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

package/dist/adapters/github/repo.js

@@ -0,0 +1,136 @@
+import { execFile } from "child_process";
+import { promisify } from "util";
+const execFileAsync = promisify(execFile);
+const GIT_TIMEOUT_MS = 120_000;
+/**
+ * Branches the bot may push: `pi/<name>`. Everything else — including the
+ * repo's default branch by construction — is refused, so a driven agent can
+ * only ever produce reviewable branches, never touch mainline directly.
+ */
+export const GITHUB_PUSH_BRANCH_PATTERN = /^pi\/[A-Za-z0-9._][A-Za-z0-9._/-]*$/;
+/**
+ * Pass the ephemeral token as a per-invocation header, never in the remote
+ * URL: nothing credential-shaped may end up in `.git/config`, which lives in
+ * the conversation dir and is bind-mounted into the sandbox.
+ */
+function gitAuthArgs(token) {
+    const basic = Buffer.from(`x-access-token:${token}`).toString("base64");
+    return ["-c", `http.extraheader=Authorization: basic ${basic}`];
+}
+async function git(args, token) {
+    const { stdout } = await execFileAsync("git", [...(token ? gitAuthArgs(token) : []), ...args], {
+        timeout: GIT_TIMEOUT_MS,
+        env: { ...process.env, GIT_TERMINAL_PROMPT: "0" },
+    });
+    return stdout;
+}
+/**
+ * Git itself rejects these ref shapes; the check just keeps an API-supplied
+ * branch name that would parse as a git option (leading dash) or an invalid
+ * ref out of argv entirely instead of surfacing as a git error mid-clone.
+ */
+function isSafeBranchName(name) {
+    return (name.length > 0 && !name.startsWith("-") && !name.includes("..") && !/[\s~^:?*[\\]/.test(name));
+}
+/**
+ * Local checkout name for a PR conversation: the PR's real head branch when
+ * known (same-repo heads only — the caller resolves that), falling back to
+ * the synthetic `pr-<n>` for fork PRs, unresolvable heads, and unsafe names.
+ * Using the real name is what lets the agent update the PR in place: commit
+ * on a `pi/*` head and `github_pr` pushes back to the same branch.
+ */
+function prCheckoutName(prNumber, prHeadBranch) {
+    return prHeadBranch && isSafeBranchName(prHeadBranch) ? prHeadBranch : `pr-${prNumber}`;
+}
+/**
+ * Shallow-clone a repo into a conversation dir and preconfigure the bot's
+ * commit identity. For PR conversations, additionally fetch the PR head and
+ * check it out so the agent starts on the code under review — under its real
+ * branch name when the caller resolved one, which is what lets the agent push
+ * fixes back to the PR itself.
+ */
+export async function cloneRepo(options) {
+    await git(["clone", "--depth", "50", options.url, options.dir], options.token);
+    await git(["-C", options.dir, "config", "user.name", options.botLogin]);
+    await git(["-C", options.dir, "config", "user.email", options.botEmail]);
+    if (options.prNumber !== undefined) {
+        await git(["-C", options.dir, "fetch", "--depth", "50", "origin", `pull/${options.prNumber}/head`], options.token);
+        await git([
+            "-C",
+            options.dir,
+            "checkout",
+            "-B",
+            prCheckoutName(options.prNumber, options.prHeadBranch),
+            "FETCH_HEAD",
+        ]);
+    }
+}
+/**
+ * Refresh a conversation clone from origin. Always fetches; only moves the
+ * checkout when that provably cannot lose agent work: the target branch is
+ * the one checked out, the tree is clean, and it has no commits of its own
+ * (`checkout -B` then handles fast-forward and force-pushed heads alike).
+ * Anything else stays fetch-only — FETCH_HEAD is left for the agent, which
+ * has full credential-less git inside the sandbox, to merge or rebase itself.
+ */
+export async function syncRepo(options) {
+    const { dir, token } = options;
+    let refspec;
+    let target;
+    if (options.branch) {
+        refspec = options.branch;
+        target = options.branch;
+    }
+    else if (options.prNumber !== undefined) {
+        refspec = `pull/${options.prNumber}/head`;
+        target = prCheckoutName(options.prNumber, options.prHeadBranch);
+    }
+    else if (options.defaultBranch) {
+        refspec = options.defaultBranch;
+        target = options.defaultBranch;
+    }
+    else {
+        throw new Error("syncRepo needs a branch, a PR number, or the default branch");
+    }
+    await git(["-C", dir, "fetch", "--depth", "50", "origin", refspec], token);
+    const fetchedSha = (await git(["-C", dir, "rev-parse", "FETCH_HEAD"])).trim();
+    const dirty = (await git(["-C", dir, "status", "--porcelain"])).trim().length > 0;
+    const currentBranch = (await git(["-C", dir, "rev-parse", "--abbrev-ref", "HEAD"])).trim();
+    // Clones made before the head branch name was resolvable sit on the
+    // synthetic pr-<n>; treat that as the same checkout so a clean sync
+    // migrates them to the real name instead of going fetch-only forever.
+    const legacyPrBranch = options.prNumber !== undefined ? `pr-${options.prNumber}` : undefined;
+    const onTarget = currentBranch === target || (legacyPrBranch !== undefined && currentBranch === legacyPrBranch);
+    let localCommits = 0;
+    if (onTarget) {
+        // Commits unique to HEAD split two ways: ones the agent committed here
+        // (the clone's preconfigured bot identity) are its work and must survive;
+        // ones committed by others were force-pushed away upstream and are safe
+        // to drop. Filter by the bot committer so a rebased PR head still syncs.
+        const botEmail = (await git(["-C", dir, "config", "user.email"])).trim();
+        localCommits = Number((await git(["-C", dir, "rev-list", "--count", `--committer=${botEmail}`, "FETCH_HEAD..HEAD"])).trim());
+    }
+    const updatedCheckout = onTarget && !dirty && localCommits === 0;
+    if (updatedCheckout) {
+        await git(["-C", dir, "checkout", "-B", target, "FETCH_HEAD"]);
+    }
+    return { target, fetchedSha, updatedCheckout, dirty, currentBranch, localCommits };
+}
+/**
+ * Push one local branch to origin. Non-force by construction (plain refspec),
+ * and only `pi/*` branches are accepted.
+ */
+export async function pushBranch(options) {
+    const { dir, branch, token } = options;
+    if (!GITHUB_PUSH_BRANCH_PATTERN.test(branch)) {
+        throw new Error(`Refusing to push branch '${branch}': only branches matching pi/<name> may be pushed.`);
+    }
+    try {
+        await git(["-C", dir, "rev-parse", "--verify", "--quiet", `refs/heads/${branch}`]);
+    }
+    catch {
+        throw new Error(`Branch '${branch}' does not exist in the conversation's ./repo clone.`);
+    }
+    await git(["-C", dir, "push", "origin", `refs/heads/${branch}:refs/heads/${branch}`], token);
+}
+//# sourceMappingURL=repo.js.map

package/dist/adapters/github/repo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo.js","sourceRoot":"","sources":["../../../src/adapters/github/repo.ts"],"names":[],"mappings":"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","sourcesContent":["import { execFile } from \"child_process\";\nimport { promisify } from \"util\";\nimport type {\n  CloneRepoOptions,\n  PushBranchOptions,\n  SyncRepoOptions,\n  SyncRepoResult,\n} from \"./types.js\";\n\nconst execFileAsync = promisify(execFile);\n\nconst GIT_TIMEOUT_MS = 120_000;\n\n/**\n * Branches the bot may push: `pi/<name>`. Everything else — including the\n * repo's default branch by construction — is refused, so a driven agent can\n * only ever produce reviewable branches, never touch mainline directly.\n */\nexport const GITHUB_PUSH_BRANCH_PATTERN = /^pi\\/[A-Za-z0-9._][A-Za-z0-9._/-]*$/;\n\n/**\n * Pass the ephemeral token as a per-invocation header, never in the remote\n * URL: nothing credential-shaped may end up in `.git/config`, which lives in\n * the conversation dir and is bind-mounted into the sandbox.\n */\nfunction gitAuthArgs(token: string): string[] {\n  const basic = Buffer.from(`x-access-token:${token}`).toString(\"base64\");\n  return [\"-c\", `http.extraheader=Authorization: basic ${basic}`];\n}\n\nasync function git(args: string[], token?: string): Promise<string> {\n  const { stdout } = await execFileAsync(\"git\", [...(token ? gitAuthArgs(token) : []), ...args], {\n    timeout: GIT_TIMEOUT_MS,\n    env: { ...process.env, GIT_TERMINAL_PROMPT: \"0\" },\n  });\n  return stdout;\n}\n\n/**\n * Git itself rejects these ref shapes; the check just keeps an API-supplied\n * branch name that would parse as a git option (leading dash) or an invalid\n * ref out of argv entirely instead of surfacing as a git error mid-clone.\n */\nfunction isSafeBranchName(name: string): boolean {\n  return (\n    name.length > 0 && !name.startsWith(\"-\") && !name.includes(\"..\") && !/[\\s~^:?*[\\\\]/.test(name)\n  );\n}\n\n/**\n * Local checkout name for a PR conversation: the PR's real head branch when\n * known (same-repo heads only — the caller resolves that), falling back to\n * the synthetic `pr-<n>` for fork PRs, unresolvable heads, and unsafe names.\n * Using the real name is what lets the agent update the PR in place: commit\n * on a `pi/*` head and `github_pr` pushes back to the same branch.\n */\nfunction prCheckoutName(prNumber: number, prHeadBranch?: string): string {\n  return prHeadBranch && isSafeBranchName(prHeadBranch) ? prHeadBranch : `pr-${prNumber}`;\n}\n\n/**\n * Shallow-clone a repo into a conversation dir and preconfigure the bot's\n * commit identity. For PR conversations, additionally fetch the PR head and\n * check it out so the agent starts on the code under review — under its real\n * branch name when the caller resolved one, which is what lets the agent push\n * fixes back to the PR itself.\n */\nexport async function cloneRepo(options: CloneRepoOptions): Promise<void> {\n  await git([\"clone\", \"--depth\", \"50\", options.url, options.dir], options.token);\n  await git([\"-C\", options.dir, \"config\", \"user.name\", options.botLogin]);\n  await git([\"-C\", options.dir, \"config\", \"user.email\", options.botEmail]);\n  if (options.prNumber !== undefined) {\n    await git(\n      [\"-C\", options.dir, \"fetch\", \"--depth\", \"50\", \"origin\", `pull/${options.prNumber}/head`],\n      options.token,\n    );\n    await git([\n      \"-C\",\n      options.dir,\n      \"checkout\",\n      \"-B\",\n      prCheckoutName(options.prNumber, options.prHeadBranch),\n      \"FETCH_HEAD\",\n    ]);\n  }\n}\n\n/**\n * Refresh a conversation clone from origin. Always fetches; only moves the\n * checkout when that provably cannot lose agent work: the target branch is\n * the one checked out, the tree is clean, and it has no commits of its own\n * (`checkout -B` then handles fast-forward and force-pushed heads alike).\n * Anything else stays fetch-only — FETCH_HEAD is left for the agent, which\n * has full credential-less git inside the sandbox, to merge or rebase itself.\n */\nexport async function syncRepo(options: SyncRepoOptions): Promise<SyncRepoResult> {\n  const { dir, token } = options;\n  let refspec: string;\n  let target: string;\n  if (options.branch) {\n    refspec = options.branch;\n    target = options.branch;\n  } else if (options.prNumber !== undefined) {\n    refspec = `pull/${options.prNumber}/head`;\n    target = prCheckoutName(options.prNumber, options.prHeadBranch);\n  } else if (options.defaultBranch) {\n    refspec = options.defaultBranch;\n    target = options.defaultBranch;\n  } else {\n    throw new Error(\"syncRepo needs a branch, a PR number, or the default branch\");\n  }\n\n  await git([\"-C\", dir, \"fetch\", \"--depth\", \"50\", \"origin\", refspec], token);\n  const fetchedSha = (await git([\"-C\", dir, \"rev-parse\", \"FETCH_HEAD\"])).trim();\n  const dirty = (await git([\"-C\", dir, \"status\", \"--porcelain\"])).trim().length > 0;\n  const currentBranch = (await git([\"-C\", dir, \"rev-parse\", \"--abbrev-ref\", \"HEAD\"])).trim();\n  // Clones made before the head branch name was resolvable sit on the\n  // synthetic pr-<n>; treat that as the same checkout so a clean sync\n  // migrates them to the real name instead of going fetch-only forever.\n  const legacyPrBranch = options.prNumber !== undefined ? `pr-${options.prNumber}` : undefined;\n  const onTarget =\n    currentBranch === target || (legacyPrBranch !== undefined && currentBranch === legacyPrBranch);\n  let localCommits = 0;\n  if (onTarget) {\n    // Commits unique to HEAD split two ways: ones the agent committed here\n    // (the clone's preconfigured bot identity) are its work and must survive;\n    // ones committed by others were force-pushed away upstream and are safe\n    // to drop. Filter by the bot committer so a rebased PR head still syncs.\n    const botEmail = (await git([\"-C\", dir, \"config\", \"user.email\"])).trim();\n    localCommits = Number(\n      (\n        await git([\"-C\", dir, \"rev-list\", \"--count\", `--committer=${botEmail}`, \"FETCH_HEAD..HEAD\"])\n      ).trim(),\n    );\n  }\n\n  const updatedCheckout = onTarget && !dirty && localCommits === 0;\n  if (updatedCheckout) {\n    await git([\"-C\", dir, \"checkout\", \"-B\", target, \"FETCH_HEAD\"]);\n  }\n  return { target, fetchedSha, updatedCheckout, dirty, currentBranch, localCommits };\n}\n\n/**\n * Push one local branch to origin. Non-force by construction (plain refspec),\n * and only `pi/*` branches are accepted.\n */\nexport async function pushBranch(options: PushBranchOptions): Promise<void> {\n  const { dir, branch, token } = options;\n  if (!GITHUB_PUSH_BRANCH_PATTERN.test(branch)) {\n    throw new Error(\n      `Refusing to push branch '${branch}': only branches matching pi/<name> may be pushed.`,\n    );\n  }\n  try {\n    await git([\"-C\", dir, \"rev-parse\", \"--verify\", \"--quiet\", `refs/heads/${branch}`]);\n  } catch {\n    throw new Error(`Branch '${branch}' does not exist in the conversation's ./repo clone.`);\n  }\n  await git([\"-C\", dir, \"push\", \"origin\", `refs/heads/${branch}:refs/heads/${branch}`], token);\n}\n"]}

