@geminixiang/mikan 1.0.0-beta.9 → 1.0.0-beta.91

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

@@ -0,0 +1,78 @@
+import { Type } from "typebox";
+import { defineHostFnTool } from "../../../harness/tools/host-fn-tool.js";
+export const GITHUB_CHECKS_TOOL = "github_checks";
+const githubChecksSchema = Type.Object({
+    branch: Type.Optional(Type.String({
+        description: "Branch whose CI checks to read (e.g. a pi/<name> branch you pushed). " +
+            "Omit in a pull-request conversation to read the PR head's checks.",
+    })),
+    job_id: Type.Optional(Type.Number({
+        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.",
+    })),
+});
+const FAILING_CONCLUSIONS = new Set(["failure", "timed_out", "action_required", "cancelled"]);
+function formatCheckLine(run) {
+    const state = run.status === "completed" ? (run.conclusion ?? "unknown") : run.status;
+    const marker = run.conclusion === null
+        ? "…"
+        : FAILING_CONCLUSIONS.has(run.conclusion)
+            ? "✗"
+            : run.conclusion === "success"
+                ? "✓"
+                : "−";
+    const handle = run.source === "actions" ? `[job ${run.id}]` : "[commit status — 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
+        ? `${line}\n  ↳ ${run.outputSummary.replace(/\s*\n\s*/g, " ")}`
+        : line;
+}
+export function createGithubChecksTool() {
+    const { tool, setFn } = defineHostFnTool({
+        name: GITHUB_CHECKS_TOOL,
+        description: "Read CI status (GitHub Actions jobs and commit statuses) for a branch you pushed, or for this " +
+            "conversation's pull request when branch is omitted. Pass job_id (a [job …] id, " +
+            "GitHub Actions) from the summary to fetch that job's log. Commit statuses from external " +
+            "CI keep logs on their own service: use " +
+            "their summary/url, or reproduce the failure locally in your clone. Only available in " +
+            "GitHub conversations.",
+        parameters: githubChecksSchema,
+        unavailable: `${GITHUB_CHECKS_TOOL} is only available in GitHub conversations.`,
+        run: async (checksFns, args) => {
+            if (args.job_id !== undefined) {
+                const logText = await checksFns.getJobLog(args.job_id);
+                return {
+                    content: [{ type: "text", text: logText || "(empty log)" }],
+                    details: undefined,
+                };
+            }
+            const runs = await checksFns.getChecks(args.branch);
+            if (runs.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "No CI jobs or commit statuses found — CI may not have started yet; try again shortly.",
+                        },
+                    ],
+                    details: undefined,
+                };
+            }
+            const completed = runs.filter((run) => run.status === "completed");
+            const failing = completed.filter((run) => run.conclusion !== null && FAILING_CONCLUSIONS.has(run.conclusion));
+            const summary = `${runs.length} check(s): ${completed.length} completed, ${runs.length - completed.length} running, ${failing.length} failing`;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: [summary, ...runs.map(formatCheckLine)].join("\n"),
+                    },
+                ],
+                details: undefined,
+            };
+        },
+    });
+    return { tool, setGithubChecksFunction: setFn };
+}
+//# 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 \"typebox\";\nimport { defineHostFnTool } from \"../../../harness/tools/host-fn-tool.js\";\nimport type { GithubCheckSummary, GithubChecksFns } from \"../types.js\";\n\nexport const GITHUB_CHECKS_TOOL = \"github_checks\";\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});\n\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  const handle =\n    run.source === \"actions\" ? `[job ${run.id}]` : \"[commit status — 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 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_TOOL,\n    description:\n      \"Read CI status (GitHub Actions jobs and commit statuses) for a branch you pushed, or for this \" +\n      \"conversation's pull request when branch is omitted. Pass job_id (a [job …] id, \" +\n      \"GitHub Actions) from the summary to fetch that job's log. Commit statuses from external \" +\n      \"CI keep logs on their own service: use \" +\n      \"their summary/url, or reproduce the failure locally in your clone. Only available in \" +\n      \"GitHub conversations.\",\n    parameters: githubChecksSchema,\n    unavailable: `${GITHUB_CHECKS_TOOL} is only available in GitHub conversations.`,\n    run: async (checksFns, args) => {\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      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 CI jobs or commit statuses 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

