@code-yeongyu/senpi 2026.7.4 → 2026.7.9-2

package/dist/modes/app-server/threads/turns.js

@@ -0,0 +1,240 @@
+import { EventProjector } from "./projection.js";
+import { buildTurn, buildUserMessage, createTurnId, invalidRequest, parseInput, readLoggedItems, toTurnEngineError, wireItemToJson, } from "./turn-runtime.js";
+export { TurnEngineError, } from "./turn-runtime.js";
+export function createTurnEngine(options) {
+    return new TurnEngine(options);
+}
+class TurnEngine {
+    constructor(options) {
+        this.pendingByThreadId = new Map();
+        this.subscribedThreadIds = new Set();
+        this.projectorByThreadId = new Map();
+        this.store = options.store;
+        this.turnLog = options.turnLog;
+        this.emitToThread = options.emitToThread;
+        this.broadcast = options.broadcast;
+    }
+    startTurn(params) {
+        this.getLoadedThreadOrThrow(params.threadId);
+        let didSettle = false;
+        const accepted = new Promise((resolve, reject) => {
+            const run = this.store.runThreadTask(params.threadId, async () => {
+                try {
+                    const parsedInput = parseInput(params.input);
+                    const entry = this.getLoadedThreadOrThrow(params.threadId);
+                    this.ensureSessionSubscription(params.threadId, entry);
+                    const turnId = createTurnId();
+                    const startedAtMs = Date.now();
+                    const startedAt = new Date(startedAtMs).toISOString();
+                    const turn = buildTurn(turnId, "inProgress", startedAtMs, null, []);
+                    const userMessage = buildUserMessage(params.clientUserMessageId ?? null, parsedInput.content);
+                    entry.activeTurn = { turnId, startedAt };
+                    entry.status = "active";
+                    entry.updatedAt = startedAt;
+                    this.turnLog.recordTurn(params.threadId, {
+                        turnId,
+                        startedAt,
+                        status: "running",
+                    });
+                    this.emitToThread(params.threadId, {
+                        method: "turn/started",
+                        params: { threadId: params.threadId, turn },
+                    });
+                    this.emitUserMessage(params.threadId, turnId, startedAtMs, userMessage);
+                    let pendingTurn;
+                    const completion = new Promise((complete) => {
+                        pendingTurn = {
+                            turnId,
+                            startedAt,
+                            startedAtMs,
+                            resolve: complete,
+                            interrupted: false,
+                            completed: false,
+                        };
+                        this.pendingByThreadId.set(params.threadId, pendingTurn);
+                    });
+                    void entry.session
+                        .prompt(parsedInput.text, {
+                        source: "rpc",
+                        preflightResult: (success) => {
+                            if (success) {
+                                if (!didSettle) {
+                                    didSettle = true;
+                                    resolve({ turn });
+                                }
+                                return;
+                            }
+                            if (!pendingTurn.completed) {
+                                this.completeTurn(params.threadId, "failed", "Prompt preflight failed");
+                            }
+                        },
+                    })
+                        .then(() => {
+                        if (!didSettle) {
+                            didSettle = true;
+                            reject(toTurnEngineError(new Error("Prompt preflight failed")));
+                        }
+                    })
+                        .catch((error) => {
+                        if (!didSettle) {
+                            didSettle = true;
+                            reject(toTurnEngineError(error));
+                        }
+                        this.completeTurn(params.threadId, "failed", error instanceof Error ? error.message : String(error));
+                    });
+                    await completion;
+                }
+                catch (error) {
+                    if (!didSettle) {
+                        didSettle = true;
+                        reject(toTurnEngineError(error instanceof Error ? error : new Error(String(error))));
+                    }
+                }
+            });
+            run.catch((error) => {
+                if (!didSettle) {
+                    didSettle = true;
+                    reject(toTurnEngineError(error));
+                }
+            });
+        });
+        return accepted;
+    }
+    async steerTurn(params) {
+        const entry = this.getLoadedThreadOrThrow(params.threadId);
+        const activeTurn = entry.activeTurn;
+        if (!activeTurn) {
+            throw invalidRequest(`No active turn for thread ${params.threadId}`);
+        }
+        if (activeTurn.turnId !== params.expectedTurnId) {
+            throw invalidRequest(`Turn id mismatch: expected ${params.expectedTurnId} but active turn is ${activeTurn.turnId}`);
+        }
+        const parsedInput = parseInput(params.input);
+        await entry.session.steer(parsedInput.text);
+        this.emitUserMessage(params.threadId, activeTurn.turnId, Date.now(), buildUserMessage(params.clientUserMessageId ?? null, parsedInput.content));
+        return { turnId: activeTurn.turnId };
+    }
+    async interruptTurn(params) {
+        const entry = this.getLoadedThreadOrThrow(params.threadId);
+        const activeTurn = entry.activeTurn;
+        if (!activeTurn) {
+            return {};
+        }
+        if (activeTurn.turnId !== params.turnId) {
+            throw invalidRequest(`Turn id mismatch: expected ${params.turnId} but active turn is ${activeTurn.turnId}`);
+        }
+        const pending = this.pendingByThreadId.get(params.threadId);
+        if (pending?.turnId === params.turnId) {
+            pending.interrupted = true;
+        }
+        await entry.session.abort();
+        if (entry.activeTurn?.turnId === params.turnId) {
+            this.completeTurn(params.threadId, "interrupted");
+        }
+        return {};
+    }
+    completeTurn(threadId, status = "completed", message) {
+        const entry = this.getLoadedThreadOrThrow(threadId);
+        const activeTurn = entry.activeTurn;
+        const pending = this.pendingByThreadId.get(threadId);
+        if (!activeTurn || !pending || pending.completed || pending.turnId !== activeTurn.turnId) {
+            return;
+        }
+        pending.completed = true;
+        // Close dangling projected items first so they land on the wire and in the
+        // turn log before turn/completed reads the logged items.
+        this.finalizeProjection(threadId);
+        const completedStatus = pending.interrupted && status === "completed" ? "interrupted" : status;
+        const completedAtMs = Date.now();
+        this.turnLog.completeTurn(threadId, pending.turnId, completedStatus);
+        const turn = buildTurn(pending.turnId, completedStatus, pending.startedAtMs, completedAtMs, readLoggedItems(this.turnLog, threadId, pending.turnId), message);
+        entry.activeTurn = null;
+        entry.status = "idle";
+        entry.updatedAt = new Date(completedAtMs).toISOString();
+        this.pendingByThreadId.delete(threadId);
+        this.emitToThread(threadId, { method: "turn/completed", params: { threadId, turn } });
+        this.broadcast({ method: "thread/status/changed", params: { threadId, status: { type: "idle" } } });
+        pending.resolve();
+    }
+    emitUserMessage(threadId, turnId, startedAtMs, userMessage) {
+        const wireUserMessage = wireItemToJson(userMessage);
+        this.emitToThread(threadId, {
+            method: "item/started",
+            params: { threadId, turnId, item: wireUserMessage, startedAtMs },
+        });
+        this.emitToThread(threadId, {
+            method: "item/completed",
+            params: { threadId, turnId, item: wireUserMessage, completedAtMs: startedAtMs },
+        });
+        this.turnLog.appendItem(threadId, turnId, userMessage);
+    }
+    ensureSessionSubscription(threadId, entry) {
+        if (this.subscribedThreadIds.has(threadId)) {
+            return;
+        }
+        this.subscribedThreadIds.add(threadId);
+        entry.session.subscribe((event) => {
+            this.projectSessionEvent(threadId, event);
+            if (event.type === "agent_end") {
+                this.completeTurn(threadId);
+            }
+        });
+    }
+    projectSessionEvent(threadId, event) {
+        let entry;
+        try {
+            entry = this.getLoadedThreadOrThrow(threadId);
+        }
+        catch {
+            return;
+        }
+        const activeTurn = entry.activeTurn;
+        if (!activeTurn) {
+            return;
+        }
+        let state = this.projectorByThreadId.get(threadId);
+        if (!state || state.turnId !== activeTurn.turnId) {
+            state = {
+                turnId: activeTurn.turnId,
+                projector: new EventProjector({
+                    threadId,
+                    turnId: activeTurn.turnId,
+                    turnLog: this.turnLog,
+                    cwd: entry.cwd,
+                }),
+            };
+            this.projectorByThreadId.set(threadId, state);
+        }
+        // The engine only ever sees real AgentSession events at runtime; the
+        // narrow TurnEngineSessionEvent supertype exists so unit tests can drive
+        // the engine with minimal fakes. Unknown event types project to nothing.
+        const result = state.projector.project(event);
+        this.emitProjected(threadId, result.notifications);
+        const completion = result.turnCompletion;
+        if (completion && completion.status !== "completed" && completion.status !== "running") {
+            this.completeTurn(threadId, completion.status, completion.errorMessage);
+        }
+    }
+    finalizeProjection(threadId) {
+        const state = this.projectorByThreadId.get(threadId);
+        if (!state) {
+            return;
+        }
+        this.projectorByThreadId.delete(threadId);
+        this.emitProjected(threadId, state.projector.finalize());
+    }
+    emitProjected(threadId, notifications) {
+        for (const notification of notifications) {
+            this.emitToThread(threadId, { method: notification.method, params: notification.params });
+        }
+    }
+    getLoadedThreadOrThrow(threadId) {
+        try {
+            return this.store.getLoadedThread(threadId);
+        }
+        catch {
+            throw invalidRequest(`Thread not found: ${threadId}`);
+        }
+    }
+}
+//# sourceMappingURL=turns.js.map