package/dist/adapters/github/tool-pack.d.ts

@@ -0,0 +1,14 @@
+import type { PlatformToolPack } from "../../tools/types.js";
+import type { PlatformGithubOps } from "./types.js";
+/**
+ * GitHub host-side capability pack — one tool per module under `tools/`:
+ * github_pr, github_checks, github_review_reply, github_sync, github_read,
+ * github_issue.
+ *
+ * These tools never run in the sandbox; they call PlatformGithubOps which
+ * mints short-lived installation tokens on the host. The pack is only
+ * constructed when the GitHub bot is configured; bindRun enables the tools
+ * only for github-named conversations so multi-platform processes stay safe.
+ */
+export declare function createGithubToolPack(ops: PlatformGithubOps): PlatformToolPack;
+//# sourceMappingURL=tool-pack.d.ts.map

package/dist/adapters/github/tool-pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-pack.d.ts","sourceRoot":"","sources":["../../../src/adapters/github/tool-pack.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,iBAAiB,GAAG,gBAAgB,CA0C7E"}

package/dist/adapters/github/tool-pack.js

@@ -0,0 +1,56 @@
+import { createGithubChecksTool } from "./tools/checks.js";
+import { createGithubPrTool } from "./tools/pr.js";
+import { createGithubIssueTool } from "./tools/issue.js";
+import { createGithubReadTool } from "./tools/read.js";
+import { createGithubReviewReplyTool } from "./tools/review-reply.js";
+import { createGithubSyncTool } from "./tools/sync.js";
+/**
+ * GitHub host-side capability pack — one tool per module under `tools/`:
+ * github_pr, github_checks, github_review_reply, github_sync, github_read,
+ * github_issue.
+ *
+ * These tools never run in the sandbox; they call PlatformGithubOps which
+ * mints short-lived installation tokens on the host. The pack is only
+ * constructed when the GitHub bot is configured; bindRun enables the tools
+ * only for github-named conversations so multi-platform processes stay safe.
+ */
+export function createGithubToolPack(ops) {
+    const { tool: githubPrTool, setGithubPrFunction } = createGithubPrTool();
+    const { tool: githubChecksTool, setGithubChecksFunction } = createGithubChecksTool();
+    const { tool: githubReviewReplyTool, setGithubReviewReplyFunction } = createGithubReviewReplyTool();
+    const { tool: githubSyncTool, setGithubSyncFunction } = createGithubSyncTool();
+    const { tool: githubReadTool, setGithubReadFunction } = createGithubReadTool();
+    const { tool: githubIssueTool, setGithubIssueFunction } = createGithubIssueTool();
+    return {
+        tools: [
+            githubPrTool,
+            githubChecksTool,
+            githubReviewReplyTool,
+            githubSyncTool,
+            githubReadTool,
+            githubIssueTool,
+        ],
+        bindRun({ conversationId, platformName }) {
+            if (platformName !== "github") {
+                setGithubPrFunction(null);
+                setGithubChecksFunction(null);
+                setGithubReviewReplyFunction(null);
+                setGithubSyncFunction(null);
+                setGithubReadFunction(null);
+                setGithubIssueFunction(null);
+                return;
+            }
+            setGithubPrFunction((request) => ops.pushAndCreatePr(conversationId, request));
+            setGithubChecksFunction({
+                getChecks: (branch) => ops.getChecks(conversationId, branch),
+                getJobLog: (jobId) => ops.getJobLog(conversationId, jobId),
+                getBuildLog: (buildId) => ops.getBuildLog(conversationId, buildId),
+            });
+            setGithubReviewReplyFunction((commentId, body) => ops.replyToReviewThread(conversationId, commentId, body));
+            setGithubSyncFunction((branch) => ops.syncRepo(conversationId, branch));
+            setGithubReadFunction((request) => ops.readGithub(conversationId, request));
+            setGithubIssueFunction((request) => ops.manageIssue(conversationId, request));
+        },
+    };
+}
+//# sourceMappingURL=tool-pack.js.map

