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

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"}

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

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

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

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