@fnndsc/chell 4.3.2 → 5.0.0

package/dist/remote/remoteEngine.js

@@ -0,0 +1,286 @@
+/**
+ * @file The remote engine: a `BrasaEngine` backed by a daemon over the wire.
+ *
+ * This is the transport swap that lets the same REPL drive either an in-process
+ * engine or a CALYPSO daemon. It implements the engine interface by sending
+ * `execute` / `complete` messages over a WebSocket and awaiting the correlated
+ * `result` / completion replies, validating every message against calypso's
+ * wire contract at the boundary. Session-bus broadcasts (another surface's
+ * activity) are delivered to an optional callback so the host can render them.
+ *
+ * @module
+ */
+import { WebSocket } from 'ws';
+import { serverMessage_parse, CONTRACT_VERSION } from '@fnndsc/calypso';
+import { envelope_deliver, sink_get } from '@fnndsc/brasa';
+import { promptFromContext_render } from '../core/prompt/session.js';
+/**
+ * A `BrasaEngine` implementation that drives a remote daemon.
+ */
+export class RemoteEngine {
+    ws;
+    pending = new Map();
+    onSession;
+    onPrompt;
+    onPipe;
+    onEdit;
+    latestPrompt = '';
+    nextId = 0;
+    liveEnvelopeChannels = new Map();
+    /**
+     * @param ws - An open, already-attached socket to the daemon.
+     * @param options - The callbacks for session broadcasts and prompts.
+     */
+    constructor(ws, options) {
+        this.ws = ws;
+        this.onSession = options.onSession;
+        this.onPrompt = options.onPrompt;
+        this.onPipe = options.onPipe;
+        this.onEdit = options.onEdit;
+    }
+    /**
+     * 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) {
+        return new Promise((resolve, reject) => {
+            const ws = new WebSocket(options.url);
+            ws.once('error', (err) => reject(err));
+            ws.once('open', () => {
+                ws.send(JSON.stringify({ type: 'attach', protocolVersion: CONTRACT_VERSION, token: options.token }));
+                ws.once('message', (data) => {
+                    const parsed = serverMessage_parse(safeJson_parse(data.toString()));
+                    if (!parsed.ok || parsed.value === undefined) {
+                        reject(new Error(`attach failed: ${parsed.error ?? 'invalid response'}`));
+                        ws.close();
+                        return;
+                    }
+                    const message = parsed.value;
+                    if (message.type === 'error') {
+                        reject(new Error(`attach refused: ${message.reason}`));
+                        ws.close();
+                        return;
+                    }
+                    if (message.type !== 'attached') {
+                        reject(new Error(`unexpected attach response: ${message.type}`));
+                        ws.close();
+                        return;
+                    }
+                    const engine = new RemoteEngine(ws, options);
+                    ws.on('message', (payload) => engine.message_handle(payload));
+                    if (options.onClose) {
+                        ws.on('close', () => options.onClose?.());
+                    }
+                    resolve(engine);
+                });
+            });
+        });
+    }
+    /** @inheritdoc */
+    async line_execute(line) {
+        const id = String(this.nextId++);
+        const envelopes = await this.request('execute', { line }, id);
+        const liveChannels = this.liveEnvelopeChannels.get(id);
+        this.liveEnvelopeChannels.delete(id);
+        // Deliver to the active sink exactly as the in-process engine delivers
+        // live, so the REPL host renders remote output without any change.
+        for (const envelope of envelopes) {
+            envelope_deliver(liveChannels ? {
+                ...envelope,
+                rendered: liveChannels.has('data') ? '' : envelope.rendered,
+                renderedErr: liveChannels.has('err') ? undefined : envelope.renderedErr,
+            } : envelope);
+        }
+        return envelopes;
+    }
+    /** @inheritdoc */
+    line_complete(linePrefix) {
+        return this.request('complete', { prefix: linePrefix });
+    }
+    /**
+     * 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.
+     */
+    request(type, fields, requestId) {
+        const id = requestId ?? String(this.nextId++);
+        return new Promise((resolve, reject) => {
+            this.pending.set(id, { resolve, reject });
+            this.ws.send(JSON.stringify({ type, id, ...fields }));
+        });
+    }
+    /**
+     * 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.
+     */
+    message_handle(payload) {
+        const parsed = serverMessage_parse(safeJson_parse(payload.toString()));
+        if (!parsed.ok || parsed.value === undefined) {
+            return;
+        }
+        const message = parsed.value;
+        switch (message.type) {
+            case 'result':
+                this.pending_settle(message.id, (p) => p.resolve(message.envelopes));
+                break;
+            case 'complete':
+                this.pending_settle(message.id, (p) => p.resolve({ candidates: message.candidates, prefix: message.prefix }));
+                break;
+            case 'session':
+                // The wire envelope is a CommandEnvelope; calypso's schema infers the
+                // model payload as optional-unknown, a zod nicety the runtime shape
+                // does not reflect. Narrow at this single boundary.
+                if (this.onSession)
+                    this.onSession(message.surface, message.envelope);
+                break;
+            case 'prompt':
+                void this.prompt_answer(message.promptId, message.message, message.hidden);
+                break;
+            case 'promptline':
+                // Render the daemon's context with this surface's own theme, so a
+                // remote prompt looks the way the local operator configured it.
+                this.latestPrompt = promptFromContext_render(message.context);
+                break;
+            case 'progress':
+                {
+                    const { type: _type, id: _id, ...event } = message;
+                    sink_get().progress_write(event);
+                }
+                break;
+            case 'output':
+                if (message.channel === 'data' || message.channel === 'err') {
+                    const channels = this.liveEnvelopeChannels.get(message.id) ?? new Set();
+                    channels.add(message.channel);
+                    this.liveEnvelopeChannels.set(message.id, channels);
+                }
+                this.output_render(message.channel, message.chunk);
+                break;
+            case 'pipe':
+                void this.pipe_run(message.pipeId, message.command, message.input);
+                break;
+            case 'edit':
+                void this.edit_run(message.editId, message.content, message.extension);
+                break;
+            case 'error':
+                if (message.id !== undefined) {
+                    this.pending_settle(message.id, (p) => p.reject(new Error(message.reason)));
+                }
+                break;
+            default:
+                break;
+        }
+    }
+    /**
+     * 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).
+     */
+    async prompt_answer(promptId, message, hidden) {
+        const answer = this.onPrompt ? await this.onPrompt(message, hidden) : '';
+        this.ws.send(JSON.stringify({ type: 'promptAnswer', promptId, 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.
+     */
+    async pipe_run(pipeId, command, input) {
+        const inputBytes = Buffer.from(input, 'base64');
+        const output = this.onPipe ? await this.onPipe(command, inputBytes) : inputBytes;
+        this.ws.send(JSON.stringify({ type: 'pipeResult', pipeId, output: output.toString('base64') }));
+    }
+    /**
+     * 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.
+     */
+    async edit_run(editId, content, extension) {
+        const result = this.onEdit
+            ? await this.onEdit(content, extension)
+            : { content, changed: false };
+        this.ws.send(JSON.stringify({ type: 'editResult', editId, content: result.content, changed: result.changed }));
+    }
+    /**
+     * 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.
+     */
+    output_render(channel, chunk) {
+        const sink = sink_get();
+        if (channel === 'data') {
+            sink.data_write(chunk);
+        }
+        else if (channel === 'err') {
+            sink.err_write(chunk);
+        }
+        else {
+            sink.status_write(chunk);
+        }
+    }
+    /**
+     * Applies a settlement to the pending request for an id, if one exists.
+     *
+     * @param id - The correlation id.
+     * @param settle - The settlement to apply.
+     */
+    pending_settle(id, settle) {
+        const pending = this.pending.get(id);
+        if (pending) {
+            this.pending.delete(id);
+            settle(pending);
+        }
+    }
+    /**
+     * The latest themed prompt string the daemon pushed, or empty before the
+     * first push.
+     *
+     * @returns The current prompt string.
+     */
+    promptLine() {
+        return this.latestPrompt;
+    }
+    /**
+     * Closes the connection.
+     */
+    close() {
+        this.ws.close();
+    }
+}
+/**
+ * Parses JSON, returning `undefined` on failure so callers can validate the
+ * result rather than catch.
+ *
+ * @param text - The JSON text.
+ * @returns The parsed value, or undefined when the text is not valid JSON.
+ */
+function safeJson_parse(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=remoteEngine.js.map

package/dist/remote/remoteEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remoteEngine.js","sourceRoot":"","sources":["../../src/remote/remoteEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAsB,MAAM,iBAAiB,CAAC;AAG5F,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAmB,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AA0BrE;;GAEG;AACH,MAAM,OAAO,YAAY;IACN,EAAE,CAAY;IACd,OAAO,GAAyB,IAAI,GAAG,EAAmB,CAAC;IAC3D,SAAS,CAAqE;IAC9E,QAAQ,CAAsE;IAC9E,MAAM,CAAoE;IAC1E,MAAM,CAAmH;IAClI,YAAY,GAAW,EAAE,CAAC;IAC1B,MAAM,GAAW,CAAC,CAAC;IACV,oBAAoB,GAAqC,IAAI,GAAG,EAA+B,CAAC;IAEjH;;;OAGG;IACH,YAAoB,EAAa,EAAE,OAA4B;QAC7D,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC/B,CAAC;IAED;;;;;;;OAOG;IACI,MAAM,CAAC,OAAO,CAAC,OAA4B;QAChD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAuC,EAAE,MAA4B,EAAE,EAAE;YAC3F,MAAM,EAAE,GAAc,IAAI,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAEjD,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAE9C,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE;gBACnB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,eAAe,EAAE,gBAAgB,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;gBACrG,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,IAAY,EAAE,EAAE;oBAClC,MAAM,MAAM,GAAG,mBAAmB,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;oBACpE,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;wBAC7C,MAAM,CAAC,IAAI,KAAK,CAAC,kBAAkB,MAAM,CAAC,KAAK,IAAI,kBAAkB,EAAE,CAAC,CAAC,CAAC;wBAC1E,EAAE,CAAC,KAAK,EAAE,CAAC;wBACX,OAAO;oBACT,CAAC;oBACD,MAAM,OAAO,GAAkB,MAAM,CAAC,KAAK,CAAC;oBAC5C,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;wBAC7B,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;wBACvD,EAAE,CAAC,KAAK,EAAE,CAAC;wBACX,OAAO;oBACT,CAAC;oBACD,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;wBAChC,MAAM,CAAC,IAAI,KAAK,CAAC,+BAA+B,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;wBACjE,EAAE,CAAC,KAAK,EAAE,CAAC;wBACX,OAAO;oBACT,CAAC;oBACD,MAAM,MAAM,GAAiB,IAAI,YAAY,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;oBAC3D,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;oBACtE,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;wBACpB,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;oBAC5C,CAAC;oBACD,OAAO,CAAC,MAAM,CAAC,CAAC;gBAClB,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,kBAAkB;IACX,KAAK,CAAC,YAAY,CAAC,IAAY;QACpC,MAAM,EAAE,GAAW,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACzC,MAAM,SAAS,GAAsB,MAAM,IAAI,CAAC,OAAO,CAAoB,SAAS,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACpG,MAAM,YAAY,GAAoC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACxF,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACrC,uEAAuE;QACvE,mEAAmE;QACnE,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,gBAAgB,CAAC,YAAY,CAAC,CAAC,CAAC;gBAC9B,GAAG,QAAQ;gBACX,QAAQ,EAAE,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ;gBAC3D,WAAW,EAAE,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW;aACxE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAChB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,kBAAkB;IACX,aAAa,CAAC,UAAkB;QACrC,OAAO,IAAI,CAAC,OAAO,CAAmB,UAAU,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;;OAMG;IACK,OAAO,CAAI,IAA4B,EAAE,MAA8B,EAAE,SAAkB;QACjG,MAAM,EAAE,GAAW,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACtD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAiC,EAAE,MAA4B,EAAE,EAAE;YACrF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;YAC1C,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC;QACxD,CAAC,CAAe,CAAC;IACnB,CAAC;IAED;;;;;;OAMG;IACK,cAAc,CAAC,OAAe;QACpC,MAAM,MAAM,GAAG,mBAAmB,CAAC,cAAc,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QACvE,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC7C,OAAO;QACT,CAAC;QACD,MAAM,OAAO,GAAkB,MAAM,CAAC,KAAK,CAAC;QAC5C,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;YACrB,KAAK,QAAQ;gBACX,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;gBAC9E,MAAM;YACR,KAAK,UAAU;gBACb,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAU,EAAE,EAAE,CAC7C,CAAC,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;gBACzE,MAAM;YACR,KAAK,SAAS;gBACZ,sEAAsE;gBACtE,oEAAoE;gBACpE,oDAAoD;gBACpD,IAAI,IAAI,CAAC,SAAS;oBAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,QAA2B,CAAC,CAAC;gBACzF,MAAM;YACR,KAAK,QAAQ;gBACX,KAAK,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;gBAC3E,MAAM;YACR,KAAK,YAAY;gBACf,kEAAkE;gBAClE,gEAAgE;gBAChE,IAAI,CAAC,YAAY,GAAG,wBAAwB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBAC9D,MAAM;YACR,KAAK,UAAU;gBACb,CAAC;oBACC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;oBACnD,QAAQ,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;gBACnC,CAAC;gBACD,MAAM;YACR,KAAK,QAAQ;gBACX,IAAI,OAAO,CAAC,OAAO,KAAK,MAAM,IAAI,OAAO,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;oBAC5D,MAAM,QAAQ,GAAwB,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,IAAI,GAAG,EAAkB,CAAC;oBAC7G,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;oBAC9B,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;gBACtD,CAAC;gBACD,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;gBACnD,MAAM;YACR,KAAK,MAAM;gBACT,KAAK,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;gBACnE,MAAM;YACR,KAAK,MAAM;gBACT,KAAK,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;gBACvE,MAAM;YACR,KAAK,OAAO;gBACV,IAAI,OAAO,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;oBAC7B,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBACvF,CAAC;gBACD,MAAM;YACR;gBACE,MAAM;QACV,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACK,KAAK,CAAC,aAAa,CAAC,QAAgB,EAAE,OAAe,EAAE,MAAe;QAC5E,MAAM,MAAM,GAAW,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACjF,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAC3E,CAAC;IAED;;;;;;;;OAQG;IACK,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,OAAe,EAAE,KAAa;QACnE,MAAM,UAAU,GAAW,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACxD,MAAM,MAAM,GAAW,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;QACzF,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IAClG,CAAC;IAED;;;;;;;;OAQG;IACK,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,OAAe,EAAE,SAA6B;QACnF,MAAM,MAAM,GAA0C,IAAI,CAAC,MAAM;YAC/D,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC;YACvC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAChC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACjH,CAAC;IAED;;;;;OAKG;IACK,aAAa,CAAC,OAAkC,EAAE,KAAa;QACrE,MAAM,IAAI,GAAe,QAAQ,EAAE,CAAC;QACpC,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;YACvB,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;aAAM,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;YAC7B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACK,cAAc,CAAC,EAAU,EAAE,MAAkC;QACnE,MAAM,OAAO,GAAwB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1D,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACxB,MAAM,CAAC,OAAO,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACI,UAAU;QACf,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;OAEG;IACI,KAAK;QACV,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;CACF;AAED;;;;;;GAMG;AACH,SAAS,cAAc,CAAC,IAAY;IAClC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fnndsc/chell",
-  "version": "4.3.2",
+  "version": "5.0.0",
   "description": "ChELL Executes Layered Logic - Interactive ChRIS REPL Shell",
   "repository": {
     "type": "git",
@@ -37,8 +37,9 @@
   "author": "FNNDSC <dev@babyMRI.org>",
   "license": "MIT",
   "dependencies": {
+    "@fnndsc/brasa": "^0.1.0",
     "@fnndsc/chili": "^3.3.0",
-    "@fnndsc/cumin": "^3.4.0",
+    "@fnndsc/cumin": "^3.5.0",
     "@fnndsc/salsa": "^3.2.6",
     "chalk": "^4.1.2",
     "cli-progress": "^3.12.0",
@@ -48,7 +49,8 @@
     "marked": "^15.0.12",
     "marked-terminal": "^7.3.0",
     "minimatch": "^10.1.1",
-    "ws": "^8.21.0"
+    "ws": "^8.21.0",
+    "@fnndsc/calypso": "^0.3.0"
   },
   "devDependencies": {
     "@types/cli-progress": "^3.11.6",

package/dist/builtins/debug.d.ts

@@ -1,6 +0,0 @@
-/**
- * Toggles or displays debug mode status.
- *
- * @param args - Command line arguments: 'on', 'off', or empty to display status.
- */
-export declare function builtin_debug(args: string[]): Promise<void>;

package/dist/builtins/debug.js

@@ -1,47 +0,0 @@
-/**
- * @file Debug Command
- *
- * Toggles debug mode for the application, enabling verbose error logging.
- */
-import chalk from 'chalk';
-import { session } from '../session/index.js';
-/**
- * Toggles or displays debug mode status.
- *
- * @param args - Command line arguments: 'on', 'off', or empty to display status.
- */
-export async function builtin_debug(args) {
-    const subcommand = args[0];
-    const config = session.connection.config;
-    if (!config) {
-        console.error(chalk.red('Error: Connection configuration not initialized.'));
-        return;
-    }
-    if (!subcommand) {
-        const status = config.debug ? 'enabled' : 'disabled';
-        console.log(`Debug mode: ${chalk.yellow(status)}`);
-        if (config.debug) {
-            console.log(chalk.gray('  Verbose error logging is enabled.'));
-        }
-        else {
-            console.log(chalk.gray('  Verbose error logging is disabled.'));
-        }
-        console.log(chalk.gray('\nUsage: debug [on|off]'));
-        return;
-    }
-    if (subcommand === 'on') {
-        config.debug = true;
-        console.log(chalk.yellow('[!] Debug mode enabled'));
-        console.log(chalk.gray('    Verbose error logging activated.'));
-    }
-    else if (subcommand === 'off') {
-        config.debug = false;
-        console.log(chalk.green('[+] Debug mode disabled'));
-        console.log(chalk.gray('    Verbose error logging deactivated.'));
-    }
-    else {
-        console.log(chalk.red(`Unknown argument: ${subcommand}`));
-        console.log(chalk.gray('Usage: debug [on|off]'));
-    }
-}
-//# sourceMappingURL=debug.js.map

package/dist/builtins/debug.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"debug.js","sourceRoot":"","sources":["../../src/builtins/debug.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAc;IAChD,MAAM,UAAU,GAAuB,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC;IAEzC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC,CAAC;QAC7E,OAAO;IACT,CAAC;IAED,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,MAAM,GAAW,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;QAC7D,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACnD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC,CAAC;QACjE,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC,CAAC;QAClE,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,CAAC;QACnD,OAAO;IACT,CAAC;IAED,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAC,CAAC;QACpD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC,CAAC;IAClE,CAAC;SAAM,IAAI,UAAU,KAAK,KAAK,EAAE,CAAC;QAChC,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC,CAAC;QACpD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC,CAAC;IACpE,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,qBAAqB,UAAU,EAAE,CAAC,CAAC,CAAC;QAC1D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC,CAAC;IACnD,CAAC;AACH,CAAC"}

package/dist/builtins/executable.d.ts

@@ -1,22 +0,0 @@
-/**
- * @file Builtin handler for executing a plugin as a shell command.
- *
- * @module
- */
-type PluginExecutableOptions = {
-    piped?: boolean;
-};
-/**
- * Handles simulated execution of plugins (e.g., "pl-simpledsapp-v1.2.3 --parameters").
- *
- * This acts as an interceptor for the main shell loop. If the user input matches a
- * known plugin name format, it routes the request to the appropriate ChRIS/ChILI logic,
- * simulating a native executable experience.
- *
- * @param command - The command string (potentially a plugin name).
- * @param args - The arguments passed to the command.
- * @param options - Optional flags for piped/non-interactive handling.
- * @returns A Promise resolving to true if the command was handled as a plugin execution, false otherwise.
- */
-export declare function pluginExecutable_handle(command: string, args: string[], options?: PluginExecutableOptions): Promise<boolean>;
-export {};

package/dist/builtins/executable.js

@@ -1,115 +0,0 @@
-/**
- * @file Builtin handler for executing a plugin as a shell command.
- *
- * @module
- */
-import chalk from 'chalk';
-import { spinner } from '../lib/spinner.js';
-import { builtin_parametersofplugin } from './parametersofplugin.js';
-import { plugins_list, plugins_listAll } from '@fnndsc/salsa';
-import { pluginReadme_fetch, pluginReadme_render } from '@fnndsc/chili/commands/plugin/readme.js';
-/**
- * Handles simulated execution of plugins (e.g., "pl-simpledsapp-v1.2.3 --parameters").
- *
- * This acts as an interceptor for the main shell loop. If the user input matches a
- * known plugin name format, it routes the request to the appropriate ChRIS/ChILI logic,
- * simulating a native executable experience.
- *
- * @param command - The command string (potentially a plugin name).
- * @param args - The arguments passed to the command.
- * @param options - Optional flags for piped/non-interactive handling.
- * @returns A Promise resolving to true if the command was handled as a plugin execution, false otherwise.
- */
-export async function pluginExecutable_handle(command, args, options) {
-    // Expected format: name-vVersion (e.g., "pl-simpledsapp-v2.1.3")
-    const versionSeparatorIndex = command.lastIndexOf('-v');
-    if (versionSeparatorIndex === -1) {
-        return false;
-    }
-    const name = command.substring(0, versionSeparatorIndex);
-    const version = command.substring(versionSeparatorIndex + 2);
-    if (!name || !version) {
-        return false;
-    }
-    const showHelp = args.includes('--help') || args.includes('-h');
-    const isPipedOutput = !!options?.piped || !process.stdout.isTTY;
-    if (showHelp) {
-        console.log(chalk.cyan(`Plugin executable flags for ${name}-v${version}:`));
-        console.log('  --parameters   Show parameter definitions for this plugin version');
-        console.log('  --readme       Show README (rendered) from plugin metadata repository URL');
-        console.log('  --readme --raw Output raw markdown, suitable for piping to glow or bat');
-        return true;
-    }
-    const plugin_resolveExact = async () => {
-        try {
-            const resultsExactUnknown = await plugins_list({
-                search: {
-                    name_exact: name,
-                    version: version
-                }
-            });
-            const resultsExact = resultsExactUnknown;
-            let candidate = resultsExact?.tableData?.[0];
-            if (!candidate || candidate.name !== name || candidate.version !== version) {
-                const allVersionsUnknown = await plugins_listAll({
-                    search: { name: name }
-                });
-                const allVersions = allVersionsUnknown;
-                candidate = allVersions?.tableData?.find((p) => p.name === name && p.version === version);
-            }
-            if (!candidate ||
-                typeof candidate.id !== 'number' ||
-                typeof candidate.name !== 'string' ||
-                typeof candidate.version !== 'string') {
-                return null;
-            }
-            return { id: candidate.id, name: candidate.name, version: candidate.version };
-        }
-        catch (error) {
-            console.error(chalk.red(`Error resolving plugin: ${error instanceof Error ? error.message : String(error)}`));
-            return null;
-        }
-    };
-    if (args.includes('--readme')) {
-        const rawMode = args.includes('--raw');
-        console.log(chalk.cyan(`Resolving plugin ${name} v${version} for README...`));
-        const resolved = await plugin_resolveExact();
-        if (!resolved) {
-            console.log(chalk.red(`Plugin ${name} v${version} not found.`));
-            return true;
-        }
-        spinner.start(`Fetching README for ${resolved.name} v${resolved.version}...`);
-        try {
-            const content = await pluginReadme_fetch(String(resolved.id));
-            spinner.stop();
-            if (content) {
-                console.log(rawMode ? content : pluginReadme_render(content));
-            }
-            else {
-                console.log(chalk.yellow(`No README found for ${resolved.name} v${resolved.version}.`));
-            }
-        }
-        catch (error) {
-            spinner.stop();
-            const message = error instanceof Error ? error.message : String(error);
-            console.log(chalk.red(`Failed to fetch README: ${message}`));
-        }
-        return true;
-    }
-    if (args.includes('--parameters')) {
-        console.log(chalk.cyan(`Fetching parameters for plugin ${name} v${version}...`));
-        const resolved = await plugin_resolveExact();
-        if (!resolved) {
-            console.log(chalk.red(`Plugin ${name} v${version} not found.`));
-            return true; // Handled (attempted), but failed
-        }
-        console.log(chalk.cyan(`Resolved Plugin: ${resolved.name} v${resolved.version} (ID: ${resolved.id})`));
-        // Delegate to parametersofplugin builtin with the resolved context
-        await builtin_parametersofplugin(['list', '--plugin-id', String(resolved.id)]);
-        return true;
-    }
-    // If command matches plugin format but no handled flags are present,
-    // return false to let the main loop handle it (or show unknown command).
-    return false;
-}
-//# sourceMappingURL=executable.js.map

package/dist/builtins/executable.js.map

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

package/dist/builtins/fs/cat.d.ts

@@ -1,16 +0,0 @@
-/**
- * Displays the content of one or more files.
- *
- * Supports multiple files and concatenates their output. Binary mode is applied
- * consistently to all files if any file is detected as binary or --binary is specified.
- *
- * @param args - Command line arguments (file paths and optional --binary flag).
- *
- * @example
- * ```typescript
- * await builtin_cat(['file1.txt', 'file2.txt']);
- * await builtin_cat(['--binary', 'image.dcm']);
- * await builtin_cat(['*.json']);  // After wildcard expansion
- * ```
- */
-export declare function builtin_cat(args: string[]): Promise<void>;