package/dist/adapters/github/tool-pack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-pack.js","sourceRoot":"","sources":["../../../src/adapters/github/tool-pack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAIvD;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAsB;IACzD,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,mBAAmB,EAAE,GAAG,kBAAkB,EAAE,CAAC;IACzE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,GAAG,sBAAsB,EAAE,CAAC;IACrF,MAAM,EAAE,IAAI,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,GACjE,2BAA2B,EAAE,CAAC;IAChC,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,qBAAqB,EAAE,GAAG,oBAAoB,EAAE,CAAC;IAC/E,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,qBAAqB,EAAE,GAAG,oBAAoB,EAAE,CAAC;IAC/E,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,sBAAsB,EAAE,GAAG,qBAAqB,EAAE,CAAC;IAElF,OAAO;QACL,KAAK,EAAE;YACL,YAAY;YACZ,gBAAgB;YAChB,qBAAqB;YACrB,cAAc;YACd,cAAc;YACd,eAAe;SAChB;QACD,OAAO,CAAC,EAAE,cAAc,EAAE,YAAY,EAAE;YACtC,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;gBAC9B,mBAAmB,CAAC,IAAI,CAAC,CAAC;gBAC1B,uBAAuB,CAAC,IAAI,CAAC,CAAC;gBAC9B,4BAA4B,CAAC,IAAI,CAAC,CAAC;gBACnC,qBAAqB,CAAC,IAAI,CAAC,CAAC;gBAC5B,qBAAqB,CAAC,IAAI,CAAC,CAAC;gBAC5B,sBAAsB,CAAC,IAAI,CAAC,CAAC;gBAC7B,OAAO;YACT,CAAC;YACD,mBAAmB,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,eAAe,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC;YAC/E,uBAAuB,CAAC;gBACtB,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,MAAM,CAAC;gBAC5D,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,KAAK,CAAC;gBAC1D,WAAW,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,cAAc,EAAE,OAAO,CAAC;aACnE,CAAC,CAAC;YACH,4BAA4B,CAAC,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,CAC/C,GAAG,CAAC,mBAAmB,CAAC,cAAc,EAAE,SAAS,EAAE,IAAI,CAAC,CACzD,CAAC;YACF,qBAAqB,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;YACxE,qBAAqB,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC;YAC5E,sBAAsB,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC;QAChF,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import { createGithubChecksTool } from \"./tools/checks.js\";\nimport { createGithubPrTool } from \"./tools/pr.js\";\nimport { createGithubIssueTool } from \"./tools/issue.js\";\nimport { createGithubReadTool } from \"./tools/read.js\";\nimport { createGithubReviewReplyTool } from \"./tools/review-reply.js\";\nimport { createGithubSyncTool } from \"./tools/sync.js\";\nimport type { PlatformToolPack } from \"../../tools/types.js\";\nimport type { PlatformGithubOps } from \"./types.js\";\n\n/**\n * GitHub host-side capability pack — one tool per module under `tools/`:\n * github_pr, github_checks, github_review_reply, github_sync, github_read,\n * github_issue.\n *\n * These tools never run in the sandbox; they call PlatformGithubOps which\n * mints short-lived installation tokens on the host. The pack is only\n * constructed when the GitHub bot is configured; bindRun enables the tools\n * only for github-named conversations so multi-platform processes stay safe.\n */\nexport function createGithubToolPack(ops: PlatformGithubOps): PlatformToolPack {\n  const { tool: githubPrTool, setGithubPrFunction } = createGithubPrTool();\n  const { tool: githubChecksTool, setGithubChecksFunction } = createGithubChecksTool();\n  const { tool: githubReviewReplyTool, setGithubReviewReplyFunction } =\n    createGithubReviewReplyTool();\n  const { tool: githubSyncTool, setGithubSyncFunction } = createGithubSyncTool();\n  const { tool: githubReadTool, setGithubReadFunction } = createGithubReadTool();\n  const { tool: githubIssueTool, setGithubIssueFunction } = createGithubIssueTool();\n\n  return {\n    tools: [\n      githubPrTool,\n      githubChecksTool,\n      githubReviewReplyTool,\n      githubSyncTool,\n      githubReadTool,\n      githubIssueTool,\n    ],\n    bindRun({ conversationId, platformName }) {\n      if (platformName !== \"github\") {\n        setGithubPrFunction(null);\n        setGithubChecksFunction(null);\n        setGithubReviewReplyFunction(null);\n        setGithubSyncFunction(null);\n        setGithubReadFunction(null);\n        setGithubIssueFunction(null);\n        return;\n      }\n      setGithubPrFunction((request) => ops.pushAndCreatePr(conversationId, request));\n      setGithubChecksFunction({\n        getChecks: (branch) => ops.getChecks(conversationId, branch),\n        getJobLog: (jobId) => ops.getJobLog(conversationId, jobId),\n        getBuildLog: (buildId) => ops.getBuildLog(conversationId, buildId),\n      });\n      setGithubReviewReplyFunction((commentId, body) =>\n        ops.replyToReviewThread(conversationId, commentId, body),\n      );\n      setGithubSyncFunction((branch) => ops.syncRepo(conversationId, branch));\n      setGithubReadFunction((request) => ops.readGithub(conversationId, request));\n      setGithubIssueFunction((request) => ops.manageIssue(conversationId, request));\n    },\n  };\n}\n"]}

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

