@geminixiang/mikan 1.0.0-beta.13 → 1.0.0-beta.14

package/dist/{tools/github-checks.js → adapters/github/tools/checks.js}

@@ -5,8 +5,12 @@ const githubChecksSchema = Type.Object({
             "Omit in a pull-request conversation to read the PR head's checks.",
     })),
     job_id: Type.Optional(Type.Number({
-        description: "A check's job id from the summary output — returns that CI job's log " +
-            "(tail) instead of the summary, for diagnosing a failing check.",
+        description: "A [job …] id from the summary output (GitHub Actions checks) — returns that " +
+            "CI job's log (tail) instead of the summary, for diagnosing a failing check.",
+    })),
+    build_id: Type.Optional(Type.String({
+        description: "A [build …] uuid from the summary output (Cloud Build checks) — returns that " +
+            "build's log (tail) instead of the summary. Mutually exclusive with job_id.",
     })),
 });
 /** Conclusions that mean "this check did not pass and needs attention". */
@@ -20,12 +24,14 @@ function formatCheckLine(run) {
             : run.conclusion === "success"
                 ? "✓"
                 : "−";
-    // Only GitHub Actions checks have logs fetchable via job_id; external CI
-    // (Cloud Build & co.) keeps logs on its own service, so advertising an id
-    // there would only invite doomed fetches.
+    // GitHub Actions logs fetch via job_id; Cloud Build logs via build_id when
+    // the host has GCP credentials. Other external CI keeps logs on its own
+    // service, so advertising an id there would only invite doomed fetches.
     const handle = run.appSlug === "github-actions"
         ? `[job ${run.id}]`
-        : `[external CI: ${run.appSlug ?? "unknown"} — logs not on GitHub]`;
+        : run.buildLogAvailable && run.externalId
+            ? `[build ${run.externalId}]`
+            : `[external CI: ${run.appSlug ?? "unknown"} — logs not on GitHub]`;
     const line = `${marker} ${run.name}: ${state} ${handle}${run.url ? ` (${run.url})` : ""}`;
     const failed = run.conclusion !== null && FAILING_CONCLUSIONS.has(run.conclusion);
     return failed && run.outputSummary
@@ -44,10 +50,11 @@ export function createGithubChecksTool() {
         name: "github_checks",
         label: "github_checks",
         description: "Read CI status (check runs) for a branch you pushed with github_pr, or for this " +
-            "conversation's pull request when branch is omitted. Pass job_id (a [job …] id from " +
-            "the summary — GitHub Actions checks only) to fetch that job's log. External CI " +
-            "checks (e.g. Cloud Build) keep logs on their own service: use their summary/url, or " +
-            "reproduce the failure locally in ./repo. Only available in GitHub conversations.",
+            "conversation's pull request when branch is omitted. Pass job_id (a [job …] id, " +
+            "GitHub Actions) or build_id (a [build …] uuid, Cloud Build) from the summary to " +
+            "fetch that run's log. Other external CI checks keep logs on their own service: use " +
+            "their summary/url, or reproduce the failure locally in ./repo. Only available in " +
+            "GitHub conversations.",
         parameters: githubChecksSchema,
         execute: async (_toolCallId, args, signal) => {
             if (!checksFns) {
@@ -56,6 +63,9 @@ export function createGithubChecksTool() {
             if (signal?.aborted) {
                 throw new Error("Operation aborted");
             }
+            if (args.job_id !== undefined && args.build_id !== undefined) {
+                throw new Error("Pass either job_id or build_id, not both.");
+            }
             if (args.job_id !== undefined) {
                 const logText = await checksFns.getJobLog(args.job_id);
                 return {
@@ -63,6 +73,13 @@ export function createGithubChecksTool() {
                     details: undefined,
                 };
             }
+            if (args.build_id !== undefined) {
+                const logText = await checksFns.getBuildLog(args.build_id);
+                return {
+                    content: [{ type: "text", text: logText || "(empty log)" }],
+                    details: undefined,
+                };
+            }
             const runs = await checksFns.getChecks(args.branch);
             if (runs.length === 0) {
                 return {
@@ -96,4 +113,4 @@ export function createGithubChecksTool() {
         },
     };
 }
-//# sourceMappingURL=github-checks.js.map
+//# sourceMappingURL=checks.js.map

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

@@ -0,0 +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"]}

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

@@ -0,0 +1,22 @@
+import type { AgentTool } from "@earendil-works/pi-agent-core";
+import type { GithubIssueRequest } from "../types.js";
+declare const githubIssueSchema: import("@sinclair/typebox").TObject<{
+    action: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"add_labels">, import("@sinclair/typebox").TLiteral<"remove_label">, import("@sinclair/typebox").TLiteral<"add_assignees">, import("@sinclair/typebox").TLiteral<"remove_assignees">, import("@sinclair/typebox").TLiteral<"close">, import("@sinclair/typebox").TLiteral<"reopen">]>;
+    number: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    labels: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    label: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    assignees: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    state_reason: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"completed">, import("@sinclair/typebox").TLiteral<"not_planned">]>>;
+}>;
+export type GithubIssueFn = (request: GithubIssueRequest) => Promise<string>;
+/**
+ * The `github_issue` tool manages labels, assignees, and open/closed state of
+ * issues in the conversation's repo (any issue number — triage). Host-side as
+ * the App; wired per run and only for GitHub conversations.
+ */
+export declare function createGithubIssueTool(): {
+    tool: AgentTool<typeof githubIssueSchema>;
+    setGithubIssueFunction: (fn: GithubIssueFn | null) => void;
+};
+export {};
+//# sourceMappingURL=issue.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,59 @@
+import { Type } from "@sinclair/typebox";
+const githubIssueSchema = Type.Object({
+    action: Type.Union([
+        Type.Literal("add_labels"),
+        Type.Literal("remove_label"),
+        Type.Literal("add_assignees"),
+        Type.Literal("remove_assignees"),
+        Type.Literal("close"),
+        Type.Literal("reopen"),
+    ], { description: "Issue management action." }),
+    number: Type.Optional(Type.Number({
+        description: "Issue/PR number in this repo; omit for this conversation's own.",
+    })),
+    labels: Type.Optional(Type.Array(Type.String(), { description: "add_labels: label names to add." })),
+    label: Type.Optional(Type.String({ description: "remove_label: the label name to remove." })),
+    assignees: Type.Optional(Type.Array(Type.String(), {
+        description: "add_assignees / remove_assignees: GitHub logins.",
+    })),
+    state_reason: Type.Optional(Type.Union([Type.Literal("completed"), Type.Literal("not_planned")], {
+        description: "close: why the issue is being closed.",
+    })),
+});
+/**
+ * The `github_issue` tool manages labels, assignees, and open/closed state of
+ * issues in the conversation's repo (any issue number — triage). Host-side as
+ * the App; wired per run and only for GitHub conversations.
+ */
+export function createGithubIssueTool() {
+    let issueFn = null;
+    const tool = {
+        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");
+            }
+            const report = await issueFn(args);
+            return {
+                content: [{ type: "text", text: report }],
+                details: undefined,
+            };
+        },
+    };
+    return {
+        tool,
+        setGithubIssueFunction: (fn) => {
+            issueFn = fn;
+        },
+    };
+}
+//# sourceMappingURL=issue.js.map

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

@@ -0,0 +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"]}

package/dist/{tools/github-pr.d.ts → adapters/github/tools/pr.d.ts}

@@ -1,5 +1,5 @@
 import type { AgentTool } from "@earendil-works/pi-agent-core";
-import type { GithubPrRequest, GithubPrResult } from "../adapters/github/types.js";
+import type { GithubPrRequest, GithubPrResult } from "../types.js";
 declare const githubPrSchema: import("@sinclair/typebox").TObject<{
     branch: import("@sinclair/typebox").TString;
     title: import("@sinclair/typebox").TString;
@@ -19,4 +19,4 @@ export declare function createGithubPrTool(): {
     setGithubPrFunction: (fn: ((request: GithubPrRequest) => Promise<GithubPrResult>) | null) => void;
 };
 export {};
-//# sourceMappingURL=github-pr.d.ts.map
+//# sourceMappingURL=pr.d.ts.map

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

@@ -0,0 +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"}

package/dist/{tools/github-pr.js → adapters/github/tools/pr.js}

@@ -1,7 +1,9 @@
 import { Type } from "@sinclair/typebox";
 const githubPrSchema = Type.Object({
     branch: Type.String({
-        description: 'Local branch inside ./repo to push. Must be named pi/<something> (e.g. "pi/fix-42"); the default branch is never pushable.',
+        description: 'Local branch inside ./repo to push. Must be named pi/<something> (e.g. "pi/fix-42"); ' +
+            "the default branch is never pushable. To update this conversation's own PR, pass its " +
+            "checked-out pi/* head branch.",
     }),
     title: Type.String({ description: "Pull request title." }),
     body: Type.Optional(Type.String({ description: "Pull request description (Markdown)." })),
@@ -21,8 +23,10 @@ export function createGithubPrTool() {
         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. Only available in GitHub issue/PR conversations. You cannot push " +
-            "to the default branch and you cannot merge — humans review and merge the PR.",
+            "(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) {
@@ -52,4 +56,4 @@ export function createGithubPrTool() {
         },
     };
 }
-//# sourceMappingURL=github-pr.js.map
+//# sourceMappingURL=pr.js.map

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

@@ -0,0 +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"]}

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

@@ -0,0 +1,22 @@
+import type { AgentTool } from "@earendil-works/pi-agent-core";
+import type { GithubReadRequest, GithubReadResult } from "../types.js";
+declare const githubReadSchema: import("@sinclair/typebox").TObject<{
+    action: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"pr">, import("@sinclair/typebox").TLiteral<"pr_files">, import("@sinclair/typebox").TLiteral<"pr_reviews">, import("@sinclair/typebox").TLiteral<"issue">, import("@sinclair/typebox").TLiteral<"comments">, import("@sinclair/typebox").TLiteral<"list">]>;
+    number: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    state: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    labels: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    creator: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export type GithubReadFn = (request: GithubReadRequest) => Promise<GithubReadResult>;
+/**
+ * The `github_read` tool reads what the ./repo clone cannot show: PR diff
+ * stats and changed files, review state with open inline threads, and other
+ * issues/PRs in this repo for triage. Read-only, host-side, same-repo by
+ * construction; wired per run and only for GitHub conversations.
+ */
+export declare function createGithubReadTool(): {
+    tool: AgentTool<typeof githubReadSchema>;
+    setGithubReadFunction: (fn: GithubReadFn | null) => void;
+};
+export {};
+//# sourceMappingURL=read.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,152 @@
+import { Type } from "@sinclair/typebox";
+const githubReadSchema = Type.Object({
+    action: Type.Union([
+        Type.Literal("pr"),
+        Type.Literal("pr_files"),
+        Type.Literal("pr_reviews"),
+        Type.Literal("issue"),
+        Type.Literal("comments"),
+        Type.Literal("list"),
+    ], {
+        description: "pr: PR metadata (state, base/head, diff stats). pr_files: changed files. " +
+            "pr_reviews: submitted reviews + open inline threads (with rc- ids for " +
+            "github_review_reply). issue: issue metadata. comments: recent conversation " +
+            "comments. list: issues/PRs in this repo.",
+    }),
+    number: Type.Optional(Type.Number({
+        description: "Issue/PR number to read; omit for this conversation's own.",
+    })),
+    state: Type.Optional(Type.String({ description: "list only: open | closed | all (default open)." })),
+    labels: Type.Optional(Type.String({ description: "list only: comma-separated label names to filter by." })),
+    creator: Type.Optional(Type.String({ description: "list only: filter by author login." })),
+});
+const MAX_BODY_CHARS = 1000;
+const MAX_COMMENT_CHARS = 500;
+const MAX_REVIEW_BODY_CHARS = 300;
+function truncate(text, max) {
+    return text.length > max ? `${text.slice(0, max)}…` : text;
+}
+function formatResult(result) {
+    switch (result.kind) {
+        case "pr": {
+            const pr = result.pr;
+            const flags = [
+                pr.state ?? "unknown",
+                pr.draft ? "draft" : null,
+                pr.merged ? "merged" : null,
+                pr.mergeable_state ? `mergeable_state: ${pr.mergeable_state}` : null,
+            ].filter(Boolean);
+            return [
+                `PR #${pr.number}: ${pr.title ?? ""} [${flags.join(", ")}]`,
+                `${pr.head?.ref ?? "?"} → ${pr.base?.ref ?? "?"} | ${pr.changed_files ?? "?"} files, +${pr.additions ?? "?"} -${pr.deletions ?? "?"}`,
+                pr.user ? `author: @${pr.user.login}` : null,
+                pr.body ? truncate(pr.body, MAX_BODY_CHARS) : "(no description)",
+            ]
+                .filter(Boolean)
+                .join("\n");
+        }
+        case "pr_files": {
+            if (result.files.length === 0)
+                return "No changed files.";
+            const lines = result.files.map((file) => `${file.status.padEnd(8)} ${file.filename} +${file.additions} -${file.deletions}`);
+            return [`${result.files.length} changed file(s):`, ...lines].join("\n");
+        }
+        case "pr_reviews": {
+            const reviewLines = result.reviews
+                .filter((review) => review.state !== "PENDING")
+                .map((review) => {
+                const body = review.body?.trim()
+                    ? ` — ${truncate(review.body, MAX_REVIEW_BODY_CHARS)}`
+                    : "";
+                return `@${review.user.login}: ${review.state}${body}`;
+            });
+            // Thread roots only: replies belong to their root's thread. The rc- id
+            // is what github_review_reply takes.
+            const rootThreads = result.threads.filter((comment) => comment.in_reply_to_id === undefined);
+            const threadLines = rootThreads.map((comment) => {
+                const location = comment.line !== null ? `${comment.path}:${comment.line}` : comment.path;
+                const replies = result.threads.filter((reply) => reply.in_reply_to_id === comment.id);
+                const replyNote = replies.length > 0
+                    ? ` (${replies.length} repl${replies.length === 1 ? "y" : "ies"})`
+                    : "";
+                return `rc-${comment.id} ${location} @${comment.user.login}${replyNote}: ${truncate(comment.body, MAX_REVIEW_BODY_CHARS)}`;
+            });
+            return [
+                reviewLines.length > 0 ? `Reviews:\n${reviewLines.join("\n")}` : "No submitted reviews.",
+                threadLines.length > 0
+                    ? `Inline threads (reply with github_review_reply):\n${threadLines.join("\n")}`
+                    : "No inline review threads.",
+            ].join("\n\n");
+        }
+        case "issue": {
+            const issue = result.issue;
+            const labels = (issue.labels ?? []).map((label) => label.name).join(", ");
+            const assignees = (issue.assignees ?? []).map((assignee) => `@${assignee.login}`).join(", ");
+            return [
+                `#${issue.number}: ${issue.title} [${issue.state ?? "unknown"}${issue.pull_request ? ", PR" : ""}]`,
+                labels ? `labels: ${labels}` : null,
+                assignees ? `assignees: ${assignees}` : null,
+                `author: @${issue.user.login}`,
+                issue.body ? truncate(issue.body, MAX_BODY_CHARS) : "(no body)",
+            ]
+                .filter(Boolean)
+                .join("\n");
+        }
+        case "comments": {
+            if (result.comments.length === 0)
+                return "No comments.";
+            return result.comments
+                .map((comment) => `@${comment.user.login} (${comment.created_at}): ${truncate(comment.body, MAX_COMMENT_CHARS)}`)
+                .join("\n");
+        }
+        case "list": {
+            if (result.issues.length === 0)
+                return "No matching issues.";
+            return result.issues
+                .map((issue) => {
+                const labels = (issue.labels ?? []).map((label) => label.name).join(", ");
+                const kind = issue.pull_request ? "PR" : "issue";
+                return `#${issue.number} [${issue.state ?? "?"} ${kind}] ${issue.title}${labels ? ` (${labels})` : ""}`;
+            })
+                .join("\n");
+        }
+    }
+}
+/**
+ * The `github_read` tool reads what the ./repo clone cannot show: PR diff
+ * stats and changed files, review state with open inline threads, and other
+ * issues/PRs in this repo for triage. Read-only, host-side, same-repo by
+ * construction; wired per run and only for GitHub conversations.
+ */
+export function createGithubReadTool() {
+    let readFn = null;
+    const tool = {
+        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");
+            }
+            const result = await readFn(args);
+            return {
+                content: [{ type: "text", text: formatResult(result) }],
+                details: undefined,
+            };
+        },
+    };
+    return {
+        tool,
+        setGithubReadFunction: (fn) => {
+            readFn = fn;
+        },
+    };
+}
+//# sourceMappingURL=read.js.map

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

@@ -0,0 +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"]}

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

@@ -0,0 +1,19 @@
+import type { AgentTool } from "@earendil-works/pi-agent-core";
+declare const githubReviewReplySchema: import("@sinclair/typebox").TObject<{
+    comment_id: import("@sinclair/typebox").TNumber;
+    body: import("@sinclair/typebox").TString;
+}>;
+export type GithubReviewReplyFn = (commentId: number, body: string) => Promise<{
+    url: string;
+}>;
+/**
+ * The `github_review_reply` tool answers inside one inline PR review thread
+ * (the responder's normal replies post as plain PR comments instead). Runs
+ * host-side as the App; wired per run and only for GitHub conversations.
+ */
+export declare function createGithubReviewReplyTool(): {
+    tool: AgentTool<typeof githubReviewReplySchema>;
+    setGithubReviewReplyFunction: (fn: GithubReviewReplyFn | null) => void;
+};
+export {};
+//# sourceMappingURL=review-reply.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,49 @@
+import { Type } from "@sinclair/typebox";
+const githubReviewReplySchema = Type.Object({
+    comment_id: Type.Number({
+        description: "Numeric id from an [PR review comment rc-<id> …] message in this conversation " +
+            "(e.g. 8001 for rc-8001). The reply lands inside that comment's thread.",
+    }),
+    body: Type.String({ description: "Reply text (Markdown)." }),
+});
+/**
+ * The `github_review_reply` tool answers inside one inline PR review thread
+ * (the responder's normal replies post as plain PR comments instead). Runs
+ * host-side as the App; wired per run and only for GitHub conversations.
+ */
+export function createGithubReviewReplyTool() {
+    let replyFn = null;
+    const tool = {
+        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");
+            }
+            const result = await replyFn(args.comment_id, args.body);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Replied in review thread rc-${args.comment_id}: ${result.url}`,
+                    },
+                ],
+                details: undefined,
+            };
+        },
+    };
+    return {
+        tool,
+        setGithubReviewReplyFunction: (fn) => {
+            replyFn = fn;
+        },
+    };
+}
+//# sourceMappingURL=review-reply.js.map

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

@@ -0,0 +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"]}

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

@@ -0,0 +1,17 @@
+import type { AgentTool } from "@earendil-works/pi-agent-core";
+declare const githubSyncSchema: import("@sinclair/typebox").TObject<{
+    branch: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export type GithubSyncFn = (branch?: string) => Promise<string>;
+/**
+ * The `github_sync` tool refreshes the conversation's ./repo clone — a
+ * first-contact snapshot the sandbox cannot update itself (no credentials).
+ * Host-side fetch with an ephemeral read token; it reports instead of moving
+ * the checkout whenever that could lose the agent's local work.
+ */
+export declare function createGithubSyncTool(): {
+    tool: AgentTool<typeof githubSyncSchema>;
+    setGithubSyncFunction: (fn: GithubSyncFn | null) => void;
+};
+export {};
+//# sourceMappingURL=sync.d.ts.map

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

@@ -0,0 +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"}