@fnndsc/calypso 0.6.0 → 0.7.0

package/dist/daemon/face.js

@@ -0,0 +1,419 @@
+/**
+ * @file The daemon console face: the terminal's resting state once booted.
+ *
+ * A daemon's terminal has no REPL competing for the screen, so after boot it
+ * becomes an instrument panel: the mise brain pulsing on the alternate screen
+ * buffer, the daemon's identity and addresses beside it, and a short strip of
+ * the latest log lines beneath. The alternate buffer never scrolls, so the
+ * animation anchors at absolute coordinates — none of the cursor arithmetic
+ * that made the boot-phase pulse fight its own log output.
+ *
+ * The pulse is honest: idle is a slow ambient shimmer, an executing command
+ * quickens it, and a surface attaching or detaching flares it briefly.
+ *
+ * Esc or `q` drops to the normal buffer — the full boot log restored exactly,
+ * with the lines captured while the face was up flushed beneath it — and any
+ * key returns. Ctrl-C stops the daemon from either mode.
+ *
+ * @module
+ */
+import chalk from 'chalk';
+import { logo_frameRender, logoColumns_count, logoRows_count } from '@fnndsc/brasa';
+/** Strips ANSI escapes for width math and log-strip storage. */
+const ESCAPE_PATTERN = /\x1b(?:\[[0-?]*[ -/]*[@-~]|\][^\x07\x1b]*(?:\x07|\x1b\\)|[@-Z\\-_])/g;
+/** Log lines kept for the drop-to-text flush. */
+const RING_CAPACITY = 400;
+/** Log lines shown in the steady face's strip. */
+const STRIP_LINES = 5;
+/** Log lines shown while booting — the messages are the point then. */
+const BOOT_STRIP_LINES = 10;
+/** Frame period. */
+const TICK_MS = 100;
+/** Ambient pulse advances one frame per this many ticks. */
+const AMBIENT_STRIDE = 3;
+/** How long an attach/detach flare quickens the pulse. */
+const FLARE_MS = 1500;
+/**
+ * A bounded line buffer for output arriving while the face owns the screen.
+ *
+ * Everything a stray `console.log` (a retry warning, a background sweep
+ * report) writes is caged here: the newest lines feed the face's strip, and
+ * the whole run since the last flush is replayed into the normal buffer when
+ * the operator drops to text — so nothing is ever lost, only re-homed.
+ */
+export class FaceLogRing {
+    lines = [];
+    pending = '';
+    unflushed = 0;
+    /**
+     * Absorbs one raw write, splitting it into stripped, stored lines.
+     *
+     * A carriage return without a newline is a redraw (a spinner frame): it
+     * discards what preceded it on the line rather than appending, so a
+     * thousand frames stay one line, not one enormous one.
+     *
+     * @param chunk - The text a hijacked stdout/stderr write carried.
+     */
+    push(chunk) {
+        const text = this.pending + chunk.replace(ESCAPE_PATTERN, '');
+        const parts = text.split('\n');
+        this.pending = (parts.pop() ?? '').split('\r').pop() ?? '';
+        for (const part of parts) {
+            const line = part.split('\r').pop() ?? '';
+            this.lines.push(line);
+            this.unflushed += 1;
+        }
+        if (this.lines.length > RING_CAPACITY) {
+            const excess = this.lines.length - RING_CAPACITY;
+            this.lines.splice(0, excess);
+            this.unflushed = Math.min(this.unflushed, this.lines.length);
+        }
+    }
+    /**
+     * The newest lines, for the face's log strip.
+     *
+     * @param count - How many lines the strip shows.
+     * @returns Up to `count` lines, oldest first.
+     */
+    tail(count) {
+        return this.lines.slice(-count);
+    }
+    /**
+     * Returns and forgets the lines not yet replayed into the normal buffer.
+     *
+     * @returns The unflushed lines, oldest first.
+     */
+    drain() {
+        const drained = this.unflushed === 0 ? [] : this.lines.slice(-this.unflushed);
+        this.unflushed = 0;
+        return drained;
+    }
+}
+/**
+ * Formats an uptime as `2d 03:14:07` / `03:14:07`.
+ *
+ * @param seconds - Whole seconds since the daemon came up.
+ * @returns The formatted uptime.
+ */
+export function uptime_format(seconds) {
+    const days = Math.floor(seconds / 86400);
+    const pad = (n) => String(n).padStart(2, '0');
+    const clock = `${pad(Math.floor((seconds % 86400) / 3600))}:${pad(Math.floor((seconds % 3600) / 60))}:${pad(Math.floor(seconds % 60))}`;
+    return days > 0 ? `${days}d ${clock}` : clock;
+}
+/**
+ * Truncates a plain (escape-free) line to the terminal width.
+ *
+ * @param line - The plain line.
+ * @param columns - The terminal width.
+ * @returns The line, cut so it can never wrap.
+ */
+function line_clip(line, columns) {
+    return line.length > columns ? line.slice(0, Math.max(0, columns - 1)) + '…' : line;
+}
+/**
+ * Composes one face frame as screen lines, top to bottom. Pure: no terminal
+ * control, no timers — the runtime places these under the alternate buffer
+ * and the tests read them directly.
+ *
+ * @param frame - The readings and geometry for this frame.
+ * @returns The lines to paint, at most `frame.rows - 1` of them.
+ */
+export function face_frameCompose(frame) {
+    return frame.phase === 'boot' ? bootFrame_compose(frame) : readyFrame_compose(frame);
+}
+/** Centers one plain line, colored after clipping. */
+function centered_line(text, columns, paint) {
+    const clipped = line_clip(text, columns);
+    const pad = ' '.repeat(Math.max(0, Math.floor((columns - clipped.length) / 2)));
+    return pad + paint(clipped);
+}
+/**
+ * The boot flavor: the brain over a headline and a tall strip of the
+ * streaming boot log. (Kept for hosts that want an animated boot on the
+ * alternate screen; the chell daemon boot uses the classic in-scroll boot.)
+ */
+function bootFrame_compose(frame) {
+    const lines = [];
+    const stripHeight = frame.logTail.length > 0 ? frame.logTail.length + 1 : 0;
+    const brainFits = logoRows_count() + stripHeight + 5 <= frame.rows - 1 && logoColumns_count() <= frame.columns;
+    if (brainFits) {
+        const indent = ' '.repeat(Math.max(0, Math.floor((frame.columns - logoColumns_count()) / 2)));
+        for (const brainLine of logo_frameRender(frame.frameIndex)) {
+            lines.push(indent + brainLine);
+        }
+        lines.push('');
+    }
+    lines.push(centered_line('SYSTEMS INITIALIZING', frame.columns, chalk.cyan));
+    lines.push('');
+    if (frame.logTail.length > 0) {
+        lines.push(chalk.gray('  ' + '─'.repeat(Math.min(40, Math.max(0, frame.columns - 4)))));
+        for (const logLine of frame.logTail) {
+            lines.push(chalk.gray(line_clip(`  ${logLine}`, frame.columns)));
+        }
+    }
+    return lines.slice(0, Math.max(0, frame.rows - 1));
+}
+/**
+ * The steady face, minimal by law: the animating brain, one status line,
+ * and the toggle hint — vertically centered. Everything informational (the
+ * addresses, the boot report) lives on the Esc side, verbatim.
+ */
+function readyFrame_compose(frame) {
+    const busy = frame.telemetry?.busy ?? false;
+    const status = busy ? 'DAEMON RUNNING · ENGINE EXECUTING' : 'DAEMON RUNNING · SESSION ESTABLISHED';
+    const hint = 'HIT ESC TO TOGGLE THE BOOT LOG · CTRL-C STOPS THE DAEMON';
+    const content = [];
+    const brainFits = logoRows_count() + 5 <= frame.rows - 1 && logoColumns_count() <= frame.columns;
+    if (brainFits) {
+        const indent = ' '.repeat(Math.max(0, Math.floor((frame.columns - logoColumns_count()) / 2)));
+        for (const brainLine of logo_frameRender(frame.frameIndex)) {
+            content.push(indent + brainLine);
+        }
+        content.push('');
+    }
+    content.push(centered_line(status, frame.columns, chalk.cyan));
+    content.push('');
+    content.push(centered_line(hint, frame.columns, chalk.gray));
+    const topPad = Math.max(0, Math.floor((frame.rows - 1 - content.length) / 2));
+    const lines = [...Array(topPad).fill(''), ...content];
+    return lines.slice(0, Math.max(0, frame.rows - 1));
+}
+let state = null;
+/** Whether the console face currently owns the terminal. */
+export function face_isActive() {
+    return state !== null;
+}
+/**
+ * Routes stray writes into the ring while the face owns the screen.
+ */
+function writes_hijack() {
+    if (state === null)
+        return;
+    const active = state;
+    const capture = ((chunk) => {
+        const text = typeof chunk === 'string' ? chunk : Buffer.from(chunk).toString('utf8');
+        active.ring.push(text);
+        return true;
+    });
+    process.stdout.write = capture;
+    process.stderr.write = capture;
+}
+/** Restores the terminal's own writes. */
+function writes_restore() {
+    if (state === null)
+        return;
+    process.stdout.write = state.stdoutWrite;
+    process.stderr.write = state.stderrWrite;
+}
+/**
+ * Paints one frame: home the cursor, draw every composed line with a
+ * clear-to-end, then clear everything below. No full-screen erase per frame,
+ * so the repaint never flickers.
+ */
+function frame_paint() {
+    if (state === null)
+        return;
+    const telemetry = state.options.telemetry_get?.() ?? null;
+    if (telemetry !== null && telemetry.sessions !== state.lastSessions) {
+        state.flareUntil = Date.now() + FLARE_MS;
+        state.lastSessions = telemetry.sessions;
+    }
+    const quickened = (telemetry?.busy ?? false) || Date.now() < state.flareUntil;
+    state.tick += 1;
+    if (state.phase === 'boot') {
+        // Booting is frenetic: the pulse races while the machine comes up.
+        state.frameIndex += 2;
+    }
+    else if (quickened || state.tick % AMBIENT_STRIDE === 0) {
+        state.frameIndex += 1;
+    }
+    const lines = face_frameCompose({
+        rows: process.stdout.rows || 24,
+        columns: process.stdout.columns || 80,
+        frameIndex: state.frameIndex,
+        phase: state.phase,
+        info: state.options.info,
+        telemetry,
+        logTail: state.ring.tail(state.phase === 'boot' ? BOOT_STRIP_LINES : STRIP_LINES),
+        uptimeSeconds: Math.floor((Date.now() - state.startedAt) / 1000),
+    });
+    state.realOut('\x1b[H' + lines.map((line) => line + '\x1b[K').join('\r\n') + '\x1b[J');
+}
+/** Enters (or re-enters) the alternate-buffer face. */
+function face_enter() {
+    if (state === null || state.mode === 'face')
+        return;
+    state.mode = 'face';
+    writes_hijack();
+    state.realOut('\x1b[?1049h\x1b[?25l');
+    frame_paint();
+    state.interval = setInterval(frame_paint, TICK_MS);
+}
+/**
+ * Drops to the normal buffer: the boot log restored exactly, the lines the
+ * face caged flushed beneath it, and a hint on the way back.
+ */
+function text_drop() {
+    if (state === null || state.mode === 'text')
+        return;
+    state.mode = 'text';
+    if (state.interval !== null) {
+        clearInterval(state.interval);
+        state.interval = null;
+    }
+    writes_restore();
+    state.realOut('\x1b[?1049l\x1b[?25h');
+    for (const line of state.ring.drain()) {
+        state.realOut(line + '\n');
+    }
+    state.realOut(chalk.gray('[face] any key returns to the console face; Ctrl-C stops the daemon\n'));
+}
+/**
+ * Takes the daemon terminal over as the console face.
+ *
+ * A no-op off a TTY (systemd, nohup, a pipe): the daemon then logs
+ * sequentially exactly as before.
+ *
+ * @param options - Identity rows and live-telemetry hook.
+ * @returns True when the face took the screen.
+ */
+export function face_start(options, phase = 'ready') {
+    if (state !== null)
+        return true;
+    if (!process.stdout.isTTY || !process.stdin.isTTY || typeof process.stdin.setRawMode !== 'function') {
+        return false;
+    }
+    const realOutWrite = process.stdout.write.bind(process.stdout);
+    const realErrWrite = process.stderr.write.bind(process.stderr);
+    const exitRestore = () => {
+        // The process is dying with the face up: put the operator's terminal
+        // back — normal buffer, visible cursor — whatever else is going on.
+        if (state === null)
+            return;
+        writes_restore();
+        if (state.mode === 'face')
+            realOutWrite('\x1b[?1049l\x1b[?25h');
+    };
+    const keyHandler = (data) => {
+        if (state === null)
+            return;
+        if (data.includes(0x03)) {
+            // Raw mode swallows the terminal's own Ctrl-C; re-raise it so the
+            // daemon's ordinary shutdown path (berth cleanup included) runs.
+            face_stop();
+            process.kill(process.pid, 'SIGINT');
+            return;
+        }
+        if (state.mode === 'face') {
+            const key = data.toString('utf8');
+            if (key === 'q' || key === 'Q' || key === '\x1b')
+                text_drop();
+        }
+        else {
+            face_enter();
+        }
+    };
+    state = {
+        options,
+        ring: new FaceLogRing(),
+        mode: 'text',
+        phase,
+        suspended: false,
+        interval: null,
+        frameIndex: 0,
+        tick: 0,
+        startedAt: Date.now(),
+        flareUntil: 0,
+        lastSessions: options.telemetry_get?.().sessions ?? 0,
+        realOut: (chunk) => { realOutWrite(chunk); },
+        realErr: (chunk) => { realErrWrite(chunk); },
+        stdoutWrite: process.stdout.write,
+        stderrWrite: process.stderr.write,
+        keyHandler,
+        exitRestore,
+    };
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdin.on('data', keyHandler);
+    process.once('exit', exitRestore);
+    face_enter();
+    return true;
+}
+/**
+ * Takes the terminal over for the boot phase: the brain in its frenetic
+ * boot pulse over a tall strip of the streaming boot log — no identity
+ * panel yet, because there is nothing to identify. A no-op off a TTY.
+ *
+ * @returns True when the boot face took the screen.
+ */
+export function face_boot() {
+    return face_start({ info: [] }, 'boot');
+}
+/**
+ * Settles the face into its steady state: the calm ambient pulse, the
+ * identity panel, live telemetry, and the toggle hint. Called on a face
+ * already up (the boot phase) it repaints in place; called with no face
+ * (a host that skipped the boot phase) it starts one. Off a TTY, nothing.
+ *
+ * @param options - Identity rows and live-telemetry hook.
+ * @returns True when a face is showing the steady state.
+ */
+export function face_ready(options) {
+    if (state === null) {
+        return face_start(options);
+    }
+    state.options = options;
+    state.phase = 'ready';
+    state.lastSessions = options.telemetry_get?.().sessions ?? state.lastSessions;
+    if (state.mode === 'face')
+        frame_paint();
+    return true;
+}
+/**
+ * Steps aside for an interactive prompt: the terminal returns to the
+ * normal buffer with cooked stdin, and the face's key handler stops
+ * listening so the prompt's readline owns every keystroke.
+ */
+export function face_suspend() {
+    if (state === null || state.suspended)
+        return;
+    state.suspended = true;
+    if (state.mode !== 'text')
+        text_drop();
+    process.stdin.off('data', state.keyHandler);
+    if (typeof process.stdin.setRawMode === 'function')
+        process.stdin.setRawMode(false);
+}
+/** Returns from a prompt: raw keys again, and back onto the face. */
+export function face_resume() {
+    if (state === null || !state.suspended)
+        return;
+    state.suspended = false;
+    if (typeof process.stdin.setRawMode === 'function')
+        process.stdin.setRawMode(true);
+    process.stdin.on('data', state.keyHandler);
+    face_enter();
+}
+/** Releases the terminal entirely: buffers, writes, raw mode, listeners. */
+export function face_stop() {
+    if (state === null)
+        return;
+    if (state.interval !== null)
+        clearInterval(state.interval);
+    writes_restore();
+    if (state.mode === 'face')
+        state.realOut('\x1b[?1049l\x1b[?25h');
+    // Lines still caged in the ring (a dying boot's abort reason, say) land
+    // in the normal buffer rather than vanishing with the face.
+    for (const line of state.ring.drain()) {
+        state.realOut(line + '\n');
+    }
+    process.stdin.off('data', state.keyHandler);
+    if (typeof process.stdin.setRawMode === 'function')
+        process.stdin.setRawMode(false);
+    process.stdin.pause();
+    process.off('exit', state.exitRestore);
+    state = null;
+}
+//# sourceMappingURL=face.js.map

