[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10,"_11":12},"actionData","errors","root",{"_228":-5,"_231":232,"_233":234},"routes/shell",{"_40":41,"_227":-5,"_228":-5,"_229":230},"routes/repo",{"_33":-7,"_34":35,"_36":37,"_38":39,"_40":41,"_42":31,"_43":31,"_44":31,"_45":31,"_46":31,"_47":31,"_48":49,"_50":49,"_51":31,"_52":-7,"_53":-7,"_54":55,"_56":57,"_58":59,"_60":-5,"_61":62,"_63":64,"_65":66,"_67":68},"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","dbea4e43b63ffdb84427291aeff57768a144a87e","path","apps/server/src/agent/tools.test.ts","oid","8df47417c1993f3e9985005018e6b02b43549a43","size",31881,"commit","mounts",[],"source","plain",{"_13":14,"_15":16},"kind","text","import { afterEach, expect, spyOn, test } from \"bun:test\";\nimport { ulid } from \"@chopin/dialect\";\n\nimport { type DocumentRoom, documentTools } from \"./tools\";\nimport { Admission } from \"../auth/admission\";\nimport { Sessions } from \"../auth/session\";\nimport * as Chat from \"../chat/service\";\nimport * as room from \"../plan/room\";\nimport * as Service from \"../plan/service\";\nimport * as Store from \"../questions/store\";\nimport { openPlan } from \"../testing/plan\";\n\nimport type { HostedAuth } from \"../auth/routes\";\nimport type { SeedState } from \"../testing/plan\";\nimport type { Config } from \"../config\";\nimport type { Socket } from \"../wire\";\n\nconst WIDGET = \"01K0N4TR8K7JGM4R1J7PW4R8YJ\";\nconst QUESTION = \"01K0N4V4E7Y6P4MJ5WD8XZF3B2\";\nconst OPTION = \"01K0N4W3B7P27CBAEC7A8C8WEA\";\nconst SECOND_WIDGET = \"01K0N4X2M5R8T3VQ7YB6ZC4DEF\";\nconst SECOND_QUESTION = \"01K0N4Y2M5R8T3VQ7YB6ZC4DEF\";\nconst SECOND_OPTION = \"01K0N4Z2M5R8T3VQ7YB6ZC4DEF\";\nconst SOURCE = `# Title\n\nThe renderer caches tiles for 60 seconds.\n\nThe second paragraph.\n\n\n`;\nconst SECOND_QUESTIONNAIRE =\n\t`\n\n\n\n`;\n\nlet plans: Awaited>[] = [];\n\nafterEach(async () => {\n\tfor (let plan of plans) await Service.close(plan);\n\tplans = [];\n});\n\nasync function opened(source: string, state: SeedState = {}) {\n\tlet context = await openPlan(source, state);\n\tplans.push(context.plan);\n\treturn context;\n}\n\nfunction fixtureTools({ room, ...dependencies }: Omit & { room: string }) {\n\tlet context = { room: { id: room, ...dependencies }, repository: { id: \"R_test\" } };\n\treturn Object.entries(documentTools).map(([name, item]) => ({\n\t\tname,\n\t\tparameters: item.inputSchema,\n\t\thandler: (input: unknown, call: { toolCallId: string; [key: string]: unknown }) =>\n\t\t\titem.execute!(input as never, {\n\t\t\t\tcontext,\n\t\t\t\ttoolCallId: call.toolCallId,\n\t\t\t\tmessages: [],\n\t\t\t} as never),\n\t}));\n}\n\ntest(\"document tool names and schemas remain available to the Planner\", async () => {\n\texpect(Object.keys(documentTools)).toEqual([\n\t\t\"read_plan\",\n\t\t\"read_reference\",\n\t\t\"list_background_jobs\",\n\t\t\"read_background_job\",\n\t\t\"create_research_workspace\",\n\t\t\"edit_plan\",\n\t\t\"ask\",\n\t\t\"read_implementation_graph\",\n\t\t\"edit_implementation_graph\",\n\t\t\"anchor_plan\",\n\t]);\n\texpect(documentTools.edit_plan.inputSchema).toBeDefined();\n});\n\ntest(\"document tools use the room and repository supplied with each call\", async () => {\n\tlet first = await opened(\"First document.\\n\");\n\tlet second = await opened(\"Second document.\\n\");\n\tlet events: string[] = [];\n\tlet makeRoom = (fixture: typeof first, id: string): DocumentRoom => ({\n\t\tid,\n\t\tplan: fixture.plan,\n\t\tserver: fixture.server,\n\t\tpersist: () => Service.persist(fixture.plan),\n\t\texclusive: action => Service.exclusive(fixture.plan, action),\n\t\tasync publish() {\n\t\t\tevents.push(`${id}:publish`);\n\t\t},\n\t\tanchors() {\n\t\t\tevents.push(`${id}:anchors`);\n\t\t},\n\t\tchanges() {\n\t\t\tevents.push(`${id}:changes`);\n\t\t},\n\t\tjobs: {\n\t\t\tlist: (room: string) => ({ room }),\n\t\t\tget: (room: string, jobId: string) => ({ room, jobId }),\n\t\t} as unknown as DocumentRoom[\"jobs\"],\n\t\treadReference: async (referenceId, repositoryId) => ({ room: id, referenceId, repositoryId }),\n\t\tcreateResearch: async question => ({\n\t\t\tworkspaceId: `${id}:${question}`,\n\t\t\tstate: \"pending\",\n\t\t\tstage: \"queued\",\n\t\t}),\n\t});\n\tlet a = makeRoom(first, \"first\");\n\tlet b = makeRoom(second, \"second\");\n\tlet call = async (\n\t\tname: \"read_plan\" | \"read_implementation_graph\" | \"list_background_jobs\",\n\t\troom: DocumentRoom,\n\t) => {\n\t\tlet result = await documentTools[name].execute!({}, {\n\t\t\tcontext: { room },\n\t\t\ttoolCallId: \"call\",\n\t\t\tmessages: [],\n\t\t});\n\t\tif (typeof result !== \"string\") throw new Error(\"document tool did not return text\");\n\t\treturn JSON.parse(result);\n\t};\n\texpect((await call(\"read_plan\", a)).source).toContain(\"First document.\");\n\texpect((await call(\"read_plan\", b)).source).toContain(\"Second document.\");\n\texpect((await call(\"read_implementation_graph\", a)).source).toContain(\"First document.\");\n\texpect((await call(\"read_implementation_graph\", b)).source).toContain(\"Second document.\");\n\texpect(await call(\"list_background_jobs\", a)).toEqual({ room: \"first\" });\n\texpect(await call(\"list_background_jobs\", b)).toEqual({ room: \"second\" });\n\tlet job = await documentTools.read_background_job.execute!({ id: \"job-1\" }, {\n\t\tcontext: { room: b },\n\t\ttoolCallId: \"job\",\n\t\tmessages: [],\n\t});\n\tif (typeof job !== \"string\") throw new Error(\"job tool did not return text\");\n\texpect(JSON.parse(job)).toEqual({ room: \"second\", jobId: \"job-1\" });\n\tlet referenceId = ulid();\n\tlet reference = await documentTools.read_reference.execute!({ id: referenceId }, {\n\t\tcontext: { room: a, repository: { id: \"R_first\" } },\n\t\ttoolCallId: \"ref\",\n\t\tmessages: [],\n\t});\n\tif (typeof reference !== \"string\") throw new Error(\"reference tool did not return text\");\n\texpect(JSON.parse(reference)).toEqual({ room: \"first\", referenceId, repositoryId: \"R_first\" });\n\tlet research = await documentTools.create_research_workspace.execute!(\n\t\t{ question: \"Exact brief\" },\n\t\t{\n\t\t\tcontext: { room: b },\n\t\t\ttoolCallId: \"research\",\n\t\t\tmessages: [],\n\t\t},\n\t);\n\tif (typeof research !== \"string\") throw new Error(\"research tool did not return text\");\n\texpect(JSON.parse(research).workspaceId).toBe(\"second:Exact brief\");\n\tlet result = await documentTools.edit_plan.execute!({\n\t\trevision: second.plan.revision,\n\t\toperations: [{ op: \"replace\", index: 0, source: \"Changed second document.\\n\" }],\n\t}, { context: { room: b }, toolCallId: \"edit\", messages: [] });\n\tif (typeof result !== \"string\") throw new Error(\"edit_plan did not return text\");\n\texpect(JSON.parse(result).ok).toBe(true);\n\texpect(room.project(first.plan.document)).toBe(\"First document.\\n\");\n\texpect(room.project(second.plan.document)).toBe(\"Changed second document.\\n\");\n\texpect(events).toEqual([\"second:publish\", \"second:changes\", \"second:anchors\"]);\n});\n\ntest(\"create_research_workspace validates one question and waits for immediate research start\", async () => {\n\tlet { plan, server } = await opened(\"Research context.\\n\");\n\tlet committed = Promise.withResolvers<{\n\t\tworkspaceId: string;\n\t\tstate: \"pending\";\n\t\tstage: \"queued\";\n\t}>();\n\tlet questions: string[] = [];\n\tlet createResearch = fixtureTools({\n\t\tplan,\n\t\tserver,\n\t\troom: \"test\",\n\t\tpersist: () => Service.persist(plan),\n\t\texclusive: action => Service.exclusive(plan, action),\n\t\tasync publish() {},\n\t\tanchors() {},\n\t\tchanges() {},\n\t\tcreateResearch: question => {\n\t\t\tquestions.push(question);\n\t\t\treturn committed.promise;\n\t\t},\n\t}).find(tool => tool.name === \"create_research_workspace\");\n\tif (!createResearch?.handler) throw new Error(\"create_research_workspace is missing\");\n\texpect((createResearch.parameters as { jsonSchema: unknown }).jsonSchema).toEqual({\n\t\ttype: \"object\",\n\t\tproperties: { question: { type: \"string\", minLength: 1, maxLength: 4_096 } },\n\t\trequired: [\"question\"],\n\t\tadditionalProperties: false,\n\t});\n\tlet call = async (raw: unknown): Promise => {\n\t\tlet response = await createResearch.handler!(raw as never, {\n\t\t\tsessionId: \"session\",\n\t\t\ttoolCallId: \"call\",\n\t\t\ttoolName: \"create_research_workspace\",\n\t\t\targuments: raw as never,\n\t\t});\n\t\tif (typeof response !== \"string\") throw new Error(\"research tool returned no text\");\n\t\treturn response;\n\t};\n\n\tlet question = \"Which public release evidence supports adopting version 3?\";\n\tlet response = call({ question });\n\tlet settled = false;\n\tvoid response.then(() => settled = true);\n\tawait Promise.resolve();\n\texpect(questions).toEqual([question]);\n\texpect(settled).toBe(false);\n\tlet result = {\n\t\tworkspaceId: \"workspace-1\",\n\t\tstate: \"pending\" as const,\n\t\tstage: \"queued\" as const,\n\t};\n\tcommitted.resolve(result);\n\texpect(JSON.parse(await response)).toEqual(result);\n\n\tlet error = spyOn(console, \"error\").mockImplementation(() => {});\n\ttry {\n\t\tfor (\n\t\t\tlet invalid of [\n\t\t\t\t{},\n\t\t\t\t{ question: \"\" },\n\t\t\t\t{ question: 1 },\n\t\t\t\t{ question: \"valid\", extra: true },\n\t\t\t\t{ question: \"x\".repeat(4_097) },\n\t\t\t]\n\t\t) {\n\t\t\texpect(await call(invalid)).toStartWith(\"Error:\");\n\t\t}\n\t} finally {\n\t\terror.mockRestore();\n\t}\n\texpect(questions).toEqual([question]);\n});\n\ntest(\"read_reference accepts only ids made available by the active chat session\", async () => {\n\tlet { plan, server } = await opened(\"Reference context.\\n\");\n\tlet available = ulid();\n\tlet reads: string[] = [];\n\tlet readReference = fixtureTools({\n\t\tplan,\n\t\tserver,\n\t\troom: \"test\",\n\t\tpersist: () => Service.persist(plan),\n\t\texclusive: action => Service.exclusive(plan, action),\n\t\tasync publish() {},\n\t\tanchors() {},\n\t\tchanges() {},\n\t\treadReference: async id => {\n\t\t\tif (id !== available) throw new Error(\"reference is not available in this Planner session\");\n\t\t\treads.push(id);\n\t\t\treturn { id, source: \"untrusted\" };\n\t\t},\n\t}).find(tool => tool.name === \"read_reference\");\n\tif (!readReference?.handler) throw new Error(\"read_reference is missing\");\n\tlet call = (raw: unknown) =>\n\t\treadReference.handler!(raw as never, {\n\t\t\tsessionId: \"session\",\n\t\t\ttoolCallId: \"call\",\n\t\t\ttoolName: \"read_reference\",\n\t\t\targuments: raw as never,\n\t\t});\n\tlet error = spyOn(console, \"error\").mockImplementation(() => {});\n\ttry {\n\t\texpect(await call({ id: available })).toContain(\"untrusted\");\n\t\texpect(await call({ id: ulid() })).toContain(\"Error: reference is not available\");\n\t\texpect(await call({ id: \"arbitrary\" })).toContain(\"Error: reference id is invalid\");\n\t\texpect(await call({ id: available, channelId: \"another-room\" })).toContain(\n\t\t\t\"Error: read_reference accepts only\",\n\t\t);\n\t} finally {\n\t\terror.mockRestore();\n\t}\n\texpect(reads).toEqual([available]);\n});\n\ntest(\"anchor_plan waits for decision placement before persisting and broadcasting anchors\", async () => {\n\tlet { plan, server } = await opened(SOURCE, {\n\t\trevision: 1,\n\t\tquestions: [{\n\t\t\tid: WIDGET,\n\t\t\tstatus: \"answered\",\n\t\t\tresolver: \"ana\",\n\t\t\tdefinition: {\n\t\t\t\tquestions: [{\n\t\t\t\t\tid: QUESTION,\n\t\t\t\t\theader: \"Cache\",\n\t\t\t\t\tquestion: \"How long do we cache?\",\n\t\t\t\t\tmultiple: false,\n\t\t\t\t\toptions: [{ id: OPTION, label: \"60 seconds\", description: \"\" }],\n\t\t\t\t}],\n\t\t\t},\n\t\t\tanswers: { [QUESTION]: \"60 seconds\" },\n\t\t}],\n\t});\n\tlet published: unknown[] = [];\n\tlet anchors = 0;\n\tlet started = Promise.withResolvers();\n\tlet release = Promise.withResolvers();\n\tlet finished = Promise.withResolvers();\n\tlet persisted = false;\n\tlet anchorPlan = fixtureTools({\n\t\tplan,\n\t\tserver,\n\t\troom: \"test\",\n\t\tpersist: async () => {\n\t\t\tpersisted = true;\n\t\t\tawait Service.persist(plan);\n\t\t},\n\t\texclusive: action => Service.exclusive(plan, action),\n\t\tpublish: async mutation => {\n\t\t\tstarted.resolve();\n\t\t\tawait release.promise;\n\t\t\tawait Service.publish(plan, server, \"test\", mutation);\n\t\t\tpublished.push(mutation);\n\t\t\tfinished.resolve();\n\t\t},\n\t\tanchors: () => anchors++,\n\t\tchanges() {},\n\t}).find(tool => tool.name === \"anchor_plan\");\n\tif (!anchorPlan) throw new Error(\"anchor_plan is missing\");\n\tif (!anchorPlan.handler) throw new Error(\"anchor_plan has no handler\");\n\tlet digest = room.digests(plan.document)[1]!;\n\n\tlet args = {\n\t\trevision: plan.revision,\n\t\tanchors: [{ widget: WIDGET, question: QUESTION, blocks: [{ index: 1, digest }] }],\n\t};\n\tlet pending = anchorPlan.handler(args, {\n\t\tsessionId: \"session\",\n\t\ttoolCallId: \"call\",\n\t\ttoolName: \"anchor_plan\",\n\t\targuments: args,\n\t});\n\tawait started.promise;\n\tlet beforeCommit = { persisted, anchors };\n\trelease.resolve();\n\tlet response = await pending;\n\tawait finished.promise;\n\texpect(beforeCommit).toEqual({ persisted: false, anchors: 0 });\n\tif (typeof response !== \"string\") throw new Error(\"anchor_plan returned no text\");\n\tlet result = JSON.parse(response);\n\n\texpect(result.ok).toBe(true);\n\texpect(published).toHaveLength(1);\n\texpect(anchors).toBe(1);\n\tlet source = room.project(plan.document);\n\texpect(source.indexOf(\"The renderer caches tiles for 60 seconds.\"))\n\t\t.toBeLessThan(source.indexOf(` {\n\tlet { plan, server } = await opened(\"The plan is ready.\\n\");\n\t(plan as typeof plan & { claiming: boolean }).claiming = true;\n\tlet editPlan = fixtureTools({\n\t\tplan,\n\t\tserver,\n\t\troom: \"test\",\n\t\tpersist: () => Service.persist(plan),\n\t\texclusive: action => Service.exclusive(plan, action),\n\t\tasync publish() {},\n\t\tanchors() {},\n\t\tchanges() {},\n\t}).find(tool => tool.name === \"edit_plan\");\n\tif (!editPlan?.handler) throw new Error(\"edit_plan has no handler\");\n\tlet args = {\n\t\trevision: plan.revision,\n\t\toperations: [{ op: \"replace\", index: 0, source: \"The plan was changed.\\n\" }],\n\t};\n\n\tlet response = await editPlan.handler(args, {\n\t\tsessionId: \"session\",\n\t\ttoolCallId: \"call\",\n\t\ttoolName: \"edit_plan\",\n\t\targuments: args,\n\t});\n\n\texpect(JSON.parse(response as string)).toEqual({ ok: false, reason: \"locked\" });\n\texpect(room.project(plan.document)).toBe(\"The plan is ready.\\n\");\n});\n\ntest(\"anchor_plan keeps same-block decisions in original ask order\", async () => {\n\tlet { plan, server } = await opened(\n\t\tSOURCE.replace(\n\t\t\t` Service.persist(plan),\n\t\texclusive: action => Service.exclusive(plan, action),\n\t\tasync publish() {},\n\t\tanchors() {},\n\t\tchanges() {},\n\t}).find(tool => tool.name === \"anchor_plan\");\n\tif (!anchorPlan?.handler) throw new Error(\"anchor_plan has no handler\");\n\tlet digest = room.digests(plan.document)[1]!;\n\tlet args = {\n\t\trevision: plan.revision,\n\t\tanchors: [\n\t\t\t{ widget: SECOND_WIDGET, question: SECOND_QUESTION, blocks: [{ index: 1, digest }] },\n\t\t\t{ widget: WIDGET, question: QUESTION, blocks: [{ index: 1, digest }] },\n\t\t],\n\t};\n\n\tawait anchorPlan.handler(args, {\n\t\tsessionId: \"session\",\n\t\ttoolCallId: \"call\",\n\t\ttoolName: \"anchor_plan\",\n\t\targuments: args,\n\t});\n\n\tlet source = room.project(plan.document);\n\tlet prose = source.indexOf(\"The renderer caches tiles for 60 seconds.\");\n\tlet first = source.indexOf(` {\n\tlet published: unknown[] = [];\n\tlet { broadcasts, plan, server } = await opened(\"Related prose.\\n\");\n\tlet anchors = 0;\n\tlet created = Promise.withResolvers();\n\tlet ask = fixtureTools({\n\t\tplan,\n\t\tserver,\n\t\troom: \"test\",\n\t\tpersist: () => Service.persist(plan),\n\t\texclusive: action => Service.exclusive(plan, action),\n\t\tpublish: async mutation => {\n\t\t\tpublished.push(mutation);\n\t\t},\n\t\tanchors: () => {\n\t\t\tanchors++;\n\t\t\tcreated.resolve();\n\t\t},\n\t\tchanges() {},\n\t}).find(tool => tool.name === \"ask\");\n\tif (!ask?.handler) throw new Error(\"ask has no handler\");\n\tlet digest = room.digests(plan.document)[0]!;\n\tlet args = {\n\t\trevision: plan.revision,\n\t\tquestions: [{\n\t\t\theader: \"Rollout\",\n\t\t\tquestion: \"How should we deploy?\",\n\t\t\tmultiple: false,\n\t\t\toptions: [{ label: \"Canary\", description: \"Limit exposure.\" }],\n\t\t\tblocks: [{ index: 0, digest }],\n\t\t}],\n\t};\n\tlet response = ask.handler(args, {\n\t\tsessionId: \"session\",\n\t\ttoolCallId: \"call\",\n\t\ttoolName: \"ask\",\n\t\targuments: args,\n\t});\n\tawait created.promise;\n\n\tlet source = room.project(plan.document);\n\texpect(source.indexOf(\"Related prose.\")).toBeLessThan(source.indexOf(\" frame.kind === \"plan:update\")).toBe(true);\n\texpect(anchors).toBe(1);\n\n\tlet record = [...plan.records.values()][0]!;\n\tlet claimed = Store.claimCancel(plan.questions, record.id, \"test\");\n\tif (!claimed.ok) throw new Error(\"could not resolve question\");\n\tStore.commit(plan.questions, claimed.claim);\n\tlet result = await response;\n\texpect(typeof result).toBe(\"string\");\n\texpect(JSON.parse(result as string).outcomes).toEqual([\n\t\t{ status: \"cancelled\", cancelled_by: \"test\" },\n\t]);\n});\n\ntest(\"a stale ask does not announce an anchor snapshot\", async () => {\n\tlet { plan, server } = await opened(\"Related prose.\\n\");\n\tlet anchors = 0;\n\tlet ask = fixtureTools({\n\t\tplan,\n\t\tserver,\n\t\troom: \"test\",\n\t\tpersist: () => Service.persist(plan),\n\t\texclusive: action => Service.exclusive(plan, action),\n\t\tasync publish() {},\n\t\tanchors: () => anchors++,\n\t\tchanges() {},\n\t}).find(tool => tool.name === \"ask\");\n\tif (!ask?.handler) throw new Error(\"ask has no handler\");\n\tlet digest = room.digests(plan.document)[0]!;\n\tlet args = {\n\t\trevision: plan.revision + 1,\n\t\tquestions: [{\n\t\t\theader: \"Rollout\",\n\t\t\tquestion: \"How should we deploy?\",\n\t\t\tmultiple: false,\n\t\t\toptions: [{ label: \"Canary\", description: \"Limit exposure.\" }],\n\t\t\tblocks: [{ index: 0, digest }],\n\t\t}],\n\t};\n\n\tawait ask.handler(args, {\n\t\tsessionId: \"session\",\n\t\ttoolCallId: \"call\",\n\t\ttoolName: \"ask\",\n\t\targuments: args,\n\t});\n\n\texpect(plan.records.size).toBe(0);\n\texpect(anchors).toBe(0);\n});\n\ntest(\"ask refuses to create a questionnaire while implementation is active\", async () => {\n\tlet { plan, server } = await opened(\"Related prose.\\n\");\n\tlet anchors = 0;\n\tlet ask = fixtureTools({\n\t\tplan,\n\t\tserver,\n\t\troom: \"test\",\n\t\tpersist: () => Service.persist(plan),\n\t\texclusive: action => Service.exclusive(plan, action),\n\t\tasync publish() {},\n\t\tanchors: () => anchors++,\n\t\tchanges() {},\n\t}).find(tool => tool.name === \"ask\");\n\tif (!ask?.handler) throw new Error(\"ask is missing\");\n\tlet digest = room.digests(plan.document)[0]!;\n\tlet args = {\n\t\trevision: plan.revision,\n\t\tquestions: [{\n\t\t\theader: \"Rollout\",\n\t\t\tquestion: \"How should we deploy?\",\n\t\t\tmultiple: false,\n\t\t\toptions: [{ label: \"Canary\", description: \"Limit exposure.\" }],\n\t\t\tblocks: [{ index: 0, digest }],\n\t\t}],\n\t};\n\tplan.execution = { id: \"run-1\" } as never;\n\n\tlet response = await ask.handler(args, {\n\t\tsessionId: \"session\",\n\t\ttoolCallId: \"call\",\n\t\ttoolName: \"ask\",\n\t\targuments: args,\n\t});\n\n\texpect(JSON.parse(response as string)).toEqual({ ok: false, reason: \"locked\" });\n\texpect(plan.records.size).toBe(0);\n\texpect(anchors).toBe(0);\n});\n\ntest(\"planner graph edits draft a revision without changing plan prose\", async () => {\n\tlet { plan, server } = await opened(\"Prepare the implementation.\\n\");\n\t// The graph tool is called from inside the planner turn that `chat:send`\n\t// started. That turn is busy by definition; readiness must not mistake it\n\t// for a competing request.\n\tplan.chat.busy = true;\n\tplan.chat.turn = { id: \"turn\", handle: \"ana\", started: 1, responded: false };\n\tlet before = room.project(plan.document);\n\tlet graph = fixtureTools({\n\t\tplan,\n\t\tserver,\n\t\troom: \"test\",\n\t\tpersist: () => Service.persist(plan),\n\t\texclusive: action => Service.exclusive(plan, action),\n\t\tasync publish() {},\n\t\tanchors() {},\n\t\tchanges() {},\n\t}).find(tool => tool.name === \"edit_implementation_graph\");\n\tif (!graph?.handler) throw new Error(\"edit_implementation_graph is missing\");\n\tlet args = {\n\t\tplan_revision: plan.revision,\n\t\tgraph_revision: 0,\n\t\toperations: [{\n\t\t\top: \"add\",\n\t\t\ttask: {\n\t\t\t\tid: \"graph-tools\",\n\t\t\t\ttitle: \"Give the planner constrained graph tools\",\n\t\t\t\tcontext: \"The shared plan is ready for implementation preparation.\",\n\t\t\t\tgoal: \"Create a draft implementation graph beside the plan.\",\n\t\t\t\tacceptance: [\n\t\t\t\t\t\"A draft graph is stored against the plan revision.\",\n\t\t\t\t\t\"The planner does not change plan.mdx.\",\n\t\t\t\t],\n\t\t\t\tdependsOn: [],\n\t\t\t},\n\t\t}],\n\t};\n\tlet response = await graph.handler(args, {\n\t\tsessionId: \"session\",\n\t\ttoolCallId: \"call\",\n\t\ttoolName: \"edit_implementation_graph\",\n\t\targuments: args,\n\t});\n\tif (typeof response !== \"string\") throw new Error(\"graph tool returned no text\");\n\n\texpect(JSON.parse(response)).toMatchObject({\n\t\tok: true,\n\t\tgraph: { versions: [{ state: \"draft\", planRevision: plan.revision }] },\n\t});\n\texpect(plan.graph?.versions[0]?.definition.tasks.map(task => task.id)).toEqual([\"graph-tools\"]);\n\texpect(room.project(plan.document)).toBe(before);\n\n\tlet stale = await graph.handler({ ...args, graph_revision: 0 }, {\n\t\tsessionId: \"session\",\n\t\ttoolCallId: \"later\",\n\t\ttoolName: \"edit_implementation_graph\",\n\t\targuments: args,\n\t});\n\texpect(JSON.parse(stale as string)).toEqual({ ok: false, reason: \"stale-graph\" });\n\texpect(room.project(plan.document)).toBe(before);\n});\n\ntest(\"chat-started tools retain only the current member request provenance\", async () => {\n\tlet { plan, server, storage, channel } = await opened(\"Prepare the implementation.\\n\");\n\tlet now = new Date();\n\tlet tools = fixtureTools({\n\t\tplan,\n\t\tserver,\n\t\troom: \"test\",\n\t\tpersist: () => Service.persist(plan),\n\t\texclusive: action => Service.exclusive(plan, action),\n\t\tasync publish() {},\n\t\tanchors() {},\n\t\tchanges() {},\n\t});\n\tlet graph = tools.find(tool => tool.name === \"edit_implementation_graph\");\n\tif (!graph?.handler) throw new Error(\"edit_implementation_graph is missing\");\n\tlet args = {\n\t\tplan_revision: plan.revision,\n\t\tgraph_revision: 0,\n\t\toperations: [{\n\t\t\top: \"add\",\n\t\t\ttask: {\n\t\t\t\tid: \"chat-graph\",\n\t\t\t\ttitle: \"Draft from the chat turn\",\n\t\t\t\tcontext: \"The planner turn began from the room conversation.\",\n\t\t\t\tgoal: \"Create a graph while the planner is busy.\",\n\t\t\t\tacceptance: [\"The graph is drafted.\", \"The chat turn can complete.\"],\n\t\t\t\tdependsOn: [],\n\t\t\t},\n\t\t}],\n\t};\n\tlet response: string | undefined;\n\tlet firstStarted = Promise.withResolvers();\n\tlet continueFirst = Promise.withResolvers();\n\tlet sent = Promise.withResolvers();\n\tlet activeRequests: Array = [];\n\tlet researchRequests: Array>[0]> = [];\n\tlet researchResponses: string[] = [];\n\tlet destroyed = 0;\n\tlet researchTool: ReturnType[number] | undefined;\n\tlet key = new Uint8Array(32).fill(7);\n\tlet sessions = new Sessions(storage, true, () => now);\n\tlet claimant = await sessions.issue(\"U_test\", {\n\t\taccessToken: \"gho_test\",\n\t\taccessExpiresIn: 28_800,\n\t\trefreshToken: \"ghr_test\",\n\t\trefreshExpiresIn: 15_897_600,\n\t});\n\tlet queuedClaimant = await sessions.issue(\"U_test\", {\n\t\taccessToken: \"gho_queued\",\n\t\taccessExpiresIn: 28_800,\n\t\trefreshToken: \"ghr_queued\",\n\t\trefreshExpiresIn: 15_897_600,\n\t});\n\tlet repository = { id: \"R_test\", owner: \"owner\", name: \"repository\", defaultBranch: \"main\" };\n\tlet config = {\n\t\torigin: \"https://test\",\n\t\tappSlug: \"chopin-test\",\n\t\tclientId: \"id\",\n\t\tclientSecret: \"secret\",\n\t\tencryptionKey: key,\n\t};\n\tlet github = {\n\t\tasync repositoryAccess() {\n\t\t\treturn {\n\t\t\t\t...repository,\n\t\t\t\tfullName: \"owner/repository\",\n\t\t\t\tprivate: true,\n\t\t\t\turl: \"\",\n\t\t\t\tpermissions: { pull: true, push: true, admin: false },\n\t\t\t};\n\t\t},\n\t} as never;\n\tlet auth: HostedAuth = {\n\t\tconfig,\n\t\tstorage,\n\t\tgithub,\n\t\tadmission: new Admission(config, github, () => now.getTime()),\n\t\tsessions,\n\t\tclock: () => now,\n\t};\n\tlet ownership = await Chat.resolveOwner(auth, repository, channel.id, claimant.id);\n\tlet activeOwner = () =>\n\t\tPromise.resolve({\n\t\t\tchannelId: channel.id,\n\t\t\ttoken: \"gho_test\",\n\t\t\trepository,\n\t\t\townerSessionId: claimant.id,\n\t\t\townerGeneration: ownership.ownership.generation,\n\t\t\tcredentialRevision: ownership.owner.access.revision,\n\t\t\texpiresAt: ownership.owner.access.expiresAt,\n\t\t\tsignal: new AbortController().signal,\n\t\t\tcurrentToken: () => \"gho_test\",\n\t\t\trevalidate: async () => true,\n\t\t\trelease() {},\n\t\t});\n\tlet context: Chat.Room = {\n\t\tchat: plan.chat,\n\t\tplan,\n\t\tserver,\n\t\troom: channel.id,\n\t\tconfig: { agent: true } as Config,\n\t\tauth,\n\t\tclaimantSessionId: claimant.id,\n\t\trepository,\n\t\tpersist: () => Service.persist(plan),\n\t\tactiveOwner,\n\t\topenPlannerSession: async () => ({\n\t\t\tok: true,\n\t\t\tvalue: {\n\t\t\t\tstream: async (_prompt, _signal) =>\n\t\t\t\t\t({\n\t\t\t\t\t\tfullStream: (async function*() {\n\t\t\t\t\t\t\tlet active = plan.chat.activeRequest;\n\t\t\t\t\t\t\tactiveRequests.push(active ? { ...active } : undefined);\n\t\t\t\t\t\t\tlet turn = activeRequests.length;\n\t\t\t\t\t\t\tif (turn === 1) {\n\t\t\t\t\t\t\t\tfirstStarted.resolve();\n\t\t\t\t\t\t\t\tawait continueFirst.promise;\n\t\t\t\t\t\t\t\tlet result = await graph.handler!(args, { toolCallId: \"call\" });\n\t\t\t\t\t\t\t\tif (typeof result !== \"string\") throw new Error(\"graph tool returned no text\");\n\t\t\t\t\t\t\t\tresponse = result;\n\t\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t\tif (!researchTool?.handler) throw new Error(\"research tool is missing\");\n\t\t\t\t\t\t\t\tlet question = \"Which public release evidence supports adopting version 3?\";\n\t\t\t\t\t\t\t\tlet attempts = turn === 2 ? 2 : 1;\n\t\t\t\t\t\t\t\tfor (let attempt = 0; attempt < attempts; attempt++) {\n\t\t\t\t\t\t\t\t\tlet result = await researchTool.handler({ question }, {\n\t\t\t\t\t\t\t\t\t\ttoolCallId: `research-${turn}-${attempt}`,\n\t\t\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\t\t\tif (typeof result !== \"string\") throw new Error(\"research tool returned no text\");\n\t\t\t\t\t\t\t\t\tresearchResponses.push(result);\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tyield { type: \"finish\" };\n\t\t\t\t\t\t\tif (turn === 3) sent.resolve();\n\t\t\t\t\t\t})(),\n\t\t\t\t\t}) as never,\n\t\t\t\tasync destroy() {\n\t\t\t\t\tdestroyed++;\n\t\t\t\t},\n\t\t\t},\n\t\t}),\n\t\tcreateResearch: async request => {\n\t\t\tresearchRequests.push(request);\n\t\t\treturn {\n\t\t\t\tworkspaceId: \"workspace-1\",\n\t\t\t\tstate: \"pending\",\n\t\t\t\tstage: \"queued\",\n\t\t\t};\n\t\t},\n\t};\n\tlet { id: _id, ...documentContext } = Chat.documentRoom(context);\n\tresearchTool = fixtureTools({ ...documentContext, room: context.room })\n\t\t.find(tool => tool.name === \"create_research_workspace\");\n\n\tawait Chat.send(\n\t\tcontext,\n\t\t{ data: { handle: \"ana\", principalId: \"U_test\" }, send() {} } as unknown as Socket,\n\t\t{\n\t\t\tkind: \"chat:send\",\n\t\t\trid: \"request\",\n\t\t\trequestId: crypto.randomUUID(),\n\t\t\ttext: \"prepare implementation\",\n\t\t\tto: \"planner\",\n\t\t\tts: 0,\n\t\t},\n\t);\n\tlet running = plan.chat.running;\n\tawait firstStarted.promise;\n\tlet queuedContext = { ...context, claimantSessionId: queuedClaimant.id };\n\tawait Chat.send(\n\t\tqueuedContext,\n\t\t{ data: { handle: \"bob\", principalId: \"U_bob\" }, send() {} } as unknown as Socket,\n\t\t{\n\t\t\tkind: \"chat:send\",\n\t\t\trid: \"queued\",\n\t\t\trequestId: crypto.randomUUID(),\n\t\t\ttext: \"@chopin start research on version 3 adoption\",\n\t\t\tto: \"planner\",\n\t\t\tts: 0,\n\t\t},\n\t);\n\tlet queuedEntryId = plan.chat.waiting[0]!.id;\n\tawait Chat.instruct(\n\t\tcontext,\n\t\t\"ana\",\n\t\t\"Act on the accepted comment.\",\n\t\t\"@ana accepted a comment.\",\n\t);\n\tlet error = spyOn(console, \"error\").mockImplementation(() => {});\n\tcontinueFirst.resolve();\n\tawait sent.promise;\n\tawait running;\n\tif (!researchTool?.handler) throw new Error(\"research tool is missing\");\n\tlet stale = await researchTool.handler({ question: \"Search again\" }, {\n\t\tsessionId: \"session\",\n\t\ttoolCallId: \"research-stale\",\n\t\ttoolName: \"create_research_workspace\",\n\t\targuments: { question: \"Search again\" },\n\t});\n\tif (typeof stale !== \"string\") throw new Error(\"research tool returned no text\");\n\tresearchResponses.push(stale);\n\terror.mockRestore();\n\n\texpect(JSON.parse(response ?? \"\")).toMatchObject({\n\t\tok: true,\n\t\tgraph: { versions: [{ state: \"draft\", planRevision: 0 }] },\n\t});\n\texpect(plan.graph?.versions[0]?.definition.tasks.map(task => task.id)).toEqual([\"chat-graph\"]);\n\texpect(activeRequests).toHaveLength(3);\n\texpect(activeRequests[0]).toMatchObject({\n\t\tentryId: plan.chat.entries.find(entry => entry.text === \"prepare implementation\")?.id,\n\t\tuserId: \"U_test\",\n\t\thandle: \"ana\",\n\t\ttext: \"prepare implementation\",\n\t\tclaimantSessionId: claimant.id,\n\t\tlifecycle: 0,\n\t});\n\texpect(activeRequests[1]).toMatchObject({\n\t\tentryId: queuedEntryId,\n\t\tuserId: \"U_bob\",\n\t\thandle: \"bob\",\n\t\ttext: \"start research on version 3 adoption\",\n\t\tclaimantSessionId: queuedClaimant.id,\n\t\tlifecycle: 0,\n\t});\n\texpect(activeRequests[0]?.turnId).not.toBe(activeRequests[1]?.turnId);\n\texpect(activeRequests[2]).toBeUndefined();\n\texpect(researchRequests).toEqual([\n\t\t{\n\t\t\tentryId: queuedEntryId,\n\t\t\tuserId: \"U_bob\",\n\t\t\thandle: \"bob\",\n\t\t\ttext: \"start research on version 3 adoption\",\n\t\t\tquestion: \"start research on version 3 adoption\",\n\t\t},\n\t\t{\n\t\t\tentryId: queuedEntryId,\n\t\t\tuserId: \"U_bob\",\n\t\t\thandle: \"bob\",\n\t\t\ttext: \"start research on version 3 adoption\",\n\t\t\tquestion: \"start research on version 3 adoption\",\n\t\t},\n\t]);\n\texpect(researchResponses.slice(0, 2).map(value => JSON.parse(value))).toEqual([\n\t\texpect.objectContaining({ workspaceId: \"workspace-1\", state: \"pending\", stage: \"queued\" }),\n\t\texpect.objectContaining({ workspaceId: \"workspace-1\", state: \"pending\", stage: \"queued\" }),\n\t]);\n\texpect(researchResponses[2]).toContain(\n\t\t\"Error: research workspaces require the explicit member message\",\n\t);\n\texpect(researchResponses[3]).toContain(\n\t\t\"Error: research workspaces require the explicit member message\",\n\t);\n\texpect(plan.chat.activeRequest).toBeUndefined();\n\tlet referenceId = ulid();\n\tlet referenceReads: unknown[] = [];\n\tplan.chat.referenceCache.set(referenceId, { id: referenceId } as never);\n\tcontext.references = {\n\t\tread: async (input: unknown) => {\n\t\t\treferenceReads.push(input);\n\t\t\treturn { source: \"reference\" };\n\t\t},\n\t} as never;\n\tlet reference = await documentTools.read_reference.execute!({ id: referenceId }, {\n\t\tcontext: { room: Chat.documentRoom(context), repository: { id: \"R_call\" } },\n\t\ttoolCallId: \"reference\",\n\t\tmessages: [],\n\t});\n\texpect(reference).toContain(\"reference\");\n\texpect(referenceReads).toMatchObject([{\n\t\tchannelId: channel.id,\n\t\trepositoryId: \"R_call\",\n\t\treference: { id: referenceId },\n\t}]);\n});\n\ntest(\"planner graph edits name readiness blockers before changing a graph\", async () => {\n\tlet { plan, server } = await opened(\"Prepare the implementation.\\n\");\n\tplan.records.set(\"open\", {\n\t\tid: \"open\",\n\t\tstatus: \"open\",\n\t\tdefinition: {\n\t\t\tquestions: [{\n\t\t\t\tid: \"question\",\n\t\t\t\theader: \"Readiness\",\n\t\t\t\tquestion: \"May implementation begin?\",\n\t\t\t\tmultiple: false,\n\t\t\t\toptions: [{ id: \"yes\", label: \"Yes\", description: \"\" }],\n\t\t\t}],\n\t\t},\n\t} as never);\n\tlet graph = fixtureTools({\n\t\tplan,\n\t\tserver,\n\t\troom: \"test\",\n\t\tpersist: () => Service.persist(plan),\n\t\texclusive: action => Service.exclusive(plan, action),\n\t\tasync publish() {},\n\t\tanchors() {},\n\t\tchanges() {},\n\t}).find(tool => tool.name === \"edit_implementation_graph\");\n\tif (!graph?.handler) throw new Error(\"edit_implementation_graph is missing\");\n\tlet args = {\n\t\tplan_revision: plan.revision,\n\t\tgraph_revision: 0,\n\t\toperations: [{\n\t\t\top: \"add\",\n\t\t\ttask: {\n\t\t\t\tid: \"blocked\",\n\t\t\t\ttitle: \"Blocked graph\",\n\t\t\t\tcontext: \"The plan still has an open decision.\",\n\t\t\t\tgoal: \"Demonstrate that preparation is refused.\",\n\t\t\t\tacceptance: [\"The tool names the blocker.\", \"No graph is created.\"],\n\t\t\t\tdependsOn: [],\n\t\t\t},\n\t\t}],\n\t};\n\tlet response = await graph.handler(args, {\n\t\tsessionId: \"session\",\n\t\ttoolCallId: \"call\",\n\t\ttoolName: \"edit_implementation_graph\",\n\t\targuments: args,\n\t});\n\n\texpect(JSON.parse(response as string)).toEqual({\n\t\tok: false,\n\t\treason: \"not-ready\",\n\t\tblockers: [\"unanswered questionnaires\"],\n\t});\n\texpect(plan.graph).toBeUndefined();\n});\n","editable",false,"branch","documentNavigation","repo","githubnext/chopin","repoId","7d1a8ac3-35b0-4dea-85d4-06a980f3bada","ownerId","org:89615882","site","nexthub","private","admin","settings","maintainer","triage","starred","stars",0,"watchers","watching","pinned","notify","views",[183,184,185,186,187,188,189,190,191,192,193,194,195],"navigation",{"_54":55,"_139":140,"_141":142,"_143":144,"_145":146,"_147":148,"_149":150},"sources",[],"viewer","meta",{"_131":132,"_133":134,"_135":136,"_42":31,"_137":126,"_138":31,"_48":49,"_50":49},"branches",[73,74,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],"tags",[69,70,71,72],"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",[165,166,167],"documents",{"_160":161,"_162":163},"code",{"_156":157,"_158":159},"automations",{"_153":154,"_155":-5},"delivery",{"_151":49,"_152":-5},"tag","04zvKQ8QOrDUF8TO1Ovz0Zy8_TT","releases","applications","workflows",3,"deployments","commits",1000,"changes",13,"counts",{"_164":163},"total",11,"issue",{"_168":158,"_170":181,"_15":158,"_172":182,"_52":174,"_175":31,"_176":174,"_177":159},{"_168":178,"_170":179,"_15":178,"_172":180,"_52":174,"_175":31,"_176":174,"_177":49},{"_168":169,"_170":171,"_15":169,"_172":173,"_52":174,"_175":31,"_176":174,"_177":163},"id","issues","name","Issues","filters",{},true,"saved","pinnable","count","tasks","Tasks",{},"Changes",{},{"_168":158,"_170":181,"_15":158,"_172":226,"_52":174,"_175":31,"_176":174},{"_168":178,"_170":179,"_15":178,"_172":225,"_52":174,"_175":31,"_176":174},{"_168":169,"_170":171,"_15":169,"_172":224,"_52":174,"_175":31,"_176":174},{"_168":221,"_170":222,"_15":221,"_172":223,"_52":31,"_175":31,"_176":174},{"_168":218,"_170":219,"_15":218,"_172":220,"_52":31,"_175":31,"_176":174},{"_168":153,"_170":216,"_15":145,"_172":217,"_52":31,"_175":31,"_176":174},{"_168":155,"_170":213,"_15":214,"_172":215,"_52":31,"_175":31,"_176":174},{"_168":151,"_170":211,"_15":151,"_172":212,"_52":31,"_175":31,"_176":174},{"_168":207,"_170":208,"_15":209,"_172":210,"_52":31,"_175":31,"_176":174},{"_168":141,"_170":205,"_15":141,"_172":206,"_52":31,"_175":31,"_176":31},{"_168":202,"_170":203,"_15":202,"_172":204,"_52":31,"_175":31,"_176":31},{"_168":199,"_170":200,"_15":199,"_172":201,"_52":31,"_175":31,"_176":31},{"_168":196,"_170":197,"_15":196,"_172":198,"_52":31,"_175":31,"_176":31},"decisions","Decisions",{},"changelog","Changelog",{},"roadmap","Roadmap",{},"Documents",{},"activity","Activity","insights",{},"Releases",{},"Deployments","automations/deployments",{},"Workflows",{},"discussions","Discussions",{},"goals","Goals",{},{},{},{},"groups","user","agents",[],"now",1794440208955,"sidebar","expanded"]