package/dist/modes/app-server/threads/turns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turns.js","sourceRoot":"","sources":["../../../../src/modes/app-server/threads/turns.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentSessionEvent } from \"../../../core/agent-session.ts\";\nimport type {\n\tJsonValue,\n\tThreadId,\n\tTurnInterruptParams,\n\tTurnInterruptResponse,\n\tTurnStartParams,\n\tTurnStartResponse,\n\tTurnSteerParams,\n\tTurnSteerResponse,\n} from \"../protocol/index.ts\";\nimport { EventProjector } from \"./projection.ts\";\nimport type { ProjectedNotification } from \"./projection-types.ts\";\nimport type { TurnLog, WireItem } from \"./turn-log.ts\";\nimport {\n\tbuildTurn,\n\tbuildUserMessage,\n\tcreateTurnId,\n\tinvalidRequest,\n\ttype LoggedStartStatus,\n\ttype PendingTurn,\n\tparseInput,\n\treadLoggedItems,\n\ttype TurnEngineApi,\n\ttype TurnEngineNotification,\n\ttype TurnEngineOptions,\n\ttype TurnEngineSessionEvent,\n\ttype TurnEngineStore,\n\ttype TurnEngineThreadEntry,\n\ttype TurnWireStatus,\n\ttoTurnEngineError,\n\twireItemToJson,\n} from \"./turn-runtime.ts\";\n\nexport {\n\ttype TurnEngineApi,\n\tTurnEngineError,\n\ttype TurnEngineNotification,\n\ttype TurnEngineOptions,\n\ttype TurnEngineSession,\n\ttype TurnEngineSessionEvent,\n\ttype TurnEngineStore,\n\ttype TurnEngineThreadEntry,\n\ttype TurnEngineThreadStatus,\n} from \"./turn-runtime.ts\";\n\nexport function createTurnEngine<Entry extends TurnEngineThreadEntry = TurnEngineThreadEntry>(\n\toptions: TurnEngineOptions<Entry>,\n): TurnEngineApi {\n\treturn new TurnEngine(options);\n}\n\nclass TurnEngine<Entry extends TurnEngineThreadEntry> {\n\tprivate readonly store: TurnEngineStore<Entry>;\n\tprivate readonly turnLog: TurnLog;\n\tprivate readonly emitToThread: (threadId: string, notification: TurnEngineNotification) => void;\n\tprivate readonly broadcast: (notification: TurnEngineNotification) => void;\n\tprivate readonly pendingByThreadId = new Map<ThreadId, PendingTurn>();\n\tprivate readonly subscribedThreadIds = new Set<ThreadId>();\n\tprivate readonly projectorByThreadId = new Map<\n\t\tThreadId,\n\t\t{ readonly turnId: string; readonly projector: EventProjector }\n\t>();\n\n\tconstructor(options: TurnEngineOptions<Entry>) {\n\t\tthis.store = options.store;\n\t\tthis.turnLog = options.turnLog;\n\t\tthis.emitToThread = options.emitToThread;\n\t\tthis.broadcast = options.broadcast;\n\t}\n\n\tstartTurn(params: TurnStartParams): Promise<TurnStartResponse> {\n\t\tthis.getLoadedThreadOrThrow(params.threadId);\n\n\t\tlet didSettle = false;\n\t\tconst accepted = new Promise<TurnStartResponse>((resolve, reject) => {\n\t\t\tconst run = this.store.runThreadTask(params.threadId, async () => {\n\t\t\t\ttry {\n\t\t\t\t\tconst parsedInput = parseInput(params.input);\n\t\t\t\t\tconst entry = this.getLoadedThreadOrThrow(params.threadId);\n\t\t\t\t\tthis.ensureSessionSubscription(params.threadId, entry);\n\t\t\t\t\tconst turnId = createTurnId();\n\t\t\t\t\tconst startedAtMs = Date.now();\n\t\t\t\t\tconst startedAt = new Date(startedAtMs).toISOString();\n\t\t\t\t\tconst turn = buildTurn(turnId, \"inProgress\", startedAtMs, null, []);\n\t\t\t\t\tconst userMessage = buildUserMessage(params.clientUserMessageId ?? null, parsedInput.content);\n\n\t\t\t\t\tentry.activeTurn = { turnId, startedAt };\n\t\t\t\t\tentry.status = \"active\";\n\t\t\t\t\tentry.updatedAt = startedAt;\n\t\t\t\t\tthis.turnLog.recordTurn(params.threadId, {\n\t\t\t\t\t\tturnId,\n\t\t\t\t\t\tstartedAt,\n\t\t\t\t\t\tstatus: \"running\" satisfies LoggedStartStatus,\n\t\t\t\t\t});\n\t\t\t\t\tthis.emitToThread(params.threadId, {\n\t\t\t\t\t\tmethod: \"turn/started\",\n\t\t\t\t\t\tparams: { threadId: params.threadId, turn },\n\t\t\t\t\t});\n\t\t\t\t\tthis.emitUserMessage(params.threadId, turnId, startedAtMs, userMessage);\n\n\t\t\t\t\tlet pendingTurn: PendingTurn;\n\t\t\t\t\tconst completion = new Promise<void>((complete) => {\n\t\t\t\t\t\tpendingTurn = {\n\t\t\t\t\t\t\tturnId,\n\t\t\t\t\t\t\tstartedAt,\n\t\t\t\t\t\t\tstartedAtMs,\n\t\t\t\t\t\t\tresolve: complete,\n\t\t\t\t\t\t\tinterrupted: false,\n\t\t\t\t\t\t\tcompleted: false,\n\t\t\t\t\t\t};\n\t\t\t\t\t\tthis.pendingByThreadId.set(params.threadId, pendingTurn);\n\t\t\t\t\t});\n\n\t\t\t\t\tvoid entry.session\n\t\t\t\t\t\t.prompt(parsedInput.text, {\n\t\t\t\t\t\t\tsource: \"rpc\",\n\t\t\t\t\t\t\tpreflightResult: (success) => {\n\t\t\t\t\t\t\t\tif (success) {\n\t\t\t\t\t\t\t\t\tif (!didSettle) {\n\t\t\t\t\t\t\t\t\t\tdidSettle = true;\n\t\t\t\t\t\t\t\t\t\tresolve({ turn });\n\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\tif (!pendingTurn.completed) {\n\t\t\t\t\t\t\t\t\tthis.completeTurn(params.threadId, \"failed\", \"Prompt preflight failed\");\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t})\n\t\t\t\t\t\t.then(() => {\n\t\t\t\t\t\t\tif (!didSettle) {\n\t\t\t\t\t\t\t\tdidSettle = true;\n\t\t\t\t\t\t\t\treject(toTurnEngineError(new Error(\"Prompt preflight failed\")));\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t})\n\t\t\t\t\t\t.catch((error: unknown) => {\n\t\t\t\t\t\t\tif (!didSettle) {\n\t\t\t\t\t\t\t\tdidSettle = true;\n\t\t\t\t\t\t\t\treject(toTurnEngineError(error));\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tthis.completeTurn(\n\t\t\t\t\t\t\t\tparams.threadId,\n\t\t\t\t\t\t\t\t\"failed\",\n\t\t\t\t\t\t\t\terror instanceof Error ? error.message : String(error),\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t});\n\t\t\t\t\tawait completion;\n\t\t\t\t} catch (error) {\n\t\t\t\t\tif (!didSettle) {\n\t\t\t\t\t\tdidSettle = true;\n\t\t\t\t\t\treject(toTurnEngineError(error instanceof Error ? error : new Error(String(error))));\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t});\n\t\t\trun.catch((error: unknown) => {\n\t\t\t\tif (!didSettle) {\n\t\t\t\t\tdidSettle = true;\n\t\t\t\t\treject(toTurnEngineError(error));\n\t\t\t\t}\n\t\t\t});\n\t\t});\n\n\t\treturn accepted;\n\t}\n\n\tasync steerTurn(params: TurnSteerParams): Promise<TurnSteerResponse> {\n\t\tconst entry = this.getLoadedThreadOrThrow(params.threadId);\n\t\tconst activeTurn = entry.activeTurn;\n\t\tif (!activeTurn) {\n\t\t\tthrow invalidRequest(`No active turn for thread ${params.threadId}`);\n\t\t}\n\t\tif (activeTurn.turnId !== params.expectedTurnId) {\n\t\t\tthrow invalidRequest(\n\t\t\t\t`Turn id mismatch: expected ${params.expectedTurnId} but active turn is ${activeTurn.turnId}`,\n\t\t\t);\n\t\t}\n\t\tconst parsedInput = parseInput(params.input);\n\t\tawait entry.session.steer(parsedInput.text);\n\t\tthis.emitUserMessage(\n\t\t\tparams.threadId,\n\t\t\tactiveTurn.turnId,\n\t\t\tDate.now(),\n\t\t\tbuildUserMessage(params.clientUserMessageId ?? null, parsedInput.content),\n\t\t);\n\t\treturn { turnId: activeTurn.turnId };\n\t}\n\n\tasync interruptTurn(params: TurnInterruptParams): Promise<TurnInterruptResponse> {\n\t\tconst entry = this.getLoadedThreadOrThrow(params.threadId);\n\t\tconst activeTurn = entry.activeTurn;\n\t\tif (!activeTurn) {\n\t\t\treturn {};\n\t\t}\n\t\tif (activeTurn.turnId !== params.turnId) {\n\t\t\tthrow invalidRequest(`Turn id mismatch: expected ${params.turnId} but active turn is ${activeTurn.turnId}`);\n\t\t}\n\t\tconst pending = this.pendingByThreadId.get(params.threadId);\n\t\tif (pending?.turnId === params.turnId) {\n\t\t\tpending.interrupted = true;\n\t\t}\n\t\tawait entry.session.abort();\n\t\tif (entry.activeTurn?.turnId === params.turnId) {\n\t\t\tthis.completeTurn(params.threadId, \"interrupted\");\n\t\t}\n\t\treturn {};\n\t}\n\n\tcompleteTurn(\n\t\tthreadId: ThreadId,\n\t\tstatus: Exclude<TurnWireStatus, \"inProgress\"> = \"completed\",\n\t\tmessage?: string,\n\t): void {\n\t\tconst entry = this.getLoadedThreadOrThrow(threadId);\n\t\tconst activeTurn = entry.activeTurn;\n\t\tconst pending = this.pendingByThreadId.get(threadId);\n\t\tif (!activeTurn || !pending || pending.completed || pending.turnId !== activeTurn.turnId) {\n\t\t\treturn;\n\t\t}\n\n\t\tpending.completed = true;\n\t\t// Close dangling projected items first so they land on the wire and in the\n\t\t// turn log before turn/completed reads the logged items.\n\t\tthis.finalizeProjection(threadId);\n\t\tconst completedStatus = pending.interrupted && status === \"completed\" ? \"interrupted\" : status;\n\t\tconst completedAtMs = Date.now();\n\t\tthis.turnLog.completeTurn(threadId, pending.turnId, completedStatus);\n\t\tconst turn = buildTurn(\n\t\t\tpending.turnId,\n\t\t\tcompletedStatus,\n\t\t\tpending.startedAtMs,\n\t\t\tcompletedAtMs,\n\t\t\treadLoggedItems(this.turnLog, threadId, pending.turnId),\n\t\t\tmessage,\n\t\t);\n\n\t\tentry.activeTurn = null;\n\t\tentry.status = \"idle\";\n\t\tentry.updatedAt = new Date(completedAtMs).toISOString();\n\t\tthis.pendingByThreadId.delete(threadId);\n\t\tthis.emitToThread(threadId, { method: \"turn/completed\", params: { threadId, turn } });\n\t\tthis.broadcast({ method: \"thread/status/changed\", params: { threadId, status: { type: \"idle\" } } });\n\t\tpending.resolve();\n\t}\n\n\tprivate emitUserMessage(threadId: ThreadId, turnId: string, startedAtMs: number, userMessage: WireItem): void {\n\t\tconst wireUserMessage = wireItemToJson(userMessage);\n\t\tthis.emitToThread(threadId, {\n\t\t\tmethod: \"item/started\",\n\t\t\tparams: { threadId, turnId, item: wireUserMessage, startedAtMs },\n\t\t});\n\t\tthis.emitToThread(threadId, {\n\t\t\tmethod: \"item/completed\",\n\t\t\tparams: { threadId, turnId, item: wireUserMessage, completedAtMs: startedAtMs },\n\t\t});\n\t\tthis.turnLog.appendItem(threadId, turnId, userMessage);\n\t}\n\n\tprivate ensureSessionSubscription(threadId: ThreadId, entry: Entry): void {\n\t\tif (this.subscribedThreadIds.has(threadId)) {\n\t\t\treturn;\n\t\t}\n\t\tthis.subscribedThreadIds.add(threadId);\n\t\tentry.session.subscribe((event) => {\n\t\t\tthis.projectSessionEvent(threadId, event);\n\t\t\tif (event.type === \"agent_end\") {\n\t\t\t\tthis.completeTurn(threadId);\n\t\t\t}\n\t\t});\n\t}\n\n\tprivate projectSessionEvent(threadId: ThreadId, event: TurnEngineSessionEvent): void {\n\t\tlet entry: Entry;\n\t\ttry {\n\t\t\tentry = this.getLoadedThreadOrThrow(threadId);\n\t\t} catch {\n\t\t\treturn;\n\t\t}\n\t\tconst activeTurn = entry.activeTurn;\n\t\tif (!activeTurn) {\n\t\t\treturn;\n\t\t}\n\t\tlet state = this.projectorByThreadId.get(threadId);\n\t\tif (!state || state.turnId !== activeTurn.turnId) {\n\t\t\tstate = {\n\t\t\t\tturnId: activeTurn.turnId,\n\t\t\t\tprojector: new EventProjector({\n\t\t\t\t\tthreadId,\n\t\t\t\t\tturnId: activeTurn.turnId,\n\t\t\t\t\tturnLog: this.turnLog,\n\t\t\t\t\tcwd: entry.cwd,\n\t\t\t\t}),\n\t\t\t};\n\t\t\tthis.projectorByThreadId.set(threadId, state);\n\t\t}\n\t\t// The engine only ever sees real AgentSession events at runtime; the\n\t\t// narrow TurnEngineSessionEvent supertype exists so unit tests can drive\n\t\t// the engine with minimal fakes. Unknown event types project to nothing.\n\t\tconst result = state.projector.project(event as AgentSessionEvent);\n\t\tthis.emitProjected(threadId, result.notifications);\n\t\tconst completion = result.turnCompletion;\n\t\tif (completion && completion.status !== \"completed\" && completion.status !== \"running\") {\n\t\t\tthis.completeTurn(threadId, completion.status, completion.errorMessage);\n\t\t}\n\t}\n\n\tprivate finalizeProjection(threadId: ThreadId): void {\n\t\tconst state = this.projectorByThreadId.get(threadId);\n\t\tif (!state) {\n\t\t\treturn;\n\t\t}\n\t\tthis.projectorByThreadId.delete(threadId);\n\t\tthis.emitProjected(threadId, state.projector.finalize());\n\t}\n\n\tprivate emitProjected(threadId: ThreadId, notifications: readonly ProjectedNotification[]): void {\n\t\tfor (const notification of notifications) {\n\t\t\tthis.emitToThread(threadId, { method: notification.method, params: notification.params as JsonValue });\n\t\t}\n\t}\n\n\tprivate getLoadedThreadOrThrow(threadId: ThreadId): Entry {\n\t\ttry {\n\t\t\treturn this.store.getLoadedThread(threadId);\n\t\t} catch {\n\t\t\tthrow invalidRequest(`Thread not found: ${threadId}`);\n\t\t}\n\t}\n}\n"]}

