@fnndsc/chell 5.6.2 → 5.7.1

package/dist/core/daemonConsole.d.ts

@@ -0,0 +1,12 @@
+import { type DaemonConsoleTarget } from '@fnndsc/calypso';
+export type { DaemonConsoleTarget };
+/** This chell build's own entry, spawned as the console surface. */
+export declare const CHELL_ENTRY: string;
+/**
+ * Runs the daemon console on chell's own terminal, spawning this chell as
+ * the surface.
+ *
+ * @param target - The daemon to attach to.
+ * @returns Resolves when the operator will not attach again.
+ */
+export declare function daemonConsole_run(target: DaemonConsoleTarget): Promise<void>;

package/dist/core/daemonConsole.js

@@ -0,0 +1,30 @@
+/**
+ * @file chell's daemon-console entry, over the console the daemon package
+ * owns.
+ *
+ * The console loop, the cage and the reattach grammar live in calypso, since
+ * both the standalone `calypso` binary and `chell --daemon` end their boot
+ * this way. chell's one difference is the surface it launches: it spawns
+ * itself — this build, at this path — rather than whatever `chell` the path
+ * happens to resolve, so the console is never a different chell than the
+ * daemon it sits on.
+ *
+ * @module
+ */
+import { fileURLToPath } from 'node:url';
+import { daemonConsole_run as consoleSession_run, consoleDeps_live, } from '@fnndsc/calypso';
+/** This chell build's own entry, spawned as the console surface. */
+export const CHELL_ENTRY = fileURLToPath(new URL('../index.js', import.meta.url));
+/** Launch the surface as this very chell, not one resolved from the path. */
+const CHELL_LAUNCH = { exec: process.execPath, prefixArgs: [CHELL_ENTRY] };
+/**
+ * Runs the daemon console on chell's own terminal, spawning this chell as
+ * the surface.
+ *
+ * @param target - The daemon to attach to.
+ * @returns Resolves when the operator will not attach again.
+ */
+export async function daemonConsole_run(target) {
+    return consoleSession_run(target, consoleDeps_live(CHELL_LAUNCH));
+}
+//# sourceMappingURL=daemonConsole.js.map

package/dist/core/daemonConsole.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemonConsole.js","sourceRoot":"","sources":["../../src/core/daemonConsole.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EACL,iBAAiB,IAAI,kBAAkB,EACvC,gBAAgB,GAGjB,MAAM,iBAAiB,CAAC;AAIzB,oEAAoE;AACpE,MAAM,CAAC,MAAM,WAAW,GAAW,aAAa,CAAC,IAAI,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1F,6EAA6E;AAC7E,MAAM,YAAY,GAAkB,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC;AAE1F;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAA2B;IACjE,OAAO,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC,CAAC;AACpE,CAAC"}

package/dist/core/promptGuard.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @file Keeps a stray write from landing across an idle prompt.
+ *
+ * A REPL waiting at its prompt shares the terminal with everything else
+ * the process writes: another surface's output pushed by the daemon, a
+ * warm-up settling late, a roster row. Written raw, such a line lands on
+ * the prompt line and the prompt is gone until the next keystroke. While
+ * the guard is engaged, a stray write clears the prompt line, lands on a
+ * line of its own, and the prompt is redrawn beneath it with whatever was
+ * typed still in place.
+ *
+ * readline draws through an output whose write bypasses the guard, so the
+ * prompt's own paint is never mistaken for a stray line.
+ *
+ * @module
+ */
+/** A write's completion callback, as the stream API passes it. */
+type WriteCallback = (error?: Error | null) => void;
+/** What the guard needs of the terminal: a write it can wrap and a TTY flag. */
+export interface GuardedStream {
+    write(chunk: string | Uint8Array, callback?: WriteCallback): boolean;
+    write(chunk: string | Uint8Array, encoding?: BufferEncoding, callback?: WriteCallback): boolean;
+    isTTY?: boolean;
+}
+/** A prompt guard around one output stream. */
+export interface PromptGuard<S extends GuardedStream = GuardedStream> {
+    /** The stream readline should draw on: its write is never guarded. */
+    readonly output: S;
+    /** Route stray writes above the prompt; call once the prompt is drawn. */
+    engage(): void;
+    /** Let writes flow raw; call before a command's output starts. */
+    release(): void;
+    /** Write as the terminal's own, whether or not the guard is engaged. */
+    write(text: string): void;
+}
+/**
+ * Creates a prompt guard around a stream.
+ *
+ * @param stream - The terminal stream; `process.stdout` in a running shell.
+ * @param redraw - Repaints the prompt and the line typed so far.
+ * @returns The guard.
+ */
+export declare function promptGuard_create<S extends GuardedStream>(stream: S, redraw: () => void): PromptGuard<S>;
+export {};

