@tea-agent/loop-agent 0.33.3 → 0.33.5

package/dist/worker/console/chat/routes.js

@@ -24,14 +24,14 @@ import { isSensitivePath, scrubSecrets } from "./explore-tools.js";
 import { listRepoDirectory, readRepoPreview, RepoBrowserError, } from "./repo-browser.js";
 import { projectRuntimeContext } from "./runtime-context.js";
 import { patchModelsConfig, readModelsConfig, readPackageInventory, readSkillPreferences, writeSkillPreferences, } from "./pi-console-config.js";
-import { ChatInterviewAdapter, projectChatInterviewState } from "./interview-adapter.js";
+import { ChatInterviewAdapter, projectChatInterviewState, } from "./interview-adapter.js";
 import { classifyChatCompactionFailure } from "./compaction-errors.js";
-import { evaluateMutationGate, isMutationMethod, } from "../security.js";
+import { evaluateMutationGate, isMutationMethod } from "../security.js";
 import { dispatchOperatorAction } from "../operator-actions.js";
-import { makeHumanGateCard } from "./human-gate-card.js";
+import { makeHumanGateCard, } from "./human-gate-card.js";
 import { ContractApplyReceiptStore } from "./contract-apply-receipt-store.js";
 import { projectTaskContext } from "./context-panel.js";
-import { contractApplyPayloadHash, issueHumanGateToken, verifyHumanGateToken } from "../human-gate-token.js";
+import { contractApplyPayloadHash, issueHumanGateToken, verifyHumanGateToken, } from "../human-gate-token.js";
 import { sendJson } from "../routes.js";
 import { openSseResponse, parseLastEventId, writeSseEvent, } from "../operation-sse.js";
 function writeChatSse(res, event) {
@@ -51,7 +51,10 @@ function turnEventToStorePartial(event) {
         case "agent_start":
             return { kind: "agent_start", data: {} };
         case "message_update":
-            return { kind: "message_update", data: { text: String(event.text ?? "") } };
+            return {
+                kind: "message_update",
+                data: { text: String(event.text ?? "") },
+            };
         case "message_end":
             return { kind: "message_end", data: { text: String(event.text ?? "") } };
         case "usage":
@@ -90,6 +93,22 @@ function turnEventToStorePartial(event) {
             return undefined;
     }
 }
+/** Guarantee a durable terminal event for a turn that ended without the SDK
+ *  emitting agent_end (client abort, pre-prompt persistence failure, runtime
+ *  error). Without it, a reconnect replay stops at agent_start and the UI stays
+ *  streaming forever. Idempotent: normal settled turns already carry the SDK's
+ *  agent_end in the ring, so they are skipped. */
+function ensureAgentEndEvent(deps, sessionId, turnId) {
+    const already = deps.events
+        .snapshot(sessionId)
+        .some((event) => event.turnId === turnId && event.kind === "agent_end");
+    if (!already) {
+        deps.events.append(sessionId, turnId, {
+            kind: "agent_end",
+            data: { willRetry: false },
+        });
+    }
+}
 async function readJsonBody(req, maxBytes = 2 * 1024 * 1024) {
     const chunks = [];
     let total = 0;
@@ -106,9 +125,22 @@ async function readJsonBody(req, maxBytes = 2 * 1024 * 1024) {
     const raw = Buffer.concat(chunks).toString("utf8");
     if (!raw.trim())
         return {};
-    return JSON.parse(raw);
+    try {
+        return JSON.parse(raw);
+    }
+    catch (error) {
+        // Preserve throw semantics: callers map parse failures to
+        // INVALID_INPUT / 400. The explicit catch keeps malformed JSON from
+        // surfacing as an unhandled SyntaxError.
+        throw error;
+    }
 }
-const IMAGE_MIME_TYPES = new Set(["image/png", "image/jpeg", "image/gif", "image/webp"]);
+const IMAGE_MIME_TYPES = new Set([
+    "image/png",
+    "image/jpeg",
+    "image/gif",
+    "image/webp",
+]);
 const MAX_IMAGE_BYTES = 5 * 1024 * 1024;
 const MAX_TOTAL_IMAGE_BYTES = 20 * 1024 * 1024;
 const MAX_IMAGES = 4;
@@ -122,12 +154,19 @@ export function parseChatImages(value) {
         if (!item || typeof item !== "object")
             throw new Error(`images[${index}] is invalid`);
         const record = item;
-        if (record.type !== "image" || typeof record.mimeType !== "string" || !IMAGE_MIME_TYPES.has(record.mimeType))
+        if (record.type !== "image" ||
+            typeof record.mimeType !== "string" ||
+            !IMAGE_MIME_TYPES.has(record.mimeType))
             throw new Error(`images[${index}] must be a supported raster image`);
-        if (typeof record.data !== "string" || !record.data || !/^[A-Za-z0-9+/]+={0,2}$/.test(record.data) || record.data.length % 4 !== 0)
+        if (typeof record.data !== "string" ||
+            !record.data ||
+            !/^[A-Za-z0-9+/]+={0,2}$/.test(record.data) ||
+            record.data.length % 4 !== 0)
             throw new Error(`images[${index}] data must be valid base64`);
         const bytes = Buffer.from(record.data, "base64");
-        const textProbe = bytes.subarray(0, Math.min(bytes.length, 64 * 1024)).toString("utf8");
+        const textProbe = bytes
+            .subarray(0, Math.min(bytes.length, 64 * 1024))
+            .toString("utf8");
         if (scrubSecrets(textProbe).redactions.length > 0)
             throw new Error(`images[${index}] contains secret-shaped content`);
         if (bytes.length > MAX_IMAGE_BYTES)
@@ -135,7 +174,11 @@ export function parseChatImages(value) {
         total += bytes.length;
         if (total > MAX_TOTAL_IMAGE_BYTES)
             throw new Error(`images exceed ${MAX_TOTAL_IMAGE_BYTES} total bytes`);
-        return { type: "image", mimeType: record.mimeType, data: bytes.toString("base64") };
+        return {
+            type: "image",
+            mimeType: record.mimeType,
+            data: bytes.toString("base64"),
+        };
     });
 }
 function gateMutation(req, deps) {
@@ -174,7 +217,8 @@ export async function handleChatCapabilities(_req, res, deps) {
             })),
             failures: skills.failures,
             skipped: skills.skipped,
-            promptFragmentCharCount: composeInstructionSkillsPrompt(skills.loaded).length,
+            promptFragmentCharCount: composeInstructionSkillsPrompt(skills.loaded)
+                .length,
         },
         // ADR 0011: full Pi tools including bash are default-active.
         hasBash: true,
@@ -204,22 +248,45 @@ export async function handleCreateChatSession(req, res, deps) {
         return;
     }
     if ("clientRequestId" in body || "requestIndex" in body) {
-        sendJson(res, 400, { ok: false, error: { code: "INVALID_INPUT", message: "operation idempotency ownership cannot be copied" } });
+        sendJson(res, 400, {
+            ok: false,
+            error: {
+                code: "INVALID_INPUT",
+                message: "operation idempotency ownership cannot be copied",
+            },
+        });
         return;
     }
     const provider = typeof body.modelProvider === "string" ? body.modelProvider : undefined;
     const modelId = typeof body.modelId === "string" ? body.modelId : undefined;
     const snapshotInput = body.snapshot;
