pullfrog 0.0.196 → 0.0.198

package/dist/lifecycle.d.ts

@@ -0,0 +1,2 @@
+/** timeout for lifecycle hook scripts */
+export declare const LIFECYCLE_HOOK_TIMEOUT_MS = 120000;

package/dist/main.d.ts

@@ -0,0 +1,8 @@
+export { Inputs } from "./utils/payload.ts";
+export interface MainResult {
+    success: boolean;
+    output?: string | undefined;
+    error?: string | undefined;
+    result?: string | undefined;
+}
+export declare function main(): Promise<MainResult>;

package/dist/mcp/arkConfig.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/mcp/checkSuite.d.ts

@@ -0,0 +1,9 @@
+import type { ToolContext } from "./server.ts";
+export declare const GetCheckSuiteLogs: import("arktype/internal/variants/object.ts").ObjectType<{
+    check_suite_id: number;
+}, {}>;
+export declare function GetCheckSuiteLogsTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
+    check_suite_id: number;
+}, {
+    check_suite_id: number;
+}>>;

package/dist/mcp/checkout.d.ts

@@ -0,0 +1,63 @@
+import type { RestEndpointMethodTypes } from "@octokit/rest";
+import type { ToolContext } from "./server.ts";
+type PullFile = RestEndpointMethodTypes["pulls"]["listFiles"]["response"]["data"][number];
+export type FormatFilesResult = {
+    content: string;
+    toc: string;
+};
+/**
+ * formats PR files with explicit line numbers for each code line.
+ * preserves all original diff info (file headers, hunk headers) and adds:
+ * | OLD | NEW | TYPE | code
+ * returns both the formatted content and a TOC with line ranges per file.
+ */
+export declare function formatFilesWithLineNumbers(files: PullFile[]): FormatFilesResult;
+export declare const CheckoutPr: import("arktype/internal/variants/object.ts").ObjectType<{
+    pull_number: number;
+}, {}>;
+export type CheckoutPrResult = {
+    success: true;
+    number: number;
+    title: string;
+    base: string;
+    localBranch: string;
+    remoteBranch: string;
+    isFork: boolean;
+    maintainerCanModify: boolean;
+    url: string;
+    headRepo: string;
+    diffPath: string;
+    incrementalDiffPath?: string | undefined;
+    toc: string;
+    instructions: string;
+};
+/**
+ * fetches PR files from GitHub and formats them with line numbers and TOC.
+ * this is the core diff formatting logic, extracted for testability.
+ */
+export declare function fetchAndFormatPrDiff(ctx: ToolContext, pullNumber: number): Promise<FormatFilesResult>;
+import type { GitContext } from "../utils/setup.ts";
+export type PrData = {
+    number: number;
+    headSha: string;
+    headRef: string;
+    headRepoFullName: string;
+    baseRef: string;
+    baseRepoFullName: string;
+    maintainerCanModify: boolean;
+};
+type CheckoutPrBranchParams = GitContext & {
+    beforeSha?: string | undefined;
+};
+/**
+ * Shared helper to checkout a PR branch and configure fork remotes.
+ * Assumes origin remote is already configured with authentication.
+ * Updates toolState.issueNumber, toolState.checkoutSha, and toolState.pushUrl (for fork PRs).
+ */
+export declare function checkoutPrBranch(pr: PrData, params: CheckoutPrBranchParams): Promise<void>;
+export declare function CheckoutPrTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
+    pull_number: number;
+}, {
+    pull_number: number;
+}>>;
+export {};

package/dist/mcp/comment.d.ts