package/dist/core/promptGuard.js

@@ -0,0 +1,71 @@
+/**
+ * @file Keeps a stray write from landing across an idle prompt.
+ *
+ * A REPL waiting at its prompt shares the terminal with everything else
+ * the process writes: another surface's output pushed by the daemon, a
+ * warm-up settling late, a roster row. Written raw, such a line lands on
+ * the prompt line and the prompt is gone until the next keystroke. While
+ * the guard is engaged, a stray write clears the prompt line, lands on a
+ * line of its own, and the prompt is redrawn beneath it with whatever was
+ * typed still in place.
+ *
+ * readline draws through an output whose write bypasses the guard, so the
+ * prompt's own paint is never mistaken for a stray line.
+ *
+ * @module
+ */
+/**
+ * Creates a prompt guard around a stream.
+ *
+ * @param stream - The terminal stream; `process.stdout` in a running shell.
+ * @param redraw - Repaints the prompt and the line typed so far.
+ * @returns The guard.
+ */
+export function promptGuard_create(stream, redraw) {
+    const original = stream.write;
+    const realWrite = (chunk, encodingOrCallback, callback) => {
+        // Normalised to the three-argument form: the stream takes an undefined
+        // encoding as its default, and the callback lands where it belongs.
+        const encoding = typeof encodingOrCallback === 'string' ? encodingOrCallback : undefined;
+        const done = typeof encodingOrCallback === 'function' ? encodingOrCallback : callback;
+        return original.call(stream, chunk, encoding, done);
+    };
+    let engaged = false;
+    const strayWrite = (chunk, encodingOrCallback, callback) => {
+        const text = typeof chunk === 'string' ? chunk : Buffer.from(chunk).toString('utf8');
+        const done = typeof encodingOrCallback === 'function' ? encodingOrCallback : callback;
+        if (stream.isTTY === true)
+            realWrite('\r\x1b[2K');
+        realWrite(text.endsWith('\n') ? text : `${text}\n`);
+        redraw();
+        done?.();
+        return true;
+    };
+    const output = new Proxy(stream, {
+        get(target, property, receiver) {
+            if (property === 'write')
+                return realWrite;
+            const value = Reflect.get(target, property, receiver);
+            return typeof value === 'function' ? value.bind(target) : value;
+        },
+    });
+    return {
+        output,
+        engage() {
+            if (engaged)
+                return;
+            engaged = true;
+            stream.write = strayWrite;
+        },
+        release() {
+            if (!engaged)
+                return;
+            engaged = false;
+            stream.write = original;
+        },
+        write(text) {
+            realWrite(text);
+        },
+    };
+}
+//# sourceMappingURL=promptGuard.js.map

