@earendil-works/pi-coding-agent 0.84.4 → 0.85.0

package/dist/experimental/mini/main.js

@@ -0,0 +1,21 @@
+/**
+ * The `mini` command. Runs the presentation host.
+ *
+ * Run: node packages/coding-agent/src/experimental/mini/main.ts [--continue]
+ */
+import { runTui } from "./tui/run.js";
+function parseArgs(argv) {
+    const options = {};
+    for (const arg of argv) {
+        if (arg === "--continue" || arg === "-c")
+            options.continueSession = true;
+        else
+            throw new Error(`Unknown argument: ${arg}`);
+    }
+    return options;
+}
+runTui(parseArgs(process.argv.slice(2))).then(() => process.exit(0), (error) => {
+    console.error(error);
+    process.exit(1);
+});
+//# sourceMappingURL=main.js.map

package/dist/experimental/mini/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../../src/experimental/mini/main.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAmB,MAAM,cAAc,CAAC;AAEvD,SAAS,SAAS,CAAC,IAAuB,EAAc;IACvD,MAAM,OAAO,GAAe,EAAE,CAAC;IAC/B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACxB,IAAI,GAAG,KAAK,YAAY,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;;YACpE,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,OAAO,CAAC;AAAA,CACf;AAED,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAC5C,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EACrB,CAAC,KAAc,EAAE,EAAE,CAAC;IACnB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAAA,CAChB,CACD,CAAC","sourcesContent":["/**\n * The `mini` command. Runs the presentation host.\n *\n * Run: node packages/coding-agent/src/experimental/mini/main.ts [--continue]\n */\n\nimport { runTui, type TuiOptions } from \"./tui/run.ts\";\n\nfunction parseArgs(argv: readonly string[]): TuiOptions {\n\tconst options: TuiOptions = {};\n\tfor (const arg of argv) {\n\t\tif (arg === \"--continue\" || arg === \"-c\") options.continueSession = true;\n\t\telse throw new Error(`Unknown argument: ${arg}`);\n\t}\n\treturn options;\n}\n\nrunTui(parseArgs(process.argv.slice(2))).then(\n\t() => process.exit(0),\n\t(error: unknown) => {\n\t\tconsole.error(error);\n\t\tprocess.exit(1);\n\t},\n);\n"]}

package/dist/experimental/mini/server/entry.d.ts

@@ -0,0 +1,3 @@
+/** Server process entry: `node server/entry.ts <socketPath> <sessionsRoot>`. Spawned detached by the CLI. */
+export {};
+//# sourceMappingURL=entry.d.ts.map

package/dist/experimental/mini/server/entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../../../src/experimental/mini/server/entry.ts"],"names":[],"mappings":"AAAA,6GAA6G","sourcesContent":["/** Server process entry: `node server/entry.ts <socketPath> <sessionsRoot>`. Spawned detached by the CLI. */\n\nimport { socketTransport } from \"../shared/transport.ts\";\nimport { runServer } from \"./run.ts\";\n\nconst [socketPath, sessionsRoot] = process.argv.slice(2);\nif (!socketPath || !sessionsRoot) throw new Error(\"Server requires <socketPath> <sessionsRoot>\");\n\nvoid runServer({ transport: socketTransport(socketPath), sessionsRoot }).catch((error: unknown) => {\n\tconsole.error(error);\n\tprocess.exit(1);\n});\n"]}

package/dist/experimental/mini/server/entry.js

@@ -0,0 +1,11 @@
+/** Server process entry: `node server/entry.ts <socketPath> <sessionsRoot>`. Spawned detached by the CLI. */
+import { socketTransport } from "../shared/transport.js";
+import { runServer } from "./run.js";
+const [socketPath, sessionsRoot] = process.argv.slice(2);
+if (!socketPath || !sessionsRoot)
+    throw new Error("Server requires <socketPath> <sessionsRoot>");
+void runServer({ transport: socketTransport(socketPath), sessionsRoot }).catch((error) => {
+    console.error(error);
+    process.exit(1);
+});
+//# sourceMappingURL=entry.js.map

package/dist/experimental/mini/server/entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../../../../src/experimental/mini/server/entry.ts"],"names":[],"mappings":"AAAA,6GAA6G;AAE7G,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,MAAM,CAAC,UAAU,EAAE,YAAY,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACzD,IAAI,CAAC,UAAU,IAAI,CAAC,YAAY;IAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;AAEjG,KAAK,SAAS,CAAC,EAAE,SAAS,EAAE,eAAe,CAAC,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE,CAAC;IAClG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAAA,CAChB,CAAC,CAAC","sourcesContent":["/** Server process entry: `node server/entry.ts <socketPath> <sessionsRoot>`. Spawned detached by the CLI. */\n\nimport { socketTransport } from \"../shared/transport.ts\";\nimport { runServer } from \"./run.ts\";\n\nconst [socketPath, sessionsRoot] = process.argv.slice(2);\nif (!socketPath || !sessionsRoot) throw new Error(\"Server requires <socketPath> <sessionsRoot>\");\n\nvoid runServer({ transport: socketTransport(socketPath), sessionsRoot }).catch((error: unknown) => {\n\tconsole.error(error);\n\tprocess.exit(1);\n});\n"]}

package/dist/experimental/mini/server/run.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Session server: accepts client connections, spawns one worker process per session, routes.
+ *
+ * It provides `Sessions` and holds no agent state. Any other service name is forwarded to the worker
+ * the calling client is attached to, and every worker event is pushed back to that worker's clients.
+ * Workers reach `Sessions` over the same peer, because the routing rule is symmetric.
+ */
+import { type Transport } from "../shared/transport.ts";
+export declare function runServer(options: {
+    transport: Transport;
+    sessionsRoot: string;
+}): Promise<void>;
+//# sourceMappingURL=run.d.ts.map

