[{"_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","beb8a54dca3abf74ad8c9e2f0eecf8ef1e3e720e","path","apps/server/src/agent/client.ts","oid","7153cb084186db3b563eeacf427eb734c27346f0","size",12345,"commit","mounts",[],"source","plain",{"_13":14,"_15":16},"kind","text","/**\n * Starting the agent.\n *\n * Disposable Planner and worker sessions share one hardened runtime. A\n * restarted process reconstructs context from durable Chopin state rather\n * than resuming Copilot's filesystem state.\n */\n\nimport { CopilotClient, RuntimeConnection } from \"@github/copilot-sdk\";\nimport { mkdtempSync, rmSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\n\nimport { locate } from \"./cli\";\nimport { gate, publicResearchGate, terminalGate } from \"./permissions\";\nimport { NAME, plannerFor, TOOLS } from \"./planner\";\nimport { Runtime } from \"./runtime\";\n\nimport type { CopilotSession, CustomAgentConfig, SessionConfig, Tool } from \"@github/copilot-sdk\";\nimport type { Config } from \"../config\";\nimport type { HostedRepository } from \"./repository\";\n\nexport type Agent = {\n\tsession: CopilotSession;\n\t/** Runtime identity used only to delete the disposable SDK session. */\n\tid: string;\n};\n\n/** The tools a planner may call, over and above the runtime's own. */\nexport type Toolbox = { tools: Tool[] };\n\nexport type PlannerSession = {\n\ttoken: string;\n\trepository: HostedRepository;\n\tbootstrap?: string;\n\tauthorize?: () => Promise;\n};\n\nexport type WorkerSession = {\n\ttoken: string;\n\tname: string;\n\tprompt: string;\n\tresult: Tool;\n\tmaxAiCredits: number;\n\tauthorize?: () => Promise;\n};\n\nconst SESSION_CONTROL_TIMEOUT_MS = 10_000;\n\nfunction bounded(operation: Promise, message: string): Promise {\n\treturn new Promise((resolve, reject) => {\n\t\tlet timer = setTimeout(() => reject(new Error(message)), SESSION_CONTROL_TIMEOUT_MS);\n\t\toperation.then(\n\t\t\tvalue => {\n\t\t\t\tclearTimeout(timer);\n\t\t\t\tresolve(value);\n\t\t\t},\n\t\t\terr => {\n\t\t\t\tclearTimeout(timer);\n\t\t\t\treject(err);\n\t\t\t},\n\t\t);\n\t});\n}\n\nfunction hardened(config: Pick, token: string): SessionConfig {\n\treturn {\n\t\tmodel: config.model,\n\t\tlargeOutput: { enabled: false },\n\t\tgitHubToken: token,\n\t\tenableConfigDiscovery: false,\n\t\tskipCustomInstructions: true,\n\t\tenableOnDemandInstructionDiscovery: false,\n\t\tenableFileHooks: false,\n\t\tenableHostGitOperations: false,\n\t\tenableSessionStore: false,\n\t\tenableSkills: false,\n\t\tskillDirectories: [],\n\t\tpluginDirectories: [],\n\t\tinfiniteSessions: { enabled: false },\n\t\tskipEmbeddingRetrieval: true,\n\t\tembeddingCacheStorage: \"in-memory\",\n\t\tmcpOAuthTokenStorage: \"in-memory\",\n\t\tenableSessionTelemetry: false,\n\t\tremoteSession: \"off\",\n\t} as SessionConfig;\n}\n\nexport function plannerConfiguration(\n\tconfig: Pick,\n\ttoolbox: Toolbox,\n\toptions: PlannerSession,\n): SessionConfig {\n\tlet repository = `${options.repository.owner}/${options.repository.name}`;\n\tlet tools = toolbox.tools.map(tool => ({ ...tool, skipPermission: false }));\n\treturn {\n\t\t...hardened(config, options.token),\n\t\tstreaming: true,\n\t\tavailableTools: TOOLS,\n\t\ttools,\n\t\tcustomAgents: [plannerFor(repository)],\n\t\tagent: NAME,\n\t\tmcpServers: {\n\t\t\tgithub: {\n\t\t\t\ttype: \"http\",\n\t\t\t\turl: \"https://api.githubcopilot.com/mcp/\",\n\t\t\t\ttools: [\"*\"],\n\t\t\t\theaders: {\n\t\t\t\t\tAuthorization: `Bearer ${options.token}`,\n\t\t\t\t\t\"X-MCP-Readonly\": \"true\",\n\t\t\t\t\t\"X-MCP-Toolsets\": \"pull_requests\",\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\tsystemMessage: {\n\t\t\tmode: \"append\",\n\t\t\tcontent: [\n\t\t\t\t`The selected repository is ${repository}. Repository reads must remain inside it.`,\n\t\t\t\t\"More than one person may be in this conversation; their messages are prefixed with the speaker's handle.\",\n\t\t\t\toptions.bootstrap ?? \"\",\n\t\t\t].filter(Boolean).join(\" \"),\n\t\t},\n\t\tonPermissionRequest: gate({\n\t\t\towner: options.repository.owner,\n\t\t\trepository: options.repository.name,\n\t\t\ttools: new Set(tools.map(tool => tool.name)),\n\t\t\tactive: options.authorize,\n\t\t}),\n\t} as SessionConfig;\n}\n\nexport function workerConfiguration(\n\tconfig: Pick,\n\toptions: WorkerSession,\n): SessionConfig {\n\tif (!Number.isFinite(options.maxAiCredits) || options.maxAiCredits <= 0) {\n\t\tthrow new Error(\"Background worker maxAiCredits must be finite and positive.\");\n\t}\n\tlet result = { ...options.result, skipPermission: false, isTerminal: true };\n\tlet worker: CustomAgentConfig = {\n\t\tname: options.name,\n\t\tdisplayName: \"Background worker\",\n\t\tdescription: \"Executes one registered background job and submits its structured result.\",\n\t\tprompt: options.prompt,\n\t\tinfer: false,\n\t};\n\treturn {\n\t\t...hardened(config, options.token),\n\t\tstreaming: false,\n\t\tsessionLimits: { maxAiCredits: options.maxAiCredits },\n\t\tavailableTools: [`custom:${result.name}`],\n\t\ttools: [result],\n\t\tcustomAgents: [worker],\n\t\tagent: worker.name,\n\t\tmcpServers: {},\n\t\tonPermissionRequest: terminalGate(result.name, options.authorize),\n\t} as SessionConfig;\n}\n\nexport function publicResearchConfiguration(\n\tconfig: Pick,\n\toptions: WorkerSession,\n): SessionConfig {\n\tif (!Number.isFinite(options.maxAiCredits) || options.maxAiCredits <= 0) {\n\t\tthrow new Error(\"Background worker maxAiCredits must be finite and positive.\");\n\t}\n\tlet result = { ...options.result, skipPermission: false, isTerminal: true };\n\tlet worker: CustomAgentConfig = {\n\t\tname: options.name,\n\t\tdisplayName: \"Public research worker\",\n\t\tdescription: \"Researches public web evidence without private Chopin or repository context.\",\n\t\tprompt: options.prompt,\n\t\tinfer: false,\n\t};\n\treturn {\n\t\t...hardened(config, options.token),\n\t\tstreaming: false,\n\t\tsessionLimits: { maxAiCredits: options.maxAiCredits },\n\t\tavailableTools: [\n\t\t\t`custom:${result.name}`,\n\t\t\t\"mcp:github-web_search\",\n\t\t],\n\t\ttools: [result],\n\t\tcustomAgents: [worker],\n\t\tagent: worker.name,\n\t\tmcpServers: {\n\t\t\tgithub: {\n\t\t\t\ttype: \"http\",\n\t\t\t\turl: \"https://api.githubcopilot.com/mcp/\",\n\t\t\t\ttools: [\"web_search\"],\n\t\t\t\theaders: {\n\t\t\t\t\tAuthorization: `Bearer ${options.token}`,\n\t\t\t\t\t\"X-MCP-Readonly\": \"true\",\n\t\t\t\t\t\"X-MCP-Tools\": \"web_search\",\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\tonPermissionRequest: publicResearchGate(result.name, options.authorize),\n\t} as SessionConfig;\n}\n\nfunction connect() {\n\tlet cli = locate();\n\tif (!cli.ok) throw new Error(cli.reason);\n\tlet home = mkdtempSync(join(tmpdir(), \"chopin-copilot-\"));\n\ttry {\n\t\tlet client = new CopilotClient({\n\t\t\tmode: \"empty\",\n\t\t\tworkingDirectory: home,\n\t\t\tbaseDirectory: home,\n\t\t\tconnection: RuntimeConnection.forStdio({ path: cli.path }),\n\t\t\tuseLoggedInUser: false,\n\t\t\tenv: {},\n\t\t\tlogLevel: \"info\",\n\t\t});\n\t\treturn { client, cleanup: () => rmSync(home, { recursive: true, force: true }) };\n\t} catch (err) {\n\t\trmSync(home, { recursive: true, force: true });\n\t\tthrow err;\n\t}\n}\n\nlet runtime = new Runtime(connect);\n\n/**\n * Report what the planner can actually call.\n *\n * A tool filter is matched against names by the runtime, and an entry that\n * matches nothing is dropped without a word. There is no other place that\n * truth is visible: the agent simply behaves as though it never had the tool,\n * and explains its way around the absence rather than reporting it — which is\n * how a planner can spend a turn apologising for having no GitHub access while\n * its prompt insists it has.\n *\n * Runs against a real session rather than the boot probe, because the probe\n * has no room and therefore none of the plan tools; auditing it would report a\n * set nobody ever gets. Costs one line per session, and is never fatal — a\n * diagnostic that can stop a turn is worse than no diagnostic.\n */\nasync function audit(session: CopilotSession): Promise {\n\ttry {\n\t\tawait session.rpc.tools.initializeAndValidate();\n\t\tlet { tools } = await session.rpc.tools.getCurrentMetadata();\n\n\t\tif (!tools) {\n\t\t\tconsole.warn(\"[agent] the tool list is not initialised\");\n\t\t} else {\n\t\t\tlet names = tools.map(tool => tool.namespacedName || tool.name).sort();\n\t\t\tconsole.log(`[agent] ${names.length} tools: ${names.join(\", \")}`);\n\t\t}\n\t} catch (err) {\n\t\tconsole.warn(\"[agent] could not read the tool list:\", err);\n\t}\n\n\ttry {\n\t\t// Throws when the server never connected, which is the distinction\n\t\t// worth having: no tools because none were offered, or no tools\n\t\t// because the ones offered were not matched.\n\t\tlet { tools } = await session.rpc.mcp.listTools({ serverName: \"github\" });\n\t\tconsole.log(`[agent] github mcp: ${tools.length} tools offered`);\n\t} catch (err) {\n\t\tlet reason = err instanceof Error ? err.message : String(err);\n\t\tconsole.warn(`[agent] github mcp is not connected: ${reason}`);\n\t}\n}\n\nexport function assertWorkerTools(names: string[], expected: string | string[]): void {\n\tlet wanted = (typeof expected === \"string\" ? [`custom:${expected}`] : expected).toSorted();\n\tlet matches = names.length === wanted.length\n\t\t&& names.every((name, index) => name === wanted[index]);\n\tif (!matches) {\n\t\tthrow new Error(\n\t\t\t`Background worker capability audit failed: expected ${wanted.join(\", \")}, received ${\n\t\t\t\tnames.length > 0 ? names.join(\", \") : \"none\"\n\t\t\t}.`,\n\t\t);\n\t}\n}\n\nasync function auditWorker(session: CopilotSession, expected: string): Promise {\n\tawait session.rpc.tools.initializeAndValidate();\n\tlet { tools } = await session.rpc.tools.getCurrentMetadata();\n\tlet names = tools?.map(tool => tool.namespacedName || `unqualified:${tool.name}`).sort() ?? [];\n\tassertWorkerTools(names, expected);\n}\n\nasync function auditPublicResearchWorker(session: CopilotSession, expected: string): Promise {\n\tawait session.rpc.tools.initializeAndValidate();\n\tlet { tools } = await session.rpc.tools.getCurrentMetadata();\n\tlet names = tools?.map(tool => tool.namespacedName || `unqualified:${tool.name}`).sort() ?? [];\n\tassertWorkerTools(names, [\n\t\t`custom:${expected}`,\n\t\t\"mcp:github-web_search\",\n\t]);\n}\n\n/** Create a disposable session authenticated and scoped to one owner and repository. */\nexport async function openPlanner(\n\tconfig: Pick,\n\ttoolbox: Toolbox,\n\toptions: PlannerSession,\n): Promise {\n\tif (!config.agent) throw new Error(\"The hosted agent is disabled.\");\n\tlet session = await runtime.open(plannerConfiguration(config, toolbox, options));\n\ttry {\n\t\tawait session.rpc.agent.select({ name: NAME });\n\t\tawait audit(session);\n\t\treturn { session, id: session.sessionId };\n\t} catch (err) {\n\t\tawait runtime.discard(session).catch(() => {});\n\t\tthrow err;\n\t}\n}\n\n/** Create a disposable isolated session for one registered background attempt. */\nexport async function openWorker(\n\tconfig: Pick,\n\toptions: WorkerSession,\n): Promise {\n\tif (!config.agent) throw new Error(\"The hosted agent is disabled.\");\n\tlet session = await runtime.open(workerConfiguration(config, options));\n\ttry {\n\t\tawait session.rpc.agent.select({ name: options.name });\n\t\tawait auditWorker(session, options.result.name);\n\t\treturn { session, id: session.sessionId };\n\t} catch (err) {\n\t\tawait runtime.discard(session).catch(() => {});\n\t\tthrow err;\n\t}\n}\n\n/** Create a public-web worker with no private document or repository capabilities. */\nexport async function openPublicResearchWorker(\n\tconfig: Pick,\n\toptions: WorkerSession,\n): Promise {\n\tif (!config.agent) throw new Error(\"The hosted agent is disabled.\");\n\tlet session = await runtime.open(publicResearchConfiguration(config, options));\n\ttry {\n\t\tawait session.rpc.agent.select({ name: options.name });\n\t\tawait auditPublicResearchWorker(session, options.result.name);\n\t\treturn { session, id: session.sessionId };\n\t} catch (err) {\n\t\tawait runtime.discard(session).catch(() => {});\n\t\tthrow err;\n\t}\n}\n\nexport async function discard(agent: Agent): Promise {\n\tlet owned: boolean;\n\ttry {\n\t\towned = await runtime.discard(agent.session);\n\t} catch {\n\t\treturn;\n\t}\n\tif (!owned) await agent.session.disconnect().catch(() => {});\n}\n\n/** Bound an SDK abort so runtime shutdown can still force a wedged session down. */\nexport async function abort(agent: Agent): Promise {\n\tawait bounded(\n\t\tPromise.resolve().then(() => agent.session.abort()),\n\t\t`Copilot session ${agent.id} abort timed out.`,\n\t).catch(() => {});\n}\n\n/** Stop waiting for an opening session, and dispose it if it arrives later. */\nexport async function settle(opening: Promise): Promise {\n\tlet expired = false;\n\tlet watched = opening.then(agent => {\n\t\tif (expired) void discard(agent);\n\t\treturn agent;\n\t}, () => undefined);\n\tlet opened = await bounded(watched, \"Copilot session opening timed out.\").catch(() => undefined);\n\texpired = true;\n\treturn opened;\n}\n\n/** Close every remaining session and let go of the CLI process. */\nexport async function shutdown(): Promise {\n\tawait runtime.shutdown();\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",1794462141385,"sidebar","expanded"]