package/dist/daemon/face.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"face.js","sourceRoot":"","sources":["../../src/daemon/face.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AA4BpF,gEAAgE;AAChE,MAAM,cAAc,GAAW,sEAAsE,CAAC;AAEtG,iDAAiD;AACjD,MAAM,aAAa,GAAW,GAAG,CAAC;AAClC,kDAAkD;AAClD,MAAM,WAAW,GAAW,CAAC,CAAC;AAC9B,uEAAuE;AACvE,MAAM,gBAAgB,GAAW,EAAE,CAAC;AACpC,oBAAoB;AACpB,MAAM,OAAO,GAAW,GAAG,CAAC;AAC5B,4DAA4D;AAC5D,MAAM,cAAc,GAAW,CAAC,CAAC;AACjC,0DAA0D;AAC1D,MAAM,QAAQ,GAAW,IAAI,CAAC;AAE9B;;;;;;;GAOG;AACH,MAAM,OAAO,WAAW;IACd,KAAK,GAAa,EAAE,CAAC;IACrB,OAAO,GAAW,EAAE,CAAC;IACrB,SAAS,GAAW,CAAC,CAAC;IAE9B;;;;;;;;OAQG;IACI,IAAI,CAAC,KAAa;QACvB,MAAM,IAAI,GAAW,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QACtE,MAAM,KAAK,GAAa,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;QAC3D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,IAAI,GAAW,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;YAClD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtB,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;QACtB,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,aAAa,EAAE,CAAC;YACtC,MAAM,MAAM,GAAW,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,aAAa,CAAC;YACzD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;YAC7B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACI,IAAI,CAAC,KAAa;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACI,KAAK;QACV,MAAM,OAAO,GAAa,IAAI,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxF,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QACnB,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAeD;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,MAAM,IAAI,GAAW,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,CAAC;IACjD,MAAM,GAAG,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC9D,MAAM,KAAK,GACT,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;IAC5H,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AAChD,CAAC;AAED;;;;;;GAMG;AACH,SAAS,SAAS,CAAC,IAAY,EAAE,OAAe;IAC9C,OAAO,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACtF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAgB;IAChD,OAAO,KAAK,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;AACvF,CAAC;AAED,sDAAsD;AACtD,SAAS,aAAa,CAAC,IAAY,EAAE,OAAe,EAAE,KAA4B;IAChF,MAAM,OAAO,GAAW,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACjD,MAAM,GAAG,GAAW,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACxF,OAAO,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;AAC9B,CAAC;AAED;;;;GAIG;AACH,SAAS,iBAAiB,CAAC,KAAgB;IACzC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,WAAW,GAAW,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpF,MAAM,SAAS,GACb,cAAc,EAAE,GAAG,WAAW,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,iBAAiB,EAAE,IAAI,KAAK,CAAC,OAAO,CAAC;IAE/F,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,MAAM,GAAW,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,OAAO,GAAG,iBAAiB,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACtG,KAAK,MAAM,SAAS,IAAI,gBAAgB,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3D,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;QACjC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,sBAAsB,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxF,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,OAAO,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,SAAS,kBAAkB,CAAC,KAAgB;IAC1C,MAAM,IAAI,GAAY,KAAK,CAAC,SAAS,EAAE,IAAI,IAAI,KAAK,CAAC;IACrD,MAAM,MAAM,GAAW,IAAI,CAAC,CAAC,CAAC,mCAAmC,CAAC,CAAC,CAAC,sCAAsC,CAAC;IAC3G,MAAM,IAAI,GAAW,0DAA0D,CAAC;IAEhF,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,SAAS,GACb,cAAc,EAAE,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,iBAAiB,EAAE,IAAI,KAAK,CAAC,OAAO,CAAC;IACjF,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,MAAM,GAAW,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,OAAO,GAAG,iBAAiB,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACtG,KAAK,MAAM,SAAS,IAAI,gBAAgB,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3D,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/D,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAE7D,MAAM,MAAM,GAAW,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACtF,MAAM,KAAK,GAAa,CAAC,GAAG,KAAK,CAAS,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC;IACxE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;AACrD,CAAC;AAuBD,IAAI,KAAK,GAAqB,IAAI,CAAC;AAEnC,4DAA4D;AAC5D,MAAM,UAAU,aAAa;IAC3B,OAAO,KAAK,KAAK,IAAI,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,SAAS,aAAa;IACpB,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO;IAC3B,MAAM,MAAM,GAAc,KAAK,CAAC;IAChC,MAAM,OAAO,GAAG,CAAC,CAAC,KAA0B,EAAW,EAAE;QACvD,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,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC,CAAgC,CAAC;IAClC,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC;IAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,OAAsC,CAAC;AAChE,CAAC;AAED,0CAA0C;AAC1C,SAAS,cAAc;IACrB,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO;IAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC,WAAW,CAAC;IACzC,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC,WAAW,CAAC;AAC3C,CAAC;AAED;;;;GAIG;AACH,SAAS,WAAW;IAClB,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO;IAC3B,MAAM,SAAS,GAAyB,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,IAAI,IAAI,CAAC;IAEhF,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,CAAC,QAAQ,KAAK,KAAK,CAAC,YAAY,EAAE,CAAC;QACpE,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC;QACzC,KAAK,CAAC,YAAY,GAAG,SAAS,CAAC,QAAQ,CAAC;IAC1C,CAAC;IACD,MAAM,SAAS,GAAY,CAAC,SAAS,EAAE,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC;IACvF,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC;IAChB,IAAI,KAAK,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;QAC3B,mEAAmE;QACnE,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;IACxB,CAAC;SAAM,IAAI,SAAS,IAAI,KAAK,CAAC,IAAI,GAAG,cAAc,KAAK,CAAC,EAAE,CAAC;QAC1D,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,MAAM,KAAK,GAAa,iBAAiB,CAAC;QACxC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE;QAC/B,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE;QACrC,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI;QACxB,SAAS;QACT,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,WAAW,CAAC;QACjF,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;KACjE,CAAC,CAAC;IACH,KAAK,CAAC,OAAO,CAAC,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC;AACzG,CAAC;AAED,uDAAuD;AACvD,SAAS,UAAU;IACjB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO;IACpD,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC;IACpB,aAAa,EAAE,CAAC;IAChB,KAAK,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACtC,WAAW,EAAE,CAAC;IACd,KAAK,CAAC,QAAQ,GAAG,WAAW,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,SAAS,SAAS;IAChB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO;IACpD,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC;IACpB,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC5B,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC9B,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;IACxB,CAAC;IACD,cAAc,EAAE,CAAC;IACjB,KAAK,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACtC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;QACtC,KAAK,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,uEAAuE,CAAC,CAAC,CAAC;AACrG,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,OAAoB,EAAE,QAA0B,OAAO;IAChF,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,OAAO,OAAO,CAAC,KAAK,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QACpG,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,YAAY,GAAgC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5F,MAAM,YAAY,GAAgC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5F,MAAM,WAAW,GAAG,GAAS,EAAE;QAC7B,qEAAqE;QACrE,oEAAoE;QACpE,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO;QAC3B,cAAc,EAAE,CAAC;QACjB,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;YAAE,YAAY,CAAC,sBAAsB,CAAC,CAAC;IAClE,CAAC,CAAC;IACF,MAAM,UAAU,GAAG,CAAC,IAAY,EAAQ,EAAE;QACxC,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO;QAC3B,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,kEAAkE;YAClE,iEAAiE;YACjE,SAAS,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YACpC,OAAO;QACT,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC1B,MAAM,GAAG,GAAW,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC1C,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,MAAM;gBAAE,SAAS,EAAE,CAAC;QAChE,CAAC;aAAM,CAAC;YACN,UAAU,EAAE,CAAC;QACf,CAAC;IACH,CAAC,CAAC;IAEF,KAAK,GAAG;QACN,OAAO;QACP,IAAI,EAAE,IAAI,WAAW,EAAE;QACvB,IAAI,EAAE,MAAM;QACZ,KAAK;QACL,SAAS,EAAE,KAAK;QAChB,QAAQ,EAAE,IAAI;QACd,UAAU,EAAE,CAAC;QACb,IAAI,EAAE,CAAC;QACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,UAAU,EAAE,CAAC;QACb,YAAY,EAAE,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,QAAQ,IAAI,CAAC;QACrD,OAAO,EAAE,CAAC,KAAa,EAAQ,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1D,OAAO,EAAE,CAAC,KAAa,EAAQ,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1D,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK;QACjC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK;QACjC,UAAU;QACV,WAAW;KACZ,CAAC;IAEF,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC/B,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IACvB,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAElC,UAAU,EAAE,CAAC;IACb,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,UAAU,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,OAAoB;IAC7C,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IACD,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;IACxB,KAAK,CAAC,KAAK,GAAG,OAAO,CAAC;IACtB,KAAK,CAAC,YAAY,GAAG,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,QAAQ,IAAI,KAAK,CAAC,YAAY,CAAC;IAC9E,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;QAAE,WAAW,EAAE,CAAC;IACzC,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC1B,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,SAAS;QAAE,OAAO;IAC9C,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;IACvB,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;QAAE,SAAS,EAAE,CAAC;IACvC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAC5C,IAAI,OAAO,OAAO,CAAC,KAAK,CAAC,UAAU,KAAK,UAAU;QAAE,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;AACtF,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,WAAW;IACzB,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS;QAAE,OAAO;IAC/C,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC;IACxB,IAAI,OAAO,OAAO,CAAC,KAAK,CAAC,UAAU,KAAK,UAAU;QAAE,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACnF,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAC3C,UAAU,EAAE,CAAC;AACf,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,SAAS;IACvB,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO;IAC3B,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI;QAAE,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC3D,cAAc,EAAE,CAAC;IACjB,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;QAAE,KAAK,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACjE,wEAAwE;IACxE,4DAA4D;IAC5D,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;QACtC,KAAK,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAC5C,IAAI,OAAO,OAAO,CAAC,KAAK,CAAC,UAAU,KAAK,UAAU;QAAE,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACpF,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACtB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IACvC,KAAK,GAAG,IAAI,CAAC;AACf,CAAC"}