package/dist/experimental/mini/server/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../../src/experimental/mini/server/run.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAkCzE,wBAAsB,SAAS,CAAC,OAAO,EAAE;IAAE,SAAS,EAAE,SAAS,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA4GtG","sourcesContent":["/**\n * Session server: accepts client connections, spawns one worker process per session, routes.\n *\n * It provides `Sessions` and holds no agent state. Any other service name is forwarded to the worker\n * the calling client is attached to, and every worker event is pushed back to that worker's clients.\n * Workers reach `Sessions` over the same peer, because the routing rule is symmetric.\n */\n\nimport { spawn } from \"node:child_process\";\nimport { extname } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n// Narrow entries: the server routes and lists sessions, it never runs an agent.\nimport { BACKGROUND_CONTEXT } from \"@earendil-works/pi-agent-core/harness/context\";\nimport { NodeExecutionEnv } from \"@earendil-works/pi-agent-core/harness/env/nodejs\";\nimport { JsonlSessionRepo } from \"@earendil-works/pi-agent-core/harness/session\";\nimport { type SessionSummary, Sessions, type SessionsServiceApi, Worker } from \"../shared/protocol.ts\";\nimport { createPeer, type RpcPeer } from \"../shared/rpc.ts\";\nimport { childConnection, type Transport } from \"../shared/transport.ts\";\n\nconst SELF_EXTENSION = extname(fileURLToPath(import.meta.url));\nconst WORKER_ENTRY = fileURLToPath(new URL(`../worker/entry${SELF_EXTENSION}`, import.meta.url));\nconst WORKER_START_TIMEOUT_MS = 30_000;\n/** Grace period before an idle server retires, so a reconnecting presentation does not race it. */\nconst IDLE_SHUTDOWN_MS = 10_000;\n\n/** The server's routing entry for one session worker process. The worker knows none of this. */\ninterface Route {\n\tsessionId: string;\n\t/** Peer to the worker process. */\n\tworker: RpcPeer;\n\t/** Attached presentations by id, so an addressed event goes to exactly one of them. */\n\tsubscribers: Map<string, RpcPeer>;\n\tstop(): void;\n}\n\nasync function listSessions(sessionsRoot: string): Promise<SessionSummary[]> {\n\tconst executionEnv = new NodeExecutionEnv({ cwd: process.cwd() });\n\tconst repo = new JsonlSessionRepo({ fileSystem: executionEnv, sessionsRoot });\n\ttry {\n\t\treturn (await repo.list(undefined, BACKGROUND_CONTEXT)).map((metadata) => ({\n\t\t\tid: metadata.id,\n\t\t\tpath: metadata.path,\n\t\t\tcwd: metadata.cwd,\n\t\t\tcreatedAt: metadata.createdAt,\n\t\t}));\n\t} finally {\n\t\tawait repo.close(BACKGROUND_CONTEXT);\n\t\tawait executionEnv.cleanup(BACKGROUND_CONTEXT);\n\t}\n}\n\nexport async function runServer(options: { transport: Transport; sessionsRoot: string }): Promise<void> {\n\tconst routes = new Map<string, Route>();\n\tlet presentations = 0;\n\tlet retire = (): void => {};\n\tconst retired = new Promise<void>((resolve) => {\n\t\tretire = resolve;\n\t});\n\tlet idleTimer: NodeJS.Timeout | undefined;\n\t/** Nothing to serve and nothing running: leave, so the next start always gets current code. */\n\tconst considerRetiring = (): void => {\n\t\tif (idleTimer) clearTimeout(idleTimer);\n\t\tif (presentations > 0 || routes.size > 0) return;\n\t\tidleTimer = setTimeout(() => {\n\t\t\tif (presentations === 0 && routes.size === 0) retire();\n\t\t}, IDLE_SHUTDOWN_MS);\n\t\tidleTimer.unref();\n\t};\n\t/** Concurrent attaches to one session must share a worker: two writers would corrupt the session. */\n\tconst spawning = new Map<string, Promise<Route>>();\n\n\tconst spawnWorker = async (sessionId: string | undefined, cwd: string): Promise<Route> => {\n\t\tconst args = [...process.execArgv, WORKER_ENTRY, options.sessionsRoot, cwd, ...(sessionId ? [sessionId] : [])];\n\t\tconst child = spawn(process.execPath, args, { stdio: [\"pipe\", \"pipe\", \"inherit\"] });\n\t\tconst connection = childConnection(child);\n\t\tconst peer = createPeer(connection);\n\t\t// Workers consume `Sessions` through this same peer.\n\t\tpeer.provide(Sessions, { list, attach: attachUnsupported });\n\t\t// A worker that never answers must not wedge the attach that spawned it.\n\t\tconst described = await peer.use(Worker, { timeoutMs: WORKER_START_TIMEOUT_MS }).describe();\n\t\tconst route: Route = {\n\t\t\tsessionId: described.sessionId,\n\t\t\tworker: peer,\n\t\t\tsubscribers: new Map(),\n\t\t\tstop: () => child.kill(),\n\t\t};\n\t\t// Routing is the server's job. An addressed event reaches one presentation; the rest are shared.\n\t\tpeer.onEvent((service, payload, to) => {\n\t\t\tif (to !== undefined) {\n\t\t\t\troute.subscribers.get(to)?.emitRaw(service, payload);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tfor (const subscriber of route.subscribers.values()) subscriber.emitRaw(service, payload);\n\t\t});\n\t\tpeer.onClose(() => {\n\t\t\troutes.delete(route.sessionId);\n\t\t\tconsiderRetiring();\n\t\t});\n\t\troutes.set(route.sessionId, route);\n\t\treturn route;\n\t};\n\n\tconst ensureRoute = (sessionId: string | null, cwd: string): Promise<Route> => {\n\t\tif (sessionId === null) return spawnWorker(undefined, cwd);\n\t\tconst existing = routes.get(sessionId);\n\t\tif (existing) return Promise.resolve(existing);\n\t\tconst pending = spawning.get(sessionId);\n\t\tif (pending) return pending;\n\t\tconst started = spawnWorker(sessionId, cwd).finally(() => spawning.delete(sessionId));\n\t\tspawning.set(sessionId, started);\n\t\treturn started;\n\t};\n\n\tconst list = (): Promise<SessionSummary[]> => listSessions(options.sessionsRoot);\n\tconst attachUnsupported = async (): Promise<string> => {\n\t\tthrow new Error(\"Only presentations attach to sessions\");\n\t};\n\n\tconst listener = await options.transport.listen((connection) => {\n\t\tpresentations += 1;\n\t\tlet route: Route | undefined;\n\t\tlet attachedAs: string | undefined;\n\t\tconst sessions: SessionsServiceApi = {\n\t\t\tlist,\n\t\t\tattach: async (sessionId, cwd, presentationId) => {\n\t\t\t\troute?.subscribers.delete(attachedAs ?? \"\");\n\t\t\t\tattachedAs = presentationId;\n\t\t\t\troute = await ensureRoute(sessionId, cwd);\n\t\t\t\troute.subscribers.set(presentationId, presentation);\n\t\t\t\treturn route.sessionId;\n\t\t\t},\n\t\t};\n\t\tconst presentation: RpcPeer = createPeer(connection, {\n\t\t\tforward: (method, args) => {\n\t\t\t\tif (!route) throw new Error(\"Not attached to a session\");\n\t\t\t\tconst service = method.slice(0, method.indexOf(\".\"));\n\t\t\t\tif (!route.worker.announced.has(service)) {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t`No host provides ${service}: server has [${[...presentation.provided]}], worker has [${[...route.worker.announced]}]`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\treturn route.worker.call(method, ...args);\n\t\t\t},\n\t\t});\n\t\tpresentation.provide(Sessions, sessions);\n\t\tconnection.onClose(() => {\n\t\t\tpresentations -= 1;\n\t\t\tif (route && attachedAs !== undefined) {\n\t\t\t\troute.subscribers.delete(attachedAs);\n\t\t\t\t// One worker per session, kept alive only while someone is looking at it.\n\t\t\t\tif (route.subscribers.size === 0) route.stop();\n\t\t\t}\n\t\t\tconsiderRetiring();\n\t\t});\n\t});\n\n\tconsiderRetiring();\n\tawait retired;\n\tawait listener.close();\n}\n"]}

package/dist/experimental/mini/server/run.js

