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

package/dist/adapters/github/context.js

@@ -0,0 +1,175 @@
+import * as log from "../../log.js";
+import { resolveChatSessionKey } from "../../sessions/policy.js";
+import { createChatResponseErrorReporter, formatToolArgs, splitText, } from "../shared.js";
+import { OrderedResponseOperations } from "../streaming.js";
+import { formatGithubContinuation, GITHUB_MAX_COMMENT_LENGTH, } from "./bot.js";
+import { parseGithubConversationId } from "./ids.js";
+function formatToolResult(result) {
+    const argsFormatted = formatToolArgs(result.args);
+    const duration = (result.durationMs / 1000).toFixed(1);
+    let text = `**${result.isError ? "Error" : "Done"} ${result.toolName}**`;
+    if (result.label)
+        text += `: ${result.label}`;
+    text += ` (${duration}s)\n`;
+    if (argsFormatted)
+        text += `\`\`\`\n${argsFormatted}\n\`\`\`\n`;
+    text += `**Result:**\n\`\`\`\n${result.result}\n\`\`\``;
+    return text;
+}
+export function createGithubAdapters(event, bot) {
+    let commentId = null;
+    let accumulatedText = "";
+    const responseOperations = new OrderedResponseOperations();
+    const conversationId = event.conversationId;
+    const ref = parseGithubConversationId(conversationId);
+    const message = {
+        id: event.ts,
+        sessionKey: event.sessionKey ??
+            resolveChatSessionKey({
+                conversationId,
+                conversationKind: event.conversationKind,
+                messageId: event.ts,
+                persistentTopLevel: true,
+                threadTs: event.thread_ts,
+            }),
+        conversationKind: event.conversationKind,
+        userId: event.user,
+        userName: event.userName,
+        text: event.text,
+        attachments: event.attachments,
+        threadTs: event.thread_ts,
+    };
+    // The bot's getMessagingInfo() is the single authority for platform info;
+    // the conversation-scoped context below is an explicit append, not a fork.
+    const baseInfo = bot.getMessagingInfo();
+    const platform = {
+        ...baseInfo,
+        formattingGuide: `${baseInfo.formattingGuide}\n\n` +
+            `## Conversation context\n` +
+            `This conversation IS GitHub issue/PR ${ref.owner}/${ref.repo}#${ref.number}: the ` +
+            `first message in the history is its title and body, and the following messages are ` +
+            `its comments. When the user says "this issue", they mean #${ref.number}. Messages ` +
+            `tagged [PR review comment rc-<id> …] are inline review threads on a diff line: ` +
+            `answer those with the github_review_reply tool (comment_id = that id) so the reply ` +
+            `lands in-thread — your normal response posts as a plain PR comment.\n\n` +
+            `## Repository & pull requests\n` +
+            `The repository is cloned at ./repo — a snapshot from this conversation's first ` +
+            `trigger; run github_sync when it may be stale to pull the latest PR head or base ` +
+            `branch. If this conversation is a pull request, its head branch is checked out ` +
+            `under its real name (run git branch --show-current in ./repo to see it; fork PRs ` +
+            `fall back to pr-${ref.number}). You have no git credentials, so git fetch/push ` +
+            `fail by design.\n` +
+            `To ship code changes: commit inside ./repo (the git author is preconfigured) on a ` +
+            `pi/<name> branch, then call the github_pr tool to push it. When this conversation's ` +
+            `checked-out PR head branch is already named pi/<name> — e.g. a PR you opened ` +
+            `earlier — commit directly on it and pass that branch to github_pr: the push ` +
+            `updates THIS pull request instead of opening a new one. Any other branch opens a ` +
+            `new pull request (draft: true for a draft); calling github_pr again with the same ` +
+            `branch pushes new commits to its existing PR. Use github_checks to read CI results ` +
+            `for your branch (or this PR) — pass a failing check's job id to read its log — and ` +
+            `iterate until they pass. You cannot push the default branch or ` +
+            `merge — humans review and merge every PR.\n` +
+            `github_read looks up PR/issue metadata this clone cannot show (diff stats, changed ` +
+            `files, review state, other issues in this repo); github_issue manages labels, ` +
+            `assignees, and close/reopen for triage.`,
+        diagnostics: {
+            showUsageSummary: false,
+        },
+    };
+    const reportResponseError = createChatResponseErrorReporter(() => ({
+        platform: "github",
+        conversationId,
+        messageId: message.id,
+        sessionKey: message.sessionKey,
+        responseMessageId: commentId,
+        conversationKind: message.conversationKind,
+    }));
+    async function postOrUpdateResponse(displayText) {
+        if (commentId !== null) {
+            await bot.updateMessage(conversationId, String(commentId), displayText);
+        }
+        else {
+            commentId = await bot.postComment(ref, displayText);
+        }
+    }
+    async function postSplitResponse(text) {
+        const [displayText, ...extraParts] = splitText(text, GITHUB_MAX_COMMENT_LENGTH, formatGithubContinuation);
+        await postOrUpdateResponse(displayText);
+        for (const part of extraParts) {
+            await bot.postComment(ref, part);
+        }
+    }
+    function queueGithubResponse(label, operation, work, extra) {
+        return responseOperations.run(work, (err) => {
+            log.logWarning(`GitHub ${label} error`, err instanceof Error ? err.message : String(err));
+            reportResponseError(err, operation, extra());
+        });
+    }
+    // No appendResponseDelta/finishResponse: GitHub gets the finished response
+    // in one comment. Streaming would edit the comment on every flush — API
+    // churn and "edited" noise for readers who refresh rather than watch typing.
+    const responder = {
+        respond: async (text) => {
+            await queueGithubResponse("respond", "respond", async () => {
+                accumulatedText = accumulatedText ? `${accumulatedText}\n${text}` : text;
+                await postSplitResponse(accumulatedText);
+                if (commentId !== null) {
+                    bot.logBotResponse(conversationId, text, String(commentId));
+                }
+            }, () => ({
+                phase: commentId ? "update" : "initial_post",
+                textLength: text.length,
+                accumulatedLength: accumulatedText.length,
+            }));
+        },
+        replaceResponse: async (text) => {
+            await queueGithubResponse("replaceResponse", "replace_response", async () => {
+                accumulatedText = text;
+                await postSplitResponse(accumulatedText);
+            }, () => ({
+                textLength: text.length,
+                hadExistingResponse: Boolean(commentId),
+            }));
+        },
+        respondDiagnostic: async (text, options) => {
+            await queueGithubResponse("respondDiagnostic", "respond_diagnostic", async () => {
+                const prefix = options?.style === "error" ? "**Error:** " : "";
+                for (const part of splitText(`${prefix}${text}`, GITHUB_MAX_COMMENT_LENGTH, formatGithubContinuation)) {
+                    await bot.postComment(ref, part);
+                }
+            }, () => ({ textLength: text.length, style: options?.style }));
+        },
+        respondToolResult: async (result) => {
+            await responder.respondDiagnostic(formatToolResult(result));
+        },
+        // GitHub has no typing indicator; progress shows through comment edits.
+        setTyping: async () => { },
+        setWorking: async () => { },
+        uploadFile: async (filePath, title) => {
+            // The REST API cannot attach files to comments (uploads are a browser
+            // feature); leave a pointer instead of failing the run.
+            const name = title ?? filePath;
+            await queueGithubResponse("uploadFile", "respond_diagnostic", async () => {
+                await bot.postComment(ref, `*(file \`${name}\` was produced, but the GitHub adapter cannot attach files to comments)*`);
+            }, () => ({ filePath }));
+        },
+        react: async (emoji) => {
+            await bot.addReaction(conversationId, event.ts, emoji);
+        },
+        deleteResponse: async () => {
+            await responseOperations.run(async () => {
+                if (commentId !== null) {
+                    try {
+                        await bot.deleteComment(ref, commentId);
+                    }
+                    catch {
+                        // Ignore errors
+                    }
+                    commentId = null;
+                }
+            });
+        },
+    };
+    return { message, responder, platform };
+}
+//# sourceMappingURL=context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/adapters/github/context.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  ChatToolResult,\n  ConversationMessage,\n  ConversationResponder,\n  MessagingInfo,\n} from \"../../adapter.js\";\nimport * as log from \"../../log.js\";\nimport { resolveChatSessionKey } from \"../../sessions/policy.js\";\nimport {\n  createChatResponseErrorReporter,\n  formatToolArgs,\n  splitText,\n  type ChatResponseErrorOperation,\n} from \"../shared.js\";\nimport { OrderedResponseOperations } from \"../streaming.js\";\nimport {\n  formatGithubContinuation,\n  GITHUB_MAX_COMMENT_LENGTH,\n  type GithubMessagingBot,\n} from \"./bot.js\";\nimport { parseGithubConversationId } from \"./ids.js\";\nimport type { GithubEvent } from \"./types.js\";\n\nfunction formatToolResult(result: ChatToolResult): string {\n  const argsFormatted = formatToolArgs(result.args);\n  const duration = (result.durationMs / 1000).toFixed(1);\n  let text = `**${result.isError ? \"Error\" : \"Done\"} ${result.toolName}**`;\n  if (result.label) text += `: ${result.label}`;\n  text += ` (${duration}s)\\n`;\n  if (argsFormatted) text += `\\`\\`\\`\\n${argsFormatted}\\n\\`\\`\\`\\n`;\n  text += `**Result:**\\n\\`\\`\\`\\n${result.result}\\n\\`\\`\\``;\n  return text;\n}\n\nexport function createGithubAdapters(\n  event: GithubEvent,\n  bot: GithubMessagingBot,\n): {\n  message: ConversationMessage;\n  responder: ConversationResponder;\n  platform: MessagingInfo;\n} {\n  let commentId: number | null = null;\n  let accumulatedText = \"\";\n  const responseOperations = new OrderedResponseOperations();\n\n  const conversationId = event.conversationId;\n  const ref = parseGithubConversationId(conversationId);\n\n  const message: ConversationMessage = {\n    id: event.ts,\n    sessionKey:\n      event.sessionKey ??\n      resolveChatSessionKey({\n        conversationId,\n        conversationKind: event.conversationKind,\n        messageId: event.ts,\n        persistentTopLevel: true,\n        threadTs: event.thread_ts,\n      }),\n    conversationKind: event.conversationKind,\n    userId: event.user,\n    userName: event.userName,\n    text: event.text,\n    attachments: event.attachments,\n    threadTs: event.thread_ts,\n  };\n\n  // The bot's getMessagingInfo() is the single authority for platform info;\n  // the conversation-scoped context below is an explicit append, not a fork.\n  const baseInfo = bot.getMessagingInfo();\n  const platform: MessagingInfo = {\n    ...baseInfo,\n    formattingGuide:\n      `${baseInfo.formattingGuide}\\n\\n` +\n      `## Conversation context\\n` +\n      `This conversation IS GitHub issue/PR ${ref.owner}/${ref.repo}#${ref.number}: the ` +\n      `first message in the history is its title and body, and the following messages are ` +\n      `its comments. When the user says \"this issue\", they mean #${ref.number}. Messages ` +\n      `tagged [PR review comment rc-<id> …] are inline review threads on a diff line: ` +\n      `answer those with the github_review_reply tool (comment_id = that id) so the reply ` +\n      `lands in-thread — your normal response posts as a plain PR comment.\\n\\n` +\n      `## Repository & pull requests\\n` +\n      `The repository is cloned at ./repo — a snapshot from this conversation's first ` +\n      `trigger; run github_sync when it may be stale to pull the latest PR head or base ` +\n      `branch. If this conversation is a pull request, its head branch is checked out ` +\n      `under its real name (run git branch --show-current in ./repo to see it; fork PRs ` +\n      `fall back to pr-${ref.number}). You have no git credentials, so git fetch/push ` +\n      `fail by design.\\n` +\n      `To ship code changes: commit inside ./repo (the git author is preconfigured) on a ` +\n      `pi/<name> branch, then call the github_pr tool to push it. When this conversation's ` +\n      `checked-out PR head branch is already named pi/<name> — e.g. a PR you opened ` +\n      `earlier — commit directly on it and pass that branch to github_pr: the push ` +\n      `updates THIS pull request instead of opening a new one. Any other branch opens a ` +\n      `new pull request (draft: true for a draft); calling github_pr again with the same ` +\n      `branch pushes new commits to its existing PR. Use github_checks to read CI results ` +\n      `for your branch (or this PR) — pass a failing check's job id to read its log — and ` +\n      `iterate until they pass. You cannot push the default branch or ` +\n      `merge — humans review and merge every PR.\\n` +\n      `github_read looks up PR/issue metadata this clone cannot show (diff stats, changed ` +\n      `files, review state, other issues in this repo); github_issue manages labels, ` +\n      `assignees, and close/reopen for triage.`,\n    diagnostics: {\n      showUsageSummary: false,\n    },\n  };\n\n  const reportResponseError = createChatResponseErrorReporter(() => ({\n    platform: \"github\",\n    conversationId,\n    messageId: message.id,\n    sessionKey: message.sessionKey,\n    responseMessageId: commentId,\n    conversationKind: message.conversationKind,\n  }));\n\n  async function postOrUpdateResponse(displayText: string): Promise<void> {\n    if (commentId !== null) {\n      await bot.updateMessage(conversationId, String(commentId), displayText);\n    } else {\n      commentId = await bot.postComment(ref, displayText);\n    }\n  }\n\n  async function postSplitResponse(text: string): Promise<void> {\n    const [displayText, ...extraParts] = splitText(\n      text,\n      GITHUB_MAX_COMMENT_LENGTH,\n      formatGithubContinuation,\n    );\n    await postOrUpdateResponse(displayText);\n    for (const part of extraParts) {\n      await bot.postComment(ref, part);\n    }\n  }\n\n  function queueGithubResponse(\n    label: string,\n    operation: ChatResponseErrorOperation,\n    work: () => Promise<void>,\n    extra: () => Record<string, unknown>,\n  ): Promise<void> {\n    return responseOperations.run(work, (err) => {\n      log.logWarning(`GitHub ${label} error`, err instanceof Error ? err.message : String(err));\n      reportResponseError(err, operation, extra());\n    });\n  }\n\n  // No appendResponseDelta/finishResponse: GitHub gets the finished response\n  // in one comment. Streaming would edit the comment on every flush — API\n  // churn and \"edited\" noise for readers who refresh rather than watch typing.\n  const responder: ConversationResponder = {\n    respond: async (text: string) => {\n      await queueGithubResponse(\n        \"respond\",\n        \"respond\",\n        async () => {\n          accumulatedText = accumulatedText ? `${accumulatedText}\\n${text}` : text;\n          await postSplitResponse(accumulatedText);\n          if (commentId !== null) {\n            bot.logBotResponse(conversationId, text, String(commentId));\n          }\n        },\n        () => ({\n          phase: commentId ? \"update\" : \"initial_post\",\n          textLength: text.length,\n          accumulatedLength: accumulatedText.length,\n        }),\n      );\n    },\n\n    replaceResponse: async (text: string) => {\n      await queueGithubResponse(\n        \"replaceResponse\",\n        \"replace_response\",\n        async () => {\n          accumulatedText = text;\n          await postSplitResponse(accumulatedText);\n        },\n        () => ({\n          textLength: text.length,\n          hadExistingResponse: Boolean(commentId),\n        }),\n      );\n    },\n\n    respondDiagnostic: async (text: string, options?: { style?: \"muted\" | \"error\" }) => {\n      await queueGithubResponse(\n        \"respondDiagnostic\",\n        \"respond_diagnostic\",\n        async () => {\n          const prefix = options?.style === \"error\" ? \"**Error:** \" : \"\";\n          for (const part of splitText(\n            `${prefix}${text}`,\n            GITHUB_MAX_COMMENT_LENGTH,\n            formatGithubContinuation,\n          )) {\n            await bot.postComment(ref, part);\n          }\n        },\n        () => ({ textLength: text.length, style: options?.style }),\n      );\n    },\n\n    respondToolResult: async (result: ChatToolResult) => {\n      await responder.respondDiagnostic(formatToolResult(result));\n    },\n\n    // GitHub has no typing indicator; progress shows through comment edits.\n    setTyping: async () => {},\n\n    setWorking: async () => {},\n\n    uploadFile: async (filePath: string, title?: string) => {\n      // The REST API cannot attach files to comments (uploads are a browser\n      // feature); leave a pointer instead of failing the run.\n      const name = title ?? filePath;\n      await queueGithubResponse(\n        \"uploadFile\",\n        \"respond_diagnostic\",\n        async () => {\n          await bot.postComment(\n            ref,\n            `*(file \\`${name}\\` was produced, but the GitHub adapter cannot attach files to comments)*`,\n          );\n        },\n        () => ({ filePath }),\n      );\n    },\n\n    react: async (emoji: string) => {\n      await bot.addReaction(conversationId, event.ts, emoji);\n    },\n\n    deleteResponse: async () => {\n      await responseOperations.run(async () => {\n        if (commentId !== null) {\n          try {\n            await bot.deleteComment(ref, commentId);\n          } catch {\n            // Ignore errors\n          }\n          commentId = null;\n        }\n      });\n    },\n  };\n\n  return { message, responder, platform };\n}\n"]}