package/dist/modes/app-server/threads/wire-thread.d.ts

@@ -0,0 +1,9 @@
+import type { Thread, ThreadStatus } from "../protocol/generated/v2/index.ts";
+import type { ThreadEntry, WireThread } from "./registry.ts";
+import type { TurnLog } from "./turn-log.ts";
+export declare const NOT_LOADED_STATUS: ThreadStatus;
+export interface BuildWireThreadOptions {
+    readonly forkedFromId?: string | null;
+}
+export declare function buildWireThread(entry: ThreadEntry | WireThread, turnLog: TurnLog, includeTurns: boolean, options?: BuildWireThreadOptions): Thread;
+//# sourceMappingURL=wire-thread.d.ts.map

package/dist/modes/app-server/threads/wire-thread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire-thread.d.ts","sourceRoot":"","sources":["../../../../src/modes/app-server/threads/wire-thread.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAc,YAAY,EAAQ,MAAM,mCAAmC,CAAC;AAChG,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,KAAK,EAAc,OAAO,EAAY,MAAM,eAAe,CAAC;AAInE,eAAO,MAAM,iBAAiB,EAAE,YAAoC,CAAC;AAErE,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED,wBAAgB,eAAe,CAC9B,KAAK,EAAE,WAAW,GAAG,UAAU,EAC/B,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,OAAO,EACrB,OAAO,GAAE,sBAA2B,GAClC,MAAM,CA4BR"}