@@ -0,0 +1,150 @@
+/**
+ * Session server: accepts client connections, spawns one worker process per session, routes.
+ *
+ * It provides `Sessions` and holds no agent state. Any other service name is forwarded to the worker
+ * the calling client is attached to, and every worker event is pushed back to that worker's clients.
+ * Workers reach `Sessions` over the same peer, because the routing rule is symmetric.
+ */
+import { spawn } from "node:child_process";
+import { extname } from "node:path";
+import { fileURLToPath } from "node:url";
+// Narrow entries: the server routes and lists sessions, it never runs an agent.
+import { BACKGROUND_CONTEXT } from "@earendil-works/pi-agent-core/harness/context";
+import { NodeExecutionEnv } from "@earendil-works/pi-agent-core/harness/env/nodejs";
+import { JsonlSessionRepo } from "@earendil-works/pi-agent-core/harness/session";
+import { Sessions, Worker } from "../shared/protocol.js";
+import { createPeer } from "../shared/rpc.js";
+import { childConnection } from "../shared/transport.js";
+const SELF_EXTENSION = extname(fileURLToPath(import.meta.url));
+const WORKER_ENTRY = fileURLToPath(new URL(`../worker/entry${SELF_EXTENSION}`, import.meta.url));
+const WORKER_START_TIMEOUT_MS = 30_000;
+/** Grace period before an idle server retires, so a reconnecting presentation does not race it. */
+const IDLE_SHUTDOWN_MS = 10_000;
+async function listSessions(sessionsRoot) {
+    const executionEnv = new NodeExecutionEnv({ cwd: process.cwd() });
+    const repo = new JsonlSessionRepo({ fileSystem: executionEnv, sessionsRoot });
+    try {
+        return (await repo.list(undefined, BACKGROUND_CONTEXT)).map((metadata) => ({
+            id: metadata.id,
+            path: metadata.path,
+            cwd: metadata.cwd,
+            createdAt: metadata.createdAt,
+        }));
+    }
+    finally {
+        await repo.close(BACKGROUND_CONTEXT);
+        await executionEnv.cleanup(BACKGROUND_CONTEXT);
+    }
+}
+export async function runServer(options) {
+    const routes = new Map();
+    let presentations = 0;
+    let retire = () => { };
+    const retired = new Promise((resolve) => {
+        retire = resolve;
+    });
+    let idleTimer;
+    /** Nothing to serve and nothing running: leave, so the next start always gets current code. */
+    const considerRetiring = () => {
+        if (idleTimer)
+            clearTimeout(idleTimer);
+        if (presentations > 0 || routes.size > 0)
+            return;
+        idleTimer = setTimeout(() => {
+            if (presentations === 0 && routes.size === 0)
+                retire();
+        }, IDLE_SHUTDOWN_MS);
+        idleTimer.unref();
+    };
+    /** Concurrent attaches to one session must share a worker: two writers would corrupt the session. */
+    const spawning = new Map();
+    const spawnWorker = async (sessionId, cwd) => {
+        const args = [...process.execArgv, WORKER_ENTRY, options.sessionsRoot, cwd, ...(sessionId ? [sessionId] : [])];
+        const child = spawn(process.execPath, args, { stdio: ["pipe", "pipe", "inherit"] });
+        const connection = childConnection(child);
+        const peer = createPeer(connection);
+        // Workers consume `Sessions` through this same peer.
+        peer.provide(Sessions, { list, attach: attachUnsupported });
+        // A worker that never answers must not wedge the attach that spawned it.
+        const described = await peer.use(Worker, { timeoutMs: WORKER_START_TIMEOUT_MS }).describe();
+        const route = {
+            sessionId: described.sessionId,
+            worker: peer,
+            subscribers: new Map(),
+            stop: () => child.kill(),
+        };
+        // Routing is the server's job. An addressed event reaches one presentation; the rest are shared.
+        peer.onEvent((service, payload, to) => {
+            if (to !== undefined) {
+                route.subscribers.get(to)?.emitRaw(service, payload);
+                return;
+            }
+            for (const subscriber of route.subscribers.values())
+                subscriber.emitRaw(service, payload);
+        });
+        peer.onClose(() => {
+            routes.delete(route.sessionId);
+            considerRetiring();
+        });
+        routes.set(route.sessionId, route);
+        return route;
+    };
+    const ensureRoute = (sessionId, cwd) => {
+        if (sessionId === null)
+            return spawnWorker(undefined, cwd);
+        const existing = routes.get(sessionId);
+        if (existing)
+            return Promise.resolve(existing);
+        const pending = spawning.get(sessionId);
+        if (pending)
+            return pending;
+        const started = spawnWorker(sessionId, cwd).finally(() => spawning.delete(sessionId));
+        spawning.set(sessionId, started);
+        return started;
+    };
+    const list = () => listSessions(options.sessionsRoot);
+    const attachUnsupported = async () => {
+        throw new Error("Only presentations attach to sessions");
+    };
+    const listener = await options.transport.listen((connection) => {
+        presentations += 1;
+        let route;
+        let attachedAs;
+        const sessions = {
+            list,
+            attach: async (sessionId, cwd, presentationId) => {
+                route?.subscribers.delete(attachedAs ?? "");
+                attachedAs = presentationId;
+                route = await ensureRoute(sessionId, cwd);
+                route.subscribers.set(presentationId, presentation);
+                return route.sessionId;
+            },
+        };
+        const presentation = createPeer(connection, {
+            forward: (method, args) => {
+                if (!route)
+                    throw new Error("Not attached to a session");
+                const service = method.slice(0, method.indexOf("."));
+                if (!route.worker.announced.has(service)) {
+                    throw new Error(`No host provides ${service}: server has [${[...presentation.provided]}], worker has [${[...route.worker.announced]}]`);
+                }
+                return route.worker.call(method, ...args);
+            },
+        });
+        presentation.provide(Sessions, sessions);
+        connection.onClose(() => {
+            presentations -= 1;
+            if (route && attachedAs !== undefined) {
+                route.subscribers.delete(attachedAs);
+                // One worker per session, kept alive only while someone is looking at it.
+                if (route.subscribers.size === 0)
+                    route.stop();
+            }
+            considerRetiring();
+        });
+    });
+    considerRetiring();
+    await retired;
+    await listener.close();
+}
+//# sourceMappingURL=run.js.map