package/dist/adapters/github/gcp-auth.d.ts

@@ -0,0 +1,31 @@
+export interface GcpTokenProviderOptions {
+    /** Path to the ADC JSON (usually $GOOGLE_APPLICATION_CREDENTIALS). */
+    credentialsPath: string;
+    fetchImpl?: typeof fetch;
+}
+export declare class GcpAuthError extends Error {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare class GcpTokenProvider {
+    private readonly credentialsPath;
+    private readonly fetchImpl;
+    private credentials;
+    private cached;
+    private inFlight;
+    constructor(options: GcpTokenProviderOptions);
+    /** A valid cloud-platform access token, cached until near expiry. */
+    getAccessToken(): Promise<string>;
+    private loadCredentials;
+    private mintToken;
+    private postForm;
+    /** WIF: read the subject token, exchange at STS, optionally impersonate. */
+    private mintExternalAccount;
+    private readSubjectToken;
+    /** Service-account key: self-signed RS256 JWT → assertion grant. */
+    private mintServiceAccount;
+    /** gcloud user ADC: refresh-token grant. */
+    private mintAuthorizedUser;
+}
+//# sourceMappingURL=gcp-auth.d.ts.map

package/dist/adapters/github/gcp-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcp-auth.d.ts","sourceRoot":"","sources":["../../../src/adapters/github/gcp-auth.ts"],"names":[],"mappings":"AAwDA,MAAM,WAAW,uBAAuB;IACtC,sEAAsE;IACtE,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAMD,qBAAa,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,EAGzD;CACF;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,MAAM,CAAqD;IACnE,OAAO,CAAC,QAAQ,CAAgC;IAEhD,YAAY,OAAO,EAAE,uBAAuB,EAG3C;IAED,qEAAqE;IAC/D,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAStC;IAED,OAAO,CAAC,eAAe;YAqBT,SAAS;YAqBT,QAAQ;IAiBtB,4EAA4E;YAC9D,mBAAmB;YA4CnB,gBAAgB;IA+B9B,oEAAoE;YACtD,kBAAkB;IAiChC,4CAA4C;YAC9B,kBAAkB;CAkBjC"}

package/dist/adapters/github/gcp-auth.js

@@ -0,0 +1,196 @@
+import { readFileSync } from "fs";
+import { createSign } from "crypto";
+/**
+ * Minimal Google Application Default Credentials provider — enough to mint
+ * cloud-platform access tokens on the host without pulling in
+ * google-auth-library (this repo hand-rolls its GitHub App JWTs the same way).
+ *
+ * Supported `GOOGLE_APPLICATION_CREDENTIALS` JSON shapes:
+ *  - `external_account` (Workload Identity Federation) with a file or url
+ *    credential source: STS token exchange, plus optional service-account
+ *    impersonation. AWS/executable sources are rejected with a clear error.
+ *  - `service_account` key: self-signed JWT assertion grant.
+ *  - `authorized_user` (gcloud user ADC): refresh-token grant. Local dev.
+ */
+const CLOUD_PLATFORM_SCOPE = "https://www.googleapis.com/auth/cloud-platform";
+const OAUTH_TOKEN_URL = "https://oauth2.googleapis.com/token";
+/** Refresh cached tokens this long before expiry — STS/impersonation tokens
+ *  live ~1h; minting per request would hammer STS in a CI-debug loop. */
+const TOKEN_REFRESH_MARGIN_MS = 5 * 60 * 1000;
+function base64Url(data) {
+    return Buffer.from(data).toString("base64url");
+}
+export class GcpAuthError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "GcpAuthError";
+    }
+}
+export class GcpTokenProvider {
+    constructor(options) {
+        this.credentials = null;
+        this.cached = null;
+        this.inFlight = null;
+        this.credentialsPath = options.credentialsPath;
+        this.fetchImpl = options.fetchImpl ?? fetch;
+    }
+    /** A valid cloud-platform access token, cached until near expiry. */
+    async getAccessToken() {
+        if (this.cached && Date.now() < this.cached.expiresAt - TOKEN_REFRESH_MARGIN_MS) {
+            return this.cached.token;
+        }
+        // Single-flight: concurrent tool calls must not each hit STS.
+        this.inFlight ??= this.mintToken().finally(() => {
+            this.inFlight = null;
+        });
+        return this.inFlight;
+    }
+    loadCredentials() {
+        if (this.credentials)
+            return this.credentials;
+        let parsed;
+        try {
+            parsed = JSON.parse(readFileSync(this.credentialsPath, "utf-8"));
+        }
+        catch (err) {
+            throw new GcpAuthError(`Cannot read GCP credentials at ${this.credentialsPath}: ${err instanceof Error ? err.message : String(err)}`, { cause: err });
+        }
+        if (!["external_account", "service_account", "authorized_user"].includes(parsed.type)) {
+            throw new GcpAuthError(`Unsupported GCP credential type '${parsed.type}' — expected ` +
+                `external_account (WIF), service_account, or authorized_user.`);
+        }
+        this.credentials = parsed;
+        return parsed;
+    }
+    async mintToken() {
+        const credentials = this.loadCredentials();
+        let minted;
+        switch (credentials.type) {
+            case "external_account":
+                minted = await this.mintExternalAccount(credentials);
+                break;
+            case "service_account":
+                minted = await this.mintServiceAccount(credentials);
+                break;
+            case "authorized_user":
+                minted = await this.mintAuthorizedUser(credentials);
+                break;
+        }
+        this.cached = {
+            token: minted.token,
+            expiresAt: Date.now() + minted.expiresInSeconds * 1000,
+        };
+        return minted.token;
+    }
+    async postForm(url, form, context) {
+        const response = await this.fetchImpl(url, {
+            method: "POST",
+            headers: { "Content-Type": "application/x-www-form-urlencoded" },
+            body: new URLSearchParams(form).toString(),
+        });
+        if (!response.ok) {
+            const detail = (await response.text().catch(() => "")).slice(0, 300);
+            throw new GcpAuthError(`${context} failed with ${response.status}: ${detail}`);
+        }
+        return (await response.json());
+    }
+    /** WIF: read the subject token, exchange at STS, optionally impersonate. */
+    async mintExternalAccount(credentials) {
+        const subjectToken = await this.readSubjectToken(credentials);
+        const sts = await this.postForm(credentials.token_url, {
+            grant_type: "urn:ietf:params:oauth:grant-type:token-exchange",
+            audience: credentials.audience,
+            scope: CLOUD_PLATFORM_SCOPE,
+            requested_token_type: "urn:ietf:params:oauth:token-type:access_token",
+            subject_token: subjectToken,
+            subject_token_type: credentials.subject_token_type,
+        }, "GCP STS token exchange");
+        const stsToken = sts.access_token;
+        const stsExpires = sts.expires_in ?? 3600;
+        if (!credentials.service_account_impersonation_url) {
+            return { token: stsToken, expiresInSeconds: stsExpires };
+        }
+        const response = await this.fetchImpl(credentials.service_account_impersonation_url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${stsToken}`,
+            },
+            body: JSON.stringify({ scope: [CLOUD_PLATFORM_SCOPE] }),
+        });
+        if (!response.ok) {
+            const detail = (await response.text().catch(() => "")).slice(0, 300);
+            throw new GcpAuthError(`GCP service-account impersonation failed with ${response.status}: ${detail}`);
+        }
+        const impersonated = (await response.json());
+        const expiresInSeconds = Math.max(0, Math.floor((Date.parse(impersonated.expireTime) - Date.now()) / 1000));
+        return { token: impersonated.accessToken, expiresInSeconds };
+    }
+    async readSubjectToken(credentials) {
+        const source = credentials.credential_source;
+        let raw;
+        if (source.file) {
+            raw = readFileSync(source.file, "utf-8").trim();
+        }
+        else if (source.url) {
+            const response = await this.fetchImpl(source.url, { headers: source.headers });
+            if (!response.ok) {
+                throw new GcpAuthError(`WIF credential_source url returned ${response.status} — cannot read subject token`);
+            }
+            raw = (await response.text()).trim();
+        }
+        else {
+            throw new GcpAuthError("Unsupported WIF credential_source: only file and url sources are supported " +
+                "(aws/executable sources are not).");
+        }
+        if (source.format?.type === "json") {
+            const field = source.format.subject_token_field_name ?? "token";
+            const parsed = JSON.parse(raw);
+            const token = parsed[field];
+            if (!token) {
+                throw new GcpAuthError(`WIF subject token field '${field}' missing from JSON source`);
+            }
+            return token;
+        }
+        return raw;
+    }
+    /** Service-account key: self-signed RS256 JWT → assertion grant. */
+    async mintServiceAccount(credentials) {
+        const tokenUrl = credentials.token_uri ?? OAUTH_TOKEN_URL;
+        const now = Math.floor(Date.now() / 1000);
+        const header = base64Url(JSON.stringify({ alg: "RS256", typ: "JWT" }));
+        const payload = base64Url(JSON.stringify({
+            iss: credentials.client_email,
+            scope: CLOUD_PLATFORM_SCOPE,
+            aud: tokenUrl,
+            iat: now,
+            exp: now + 3600,
+        }));
+        const signature = createSign("RSA-SHA256")
+            .update(`${header}.${payload}`)
+            .sign(credentials.private_key)
+            .toString("base64url");
+        const data = await this.postForm(tokenUrl, {
+            grant_type: "urn:ietf:params:oauth:grant-type:jwt-bearer",
+            assertion: `${header}.${payload}.${signature}`,
+        }, "GCP service-account token grant");
+        return {
+            token: data.access_token,
+            expiresInSeconds: data.expires_in ?? 3600,
+        };
+    }
+    /** gcloud user ADC: refresh-token grant. */
+    async mintAuthorizedUser(credentials) {
+        const data = await this.postForm(OAUTH_TOKEN_URL, {
+            grant_type: "refresh_token",
+            client_id: credentials.client_id,
+            client_secret: credentials.client_secret,
+            refresh_token: credentials.refresh_token,
+        }, "GCP user-credential refresh");
+        return {
+            token: data.access_token,
+            expiresInSeconds: data.expires_in ?? 3600,
+        };
+    }
+}
+//# sourceMappingURL=gcp-auth.js.map

package/dist/adapters/github/gcp-auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcp-auth.js","sourceRoot":"","sources":["../../../src/adapters/github/gcp-auth.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFileSync } from \"fs\";\nimport { createSign } from \"crypto\";\n\n/**\n * Minimal Google Application Default Credentials provider — enough to mint\n * cloud-platform access tokens on the host without pulling in\n * google-auth-library (this repo hand-rolls its GitHub App JWTs the same way).\n *\n * Supported `GOOGLE_APPLICATION_CREDENTIALS` JSON shapes:\n *  - `external_account` (Workload Identity Federation) with a file or url\n *    credential source: STS token exchange, plus optional service-account\n *    impersonation. AWS/executable sources are rejected with a clear error.\n *  - `service_account` key: self-signed JWT assertion grant.\n *  - `authorized_user` (gcloud user ADC): refresh-token grant. Local dev.\n */\n\nconst CLOUD_PLATFORM_SCOPE = \"https://www.googleapis.com/auth/cloud-platform\";\nconst OAUTH_TOKEN_URL = \"https://oauth2.googleapis.com/token\";\n\n/** Refresh cached tokens this long before expiry — STS/impersonation tokens\n *  live ~1h; minting per request would hammer STS in a CI-debug loop. */\nconst TOKEN_REFRESH_MARGIN_MS = 5 * 60 * 1000;\n\ninterface ExternalAccountCredentials {\n  type: \"external_account\";\n  audience: string;\n  subject_token_type: string;\n  token_url: string;\n  service_account_impersonation_url?: string;\n  credential_source: {\n    file?: string;\n    url?: string;\n    headers?: Record<string, string>;\n    format?: { type?: string; subject_token_field_name?: string };\n  };\n}\n\ninterface ServiceAccountCredentials {\n  type: \"service_account\";\n  client_email: string;\n  private_key: string;\n  token_uri?: string;\n}\n\ninterface AuthorizedUserCredentials {\n  type: \"authorized_user\";\n  client_id: string;\n  client_secret: string;\n  refresh_token: string;\n}\n\ntype AdcCredentials =\n  | ExternalAccountCredentials\n  | ServiceAccountCredentials\n  | AuthorizedUserCredentials;\n\nexport interface GcpTokenProviderOptions {\n  /** Path to the ADC JSON (usually $GOOGLE_APPLICATION_CREDENTIALS). */\n  credentialsPath: string;\n  fetchImpl?: typeof fetch;\n}\n\nfunction base64Url(data: string): string {\n  return Buffer.from(data).toString(\"base64url\");\n}\n\nexport class GcpAuthError extends Error {\n  constructor(message: string, options?: { cause?: unknown }) {\n    super(message, options);\n    this.name = \"GcpAuthError\";\n  }\n}\n\nexport class GcpTokenProvider {\n  private readonly credentialsPath: string;\n  private readonly fetchImpl: typeof fetch;\n  private credentials: AdcCredentials | null = null;\n  private cached: { token: string; expiresAt: number } | null = null;\n  private inFlight: Promise<string> | null = null;\n\n  constructor(options: GcpTokenProviderOptions) {\n    this.credentialsPath = options.credentialsPath;\n    this.fetchImpl = options.fetchImpl ?? fetch;\n  }\n\n  /** A valid cloud-platform access token, cached until near expiry. */\n  async getAccessToken(): Promise<string> {\n    if (this.cached && Date.now() < this.cached.expiresAt - TOKEN_REFRESH_MARGIN_MS) {\n      return this.cached.token;\n    }\n    // Single-flight: concurrent tool calls must not each hit STS.\n    this.inFlight ??= this.mintToken().finally(() => {\n      this.inFlight = null;\n    });\n    return this.inFlight;\n  }\n\n  private loadCredentials(): AdcCredentials {\n    if (this.credentials) return this.credentials;\n    let parsed: AdcCredentials;\n    try {\n      parsed = JSON.parse(readFileSync(this.credentialsPath, \"utf-8\")) as AdcCredentials;\n    } catch (err) {\n      throw new GcpAuthError(\n        `Cannot read GCP credentials at ${this.credentialsPath}: ${err instanceof Error ? err.message : String(err)}`,\n        { cause: err },\n      );\n    }\n    if (![\"external_account\", \"service_account\", \"authorized_user\"].includes(parsed.type)) {\n      throw new GcpAuthError(\n        `Unsupported GCP credential type '${(parsed as { type?: string }).type}' — expected ` +\n          `external_account (WIF), service_account, or authorized_user.`,\n      );\n    }\n    this.credentials = parsed;\n    return parsed;\n  }\n\n  private async mintToken(): Promise<string> {\n    const credentials = this.loadCredentials();\n    let minted: { token: string; expiresInSeconds: number };\n    switch (credentials.type) {\n      case \"external_account\":\n        minted = await this.mintExternalAccount(credentials);\n        break;\n      case \"service_account\":\n        minted = await this.mintServiceAccount(credentials);\n        break;\n      case \"authorized_user\":\n        minted = await this.mintAuthorizedUser(credentials);\n        break;\n    }\n    this.cached = {\n      token: minted.token,\n      expiresAt: Date.now() + minted.expiresInSeconds * 1000,\n    };\n    return minted.token;\n  }\n\n  private async postForm(\n    url: string,\n    form: Record<string, string>,\n    context: string,\n  ): Promise<Record<string, unknown>> {\n    const response = await this.fetchImpl(url, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/x-www-form-urlencoded\" },\n      body: new URLSearchParams(form).toString(),\n    });\n    if (!response.ok) {\n      const detail = (await response.text().catch(() => \"\")).slice(0, 300);\n      throw new GcpAuthError(`${context} failed with ${response.status}: ${detail}`);\n    }\n    return (await response.json()) as Record<string, unknown>;\n  }\n\n  /** WIF: read the subject token, exchange at STS, optionally impersonate. */\n  private async mintExternalAccount(\n    credentials: ExternalAccountCredentials,\n  ): Promise<{ token: string; expiresInSeconds: number }> {\n    const subjectToken = await this.readSubjectToken(credentials);\n    const sts = await this.postForm(\n      credentials.token_url,\n      {\n        grant_type: \"urn:ietf:params:oauth:grant-type:token-exchange\",\n        audience: credentials.audience,\n        scope: CLOUD_PLATFORM_SCOPE,\n        requested_token_type: \"urn:ietf:params:oauth:token-type:access_token\",\n        subject_token: subjectToken,\n        subject_token_type: credentials.subject_token_type,\n      },\n      \"GCP STS token exchange\",\n    );\n    const stsToken = sts.access_token as string;\n    const stsExpires = (sts.expires_in as number | undefined) ?? 3600;\n    if (!credentials.service_account_impersonation_url) {\n      return { token: stsToken, expiresInSeconds: stsExpires };\n    }\n\n    const response = await this.fetchImpl(credentials.service_account_impersonation_url, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        Authorization: `Bearer ${stsToken}`,\n      },\n      body: JSON.stringify({ scope: [CLOUD_PLATFORM_SCOPE] }),\n    });\n    if (!response.ok) {\n      const detail = (await response.text().catch(() => \"\")).slice(0, 300);\n      throw new GcpAuthError(\n        `GCP service-account impersonation failed with ${response.status}: ${detail}`,\n      );\n    }\n    const impersonated = (await response.json()) as { accessToken: string; expireTime: string };\n    const expiresInSeconds = Math.max(\n      0,\n      Math.floor((Date.parse(impersonated.expireTime) - Date.now()) / 1000),\n    );\n    return { token: impersonated.accessToken, expiresInSeconds };\n  }\n\n  private async readSubjectToken(credentials: ExternalAccountCredentials): Promise<string> {\n    const source = credentials.credential_source;\n    let raw: string;\n    if (source.file) {\n      raw = readFileSync(source.file, \"utf-8\").trim();\n    } else if (source.url) {\n      const response = await this.fetchImpl(source.url, { headers: source.headers });\n      if (!response.ok) {\n        throw new GcpAuthError(\n          `WIF credential_source url returned ${response.status} — cannot read subject token`,\n        );\n      }\n      raw = (await response.text()).trim();\n    } else {\n      throw new GcpAuthError(\n        \"Unsupported WIF credential_source: only file and url sources are supported \" +\n          \"(aws/executable sources are not).\",\n      );\n    }\n    if (source.format?.type === \"json\") {\n      const field = source.format.subject_token_field_name ?? \"token\";\n      const parsed = JSON.parse(raw) as Record<string, string>;\n      const token = parsed[field];\n      if (!token) {\n        throw new GcpAuthError(`WIF subject token field '${field}' missing from JSON source`);\n      }\n      return token;\n    }\n    return raw;\n  }\n\n  /** Service-account key: self-signed RS256 JWT → assertion grant. */\n  private async mintServiceAccount(\n    credentials: ServiceAccountCredentials,\n  ): Promise<{ token: string; expiresInSeconds: number }> {\n    const tokenUrl = credentials.token_uri ?? OAUTH_TOKEN_URL;\n    const now = Math.floor(Date.now() / 1000);\n    const header = base64Url(JSON.stringify({ alg: \"RS256\", typ: \"JWT\" }));\n    const payload = base64Url(\n      JSON.stringify({\n        iss: credentials.client_email,\n        scope: CLOUD_PLATFORM_SCOPE,\n        aud: tokenUrl,\n        iat: now,\n        exp: now + 3600,\n      }),\n    );\n    const signature = createSign(\"RSA-SHA256\")\n      .update(`${header}.${payload}`)\n      .sign(credentials.private_key)\n      .toString(\"base64url\");\n    const data = await this.postForm(\n      tokenUrl,\n      {\n        grant_type: \"urn:ietf:params:oauth:grant-type:jwt-bearer\",\n        assertion: `${header}.${payload}.${signature}`,\n      },\n      \"GCP service-account token grant\",\n    );\n    return {\n      token: data.access_token as string,\n      expiresInSeconds: (data.expires_in as number | undefined) ?? 3600,\n    };\n  }\n\n  /** gcloud user ADC: refresh-token grant. */\n  private async mintAuthorizedUser(\n    credentials: AuthorizedUserCredentials,\n  ): Promise<{ token: string; expiresInSeconds: number }> {\n    const data = await this.postForm(\n      OAUTH_TOKEN_URL,\n      {\n        grant_type: \"refresh_token\",\n        client_id: credentials.client_id,\n        client_secret: credentials.client_secret,\n        refresh_token: credentials.refresh_token,\n      },\n      \"GCP user-credential refresh\",\n    );\n    return {\n      token: data.access_token as string,\n      expiresInSeconds: (data.expires_in as number | undefined) ?? 3600,\n    };\n  }\n}\n"]}

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

@@ -0,0 +1,34 @@
+import type { GithubConversationRef } from "./types.js";
+/**
+ * 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 declare function buildGithubConversationId(ref: GithubConversationRef): string;
+export declare function parseGithubConversationId(conversationId: string): GithubConversationRef;
+/** Message ts used for the issue/PR body itself (comments use their comment id). */
+export declare 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 declare function githubReviewCommentTs(commentId: number): string;
+/** The review-comment id inside an `rc-<id>` ts, or null for other ts kinds. */
+export declare function parseReviewCommentTs(ts: string): number | null;
+//# sourceMappingURL=ids.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../../src/adapters/github/ids.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,qBAAqB,GAAG,MAAM,CAE5E;AAID,wBAAgB,yBAAyB,CAAC,cAAc,EAAE,MAAM,GAAG,qBAAqB,CAYvF;AAED,oFAAoF;AACpF,eAAO,MAAM,oBAAoB,UAAU,CAAC;AAE5C;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,gFAAgF;AAChF,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG9D"}

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,30 @@
+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;
+/**
+ * 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":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACf,MAAM,YAAY,CAAC;AAMpB;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,QAAwC,CAAC;AA0ChF;;;;;;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"}