[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10,"_11":12},"actionData","errors","root",{"_229":-5,"_232":233,"_234":235},"routes/shell",{"_42":43,"_228":-5,"_229":-5,"_230":231},"routes/repo",{"_33":-7,"_34":35,"_36":37,"_38":39,"_40":41,"_42":43,"_44":31,"_45":31,"_46":31,"_47":31,"_48":31,"_49":31,"_50":51,"_52":51,"_53":31,"_54":-7,"_55":-7,"_56":57,"_58":59,"_60":61,"_62":-5,"_63":64,"_65":66,"_67":68,"_69":70},"routes/repo.blob",{"_13":14,"_15":16,"_17":18,"_19":20,"_21":14,"_22":23,"_24":-5,"_25":26,"_27":28,"_28":29,"_30":31,"_32":14},"ref","bbd08196498a5f63070bcf73c5d6cb2f1c28dda9","path","apps/server/src/chat/service.ts","oid","b72a50f44528b07e1bea8fa2ff10e4bdf76a9b2f","size",50060,"commit","mounts",[],"source","plain",{"_13":14,"_15":16},"kind","text","/**\n * Chat.\n *\n * One transcript per room, shared by everyone in it, and one turn at a time.\n * Messages that address the agent are queued rather than refused while it is\n * working: the plan belongs to the agent for the length of a turn, but the\n * Chat does not, and silencing somebody because a colleague prompted\n * first is a poor way to run a room with two people in it.\n *\n * Messages that do not address it are ordinary conversation. They are carried\n * into the next turn as context rather than starting one, so people can decide\n * something between themselves and the agent turns up already knowing.\n *\n * Every message reaching the model is prefixed with its author's handle. The\n * agent is planning with a group, and \"Alice prefers X, but Bob raised Y\" is\n * the kind of thing it has to be able to say back.\n */\n\nimport { createHash } from \"node:crypto\";\n\nimport { ulid } from \"@chopin/dialect\";\n\nimport * as Agent from \"../agent/client\";\nimport { toCopilotTools } from \"../agent/copilot-bridge\";\nimport { repositoryTools } from \"../agent/repository\";\nimport { type DocumentRoom, documentTools, type ResearchWorkspaceRequest } from \"../agent/tools\";\nimport * as Service from \"../plan/service\";\nimport { instruction } from \"@chopin/protocol/address\";\n\nimport { annotatedText, compose, referenceCatalog, remember } from \"./address\";\nimport { broadcast, fail, reply, tell } from \"../wire\";\n\nimport type { Server } from \"bun\";\nimport type { SessionEvent } from \"@github/copilot-sdk\";\nimport type { Chat as Wire, Request } from \"@chopin/protocol\";\nimport type { Config } from \"../config\";\nimport type { HostedAuth } from \"../auth/routes\";\nimport type { HostedRepository } from \"../agent/repository\";\nimport type { JobService } from \"../jobs/service\";\nimport type { Plan } from \"../plan/service\";\nimport type { Said } from \"./address\";\nimport type { ReferenceService } from \"./references\";\nimport type { Socket, SocketData } from \"../wire\";\n\n/** Beyond this the queue is a backlog nobody is going to read. */\nconst MAX_QUEUE = 20;\nconst MAX_PENDING_SENDS = 20;\nconst MAX_MESSAGE_BYTES = 64 * 1024;\nconst MAX_SESSION_REFERENCES = 50;\nconst REQUEST_ID = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;\nconst FINGERPRINT = /^sha256:[0-9a-f]{64}$/;\n\ntype Delivery = {\n\tdestination: Wire.Destination;\n\trequestFingerprint: string;\n\tcanonicalFingerprint: string;\n};\n\ntype MemberEntry = Wire.Entry & { delivery?: Delivery };\n\n/** How long the agent's cursor stays where it finished, after a turn ends. */\nconst LINGER_MS = 5_000;\nconst CREDENTIAL_EXPIRY_SKEW_MS = 60_000;\n\n/**\n * A queued message, with what the queue needs and clients do not.\n *\n * `spent` is asked, just before the turn would run, whether somebody else has\n * already done the work. It is a function rather than a flag because the answer\n * is only knowable at that moment — and `JSON.stringify` drops it, so the wire\n * shape stays exactly `Wire.Waiting`.\n */\ntype Waiting = Wire.Waiting & {\n\tdelivery?: Delivery;\n\tspent?: () => boolean;\n\t/** True when this came from the composer rather than another instruction. */\n\tmessage?: boolean;\n\t/** The comment thread this turn was started to act on, if one was. */\n\tthread?: string;\n\t/** Login session whose Copilot entitlement owns this queued turn. */\n\tsessionId?: string;\n\t/** Verified member identity, retained only for a queued composer message. */\n\tuserId?: string;\n};\n\nexport type ActiveMemberRequest = {\n\tentryId: string;\n\tuserId: string;\n\thandle: string;\n\ttext: string;\n\tclaimantSessionId: string;\n\tturnId: string;\n\tlifecycle: number;\n};\n\ntype MemberRequest = Pick;\n\n/** What a turn other than a message needs to say about itself. */\nexport type Instruction = {\n\tspent?: () => boolean;\n\tthread?: string;\n};\n\nexport type Chat = {\n\tentries: Wire.Entry[];\n\twaiting: Waiting[];\n\t/** Serializes complete member send acceptance, including asynchronous resolution and persistence. */\n\tsending: Promise;\n\t/** Work admitted to the send FIFO, including the operation currently resolving. */\n\tpendingSends: number;\n\t/** The Copilot session, once somebody has prompted. */\n\tagent?: Agent.Agent;\n\t/** In flight while the session is being opened, so a second prompt waits. */\n\topening?: Promise;\n\topeningOwner?: { sessionId: string; generation: number; revision: number };\n\t/** Fences an SDK session that finishes opening after it was invalidated. */\n\tlifecycle: number;\n\t/** Complete top-level turn lifecycle, including queued turns. */\n\trunning?: Promise;\n\tclosed: boolean;\n\tbusy: boolean;\n\t/** The transient lifecycle of the running Planner turn. */\n\tturn?: Wire.Turn;\n\t/** Private provenance for the member message driving only the current turn. */\n\tactiveRequest?: ActiveMemberRequest;\n\t/**\n\t * The comment thread the running turn is acting on.\n\t *\n\t * Read by `edit_plan`, so the prose a turn writes can be recorded as what\n\t * that decision produced even when the agent forgets to say so itself.\n\t */\n\tacting?: string;\n\t/** The entry the agent is currently writing into. */\n\twriting?: string;\n\t/** The dedicated entry collecting tool calls for this turn. */\n\ttooling?: string;\n\t/** Detaches the event handler when a turn ends. */\n\trelease?: () => void;\n\t/** Ends a turn when reset destroys the SDK session before it emits idle. */\n\tfinishTurn?: () => void;\n\t/** Pending removal of the agent's cursor, cancelled if it edits again. */\n\tlingering?: ReturnType;\n\t/** When each running tool call started, for its duration. */\n\ttimings: Map;\n\t/** First-invoker ownership, fenced by storage generation. */\n\towner?: { sessionId: string; generation: number; revision: number; expiresAt: number };\n\t/** Stops a disposable SDK session shortly before its copied token expires. */\n\tcredentialTimer?: ReturnType;\n\t/** User-facing reason an in-flight turn was interrupted. */\n\tinterruption?: string;\n\t/** Durable context prepended once after recreating a hosted SDK session. */\n\tbootstrap?: string;\n\t/** Backscroll entries already represented by an opening session's bootstrap. */\n\tbootstrapEntries?: Set;\n\t/** References available to `read_reference` in the active SDK session. */\n\treferenceCache: Map;\n\t/**\n\t * What the room has said since the agent last ran.\n\t *\n\t * Deliberately not persisted: a conversation the agent never saw has no\n\t * claim on surviving a restart, and replaying it later would be stranger\n\t * than losing it.\n\t */\n\tbackscroll: Said[];\n};\n\nexport function create(): Chat {\n\treturn {\n\t\tentries: [],\n\t\twaiting: [],\n\t\tsending: Promise.resolve(),\n\t\tpendingSends: 0,\n\t\tbusy: false,\n\t\tlifecycle: 0,\n\t\tclosed: false,\n\t\ttimings: new Map(),\n\t\treferenceCache: new Map(),\n\t\tbackscroll: [],\n\t};\n}\n\n/**\n * Come back with what was said before.\n *\n * An entry that was still streaming when the process went away never finished,\n * so the flag is cleared: it is as complete as it is ever going to be, and\n * leaving it set would show a spinner nothing will ever stop.\n */\nexport function restore(entries: Wire.Entry[]): Chat {\n\treturn {\n\t\tentries: entries.map(entry => {\n\t\t\tlet { streaming: _streaming, ...rest } = entry;\n\t\t\treturn rest;\n\t\t}),\n\t\twaiting: [],\n\t\tsending: Promise.resolve(),\n\t\tpendingSends: 0,\n\t\tbusy: false,\n\t\tlifecycle: 0,\n\t\tclosed: false,\n\t\ttimings: new Map(),\n\t\treferenceCache: new Map(),\n\t\tbackscroll: [],\n\t};\n}\n\nfunction now(): number {\n\treturn Math.floor(Date.now() / 1000);\n}\n\nfunction digest(value: string): string {\n\treturn `sha256:${createHash(\"sha256\").update(value).digest(\"hex\")}`;\n}\n\nfunction requestFingerprint(msg: Request, principalId: string): string {\n\tlet references = Array.isArray(msg.references)\n\t\t? msg.references.map(value => {\n\t\t\tif (!value || typeof value !== \"object\" || Array.isArray(value)) return value;\n\t\t\tlet item = value as unknown as Record;\n\t\t\treturn Object.keys(item).sort().map(key => [key, item[key]]);\n\t\t})\n\t\t: msg.references ?? [];\n\treturn digest(JSON.stringify([principalId, msg.to, msg.text, references]));\n}\n\nfunction canonicalFingerprint(\n\tdestination: Wire.Destination,\n\ttext: string,\n\treferences: Wire.Reference[] = [],\n): string {\n\tlet targets = references.map(reference =>\n\t\treference.kind === \"document\"\n\t\t\t? [\n\t\t\t\treference.kind,\n\t\t\t\treference.id,\n\t\t\t\treference.start,\n\t\t\t\treference.end,\n\t\t\t\treference.label,\n\t\t\t\treference.href,\n\t\t\t\treference.repositoryId,\n\t\t\t\treference.observedRevision,\n\t\t\t\treference.channelId,\n\t\t\t\treference.observedSourceHash,\n\t\t\t]\n\t\t\t: [\n\t\t\t\treference.kind,\n\t\t\t\treference.id,\n\t\t\t\treference.start,\n\t\t\t\treference.end,\n\t\t\t\treference.label,\n\t\t\t\treference.href,\n\t\t\t\treference.repositoryId,\n\t\t\t\treference.observedRevision,\n\t\t\t\treference.parentChannelId,\n\t\t\t\treference.workspaceId,\n\t\t\t]\n\t);\n\treturn digest(JSON.stringify([destination, text, targets]));\n}\n\nfunction delivery(\n\tdestination: Wire.Destination,\n\trequest: string,\n\ttext: string,\n\treferences: Wire.Reference[] = [],\n): Delivery {\n\treturn {\n\t\tdestination,\n\t\trequestFingerprint: request,\n\t\tcanonicalFingerprint: canonicalFingerprint(destination, text, references),\n\t};\n}\n\nfunction publicEntry(value: Wire.Entry): Wire.Entry {\n\tlet { delivery: _delivery, ...entry } = value as MemberEntry;\n\treturn entry;\n}\n\nexport function validateDelivery(entry: Wire.Entry): void {\n\tlet saved = (entry as MemberEntry).delivery;\n\tif (saved === undefined) return;\n\tlet keys = saved && typeof saved === \"object\" && !Array.isArray(saved)\n\t\t? Object.keys(saved).sort()\n\t\t: [];\n\tif (\n\t\tentry.author.kind !== \"member\" || !REQUEST_ID.test(entry.id)\n\t\t|| keys.length !== 3\n\t\t|| keys[0] !== \"canonicalFingerprint\"\n\t\t|| keys[1] !== \"destination\"\n\t\t|| keys[2] !== \"requestFingerprint\"\n\t\t|| (saved.destination !== \"room\" && saved.destination !== \"planner\")\n\t\t|| typeof saved.requestFingerprint !== \"string\" || !FINGERPRINT.test(saved.requestFingerprint)\n\t\t|| typeof saved.canonicalFingerprint !== \"string\"\n\t\t|| !FINGERPRINT.test(saved.canonicalFingerprint)\n\t\t|| saved.canonicalFingerprint\n\t\t\t!== canonicalFingerprint(saved.destination, entry.text, entry.references)\n\t) throw new Error(\"hosted channel has invalid chat delivery metadata\");\n}\n\nfunction replay(\n\tchat: Chat,\n\tws: Socket,\n\tmsg: Request,\n\trequestId: string,\n\tfingerprint: string,\n): boolean {\n\tlet entries = chat.entries.filter(entry => entry.id === requestId);\n\tlet waiting = chat.waiting.filter(item => item.id === requestId);\n\tif (entries.length === 0 && waiting.length === 0) return false;\n\tif (entries.length + waiting.length !== 1) {\n\t\tfail(ws, msg.rid, \"chat request id conflicts with existing state\");\n\t\treturn true;\n\t}\n\tlet entry = entries[0];\n\tlet queued = waiting[0];\n\tlet saved = entry ? (entry as MemberEntry).delivery : queued?.delivery;\n\ttry {\n\t\tif (entry) validateDelivery(entry);\n\t\telse if (\n\t\t\t!queued || !saved || !REQUEST_ID.test(queued.id)\n\t\t\t|| saved.canonicalFingerprint\n\t\t\t\t!== canonicalFingerprint(saved.destination, queued.text, queued.references)\n\t\t) throw new Error(\"invalid queued delivery metadata\");\n\t} catch {\n\t\tfail(ws, msg.rid, \"chat request id conflicts with existing state\");\n\t\treturn true;\n\t}\n\tif (!saved || saved.destination !== msg.to || saved.requestFingerprint !== fingerprint) {\n\t\tfail(ws, msg.rid, \"chat request id was reused with different content\");\n\t\treturn true;\n\t}\n\treply(ws, msg.rid, {\n\t\tkind: \"chat:send\",\n\t\tts: 0,\n\t\tid: (entry ?? queued)!.id,\n\t\tqueued: waiting.length === 1,\n\t});\n\treturn true;\n}\n\nfunction state(chat: Chat, server: Server, room: string): void {\n\tbroadcast(server, room, {\n\t\tkind: \"chat:state\",\n\t\tts: 0,\n\t\tbusy: chat.busy,\n\t\t...(chat.turn ? { turn: chat.turn } : {}),\n\t});\n}\n\n/** Only visible Planner prose ends the working projection. */\nfunction responded(chat: Chat, server: Server, room: string, text: string): void {\n\tif (!chat.turn || chat.turn.responded || !text.trim()) return;\n\tchat.turn.responded = true;\n\tstate(chat, server, room);\n}\n\n/**\n * The queue as clients see it.\n *\n * Internal queue metadata decides how and under whose authority a turn runs.\n * None of it belongs in the wire projection.\n */\nfunction visible(chat: Chat): Wire.Waiting[] {\n\treturn chat.waiting.map(({ handle, id, text, references }) => ({\n\t\thandle,\n\t\tid,\n\t\ttext,\n\t\t...(references?.length ? { references } : {}),\n\t}));\n}\n\nfunction queued(chat: Chat, server: Server, room: string): void {\n\tbroadcast(server, room, { kind: \"chat:queue\", ts: 0, waiting: visible(chat) });\n}\n\nfunction say(\n\tchat: Chat,\n\tserver: Server,\n\troom: string,\n\tentry: Wire.Entry,\n): Wire.Entry {\n\tchat.entries.push(entry);\n\tannounce(server, room, entry);\n\treturn entry;\n}\n\nfunction announce(server: Server, room: string, entry: Wire.Entry): void {\n\tbroadcast(server, room, { kind: \"chat:message\", ts: 0, entry: publicEntry(entry) });\n}\n\n/** Everything said so far, for somebody who has just arrived. */\nexport function greet(chat: Chat, ws: Socket): void {\n\ttell(ws, {\n\t\tkind: \"chat:history\",\n\t\tts: 0,\n\t\tentries: chat.entries.map(publicEntry),\n\t\tbusy: chat.busy,\n\t\t...(chat.turn ? { turn: chat.turn } : {}),\n\t\tqueued: visible(chat),\n\t});\n}\n\nexport type Room = {\n\tchat: Chat;\n\tplan: Plan;\n\tserver: Server;\n\troom: string;\n\tconfig: Config;\n\tauth: HostedAuth;\n\tclaimantSessionId: string;\n\trepository: HostedRepository;\n\tpersist: () => Promise;\n\townerAvailable?: () => Promise;\n\tjobs?: JobService;\n\treferences?: ReferenceService;\n\tcreateResearch?: (request: {\n\t\tentryId: string;\n\t\tuserId: string;\n\t\thandle: string;\n\t\ttext: string;\n\t\tquestion: string;\n\t}) => Promise;\n};\n\n/**\n * Take a message.\n *\n * A room message appears immediately. A planner message queued behind another\n * turn stays visibly queued until that turn actually begins, then moves into\n * the transcript exactly once. The destination, rather than its prose, decides\n * which lifecycle it takes.\n */\nexport function send(context: Room, ws: Socket, msg: Request): Promise {\n\tif (context.chat.pendingSends >= MAX_PENDING_SENDS) {\n\t\tfail(ws, msg.rid, \"too many chat messages are waiting to be processed\");\n\t\treturn Promise.resolve();\n\t}\n\tcontext.chat.pendingSends++;\n\tlet process = () => processSend(context, ws, msg);\n\tlet accepted = context.chat.sending.then(process, process);\n\tlet completed = accepted.finally(() => context.chat.pendingSends--);\n\tcontext.chat.sending = completed.then(() => {}, () => {});\n\treturn completed;\n}\n\nasync function processSend(context: Room, ws: Socket, msg: Request): Promise {\n\tlet { chat, room, server } = context;\n\tlet suppliedRequestId = (msg as Request & { requestId?: unknown }).requestId;\n\tif (\n\t\tsuppliedRequestId !== undefined && (\n\t\t\ttypeof suppliedRequestId !== \"string\" || !REQUEST_ID.test(suppliedRequestId)\n\t\t)\n\t) {\n\t\treturn fail(ws, msg.rid, \"chat request id must be a UUIDv4\");\n\t}\n\t// Pre-deploy browser tabs did not send request IDs. They keep legacy at-most-once behavior.\n\tlet requestId = suppliedRequestId ?? crypto.randomUUID();\n\tlet handle = ws.data.handle;\n\tlet destination = msg.to;\n\tif (destination !== \"room\" && destination !== \"planner\") {\n\t\treturn fail(ws, msg.rid, \"invalid message destination\");\n\t}\n\tif (typeof msg.text !== \"string\") return fail(ws, msg.rid, \"invalid message text\");\n\tif (Buffer.byteLength(msg.text) > MAX_MESSAGE_BYTES) {\n\t\treturn fail(ws, msg.rid, \"chat message exceeds the 64 KiB limit\");\n\t}\n\tlet request = requestFingerprint(msg, ws.data.principalId);\n\tif (replay(chat, ws, msg, requestId, request)) return;\n\tif (chat.closed) return fail(ws, msg.rid, \"chat is closed\");\n\tlet projected: { text: string; references?: Wire.Reference[] };\n\ttry {\n\t\tif (context.references) {\n\t\t\tprojected = await context.references.resolve({\n\t\t\t\tchannelId: room,\n\t\t\t\trepositoryId: context.repository.id,\n\t\t\t\ttext: msg.text,\n\t\t\t\tdestination,\n\t\t\t\trequests: msg.references,\n\t\t\t});\n\t\t} else {\n\t\t\tif (\n\t\t\t\tmsg.references !== undefined && (!Array.isArray(msg.references) || msg.references.length)\n\t\t\t) {\n\t\t\t\treturn fail(ws, msg.rid, \"chat references are unavailable\");\n\t\t\t}\n\t\t\tlet text = msg.text.trim();\n\t\t\tprojected = { text: destination === \"planner\" ? instruction(text) : text };\n\t\t}\n\t} catch {\n\t\treturn fail(ws, msg.rid, \"invalid or unavailable chat reference\");\n\t}\n\tlet text = projected.text;\n\tlet references = projected.references;\n\tif (!text) return fail(ws, msg.rid, \"message text is empty\");\n\tif (chat.closed) return fail(ws, msg.rid, \"chat is closed\");\n\tlet savedDelivery = delivery(destination, request, text, references);\n\n\tif (destination === \"room\") {\n\t\tlet entry: MemberEntry = {\n\t\t\tid: requestId,\n\t\t\tauthor: { kind: \"member\", handle },\n\t\t\ttext,\n\t\t\tts: now(),\n\t\t\t...(references?.length ? { references } : {}),\n\t\t\tdelivery: savedDelivery,\n\t\t};\n\t\tchat.entries.push(entry);\n\t\ttry {\n\t\t\tawait context.persist();\n\t\t} catch {\n\t\t\tchat.entries = chat.entries.filter(value => value.id !== entry.id);\n\t\t\treturn fail(ws, msg.rid, \"could not save message\");\n\t\t}\n\t\treply(ws, msg.rid, { kind: \"chat:send\", ts: 0, id: entry.id, queued: false });\n\t\tannounce(server, room, entry);\n\t\tchat.backscroll = remember(chat.backscroll, {\n\t\t\tentryId: entry.id,\n\t\t\thandle,\n\t\t\ttext,\n\t\t\t...(references?.length ? { references } : {}),\n\t\t});\n\t\treturn;\n\t}\n\tif (!context.config.agent) {\n\t\tlet entries: MemberEntry[] = [{\n\t\t\tid: requestId,\n\t\t\tauthor: { kind: \"member\", handle },\n\t\t\ttext,\n\t\t\tts: now(),\n\t\t\t...(references?.length ? { references } : {}),\n\t\t\tdelivery: savedDelivery,\n\t\t}, {\n\t\t\tid: ulid(),\n\t\t\tauthor: { kind: \"system\" },\n\t\t\ttext: \"The agent is not running, so the plan has not been revised.\",\n\t\t\tts: now(),\n\t\t}];\n\t\tchat.entries.push(...entries);\n\t\ttry {\n\t\t\tawait context.persist();\n\t\t} catch {\n\t\t\tlet ids = new Set(entries.map(entry => entry.id));\n\t\t\tchat.entries = chat.entries.filter(entry => !ids.has(entry.id));\n\t\t\treturn fail(ws, msg.rid, \"could not save message\");\n\t\t}\n\t\treply(ws, msg.rid, { kind: \"chat:send\", ts: 0, id: entries[0]!.id, queued: false });\n\t\tfor (let entry of entries) announce(server, room, entry);\n\t\treturn;\n\t}\n\n\tif (chat.busy) {\n\t\tif (chat.waiting.length >= MAX_QUEUE) {\n\t\t\tsay(chat, server, room, {\n\t\t\t\tid: ulid(),\n\t\t\t\tauthor: { kind: \"system\" },\n\t\t\t\ttext: \"The queue is full. Wait for the current turn to finish.\",\n\t\t\t\tts: now(),\n\t\t\t});\n\t\t\treturn fail(ws, msg.rid, \"the Planner queue is full\");\n\t\t}\n\t\tlet waiting: Waiting = {\n\t\t\tid: requestId,\n\t\t\thandle,\n\t\t\ttext,\n\t\t\t...(references?.length ? { references } : {}),\n\t\t\tdelivery: savedDelivery,\n\t\t\tmessage: true,\n\t\t\tsessionId: context.claimantSessionId,\n\t\t\tuserId: ws.data.principalId,\n\t\t};\n\t\tchat.waiting.push(waiting);\n\t\treply(ws, msg.rid, { kind: \"chat:send\", ts: 0, id: waiting.id, queued: true });\n\t\treturn queued(chat, server, room);\n\t}\n\n\tlet entry: MemberEntry = {\n\t\tid: requestId,\n\t\tauthor: { kind: \"member\", handle },\n\t\ttext,\n\t\tts: now(),\n\t\t...(references?.length ? { references } : {}),\n\t\tdelivery: savedDelivery,\n\t};\n\tchat.busy = true;\n\tchat.turn = { id: ulid(), handle, started: now(), responded: false };\n\tstate(chat, server, room);\n\tchat.entries.push(entry);\n\ttry {\n\t\tawait context.persist();\n\t} catch {\n\t\tchat.entries = chat.entries.filter(value => value.id !== entry.id);\n\t\tchat.busy = false;\n\t\tchat.turn = undefined;\n\t\tstate(chat, server, room);\n\t\treturn fail(ws, msg.rid, \"could not save message\");\n\t}\n\treply(ws, msg.rid, { kind: \"chat:send\", ts: 0, id: entry.id, queued: false });\n\tif (chat.closed) return;\n\tannounce(server, room, entry);\n\tstartRun(\n\t\tcontext,\n\t\thandle,\n\t\ttext,\n\t\tundefined,\n\t\tcontext.claimantSessionId,\n\t\ttrue,\n\t\t{ entryId: entry.id, userId: ws.data.principalId },\n\t\treferences,\n\t);\n}\n\n/** Say something in the transcript without asking the agent for anything. */\nexport function notice(context: Room, text: string): void | Promise {\n\tlet { chat, room, server } = context;\n\tlet entry: Wire.Entry = { id: ulid(), author: { kind: \"system\" }, text, ts: now() };\n\tchat.entries.push(entry);\n\treturn context.persist().then(() => announce(server, room, entry));\n}\n\n/**\n * Start a turn from something other than a message.\n *\n * Accepting a comment is an instruction in a way prose is not — the `@chopin` rule\n * exists to separate conversation from instruction, and a button press is\n * already the latter. What it is not is a thing anybody said, so the transcript\n * gets a system entry explaining why the agent started moving; an agent that\n * begins editing for no visible reason is worse than a noisy log.\n */\nexport function instruct(\n\tcontext: Room,\n\thandle: string,\n\ttext: string,\n\tsaid: string,\n\tabout: Instruction = {},\n): void | Promise {\n\tlet { chat, config, room, server } = context;\n\tlet proceed = (): void | Promise => {\n\t\tif (chat.closed) return;\n\t\t// `AGENT=off` runs the room without one. The decision that got here is\n\t\t// still a decision and is already recorded; only the turn is impossible,\n\t\t// and saying so beats a session failing to open.\n\t\tif (!config.agent) {\n\t\t\tlet entry: Wire.Entry = {\n\t\t\t\tid: ulid(),\n\t\t\t\tauthor: { kind: \"system\" },\n\t\t\t\ttext: \"The agent is not running, so the plan has not been revised.\",\n\t\t\t\tts: now(),\n\t\t\t};\n\t\t\tchat.entries.push(entry);\n\t\t\treturn context.persist().then(() => announce(server, room, entry));\n\t\t}\n\n\t\tif (chat.busy) {\n\t\t\tif (chat.waiting.length >= MAX_QUEUE) {\n\t\t\t\treturn void say(chat, server, room, {\n\t\t\t\t\tid: ulid(),\n\t\t\t\t\tauthor: { kind: \"system\" },\n\t\t\t\t\ttext: \"The queue is full. Wait for the current turn to finish.\",\n\t\t\t\t\tts: now(),\n\t\t\t\t});\n\t\t\t}\n\t\t\tchat.waiting.push({\n\t\t\t\tid: ulid(),\n\t\t\t\thandle,\n\t\t\t\ttext,\n\t\t\t\t...about,\n\t\t\t\tsessionId: context.claimantSessionId,\n\t\t\t});\n\t\t\treturn queued(chat, server, room);\n\t\t}\n\n\t\tstartRun(context, handle, text, about.thread, context.claimantSessionId);\n\t};\n\tlet announced = notice(context, said);\n\treturn announced instanceof Promise ? announced.then(proceed) : proceed();\n}\n\n/** Withdraw a queued message. Only whoever wrote it may. */\nexport function unqueue(context: Room, ws: Socket, msg: Request): void {\n\tlet { chat, room, server } = context;\n\tlet found = chat.waiting.find(item => item.id === msg.id);\n\tif (!found || found.handle !== ws.data.handle) return;\n\tchat.waiting = chat.waiting.filter(item => item.id !== msg.id);\n\tqueued(chat, server, room);\n}\n\n/** Stop the running turn. Anyone may, and the transcript says who did. */\nexport async function abort(context: Room, ws: Socket): Promise {\n\tlet { chat, room, server } = context;\n\tif (!chat.busy || !chat.agent) return;\n\n\tawait Agent.abort(chat.agent);\n\tsay(chat, server, room, {\n\t\tid: ulid(),\n\t\tauthor: { kind: \"system\" },\n\t\ttext: `@${ws.data.handle} stopped the turn.`,\n\t\tts: now(),\n\t});\n}\n\nfunction currentMemberRequest(chat: Chat): ActiveMemberRequest | undefined {\n\tlet active = chat.activeRequest;\n\tif (\n\t\t!active || chat.closed || !chat.busy || chat.lifecycle !== active.lifecycle\n\t\t|| chat.turn?.id !== active.turnId || !active.userId || !active.claimantSessionId\n\t) return undefined;\n\tlet entry = chat.entries.find(value => value.id === active.entryId);\n\tif (\n\t\tentry?.author.kind !== \"member\" || entry.author.handle !== active.handle\n\t\t|| entry.text !== active.text\n\t) return undefined;\n\treturn active;\n}\n\nexport function documentRoom(context: Room): DocumentRoom {\n\tlet { chat, plan, room, server } = context;\n\treturn {\n\t\tid: room,\n\t\tplan,\n\t\tserver,\n\t\tpublish: mutation => Service.publish(plan, server, room, mutation),\n\t\tpersist: context.persist,\n\t\texclusive: action => Service.exclusive(plan, action),\n\t\tanchors: () => Service.anchors(plan, server, room),\n\t\tchanges: found => Service.changes(plan, server, room, found),\n\t\tjobs: context.jobs,\n\t\treadReference: async (id, repositoryId) => {\n\t\t\tlet reference = chat.referenceCache.get(id);\n\t\t\tif (!reference) throw new Error(\"reference is not available in this Planner session\");\n\t\t\tif (!context.references) throw new Error(\"chat references are unavailable\");\n\t\t\treturn context.references.read({\n\t\t\t\tchannelId: room,\n\t\t\t\trepositoryId,\n\t\t\t\treference,\n\t\t\t});\n\t\t},\n\t\tcreateResearch: async _question => {\n\t\t\tlet active = currentMemberRequest(chat);\n\t\t\tif (!active) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t\"research workspaces require the explicit member message driving the current turn\",\n\t\t\t\t);\n\t\t\t}\n\t\t\tlet createResearch = context.createResearch;\n\t\t\tif (!createResearch) throw new Error(\"research workspaces are unavailable\");\n\t\t\treturn createResearch({\n\t\t\t\tentryId: active.entryId,\n\t\t\t\tuserId: active.userId,\n\t\t\t\thandle: active.handle,\n\t\t\t\ttext: active.text,\n\t\t\t\tquestion: active.text,\n\t\t\t});\n\t\t},\n\t};\n}\n\nexport function retainReferences(chat: Chat, references: Wire.Reference[]): void {\n\tfor (let reference of references) {\n\t\tchat.referenceCache.delete(reference.id);\n\t\tchat.referenceCache.set(reference.id, reference);\n\t\twhile (chat.referenceCache.size > MAX_SESSION_REFERENCES) {\n\t\t\tlet oldest = chat.referenceCache.keys().next().value;\n\t\t\tif (typeof oldest !== \"string\") break;\n\t\t\tchat.referenceCache.delete(oldest);\n\t\t}\n\t}\n}\n\nexport function sessionBootstrap(\n\tchat: Chat,\n\tcursor: number,\n\tsummary: string,\n\tcurrentEntryId?: string,\n\tcurrentReferences: Wire.Reference[] = [],\n): string | undefined {\n\tlet start = Number.isSafeInteger(cursor) && cursor >= 0 && cursor <= chat.entries.length\n\t\t? cursor\n\t\t: 0;\n\tlet candidates = chat.entries.slice(start)\n\t\t.filter(entry => entry.id !== currentEntryId)\n\t\t.slice(-100);\n\tlet allReferenceIds = new Set(\n\t\tcandidates.flatMap(entry => entry.references?.map(reference => reference.id) ?? []),\n\t);\n\tlet line = (entry: Wire.Entry, readable: Set) => {\n\t\tlet speaker = entry.author.kind === \"member\"\n\t\t\t? `@${entry.author.handle}`\n\t\t\t: entry.author.kind === \"agent\"\n\t\t\t? \"Planner\"\n\t\t\t: \"System\";\n\t\treturn `${speaker}: ${annotatedText(entry.text, entry.references, readable)}`;\n\t};\n\tlet selected: Wire.Entry[] = [];\n\tlet used = 0;\n\tlet partial = false;\n\tfor (let entry of candidates.toReversed()) {\n\t\tlet rendered = line(entry, allReferenceIds);\n\t\tlet separator = selected.length > 0 ? 1 : 0;\n\t\tif (used + separator + rendered.length > 50_000) {\n\t\t\tif (selected.length === 0) {\n\t\t\t\tselected.unshift(entry);\n\t\t\t\tpartial = true;\n\t\t\t}\n\t\t\tbreak;\n\t\t}\n\t\tselected.unshift(entry);\n\t\tused += separator + rendered.length;\n\t}\n\tlet selectedIds = new Set(selected.map(entry => entry.id));\n\tlet remainingBackscroll = chat.backscroll.filter(said =>\n\t\t!said.entryId || !selectedIds.has(said.entryId)\n\t);\n\tchat.referenceCache.clear();\n\tretainReferences(chat, selected.flatMap(entry => entry.references ?? []));\n\tretainReferences(chat, [\n\t\t...remainingBackscroll.flatMap(said => said.references ?? []),\n\t\t...currentReferences,\n\t]);\n\tlet readable = new Set(chat.referenceCache.keys());\n\tlet lines = selected.map(entry => line(entry, readable));\n\tif (partial && lines[0]) lines[0] = lines[0].slice(-50_000);\n\tchat.bootstrapEntries = new Set(selected.map(entry => entry.id));\n\tlet transcript = lines.join(\"\\n\");\n\tif (!transcript && !summary) return undefined;\n\tlet durableIds = new Set(\n\t\tselected.flatMap(entry => entry.references?.map(reference => reference.id) ?? []),\n\t);\n\tlet catalog = referenceCatalog(\n\t\t[...chat.referenceCache.values()].filter(reference => durableIds.has(reference.id)),\n\t);\n\treturn [\n\t\t\"This Copilot session was recreated.\",\n\t\tsummary ? `Earlier durable summary:\\n${summary}` : \"\",\n\t\ttranscript ? `Durable conversation context follows:\\n${transcript}` : \"\",\n\t\tcatalog ?? \"\",\n\t].filter(Boolean).join(\"\\n\\n\");\n}\n\nexport function consumeBootstrapBackscroll(chat: Chat): void {\n\tlet entries = chat.bootstrapEntries;\n\tchat.bootstrapEntries = undefined;\n\tif (!entries?.size) return;\n\tchat.backscroll = chat.backscroll.filter(said => !said.entryId || !entries.has(said.entryId));\n}\n\nasync function repositorySession(\n\tcontext: Room,\n\tclaimantSessionId: string,\n\tcurrentEntryId?: string,\n\tcurrentReferences: Wire.Reference[] = [],\n): Promise {\n\tlet { ownership, owner, repository } = await resolveOwner(\n\t\tcontext.auth,\n\t\tcontext.repository,\n\t\tcontext.room,\n\t\tclaimantSessionId,\n\t);\n\tif (context.ownerAvailable) void context.ownerAvailable().catch(() => {});\n\tlet { auth } = context;\n\tlet ownerSessionId = ownership.ownerSessionId!;\n\tlet credentialExpiresAt = Math.min(\n\t\towner.access.expiresAt.getTime(),\n\t\towner.session.expiresAt.getTime(),\n\t);\n\n\tlet { chat } = context;\n\tlet lifecycle = chat.lifecycle;\n\tlet reusable = chat.agent;\n\tlet binding = chat.owner;\n\tlet reuseLifecycle = chat.lifecycle;\n\tif (\n\t\treusable\n\t\t&& binding?.sessionId === ownerSessionId\n\t\t&& binding.generation === ownership.generation\n\t\t&& binding.revision === owner.access.revision\n\t\t&& binding.expiresAt > Date.now() + CREDENTIAL_EXPIRY_SKEW_MS\n\t) {\n\t\tawait auth.storage.channels.updateAgentContext({\n\t\t\tchannelId: context.room,\n\t\t\townerSessionId,\n\t\t\tgeneration: ownership.generation,\n\t\t\tsummary: ownership.summary,\n\t\t\ttranscriptCursor: ownership.transcriptCursor,\n\t\t\tstatus: \"ready\",\n\t\t\tnow: new Date(),\n\t\t});\n\t\tif (\n\t\t\tchat.lifecycle !== reuseLifecycle\n\t\t\t|| chat.agent !== reusable\n\t\t\t|| chat.owner !== binding\n\t\t) throw new Error(\"The Planner session changed while it was being reused. Try again.\");\n\t\treturn reusable;\n\t}\n\tchat.referenceCache.clear();\n\tif (chat.agent) await Agent.discard(chat.agent);\n\tchat.agent = undefined;\n\tchat.owner = undefined;\n\tclearTimeout(chat.credentialTimer);\n\tchat.credentialTimer = undefined;\n\tlet activeOwner = await auth.sessions.inspect(ownerSessionId);\n\tif (chat.lifecycle !== lifecycle || activeOwner?.access.revision !== owner.access.revision) {\n\t\tthrow new Error(\n\t\t\t\"The Planner credentials changed while its old session was closing. Try again.\",\n\t\t);\n\t}\n\towner = activeOwner;\n\tcredentialExpiresAt = Math.min(\n\t\towner.access.expiresAt.getTime(),\n\t\towner.session.expiresAt.getTime(),\n\t);\n\tif (credentialExpiresAt <= Date.now() + CREDENTIAL_EXPIRY_SKEW_MS) {\n\t\tthrow new Error(\"The Copilot owner's login session is about to expire. Sign in again.\");\n\t}\n\tlet openingOwner = {\n\t\tsessionId: ownerSessionId,\n\t\tgeneration: ownership.generation,\n\t\trevision: owner.access.revision,\n\t};\n\tchat.openingOwner = openingOwner;\n\tlet bound = () =>\n\t\tchat.lifecycle === lifecycle\n\t\t&& (chat.openingOwner === openingOwner\n\t\t\t|| (chat.owner?.sessionId === ownerSessionId\n\t\t\t\t&& chat.owner.generation === ownership.generation\n\t\t\t\t&& chat.owner.revision === owner.access.revision));\n\tlet activeToken = () => {\n\t\tif (!bound()) return undefined;\n\t\treturn auth.sessions.token(ownerSessionId, owner.access.revision);\n\t};\n\tlet tools = toCopilotTools({ ...documentTools, ...repositoryTools() }, {\n\t\troom: documentRoom(context),\n\t\trepository,\n\t\towner: { currentToken: activeToken },\n\t});\n\tlet opening: Promise | undefined;\n\tlet opened: Agent.Agent | undefined;\n\ttry {\n\t\topening = Agent.openPlanner(context.config, { tools }, {\n\t\t\ttoken: owner.access.token,\n\t\t\trepository,\n\t\t\tbootstrap: sessionBootstrap(\n\t\t\t\tchat,\n\t\t\t\townership.transcriptCursor,\n\t\t\t\townership.summary,\n\t\t\t\tcurrentEntryId,\n\t\t\t\tcurrentReferences,\n\t\t\t),\n\t\t\tauthorize: async () => {\n\t\t\t\tif (!bound()) return false;\n\t\t\t\tlet activeOwner = await auth.sessions.inspect(ownerSessionId);\n\t\t\t\tif (!activeOwner || activeOwner.access.revision !== owner.access.revision) return false;\n\t\t\t\tif (!await auth.admission.allowed(activeOwner.access.token, activeOwner.user.id)) {\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t\tlet stored = await auth.storage.collaboration.load(context.room, new Date());\n\t\t\t\tif (\n\t\t\t\t\tstored?.agent?.ownerSessionId !== ownerSessionId\n\t\t\t\t\t|| stored.agent.generation !== ownership.generation\n\t\t\t\t) return false;\n\t\t\t\tlet access = await auth.github.repositoryAccess(\n\t\t\t\t\tactiveOwner.access.token,\n\t\t\t\t\trepository.owner,\n\t\t\t\t\trepository.name,\n\t\t\t\t);\n\t\t\t\tlet stillActive = await auth.sessions.inspect(ownerSessionId);\n\t\t\t\treturn bound()\n\t\t\t\t\t&& stillActive?.access.revision === owner.access.revision\n\t\t\t\t\t&& !!access && access.id === repository.id\n\t\t\t\t\t&& (access.permissions.push || access.permissions.admin);\n\t\t\t},\n\t\t});\n\t\tchat.opening = opening;\n\t\tlet agent = opened = await opening;\n\t\tlet activeOwner = await auth.sessions.inspect(ownerSessionId);\n\t\tlet activeOwnership = await auth.storage.collaboration.load(context.room, new Date());\n\t\tif (\n\t\t\tchat.lifecycle !== lifecycle\n\t\t\t|| chat.openingOwner !== openingOwner\n\t\t\t|| activeOwner?.access.revision !== owner.access.revision\n\t\t\t|| activeOwnership?.agent?.ownerSessionId !== ownerSessionId\n\t\t\t|| activeOwnership.agent.generation !== ownership.generation\n\t\t) {\n\t\t\tthrow new Error(\"The Planner session changed while it was opening. Try again.\");\n\t\t}\n\t\tawait auth.storage.channels.updateAgentContext({\n\t\t\tchannelId: context.room,\n\t\t\townerSessionId,\n\t\t\tgeneration: ownership.generation,\n\t\t\tsummary: ownership.summary,\n\t\t\ttranscriptCursor: ownership.transcriptCursor,\n\t\t\tstatus: \"ready\",\n\t\t\tnow: new Date(),\n\t\t});\n\t\tactiveOwner = await auth.sessions.inspect(ownerSessionId);\n\t\tif (\n\t\t\tchat.lifecycle !== lifecycle\n\t\t\t|| chat.openingOwner !== openingOwner\n\t\t\t|| activeOwner?.access.revision !== owner.access.revision\n\t\t) {\n\t\t\tthrow new Error(\"The Planner session changed while it was opening. Try again.\");\n\t\t}\n\t\tchat.agent = agent;\n\t\tchat.owner = {\n\t\t\tsessionId: ownerSessionId,\n\t\t\tgeneration: ownership.generation,\n\t\t\trevision: owner.access.revision,\n\t\t\texpiresAt: credentialExpiresAt,\n\t\t};\n\t\tconsumeBootstrapBackscroll(chat);\n\t\tchat.credentialTimer = setTimeout(() => {\n\t\t\tvoid resetAgent(\n\t\t\t\tchat,\n\t\t\t\townerSessionId,\n\t\t\t\towner.access.revision,\n\t\t\t\t\"GitHub credentials expired, so the Planner session was restarted. Ask it to continue.\",\n\t\t\t);\n\t\t}, Math.max(0, credentialExpiresAt - Date.now() - CREDENTIAL_EXPIRY_SKEW_MS));\n\t\treturn agent;\n\t} catch (err) {\n\t\tif (opened && chat.agent !== opened) await Agent.discard(opened);\n\t\tif (!chat.agent) chat.referenceCache.clear();\n\t\tchat.bootstrapEntries = undefined;\n\t\tawait auth.storage.channels.updateAgentContext({\n\t\t\tchannelId: context.room,\n\t\t\townerSessionId,\n\t\t\tgeneration: ownership.generation,\n\t\t\tsummary: ownership.summary,\n\t\t\ttranscriptCursor: ownership.transcriptCursor,\n\t\t\tstatus: \"unavailable\",\n\t\t\tnow: new Date(),\n\t\t}).catch(() => {});\n\t\tthrow err;\n\t} finally {\n\t\tif (chat.openingOwner === openingOwner) chat.openingOwner = undefined;\n\t\tif (chat.opening === opening) chat.opening = undefined;\n\t}\n}\n\nexport async function resolveOwner(\n\tauth: HostedAuth,\n\trepository: HostedRepository,\n\tchannelId: string,\n\tclaimantSessionId: string,\n) {\n\tlet ownership = await auth.storage.channels.claimAgentOwner(\n\t\tchannelId,\n\t\tclaimantSessionId,\n\t\tnew Date(),\n\t);\n\tlet ownerSessionId = ownership.ownerSessionId;\n\tif (!ownerSessionId) throw new Error(\"This channel's Copilot owner is unavailable.\");\n\tlet owner = await auth.sessions.resolve(ownerSessionId);\n\tif (!owner) {\n\t\tthrow new Error(\"The Copilot owner must sign in again or reset this channel's agent.\");\n\t}\n\tlet checked = await auth.sessions.use(\n\t\towner,\n\t\ttoken => auth.github.repositoryAccess(token, repository.owner, repository.name),\n\t);\n\towner = checked.authenticated;\n\tlet current = checked.value;\n\tif (\n\t\t!current\n\t\t|| current.id !== repository.id\n\t\t|| (!current.permissions.push && !current.permissions.admin)\n\t) throw new Error(\"The Copilot owner no longer has repository write access.\");\n\treturn { ownership, owner, repository };\n}\n\nasync function session(\n\tcontext: Room,\n\tclaimantSessionId: string,\n\tcurrentEntryId?: string,\n\tcurrentReferences: Wire.Reference[] = [],\n): Promise {\n\treturn repositorySession(context, claimantSessionId, currentEntryId, currentReferences);\n}\n\n/**\n * Finish anything left mid-sentence.\n *\n * A message is normally completed by `assistant.message`, which arrives at the\n * end of a stream. An aborted or failed turn never sends one, so without this\n * the entry keeps its streaming flag and every client goes on drawing a caret\n * after a message that will never be added to.\n */\nfunction settle(chat: Chat, server: Server, room: string): void {\n\tfor (let entry of chat.entries) {\n\t\tif (!entry.streaming) continue;\n\t\tdelete entry.streaming;\n\t\tannounce(server, room, entry);\n\t}\n}\n\n/** Run one turn, then drain whatever queued up behind it. */\nasync function run(\n\tcontext: Room,\n\thandle: string,\n\ttext: string,\n\tthread: string | undefined,\n\tclaimantSessionId: string,\n\treserved = false,\n\tmember?: MemberRequest,\n\treferences: Wire.Reference[] = [],\n): Promise {\n\tlet { chat, plan, room, server } = context;\n\tif (chat.closed) return;\n\n\tif (!reserved) {\n\t\tchat.busy = true;\n\t\tchat.turn = { id: ulid(), handle, started: now(), responded: false };\n\t\tchat.acting = thread;\n\t\tstate(chat, server, room);\n\t} else chat.acting = thread;\n\n\tchat.activeRequest = member && chat.turn\n\t\t? {\n\t\t\tentryId: member.entryId,\n\t\t\tuserId: member.userId,\n\t\t\thandle,\n\t\t\ttext,\n\t\t\tclaimantSessionId,\n\t\t\tturnId: chat.turn.id,\n\t\t\tlifecycle: chat.lifecycle,\n\t\t}\n\t\t: undefined;\n\n\ttry {\n\t\tlet agent = await session(context, claimantSessionId, member?.entryId, references);\n\t\tif (chat.agent !== agent) {\n\t\t\tthrow new Error(\"The Planner session changed before the turn started. Try again.\");\n\t\t}\n\n\t\t/*\n\t\t * `send` resolves when the message is accepted, not when the turn is\n\t\t * over — the work happens afterwards, over events. Waiting on `send`\n\t\t * alone tears the handler down before the agent has said anything.\n\t\t *\n\t\t * `session.idle` is the turn actually ending. `session.error` resolves\n\t\t * it too: a turn that has failed is not going to reach idle, and\n\t\t * leaving the room busy forever is worse than ending early.\n\t\t */\n\t\tlet finished = Promise.withResolvers();\n\t\tchat.finishTurn = finished.resolve;\n\t\tchat.release = agent.session.on(event => {\n\t\t\ttranslate(context, event);\n\t\t\tif (event.type === \"session.idle\" || event.type === \"session.error\") {\n\t\t\t\tfinished.resolve();\n\t\t\t}\n\t\t});\n\n\t\t// Drained rather than copied: what the agent has been told once should\n\t\t// not arrive again on the next turn.\n\t\tlet backscroll = chat.backscroll;\n\t\tchat.backscroll = [];\n\t\tlet promptReferences = [\n\t\t\t...backscroll.flatMap(said => said.references ?? []),\n\t\t\t...references,\n\t\t];\n\t\tretainReferences(chat, promptReferences);\n\t\tlet available = promptReferences.filter(reference => chat.referenceCache.has(reference.id));\n\t\tlet prompt = compose(backscroll, handle, text, references, available);\n\n\t\t// The handle travels to the model, because a position belongs to\n\t\t// whoever holds it.\n\t\tawait agent.session.send({ prompt });\n\t\tawait finished.promise;\n\t\tif (chat.interruption) throw new Error(chat.interruption);\n\t} catch (err) {\n\t\tconsole.error(\"[chat] turn failed:\", err);\n\t\tif (!chat.closed) {\n\t\t\tsay(chat, server, room, {\n\t\t\t\tid: ulid(),\n\t\t\t\tauthor: { kind: \"system\" },\n\t\t\t\ttext: err instanceof Error ? err.message : \"The agent could not be reached.\",\n\t\t\t\tts: now(),\n\t\t\t});\n\t\t}\n\t\tchat.interruption = undefined;\n\t} finally {\n\t\tchat.activeRequest = undefined;\n\t\tchat.release?.();\n\t\tchat.release = undefined;\n\t\tchat.finishTurn = undefined;\n\t\tchat.writing = undefined;\n\t\tchat.tooling = undefined;\n\t\tsettle(chat, server, room);\n\t\tif (!chat.closed) await context.persist();\n\n\t\t/*\n\t\t * The agent's cursor outlives the turn by a moment.\n\t\t *\n\t\t * Somebody who looks over just as it finishes should still see where it\n\t\t * got to, and a caret that vanished on the same tick as the last token\n\t\t * would deny them that. Restarted rather than stacked: a queued turn\n\t\t * starting inside the linger must cancel this, or it would take down a\n\t\t * cursor the next turn had just placed.\n\t\t */\n\t\tclearTimeout(chat.lingering);\n\t\tif (!chat.closed) {\n\t\t\tchat.lingering = setTimeout(() => {\n\t\t\t\tchat.lingering = undefined;\n\t\t\t\tService.release(plan, server, room);\n\t\t\t}, LINGER_MS);\n\t\t}\n\t}\n\n\tif (chat.closed) return;\n\tlet next = pending(chat);\n\tif (next) {\n\t\tawait context.persist();\n\t\tif (chat.closed) return;\n\t\tqueued(chat, server, room);\n\t\tlet entry = next.message ? chat.entries.find(item => item.id === next.id) : undefined;\n\t\tif (entry) announce(server, room, entry);\n\t\tawait run(\n\t\t\tcontext,\n\t\t\tnext.handle,\n\t\t\tnext.text,\n\t\t\tnext.thread,\n\t\t\tnext.sessionId ?? context.claimantSessionId,\n\t\t\tfalse,\n\t\t\tnext.message && next.userId ? { entryId: next.id, userId: next.userId } : undefined,\n\t\t\tnext.references,\n\t\t);\n\t} else {\n\t\tchat.busy = false;\n\t\tchat.turn = undefined;\n\t\tchat.acting = undefined;\n\t\tstate(chat, server, room);\n\t}\n}\n\nfunction startRun(\n\tcontext: Room,\n\thandle: string,\n\ttext: string,\n\tthread: string | undefined,\n\tclaimantSessionId: string,\n\treserved = false,\n\tmember?: MemberRequest,\n\treferences?: Wire.Reference[],\n): void {\n\tif (context.chat.closed) return;\n\tlet running = run(context, handle, text, thread, claimantSessionId, reserved, member, references);\n\tcontext.chat.running = running;\n\tvoid running.finally(() => {\n\t\tif (context.chat.running === running) context.chat.running = undefined;\n\t}).catch(() => {});\n}\n\n/**\n * The next queued turn worth running.\n *\n * A turn whose work is already done is dropped rather than run: four accepted\n * comments should not cost four passes over the plan when the agent dealt with\n * all of them in the first. Only something that queued behind a turn can be\n * spent, which is why the question is asked here and not when it was accepted.\n */\nexport function pending(chat: Chat): Waiting | undefined {\n\tlet next = chat.waiting.shift();\n\twhile (next?.spent?.()) next = chat.waiting.shift();\n\tif (next?.message) {\n\t\tlet entry: MemberEntry = {\n\t\t\tid: next.id,\n\t\t\tauthor: { kind: \"member\", handle: next.handle },\n\t\t\ttext: next.text,\n\t\t\tts: now(),\n\t\t\t...(next.references?.length ? { references: next.references } : {}),\n\t\t\t...(next.delivery ? { delivery: next.delivery } : {}),\n\t\t};\n\t\tchat.entries.push(entry);\n\t}\n\treturn next;\n}\n\n/**\n * Turn what the SDK reports into what the room sees.\n *\n * Only the events a reader needs: what the agent said, what it is doing, and\n * when something failed. The rest is diagnostic noise that belongs in a log.\n *\n * Exported so it can be driven with synthetic events. Every field it reads\n * lives under `event.data` and several are near-homonyms of fields on the\n * envelope, which is the kind of mistake that produces plausible-looking\n * output rather than an error.\n */\nexport function translate(context: Room, event: SessionEvent): void {\n\tlet { chat, room, server } = context;\n\n\tswitch (event.type) {\n\t\tcase \"session.idle\":\n\t\t\tchat.tooling = undefined;\n\t\t\treturn;\n\n\t\t// One entry per assistant message, identified by the id the deltas\n\t\t// carry, so two messages in a turn do not run together.\n\t\tcase \"assistant.message_delta\": {\n\t\t\tlet { deltaContent, messageId } = event.data;\n\t\t\tlet entry = chat.entries.find(item => item.id === messageId);\n\t\t\tif (!entry) {\n\t\t\t\tchat.writing = messageId;\n\t\t\t\tsay(chat, server, room, {\n\t\t\t\t\tid: messageId,\n\t\t\t\t\tauthor: { kind: \"agent\" },\n\t\t\t\t\ttext: deltaContent,\n\t\t\t\t\tts: now(),\n\t\t\t\t\tstreaming: true,\n\t\t\t\t});\n\t\t\t\tresponded(chat, server, room, deltaContent);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tentry.text += deltaContent;\n\t\t\tbroadcast(server, room, { kind: \"chat:delta\", ts: 0, id: messageId, text: deltaContent });\n\t\t\tresponded(chat, server, room, deltaContent);\n\t\t\treturn;\n\t\t}\n\n\t\tcase \"assistant.message\": {\n\t\t\t// `data.messageId`, not `event.id`. The envelope's id belongs to the\n\t\t\t// event; the message has its own, and it is the one the deltas were\n\t\t\t// keyed by. Looking up the wrong one finds nothing, appends a second\n\t\t\t// copy of the message, and leaves the first one streaming forever.\n\t\t\tlet { content, messageId } = event.data;\n\t\t\tlet entry = chat.entries.find(item => item.id === messageId);\n\n\t\t\tif (entry) {\n\t\t\t\tentry.text = content || entry.text;\n\t\t\t\tdelete entry.streaming;\n\t\t\t\tannounce(server, room, entry);\n\t\t\t\tresponded(chat, server, room, content);\n\t\t\t} else if (content.trim()) {\n\t\t\t\t// No deltas arrived — a short reply the model did not stream.\n\t\t\t\tsay(chat, server, room, {\n\t\t\t\t\tid: messageId,\n\t\t\t\t\tauthor: { kind: \"agent\" },\n\t\t\t\t\ttext: content,\n\t\t\t\t\tts: now(),\n\t\t\t\t});\n\t\t\t\tresponded(chat, server, room, content);\n\t\t\t}\n\n\t\t\tchat.writing = undefined;\n\t\t\treturn;\n\t\t}\n\n\t\tcase \"tool.execution_start\": {\n\t\t\tlet { arguments: args, toolCallId, toolName } = event.data;\n\t\t\tchat.timings.set(toolCallId, Date.now());\n\t\t\tlet activity: Wire.Activity = {\n\t\t\t\tid: toolCallId,\n\t\t\t\tname: toolName,\n\t\t\t\tstatus: \"running\",\n\t\t\t\t...(args ? { args: JSON.stringify(args, null, 2) } : {}),\n\t\t\t};\n\t\t\tbroadcast(server, room, {\n\t\t\t\tkind: \"chat:tool\",\n\t\t\t\tts: 0,\n\t\t\t\tentry: attach(context, activity),\n\t\t\t\tactivity,\n\t\t\t});\n\t\t\treturn;\n\t\t}\n\n\t\tcase \"tool.execution_complete\": {\n\t\t\tlet { error, result, success, toolCallId } = event.data;\n\t\t\tlet started = chat.timings.get(toolCallId);\n\t\t\tchat.timings.delete(toolCallId);\n\n\t\t\t// The completion does not repeat the tool's name; the start did, and\n\t\t\t// the entry it was filed under still has it.\n\t\t\tlet name = named(chat, toolCallId);\n\t\t\tlet detail = name === \"read_reference\"\n\t\t\t\t? success\n\t\t\t\t\t? \"Reference content was returned privately to the Planner.\"\n\t\t\t\t\t: \"The reference could not be read.\"\n\t\t\t\t: result?.content ?? (error ? JSON.stringify(error) : undefined);\n\t\t\tlet activity: Wire.Activity = {\n\t\t\t\tid: toolCallId,\n\t\t\t\tname,\n\t\t\t\tstatus: success ? \"done\" : \"failed\",\n\t\t\t\t...(started ? { took: Date.now() - started } : {}),\n\t\t\t\t// Bounded: a `grep` across a repository is not a thing anybody\n\t\t\t\t// wants delivered to every browser in the room.\n\t\t\t\t...(detail ? { result: detail.slice(0, 4_000) } : {}),\n\t\t\t};\n\t\t\tbroadcast(server, room, {\n\t\t\t\tkind: \"chat:tool\",\n\t\t\t\tts: 0,\n\t\t\t\tentry: attach(context, activity),\n\t\t\t\tactivity,\n\t\t\t});\n\t\t\treturn;\n\t\t}\n\n\t\t/*\n\t\t * A refused tool never executes, so it produces no start and no\n\t\t * completion — without this it leaves no trace at all, and the agent\n\t\t * quietly works around a boundary nobody can see it hitting. Which is\n\t\t * indistinguishable, from the outside, from a tool it never had.\n\t\t */\n\t\tcase \"permission.completed\": {\n\t\t\tlet { result, toolCallId } = event.data;\n\t\t\tif (!toolCallId || !result.kind.startsWith(\"denied\")) return;\n\n\t\t\tlet feedback = \"feedback\" in result && typeof result.feedback === \"string\"\n\t\t\t\t? result.feedback\n\t\t\t\t: undefined;\n\n\t\t\tlet activity: Wire.Activity = {\n\t\t\t\tid: toolCallId,\n\t\t\t\tname: named(chat, toolCallId),\n\t\t\t\tstatus: \"failed\",\n\t\t\t\tresult: feedback ?? \"Refused.\",\n\t\t\t};\n\t\t\tbroadcast(server, room, {\n\t\t\t\tkind: \"chat:tool\",\n\t\t\t\tts: 0,\n\t\t\t\tentry: attach(context, activity),\n\t\t\t\tactivity,\n\t\t\t});\n\t\t\treturn;\n\t\t}\n\n\t\tcase \"session.error\": {\n\t\t\tchat.tooling = undefined;\n\t\t\tsay(chat, server, room, {\n\t\t\t\tid: ulid(),\n\t\t\t\tauthor: { kind: \"system\" },\n\t\t\t\ttext: event.data.message || \"The agent stopped unexpectedly.\",\n\t\t\t\tts: now(),\n\t\t\t});\n\t\t\treturn;\n\t\t}\n\t}\n}\n\n/** What a running tool call was called, from where it was filed. */\nfunction named(chat: Chat, id: string): string {\n\tfor (let entry of chat.entries) {\n\t\tlet found = entry.tools?.find(activity => activity.id === id);\n\t\tif (found) return found.name;\n\t}\n\treturn \"tool\";\n}\n\n/**\n * File a tool call under the message that made it, and say which that was.\n *\n * A tool call that arrives before the agent has said anything — which is most\n * of them, since reading precedes writing — has no message to attach to yet.\n * It gets an entry of its own so the work is visible while it happens rather\n * than appearing retrospectively once the agent finishes talking.\n */\nfunction attach(context: Room, activity: Wire.Activity): string {\n\tlet { chat, room, server } = context;\n\t// Completion can arrive after idle; find its original activity by call id.\n\tlet entry = chat.entries.find(item => item.tools?.some(tool => tool.id === activity.id))\n\t\t?? chat.entries.find(item => item.id === chat.tooling)\n\t\t?? chat.entries.find(item => item.id === chat.writing);\n\tif (entry && !entry.tools?.some(tool => tool.id === activity.id)) chat.tooling = entry.id;\n\n\tif (!entry) {\n\t\tentry = { id: ulid(), author: { kind: \"agent\" }, text: \"\", ts: now(), tools: [] };\n\t\tchat.tooling = entry.id;\n\t\tsay(chat, server, room, entry);\n\t}\n\n\tentry.tools ??= [];\n\tlet existing = entry.tools.findIndex(item => item.id === activity.id);\n\tif (existing >= 0) entry.tools[existing] = { ...entry.tools[existing], ...activity };\n\telse entry.tools.push(activity);\n\treturn entry.id;\n}\n\nexport async function resetAgent(\n\tchat: Chat,\n\tsessionId?: string,\n\trevision?: number,\n\treason?: string,\n): Promise {\n\tlet binding = chat.owner ?? chat.openingOwner;\n\tif (\n\t\t!binding\n\t\t|| (sessionId && binding.sessionId !== sessionId)\n\t\t|| (revision !== undefined && binding.revision !== revision)\n\t) return;\n\tchat.lifecycle++;\n\tchat.activeRequest = undefined;\n\tclearTimeout(chat.credentialTimer);\n\tchat.credentialTimer = undefined;\n\tif (reason && chat.finishTurn) chat.interruption = reason;\n\tlet agent = chat.agent;\n\tlet opening = chat.opening;\n\tchat.agent = undefined;\n\tchat.owner = undefined;\n\tchat.referenceCache.clear();\n\tchat.bootstrapEntries = undefined;\n\tchat.opening = undefined;\n\tchat.openingOwner = undefined;\n\tif (agent) await Agent.abort(agent);\n\tchat.finishTurn?.();\n\tchat.release?.();\n\tchat.release = undefined;\n\tchat.finishTurn = undefined;\n\tif (agent) await Agent.discard(agent);\n\tif (opening) {\n\t\tlet opened = await Agent.settle(opening);\n\t\tif (opened && opened !== agent) await Agent.discard(opened);\n\t}\n}\n\n/** Let go of the session. The conversation is resumable by id. */\nexport async function close(chat: Chat): Promise {\n\tchat.closed = true;\n\tchat.lifecycle++;\n\tchat.activeRequest = undefined;\n\tchat.waiting = [];\n\tlet sending = chat.sending;\n\tlet running = chat.running;\n\tlet agent = chat.agent;\n\tlet opening = chat.opening;\n\tchat.agent = undefined;\n\tchat.owner = undefined;\n\tchat.referenceCache.clear();\n\tchat.bootstrapEntries = undefined;\n\tchat.opening = undefined;\n\tchat.openingOwner = undefined;\n\tif (agent) await Agent.abort(agent);\n\tchat.finishTurn?.();\n\tchat.release?.();\n\tchat.release = undefined;\n\tchat.finishTurn = undefined;\n\t// A cursor waiting to be taken down has nowhere to be taken down from, and\n\t// a live timer would hold the loop open for its whole linger.\n\tclearTimeout(chat.lingering);\n\tchat.lingering = undefined;\n\tclearTimeout(chat.credentialTimer);\n\tchat.credentialTimer = undefined;\n\tif (agent) await Agent.discard(agent);\n\tif (opening) {\n\t\tlet opened = await Agent.settle(opening);\n\t\tif (opened && opened !== agent) await Agent.discard(opened);\n\t}\n\tawait Promise.all([sending, running]);\n}\n","editable",false,"branch","documentNavigation","repo","githubnext/chopin","repoId","7d1a8ac3-35b0-4dea-85d4-06a980f3bada","ownerId","org:89615882","organization",true,"site","nexthub","private","admin","settings","maintainer","triage","starred","stars",0,"watchers","watching","pinned","notify","views",[184,185,186,187,188,189,190,191,192,193,194,195,196],"navigation",{"_56":57,"_141":142,"_143":144,"_145":146,"_147":148,"_149":150,"_151":152},"sources",[],"viewer","meta",{"_133":134,"_135":136,"_137":138,"_44":31,"_139":128,"_140":31,"_50":51,"_52":51},"branches",[75,76,77,78,79,80,81,82,83,84,85,86,87,88,89,90,91,92,93,94,95,96,97,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132],"tags",[71,72,73,74],"cloneUrl","https://git.nexthub.sh/githubnext/chopin.git","color-controls-slice-1","color-controls-slice-2","color-controls-slice-3","color-controls-slice-4","Krzysztof-Cieslak-patch-1","Krzysztof-Cieslak-patch-2","Maggie/app-preview-toolkit","Maggie/ci-playwright-install-timeout","Maggie/collaborative-visual-decision","Maggie/design-audit","Maggie/generic-visual-decision-runtime","Maggie/impeccable-chopin-metadata","Maggie/jev-chat-product","Maggie/jev-composed-assessment","Maggie/native-document-layouts","Maggie/openui-composition-product","Maggie/openui-composition-trial","Maggie/planner-visual-authoring","Maggie/planner-visual-requests","Maggie/visual-selection-eval","artifacts/pr-419-live-preview-20261009","automation/pr-maintenance-state","automation/use-effect/callout-disabled-picker-8cf9e49ba5c09471","automation/use-effect/collaboration-options-ref-4e3a5a08a879a5ae","automation/use-effect/room-workspace-effective-access-a57d40866c71bed0","chore/bun-1.4.2","color-controls","color-controls-plan","comments","design-pr-assets","design/archived-decisions-badge","design/channel-route-remount","design/chat-decision-entry","design/conversation-analysis-markers","design/decision-evidence","design/settled-line-icon","dev/integration","diagram-step-controls","feat/liveapp-frontend-pilot","feat/local-experiments","feat/local-launcher-tracer","fix/autolink-mdx-crash","github-pills/2-pills","github-pills/3-hover-card","maggie/app-preview-toolkit","maggie/ci-playwright-install-timeout","maggie/collaborative-visual-decision","maggie/design-audit","maggie/generic-visual-decision-runtime","maggie/impeccable-chopin-metadata","maggie/jev-composed-assessment","maggie/native-document-layouts","maggie/openui-composition-product","maggie/openui-composition-trial","maggie/planner-visual-authoring","maggie/planner-visual-requests","maggie/visual-selection-eval","main","plain-text-fence-chrome","tokens/09-copy","wireframes/2-renderer","wireframes/3-planner","description","Let's compose rich plans together","owner","githubnext","section","","head","empty","pins",[167,168,169],"documents",{"_162":163,"_164":165},"code",{"_158":159,"_160":161},"automations",{"_155":156,"_157":-5},"delivery",{"_153":51,"_154":-5},"tag","04zvKQ8QOrDUF8TO1Ovz0Zy8_TT","releases","applications","workflows",3,"deployments","commits",1000,"changes",13,"counts",{"_166":165},"total",11,"issue",{"_170":160,"_172":182,"_15":160,"_174":183,"_54":41,"_176":31,"_177":41,"_178":161},{"_170":179,"_172":180,"_15":179,"_174":181,"_54":41,"_176":31,"_177":41,"_178":51},{"_170":171,"_172":173,"_15":171,"_174":175,"_54":41,"_176":31,"_177":41,"_178":165},"id","issues","name","Issues","filters",{},"saved","pinnable","count","tasks","Tasks",{},"Changes",{},{"_170":160,"_172":182,"_15":160,"_174":227,"_54":41,"_176":31,"_177":41},{"_170":179,"_172":180,"_15":179,"_174":226,"_54":41,"_176":31,"_177":41},{"_170":171,"_172":173,"_15":171,"_174":225,"_54":41,"_176":31,"_177":41},{"_170":222,"_172":223,"_15":222,"_174":224,"_54":31,"_176":31,"_177":41},{"_170":219,"_172":220,"_15":219,"_174":221,"_54":31,"_176":31,"_177":41},{"_170":155,"_172":217,"_15":147,"_174":218,"_54":31,"_176":31,"_177":41},{"_170":157,"_172":214,"_15":215,"_174":216,"_54":31,"_176":31,"_177":41},{"_170":153,"_172":212,"_15":153,"_174":213,"_54":31,"_176":31,"_177":41},{"_170":208,"_172":209,"_15":210,"_174":211,"_54":31,"_176":31,"_177":41},{"_170":143,"_172":206,"_15":143,"_174":207,"_54":31,"_176":31,"_177":31},{"_170":203,"_172":204,"_15":203,"_174":205,"_54":31,"_176":31,"_177":31},{"_170":200,"_172":201,"_15":200,"_174":202,"_54":31,"_176":31,"_177":31},{"_170":197,"_172":198,"_15":197,"_174":199,"_54":31,"_176":31,"_177":31},"decisions","Decisions",{},"changelog","Changelog",{},"roadmap","Roadmap",{},"Documents",{},"activity","Activity","insights",{},"Releases",{},"Deployments","automations/deployments",{},"Workflows",{},"discussions","Discussions",{},"goals","Goals",{},{},{},{},"groups","user","agents",[],"now",1794609720850,"sidebar","expanded"]