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

package/dist/adapters/github/ids.js

@@ -0,0 +1,53 @@
+/**
+ * Conversation id for one issue/PR: `GH_<owner>_<repo>_<number>`.
+ *
+ * DESIGN.md originally proposed `gh:<owner>/<repo>#<number>`, but conversation
+ * ids are used verbatim as a single path segment (LAYOUT.md § Casing) and the
+ * conversation dir is bind-mounted with docker's `-v source:target` syntax in
+ * image mode — so the id can contain neither `/` nor `:`. `_` is the
+ * separator because it is the only inert character that also parses back
+ * unambiguously under GitHub's name grammar: owners allow `-` (so `-` would
+ * make the owner/repo boundary ambiguous) but never `_`, repos may contain
+ * `_` but the trailing number is pure digits — so the first `_` and the last
+ * `_` before the digits are always the real boundaries.
+ *
+ * Owner and repo are lowercased: GitHub names are case-insensitive (and this
+ * id has two spelling sources — the GITHUB_REPOS env var and API payloads),
+ * so per LAYOUT.md § Casing this is a mikan-derived slug, not a verbatim
+ * platform id, and derived slugs are lowercased to keep one issue from
+ * mapping to two conversation dirs on case-sensitive filesystems.
+ */
+export function buildGithubConversationId(ref) {
+    return `GH_${ref.owner.toLowerCase()}_${ref.repo.toLowerCase()}_${ref.number}`;
+}
+const CONVERSATION_ID_PATTERN = /^GH_([A-Za-z0-9-]+)_(.+)_(\d+)$/;
+export function parseGithubConversationId(conversationId) {
+    // The greedy repo group splits at the last `_` followed by digits-to-end,
+    // which is always the number boundary (repos may contain `_` themselves).
+    const match = CONVERSATION_ID_PATTERN.exec(conversationId);
+    if (!match) {
+        throw new Error(`Not a GitHub conversation id: ${conversationId}`);
+    }
+    return {
+        owner: match[1].toLowerCase(),
+        repo: match[2].toLowerCase(),
+        number: Number(match[3]),
+    };
+}
+/** Message ts used for the issue/PR body itself (comments use their comment id). */
+export const GITHUB_ISSUE_BODY_TS = "issue";
+/**
+ * Message ts for an inline PR review comment: `rc-<id>`. Review-comment ids
+ * live in a different id space than issue-comment ids, and several endpoints
+ * (reactions, edits) differ by family — the prefix makes routing a review id
+ * to an issue-comment endpoint structurally impossible.
+ */
+export function githubReviewCommentTs(commentId) {
+    return `rc-${commentId}`;
+}
+/** The review-comment id inside an `rc-<id>` ts, or null for other ts kinds. */
+export function parseReviewCommentTs(ts) {
+    const match = /^rc-(\d+)$/.exec(ts);
+    return match ? Number(match[1]) : null;
+}
+//# sourceMappingURL=ids.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../../src/adapters/github/ids.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,yBAAyB,CAAC,GAA0B;IAClE,OAAO,MAAM,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;AACjF,CAAC;AAED,MAAM,uBAAuB,GAAG,iCAAiC,CAAC;AAElE,MAAM,UAAU,yBAAyB,CAAC,cAAsB;IAC9D,0EAA0E;IAC1E,0EAA0E;IAC1E,MAAM,KAAK,GAAG,uBAAuB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC3D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,iCAAiC,cAAc,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;QAC7B,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;QAC5B,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;KACzB,CAAC;AACJ,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAAiB;IACrD,OAAO,MAAM,SAAS,EAAE,CAAC;AAC3B,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,oBAAoB,CAAC,EAAU;IAC7C,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpC,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACzC,CAAC","sourcesContent":["import type { GithubConversationRef } from \"./types.js\";\n\n/**\n * Conversation id for one issue/PR: `GH_<owner>_<repo>_<number>`.\n *\n * DESIGN.md originally proposed `gh:<owner>/<repo>#<number>`, but conversation\n * ids are used verbatim as a single path segment (LAYOUT.md § Casing) and the\n * conversation dir is bind-mounted with docker's `-v source:target` syntax in\n * image mode — so the id can contain neither `/` nor `:`. `_` is the\n * separator because it is the only inert character that also parses back\n * unambiguously under GitHub's name grammar: owners allow `-` (so `-` would\n * make the owner/repo boundary ambiguous) but never `_`, repos may contain\n * `_` but the trailing number is pure digits — so the first `_` and the last\n * `_` before the digits are always the real boundaries.\n *\n * Owner and repo are lowercased: GitHub names are case-insensitive (and this\n * id has two spelling sources — the GITHUB_REPOS env var and API payloads),\n * so per LAYOUT.md § Casing this is a mikan-derived slug, not a verbatim\n * platform id, and derived slugs are lowercased to keep one issue from\n * mapping to two conversation dirs on case-sensitive filesystems.\n */\nexport function buildGithubConversationId(ref: GithubConversationRef): string {\n  return `GH_${ref.owner.toLowerCase()}_${ref.repo.toLowerCase()}_${ref.number}`;\n}\n\nconst CONVERSATION_ID_PATTERN = /^GH_([A-Za-z0-9-]+)_(.+)_(\\d+)$/;\n\nexport function parseGithubConversationId(conversationId: string): GithubConversationRef {\n  // The greedy repo group splits at the last `_` followed by digits-to-end,\n  // which is always the number boundary (repos may contain `_` themselves).\n  const match = CONVERSATION_ID_PATTERN.exec(conversationId);\n  if (!match) {\n    throw new Error(`Not a GitHub conversation id: ${conversationId}`);\n  }\n  return {\n    owner: match[1].toLowerCase(),\n    repo: match[2].toLowerCase(),\n    number: Number(match[3]),\n  };\n}\n\n/** Message ts used for the issue/PR body itself (comments use their comment id). */\nexport const GITHUB_ISSUE_BODY_TS = \"issue\";\n\n/**\n * Message ts for an inline PR review comment: `rc-<id>`. Review-comment ids\n * live in a different id space than issue-comment ids, and several endpoints\n * (reactions, edits) differ by family — the prefix makes routing a review id\n * to an issue-comment endpoint structurally impossible.\n */\nexport function githubReviewCommentTs(commentId: number): string {\n  return `rc-${commentId}`;\n}\n\n/** The review-comment id inside an `rc-<id>` ts, or null for other ts kinds. */\nexport function parseReviewCommentTs(ts: string): number | null {\n  const match = /^rc-(\\d+)$/.exec(ts);\n  return match ? Number(match[1]) : null;\n}\n"]}