package/dist/core/promptGuard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptGuard.js","sourceRoot":"","sources":["../../src/core/promptGuard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAwBH;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAA0B,MAAS,EAAE,MAAkB;IACvF,MAAM,QAAQ,GAA2B,MAAM,CAAC,KAAK,CAAC;IACtD,MAAM,SAAS,GAAG,CAChB,KAA0B,EAC1B,kBAAmD,EACnD,QAAwB,EACf,EAAE;QACX,uEAAuE;QACvE,oEAAoE;QACpE,MAAM,QAAQ,GAA+B,OAAO,kBAAkB,KAAK,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,SAAS,CAAC;QACrH,MAAM,IAAI,GAA8B,OAAO,kBAAkB,KAAK,UAAU,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,QAAQ,CAAC;QACjH,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IACtD,CAAC,CAAC;IACF,IAAI,OAAO,GAAY,KAAK,CAAC;IAE7B,MAAM,UAAU,GAAG,CACjB,KAA0B,EAC1B,kBAAmD,EACnD,QAAwB,EACf,EAAE;QACX,MAAM,IAAI,GAAW,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC7F,MAAM,IAAI,GAA8B,OAAO,kBAAkB,KAAK,UAAU,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,QAAQ,CAAC;QACjH,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI;YAAE,SAAS,CAAC,WAAW,CAAC,CAAC;QAClD,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;QACpD,MAAM,EAAE,CAAC;QACT,IAAI,EAAE,EAAE,CAAC;QACT,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,MAAM,MAAM,GAAM,IAAI,KAAK,CAAC,MAAM,EAAE;QAClC,GAAG,CAAC,MAAS,EAAE,QAAyB,EAAE,QAAiB;YACzD,IAAI,QAAQ,KAAK,OAAO;gBAAE,OAAO,SAAS,CAAC;YAC3C,MAAM,KAAK,GAAY,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAC/D,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAE,KAAyC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACvG,CAAC;KACF,CAAC,CAAC;IAEH,OAAO;QACL,MAAM;QACN,MAAM;YACJ,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,MAAM,CAAC,KAAK,GAAG,UAAU,CAAC;QAC5B,CAAC;QACD,OAAO;YACL,IAAI,CAAC,OAAO;gBAAE,OAAO;YACrB,OAAO,GAAG,KAAK,CAAC;YAChB,MAAM,CAAC,KAAK,GAAG,QAAQ,CAAC;QAC1B,CAAC;QACD,KAAK,CAAC,IAAY;YAChB,SAAS,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/core/repl.d.ts

