@geminixiang/mikan 1.0.0-beta.20 → 1.0.0-beta.21

package/dist/adapters/github/tools/checks.js.map

@@ -1 +1 @@
-{"version":3,"file":"checks.js","sourceRoot":"","sources":["../../../../src/adapters/github/tools/checks.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentTool } from \"@earendil-works/pi-agent-core\";\nimport { Type } from \"@sinclair/typebox\";\nimport type { GithubCheckSummary } from \"../types.js\";\n\nconst githubChecksSchema = Type.Object({\n  branch: Type.Optional(\n    Type.String({\n      description:\n        \"Branch whose CI checks to read (e.g. a pi/<name> branch you pushed). \" +\n        \"Omit in a pull-request conversation to read the PR head's checks.\",\n    }),\n  ),\n  job_id: Type.Optional(\n    Type.Number({\n      description:\n        \"A [job …] id from the summary output (GitHub Actions checks) — returns that \" +\n        \"CI job's log (tail) instead of the summary, for diagnosing a failing check.\",\n    }),\n  ),\n  build_id: Type.Optional(\n    Type.String({\n      description:\n        \"A [build …] uuid from the summary output (Cloud Build checks) — returns that \" +\n        \"build's log (tail) instead of the summary. Mutually exclusive with job_id.\",\n    }),\n  ),\n});\n\n/** Conclusions that mean \"this check did not pass and needs attention\". */\nconst FAILING_CONCLUSIONS = new Set([\"failure\", \"timed_out\", \"action_required\", \"cancelled\"]);\n\nfunction formatCheckLine(run: GithubCheckSummary): string {\n  const state = run.status === \"completed\" ? (run.conclusion ?? \"unknown\") : run.status;\n  const marker =\n    run.conclusion === null\n      ? \"…\"\n      : FAILING_CONCLUSIONS.has(run.conclusion)\n        ? \"✗\"\n        : run.conclusion === \"success\"\n          ? \"✓\"\n          : \"−\";\n  // GitHub Actions logs fetch via job_id; Cloud Build logs via build_id when\n  // the host has GCP credentials. Other external CI keeps logs on its own\n  // service, so advertising an id there would only invite doomed fetches.\n  const handle =\n    run.appSlug === \"github-actions\"\n      ? `[job ${run.id}]`\n      : run.buildLogAvailable && run.externalId\n        ? `[build ${run.externalId}]`\n        : `[external CI: ${run.appSlug ?? \"unknown\"} — logs not on GitHub]`;\n  const line = `${marker} ${run.name}: ${state} ${handle}${run.url ? ` (${run.url})` : \"\"}`;\n  const failed = run.conclusion !== null && FAILING_CONCLUSIONS.has(run.conclusion);\n  return failed && run.outputSummary\n    ? `${line}\\n  ↳ ${run.outputSummary.replace(/\\s*\\n\\s*/g, \" \")}`\n    : line;\n}\n\nexport interface GithubChecksFns {\n  getChecks: (branch?: string) => Promise<GithubCheckSummary[]>;\n  getJobLog: (jobId: number) => Promise<string>;\n  getBuildLog: (buildId: string) => Promise<string>;\n}\n\n/**\n * The `github_checks` tool reads CI check runs (GitHub Actions and other\n * check-reporting apps) for a branch or the conversation's PR head, and can\n * fetch one job's log tail so the agent can diagnose failures and iterate.\n * Read-only, host-side; wired per run and only for GitHub conversations.\n */\nexport function createGithubChecksTool(): {\n  tool: AgentTool<typeof githubChecksSchema>;\n  setGithubChecksFunction: (fns: GithubChecksFns | null) => void;\n} {\n  let checksFns: GithubChecksFns | null = null;\n\n  const tool: AgentTool<typeof githubChecksSchema> = {\n    name: \"github_checks\",\n    label: \"github_checks\",\n    description:\n      \"Read CI status (check runs) for a branch you pushed with github_pr, or for this \" +\n      \"conversation's pull request when branch is omitted. Pass job_id (a [job …] id, \" +\n      \"GitHub Actions) or build_id (a [build …] uuid, Cloud Build) from the summary to \" +\n      \"fetch that run's log. Other external CI checks keep logs on their own service: use \" +\n      \"their summary/url, or reproduce the failure locally in ./repo. Only available in \" +\n      \"GitHub conversations.\",\n    parameters: githubChecksSchema,\n    execute: async (\n      _toolCallId: string,\n      args: { branch?: string; job_id?: number; build_id?: string },\n      signal?: AbortSignal,\n    ) => {\n      if (!checksFns) {\n        throw new Error(\"github_checks is only available in GitHub conversations.\");\n      }\n      if (signal?.aborted) {\n        throw new Error(\"Operation aborted\");\n      }\n      if (args.job_id !== undefined && args.build_id !== undefined) {\n        throw new Error(\"Pass either job_id or build_id, not both.\");\n      }\n\n      if (args.job_id !== undefined) {\n        const logText = await checksFns.getJobLog(args.job_id);\n        return {\n          content: [{ type: \"text\" as const, text: logText || \"(empty log)\" }],\n          details: undefined,\n        };\n      }\n\n      if (args.build_id !== undefined) {\n        const logText = await checksFns.getBuildLog(args.build_id);\n        return {\n          content: [{ type: \"text\" as const, text: logText || \"(empty log)\" }],\n          details: undefined,\n        };\n      }\n\n      const runs = await checksFns.getChecks(args.branch);\n      if (runs.length === 0) {\n        return {\n          content: [\n            {\n              type: \"text\" as const,\n              text: \"No check runs found — CI may not have started yet; try again shortly.\",\n            },\n          ],\n          details: undefined,\n        };\n      }\n      const completed = runs.filter((run) => run.status === \"completed\");\n      const failing = completed.filter(\n        (run) => run.conclusion !== null && FAILING_CONCLUSIONS.has(run.conclusion),\n      );\n      const summary = `${runs.length} check(s): ${completed.length} completed, ${runs.length - completed.length} running, ${failing.length} failing`;\n      return {\n        content: [\n          {\n            type: \"text\" as const,\n            text: [summary, ...runs.map(formatCheckLine)].join(\"\\n\"),\n          },\n        ],\n        details: undefined,\n      };\n    },\n  };\n\n  return {\n    tool,\n    setGithubChecksFunction: (fns) => {\n      checksFns = fns;\n    },\n  };\n}\n"]}
+{"version":3,"file":"checks.js","sourceRoot":"","sources":["../../../../src/adapters/github/tools/checks.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentTool } from \"@earendil-works/pi-agent-core\";\nimport { Type } from \"@sinclair/typebox\";\nimport { defineHostFnTool } from \"../../../tools/host-fn-tool.js\";\nimport type { GithubCheckSummary } from \"../types.js\";\n\nconst githubChecksSchema = Type.Object({\n  branch: Type.Optional(\n    Type.String({\n      description:\n        \"Branch whose CI checks to read (e.g. a pi/<name> branch you pushed). \" +\n        \"Omit in a pull-request conversation to read the PR head's checks.\",\n    }),\n  ),\n  job_id: Type.Optional(\n    Type.Number({\n      description:\n        \"A [job …] id from the summary output (GitHub Actions checks) — returns that \" +\n        \"CI job's log (tail) instead of the summary, for diagnosing a failing check.\",\n    }),\n  ),\n  build_id: Type.Optional(\n    Type.String({\n      description:\n        \"A [build …] uuid from the summary output (Cloud Build checks) — returns that \" +\n        \"build's log (tail) instead of the summary. Mutually exclusive with job_id.\",\n    }),\n  ),\n});\n\n/** Conclusions that mean \"this check did not pass and needs attention\". */\nconst FAILING_CONCLUSIONS = new Set([\"failure\", \"timed_out\", \"action_required\", \"cancelled\"]);\n\nfunction formatCheckLine(run: GithubCheckSummary): string {\n  const state = run.status === \"completed\" ? (run.conclusion ?? \"unknown\") : run.status;\n  const marker =\n    run.conclusion === null\n      ? \"…\"\n      : FAILING_CONCLUSIONS.has(run.conclusion)\n        ? \"✗\"\n        : run.conclusion === \"success\"\n          ? \"✓\"\n          : \"−\";\n  // GitHub Actions logs fetch via job_id; Cloud Build logs via build_id when\n  // the host has GCP credentials. Other external CI keeps logs on its own\n  // service, so advertising an id there would only invite doomed fetches.\n  const handle =\n    run.appSlug === \"github-actions\"\n      ? `[job ${run.id}]`\n      : run.buildLogAvailable && run.externalId\n        ? `[build ${run.externalId}]`\n        : `[external CI: ${run.appSlug ?? \"unknown\"} — logs not on GitHub]`;\n  const line = `${marker} ${run.name}: ${state} ${handle}${run.url ? ` (${run.url})` : \"\"}`;\n  const failed = run.conclusion !== null && FAILING_CONCLUSIONS.has(run.conclusion);\n  return failed && run.outputSummary\n    ? `${line}\\n  ↳ ${run.outputSummary.replace(/\\s*\\n\\s*/g, \" \")}`\n    : line;\n}\n\nexport interface GithubChecksFns {\n  getChecks: (branch?: string) => Promise<GithubCheckSummary[]>;\n  getJobLog: (jobId: number) => Promise<string>;\n  getBuildLog: (buildId: string) => Promise<string>;\n}\n\n/**\n * The `github_checks` tool reads CI check runs (GitHub Actions and other\n * check-reporting apps) for a branch or the conversation's PR head, and can\n * fetch one job's log tail so the agent can diagnose failures and iterate.\n * Read-only, host-side; wired per run and only for GitHub conversations.\n */\nexport function createGithubChecksTool(): {\n  tool: AgentTool<typeof githubChecksSchema>;\n  setGithubChecksFunction: (fns: GithubChecksFns | null) => void;\n} {\n  const { tool, setFn } = defineHostFnTool<GithubChecksFns, typeof githubChecksSchema>({\n    name: \"github_checks\",\n    description:\n      \"Read CI status (check runs) for a branch you pushed with github_pr, or for this \" +\n      \"conversation's pull request when branch is omitted. Pass job_id (a [job …] id, \" +\n      \"GitHub Actions) or build_id (a [build …] uuid, Cloud Build) from the summary to \" +\n      \"fetch that run's log. Other external CI checks keep logs on their own service: use \" +\n      \"their summary/url, or reproduce the failure locally in ./repo. Only available in \" +\n      \"GitHub conversations.\",\n    parameters: githubChecksSchema,\n    unavailable: \"github_checks is only available in GitHub conversations.\",\n    run: async (checksFns, args) => {\n      if (args.job_id !== undefined && args.build_id !== undefined) {\n        throw new Error(\"Pass either job_id or build_id, not both.\");\n      }\n\n      if (args.job_id !== undefined) {\n        const logText = await checksFns.getJobLog(args.job_id);\n        return {\n          content: [{ type: \"text\" as const, text: logText || \"(empty log)\" }],\n          details: undefined,\n        };\n      }\n\n      if (args.build_id !== undefined) {\n        const logText = await checksFns.getBuildLog(args.build_id);\n        return {\n          content: [{ type: \"text\" as const, text: logText || \"(empty log)\" }],\n          details: undefined,\n        };\n      }\n\n      const runs = await checksFns.getChecks(args.branch);\n      if (runs.length === 0) {\n        return {\n          content: [\n            {\n              type: \"text\" as const,\n              text: \"No check runs found — CI may not have started yet; try again shortly.\",\n            },\n          ],\n          details: undefined,\n        };\n      }\n      const completed = runs.filter((run) => run.status === \"completed\");\n      const failing = completed.filter(\n        (run) => run.conclusion !== null && FAILING_CONCLUSIONS.has(run.conclusion),\n      );\n      const summary = `${runs.length} check(s): ${completed.length} completed, ${runs.length - completed.length} running, ${failing.length} failing`;\n      return {\n        content: [\n          {\n            type: \"text\" as const,\n            text: [summary, ...runs.map(formatCheckLine)].join(\"\\n\"),\n          },\n        ],\n        details: undefined,\n      };\n    },\n  });\n\n  return { tool, setGithubChecksFunction: setFn };\n}\n"]}