-    if (snapshotInput !== undefined && (!snapshotInput || typeof snapshotInput !== "object" || snapshotInput.schemaVersion !== 1 || typeof snapshotInput.summary !== "string" || !snapshotInput.summary)) {
-        sendJson(res, 400, { ok: false, error: { code: "INVALID_SNAPSHOT", message: "valid OperatorContextSnapshotV1 is required" } });
+    if (snapshotInput !== undefined &&
+        (!snapshotInput ||
+            typeof snapshotInput !== "object" ||
+            snapshotInput.schemaVersion !== 1 ||
+            typeof snapshotInput.summary !== "string" ||
+            !snapshotInput.summary)) {
+        sendJson(res, 400, {
+            ok: false,
+            error: {
+                code: "INVALID_SNAPSHOT",
+                message: "valid OperatorContextSnapshotV1 is required",
+            },
+        });
         return;
     }
     try {
         deps.runtime.setDisabledInstructionSkills(await readSkillPreferences(deps.appData));
-        const snapshot = snapshotInput === undefined ? undefined : projectCompactSnapshot(snapshotInput);
+        const snapshot = snapshotInput === undefined
+            ? undefined
+            : projectCompactSnapshot(snapshotInput);
         const handle = await deps.runtime.createSession({
             ...(provider && modelId ? { model: { provider, modelId } } : {}),
-            ...(snapshot ? { systemPromptSuffix: `Read-only initial Operator context snapshot; this is not runtime rollback.\n${snapshot.summary}` } : {}),
+            ...(snapshot
+                ? {
+                    systemPromptSuffix: `Read-only initial Operator context snapshot; this is not runtime rollback.\n${snapshot.summary}`,
+                }
+                : {}),
         });
         await deps.store.create({
             sessionId: handle.sessionId,
@@ -228,7 +295,10 @@ export async function handleCreateChatSession(req, res, deps) {
             modelId: handle.model?.modelId,
         });
         if (snapshot)
-            deps.events.append(handle.sessionId, `${handle.sessionId}:snapshot`, { kind: "compact", data: snapshot });
+            deps.events.append(handle.sessionId, `${handle.sessionId}:snapshot`, {
+                kind: "compact",
+                data: snapshot,
+            });
         sendJson(res, 201, {
             ok: true,
             sessionId: handle.sessionId,
@@ -249,47 +319,102 @@ export async function handleCreateChatSession(req, res, deps) {
 export async function handleForkChatSession(req, res, deps, sourceSessionId) {
     const gate = gateMutation(req, deps);
     if (!gate.ok) {
-        sendJson(res, gate.status, { ok: false, error: { code: gate.code, message: gate.message } });
+        sendJson(res, gate.status, {
+            ok: false,
+            error: { code: gate.code, message: gate.message },
+        });
         return;
     }
     if (deps.events.getActiveTurn(sourceSessionId)) {
-        sendJson(res, 409, { ok: false, error: { code: "TURN_ACTIVE", message: "cannot fork an active turn" } });
+        sendJson(res, 409, {
+            ok: false,
+            error: { code: "TURN_ACTIVE", message: "cannot fork an active turn" },
+        });
         return;
     }
     const source = await deps.store.get(sourceSessionId);
     if (!source) {
-        sendJson(res, 404, { ok: false, error: { code: "NOT_FOUND", message: `chat session not found: ${sourceSessionId}` } });
+        sendJson(res, 404, {
+            ok: false,
+            error: {
+                code: "NOT_FOUND",
+                message: `chat session not found: ${sourceSessionId}`,
+            },
+        });
         return;
     }
     try {
-        const handle = await deps.runtime.forkSession({ sourceSessionFile: source.sessionFile ?? "", ...(source.modelProvider && source.modelId ? { model: { provider: source.modelProvider, modelId: source.modelId } } : {}) });
-        await deps.store.forkFrom({ sourceSessionId, targetSessionId: handle.sessionId, targetSessionFile: handle.sessionFile });
-        const copied = deps.events.forkContextRefs({ sourceSessionId, targetSessionId: handle.sessionId, targetTurnId: `${handle.sessionId}:fork` });
+        const handle = await deps.runtime.forkSession({
+            sourceSessionFile: source.sessionFile ?? "",
+            ...(source.modelProvider && source.modelId
+                ? { model: { provider: source.modelProvider, modelId: source.modelId } }
+                : {}),
+        });
+        await deps.store.forkFrom({
+            sourceSessionId,
+            targetSessionId: handle.sessionId,
+            targetSessionFile: handle.sessionFile,
+        });
+        const copied = deps.events.forkContextRefs({
+            sourceSessionId,
+            targetSessionId: handle.sessionId,
+            targetTurnId: `${handle.sessionId}:fork`,
+        });
         await deps.operationLinker.recoverSession(handle.sessionId);
-        sendJson(res, 201, { ok: true, sessionId: handle.sessionId, forkedFrom: sourceSessionId, copiedContextRefs: copied.copiedCount, warnings: ["已发生的 task/DAG/Worker mutation 不会撤销或重放。", "operation idempotency / clientRequestId ownership 不会复制到新会话。"] });
+        sendJson(res, 201, {
+            ok: true,
+            sessionId: handle.sessionId,
+            forkedFrom: sourceSessionId,
+            copiedContextRefs: copied.copiedCount,
+            warnings: [
+                "已发生的 task/DAG/Worker mutation 不会撤销或重放。",
+                "operation idempotency / clientRequestId ownership 不会复制到新会话。",
+            ],
+        });
     }
     catch (error) {
-        sendJson(res, 409, { ok: false, error: { code: "SESSION_FORK_FAILED", message: error instanceof Error ? error.message : String(error) } });
+        sendJson(res, 409, {
+            ok: false,
+            error: {
+                code: "SESSION_FORK_FAILED",
+                message: error instanceof Error ? error.message : String(error),
+            },
+        });
     }
 }
 export async function handleBranchChatSession(req, res, deps, sessionId) {
     const gate = gateMutation(req, deps);
     if (!gate.ok) {
-        sendJson(res, gate.status, { ok: false, error: { code: gate.code, message: gate.message } });
+        sendJson(res, gate.status, {
+            ok: false,
+            error: { code: gate.code, message: gate.message },
+        });
         return;
     }
     if (deps.events.getActiveTurn(sessionId)) {
-        sendJson(res, 409, { ok: false, error: { code: "TURN_ACTIVE", message: "cannot branch an active turn" } });
+        sendJson(res, 409, {
+            ok: false,
+            error: { code: "TURN_ACTIVE", message: "cannot branch an active turn" },
+        });
         return;
     }
     const record = await deps.store.get(sessionId);
     if (!record) {
-        sendJson(res, 404, { ok: false, error: { code: "NOT_FOUND", message: `chat session not found: ${sessionId}` } });
+        sendJson(res, 404, {
+            ok: false,
+            error: {
+                code: "NOT_FOUND",
+                message: `chat session not found: ${sessionId}`,
+            },
+        });
         return;
     }
     try {
         if (!deps.runtime.hasSession(sessionId)) {
-            const reopened = await deps.runtime.reopenSession({ sessionId, sessionFile: record.sessionFile });
+            const reopened = await deps.runtime.reopenSession({
+                sessionId,
+                sessionFile: record.sessionFile,
+            });
             if (!reopened.ok)
                 throw new Error(reopened.message);
         }
@@ -297,20 +422,41 @@ export async function handleBranchChatSession(req, res, deps, sessionId) {
         if ("clientRequestId" in body || "requestIndex" in body)
             throw new Error("operation idempotency ownership cannot be copied");
         const current = deps.runtime.getBranchContext(sessionId);
-        const branchFromEntryId = typeof body.branchFromEntryId === "string" ? body.branchFromEntryId : current.leafId;
+        const branchFromEntryId = typeof body.branchFromEntryId === "string"
+            ? body.branchFromEntryId
+            : current.leafId;
         if (!branchFromEntryId)
             throw new Error("branchFromEntryId is required");
-        const result = await deps.runtime.branchSession({ sessionId, branchFromEntryId, ...(typeof body.summary === "string" && body.summary ? { summary: body.summary } : {}) });
-        sendJson(res, 200, { ok: true, ...result, note: "仅影响后续 LLM 上下文，未持久化第二历史" });
+        const result = await deps.runtime.branchSession({
+            sessionId,
+            branchFromEntryId,
+            ...(typeof body.summary === "string" && body.summary
+                ? { summary: body.summary }
+                : {}),
+        });
+        sendJson(res, 200, {
+            ok: true,
+            ...result,
+            note: "仅影响后续 LLM 上下文，未持久化第二历史",
+        });
     }
     catch (error) {
-        sendJson(res, 400, { ok: false, error: { code: "SESSION_BRANCH_FAILED", message: error instanceof Error ? error.message : String(error) } });
+        sendJson(res, 400, {
+            ok: false,
+            error: {
+                code: "SESSION_BRANCH_FAILED",
+                message: error instanceof Error ? error.message : String(error),
+            },
+        });
     }
 }
 export async function handleSwitchMainlineChatSession(req, res, deps, sessionId) {
     const gate = gateMutation(req, deps);
     if (!gate.ok) {
-        sendJson(res, gate.status, { ok: false, error: { code: gate.code, message: gate.message } });
+        sendJson(res, gate.status, {
+            ok: false,
+            error: { code: gate.code, message: gate.message },
+        });
         return;
     }
     try {
@@ -318,7 +464,13 @@ export async function handleSwitchMainlineChatSession(req, res, deps, sessionId)
         sendJson(res, 200, { ok: true, sessionId, active: "mainline" });
     }
     catch (error) {
-        sendJson(res, 409, { ok: false, error: { code: "MAINLINE_SWITCH_FAILED", message: error instanceof Error ? error.message : String(error) } });
+        sendJson(res, 409, {
+            ok: false,
+            error: {
+                code: "MAINLINE_SWITCH_FAILED",
+                message: error instanceof Error ? error.message : String(error),
+            },
+        });
     }
 }
 export async function handleGetChatSession(_req, res, deps, sessionId) {
@@ -326,7 +478,10 @@ export async function handleGetChatSession(_req, res, deps, sessionId) {
     if (!record) {
         sendJson(res, 404, {
             ok: false,
-            error: { code: "NOT_FOUND", message: `chat session not found: ${sessionId}` },
+            error: {
+                code: "NOT_FOUND",
+                message: `chat session not found: ${sessionId}`,
+            },
         });
         return;
     }
@@ -346,6 +501,34 @@ export async function handleGetChatSession(_req, res, deps, sessionId) {
         lastEventSeq: lastEvent?.seq ?? 0,
     });
 }
+/** Lightweight busy-truth endpoint for the client reconcile loop (pi-web
+ *  get_state equivalent): exposes the active turn + the latest turn's durable
+ *  outcome WITHOUT the full message payload, so the UI can poll it on an
+ *  interval / visibility / online without paying for session detail. */
+export async function handleGetChatSessionState(_req, res, deps, sessionId) {
+    const record = await deps.store.get(sessionId);
+    if (!record) {
+        sendJson(res, 404, {
+            ok: false,
+            error: {
+                code: "NOT_FOUND",
+                message: `chat session not found: ${sessionId}`,
+            },
+        });
+        return;
+    }
+    const active = deps.events.getActiveTurn(sessionId);
+    const latest = deps.events.latestTurn(sessionId);
+    sendJson(res, 200, {
+        ok: true,
+        state: {
+            activeTurnId: active?.turnId ?? null,
+            activeTurnState: active?.state ?? null,
+            latestTurnId: latest?.turnId ?? null,
+            latestTurnState: latest?.state ?? null,
+        },
+    });
+}
 export async function handleListChatSessions(_req, res, deps) {
     const sessions = await deps.store.list({ includeArchived: true });
     sendJson(res, 200, {
@@ -361,7 +544,10 @@ export async function handleListChatSessions(_req, res, deps) {
 export async function handlePatchChatSession(req, res, deps, sessionId) {
     const gate = gateMutation(req, deps);
     if (!gate.ok) {
-        sendJson(res, gate.status, { ok: false, error: { code: gate.code, message: gate.message } });
+        sendJson(res, gate.status, {
+            ok: false,
+            error: { code: gate.code, message: gate.message },
+        });
         return;
     }
     try {
@@ -373,28 +559,55 @@ export async function handlePatchChatSession(req, res, deps, sessionId) {
             record = await deps.store.setState(sessionId, body.state);
         }
         else {
-            sendJson(res, 400, { ok: false, error: { code: "INVALID_INPUT", message: "title or state(active|archived) is required" } });
+            sendJson(res, 400, {
+                ok: false,
+                error: {
+                    code: "INVALID_INPUT",
+                    message: "title or state(active|archived) is required",
+                },
+            });
             return;
         }
         sendJson(res, 200, { ok: true, session: record });
     }
     catch (error) {
-        sendJson(res, 404, { ok: false, error: { code: "NOT_FOUND", message: error instanceof Error ? error.message : String(error) } });
+        sendJson(res, 404, {
+            ok: false,
+            error: {
+                code: "NOT_FOUND",
+                message: error instanceof Error ? error.message : String(error),
+            },
+        });
     }
 }
 export async function handleReopenChatSession(req, res, deps, sessionId) {
     const gate = gateMutation(req, deps);
     if (!gate.ok) {
-        sendJson(res, gate.status, { ok: false, error: { code: gate.code, message: gate.message } });
+        sendJson(res, gate.status, {
+            ok: false,
+            error: { code: gate.code, message: gate.message },
+        });
         return;
     }
     const record = await deps.store.get(sessionId);
     if (!record) {
-        sendJson(res, 404, { ok: false, error: { code: "NOT_FOUND", message: `chat session not found: ${sessionId}` } });
+        sendJson(res, 404, {
+            ok: false,
+            error: {
+                code: "NOT_FOUND",
+                message: `chat session not found: ${sessionId}`,
+            },
+        });
         return;
     }
     if (deps.runtime.hasSession(sessionId)) {
-        sendJson(res, 200, { ok: true, sessionId, reopened: false, alreadyActive: true, hasBash: true });
+        sendJson(res, 200, {
+            ok: true,
+            sessionId,
+            reopened: false,
+            alreadyActive: true,
+            hasBash: true,
+        });
         return;
     }
     const result = await deps.runtime.reopenSession({
@@ -405,7 +618,10 @@ export async function handleReopenChatSession(req, res, deps, sessionId) {
             : {}),
     });
     if (!result.ok) {
-        sendJson(res, 409, { ok: false, error: { code: result.code, message: result.message } });
+        sendJson(res, 409, {
+            ok: false,
+            error: { code: result.code, message: result.message },
+        });
         return;
     }
     sendJson(res, 200, {
@@ -447,7 +663,13 @@ export async function handleChatPrompt(req, res, deps, sessionId) {
         images = parseChatImages(body.images);
     }
     catch (error) {
-        sendJson(res, 400, { ok: false, error: { code: "INVALID_ATTACHMENT", message: error instanceof Error ? error.message : String(error) } });
+        sendJson(res, 400, {
+            ok: false,
+            error: {
+                code: "INVALID_ATTACHMENT",
+                message: error instanceof Error ? error.message : String(error),
+            },
+        });
         return;
     }
     if (!text) {
@@ -464,7 +686,13 @@ export async function handleChatPrompt(req, res, deps, sessionId) {
         // fresh session under the same id, which would lose prior context.
         const record = await deps.store.get(sessionId);
         if (!record) {
-            sendJson(res, 404, { ok: false, error: { code: "NOT_FOUND", message: `chat session not found: ${sessionId}` } });
+            sendJson(res, 404, {
+                ok: false,
+                error: {
+                    code: "NOT_FOUND",
+                    message: `chat session not found: ${sessionId}`,
+                },
+            });
             return;
         }
         const reopen = await deps.runtime.reopenSession({
@@ -475,7 +703,10 @@ export async function handleChatPrompt(req, res, deps, sessionId) {
                 : {}),
         });
         if (!reopen.ok) {
-            sendJson(res, 409, { ok: false, error: { code: reopen.code, message: reopen.message } });
+            sendJson(res, 409, {
+                ok: false,
+                error: { code: reopen.code, message: reopen.message },
+            });
             return;
         }
     }
@@ -541,13 +772,17 @@ export async function handleChatPrompt(req, res, deps, sessionId) {
             onEvent: (event) => {
                 if (closed)
                     return;
-                if (event.type === "tool_result" && event.toolName === "prepareDagConfirmation" && !event.isError) {
+                if (event.type === "tool_result" &&
+                    event.toolName === "prepareDagConfirmation" &&
+                    !event.isError) {
                     const result = event.result;
                     const confirmationId = result?.confirmation?.confirmationId;
                     if (confirmationId)
                         void ctxConfirmationCard(deps, sessionId, turnId, confirmationId);
                 }
-                if (event.type === "tool_result" && event.toolName === "prepareMutationGate" && !event.isError) {
+                if (event.type === "tool_result" &&
+                    event.toolName === "prepareMutationGate" &&
+                    !event.isError) {
                     const result = event.result;
                     if (result?.receiptId)
                         void ctxMutationGateCard(deps, sessionId, result.receiptId);
@@ -569,12 +804,14 @@ export async function handleChatPrompt(req, res, deps, sessionId) {
             },
         });
         if (abortedByClient || ac.signal.aborted) {
+            ensureAgentEndEvent(deps, sessionId, turnId);
             deps.events.setTurnState(sessionId, turnId, "aborted", {
                 code: "CLIENT_ABORTED",
                 message: "client disconnected before turn settled",
             });
         }
         else {
+            ensureAgentEndEvent(deps, sessionId, turnId);
             deps.events.setTurnState(sessionId, turnId, outcome.ok ? "settled" : "failed", outcome.error);
         }
     }
@@ -585,8 +822,11 @@ export async function handleChatPrompt(req, res, deps, sessionId) {
         // stream is already open. Persist + emit an error event so a reconnecting
         // client also sees the failure (not just the original requester).
         const message = error instanceof Error ? error.message : String(error);
+        ensureAgentEndEvent(deps, sessionId, turnId);
         deps.events.setTurnState(sessionId, turnId, abortedByClient || ac.signal.aborted ? "aborted" : "failed", {
-            code: abortedByClient || ac.signal.aborted ? "CLIENT_ABORTED" : "CHAT_TURN_FAILED",
+            code: abortedByClient || ac.signal.aborted
+                ? "CLIENT_ABORTED"
+                : "CHAT_TURN_FAILED",
             message,
         });
         if (!closed) {
@@ -615,7 +855,10 @@ export async function handleChatPrompt(req, res, deps, sessionId) {
 export async function handleCreateChatTurn(req, res, deps, sessionId) {
     const gate = gateMutation(req, deps);
     if (!gate.ok) {
-        sendJson(res, gate.status, { ok: false, error: { code: gate.code, message: gate.message } });
+        sendJson(res, gate.status, {
+            ok: false,
+            error: { code: gate.code, message: gate.message },
+        });
         return;
     }
     let body;
@@ -623,7 +866,13 @@ export async function handleCreateChatTurn(req, res, deps, sessionId) {
         body = await readJsonBody(req);
     }
     catch (error) {
-        sendJson(res, 400, { ok: false, error: { code: "INVALID_INPUT", message: error instanceof Error ? error.message : String(error) } });
+        sendJson(res, 400, {
+            ok: false,
+            error: {
+                code: "INVALID_INPUT",
+                message: error instanceof Error ? error.message : String(error),
+            },
+        });
         return;
     }
     const text = typeof body.text === "string" ? body.text.trim() : "";
@@ -632,17 +881,32 @@ export async function handleCreateChatTurn(req, res, deps, sessionId) {
         images = parseChatImages(body.images);
     }
     catch (error) {
-        sendJson(res, 400, { ok: false, error: { code: "INVALID_ATTACHMENT", message: error instanceof Error ? error.message : String(error) } });
+        sendJson(res, 400, {
+            ok: false,
+            error: {
+                code: "INVALID_ATTACHMENT",
+                message: error instanceof Error ? error.message : String(error),
+            },
+        });
         return;
     }
     if (!text) {
-        sendJson(res, 400, { ok: false, error: { code: "INVALID_INPUT", message: "text is required" } });
+        sendJson(res, 400, {
+            ok: false,
+            error: { code: "INVALID_INPUT", message: "text is required" },
+        });
         return;
     }
     if (!deps.runtime.hasSession(sessionId)) {
         const record = await deps.store.get(sessionId);
         if (!record) {
-            sendJson(res, 404, { ok: false, error: { code: "NOT_FOUND", message: `chat session not found: ${sessionId}` } });
+            sendJson(res, 404, {
+                ok: false,
+                error: {
+                    code: "NOT_FOUND",
+                    message: `chat session not found: ${sessionId}`,
+                },
+            });
             return;
         }
         const reopen = await deps.runtime.reopenSession({
@@ -653,26 +917,43 @@ export async function handleCreateChatTurn(req, res, deps, sessionId) {
                 : {}),
         });
         if (!reopen.ok) {
-            sendJson(res, 409, { ok: false, error: { code: reopen.code, message: reopen.message } });
+            sendJson(res, 409, {
+                ok: false,
+                error: { code: reopen.code, message: reopen.message },
+            });
             return;
         }
     }
     const actionContext = deps.runtime.actionContext;
     if (!actionContext) {
-        sendJson(res, 503, { ok: false, error: { code: "CHAT_NO_ACTION_CONTEXT", message: "Chat runtime has no operator action context wired" } });
+        sendJson(res, 503, {
+            ok: false,
+            error: {
+                code: "CHAT_NO_ACTION_CONTEXT",
+                message: "Chat runtime has no operator action context wired",
+            },
+        });
         return;
     }
     const created = deps.events.createTurn(sessionId);
     if (!created.ok) {
         sendJson(res, 409, {
             ok: false,
-            error: { code: "TURN_ACTIVE", message: `chat turn already active: ${created.activeTurn.turnId}` },
+            error: {
+                code: "TURN_ACTIVE",
+                message: `chat turn already active: ${created.activeTurn.turnId}`,
+            },
         });
         return;
     }
     const turn = created.turn;
     deps.events.setTurnState(sessionId, turn.turnId, "running");
-    sendJson(res, 202, { ok: true, turnId: turn.turnId, ordinal: turn.ordinal, state: "running" });
+    sendJson(res, 202, {
+        ok: true,
+        turnId: turn.turnId,
+        ordinal: turn.ordinal,
+        state: "running",
+    });
     // Deliberately detached from the request lifecycle: closing the POST
     // response cannot abort the prompt; clients follow GET /events instead.
     void (async () => {
@@ -699,11 +980,16 @@ export async function handleCreateChatTurn(req, res, deps, sessionId) {
                         deps.events.append(sessionId, turn.turnId, partial);
                 },
             });
+            ensureAgentEndEvent(deps, sessionId, turn.turnId);
             deps.events.setTurnState(sessionId, turn.turnId, outcome.ok ? "settled" : "failed", outcome.error);
         }
         catch (error) {
             const message = error instanceof Error ? error.message : String(error);
-            deps.events.append(sessionId, turn.turnId, { kind: "error", data: { message } });
+            deps.events.append(sessionId, turn.turnId, {
+                kind: "error",
+                data: { message },
+            });
+            ensureAgentEndEvent(deps, sessionId, turn.turnId);
             deps.events.setTurnState(sessionId, turn.turnId, "failed", {
                 code: "CHAT_TURN_FAILED",
                 message,
@@ -714,7 +1000,10 @@ export async function handleCreateChatTurn(req, res, deps, sessionId) {
 export async function handleGetChatTurn(_req, res, deps, sessionId, turnId) {
     const turn = deps.events.getTurn(sessionId, turnId);
     if (!turn) {
-        sendJson(res, 404, { ok: false, error: { code: "NOT_FOUND", message: `chat turn not found: ${turnId}` } });
+        sendJson(res, 404, {
+            ok: false,
+            error: { code: "NOT_FOUND", message: `chat turn not found: ${turnId}` },
+        });
         return;
     }
     sendJson(res, 200, { ok: true, turn });
@@ -725,7 +1014,13 @@ export async function handleChatEventsStream(req, res, deps, sessionId) {
     // the boot cookie so only the Console browser can poll a live session.
     const record = await deps.store.get(sessionId);
     if (!record) {
-        sendJson(res, 404, { ok: false, error: { code: "NOT_FOUND", message: `chat session not found: ${sessionId}` } });
+        sendJson(res, 404, {
+            ok: false,
+            error: {
+                code: "NOT_FOUND",
+                message: `chat session not found: ${sessionId}`,
+            },
+        });
         return;
     }
     await deps.operationLinker.recoverSession(sessionId);
@@ -812,13 +1107,19 @@ export async function handleDeleteChatSession(req, res, deps, sessionId) {
     const removed = await deps.store.remove(sessionId);
     await new ComposerDraftStore(deps.appData).remove(sessionId);
     if (!removed) {
-        sendJson(res, 404, { ok: false, error: { code: "NOT_FOUND", message: `chat session not found: ${sessionId}` } });
+        sendJson(res, 404, {
+            ok: false,
+            error: {
+                code: "NOT_FOUND",
+                message: `chat session not found: ${sessionId}`,
+            },
+        });
         return;
     }
     sendJson(res, 200, { ok: true, sessionId, disposed: true, removed: true });
 }
 export async function handleGetTaskContext(_res, res, deps, sessionId) {
-    if (!await requireChatSession(res, deps, sessionId))
+    if (!(await requireChatSession(res, deps, sessionId)))
         return;
     const events = deps.events.snapshot(sessionId);
     const context = projectTaskContext(events);
@@ -833,10 +1134,13 @@ export async function handleGetTaskContext(_res, res, deps, sessionId) {
 async function handleComposerDraft(req, res, deps, sessionId) {
     const gate = gateMutation(req, deps);
     if (!gate.ok) {
-        sendJson(res, gate.status, { ok: false, error: { code: gate.code, message: gate.message } });
+        sendJson(res, gate.status, {
+            ok: false,
+            error: { code: gate.code, message: gate.message },
+        });
         return;
     }
-    if (!await requireChatSession(res, deps, sessionId))
+    if (!(await requireChatSession(res, deps, sessionId)))
         return;
     try {
         const body = await readJsonBody(req, 70 * 1024);
@@ -845,7 +1149,13 @@ async function handleComposerDraft(req, res, deps, sessionId) {
         sendJson(res, 200, { ok: true });
     }
     catch (error) {
-        sendJson(res, 400, { ok: false, error: { code: "INVALID_INPUT", message: error instanceof Error ? error.message : String(error) } });
+        sendJson(res, 400, {
+            ok: false,
+            error: {
+                code: "INVALID_INPUT",
+                message: error instanceof Error ? error.message : String(error),
+            },
+        });
     }
 }
 async function handleRepoBrowser(res, deps, kind, rawPath) {
@@ -859,7 +1169,10 @@ async function handleRepoBrowser(res, deps, kind, rawPath) {
         const failure = error instanceof RepoBrowserError
             ? error
             : new RepoBrowserError(500, "READ_FAILED", error instanceof Error ? error.message : String(error));
-        sendJson(res, failure.status, { ok: false, error: { code: failure.code, message: failure.message } });
+        sendJson(res, failure.status, {
+            ok: false,
+            error: { code: failure.code, message: failure.message },
+        });
     }
 }
 async function handlePiConfig(req, res, deps, resource) {
@@ -867,26 +1180,43 @@ async function handlePiConfig(req, res, deps, resource) {
         if (resource === "models") {
             const agentDir = await deps.runtime.getAgentDir();
             if (req.method === "GET")
-                sendJson(res, 200, { ok: true, data: await readModelsConfig(agentDir) });
+                sendJson(res, 200, {
+                    ok: true,
+                    data: await readModelsConfig(agentDir),
+                });
             else {
                 const gate = gateMutation(req, deps);
                 if (!gate.ok) {
-                    sendJson(res, gate.status, { ok: false, error: { code: gate.code, message: gate.message } });
+                    sendJson(res, gate.status, {
+                        ok: false,
+                        error: { code: gate.code, message: gate.message },
+                    });
                     return;
                 }
                 const body = await readJsonBody(req);
-                sendJson(res, 200, { ok: true, data: await patchModelsConfig(agentDir, body) });
+                sendJson(res, 200, {
+                    ok: true,
+                    data: await patchModelsConfig(agentDir, body),
+                });
             }
             return;
         }
         if (resource === "packages") {
-            sendJson(res, 200, { ok: true, data: { packages: await readPackageInventory(await deps.runtime.getAgentDir(), deps.appData.repoRoot), mutationSupported: false } });
+            sendJson(res, 200, {
+                ok: true,
+                data: {
+                    packages: await readPackageInventory(await deps.runtime.getAgentDir(), deps.appData.repoRoot),
+                    mutationSupported: false,
+                },
+            });
             return;
         }
         if (req.method === "GET") {
             const disabledNames = await readSkillPreferences(deps.appData);
             const loaded = await loadOperatorChatInstructionSkills(deps.skillsDir);
-            sendJson(res, 200, { ok: true, data: {
+            sendJson(res, 200, {
+                ok: true,
+                data: {
                     allowed: OPERATOR_CHAT_ALLOWED_INSTRUCTION_SKILLS.map((name) => {
                         const skill = loaded.loaded.find((item) => item.name === name);
                         return {
@@ -900,32 +1230,53 @@ async function handlePiConfig(req, res, deps, resource) {
                     conditional: OPERATOR_CHAT_WORKFLOW_CONDITIONAL_SKILLS,
                     denied: OPERATOR_CHAT_DENIED_INSTRUCTION_SKILLS,
                     disabledNames,
-                } });
+                },
+            });
         }
         else {
             const gate = gateMutation(req, deps);
             if (!gate.ok) {
-                sendJson(res, gate.status, { ok: false, error: { code: gate.code, message: gate.message } });
+                sendJson(res, gate.status, {
+                    ok: false,
+                    error: { code: gate.code, message: gate.message },
+                });
                 return;
             }
             const body = await readJsonBody(req);
-            const disabledNames = await writeSkillPreferences(deps.appData, Array.isArray(body.disabledNames) ? body.disabledNames.filter((name) => typeof name === "string") : []);
+            const disabledNames = await writeSkillPreferences(deps.appData, Array.isArray(body.disabledNames)
+                ? body.disabledNames.filter((name) => typeof name === "string")
+                : []);
             deps.runtime.setDisabledInstructionSkills(disabledNames);
-            sendJson(res, 200, { ok: true, data: { disabledNames, appliesTo: "new-sessions" } });
+            sendJson(res, 200, {
+                ok: true,
+                data: { disabledNames, appliesTo: "new-sessions" },
+            });
         }
     }
     catch (error) {
         const failure = error;
-        sendJson(res, failure.status ?? 400, { ok: false, error: { code: failure.code ?? "INVALID_INPUT", message: failure.message } });
+        sendJson(res, failure.status ?? 400, {
+            ok: false,
+            error: {
+                code: failure.code ?? "INVALID_INPUT",
+                message: failure.message,
+            },
+        });
     }
 }
 async function handleChatFiles(res, deps, sessionId, query) {
-    if (!await requireChatSession(res, deps, sessionId))
+    if (!(await requireChatSession(res, deps, sessionId)))
         return;
     const q = query.trim().toLowerCase();
-    const files = (await walkRepoFiles(deps.appData.repoRoot, { skipSensitive: true, maxFiles: 5000 }))
-        .map((entry) => entry.repoRelative).filter((file) => !isSensitivePath(file) && (!q || file.toLowerCase().includes(q)))
-        .sort((a, b) => a.localeCompare(b)).slice(0, 50).map((path) => ({ path }));
+    const files = (await walkRepoFiles(deps.appData.repoRoot, {
+        skipSensitive: true,
+        maxFiles: 5000,
+    }))
+        .map((entry) => entry.repoRelative)
+        .filter((file) => !isSensitivePath(file) && (!q || file.toLowerCase().includes(q)))
+        .sort((a, b) => a.localeCompare(b))
+        .slice(0, 50)
+        .map((path) => ({ path }));
     sendJson(res, 200, { ok: true, files });
 }
 async function handleRuntimeContext(res, deps, sessionId) {
@@ -958,123 +1309,226 @@ async function handleRuntimeContext(res, deps, sessionId) {
     });
 }
 async function handleModels(req, res, deps, sessionId) {
-    if (!await requireChatSession(res, deps, sessionId))
+    if (!(await requireChatSession(res, deps, sessionId)))
         return;
     try {
         if ((req.method ?? "GET").toUpperCase() === "GET") {
-            sendJson(res, 200, { ok: true, models: await deps.runtime.listModels(sessionId), thinkingLevels: THINKING_LEVELS });
+            sendJson(res, 200, {
+                ok: true,
+                models: await deps.runtime.listModels(sessionId),
+                thinkingLevels: THINKING_LEVELS,
+            });
             return;
         }
         const gate = gateMutation(req, deps);
         if (!gate.ok) {
-            sendJson(res, gate.status, { ok: false, error: { code: gate.code, message: gate.message } });
+            sendJson(res, gate.status, {
+                ok: false,
+                error: { code: gate.code, message: gate.message },
+            });
             return;
         }
         const body = await readJsonBody(req);
         let updated;
         if (typeof body.provider === "string" && typeof body.modelId === "string") {
-            const model = await deps.runtime.applyModel(sessionId, { provider: body.provider, modelId: body.modelId });
-            updated = await deps.store.setRuntimeSelection(sessionId, { modelProvider: model.provider, modelId: model.modelId });
+            const model = await deps.runtime.applyModel(sessionId, {
+                provider: body.provider,
+                modelId: body.modelId,
+            });
+            updated = await deps.store.setRuntimeSelection(sessionId, {
+                modelProvider: model.provider,
+                modelId: model.modelId,
+            });
         }
-        else if (typeof body.thinkingLevel === "string" && THINKING_LEVELS.includes(body.thinkingLevel)) {
+        else if (typeof body.thinkingLevel === "string" &&
+            THINKING_LEVELS.includes(body.thinkingLevel)) {
             const thinkingLevel = deps.runtime.applyThinkingLevel(sessionId, body.thinkingLevel);
-            updated = await deps.store.setRuntimeSelection(sessionId, { thinkingLevel });
+            updated = await deps.store.setRuntimeSelection(sessionId, {
+                thinkingLevel,
+            });
         }
         else {
-            sendJson(res, 400, { ok: false, error: { code: "INVALID_INPUT", message: "provider/modelId or thinkingLevel is required" } });
+            sendJson(res, 400, {
+                ok: false,
+                error: {
+                    code: "INVALID_INPUT",
+                    message: "provider/modelId or thinkingLevel is required",
+                },
+            });
             return;
         }
         sendJson(res, 200, { ok: true, session: updated });
     }
     catch (error) {
-        sendJson(res, 409, { ok: false, error: { code: "MODEL_SWITCH_FAILED", message: error instanceof Error ? error.message : String(error) } });
+        sendJson(res, 409, {
+            ok: false,
+            error: {
+                code: "MODEL_SWITCH_FAILED",
+                message: error instanceof Error ? error.message : String(error),
+            },
+        });
     }
 }
 async function requireChatSession(res, deps, sessionId) {
     if (await deps.store.get(sessionId))
         return true;
-    sendJson(res, 404, { ok: false, error: { code: "NOT_FOUND", message: `chat session not found: ${sessionId}` } });
+    sendJson(res, 404, {
+        ok: false,
+        error: {
+            code: "NOT_FOUND",
+            message: `chat session not found: ${sessionId}`,
+        },
+    });
     return false;
 }
 async function handleLinkWorkspaceOperation(req, res, deps, sessionId) {
     const gate = gateMutation(req, deps);
     if (!gate.ok) {
-        sendJson(res, gate.status, { ok: false, error: { code: gate.code, message: gate.message } });
+        sendJson(res, gate.status, {
+            ok: false,
+            error: { code: gate.code, message: gate.message },
+        });
         return;
     }
-    if (!await requireChatSession(res, deps, sessionId))
+    if (!(await requireChatSession(res, deps, sessionId)))
         return;
     try {
         const body = await readJsonBody(req);
         const operationId = typeof body.operationId === "string" ? body.operationId.trim() : "";
         if (!operationId) {
-            sendJson(res, 400, { ok: false, error: { code: "INVALID_INPUT", message: "operationId is required" } });
+            sendJson(res, 400, {
+                ok: false,
+                error: { code: "INVALID_INPUT", message: "operationId is required" },
+            });
             return;
         }
         const operations = deps.runtime.actionContext?.operations;
-        if (!operations || !await operations.get(operationId)) {
-            sendJson(res, 404, { ok: false, error: { code: "NOT_FOUND", message: `operation not found: ${operationId}` } });
+        if (!operations || !(await operations.get(operationId))) {
+            sendJson(res, 404, {
+                ok: false,
+                error: {
+                    code: "NOT_FOUND",
+                    message: `operation not found: ${operationId}`,
+                },
+            });
             return;
         }
-        await deps.operationLinker.link({ sessionId, turnId: deps.events.latestTurnId(sessionId) ?? "workspace", toolCallId: `workspace-${operationId}`, operationId });
+        await deps.operationLinker.link({
+            sessionId,
+            turnId: deps.events.latestTurnId(sessionId) ?? "workspace",
+            toolCallId: `workspace-${operationId}`,
+            operationId,
+        });
         sendJson(res, 200, { ok: true });
     }
     catch (error) {
-        sendJson(res, 400, { ok: false, error: { code: "INVALID_INPUT", message: error instanceof Error ? error.message : String(error) } });
+        sendJson(res, 400, {
+            ok: false,
+            error: {
+                code: "INVALID_INPUT",
+                message: error instanceof Error ? error.message : String(error),
+            },
+        });
     }
 }
 async function handleStartInterview(req, res, deps, sessionId) {
     const gate = gateMutation(req, deps);
     if (!gate.ok) {
-        sendJson(res, gate.status, { ok: false, error: { code: gate.code, message: gate.message } });
+        sendJson(res, gate.status, {
+            ok: false,
+            error: { code: gate.code, message: gate.message },
+        });
         return;
     }
-    if (!await requireChatSession(res, deps, sessionId))
+    if (!(await requireChatSession(res, deps, sessionId)))
         return;
     try {
         const body = await readJsonBody(req);
         const taskId = typeof body.taskId === "string" ? body.taskId.trim() : "";
         if (!taskId) {
-            sendJson(res, 400, { ok: false, error: { code: "INVALID_INPUT", message: "taskId is required" } });
+            sendJson(res, 400, {
+                ok: false,
+                error: { code: "INVALID_INPUT", message: "taskId is required" },
+            });
             return;
         }
         const adapter = new ChatInterviewAdapter(deps.appData, deps.events);
-        const state = await adapter.start({ operatorSessionId: sessionId, taskId, ...(typeof body.title === "string" ? { title: body.title } : {}), ...(body.initialDraft && typeof body.initialDraft === "object" ? { initialDraft: body.initialDraft } : {}) });
+        const state = await adapter.start({
+            operatorSessionId: sessionId,
+            taskId,
+            ...(typeof body.title === "string" ? { title: body.title } : {}),
+            ...(body.initialDraft && typeof body.initialDraft === "object"
+                ? { initialDraft: body.initialDraft }
+                : {}),
+        });
         sendJson(res, 201, { ok: true, ...projectChatInterviewState(state) });
     }
     catch (error) {
-        sendJson(res, 400, { ok: false, error: { code: "INTERVIEW_START_FAILED", message: error instanceof Error ? error.message : String(error) } });
+        sendJson(res, 400, {
+            ok: false,
+            error: {
+                code: "INTERVIEW_START_FAILED",
+                message: error instanceof Error ? error.message : String(error),
+            },
+        });
     }
 }
 async function handleAnswerInterview(req, res, deps, sessionId, interviewSessionId) {
     const gate = gateMutation(req, deps);
     if (!gate.ok) {
-        sendJson(res, gate.status, { ok: false, error: { code: gate.code, message: gate.message } });
+        sendJson(res, gate.status, {
+            ok: false,
+            error: { code: gate.code, message: gate.message },
+        });
         return;
     }
-    if (!await requireChatSession(res, deps, sessionId))
+    if (!(await requireChatSession(res, deps, sessionId)))
         return;
     try {
         const body = await readJsonBody(req);
         const questionId = typeof body.questionId === "string" ? body.questionId : "";
         const response = typeof body.response === "string" ? body.response : "";
         if (!questionId || !response) {
-            sendJson(res, 400, { ok: false, error: { code: "INVALID_INPUT", message: "questionId and response are required" } });
+            sendJson(res, 400, {
+                ok: false,
+                error: {
+                    code: "INVALID_INPUT",
+                    message: "questionId and response are required",
+                },
+            });
             return;
         }
-        const state = await new ChatInterviewAdapter(deps.appData, deps.events).answer({ operatorSessionId: sessionId, interviewSessionId, questionId, response, ...(typeof body.text === "string" ? { text: body.text } : {}) });
+        const state = await new ChatInterviewAdapter(deps.appData, deps.events).answer({
+            operatorSessionId: sessionId,
+            interviewSessionId,
+            questionId,
+            response,
+            ...(typeof body.text === "string" ? { text: body.text } : {}),
+        });
         sendJson(res, 200, { ok: true, ...projectChatInterviewState(state) });
     }
     catch (error) {
-        sendJson(res, 400, { ok: false, error: { code: "INTERVIEW_ANSWER_FAILED", message: error instanceof Error ? error.message : String(error) } });
+        sendJson(res, 400, {
+            ok: false,
+            error: {
+                code: "INTERVIEW_ANSWER_FAILED",
+                message: error instanceof Error ? error.message : String(error),
+            },
+        });
     }
 }
 async function handleGetInterviewFact(res, deps, sessionId, interviewSessionId, fact) {
-    if (!await requireChatSession(res, deps, sessionId))
+    if (!(await requireChatSession(res, deps, sessionId)))
         return;
     const state = await new ChatInterviewAdapter(deps.appData, deps.events).get(interviewSessionId);
     if (!state || state.interview.operatorSessionId !== sessionId) {
-        sendJson(res, 404, { ok: false, error: { code: "NOT_FOUND", message: `interview session not found: ${interviewSessionId}` } });
+        sendJson(res, 404, {
+            ok: false,
+            error: {
+                code: "NOT_FOUND",
+                message: `interview session not found: ${interviewSessionId}`,
+            },
+        });
         return;
     }
     const projected = projectChatInterviewState(state);
@@ -1094,7 +1548,12 @@ async function ctxConfirmationCard(deps, sessionId, turnId, confirmationId) {
         expiresAt: confirmation.expiresAt,
         inspectHref: `/inspect/?taskId=${encodeURIComponent(taskId)}#/`,
         humanGateToken: confirmation.humanGateToken,
-        displayOnlyChallenges: ["source", "writer-scope", "verification", "human-gates"],
+        displayOnlyChallenges: [
+            "source",
+            "writer-scope",
+            "verification",
+            "human-gates",
+        ],
         contractRevision: confirmation.taskContractBinding.revision,
     }));
     void turnId;
@@ -1130,26 +1589,44 @@ async function liveContractBinding(ctx, taskId) {
     const draft = await ctx.drafts.get(taskId);
     if (!draft)
         throw new Error(`draft not found: ${taskId}`);
-    const shown = await dispatchOperatorAction(ctx, { action: "contractShow", actionParams: { taskId } });
+    const shown = await dispatchOperatorAction(ctx, {
+        action: "contractShow",
+        actionParams: { taskId },
+    });
     if (shown.kind === "error")
         throw new Error("contractShow failed");
     const result = actionResultBody(shown);
     const state = result.state;
     const revision = state?.ref?.revision ?? 0;
     const expectedObservedHash = state?.observedCanonicalHash ?? "0".repeat(64);
-    return { taskId, revision, canonicalHash: state?.ref?.canonicalHash ?? expectedObservedHash, draftSha256: draft.draftSha256, expectedObservedHash };
+    return {
+        taskId,
+        revision,
+        canonicalHash: state?.ref?.canonicalHash ?? expectedObservedHash,
+        draftSha256: draft.draftSha256,
+        expectedObservedHash,
+    };
 }
 async function handleContractApplyHumanGate(req, res, deps, sessionId, step) {
     const gate = gateMutation(req, deps);
     if (!gate.ok) {
-        sendJson(res, gate.status, { ok: false, error: { code: gate.code, message: gate.message } });
+        sendJson(res, gate.status, {
+            ok: false,
+            error: { code: gate.code, message: gate.message },
+        });
         return;
     }
-    if (!await requireChatSession(res, deps, sessionId))
+    if (!(await requireChatSession(res, deps, sessionId)))
         return;
     const ctx = deps.runtime.actionContext;
     if (!ctx) {
-        sendJson(res, 503, { ok: false, error: { code: "CHAT_NO_ACTION_CONTEXT", message: "Chat runtime has no operator action context wired" } });
+        sendJson(res, 503, {
+            ok: false,
+            error: {
+                code: "CHAT_NO_ACTION_CONTEXT",
+                message: "Chat runtime has no operator action context wired",
+            },
+        });
         return;
     }
     try {
@@ -1162,9 +1639,30 @@ async function handleContractApplyHumanGate(req, res, deps, sessionId, step) {
             const binding = await liveContractBinding(ctx, taskId);
             const expiresAt = new Date(Date.now() + 30 * 60_000).toISOString();
             const receiptId = `apply_${crypto.randomUUID()}`;
-            const humanGateToken = issueHumanGateToken({ confirmationId: receiptId, payloadHash: contractApplyPayloadHash(binding), expiresAt }, deps.bootToken.confirmationToken);
-            const receipt = await receipts.prepare({ receiptId, operatorSessionId: sessionId, ...binding, expiresAt, humanGateToken });
-            const card = makeHumanGateCard({ cardId: `contract-${receipt.receiptId}`, gateType: "contract-apply", state: "prepared", taskId, receiptId: receipt.receiptId, expiresAt, humanGateToken, contractRevision: binding.revision, contractDiffSummary: `revision ${binding.revision}; draft ${binding.draftSha256.slice(0, 12)}; observed ${binding.expectedObservedHash.slice(0, 12)}`, inspectHref: `/inspect/?taskId=${encodeURIComponent(taskId)}#/` });
+            const humanGateToken = issueHumanGateToken({
+                confirmationId: receiptId,
+                payloadHash: contractApplyPayloadHash(binding),
+                expiresAt,
+            }, deps.bootToken.confirmationToken);
+            const receipt = await receipts.prepare({
+                receiptId,
+                operatorSessionId: sessionId,
+                ...binding,
+                expiresAt,
+                humanGateToken,
+            });
+            const card = makeHumanGateCard({
+                cardId: `contract-${receipt.receiptId}`,
+                gateType: "contract-apply",
+                state: "prepared",
+                taskId,
+                receiptId: receipt.receiptId,
+                expiresAt,
+                humanGateToken,
+                contractRevision: binding.revision,
+                contractDiffSummary: `revision ${binding.revision}; draft ${binding.draftSha256.slice(0, 12)}; observed ${binding.expectedObservedHash.slice(0, 12)}`,
+                inspectHref: `/inspect/?taskId=${encodeURIComponent(taskId)}#/`,
+            });
             appendHumanGateCard(deps, sessionId, card);
             sendJson(res, 201, { ok: true, card });
             return;
@@ -1172,18 +1670,34 @@ async function handleContractApplyHumanGate(req, res, deps, sessionId, step) {
         const receiptId = typeof body.receiptId === "string" ? body.receiptId : "";
         const receipt = await receipts.get(receiptId);
         if (!receipt || receipt.operatorSessionId !== sessionId) {
-            sendJson(res, 404, { ok: false, error: { code: "NOT_FOUND", message: "contract apply receipt not found" } });
+            sendJson(res, 404, {
+                ok: false,
+                error: {
+                    code: "NOT_FOUND",
+                    message: "contract apply receipt not found",
+                },
+            });
             return;
         }
         const current = await liveContractBinding(ctx, receipt.taskId);
-        const check = verifyHumanGateToken(body.humanGateToken, { confirmationId: receipt.receiptId, payloadHash: contractApplyPayloadHash(current) }, deps.bootToken.confirmationToken);
+        const check = verifyHumanGateToken(body.humanGateToken, {
+            confirmationId: receipt.receiptId,
+            payloadHash: contractApplyPayloadHash(current),
+        }, deps.bootToken.confirmationToken);
         if (!check.ok) {
-            sendJson(res, 403, { ok: false, error: { code: check.code, message: check.message } });
+            sendJson(res, 403, {
+                ok: false,
+                error: { code: check.code, message: check.message },
+            });
             return;
         }
         const reserved = await receipts.tryReserve(receiptId);
         if (!reserved.ok) {
-            sendJson(res, reserved.code === "NOT_FOUND" ? 404 : reserved.code === "EXPIRED" ? 410 : 409, {
+            sendJson(res, reserved.code === "NOT_FOUND"
+                ? 404
+                : reserved.code === "EXPIRED"
+                    ? 410
+                    : 409, {
                 ok: false,
                 error: { code: reserved.code, message: reserved.message },
             });
@@ -1209,7 +1723,12 @@ async function handleContractApplyHumanGate(req, res, deps, sessionId, step) {
                 ok: true,
                 card,
                 result: operationId
-                    ? { operationId, state: "accepted", action: "contractApply", clientRequestId: `chat-apply-${receiptId}` }
+                    ? {
+                        operationId,
+                        state: "accepted",
+                        action: "contractApply",
+                        clientRequestId: `chat-apply-${receiptId}`,
+                    }
                     : { state: reserved.reason },
             });
             return;
@@ -1233,55 +1752,110 @@ async function handleContractApplyHumanGate(req, res, deps, sessionId, step) {
         }
         const operationId = result.kind === "accepted" ? result.body.operationId : undefined;
         await receipts.markDispatched(receiptId, operationId);
-        const card = makeHumanGateCard({ cardId: `contract-${receiptId}`, gateType: "contract-apply", state: "dispatched", taskId: receipt.taskId, receiptId, expiresAt: receipt.expiresAt, contractRevision: receipt.revision, operationId, inspectHref: operationId ? `/inspect/?operationId=${encodeURIComponent(operationId)}#/` : `/inspect/?taskId=${encodeURIComponent(receipt.taskId)}#/` });
+        const card = makeHumanGateCard({
+            cardId: `contract-${receiptId}`,
+            gateType: "contract-apply",
+            state: "dispatched",
+            taskId: receipt.taskId,
+            receiptId,
+            expiresAt: receipt.expiresAt,
+            contractRevision: receipt.revision,
+            operationId,
+            inspectHref: operationId
+                ? `/inspect/?operationId=${encodeURIComponent(operationId)}#/`
+                : `/inspect/?taskId=${encodeURIComponent(receipt.taskId)}#/`,
+        });
         appendHumanGateCard(deps, sessionId, card);
         if (operationId)
-            await deps.operationLinker.link({ sessionId, turnId: deps.events.latestTurnId(sessionId) ?? "human-gate", toolCallId: "human-contract-apply", operationId });
-        sendJson(res, result.status, { ok: true, card, result: actionResultBody(result) });
+            await deps.operationLinker.link({
+                sessionId,
+                turnId: deps.events.latestTurnId(sessionId) ?? "human-gate",
+                toolCallId: "human-contract-apply",
+                operationId,
+            });
+        sendJson(res, result.status, {
+            ok: true,
+            card,
+            result: actionResultBody(result),
+        });
     }
     catch (error) {
-        sendJson(res, 400, { ok: false, error: { code: "HUMAN_GATE_FAILED", message: error instanceof Error ? error.message : String(error) } });
+        sendJson(res, 400, {
+            ok: false,
+            error: {
+                code: "HUMAN_GATE_FAILED",
+                message: error instanceof Error ? error.message : String(error),
+            },
+        });
     }
 }
 async function handleDagHumanGate(req, res, deps, sessionId, step) {
     const gate = gateMutation(req, deps);
     if (!gate.ok) {
-        sendJson(res, gate.status, { ok: false, error: { code: gate.code, message: gate.message } });
+        sendJson(res, gate.status, {
+            ok: false,
+            error: { code: gate.code, message: gate.message },
+        });
         return;
     }
-    if (!await requireChatSession(res, deps, sessionId))
+    if (!(await requireChatSession(res, deps, sessionId)))
         return;
     const ctx = deps.runtime.actionContext;
     if (!ctx) {
-        sendJson(res, 503, { ok: false, error: { code: "CHAT_NO_ACTION_CONTEXT", message: "Chat runtime has no operator action context wired" } });
+        sendJson(res, 503, {
+            ok: false,
+            error: {
+                code: "CHAT_NO_ACTION_CONTEXT",
+                message: "Chat runtime has no operator action context wired",
+            },
+        });
         return;
     }
     try {
         const body = await readJsonBody(req);
-        const action = step === "prepare" ? "prepareDagConfirmation" : step === "confirm" ? "confirmDagConfirmation" : "runDag";
+        const action = step === "prepare"
+            ? "prepareDagConfirmation"
+            : step === "confirm"
+                ? "confirmDagConfirmation"
+                : "runDag";
         const result = await dispatchOperatorAction(ctx, {
             action,
             actionParams: body,
-            clientRequestId: typeof body.clientRequestId === "string" ? body.clientRequestId : `chat-${sessionId}-${Date.now()}`,
+            clientRequestId: typeof body.clientRequestId === "string"
+                ? body.clientRequestId
+                : `chat-${sessionId}-${Date.now()}`,
         });
         if (result.kind === "error") {
             sendJson(res, result.status, result.body);
             return;
         }
         const projected = actionResultBody(result);
-        const confirmation = (projected.confirmation ?? await ctx.confirmations.get(String(body.confirmationId ?? "")));
+        const confirmation = (projected.confirmation ??
+            (await ctx.confirmations.get(String(body.confirmationId ?? ""))));
         const confirmationId = String(confirmation?.confirmationId ?? body.confirmationId ?? "");
         const taskBinding = confirmation?.taskContractBinding;
         const taskId = String(taskBinding?.taskId ?? body.taskId ?? "");
-        const state = step === "prepare" ? "prepared" : step === "confirm" ? "confirmed" : "dispatched";
+        const state = step === "prepare"
+            ? "prepared"
+            : step === "confirm"
+                ? "confirmed"
+                : "dispatched";
         const operationId = result.kind === "accepted" ? result.body.operationId : undefined;
-        const dagText = typeof body.dagText === "string" ? body.dagText : typeof body.dagJson === "string" ? body.dagJson : "";
+        const dagText = typeof body.dagText === "string"
+            ? body.dagText
+            : typeof body.dagJson === "string"
+                ? body.dagJson
+                : "";
         let dagSpine;
         try {
             const parsed = JSON.parse(dagText);
-            dagSpine = parsed.nodes?.map((node) => String(node.id ?? "")).filter(Boolean);
+            dagSpine = parsed.nodes
+                ?.map((node) => String(node.id ?? ""))
+                .filter(Boolean);
+        }
+        catch {
+            /* display summary is optional */
         }
-        catch { /* display summary is optional */ }
         const card = makeHumanGateCard({
             cardId: `dag-${confirmationId}`,
             gateType: "dag-run",
@@ -1289,26 +1863,48 @@ async function handleDagHumanGate(req, res, deps, sessionId, step) {
             taskId,
             confirmationId,
             expiresAt: String(confirmation?.expiresAt ?? new Date().toISOString()),
-            inspectHref: operationId ? `/inspect/?operationId=${encodeURIComponent(operationId)}#/` : `/inspect/?taskId=${encodeURIComponent(taskId)}#/`,
-            ...(confirmation?.humanGateToken ? { humanGateToken: confirmation.humanGateToken } : {}),
-            displayOnlyChallenges: Array.isArray(projected.requiredChallenges) ? projected.requiredChallenges.map(String) : undefined,
-            contractRevision: typeof taskBinding?.revision === "number" ? taskBinding.revision : undefined,
+            inspectHref: operationId
+                ? `/inspect/?operationId=${encodeURIComponent(operationId)}#/`
+                : `/inspect/?taskId=${encodeURIComponent(taskId)}#/`,
+            ...(confirmation?.humanGateToken
+                ? { humanGateToken: confirmation.humanGateToken }
+                : {}),
+            displayOnlyChallenges: Array.isArray(projected.requiredChallenges)
+                ? projected.requiredChallenges.map(String)
+                : undefined,
+            contractRevision: typeof taskBinding?.revision === "number"
+                ? taskBinding.revision
+                : undefined,
             dagSpine,
             operationId,
         });
         appendHumanGateCard(deps, sessionId, card);
         if (operationId)
-            await deps.operationLinker.link({ sessionId, turnId: deps.events.latestTurnId(sessionId) ?? "human-gate", toolCallId: `human-${step}`, operationId });
+            await deps.operationLinker.link({
+                sessionId,
+                turnId: deps.events.latestTurnId(sessionId) ?? "human-gate",
+                toolCallId: `human-${step}`,
+                operationId,
+            });
         sendJson(res, result.status, { ok: true, card, result: projected });
     }
     catch (error) {
-        sendJson(res, 400, { ok: false, error: { code: "HUMAN_GATE_FAILED", message: error instanceof Error ? error.message : String(error) } });
+        sendJson(res, 400, {
+            ok: false,
+            error: {
+                code: "HUMAN_GATE_FAILED",
+                message: error instanceof Error ? error.message : String(error),
+            },
+        });
     }
 }
 async function handleMutationHumanGate(req, res, deps, sessionId) {
     const gate = gateMutation(req, deps);
     if (!gate.ok) {
-        sendJson(res, gate.status, { ok: false, error: { code: gate.code, message: gate.message } });
+        sendJson(res, gate.status, {
+            ok: false,
+            error: { code: gate.code, message: gate.message },
+        });
         return;
     }
     if (!(await requireChatSession(res, deps, sessionId)))
@@ -1333,7 +1929,10 @@ async function handleMutationHumanGate(req, res, deps, sessionId) {
         if (!receipt || receipt.operatorSessionId !== ctx.operatorSessionId) {
             sendJson(res, 404, {
                 ok: false,
-                error: { code: "NOT_FOUND", message: "mutation gate receipt not found" },
+                error: {
+                    code: "NOT_FOUND",
+                    message: "mutation gate receipt not found",
+                },
             });
             return;
         }
@@ -1372,7 +1971,11 @@ async function handleMutationHumanGate(req, res, deps, sessionId) {
                 operationId,
             });
         }
-        sendJson(res, result.status, { ok: true, card, result: actionResultBody(result) });
+        sendJson(res, result.status, {
+            ok: true,
+            card,
+            result: actionResultBody(result),
+        });
     }
     catch (error) {
         sendJson(res, 400, {
@@ -1387,43 +1990,80 @@ async function handleMutationHumanGate(req, res, deps, sessionId) {
 async function handleConfirmTaskKind(req, res, deps, sessionId, interviewSessionId) {
     const gate = gateMutation(req, deps);
     if (!gate.ok) {
-        sendJson(res, gate.status, { ok: false, error: { code: gate.code, message: gate.message } });
+        sendJson(res, gate.status, {
+            ok: false,
+            error: { code: gate.code, message: gate.message },
+        });
         return;
     }
-    if (!await requireChatSession(res, deps, sessionId))
+    if (!(await requireChatSession(res, deps, sessionId)))
         return;
     try {
         const body = await readJsonBody(req);
         if (typeof body.taskKind !== "string" || !body.taskKind.trim()) {
-            sendJson(res, 400, { ok: false, error: { code: "INVALID_INPUT", message: "taskKind is required" } });
+            sendJson(res, 400, {
+                ok: false,
+                error: { code: "INVALID_INPUT", message: "taskKind is required" },
+            });
             return;
         }
-        const state = await new ChatInterviewAdapter(deps.appData, deps.events).confirmTaskKind({ operatorSessionId: sessionId, interviewSessionId, taskKind: body.taskKind });
+        const state = await new ChatInterviewAdapter(deps.appData, deps.events).confirmTaskKind({
+            operatorSessionId: sessionId,
+            interviewSessionId,
+            taskKind: body.taskKind,
+        });
         sendJson(res, 200, { ok: true, ...projectChatInterviewState(state) });
     }
     catch (error) {
-        sendJson(res, 400, { ok: false, error: { code: "TASK_KIND_CONFIRM_FAILED", message: error instanceof Error ? error.message : String(error) } });
+        sendJson(res, 400, {
+            ok: false,
+            error: {
+                code: "TASK_KIND_CONFIRM_FAILED",
+                message: error instanceof Error ? error.message : String(error),
+            },
+        });
     }
 }
 export async function handleChatCompact(req, res, deps, sessionId) {
     const gate = gateMutation(req, deps);
     if (!gate.ok) {
-        sendJson(res, gate.status, { ok: false, error: { code: gate.code, message: gate.message } });
+        sendJson(res, gate.status, {
+            ok: false,
+            error: { code: gate.code, message: gate.message },
+        });
         return;
     }
     if (deps.events.getActiveTurn(sessionId)) {
-        sendJson(res, 409, { ok: false, error: { code: "TURN_ACTIVE", message: "cannot compact an active turn" } });
+        sendJson(res, 409, {
+            ok: false,
+            error: { code: "TURN_ACTIVE", message: "cannot compact an active turn" },
+        });
         return;
     }
     const record = await deps.store.get(sessionId);
     if (!record) {
-        sendJson(res, 404, { ok: false, error: { code: "NOT_FOUND", message: `chat session not found: ${sessionId}` } });
+        sendJson(res, 404, {
+            ok: false,
+            error: {
+                code: "NOT_FOUND",
+                message: `chat session not found: ${sessionId}`,
+            },
+        });
         return;
     }
     if (!deps.runtime.hasSession(sessionId)) {
-        const reopened = await deps.runtime.reopenSession({ sessionId, sessionFile: record.sessionFile, ...(record.modelProvider && record.modelId ? { model: { provider: record.modelProvider, modelId: record.modelId } } : {}) });
+        const reopened = await deps.runtime.reopenSession({
+            sessionId,
+            sessionFile: record.sessionFile,
+            ...(record.modelProvider && record.modelId
+                ? { model: { provider: record.modelProvider, modelId: record.modelId } }
+                : {}),
+        });
         if (!reopened.ok) {
-            sendJson(res, 409, { ok: false, error: { code: reopened.code, message: reopened.message } });
+            sendJson(res, 409, {
+                ok: false,
+                error: { code: reopened.code, message: reopened.message },
+            });
             return;
         }
     }
@@ -1443,11 +2083,20 @@ export async function handleChatCompact(req, res, deps, sessionId) {
 export async function handleChatMessages(res, deps, sessionId, url) {
     try {
         const limit = Number(url.searchParams.get("limit") ?? 30);
-        const page = await deps.store.listMessages(sessionId, { limit: Number.isFinite(limit) ? limit : 30, beforeId: url.searchParams.get("beforeId") ?? undefined });
+        const page = await deps.store.listMessages(sessionId, {
+            limit: Number.isFinite(limit) ? limit : 30,
+            beforeId: url.searchParams.get("beforeId") ?? undefined,
+        });
         sendJson(res, 200, { ok: true, ...page });
     }
     catch (error) {
-        sendJson(res, 404, { ok: false, error: { code: "NOT_FOUND", message: error instanceof Error ? error.message : String(error) } });
+        sendJson(res, 404, {
+            ok: false,
+            error: {
+                code: "NOT_FOUND",
+                message: error instanceof Error ? error.message : String(error),
+            },
+        });
     }
 }
 /**
@@ -1457,28 +2106,46 @@ export async function handleChatMessages(res, deps, sessionId, url) {
 export async function handleChatRequest(req, res, deps, pathname) {
     if (!deps)
         return false;
-    if (!pathname.startsWith("/api/operator/v1/chat/") && !pathname.startsWith("/api/operator/v1/pi/"))
+    if (!pathname.startsWith("/api/operator/v1/chat/") &&
+        !pathname.startsWith("/api/operator/v1/pi/"))
         return false;
     const method = (req.method ?? "GET").toUpperCase();
     const url = new URL(req.url ?? "/", "http://localhost");
-    if (pathname === "/api/operator/v1/pi/models-config/test" && method === "POST") {
+    if (pathname === "/api/operator/v1/pi/models-config/test" &&
+        method === "POST") {
         const gate = gateMutation(req, deps);
         if (!gate.ok) {
-            sendJson(res, gate.status, { ok: false, error: { code: gate.code, message: gate.message } });
+            sendJson(res, gate.status, {
+                ok: false,
+                error: { code: gate.code, message: gate.message },
+            });
             return true;
         }
         try {
             const body = await readJsonBody(req);
             if (typeof body.provider !== "string" || typeof body.modelId !== "string")
                 throw new Error("provider and modelId are required");
-            sendJson(res, 200, { ok: true, data: await deps.runtime.testConfiguredModel({ provider: body.provider, modelId: body.modelId }) });
+            sendJson(res, 200, {
+                ok: true,
+                data: await deps.runtime.testConfiguredModel({
+                    provider: body.provider,
+                    modelId: body.modelId,
+                }),
+            });
         }
         catch (error) {
-            sendJson(res, 400, { ok: false, error: { code: "MODEL_TEST_FAILED", message: error instanceof Error ? error.message : String(error) } });
+            sendJson(res, 400, {
+                ok: false,
+                error: {
+                    code: "MODEL_TEST_FAILED",
+                    message: error instanceof Error ? error.message : String(error),
+                },
+            });
         }
         return true;
     }
-    if (pathname === "/api/operator/v1/pi/models-config" && (method === "GET" || method === "PATCH")) {
+    if (pathname === "/api/operator/v1/pi/models-config" &&
+        (method === "GET" || method === "PATCH")) {
         await handlePiConfig(req, res, deps, "models");
         return true;
     }
@@ -1486,11 +2153,13 @@ export async function handleChatRequest(req, res, deps, pathname) {
         await handlePiConfig(req, res, deps, "packages");
         return true;
     }
-    if (pathname === "/api/operator/v1/chat/instruction-skills" && method === "GET") {
+    if (pathname === "/api/operator/v1/chat/instruction-skills" &&
+        method === "GET") {
         await handlePiConfig(req, res, deps, "skills");
         return true;
     }
-    if (pathname === "/api/operator/v1/chat/instruction-skills/preferences" && method === "PUT") {
+    if (pathname === "/api/operator/v1/chat/instruction-skills/preferences" &&
+        method === "PUT") {
         await handlePiConfig(req, res, deps, "skills");
         return true;
     }
@@ -1505,7 +2174,10 @@ export async function handleChatRequest(req, res, deps, pathname) {
     if (method === "GET" && pathname === "/api/operator/v1/chat/repo/file") {
         const filePath = url.searchParams.get("path");
         if (!filePath)
-            sendJson(res, 400, { ok: false, error: { code: "INVALID_PATH", message: "path is required" } });
+            sendJson(res, 400, {
+                ok: false,
+                error: { code: "INVALID_PATH", message: "path is required" },
+            });
         else
             await handleRepoBrowser(res, deps, "file", filePath);
         return true;
@@ -1629,6 +2301,11 @@ export async function handleChatRequest(req, res, deps, pathname) {
         await handleGetTaskContext(req, res, deps, decodeURIComponent(sessionContext[1]));
         return true;
     }
+    const sessionState = pathname.match(/^\/api\/operator\/v1\/chat\/sessions\/([^/]+)\/state$/);
+    if (method === "GET" && sessionState) {
+        await handleGetChatSessionState(req, res, deps, decodeURIComponent(sessionState[1]));
+        return true;
+    }
     const sessionEvents = pathname.match(/^\/api\/operator\/v1\/chat\/sessions\/([^/]+)\/events$/);
     if (method === "GET" && sessionEvents) {
         await handleChatEventsStream(req, res, deps, decodeURIComponent(sessionEvents[1]));
@@ -1662,7 +2339,10 @@ export async function handleChatRequest(req, res, deps, pathname) {
         });
         return true;
     }
-    sendJson(res, 404, { ok: false, error: { code: "NOT_FOUND", message: `unknown chat route: ${pathname}` } });
+    sendJson(res, 404, {
+        ok: false,
+        error: { code: "NOT_FOUND", message: `unknown chat route: ${pathname}` },
+    });
     return true;
 }
 // Re-export for route wiring; writeSseEvent kept for parity with operation-sse.