package/dist/modes/app-server/threads/wire-thread.js

@@ -0,0 +1,108 @@
+import { VERSION } from "../../../config.js";
+const ACTIVE_STATUS = { type: "active", activeFlags: [] };
+const IDLE_STATUS = { type: "idle" };
+export const NOT_LOADED_STATUS = { type: "notLoaded" };
+export function buildWireThread(entry, turnLog, includeTurns, options = {}) {
+    const model = "session" in entry ? entry.session.model : undefined;
+    const wire = "session" in entry ? entryToWire(entry) : entry;
+    const createdAt = isoSeconds(wire.createdAt);
+    const updatedAt = isoSeconds(wire.updatedAt);
+    return {
+        id: wire.id,
+        sessionId: wire.sessionId,
+        forkedFromId: options.forkedFromId ?? null,
+        parentThreadId: null,
+        preview: wire.preview ?? "",
+        ephemeral: false,
+        modelProvider: model?.provider ?? "unknown",
+        createdAt,
+        updatedAt,
+        recencyAt: updatedAt,
+        status: toGeneratedStatus(wire.status.type),
+        path: "session" in entry ? (entry.session.sessionFile ?? null) : wire.sessionPath,
+        cwd: wire.cwd,
+        cliVersion: VERSION,
+        source: "appServer",
+        threadSource: null,
+        agentNickname: null,
+        agentRole: null,
+        gitInfo: null,
+        name: wire.name,
+        turns: includeTurns ? threadTurns(entry, turnLog) : [],
+    };
+}
+function entryToWire(entry) {
+    return {
+        id: entry.id,
+        sessionId: entry.session.sessionId,
+        sessionPath: entry.session.sessionFile ?? null,
+        cwd: entry.cwd,
+        createdAt: entry.createdAt,
+        updatedAt: entry.updatedAt,
+        status: { type: entry.status },
+        preview: entry.session.getUserMessagesForForking()[0]?.text ?? null,
+        name: entry.session.sessionName ?? null,
+    };
+}
+function loggedTurnToWireTurn(turn) {
+    return {
+        id: turn.turnId,
+        items: turn.items.map(wireItemToThreadItem),
+        itemsView: "full",
+        status: turn.status === "running" ? "inProgress" : turn.status,
+        error: null,
+        startedAt: isoSeconds(turn.startedAt),
+        completedAt: null,
+        durationMs: null,
+    };
+}
+function threadTurns(entry, turnLog) {
+    const loggedTurns = turnLog.readTurns(entry.id);
+    if (loggedTurns.length > 0 || !("session" in entry)) {
+        return loggedTurns.map(loggedTurnToWireTurn);
+    }
+    return entry.session.getUserMessagesForForking().map((message, index) => loggedTurnToWireTurn({
+        turnId: `turn-${index + 1}`,
+        startedAt: entry.createdAt,
+        status: "completed",
+        items: [{ id: message.entryId, type: "userMessage", content: [] }],
+    }));
+}
+function wireItemToThreadItem(item) {
+    const type = item.type;
+    const id = typeof item.id === "string" && item.id.length > 0 ? item.id : "item";
+    if (type === "userMessage") {
+        return {
+            type: "userMessage",
+            id,
+            clientId: typeof item.clientId === "string" ? item.clientId : null,
+            content: [],
+        };
+    }
+    if (type === "reasoning") {
+        return { type: "reasoning", id, summary: [], content: [stringField(item, "text")] };
+    }
+    if (type === "plan") {
+        return { type: "plan", id, text: stringField(item, "text") };
+    }
+    return { type: "agentMessage", id, text: stringField(item, "text"), phase: null, memoryCitation: null };
+}
+function stringField(item, key) {
+    const value = item[key];
+    return typeof value === "string" ? value : "";
+}
+function toGeneratedStatus(status) {
+    switch (status) {
+        case "active":
+            return ACTIVE_STATUS;
+        case "idle":
+            return IDLE_STATUS;
+        case "notLoaded":
+            return NOT_LOADED_STATUS;
+    }
+}
+function isoSeconds(value) {
+    const parsed = Date.parse(value);
+    return Number.isFinite(parsed) ? parsed / 1000 : 0;
+}
+//# sourceMappingURL=wire-thread.js.map