package/dist/experimental/mini/server/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../../src/experimental/mini/server/run.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Session server: accepts client connections, spawns one worker process per session, routes.\n *\n * It provides `Sessions` and holds no agent state. Any other service name is forwarded to the worker\n * the calling client is attached to, and every worker event is pushed back to that worker's clients.\n * Workers reach `Sessions` over the same peer, because the routing rule is symmetric.\n */\n\nimport { spawn } from \"node:child_process\";\nimport { extname } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n// Narrow entries: the server routes and lists sessions, it never runs an agent.\nimport { BACKGROUND_CONTEXT } from \"@earendil-works/pi-agent-core/harness/context\";\nimport { NodeExecutionEnv } from \"@earendil-works/pi-agent-core/harness/env/nodejs\";\nimport { JsonlSessionRepo } from \"@earendil-works/pi-agent-core/harness/session\";\nimport { type SessionSummary, Sessions, type SessionsServiceApi, Worker } from \"../shared/protocol.ts\";\nimport { createPeer, type RpcPeer } from \"../shared/rpc.ts\";\nimport { childConnection, type Transport } from \"../shared/transport.ts\";\n\nconst SELF_EXTENSION = extname(fileURLToPath(import.meta.url));\nconst WORKER_ENTRY = fileURLToPath(new URL(`../worker/entry${SELF_EXTENSION}`, import.meta.url));\nconst WORKER_START_TIMEOUT_MS = 30_000;\n/** Grace period before an idle server retires, so a reconnecting presentation does not race it. */\nconst IDLE_SHUTDOWN_MS = 10_000;\n\n/** The server's routing entry for one session worker process. The worker knows none of this. */\ninterface Route {\n\tsessionId: string;\n\t/** Peer to the worker process. */\n\tworker: RpcPeer;\n\t/** Attached presentations by id, so an addressed event goes to exactly one of them. */\n\tsubscribers: Map<string, RpcPeer>;\n\tstop(): void;\n}\n\nasync function listSessions(sessionsRoot: string): Promise<SessionSummary[]> {\n\tconst executionEnv = new NodeExecutionEnv({ cwd: process.cwd() });\n\tconst repo = new JsonlSessionRepo({ fileSystem: executionEnv, sessionsRoot });\n\ttry {\n\t\treturn (await repo.list(undefined, BACKGROUND_CONTEXT)).map((metadata) => ({\n\t\t\tid: metadata.id,\n\t\t\tpath: metadata.path,\n\t\t\tcwd: metadata.cwd,\n\t\t\tcreatedAt: metadata.createdAt,\n\t\t}));\n\t} finally {\n\t\tawait repo.close(BACKGROUND_CONTEXT);\n\t\tawait executionEnv.cleanup(BACKGROUND_CONTEXT);\n\t}\n}\n\nexport async function runServer(options: { transport: Transport; sessionsRoot: string }): Promise<void> {\n\tconst routes = new Map<string, Route>();\n\tlet presentations = 0;\n\tlet retire = (): void => {};\n\tconst retired = new Promise<void>((resolve) => {\n\t\tretire = resolve;\n\t});\n\tlet idleTimer: NodeJS.Timeout | undefined;\n\t/** Nothing to serve and nothing running: leave, so the next start always gets current code. */\n\tconst considerRetiring = (): void => {\n\t\tif (idleTimer) clearTimeout(idleTimer);\n\t\tif (presentations > 0 || routes.size > 0) return;\n\t\tidleTimer = setTimeout(() => {\n\t\t\tif (presentations === 0 && routes.size === 0) retire();\n\t\t}, IDLE_SHUTDOWN_MS);\n\t\tidleTimer.unref();\n\t};\n\t/** Concurrent attaches to one session must share a worker: two writers would corrupt the session. */\n\tconst spawning = new Map<string, Promise<Route>>();\n\n\tconst spawnWorker = async (sessionId: string | undefined, cwd: string): Promise<Route> => {\n\t\tconst args = [...process.execArgv, WORKER_ENTRY, options.sessionsRoot, cwd, ...(sessionId ? [sessionId] : [])];\n\t\tconst child = spawn(process.execPath, args, { stdio: [\"pipe\", \"pipe\", \"inherit\"] });\n\t\tconst connection = childConnection(child);\n\t\tconst peer = createPeer(connection);\n\t\t// Workers consume `Sessions` through this same peer.\n\t\tpeer.provide(Sessions, { list, attach: attachUnsupported });\n\t\t// A worker that never answers must not wedge the attach that spawned it.\n\t\tconst described = await peer.use(Worker, { timeoutMs: WORKER_START_TIMEOUT_MS }).describe();\n\t\tconst route: Route = {\n\t\t\tsessionId: described.sessionId,\n\t\t\tworker: peer,\n\t\t\tsubscribers: new Map(),\n\t\t\tstop: () => child.kill(),\n\t\t};\n\t\t// Routing is the server's job. An addressed event reaches one presentation; the rest are shared.\n\t\tpeer.onEvent((service, payload, to) => {\n\t\t\tif (to !== undefined) {\n\t\t\t\troute.subscribers.get(to)?.emitRaw(service, payload);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tfor (const subscriber of route.subscribers.values()) subscriber.emitRaw(service, payload);\n\t\t});\n\t\tpeer.onClose(() => {\n\t\t\troutes.delete(route.sessionId);\n\t\t\tconsiderRetiring();\n\t\t});\n\t\troutes.set(route.sessionId, route);\n\t\treturn route;\n\t};\n\n\tconst ensureRoute = (sessionId: string | null, cwd: string): Promise<Route> => {\n\t\tif (sessionId === null) return spawnWorker(undefined, cwd);\n\t\tconst existing = routes.get(sessionId);\n\t\tif (existing) return Promise.resolve(existing);\n\t\tconst pending = spawning.get(sessionId);\n\t\tif (pending) return pending;\n\t\tconst started = spawnWorker(sessionId, cwd).finally(() => spawning.delete(sessionId));\n\t\tspawning.set(sessionId, started);\n\t\treturn started;\n\t};\n\n\tconst list = (): Promise<SessionSummary[]> => listSessions(options.sessionsRoot);\n\tconst attachUnsupported = async (): Promise<string> => {\n\t\tthrow new Error(\"Only presentations attach to sessions\");\n\t};\n\n\tconst listener = await options.transport.listen((connection) => {\n\t\tpresentations += 1;\n\t\tlet route: Route | undefined;\n\t\tlet attachedAs: string | undefined;\n\t\tconst sessions: SessionsServiceApi = {\n\t\t\tlist,\n\t\t\tattach: async (sessionId, cwd, presentationId) => {\n\t\t\t\troute?.subscribers.delete(attachedAs ?? \"\");\n\t\t\t\tattachedAs = presentationId;\n\t\t\t\troute = await ensureRoute(sessionId, cwd);\n\t\t\t\troute.subscribers.set(presentationId, presentation);\n\t\t\t\treturn route.sessionId;\n\t\t\t},\n\t\t};\n\t\tconst presentation: RpcPeer = createPeer(connection, {\n\t\t\tforward: (method, args) => {\n\t\t\t\tif (!route) throw new Error(\"Not attached to a session\");\n\t\t\t\tconst service = method.slice(0, method.indexOf(\".\"));\n\t\t\t\tif (!route.worker.announced.has(service)) {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t`No host provides ${service}: server has [${[...presentation.provided]}], worker has [${[...route.worker.announced]}]`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\treturn route.worker.call(method, ...args);\n\t\t\t},\n\t\t});\n\t\tpresentation.provide(Sessions, sessions);\n\t\tconnection.onClose(() => {\n\t\t\tpresentations -= 1;\n\t\t\tif (route && attachedAs !== undefined) {\n\t\t\t\troute.subscribers.delete(attachedAs);\n\t\t\t\t// One worker per session, kept alive only while someone is looking at it.\n\t\t\t\tif (route.subscribers.size === 0) route.stop();\n\t\t\t}\n\t\t\tconsiderRetiring();\n\t\t});\n\t});\n\n\tconsiderRetiring();\n\tawait retired;\n\tawait listener.close();\n}\n"]}

package/dist/experimental/mini/shared/protocol.d.ts

@@ -0,0 +1,127 @@
+/** Service contracts and everything that crosses the wire. */
+import type { HarnessEvent, LaneSnapshot } from "@earendil-works/pi-agent-core";
+import type { AuthEvent, AuthPrompt } from "@earendil-works/pi-ai";
+/** Commands answer with data, never exceptions, exactly like a remote call would. */
+export type CommandResult = {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+/** Durable model identity. Nothing outside a worker holds a `Model` object. */
+export interface ModelRef {
+    provider: string;
+    modelId: string;
+}
+export interface ModelSummary extends ModelRef {
+    name: string;
+}
+export interface ProviderAccount {
+    id: string;
+    name: string;
+    authType: "oauth" | "api_key";
+    configured: boolean;
+    /** Where the credential came from, for display: "stored", "environment", an env var name. */
+    source?: string;
+    /** False for ambient credentials pi cannot collect itself, such as AWS profiles or env vars. */
+    interactive: boolean;
+    methodName?: string;
+}
+export interface ModelsState {
+    readonly models: readonly ModelSummary[];
+    readonly accounts: readonly ProviderAccount[];
+    readonly refreshing: boolean;
+}
+/** An auth prompt without its `AbortSignal`: the part that can cross a transport. */
+export type AuthPromptRequest = AuthPrompt extends infer Prompt ? Prompt extends unknown ? Omit<Prompt, "signal"> : never : never;
+/** A service seen from the other side of a connection: every method returns a promise. */
+export type Remote<T> = {
+    [K in keyof T]: T[K] extends (...args: infer A) => infer R ? (...args: A) => Promise<Awaited<R>> : never;
+};
+/** Names one service and carries its call and event types. Names are globally unique. */
+export interface ServiceToken<TApi extends object, TEvent = never> {
+    readonly name: string;
+    /** Phantom, never read: keeps the types attached to the token. */
+    readonly types?: (api: TApi, event: TEvent) => void;
+}
+export declare function defineService<TApi extends object, TEvent = never>(name: string): ServiceToken<TApi, TEvent>;
+export interface SessionSummary {
+    id: string;
+    path: string;
+    cwd: string;
+    createdAt: number;
+}
+export interface SessionSnapshot {
+    sessionId: string;
+    cwd: string;
+    sessionPath: string;
+    /** Carries the lane configuration, queues, and stats: no side-channel replication. */
+    lane: LaneSnapshot;
+    models: ModelsState;
+}
+/** Everything the `Models` service publishes. */
+export type ModelsEvent = {
+    type: "state";
+    state: ModelsState;
+} | {
+    type: "prompt";
+    requestId: string;
+    request: AuthPromptRequest;
+} | {
+    type: "notice";
+    notice: AuthEvent;
+};
+/** The login half, for whatever drives the dialog. */
+export type AuthEventPayload = Exclude<ModelsEvent, {
+    type: "state";
+}>;
+/** One presentation's subscription: a `lane.watch()` in the worker, named so its events can be filtered. */
+export interface LaneSubscription {
+    subscriptionId: string;
+    snapshot: SessionSnapshot;
+}
+/** Lane events are addressed to the subscription whose watch produced them. */
+export interface LaneEvent {
+    subscriptionId: string;
+    event: HarnessEvent;
+}
+export interface LaneServiceApi {
+    /**
+     * Capture a snapshot and open a subscription for one presentation. Its events are addressed to
+     * `presentationId`, so the server routes them instead of broadcasting. Buffered until `start`.
+     */
+    watch(presentationId: string): Promise<LaneSubscription>;
+    /** Begin delivery, draining everything buffered since the snapshot. */
+    start(subscriptionId: string): Promise<void>;
+    unwatch(subscriptionId: string): Promise<void>;
+    prompt(text: string): Promise<CommandResult>;
+    steer(text: string): Promise<CommandResult>;
+    followUp(text: string): Promise<CommandResult>;
+    compact(): Promise<CommandResult>;
+    abort(): Promise<CommandResult>;
+    setModel(ref: ModelRef): Promise<CommandResult>;
+}
+export interface ModelsServiceApi {
+    refresh(): Promise<CommandResult>;
+    login(providerId: string, authType: "oauth" | "api_key"): Promise<CommandResult>;
+    authReply(requestId: string, answer: string | null): Promise<void>;
+}
+/** Provided by a worker so the server can identify the session it opened, without naming lane methods. */
+export interface WorkerServiceApi {
+    describe(): Promise<{
+        sessionId: string;
+    }>;
+}
+export interface SessionsServiceApi {
+    list(): Promise<SessionSummary[]>;
+    attach(sessionId: string | null, cwd: string, presentationId: string): Promise<string>;
+}
+/** Provided by the worker. One subscription per presentation; `watch` again to rebase. */
+export declare const Lane: ServiceToken<LaneServiceApi, LaneEvent>;
+/** Provided by the worker. Small enough to publish whole. */
+export declare const Models: ServiceToken<ModelsServiceApi, ModelsEvent>;
+/** Provided by the worker, consumed only by the server. */
+export declare const Worker: ServiceToken<WorkerServiceApi, never>;
+/** Provided by the server. */
+export declare const Sessions: ServiceToken<SessionsServiceApi, never>;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/experimental/mini/shared/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../../src/experimental/mini/shared/protocol.ts"],"names":[],"mappings":"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","sourcesContent":["/** Service contracts and everything that crosses the wire. */\n\nimport type { HarnessEvent, LaneSnapshot } from \"@earendil-works/pi-agent-core\";\nimport type { AuthEvent, AuthPrompt } from \"@earendil-works/pi-ai\";\n\n/** Commands answer with data, never exceptions, exactly like a remote call would. */\nexport type CommandResult = { ok: true } | { ok: false; error: string };\n\n/** Durable model identity. Nothing outside a worker holds a `Model` object. */\nexport interface ModelRef {\n\tprovider: string;\n\tmodelId: string;\n}\n\nexport interface ModelSummary extends ModelRef {\n\tname: string;\n}\n\nexport interface ProviderAccount {\n\tid: string;\n\tname: string;\n\tauthType: \"oauth\" | \"api_key\";\n\tconfigured: boolean;\n\t/** Where the credential came from, for display: \"stored\", \"environment\", an env var name. */\n\tsource?: string;\n\t/** False for ambient credentials pi cannot collect itself, such as AWS profiles or env vars. */\n\tinteractive: boolean;\n\tmethodName?: string;\n}\n\nexport interface ModelsState {\n\treadonly models: readonly ModelSummary[];\n\treadonly accounts: readonly ProviderAccount[];\n\treadonly refreshing: boolean;\n}\n\n/** An auth prompt without its `AbortSignal`: the part that can cross a transport. */\nexport type AuthPromptRequest = AuthPrompt extends infer Prompt\n\t? Prompt extends unknown\n\t\t? Omit<Prompt, \"signal\">\n\t\t: never\n\t: never;\n\n/** A service seen from the other side of a connection: every method returns a promise. */\nexport type Remote<T> = {\n\t[K in keyof T]: T[K] extends (...args: infer A) => infer R ? (...args: A) => Promise<Awaited<R>> : never;\n};\n\n/** Names one service and carries its call and event types. Names are globally unique. */\nexport interface ServiceToken<TApi extends object, TEvent = never> {\n\treadonly name: string;\n\t/** Phantom, never read: keeps the types attached to the token. */\n\treadonly types?: (api: TApi, event: TEvent) => void;\n}\n\nexport function defineService<TApi extends object, TEvent = never>(name: string): ServiceToken<TApi, TEvent> {\n\treturn { name };\n}\n\nexport interface SessionSummary {\n\tid: string;\n\tpath: string;\n\tcwd: string;\n\tcreatedAt: number;\n}\n\nexport interface SessionSnapshot {\n\tsessionId: string;\n\tcwd: string;\n\tsessionPath: string;\n\t/** Carries the lane configuration, queues, and stats: no side-channel replication. */\n\tlane: LaneSnapshot;\n\tmodels: ModelsState;\n}\n\n/** Everything the `Models` service publishes. */\nexport type ModelsEvent =\n\t| { type: \"state\"; state: ModelsState }\n\t// Login runs the wrong way round: the request is an event, the answer is an ordinary call.\n\t| { type: \"prompt\"; requestId: string; request: AuthPromptRequest }\n\t| { type: \"notice\"; notice: AuthEvent };\n\n/** The login half, for whatever drives the dialog. */\nexport type AuthEventPayload = Exclude<ModelsEvent, { type: \"state\" }>;\n\n/** One presentation's subscription: a `lane.watch()` in the worker, named so its events can be filtered. */\nexport interface LaneSubscription {\n\tsubscriptionId: string;\n\tsnapshot: SessionSnapshot;\n}\n\n/** Lane events are addressed to the subscription whose watch produced them. */\nexport interface LaneEvent {\n\tsubscriptionId: string;\n\tevent: HarnessEvent;\n}\n\nexport interface LaneServiceApi {\n\t/**\n\t * Capture a snapshot and open a subscription for one presentation. Its events are addressed to\n\t * `presentationId`, so the server routes them instead of broadcasting. Buffered until `start`.\n\t */\n\twatch(presentationId: string): Promise<LaneSubscription>;\n\t/** Begin delivery, draining everything buffered since the snapshot. */\n\tstart(subscriptionId: string): Promise<void>;\n\tunwatch(subscriptionId: string): Promise<void>;\n\tprompt(text: string): Promise<CommandResult>;\n\tsteer(text: string): Promise<CommandResult>;\n\tfollowUp(text: string): Promise<CommandResult>;\n\tcompact(): Promise<CommandResult>;\n\tabort(): Promise<CommandResult>;\n\tsetModel(ref: ModelRef): Promise<CommandResult>;\n}\n\nexport interface ModelsServiceApi {\n\trefresh(): Promise<CommandResult>;\n\tlogin(providerId: string, authType: \"oauth\" | \"api_key\"): Promise<CommandResult>;\n\tauthReply(requestId: string, answer: string | null): Promise<void>;\n}\n\n/** Provided by a worker so the server can identify the session it opened, without naming lane methods. */\nexport interface WorkerServiceApi {\n\tdescribe(): Promise<{ sessionId: string }>;\n}\n\nexport interface SessionsServiceApi {\n\tlist(): Promise<SessionSummary[]>;\n\tattach(sessionId: string | null, cwd: string, presentationId: string): Promise<string>;\n}\n\n/** Provided by the worker. One subscription per presentation; `watch` again to rebase. */\nexport const Lane = defineService<LaneServiceApi, LaneEvent>(\"lane\");\n/** Provided by the worker. Small enough to publish whole. */\nexport const Models = defineService<ModelsServiceApi, ModelsEvent>(\"models\");\n/** Provided by the worker, consumed only by the server. */\nexport const Worker = defineService<WorkerServiceApi>(\"worker\");\n/** Provided by the server. */\nexport const Sessions = defineService<SessionsServiceApi>(\"sessions\");\n"]}

package/dist/experimental/mini/shared/protocol.js

@@ -0,0 +1,13 @@
+/** Service contracts and everything that crosses the wire. */
+export function defineService(name) {
+    return { name };
+}
+/** Provided by the worker. One subscription per presentation; `watch` again to rebase. */
+export const Lane = defineService("lane");
+/** Provided by the worker. Small enough to publish whole. */
+export const Models = defineService("models");
+/** Provided by the worker, consumed only by the server. */
+export const Worker = defineService("worker");
+/** Provided by the server. */
+export const Sessions = defineService("sessions");
+//# sourceMappingURL=protocol.js.map

package/dist/experimental/mini/shared/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../../../src/experimental/mini/shared/protocol.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAuD9D,MAAM,UAAU,aAAa,CAAsC,IAAY,EAA8B;IAC5G,OAAO,EAAE,IAAI,EAAE,CAAC;AAAA,CAChB;AAyED,0FAA0F;AAC1F,MAAM,CAAC,MAAM,IAAI,GAAG,aAAa,CAA4B,MAAM,CAAC,CAAC;AACrE,6DAA6D;AAC7D,MAAM,CAAC,MAAM,MAAM,GAAG,aAAa,CAAgC,QAAQ,CAAC,CAAC;AAC7E,2DAA2D;AAC3D,MAAM,CAAC,MAAM,MAAM,GAAG,aAAa,CAAmB,QAAQ,CAAC,CAAC;AAChE,8BAA8B;AAC9B,MAAM,CAAC,MAAM,QAAQ,GAAG,aAAa,CAAqB,UAAU,CAAC,CAAC","sourcesContent":["/** Service contracts and everything that crosses the wire. */\n\nimport type { HarnessEvent, LaneSnapshot } from \"@earendil-works/pi-agent-core\";\nimport type { AuthEvent, AuthPrompt } from \"@earendil-works/pi-ai\";\n\n/** Commands answer with data, never exceptions, exactly like a remote call would. */\nexport type CommandResult = { ok: true } | { ok: false; error: string };\n\n/** Durable model identity. Nothing outside a worker holds a `Model` object. */\nexport interface ModelRef {\n\tprovider: string;\n\tmodelId: string;\n}\n\nexport interface ModelSummary extends ModelRef {\n\tname: string;\n}\n\nexport interface ProviderAccount {\n\tid: string;\n\tname: string;\n\tauthType: \"oauth\" | \"api_key\";\n\tconfigured: boolean;\n\t/** Where the credential came from, for display: \"stored\", \"environment\", an env var name. */\n\tsource?: string;\n\t/** False for ambient credentials pi cannot collect itself, such as AWS profiles or env vars. */\n\tinteractive: boolean;\n\tmethodName?: string;\n}\n\nexport interface ModelsState {\n\treadonly models: readonly ModelSummary[];\n\treadonly accounts: readonly ProviderAccount[];\n\treadonly refreshing: boolean;\n}\n\n/** An auth prompt without its `AbortSignal`: the part that can cross a transport. */\nexport type AuthPromptRequest = AuthPrompt extends infer Prompt\n\t? Prompt extends unknown\n\t\t? Omit<Prompt, \"signal\">\n\t\t: never\n\t: never;\n\n/** A service seen from the other side of a connection: every method returns a promise. */\nexport type Remote<T> = {\n\t[K in keyof T]: T[K] extends (...args: infer A) => infer R ? (...args: A) => Promise<Awaited<R>> : never;\n};\n\n/** Names one service and carries its call and event types. Names are globally unique. */\nexport interface ServiceToken<TApi extends object, TEvent = never> {\n\treadonly name: string;\n\t/** Phantom, never read: keeps the types attached to the token. */\n\treadonly types?: (api: TApi, event: TEvent) => void;\n}\n\nexport function defineService<TApi extends object, TEvent = never>(name: string): ServiceToken<TApi, TEvent> {\n\treturn { name };\n}\n\nexport interface SessionSummary {\n\tid: string;\n\tpath: string;\n\tcwd: string;\n\tcreatedAt: number;\n}\n\nexport interface SessionSnapshot {\n\tsessionId: string;\n\tcwd: string;\n\tsessionPath: string;\n\t/** Carries the lane configuration, queues, and stats: no side-channel replication. */\n\tlane: LaneSnapshot;\n\tmodels: ModelsState;\n}\n\n/** Everything the `Models` service publishes. */\nexport type ModelsEvent =\n\t| { type: \"state\"; state: ModelsState }\n\t// Login runs the wrong way round: the request is an event, the answer is an ordinary call.\n\t| { type: \"prompt\"; requestId: string; request: AuthPromptRequest }\n\t| { type: \"notice\"; notice: AuthEvent };\n\n/** The login half, for whatever drives the dialog. */\nexport type AuthEventPayload = Exclude<ModelsEvent, { type: \"state\" }>;\n\n/** One presentation's subscription: a `lane.watch()` in the worker, named so its events can be filtered. */\nexport interface LaneSubscription {\n\tsubscriptionId: string;\n\tsnapshot: SessionSnapshot;\n}\n\n/** Lane events are addressed to the subscription whose watch produced them. */\nexport interface LaneEvent {\n\tsubscriptionId: string;\n\tevent: HarnessEvent;\n}\n\nexport interface LaneServiceApi {\n\t/**\n\t * Capture a snapshot and open a subscription for one presentation. Its events are addressed to\n\t * `presentationId`, so the server routes them instead of broadcasting. Buffered until `start`.\n\t */\n\twatch(presentationId: string): Promise<LaneSubscription>;\n\t/** Begin delivery, draining everything buffered since the snapshot. */\n\tstart(subscriptionId: string): Promise<void>;\n\tunwatch(subscriptionId: string): Promise<void>;\n\tprompt(text: string): Promise<CommandResult>;\n\tsteer(text: string): Promise<CommandResult>;\n\tfollowUp(text: string): Promise<CommandResult>;\n\tcompact(): Promise<CommandResult>;\n\tabort(): Promise<CommandResult>;\n\tsetModel(ref: ModelRef): Promise<CommandResult>;\n}\n\nexport interface ModelsServiceApi {\n\trefresh(): Promise<CommandResult>;\n\tlogin(providerId: string, authType: \"oauth\" | \"api_key\"): Promise<CommandResult>;\n\tauthReply(requestId: string, answer: string | null): Promise<void>;\n}\n\n/** Provided by a worker so the server can identify the session it opened, without naming lane methods. */\nexport interface WorkerServiceApi {\n\tdescribe(): Promise<{ sessionId: string }>;\n}\n\nexport interface SessionsServiceApi {\n\tlist(): Promise<SessionSummary[]>;\n\tattach(sessionId: string | null, cwd: string, presentationId: string): Promise<string>;\n}\n\n/** Provided by the worker. One subscription per presentation; `watch` again to rebase. */\nexport const Lane = defineService<LaneServiceApi, LaneEvent>(\"lane\");\n/** Provided by the worker. Small enough to publish whole. */\nexport const Models = defineService<ModelsServiceApi, ModelsEvent>(\"models\");\n/** Provided by the worker, consumed only by the server. */\nexport const Worker = defineService<WorkerServiceApi>(\"worker\");\n/** Provided by the server. */\nexport const Sessions = defineService<SessionsServiceApi>(\"sessions\");\n"]}

