lastlight 0.15.0 → 0.16.1

package/dist/engine/github/github.d.ts

@@ -1,1193 +0,0 @@
-import { type GitHubAppClientConfig } from "./github-app-client.js";
-import type { InlineComment, ReviewEvent } from "./review-poster.js";
-/** GitHub reaction emoji values accepted by the reactions API. */
-export type ReactionContent = "+1" | "-1" | "laugh" | "confused" | "heart" | "hooray" | "rocket" | "eyes";
-/**
- * GitHub client for the harness — uses GitHub App auth.
- * Used by the orchestrator to post comments, not by agent sessions.
- */
-export declare class GitHubClient {
-    private octokit;
-    constructor(config: GitHubAppClientConfig);
-    /**
-     * Build a client authed with a raw bearer token (a pre-minted installation
-     * token) instead of App JWT auth. Used by the harness-side `post-review`
-     * action: prod passes the run's scoped review-write token; evals pass the
-     * mock's token + `baseUrl`. Avoids the App installation-token minting
-     * round-trip (which hard-codes api.github.com and the evals mock doesn't
-     * serve).
-     */
-    static withToken(token: string, baseUrl?: string): GitHubClient;
-    /**
-     * Create a new comment on an issue/PR. Returns the new comment id so callers
-     * that want to edit it later (the in-place status checklist — see
-     * `src/notify/transports/github.ts`) can hold onto a handle. Callers that
-     * just post a one-off comment can ignore the return.
-     */
-    postComment(owner: string, repo: string, issueNumber: number, body: string): Promise<number>;
-    /**
-     * List every repository the App installation can access, as `owner/repo`
-     * full names. Used at boot to seed the managed-repo list from the App grant
-     * (see src/managed-repos.ts). The installation id is bound by the App auth
-     * strategy, so no argument is needed. Paginated — handles installs with
-     * hundreds of repos.
-     */
-    listInstallationRepos(): Promise<string[]>;
-    /**
-     * Edit an existing issue/PR comment in place. Paired with `postComment` to
-     * maintain a single status comment that updates as a workflow progresses,
-     * rather than posting a new comment per phase. GitHub does NOT notify
-     * watchers on edits, which is exactly why this keeps the thread quiet.
-     */
-    updateComment(owner: string, repo: string, commentId: number, body: string): Promise<void>;
-    /**
-     * Add an emoji reaction to a specific issue comment. Used as an immediate
-     * (silent) acknowledgment that the agent has accepted a request, before
-     * any actual work — and any chatty bot comments — start.
-     *
-     * Reaction `content` values: "+1" | "-1" | "laugh" | "confused" | "heart"
-     * | "hooray" | "rocket" | "eyes".
-     */
-    reactToComment(owner: string, repo: string, commentId: number, content?: ReactionContent): Promise<void>;
-    /**
-     * Add an emoji reaction to an issue or PR itself (not a comment) — used to
-     * ack events that aren't comments, e.g. a freshly opened issue/PR. PRs are
-     * issues for the reactions API, so this works for both.
-     */
-    reactToIssue(owner: string, repo: string, issueNumber: number, content?: ReactionContent): Promise<void>;
-    /**
-     * Add an emoji reaction to a pull-request review comment (inline diff
-     * comment). Distinct endpoint from issue comments — review comments live on
-     * the pulls API.
-     */
-    reactToReviewComment(owner: string, repo: string, commentId: number, content?: ReactionContent): Promise<void>;
-    getIssue(owner: string, repo: string, issueNumber: number): Promise<{
-        id: number;
-        node_id: string;
-        url: string;
-        repository_url: string;
-        labels_url: string;
-        comments_url: string;
-        events_url: string;
-        html_url: string;
-        number: number;
-        state: string;
-        state_reason?: "completed" | "reopened" | "not_planned" | "duplicate" | null;
-        title: string;
-        body?: string | null;
-        user: {
-            name?: string | null;
-            email?: string | null;
-            login: string;
-            id: number;
-            node_id: string;
-            avatar_url: string;
-            gravatar_id: string | null;
-            url: string;
-            html_url: string;
-            followers_url: string;
-            following_url: string;
-            gists_url: string;
-            starred_url: string;
-            subscriptions_url: string;
-            organizations_url: string;
-            repos_url: string;
-            events_url: string;
-            received_events_url: string;
-            type: string;
-            site_admin: boolean;
-            starred_at?: string;
-            user_view_type?: string;
-        } | null;
-        labels: (string | {
-            id?: number;
-            node_id?: string;
-            url?: string;
-            name?: string;
-            description?: string | null;
-            color?: string | null;
-            default?: boolean;
-        })[];
-        assignee: {
-            name?: string | null;
-            email?: string | null;
-            login: string;
-            id: number;
-            node_id: string;
-            avatar_url: string;
-            gravatar_id: string | null;
-            url: string;
-            html_url: string;
-            followers_url: string;
-            following_url: string;
-            gists_url: string;
-            starred_url: string;
-            subscriptions_url: string;
-            organizations_url: string;
-            repos_url: string;
-            events_url: string;
-            received_events_url: string;
-            type: string;
-            site_admin: boolean;
-            starred_at?: string;
-            user_view_type?: string;
-        } | null;
-        assignees?: {
-            name?: string | null;
-            email?: string | null;
-            login: string;
-            id: number;
-            node_id: string;
-            avatar_url: string;
-            gravatar_id: string | null;
-            url: string;
-            html_url: string;
-            followers_url: string;
-            following_url: string;
-            gists_url: string;
-            starred_url: string;
-            subscriptions_url: string;
-            organizations_url: string;
-            repos_url: string;
-            events_url: string;
-            received_events_url: string;
-            type: string;
-            site_admin: boolean;
-            starred_at?: string;
-            user_view_type?: string;
-        }[] | null;
-        milestone: {
-            url: string;
-            html_url: string;
-            labels_url: string;
-            id: number;
-            node_id: string;
-            number: number;
-            state: "open" | "closed";
-            title: string;
-            description: string | null;
-            creator: {
-                name?: string | null;
-                email?: string | null;
-                login: string;
-                id: number;
-                node_id: string;
-                avatar_url: string;
-                gravatar_id: string | null;
-                url: string;
-                html_url: string;
-                followers_url: string;
-                following_url: string;
-                gists_url: string;
-                starred_url: string;
-                subscriptions_url: string;
-                organizations_url: string;
-                repos_url: string;
-                events_url: string;
-                received_events_url: string;
-                type: string;
-                site_admin: boolean;
-                starred_at?: string;
-                user_view_type?: string;
-            } | null;
-            open_issues: number;
-            closed_issues: number;
-            created_at: string;
-            updated_at: string;
-            closed_at: string | null;
-            due_on: string | null;
-        } | null;
-        locked: boolean;
-        active_lock_reason?: string | null;
-        comments: number;
-        pull_request?: {
-            merged_at?: string | null;
-            diff_url: string | null;
-            html_url: string | null;
-            patch_url: string | null;
-            url: string | null;
-        };
-        closed_at: string | null;
-        created_at: string;
-        updated_at: string;
-        draft?: boolean;
-        closed_by?: {
-            name?: string | null;
-            email?: string | null;
-            login: string;
-            id: number;
-            node_id: string;
-            avatar_url: string;
-            gravatar_id: string | null;
-            url: string;
-            html_url: string;
-            followers_url: string;
-            following_url: string;
-            gists_url: string;
-            starred_url: string;
-            subscriptions_url: string;
-            organizations_url: string;
-            repos_url: string;
-            events_url: string;
-            received_events_url: string;
-            type: string;
-            site_admin: boolean;
-            starred_at?: string;
-            user_view_type?: string;
-        } | null;
-        body_html?: string;
-        body_text?: string;
-        timeline_url?: string;
-        type?: {
-            id: number;
-            node_id: string;
-            name: string;
-            description: string | null;
-            color?: "gray" | "blue" | "green" | "yellow" | "orange" | "red" | "pink" | "purple" | null;
-            created_at?: string;
-            updated_at?: string;
-            is_enabled?: boolean;
-        } | null;
-        repository?: {
-            id: number;
-            node_id: string;
-            name: string;
-            full_name: string;
-            license: {
-                key: string;
-                name: string;
-                url: string | null;
-                spdx_id: string | null;
-                node_id: string;
-                html_url?: string;
-            } | null;
-            forks: number;
-            permissions?: {
-                admin: boolean;
-                pull: boolean;
-                triage?: boolean;
-                push: boolean;
-                maintain?: boolean;
-            };
-            owner: {
-                name?: string | null;
-                email?: string | null;
-                login: string;
-                id: number;
-                node_id: string;
-                avatar_url: string;
-                gravatar_id: string | null;
-                url: string;
-                html_url: string;
-                followers_url: string;
-                following_url: string;
-                gists_url: string;
-                starred_url: string;
-                subscriptions_url: string;
-                organizations_url: string;
-                repos_url: string;
-                events_url: string;
-                received_events_url: string;
-                type: string;
-                site_admin: boolean;
-                starred_at?: string;
-                user_view_type?: string;
-            };
-            private: boolean;
-            html_url: string;
-            description: string | null;
-            fork: boolean;
-            url: string;
-            archive_url: string;
-            assignees_url: string;
-            blobs_url: string;
-            branches_url: string;
-            collaborators_url: string;
-            comments_url: string;
-            commits_url: string;
-            compare_url: string;
-            contents_url: string;
-            contributors_url: string;
-            deployments_url: string;
-            downloads_url: string;
-            events_url: string;
-            forks_url: string;
-            git_commits_url: string;
-            git_refs_url: string;
-            git_tags_url: string;
-            git_url: string;
-            issue_comment_url: string;
-            issue_events_url: string;
-            issues_url: string;
-            keys_url: string;
-            labels_url: string;
-            languages_url: string;
-            merges_url: string;
-            milestones_url: string;
-            notifications_url: string;
-            pulls_url: string;
-            releases_url: string;
-            ssh_url: string;
-            stargazers_url: string;
-            statuses_url: string;
-            subscribers_url: string;
-            subscription_url: string;
-            tags_url: string;
-            teams_url: string;
-            trees_url: string;
-            clone_url: string;
-            mirror_url: string | null;
-            hooks_url: string;
-            svn_url: string;
-            homepage: string | null;
-            language: string | null;
-            forks_count: number;
-            stargazers_count: number;
-            watchers_count: number;
-            size: number;
-            default_branch: string;
-            open_issues_count: number;
-            is_template?: boolean;
-            topics?: string[];
-            has_issues: boolean;
-            has_projects: boolean;
-            has_wiki: boolean;
-            has_pages: boolean;
-            has_downloads: boolean;
-            has_discussions?: boolean;
-            archived: boolean;
-            disabled: boolean;
-            visibility?: string;
-            pushed_at: string | null;
-            created_at: string | null;
-            updated_at: string | null;
-            allow_rebase_merge?: boolean;
-            temp_clone_token?: string;
-            allow_squash_merge?: boolean;
-            allow_auto_merge?: boolean;
-            delete_branch_on_merge?: boolean;
-            allow_update_branch?: boolean;
-            use_squash_pr_title_as_default?: boolean;
-            squash_merge_commit_title?: "PR_TITLE" | "COMMIT_OR_PR_TITLE";
-            squash_merge_commit_message?: "PR_BODY" | "COMMIT_MESSAGES" | "BLANK";
-            merge_commit_title?: "PR_TITLE" | "MERGE_MESSAGE";
-            merge_commit_message?: "PR_BODY" | "PR_TITLE" | "BLANK";
-            allow_merge_commit?: boolean;
-            allow_forking?: boolean;
-            web_commit_signoff_required?: boolean;
-            open_issues: number;
-            watchers: number;
-            master_branch?: string;
-            starred_at?: string;
-            anonymous_access_enabled?: boolean;
-            code_search_index_status?: {
-                lexical_search_ok?: boolean;
-                lexical_commit_sha?: string;
-            };
-        };
-        performed_via_github_app?: {
-            id: number;
-            slug?: string;
-            node_id: string;
-            client_id?: string;
-            owner: {
-                name?: string | null;
-                email?: string | null;
-                login: string;
-                id: number;
-                node_id: string;
-                avatar_url: string;
-                gravatar_id: string | null;
-                url: string;
-                html_url: string;
-                followers_url: string;
-                following_url: string;
-                gists_url: string;
-                starred_url: string;
-                subscriptions_url: string;
-                organizations_url: string;
-                repos_url: string;
-                events_url: string;
-                received_events_url: string;
-                type: string;
-                site_admin: boolean;
-                starred_at?: string;
-                user_view_type?: string;
-            } | {
-                description?: string | null;
-                html_url: string;
-                website_url?: string | null;
-                id: number;
-                node_id: string;
-                name: string;
-                slug: string;
-                created_at: string | null;
-                updated_at: string | null;
-                avatar_url: string;
-            };
-            name: string;
-            description: string | null;
-            external_url: string;
-            html_url: string;
-            created_at: string;
-            updated_at: string;
-            permissions: {
-                issues?: string;
-                checks?: string;
-                metadata?: string;
-                contents?: string;
-                deployments?: string;
-                [key: string]: string | undefined;
-            };
-            events: string[];
-            installations_count?: number;
-        } | null;
-        author_association?: "COLLABORATOR" | "CONTRIBUTOR" | "FIRST_TIMER" | "FIRST_TIME_CONTRIBUTOR" | "MANNEQUIN" | "MEMBER" | "NONE" | "OWNER";
-        reactions?: {
-            url: string;
-            total_count: number;
-            "+1": number;
-            "-1": number;
-            laugh: number;
-            confused: number;
-            heart: number;
-            hooray: number;
-            eyes: number;
-            rocket: number;
-        };
-        sub_issues_summary?: {
-            total: number;
-            completed: number;
-            percent_completed: number;
-        };
-        parent_issue_url?: string | null;
-        issue_dependencies_summary?: {
-            blocked_by: number;
-            blocking: number;
-            total_blocked_by: number;
-            total_blocking: number;
-        };
-        issue_field_values?: {
-            issue_field_id: number;
-            node_id: string;
-            data_type: "text" | "single_select" | "number" | "date";
-            value: (string | number) | null;
-            single_select_option?: {
-                id: number;
-                name: string;
-                color: string;
-            } | null;
-        }[];
-    }>;
-    /**
-     * Fetch the issue body. Used by the dispatch path so build/explore/pr-fix
-     * workflows always see the real issue body, even when triggered from a
-     * comment (where the EventEnvelope.body field is the comment, not the
-     * issue body).
-     */
-    getIssueBody(owner: string, repo: string, issueNumber: number): Promise<string>;
-    /**
-     * List all comments on an issue/PR, oldest first. Used by the dispatch path
-     * to inject the full conversation thread into the architect's context — the
-     * spec the bot writes during an `explore` run lives here, and the build
-     * cycle needs to see it to implement the agreed design.
-     */
-    listIssueComments(owner: string, repo: string, issueNumber: number): Promise<Array<{
-        user: string;
-        body: string;
-        createdAt: string;
-    }>>;
-    getPullRequest(owner: string, repo: string, pullNumber: number): Promise<{
-        url: string;
-        id: number;
-        node_id: string;
-        html_url: string;
-        diff_url: string;
-        patch_url: string;
-        issue_url: string;
-        commits_url: string;
-        review_comments_url: string;
-        review_comment_url: string;
-        comments_url: string;
-        statuses_url: string;
-        number: number;
-        state: "open" | "closed";
-        locked: boolean;
-        title: string;
-        user: {
-            name?: string | null;
-            email?: string | null;
-            login: string;
-            id: number;
-            node_id: string;
-            avatar_url: string;
-            gravatar_id: string | null;
-            url: string;
-            html_url: string;
-            followers_url: string;
-            following_url: string;
-            gists_url: string;
-            starred_url: string;
-            subscriptions_url: string;
-            organizations_url: string;
-            repos_url: string;
-            events_url: string;
-            received_events_url: string;
-            type: string;
-            site_admin: boolean;
-            starred_at?: string;
-            user_view_type?: string;
-        };
-        body: string | null;
-        labels: {
-            id: number;
-            node_id: string;
-            url: string;
-            name: string;
-            description: string | null;
-            color: string;
-            default: boolean;
-        }[];
-        milestone: {
-            url: string;
-            html_url: string;
-            labels_url: string;
-            id: number;
-            node_id: string;
-            number: number;
-            state: "open" | "closed";
-            title: string;
-            description: string | null;
-            creator: {
-                name?: string | null;
-                email?: string | null;
-                login: string;
-                id: number;
-                node_id: string;
-                avatar_url: string;
-                gravatar_id: string | null;
-                url: string;
-                html_url: string;
-                followers_url: string;
-                following_url: string;
-                gists_url: string;
-                starred_url: string;
-                subscriptions_url: string;
-                organizations_url: string;
-                repos_url: string;
-                events_url: string;
-                received_events_url: string;
-                type: string;
-                site_admin: boolean;
-                starred_at?: string;
-                user_view_type?: string;
-            } | null;
-            open_issues: number;
-            closed_issues: number;
-            created_at: string;
-            updated_at: string;
-            closed_at: string | null;
-            due_on: string | null;
-        } | null;
-        active_lock_reason?: string | null;
-        created_at: string;
-        updated_at: string;
-        closed_at: string | null;
-        merged_at: string | null;
-        merge_commit_sha: string | null;
-        assignee: {
-            name?: string | null;
-            email?: string | null;
-            login: string;
-            id: number;
-            node_id: string;
-            avatar_url: string;
-            gravatar_id: string | null;
-            url: string;
-            html_url: string;
-            followers_url: string;
-            following_url: string;
-            gists_url: string;
-            starred_url: string;
-            subscriptions_url: string;
-            organizations_url: string;
-            repos_url: string;
-            events_url: string;
-            received_events_url: string;
-            type: string;
-            site_admin: boolean;
-            starred_at?: string;
-            user_view_type?: string;
-        } | null;
-        assignees?: {
-            name?: string | null;
-            email?: string | null;
-            login: string;
-            id: number;
-            node_id: string;
-            avatar_url: string;
-            gravatar_id: string | null;
-            url: string;
-            html_url: string;
-            followers_url: string;
-            following_url: string;
-            gists_url: string;
-            starred_url: string;
-            subscriptions_url: string;
-            organizations_url: string;
-            repos_url: string;
-            events_url: string;
-            received_events_url: string;
-            type: string;
-            site_admin: boolean;
-            starred_at?: string;
-            user_view_type?: string;
-        }[] | null;
-        requested_reviewers?: {
-            name?: string | null;
-            email?: string | null;
-            login: string;
-            id: number;
-            node_id: string;
-            avatar_url: string;
-            gravatar_id: string | null;
-            url: string;
-            html_url: string;
-            followers_url: string;
-            following_url: string;
-            gists_url: string;
-            starred_url: string;
-            subscriptions_url: string;
-            organizations_url: string;
-            repos_url: string;
-            events_url: string;
-            received_events_url: string;
-            type: string;
-            site_admin: boolean;
-            starred_at?: string;
-            user_view_type?: string;
-        }[] | null;
-        requested_teams?: {
-            id: number;
-            node_id: string;
-            url: string;
-            members_url: string;
-            name: string;
-            description: string | null;
-            permission: string;
-            privacy?: string;
-            notification_setting?: string;
-            html_url: string;
-            repositories_url: string;
-            slug: string;
-            ldap_dn?: string;
-            type: "enterprise" | "organization";
-            organization_id?: number;
-            enterprise_id?: number;
-        }[] | null;
-        head: {
-            label: string;
-            ref: string;
-            repo: {
-                id: number;
-                node_id: string;
-                name: string;
-                full_name: string;
-                license: {
-                    key: string;
-                    name: string;
-                    url: string | null;
-                    spdx_id: string | null;
-                    node_id: string;
-                    html_url?: string;
-                } | null;
-                forks: number;
-                permissions?: {
-                    admin: boolean;
-                    pull: boolean;
-                    triage?: boolean;
-                    push: boolean;
-                    maintain?: boolean;
-                };
-                owner: {
-                    name?: string | null;
-                    email?: string | null;
-                    login: string;
-                    id: number;
-                    node_id: string;
-                    avatar_url: string;
-                    gravatar_id: string | null;
-                    url: string;
-                    html_url: string;
-                    followers_url: string;
-                    following_url: string;
-                    gists_url: string;
-                    starred_url: string;
-                    subscriptions_url: string;
-                    organizations_url: string;
-                    repos_url: string;
-                    events_url: string;
-                    received_events_url: string;
-                    type: string;
-                    site_admin: boolean;
-                    starred_at?: string;
-                    user_view_type?: string;
-                };
-                private: boolean;
-                html_url: string;
-                description: string | null;
-                fork: boolean;
-                url: string;
-                archive_url: string;
-                assignees_url: string;
-                blobs_url: string;
-                branches_url: string;
-                collaborators_url: string;
-                comments_url: string;
-                commits_url: string;
-                compare_url: string;
-                contents_url: string;
-                contributors_url: string;
-                deployments_url: string;
-                downloads_url: string;
-                events_url: string;
-                forks_url: string;
-                git_commits_url: string;
-                git_refs_url: string;
-                git_tags_url: string;
-                git_url: string;
-                issue_comment_url: string;
-                issue_events_url: string;
-                issues_url: string;
-                keys_url: string;
-                labels_url: string;
-                languages_url: string;
-                merges_url: string;
-                milestones_url: string;
-                notifications_url: string;
-                pulls_url: string;
-                releases_url: string;
-                ssh_url: string;
-                stargazers_url: string;
-                statuses_url: string;
-                subscribers_url: string;
-                subscription_url: string;
-                tags_url: string;
-                teams_url: string;
-                trees_url: string;
-                clone_url: string;
-                mirror_url: string | null;
-                hooks_url: string;
-                svn_url: string;
-                homepage: string | null;
-                language: string | null;
-                forks_count: number;
-                stargazers_count: number;
-                watchers_count: number;
-                size: number;
-                default_branch: string;
-                open_issues_count: number;
-                is_template?: boolean;
-                topics?: string[];
-                has_issues: boolean;
-                has_projects: boolean;
-                has_wiki: boolean;
-                has_pages: boolean;
-                has_downloads: boolean;
-                has_discussions?: boolean;
-                archived: boolean;
-                disabled: boolean;
-                visibility?: string;
-                pushed_at: string | null;
-                created_at: string | null;
-                updated_at: string | null;
-                allow_rebase_merge?: boolean;
-                temp_clone_token?: string;
-                allow_squash_merge?: boolean;
-                allow_auto_merge?: boolean;
-                delete_branch_on_merge?: boolean;
-                allow_update_branch?: boolean;
-                use_squash_pr_title_as_default?: boolean;
-                squash_merge_commit_title?: "PR_TITLE" | "COMMIT_OR_PR_TITLE";
-                squash_merge_commit_message?: "PR_BODY" | "COMMIT_MESSAGES" | "BLANK";
-                merge_commit_title?: "PR_TITLE" | "MERGE_MESSAGE";
-                merge_commit_message?: "PR_BODY" | "PR_TITLE" | "BLANK";
-                allow_merge_commit?: boolean;
-                allow_forking?: boolean;
-                web_commit_signoff_required?: boolean;
-                open_issues: number;
-                watchers: number;
-                master_branch?: string;
-                starred_at?: string;
-                anonymous_access_enabled?: boolean;
-                code_search_index_status?: {
-                    lexical_search_ok?: boolean;
-                    lexical_commit_sha?: string;
-                };
-            };
-            sha: string;
-            user: {
-                name?: string | null;
-                email?: string | null;
-                login: string;
-                id: number;
-                node_id: string;
-                avatar_url: string;
-                gravatar_id: string | null;
-                url: string;
-                html_url: string;
-                followers_url: string;
-                following_url: string;
-                gists_url: string;
-                starred_url: string;
-                subscriptions_url: string;
-                organizations_url: string;
-                repos_url: string;
-                events_url: string;
-                received_events_url: string;
-                type: string;
-                site_admin: boolean;
-                starred_at?: string;
-                user_view_type?: string;
-            };
-        };
-        base: {
-            label: string;
-            ref: string;
-            repo: {
-                id: number;
-                node_id: string;
-                name: string;
-                full_name: string;
-                license: {
-                    key: string;
-                    name: string;
-                    url: string | null;
-                    spdx_id: string | null;
-                    node_id: string;
-                    html_url?: string;
-                } | null;
-                forks: number;
-                permissions?: {
-                    admin: boolean;
-                    pull: boolean;
-                    triage?: boolean;
-                    push: boolean;
-                    maintain?: boolean;
-                };
-                owner: {
-                    name?: string | null;
-                    email?: string | null;
-                    login: string;
-                    id: number;
-                    node_id: string;
-                    avatar_url: string;
-                    gravatar_id: string | null;
-                    url: string;
-                    html_url: string;
-                    followers_url: string;
-                    following_url: string;
-                    gists_url: string;
-                    starred_url: string;
-                    subscriptions_url: string;
-                    organizations_url: string;
-                    repos_url: string;
-                    events_url: string;
-                    received_events_url: string;
-                    type: string;
-                    site_admin: boolean;
-                    starred_at?: string;
-                    user_view_type?: string;
-                };
-                private: boolean;
-                html_url: string;
-                description: string | null;
-                fork: boolean;
-                url: string;
-                archive_url: string;
-                assignees_url: string;
-                blobs_url: string;
-                branches_url: string;
-                collaborators_url: string;
-                comments_url: string;
-                commits_url: string;
-                compare_url: string;
-                contents_url: string;
-                contributors_url: string;
-                deployments_url: string;
-                downloads_url: string;
-                events_url: string;
-                forks_url: string;
-                git_commits_url: string;
-                git_refs_url: string;
-                git_tags_url: string;
-                git_url: string;
-                issue_comment_url: string;
-                issue_events_url: string;
-                issues_url: string;
-                keys_url: string;
-                labels_url: string;
-                languages_url: string;
-                merges_url: string;
-                milestones_url: string;
-                notifications_url: string;
-                pulls_url: string;
-                releases_url: string;
-                ssh_url: string;
-                stargazers_url: string;
-                statuses_url: string;
-                subscribers_url: string;
-                subscription_url: string;
-                tags_url: string;
-                teams_url: string;
-                trees_url: string;
-                clone_url: string;
-                mirror_url: string | null;
-                hooks_url: string;
-                svn_url: string;
-                homepage: string | null;
-                language: string | null;
-                forks_count: number;
-                stargazers_count: number;
-                watchers_count: number;
-                size: number;
-                default_branch: string;
-                open_issues_count: number;
-                is_template?: boolean;
-                topics?: string[];
-                has_issues: boolean;
-                has_projects: boolean;
-                has_wiki: boolean;
-                has_pages: boolean;
-                has_downloads: boolean;
-                has_discussions?: boolean;
-                archived: boolean;
-                disabled: boolean;
-                visibility?: string;
-                pushed_at: string | null;
-                created_at: string | null;
-                updated_at: string | null;
-                allow_rebase_merge?: boolean;
-                temp_clone_token?: string;
-                allow_squash_merge?: boolean;
-                allow_auto_merge?: boolean;
-                delete_branch_on_merge?: boolean;
-                allow_update_branch?: boolean;
-                use_squash_pr_title_as_default?: boolean;
-                squash_merge_commit_title?: "PR_TITLE" | "COMMIT_OR_PR_TITLE";
-                squash_merge_commit_message?: "PR_BODY" | "COMMIT_MESSAGES" | "BLANK";
-                merge_commit_title?: "PR_TITLE" | "MERGE_MESSAGE";
-                merge_commit_message?: "PR_BODY" | "PR_TITLE" | "BLANK";
-                allow_merge_commit?: boolean;
-                allow_forking?: boolean;
-                web_commit_signoff_required?: boolean;
-                open_issues: number;
-                watchers: number;
-                master_branch?: string;
-                starred_at?: string;
-                anonymous_access_enabled?: boolean;
-                code_search_index_status?: {
-                    lexical_search_ok?: boolean;
-                    lexical_commit_sha?: string;
-                };
-            };
-            sha: string;
-            user: {
-                name?: string | null;
-                email?: string | null;
-                login: string;
-                id: number;
-                node_id: string;
-                avatar_url: string;
-                gravatar_id: string | null;
-                url: string;
-                html_url: string;
-                followers_url: string;
-                following_url: string;
-                gists_url: string;
-                starred_url: string;
-                subscriptions_url: string;
-                organizations_url: string;
-                repos_url: string;
-                events_url: string;
-                received_events_url: string;
-                type: string;
-                site_admin: boolean;
-                starred_at?: string;
-                user_view_type?: string;
-            };
-        };
-        _links: {
-            comments: {
-                href: string;
-            };
-            commits: {
-                href: string;
-            };
-            statuses: {
-                href: string;
-            };
-            html: {
-                href: string;
-            };
-            issue: {
-                href: string;
-            };
-            review_comments: {
-                href: string;
-            };
-            review_comment: {
-                href: string;
-            };
-            self: {
-                href: string;
-            };
-        };
-        author_association: "COLLABORATOR" | "CONTRIBUTOR" | "FIRST_TIMER" | "FIRST_TIME_CONTRIBUTOR" | "MANNEQUIN" | "MEMBER" | "NONE" | "OWNER";
-        auto_merge: {
-            enabled_by: {
-                name?: string | null;
-                email?: string | null;
-                login: string;
-                id: number;
-                node_id: string;
-                avatar_url: string;
-                gravatar_id: string | null;
-                url: string;
-                html_url: string;
-                followers_url: string;
-                following_url: string;
-                gists_url: string;
-                starred_url: string;
-                subscriptions_url: string;
-                organizations_url: string;
-                repos_url: string;
-                events_url: string;
-                received_events_url: string;
-                type: string;
-                site_admin: boolean;
-                starred_at?: string;
-                user_view_type?: string;
-            };
-            merge_method: "merge" | "squash" | "rebase";
-            commit_title: string;
-            commit_message: string;
-        } | null;
-        draft?: boolean;
-        merged: boolean;
-        mergeable: boolean | null;
-        rebaseable?: boolean | null;
-        mergeable_state: string;
-        merged_by: {
-            name?: string | null;
-            email?: string | null;
-            login: string;
-            id: number;
-            node_id: string;
-            avatar_url: string;
-            gravatar_id: string | null;
-            url: string;
-            html_url: string;
-            followers_url: string;
-            following_url: string;
-            gists_url: string;
-            starred_url: string;
-            subscriptions_url: string;
-            organizations_url: string;
-            repos_url: string;
-            events_url: string;
-            received_events_url: string;
-            type: string;
-            site_admin: boolean;
-            starred_at?: string;
-            user_view_type?: string;
-        } | null;
-        comments: number;
-        review_comments: number;
-        maintainer_can_modify: boolean;
-        commits: number;
-        additions: number;
-        deletions: number;
-        changed_files: number;
-    }>;
-    /**
-     * The repo's default branch (e.g. `main`, `master`, `develop`). Used to
-     * scope build runs to the real base branch instead of assuming `main` — a
-     * `master`-default repo otherwise breaks every `git ... main..HEAD` the
-     * reviewer runs. See the `baseBranch` plumbing in src/index.ts.
-     */
-    getDefaultBranch(owner: string, repo: string): Promise<string>;
-    /** Convenience: fetch only the PR's head commit SHA. Used by check-run code. */
-    getPullRequestHeadSha(owner: string, repo: string, pullNumber: number): Promise<string>;
-    /**
-     * Create a Check Run on a PR's head commit. Returns the new check_run id so
-     * the caller can later transition it from `in_progress` → `completed` with
-     * a conclusion. Repos that enable "Require status checks to pass" with
-     * `name` in their list will gate merges on the eventual conclusion.
-     *
-     * Requires the GitHub App to have `Checks: Read and write` permission.
-     */
-    createCheckRun(owner: string, repo: string, headSha: string, name: string, options?: {
-        detailsUrl?: string;
-        output?: {
-            title: string;
-            summary: string;
-        };
-    }): Promise<number>;
-    /**
-     * Update an existing Check Run — typically to transition `in_progress` →
-     * `completed` with a conclusion. Conclusion values that branch protection
-     * treats as passing: `success`, `neutral`, `skipped`. Failing: `failure`,
-     * `cancelled`, `timed_out`, `action_required`.
-     */
-    updateCheckRun(owner: string, repo: string, checkRunId: number, update: {
-        status?: "queued" | "in_progress" | "completed";
-        conclusion?: "success" | "failure" | "neutral" | "cancelled" | "timed_out" | "action_required" | "skipped";
-        /** Sets the check's "Details" link (e.g. the dashboard run deep link). */
-        detailsUrl?: string;
-        output?: {
-            title: string;
-            summary: string;
-        };
-    }): Promise<void>;
-    /**
-     * Find the bot's most recent review on this PR's current head commit. Used
-     * after a pr-review workflow finishes to derive the check-run conclusion
-     * from the review the agent actually posted (APPROVE / REQUEST_CHANGES /
-     * COMMENT). Returns null when the bot hasn't reviewed this SHA yet.
-     *
-     * `botLogin` defaults to `last-light[bot]` so the lookup matches App-auth'd
-     * reviews regardless of how the agent identified itself.
-     */
-    getLatestBotReview(owner: string, repo: string, pullNumber: number, headSha: string, botLogin?: string): Promise<{
-        state: string;
-        body: string | null;
-        submittedAt: string | null;
-    } | null>;
-    /**
-     * Fetch a PR's unified diff (three-dot, base…head) as a string. Used by the
-     * `post-review` action to anchor findings to changed lines — the harness runs
-     * this in-process (not in the sandbox), so the diff comes from the API rather
-     * than a local `git diff`, with no dependency on checkout/fetch state.
-     */
-    getPullRequestDiff(owner: string, repo: string, pullNumber: number): Promise<string>;
-    /**
-     * Submit one formal PR review with an event (APPROVE / REQUEST_CHANGES /
-     * COMMENT) plus optional line-anchored inline comments. `commitId` pins the
-     * review to the reviewed head SHA. This is the single harness-side write for
-     * PR reviews — the reviewer agent never submits; it writes findings and the
-     * `post-review` action calls this. Throws on a non-2xx so the action can fail
-     * the phase visibly (or retry body-only).
-     */
-    createPullRequestReview(owner: string, repo: string, pullNumber: number, review: {
-        body: string;
-        event: ReviewEvent;
-        comments?: InlineComment[];
-        commitId?: string;
-    }): Promise<void>;
-    /**
-     * Get failed check runs for a PR's head SHA.
-     * Fetches the actual job logs (not just annotations) to show real errors.
-     */
-    getFailedChecks(owner: string, repo: string, ref: string): Promise<string>;
-}