@fnndsc/chell 5.6.2 → 5.7.0

package/dist/core/daemonConsole.d.ts

@@ -0,0 +1,88 @@
+/**
+ * @file The daemon console: the terminal a daemon booted in becomes its
+ * first surface.
+ *
+ * A Linux boot ends at a login. A daemon boot ended at a resting face — a
+ * brain animation and a status line, with the boot log a keypress away —
+ * that was a screensaver where a session belonged. The identity is already
+ * resolved by the time the engine is ready, so the login is the attach: an
+ * ordinary `chell --remote` surface is put on the daemon's own terminal.
+ *
+ * It is a child process on the wire, not an in-process shortcut. The daemon
+ * process holds one output sink and one interaction surface for every
+ * attached session; a REPL started inside it would take those over and
+ * every other surface would go quiet. A child pays one loopback hop, which
+ * is what every surface pays, and shares nothing else.
+ *
+ * `exit` in the console detaches; the daemon stays up, its terminal idle.
+ * Enter attaches again. Ctrl-C at that idle terminal stops the daemon, as
+ * it always did. While the console holds the terminal, whatever the daemon
+ * itself writes — a roster row, a late warm-up settling — is held and
+ * handed back on detach, so it lands after the surface's last line and
+ * never across its prompt.
+ *
+ * @module
+ */
+import { type ChildProcess } from 'node:child_process';
+import type { EventEmitter } from 'node:events';
+/** What the console needs to know about the daemon it attaches to. */
+export interface DaemonConsoleTarget {
+    identity: string;
+    url: string;
+    token: string;
+}
+/** The running attached surface: settles with its exit code. */
+export interface ConsoleChild {
+    exited: Promise<number>;
+}
+/** The seams the console loop runs on, replaceable under test. */
+export interface DaemonConsoleDeps {
+    /** Starts a `chell --remote` surface on this terminal. */
+    attach: (target: DaemonConsoleTarget) => ConsoleChild;
+    /** Holds the daemon's own console writes. */
+    cage_start: () => void;
+    /** Hands back what was held. */
+    cage_stop: () => string[];
+    /** Resolves true on Enter, false when the terminal's input ends. */
+    enter_wait: () => Promise<boolean>;
+    /** The terminal's own line writer. */
+    log: (line: string) => void;
+}
+/** The chell entry this module was built beside: the surface to spawn. */
+export declare const CHELL_ENTRY: string;
+/** What the spawner needs of a child: its exit and error events. */
+export type SpawnedChild = Pick<ChildProcess, 'once'>;
+/** A process spawner with the shape of `child_process.spawn`. */
+export type Spawn = (command: string, args: string[], options: {
+    stdio: 'inherit';
+    env: NodeJS.ProcessEnv;
+}) => SpawnedChild;
+/** What the Enter wait needs of the terminal's input. */
+export type ConsoleInput = Pick<EventEmitter, 'on' | 'once' | 'off'> & {
+    resume(): unknown;
+    pause(): unknown;
+};
+/**
+ * Starts a remote chell surface on this terminal, attached by address.
+ *
+ * @param target - The daemon's wire address and token.
+ * @param spawn - The process spawner; `child_process.spawn` by default.
+ * @returns The child, settling with its exit code when the operator detaches.
+ */
+export declare function surface_spawn(target: DaemonConsoleTarget, spawn?: Spawn): ConsoleChild;
+/**
+ * Waits for the operator to press Enter at the idle daemon terminal.
+ *
+ * @param input - The terminal's input; `process.stdin` by default.
+ * @returns True on a line of input; false when the input ends.
+ */
+export declare function enter_await(input?: ConsoleInput): Promise<boolean>;
+/**
+ * Runs the daemon console until the operator leaves the terminal idle for
+ * good: attach, detach on `exit`, attach again on Enter, until stdin ends.
+ *
+ * @param target - The daemon to attach to.
+ * @param deps - The seams; the live ones by default.
+ * @returns Resolves when the operator will not attach again.
+ */
+export declare function daemonConsole_run(target: DaemonConsoleTarget, deps?: DaemonConsoleDeps): Promise<void>;

package/dist/core/daemonConsole.js