package/dist/modes/app-server/threads/wire-thread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire-thread.js","sourceRoot":"","sources":["../../../../src/modes/app-server/threads/wire-thread.ts"],"names":[],"mappings":"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","sourcesContent":["import { VERSION } from \"../../../config.ts\";\nimport type { Thread, ThreadItem, ThreadStatus, Turn } from \"../protocol/generated/v2/index.ts\";\nimport type { ThreadEntry, WireThread } from \"./registry.ts\";\nimport type { LoggedTurn, TurnLog, WireItem } from \"./turn-log.ts\";\n\nconst ACTIVE_STATUS: ThreadStatus = { type: \"active\", activeFlags: [] };\nconst IDLE_STATUS: ThreadStatus = { type: \"idle\" };\nexport const NOT_LOADED_STATUS: ThreadStatus = { type: \"notLoaded\" };\n\nexport interface BuildWireThreadOptions {\n\treadonly forkedFromId?: string | null;\n}\n\nexport function buildWireThread(\n\tentry: ThreadEntry | WireThread,\n\tturnLog: TurnLog,\n\tincludeTurns: boolean,\n\toptions: BuildWireThreadOptions = {},\n): Thread {\n\tconst model = \"session\" in entry ? entry.session.model : undefined;\n\tconst wire = \"session\" in entry ? entryToWire(entry) : entry;\n\tconst createdAt = isoSeconds(wire.createdAt);\n\tconst updatedAt = isoSeconds(wire.updatedAt);\n\treturn {\n\t\tid: wire.id,\n\t\tsessionId: wire.sessionId,\n\t\tforkedFromId: options.forkedFromId ?? null,\n\t\tparentThreadId: null,\n\t\tpreview: wire.preview ?? \"\",\n\t\tephemeral: false,\n\t\tmodelProvider: model?.provider ?? \"unknown\",\n\t\tcreatedAt,\n\t\tupdatedAt,\n\t\trecencyAt: updatedAt,\n\t\tstatus: toGeneratedStatus(wire.status.type),\n\t\tpath: \"session\" in entry ? (entry.session.sessionFile ?? null) : wire.sessionPath,\n\t\tcwd: wire.cwd,\n\t\tcliVersion: VERSION,\n\t\tsource: \"appServer\",\n\t\tthreadSource: null,\n\t\tagentNickname: null,\n\t\tagentRole: null,\n\t\tgitInfo: null,\n\t\tname: wire.name,\n\t\tturns: includeTurns ? threadTurns(entry, turnLog) : [],\n\t};\n}\n\nfunction entryToWire(entry: ThreadEntry): WireThread {\n\treturn {\n\t\tid: entry.id,\n\t\tsessionId: entry.session.sessionId,\n\t\tsessionPath: entry.session.sessionFile ?? null,\n\t\tcwd: entry.cwd,\n\t\tcreatedAt: entry.createdAt,\n\t\tupdatedAt: entry.updatedAt,\n\t\tstatus: { type: entry.status },\n\t\tpreview: entry.session.getUserMessagesForForking()[0]?.text ?? null,\n\t\tname: entry.session.sessionName ?? null,\n\t};\n}\n\nfunction loggedTurnToWireTurn(turn: LoggedTurn): Turn {\n\treturn {\n\t\tid: turn.turnId,\n\t\titems: turn.items.map(wireItemToThreadItem),\n\t\titemsView: \"full\",\n\t\tstatus: turn.status === \"running\" ? \"inProgress\" : turn.status,\n\t\terror: null,\n\t\tstartedAt: isoSeconds(turn.startedAt),\n\t\tcompletedAt: null,\n\t\tdurationMs: null,\n\t};\n}\n\nfunction threadTurns(entry: ThreadEntry | WireThread, turnLog: TurnLog): Turn[] {\n\tconst loggedTurns = turnLog.readTurns(entry.id);\n\tif (loggedTurns.length > 0 || !(\"session\" in entry)) {\n\t\treturn loggedTurns.map(loggedTurnToWireTurn);\n\t}\n\treturn entry.session.getUserMessagesForForking().map((message, index) =>\n\t\tloggedTurnToWireTurn({\n\t\t\tturnId: `turn-${index + 1}`,\n\t\t\tstartedAt: entry.createdAt,\n\t\t\tstatus: \"completed\",\n\t\t\titems: [{ id: message.entryId, type: \"userMessage\", content: [] }],\n\t\t}),\n\t);\n}\n\nfunction wireItemToThreadItem(item: WireItem): ThreadItem {\n\tconst type = item.type;\n\tconst id = typeof item.id === \"string\" && item.id.length > 0 ? item.id : \"item\";\n\tif (type === \"userMessage\") {\n\t\treturn {\n\t\t\ttype: \"userMessage\",\n\t\t\tid,\n\t\t\tclientId: typeof item.clientId === \"string\" ? item.clientId : null,\n\t\t\tcontent: [],\n\t\t};\n\t}\n\tif (type === \"reasoning\") {\n\t\treturn { type: \"reasoning\", id, summary: [], content: [stringField(item, \"text\")] };\n\t}\n\tif (type === \"plan\") {\n\t\treturn { type: \"plan\", id, text: stringField(item, \"text\") };\n\t}\n\treturn { type: \"agentMessage\", id, text: stringField(item, \"text\"), phase: null, memoryCitation: null };\n}\n\nfunction stringField(item: WireItem, key: string): string {\n\tconst value = item[key];\n\treturn typeof value === \"string\" ? value : \"\";\n}\n\nfunction toGeneratedStatus(status: WireThread[\"status\"][\"type\"]): ThreadStatus {\n\tswitch (status) {\n\t\tcase \"active\":\n\t\t\treturn ACTIVE_STATUS;\n\t\tcase \"idle\":\n\t\t\treturn IDLE_STATUS;\n\t\tcase \"notLoaded\":\n\t\t\treturn NOT_LOADED_STATUS;\n\t}\n}\n\nfunction isoSeconds(value: string): number {\n\tconst parsed = Date.parse(value);\n\treturn Number.isFinite(parsed) ? parsed / 1000 : 0;\n}\n"]}

