@spexcode/spec-cli 0.6.5

package/dist/headless-controller.d.ts

@@ -0,0 +1,9 @@
+import type { DispatchResult } from './harness.js';
+export type ControlRequestLabel = {
+    name: string;
+    session: string;
+    timeoutMs: number;
+    rejected: string;
+};
+export declare function withTimeout<T>(promise: Promise<T>, ms: number, message: string): Promise<T>;
+export declare function controlRequest(sockPath: string, request: object, label: ControlRequestLabel): Promise<DispatchResult>;

package/dist/headless-controller.js

@@ -0,0 +1,47 @@
+import { createConnection } from 'node:net';
+export function withTimeout(promise, ms, message) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => reject(new Error(message)), ms);
+        promise.then((value) => { clearTimeout(timer); resolve(value); }, (error) => { clearTimeout(timer); reject(error); });
+    });
+}
+export function controlRequest(sockPath, request, label) {
+    return new Promise((resolve) => {
+        let socket;
+        let buffer = '';
+        let settled = false;
+        const finish = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            socket?.destroy();
+            resolve(result);
+        };
+        const timer = setTimeout(() => finish({ ok: false, error: `${label.name} control timed out for session ${label.session}` }), label.timeoutMs);
+        try {
+            socket = createConnection(sockPath);
+        }
+        catch (error) {
+            finish({ ok: false, error: `${label.name} controller connect failed for session ${label.session}: ${error.message}` });
+            return;
+        }
+        socket.setEncoding('utf8');
+        socket.on('connect', () => socket.write(`${JSON.stringify(request)}\n`));
+        socket.on('data', (chunk) => {
+            buffer += chunk;
+            const nl = buffer.indexOf('\n');
+            if (nl < 0)
+                return;
+            try {
+                const response = JSON.parse(buffer.slice(0, nl));
+                finish(response.ok ? { ok: true } : { ok: false, error: response.error || label.rejected });
+            }
+            catch (error) {
+                finish({ ok: false, error: `${label.name} returned an invalid control response: ${error.message}` });
+            }
+        });
+        socket.on('error', (error) => finish({ ok: false, error: `${label.name} controller unreachable for session ${label.session}: ${error.message}` }));
+        socket.on('close', () => finish({ ok: false, error: `${label.name} controller closed before confirming session ${label.session}` }));
+    });
+}

package/dist/help.d.ts

@@ -0,0 +1,10 @@
+export declare function commandHelp(name: string, verb?: string): string | null;
+export type HelpCatalogEntry = Readonly<{
+    id: string;
+    title: string;
+    text: string;
+}>;
+export declare function helpCatalogEntries(): readonly HelpCatalogEntry[];
+export declare function sessionLaunchReceipt(id: string, managedWatch?: boolean): string;
+export declare function peerSessionLaunchReceipt(id: string, sshAddress: string): string;
+export declare function overviewHelp(): string;