@@ -0,0 +1,87 @@
+import type { ToolContext } from "./server.ts";
+type CommentNodeIdField = "planCommentNodeId" | "summaryCommentNodeId";
+export declare function updateCommentNodeId(ctx: ToolContext, field: CommentNodeIdField, nodeId: string): Promise<void>;
+/**
+ * The prefix text for the initial "leaping into action" comment.
+ * This is used to identify if a comment is still in its initial state
+ * and hasn't been updated with progress or error messages.
+ */
+export declare const LEAPING_INTO_ACTION_PREFIX = "Leaping into action";
+export declare function addFooter(ctx: ToolContext, body: string): string;
+export declare const Comment: import("arktype/internal/variants/object.ts").ObjectType<{
+    issueNumber: number;
+    body: string;
+    type?: "Plan" | "Summary" | "Comment";
+}, {}>;
+export declare function CreateCommentTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
+    issueNumber: number;
+    body: string;
+    type?: "Plan" | "Summary" | "Comment";
+}, {
+    issueNumber: number;
+    body: string;
+    type?: "Plan" | "Summary" | "Comment";
+}>>;
+export declare const EditComment: import("arktype/internal/variants/object.ts").ObjectType<{
+    commentId: number;
+    body: string;
+}, {}>;
+export declare function EditCommentTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
+    commentId: number;
+    body: string;
+}, {
+    commentId: number;
+    body: string;
+}>>;
+export declare const ReportProgress: import("arktype/internal/variants/object.ts").ObjectType<{
+    body: string;
+    target_plan_comment?: boolean;
+}, {}>;
+/**
+ * Report progress to a GitHub comment.
+ *
+ * progressCommentId has three states:
+ *   - undefined: no comment yet — will create one if an issue/PR target exists
+ *   - number:    active comment — will update it in place
+ *   - null:      deliberately deleted (e.g. after submitting a PR review) — skips silently
+ *
+ * The body is always tracked in lastProgressBody for the job summary regardless of comment state.
+ */
+export declare function reportProgress(ctx: ToolContext, params: {
+    body: string;
+    target_plan_comment?: boolean;
+}): Promise<{
+    commentId?: number;
+    url?: string;
+    body: string;
+    action: "created" | "updated" | "skipped";
+}>;
+export declare function ReportProgressTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
+    body: string;
+    target_plan_comment?: boolean;
+}, {
+    body: string;
+    target_plan_comment?: boolean;
+}>>;
+/**
+ * Delete the progress comment if it exists.
+ * Used by main.ts for stranded-comment cleanup (orphaned "Leaping into action" or
+ * checklist left by the todo tracker when the agent didn't call report_progress).
+ * Sets progressCommentId to null so subsequent report_progress calls are no-ops.
+ */
+export declare function deleteProgressComment(ctx: ToolContext): Promise<boolean>;
+export declare const ReplyToReviewComment: import("arktype/internal/variants/object.ts").ObjectType<{
+    pull_number: number;
+    comment_id: number;
+    body: string;
+}, {}>;
+export declare function ReplyToReviewCommentTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
+    pull_number: number;
+    comment_id: number;
+    body: string;
+}, {
+    pull_number: number;
+    comment_id: number;
+    body: string;
+}>>;
+export {};

package/dist/mcp/commitInfo.d.ts

@@ -0,0 +1,9 @@
+import type { ToolContext } from "./server.ts";
+export declare const CommitInfo: import("arktype/internal/variants/object.ts").ObjectType<{
+    sha: string;
+}, {}>;
+export declare function CommitInfoTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
+    sha: string;
+}, {
+    sha: string;
+}>>;

package/dist/mcp/dependencies.d.ts

@@ -0,0 +1,3 @@
+import type { ToolContext } from "./server.ts";
+export declare function StartDependencyInstallationTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<object, object>>;
+export declare function AwaitDependencyInstallationTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<object, object>>;

package/dist/mcp/git.d.ts

@@ -0,0 +1,38 @@
+import type { ToolContext } from "./server.ts";
+export declare const PushBranch: import("arktype/internal/variants/object.ts").ObjectType<{
+    force: import("arktype/internal/attributes.ts").Default<boolean, false>;
+    branchName?: string;
+}, {}>;
+export declare function PushBranchTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
+    branchName?: string;
+    force?: boolean;
+}, {
+    branchName?: string;
+    force?: boolean;
+}>>;
+export declare function GitTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
+    subcommand: string;
+    args?: string[];
+}, {
+    subcommand: string;
+    args?: string[];
+}>>;
+export declare function GitFetchTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
+    ref: string;
+    depth?: number;
+}, {
+    ref: string;
+    depth?: number;
+}>>;
+export declare function DeleteBranchTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
+    branchName: string;
+}, {
+    branchName: string;
+}>>;
+export declare function PushTagsTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
+    tag: string;
+    force?: boolean;
+}, {
+    tag: string;
+    force?: boolean;
+}>>;

package/dist/mcp/issue.d.ts

@@ -0,0 +1,18 @@
+import type { ToolContext } from "./server.ts";
+export declare const Issue: import("arktype/internal/variants/object.ts").ObjectType<{
+    title: string;
+    body: string;
+    labels?: string[];
+    assignees?: string[];
+}, {}>;
+export declare function IssueTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
+    title: string;
+    body: string;
+    labels?: string[];
+    assignees?: string[];
+}, {
+    title: string;
+    body: string;
+    labels?: string[];
+    assignees?: string[];
+}>>;

package/dist/mcp/issueComments.d.ts