package/dist/adapters/github/repo.d.ts

@@ -0,0 +1,32 @@
+import type { CloneRepoOptions, PushBranchOptions, SyncRepoOptions, SyncRepoResult } from "./types.js";
+/**
+ * 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 declare const GITHUB_PUSH_BRANCH_PATTERN: RegExp;
+/** The conversation's clone location (bind-mounted into the sandbox as ./repo). */
+export declare function conversationRepoDir(workingDir: string, conversationId: string): string;
+/**
+ * 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 declare function cloneRepo(options: CloneRepoOptions): Promise<void>;
+/**
+ * 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 declare function syncRepo(options: SyncRepoOptions): Promise<SyncRepoResult>;
+/**
+ * Push one local branch to origin. Non-force by construction (plain refspec),
+ * and only `pi/*` branches are accepted.
+ */
+export declare function pushBranch(options: PushBranchOptions): Promise<void>;
+//# sourceMappingURL=repo.d.ts.map

package/dist/adapters/github/repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo.d.ts","sourceRoot":"","sources":["../../../src/adapters/github/repo.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACf,MAAM,YAAY,CAAC;AAMpB;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,QAAwC,CAAC;AAEhF,mFAAmF;AACnF,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAEtF;AA0CD;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBxE;AAED;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CA8ChF;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAa1E"}

package/dist/adapters/github/repo.js

@@ -0,0 +1,141 @@
+import { execFile } from "child_process";
+import { join } from "path";
+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._/-]*$/;
+/** The conversation's clone location (bind-mounted into the sandbox as ./repo). */
+export function conversationRepoDir(workingDir, conversationId) {
+    return join(workingDir, conversationId, "repo");
+}
+/**
+ * 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 { join } from \"path\";\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/** The conversation's clone location (bind-mounted into the sandbox as ./repo). */\nexport function conversationRepoDir(workingDir: string, conversationId: string): string {\n  return join(workingDir, conversationId, \"repo\");\n}\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;AAG/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,CA+DA"}

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

@@ -0,0 +1,105 @@
+import { Type } from "@sinclair/typebox";
+import { defineHostFnTool } from "../../../tools/host-fn-tool.js";
+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() {
+    const { tool, setFn } = defineHostFnTool({
+        name: "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,
+        unavailable: "github_checks is only available in GitHub conversations.",
+        run: async (checksFns, args) => {
+            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: setFn };
+}
+//# sourceMappingURL=checks.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checks.js","sourceRoot":"","sources":["../../../../src/adapters/github/tools/checks.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentTool } from \"@earendil-works/pi-agent-core\";\nimport { Type } from \"@sinclair/typebox\";\nimport { defineHostFnTool } from \"../../../tools/host-fn-tool.js\";\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  const { tool, setFn } = defineHostFnTool<GithubChecksFns, typeof githubChecksSchema>({\n    name: \"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    unavailable: \"github_checks is only available in GitHub conversations.\",\n    run: async (checksFns, args) => {\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 { tool, setGithubChecksFunction: setFn };\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;AAG/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,CAoBA"}

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

@@ -0,0 +1,48 @@
+import { Type } from "@sinclair/typebox";
+import { defineHostFnTool } from "../../../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,gCAAgC,CAAC;AAGlE,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,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 \"../../../tools/host-fn-tool.js\";\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  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"]}