@@ -0,0 +1,18 @@
+import type { AgentTool } from "@earendil-works/pi-agent-core";
+import { Type } from "typebox";
+import type { GithubIssueFn } from "../types.js";
+export declare const GITHUB_ISSUE_TOOL = "github_issue";
+declare const githubIssueSchema: Type.TObject<{
+    action: Type.TUnion<[Type.TLiteral<"add_labels">, Type.TLiteral<"remove_label">, Type.TLiteral<"add_assignees">, Type.TLiteral<"remove_assignees">, Type.TLiteral<"close">, Type.TLiteral<"reopen">]>;
+    number: Type.TOptional<Type.TNumber>;
+    labels: Type.TOptional<Type.TArray<Type.TString>>;
+    label: Type.TOptional<Type.TString>;
+    assignees: Type.TOptional<Type.TArray<Type.TString>>;
+    state_reason: Type.TOptional<Type.TUnion<[Type.TLiteral<"completed">, Type.TLiteral<"not_planned">]>>;
+}>;
+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;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,aAAa,CAAC;AAErE,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAEhD,QAAA,MAAM,iBAAiB;;;;;;;EA+BrB,CAAC;AAEH,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

@@ -0,0 +1,44 @@
+import { Type } from "typebox";
+import { defineHostFnTool } from "../../../harness/tools/host-fn-tool.js";
+export const GITHUB_ISSUE_TOOL = "github_issue";
+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.",
+    })),
+});
+export function createGithubIssueTool() {
+    const { tool, setFn } = defineHostFnTool({
+        name: GITHUB_ISSUE_TOOL,
+        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,
+        unavailable: `${GITHUB_ISSUE_TOOL} 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: setFn };
+}
+//# 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,SAAS,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAG1E,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAEhD,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;AAEH,MAAM,UAAU,qBAAqB;IAInC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,gBAAgB,CAA0C;QAChF,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,6EAA6E;YAC7E,mFAAmF;YACnF,kFAAkF;YAClF,gBAAgB;QAClB,UAAU,EAAE,iBAAiB;QAC7B,WAAW,EAAE,GAAG,iBAAiB,6CAA6C;QAC9E,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 \"typebox\";\nimport { defineHostFnTool } from \"../../../harness/tools/host-fn-tool.js\";\nimport type { GithubIssueFn, GithubIssueRequest } from \"../types.js\";\n\nexport const GITHUB_ISSUE_TOOL = \"github_issue\";\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 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_TOOL,\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_TOOL} 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

@@ -0,0 +1,17 @@
+import type { AgentTool } from "@earendil-works/pi-agent-core";
+import { Type } from "typebox";
+import type { GithubPrRequest, GithubPrResult } from "../types.js";
+export declare const GITHUB_PR_TOOL = "github_pr";
+declare const githubPrSchema: Type.TObject<{
+    branch: Type.TString;
+    title: Type.TString;
+    body: Type.TOptional<Type.TString>;
+    base: Type.TOptional<Type.TString>;
+    draft: Type.TOptional<Type.TBoolean>;
+}>;
+export declare function createGithubPrTool(): {
+    tool: AgentTool<typeof githubPrSchema>;
+    setGithubPrFunction: (fn: ((request: GithubPrRequest) => Promise<GithubPrResult>) | null) => void;
+};
+export {};
+//# 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;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEnE,eAAO,MAAM,cAAc,cAAc,CAAC;AAE1C,QAAA,MAAM,cAAc;;;;;;EAYlB,CAAC;AAIH,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,CA8BA"}

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

@@ -0,0 +1,40 @@
+import { Type } from "typebox";
+import { defineHostFnTool } from "../../../harness/tools/host-fn-tool.js";
+export const GITHUB_PR_TOOL = "github_pr";
+const githubPrSchema = Type.Object({
+    branch: Type.String({
+        description: 'Branch you already pushed from your sandbox (e.g. "pi/fix-42"); it becomes the pull ' +
+            "request head.",
+    }),
+    title: Type.String({ description: "Pull request title." }),
+    body: Type.Optional(Type.String({ description: "Pull request description (Markdown)." })),
+    base: Type.Optional(Type.String({ description: "Target branch; defaults to the repository's default branch." })),
+    draft: Type.Optional(Type.Boolean({ description: "Open as a draft pull request." })),
+});
+export function createGithubPrTool() {
+    const { tool, setFn } = defineHostFnTool({
+        name: GITHUB_PR_TOOL,
+        description: "Open a GitHub pull request (or draft) for a branch you already pushed with git from " +
+            "your sandbox. If the branch already has an open PR, returns that PR instead of " +
+            "opening another. Only available in GitHub issue/PR conversations. You cannot merge — " +
+            "humans review and merge the PR.",
+        parameters: githubPrSchema,
+        unavailable: `${GITHUB_PR_TOOL} is only available in GitHub conversations.`,
+        run: async (prFn, args) => {
+            const result = await prFn(args);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: result.updatedExisting
+                            ? `Branch already has PR #${result.number}: ${result.url}`
+                            : `Opened ${args.draft ? "draft " : ""}PR #${result.number}: ${result.url}`,
+                    },
+                ],
+                details: undefined,
+            };
+        },
+    });
+    return { tool, setGithubPrFunction: setFn };
+}
+//# 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,SAAS,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAG1E,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CAAC;AAE1C,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC;IACjC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;QAClB,WAAW,EACT,sFAAsF;YACtF,eAAe;KAClB,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,MAAM,UAAU,kBAAkB;IAIhC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,gBAAgB,CAGtC;QACA,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,sFAAsF;YACtF,iFAAiF;YACjF,uFAAuF;YACvF,iCAAiC;QACnC,UAAU,EAAE,cAAc;QAC1B,WAAW,EAAE,GAAG,cAAc,6CAA6C;QAC3E,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 \"typebox\";\nimport { defineHostFnTool } from \"../../../harness/tools/host-fn-tool.js\";\nimport type { GithubPrRequest, GithubPrResult } from \"../types.js\";\n\nexport const GITHUB_PR_TOOL = \"github_pr\";\n\nconst githubPrSchema = Type.Object({\n  branch: Type.String({\n    description:\n      'Branch you already pushed from your sandbox (e.g. \"pi/fix-42\"); it becomes the pull ' +\n      \"request head.\",\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\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_TOOL,\n    description:\n      \"Open a GitHub pull request (or draft) for a branch you already pushed with git from \" +\n      \"your sandbox. If the branch already has an open PR, returns that PR instead of \" +\n      \"opening another. Only available in GitHub issue/PR conversations. You cannot merge — \" +\n      \"humans review and merge the PR.\",\n    parameters: githubPrSchema,\n    unavailable: `${GITHUB_PR_TOOL} 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              ? `Branch already has 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