package/dist/daemon/launch.d.ts

@@ -3,6 +3,21 @@ import type { BrasaEngine } from '@fnndsc/brasa';
 import { type OutputSink } from '@fnndsc/brasa';
 import type { ProgressEvent } from '@fnndsc/brasa';
 import { type Surface } from '@fnndsc/brasa';
+/** What a launched daemon hands back to its host (the console face's feed). */
+export interface DaemonLaunchInfo {
+    /** The CUBE identity this daemon hosts. */
+    identity: string;
+    /** The WebSocket wire address. */
+    url: string;
+    /** The attach token gating every session. */
+    token: string;
+    /** The berth file advertising this daemon. */
+    berthPath: string;
+    /** The ARGUS web-surface address, when a bundle is served. */
+    argusUrl: string | null;
+    /** The running daemon, for live telemetry. */
+    daemon: CalypsoDaemon;
+}
 /** The daemon sink forwards live command output to the executing surface. */
 export declare class DaemonSink implements OutputSink {
     private readonly daemon;
@@ -21,9 +36,9 @@ export declare class DaemonSink implements OutputSink {
  * Builds the surface a daemon-hosted engine talks to.
  *
  * Interactivity is a surface capability: prompts, pipeline segments, shell
- * escapes, and local editing reach the surface running the command through
- * the daemon's brokers, without knowing the transport. Nothing ever spawns
- * on the daemon host.
+ * escapes, local editing and file delivery reach the surface running the
+ * command through the daemon's brokers, without knowing the transport. Nothing
+ * ever spawns on the daemon host, and nothing is ever written to its disk.
  *
  * @param daemon - The daemon whose brokers deliver the capability requests.
  * @returns The surface to install with `surface_set` on the daemon host.
@@ -35,7 +50,7 @@ export declare function daemonSurface_create(daemon: CalypsoDaemon): Surface;
  * @param engine - The engine to host (already created and connected by boot).
  * @param beforeListen - Optional host preparation run after the duplicate guard
  *   and before the socket binds or the berth is published.
- * @returns A promise that resolves once the daemon is listening; the process
- *   then stays alive on the WebSocket server.
+ * @returns The launched daemon's addresses and handle, once it is listening;
+ *   the process then stays alive on the WebSocket server.
  */
-export declare function daemon_launch(engine: BrasaEngine, beforeListen?: () => Promise<void>): Promise<void>;
+export declare function daemon_launch(engine: BrasaEngine, beforeListen?: () => Promise<void>): Promise<DaemonLaunchInfo>;

package/dist/daemon/launch.js

@@ -15,14 +15,15 @@ import { hostname } from 'node:os';
 import * as path from 'node:path';
 import chalk from 'chalk';
 import { CalypsoDaemon } from './server.js';
-import { webRoot_resolve } from './static.js';
+import { bundledWebRoot_find, webRoot_resolve } from './static.js';
 import { token_generate } from './token.js';
 import { sink_set } from '@fnndsc/brasa';
 import { surface_set } from '@fnndsc/brasa';
-import { sessionPromptContext_build } from '@fnndsc/brasa';
+import { procIndex_snapshot, sessionPromptContext_build } from '@fnndsc/brasa';
 import { welcomeLine_build, versionReport_build, versions_get, buildHash_get, fortune_random } from '@fnndsc/brasa';
 import { chrisContext } from '@fnndsc/cumin';
 import { identity_forSession, berth_write, berth_read, berth_path, berthUrl_isAlive, DISCONNECTED_IDENTITY } from './berth.js';
+import { attachFile_write, attachFile_remove } from './attachFile.js';
 /** The daemon sink forwards live command output to the executing surface. */
 export class DaemonSink {
     daemon;
@@ -46,26 +47,40 @@ export class DaemonSink {
  * Builds the surface a daemon-hosted engine talks to.
  *
  * Interactivity is a surface capability: prompts, pipeline segments, shell
- * escapes, and local editing reach the surface running the command through
- * the daemon's brokers, without knowing the transport. Nothing ever spawns
- * on the daemon host.
+ * escapes, local editing and file delivery reach the surface running the
+ * command through the daemon's brokers, without knowing the transport. Nothing
+ * ever spawns on the daemon host, and nothing is ever written to its disk.
  *
  * @param daemon - The daemon whose brokers deliver the capability requests.
  * @returns The surface to install with `surface_set` on the daemon host.
  */
 export function daemonSurface_create(daemon) {
     return {
-        capabilities: {
-            hiddenInput: true,
-            localEdit: true,
-            tty: true,
-            pipeSegments: true,
-            shellCommands: true,
+        // A daemon has no capabilities of its own to offer. Those that vary by
+        // surface are read from whichever one is executing, as it declared them on
+        // attach — a browser and a remote shell differ, and answering for both
+        // would either archive a directory a shell wanted whole or hand a browser
+        // a tree it cannot hold.
+        get capabilities() {
+            const attached = daemon.capabilities_current();
+            return {
+                hiddenInput: true,
+                localEdit: true,
+                tty: true,
+                pipeSegments: true,
+                shellCommands: true,
+                fileDelivery: attached?.fileDelivery ?? false,
+                // The daemon's disk belongs to nobody attending this session, so a
+                // builtin that would write must deliver through the surface instead.
+                engineFilesystem: false,
+                localFilesystem: attached?.localFilesystem ?? false,
+            };
         },
         prompt: (request) => daemon.prompt_current(request.message, request.hidden ?? false),
         pipeSegment: (command, input) => daemon.pipe_current(command, input),
         shellCommand: (command) => daemon.shell_current(command),
         localEdit: (request) => daemon.edit_current(request.content, request.extension),
+        fileDeliver: (request) => daemon.deliver_current(request),
     };
 }
 /**
@@ -74,8 +89,8 @@ export function daemonSurface_create(daemon) {
  * @param engine - The engine to host (already created and connected by boot).
  * @param beforeListen - Optional host preparation run after the duplicate guard
  *   and before the socket binds or the berth is published.
- * @returns A promise that resolves once the daemon is listening; the process
- *   then stays alive on the WebSocket server.
+ * @returns The launched daemon's addresses and handle, once it is listening;
+ *   the process then stays alive on the WebSocket server.
  */
 export async function daemon_launch(engine, beforeListen) {
     // Force color into the engine's rendered text: no TTY here to auto-detect.
@@ -105,12 +120,14 @@ export async function daemon_launch(engine, beforeListen) {
     }
     const token = token_generate();
     // The web surface (argus) is served from the same port as the wire when a
-    // built bundle is found: an explicit CALYPSO_WEB_ROOT wins, and a monorepo
-    // checkout's bundle is picked up from the working directory so a dev-tree
-    // `chell --daemon` serves the surface with no configuration at all.
+    // built bundle is found: an explicit CALYPSO_WEB_ROOT wins, then the working
+    // directory, then the checkout enclosing this module — so a dev-tree
+    // `chell --daemon` serves the surface from any directory, with no
+    // configuration at all.
     const webRoot = webRoot_resolve([
         process.env['CALYPSO_WEB_ROOT'],
         path.join(process.cwd(), 'apps', 'argus', 'dist'),
+        bundledWebRoot_find() ?? undefined,
     ]);
     // Loopback is the posture; CALYPSO_BIND is a deliberate, per-launch
     // opt-out for demos on a trusted network. The attach token still gates
@@ -125,7 +142,10 @@ export async function daemon_launch(engine, beforeListen) {
         ...(webRoot !== null ? { webRoot } : {}),
         // Only the daemon holds the session context, so it renders the themed
         // prompt and pushes it to surfaces.
-        promptProvider: () => sessionPromptContext_build(),
+        telemetryProvider: procIndex_snapshot,
+        promptProvider: (last) => sessionPromptContext_build(last !== undefined
+            ? { lastCommandDurationMs: last.durationMs, lastExitCode: last.exitCode }
+            : {}),
         // Report this process's own versions and build hash so attaching surfaces
         // greet with the daemon's truth rather than their local install's.
         stack: { ...versions_get(), build: buildHash_get() },
@@ -133,10 +153,35 @@ export async function daemon_launch(engine, beforeListen) {
     sink_set(new DaemonSink(daemon));
     surface_set(daemonSurface_create(daemon));
     const port = await daemon.start();
-    const url = `ws://127.0.0.1:${port}`;
+    // The berth records where this daemon can actually be reached. Loopback is
+    // right for the ordinary case and wrong the moment CALYPSO_BIND opens the
+    // wire to the network: a berth copied to another machine, or an address
+    // pasted into `chell --remote --attach`, has to name a host that resolves
+    // from somewhere else.
+    const wireHost = bindHost === '0.0.0.0' ? hostname() : bindHost;
+    const url = `ws://${wireHost}:${port}`;
     const berth = { identity, url, token };
     berth_write(berth);
     const attachHint = identity === DISCONNECTED_IDENTITY ? '' : ` ${identity}`;
+    // The boot animation keeps repainting this terminal, and scrollback dies with
+    // the next clear. The same addresses go to a file so they can be read back
+    // without fighting either.
+    const noteLines = [
+        `identity:  ${identity}`,
+        `wire:      ${url}`,
+        `token:     ${token}`,
+        ...(webRoot !== null
+            ? [`ARGUS:     http://${bindHost === '0.0.0.0' ? hostname() : bindHost}:${port}/?token=${token}`]
+            : []),
+        `attach:    chell --remote --attach ${url} --token ${token}`,
+    ];
+    const notePath = attachFile_write(noteLines);
+    if (notePath !== null) {
+        const cleanup = () => attachFile_remove();
+        process.once('exit', cleanup);
+        process.once('SIGINT', () => { cleanup(); process.exit(0); });
+        process.once('SIGTERM', () => { cleanup(); process.exit(0); });
+    }
     console.log(chalk.bold.cyan(welcomeLine_build('calypso')));
     for (const line of versionReport_build().split('\n')) {
         console.log(chalk.gray(`    ${line}`));
@@ -147,6 +192,12 @@ export async function daemon_launch(engine, beforeListen) {
     console.log(chalk.gray(`    token:     ${token}`));
     console.log(chalk.gray(`    berth:     ${berth_path(identity)}`));
     console.log(chalk.gray(`    attach a surface with:  chell --remote${attachHint}`));
+    if (bindHost !== '127.0.0.1') {
+        // Berth discovery is a file in this host's runtime directory, so it cannot
+        // reach another machine. An explicit address is how a surface elsewhere
+        // attaches, and it is worth printing ready to paste.
+        console.log(chalk.gray(`    from another machine:   chell --remote --attach ${url} --token ${token}`));
+    }
     if (webRoot !== null) {
         // A wildcard bind has no routable form for a URL; name the machine so
         // the printed address works from another host.
@@ -154,5 +205,18 @@ export async function daemon_launch(engine, beforeListen) {
         console.log(chalk.green(`[+] ARGUS web surface at http://${displayHost}:${port}/?token=${token}`));
         console.log(chalk.gray(`    serving:   ${webRoot}`));
     }
+    if (notePath !== null) {
+        console.log(chalk.gray(`    these lines also in:  ${notePath}`));
+        console.log(chalk.gray('    or run:               calypso --berths'));
+    }
+    const displayHost = bindHost === '0.0.0.0' ? hostname() : bindHost;
+    return {
+        identity,
+        url,
+        token,
+        berthPath: berth_path(identity),
+        argusUrl: webRoot !== null ? `http://${displayHost}:${port}/?token=${token}` : null,
+        daemon,
+    };
 }
 //# sourceMappingURL=launch.js.map