[{"_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","1d19c708111be8ff610bbab1eb2d84dca93cafeb","path","apps/server/src/harness/github-tools.ts","oid","bc7c1f8d3776dd0bfcc04263320efabc1f8bd5a9","size",10230,"commit","mounts",[],"source","plain",{"_13":14,"_15":16},"kind","text","import { createMCPClient } from \"@ai-sdk/mcp\";\nimport { tool } from \"ai\";\nimport { z } from \"zod\";\n\nimport type { MCPClientConfig } from \"@ai-sdk/mcp\";\nimport type { Tool, ToolSet } from \"ai\";\n\nimport type { ActiveOwnerBinding } from \"../agent/active-owner\";\nimport type { HostedRepository } from \"../agent/repository\";\n\nconst MCP_URL = \"https://api.githubcopilot.com/mcp/\";\n\nexport type GitHubToolsError =\n\t| { kind: \"Unavailable\"; cause: unknown }\n\t| { kind: \"MissingTool\"; name: string };\n\nexport type Result = { ok: true; value: T } | { ok: false; error: E };\n\n/**\n * `schemas` loads only these tools from the remote GitHub MCP server. Descriptions\n * are Chopin's own, never the remote server's; both schemas omit `owner`/`repo` because\n * `bindRepository` supplies them from call-time context, not model input.\n */\nexport const GITHUB_TOOL_SCHEMAS = {\n\tlist_pull_requests: {\n\t\tinputSchema: z.object({\n\t\t\tstate: z.string().optional(),\n\t\t\tbase: z.string().optional(),\n\t\t\thead: z.string().optional(),\n\t\t\tsort: z.string().optional(),\n\t\t\tdirection: z.string().optional(),\n\t\t\tpage: z.number().optional(),\n\t\t\tperPage: z.number().optional(),\n\t\t}),\n\t},\n\tpull_request_read: {\n\t\tinputSchema: z.object({\n\t\t\tmethod: z.enum([\n\t\t\t\t\"get\",\n\t\t\t\t\"get_diff\",\n\t\t\t\t\"get_status\",\n\t\t\t\t\"get_files\",\n\t\t\t\t\"get_commits\",\n\t\t\t\t\"get_review_comments\",\n\t\t\t\t\"get_reviews\",\n\t\t\t\t\"get_comments\",\n\t\t\t\t\"get_check_runs\",\n\t\t\t]),\n\t\t\tpullNumber: z.number(),\n\t\t\tpage: z.number().optional(),\n\t\t\tperPage: z.number().optional(),\n\t\t\tafter: z.string().optional(),\n\t\t}),\n\t},\n} as const;\n\nconst GITHUB_TOOL_DESCRIPTIONS: Record = {\n\tlist_pull_requests: \"List pull requests in the selected repository.\",\n\tpull_request_read: \"Read one pull request in the selected repository: its details, diff, status, \"\n\t\t+ \"changed files, commits, review comments, reviews, issue comments, or check runs.\",\n};\n\nconst RepositoryContextSchema = z.object({\n\trepository: z.custom(),\n});\n\nclass MissingToolError extends Error {\n\tconstructor(readonly toolName: string) {\n\t\tsuper(`GitHub tool ${toolName} is unavailable`);\n\t}\n}\n\n/**\n * Rebuilds each tool with Chopin's own description and overwrites `owner`/`repo`\n * from `context.repository`. All other input fields pass through verbatim.\n */\nexport function bindRepository(tools: ToolSet, descriptions: Record): ToolSet {\n\tlet bound: ToolSet = {};\n\tfor (let [name, source] of Object.entries(tools)) {\n\t\tlet description = descriptions[name];\n\t\tlet execute = source.execute;\n\t\tif (description === undefined || !execute) throw new MissingToolError(name);\n\t\tbound[name] = tool({\n\t\t\tdescription,\n\t\t\tinputSchema: source.inputSchema,\n\t\t\tcontextSchema: RepositoryContextSchema,\n\t\t\texecute: (input, options) => {\n\t\t\t\tlet context = options.context as { repository: HostedRepository };\n\t\t\t\tlet overridden = {\n\t\t\t\t\t...(input as Record),\n\t\t\t\t\towner: context.repository.owner,\n\t\t\t\t\trepo: context.repository.name,\n\t\t\t\t};\n\t\t\t\treturn execute(overridden, options);\n\t\t\t},\n\t\t}) as Tool;\n\t}\n\treturn bound;\n}\n\n/** Picks exactly `names` from `tools`, or reports the first one missing. */\nexport function requireTools(\n\ttools: ToolSet,\n\tnames: readonly string[],\n): Result {\n\tlet picked: ToolSet = {};\n\tfor (let name of names) {\n\t\tlet found = tools[name];\n\t\tif (!found) return { ok: false, error: { kind: \"MissingTool\", name } };\n\t\tpicked[name] = found;\n\t}\n\treturn { ok: true, value: picked };\n}\n\nfunction credentialKey(owner: ActiveOwnerBinding): string {\n\treturn owner.ownerSessionId;\n}\n\n/**\n * `ActiveOwnerBindings#release()` aborts a binding's signal with reason `\"released\"`\n * once per turn even though the underlying credential (session + revision) is still\n * live for the next turn; every other abort reason (rotation, expiry, revocation,\n * channel reset, runtime stop) means the credential itself is gone. Only the latter\n * should close the cached client.\n */\nconst RETAINED_ABORT_REASONS = new Set([\"released\"]);\n\nfunction abortRetainsCredential(signal: AbortSignal): boolean {\n\tlet reason = signal.reason;\n\tlet message = reason instanceof Error ? reason.message : String(reason ?? \"\");\n\treturn RETAINED_ABORT_REASONS.has(message);\n}\n\n/** Minimal shape of `MCPClient` this module depends on; keeps the test seam decoupled\n * from `MCPClient.tools()`'s generic overloads. */\ntype MinimalMCPClient = {\n\ttools(options: { schemas: typeof GITHUB_TOOL_SCHEMAS }): Promise;\n\tclose(): Promise;\n};\n\ntype CreateClient = (config: MCPClientConfig) => Promise;\n\ntype CacheEntry = {\n\tclient: Pick;\n\ttoken: string;\n\tcredentialRevision: number;\n\texpiresAt: number;\n\tresult: Result;\n\ttimer: ReturnType;\n\tevicted: boolean;\n};\n\nconst MAX_TIMEOUT_MS = 2_147_483_647;\n\nconst cache = new Map();\ntype Opening = {\n\ttoken: string;\n\tcredentialRevision: number;\n\tpromise: Promise>;\n};\n\nconst openings = new Map();\n\nasync function closeQuietly(client: Pick): Promise {\n\ttry {\n\t\tawait client.close();\n\t} catch {\n\t\t// Closing a client that already failed to connect is not itself an error.\n\t}\n}\n\nfunction evict(key: string, entry: CacheEntry): void {\n\tif (entry.evicted) return;\n\tentry.evicted = true;\n\tclearTimeout(entry.timer);\n\tif (cache.get(key) === entry) cache.delete(key);\n\tvoid closeQuietly(entry.client);\n}\n\n/**\n * Closes `entry` once `owner`'s binding ends for a reason other than a plain per-turn\n * release. Safe to call on every reuse of a cached entry: eviction is idempotent, and a\n * cache hit from a fresh `resolve()` call carries a fresh, not-yet-aborted signal that\n * still needs its own listener.\n */\nfunction watch(key: string, entry: CacheEntry, owner: ActiveOwnerBinding): void {\n\tif (owner.signal.aborted) {\n\t\tif (!abortRetainsCredential(owner.signal)) evict(key, entry);\n\t\treturn;\n\t}\n\towner.signal.addEventListener(\"abort\", () => {\n\t\tif (!abortRetainsCredential(owner.signal)) evict(key, entry);\n\t}, { once: true });\n}\n\nfunction unavailable(cause: unknown): Result {\n\treturn { ok: false, error: { kind: \"Unavailable\", cause } };\n}\n\n/**\n * Returns host-executed AI SDK tools bound to `owner`'s repository. Read-only,\n * `pull_requests`-only GitHub MCP tools reachable with `owner`'s token: no schema has\n * an `owner`/`repo` field and `bindRepository` overwrites both from call-time context,\n * so a model cannot name another repository. Search tools are not in the allowlist and\n * are silently dropped by the MCP client if the server ever offers them.\n *\n * Caches one client per owner session and current credential, reused across calls\n * whose token and revision still match. A rotation closes the previous credential's\n * client even when the previous binding was released. An expired, revoked, or\n * in-flight superseded binding never populates the cache.\n */\nexport async function githubTools(\n\towner: ActiveOwnerBinding,\n\tdeps: { createClient?: CreateClient } = {},\n): Promise> {\n\tif (owner.signal.aborted || owner.expiresAt.getTime() <= Date.now()) {\n\t\treturn unavailable(owner.signal.reason ?? new Error(\"owner binding is no longer valid\"));\n\t}\n\n\tlet key = credentialKey(owner);\n\tlet cached = cache.get(key);\n\tif (\n\t\tcached && cached.token === owner.token\n\t\t&& cached.credentialRevision === owner.credentialRevision\n\t\t&& cached.expiresAt > Date.now()\n\t) {\n\t\twatch(key, cached, owner);\n\t\treturn cached.result;\n\t}\n\tif (cached) evict(key, cached);\n\n\tlet existing = openings.get(key);\n\tif (existing?.token === owner.token && existing.credentialRevision === owner.credentialRevision) {\n\t\tlet result = await existing.promise;\n\t\tif (owner.signal.aborted || owner.expiresAt.getTime() <= Date.now()) {\n\t\t\treturn unavailable(owner.signal.reason ?? new Error(\"owner binding is no longer valid\"));\n\t\t}\n\t\tlet entry = cache.get(key);\n\t\tif (entry) watch(key, entry, owner);\n\t\treturn result;\n\t}\n\n\tlet opening: Opening;\n\tlet connect = async (): Promise> => {\n\t\tlet createClient = deps.createClient ?? (createMCPClient as CreateClient);\n\t\tlet client: MinimalMCPClient;\n\t\ttry {\n\t\t\tclient = await createClient({\n\t\t\t\ttransport: {\n\t\t\t\t\ttype: \"http\",\n\t\t\t\t\turl: MCP_URL,\n\t\t\t\t\theaders: {\n\t\t\t\t\t\tAuthorization: `Bearer ${owner.token}`,\n\t\t\t\t\t\t\"X-MCP-Readonly\": \"true\",\n\t\t\t\t\t\t\"X-MCP-Toolsets\": \"pull_requests\",\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t});\n\t\t} catch (cause) {\n\t\t\treturn unavailable(cause);\n\t\t}\n\n\t\tlet raw: ToolSet;\n\t\ttry {\n\t\t\traw = await client.tools({ schemas: GITHUB_TOOL_SCHEMAS });\n\t\t} catch (cause) {\n\t\t\tawait closeQuietly(client);\n\t\t\treturn unavailable(cause);\n\t\t}\n\n\t\tif (\n\t\t\towner.signal.aborted || owner.expiresAt.getTime() <= Date.now()\n\t\t\t|| openings.get(key) !== opening\n\t\t) {\n\t\t\tawait closeQuietly(client);\n\t\t\treturn unavailable(\n\t\t\t\towner.signal.reason ?? new Error(\"owner credential changed while loading tools\"),\n\t\t\t);\n\t\t}\n\n\t\tlet picked = requireTools(raw, Object.keys(GITHUB_TOOL_SCHEMAS));\n\t\tif (!picked.ok) {\n\t\t\tawait closeQuietly(client);\n\t\t\treturn picked;\n\t\t}\n\t\tlet bound: ToolSet;\n\t\ttry {\n\t\t\tbound = bindRepository(picked.value, GITHUB_TOOL_DESCRIPTIONS);\n\t\t} catch (cause) {\n\t\t\tawait closeQuietly(client);\n\t\t\treturn cause instanceof MissingToolError\n\t\t\t\t? { ok: false, error: { kind: \"MissingTool\", name: cause.toolName } }\n\t\t\t\t: unavailable(cause);\n\t\t}\n\n\t\tlet entry: CacheEntry = {\n\t\t\tclient,\n\t\t\ttoken: owner.token,\n\t\t\tcredentialRevision: owner.credentialRevision,\n\t\t\texpiresAt: owner.expiresAt.getTime(),\n\t\t\tresult: { ok: true, value: bound },\n\t\t\tevicted: false,\n\t\t\ttimer: undefined as unknown as ReturnType,\n\t\t};\n\t\tentry.timer = setTimeout(\n\t\t\t() => evict(key, entry),\n\t\t\tMath.min(Math.max(0, owner.expiresAt.getTime() - Date.now()), MAX_TIMEOUT_MS),\n\t\t);\n\t\tcache.set(key, entry);\n\t\twatch(key, entry, owner);\n\t\treturn entry.result;\n\t};\n\topening = {\n\t\ttoken: owner.token,\n\t\tcredentialRevision: owner.credentialRevision,\n\t\tpromise: connect(),\n\t};\n\topenings.set(key, opening);\n\ttry {\n\t\treturn await opening.promise;\n\t} finally {\n\t\tif (openings.get(key) === opening) openings.delete(key);\n\t}\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",1794437462986,"sidebar","expanded"]