@geminixiang/mikan 1.0.0-beta.7 → 1.0.0-beta.71

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

@@ -0,0 +1,21 @@
+import type { AgentTool } from "@earendil-works/pi-agent-core";
+import type { GithubIssueFn } from "../types.js";
+export type { GithubIssueFn } 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">]>>;
+}>;
+/**
+ * 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;
+};
+//# 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;AAG/D,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,aAAa,CAAC;AAErE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,QAAA,MAAM,iBAAiB;;;;;;;EA+BrB,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI;IACvC,IAAI,EAAE,SAAS,CAAC,OAAO,iBAAiB,CAAC,CAAC;IAC1C,sBAAsB,EAAE,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI,KAAK,IAAI,CAAC;CAC5D,CAoBA"}

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

@@ -0,0 +1,48 @@
+import { Type } from "@sinclair/typebox";
+import { defineHostFnTool } from "../../../harness/tools/host-fn-tool.js";
+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() {
+    const { tool, setFn } = defineHostFnTool({
+        name: "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,
+        unavailable: "github_issue is only available in GitHub conversations.",
+        run: async (issueFn, args) => {
+            const report = await issueFn(args);
+            return {
+                content: [{ type: "text", text: report }],
+                details: undefined,
+            };
+        },
+    });
+    return { tool, setGithubIssueFunction: 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,mBAAmB,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAK1E,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;;;;GAIG;AACH,MAAM,UAAU,qBAAqB;IAInC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,gBAAgB,CAA0C;QAChF,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,6EAA6E;YAC7E,mFAAmF;YACnF,kFAAkF;YAClF,gBAAgB;QAClB,UAAU,EAAE,iBAAiB;QAC7B,WAAW,EAAE,yDAAyD;QACtE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;YAC3B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAA0B,CAAC,CAAC;YACzD,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;gBAClD,OAAO,EAAE,SAAS;aACnB,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,EAAE,IAAI,EAAE,sBAAsB,EAAE,KAAK,EAAE,CAAC;AACjD,CAAC","sourcesContent":["import type { AgentTool } from \"@earendil-works/pi-agent-core\";\nimport { Type } from \"@sinclair/typebox\";\nimport { defineHostFnTool } from \"../../../harness/tools/host-fn-tool.js\";\nimport type { GithubIssueFn, GithubIssueRequest } from \"../types.js\";\n\nexport type { GithubIssueFn } 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\n/**\n * The `github_issue` tool manages labels, assignees, and open/closed state of\n * issues in the conversation's repo (any issue number — triage). Host-side as\n * the App; wired per run and only for GitHub conversations.\n */\nexport function createGithubIssueTool(): {\n  tool: AgentTool<typeof githubIssueSchema>;\n  setGithubIssueFunction: (fn: GithubIssueFn | null) => void;\n} {\n  const { tool, setFn } = defineHostFnTool<GithubIssueFn, typeof githubIssueSchema>({\n    name: \"github_issue\",\n    description:\n      \"Manage issues in this repo: add/remove labels, add/remove assignees, close \" +\n      \"(optionally with state_reason) or reopen. number defaults to this conversation's \" +\n      \"issue; any issue number in this repo works for triage. Only available in GitHub \" +\n      \"conversations.\",\n    parameters: githubIssueSchema,\n    unavailable: \"github_issue is only available in GitHub conversations.\",\n    run: async (issueFn, args) => {\n      const report = await issueFn(args as GithubIssueRequest);\n      return {\n        content: [{ type: \"text\" as const, text: report }],\n        details: undefined,\n      };\n    },\n  });\n\n  return { tool, setGithubIssueFunction: setFn };\n}\n"]}

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

@@ -0,0 +1,22 @@
+import type { AgentTool } from "@earendil-works/pi-agent-core";
+import type { GithubPrRequest, GithubPrResult } from "../types.js";
+declare const githubPrSchema: import("@sinclair/typebox").TObject<{
+    branch: import("@sinclair/typebox").TString;
+    title: import("@sinclair/typebox").TString;
+    body: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    base: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    draft: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+}>;
+/**
+ * The `github_pr` tool pushes a branch the agent prepared in the
+ * conversation's ./repo clone and opens a pull request as the GitHub App.
+ * The push and API calls run host-side with an ephemeral repo-scoped token;
+ * the sandbox never holds credentials. Wired per run via the setter, and only
+ * for GitHub conversations.
+ */
+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;AAG/D,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEnE,QAAA,MAAM,cAAc;;;;;;EAalB,CAAC;AAIH;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI;IACpC,IAAI,EAAE,SAAS,CAAC,OAAO,cAAc,CAAC,CAAC;IACvC,mBAAmB,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC,GAAG,IAAI,KAAK,IAAI,CAAC;CACnG,CA+BA"}

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

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

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

@@ -0,0 +1,21 @@
+import type { AgentTool } from "@earendil-works/pi-agent-core";
+import type { GithubReadFn } from "../types.js";
+export type { GithubReadFn } 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>;
+}>;
+/**
+ * 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;
+};
+//# 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;AAG/D,OAAO,KAAK,EAEV,YAAY,EAGb,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,QAAA,MAAM,gBAAgB;;;;;;EA8BpB,CAAC;AA8GH;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI;IACtC,IAAI,EAAE,SAAS,CAAC,OAAO,gBAAgB,CAAC,CAAC;IACzC,qBAAqB,EAAE,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,KAAK,IAAI,CAAC;CAC1D,CAoBA"}

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

@@ -0,0 +1,141 @@
+import { Type } from "@sinclair/typebox";
+import { defineHostFnTool } from "../../../harness/tools/host-fn-tool.js";
+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}`;
+    });
+    // Count once rather than rescanning every comment for each root. Orphan replies
+    // still count only toward their own parent; they never become root threads.
+    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.");
+        }
+    }
+}
+/**
+ * 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() {
+    const { tool, setFn } = defineHostFnTool({
+        name: "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,
+        unavailable: "github_read is only available in GitHub conversations.",
+        run: async (readFn, args) => {
+            const result = await readFn(args);
+            return {
+                content: [{ type: "text", text: formatResult(result) }],
+                details: undefined,
+            };
+        },
+    });
+    return { tool, setGithubReadFunction: 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":"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","sourcesContent":["import type { AgentTool } from \"@earendil-works/pi-agent-core\";\nimport { Type } from \"@sinclair/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 type { GithubReadFn } 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 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  // Count once rather than rescanning every comment for each root. Orphan replies\n  // still count only toward their own parent; they never become root threads.\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\n/**\n * The `github_read` tool reads what the ./repo clone cannot show: PR diff\n * stats and changed files, review state with open inline threads, and other\n * issues/PRs in this repo for triage. Read-only, host-side, same-repo by\n * construction; wired per run and only for GitHub conversations.\n */\nexport function createGithubReadTool(): {\n  tool: AgentTool<typeof githubReadSchema>;\n  setGithubReadFunction: (fn: GithubReadFn | null) => void;\n} {\n  const { tool, setFn } = defineHostFnTool<GithubReadFn, typeof githubReadSchema>({\n    name: \"github_read\",\n    description:\n      \"Read GitHub metadata for this repo: PR state/diff stats (pr), changed files \" +\n      \"(pr_files), reviews and open inline threads (pr_reviews), issue metadata (issue), \" +\n      \"recent comments (comments), or a filtered issue/PR listing (list). number defaults \" +\n      \"to this conversation's issue/PR. Only available in GitHub conversations.\",\n    parameters: githubReadSchema,\n    unavailable: \"github_read is only available in GitHub conversations.\",\n    run: async (readFn, args) => {\n      const result = await readFn(args as GithubReadRequest);\n      return {\n        content: [{ type: \"text\" as const, text: formatResult(result) }],\n        details: undefined,\n      };\n    },\n  });\n\n  return { tool, setGithubReadFunction: setFn };\n}\n"]}

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

@@ -0,0 +1,17 @@
+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;
+}>;
+import type { GithubReviewReplyFn } from "../types.js";
+export type { GithubReviewReplyFn } from "../types.js";
+/**
+ * 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;
+};
+//# 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;AAI/D,QAAA,MAAM,uBAAuB;;;EAO3B,CAAC;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD;;;;GAIG;AACH,wBAAgB,2BAA2B,IAAI;IAC7C,IAAI,EAAE,SAAS,CAAC,OAAO,uBAAuB,CAAC,CAAC;IAChD,4BAA4B,EAAE,CAAC,EAAE,EAAE,mBAAmB,GAAG,IAAI,KAAK,IAAI,CAAC;CACxE,CAwBA"}

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

@@ -0,0 +1,38 @@
+import { Type } from "@sinclair/typebox";
+import { defineHostFnTool } from "../../../harness/tools/host-fn-tool.js";
+const githubReviewReplySchema = Type.Object({
+    comment_id: Type.Number({
+        description: "Numeric id from an [PR review comment rc-<id> …] message in this conversation " +
+            "(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() {
+    const { tool, setFn } = defineHostFnTool({
+        name: "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,
+        unavailable: "github_review_reply is only available in GitHub conversations.",
+        run: async (replyFn, args) => {
+            const result = await replyFn(args.comment_id, args.body);
+            return {
+                content: [
+                    {
+                        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,mBAAmB,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAE1E,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;AAMH;;;;GAIG;AACH,MAAM,UAAU,2BAA2B;IAIzC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,gBAAgB,CAAsD;QAC5F,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EACT,uEAAuE;YACvE,mFAAmF;YACnF,yFAAyF;QAC3F,UAAU,EAAE,uBAAuB;QACnC,WAAW,EAAE,gEAAgE;QAC7E,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;YAC3B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACzD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,+BAA+B,IAAI,CAAC,UAAU,KAAK,MAAM,CAAC,GAAG,EAAE;qBACtE;iBACF;gBACD,OAAO,EAAE,SAAS;aACnB,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,EAAE,IAAI,EAAE,4BAA4B,EAAE,KAAK,EAAE,CAAC;AACvD,CAAC","sourcesContent":["import type { AgentTool } from \"@earendil-works/pi-agent-core\";\nimport { Type } from \"@sinclair/typebox\";\nimport { defineHostFnTool } from \"../../../harness/tools/host-fn-tool.js\";\n\nconst githubReviewReplySchema = Type.Object({\n  comment_id: Type.Number({\n    description:\n      \"Numeric id from an [PR review comment rc-<id> …] message in this conversation \" +\n      \"(e.g. 8001 for rc-8001). The reply lands inside that comment's thread.\",\n  }),\n  body: Type.String({ description: \"Reply text (Markdown).\" }),\n});\n\nimport type { GithubReviewReplyFn } from \"../types.js\";\n\nexport type { GithubReviewReplyFn } from \"../types.js\";\n\n/**\n * The `github_review_reply` tool answers inside one inline PR review thread\n * (the responder's normal replies post as plain PR comments instead). Runs\n * host-side as the App; wired per run and only for GitHub conversations.\n */\nexport function createGithubReviewReplyTool(): {\n  tool: AgentTool<typeof githubReviewReplySchema>;\n  setGithubReviewReplyFunction: (fn: GithubReviewReplyFn | null) => void;\n} {\n  const { tool, setFn } = defineHostFnTool<GithubReviewReplyFn, typeof githubReviewReplySchema>({\n    name: \"github_review_reply\",\n    description:\n      \"Reply inside a specific PR review thread. Use the numeric id from an \" +\n      \"[PR review comment rc-<id> …] message as comment_id; a plain response would post \" +\n      \"as a normal PR comment instead of in-thread. Only available in GitHub PR conversations.\",\n    parameters: githubReviewReplySchema,\n    unavailable: \"github_review_reply is only available in GitHub conversations.\",\n    run: async (replyFn, args) => {\n      const result = await replyFn(args.comment_id, args.body);\n      return {\n        content: [\n          {\n            type: \"text\" as const,\n            text: `Replied in review thread rc-${args.comment_id}: ${result.url}`,\n          },\n        ],\n        details: undefined,\n      };\n    },\n  });\n\n  return { tool, setGithubReviewReplyFunction: setFn };\n}\n"]}

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

@@ -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>;
+}>;
+import type { GithubSyncFn } from "../types.js";
+export type { GithubSyncFn } from "../types.js";
+/**
+ * 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;
+};
+//# 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;AAI/D,QAAA,MAAM,gBAAgB;;EAQpB,CAAC;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI;IACtC,IAAI,EAAE,SAAS,CAAC,OAAO,gBAAgB,CAAC,CAAC;IACzC,qBAAqB,EAAE,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,KAAK,IAAI,CAAC;CAC1D,CAoBA"}

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

@@ -0,0 +1,34 @@
+import { Type } from "@sinclair/typebox";
+import { defineHostFnTool } from "../../../harness/tools/host-fn-tool.js";
+const githubSyncSchema = Type.Object({
+    branch: Type.Optional(Type.String({
+        description: "Remote branch to fetch. Omit to fetch this PR's latest head (or the default " +
+            "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() {
+    const { tool, setFn } = defineHostFnTool({
+        name: "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,
+        unavailable: "github_sync is only available in GitHub conversations.",
+        run: async (syncFn, args) => {
+            const report = await syncFn(args.branch);
+            return {
+                content: [{ type: "text", text: report }],
+                details: undefined,
+            };
+        },
+    });
+    return { tool, setGithubSyncFunction: setFn };
+}
+//# 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;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAE1E,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;AAMH;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB;IAIlC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,gBAAgB,CAAwC;QAC9E,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,mFAAmF;YACnF,qFAAqF;YACrF,sFAAsF;YACtF,yCAAyC;QAC3C,UAAU,EAAE,gBAAgB;QAC5B,WAAW,EAAE,wDAAwD;QACrE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;YAC1B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACzC,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;gBAClD,OAAO,EAAE,SAAS;aACnB,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,EAAE,IAAI,EAAE,qBAAqB,EAAE,KAAK,EAAE,CAAC;AAChD,CAAC","sourcesContent":["import type { AgentTool } from \"@earendil-works/pi-agent-core\";\nimport { Type } from \"@sinclair/typebox\";\nimport { defineHostFnTool } from \"../../../harness/tools/host-fn-tool.js\";\n\nconst githubSyncSchema = Type.Object({\n  branch: Type.Optional(\n    Type.String({\n      description:\n        \"Remote branch to fetch. Omit to fetch this PR's latest head (or the default \" +\n        \"branch in a plain-issue conversation).\",\n    }),\n  ),\n});\n\nimport type { GithubSyncFn } from \"../types.js\";\n\nexport type { GithubSyncFn } from \"../types.js\";\n\n/**\n * The `github_sync` tool refreshes the conversation's ./repo clone — a\n * first-contact snapshot the sandbox cannot update itself (no credentials).\n * Host-side fetch with an ephemeral read token; it reports instead of moving\n * the checkout whenever that could lose the agent's local work.\n */\nexport function createGithubSyncTool(): {\n  tool: AgentTool<typeof githubSyncSchema>;\n  setGithubSyncFunction: (fn: GithubSyncFn | null) => void;\n} {\n  const { tool, setFn } = defineHostFnTool<GithubSyncFn, typeof githubSyncSchema>({\n    name: \"github_sync\",\n    description:\n      \"Update ./repo from GitHub: fetches this PR's latest head (or the default branch, \" +\n      \"or a named branch) and fast-forwards the checkout when that cannot lose your work; \" +\n      \"otherwise it fetches to FETCH_HEAD and reports so you can merge or rebase yourself. \" +\n      \"Only available in GitHub conversations.\",\n    parameters: githubSyncSchema,\n    unavailable: \"github_sync is only available in GitHub conversations.\",\n    run: async (syncFn, args) => {\n      const report = await syncFn(args.branch);\n      return {\n        content: [{ type: \"text\" as const, text: report }],\n        details: undefined,\n      };\n    },\n  });\n\n  return { tool, setGithubSyncFunction: setFn };\n}\n"]}