@@ -33,6 +33,12 @@ export declare class REPL {
     private lastExitCode;
     private promptText;
     private readonly bytesFetch;
+    /**
+     * Keeps a stray write — another surface's output pushed by the daemon, a
+     * warm-up settling late — from landing across the idle prompt. Engaged
+     * once the prompt is drawn, released before a command's output starts.
+     */
+    private readonly guard;
     /**
      * Initializes the REPL interface around an engine.
      *

package/dist/core/repl.js

@@ -17,6 +17,7 @@ import { cliSurface_create } from './cliSurface.js';
 import { sink_set, StdoutSink } from '@fnndsc/brasa';
 import { TerminalProgressRenderer } from './progressRenderer.js';
 import { surfaceLine_executeSafely } from './surfaceDispatch.js';
+import { promptGuard_create } from './promptGuard.js';
 /**
  * Handles the Read-Eval-Print Loop (REPL) interaction.
  */
@@ -28,6 +29,12 @@ export class REPL {
     lastExitCode = 0;
     promptText;
     bytesFetch;
+    /**
+     * Keeps a stray write — another surface's output pushed by the daemon, a
+     * warm-up settling late — from landing across the idle prompt. Engaged
+     * once the prompt is drawn, released before a command's output starts.
+     */
+    guard;
     /**
      * Initializes the REPL interface around an engine.
      *
@@ -38,9 +45,20 @@ export class REPL {
         this.engine = engine;
         this.promptText = options?.promptText;
         this.bytesFetch = options?.bytesFetch;
+        this.guard = promptGuard_create(process.stdout, () => {
+            try {
+                this.rl.prompt(true);
+            }
+            catch {
+                // Interface might be closed.
+            }
+        });
         this.rl = readline.createInterface({
             input: process.stdin,
-            output: process.stdout,
+            // readline draws through the guard's own output, so the prompt's paint
+            // is never taken for a stray line.
+            output: this.guard.output,
+            terminal: process.stdout.isTTY === true,
             prompt: '> ',
             completer: (line, callback) => {
                 this.engine.line_complete(line)
@@ -66,6 +84,8 @@ export class REPL {
         await this.history_load();
         await this.prompt_update();
         this.rl.on('line', async (line) => {
+            // The line is the command's now; its output flows raw.
+            this.guard.release();
             await this.history_append(line);
             // `exit` quits this shell, never the engine. Closing readline runs the
             // 'close' handler (goodbye, then process exit). Crucially, for a remote
@@ -93,7 +113,7 @@ export class REPL {
             // A cancellable foreground command (currently recursive scans) gets the
             // interrupt first. Otherwise Ctrl+C retains readline's usual behavior:
             // clear an unfinished input line and redraw the prompt.
-            process.stdout.write('\n');
+            this.guard.write('\n');
             if (this.engine.line_cancel?.()) {
                 return;
             }
@@ -102,6 +122,7 @@ export class REPL {
         });
         this.rl.on('close', () => {
             this.isOpen = false;
+            this.guard.release();
             console.log(chalk.cyan('Exiting ChELL. Goodbye!'));
             process.exit(0);
         });
@@ -124,6 +145,7 @@ export class REPL {
             catch (e) {
                 // Interface might be closed
             }
+            this.guard.engage();
             return;
         }
         const rendered = await sessionPrompt_render({
@@ -137,6 +159,7 @@ export class REPL {
         catch (e) {
             // Interface might be closed
         }
+        this.guard.engage();
     }
     /**
      * Loads command history from file.

package/dist/core/repl.js.map

@@ -1 +1 @@
-{"version":3,"file":"repl.js","sourceRoot":"","sources":["../../src/core/repl.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAmB,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AA0BjE;;GAEG;AACH,MAAM,OAAO,IAAI;IACP,EAAE,CAAqB;IACvB,MAAM,CAAc;IACpB,MAAM,GAAY,IAAI,CAAC;IACvB,qBAAqB,GAAW,CAAC,CAAC;IAClC,YAAY,GAAW,CAAC,CAAC;IACzB,UAAU,CAAsC;IACvC,UAAU,CAAyB;IAEpD;;;;;OAKG;IACH,YAAY,MAAmB,EAAE,OAAqB;QACpD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,OAAO,EAAE,UAAU,CAAC;QACtC,IAAI,CAAC,UAAU,GAAG,OAAO,EAAE,UAAU,CAAC;QACtC,IAAI,CAAC,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;YACjC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE,CAAC,IAAY,EAAE,QAAiE,EAAQ,EAAE;gBACnG,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC;qBAC5B,IAAI,CAAC,CAAC,MAAwB,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;oBACvF,mEAAmE;oBACnE,4DAA4D;oBAC5D,kCAAkC;qBACjC,KAAK,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;YAC7C,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,0EAA0E;QAC1E,qEAAqE;QACrE,0EAA0E;QAC1E,yEAAyE;QACzE,MAAM,gBAAgB,GAA6B,IAAI,wBAAwB,EAAE,CAAC;QAClF,QAAQ,CAAC,IAAI,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAC3C,WAAW,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAEzD,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1B,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAE3B,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,IAAY,EAAE,EAAE;YACxC,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;YAEhC,uEAAuE;YACvE,wEAAwE;YACxE,yEAAyE;YACzE,0EAA0E;YAC1E,qEAAqE;YACrE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;gBAC3C,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;gBAChB,OAAO;YACT,CAAC;YAED,MAAM,OAAO,GAAW,IAAI,CAAC,GAAG,EAAE,CAAC;YACnC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,MAAM,yBAAyB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACnD,wEAAwE;YACxE,yEAAyE;YACzE,iEAAiE;YACjE,gBAAgB,CAAC,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;YAClD,IAAI,CAAC,YAAY,GAAI,OAAO,CAAC,QAA+B,IAAI,CAAC,CAAC;YAElE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;YAC7B,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;YACxB,wEAAwE;YACxE,uEAAuE;YACvE,wDAAwD;YACxD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,EAAE,CAAC;gBAChC,OAAO;YACT,CAAC;YACD,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACtC,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACvB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,CAAC;YACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa;QACjB,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QAEzB,wEAAwE;QACxE,uEAAuE;QACvE,kEAAkE;QAClE,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YAClC,MAAM,IAAI,GAAW,OAAO,IAAI,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;YACjG,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YACxB,IAAI,CAAC;gBACH,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC;YACnB,CAAC;YAAC,OAAO,CAAU,EAAE,CAAC;gBACpB,4BAA4B;YAC9B,CAAC;YACD,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAW,MAAM,oBAAoB,CAAC;YAClD,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,qBAAqB,EAAE,IAAI,CAAC,qBAAqB;SAClD,CAAC,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC5B,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC;QACnB,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACpB,4BAA4B;QAC9B,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,YAAY;QACxB,MAAM,IAAI,GAAW,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC;QACjD,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC;gBACH,MAAM,OAAO,GAAW,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBAClE,MAAM,KAAK,GAAa,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;gBACtF,MAAM,KAAK,GAAW,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC;gBAClD,uEAAuE;gBACvE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;YACzD,CAAC;YAAC,OAAO,CAAU,EAAE,CAAC;gBACpB,4CAA4C;YAC9C,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,cAAc,CAAC,IAAY;QACvC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YAAE,OAAO;QACzB,MAAM,IAAI,GAAW,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC;QACjD,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC;QAClD,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACpB,2CAA2C;QAC7C,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"repl.js","sourceRoot":"","sources":["../../src/core/repl.ts"],"names":[],"mappings":"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"}

package/dist/core/startupWarmup.d.ts

@@ -10,6 +10,7 @@
  */
 import { type BrasaEngine, type PrefetchResult } from '@fnndsc/brasa';
 import { type HostControlInputs } from '@fnndsc/calypso';
+import { type DaemonConsoleTarget } from './daemonConsole.js';
 import { type BootStatus } from '../lib/bootsequence.js';
 /** Startup cache selections shared by interactive and daemon modes. */
 export interface StartupWarmupFlags {
@@ -77,11 +78,13 @@ export declare function queryCheckpoint_flush(): Promise<void>;
  * @param user - Authenticated username used to construct the feed path.
  * @param interactive - Whether progress may use an interactive spinner.
  * @param reporter - Host status logger, or null for silent status reporting.
- * @param reportTopologySettlement - Whether to report the asynchronous topology
- *   result; daemon hosts enable this, while interactive hosts use prompt progress.
+ * @param reportSettlement - Whether to report outcomes that arrive after
+ *   boot (the topology walk, the steps warming behind the prompt); daemon
+ *   hosts enable this because the face keeps the readout, while interactive
+ *   hosts use prompt progress.
  * @returns Cache counts and the labels of any failed warm-up operations.
  */
-export declare function startupWarmup_run(flags: StartupWarmupFlags, user: string | undefined, interactive: boolean, reporter: StartupWarmupReporter | null, reportTopologySettlement?: boolean): Promise<StartupWarmupCache>;
+export declare function startupWarmup_run(flags: StartupWarmupFlags, user: string | undefined, interactive: boolean, reporter: StartupWarmupReporter | null, reportSettlement?: boolean): Promise<StartupWarmupCache>;
 /**
  * Warms a connected engine, reports readiness, then publishes its daemon.
  *
@@ -90,5 +93,9 @@ export declare function startupWarmup_run(flags: StartupWarmupFlags, user: strin
  * @param flags - Resource caches selected by daemon boot flags.
  * @param interactive - Whether progress may use an interactive spinner.
  * @param reporter - Daemon boot status logger.
+ * @param recovery - Asks the operator what to do after an exhausted warm-up.
+ * @param hostControlInputs - The host-control policy inputs.
+ * @param console - Puts a surface on this terminal once the daemon is up;
+ *   the daemon console by default, replaceable under test.
  */
-export declare function daemonSession_run(engine: BrasaEngine, user: string | undefined, flags: StartupWarmupFlags, interactive: boolean, reporter: StartupWarmupReporter, recovery?: DaemonWarmupRecovery, hostControlInputs?: HostControlInputs): Promise<void>;
+export declare function daemonSession_run(engine: BrasaEngine, user: string | undefined, flags: StartupWarmupFlags, interactive: boolean, reporter: StartupWarmupReporter, recovery?: DaemonWarmupRecovery, hostControlInputs?: HostControlInputs, console?: (target: DaemonConsoleTarget) => Promise<void>): Promise<void>;