@@ -0,0 +1,9 @@
+import type { ToolContext } from "./server.ts";
+export declare const GetIssueComments: import("arktype/internal/variants/object.ts").ObjectType<{
+    issue_number: number;
+}, {}>;
+export declare function GetIssueCommentsTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
+    issue_number: number;
+}, {
+    issue_number: number;
+}>>;

package/dist/mcp/issueEvents.d.ts

@@ -0,0 +1,9 @@
+import type { ToolContext } from "./server.ts";
+export declare const GetIssueEvents: import("arktype/internal/variants/object.ts").ObjectType<{
+    issue_number: number;
+}, {}>;
+export declare function GetIssueEventsTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
+    issue_number: number;
+}, {
+    issue_number: number;
+}>>;

package/dist/mcp/issueInfo.d.ts

@@ -0,0 +1,9 @@
+import type { ToolContext } from "./server.ts";
+export declare const IssueInfo: import("arktype/internal/variants/object.ts").ObjectType<{
+    issue_number: number;
+}, {}>;
+export declare function IssueInfoTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
+    issue_number: number;
+}, {
+    issue_number: number;
+}>>;

package/dist/mcp/labels.d.ts

@@ -0,0 +1,12 @@
+import type { ToolContext } from "./server.ts";
+export declare const AddLabelsParams: import("arktype/internal/variants/object.ts").ObjectType<{
+    issue_number: number;
+    labels: string[];
+}, {}>;
+export declare function AddLabelsTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
+    issue_number: number;
+    labels: string[];
+}, {
+    issue_number: number;
+    labels: string[];
+}>>;

package/dist/mcp/learnings.d.ts

@@ -0,0 +1,6 @@
+import type { ToolContext } from "./server.ts";
+export declare function UpdateLearningsTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
+    learnings: string;
+}, {
+    learnings: string;
+}>>;

package/dist/mcp/output.d.ts

@@ -0,0 +1,12 @@
+import type { StandardSchemaV1 } from "@standard-schema/spec";
+import type { ToolContext } from "./server.ts";
+export declare const SetOutputParams: import("arktype/internal/variants/object.ts").ObjectType<{
+    value: string;
+}, {}>;
+type JsonSchema = Record<string, unknown>;
+export declare function SetOutputTool(ctx: ToolContext, outputSchema?: JsonSchema): import("fastmcp").Tool<any, StandardSchemaV1<any, any>> | import("fastmcp").Tool<any, StandardSchemaV1<{
+    value: string;
+}, {
+    value: string;
+}>>;
+export {};

package/dist/mcp/pr.d.ts

@@ -0,0 +1,29 @@
+import type { ToolContext } from "./server.ts";
+export declare const PullRequest: import("arktype/internal/variants/object.ts").ObjectType<{
+    title: string;
+    body: string;
+    base: string;
+    draft?: boolean;
+}, {}>;
+export declare const UpdatePullRequestBody: import("arktype/internal/variants/object.ts").ObjectType<{
+    pull_number: number;
+    body: string;
+}, {}>;
+export declare function UpdatePullRequestBodyTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
+    pull_number: number;
+    body: string;
+}, {
+    pull_number: number;
+    body: string;
+}>>;
+export declare function CreatePullRequestTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
+    title: string;
+    body: string;
+    base: string;
+    draft?: boolean;
+}, {
+    title: string;
+    body: string;
+    base: string;
+    draft?: boolean;
+}>>;

package/dist/mcp/prInfo.d.ts

@@ -0,0 +1,9 @@
+import type { ToolContext } from "./server.ts";
+export declare const PullRequestInfo: import("arktype/internal/variants/object.ts").ObjectType<{
+    pull_number: number;
+}, {}>;
+export declare function PullRequestInfoTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
+    pull_number: number;
+}, {
+    pull_number: number;
+}>>;

package/dist/mcp/review.d.ts

@@ -0,0 +1,47 @@
+import type { ToolContext } from "./server.ts";
+export declare const CreatePullRequestReview: import("arktype/internal/variants/object.ts").ObjectType<{
+    pull_number: number;
+    body?: string;
+    approved?: boolean;
+    commit_id?: string;
+    comments?: {
+        path: string;
+        line: number;
+        side?: "LEFT" | "RIGHT";
+        body?: string;
+        suggestion?: string;
+        start_line?: number;
+    }[];
+}, {}>;
+export declare function CreatePullRequestReviewTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
+    pull_number: number;
+    body?: string;
+    approved?: boolean;
+    commit_id?: string;
+    comments?: {
+        path: string;
+        line: number;
+        side?: "LEFT" | "RIGHT";
+        body?: string;
+        suggestion?: string;
+        start_line?: number;
+    }[];
+}, {
+    pull_number: number;
+    body?: string;
+    approved?: boolean;
+    commit_id?: string;
+    comments?: {
+        path: string;
+        line: number;
+        side?: "LEFT" | "RIGHT";
+        body?: string;
+        suggestion?: string;
+        start_line?: number;
+    }[];
+}>>;
+/**
+ * report the review node ID to the server so the WorkflowRun is marked as "review submitted".
+ * exported for use in main.ts post-agent cleanup.
+ */
+export declare function reportReviewNodeId(ctx: ToolContext, reviewNodeId: string): Promise<void>;

