@fnndsc/brasa 0.1.0

package/dist/core/promptContext.js

@@ -0,0 +1,39 @@
+/**
+ * @file The session's prompt context: the engine-known facts a prompt reflects.
+ *
+ * A prompt shows live session state — user, CUBE, working directory, PACS,
+ * physical-mode, warm-up progress — plus the last command's outcome. Only the
+ * process holding the session can know these, but how they are *rendered*
+ * (theme, segments, terminal width) is a frontend concern. This module builds
+ * the engine half; each frontend renders it with its own theme, so the daemon
+ * ships context and never a themed string.
+ *
+ * @module
+ */
+import { session } from '../session/index.js';
+import { context_getSingle } from '@fnndsc/salsa';
+import { procCache_get } from '@fnndsc/cumin';
+/**
+ * Builds the current session's prompt context.
+ *
+ * @param options - The last-command inputs the session cannot know.
+ * @returns The engine-known prompt facts.
+ */
+export async function sessionPromptContext_build(options = {}) {
+    const context = await context_getSingle();
+    const cwd = await session.getCWD();
+    const isOffline = session.offline;
+    const warmupRaw = procCache_get().warmupProgress_get();
+    const procWarmup = warmupRaw.active ? { loaded: warmupRaw.loaded } : undefined;
+    return {
+        user: isOffline ? 'disconnected' : (context.user ?? 'disconnected'),
+        uri: isOffline ? 'no-cube' : (context.URL ?? 'no-cube'),
+        cwd: isOffline ? '/' : cwd,
+        pacsserver: context.pacsserver ?? null,
+        physicalMode: session.physicalMode_get(),
+        lastExitCode: options.lastExitCode ?? 0,
+        lastCommandDurationMs: options.lastCommandDurationMs ?? 0,
+        procWarmup,
+    };
+}
+//# sourceMappingURL=promptContext.js.map

package/dist/core/promptContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptContext.js","sourceRoot":"","sources":["../../src/core/promptContext.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAiB,aAAa,EAA2B,MAAM,eAAe,CAAC;AAgCtF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,UAAuC,EAAE;IAEzC,MAAM,OAAO,GAAkB,MAAM,iBAAiB,EAAE,CAAC;IACzD,MAAM,GAAG,GAAW,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC;IAC3C,MAAM,SAAS,GAAY,OAAO,CAAC,OAAO,CAAC;IAE3C,MAAM,SAAS,GAAuB,aAAa,EAAE,CAAC,kBAAkB,EAAE,CAAC;IAC3E,MAAM,UAAU,GACd,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAE9D,OAAO;QACL,IAAI,EAAmB,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,cAAc,CAAC;QACpF,GAAG,EAAoB,SAAS,CAAC,CAAC,CAAC,SAAS,CAAM,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,IAAK,SAAS,CAAC;QAC/E,GAAG,EAAoB,SAAS,CAAC,CAAC,CAAC,GAAG,CAAY,CAAC,CAAC,GAAG;QACvD,UAAU,EAAa,OAAO,CAAC,UAAU,IAAI,IAAI;QACjD,YAAY,EAAW,OAAO,CAAC,gBAAgB,EAAE;QACjD,YAAY,EAAW,OAAO,CAAC,YAAY,IAAI,CAAC;QAChD,qBAAqB,EAAE,OAAO,CAAC,qBAAqB,IAAI,CAAC;QACzD,UAAU;KACX,CAAC;AACJ,CAAC"}

package/dist/core/question.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @file Shared question helpers for builtins.
+ *
+ * Thin adapters over the active {@link Surface}'s prompt operation. Builtins
+ * (and the salsa admin-prompt flow, which is handed these functions) call
+ * `repl_question` / `repl_questionHidden` and remain unaware of how the host
+ * actually reads input — a local readline interface, or a request to a remote
+ * surface. The host installs the surface (see `./cliSurface.js`); until it
+ * does, the default surface fails these calls with a clear message rather
+ * than hanging on a standard input that is not there.
+ *
+ * @module
+ */
+/**
+ * Asks a question through the active surface.
+ *
+ * @param prompt - The question string to display.
+ * @returns The trimmed user answer.
+ */
+export declare function repl_question(prompt: string): Promise<string>;
+/**
+ * Asks for a secret (no echo) through the active surface.
+ *
+ * @param prompt - The prompt string to display.
+ * @returns The trimmed secret string.
+ */
+export declare function repl_questionHidden(prompt: string): Promise<string>;