@@ -0,0 +1,17 @@
+import type { AgentTool } from "@earendil-works/pi-agent-core";
+import { Type } from "typebox";
+import type { GithubReadFn } from "../types.js";
+export declare const GITHUB_READ_TOOL = "github_read";
+declare const githubReadSchema: Type.TObject<{
+    action: Type.TUnion<[Type.TLiteral<"pr">, Type.TLiteral<"pr_files">, Type.TLiteral<"pr_reviews">, Type.TLiteral<"issue">, Type.TLiteral<"comments">, Type.TLiteral<"list">]>;
+    number: Type.TOptional<Type.TNumber>;
+    state: Type.TOptional<Type.TString>;
+    labels: Type.TOptional<Type.TString>;
+    creator: Type.TOptional<Type.TString>;
+}>;
+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;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,OAAO,KAAK,EAEV,YAAY,EAGb,MAAM,aAAa,CAAC;AAErB,eAAO,MAAM,gBAAgB,gBAAgB,CAAC;AAE9C,QAAA,MAAM,gBAAgB;;;;;;EA8BpB,CAAC;AA4GH,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

@@ -0,0 +1,134 @@
+import { Type } from "typebox";
+import { defineHostFnTool } from "../../../harness/tools/host-fn-tool.js";
+export const GITHUB_READ_TOOL = "github_read";
+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 formatPr(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");
+}
+function formatReviews({ reviews, threads, }) {
+    const reviewLines = 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}`;
+    });
+    const replyCounts = new Map();
+    for (const { in_reply_to_id: parent } of threads) {
+        replyCounts.set(parent, (replyCounts.get(parent) ?? 0) + 1);
+    }
+    const threadLines = threads
+        .filter((comment) => comment.in_reply_to_id === undefined)
+        .map((comment) => {
+        const location = comment.line !== null ? `${comment.path}:${comment.line}` : comment.path;
+        const count = replyCounts.get(comment.id) ?? 0;
+        const replyNote = count ? ` (${count} repl${count === 1 ? "y" : "ies"})` : "";
+        return `rc-${comment.id} ${location} @${comment.user.login}${replyNote}: ${truncate(comment.body, MAX_REVIEW_BODY_CHARS)}`;
+    });
+    return [
+        reviewLines.length ? `Reviews:\n${reviewLines.join("\n")}` : "No submitted reviews.",
+        threadLines.length
+            ? `Inline threads (reply with github_review_reply):\n${threadLines.join("\n")}`
+            : "No inline review threads.",
+    ].join("\n\n");
+}
+function formatResult(result) {
+    switch (result.kind) {
+        case "pr":
+            return formatPr(result.pr);
+        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":
+            return formatReviews(result);
+        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": {
+            return (result.comments
+                .map((comment) => `@${comment.user.login} (${comment.created_at}): ${truncate(comment.body, MAX_COMMENT_CHARS)}`)
+                .join("\n") || "No comments.");
+        }
+        case "list": {
+            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") || "No matching issues.");
+        }
+    }
+}
+export function createGithubReadTool() {
+    const { tool, setFn } = defineHostFnTool({
+        name: GITHUB_READ_TOOL,
+        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,
+        unavailable: `${GITHUB_READ_TOOL} 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: setFn };
+}
+//# 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":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAQ1E,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAAC;AAE9C,MAAM,gBAAgB,GAAG,IAAI,CAAC,MAAM,CAAC;IACnC,MAAM,EAAE,IAAI,CAAC,KAAK,CAChB;QACE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;QAClB,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;QACxB,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC;QAC1B,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;QACrB,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;QACxB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;KACrB,EACD;QACE,WAAW,EACT,2EAA2E;YAC3E,wEAAwE;YACxE,6EAA6E;YAC7E,0CAA0C;KAC7C,CACF;IACD,MAAM,EAAE,IAAI,CAAC,QAAQ,CACnB,IAAI,CAAC,MAAM,CAAC;QACV,WAAW,EAAE,4DAA4D;KAC1E,CAAC,CACH;IACD,KAAK,EAAE,IAAI,CAAC,QAAQ,CAClB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,gDAAgD,EAAE,CAAC,CAC/E;IACD,MAAM,EAAE,IAAI,CAAC,QAAQ,CACnB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,sDAAsD,EAAE,CAAC,CACrF;IACD,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,oCAAoC,EAAE,CAAC,CAAC;CAC3F,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,IAAI,CAAC;AAC5B,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAC9B,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAElC,SAAS,QAAQ,CAAC,IAAY,EAAE,GAAW;IACzC,OAAO,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7D,CAAC;AAED,SAAS,QAAQ,CAAC,EAAqB;IACrC,MAAM,KAAK,GAAG;QACZ,EAAE,CAAC,KAAK,IAAI,SAAS;QACrB,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;QACzB,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI;QAC3B,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,oBAAoB,EAAE,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,IAAI;KACrE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClB,OAAO;QACL,OAAO,EAAE,CAAC,MAAM,KAAK,EAAE,CAAC,KAAK,IAAI,EAAE,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QAC3D,GAAG,EAAE,CAAC,IAAI,EAAE,GAAG,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,IAAI,GAAG,MAAM,EAAE,CAAC,aAAa,IAAI,GAAG,YAAY,EAAE,CAAC,SAAS,IAAI,GAAG,KAAK,EAAE,CAAC,SAAS,IAAI,GAAG,EAAE;QACrI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI;QAC5C,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,kBAAkB;KACjE;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,SAAS,aAAa,CAAC,EACrB,OAAO,EACP,OAAO,GAC2C;IAClD,MAAM,WAAW,GAAG,OAAO;SACxB,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC;SAC9C,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QACd,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,qBAAqB,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7F,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,GAAG,IAAI,EAAE,CAAC;IACzD,CAAC,CAAC,CAAC;IACL,MAAM,WAAW,GAAG,IAAI,GAAG,EAA8B,CAAC;IAC1D,KAAK,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;QACjD,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9D,CAAC;IACD,MAAM,WAAW,GAAG,OAAO;SACxB,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS,CAAC;SACzD,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QACf,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;QAC1F,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,OAAO,MAAM,OAAO,CAAC,EAAE,IAAI,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,KAAK,GAAG,SAAS,KAAK,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,qBAAqB,CAAC,EAAE,CAAC;IAC7H,CAAC,CAAC,CAAC;IACL,OAAO;QACL,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,uBAAuB;QACpF,WAAW,CAAC,MAAM;YAChB,CAAC,CAAC,qDAAqD,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAC/E,CAAC,CAAC,2BAA2B;KAChC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACjB,CAAC;AAED,SAAS,YAAY,CAAC,MAAwB;IAC5C,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,IAAI;YACP,OAAO,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC7B,KAAK,UAAU,EAAE,CAAC;YAChB,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,mBAAmB,CAAC;YAC1D,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAC5B,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS,EAAE,CAC5F,CAAC;YACF,OAAO,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,mBAAmB,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1E,CAAC;QACD,KAAK,YAAY;YACf,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;QAC/B,KAAK,OAAO,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;YAC3B,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1E,MAAM,SAAS,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7F,OAAO;gBACL,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,IAAI,SAAS,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG;gBACnG,MAAM,CAAC,CAAC,CAAC,WAAW,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI;gBACnC,SAAS,CAAC,CAAC,CAAC,cAAc,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI;gBAC5C,YAAY,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE;gBAC9B,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,WAAW;aAChE;iBACE,MAAM,CAAC,OAAO,CAAC;iBACf,IAAI,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC;QACD,KAAK,UAAU,EAAE,CAAC;YAChB,OAAO,CACL,MAAM,CAAC,QAAQ;iBACZ,GAAG,CACF,CAAC,OAAO,EAAE,EAAE,CACV,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,KAAK,OAAO,CAAC,UAAU,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,iBAAiB,CAAC,EAAE,CACjG;iBACA,IAAI,CAAC,IAAI,CAAC,IAAI,cAAc,CAChC,CAAC;QACJ,CAAC;QACD,KAAK,MAAM,EAAE,CAAC;YACZ,OAAO,CACL,MAAM,CAAC,MAAM;iBACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;gBACb,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC1E,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;gBACjD,OAAO,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,KAAK,IAAI,GAAG,IAAI,IAAI,KAAK,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YAC1G,CAAC,CAAC;iBACD,IAAI,CAAC,IAAI,CAAC,IAAI,qBAAqB,CACvC,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB;IAIlC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,gBAAgB,CAAwC;QAC9E,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,8EAA8E;YAC9E,oFAAoF;YACpF,qFAAqF;YACrF,0EAA0E;QAC5E,UAAU,EAAE,gBAAgB;QAC5B,WAAW,EAAE,GAAG,gBAAgB,6CAA6C;QAC7E,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;YAC1B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAyB,CAAC,CAAC;YACvD,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;gBAChE,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 \"typebox\";\nimport { defineHostFnTool } from \"../../../harness/tools/host-fn-tool.js\";\nimport type {\n  GithubPullRequest,\n  GithubReadFn,\n  GithubReadRequest,\n  GithubReadResult,\n} from \"../types.js\";\n\nexport const GITHUB_READ_TOOL = \"github_read\";\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 formatPr(pr: GithubPullRequest): string {\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\nfunction formatReviews({\n  reviews,\n  threads,\n}: Extract<GithubReadResult, { kind: \"pr_reviews\" }>): string {\n  const reviewLines = reviews\n    .filter((review) => review.state !== \"PENDING\")\n    .map((review) => {\n      const body = review.body?.trim() ? ` — ${truncate(review.body, MAX_REVIEW_BODY_CHARS)}` : \"\";\n      return `@${review.user.login}: ${review.state}${body}`;\n    });\n  const replyCounts = new Map<number | undefined, number>();\n  for (const { in_reply_to_id: parent } of threads) {\n    replyCounts.set(parent, (replyCounts.get(parent) ?? 0) + 1);\n  }\n  const threadLines = threads\n    .filter((comment) => comment.in_reply_to_id === undefined)\n    .map((comment) => {\n      const location = comment.line !== null ? `${comment.path}:${comment.line}` : comment.path;\n      const count = replyCounts.get(comment.id) ?? 0;\n      const replyNote = count ? ` (${count} repl${count === 1 ? \"y\" : \"ies\"})` : \"\";\n      return `rc-${comment.id} ${location} @${comment.user.login}${replyNote}: ${truncate(comment.body, MAX_REVIEW_BODY_CHARS)}`;\n    });\n  return [\n    reviewLines.length ? `Reviews:\\n${reviewLines.join(\"\\n\")}` : \"No submitted reviews.\",\n    threadLines.length\n      ? `Inline threads (reply with github_review_reply):\\n${threadLines.join(\"\\n\")}`\n      : \"No inline review threads.\",\n  ].join(\"\\n\\n\");\n}\n\nfunction formatResult(result: GithubReadResult): string {\n  switch (result.kind) {\n    case \"pr\":\n      return formatPr(result.pr);\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      return formatReviews(result);\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      return (\n        result.comments\n          .map(\n            (comment) =>\n              `@${comment.user.login} (${comment.created_at}): ${truncate(comment.body, MAX_COMMENT_CHARS)}`,\n          )\n          .join(\"\\n\") || \"No comments.\"\n      );\n    }\n    case \"list\": {\n      return (\n        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\") || \"No matching issues.\"\n      );\n    }\n  }\n}\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_TOOL,\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_TOOL} 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