package/dist/modes/app-server/transports/stdio.d.ts

@@ -0,0 +1,21 @@
+import type { Readable } from "node:stream";
+import type { ClassifiedIncoming } from "../rpc/envelope.ts";
+import type { Connection, ConnectionId, ConnectionInput } from "../server/connection.ts";
+export interface StdioServerCore {
+    addConnection(input: ConnectionInput): Connection;
+    removeConnection(id: ConnectionId): void;
+    receive(connectionId: ConnectionId, envelope: ClassifiedIncoming): Promise<void>;
+}
+export interface StdioTransportOptions {
+    readonly core: StdioServerCore;
+    readonly stdin?: Readable;
+    readonly connectionId?: ConnectionId;
+    readonly onShutdown?: (reason: string) => Promise<void> | void;
+}
+export interface StdioTransport {
+    readonly connectionId: ConnectionId;
+    drain(): Promise<void>;
+    close(reason: string): Promise<void>;
+}
+export declare function startStdioTransport(options: StdioTransportOptions): StdioTransport;
+//# sourceMappingURL=stdio.d.ts.map

package/dist/modes/app-server/transports/stdio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../../../src/modes/app-server/transports/stdio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,KAAK,EAAE,kBAAkB,EAAe,MAAM,oBAAoB,CAAC;AAE1E,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAEzF,MAAM,WAAW,eAAe;IAC/B,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU,CAAC;IAClD,gBAAgB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAAC;IACzC,OAAO,CAAC,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjF;AAED,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC/D;AAED,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAMD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CASlF"}