package/dist/core/question.js

@@ -0,0 +1,33 @@
+/**
+ * @file Shared question helpers for builtins.
+ *
+ * Thin adapters over the active {@link Surface}'s prompt operation. Builtins
+ * (and the salsa admin-prompt flow, which is handed these functions) call
+ * `repl_question` / `repl_questionHidden` and remain unaware of how the host
+ * actually reads input — a local readline interface, or a request to a remote
+ * surface. The host installs the surface (see `./cliSurface.js`); until it
+ * does, the default surface fails these calls with a clear message rather
+ * than hanging on a standard input that is not there.
+ *
+ * @module
+ */
+import { surface_get } from './surface.js';
+/**
+ * Asks a question through the active surface.
+ *
+ * @param prompt - The question string to display.
+ * @returns The trimmed user answer.
+ */
+export function repl_question(prompt) {
+    return surface_get().prompt({ message: prompt });
+}
+/**
+ * Asks for a secret (no echo) through the active surface.
+ *
+ * @param prompt - The prompt string to display.
+ * @returns The trimmed secret string.
+ */
+export function repl_questionHidden(prompt) {
+    return surface_get().prompt({ message: prompt, hidden: true });
+}
+//# sourceMappingURL=question.js.map

package/dist/core/question.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"question.js","sourceRoot":"","sources":["../../src/core/question.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,WAAW,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;AACnD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,OAAO,WAAW,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AACjE,CAAC"}

package/dist/core/sink.d.ts