@@ -0,0 +1,14 @@
+import type { AgentTool } from "@earendil-works/pi-agent-core";
+import { Type } from "typebox";
+export declare const GITHUB_REVIEW_REPLY_TOOL = "github_review_reply";
+declare const githubReviewReplySchema: Type.TObject<{
+    comment_id: Type.TNumber;
+    body: Type.TString;
+}>;
+import type { GithubReviewReplyFn } from "../types.js";
+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;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAG/B,eAAO,MAAM,wBAAwB,wBAAwB,CAAC;AAE9D,QAAA,MAAM,uBAAuB;;;EAO3B,CAAC;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,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

@@ -0,0 +1,34 @@
+import { Type } from "typebox";
+import { defineHostFnTool } from "../../../harness/tools/host-fn-tool.js";
+export const GITHUB_REVIEW_REPLY_TOOL = "github_review_reply";
+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)." }),
+});
+export function createGithubReviewReplyTool() {
+    const { tool, setFn } = defineHostFnTool({
+        name: GITHUB_REVIEW_REPLY_TOOL,
+        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,
+        unavailable: `${GITHUB_REVIEW_REPLY_TOOL} is only available in GitHub conversations.`,
+        run: async (replyFn, args) => {
+            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: setFn };
+}
+//# 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,SAAS,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAE1E,MAAM,CAAC,MAAM,wBAAwB,GAAG,qBAAqB,CAAC;AAE9D,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,MAAM,UAAU,2BAA2B;IAIzC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,gBAAgB,CAAsD;QAC5F,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EACT,uEAAuE;YACvE,mFAAmF;YACnF,yFAAyF;QAC3F,UAAU,EAAE,uBAAuB;QACnC,WAAW,EAAE,GAAG,wBAAwB,6CAA6C;QACrF,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 \"typebox\";\nimport { defineHostFnTool } from \"../../../harness/tools/host-fn-tool.js\";\n\nexport const GITHUB_REVIEW_REPLY_TOOL = \"github_review_reply\";\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\nimport type { GithubReviewReplyFn } from \"../types.js\";\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_TOOL,\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_TOOL} 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"]}