@fnndsc/chell 4.3.2 → 5.0.0

package/dist/core/repl.js

@@ -1,66 +1,78 @@
 /**
  * @file REPL Logic.
  *
- * Manages the Read-Eval-Print Loop using Node.js readline.
+ * The CLI host around the chell engine: a readline loop that reads lines,
+ * hands them to the engine, and owns the terminal-facing concerns (prompt,
+ * history, output sink, interactive questions).
  *
  * @module
  */
 import * as readline from 'readline';
 import * as fs from 'fs';
 import chalk from 'chalk';
-import { session } from '../session/index.js';
-import { input_complete } from '../lib/completer/index.js';
 import { settings } from '../config/settings.js';
-import { context_getSingle } from '@fnndsc/salsa';
-import { prompt_render } from './prompt/index.js';
-import { repl_questionRegister } from './question.js';
-import { procCache_get } from '@fnndsc/cumin';
+import { sessionPrompt_render } from './prompt/session.js';
+import { surface_set } from '@fnndsc/brasa';
+import { cliSurface_create } from './cliSurface.js';
+import { sink_set, StdoutSink } from '@fnndsc/brasa';
+import { TerminalProgressRenderer } from './progressRenderer.js';
+import { surfaceLine_execute } from './surfaceDispatch.js';
 /**
  * Handles the Read-Eval-Print Loop (REPL) interaction.
  */
 export class REPL {
     rl;
+    engine;
     isOpen = true;
     lastCommandDurationMs = 0;
     lastExitCode = 0;
+    promptText;
     /**
-     * Initializes the REPL interface.
+     * Initializes the REPL interface around an engine.
+     *
+     * @param engine - The engine that executes lines and answers completions.
+     * @param options - Optional host settings (e.g. a fixed prompt string).
      */
-    constructor() {
+    constructor(engine, options) {
+        this.engine = engine;
+        this.promptText = options?.promptText;
         this.rl = readline.createInterface({
             input: process.stdin,
             output: process.stdout,
             prompt: '> ',
-            completer: input_complete,
+            completer: (line, callback) => {
+                this.engine.line_complete(line)
+                    .then((result) => callback(null, [result.candidates, result.prefix]))
+                    .catch(() => callback(null, [[], line]));
+            },
         });
     }
     /**
-     * Starts the REPL loop.
-     * @param commandHandler - Async function to process each input line.
+     * Starts the REPL loop, executing each input line through the engine.
      */
-    async start(commandHandler) {
-        repl_questionRegister((prompt) => new Promise((resolve) => {
-            this.rl.question(prompt, (answer) => resolve(answer.trim()));
-        }), (prompt) => {
-            const rlInternal = this.rl;
-            const origWrite = rlInternal._writeToOutput.bind(this.rl);
-            rlInternal._writeToOutput = (_str) => { };
-            process.stdout.write(prompt);
-            return new Promise((resolve) => {
-                this.rl.question('', (answer) => {
-                    rlInternal._writeToOutput = origWrite;
-                    process.stdout.write('\n');
-                    resolve(answer.trim());
-                });
-            });
-        });
+    async start() {
+        // The REPL is the host that owns the interaction channels: command output
+        // reaches the terminal through the sink it installs, and interactive
+        // prompts run through the surface it installs — both backed by the REPL's
+        // single readline interface, so builtins never assume a terminal exists.
+        sink_set(new StdoutSink(new TerminalProgressRenderer()));
+        surface_set(cliSurface_create(this.rl));
         await this.history_load();
         await this.prompt_update();
         this.rl.on('line', async (line) => {
             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
+            // surface this detaches the client and leaves the daemon — and its other
+            // surfaces — running; forwarding `exit` to the engine would instead reach
+            // dispatch's process.exit on the daemon and tear every surface down.
+            if (line.trim().split(/\s+/)[0] === 'exit') {
+                this.rl.close();
+                return;
+            }
             const startMs = Date.now();
             process.exitCode = 0;
-            await commandHandler(line);
+            await surfaceLine_execute(this.engine, line);
             this.lastCommandDurationMs = Date.now() - startMs;
             this.lastExitCode = process.exitCode ?? 0;
             if (this.isOpen) {
@@ -85,24 +97,25 @@ export class REPL {
     async prompt_update() {
         if (!this.isOpen)
             return;
-        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;
-        const ctx = {
-            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(),
-            terminalWidth: process.stdout.columns || 80,
+        // An injected prompt (the remote client) skips local context rendering:
+        // the session lives in the daemon, not this process. It may be a fixed
+        // string or a provider returning the latest daemon-pushed prompt.
+        if (this.promptText !== undefined) {
+            const text = typeof this.promptText === 'function' ? this.promptText() : this.promptText;
+            this.rl.setPrompt(text);
+            try {
+                this.rl.prompt();
+            }
+            catch (e) {
+                // Interface might be closed
+            }
+            return;
+        }
+        const rendered = await sessionPrompt_render({
             lastExitCode: this.lastExitCode,
             lastCommandDurationMs: this.lastCommandDurationMs,
-            p10kSegments: settings.config.p10kSegments,
-            procWarmup,
-        };
-        this.rl.setPrompt(prompt_render(settings.config.promptTheme, ctx));
+        });
+        this.rl.setPrompt(rendered);
         try {
             this.rl.prompt();
         }

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/surfaceDispatch.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @file Surface command interception.
+ *
+ * A few commands are purely frontend-local: they configure how *this* terminal
+ * renders and produce no engine output. `prompt` (theme selection) is the
+ * canonical case — a remote client themes its own prompt, so the engine, which
+ * may be a shared daemon, must never own it. The CLI surface handles these
+ * itself and delegates everything else to the engine.
+ *
+ * @module
+ */
+import type { CommandEnvelope } from '@fnndsc/cumin';
+import type { BrasaEngine } from '@fnndsc/brasa';
+/**
+ * Runs a command line, intercepting surface-local commands before the engine.
+ *
+ * @param engine - The engine that executes non-surface commands.
+ * @param line - The raw command line.
+ * @returns The engine's envelopes, or an empty list for a surface command.
+ */
+export declare function surfaceLine_execute(engine: BrasaEngine, line: string): Promise<CommandEnvelope[]>;

package/dist/core/surfaceDispatch.js

@@ -0,0 +1,33 @@
+/**
+ * @file Surface command interception.
+ *
+ * A few commands are purely frontend-local: they configure how *this* terminal
+ * renders and produce no engine output. `prompt` (theme selection) is the
+ * canonical case — a remote client themes its own prompt, so the engine, which
+ * may be a shared daemon, must never own it. The CLI surface handles these
+ * itself and delegates everything else to the engine.
+ *
+ * @module
+ */
+import { builtin_prompt } from '../builtins/sys/prompt.js';
+/** Commands the CLI surface runs locally and never forwards to the engine. */
+const SURFACE_COMMANDS = {
+    prompt: builtin_prompt,
+};
+/**
+ * Runs a command line, intercepting surface-local commands before the engine.
+ *
+ * @param engine - The engine that executes non-surface commands.
+ * @param line - The raw command line.
+ * @returns The engine's envelopes, or an empty list for a surface command.
+ */
+export async function surfaceLine_execute(engine, line) {
+    const tokens = line.trim().split(/\s+/);
+    const handler = SURFACE_COMMANDS[tokens[0]];
+    if (handler !== undefined) {
+        await handler(tokens.slice(1));
+        return [];
+    }
+    return engine.line_execute(line);
+}
+//# sourceMappingURL=surfaceDispatch.js.map

package/dist/core/surfaceDispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceDispatch.js","sourceRoot":"","sources":["../../src/core/surfaceDispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,8EAA8E;AAC9E,MAAM,gBAAgB,GAAsD;IAC1E,MAAM,EAAE,cAAc;CACvB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,MAAmB,EAAE,IAAY;IACzE,MAAM,MAAM,GAAa,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,OAAO,GAAoD,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7F,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC"}

package/dist/core/warnings.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @file Node deprecation-warning suppression shared by chell's entry points.
+ *
+ * @module
+ */
+/**
+ * Suppresses the DEP0169 `url.parse()` deprecation warning emitted through the
+ * axios -> proxy-from-env dependency chain.
+ *
+ * proxy-from-env 1.1.0 (pulled via axios) still uses `url.parse()`, which
+ * triggers the warning in Node. Safe to remove once that dependency migrates to
+ * the WHATWG URL API or axios drops it.
+ */
+export declare function warnings_suppress(): void;

package/dist/core/warnings.js

@@ -0,0 +1,25 @@
+/**
+ * @file Node deprecation-warning suppression shared by chell's entry points.
+ *
+ * @module
+ */
+/**
+ * Suppresses the DEP0169 `url.parse()` deprecation warning emitted through the
+ * axios -> proxy-from-env dependency chain.
+ *
+ * proxy-from-env 1.1.0 (pulled via axios) still uses `url.parse()`, which
+ * triggers the warning in Node. Safe to remove once that dependency migrates to
+ * the WHATWG URL API or axios drops it.
+ */
+export function warnings_suppress() {
+    const originalEmitWarning = process.emitWarning;
+    process.emitWarning = function (warning, ...args) {
+        if (typeof warning === 'string' &&
+            (warning.includes('DEP0169') || warning.includes('url.parse()'))) {
+            return;
+        }
+        // eslint-disable-next-line prefer-spread
+        return originalEmitWarning.apply(process, [warning, ...args]);
+    };
+}
+//# sourceMappingURL=warnings.js.map

package/dist/core/warnings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"warnings.js","sourceRoot":"","sources":["../../src/core/warnings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,mBAAmB,GAA+B,OAAO,CAAC,WAAW,CAAC;IAC5E,OAAO,CAAC,WAAW,GAAG,UAAU,OAAuB,EAAE,GAAG,IAAe;QACzE,IACE,OAAO,OAAO,KAAK,QAAQ;YAC3B,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,EAChE,CAAC;YACD,OAAO;QACT,CAAC;QACD,yCAAyC;QACzC,OAAQ,mBAAiD,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;IAC/F,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.js

@@ -4,21 +4,11 @@
  *
  * @module
  */
-// Suppress DEP0169 warning from axios/proxy-from-env dependency.
-// proxy-from-env 1.1.0 (pulled via axios) still uses url.parse(), which triggers
-// a deprecation warning in Node. This suppression is safe to remove once that
-// dependency migrates to the WHATWG URL API or axios drops it.
-const originalEmitWarning = process.emitWarning;
-process.emitWarning = function (warning, ...args) {
-    if (typeof warning === 'string' &&
-        (warning.includes('DEP0169') || warning.includes('url.parse()'))) {
-        return;
-    }
-    return originalEmitWarning.call(process, warning, ...args);
-};
 import { fileURLToPath } from 'url';
 import { realpathSync } from 'fs';
+import { warnings_suppress } from './core/warnings.js';
 import { chell_start } from './core/boot.js';
+warnings_suppress();
 const currentFile = fileURLToPath(import.meta.url);
 // Compare real paths to handle symlinks (e.g. global install)
 let isMain = false;

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;GAIG;AAEH,iEAAiE;AACjE,iFAAiF;AACjF,8EAA8E;AAC9E,+DAA+D;AAC/D,MAAM,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;AAChD,OAAO,CAAC,WAAW,GAAG,UAAU,OAAuB,EAAE,GAAG,IAAW;IACrE,IACE,OAAO,OAAO,KAAK,QAAQ;QAC3B,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,EAChE,CAAC;QACD,OAAO;IACT,CAAC;IACD,OAAO,mBAAmB,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;AAC7D,CAAC,CAAC;AAEF,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,WAAW,GAAW,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE3D,8DAA8D;AAC9D,IAAI,MAAM,GAAY,KAAK,CAAC;AAC5B,IAAI,CAAC;IACH,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,YAAY,CAAC,WAAW,CAAC,CAAC;AACvE,CAAC;AAAC,OAAO,CAAU,EAAE,CAAC;IACpB,qBAAqB;AACvB,CAAC;AAED,IAAI,MAAM,EAAE,CAAC;IACX,WAAW,EAAE,CAAC;AAChB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,iBAAiB,EAAE,CAAC;AAEpB,MAAM,WAAW,GAAW,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE3D,8DAA8D;AAC9D,IAAI,MAAM,GAAY,KAAK,CAAC;AAC5B,IAAI,CAAC;IACH,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,YAAY,CAAC,WAAW,CAAC,CAAC;AACvE,CAAC;AAAC,OAAO,CAAU,EAAE,CAAC;IACpB,qBAAqB;AACvB,CAAC;AAED,IAAI,MAAM,EAAE,CAAC;IACX,WAAW,EAAE,CAAC;AAChB,CAAC"}

package/dist/remote/client.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Runs the remote client: discovers a daemon, attaches, and enters the REPL.
+ *
+ * @returns A promise that resolves when the client session ends.
+ */
+export declare function remote_run(): Promise<void>;

package/dist/remote/client.js

@@ -0,0 +1,71 @@
+/**
+ * @file The `chell --remote` client.
+ *
+ * Attaches to a same-user CALYPSO daemon and drives it with the ordinary REPL,
+ * proving the sibling-surfaces topology: the same REPL runs over either an
+ * in-process engine or a remote one. The remote engine delivers received
+ * output to the sink exactly as the local engine delivers live, so the REPL is
+ * unchanged. Another surface's activity (the session bus) is printed as it
+ * arrives.
+ *
+ * @module
+ */
+import chalk from 'chalk';
+import { REPL } from '../core/repl.js';
+import { RemoteEngine } from './remoteEngine.js';
+import { discovery_read } from '@fnndsc/calypso';
+import { surface_get } from '@fnndsc/brasa';
+/**
+ * Runs the remote client: discovers a daemon, attaches, and enters the REPL.
+ *
+ * @returns A promise that resolves when the client session ends.
+ */
+export async function remote_run() {
+    const discovery = discovery_read();
+    if (!discovery) {
+        console.error(chalk.red('[!] No CALYPSO daemon found. Start one with:  chell --daemon'));
+        process.exit(1);
+    }
+    let engine;
+    try {
+        engine = await RemoteEngine.connect({
+            url: discovery.url,
+            token: discovery.token,
+            onSession: (surface, envelope) => {
+                if (envelope.rendered.length > 0) {
+                    process.stdout.write(`\n${chalk.gray(`[surface ${surface.slice(0, 6)}]`)}\n${envelope.rendered}`);
+                }
+            },
+            onPrompt: (message, hidden) => 
+            // The REPL has installed the CLI surface (readline-backed) by the time
+            // a prompt can arrive, so this reads from the local terminal.
+            surface_get().prompt({ message, hidden }),
+            onPipe: (command, input) => 
+            // Pipeline segments run on this machine, through the client's own
+            // tools — never on the daemon host.
+            surface_get().pipeSegment(command, input),
+            onEdit: (content, extension) => 
+            // Editing happens in this machine's editor.
+            surface_get().localEdit({ content, extension }),
+            onClose: () => {
+                console.log(chalk.yellow('\n[!] Daemon disconnected.'));
+                process.exit(0);
+            },
+        });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(chalk.red(`[!] Could not attach to the daemon: ${message}`));
+        process.exit(1);
+        return;
+    }
+    console.log(chalk.green(`[+] Attached to CALYPSO daemon at ${discovery.url}`));
+    console.log(chalk.gray("    Type 'exit' to detach.\n"));
+    // The daemon pushes the themed prompt string; the REPL renders whatever the
+    // daemon last sent, falling back until the first push arrives.
+    const repl = new REPL(engine, {
+        promptText: () => engine.promptLine() || 'chell(remote) ❯ ',
+    });
+    await repl.start();
+}
+//# sourceMappingURL=client.js.map

package/dist/remote/client.js.map

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

package/dist/remote/remoteEngine.d.ts

@@ -0,0 +1,125 @@
+import type { CommandEnvelope } from '@fnndsc/cumin';
+import type { BrasaEngine, CompletionResult } from '@fnndsc/brasa';
+/** Options for connecting a remote engine. */
+export interface RemoteEngineOptions {
+    /** The daemon WebSocket URL, e.g. `ws://127.0.0.1:4300`. */
+    url: string;
+    /** The attach token. */
+    token: string;
+    /** Called with each session-bus broadcast from another surface. */
+    onSession?: (surface: string, envelope: CommandEnvelope) => void;
+    /** Answers a prompt the daemon raised during a command (password, confirmation). */
+    onPrompt?: (message: string, hidden: boolean) => Promise<string>;
+    /** Runs a pipeline segment on this machine and returns its output. */
+    onPipe?: (command: string, input: Buffer) => Promise<Buffer>;
+    /** Opens content in this machine's editor and returns the edited result. */
+    onEdit?: (content: string, extension: string | undefined) => Promise<{
+        content: string;
+        changed: boolean;
+    }>;
+    /** Called when the connection closes unexpectedly. */
+    onClose?: () => void;
+}
+/**
+ * A `BrasaEngine` implementation that drives a remote daemon.
+ */
+export declare class RemoteEngine implements BrasaEngine {
+    private readonly ws;
+    private readonly pending;
+    private readonly onSession;
+    private readonly onPrompt;
+    private readonly onPipe;
+    private readonly onEdit;
+    private latestPrompt;
+    private nextId;
+    private readonly liveEnvelopeChannels;
+    /**
+     * @param ws - An open, already-attached socket to the daemon.
+     * @param options - The callbacks for session broadcasts and prompts.
+     */
+    private constructor();
+    /**
+     * Connects to a daemon, performs the attach handshake, and returns a ready
+     * remote engine.
+     *
+     * @param options - The daemon URL, attach token, and callbacks.
+     * @returns The connected remote engine.
+     * @throws {Error} When the connection fails or the attach is refused.
+     */
+    static connect(options: RemoteEngineOptions): Promise<RemoteEngine>;
+    /** @inheritdoc */
+    line_execute(line: string): Promise<CommandEnvelope[]>;
+    /** @inheritdoc */
+    line_complete(linePrefix: string): Promise<CompletionResult>;
+    /**
+     * Sends a correlated request and returns a promise for its reply.
+     *
+     * @param type - The request message type.
+     * @param fields - The message fields besides `type` and `id`.
+     * @returns The reply payload.
+     */
+    private request;
+    /**
+     * Dispatches a message from the daemon: correlated replies resolve their
+     * pending request, session broadcasts reach the callback, and uncorrelated
+     * errors are surfaced.
+     *
+     * @param payload - The raw message bytes.
+     */
+    private message_handle;
+    /**
+     * Answers a prompt the daemon raised: asks the local surface and sends the
+     * answer back. With no prompt handler, answers empty so the command does not
+     * hang.
+     *
+     * @param promptId - The prompt correlation id.
+     * @param message - The prompt text.
+     * @param hidden - Whether the entry should be hidden (a password).
+     */
+    private prompt_answer;
+    /**
+     * Runs a pipeline segment the daemon asked for on this machine and returns
+     * its output. Data crosses the wire base64-encoded. With no pipe handler,
+     * returns the input unchanged so the pipeline does not hang.
+     *
+     * @param pipeId - The pipe correlation id.
+     * @param command - The segment command line.
+     * @param input - The base64-encoded input bytes.
+     */
+    private pipe_run;
+    /**
+     * Opens content in this machine's editor (the daemon asked for it) and
+     * returns the edited result. With no edit handler, returns the content
+     * unchanged so the command does not hang.
+     *
+     * @param editId - The edit correlation id.
+     * @param content - The content to edit.
+     * @param extension - An optional filename extension.
+     */
+    private edit_run;
+    /**
+     * Renders a streamed output chunk to the local sink on its channel.
+     *
+     * @param channel - The sink channel the chunk belongs to.
+     * @param chunk - The streamed text.
+     */
+    private output_render;
+    /**
+     * Applies a settlement to the pending request for an id, if one exists.
+     *
+     * @param id - The correlation id.
+     * @param settle - The settlement to apply.
+     */
+    private pending_settle;
+    /**
+     * The latest themed prompt string the daemon pushed, or empty before the
+     * first push.
+     *
+     * @returns The current prompt string.
+     */
+    promptLine(): string;
+    /**
+     * Closes the connection.
+     */
+    close(): void;
+}