@@ -0,0 +1,207 @@
+/**
+ * @file Output sink: the seam through which command output leaves the engine.
+ *
+ * Builtins historically printed straight to process stdout, which fuses the
+ * engine to a terminal. The sink inverts that: output is written to whatever
+ * sink the host installed, and only the host knows where bytes finally go
+ * (a terminal for the CLI REPL, a capture buffer for pipes, a connection for
+ * a remote surface).
+ *
+ * Three channels are distinguished. Data is the command's actual output: it
+ * is accumulated into the command's result envelope and is what capture,
+ * piping and redirection consume. Err is the error stream: presented to the
+ * user, never piped, never captured. Status is ephemeral (spinners,
+ * progress, transient messages): displayed live, never accumulated, never
+ * piped.
+ *
+ * This module also provides delivery helpers that bridge envelope-returning
+ * builtins into the existing dispatch table, so conversion can proceed one
+ * builtin at a time while unconverted builtins keep printing.
+ *
+ * @see docs/calypso.adoc for the governing design.
+ * @module
+ */
+import type { CommandEnvelope } from '@fnndsc/cumin';
+import { type ProgressEvent, type ProgressRenderer } from './progress.js';
+/**
+ * Destination for command output, installed by the host.
+ */
+export interface OutputSink {
+    /**
+     * Writes command output (the data channel).
+     *
+     * @param chunk - Printable text (ANSI permitted) or raw bytes.
+     */
+    data_write(chunk: string | Buffer): void;
+    /**
+     * Writes error-stream output (the err channel).
+     *
+     * @param chunk - Printable text (ANSI permitted) or raw bytes.
+     */
+    err_write(chunk: string | Buffer): void;
+    /**
+     * Writes an ephemeral status line (the status channel).
+     *
+     * @param text - Transient text; consumers may overwrite or drop it.
+     */
+    status_write(text: string): void;
+    progress_write(event: ProgressEvent): void;
+}
+/**
+ * Sink that writes both channels to the process's standard output.
+ *
+ * This is the CLI host's sink and the default, preserving the shell's
+ * historical behavior exactly.
+ */
+export declare class StdoutSink implements OutputSink {
+    private readonly progressRenderer;
+    constructor(progressRenderer?: ProgressRenderer);
+    /** @inheritdoc */
+    data_write(chunk: string | Buffer): void;
+    /** @inheritdoc */
+    err_write(chunk: string | Buffer): void;
+    /** @inheritdoc */
+    status_write(text: string): void;
+    progress_write(event: ProgressEvent): void;
+}
+/**
+ * Sink that accumulates the data channel in memory and drops status.
+ *
+ * Used by capture paths and tests; will carry the pipe and redirect
+ * machinery once those consume envelopes.
+ */
+export declare class BufferSink implements OutputSink {
+    private chunks;
+    /** @inheritdoc */
+    data_write(chunk: string | Buffer): void;
+    /** @inheritdoc */
+    err_write(chunk: string | Buffer): void;
+    /** @inheritdoc */
+    status_write(_text: string): void;
+    progress_write(_event: ProgressEvent): void;
+    /**
+     * Returns everything written to the data channel so far.
+     *
+     * @returns The accumulated bytes.
+     */
+    buffer_get(): Buffer;
+    /**
+     * Returns the accumulated data channel as UTF-8 text.
+     *
+     * @returns The accumulated text.
+     */
+    text_get(): string;
+}
+/**
+ * Sink that captures the data and err channels while passing status through
+ * to a live sink, so transients (spinners, progress) remain visible while a
+ * legacy printing command's output is being gathered into an envelope.
+ */
+export declare class CaptureSink implements OutputSink {
+    private dataChunks;
+    private errChunks;
+    private live;
+    private readonly forwardEnvelopeOutput;
+    /**
+     * Initializes the capture around a live sink for status passthrough.
+     *
+     * @param live - The sink that continues to receive status writes.
+     */
+    constructor(live: OutputSink, options?: {
+        forwardEnvelopeOutput?: boolean;
+    });
+    /** @inheritdoc */
+    data_write(chunk: string | Buffer): void;
+    /** @inheritdoc */
+    err_write(chunk: string | Buffer): void;
+    /** @inheritdoc */
+    status_write(text: string): void;
+    progress_write(event: ProgressEvent): void;
+    /**
+     * Returns the captured data channel as UTF-8 text.
+     *
+     * @returns The captured data text.
+     */
+    dataText_get(): string;
+    /**
+     * Returns the captured err channel as UTF-8 text.
+     *
+     * @returns The captured error-stream text.
+     */
+    errText_get(): string;
+}
+/**
+ * Returns the sink in effect for the current async context.
+ *
+ * Inside a captured command this is that command's capture sink; otherwise it
+ * is the host sink.
+ *
+ * @returns The active output sink.
+ */
+export declare function sink_get(): OutputSink;
+/**
+ * Installs the host sink. Called by the host that owns the output destination.
+ *
+ * This sets the process-wide default, not the per-invocation scope, so a host
+ * installs it once at startup. Capture scopes established during command
+ * execution take precedence over it via {@link sink_get}.
+ *
+ * @param sink - The sink to install.
+ * @returns The previously installed host sink, so callers can restore it.
+ */
+export declare function sink_set(sink: OutputSink): OutputSink;
+/**
+ * Delivers a completed envelope to the active sink.
+ *
+ * Rendered text goes to the data channel and error-stream text to the err
+ * channel. The structured errors field is machine-facing and is not
+ * presented here: its terminal presentation, when any, travels in
+ * renderedErr.
+ *
+ * @param envelope - The completed command envelope.
+ */
+export declare function envelope_deliver(envelope: CommandEnvelope): void;
+/**
+ * Adapts an envelope-returning builtin to the legacy printing handler shape.
+ *
+ * This is the compatibility bridge for incremental conversion: converted
+ * builtins return envelopes, and this wrapper delivers them through the
+ * active sink so the dispatch table, pipes and redirects need no changes.
+ * A handler that resolves without an envelope (as stubbed handlers in tests
+ * do) is treated as having produced no output.
+ *
+ * @param handler - An envelope-returning command handler.
+ * @returns A handler with the legacy void-returning shape.
+ */
+export declare function envelopeHandler_wrap(handler: (args: string[]) => Promise<CommandEnvelope>): (args: string[]) => Promise<void>;
+/**
+ * Adapts a legacy printing builtin to the envelope-returning shape.
+ *
+ * This is the capture bridge for commands whose rendering lives below the
+ * seam (chili's table display prints internally): the handler runs with the
+ * data and err channels captured, console printing redirected into the
+ * capture, and status passed through live so spinners stay visible. The
+ * result is an envelope carrying the exact bytes each stream would have
+ * shown, with the status derived from the process exit code the handler set.
+ *
+ * Bridged commands gain envelope semantics without typed models; native
+ * conversion (models, streamed data) remains the end state for commands
+ * where a structural consumer exists.
+ *
+ * @param handler - A legacy printing command handler.
+ * @returns An envelope-returning handler with identical observable output.
+ */
+export declare function printingHandler_wrap(handler: (args: string[]) => Promise<void>): (args: string[]) => Promise<CommandEnvelope>;
+/**
+ * Strips ANSI escape sequences from text.
+ *
+ * Applied at the pipe and redirect boundary so downstream consumers receive
+ * plain text, the way programs behind a real shell pipe see no color. This
+ * is a deliberate, documented deviation from the historical behavior, in
+ * which escape bytes leaked into pipes because color detection saw the
+ * terminal regardless of capture.
+ *
+ * @param text - Text possibly containing ANSI sequences.
+ * @returns The text with all ANSI sequences removed.
+ */
+export declare function ansi_strip(text: string): string;

