@poe-platform/safe-bash 0.1.630 → 0.1.632

package/dist/safe-bash/contracts/command.js

@@ -172,6 +172,7 @@ export function getCommandArguments(context) {
         throw new CommandArgumentIdentityError();
     return carrier;
 }
+export const commandRuntimeIdentity = Object.freeze({});
 export class CommandRegistry {
     #commands = new Map();
     constructor(commands = []) {
@@ -179,17 +180,20 @@ export class CommandRegistry {
             this.register(command);
     }
     register(command, options = {}) {
-        const { name, execute } = command;
+        const { name, execute, runtimeIdentity, ...metadata } = command;
         if (typeof name !== "string" || !name || /[\s/\0]/u.test(name)) {
             throw new TypeError("Command names must be nonempty and contain no whitespace, slash, or NUL");
         }
         if (typeof execute !== "function") {
             throw new TypeError("Command execute must be a function");
         }
+        if (runtimeIdentity !== undefined && runtimeIdentity !== commandRuntimeIdentity) {
+            throw new TypeError("Command requires its matching shell runtime; do not mix source and compiled runtime modules");
+        }
         if (this.#commands.has(name) && !options.replace) {
             throw new Error(`Command already registered: ${name}`);
         }
-        this.#commands.set(name, Object.freeze({ ...command, name, execute }));
+        this.#commands.set(name, Object.freeze({ ...metadata, name, execute, ...(runtimeIdentity === undefined ? {} : { runtimeIdentity }) }));
         return this;
     }
     get(name) {

package/dist/safe-bash/contracts/command.js.map

@@ -1 +1 @@
-{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/contracts/command.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/contracts/command.ts"],"names":[],"mappings":"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"}

package/dist/safe-bash/contracts/filesystem-descriptor.d.ts

@@ -0,0 +1,13 @@
+import type { FileDescriptor, OpenFileOptions } from "@poe-platform/safe-fs/core";
+import { type FileOutputContext } from "./filesystem-output-budget.js";
+export interface CommandFileDescriptor extends FileDescriptor {
+    acknowledgeCloseFailure(reason: unknown): boolean;
+}
+/** descriptorCleanup: "caller" requires an already-enrolled owner that drains late
+ * acquisitions and closes the returned descriptor; output accounting keeps the
+ * original registerCleanup identity in either ownership mode. */
+export declare function openCommandFile(context: FileOutputContext & {
+    readonly cleanupFailurePrioritySignal?: AbortSignal | undefined;
+    readonly descriptorCleanup?: "caller";
+}, path: string, options: OpenFileOptions): Promise<CommandFileDescriptor>;
+//# sourceMappingURL=filesystem-descriptor.d.ts.map

package/dist/safe-bash/contracts/filesystem-descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-descriptor.d.ts","sourceRoot":"","sources":["../../src/contracts/filesystem-descriptor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAa,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxF,OAAO,EAAmD,KAAK,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAExH,MAAM,WAAW,qBAAsB,SAAQ,cAAc;IAC3D,uBAAuB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;CACnD;AAED;;iEAEiE;AACjE,wBAAsB,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG;IAAE,QAAQ,CAAC,4BAA4B,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,QAAQ,CAAA;CAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAmJrP"}

package/dist/safe-bash/contracts/filesystem-descriptor.js

@@ -0,0 +1,189 @@
+import { FsError } from "@poe-platform/safe-fs/core";
+import { assertCountedFileOutput, writeFileOutputCounted } from "./filesystem-output-budget.js";
+/** descriptorCleanup: "caller" requires an already-enrolled owner that drains late
+ * acquisitions and closes the returned descriptor; output accounting keeps the
+ * original registerCleanup identity in either ownership mode. */
+export async function openCommandFile(context, path, options) {
+    const { cleanupFailurePrioritySignal } = context;
+    let descriptor;
+    let accepting = true;
+    let closing;
+    let closeFailure;
+    let work = Promise.resolve();
+    let acquisitionSettled;
+    const acquired = new Promise(resolve => { acquisitionSettled = resolve; });
+    let scope;
+    const close = () => {
+        accepting = false;
+        closing ??= (async () => {
+            await acquired;
+            await work;
+            const retained = descriptor;
+            descriptor = undefined;
+            try {
+                await retained?.close();
+            }
+            catch (reason) {
+                closeFailure = { reason, acknowledged: false, drained: false };
+                throw reason;
+            }
+            finally {
+                scope?.removeEventListener("abort", aborted);
+                if (closeFailure)
+                    closeFailure.drained = true;
+            }
+        })();
+        void closing.catch(() => { });
+        return closing;
+    };
+    const aborted = () => { void close().catch(() => { }); };
+    const check = (signal) => {
+        context.signal.throwIfAborted();
+        scope?.throwIfAborted();
+        signal?.throwIfAborted();
+    };
+    const run = (syscall, forwarded, action) => {
+        const signal = forwarded.signal;
+        try {
+            check(signal);
+            if (!accepting)
+                throw new FsError("EBADF", { syscall, path });
+        }
+        catch (error) {
+            return Promise.reject(error);
+        }
+        const operation = work.then(async () => {
+            check(signal);
+            const local = signal ? AbortSignal.any([scope, signal]) : scope;
+            try {
+                const result = await action(descriptor, { signal: local });
+                check(signal);
+                return result;
+            }
+            catch (error) {
+                check(signal);
+                throw error;
+            }
+        });
+        work = operation.then(() => { }, () => { });
+        return operation;
+    };
+    try {
+        if (context.descriptorCleanup !== "caller")
+            context.registerCleanup?.(async () => {
+                try {
+                    await close();
+                }
+                catch (reason) {
+                    if (!closeFailure?.drained || !closeFailure.acknowledged || !Object.is(reason, closeFailure.reason)) {
+                        if (cleanupFailurePrioritySignal === undefined)
+                            check();
+                        else
+                            cleanupFailurePrioritySignal.throwIfAborted();
+                        throw reason;
+                    }
+                }
+                check();
+            });
+        const request = { ...options };
+        scope = request.signal ? AbortSignal.any([context.signal, request.signal]) : context.signal;
+        scope.addEventListener("abort", aborted, { once: true });
+        check();
+        if (!accepting)
+            throw new FsError("EBADF", { syscall: "open", path });
+        if (request.access !== "read")
+            assertCountedFileOutput(context);
+        const fsOptions = { signal: scope };
+        // A following capability query cannot precede atomic exclusive acquisition:
+        // even a self-loop final symlink must be refused by open with EEXIST.
+        const capabilities = request.creation === "exclusive" ? context.fs.capabilities
+            : await context.fs.capabilitiesFor?.(path, { ...fsOptions, ...(request.creation === "ifMissing" ? { create: true } : {}) }) ?? context.fs.capabilities;
+        check();
+        if (!accepting)
+            throw new FsError("EBADF", { syscall: "open", path });
+        if (!context.fs.open || capabilities?.open === false)
+            throw new FsError("ENOTSUP", { syscall: "open", path });
+        descriptor = await context.fs.open(path, { ...request, signal: scope });
+        acquisitionSettled();
+        check();
+        if (!accepting)
+            throw new FsError("EBADF", { syscall: "open", path });
+        const { delegateZeroLengthWrite, ...retainedCapabilities } = descriptor.capabilities;
+        const position = retainedCapabilities.position === true && typeof descriptor.getPosition === "function";
+        const probeRead = retainedCapabilities.readObservation === true ? descriptor.probeRead : undefined;
+        if (retainedCapabilities.readObservation === true && typeof probeRead !== "function")
+            throw new FsError("ENOTSUP", { syscall: "probeRead", path });
+        const admitted = Object.freeze({ ...retainedCapabilities,
+            positionedRead: retainedCapabilities.positionedRead && request.access !== "write",
+            positionedWrite: retainedCapabilities.positionedWrite && request.access !== "read"
+                && (!request.append || retainedCapabilities.positionedAppendWrite === true),
+            truncate: retainedCapabilities.truncate && request.access !== "read",
+            ...(retainedCapabilities.position === undefined ? {} : { position }),
+            ...(retainedCapabilities.positionedAppendWrite === undefined ? {} : {
+                positionedAppendWrite: retainedCapabilities.positionedAppendWrite === true
+                    && retainedCapabilities.positionedWrite && request.access !== "read",
+            }),
+            ...(delegateZeroLengthWrite === undefined ? {} : {
+                delegateZeroLengthWrite: delegateZeroLengthWrite === true && request.access !== "read",
+            }),
+        });
+        check();
+        if (!accepting)
+            throw new FsError("EBADF", { syscall: "open", path });
+        return {
+            capabilities: admitted,
+            ...(probeRead === undefined ? {} : { probeRead: (forwarded = {}) => run("probeRead", forwarded, async (retained, supplied) => {
+                    const readiness = await probeRead.call(retained, supplied);
+                    if (readiness !== "ready" && readiness !== "blocked" && readiness !== "unknown")
+                        throw new FsError("EIO", { syscall: "probeRead", path });
+                    return readiness;
+                }) }),
+            ...(position ? { getPosition: (forwarded = {}) => run("getPosition", forwarded, async (retained, supplied) => {
+                    if (retained.capabilities.position !== true || typeof retained.getPosition !== "function")
+                        throw new FsError("ENOTSUP", { syscall: "getPosition", path });
+                    const cursor = await retained.getPosition(supplied);
+                    if (!Number.isSafeInteger(cursor) || cursor < 0)
+                        throw new FsError("EIO", { syscall: "getPosition", path });
+                    return cursor;
+                }) } : {}),
+            stat: (forwarded = {}) => run("fstat", forwarded, (retained, supplied) => retained.stat(supplied)),
+            read: (buffer, position, forwarded = {}) => run("read", forwarded, async (retained, supplied) => {
+                if (request.access === "write")
+                    throw new FsError("EBADF", { syscall: "read", path });
+                return retained.read(buffer, position, supplied);
+            }),
+            write: (buffer, position, forwarded = {}) => run("write", forwarded, async (retained, supplied) => {
+                if (request.access === "read")
+                    throw new FsError("EBADF", { syscall: "write", path });
+                return writeFileOutputCounted({ ...context, signal: supplied.signal }, buffer, () => retained.write(buffer, position, supplied));
+            }),
+            truncate: (length, forwarded = {}) => run("ftruncate", forwarded, async (retained, supplied) => {
+                if (request.access === "read")
+                    throw new FsError("EBADF", { syscall: "ftruncate", path });
+                await retained.truncate(length, supplied);
+            }),
+            sync: (dataOnly, forwarded = {}) => run(dataOnly ? "fdatasync" : "fsync", forwarded, (retained, supplied) => retained.sync(dataOnly, supplied)),
+            close,
+            acknowledgeCloseFailure: (reason) => {
+                if (!closeFailure || !Object.is(reason, closeFailure.reason))
+                    return false;
+                if (closeFailure.acknowledged)
+                    return true;
+                if (context.signal.aborted || scope?.aborted)
+                    return false;
+                closeFailure.acknowledged = true;
+                return true;
+            },
+        };
+    }
+    catch (error) {
+        acquisitionSettled();
+        try {
+            await close();
+        }
+        catch { }
+        check();
+        throw error;
+    }
+}
+//# sourceMappingURL=filesystem-descriptor.js.map

package/dist/safe-bash/contracts/filesystem-descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-descriptor.js","sourceRoot":"","sources":["../../src/contracts/filesystem-descriptor.ts"],"names":[],"mappings":"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"}

package/dist/safe-bash/contracts/filesystem-output-budget.d.ts

@@ -0,0 +1,15 @@
+import type { CommandContext } from "./command.js";
+import type { ByteSink } from "./io.js";
+export type CountedFileWrite = (chunk: Uint8Array, write: () => Promise<number>) => Promise<number>;
+export declare const filesystemOutputBudgets: WeakMap<(cleanup: import("./command.js").InvocationCleanup) => void, {
+    readonly sinkBudget: (sink: ByteSink) => ByteSink;
+    readonly countedWrite?: CountedFileWrite;
+}>;
+export type FileOutputContext = Pick<CommandContext, "fs" | "signal" | "registerCleanup"> & {
+    readonly cleanupFailurePrioritySignal?: AbortSignal | undefined;
+    readonly outputBudget?: "shell" | "independent";
+};
+export declare function bindFileOutputBudget(context: Pick<CommandContext, "registerCleanup">, budget: (sink: ByteSink) => ByteSink, countedWrite?: CountedFileWrite): void;
+export declare function assertCountedFileOutput(context: Pick<CommandContext, "registerCleanup" | "signal">): void;
+export declare function writeFileOutputCounted(context: Pick<CommandContext, "registerCleanup" | "signal">, chunk: Uint8Array, write: () => Promise<number>): Promise<number>;
+//# sourceMappingURL=filesystem-output-budget.d.ts.map

package/dist/safe-bash/contracts/filesystem-output-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-output-budget.d.ts","sourceRoot":"","sources":["../../src/contracts/filesystem-output-budget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEpG,eAAO,MAAM,uBAAuB;yBACb,CAAC,IAAI,EAAE,QAAQ,KAAK,QAAQ;4BACzB,gBAAgB;EACtC,CAAC;AAEL,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,cAAc,EAAE,IAAI,GAAG,QAAQ,GAAG,iBAAiB,CAAC,GAAG;IAC1F,QAAQ,CAAC,4BAA4B,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAChE,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC;CACjD,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,QAAQ,EAAE,YAAY,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAGlK;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,iBAAiB,GAAG,QAAQ,CAAC,GAAG,IAAI,CAIzG;AAED,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,iBAAiB,GAAG,QAAQ,CAAC,EACtG,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAqClE"}

package/dist/safe-bash/contracts/filesystem-output-budget.js

@@ -0,0 +1,69 @@
+import { FsError } from "./errors.js";
+export const filesystemOutputBudgets = new WeakMap();
+export function bindFileOutputBudget(context, budget, countedWrite) {
+    if (!context.registerCleanup)
+        throw new TypeError("Shell output budgets require invocation cleanup ownership");
+    filesystemOutputBudgets.set(context.registerCleanup, { sinkBudget: budget, ...(countedWrite === undefined ? {} : { countedWrite }) });
+}
+export function assertCountedFileOutput(context) {
+    context.signal.throwIfAborted();
+    const budget = context.registerCleanup && filesystemOutputBudgets.get(context.registerCleanup);
+    if (budget && !budget.countedWrite)
+        throw new FsError("ENOTSUP", { syscall: "write", message: "counted filesystem output budget is not bound" });
+}
+export async function writeFileOutputCounted(context, chunk, write) {
+    assertCountedFileOutput(context);
+    if (!(chunk instanceof Uint8Array))
+        throw new TypeError("Filesystem output must be Uint8Array");
+    const budget = context.registerCleanup && filesystemOutputBudgets.get(context.registerCleanup);
+    const requested = chunk.byteLength;
+    let called = false;
+    let accepting = true;
+    let accepted;
+    let active;
+    const guarded = () => {
+        try {
+            context.signal.throwIfAborted();
+            if (!accepting)
+                throw new FsError("EBADF", { syscall: "write" });
+            if (called)
+                throw new FsError("EIO", { syscall: "write", message: "counted writer invoked more than once" });
+            called = true;
+        }
+        catch (error) {
+            return Promise.reject(error);
+        }
+        active = (async () => {
+            const count = await write();
+            context.signal.throwIfAborted();
+            if (!Number.isSafeInteger(count) || count < 0 || count > requested)
+                throw new FsError("EIO", { syscall: "write", message: "invalid byte count" });
+            accepted = count;
+            return count;
+        })();
+        void active.catch(() => { });
+        return active;
+    };
+    let result;
+    let failure;
+    try {
+        result = await (budget?.countedWrite ? budget.countedWrite(chunk, guarded) : guarded());
+    }
+    catch (reason) {
+        failure = { reason };
+    }
+    accepting = false;
+    try {
+        await active;
+    }
+    catch (reason) {
+        failure ??= { reason };
+    }
+    context.signal.throwIfAborted();
+    if (failure)
+        throw failure.reason;
+    if (accepted === undefined || result !== accepted)
+        throw new FsError("EIO", { syscall: "write", message: "counted writer changed the accepted byte count" });
+    return accepted;
+}
+//# sourceMappingURL=filesystem-output-budget.js.map

package/dist/safe-bash/contracts/filesystem-output-budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-output-budget.js","sourceRoot":"","sources":["../../src/contracts/filesystem-output-budget.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAKtC,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,OAAO,EAG9C,CAAC;AAOL,MAAM,UAAU,oBAAoB,CAAC,OAAgD,EAAE,MAAoC,EAAE,YAA+B;IAC1J,IAAI,CAAC,OAAO,CAAC,eAAe;QAAE,MAAM,IAAI,SAAS,CAAC,2DAA2D,CAAC,CAAC;IAC/G,uBAAuB,CAAC,GAAG,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,CAAC;AACxI,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAA2D;IACjG,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,OAAO,CAAC,eAAe,IAAI,uBAAuB,CAAC,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAC/F,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY;QAAE,MAAM,IAAI,OAAO,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,+CAA+C,EAAE,CAAC,CAAC;AACnJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,OAA2D,EACtG,KAAiB,EAAE,KAA4B;IAC/C,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjC,IAAI,CAAC,CAAC,KAAK,YAAY,UAAU,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,sCAAsC,CAAC,CAAC;IAChG,MAAM,MAAM,GAAG,OAAO,CAAC,eAAe,IAAI,uBAAuB,CAAC,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAC/F,MAAM,SAAS,GAAG,KAAK,CAAC,UAAU,CAAC;IACnC,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,SAAS,GAAG,IAAI,CAAC;IACrB,IAAI,QAA4B,CAAC;IACjC,IAAI,MAAmC,CAAC;IACxC,MAAM,OAAO,GAAG,GAAoB,EAAE;QACpC,IAAI,CAAC;YACH,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YAChC,IAAI,CAAC,SAAS;gBAAE,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;YACjE,IAAI,MAAM;gBAAE,MAAM,IAAI,OAAO,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,uCAAuC,EAAE,CAAC,CAAC;YAC7G,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAAC,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAAC,CAAC;QACjD,MAAM,GAAG,CAAC,KAAK,IAAI,EAAE;YACnB,MAAM,KAAK,GAAG,MAAM,KAAK,EAAE,CAAC;YAC5B,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YAChC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,SAAS;gBAAE,MAAM,IAAI,OAAO,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC,CAAC;YAClJ,QAAQ,GAAG,KAAK,CAAC;YACjB,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,EAAE,CAAC;QACL,KAAK,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC5B,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IACF,IAAI,MAA0B,CAAC;IAC/B,IAAI,OAAwC,CAAC;IAC7C,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1F,CAAC;IAAC,OAAO,MAAM,EAAE,CAAC;QAAC,OAAO,GAAG,EAAE,MAAM,EAAE,CAAC;IAAC,CAAC;IAC1C,SAAS,GAAG,KAAK,CAAC;IAClB,IAAI,CAAC;QAAC,MAAM,MAAM,CAAC;IAAC,CAAC;IAAC,OAAO,MAAM,EAAE,CAAC;QAAC,OAAO,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,CAAC;IAChE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;IAChC,IAAI,OAAO;QAAE,MAAM,OAAO,CAAC,MAAM,CAAC;IAClC,IAAI,QAAQ,KAAK,SAAS,IAAI,MAAM,KAAK,QAAQ;QAAE,MAAM,IAAI,OAAO,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,gDAAgD,EAAE,CAAC,CAAC;IAC7J,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/safe-bash/contracts/filesystem-output.d.ts

@@ -1,15 +1,21 @@
 import type { CommandContext } from "./command.js";
 import { type ByteSink } from "./io.js";
-export type FileOutputContext = Pick<CommandContext, "fs" | "signal" | "registerCleanup"> & {
-    readonly outputBudget?: "shell" | "independent";
-};
-export declare function bindFileOutputBudget(context: Pick<CommandContext, "registerCleanup">, budget: (sink: ByteSink) => ByteSink): void;
+import { type FileOutputContext } from "./filesystem-output-budget.js";
+import { type CommandFileDescriptor } from "./filesystem-descriptor.js";
+export { bindFileOutputBudget, assertCountedFileOutput, writeFileOutputCounted } from "./filesystem-output-budget.js";
+export type { CountedFileWrite, FileOutputContext } from "./filesystem-output-budget.js";
 export declare function writeFileOutput(context: Pick<CommandContext, "signal" | "registerCleanup">, bytes: Uint8Array, write: (bytes: Uint8Array) => Promise<void>): Promise<void>;
 export interface FileOutput {
     readonly sink: ByteSink;
     readonly signal: AbortSignal;
+    readonly descriptor?: CommandFileDescriptor;
     finish(): Promise<void>;
     abort(reason: unknown): Promise<void>;
 }
-export declare function openFileOutput(context: FileOutputContext, path: string, flag: "w" | "a", incremental?: () => Promise<ByteSink>): Promise<FileOutput>;
+export interface FileOutputOpenOptions {
+    readonly flag: "w" | "a" | "wx";
+    readonly mode?: number;
+    readonly descriptor?: boolean;
+}
+export declare function openFileOutput(context: FileOutputContext, path: string, options: "w" | "a" | FileOutputOpenOptions, incremental?: () => Promise<ByteSink>): Promise<FileOutput>;
 //# sourceMappingURL=filesystem-output.d.ts.map

package/dist/safe-bash/contracts/filesystem-output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filesystem-output.d.ts","sourceRoot":"","sources":["../../src/contracts/filesystem-output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAgD,KAAK,QAAQ,EAAmB,MAAM,SAAS,CAAC;AAKvG,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,cAAc,EAAE,IAAI,GAAG,QAAQ,GAAG,iBAAiB,CAAC,GAAG;IAC1F,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC;CACjD,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,QAAQ,GAAG,IAAI,CAGjI;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,iBAAiB,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBhL;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,GAAG,EAAE,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAsI1J"}
+{"version":3,"file":"filesystem-output.d.ts","sourceRoot":"","sources":["../../src/contracts/filesystem-output.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAgD,KAAK,QAAQ,EAAmB,MAAM,SAAS,CAAC;AAGvG,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAChG,OAAO,EAAmB,KAAK,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACzF,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACtH,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAGzF,wBAAsB,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,iBAAiB,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBhL;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,qBAAqB,CAAC;IAC5C,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AA2JD,wBAAsB,cAAc,CAAC,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,GAAG,GAAG,qBAAqB,EAAE,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAkJrL"}