package/dist/modes/app-server/transports/stdio.js

@@ -0,0 +1,105 @@
+import { takeOverStdout, waitForRawStdoutBackpressure, writeRawStdout } from "../../../core/output-guard.js";
+import { attachNdjsonRpcReader, serializeNdjsonMessage } from "../rpc/ndjson.js";
+const DEFAULT_CONNECTION_ID = "stdio";
+let activeTransport;
+export function startStdioTransport(options) {
+    if (activeTransport) {
+        throw new Error("stdio transport already active");
+    }
+    takeOverStdout();
+    const transport = new StdioTransportImpl(options);
+    activeTransport = transport;
+    return transport;
+}
+class StdioTransportImpl {
+    constructor(options) {
+        this.inputTail = Promise.resolve();
+        this.closed = false;
+        this.shutdownRequested = false;
+        this.handleStdinEnd = () => {
+            this.requestShutdown("stdin ended");
+        };
+        this.handleStdinClose = () => {
+            this.requestShutdown("stdin closed");
+        };
+        this.core = options.core;
+        this.stdin = options.stdin ?? process.stdin;
+        this.connectionId = options.connectionId ?? DEFAULT_CONNECTION_ID;
+        this.onShutdown = options.onShutdown;
+        this.connection = this.core.addConnection({
+            id: this.connectionId,
+            transportKind: "stdio",
+            send: (message) => this.writeMessage(message),
+            close: (reason) => this.close(reason),
+        });
+        this.detachReader = attachNdjsonRpcReader(this.stdin, (message) => {
+            this.enqueue(() => this.handleMessage(message));
+        });
+        this.stdin.on("end", this.handleStdinEnd);
+        this.stdin.on("close", this.handleStdinClose);
+    }
+    async drain() {
+        await this.inputTail;
+    }
+    async close(reason) {
+        this.closeCore(reason);
+        await this.inputTail;
+    }
+    enqueue(task) {
+        const next = this.inputTail.then(task, task);
+        this.inputTail = next.catch((error) => {
+            this.reportError(error);
+        });
+    }
+    requestShutdown(reason) {
+        if (this.shutdownRequested) {
+            return;
+        }
+        this.shutdownRequested = true;
+        this.enqueue(async () => {
+            this.closeCore(reason);
+            await this.onShutdown?.(reason);
+        });
+    }
+    async handleMessage(message) {
+        switch (message.kind) {
+            case "parse-error":
+                await this.connection.send(message.message);
+                return;
+            case "request":
+            case "notification":
+            case "response":
+            case "protocol-invalid":
+                await this.core.receive(this.connectionId, message);
+                return;
+            default:
+                return assertNever(message);
+        }
+    }
+    async writeMessage(message) {
+        writeRawStdout(serializeNdjsonMessage(message));
+        await waitForRawStdoutBackpressure();
+    }
+    closeCore(reason) {
+        if (this.closed) {
+            return;
+        }
+        this.closed = true;
+        this.detachReader();
+        this.stdin.off("end", this.handleStdinEnd);
+        this.stdin.off("close", this.handleStdinClose);
+        this.core.removeConnection(this.connectionId);
+        if (activeTransport === this) {
+            activeTransport = undefined;
+        }
+        process.stderr.write(`app-server stdio closed: ${reason}\n`);
+    }
+    reportError(error) {
+        const message = error instanceof Error ? (error.stack ?? error.message) : String(error);
+        process.stderr.write(`app-server stdio error: ${message}\n`);
+    }
+}
+function assertNever(value) {
+    throw new Error(`Unhandled stdio RPC emission: ${JSON.stringify(value)}`);
+}
+//# sourceMappingURL=stdio.js.map