package/dist/mcp/reviewComments.d.ts

@@ -0,0 +1,135 @@
+import type { Octokit } from "@octokit/rest";
+import type { ToolContext } from "./server.ts";
+export declare const REVIEW_THREADS_QUERY = "\nquery ($owner: String!, $name: String!, $prNumber: Int!) {\n  repository(owner: $owner, name: $name) {\n    pullRequest(number: $prNumber) {\n      reviewThreads(first: 100) {\n        nodes {\n          id\n          path\n          line\n          startLine\n          diffSide\n          isResolved\n          isOutdated\n          comments(first: 50) {\n            nodes {\n              fullDatabaseId\n              body\n              createdAt\n              diffHunk\n              line\n              startLine\n              originalLine\n              originalStartLine\n              author { login }\n              pullRequestReview {\n                databaseId\n                author { login }\n              }\n              reactionGroups {\n                content\n                reactors(first: 10) {\n                  nodes {\n                    ... on Actor { login }\n                  }\n                }\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n}\n";
+export type ReviewThreadComment = {
+    fullDatabaseId: string | null;
+    body: string;
+    createdAt: string;
+    diffHunk: string;
+    line: number | null;
+    startLine: number | null;
+    originalLine: number | null;
+    originalStartLine: number | null;
+    author: {
+        login: string;
+    } | null;
+    pullRequestReview: {
+        databaseId: number | null;
+        author: {
+            login: string;
+        } | null;
+    } | null;
+    reactionGroups: Array<{
+        content: string;
+        reactors: {
+            nodes: Array<{
+                login: string;
+            } | null> | null;
+        } | null;
+    }> | null;
+};
+export type ReviewThread = {
+    id: string;
+    path: string;
+    line: number | null;
+    startLine: number | null;
+    diffSide: "LEFT" | "RIGHT";
+    isResolved: boolean;
+    isOutdated: boolean;
+    comments: {
+        nodes: (ReviewThreadComment | null)[] | null;
+    } | null;
+};
+export type ReviewThreadsQueryResponse = {
+    repository: {
+        pullRequest: {
+            reviewThreads: {
+                nodes: (ReviewThread | null)[] | null;
+            } | null;
+        } | null;
+    } | null;
+};
+export declare function countLines(str: string): number;
+export type ParsedHunk = {
+    header: string;
+    oldStart: number;
+    oldCount: number;
+    newStart: number;
+    newCount: number;
+    content: string[];
+};
+export declare function parseFilePatches(patch: string): ParsedHunk[];
+export declare const GetReviewComments: import("arktype/internal/variants/object.ts").ObjectType<{
+    pull_number: number;
+    review_id: number;
+}, {}>;
+/**
+ * formats thread blocks into markdown with TOC and line numbers.
+ * extracted for testability.
+ */
+export declare function formatReviewThreads(threadBlocks: Array<{
+    path: string;
+    lineRange: string;
+    content: string[];
+}>, header: {
+    pullNumber: number;
+    reviewId: number;
+    reviewer: string;
+    reviewBody?: string;
+}): {
+    toc: string;
+    content: string;
+};
+/**
+ * builds thread blocks from review threads and file patches.
+ * extracted for testability.
+ */
+export declare function buildThreadBlocks(threads: ReviewThread[], filePatchMap: Map<string, ParsedHunk[]>, reviewId: number): {
+    path: string;
+    lineRange: string;
+    content: string[];
+}[];
+interface GetReviewDataInput {
+    octokit: Octokit;
+    owner: string;
+    name: string;
+    pullNumber: number;
+    reviewId: number;
+    approvedBy?: string | undefined;
+}
+export declare function getReviewData(input: GetReviewDataInput): Promise<{
+    threadBlocks: Array<{
+        path: string;
+        lineRange: string;
+        content: string[];
+    }>;
+    reviewer: string;
+    formatted: {
+        toc: string;
+        content: string;
+    };
+} | undefined>;
+export declare function GetReviewCommentsTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
+    pull_number: number;
+    review_id: number;
+}, {
+    pull_number: number;
+    review_id: number;
+}>>;
+export declare const ListPullRequestReviews: import("arktype/internal/variants/object.ts").ObjectType<{
+    pull_number: number;
+}, {}>;
+export declare function ListPullRequestReviewsTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
+    pull_number: number;
+}, {
+    pull_number: number;
+}>>;
+export declare const ResolveReviewThread: import("arktype/internal/variants/object.ts").ObjectType<{
+    thread_id: string;
+}, {}>;
+export declare function ResolveReviewThreadTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
+    thread_id: string;
+}, {
+    thread_id: string;
+}>>;
+export {};