@@ -0,0 +1,130 @@
+/**
+ * @file The daemon console: the terminal a daemon booted in becomes its
+ * first surface.
+ *
+ * A Linux boot ends at a login. A daemon boot ended at a resting face — a
+ * brain animation and a status line, with the boot log a keypress away —
+ * that was a screensaver where a session belonged. The identity is already
+ * resolved by the time the engine is ready, so the login is the attach: an
+ * ordinary `chell --remote` surface is put on the daemon's own terminal.
+ *
+ * It is a child process on the wire, not an in-process shortcut. The daemon
+ * process holds one output sink and one interaction surface for every
+ * attached session; a REPL started inside it would take those over and
+ * every other surface would go quiet. A child pays one loopback hop, which
+ * is what every surface pays, and shares nothing else.
+ *
+ * `exit` in the console detaches; the daemon stays up, its terminal idle.
+ * Enter attaches again. Ctrl-C at that idle terminal stops the daemon, as
+ * it always did. While the console holds the terminal, whatever the daemon
+ * itself writes — a roster row, a late warm-up settling — is held and
+ * handed back on detach, so it lands after the surface's last line and
+ * never across its prompt.
+ *
+ * @module
+ */
+import { spawn as childSpawn } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+import chalk from 'chalk';
+import { consoleCage_start, consoleCage_stop } from '@fnndsc/calypso';
+/** The chell entry this module was built beside: the surface to spawn. */
+export const CHELL_ENTRY = fileURLToPath(new URL('../index.js', import.meta.url));
+/**
+ * Starts a remote chell surface on this terminal, attached by address.
+ *
+ * @param target - The daemon's wire address and token.
+ * @param spawn - The process spawner; `child_process.spawn` by default.
+ * @returns The child, settling with its exit code when the operator detaches.
+ */
+export function surface_spawn(target, spawn = childSpawn) {
+    // The identity rides along so the surface greets with it, not with the
+    // address twice; the environment mark tells it whose terminal it is on,
+    // so it skips the greeting the daemon's banner already gave.
+    const child = spawn(process.execPath, [CHELL_ENTRY, '--remote', target.identity, '--attach', target.url, '--token', target.token], { stdio: 'inherit', env: { ...process.env, CHELL_CONSOLE: '1' } });
+    const exited = new Promise((resolve) => {
+        child.once('exit', (code) => { resolve(code ?? 0); });
+        child.once('error', () => { resolve(1); });
+    });
+    return { exited };
+}
+/**
+ * Waits for the operator to press Enter at the idle daemon terminal.
+ *
+ * @param input - The terminal's input; `process.stdin` by default.
+ * @returns True on a line of input; false when the input ends.
+ */
+export function enter_await(input = process.stdin) {
+    return new Promise((resolve) => {
+        const cleanup = () => {
+            input.off('data', onData);
+            input.off('end', onEnd);
+            input.pause();
+        };
+        const onData = () => { cleanup(); resolve(true); };
+        const onEnd = () => { cleanup(); resolve(false); };
+        input.on('data', onData);
+        input.once('end', onEnd);
+        input.resume();
+    });
+}
+/** The live seams: a real child on the wire, the real cage, the real terminal. */
+const LIVE_DEPS = {
+    attach: (target) => surface_spawn(target),
+    cage_start: consoleCage_start,
+    cage_stop: consoleCage_stop,
+    enter_wait: () => enter_await(),
+    log: (line) => { console.log(line); },
+};
+/**
+ * Holds the terminal's interrupt while a surface has it.
+ *
+ * The surface's readline owns Ctrl-C while attached (it clears the typed
+ * line, as chell always has); the daemon's own stop-on-interrupt is put
+ * back once the surface detaches, so Ctrl-C at the idle terminal stops
+ * the daemon as before.
+ *
+ * @returns A restore function.
+ */
+function interrupt_hold() {
+    const held = process.listeners('SIGINT');
+    process.removeAllListeners('SIGINT');
+    const ignore = () => { };
+    process.on('SIGINT', ignore);
+    return () => {
+        process.off('SIGINT', ignore);
+        for (const listener of held)
+            process.on('SIGINT', listener);
+    };
+}
+/**
+ * Runs the daemon console until the operator leaves the terminal idle for
+ * good: attach, detach on `exit`, attach again on Enter, until stdin ends.
+ *
+ * @param target - The daemon to attach to.
+ * @param deps - The seams; the live ones by default.
+ * @returns Resolves when the operator will not attach again.
+ */
+export async function daemonConsole_run(target, deps = LIVE_DEPS) {
+    for (;;) {
+        deps.log(chalk.green(`[+] Console attached to ${target.identity} — 'exit' detaches, Enter attaches again, Ctrl-C then stops the daemon`));
+        deps.cage_start();
+        const restore = interrupt_hold();
+        let held;
+        try {
+            await deps.attach(target).exited;
+        }
+        finally {
+            restore();
+            held = deps.cage_stop();
+        }
+        if (held.length > 0) {
+            deps.log(chalk.gray('[+] While the console was attached:'));
+            for (const line of held)
+                deps.log(line);
+        }
+        deps.log(chalk.green('[+] Console detached; the daemon is still running. Enter attaches again, Ctrl-C stops the daemon.'));
+        if (!(await deps.enter_wait()))
+            return;
+    }
+}
+//# 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":"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"}

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":"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"}
+{"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>;