package/dist/adapters/github/tools/issue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"issue.d.ts","sourceRoot":"","sources":["../../../../src/adapters/github/tools/issue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,QAAA,MAAM,iBAAiB;;;;;;;EA+BrB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAE7E;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI;IACvC,IAAI,EAAE,SAAS,CAAC,OAAO,iBAAiB,CAAC,CAAC;IAC1C,sBAAsB,EAAE,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI,KAAK,IAAI,CAAC;CAC5D,CAiCA"}
+{"version":3,"file":"issue.d.ts","sourceRoot":"","sources":["../../../../src/adapters/github/tools/issue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAG/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,QAAA,MAAM,iBAAiB;;;;;;;EA+BrB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAE7E;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI;IACvC,IAAI,EAAE,SAAS,CAAC,OAAO,iBAAiB,CAAC,CAAC;IAC1C,sBAAsB,EAAE,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI,KAAK,IAAI,CAAC;CAC5D,CAoBA"}

package/dist/adapters/github/tools/issue.js

@@ -1,4 +1,5 @@
 import { Type } from "@sinclair/typebox";
+import { defineHostFnTool } from "../../../tools/host-fn-tool.js";
 const githubIssueSchema = Type.Object({
     action: Type.Union([
         Type.Literal("add_labels"),
@@ -26,34 +27,22 @@ const githubIssueSchema = Type.Object({
  * the App; wired per run and only for GitHub conversations.
  */
 export function createGithubIssueTool() {
-    let issueFn = null;
-    const tool = {
+    const { tool, setFn } = defineHostFnTool({
         name: "github_issue",
-        label: "github_issue",
         description: "Manage issues in this repo: add/remove labels, add/remove assignees, close " +
             "(optionally with state_reason) or reopen. number defaults to this conversation's " +
             "issue; any issue number in this repo works for triage. Only available in GitHub " +
             "conversations.",
         parameters: githubIssueSchema,
-        execute: async (_toolCallId, args, signal) => {
-            if (!issueFn) {
-                throw new Error("github_issue is only available in GitHub conversations.");
-            }
-            if (signal?.aborted) {
-                throw new Error("Operation aborted");
-            }
+        unavailable: "github_issue is only available in GitHub conversations.",
+        run: async (issueFn, args) => {
             const report = await issueFn(args);
             return {
                 content: [{ type: "text", text: report }],
                 details: undefined,
             };
         },
-    };
-    return {
-        tool,
-        setGithubIssueFunction: (fn) => {
-            issueFn = fn;
-        },
-    };
+    });
+    return { tool, setGithubIssueFunction: setFn };
 }
 //# sourceMappingURL=issue.js.map

package/dist/adapters/github/tools/issue.js.map

@@ -1 +1 @@
-{"version":3,"file":"issue.js","sourceRoot":"","sources":["../../../../src/adapters/github/tools/issue.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAGzC,MAAM,iBAAiB,GAAG,IAAI,CAAC,MAAM,CAAC;IACpC,MAAM,EAAE,IAAI,CAAC,KAAK,CAChB;QACE,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC;QAC1B,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC;QAC5B,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC;QAChC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;QACrB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;KACvB,EACD,EAAE,WAAW,EAAE,0BAA0B,EAAE,CAC5C;IACD,MAAM,EAAE,IAAI,CAAC,QAAQ,CACnB,IAAI,CAAC,MAAM,CAAC;QACV,WAAW,EAAE,iEAAiE;KAC/E,CAAC,CACH;IACD,MAAM,EAAE,IAAI,CAAC,QAAQ,CACnB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,iCAAiC,EAAE,CAAC,CAC9E;IACD,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,yCAAyC,EAAE,CAAC,CAAC;IAC7F,SAAS,EAAE,IAAI,CAAC,QAAQ,CACtB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE;QACxB,WAAW,EAAE,kDAAkD;KAChE,CAAC,CACH;IACD,YAAY,EAAE,IAAI,CAAC,QAAQ,CACzB,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,EAAE;QACnE,WAAW,EAAE,uCAAuC;KACrD,CAAC,CACH;CACF,CAAC,CAAC;AAIH;;;;GAIG;AACH,MAAM,UAAU,qBAAqB;IAInC,IAAI,OAAO,GAAyB,IAAI,CAAC;IAEzC,MAAM,IAAI,GAAwC;QAChD,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,cAAc;QACrB,WAAW,EACT,6EAA6E;YAC7E,mFAAmF;YACnF,kFAAkF;YAClF,gBAAgB;QAClB,UAAU,EAAE,iBAAiB;QAC7B,OAAO,EAAE,KAAK,EAAE,WAAmB,EAAE,IAAwB,EAAE,MAAoB,EAAE,EAAE;YACrF,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;YAC7E,CAAC;YACD,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;YACvC,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;YACnC,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;gBAClD,OAAO,EAAE,SAAS;aACnB,CAAC;QACJ,CAAC;KACF,CAAC;IAEF,OAAO;QACL,IAAI;QACJ,sBAAsB,EAAE,CAAC,EAAE,EAAE,EAAE;YAC7B,OAAO,GAAG,EAAE,CAAC;QACf,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type { AgentTool } from \"@earendil-works/pi-agent-core\";\nimport { Type } from \"@sinclair/typebox\";\nimport type { GithubIssueRequest } from \"../types.js\";\n\nconst githubIssueSchema = Type.Object({\n  action: Type.Union(\n    [\n      Type.Literal(\"add_labels\"),\n      Type.Literal(\"remove_label\"),\n      Type.Literal(\"add_assignees\"),\n      Type.Literal(\"remove_assignees\"),\n      Type.Literal(\"close\"),\n      Type.Literal(\"reopen\"),\n    ],\n    { description: \"Issue management action.\" },\n  ),\n  number: Type.Optional(\n    Type.Number({\n      description: \"Issue/PR number in this repo; omit for this conversation's own.\",\n    }),\n  ),\n  labels: Type.Optional(\n    Type.Array(Type.String(), { description: \"add_labels: label names to add.\" }),\n  ),\n  label: Type.Optional(Type.String({ description: \"remove_label: the label name to remove.\" })),\n  assignees: Type.Optional(\n    Type.Array(Type.String(), {\n      description: \"add_assignees / remove_assignees: GitHub logins.\",\n    }),\n  ),\n  state_reason: Type.Optional(\n    Type.Union([Type.Literal(\"completed\"), Type.Literal(\"not_planned\")], {\n      description: \"close: why the issue is being closed.\",\n    }),\n  ),\n});\n\nexport type GithubIssueFn = (request: GithubIssueRequest) => Promise<string>;\n\n/**\n * The `github_issue` tool manages labels, assignees, and open/closed state of\n * issues in the conversation's repo (any issue number — triage). Host-side as\n * the App; wired per run and only for GitHub conversations.\n */\nexport function createGithubIssueTool(): {\n  tool: AgentTool<typeof githubIssueSchema>;\n  setGithubIssueFunction: (fn: GithubIssueFn | null) => void;\n} {\n  let issueFn: GithubIssueFn | null = null;\n\n  const tool: AgentTool<typeof githubIssueSchema> = {\n    name: \"github_issue\",\n    label: \"github_issue\",\n    description:\n      \"Manage issues in this repo: add/remove labels, add/remove assignees, close \" +\n      \"(optionally with state_reason) or reopen. number defaults to this conversation's \" +\n      \"issue; any issue number in this repo works for triage. Only available in GitHub \" +\n      \"conversations.\",\n    parameters: githubIssueSchema,\n    execute: async (_toolCallId: string, args: GithubIssueRequest, signal?: AbortSignal) => {\n      if (!issueFn) {\n        throw new Error(\"github_issue is only available in GitHub conversations.\");\n      }\n      if (signal?.aborted) {\n        throw new Error(\"Operation aborted\");\n      }\n      const report = await issueFn(args);\n      return {\n        content: [{ type: \"text\" as const, text: report }],\n        details: undefined,\n      };\n    },\n  };\n\n  return {\n    tool,\n    setGithubIssueFunction: (fn) => {\n      issueFn = fn;\n    },\n  };\n}\n"]}
+{"version":3,"file":"issue.js","sourceRoot":"","sources":["../../../../src/adapters/github/tools/issue.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAGlE,MAAM,iBAAiB,GAAG,IAAI,CAAC,MAAM,CAAC;IACpC,MAAM,EAAE,IAAI,CAAC,KAAK,CAChB;QACE,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC;QAC1B,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC;QAC5B,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC;QAChC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;QACrB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;KACvB,EACD,EAAE,WAAW,EAAE,0BAA0B,EAAE,CAC5C;IACD,MAAM,EAAE,IAAI,CAAC,QAAQ,CACnB,IAAI,CAAC,MAAM,CAAC;QACV,WAAW,EAAE,iEAAiE;KAC/E,CAAC,CACH;IACD,MAAM,EAAE,IAAI,CAAC,QAAQ,CACnB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,iCAAiC,EAAE,CAAC,CAC9E;IACD,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,yCAAyC,EAAE,CAAC,CAAC;IAC7F,SAAS,EAAE,IAAI,CAAC,QAAQ,CACtB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE;QACxB,WAAW,EAAE,kDAAkD;KAChE,CAAC,CACH;IACD,YAAY,EAAE,IAAI,CAAC,QAAQ,CACzB,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,EAAE;QACnE,WAAW,EAAE,uCAAuC;KACrD,CAAC,CACH;CACF,CAAC,CAAC;AAIH;;;;GAIG;AACH,MAAM,UAAU,qBAAqB;IAInC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,gBAAgB,CAA0C;QAChF,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,6EAA6E;YAC7E,mFAAmF;YACnF,kFAAkF;YAClF,gBAAgB;QAClB,UAAU,EAAE,iBAAiB;QAC7B,WAAW,EAAE,yDAAyD;QACtE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;YAC3B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAA0B,CAAC,CAAC;YACzD,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;gBAClD,OAAO,EAAE,SAAS;aACnB,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,EAAE,IAAI,EAAE,sBAAsB,EAAE,KAAK,EAAE,CAAC;AACjD,CAAC","sourcesContent":["import type { AgentTool } from \"@earendil-works/pi-agent-core\";\nimport { Type } from \"@sinclair/typebox\";\nimport { defineHostFnTool } from \"../../../tools/host-fn-tool.js\";\nimport type { GithubIssueRequest } from \"../types.js\";\n\nconst githubIssueSchema = Type.Object({\n  action: Type.Union(\n    [\n      Type.Literal(\"add_labels\"),\n      Type.Literal(\"remove_label\"),\n      Type.Literal(\"add_assignees\"),\n      Type.Literal(\"remove_assignees\"),\n      Type.Literal(\"close\"),\n      Type.Literal(\"reopen\"),\n    ],\n    { description: \"Issue management action.\" },\n  ),\n  number: Type.Optional(\n    Type.Number({\n      description: \"Issue/PR number in this repo; omit for this conversation's own.\",\n    }),\n  ),\n  labels: Type.Optional(\n    Type.Array(Type.String(), { description: \"add_labels: label names to add.\" }),\n  ),\n  label: Type.Optional(Type.String({ description: \"remove_label: the label name to remove.\" })),\n  assignees: Type.Optional(\n    Type.Array(Type.String(), {\n      description: \"add_assignees / remove_assignees: GitHub logins.\",\n    }),\n  ),\n  state_reason: Type.Optional(\n    Type.Union([Type.Literal(\"completed\"), Type.Literal(\"not_planned\")], {\n      description: \"close: why the issue is being closed.\",\n    }),\n  ),\n});\n\nexport type GithubIssueFn = (request: GithubIssueRequest) => Promise<string>;\n\n/**\n * The `github_issue` tool manages labels, assignees, and open/closed state of\n * issues in the conversation's repo (any issue number — triage). Host-side as\n * the App; wired per run and only for GitHub conversations.\n */\nexport function createGithubIssueTool(): {\n  tool: AgentTool<typeof githubIssueSchema>;\n  setGithubIssueFunction: (fn: GithubIssueFn | null) => void;\n} {\n  const { tool, setFn } = defineHostFnTool<GithubIssueFn, typeof githubIssueSchema>({\n    name: \"github_issue\",\n    description:\n      \"Manage issues in this repo: add/remove labels, add/remove assignees, close \" +\n      \"(optionally with state_reason) or reopen. number defaults to this conversation's \" +\n      \"issue; any issue number in this repo works for triage. Only available in GitHub \" +\n      \"conversations.\",\n    parameters: githubIssueSchema,\n    unavailable: \"github_issue is only available in GitHub conversations.\",\n    run: async (issueFn, args) => {\n      const report = await issueFn(args as GithubIssueRequest);\n      return {\n        content: [{ type: \"text\" as const, text: report }],\n        details: undefined,\n      };\n    },\n  });\n\n  return { tool, setGithubIssueFunction: setFn };\n}\n"]}

package/dist/adapters/github/tools/pr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pr.d.ts","sourceRoot":"","sources":["../../../../src/adapters/github/tools/pr.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEnE,QAAA,MAAM,cAAc;;;;;;EAalB,CAAC;AAIH;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI;IACpC,IAAI,EAAE,SAAS,CAAC,OAAO,cAAc,CAAC,CAAC;IACvC,mBAAmB,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC,GAAG,IAAI,KAAK,IAAI,CAAC;CACnG,CAyCA"}
+{"version":3,"file":"pr.d.ts","sourceRoot":"","sources":["../../../../src/adapters/github/tools/pr.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAG/D,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEnE,QAAA,MAAM,cAAc;;;;;;EAalB,CAAC;AAIH;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI;IACpC,IAAI,EAAE,SAAS,CAAC,OAAO,cAAc,CAAC,CAAC;IACvC,mBAAmB,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC,GAAG,IAAI,KAAK,IAAI,CAAC;CACnG,CA+BA"}

package/dist/adapters/github/tools/pr.js

@@ -1,4 +1,5 @@
 import { Type } from "@sinclair/typebox";
+import { defineHostFnTool } from "../../../tools/host-fn-tool.js";
 const githubPrSchema = Type.Object({
     branch: Type.String({
         description: 'Local branch inside ./repo to push. Must be named pi/<something> (e.g. "pi/fix-42"); ' +
@@ -18,23 +19,16 @@ const githubPrSchema = Type.Object({
  * for GitHub conversations.
  */
 export function createGithubPrTool() {
-    let prFn = null;
-    const tool = {
+    const { tool, setFn } = defineHostFnTool({
         name: "github_pr",
-        label: "github_pr",
         description: "Push a pi/<name> branch you committed inside ./repo and open a GitHub pull request " +
             "(or draft) for it. Pushing a branch that already has an open PR — including this " +
             "conversation's own PR head — updates that PR instead of opening a new one. Only " +
             "available in GitHub issue/PR conversations. You cannot push to the default branch " +
             "and you cannot merge — humans review and merge the PR.",
         parameters: githubPrSchema,
-        execute: async (_toolCallId, args, signal) => {
-            if (!prFn) {
-                throw new Error("github_pr is only available in GitHub conversations.");
-            }
-            if (signal?.aborted) {
-                throw new Error("Operation aborted");
-            }
+        unavailable: "github_pr is only available in GitHub conversations.",
+        run: async (prFn, args) => {
             const result = await prFn(args);
             return {
                 content: [
@@ -48,12 +42,7 @@ export function createGithubPrTool() {
                 details: undefined,
             };
         },
-    };
-    return {
-        tool,
-        setGithubPrFunction: (fn) => {
-            prFn = fn;
-        },
-    };
+    });
+    return { tool, setGithubPrFunction: setFn };
 }
 //# sourceMappingURL=pr.js.map

package/dist/adapters/github/tools/pr.js.map

@@ -1 +1 @@
-{"version":3,"file":"pr.js","sourceRoot":"","sources":["../../../../src/adapters/github/tools/pr.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAGzC,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC;IACjC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;QAClB,WAAW,EACT,uFAAuF;YACvF,uFAAuF;YACvF,+BAA+B;KAClC,CAAC;IACF,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,qBAAqB,EAAE,CAAC;IAC1D,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,sCAAsC,EAAE,CAAC,CAAC;IACzF,IAAI,EAAE,IAAI,CAAC,QAAQ,CACjB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,6DAA6D,EAAE,CAAC,CAC5F;IACD,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,+BAA+B,EAAE,CAAC,CAAC;CACrF,CAAC,CAAC;AAIH;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB;IAIhC,IAAI,IAAI,GAAmE,IAAI,CAAC;IAEhF,MAAM,IAAI,GAAqC;QAC7C,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,WAAW;QAClB,WAAW,EACT,qFAAqF;YACrF,mFAAmF;YACnF,kFAAkF;YAClF,oFAAoF;YACpF,wDAAwD;QAC1D,UAAU,EAAE,cAAc;QAC1B,OAAO,EAAE,KAAK,EAAE,WAAmB,EAAE,IAAkB,EAAE,MAAoB,EAAE,EAAE;YAC/E,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;YAC1E,CAAC;YACD,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;YACvC,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;YAChC,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,MAAM,CAAC,eAAe;4BAC1B,CAAC,CAAC,0BAA0B,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,GAAG,EAAE;4BAC1D,CAAC,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,GAAG,EAAE;qBAC9E;iBACF;gBACD,OAAO,EAAE,SAAS;aACnB,CAAC;QACJ,CAAC;KACF,CAAC;IAEF,OAAO;QACL,IAAI;QACJ,mBAAmB,EAAE,CAAC,EAAE,EAAE,EAAE;YAC1B,IAAI,GAAG,EAAE,CAAC;QACZ,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type { AgentTool } from \"@earendil-works/pi-agent-core\";\nimport { Type } from \"@sinclair/typebox\";\nimport type { GithubPrRequest, GithubPrResult } from \"../types.js\";\n\nconst githubPrSchema = Type.Object({\n  branch: Type.String({\n    description:\n      'Local branch inside ./repo to push. Must be named pi/<something> (e.g. \"pi/fix-42\"); ' +\n      \"the default branch is never pushable. To update this conversation's own PR, pass its \" +\n      \"checked-out pi/* head branch.\",\n  }),\n  title: Type.String({ description: \"Pull request title.\" }),\n  body: Type.Optional(Type.String({ description: \"Pull request description (Markdown).\" })),\n  base: Type.Optional(\n    Type.String({ description: \"Target branch; defaults to the repository's default branch.\" }),\n  ),\n  draft: Type.Optional(Type.Boolean({ description: \"Open as a draft pull request.\" })),\n});\n\ntype GithubPrArgs = GithubPrRequest;\n\n/**\n * The `github_pr` tool pushes a branch the agent prepared in the\n * conversation's ./repo clone and opens a pull request as the GitHub App.\n * The push and API calls run host-side with an ephemeral repo-scoped token;\n * the sandbox never holds credentials. Wired per run via the setter, and only\n * for GitHub conversations.\n */\nexport function createGithubPrTool(): {\n  tool: AgentTool<typeof githubPrSchema>;\n  setGithubPrFunction: (fn: ((request: GithubPrRequest) => Promise<GithubPrResult>) | null) => void;\n} {\n  let prFn: ((request: GithubPrRequest) => Promise<GithubPrResult>) | null = null;\n\n  const tool: AgentTool<typeof githubPrSchema> = {\n    name: \"github_pr\",\n    label: \"github_pr\",\n    description:\n      \"Push a pi/<name> branch you committed inside ./repo and open a GitHub pull request \" +\n      \"(or draft) for it. Pushing a branch that already has an open PR — including this \" +\n      \"conversation's own PR head — updates that PR instead of opening a new one. Only \" +\n      \"available in GitHub issue/PR conversations. You cannot push to the default branch \" +\n      \"and you cannot merge — humans review and merge the PR.\",\n    parameters: githubPrSchema,\n    execute: async (_toolCallId: string, args: GithubPrArgs, signal?: AbortSignal) => {\n      if (!prFn) {\n        throw new Error(\"github_pr is only available in GitHub conversations.\");\n      }\n      if (signal?.aborted) {\n        throw new Error(\"Operation aborted\");\n      }\n      const result = await prFn(args);\n      return {\n        content: [\n          {\n            type: \"text\" as const,\n            text: result.updatedExisting\n              ? `Pushed to existing PR #${result.number}: ${result.url}`\n              : `Opened ${args.draft ? \"draft \" : \"\"}PR #${result.number}: ${result.url}`,\n          },\n        ],\n        details: undefined,\n      };\n    },\n  };\n\n  return {\n    tool,\n    setGithubPrFunction: (fn) => {\n      prFn = fn;\n    },\n  };\n}\n"]}
+{"version":3,"file":"pr.js","sourceRoot":"","sources":["../../../../src/adapters/github/tools/pr.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAGlE,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC;IACjC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;QAClB,WAAW,EACT,uFAAuF;YACvF,uFAAuF;YACvF,+BAA+B;KAClC,CAAC;IACF,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,qBAAqB,EAAE,CAAC;IAC1D,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,sCAAsC,EAAE,CAAC,CAAC;IACzF,IAAI,EAAE,IAAI,CAAC,QAAQ,CACjB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,6DAA6D,EAAE,CAAC,CAC5F;IACD,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,+BAA+B,EAAE,CAAC,CAAC;CACrF,CAAC,CAAC;AAIH;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB;IAIhC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,gBAAgB,CAGtC;QACA,IAAI,EAAE,WAAW;QACjB,WAAW,EACT,qFAAqF;YACrF,mFAAmF;YACnF,kFAAkF;YAClF,oFAAoF;YACpF,wDAAwD;QAC1D,UAAU,EAAE,cAAc;QAC1B,WAAW,EAAE,sDAAsD;QACnE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,IAAkB,EAAE,EAAE;YACtC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;YAChC,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,MAAM,CAAC,eAAe;4BAC1B,CAAC,CAAC,0BAA0B,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,GAAG,EAAE;4BAC1D,CAAC,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,GAAG,EAAE;qBAC9E;iBACF;gBACD,OAAO,EAAE,SAAS;aACnB,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,CAAC;AAC9C,CAAC","sourcesContent":["import type { AgentTool } from \"@earendil-works/pi-agent-core\";\nimport { Type } from \"@sinclair/typebox\";\nimport { defineHostFnTool } from \"../../../tools/host-fn-tool.js\";\nimport type { GithubPrRequest, GithubPrResult } from \"../types.js\";\n\nconst githubPrSchema = Type.Object({\n  branch: Type.String({\n    description:\n      'Local branch inside ./repo to push. Must be named pi/<something> (e.g. \"pi/fix-42\"); ' +\n      \"the default branch is never pushable. To update this conversation's own PR, pass its \" +\n      \"checked-out pi/* head branch.\",\n  }),\n  title: Type.String({ description: \"Pull request title.\" }),\n  body: Type.Optional(Type.String({ description: \"Pull request description (Markdown).\" })),\n  base: Type.Optional(\n    Type.String({ description: \"Target branch; defaults to the repository's default branch.\" }),\n  ),\n  draft: Type.Optional(Type.Boolean({ description: \"Open as a draft pull request.\" })),\n});\n\ntype GithubPrArgs = GithubPrRequest;\n\n/**\n * The `github_pr` tool pushes a branch the agent prepared in the\n * conversation's ./repo clone and opens a pull request as the GitHub App.\n * The push and API calls run host-side with an ephemeral repo-scoped token;\n * the sandbox never holds credentials. Wired per run via the setter, and only\n * for GitHub conversations.\n */\nexport function createGithubPrTool(): {\n  tool: AgentTool<typeof githubPrSchema>;\n  setGithubPrFunction: (fn: ((request: GithubPrRequest) => Promise<GithubPrResult>) | null) => void;\n} {\n  const { tool, setFn } = defineHostFnTool<\n    (request: GithubPrRequest) => Promise<GithubPrResult>,\n    typeof githubPrSchema\n  >({\n    name: \"github_pr\",\n    description:\n      \"Push a pi/<name> branch you committed inside ./repo and open a GitHub pull request \" +\n      \"(or draft) for it. Pushing a branch that already has an open PR — including this \" +\n      \"conversation's own PR head — updates that PR instead of opening a new one. Only \" +\n      \"available in GitHub issue/PR conversations. You cannot push to the default branch \" +\n      \"and you cannot merge — humans review and merge the PR.\",\n    parameters: githubPrSchema,\n    unavailable: \"github_pr is only available in GitHub conversations.\",\n    run: async (prFn, args: GithubPrArgs) => {\n      const result = await prFn(args);\n      return {\n        content: [\n          {\n            type: \"text\" as const,\n            text: result.updatedExisting\n              ? `Pushed to existing PR #${result.number}: ${result.url}`\n              : `Opened ${args.draft ? \"draft \" : \"\"}PR #${result.number}: ${result.url}`,\n          },\n        ],\n        details: undefined,\n      };\n    },\n  });\n\n  return { tool, setGithubPrFunction: setFn };\n}\n"]}

package/dist/adapters/github/tools/read.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../../src/adapters/github/tools/read.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEvE,QAAA,MAAM,gBAAgB;;;;;;EA8BpB,CAAC;AAoGH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAErF;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI;IACtC,IAAI,EAAE,SAAS,CAAC,OAAO,gBAAgB,CAAC,CAAC;IACzC,qBAAqB,EAAE,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,KAAK,IAAI,CAAC;CAC1D,CAiCA"}
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../../src/adapters/github/tools/read.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAG/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEvE,QAAA,MAAM,gBAAgB;;;;;;EA8BpB,CAAC;AAoGH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAErF;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI;IACtC,IAAI,EAAE,SAAS,CAAC,OAAO,gBAAgB,CAAC,CAAC;IACzC,qBAAqB,EAAE,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,KAAK,IAAI,CAAC;CAC1D,CAoBA"}

package/dist/adapters/github/tools/read.js

@@ -1,4 +1,5 @@
 import { Type } from "@sinclair/typebox";
+import { defineHostFnTool } from "../../../tools/host-fn-tool.js";
 const githubReadSchema = Type.Object({
     action: Type.Union([
         Type.Literal("pr"),
@@ -119,34 +120,22 @@ function formatResult(result) {
  * construction; wired per run and only for GitHub conversations.
  */
 export function createGithubReadTool() {
-    let readFn = null;
-    const tool = {
+    const { tool, setFn } = defineHostFnTool({
         name: "github_read",
-        label: "github_read",
         description: "Read GitHub metadata for this repo: PR state/diff stats (pr), changed files " +
             "(pr_files), reviews and open inline threads (pr_reviews), issue metadata (issue), " +
             "recent comments (comments), or a filtered issue/PR listing (list). number defaults " +
             "to this conversation's issue/PR. Only available in GitHub conversations.",
         parameters: githubReadSchema,
-        execute: async (_toolCallId, args, signal) => {
-            if (!readFn) {
-                throw new Error("github_read is only available in GitHub conversations.");
-            }
-            if (signal?.aborted) {
-                throw new Error("Operation aborted");
-            }
+        unavailable: "github_read is only available in GitHub conversations.",
+        run: async (readFn, args) => {
             const result = await readFn(args);
             return {
                 content: [{ type: "text", text: formatResult(result) }],
                 details: undefined,
             };
         },
-    };
-    return {
-        tool,
-        setGithubReadFunction: (fn) => {
-            readFn = fn;
-        },
-    };
+    });
+    return { tool, setGithubReadFunction: setFn };
 }
 //# sourceMappingURL=read.js.map

package/dist/adapters/github/tools/read.js.map

@@ -1 +1 @@
-{"version":3,"file":"read.js","sourceRoot":"","sources":["../../../../src/adapters/github/tools/read.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentTool } from \"@earendil-works/pi-agent-core\";\nimport { Type } from \"@sinclair/typebox\";\nimport type { GithubReadRequest, GithubReadResult } from \"../types.js\";\n\nconst githubReadSchema = Type.Object({\n  action: Type.Union(\n    [\n      Type.Literal(\"pr\"),\n      Type.Literal(\"pr_files\"),\n      Type.Literal(\"pr_reviews\"),\n      Type.Literal(\"issue\"),\n      Type.Literal(\"comments\"),\n      Type.Literal(\"list\"),\n    ],\n    {\n      description:\n        \"pr: PR metadata (state, base/head, diff stats). pr_files: changed files. \" +\n        \"pr_reviews: submitted reviews + open inline threads (with rc- ids for \" +\n        \"github_review_reply). issue: issue metadata. comments: recent conversation \" +\n        \"comments. list: issues/PRs in this repo.\",\n    },\n  ),\n  number: Type.Optional(\n    Type.Number({\n      description: \"Issue/PR number to read; omit for this conversation's own.\",\n    }),\n  ),\n  state: Type.Optional(\n    Type.String({ description: \"list only: open | closed | all (default open).\" }),\n  ),\n  labels: Type.Optional(\n    Type.String({ description: \"list only: comma-separated label names to filter by.\" }),\n  ),\n  creator: Type.Optional(Type.String({ description: \"list only: filter by author login.\" })),\n});\n\nconst MAX_BODY_CHARS = 1000;\nconst MAX_COMMENT_CHARS = 500;\nconst MAX_REVIEW_BODY_CHARS = 300;\n\nfunction truncate(text: string, max: number): string {\n  return text.length > max ? `${text.slice(0, max)}…` : text;\n}\n\nfunction formatResult(result: GithubReadResult): string {\n  switch (result.kind) {\n    case \"pr\": {\n      const pr = result.pr;\n      const flags = [\n        pr.state ?? \"unknown\",\n        pr.draft ? \"draft\" : null,\n        pr.merged ? \"merged\" : null,\n        pr.mergeable_state ? `mergeable_state: ${pr.mergeable_state}` : null,\n      ].filter(Boolean);\n      return [\n        `PR #${pr.number}: ${pr.title ?? \"\"} [${flags.join(\", \")}]`,\n        `${pr.head?.ref ?? \"?\"} → ${pr.base?.ref ?? \"?\"} | ${pr.changed_files ?? \"?\"} files, +${pr.additions ?? \"?\"} -${pr.deletions ?? \"?\"}`,\n        pr.user ? `author: @${pr.user.login}` : null,\n        pr.body ? truncate(pr.body, MAX_BODY_CHARS) : \"(no description)\",\n      ]\n        .filter(Boolean)\n        .join(\"\\n\");\n    }\n    case \"pr_files\": {\n      if (result.files.length === 0) return \"No changed files.\";\n      const lines = result.files.map(\n        (file) => `${file.status.padEnd(8)} ${file.filename} +${file.additions} -${file.deletions}`,\n      );\n      return [`${result.files.length} changed file(s):`, ...lines].join(\"\\n\");\n    }\n    case \"pr_reviews\": {\n      const reviewLines = result.reviews\n        .filter((review) => review.state !== \"PENDING\")\n        .map((review) => {\n          const body = review.body?.trim()\n            ? ` — ${truncate(review.body, MAX_REVIEW_BODY_CHARS)}`\n            : \"\";\n          return `@${review.user.login}: ${review.state}${body}`;\n        });\n      // Thread roots only: replies belong to their root's thread. The rc- id\n      // is what github_review_reply takes.\n      const rootThreads = result.threads.filter((comment) => comment.in_reply_to_id === undefined);\n      const threadLines = rootThreads.map((comment) => {\n        const location = comment.line !== null ? `${comment.path}:${comment.line}` : comment.path;\n        const replies = result.threads.filter((reply) => reply.in_reply_to_id === comment.id);\n        const replyNote =\n          replies.length > 0\n            ? ` (${replies.length} repl${replies.length === 1 ? \"y\" : \"ies\"})`\n            : \"\";\n        return `rc-${comment.id} ${location} @${comment.user.login}${replyNote}: ${truncate(comment.body, MAX_REVIEW_BODY_CHARS)}`;\n      });\n      return [\n        reviewLines.length > 0 ? `Reviews:\\n${reviewLines.join(\"\\n\")}` : \"No submitted reviews.\",\n        threadLines.length > 0\n          ? `Inline threads (reply with github_review_reply):\\n${threadLines.join(\"\\n\")}`\n          : \"No inline review threads.\",\n      ].join(\"\\n\\n\");\n    }\n    case \"issue\": {\n      const issue = result.issue;\n      const labels = (issue.labels ?? []).map((label) => label.name).join(\", \");\n      const assignees = (issue.assignees ?? []).map((assignee) => `@${assignee.login}`).join(\", \");\n      return [\n        `#${issue.number}: ${issue.title} [${issue.state ?? \"unknown\"}${issue.pull_request ? \", PR\" : \"\"}]`,\n        labels ? `labels: ${labels}` : null,\n        assignees ? `assignees: ${assignees}` : null,\n        `author: @${issue.user.login}`,\n        issue.body ? truncate(issue.body, MAX_BODY_CHARS) : \"(no body)\",\n      ]\n        .filter(Boolean)\n        .join(\"\\n\");\n    }\n    case \"comments\": {\n      if (result.comments.length === 0) return \"No comments.\";\n      return result.comments\n        .map(\n          (comment) =>\n            `@${comment.user.login} (${comment.created_at}): ${truncate(comment.body, MAX_COMMENT_CHARS)}`,\n        )\n        .join(\"\\n\");\n    }\n    case \"list\": {\n      if (result.issues.length === 0) return \"No matching issues.\";\n      return result.issues\n        .map((issue) => {\n          const labels = (issue.labels ?? []).map((label) => label.name).join(\", \");\n          const kind = issue.pull_request ? \"PR\" : \"issue\";\n          return `#${issue.number} [${issue.state ?? \"?\"} ${kind}] ${issue.title}${labels ? ` (${labels})` : \"\"}`;\n        })\n        .join(\"\\n\");\n    }\n  }\n}\n\nexport type GithubReadFn = (request: GithubReadRequest) => Promise<GithubReadResult>;\n\n/**\n * The `github_read` tool reads what the ./repo clone cannot show: PR diff\n * stats and changed files, review state with open inline threads, and other\n * issues/PRs in this repo for triage. Read-only, host-side, same-repo by\n * construction; wired per run and only for GitHub conversations.\n */\nexport function createGithubReadTool(): {\n  tool: AgentTool<typeof githubReadSchema>;\n  setGithubReadFunction: (fn: GithubReadFn | null) => void;\n} {\n  let readFn: GithubReadFn | null = null;\n\n  const tool: AgentTool<typeof githubReadSchema> = {\n    name: \"github_read\",\n    label: \"github_read\",\n    description:\n      \"Read GitHub metadata for this repo: PR state/diff stats (pr), changed files \" +\n      \"(pr_files), reviews and open inline threads (pr_reviews), issue metadata (issue), \" +\n      \"recent comments (comments), or a filtered issue/PR listing (list). number defaults \" +\n      \"to this conversation's issue/PR. Only available in GitHub conversations.\",\n    parameters: githubReadSchema,\n    execute: async (_toolCallId: string, args: GithubReadRequest, signal?: AbortSignal) => {\n      if (!readFn) {\n        throw new Error(\"github_read is only available in GitHub conversations.\");\n      }\n      if (signal?.aborted) {\n        throw new Error(\"Operation aborted\");\n      }\n      const result = await readFn(args);\n      return {\n        content: [{ type: \"text\" as const, text: formatResult(result) }],\n        details: undefined,\n      };\n    },\n  };\n\n  return {\n    tool,\n    setGithubReadFunction: (fn) => {\n      readFn = fn;\n    },\n  };\n}\n"]}
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../../../src/adapters/github/tools/read.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentTool } from \"@earendil-works/pi-agent-core\";\nimport { Type } from \"@sinclair/typebox\";\nimport { defineHostFnTool } from \"../../../tools/host-fn-tool.js\";\nimport type { GithubReadRequest, GithubReadResult } from \"../types.js\";\n\nconst githubReadSchema = Type.Object({\n  action: Type.Union(\n    [\n      Type.Literal(\"pr\"),\n      Type.Literal(\"pr_files\"),\n      Type.Literal(\"pr_reviews\"),\n      Type.Literal(\"issue\"),\n      Type.Literal(\"comments\"),\n      Type.Literal(\"list\"),\n    ],\n    {\n      description:\n        \"pr: PR metadata (state, base/head, diff stats). pr_files: changed files. \" +\n        \"pr_reviews: submitted reviews + open inline threads (with rc- ids for \" +\n        \"github_review_reply). issue: issue metadata. comments: recent conversation \" +\n        \"comments. list: issues/PRs in this repo.\",\n    },\n  ),\n  number: Type.Optional(\n    Type.Number({\n      description: \"Issue/PR number to read; omit for this conversation's own.\",\n    }),\n  ),\n  state: Type.Optional(\n    Type.String({ description: \"list only: open | closed | all (default open).\" }),\n  ),\n  labels: Type.Optional(\n    Type.String({ description: \"list only: comma-separated label names to filter by.\" }),\n  ),\n  creator: Type.Optional(Type.String({ description: \"list only: filter by author login.\" })),\n});\n\nconst MAX_BODY_CHARS = 1000;\nconst MAX_COMMENT_CHARS = 500;\nconst MAX_REVIEW_BODY_CHARS = 300;\n\nfunction truncate(text: string, max: number): string {\n  return text.length > max ? `${text.slice(0, max)}…` : text;\n}\n\nfunction formatResult(result: GithubReadResult): string {\n  switch (result.kind) {\n    case \"pr\": {\n      const pr = result.pr;\n      const flags = [\n        pr.state ?? \"unknown\",\n        pr.draft ? \"draft\" : null,\n        pr.merged ? \"merged\" : null,\n        pr.mergeable_state ? `mergeable_state: ${pr.mergeable_state}` : null,\n      ].filter(Boolean);\n      return [\n        `PR #${pr.number}: ${pr.title ?? \"\"} [${flags.join(\", \")}]`,\n        `${pr.head?.ref ?? \"?\"} → ${pr.base?.ref ?? \"?\"} | ${pr.changed_files ?? \"?\"} files, +${pr.additions ?? \"?\"} -${pr.deletions ?? \"?\"}`,\n        pr.user ? `author: @${pr.user.login}` : null,\n        pr.body ? truncate(pr.body, MAX_BODY_CHARS) : \"(no description)\",\n      ]\n        .filter(Boolean)\n        .join(\"\\n\");\n    }\n    case \"pr_files\": {\n      if (result.files.length === 0) return \"No changed files.\";\n      const lines = result.files.map(\n        (file) => `${file.status.padEnd(8)} ${file.filename} +${file.additions} -${file.deletions}`,\n      );\n      return [`${result.files.length} changed file(s):`, ...lines].join(\"\\n\");\n    }\n    case \"pr_reviews\": {\n      const reviewLines = result.reviews\n        .filter((review) => review.state !== \"PENDING\")\n        .map((review) => {\n          const body = review.body?.trim()\n            ? ` — ${truncate(review.body, MAX_REVIEW_BODY_CHARS)}`\n            : \"\";\n          return `@${review.user.login}: ${review.state}${body}`;\n        });\n      // Thread roots only: replies belong to their root's thread. The rc- id\n      // is what github_review_reply takes.\n      const rootThreads = result.threads.filter((comment) => comment.in_reply_to_id === undefined);\n      const threadLines = rootThreads.map((comment) => {\n        const location = comment.line !== null ? `${comment.path}:${comment.line}` : comment.path;\n        const replies = result.threads.filter((reply) => reply.in_reply_to_id === comment.id);\n        const replyNote =\n          replies.length > 0\n            ? ` (${replies.length} repl${replies.length === 1 ? \"y\" : \"ies\"})`\n            : \"\";\n        return `rc-${comment.id} ${location} @${comment.user.login}${replyNote}: ${truncate(comment.body, MAX_REVIEW_BODY_CHARS)}`;\n      });\n      return [\n        reviewLines.length > 0 ? `Reviews:\\n${reviewLines.join(\"\\n\")}` : \"No submitted reviews.\",\n        threadLines.length > 0\n          ? `Inline threads (reply with github_review_reply):\\n${threadLines.join(\"\\n\")}`\n          : \"No inline review threads.\",\n      ].join(\"\\n\\n\");\n    }\n    case \"issue\": {\n      const issue = result.issue;\n      const labels = (issue.labels ?? []).map((label) => label.name).join(\", \");\n      const assignees = (issue.assignees ?? []).map((assignee) => `@${assignee.login}`).join(\", \");\n      return [\n        `#${issue.number}: ${issue.title} [${issue.state ?? \"unknown\"}${issue.pull_request ? \", PR\" : \"\"}]`,\n        labels ? `labels: ${labels}` : null,\n        assignees ? `assignees: ${assignees}` : null,\n        `author: @${issue.user.login}`,\n        issue.body ? truncate(issue.body, MAX_BODY_CHARS) : \"(no body)\",\n      ]\n        .filter(Boolean)\n        .join(\"\\n\");\n    }\n    case \"comments\": {\n      if (result.comments.length === 0) return \"No comments.\";\n      return result.comments\n        .map(\n          (comment) =>\n            `@${comment.user.login} (${comment.created_at}): ${truncate(comment.body, MAX_COMMENT_CHARS)}`,\n        )\n        .join(\"\\n\");\n    }\n    case \"list\": {\n      if (result.issues.length === 0) return \"No matching issues.\";\n      return result.issues\n        .map((issue) => {\n          const labels = (issue.labels ?? []).map((label) => label.name).join(\", \");\n          const kind = issue.pull_request ? \"PR\" : \"issue\";\n          return `#${issue.number} [${issue.state ?? \"?\"} ${kind}] ${issue.title}${labels ? ` (${labels})` : \"\"}`;\n        })\n        .join(\"\\n\");\n    }\n  }\n}\n\nexport type GithubReadFn = (request: GithubReadRequest) => Promise<GithubReadResult>;\n\n/**\n * The `github_read` tool reads what the ./repo clone cannot show: PR diff\n * stats and changed files, review state with open inline threads, and other\n * issues/PRs in this repo for triage. Read-only, host-side, same-repo by\n * construction; wired per run and only for GitHub conversations.\n */\nexport function createGithubReadTool(): {\n  tool: AgentTool<typeof githubReadSchema>;\n  setGithubReadFunction: (fn: GithubReadFn | null) => void;\n} {\n  const { tool, setFn } = defineHostFnTool<GithubReadFn, typeof githubReadSchema>({\n    name: \"github_read\",\n    description:\n      \"Read GitHub metadata for this repo: PR state/diff stats (pr), changed files \" +\n      \"(pr_files), reviews and open inline threads (pr_reviews), issue metadata (issue), \" +\n      \"recent comments (comments), or a filtered issue/PR listing (list). number defaults \" +\n      \"to this conversation's issue/PR. Only available in GitHub conversations.\",\n    parameters: githubReadSchema,\n    unavailable: \"github_read is only available in GitHub conversations.\",\n    run: async (readFn, args) => {\n      const result = await readFn(args as GithubReadRequest);\n      return {\n        content: [{ type: \"text\" as const, text: formatResult(result) }],\n        details: undefined,\n      };\n    },\n  });\n\n  return { tool, setGithubReadFunction: setFn };\n}\n"]}

package/dist/adapters/github/tools/review-reply.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"review-reply.d.ts","sourceRoot":"","sources":["../../../../src/adapters/github/tools/review-reply.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAG/D,QAAA,MAAM,uBAAuB;;;EAO3B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEhG;;;;GAIG;AACH,wBAAgB,2BAA2B,IAAI;IAC7C,IAAI,EAAE,SAAS,CAAC,OAAO,uBAAuB,CAAC,CAAC;IAChD,4BAA4B,EAAE,CAAC,EAAE,EAAE,mBAAmB,GAAG,IAAI,KAAK,IAAI,CAAC;CACxE,CAyCA"}
+{"version":3,"file":"review-reply.d.ts","sourceRoot":"","sources":["../../../../src/adapters/github/tools/review-reply.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAI/D,QAAA,MAAM,uBAAuB;;;EAO3B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEhG;;;;GAIG;AACH,wBAAgB,2BAA2B,IAAI;IAC7C,IAAI,EAAE,SAAS,CAAC,OAAO,uBAAuB,CAAC,CAAC;IAChD,4BAA4B,EAAE,CAAC,EAAE,EAAE,mBAAmB,GAAG,IAAI,KAAK,IAAI,CAAC;CACxE,CAwBA"}

package/dist/adapters/github/tools/review-reply.js

@@ -1,4 +1,5 @@
 import { Type } from "@sinclair/typebox";
+import { defineHostFnTool } from "../../../tools/host-fn-tool.js";
 const githubReviewReplySchema = Type.Object({
     comment_id: Type.Number({
         description: "Numeric id from an [PR review comment rc-<id> …] message in this conversation " +
@@ -12,21 +13,14 @@ const githubReviewReplySchema = Type.Object({
  * host-side as the App; wired per run and only for GitHub conversations.
  */
 export function createGithubReviewReplyTool() {
-    let replyFn = null;
-    const tool = {
+    const { tool, setFn } = defineHostFnTool({
         name: "github_review_reply",
-        label: "github_review_reply",
         description: "Reply inside a specific PR review thread. Use the numeric id from an " +
             "[PR review comment rc-<id> …] message as comment_id; a plain response would post " +
             "as a normal PR comment instead of in-thread. Only available in GitHub PR conversations.",
         parameters: githubReviewReplySchema,
-        execute: async (_toolCallId, args, signal) => {
-            if (!replyFn) {
-                throw new Error("github_review_reply is only available in GitHub conversations.");
-            }
-            if (signal?.aborted) {
-                throw new Error("Operation aborted");
-            }
+        unavailable: "github_review_reply is only available in GitHub conversations.",
+        run: async (replyFn, args) => {
             const result = await replyFn(args.comment_id, args.body);
             return {
                 content: [
@@ -38,12 +32,7 @@ export function createGithubReviewReplyTool() {
                 details: undefined,
             };
         },
-    };
-    return {
-        tool,
-        setGithubReviewReplyFunction: (fn) => {
-            replyFn = fn;
-        },
-    };
+    });
+    return { tool, setGithubReviewReplyFunction: setFn };
 }
 //# sourceMappingURL=review-reply.js.map

package/dist/adapters/github/tools/review-reply.js.map

@@ -1 +1 @@
-{"version":3,"file":"review-reply.js","sourceRoot":"","sources":["../../../../src/adapters/github/tools/review-reply.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,MAAM,uBAAuB,GAAG,IAAI,CAAC,MAAM,CAAC;IAC1C,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;QACtB,WAAW,EACT,gFAAgF;YAChF,wEAAwE;KAC3E,CAAC;IACF,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,wBAAwB,EAAE,CAAC;CAC7D,CAAC,CAAC;AAIH;;;;GAIG;AACH,MAAM,UAAU,2BAA2B;IAIzC,IAAI,OAAO,GAA+B,IAAI,CAAC;IAE/C,MAAM,IAAI,GAA8C;QACtD,IAAI,EAAE,qBAAqB;QAC3B,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EACT,uEAAuE;YACvE,mFAAmF;YACnF,yFAAyF;QAC3F,UAAU,EAAE,uBAAuB;QACnC,OAAO,EAAE,KAAK,EACZ,WAAmB,EACnB,IAA0C,EAC1C,MAAoB,EACpB,EAAE;YACF,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;YACpF,CAAC;YACD,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;YACvC,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACzD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,+BAA+B,IAAI,CAAC,UAAU,KAAK,MAAM,CAAC,GAAG,EAAE;qBACtE;iBACF;gBACD,OAAO,EAAE,SAAS;aACnB,CAAC;QACJ,CAAC;KACF,CAAC;IAEF,OAAO;QACL,IAAI;QACJ,4BAA4B,EAAE,CAAC,EAAE,EAAE,EAAE;YACnC,OAAO,GAAG,EAAE,CAAC;QACf,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type { AgentTool } from \"@earendil-works/pi-agent-core\";\nimport { Type } from \"@sinclair/typebox\";\n\nconst githubReviewReplySchema = Type.Object({\n  comment_id: Type.Number({\n    description:\n      \"Numeric id from an [PR review comment rc-<id> …] message in this conversation \" +\n      \"(e.g. 8001 for rc-8001). The reply lands inside that comment's thread.\",\n  }),\n  body: Type.String({ description: \"Reply text (Markdown).\" }),\n});\n\nexport type GithubReviewReplyFn = (commentId: number, body: string) => Promise<{ url: string }>;\n\n/**\n * The `github_review_reply` tool answers inside one inline PR review thread\n * (the responder's normal replies post as plain PR comments instead). Runs\n * host-side as the App; wired per run and only for GitHub conversations.\n */\nexport function createGithubReviewReplyTool(): {\n  tool: AgentTool<typeof githubReviewReplySchema>;\n  setGithubReviewReplyFunction: (fn: GithubReviewReplyFn | null) => void;\n} {\n  let replyFn: GithubReviewReplyFn | null = null;\n\n  const tool: AgentTool<typeof githubReviewReplySchema> = {\n    name: \"github_review_reply\",\n    label: \"github_review_reply\",\n    description:\n      \"Reply inside a specific PR review thread. Use the numeric id from an \" +\n      \"[PR review comment rc-<id> …] message as comment_id; a plain response would post \" +\n      \"as a normal PR comment instead of in-thread. Only available in GitHub PR conversations.\",\n    parameters: githubReviewReplySchema,\n    execute: async (\n      _toolCallId: string,\n      args: { comment_id: number; body: string },\n      signal?: AbortSignal,\n    ) => {\n      if (!replyFn) {\n        throw new Error(\"github_review_reply is only available in GitHub conversations.\");\n      }\n      if (signal?.aborted) {\n        throw new Error(\"Operation aborted\");\n      }\n      const result = await replyFn(args.comment_id, args.body);\n      return {\n        content: [\n          {\n            type: \"text\" as const,\n            text: `Replied in review thread rc-${args.comment_id}: ${result.url}`,\n          },\n        ],\n        details: undefined,\n      };\n    },\n  };\n\n  return {\n    tool,\n    setGithubReviewReplyFunction: (fn) => {\n      replyFn = fn;\n    },\n  };\n}\n"]}
+{"version":3,"file":"review-reply.js","sourceRoot":"","sources":["../../../../src/adapters/github/tools/review-reply.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE,MAAM,uBAAuB,GAAG,IAAI,CAAC,MAAM,CAAC;IAC1C,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;QACtB,WAAW,EACT,gFAAgF;YAChF,wEAAwE;KAC3E,CAAC;IACF,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,wBAAwB,EAAE,CAAC;CAC7D,CAAC,CAAC;AAIH;;;;GAIG;AACH,MAAM,UAAU,2BAA2B;IAIzC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,gBAAgB,CAAsD;QAC5F,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EACT,uEAAuE;YACvE,mFAAmF;YACnF,yFAAyF;QAC3F,UAAU,EAAE,uBAAuB;QACnC,WAAW,EAAE,gEAAgE;QAC7E,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;YAC3B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACzD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,+BAA+B,IAAI,CAAC,UAAU,KAAK,MAAM,CAAC,GAAG,EAAE;qBACtE;iBACF;gBACD,OAAO,EAAE,SAAS;aACnB,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,EAAE,IAAI,EAAE,4BAA4B,EAAE,KAAK,EAAE,CAAC;AACvD,CAAC","sourcesContent":["import type { AgentTool } from \"@earendil-works/pi-agent-core\";\nimport { Type } from \"@sinclair/typebox\";\nimport { defineHostFnTool } from \"../../../tools/host-fn-tool.js\";\n\nconst githubReviewReplySchema = Type.Object({\n  comment_id: Type.Number({\n    description:\n      \"Numeric id from an [PR review comment rc-<id> …] message in this conversation \" +\n      \"(e.g. 8001 for rc-8001). The reply lands inside that comment's thread.\",\n  }),\n  body: Type.String({ description: \"Reply text (Markdown).\" }),\n});\n\nexport type GithubReviewReplyFn = (commentId: number, body: string) => Promise<{ url: string }>;\n\n/**\n * The `github_review_reply` tool answers inside one inline PR review thread\n * (the responder's normal replies post as plain PR comments instead). Runs\n * host-side as the App; wired per run and only for GitHub conversations.\n */\nexport function createGithubReviewReplyTool(): {\n  tool: AgentTool<typeof githubReviewReplySchema>;\n  setGithubReviewReplyFunction: (fn: GithubReviewReplyFn | null) => void;\n} {\n  const { tool, setFn } = defineHostFnTool<GithubReviewReplyFn, typeof githubReviewReplySchema>({\n    name: \"github_review_reply\",\n    description:\n      \"Reply inside a specific PR review thread. Use the numeric id from an \" +\n      \"[PR review comment rc-<id> …] message as comment_id; a plain response would post \" +\n      \"as a normal PR comment instead of in-thread. Only available in GitHub PR conversations.\",\n    parameters: githubReviewReplySchema,\n    unavailable: \"github_review_reply is only available in GitHub conversations.\",\n    run: async (replyFn, args) => {\n      const result = await replyFn(args.comment_id, args.body);\n      return {\n        content: [\n          {\n            type: \"text\" as const,\n            text: `Replied in review thread rc-${args.comment_id}: ${result.url}`,\n          },\n        ],\n        details: undefined,\n      };\n    },\n  });\n\n  return { tool, setGithubReviewReplyFunction: setFn };\n}\n"]}

package/dist/adapters/github/tools/sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../../src/adapters/github/tools/sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAG/D,QAAA,MAAM,gBAAgB;;EAQpB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEhE;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI;IACtC,IAAI,EAAE,SAAS,CAAC,OAAO,gBAAgB,CAAC,CAAC;IACzC,qBAAqB,EAAE,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,KAAK,IAAI,CAAC;CAC1D,CAiCA"}
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../../src/adapters/github/tools/sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAI/D,QAAA,MAAM,gBAAgB;;EAQpB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEhE;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI;IACtC,IAAI,EAAE,SAAS,CAAC,OAAO,gBAAgB,CAAC,CAAC;IACzC,qBAAqB,EAAE,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,KAAK,IAAI,CAAC;CAC1D,CAoBA"}

package/dist/adapters/github/tools/sync.js

@@ -1,4 +1,5 @@
 import { Type } from "@sinclair/typebox";
+import { defineHostFnTool } from "../../../tools/host-fn-tool.js";
 const githubSyncSchema = Type.Object({
     branch: Type.Optional(Type.String({
         description: "Remote branch to fetch. Omit to fetch this PR's latest head (or the default " +
@@ -12,34 +13,22 @@ const githubSyncSchema = Type.Object({
  * the checkout whenever that could lose the agent's local work.
  */
 export function createGithubSyncTool() {
-    let syncFn = null;
-    const tool = {
+    const { tool, setFn } = defineHostFnTool({
         name: "github_sync",
-        label: "github_sync",
         description: "Update ./repo from GitHub: fetches this PR's latest head (or the default branch, " +
             "or a named branch) and fast-forwards the checkout when that cannot lose your work; " +
             "otherwise it fetches to FETCH_HEAD and reports so you can merge or rebase yourself. " +
             "Only available in GitHub conversations.",
         parameters: githubSyncSchema,
-        execute: async (_toolCallId, args, signal) => {
-            if (!syncFn) {
-                throw new Error("github_sync is only available in GitHub conversations.");
-            }
-            if (signal?.aborted) {
-                throw new Error("Operation aborted");
-            }
+        unavailable: "github_sync is only available in GitHub conversations.",
+        run: async (syncFn, args) => {
             const report = await syncFn(args.branch);
             return {
                 content: [{ type: "text", text: report }],
                 details: undefined,
             };
         },
-    };
-    return {
-        tool,
-        setGithubSyncFunction: (fn) => {
-            syncFn = fn;
-        },
-    };
+    });
+    return { tool, setGithubSyncFunction: setFn };
 }
 //# sourceMappingURL=sync.js.map

package/dist/adapters/github/tools/sync.js.map

@@ -1 +1 @@
-{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../../../src/adapters/github/tools/sync.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,MAAM,gBAAgB,GAAG,IAAI,CAAC,MAAM,CAAC;IACnC,MAAM,EAAE,IAAI,CAAC,QAAQ,CACnB,IAAI,CAAC,MAAM,CAAC;QACV,WAAW,EACT,8EAA8E;YAC9E,wCAAwC;KAC3C,CAAC,CACH;CACF,CAAC,CAAC;AAIH;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB;IAIlC,IAAI,MAAM,GAAwB,IAAI,CAAC;IAEvC,MAAM,IAAI,GAAuC;QAC/C,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,aAAa;QACpB,WAAW,EACT,mFAAmF;YACnF,qFAAqF;YACrF,sFAAsF;YACtF,yCAAyC;QAC3C,UAAU,EAAE,gBAAgB;QAC5B,OAAO,EAAE,KAAK,EAAE,WAAmB,EAAE,IAAyB,EAAE,MAAoB,EAAE,EAAE;YACtF,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;YAC5E,CAAC;YACD,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;YACvC,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACzC,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;gBAClD,OAAO,EAAE,SAAS;aACnB,CAAC;QACJ,CAAC;KACF,CAAC;IAEF,OAAO;QACL,IAAI;QACJ,qBAAqB,EAAE,CAAC,EAAE,EAAE,EAAE;YAC5B,MAAM,GAAG,EAAE,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type { AgentTool } from \"@earendil-works/pi-agent-core\";\nimport { Type } from \"@sinclair/typebox\";\n\nconst githubSyncSchema = Type.Object({\n  branch: Type.Optional(\n    Type.String({\n      description:\n        \"Remote branch to fetch. Omit to fetch this PR's latest head (or the default \" +\n        \"branch in a plain-issue conversation).\",\n    }),\n  ),\n});\n\nexport type GithubSyncFn = (branch?: string) => Promise<string>;\n\n/**\n * The `github_sync` tool refreshes the conversation's ./repo clone — a\n * first-contact snapshot the sandbox cannot update itself (no credentials).\n * Host-side fetch with an ephemeral read token; it reports instead of moving\n * the checkout whenever that could lose the agent's local work.\n */\nexport function createGithubSyncTool(): {\n  tool: AgentTool<typeof githubSyncSchema>;\n  setGithubSyncFunction: (fn: GithubSyncFn | null) => void;\n} {\n  let syncFn: GithubSyncFn | null = null;\n\n  const tool: AgentTool<typeof githubSyncSchema> = {\n    name: \"github_sync\",\n    label: \"github_sync\",\n    description:\n      \"Update ./repo from GitHub: fetches this PR's latest head (or the default branch, \" +\n      \"or a named branch) and fast-forwards the checkout when that cannot lose your work; \" +\n      \"otherwise it fetches to FETCH_HEAD and reports so you can merge or rebase yourself. \" +\n      \"Only available in GitHub conversations.\",\n    parameters: githubSyncSchema,\n    execute: async (_toolCallId: string, args: { branch?: string }, signal?: AbortSignal) => {\n      if (!syncFn) {\n        throw new Error(\"github_sync is only available in GitHub conversations.\");\n      }\n      if (signal?.aborted) {\n        throw new Error(\"Operation aborted\");\n      }\n      const report = await syncFn(args.branch);\n      return {\n        content: [{ type: \"text\" as const, text: report }],\n        details: undefined,\n      };\n    },\n  };\n\n  return {\n    tool,\n    setGithubSyncFunction: (fn) => {\n      syncFn = fn;\n    },\n  };\n}\n"]}
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../../../src/adapters/github/tools/sync.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE,MAAM,gBAAgB,GAAG,IAAI,CAAC,MAAM,CAAC;IACnC,MAAM,EAAE,IAAI,CAAC,QAAQ,CACnB,IAAI,CAAC,MAAM,CAAC;QACV,WAAW,EACT,8EAA8E;YAC9E,wCAAwC;KAC3C,CAAC,CACH;CACF,CAAC,CAAC;AAIH;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB;IAIlC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,gBAAgB,CAAwC;QAC9E,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,mFAAmF;YACnF,qFAAqF;YACrF,sFAAsF;YACtF,yCAAyC;QAC3C,UAAU,EAAE,gBAAgB;QAC5B,WAAW,EAAE,wDAAwD;QACrE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;YAC1B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACzC,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;gBAClD,OAAO,EAAE,SAAS;aACnB,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,EAAE,IAAI,EAAE,qBAAqB,EAAE,KAAK,EAAE,CAAC;AAChD,CAAC","sourcesContent":["import type { AgentTool } from \"@earendil-works/pi-agent-core\";\nimport { Type } from \"@sinclair/typebox\";\nimport { defineHostFnTool } from \"../../../tools/host-fn-tool.js\";\n\nconst githubSyncSchema = Type.Object({\n  branch: Type.Optional(\n    Type.String({\n      description:\n        \"Remote branch to fetch. Omit to fetch this PR's latest head (or the default \" +\n        \"branch in a plain-issue conversation).\",\n    }),\n  ),\n});\n\nexport type GithubSyncFn = (branch?: string) => Promise<string>;\n\n/**\n * The `github_sync` tool refreshes the conversation's ./repo clone — a\n * first-contact snapshot the sandbox cannot update itself (no credentials).\n * Host-side fetch with an ephemeral read token; it reports instead of moving\n * the checkout whenever that could lose the agent's local work.\n */\nexport function createGithubSyncTool(): {\n  tool: AgentTool<typeof githubSyncSchema>;\n  setGithubSyncFunction: (fn: GithubSyncFn | null) => void;\n} {\n  const { tool, setFn } = defineHostFnTool<GithubSyncFn, typeof githubSyncSchema>({\n    name: \"github_sync\",\n    description:\n      \"Update ./repo from GitHub: fetches this PR's latest head (or the default branch, \" +\n      \"or a named branch) and fast-forwards the checkout when that cannot lose your work; \" +\n      \"otherwise it fetches to FETCH_HEAD and reports so you can merge or rebase yourself. \" +\n      \"Only available in GitHub conversations.\",\n    parameters: githubSyncSchema,\n    unavailable: \"github_sync is only available in GitHub conversations.\",\n    run: async (syncFn, args) => {\n      const report = await syncFn(args.branch);\n      return {\n        content: [{ type: \"text\" as const, text: report }],\n        details: undefined,\n      };\n    },\n  });\n\n  return { tool, setGithubSyncFunction: setFn };\n}\n"]}

package/dist/adapters/slack/bot.js

@@ -10,7 +10,7 @@ import { PRODUCT_NAME, formatForceStopped } from "../../platform-messages.js";
 import { appendBotResponseLog, appendChannelLog, MessagingEventQueue, withRetry, } from "../shared.js";
 import { processMessageIntake } from "../intake.js";
 import { createSlackAdapters } from "./context.js";
-import { hasMaterializedChatSession, registerThreadSession, } from "../../sessions/agent-memory-file-manager.js";
+import { hasMaterializedChatSession, registerThreadSession, } from "../../sessions/chat-history-sync.js";
 import { conversationIdOf } from "../../sessions/session-key.js";
 import { isSlackThreadSessionKey, planSlackAdapterSession, planSlackEventAnchorRun, resolveSlackSessionKey, } from "./session.js";
 import { reportUserFacingError } from "../../observability/sentry.js";