package/dist/mcp/selectMode.d.ts

@@ -0,0 +1,24 @@
+import type { ToolContext } from "./server.ts";
+export declare const SelectModeParams: import("arktype/internal/variants/object.ts").ObjectType<{
+    mode: string;
+    issue_number?: number;
+}, {}>;
+export type PlanCommentResponsePayload = {
+    error: string;
+} | {
+    commentId: number;
+    body: string;
+};
+export type SummaryCommentResponsePayload = {
+    error: string;
+} | {
+    commentId: number;
+    body: string;
+};
+export declare function SelectModeTool(ctx: ToolContext): import("fastmcp").Tool<any, import("@standard-schema/spec").StandardSchemaV1<{
+    mode: string;
+    issue_number?: number;
+}, {
+    mode: string;
+    issue_number?: number;
+}>>;

package/dist/mcp/server.d.ts

@@ -0,0 +1,93 @@
+import "./arkConfig.ts";
+import type { AgentUsage } from "../agents/index.ts";
+import { type AgentId } from "../external.ts";
+import type { Mode } from "../modes.ts";
+import type { PrepResult } from "../prep/index.ts";
+import type { OctokitWithPlugins } from "../utils/github.ts";
+import type { ResolvedPayload } from "../utils/payload.ts";
+import type { RunContextData } from "../utils/runContextData.ts";
+import type { TodoTracker } from "../utils/todoTracking.ts";
+export type BackgroundProcess = {
+    pid: number;
+    outputPath: string;
+    pidPath: string;
+};
+export type BrowserDaemon = {
+    binDir: string;
+    error?: never;
+} | {
+    binDir?: never;
+    error: string;
+};
+export type StoredPushDest = {
+    remoteName: string;
+    remoteBranch: string;
+    localBranch: string;
+};
+export interface ToolState {
+    pushUrl?: string;
+    pushDest?: StoredPushDest;
+    issueNumber?: number;
+    checkoutSha?: string;
+    beforeSha?: string;
+    selectedMode?: string;
+    backgroundProcesses: Map<string, BackgroundProcess>;
+    browserDaemon?: BrowserDaemon | undefined;
+    review?: {
+        id: number;
+        nodeId: string;
+        reviewedSha: string | undefined;
+    };
+    dependencyInstallation?: {
+        status: "not_started" | "in_progress" | "completed" | "failed";
+        promise: Promise<PrepResult[]> | undefined;
+        results: PrepResult[] | undefined;
+    };
+    progressCommentId: number | null | undefined;
+    hadProgressComment: boolean;
+    lastProgressBody?: string;
+    wasUpdated?: boolean;
+    finalSummaryWritten?: boolean;
+    existingPlanCommentId?: number;
+    previousPlanBody?: string;
+    existingSummaryCommentId?: number;
+    output?: string;
+    usageEntries: AgentUsage[];
+    model?: string | undefined;
+    todoTracker?: TodoTracker | undefined;
+}
+interface InitToolStateParams {
+    progressCommentId: string | undefined;
+}
+export declare function initToolState(params: InitToolStateParams): ToolState;
+export interface ToolContext {
+    agentId: AgentId;
+    repo: RunContextData["repo"];
+    payload: ResolvedPayload;
+    octokit: OctokitWithPlugins;
+    githubInstallationToken: string;
+    gitToken: string;
+    apiToken: string;
+    modes: Mode[];
+    postCheckoutScript: string | null;
+    prepushScript: string | null;
+    prApproveEnabled: boolean;
+    modeInstructions: Record<string, string>;
+    toolState: ToolState;
+    runId: number | undefined;
+    jobId: string | undefined;
+    mcpServerUrl: string;
+    tmpdir: string;
+}
+type JsonSchema = Record<string, unknown>;
+type McpHttpServerOptions = {
+    outputSchema?: JsonSchema | undefined;
+};
+/**
+ * Start the MCP HTTP server.
+ */
+export declare function startMcpHttpServer(ctx: ToolContext, options?: McpHttpServerOptions): Promise<{
+    url: string;
+    [Symbol.asyncDispose]: () => Promise<void>;
+}>;
+export {};