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

package/dist/adapters/github/github-ops.js

@@ -0,0 +1,405 @@
+import { existsSync } from "fs";
+import * as log from "../../log.js";
+import { GithubApiError, GITHUB_MAX_COMMENT_LENGTH, githubRetry } from "./client.js";
+import { CLOUD_BUILD_APP_SLUG, CloudBuildLogUnavailableError, fetchCloudBuildLog, isCloudBuildId, projectFromDetailsUrl, } from "./cloudbuild.js";
+import { parseGithubConversationId } from "./ids.js";
+import { conversationRepoDir, GITHUB_PUSH_BRANCH_PATTERN, pushBranch, syncRepo } from "./repo.js";
+/** Both CI log modes tail-truncate to this many characters. */
+const MAX_LOG_CHARS = 20000;
+function truncateLogTail(logText) {
+    return logText.length > MAX_LOG_CHARS
+        ? `…(truncated to the last ${MAX_LOG_CHARS} chars)\n${logText.slice(-MAX_LOG_CHARS)}`
+        : logText;
+}
+/** Whether the conversation's issue is a PR, for callers where the triggering
+ *  item didn't carry that knowledge. Errs toward plain issue. */
+export async function fetchIsPr(client, ref) {
+    try {
+        const issue = await githubRetry(() => client.getIssue(ref.owner, ref.repo, ref.number));
+        return Boolean(issue.pull_request);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * The PR's head branch name when it lives in this repo — that is the name
+ * the local checkout should carry, so committing on it and calling
+ * github_pr pushes back to the PR itself instead of opening a new one.
+ * Fork heads (unpushable with the repo-scoped token) and failed lookups
+ * return undefined; callers then fall back to the synthetic pr-<n>.
+ */
+export async function fetchPrHeadBranch(client, ref) {
+    try {
+        const pr = await githubRetry(() => client.getPullRequest(ref.owner, ref.repo, ref.number));
+        const sameRepo = pr.head?.repo?.full_name?.toLowerCase() === `${ref.owner}/${ref.repo}`.toLowerCase();
+        return sameRepo ? pr.head?.ref : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Host-side backend of the github_* tool pack (`PlatformGithubOps`),
+ * standalone from the messaging bot: it needs the API client, the
+ * conversation working dir, and optional Cloud Build access — not the poll
+ * loop, queues, or trigger gate. Tokens are minted per call, scoped to the
+ * conversation's repo, and never enter the sandbox.
+ */
+export class GithubOps {
+    constructor(client, config) {
+        this.client = client;
+        this.config = config;
+        /** Cloud Build ids seen in getChecks summaries → their GCP project. */
+        this.buildRef = new Map();
+    }
+    repoDir(conversationId) {
+        return conversationRepoDir(this.config.workingDir, conversationId);
+    }
+    /**
+     * Backs the `github_pr` tool: push a `pi/*` branch the agent prepared in
+     * the conversation's clone, then open a pull request as the App. The write
+     * token is minted per call, scoped to this one repo, and never enters the
+     * sandbox.
+     */
+    async pushAndCreatePr(conversationId, request) {
+        const ref = parseGithubConversationId(conversationId);
+        const dir = this.repoDir(conversationId);
+        if (!existsSync(dir)) {
+            throw new Error("This conversation has no ./repo clone to push from.");
+        }
+        if (!GITHUB_PUSH_BRANCH_PATTERN.test(request.branch)) {
+            throw new Error(`Branch '${request.branch}' is not pushable: name it pi/<something> (e.g. pi/fix-${ref.number}).`);
+        }
+        const repository = await githubRetry(() => this.client.getRepository(ref.owner, ref.repo));
+        const base = request.base ?? repository.default_branch;
+        const token = await this.client.createScopedInstallationToken(ref.repo, {
+            contents: "write",
+            pull_requests: "write",
+        });
+        await pushBranch({ dir, branch: request.branch, token });
+        try {
+            const pr = await githubRetry(() => this.client.createPullRequest(ref.owner, ref.repo, {
+                title: request.title,
+                head: request.branch,
+                base,
+                body: request.body,
+                draft: request.draft,
+            }));
+            log.logInfo(`[${conversationId}] Opened PR #${pr.number}: ${pr.html_url}`);
+            return { number: pr.number, url: pr.html_url };
+        }
+        catch (err) {
+            // Idempotency: pushing more commits to a branch that already has an
+            // open PR updates that PR; the create call then 422s. Surface the
+            // existing PR instead of failing the fix-CI-push-again loop.
+            if (err instanceof GithubApiError &&
+                err.status === 422 &&
+                /already exists/i.test(err.message)) {
+                const existing = await this.client.findOpenPullRequestByBranch(ref.owner, ref.repo, request.branch);
+                if (existing) {
+                    log.logInfo(`[${conversationId}] Pushed to existing PR #${existing.number}: ${existing.html_url}`);
+                    return { number: existing.number, url: existing.html_url, updatedExisting: true };
+                }
+            }
+            throw err;
+        }
+    }
+    /**
+     * Backs the `github_checks` tool: CI check runs for a branch the agent
+     * pushed, or for the conversation's PR head when no branch is given.
+     */
+    async getChecks(conversationId, branch) {
+        const ref = parseGithubConversationId(conversationId);
+        let target = branch;
+        if (!target) {
+            let pr;
+            try {
+                pr = await githubRetry(() => this.client.getPullRequest(ref.owner, ref.repo, ref.number));
+            }
+            catch {
+                pr = null;
+            }
+            if (!pr?.head) {
+                throw new Error("This conversation is not a pull request — pass the branch whose checks you want.");
+            }
+            target = pr.head.sha;
+        }
+        const runs = await githubRetry(() => this.client.listCheckRuns(ref.owner, ref.repo, target));
+        return runs.map((run) => {
+            const externalId = run.external_id?.trim() || null;
+            let buildLogAvailable = false;
+            // Cloud Build runs carry their build UUID in external_id and the GCP
+            // project in details_url. Remember project-by-build so getBuildLog only
+            // serves builds the agent actually saw on this repo's checks.
+            if (this.config.cloudBuild &&
+                run.app?.slug === CLOUD_BUILD_APP_SLUG &&
+                externalId &&
+                isCloudBuildId(externalId)) {
+                const project = projectFromDetailsUrl(run.details_url) ?? this.config.cloudBuild.projectFallback;
+                if (project) {
+                    this.rememberBuild(externalId, project);
+                    buildLogAvailable = true;
+                }
+            }
+            return {
+                id: run.id,
+                name: run.name,
+                status: run.status,
+                conclusion: run.conclusion,
+                url: run.html_url,
+                appSlug: run.app?.slug ?? null,
+                outputSummary: run.output?.summary?.trim() ? run.output.summary.slice(0, 500) : null,
+                externalId,
+                buildLogAvailable,
+            };
+        });
+    }
+    rememberBuild(buildId, project) {
+        // Insertion-ordered Map as a small LRU: re-insert on touch, prune oldest.
+        this.buildRef.delete(buildId);
+        this.buildRef.set(buildId, { project });
+        if (this.buildRef.size > 200) {
+            const oldest = this.buildRef.keys().next().value;
+            if (oldest !== undefined)
+                this.buildRef.delete(oldest);
+        }
+    }
+    /**
+     * Backs the Cloud Build log mode of `github_checks`. GCP credentials stay
+     * host-side (ADC via GOOGLE_APPLICATION_CREDENTIALS — e.g. a Workload
+     * Identity Federation external_account file); the build must have appeared
+     * in a github_checks summary first, which is also where its project is
+     * learned. Unreadable logs degrade to the console url, never a dead end.
+     */
+    async getBuildLog(conversationId, buildId) {
+        if (!this.config.cloudBuild) {
+            throw new Error("Cloud Build log access is not configured on this host (no GCP credentials).");
+        }
+        const known = this.buildRef.get(buildId);
+        if (!known) {
+            throw new Error(`Unknown build id ${buildId}: run github_checks first and take a [build …] id from ` +
+                `the summary.`);
+        }
+        let logText;
+        try {
+            logText = await fetchCloudBuildLog({
+                tokenProvider: this.config.cloudBuild.tokenProvider,
+                project: known.project,
+                buildId,
+            });
+        }
+        catch (err) {
+            if (err instanceof CloudBuildLogUnavailableError) {
+                throw new Error(`${err.message}${err.consoleUrl ? ` Console: ${err.consoleUrl}` : ""} Use the check's ` +
+                    `summary/url from github_checks, or reproduce the failure locally in ./repo.`, { cause: err });
+            }
+            throw err;
+        }
+        return truncateLogTail(logText);
+    }
+    /**
+     * Backs the `github_sync` tool: refresh the conversation's ./repo clone
+     * from origin with an ephemeral read token. Fetch-only when moving the
+     * checkout could lose agent work; the formatted report tells the agent
+     * what happened and what to do next.
+     */
+    async syncRepo(conversationId, branch) {
+        const ref = parseGithubConversationId(conversationId);
+        const dir = this.repoDir(conversationId);
+        if (!existsSync(dir)) {
+            throw new Error("This conversation has no ./repo clone to sync.");
+        }
+        const token = await this.client.createScopedInstallationToken(ref.repo, {
+            contents: "read",
+        });
+        let prNumber;
+        let prHeadBranch;
+        let defaultBranch;
+        if (!branch) {
+            if (await fetchIsPr(this.client, ref)) {
+                prNumber = ref.number;
+                prHeadBranch = await fetchPrHeadBranch(this.client, ref);
+            }
+            else {
+                const repository = await githubRetry(() => this.client.getRepository(ref.owner, ref.repo));
+                defaultBranch = repository.default_branch;
+            }
+        }
+        const result = await syncRepo({ dir, token, branch, prNumber, prHeadBranch, defaultBranch });
+        if (result.updatedCheckout) {
+            return `Updated ./repo: branch ${result.target} is now at ${result.fetchedSha.slice(0, 12)}.`;
+        }
+        const reasons = [];
+        if (result.currentBranch !== result.target) {
+            reasons.push(`the checkout is on '${result.currentBranch}', not '${result.target}'`);
+        }
+        if (result.dirty) {
+            reasons.push("the working tree has uncommitted changes");
+        }
+        if (result.localCommits > 0) {
+            reasons.push(`'${result.target}' has ${result.localCommits} local commit(s) not on origin`);
+        }
+        return (`Fetched ${result.target} to FETCH_HEAD (${result.fetchedSha.slice(0, 12)}) but left the ` +
+            `checkout alone: ${reasons.join("; ")}. Merge or rebase FETCH_HEAD yourself ` +
+            `(e.g. git merge FETCH_HEAD), or commit your work to a pi/* branch first.`);
+    }
+    /**
+     * Backs the `github_read` tool: PR/issue metadata the ./repo clone cannot
+     * provide (diff stats, review state, other issues in the repo). Owner/repo
+     * always come from the conversation id, so reads never leave this repo.
+     */
+    async readGithub(conversationId, request) {
+        const ref = parseGithubConversationId(conversationId);
+        const number = request.number ?? ref.number;
+        switch (request.action) {
+            case "pr": {
+                const pr = await githubRetry(() => this.client.getPullRequest(ref.owner, ref.repo, number));
+                return { kind: "pr", pr };
+            }
+            case "pr_files": {
+                const files = await githubRetry(() => this.client.listPullRequestFiles(ref.owner, ref.repo, number));
+                return { kind: "pr_files", files };
+            }
+            case "pr_reviews": {
+                const [reviews, threads] = await Promise.all([
+                    githubRetry(() => this.client.listPullRequestReviews(ref.owner, ref.repo, number)),
+                    githubRetry(() => this.client.listPullReviewComments(ref.owner, ref.repo, number)),
+                ]);
+                return { kind: "pr_reviews", reviews, threads };
+            }
+            case "issue": {
+                const issue = await githubRetry(() => this.client.getIssue(ref.owner, ref.repo, number));
+                return { kind: "issue", issue };
+            }
+            case "comments": {
+                const comments = await githubRetry(() => this.client.listIssueComments(ref.owner, ref.repo, number));
+                return { kind: "comments", comments };
+            }
+            case "list": {
+                const issues = await githubRetry(() => this.client.listIssues(ref.owner, ref.repo, {
+                    state: request.state,
+                    labels: request.labels,
+                    creator: request.creator,
+                }));
+                return { kind: "list", issues };
+            }
+            default:
+                throw new Error(`Unknown github_read action: ${String(request.action)}`);
+        }
+    }
+    /**
+     * Backs the `github_issue` tool: labels, assignees, and open/closed state
+     * on any issue of this conversation's repo (triage). Same-repo by
+     * construction — owner/repo come from the conversation id; the action enum
+     * is closed, so lock/delete/transfer cannot be expressed at all.
+     */
+    async manageIssue(conversationId, request) {
+        const ref = parseGithubConversationId(conversationId);
+        const number = request.number ?? ref.number;
+        try {
+            switch (request.action) {
+                case "add_labels": {
+                    if (!request.labels?.length) {
+                        throw new Error("add_labels requires a non-empty labels array.");
+                    }
+                    await githubRetry(() => this.client.addIssueLabels(ref.owner, ref.repo, number, request.labels));
+                    return `Added label(s) ${request.labels.join(", ")} to #${number}.`;
+                }
+                case "remove_label": {
+                    if (!request.label) {
+                        throw new Error("remove_label requires a label name.");
+                    }
+                    await githubRetry(() => this.client.removeIssueLabel(ref.owner, ref.repo, number, request.label));
+                    return `Removed label ${request.label} from #${number}.`;
+                }
+                case "add_assignees": {
+                    if (!request.assignees?.length) {
+                        throw new Error("add_assignees requires a non-empty assignees array.");
+                    }
+                    await githubRetry(() => this.client.addIssueAssignees(ref.owner, ref.repo, number, request.assignees));
+                    return `Assigned ${request.assignees.map((login) => `@${login}`).join(", ")} to #${number}.`;
+                }
+                case "remove_assignees": {
+                    if (!request.assignees?.length) {
+                        throw new Error("remove_assignees requires a non-empty assignees array.");
+                    }
+                    await githubRetry(() => this.client.removeIssueAssignees(ref.owner, ref.repo, number, request.assignees));
+                    return `Unassigned ${request.assignees.map((login) => `@${login}`).join(", ")} from #${number}.`;
+                }
+                case "close": {
+                    await githubRetry(() => this.client.updateIssueState(ref.owner, ref.repo, number, "closed", request.state_reason));
+                    return `Closed #${number}${request.state_reason ? ` as ${request.state_reason}` : ""}.`;
+                }
+                case "reopen": {
+                    await githubRetry(() => this.client.updateIssueState(ref.owner, ref.repo, number, "open"));
+                    return `Reopened #${number}.`;
+                }
+                default:
+                    throw new Error(`Unknown github_issue action: ${String(request.action)}`);
+            }
+        }
+        catch (err) {
+            if (err instanceof GithubApiError && err.status === 404) {
+                throw new Error(`Issue #${number} not found in ${ref.owner}/${ref.repo}.`, { cause: err });
+            }
+            throw err;
+        }
+    }
+    /**
+     * Backs the `github_review_reply` tool: answer inside one inline review
+     * thread of this conversation's PR. The comment id comes from an
+     * `[PR review comment rc-<id> …]` message; GitHub validates it belongs to
+     * this PR (404 otherwise, translated into agent-actionable guidance).
+     */
+    async replyToReviewThread(conversationId, commentId, body) {
+        if (!Number.isInteger(commentId) || commentId <= 0) {
+            throw new Error("comment_id must be the numeric id from an [PR review comment rc-<id> …] message.");
+        }
+        const ref = parseGithubConversationId(conversationId);
+        const text = body.length > GITHUB_MAX_COMMENT_LENGTH
+            ? `${body.slice(0, GITHUB_MAX_COMMENT_LENGTH)}\n…(truncated)`
+            : body;
+        try {
+            const reply = await githubRetry(() => this.client.replyToReviewComment(ref.owner, ref.repo, ref.number, commentId, text));
+            return {
+                url: `https://github.com/${ref.owner}/${ref.repo}/pull/${ref.number}#discussion_r${reply.id}`,
+            };
+        }
+        catch (err) {
+            if (err instanceof GithubApiError && err.status === 404) {
+                throw new Error(`Comment ${commentId} is not a review comment on this PR. Take the id from an ` +
+                    `[PR review comment rc-<id> …] message in this conversation; do not guess ids.`, { cause: err });
+            }
+            throw err;
+        }
+    }
+    /**
+     * Backs the log mode of `github_checks`: the tail of one CI job's log so
+     * the agent can diagnose a failing check without sandbox credentials. Only
+     * GitHub Actions checks have logs on GitHub — external CI apps (e.g. Cloud
+     * Build) keep theirs on their own service, so a 404 here is translated
+     * into guidance instead of a dead end.
+     */
+    async getJobLog(conversationId, jobId) {
+        if (!Number.isInteger(jobId) || jobId <= 0) {
+            throw new Error("job_id must be a positive Actions job id taken from a [job …] entry in the github_checks summary.");
+        }
+        const ref = parseGithubConversationId(conversationId);
+        let logText;
+        try {
+            logText = await githubRetry(() => this.client.getJobLog(ref.owner, ref.repo, jobId));
+        }
+        catch (err) {
+            if (err instanceof GithubApiError && err.status === 404) {
+                throw new Error(`No GitHub Actions log for job ${jobId}. Logs are only available for checks reported ` +
+                    `by github-actions; external CI (e.g. Cloud Build) keeps logs on its own service — ` +
+                    `use that check's summary/url from github_checks, or reproduce the failure locally ` +
+                    `in ./repo instead. Do not retry with other ids.`, { cause: err });
+            }
+            throw err;
+        }
+        return truncateLogTail(logText);
+    }
+}
+//# sourceMappingURL=github-ops.js.map

package/dist/adapters/github/github-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-ops.js","sourceRoot":"","sources":["../../../src/adapters/github/github-ops.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,cAAc,EAAgB,yBAAyB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACnG,OAAO,EACL,oBAAoB,EACpB,6BAA6B,EAC7B,kBAAkB,EAClB,cAAc,EACd,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAalG,+DAA+D;AAC/D,MAAM,aAAa,GAAG,KAAK,CAAC;AAE5B,SAAS,eAAe,CAAC,OAAe;IACtC,OAAO,OAAO,CAAC,MAAM,GAAG,aAAa;QACnC,CAAC,CAAC,2BAA2B,aAAa,YAAY,OAAO,CAAC,KAAK,CAAC,CAAC,aAAa,CAAC,EAAE;QACrF,CAAC,CAAC,OAAO,CAAC;AACd,CAAC;AAED;iEACiE;AACjE,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAAoB,EACpB,GAA0B;IAE1B,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QACxF,OAAO,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAoB,EACpB,GAA0B;IAE1B,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3F,MAAM,QAAQ,GACZ,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,GAAG,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACvF,OAAO,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,OAAO,SAAS;IAIpB,YACmB,MAAoB,EACpB,MAGhB;QAJgB,WAAM,GAAN,MAAM,CAAc;QACpB,WAAM,GAAN,MAAM,CAGtB;QARH,uEAAuE;QAC/D,aAAQ,GAAG,IAAI,GAAG,EAA+B,CAAC;IAQvD,CAAC;IAEI,OAAO,CAAC,cAAsB;QACpC,OAAO,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IACrE,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,eAAe,CAAC,cAAsB,EAAE,OAAwB;QACpE,MAAM,GAAG,GAAG,yBAAyB,CAAC,cAAc,CAAC,CAAC;QACtD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACzC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;QACD,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CACb,WAAW,OAAO,CAAC,MAAM,0DAA0D,GAAG,CAAC,MAAM,IAAI,CAClG,CAAC;QACJ,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3F,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,UAAU,CAAC,cAAc,CAAC;QACvD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,6BAA6B,CAAC,GAAG,CAAC,IAAI,EAAE;YACtE,QAAQ,EAAE,OAAO;YACjB,aAAa,EAAE,OAAO;SACvB,CAAC,CAAC;QACH,MAAM,UAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,CAChC,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE;gBACjD,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,IAAI,EAAE,OAAO,CAAC,MAAM;gBACpB,IAAI;gBACJ,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,KAAK,EAAE,OAAO,CAAC,KAAK;aACrB,CAAC,CACH,CAAC;YACF,GAAG,CAAC,OAAO,CAAC,IAAI,cAAc,gBAAgB,EAAE,CAAC,MAAM,KAAK,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC3E,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC;QACjD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,oEAAoE;YACpE,kEAAkE;YAClE,6DAA6D;YAC7D,IACE,GAAG,YAAY,cAAc;gBAC7B,GAAG,CAAC,MAAM,KAAK,GAAG;gBAClB,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EACnC,CAAC;gBACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,2BAA2B,CAC5D,GAAG,CAAC,KAAK,EACT,GAAG,CAAC,IAAI,EACR,OAAO,CAAC,MAAM,CACf,CAAC;gBACF,IAAI,QAAQ,EAAE,CAAC;oBACb,GAAG,CAAC,OAAO,CACT,IAAI,cAAc,4BAA4B,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,QAAQ,EAAE,CACtF,CAAC;oBACF,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC;gBACpF,CAAC;YACH,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS,CAAC,cAAsB,EAAE,MAAe;QACrD,MAAM,GAAG,GAAG,yBAAyB,CAAC,cAAc,CAAC,CAAC;QACtD,IAAI,MAAM,GAAG,MAAM,CAAC;QACpB,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,EAAE,CAAC;YACP,IAAI,CAAC;gBACH,EAAE,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;YAC5F,CAAC;YAAC,MAAM,CAAC;gBACP,EAAE,GAAG,IAAI,CAAC;YACZ,CAAC;YACD,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CACb,kFAAkF,CACnF,CAAC;YACJ,CAAC;YACD,MAAM,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC;QACvB,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QAC7F,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YACtB,MAAM,UAAU,GAAG,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC;YACnD,IAAI,iBAAiB,GAAG,KAAK,CAAC;YAC9B,qEAAqE;YACrE,wEAAwE;YACxE,8DAA8D;YAC9D,IACE,IAAI,CAAC,MAAM,CAAC,UAAU;gBACtB,GAAG,CAAC,GAAG,EAAE,IAAI,KAAK,oBAAoB;gBACtC,UAAU;gBACV,cAAc,CAAC,UAAU,CAAC,EAC1B,CAAC;gBACD,MAAM,OAAO,GACX,qBAAqB,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,eAAe,CAAC;gBACnF,IAAI,OAAO,EAAE,CAAC;oBACZ,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;oBACxC,iBAAiB,GAAG,IAAI,CAAC;gBAC3B,CAAC;YACH,CAAC;YACD,OAAO;gBACL,EAAE,EAAE,GAAG,CAAC,EAAE;gBACV,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,GAAG,EAAE,GAAG,CAAC,QAAQ;gBACjB,OAAO,EAAE,GAAG,CAAC,GAAG,EAAE,IAAI,IAAI,IAAI;gBAC9B,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI;gBACpF,UAAU;gBACV,iBAAiB;aAClB,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,aAAa,CAAC,OAAe,EAAE,OAAe;QACpD,0EAA0E;QAC1E,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC9B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACxC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,GAAG,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YACjD,IAAI,MAAM,KAAK,SAAS;gBAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,WAAW,CAAC,cAAsB,EAAE,OAAe;QACvD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CACb,6EAA6E,CAC9E,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,oBAAoB,OAAO,yDAAyD;gBAClF,cAAc,CACjB,CAAC;QACJ,CAAC;QACD,IAAI,OAAe,CAAC;QACpB,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,kBAAkB,CAAC;gBACjC,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,aAAa;gBACnD,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,OAAO;aACR,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,6BAA6B,EAAE,CAAC;gBACjD,MAAM,IAAI,KAAK,CACb,GAAG,GAAG,CAAC,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,mBAAmB;oBACrF,6EAA6E,EAC/E,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAC;YACJ,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,cAAsB,EAAE,MAAe;QACpD,MAAM,GAAG,GAAG,yBAAyB,CAAC,cAAc,CAAC,CAAC;QACtD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACzC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpE,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,6BAA6B,CAAC,GAAG,CAAC,IAAI,EAAE;YACtE,QAAQ,EAAE,MAAM;SACjB,CAAC,CAAC;QACH,IAAI,QAA4B,CAAC;QACjC,IAAI,YAAgC,CAAC;QACrC,IAAI,aAAiC,CAAC;QACtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;gBACtC,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC;gBACtB,YAAY,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YAC3D,CAAC;iBAAM,CAAC;gBACN,MAAM,UAAU,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC3F,aAAa,GAAG,UAAU,CAAC,cAAc,CAAC;YAC5C,CAAC;QACH,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC,CAAC;QAE7F,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;YAC3B,OAAO,0BAA0B,MAAM,CAAC,MAAM,cAAc,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC;QAChG,CAAC;QACD,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,aAAa,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC;YAC3C,OAAO,CAAC,IAAI,CAAC,uBAAuB,MAAM,CAAC,aAAa,WAAW,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QACvF,CAAC;QACD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,OAAO,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,MAAM,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,SAAS,MAAM,CAAC,YAAY,gCAAgC,CAAC,CAAC;QAC9F,CAAC;QACD,OAAO,CACL,WAAW,MAAM,CAAC,MAAM,mBAAmB,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB;YAC1F,mBAAmB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,wCAAwC;YAC7E,0EAA0E,CAC3E,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,cAAsB,EAAE,OAA0B;QACjE,MAAM,GAAG,GAAG,yBAAyB,CAAC,cAAc,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC;QAC5C,QAAQ,OAAO,CAAC,MAAM,EAAE,CAAC;YACvB,KAAK,IAAI,EAAE,CAAC;gBACV,MAAM,EAAE,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;gBAC5F,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;YAC5B,CAAC;YACD,KAAK,UAAU,EAAE,CAAC;gBAChB,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,CACnC,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAC9D,CAAC;gBACF,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;YACrC,CAAC;YACD,KAAK,YAAY,EAAE,CAAC;gBAClB,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;oBAC3C,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,sBAAsB,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;oBAClF,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,sBAAsB,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;iBACnF,CAAC,CAAC;gBACH,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;YAClD,CAAC;YACD,KAAK,OAAO,EAAE,CAAC;gBACb,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;gBACzF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YAClC,CAAC;YACD,KAAK,UAAU,EAAE,CAAC;gBAChB,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,CACtC,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAC3D,CAAC;gBACF,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;YACxC,CAAC;YACD,KAAK,MAAM,EAAE,CAAC;gBACZ,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,CACpC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE;oBAC1C,KAAK,EAAE,OAAO,CAAC,KAAK;oBACpB,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,OAAO,EAAE,OAAO,CAAC,OAAO;iBACzB,CAAC,CACH,CAAC;gBACF,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;YAClC,CAAC;YACD;gBACE,MAAM,IAAI,KAAK,CAAC,+BAA+B,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,WAAW,CAAC,cAAsB,EAAE,OAA2B;QACnE,MAAM,GAAG,GAAG,yBAAyB,CAAC,cAAc,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC;QAC5C,IAAI,CAAC;YACH,QAAQ,OAAO,CAAC,MAAM,EAAE,CAAC;gBACvB,KAAK,YAAY,EAAE,CAAC;oBAClB,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;wBAC5B,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;oBACnE,CAAC;oBACD,MAAM,WAAW,CAAC,GAAG,EAAE,CACrB,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAO,CAAC,CACzE,CAAC;oBACF,OAAO,kBAAkB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,MAAM,GAAG,CAAC;gBACtE,CAAC;gBACD,KAAK,cAAc,EAAE,CAAC;oBACpB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;wBACnB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;oBACzD,CAAC;oBACD,MAAM,WAAW,CAAC,GAAG,EAAE,CACrB,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,KAAM,CAAC,CAC1E,CAAC;oBACF,OAAO,iBAAiB,OAAO,CAAC,KAAK,UAAU,MAAM,GAAG,CAAC;gBAC3D,CAAC;gBACD,KAAK,eAAe,EAAE,CAAC;oBACrB,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;wBAC/B,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;oBACzE,CAAC;oBACD,MAAM,WAAW,CAAC,GAAG,EAAE,CACrB,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,SAAU,CAAC,CAC/E,CAAC;oBACF,OAAO,YAAY,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,MAAM,GAAG,CAAC;gBAC/F,CAAC;gBACD,KAAK,kBAAkB,EAAE,CAAC;oBACxB,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;wBAC/B,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;oBAC5E,CAAC;oBACD,MAAM,WAAW,CAAC,GAAG,EAAE,CACrB,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,SAAU,CAAC,CAClF,CAAC;oBACF,OAAO,cAAc,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,MAAM,GAAG,CAAC;gBACnG,CAAC;gBACD,KAAK,OAAO,EAAE,CAAC;oBACb,MAAM,WAAW,CAAC,GAAG,EAAE,CACrB,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAC1B,GAAG,CAAC,KAAK,EACT,GAAG,CAAC,IAAI,EACR,MAAM,EACN,QAAQ,EACR,OAAO,CAAC,YAAY,CACrB,CACF,CAAC;oBACF,OAAO,WAAW,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;gBAC1F,CAAC;gBACD,KAAK,QAAQ,EAAE,CAAC;oBACd,MAAM,WAAW,CAAC,GAAG,EAAE,CACrB,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAClE,CAAC;oBACF,OAAO,aAAa,MAAM,GAAG,CAAC;gBAChC,CAAC;gBACD;oBACE,MAAM,IAAI,KAAK,CAAC,gCAAgC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC9E,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,cAAc,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBACxD,MAAM,IAAI,KAAK,CAAC,UAAU,MAAM,iBAAiB,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,IAAI,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YAC7F,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,mBAAmB,CACvB,cAAsB,EACtB,SAAiB,EACjB,IAAY;QAEZ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,KAAK,CACb,kFAAkF,CACnF,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,GAAG,yBAAyB,CAAC,cAAc,CAAC,CAAC;QACtD,MAAM,IAAI,GACR,IAAI,CAAC,MAAM,GAAG,yBAAyB;YACrC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,yBAAyB,CAAC,gBAAgB;YAC7D,CAAC,CAAC,IAAI,CAAC;QACX,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,CACnC,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,CACnF,CAAC;YACF,OAAO;gBACL,GAAG,EAAE,sBAAsB,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,IAAI,SAAS,GAAG,CAAC,MAAM,gBAAgB,KAAK,CAAC,EAAE,EAAE;aAC9F,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,cAAc,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBACxD,MAAM,IAAI,KAAK,CACb,WAAW,SAAS,2DAA2D;oBAC7E,+EAA+E,EACjF,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAC;YACJ,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,SAAS,CAAC,cAAsB,EAAE,KAAa;QACnD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CACb,mGAAmG,CACpG,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,GAAG,yBAAyB,CAAC,cAAc,CAAC,CAAC;QACtD,IAAI,OAAe,CAAC;QACpB,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QACvF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,cAAc,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBACxD,MAAM,IAAI,KAAK,CACb,iCAAiC,KAAK,gDAAgD;oBACpF,oFAAoF;oBACpF,oFAAoF;oBACpF,iDAAiD,EACnD,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAC;YACJ,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;CACF","sourcesContent":["import { existsSync } from \"fs\";\nimport * as log from \"../../log.js\";\nimport { GithubApiError, GithubClient, GITHUB_MAX_COMMENT_LENGTH, githubRetry } from \"./client.js\";\nimport {\n  CLOUD_BUILD_APP_SLUG,\n  CloudBuildLogUnavailableError,\n  fetchCloudBuildLog,\n  isCloudBuildId,\n  projectFromDetailsUrl,\n} from \"./cloudbuild.js\";\nimport { parseGithubConversationId } from \"./ids.js\";\nimport { conversationRepoDir, GITHUB_PUSH_BRANCH_PATTERN, pushBranch, syncRepo } from \"./repo.js\";\nimport type {\n  GithubBotConfig,\n  GithubCheckSummary,\n  GithubConversationRef,\n  GithubIssueRequest,\n  GithubPrRequest,\n  GithubPrResult,\n  GithubReadRequest,\n  GithubReadResult,\n  PlatformGithubOps,\n} from \"./types.js\";\n\n/** Both CI log modes tail-truncate to this many characters. */\nconst MAX_LOG_CHARS = 20000;\n\nfunction truncateLogTail(logText: string): string {\n  return logText.length > MAX_LOG_CHARS\n    ? `…(truncated to the last ${MAX_LOG_CHARS} chars)\\n${logText.slice(-MAX_LOG_CHARS)}`\n    : logText;\n}\n\n/** Whether the conversation's issue is a PR, for callers where the triggering\n *  item didn't carry that knowledge. Errs toward plain issue. */\nexport async function fetchIsPr(\n  client: GithubClient,\n  ref: GithubConversationRef,\n): Promise<boolean> {\n  try {\n    const issue = await githubRetry(() => client.getIssue(ref.owner, ref.repo, ref.number));\n    return Boolean(issue.pull_request);\n  } catch {\n    return false;\n  }\n}\n\n/**\n * The PR's head branch name when it lives in this repo — that is the name\n * the local checkout should carry, so committing on it and calling\n * github_pr pushes back to the PR itself instead of opening a new one.\n * Fork heads (unpushable with the repo-scoped token) and failed lookups\n * return undefined; callers then fall back to the synthetic pr-<n>.\n */\nexport async function fetchPrHeadBranch(\n  client: GithubClient,\n  ref: GithubConversationRef,\n): Promise<string | undefined> {\n  try {\n    const pr = await githubRetry(() => client.getPullRequest(ref.owner, ref.repo, ref.number));\n    const sameRepo =\n      pr.head?.repo?.full_name?.toLowerCase() === `${ref.owner}/${ref.repo}`.toLowerCase();\n    return sameRepo ? pr.head?.ref : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Host-side backend of the github_* tool pack (`PlatformGithubOps`),\n * standalone from the messaging bot: it needs the API client, the\n * conversation working dir, and optional Cloud Build access — not the poll\n * loop, queues, or trigger gate. Tokens are minted per call, scoped to the\n * conversation's repo, and never enter the sandbox.\n */\nexport class GithubOps implements PlatformGithubOps {\n  /** Cloud Build ids seen in getChecks summaries → their GCP project. */\n  private buildRef = new Map<string, { project: string }>();\n\n  constructor(\n    private readonly client: GithubClient,\n    private readonly config: {\n      workingDir: string;\n      cloudBuild?: GithubBotConfig[\"cloudBuild\"];\n    },\n  ) {}\n\n  private repoDir(conversationId: string): string {\n    return conversationRepoDir(this.config.workingDir, conversationId);\n  }\n\n  /**\n   * Backs the `github_pr` tool: push a `pi/*` branch the agent prepared in\n   * the conversation's clone, then open a pull request as the App. The write\n   * token is minted per call, scoped to this one repo, and never enters the\n   * sandbox.\n   */\n  async pushAndCreatePr(conversationId: string, request: GithubPrRequest): Promise<GithubPrResult> {\n    const ref = parseGithubConversationId(conversationId);\n    const dir = this.repoDir(conversationId);\n    if (!existsSync(dir)) {\n      throw new Error(\"This conversation has no ./repo clone to push from.\");\n    }\n    if (!GITHUB_PUSH_BRANCH_PATTERN.test(request.branch)) {\n      throw new Error(\n        `Branch '${request.branch}' is not pushable: name it pi/<something> (e.g. pi/fix-${ref.number}).`,\n      );\n    }\n    const repository = await githubRetry(() => this.client.getRepository(ref.owner, ref.repo));\n    const base = request.base ?? repository.default_branch;\n    const token = await this.client.createScopedInstallationToken(ref.repo, {\n      contents: \"write\",\n      pull_requests: \"write\",\n    });\n    await pushBranch({ dir, branch: request.branch, token });\n    try {\n      const pr = await githubRetry(() =>\n        this.client.createPullRequest(ref.owner, ref.repo, {\n          title: request.title,\n          head: request.branch,\n          base,\n          body: request.body,\n          draft: request.draft,\n        }),\n      );\n      log.logInfo(`[${conversationId}] Opened PR #${pr.number}: ${pr.html_url}`);\n      return { number: pr.number, url: pr.html_url };\n    } catch (err) {\n      // Idempotency: pushing more commits to a branch that already has an\n      // open PR updates that PR; the create call then 422s. Surface the\n      // existing PR instead of failing the fix-CI-push-again loop.\n      if (\n        err instanceof GithubApiError &&\n        err.status === 422 &&\n        /already exists/i.test(err.message)\n      ) {\n        const existing = await this.client.findOpenPullRequestByBranch(\n          ref.owner,\n          ref.repo,\n          request.branch,\n        );\n        if (existing) {\n          log.logInfo(\n            `[${conversationId}] Pushed to existing PR #${existing.number}: ${existing.html_url}`,\n          );\n          return { number: existing.number, url: existing.html_url, updatedExisting: true };\n        }\n      }\n      throw err;\n    }\n  }\n\n  /**\n   * Backs the `github_checks` tool: CI check runs for a branch the agent\n   * pushed, or for the conversation's PR head when no branch is given.\n   */\n  async getChecks(conversationId: string, branch?: string): Promise<GithubCheckSummary[]> {\n    const ref = parseGithubConversationId(conversationId);\n    let target = branch;\n    if (!target) {\n      let pr;\n      try {\n        pr = await githubRetry(() => this.client.getPullRequest(ref.owner, ref.repo, ref.number));\n      } catch {\n        pr = null;\n      }\n      if (!pr?.head) {\n        throw new Error(\n          \"This conversation is not a pull request — pass the branch whose checks you want.\",\n        );\n      }\n      target = pr.head.sha;\n    }\n    const runs = await githubRetry(() => this.client.listCheckRuns(ref.owner, ref.repo, target));\n    return runs.map((run) => {\n      const externalId = run.external_id?.trim() || null;\n      let buildLogAvailable = false;\n      // Cloud Build runs carry their build UUID in external_id and the GCP\n      // project in details_url. Remember project-by-build so getBuildLog only\n      // serves builds the agent actually saw on this repo's checks.\n      if (\n        this.config.cloudBuild &&\n        run.app?.slug === CLOUD_BUILD_APP_SLUG &&\n        externalId &&\n        isCloudBuildId(externalId)\n      ) {\n        const project =\n          projectFromDetailsUrl(run.details_url) ?? this.config.cloudBuild.projectFallback;\n        if (project) {\n          this.rememberBuild(externalId, project);\n          buildLogAvailable = true;\n        }\n      }\n      return {\n        id: run.id,\n        name: run.name,\n        status: run.status,\n        conclusion: run.conclusion,\n        url: run.html_url,\n        appSlug: run.app?.slug ?? null,\n        outputSummary: run.output?.summary?.trim() ? run.output.summary.slice(0, 500) : null,\n        externalId,\n        buildLogAvailable,\n      };\n    });\n  }\n\n  private rememberBuild(buildId: string, project: string): void {\n    // Insertion-ordered Map as a small LRU: re-insert on touch, prune oldest.\n    this.buildRef.delete(buildId);\n    this.buildRef.set(buildId, { project });\n    if (this.buildRef.size > 200) {\n      const oldest = this.buildRef.keys().next().value;\n      if (oldest !== undefined) this.buildRef.delete(oldest);\n    }\n  }\n\n  /**\n   * Backs the Cloud Build log mode of `github_checks`. GCP credentials stay\n   * host-side (ADC via GOOGLE_APPLICATION_CREDENTIALS — e.g. a Workload\n   * Identity Federation external_account file); the build must have appeared\n   * in a github_checks summary first, which is also where its project is\n   * learned. Unreadable logs degrade to the console url, never a dead end.\n   */\n  async getBuildLog(conversationId: string, buildId: string): Promise<string> {\n    if (!this.config.cloudBuild) {\n      throw new Error(\n        \"Cloud Build log access is not configured on this host (no GCP credentials).\",\n      );\n    }\n    const known = this.buildRef.get(buildId);\n    if (!known) {\n      throw new Error(\n        `Unknown build id ${buildId}: run github_checks first and take a [build …] id from ` +\n          `the summary.`,\n      );\n    }\n    let logText: string;\n    try {\n      logText = await fetchCloudBuildLog({\n        tokenProvider: this.config.cloudBuild.tokenProvider,\n        project: known.project,\n        buildId,\n      });\n    } catch (err) {\n      if (err instanceof CloudBuildLogUnavailableError) {\n        throw new Error(\n          `${err.message}${err.consoleUrl ? ` Console: ${err.consoleUrl}` : \"\"} Use the check's ` +\n            `summary/url from github_checks, or reproduce the failure locally in ./repo.`,\n          { cause: err },\n        );\n      }\n      throw err;\n    }\n    return truncateLogTail(logText);\n  }\n\n  /**\n   * Backs the `github_sync` tool: refresh the conversation's ./repo clone\n   * from origin with an ephemeral read token. Fetch-only when moving the\n   * checkout could lose agent work; the formatted report tells the agent\n   * what happened and what to do next.\n   */\n  async syncRepo(conversationId: string, branch?: string): Promise<string> {\n    const ref = parseGithubConversationId(conversationId);\n    const dir = this.repoDir(conversationId);\n    if (!existsSync(dir)) {\n      throw new Error(\"This conversation has no ./repo clone to sync.\");\n    }\n    const token = await this.client.createScopedInstallationToken(ref.repo, {\n      contents: \"read\",\n    });\n    let prNumber: number | undefined;\n    let prHeadBranch: string | undefined;\n    let defaultBranch: string | undefined;\n    if (!branch) {\n      if (await fetchIsPr(this.client, ref)) {\n        prNumber = ref.number;\n        prHeadBranch = await fetchPrHeadBranch(this.client, ref);\n      } else {\n        const repository = await githubRetry(() => this.client.getRepository(ref.owner, ref.repo));\n        defaultBranch = repository.default_branch;\n      }\n    }\n    const result = await syncRepo({ dir, token, branch, prNumber, prHeadBranch, defaultBranch });\n\n    if (result.updatedCheckout) {\n      return `Updated ./repo: branch ${result.target} is now at ${result.fetchedSha.slice(0, 12)}.`;\n    }\n    const reasons: string[] = [];\n    if (result.currentBranch !== result.target) {\n      reasons.push(`the checkout is on '${result.currentBranch}', not '${result.target}'`);\n    }\n    if (result.dirty) {\n      reasons.push(\"the working tree has uncommitted changes\");\n    }\n    if (result.localCommits > 0) {\n      reasons.push(`'${result.target}' has ${result.localCommits} local commit(s) not on origin`);\n    }\n    return (\n      `Fetched ${result.target} to FETCH_HEAD (${result.fetchedSha.slice(0, 12)}) but left the ` +\n      `checkout alone: ${reasons.join(\"; \")}. Merge or rebase FETCH_HEAD yourself ` +\n      `(e.g. git merge FETCH_HEAD), or commit your work to a pi/* branch first.`\n    );\n  }\n\n  /**\n   * Backs the `github_read` tool: PR/issue metadata the ./repo clone cannot\n   * provide (diff stats, review state, other issues in the repo). Owner/repo\n   * always come from the conversation id, so reads never leave this repo.\n   */\n  async readGithub(conversationId: string, request: GithubReadRequest): Promise<GithubReadResult> {\n    const ref = parseGithubConversationId(conversationId);\n    const number = request.number ?? ref.number;\n    switch (request.action) {\n      case \"pr\": {\n        const pr = await githubRetry(() => this.client.getPullRequest(ref.owner, ref.repo, number));\n        return { kind: \"pr\", pr };\n      }\n      case \"pr_files\": {\n        const files = await githubRetry(() =>\n          this.client.listPullRequestFiles(ref.owner, ref.repo, number),\n        );\n        return { kind: \"pr_files\", files };\n      }\n      case \"pr_reviews\": {\n        const [reviews, threads] = await Promise.all([\n          githubRetry(() => this.client.listPullRequestReviews(ref.owner, ref.repo, number)),\n          githubRetry(() => this.client.listPullReviewComments(ref.owner, ref.repo, number)),\n        ]);\n        return { kind: \"pr_reviews\", reviews, threads };\n      }\n      case \"issue\": {\n        const issue = await githubRetry(() => this.client.getIssue(ref.owner, ref.repo, number));\n        return { kind: \"issue\", issue };\n      }\n      case \"comments\": {\n        const comments = await githubRetry(() =>\n          this.client.listIssueComments(ref.owner, ref.repo, number),\n        );\n        return { kind: \"comments\", comments };\n      }\n      case \"list\": {\n        const issues = await githubRetry(() =>\n          this.client.listIssues(ref.owner, ref.repo, {\n            state: request.state,\n            labels: request.labels,\n            creator: request.creator,\n          }),\n        );\n        return { kind: \"list\", issues };\n      }\n      default:\n        throw new Error(`Unknown github_read action: ${String(request.action)}`);\n    }\n  }\n\n  /**\n   * Backs the `github_issue` tool: labels, assignees, and open/closed state\n   * on any issue of this conversation's repo (triage). Same-repo by\n   * construction — owner/repo come from the conversation id; the action enum\n   * is closed, so lock/delete/transfer cannot be expressed at all.\n   */\n  async manageIssue(conversationId: string, request: GithubIssueRequest): Promise<string> {\n    const ref = parseGithubConversationId(conversationId);\n    const number = request.number ?? ref.number;\n    try {\n      switch (request.action) {\n        case \"add_labels\": {\n          if (!request.labels?.length) {\n            throw new Error(\"add_labels requires a non-empty labels array.\");\n          }\n          await githubRetry(() =>\n            this.client.addIssueLabels(ref.owner, ref.repo, number, request.labels!),\n          );\n          return `Added label(s) ${request.labels.join(\", \")} to #${number}.`;\n        }\n        case \"remove_label\": {\n          if (!request.label) {\n            throw new Error(\"remove_label requires a label name.\");\n          }\n          await githubRetry(() =>\n            this.client.removeIssueLabel(ref.owner, ref.repo, number, request.label!),\n          );\n          return `Removed label ${request.label} from #${number}.`;\n        }\n        case \"add_assignees\": {\n          if (!request.assignees?.length) {\n            throw new Error(\"add_assignees requires a non-empty assignees array.\");\n          }\n          await githubRetry(() =>\n            this.client.addIssueAssignees(ref.owner, ref.repo, number, request.assignees!),\n          );\n          return `Assigned ${request.assignees.map((login) => `@${login}`).join(\", \")} to #${number}.`;\n        }\n        case \"remove_assignees\": {\n          if (!request.assignees?.length) {\n            throw new Error(\"remove_assignees requires a non-empty assignees array.\");\n          }\n          await githubRetry(() =>\n            this.client.removeIssueAssignees(ref.owner, ref.repo, number, request.assignees!),\n          );\n          return `Unassigned ${request.assignees.map((login) => `@${login}`).join(\", \")} from #${number}.`;\n        }\n        case \"close\": {\n          await githubRetry(() =>\n            this.client.updateIssueState(\n              ref.owner,\n              ref.repo,\n              number,\n              \"closed\",\n              request.state_reason,\n            ),\n          );\n          return `Closed #${number}${request.state_reason ? ` as ${request.state_reason}` : \"\"}.`;\n        }\n        case \"reopen\": {\n          await githubRetry(() =>\n            this.client.updateIssueState(ref.owner, ref.repo, number, \"open\"),\n          );\n          return `Reopened #${number}.`;\n        }\n        default:\n          throw new Error(`Unknown github_issue action: ${String(request.action)}`);\n      }\n    } catch (err) {\n      if (err instanceof GithubApiError && err.status === 404) {\n        throw new Error(`Issue #${number} not found in ${ref.owner}/${ref.repo}.`, { cause: err });\n      }\n      throw err;\n    }\n  }\n\n  /**\n   * Backs the `github_review_reply` tool: answer inside one inline review\n   * thread of this conversation's PR. The comment id comes from an\n   * `[PR review comment rc-<id> …]` message; GitHub validates it belongs to\n   * this PR (404 otherwise, translated into agent-actionable guidance).\n   */\n  async replyToReviewThread(\n    conversationId: string,\n    commentId: number,\n    body: string,\n  ): Promise<{ url: string }> {\n    if (!Number.isInteger(commentId) || commentId <= 0) {\n      throw new Error(\n        \"comment_id must be the numeric id from an [PR review comment rc-<id> …] message.\",\n      );\n    }\n    const ref = parseGithubConversationId(conversationId);\n    const text =\n      body.length > GITHUB_MAX_COMMENT_LENGTH\n        ? `${body.slice(0, GITHUB_MAX_COMMENT_LENGTH)}\\n…(truncated)`\n        : body;\n    try {\n      const reply = await githubRetry(() =>\n        this.client.replyToReviewComment(ref.owner, ref.repo, ref.number, commentId, text),\n      );\n      return {\n        url: `https://github.com/${ref.owner}/${ref.repo}/pull/${ref.number}#discussion_r${reply.id}`,\n      };\n    } catch (err) {\n      if (err instanceof GithubApiError && err.status === 404) {\n        throw new Error(\n          `Comment ${commentId} is not a review comment on this PR. Take the id from an ` +\n            `[PR review comment rc-<id> …] message in this conversation; do not guess ids.`,\n          { cause: err },\n        );\n      }\n      throw err;\n    }\n  }\n\n  /**\n   * Backs the log mode of `github_checks`: the tail of one CI job's log so\n   * the agent can diagnose a failing check without sandbox credentials. Only\n   * GitHub Actions checks have logs on GitHub — external CI apps (e.g. Cloud\n   * Build) keep theirs on their own service, so a 404 here is translated\n   * into guidance instead of a dead end.\n   */\n  async getJobLog(conversationId: string, jobId: number): Promise<string> {\n    if (!Number.isInteger(jobId) || jobId <= 0) {\n      throw new Error(\n        \"job_id must be a positive Actions job id taken from a [job …] entry in the github_checks summary.\",\n      );\n    }\n    const ref = parseGithubConversationId(conversationId);\n    let logText: string;\n    try {\n      logText = await githubRetry(() => this.client.getJobLog(ref.owner, ref.repo, jobId));\n    } catch (err) {\n      if (err instanceof GithubApiError && err.status === 404) {\n        throw new Error(\n          `No GitHub Actions log for job ${jobId}. Logs are only available for checks reported ` +\n            `by github-actions; external CI (e.g. Cloud Build) keeps logs on its own service — ` +\n            `use that check's summary/url from github_checks, or reproduce the failure locally ` +\n            `in ./repo instead. Do not retry with other ids.`,\n          { cause: err },\n        );\n      }\n      throw err;\n    }\n    return truncateLogTail(logText);\n  }\n}\n"]}

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

@@ -5,6 +5,8 @@ import type { CloneRepoOptions, PushBranchOptions, SyncRepoOptions, SyncRepoResu
  * 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

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

@@ -1 +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"}
+{"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

@@ -1,4 +1,5 @@
 import { execFile } from "child_process";
+import { join } from "path";
 import { promisify } from "util";
 const execFileAsync = promisify(execFile);
 const GIT_TIMEOUT_MS = 120_000;
@@ -8,6 +9,10 @@ const GIT_TIMEOUT_MS = 120_000;
  * 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

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

@@ -1 +1 @@
-{"version":3,"file":"repo.js","sourceRoot":"","sources":["../../../src/adapters/github/repo.ts"],"names":[],"mappings":"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","sourcesContent":["import { execFile } from \"child_process\";\nimport { promisify } from \"util\";\nimport type {\n  CloneRepoOptions,\n  PushBranchOptions,\n  SyncRepoOptions,\n  SyncRepoResult,\n} from \"./types.js\";\n\nconst execFileAsync = promisify(execFile);\n\nconst GIT_TIMEOUT_MS = 120_000;\n\n/**\n * Branches the bot may push: `pi/<name>`. Everything else — including the\n * repo's default branch by construction — is refused, so a driven agent can\n * only ever produce reviewable branches, never touch mainline directly.\n */\nexport const GITHUB_PUSH_BRANCH_PATTERN = /^pi\\/[A-Za-z0-9._][A-Za-z0-9._/-]*$/;\n\n/**\n * Pass the ephemeral token as a per-invocation header, never in the remote\n * URL: nothing credential-shaped may end up in `.git/config`, which lives in\n * the conversation dir and is bind-mounted into the sandbox.\n */\nfunction gitAuthArgs(token: string): string[] {\n  const basic = Buffer.from(`x-access-token:${token}`).toString(\"base64\");\n  return [\"-c\", `http.extraheader=Authorization: basic ${basic}`];\n}\n\nasync function git(args: string[], token?: string): Promise<string> {\n  const { stdout } = await execFileAsync(\"git\", [...(token ? gitAuthArgs(token) : []), ...args], {\n    timeout: GIT_TIMEOUT_MS,\n    env: { ...process.env, GIT_TERMINAL_PROMPT: \"0\" },\n  });\n  return stdout;\n}\n\n/**\n * Git itself rejects these ref shapes; the check just keeps an API-supplied\n * branch name that would parse as a git option (leading dash) or an invalid\n * ref out of argv entirely instead of surfacing as a git error mid-clone.\n */\nfunction isSafeBranchName(name: string): boolean {\n  return (\n    name.length > 0 && !name.startsWith(\"-\") && !name.includes(\"..\") && !/[\\s~^:?*[\\\\]/.test(name)\n  );\n}\n\n/**\n * Local checkout name for a PR conversation: the PR's real head branch when\n * known (same-repo heads only — the caller resolves that), falling back to\n * the synthetic `pr-<n>` for fork PRs, unresolvable heads, and unsafe names.\n * Using the real name is what lets the agent update the PR in place: commit\n * on a `pi/*` head and `github_pr` pushes back to the same branch.\n */\nfunction prCheckoutName(prNumber: number, prHeadBranch?: string): string {\n  return prHeadBranch && isSafeBranchName(prHeadBranch) ? prHeadBranch : `pr-${prNumber}`;\n}\n\n/**\n * Shallow-clone a repo into a conversation dir and preconfigure the bot's\n * commit identity. For PR conversations, additionally fetch the PR head and\n * check it out so the agent starts on the code under review — under its real\n * branch name when the caller resolved one, which is what lets the agent push\n * fixes back to the PR itself.\n */\nexport async function cloneRepo(options: CloneRepoOptions): Promise<void> {\n  await git([\"clone\", \"--depth\", \"50\", options.url, options.dir], options.token);\n  await git([\"-C\", options.dir, \"config\", \"user.name\", options.botLogin]);\n  await git([\"-C\", options.dir, \"config\", \"user.email\", options.botEmail]);\n  if (options.prNumber !== undefined) {\n    await git(\n      [\"-C\", options.dir, \"fetch\", \"--depth\", \"50\", \"origin\", `pull/${options.prNumber}/head`],\n      options.token,\n    );\n    await git([\n      \"-C\",\n      options.dir,\n      \"checkout\",\n      \"-B\",\n      prCheckoutName(options.prNumber, options.prHeadBranch),\n      \"FETCH_HEAD\",\n    ]);\n  }\n}\n\n/**\n * Refresh a conversation clone from origin. Always fetches; only moves the\n * checkout when that provably cannot lose agent work: the target branch is\n * the one checked out, the tree is clean, and it has no commits of its own\n * (`checkout -B` then handles fast-forward and force-pushed heads alike).\n * Anything else stays fetch-only — FETCH_HEAD is left for the agent, which\n * has full credential-less git inside the sandbox, to merge or rebase itself.\n */\nexport async function syncRepo(options: SyncRepoOptions): Promise<SyncRepoResult> {\n  const { dir, token } = options;\n  let refspec: string;\n  let target: string;\n  if (options.branch) {\n    refspec = options.branch;\n    target = options.branch;\n  } else if (options.prNumber !== undefined) {\n    refspec = `pull/${options.prNumber}/head`;\n    target = prCheckoutName(options.prNumber, options.prHeadBranch);\n  } else if (options.defaultBranch) {\n    refspec = options.defaultBranch;\n    target = options.defaultBranch;\n  } else {\n    throw new Error(\"syncRepo needs a branch, a PR number, or the default branch\");\n  }\n\n  await git([\"-C\", dir, \"fetch\", \"--depth\", \"50\", \"origin\", refspec], token);\n  const fetchedSha = (await git([\"-C\", dir, \"rev-parse\", \"FETCH_HEAD\"])).trim();\n  const dirty = (await git([\"-C\", dir, \"status\", \"--porcelain\"])).trim().length > 0;\n  const currentBranch = (await git([\"-C\", dir, \"rev-parse\", \"--abbrev-ref\", \"HEAD\"])).trim();\n  // Clones made before the head branch name was resolvable sit on the\n  // synthetic pr-<n>; treat that as the same checkout so a clean sync\n  // migrates them to the real name instead of going fetch-only forever.\n  const legacyPrBranch = options.prNumber !== undefined ? `pr-${options.prNumber}` : undefined;\n  const onTarget =\n    currentBranch === target || (legacyPrBranch !== undefined && currentBranch === legacyPrBranch);\n  let localCommits = 0;\n  if (onTarget) {\n    // Commits unique to HEAD split two ways: ones the agent committed here\n    // (the clone's preconfigured bot identity) are its work and must survive;\n    // ones committed by others were force-pushed away upstream and are safe\n    // to drop. Filter by the bot committer so a rebased PR head still syncs.\n    const botEmail = (await git([\"-C\", dir, \"config\", \"user.email\"])).trim();\n    localCommits = Number(\n      (\n        await git([\"-C\", dir, \"rev-list\", \"--count\", `--committer=${botEmail}`, \"FETCH_HEAD..HEAD\"])\n      ).trim(),\n    );\n  }\n\n  const updatedCheckout = onTarget && !dirty && localCommits === 0;\n  if (updatedCheckout) {\n    await git([\"-C\", dir, \"checkout\", \"-B\", target, \"FETCH_HEAD\"]);\n  }\n  return { target, fetchedSha, updatedCheckout, dirty, currentBranch, localCommits };\n}\n\n/**\n * Push one local branch to origin. Non-force by construction (plain refspec),\n * and only `pi/*` branches are accepted.\n */\nexport async function pushBranch(options: PushBranchOptions): Promise<void> {\n  const { dir, branch, token } = options;\n  if (!GITHUB_PUSH_BRANCH_PATTERN.test(branch)) {\n    throw new Error(\n      `Refusing to push branch '${branch}': only branches matching pi/<name> may be pushed.`,\n    );\n  }\n  try {\n    await git([\"-C\", dir, \"rev-parse\", \"--verify\", \"--quiet\", `refs/heads/${branch}`]);\n  } catch {\n    throw new Error(`Branch '${branch}' does not exist in the conversation's ./repo clone.`);\n  }\n  await git([\"-C\", dir, \"push\", \"origin\", `refs/heads/${branch}:refs/heads/${branch}`], token);\n}\n"]}
+{"version":3,"file":"repo.js","sourceRoot":"","sources":["../../../src/adapters/github/repo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAQjC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,MAAM,cAAc,GAAG,OAAO,CAAC;AAE/B;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,qCAAqC,CAAC;AAEhF,mFAAmF;AACnF,MAAM,UAAU,mBAAmB,CAAC,UAAkB,EAAE,cAAsB;IAC5E,OAAO,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,SAAS,WAAW,CAAC,KAAa;IAChC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,kBAAkB,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACxE,OAAO,CAAC,IAAI,EAAE,yCAAyC,KAAK,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,KAAK,UAAU,GAAG,CAAC,IAAc,EAAE,KAAc;IAC/C,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE;QAC7F,OAAO,EAAE,cAAc;QACvB,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,mBAAmB,EAAE,GAAG,EAAE;KAClD,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,SAAS,gBAAgB,CAAC,IAAY;IACpC,OAAO,CACL,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAC/F,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAS,cAAc,CAAC,QAAgB,EAAE,YAAqB;IAC7D,OAAO,YAAY,IAAI,gBAAgB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,QAAQ,EAAE,CAAC;AAC1F,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAyB;IACvD,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC/E,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IACzE,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACnC,MAAM,GAAG,CACP,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,OAAO,CAAC,QAAQ,OAAO,CAAC,EACxF,OAAO,CAAC,KAAK,CACd,CAAC;QACF,MAAM,GAAG,CAAC;YACR,IAAI;YACJ,OAAO,CAAC,GAAG;YACX,UAAU;YACV,IAAI;YACJ,cAAc,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC;YACtD,YAAY;SACb,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAwB;IACrD,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAC/B,IAAI,OAAe,CAAC;IACpB,IAAI,MAAc,CAAC;IACnB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;QACzB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC1B,CAAC;SAAM,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,GAAG,QAAQ,OAAO,CAAC,QAAQ,OAAO,CAAC;QAC1C,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAClE,CAAC;SAAM,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;QACjC,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC;QAChC,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IACjC,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACjF,CAAC;IAED,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;IAC3E,MAAM,UAAU,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9E,MAAM,KAAK,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IAClF,MAAM,aAAa,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3F,oEAAoE;IACpE,oEAAoE;IACpE,sEAAsE;IACtE,MAAM,cAAc,GAAG,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7F,MAAM,QAAQ,GACZ,aAAa,KAAK,MAAM,IAAI,CAAC,cAAc,KAAK,SAAS,IAAI,aAAa,KAAK,cAAc,CAAC,CAAC;IACjG,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,QAAQ,EAAE,CAAC;QACb,uEAAuE;QACvE,0EAA0E;QAC1E,wEAAwE;QACxE,yEAAyE;QACzE,MAAM,QAAQ,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACzE,YAAY,GAAG,MAAM,CACnB,CACE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,QAAQ,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAC7F,CAAC,IAAI,EAAE,CACT,CAAC;IACJ,CAAC;IAED,MAAM,eAAe,GAAG,QAAQ,IAAI,CAAC,KAAK,IAAI,YAAY,KAAK,CAAC,CAAC;IACjE,IAAI,eAAe,EAAE,CAAC;QACpB,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC;AACrF,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAA0B;IACzD,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IACvC,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CACb,4BAA4B,MAAM,oDAAoD,CACvF,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,MAAM,EAAE,CAAC,CAAC,CAAC;IACrF,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,sDAAsD,CAAC,CAAC;IAC3F,CAAC;IACD,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,MAAM,eAAe,MAAM,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;AAC/F,CAAC","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/tools/checks.d.ts.map

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

@@ -1,4 +1,5 @@
 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). " +
@@ -45,10 +46,8 @@ function formatCheckLine(run) {
  * Read-only, host-side; wired per run and only for GitHub conversations.
  */
 export function createGithubChecksTool() {
-    let checksFns = null;
-    const tool = {
+    const { tool, setFn } = defineHostFnTool({
         name: "github_checks",
-        label: "github_checks",
         description: "Read CI status (check runs) for a branch you pushed with github_pr, or for this " +
             "conversation's pull request when branch is omitted. Pass job_id (a [job …] id, " +
             "GitHub Actions) or build_id (a [build …] uuid, Cloud Build) from the summary to " +
@@ -56,13 +55,8 @@ export function createGithubChecksTool() {
             "their summary/url, or reproduce the failure locally in ./repo. Only available in " +
             "GitHub conversations.",
         parameters: githubChecksSchema,
-        execute: async (_toolCallId, args, signal) => {
-            if (!checksFns) {
-                throw new Error("github_checks is only available in GitHub conversations.");
-            }
-            if (signal?.aborted) {
-                throw new Error("Operation aborted");
-            }
+        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.");
             }
@@ -105,12 +99,7 @@ export function createGithubChecksTool() {
                 details: undefined,
             };
         },
-    };
-    return {
-        tool,
-        setGithubChecksFunction: (fns) => {
-            checksFns = fns;
-        },
-    };
+    });
+    return { tool, setGithubChecksFunction: setFn };
 }
 //# sourceMappingURL=checks.js.map