@@ -0,0 +1,24 @@
+import type { AgentTool } from "@earendil-works/pi-agent-core";
+import type { GithubCheckSummary } from "../types.js";
+declare const githubChecksSchema: import("@sinclair/typebox").TObject<{
+    branch: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    job_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    build_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export interface GithubChecksFns {
+    getChecks: (branch?: string) => Promise<GithubCheckSummary[]>;
+    getJobLog: (jobId: number) => Promise<string>;
+    getBuildLog: (buildId: string) => Promise<string>;
+}
+/**
+ * The `github_checks` tool reads CI check runs (GitHub Actions and other
+ * check-reporting apps) for a branch or the conversation's PR head, and can
+ * fetch one job's log tail so the agent can diagnose failures and iterate.
+ * Read-only, host-side; wired per run and only for GitHub conversations.
+ */
+export declare function createGithubChecksTool(): {
+    tool: AgentTool<typeof githubChecksSchema>;
+    setGithubChecksFunction: (fns: GithubChecksFns | null) => void;
+};
+export {};
+//# sourceMappingURL=checks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checks.d.ts","sourceRoot":"","sources":["../../../../src/adapters/github/tools/checks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,QAAA,MAAM,kBAAkB;;;;EAsBtB,CAAC;AA+BH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAC9D,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9C,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACnD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI;IACxC,IAAI,EAAE,SAAS,CAAC,OAAO,kBAAkB,CAAC,CAAC;IAC3C,uBAAuB,EAAE,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI,KAAK,IAAI,CAAC;CAChE,CAgFA"}

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

@@ -0,0 +1,116 @@
+import { Type } from "@sinclair/typebox";
+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.",
+    })),
+    build_id: Type.Optional(Type.String({
+        description: "A [build …] uuid from the summary output (Cloud Build checks) — returns that " +
+            "build's log (tail) instead of the summary. Mutually exclusive with job_id.",
+    })),
+});
+/** Conclusions that mean "this check did not pass and needs attention". */
+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"
+                ? "✓"
+                : "−";
+    // GitHub Actions logs fetch via job_id; Cloud Build logs via build_id when
+    // the host has GCP credentials. Other external CI keeps logs on its own
+    // service, so advertising an id there would only invite doomed fetches.
+    const handle = run.appSlug === "github-actions"
+        ? `[job ${run.id}]`
+        : run.buildLogAvailable && run.externalId
+            ? `[build ${run.externalId}]`
+            : `[external CI: ${run.appSlug ?? "unknown"} — logs not on GitHub]`;
+    const line = `${marker} ${run.name}: ${state} ${handle}${run.url ? ` (${run.url})` : ""}`;
+    const failed = run.conclusion !== null && FAILING_CONCLUSIONS.has(run.conclusion);
+    return failed && run.outputSummary
+        ? `${line}\n  ↳ ${run.outputSummary.replace(/\s*\n\s*/g, " ")}`
+        : line;
+}
+/**
+ * The `github_checks` tool reads CI check runs (GitHub Actions and other
+ * check-reporting apps) for a branch or the conversation's PR head, and can
+ * fetch one job's log tail so the agent can diagnose failures and iterate.
+ * Read-only, host-side; wired per run and only for GitHub conversations.
+ */
+export function createGithubChecksTool() {
+    let checksFns = null;
+    const tool = {
+        name: "github_checks",
+        label: "github_checks",
+        description: "Read CI status (check runs) for a branch you pushed with github_pr, or for this " +
+            "conversation's pull request when branch is omitted. Pass job_id (a [job …] id, " +
+            "GitHub Actions) or build_id (a [build …] uuid, Cloud Build) from the summary to " +
+            "fetch that run's log. Other external CI checks keep logs on their own service: use " +
+            "their summary/url, or reproduce the failure locally in ./repo. Only available in " +
+            "GitHub conversations.",
+        parameters: githubChecksSchema,
+        execute: async (_toolCallId, args, signal) => {
+            if (!checksFns) {
+                throw new Error("github_checks is only available in GitHub conversations.");
+            }
+            if (signal?.aborted) {
+                throw new Error("Operation aborted");
+            }
+            if (args.job_id !== undefined && args.build_id !== undefined) {
+                throw new Error("Pass either job_id or build_id, not both.");
+            }
+            if (args.job_id !== undefined) {
+                const logText = await checksFns.getJobLog(args.job_id);
+                return {
+                    content: [{ type: "text", text: logText || "(empty log)" }],
+                    details: undefined,
+                };
+            }
+            if (args.build_id !== undefined) {
+                const logText = await checksFns.getBuildLog(args.build_id);
+                return {
+                    content: [{ type: "text", text: logText || "(empty log)" }],
+                    details: undefined,
+                };
+            }
+            const runs = await checksFns.getChecks(args.branch);
+            if (runs.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "No check runs 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: (fns) => {
+            checksFns = fns;
+        },
+    };
+}
+//# sourceMappingURL=checks.js.map

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

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

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

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

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

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

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

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

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

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

package/dist/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;AAE/D,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEnE,QAAA,MAAM,cAAc;;;;;;EAalB,CAAC;AAIH;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI;IACpC,IAAI,EAAE,SAAS,CAAC,OAAO,cAAc,CAAC,CAAC;IACvC,mBAAmB,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC,GAAG,IAAI,KAAK,IAAI,CAAC;CACnG,CAyCA"}

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

@@ -0,0 +1,59 @@
+import { Type } from "@sinclair/typebox";
+const githubPrSchema = Type.Object({
+    branch: Type.String({
+        description: 'Local branch inside ./repo to push. Must be named pi/<something> (e.g. "pi/fix-42"); ' +
+            "the default branch is never pushable. 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() {
+    let prFn = null;
+    const tool = {
+        name: "github_pr",
+        label: "github_pr",
+        description: "Push a pi/<name> branch you committed inside ./repo and open a GitHub pull request " +
+            "(or draft) for it. Pushing a branch that already has an open PR — including this " +
+            "conversation's own PR head — updates that PR instead of opening a new one. Only " +
+            "available in GitHub issue/PR conversations. You cannot push to the default branch " +
+            "and you cannot merge — humans review and merge the PR.",
+        parameters: githubPrSchema,
+        execute: async (_toolCallId, args, signal) => {
+            if (!prFn) {
+                throw new Error("github_pr is only available in GitHub conversations.");
+            }
+            if (signal?.aborted) {
+                throw new Error("Operation aborted");
+            }
+            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: (fn) => {
+            prFn = fn;
+        },
+    };
+}
+//# sourceMappingURL=pr.js.map

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

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