package/dist/core/sink.js

@@ -0,0 +1,329 @@
+/**
+ * @file Output sink: the seam through which command output leaves the engine.
+ *
+ * Builtins historically printed straight to process stdout, which fuses the
+ * engine to a terminal. The sink inverts that: output is written to whatever
+ * sink the host installed, and only the host knows where bytes finally go
+ * (a terminal for the CLI REPL, a capture buffer for pipes, a connection for
+ * a remote surface).
+ *
+ * Three channels are distinguished. Data is the command's actual output: it
+ * is accumulated into the command's result envelope and is what capture,
+ * piping and redirection consume. Err is the error stream: presented to the
+ * user, never piped, never captured. Status is ephemeral (spinners,
+ * progress, transient messages): displayed live, never accumulated, never
+ * piped.
+ *
+ * This module also provides delivery helpers that bridge envelope-returning
+ * builtins into the existing dispatch table, so conversion can proceed one
+ * builtin at a time while unconverted builtins keep printing.
+ *
+ * @see docs/calypso.adoc for the governing design.
+ * @module
+ */
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { NullProgressRenderer } from './progress.js';
+function sink_streamsEnvelopeOutput(sink) {
+    return sink.liveEnvelopeOutput === true;
+}
+/**
+ * Sink that writes both channels to the process's standard output.
+ *
+ * This is the CLI host's sink and the default, preserving the shell's
+ * historical behavior exactly.
+ */
+export class StdoutSink {
+    progressRenderer;
+    constructor(progressRenderer = new NullProgressRenderer()) {
+        this.progressRenderer = progressRenderer;
+    }
+    /** @inheritdoc */
+    data_write(chunk) {
+        process.stdout.write(chunk);
+    }
+    /** @inheritdoc */
+    err_write(chunk) {
+        process.stderr.write(chunk);
+    }
+    /** @inheritdoc */
+    status_write(text) {
+        process.stdout.write(text);
+    }
+    progress_write(event) {
+        this.progressRenderer.write(event);
+    }
+}
+/**
+ * Sink that accumulates the data channel in memory and drops status.
+ *
+ * Used by capture paths and tests; will carry the pipe and redirect
+ * machinery once those consume envelopes.
+ */
+export class BufferSink {
+    chunks = [];
+    /** @inheritdoc */
+    data_write(chunk) {
+        this.chunks.push(typeof chunk === 'string' ? Buffer.from(chunk, 'utf-8') : chunk);
+    }
+    /** @inheritdoc */
+    err_write(chunk) {
+        // The err channel is never captured: today's pipe and redirect paths
+        // inherit stderr, so error output must keep reaching the terminal even
+        // while data is being buffered.
+        process.stderr.write(chunk);
+    }
+    /** @inheritdoc */
+    status_write(_text) {
+        // Status is ephemeral by contract: never accumulated.
+    }
+    progress_write(_event) {
+        // Progress is ephemeral by contract: never accumulated.
+    }
+    /**
+     * Returns everything written to the data channel so far.
+     *
+     * @returns The accumulated bytes.
+     */
+    buffer_get() {
+        return Buffer.concat(this.chunks);
+    }
+    /**
+     * Returns the accumulated data channel as UTF-8 text.
+     *
+     * @returns The accumulated text.
+     */
+    text_get() {
+        return this.buffer_get().toString('utf-8');
+    }
+}
+/**
+ * Sink that captures the data and err channels while passing status through
+ * to a live sink, so transients (spinners, progress) remain visible while a
+ * legacy printing command's output is being gathered into an envelope.
+ */
+export class CaptureSink {
+    dataChunks = [];
+    errChunks = [];
+    live;
+    forwardEnvelopeOutput;
+    /**
+     * Initializes the capture around a live sink for status passthrough.
+     *
+     * @param live - The sink that continues to receive status writes.
+     */
+    constructor(live, options = {}) {
+        this.live = live;
+        this.forwardEnvelopeOutput = options.forwardEnvelopeOutput ?? false;
+    }
+    /** @inheritdoc */
+    data_write(chunk) {
+        this.dataChunks.push(typeof chunk === 'string' ? Buffer.from(chunk, 'utf-8') : chunk);
+        if (this.forwardEnvelopeOutput) {
+            this.live.data_write(chunk);
+        }
+    }
+    /** @inheritdoc */
+    err_write(chunk) {
+        this.errChunks.push(typeof chunk === 'string' ? Buffer.from(chunk, 'utf-8') : chunk);
+        if (this.forwardEnvelopeOutput) {
+            this.live.err_write(chunk);
+        }
+    }
+    /** @inheritdoc */
+    status_write(text) {
+        this.live.status_write(text);
+    }
+    progress_write(event) {
+        this.live.progress_write(event);
+    }
+    /**
+     * Returns the captured data channel as UTF-8 text.
+     *
+     * @returns The captured data text.
+     */
+    dataText_get() {
+        return Buffer.concat(this.dataChunks).toString('utf-8');
+    }
+    /**
+     * Returns the captured err channel as UTF-8 text.
+     *
+     * @returns The captured error-stream text.
+     */
+    errText_get() {
+        return Buffer.concat(this.errChunks).toString('utf-8');
+    }
+}
+/**
+ * The host sink: the process-wide default installed by whoever owns the output
+ * destination (the CLI REPL, the daemon). Defaults to stdout so every entry
+ * point behaves as the CLI always has.
+ */
+let hostSink = new StdoutSink();
+/**
+ * Per-invocation sink scope.
+ *
+ * A captured command runs inside {@link AsyncLocalStorage#run}, so its sink
+ * follows the async call chain and is isolated from any other command running
+ * concurrently in the same process. Outside a scope the store is undefined and
+ * the host sink applies. This is what lets one process host several sessions
+ * at once without their output stomping a shared global.
+ */
+const sinkScope = new AsyncLocalStorage();
+/**
+ * Returns the sink in effect for the current async context.
+ *
+ * Inside a captured command this is that command's capture sink; otherwise it
+ * is the host sink.
+ *
+ * @returns The active output sink.
+ */
+export function sink_get() {
+    return sinkScope.getStore() ?? hostSink;
+}
+/**
+ * Installs the host sink. Called by the host that owns the output destination.
+ *
+ * This sets the process-wide default, not the per-invocation scope, so a host
+ * installs it once at startup. Capture scopes established during command
+ * execution take precedence over it via {@link sink_get}.
+ *
+ * @param sink - The sink to install.
+ * @returns The previously installed host sink, so callers can restore it.
+ */
+export function sink_set(sink) {
+    const previous = hostSink;
+    hostSink = sink;
+    return previous;
+}
+/**
+ * Delivers a completed envelope to the active sink.
+ *
+ * Rendered text goes to the data channel and error-stream text to the err
+ * channel. The structured errors field is machine-facing and is not
+ * presented here: its terminal presentation, when any, travels in
+ * renderedErr.
+ *
+ * @param envelope - The completed command envelope.
+ */
+export function envelope_deliver(envelope) {
+    const sink = sink_get();
+    if (envelope.rendered.length > 0) {
+        sink.data_write(envelope.rendered);
+    }
+    if (envelope.renderedErr !== undefined && envelope.renderedErr.length > 0) {
+        sink.err_write(envelope.renderedErr);
+    }
+}
+/**
+ * Adapts an envelope-returning builtin to the legacy printing handler shape.
+ *
+ * This is the compatibility bridge for incremental conversion: converted
+ * builtins return envelopes, and this wrapper delivers them through the
+ * active sink so the dispatch table, pipes and redirects need no changes.
+ * A handler that resolves without an envelope (as stubbed handlers in tests
+ * do) is treated as having produced no output.
+ *
+ * @param handler - An envelope-returning command handler.
+ * @returns A handler with the legacy void-returning shape.
+ */
+export function envelopeHandler_wrap(handler) {
+    return async (args) => {
+        const envelope = await handler(args);
+        if (!envelope) {
+            return;
+        }
+        envelope_deliver(envelope);
+    };
+}
+/**
+ * Adapts a legacy printing builtin to the envelope-returning shape.
+ *
+ * This is the capture bridge for commands whose rendering lives below the
+ * seam (chili's table display prints internally): the handler runs with the
+ * data and err channels captured, console printing redirected into the
+ * capture, and status passed through live so spinners stay visible. The
+ * result is an envelope carrying the exact bytes each stream would have
+ * shown, with the status derived from the process exit code the handler set.
+ *
+ * Bridged commands gain envelope semantics without typed models; native
+ * conversion (models, streamed data) remains the end state for commands
+ * where a structural consumer exists.
+ *
+ * @param handler - A legacy printing command handler.
+ * @returns An envelope-returning handler with identical observable output.
+ */
+export function printingHandler_wrap(handler) {
+    return async (args) => {
+        const live = sink_get();
+        const capture = new CaptureSink(live, {
+            forwardEnvelopeOutput: sink_streamsEnvelopeOutput(live),
+        });
+        // The command's sink is scoped to this async context, so sink_get() (used
+        // by spinners, progress and directly-writing builtins) resolves to this
+        // capture without a shared global that concurrent commands would stomp.
+        // The console/stdout redirect below remains per-invocation: removing it in
+        // favour of envelope-returning builtins is tracked separately (#98).
+        const originalLog = console.log;
+        const originalError = console.error;
+        const originalStdoutWrite = process.stdout.write.bind(process.stdout);
+        const exitCodeBefore = typeof process.exitCode === 'number' ? process.exitCode : 0;
+        console.log = (...logArgs) => {
+            const text = logArgs
+                .map((arg) => (typeof arg === 'string' ? arg : JSON.stringify(arg)))
+                .join(' ');
+            capture.data_write(`${text}\n`);
+        };
+        console.error = (...logArgs) => {
+            const text = logArgs
+                .map((arg) => (typeof arg === 'string' ? arg : JSON.stringify(arg)))
+                .join(' ');
+            capture.err_write(`${text}\n`);
+        };
+        process.stdout.write = ((chunk) => {
+            if (typeof chunk === 'string' || Buffer.isBuffer(chunk)) {
+                capture.data_write(chunk);
+            }
+            else if (chunk instanceof Uint8Array) {
+                capture.data_write(Buffer.from(chunk));
+            }
+            return true;
+        });
+        try {
+            await sinkScope.run(capture, async () => {
+                await handler(args);
+            });
+        }
+        finally {
+            console.log = originalLog;
+            console.error = originalError;
+            process.stdout.write = originalStdoutWrite;
+        }
+        const exitCodeAfter = typeof process.exitCode === 'number' ? process.exitCode : 0;
+        const failed = exitCodeAfter !== 0 && exitCodeAfter !== exitCodeBefore;
+        const rendered = capture.dataText_get();
+        const renderedErr = capture.errText_get();
+        const envelope = { status: failed ? 'error' : 'ok', rendered };
+        if (renderedErr.length > 0) {
+            envelope.renderedErr = renderedErr;
+        }
+        return envelope;
+    };
+}
+/** Matches ANSI escape sequences (SGR colors, cursor movement, erase). */
+const ANSI_PATTERN = /\x1b\[[0-9;?]*[a-zA-Z]/g;
+/**
+ * Strips ANSI escape sequences from text.
+ *
+ * Applied at the pipe and redirect boundary so downstream consumers receive
+ * plain text, the way programs behind a real shell pipe see no color. This
+ * is a deliberate, documented deviation from the historical behavior, in
+ * which escape bytes leaked into pipes because color detection saw the
+ * terminal regardless of capture.
+ *
+ * @param text - Text possibly containing ANSI sequences.
+ * @returns The text with all ANSI sequences removed.
+ */
+export function ansi_strip(text) {
+    return text.replace(ANSI_PATTERN, '');
+}
+//# sourceMappingURL=sink.js.map

package/dist/core/sink.js.map

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