package/dist/modes/app-server/transports/stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../../../../src/modes/app-server/transports/stdio.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Readable } from \"node:stream\";\nimport { takeOverStdout, waitForRawStdoutBackpressure, writeRawStdout } from \"../../../core/output-guard.ts\";\nimport type { ClassifiedIncoming, RpcEnvelope } from \"../rpc/envelope.ts\";\nimport { attachNdjsonRpcReader, type NdjsonRpcEmission, serializeNdjsonMessage } from \"../rpc/ndjson.ts\";\nimport type { Connection, ConnectionId, ConnectionInput } from \"../server/connection.ts\";\n\nexport interface StdioServerCore {\n\taddConnection(input: ConnectionInput): Connection;\n\tremoveConnection(id: ConnectionId): void;\n\treceive(connectionId: ConnectionId, envelope: ClassifiedIncoming): Promise<void>;\n}\n\nexport interface StdioTransportOptions {\n\treadonly core: StdioServerCore;\n\treadonly stdin?: Readable;\n\treadonly connectionId?: ConnectionId;\n\treadonly onShutdown?: (reason: string) => Promise<void> | void;\n}\n\nexport interface StdioTransport {\n\treadonly connectionId: ConnectionId;\n\tdrain(): Promise<void>;\n\tclose(reason: string): Promise<void>;\n}\n\nconst DEFAULT_CONNECTION_ID = \"stdio\";\n\nlet activeTransport: StdioTransportImpl | undefined;\n\nexport function startStdioTransport(options: StdioTransportOptions): StdioTransport {\n\tif (activeTransport) {\n\t\tthrow new Error(\"stdio transport already active\");\n\t}\n\n\ttakeOverStdout();\n\tconst transport = new StdioTransportImpl(options);\n\tactiveTransport = transport;\n\treturn transport;\n}\n\nclass StdioTransportImpl implements StdioTransport {\n\treadonly connectionId: ConnectionId;\n\tprivate readonly core: StdioServerCore;\n\tprivate readonly stdin: Readable;\n\tprivate readonly onShutdown: ((reason: string) => Promise<void> | void) | undefined;\n\tprivate readonly connection: Connection;\n\tprivate readonly detachReader: () => void;\n\tprivate inputTail: Promise<void> = Promise.resolve();\n\tprivate closed = false;\n\tprivate shutdownRequested = false;\n\n\tprivate readonly handleStdinEnd = (): void => {\n\t\tthis.requestShutdown(\"stdin ended\");\n\t};\n\n\tprivate readonly handleStdinClose = (): void => {\n\t\tthis.requestShutdown(\"stdin closed\");\n\t};\n\n\tconstructor(options: StdioTransportOptions) {\n\t\tthis.core = options.core;\n\t\tthis.stdin = options.stdin ?? process.stdin;\n\t\tthis.connectionId = options.connectionId ?? DEFAULT_CONNECTION_ID;\n\t\tthis.onShutdown = options.onShutdown;\n\t\tthis.connection = this.core.addConnection({\n\t\t\tid: this.connectionId,\n\t\t\ttransportKind: \"stdio\",\n\t\t\tsend: (message) => this.writeMessage(message),\n\t\t\tclose: (reason) => this.close(reason),\n\t\t});\n\t\tthis.detachReader = attachNdjsonRpcReader(this.stdin, (message) => {\n\t\t\tthis.enqueue(() => this.handleMessage(message));\n\t\t});\n\t\tthis.stdin.on(\"end\", this.handleStdinEnd);\n\t\tthis.stdin.on(\"close\", this.handleStdinClose);\n\t}\n\n\tasync drain(): Promise<void> {\n\t\tawait this.inputTail;\n\t}\n\n\tasync close(reason: string): Promise<void> {\n\t\tthis.closeCore(reason);\n\t\tawait this.inputTail;\n\t}\n\n\tprivate enqueue(task: () => Promise<void>): void {\n\t\tconst next = this.inputTail.then(task, task);\n\t\tthis.inputTail = next.catch((error: unknown) => {\n\t\t\tthis.reportError(error);\n\t\t});\n\t}\n\n\tprivate requestShutdown(reason: string): void {\n\t\tif (this.shutdownRequested) {\n\t\t\treturn;\n\t\t}\n\t\tthis.shutdownRequested = true;\n\t\tthis.enqueue(async () => {\n\t\t\tthis.closeCore(reason);\n\t\t\tawait this.onShutdown?.(reason);\n\t\t});\n\t}\n\n\tprivate async handleMessage(message: NdjsonRpcEmission): Promise<void> {\n\t\tswitch (message.kind) {\n\t\t\tcase \"parse-error\":\n\t\t\t\tawait this.connection.send(message.message);\n\t\t\t\treturn;\n\t\t\tcase \"request\":\n\t\t\tcase \"notification\":\n\t\t\tcase \"response\":\n\t\t\tcase \"protocol-invalid\":\n\t\t\t\tawait this.core.receive(this.connectionId, message);\n\t\t\t\treturn;\n\t\t\tdefault:\n\t\t\t\treturn assertNever(message);\n\t\t}\n\t}\n\n\tprivate async writeMessage(message: RpcEnvelope): Promise<void> {\n\t\twriteRawStdout(serializeNdjsonMessage(message));\n\t\tawait waitForRawStdoutBackpressure();\n\t}\n\n\tprivate closeCore(reason: string): void {\n\t\tif (this.closed) {\n\t\t\treturn;\n\t\t}\n\t\tthis.closed = true;\n\t\tthis.detachReader();\n\t\tthis.stdin.off(\"end\", this.handleStdinEnd);\n\t\tthis.stdin.off(\"close\", this.handleStdinClose);\n\t\tthis.core.removeConnection(this.connectionId);\n\t\tif (activeTransport === this) {\n\t\t\tactiveTransport = undefined;\n\t\t}\n\t\tprocess.stderr.write(`app-server stdio closed: ${reason}\\n`);\n\t}\n\n\tprivate reportError(error: unknown): void {\n\t\tconst message = error instanceof Error ? (error.stack ?? error.message) : String(error);\n\t\tprocess.stderr.write(`app-server stdio error: ${message}\\n`);\n\t}\n}\n\nfunction assertNever(value: never): never {\n\tthrow new Error(`Unhandled stdio RPC emission: ${JSON.stringify(value)}`);\n}\n"]}

package/dist/modes/app-server/transports/unix-socket.d.ts

@@ -0,0 +1,22 @@
+import { ServerCore } from "../server/server-core.ts";
+import { type WebSocketListenerAuth } from "./websocket-auth.ts";
+export interface UnixSocketListenerOptions {
+    readonly socketPath?: string;
+    readonly auth?: WebSocketListenerAuth;
+    readonly core?: ServerCore;
+    readonly stderr?: Pick<NodeJS.WriteStream, "write">;
+    readonly outboundQueueBytes?: number;
+}
+export interface UnixSocketListenerHandle {
+    readonly socketPath: string;
+    readonly core: ServerCore;
+    readonly tokenFile: string | undefined;
+    readonly connectionCount: number;
+    close(): Promise<void>;
+}
+export declare class AppServerUnixSocketListenError extends Error {
+    readonly exitCode = 2;
+    constructor(message: string);
+}
+export declare function startAppServerUnixSocketListener(options?: UnixSocketListenerOptions): Promise<UnixSocketListenerHandle>;
+//# sourceMappingURL=unix-socket.d.ts.map

package/dist/modes/app-server/transports/unix-socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unix-socket.d.ts","sourceRoot":"","sources":["../../../../src/modes/app-server/transports/unix-socket.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAgC,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAG/F,MAAM,WAAW,yBAAyB;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,qBAAqB,CAAC;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACpD,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,wBAAwB;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAID,qBAAa,8BAA+B,SAAQ,KAAK;IACxD,QAAQ,CAAC,QAAQ,KAAK;IAEtB,YAAY,OAAO,EAAE,MAAM,EAG1B;CACD;AAED,wBAAsB,gCAAgC,CACrD,OAAO,GAAE,yBAA8B,GACrC,OAAO,CAAC,wBAAwB,CAAC,CA0CnC"}