@struktoai/mirage-core/dist/commands/builtin/generic/crossmount/fanout/fanout.js

A Unified Virtual Filesystem For AI Agents

// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
import { Cmd } from "../types.js";
import { mergeOperandIos, runOperands, streamOperands } from "../utils.js";
import { FlagView, flagOccurrences } from "../../../../spec/flag_view.js";
import {} from "../../../../spec/types.js";
import { specOf } from "../../../../spec/builtins.js";
const ENC = new TextEncoder();
export function joinRuns(runs, separator) {
    const parts = runs.filter((d) => d.byteLength > 0);
    const sep = ENC.encode(separator);
    const size = parts.reduce((n, d) => n + d.byteLength, 0) + sep.byteLength * Math.max(0, parts.length - 1);
    const out = new Uint8Array(size);
    let offset = 0;
    parts.forEach((d, i) => {
        if (i > 0) {
            out.set(sep, offset);
            offset += sep.byteLength;
        }
        out.set(d, offset);
        offset += d.byteLength;
    });
    return out;
}
// Run a per-operand command whose operands span mounts. The command runs
// natively once per operand on the operand's owning mount (globs expand
// inside that native run), and the outputs combine in operand order.
// Filename-keyed commands stay correct because every native run is forced to
// name its files (head/tail `-v`); `du -c` re-totals across
// runs.
export async function runFanout(cmdName, scopes, textArgs, flagKwargs, runSingle) {
    const flags = { ...flagKwargs };
    flagOccurrences(flags).push(...flagOccurrences(flagKwargs));
    // head pairs -q/--quiet and -v/--verbose (canonical dests), tail declares
    // them short-only.
    const quietKey = cmdName === Cmd.HEAD ? 'quiet' : 'q';
    const verboseKey = cmdName === Cmd.HEAD ? 'verbose' : 'v';
    if ((cmdName === Cmd.HEAD || cmdName === Cmd.TAIL) &&
        !new FlagView(flags, specOf(cmdName)).asBool(quietKey)) {
        flags[verboseKey] = true;
    }
    if (![Cmd.FIND, Cmd.RM, Cmd.RMDIR, Cmd.UNLINK, Cmd.TOUCH, Cmd.MKDIR].includes(cmdName)) {
        const separator = (cmdName === Cmd.HEAD || cmdName === Cmd.TAIL) &&
            new FlagView(flags, specOf(cmdName)).asBool(verboseKey)
            ? '\n'
            : '';
        return streamOperands(runSingle, cmdName, scopes, textArgs, flags, separator);
    }
    const results = await runOperands(runSingle, cmdName, scopes, [...textArgs], flags);
    const exitCode = Math.max(0, ...results.map((r) => r.io.exitCode));
    const body = joinRuns(results.map((r) => r.data), '');
    const io = await mergeOperandIos(results, exitCode);
    return [body, io];
}
//# sourceMappingURL=fanout.js.map