package/dist/experimental/mini/shared/rpc.d.ts

@@ -0,0 +1,49 @@
+/**
+ * The whole protocol: call, result, error, cancel, event, ping. Plus named services and one routing
+ * rule.
+ *
+ * A peer provides any number of services and uses the other side's. A call for a service this peer
+ * does not provide goes to `forward`, which is what makes the server transparent: a TUI uses
+ * `lane.prompt`, the server does not provide `lane`, so it hands the call to the attached worker.
+ * The same rule lets a worker use `sessions.list` back through the server.
+ */
+import type { Remote, ServiceToken } from "./protocol.ts";
+import type { Connection } from "./transport.ts";
+export type Forward = (method: string, args: unknown[]) => Promise<unknown>;
+export interface CallOptions {
+    /** Abandon the call and tell the peer to stop. */
+    signal?: AbortSignal;
+    /** Reject if the peer has not answered in time. Omit for calls with no bounded duration. */
+    timeoutMs?: number;
+}
+export interface PeerOptions {
+    /** Handles calls for services this peer does not provide. */
+    forward?: Forward;
+    /** Silence tolerated before the peer is declared gone. Default 15s; 0 disables liveness. */
+    deadMs?: number;
+}
+export interface RpcPeer {
+    /** Register an implementation and announce the name to the other side. */
+    provide<TApi extends object, TEvent>(token: ServiceToken<TApi, TEvent>, implementation: TApi): void;
+    /** Services this peer provides. */
+    readonly provided: ReadonlySet<string>;
+    /** Services the other side announced. */
+    readonly announced: ReadonlySet<string>;
+    /** Use a service, wherever it is provided: this peer's other side, or its next hop. */
+    use<TApi extends object, TEvent>(token: ServiceToken<TApi, TEvent>, options?: CallOptions): Remote<TApi>;
+    /** Publish to everyone listening on the other side. */
+    emit<TApi extends object, TEvent>(token: ServiceToken<TApi, TEvent>, event: TEvent): void;
+    /** Publish for one destination. A router delivers it there instead of broadcasting. */
+    emitTo<TApi extends object, TEvent>(token: ServiceToken<TApi, TEvent>, event: TEvent, to: string): void;
+    on<TApi extends object, TEvent>(token: ServiceToken<TApi, TEvent>, handler: (event: TEvent) => void): void;
+    /** Router half of the event channel: observe and republish without knowing the service. */
+    onEvent(handler: (service: string, payload: unknown, to: string | undefined) => void): void;
+    emitRaw(service: string, payload: unknown, to?: string): void;
+    call(method: string, ...args: unknown[]): Promise<unknown>;
+    callWith(options: CallOptions, method: string, ...args: unknown[]): Promise<unknown>;
+    onClose(handler: () => void): void;
+    close(): void;
+}
+/** A bidirectional peer on one connection. */
+export declare function createPeer(connection: Connection, options?: PeerOptions): RpcPeer;
+//# sourceMappingURL=rpc.d.ts.map

package/dist/experimental/mini/shared/rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../../../../src/experimental/mini/shared/rpc.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAWjD,MAAM,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAE5E,MAAM,WAAW,WAAW;IAC3B,kDAAkD;IAClD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,4FAA4F;IAC5F,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC3B,6DAA6D;IAC7D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4FAA4F;IAC5F,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,MAAM,WAAW,OAAO;IACvB,0EAA0E;IAC1E,OAAO,CAAC,IAAI,SAAS,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,cAAc,EAAE,IAAI,GAAG,IAAI,CAAC;IACpG,mCAAmC;IACnC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACvC,yCAAyC;IACzC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACxC,uFAAuF;IACvF,GAAG,CAAC,IAAI,SAAS,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IACzG,uDAAuD;IACvD,IAAI,CAAC,IAAI,SAAS,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1F,uFAAuF;IACvF,MAAM,CAAC,IAAI,SAAS,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACxG,EAAE,CAAC,IAAI,SAAS,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAC3G,2FAA2F;IAC3F,OAAO,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,GAAG,IAAI,CAAC;IAC5F,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9D,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3D,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrF,OAAO,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACnC,KAAK,IAAI,IAAI,CAAC;CACd;AAED,8CAA8C;AAC9C,wBAAgB,UAAU,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAoKrF","sourcesContent":["/**\n * The whole protocol: call, result, error, cancel, event, ping. Plus named services and one routing\n * rule.\n *\n * A peer provides any number of services and uses the other side's. A call for a service this peer\n * does not provide goes to `forward`, which is what makes the server transparent: a TUI uses\n * `lane.prompt`, the server does not provide `lane`, so it hands the call to the attached worker.\n * The same rule lets a worker use `sessions.list` back through the server.\n */\n\nimport type { Remote, ServiceToken } from \"./protocol.ts\";\nimport type { Connection } from \"./transport.ts\";\n\ntype Frame =\n\t| { kind: \"call\"; id: number; method: string; args: unknown[] }\n\t| { kind: \"result\"; id: number; result: unknown }\n\t| { kind: \"error\"; id: number; error: string }\n\t| { kind: \"cancel\"; id: number }\n\t| { kind: \"event\"; service: string; payload: unknown; to?: string }\n\t| { kind: \"announce\"; services: string[] }\n\t| { kind: \"ping\" };\n\nexport type Forward = (method: string, args: unknown[]) => Promise<unknown>;\n\nexport interface CallOptions {\n\t/** Abandon the call and tell the peer to stop. */\n\tsignal?: AbortSignal;\n\t/** Reject if the peer has not answered in time. Omit for calls with no bounded duration. */\n\ttimeoutMs?: number;\n}\n\nexport interface PeerOptions {\n\t/** Handles calls for services this peer does not provide. */\n\tforward?: Forward;\n\t/** Silence tolerated before the peer is declared gone. Default 15s; 0 disables liveness. */\n\tdeadMs?: number;\n}\n\nconst DEFAULT_DEAD_MS = 15_000;\n\nexport interface RpcPeer {\n\t/** Register an implementation and announce the name to the other side. */\n\tprovide<TApi extends object, TEvent>(token: ServiceToken<TApi, TEvent>, implementation: TApi): void;\n\t/** Services this peer provides. */\n\treadonly provided: ReadonlySet<string>;\n\t/** Services the other side announced. */\n\treadonly announced: ReadonlySet<string>;\n\t/** Use a service, wherever it is provided: this peer's other side, or its next hop. */\n\tuse<TApi extends object, TEvent>(token: ServiceToken<TApi, TEvent>, options?: CallOptions): Remote<TApi>;\n\t/** Publish to everyone listening on the other side. */\n\temit<TApi extends object, TEvent>(token: ServiceToken<TApi, TEvent>, event: TEvent): void;\n\t/** Publish for one destination. A router delivers it there instead of broadcasting. */\n\temitTo<TApi extends object, TEvent>(token: ServiceToken<TApi, TEvent>, event: TEvent, to: string): void;\n\ton<TApi extends object, TEvent>(token: ServiceToken<TApi, TEvent>, handler: (event: TEvent) => void): void;\n\t/** Router half of the event channel: observe and republish without knowing the service. */\n\tonEvent(handler: (service: string, payload: unknown, to: string | undefined) => void): void;\n\temitRaw(service: string, payload: unknown, to?: string): void;\n\tcall(method: string, ...args: unknown[]): Promise<unknown>;\n\tcallWith(options: CallOptions, method: string, ...args: unknown[]): Promise<unknown>;\n\tonClose(handler: () => void): void;\n\tclose(): void;\n}\n\n/** A bidirectional peer on one connection. */\nexport function createPeer(connection: Connection, options: PeerOptions = {}): RpcPeer {\n\tconst services = new Map<string, object>();\n\tconst provided = new Set<string>();\n\t/** What the other side told us it provides, so routing is a lookup rather than a guess. */\n\tconst announced = new Set<string>();\n\tconst pending = new Map<number, { resolve: (value: unknown) => void; reject: (error: Error) => void }>();\n\t/** Controllers for calls this peer is currently answering, so a `cancel` frame can stop them. */\n\tconst inflight = new Map<number, AbortController>();\n\tconst eventHandlers: ((service: string, payload: unknown, to: string | undefined) => void)[] = [];\n\tlet nextId = 1;\n\tlet lastFrameAt = Date.now();\n\n\t// The signal is appended to every handler call: services that care declare a trailing\n\t// `AbortSignal` parameter, the rest ignore an extra argument.\n\tconst dispatch = async (method: string, args: unknown[], signal: AbortSignal): Promise<unknown> => {\n\t\tconst dot = method.indexOf(\".\");\n\t\tconst local = dot === -1 ? undefined : services.get(method.slice(0, dot));\n\t\tif (!local) {\n\t\t\tif (!options.forward) throw new Error(`No service provides ${method}`);\n\t\t\treturn options.forward(method, args);\n\t\t}\n\t\tconst handler = (local as Record<string, unknown>)[method.slice(dot + 1)];\n\t\tif (typeof handler !== \"function\") throw new Error(`Unknown method: ${method}`);\n\t\treturn (handler as (...args: unknown[]) => unknown).apply(local, [...args, signal]);\n\t};\n\n\tconnection.onMessage((frameValue) => {\n\t\tconst frame = frameValue as Frame;\n\t\tlastFrameAt = Date.now();\n\t\tswitch (frame.kind) {\n\t\t\tcase \"event\": {\n\t\t\t\tfor (const handler of eventHandlers) handler(frame.service, frame.payload, frame.to);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tcase \"call\": {\n\t\t\t\tconst controller = new AbortController();\n\t\t\t\tinflight.set(frame.id, controller);\n\t\t\t\tvoid dispatch(frame.method, frame.args, controller.signal)\n\t\t\t\t\t.then(\n\t\t\t\t\t\t// `undefined` vanishes through JSON, so an absent result is sent as null.\n\t\t\t\t\t\t(result) => connection.send({ kind: \"result\", id: frame.id, result: result ?? null }),\n\t\t\t\t\t\t(error: unknown) => connection.send({ kind: \"error\", id: frame.id, error: message(error) }),\n\t\t\t\t\t)\n\t\t\t\t\t.finally(() => inflight.delete(frame.id));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tcase \"cancel\": {\n\t\t\t\tinflight.get(frame.id)?.abort(new Error(\"Cancelled by caller\"));\n\t\t\t\tinflight.delete(frame.id);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tcase \"result\":\n\t\t\tcase \"error\": {\n\t\t\t\tconst waiter = pending.get(frame.id);\n\t\t\t\tpending.delete(frame.id);\n\t\t\t\tif (frame.kind === \"error\") waiter?.reject(new Error(frame.error));\n\t\t\t\telse waiter?.resolve(frame.result);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tcase \"announce\": {\n\t\t\t\tannounced.clear();\n\t\t\t\tfor (const service of frame.services) announced.add(service);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tcase \"ping\":\n\t\t\t\treturn;\n\t\t\tdefault: {\n\t\t\t\tconst unknownFrame: never = frame;\n\t\t\t\tthrow new Error(`Unknown frame: ${JSON.stringify(unknownFrame)}`);\n\t\t\t}\n\t\t}\n\t});\n\n\tconnection.onClose(() => {\n\t\tif (liveness) clearInterval(liveness);\n\t\tfor (const waiter of pending.values()) waiter.reject(new Error(\"Connection closed\"));\n\t\tpending.clear();\n\t\tfor (const controller of inflight.values()) controller.abort(new Error(\"Connection closed\"));\n\t\tinflight.clear();\n\t});\n\n\t/**\n\t * A peer can vanish without closing: a killed machine, a wedged event loop. Any frame counts as\n\t * proof of life, and pings keep an idle connection proving it.\n\t */\n\tconst deadMs = options.deadMs ?? DEFAULT_DEAD_MS;\n\tconst liveness =\n\t\tdeadMs > 0\n\t\t\t? setInterval(\n\t\t\t\t\t() => {\n\t\t\t\t\t\tif (Date.now() - lastFrameAt > deadMs) connection.close();\n\t\t\t\t\t\telse connection.send({ kind: \"ping\" });\n\t\t\t\t\t},\n\t\t\t\t\tMath.floor(deadMs / 3),\n\t\t\t\t)\n\t\t\t: undefined;\n\tliveness?.unref();\n\n\tconst callWith = (callOptions: CallOptions, method: string, ...args: unknown[]): Promise<unknown> =>\n\t\tnew Promise((resolve, reject) => {\n\t\t\tconst id = nextId++;\n\t\t\tlet timer: NodeJS.Timeout | undefined;\n\t\t\tconst abandon = (error: Error): void => {\n\t\t\t\tif (!pending.delete(id)) return;\n\t\t\t\tif (timer) clearTimeout(timer);\n\t\t\t\tcallOptions.signal?.removeEventListener(\"abort\", onAbort);\n\t\t\t\t// Tell the peer to stop; it may already be gone, in which case this is a no-op.\n\t\t\t\tconnection.send({ kind: \"cancel\", id });\n\t\t\t\treject(error);\n\t\t\t};\n\t\t\tconst onAbort = (): void => abandon(new Error(\"Call cancelled\"));\n\t\t\tconst settle =\n\t\t\t\t<T>(handler: (value: T) => void) =>\n\t\t\t\t(value: T) => {\n\t\t\t\t\tif (timer) clearTimeout(timer);\n\t\t\t\t\tcallOptions.signal?.removeEventListener(\"abort\", onAbort);\n\t\t\t\t\thandler(value);\n\t\t\t\t};\n\t\t\tif (callOptions.signal?.aborted) {\n\t\t\t\treject(new Error(\"Call cancelled\"));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tpending.set(id, { resolve: settle(resolve), reject: settle(reject) });\n\t\t\tcallOptions.signal?.addEventListener(\"abort\", onAbort, { once: true });\n\t\t\tif (callOptions.timeoutMs !== undefined) {\n\t\t\t\ttimer = setTimeout(\n\t\t\t\t\t() => abandon(new Error(`${method} timed out after ${callOptions.timeoutMs}ms`)),\n\t\t\t\t\tcallOptions.timeoutMs,\n\t\t\t\t);\n\t\t\t\ttimer.unref();\n\t\t\t}\n\t\t\tconnection.send({ kind: \"call\", id, method, args });\n\t\t});\n\n\tconst peer: RpcPeer = {\n\t\tprovide: (token, implementation) => {\n\t\t\tservices.set(token.name, implementation);\n\t\t\tprovided.add(token.name);\n\t\t\tconnection.send({ kind: \"announce\", services: [...provided] });\n\t\t},\n\t\tprovided,\n\t\tannounced,\n\t\tuse: (token, callOptions = {}) =>\n\t\t\tnew Proxy({} as Remote<typeof token extends ServiceToken<infer TApi, never> ? TApi : never>, {\n\t\t\t\tget:\n\t\t\t\t\t(_target, method) =>\n\t\t\t\t\t(...args: unknown[]) =>\n\t\t\t\t\t\tcallWith(callOptions, `${token.name}.${String(method)}`, ...args),\n\t\t\t}) as never,\n\t\temit: (token, event) => connection.send({ kind: \"event\", service: token.name, payload: event }),\n\t\temitTo: (token, event, to) => connection.send({ kind: \"event\", service: token.name, payload: event, to }),\n\t\temitRaw: (service, payload, to) =>\n\t\t\tconnection.send({ kind: \"event\", service, payload, ...(to === undefined ? {} : { to }) }),\n\t\ton: (token, handler) =>\n\t\t\teventHandlers.push((name, payload) => {\n\t\t\t\tif (name === token.name) handler(payload as never);\n\t\t\t}),\n\t\tonEvent: (handler) => eventHandlers.push(handler),\n\t\tcall: (method, ...args) => callWith({}, method, ...args),\n\t\tcallWith,\n\t\tonClose: (handler) => connection.onClose(handler),\n\t\tclose: () => connection.close(),\n\t};\n\treturn peer;\n}\n\nfunction message(error: unknown): string {\n\treturn error instanceof Error ? error.message : String(error);\n}\n"]}