@urateam/core 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,1230 @@
+import { z } from "zod";
+export declare const StageTypeSchema: z.ZodEnum<["triage", "await-approval", "reproduce", "implement", "test", "review"]>;
+export type StageType = z.infer<typeof StageTypeSchema>;
+export declare const AGENT_STAGES: StageType[];
+export declare const RetryStrategySchema: z.ZodEnum<["fix-and-retry", "escalate", "fail-fast"]>;
+export type RetryStrategy = z.infer<typeof RetryStrategySchema>;
+export declare const RetryConfigSchema: z.ZodObject<{
+    maxAttempts: z.ZodNumber;
+    strategy: z.ZodEnum<["fix-and-retry", "escalate", "fail-fast"]>;
+}, "strip", z.ZodTypeAny, {
+    maxAttempts: number;
+    strategy: "fix-and-retry" | "escalate" | "fail-fast";
+}, {
+    maxAttempts: number;
+    strategy: "fix-and-retry" | "escalate" | "fail-fast";
+}>;
+export type RetryConfig = z.infer<typeof RetryConfigSchema>;
+export declare const ReviewConfigSchema: z.ZodObject<{
+    requiredApprovals: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    requiredApprovals: number;
+}, {
+    requiredApprovals: number;
+}>;
+export type ReviewConfig = z.infer<typeof ReviewConfigSchema>;
+export declare const PipelineConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    stages: z.ZodArray<z.ZodEnum<["triage", "await-approval", "reproduce", "implement", "test", "review"]>, "many">;
+    retry: z.ZodObject<{
+        maxAttempts: z.ZodNumber;
+        strategy: z.ZodEnum<["fix-and-retry", "escalate", "fail-fast"]>;
+    }, "strip", z.ZodTypeAny, {
+        maxAttempts: number;
+        strategy: "fix-and-retry" | "escalate" | "fail-fast";
+    }, {
+        maxAttempts: number;
+        strategy: "fix-and-retry" | "escalate" | "fail-fast";
+    }>;
+    review: z.ZodObject<{
+        requiredApprovals: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        requiredApprovals: number;
+    }, {
+        requiredApprovals: number;
+    }>;
+    prStrategy: z.ZodEnum<["draft", "ready"]>;
+    /** Run a lightweight validation agent after each stage to verify handoff accuracy.
+     *  Default: false. Set to true to opt in (adds ~15-20K tokens per run). */
+    validateHandoffs: z.ZodOptional<z.ZodBoolean>;
+    /** RALPH loop iterations for the implement stage. 0 disables. Default: 1.
+     *  Set to 2 for more thorough requirements checking (adds ~100-200K tokens per iteration). */
+    ralphIterations: z.ZodOptional<z.ZodNumber>;
+    /** Review-fix loop iterations. When review finds blocking issues, re-run implement→test→review.
+     *  Default: 1, 0 disables. WARNING: compounds with ralphIterations — worst case is
+     *  reviewFixIterations × (1 + ralphIterations) implement runs per fix cycle.
+     *  Set to 2 for an extra fix pass (adds ~150-300K tokens per iteration). */
+    reviewFixIterations: z.ZodOptional<z.ZodNumber>;
+    /** Deep review passes using 3 parallel sub-agents (reuse, quality, efficiency).
+     *  Runs after the review-fix loop resolves blocking findings. Default: 0 (disabled).
+     *  Set to 1 to opt in for critical pipelines (adds ~45-100K tokens per pass). */
+    deepReviewPasses: z.ZodOptional<z.ZodNumber>;
+    /** Hard cap on deep review passes. Prevents infinite loops. Default: 3. */
+    maxDeepReviewPasses: z.ZodOptional<z.ZodNumber>;
+    /** Auto-merge PRs when changes are trivial. Default: false (opt-in). */
+    autoMerge: z.ZodOptional<z.ZodBoolean>;
+    /** Max diff lines for auto-merge eligibility. Default: 200. */
+    autoMergeMaxLines: z.ZodOptional<z.ZodNumber>;
+    /** File glob patterns that require manual review (skip auto-merge if any changed file matches).
+     *  Example: ["**\/migrations\/**", "**\/*.env", "infra\/**"]  */
+    autoMergeExcludePatterns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * Advanced automerge criteria evaluated when GitHub sends a PR event (check_suite.completed,
+     * status, pull_request.labeled, etc.).  All criteria must pass for the PR to be merged.
+     * Requires GitHub App credentials (github config in ServerConfig).
+     */
+    autoMergeConfig: z.ZodOptional<z.ZodObject<{
+        /** Minimum number of unique approving reviews required. Default: 0. */
+        minimumApprovingReviews: z.ZodOptional<z.ZodNumber>;
+        /** Status check context names (or check run names) that must all report "success".
+         *  Example: ["ci/tests", "security/snyk"]  */
+        requiredStatusChecks: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** Labels the PR must carry — all listed labels must be present. Default: [] */
+        requiredLabels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** Allowed base branches for auto-merge. If empty, any base branch is allowed. */
+        allowedBranches: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** Merge method to use when merging the PR. Default: "squash". */
+        mergeMethod: z.ZodOptional<z.ZodEnum<["merge", "squash", "rebase"]>>;
+    }, "strip", z.ZodTypeAny, {
+        minimumApprovingReviews?: number | undefined;
+        requiredStatusChecks?: string[] | undefined;
+        requiredLabels?: string[] | undefined;
+        allowedBranches?: string[] | undefined;
+        mergeMethod?: "merge" | "squash" | "rebase" | undefined;
+    }, {
+        minimumApprovingReviews?: number | undefined;
+        requiredStatusChecks?: string[] | undefined;
+        requiredLabels?: string[] | undefined;
+        allowedBranches?: string[] | undefined;
+        mergeMethod?: "merge" | "squash" | "rebase" | undefined;
+    }>>;
+    /** Maximum total tokens (input + output) allowed per pipeline run. Exceeding this aborts the run. */
+    maxTokens: z.ZodOptional<z.ZodNumber>;
+    /** Per-stage model overrides. Keys are stage names; values are model strings passed to the Agent SDK.
+     *  Invalid model strings are passed through as-is (let the SDK error, no local validation).
+     *  Example: { implement: "claude-opus-4-6", test: "claude-haiku-4-5" } */
+    stageModels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    /** Fail the pipeline run if the agent did not commit its work and auto-commit was triggered.
+     *  When false (default), auto-commit is a silent safety net and the run continues normally.
+     *  When true, triggering auto-commit is treated as a pipeline error so the issue surfaces immediately. */
+    failOnAutoCommit: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    review: {
+        requiredApprovals: number;
+    };
+    name: string;
+    stages: ("triage" | "await-approval" | "reproduce" | "implement" | "test" | "review")[];
+    retry: {
+        maxAttempts: number;
+        strategy: "fix-and-retry" | "escalate" | "fail-fast";
+    };
+    prStrategy: "draft" | "ready";
+    validateHandoffs?: boolean | undefined;
+    ralphIterations?: number | undefined;
+    reviewFixIterations?: number | undefined;
+    deepReviewPasses?: number | undefined;
+    maxDeepReviewPasses?: number | undefined;
+    autoMerge?: boolean | undefined;
+    autoMergeMaxLines?: number | undefined;
+    autoMergeExcludePatterns?: string[] | undefined;
+    autoMergeConfig?: {
+        minimumApprovingReviews?: number | undefined;
+        requiredStatusChecks?: string[] | undefined;
+        requiredLabels?: string[] | undefined;
+        allowedBranches?: string[] | undefined;
+        mergeMethod?: "merge" | "squash" | "rebase" | undefined;
+    } | undefined;
+    maxTokens?: number | undefined;
+    stageModels?: Record<string, string> | undefined;
+    failOnAutoCommit?: boolean | undefined;
+}, {
+    review: {
+        requiredApprovals: number;
+    };
+    name: string;
+    stages: ("triage" | "await-approval" | "reproduce" | "implement" | "test" | "review")[];
+    retry: {
+        maxAttempts: number;
+        strategy: "fix-and-retry" | "escalate" | "fail-fast";
+    };
+    prStrategy: "draft" | "ready";
+    validateHandoffs?: boolean | undefined;
+    ralphIterations?: number | undefined;
+    reviewFixIterations?: number | undefined;
+    deepReviewPasses?: number | undefined;
+    maxDeepReviewPasses?: number | undefined;
+    autoMerge?: boolean | undefined;
+    autoMergeMaxLines?: number | undefined;
+    autoMergeExcludePatterns?: string[] | undefined;
+    autoMergeConfig?: {
+        minimumApprovingReviews?: number | undefined;
+        requiredStatusChecks?: string[] | undefined;
+        requiredLabels?: string[] | undefined;
+        allowedBranches?: string[] | undefined;
+        mergeMethod?: "merge" | "squash" | "rebase" | undefined;
+    } | undefined;
+    maxTokens?: number | undefined;
+    stageModels?: Record<string, string> | undefined;
+    failOnAutoCommit?: boolean | undefined;
+}>;
+export type PipelineConfig = z.infer<typeof PipelineConfigSchema>;
+export declare const TriggerMapSchema: z.ZodObject<{
+    start: z.ZodString;
+    resume: z.ZodString;
+    pause: z.ZodString;
+    abort: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    start: string;
+    resume: string;
+    pause: string;
+    abort: string;
+}, {
+    start: string;
+    resume: string;
+    pause: string;
+    abort: string;
+}>;
+export type TriggerMap = z.infer<typeof TriggerMapSchema>;
+export declare const DEFAULT_TRIGGER_MAP: TriggerMap;
+export declare const SetupCommandSchema: z.ZodArray<z.ZodString, "many">;
+export type SetupCommand = z.infer<typeof SetupCommandSchema>;
+export declare const McpServerEntrySchema: z.ZodObject<{
+    command: z.ZodString;
+    args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    command: string;
+    args?: string[] | undefined;
+    env?: Record<string, string> | undefined;
+}, {
+    command: string;
+    args?: string[] | undefined;
+    env?: Record<string, string> | undefined;
+}>;
+export declare const PluginEntrySchema: z.ZodObject<{
+    type: z.ZodLiteral<"local">;
+    path: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    type: "local";
+}, {
+    path: string;
+    type: "local";
+}>;
+export declare const PluginConfigSchema: z.ZodObject<{
+    /** Explicit MCP servers to always include */
+    mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        command: z.ZodString;
+        args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        command: string;
+        args?: string[] | undefined;
+        env?: Record<string, string> | undefined;
+    }, {
+        command: string;
+        args?: string[] | undefined;
+        env?: Record<string, string> | undefined;
+    }>>>;
+    /** MCP server names to never include */
+    excludeMcpServers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Explicit plugins to always include */
+    plugins: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodLiteral<"local">;
+        path: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        type: "local";
+    }, {
+        path: string;
+        type: "local";
+    }>, "many">>;
+    /** Plugin paths to never include */
+    excludePlugins: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Set to false to disable auto-detection of plugins/MCP servers */
+    autoDetect: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    mcpServers?: Record<string, {
+        command: string;
+        args?: string[] | undefined;
+        env?: Record<string, string> | undefined;
+    }> | undefined;
+    excludeMcpServers?: string[] | undefined;
+    plugins?: {
+        path: string;
+        type: "local";
+    }[] | undefined;
+    excludePlugins?: string[] | undefined;
+    autoDetect?: boolean | undefined;
+}, {
+    mcpServers?: Record<string, {
+        command: string;
+        args?: string[] | undefined;
+        env?: Record<string, string> | undefined;
+    }> | undefined;
+    excludeMcpServers?: string[] | undefined;
+    plugins?: {
+        path: string;
+        type: "local";
+    }[] | undefined;
+    excludePlugins?: string[] | undefined;
+    autoDetect?: boolean | undefined;
+}>;
+export type PluginConfig = z.infer<typeof PluginConfigSchema>;
+export declare const DevcontainerConfigSchema: z.ZodObject<{
+    /** Enable devcontainer usage. Default: "auto" (use if .devcontainer exists) */
+    mode: z.ZodOptional<z.ZodEnum<["auto", "always", "never"]>>;
+    /** Override path to devcontainer config */
+    configPath: z.ZodOptional<z.ZodString>;
+    /** Extra environment variables for the container */
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    env?: Record<string, string> | undefined;
+    mode?: "never" | "auto" | "always" | undefined;
+    configPath?: string | undefined;
+}, {
+    env?: Record<string, string> | undefined;
+    mode?: "never" | "auto" | "always" | undefined;
+    configPath?: string | undefined;
+}>;
+export type DevcontainerConfig = z.infer<typeof DevcontainerConfigSchema>;
+export declare const GitHubFeedbackConfigSchema: z.ZodObject<{
+    /**
+     * GitHub logins allowed to trigger feedback runs.
+     * If empty/omitted, any reviewer can trigger.
+     */
+    allowedReviewers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * GitHub logins that should never trigger feedback runs (e.g. the bot itself).
+     */
+    botLogins: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * If provided, only comments containing this keyword trigger a feedback run.
+     * When omitted and autoTrigger is true (the default), any qualifying comment triggers.
+     * Example: "@agent fix this"
+     */
+    triggerKeyword: z.ZodOptional<z.ZodString>;
+    /**
+     * If true (default), any qualifying review comment automatically triggers a feedback run.
+     * Set to false to require the triggerKeyword to be present.
+     */
+    autoTrigger: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * If true, re-request review on the PR after the feedback run pushes changes.
+     * Requires GitHub App credentials in server config. Default: false.
+     */
+    rerequestReview: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    allowedReviewers?: string[] | undefined;
+    botLogins?: string[] | undefined;
+    triggerKeyword?: string | undefined;
+    autoTrigger?: boolean | undefined;
+    rerequestReview?: boolean | undefined;
+}, {
+    allowedReviewers?: string[] | undefined;
+    botLogins?: string[] | undefined;
+    triggerKeyword?: string | undefined;
+    autoTrigger?: boolean | undefined;
+    rerequestReview?: boolean | undefined;
+}>;
+export type GitHubFeedbackConfig = z.infer<typeof GitHubFeedbackConfigSchema>;
+export declare const RepoConfigSchema: z.ZodObject<{
+    url: z.ZodString;
+    defaultBranch: z.ZodString;
+    testCommand: z.ZodString;
+    buildCommand: z.ZodString;
+    setupCommands: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodString, "many">, "many">>;
+    workingDirectory: z.ZodOptional<z.ZodString>;
+    plugins: z.ZodOptional<z.ZodObject<{
+        /** Explicit MCP servers to always include */
+        mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            command: z.ZodString;
+            args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            command: string;
+            args?: string[] | undefined;
+            env?: Record<string, string> | undefined;
+        }, {
+            command: string;
+            args?: string[] | undefined;
+            env?: Record<string, string> | undefined;
+        }>>>;
+        /** MCP server names to never include */
+        excludeMcpServers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** Explicit plugins to always include */
+        plugins: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodLiteral<"local">;
+            path: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            type: "local";
+        }, {
+            path: string;
+            type: "local";
+        }>, "many">>;
+        /** Plugin paths to never include */
+        excludePlugins: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** Set to false to disable auto-detection of plugins/MCP servers */
+        autoDetect: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        mcpServers?: Record<string, {
+            command: string;
+            args?: string[] | undefined;
+            env?: Record<string, string> | undefined;
+        }> | undefined;
+        excludeMcpServers?: string[] | undefined;
+        plugins?: {
+            path: string;
+            type: "local";
+        }[] | undefined;
+        excludePlugins?: string[] | undefined;
+        autoDetect?: boolean | undefined;
+    }, {
+        mcpServers?: Record<string, {
+            command: string;
+            args?: string[] | undefined;
+            env?: Record<string, string> | undefined;
+        }> | undefined;
+        excludeMcpServers?: string[] | undefined;
+        plugins?: {
+            path: string;
+            type: "local";
+        }[] | undefined;
+        excludePlugins?: string[] | undefined;
+        autoDetect?: boolean | undefined;
+    }>>;
+    devcontainer: z.ZodOptional<z.ZodObject<{
+        /** Enable devcontainer usage. Default: "auto" (use if .devcontainer exists) */
+        mode: z.ZodOptional<z.ZodEnum<["auto", "always", "never"]>>;
+        /** Override path to devcontainer config */
+        configPath: z.ZodOptional<z.ZodString>;
+        /** Extra environment variables for the container */
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        env?: Record<string, string> | undefined;
+        mode?: "never" | "auto" | "always" | undefined;
+        configPath?: string | undefined;
+    }, {
+        env?: Record<string, string> | undefined;
+        mode?: "never" | "auto" | "always" | undefined;
+        configPath?: string | undefined;
+    }>>;
+    /** Per-team trigger map. Overrides the global triggerMap for this team's repo. Falls back to DEFAULT_TRIGGER_MAP. */
+    triggerMap: z.ZodOptional<z.ZodObject<{
+        start: z.ZodString;
+        resume: z.ZodString;
+        pause: z.ZodString;
+        abort: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        start: string;
+        resume: string;
+        pause: string;
+        abort: string;
+    }, {
+        start: string;
+        resume: string;
+        pause: string;
+        abort: string;
+    }>>;
+    /** Hosting provider. Defaults to "github". Set to "gitlab" for GitLab repos. */
+    provider: z.ZodOptional<z.ZodEnum<["github", "gitlab"]>>;
+    /** Configuration for GitHub PR review comment → pipeline re-entry (feedback runs). */
+    githubFeedback: z.ZodOptional<z.ZodObject<{
+        /**
+         * GitHub logins allowed to trigger feedback runs.
+         * If empty/omitted, any reviewer can trigger.
+         */
+        allowedReviewers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /**
+         * GitHub logins that should never trigger feedback runs (e.g. the bot itself).
+         */
+        botLogins: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /**
+         * If provided, only comments containing this keyword trigger a feedback run.
+         * When omitted and autoTrigger is true (the default), any qualifying comment triggers.
+         * Example: "@agent fix this"
+         */
+        triggerKeyword: z.ZodOptional<z.ZodString>;
+        /**
+         * If true (default), any qualifying review comment automatically triggers a feedback run.
+         * Set to false to require the triggerKeyword to be present.
+         */
+        autoTrigger: z.ZodOptional<z.ZodBoolean>;
+        /**
+         * If true, re-request review on the PR after the feedback run pushes changes.
+         * Requires GitHub App credentials in server config. Default: false.
+         */
+        rerequestReview: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        allowedReviewers?: string[] | undefined;
+        botLogins?: string[] | undefined;
+        triggerKeyword?: string | undefined;
+        autoTrigger?: boolean | undefined;
+        rerequestReview?: boolean | undefined;
+    }, {
+        allowedReviewers?: string[] | undefined;
+        botLogins?: string[] | undefined;
+        triggerKeyword?: string | undefined;
+        autoTrigger?: boolean | undefined;
+        rerequestReview?: boolean | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    defaultBranch: string;
+    testCommand: string;
+    buildCommand: string;
+    plugins?: {
+        mcpServers?: Record<string, {
+            command: string;
+            args?: string[] | undefined;
+            env?: Record<string, string> | undefined;
+        }> | undefined;
+        excludeMcpServers?: string[] | undefined;
+        plugins?: {
+            path: string;
+            type: "local";
+        }[] | undefined;
+        excludePlugins?: string[] | undefined;
+        autoDetect?: boolean | undefined;
+    } | undefined;
+    setupCommands?: string[][] | undefined;
+    workingDirectory?: string | undefined;
+    devcontainer?: {
+        env?: Record<string, string> | undefined;
+        mode?: "never" | "auto" | "always" | undefined;
+        configPath?: string | undefined;
+    } | undefined;
+    triggerMap?: {
+        start: string;
+        resume: string;
+        pause: string;
+        abort: string;
+    } | undefined;
+    provider?: "github" | "gitlab" | undefined;
+    githubFeedback?: {
+        allowedReviewers?: string[] | undefined;
+        botLogins?: string[] | undefined;
+        triggerKeyword?: string | undefined;
+        autoTrigger?: boolean | undefined;
+        rerequestReview?: boolean | undefined;
+    } | undefined;
+}, {
+    url: string;
+    defaultBranch: string;
+    testCommand: string;
+    buildCommand: string;
+    plugins?: {
+        mcpServers?: Record<string, {
+            command: string;
+            args?: string[] | undefined;
+            env?: Record<string, string> | undefined;
+        }> | undefined;
+        excludeMcpServers?: string[] | undefined;
+        plugins?: {
+            path: string;
+            type: "local";
+        }[] | undefined;
+        excludePlugins?: string[] | undefined;
+        autoDetect?: boolean | undefined;
+    } | undefined;
+    setupCommands?: string[][] | undefined;
+    workingDirectory?: string | undefined;
+    devcontainer?: {
+        env?: Record<string, string> | undefined;
+        mode?: "never" | "auto" | "always" | undefined;
+        configPath?: string | undefined;
+    } | undefined;
+    triggerMap?: {
+        start: string;
+        resume: string;
+        pause: string;
+        abort: string;
+    } | undefined;
+    provider?: "github" | "gitlab" | undefined;
+    githubFeedback?: {
+        allowedReviewers?: string[] | undefined;
+        botLogins?: string[] | undefined;
+        triggerKeyword?: string | undefined;
+        autoTrigger?: boolean | undefined;
+        rerequestReview?: boolean | undefined;
+    } | undefined;
+}>;
+export type RepoConfig = z.infer<typeof RepoConfigSchema>;
+export declare const TestResultSchema: z.ZodObject<{
+    passed: z.ZodNumber;
+    failed: z.ZodNumber;
+    firstFailure: z.ZodOptional<z.ZodObject<{
+        test: z.ZodString;
+        error: z.ZodString;
+        file: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        test: string;
+        error: string;
+        file: string;
+    }, {
+        test: string;
+        error: string;
+        file: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    passed: number;
+    failed: number;
+    firstFailure?: {
+        test: string;
+        error: string;
+        file: string;
+    } | undefined;
+}, {
+    passed: number;
+    failed: number;
+    firstFailure?: {
+        test: string;
+        error: string;
+        file: string;
+    } | undefined;
+}>;
+export type TestResult = z.infer<typeof TestResultSchema>;
+export declare const ReviewFindingSchema: z.ZodObject<{
+    severity: z.ZodEnum<["blocking", "warning", "suggestion"]>;
+    file: z.ZodString;
+    line: z.ZodNumber;
+    category: z.ZodString;
+    description: z.ZodString;
+    fix: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    file: string;
+    severity: "blocking" | "warning" | "suggestion";
+    line: number;
+    category: string;
+    description: string;
+    fix: string;
+}, {
+    file: string;
+    severity: "blocking" | "warning" | "suggestion";
+    line: number;
+    category: string;
+    description: string;
+    fix: string;
+}>;
+export type ReviewFinding = z.infer<typeof ReviewFindingSchema>;
+export declare const HandoffArtifactSchema: z.ZodObject<{
+    runId: z.ZodString;
+    issueId: z.ZodString;
+    stage: z.ZodString;
+    timestamp: z.ZodString;
+    summary: z.ZodString;
+    filesChanged: z.ZodArray<z.ZodString, "many">;
+    approach: z.ZodString;
+    context: z.ZodObject<{
+        issueIntent: z.ZodString;
+        constraints: z.ZodArray<z.ZodString, "many">;
+        assumptions: z.ZodArray<z.ZodString, "many">;
+        testResults: z.ZodOptional<z.ZodObject<{
+            passed: z.ZodNumber;
+            failed: z.ZodNumber;
+            firstFailure: z.ZodOptional<z.ZodObject<{
+                test: z.ZodString;
+                error: z.ZodString;
+                file: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                test: string;
+                error: string;
+                file: string;
+            }, {
+                test: string;
+                error: string;
+                file: string;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            passed: number;
+            failed: number;
+            firstFailure?: {
+                test: string;
+                error: string;
+                file: string;
+            } | undefined;
+        }, {
+            passed: number;
+            failed: number;
+            firstFailure?: {
+                test: string;
+                error: string;
+                file: string;
+            } | undefined;
+        }>>;
+        reviewFindings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            severity: z.ZodEnum<["blocking", "warning", "suggestion"]>;
+            file: z.ZodString;
+            line: z.ZodNumber;
+            category: z.ZodString;
+            description: z.ZodString;
+            fix: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            file: string;
+            severity: "blocking" | "warning" | "suggestion";
+            line: number;
+            category: string;
+            description: string;
+            fix: string;
+        }, {
+            file: string;
+            severity: "blocking" | "warning" | "suggestion";
+            line: number;
+            category: string;
+            description: string;
+            fix: string;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        issueIntent: string;
+        constraints: string[];
+        assumptions: string[];
+        testResults?: {
+            passed: number;
+            failed: number;
+            firstFailure?: {
+                test: string;
+                error: string;
+                file: string;
+            } | undefined;
+        } | undefined;
+        reviewFindings?: {
+            file: string;
+            severity: "blocking" | "warning" | "suggestion";
+            line: number;
+            category: string;
+            description: string;
+            fix: string;
+        }[] | undefined;
+    }, {
+        issueIntent: string;
+        constraints: string[];
+        assumptions: string[];
+        testResults?: {
+            passed: number;
+            failed: number;
+            firstFailure?: {
+                test: string;
+                error: string;
+                file: string;
+            } | undefined;
+        } | undefined;
+        reviewFindings?: {
+            file: string;
+            severity: "blocking" | "warning" | "suggestion";
+            line: number;
+            category: string;
+            description: string;
+            fix: string;
+        }[] | undefined;
+    }>;
+    tokenBudget: z.ZodObject<{
+        contextTokensUsed: z.ZodNumber;
+        recommendedMaxTurns: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        contextTokensUsed: number;
+        recommendedMaxTurns: number;
+    }, {
+        contextTokensUsed: number;
+        recommendedMaxTurns: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    runId: string;
+    issueId: string;
+    stage: string;
+    timestamp: string;
+    summary: string;
+    filesChanged: string[];
+    approach: string;
+    context: {
+        issueIntent: string;
+        constraints: string[];
+        assumptions: string[];
+        testResults?: {
+            passed: number;
+            failed: number;
+            firstFailure?: {
+                test: string;
+                error: string;
+                file: string;
+            } | undefined;
+        } | undefined;
+        reviewFindings?: {
+            file: string;
+            severity: "blocking" | "warning" | "suggestion";
+            line: number;
+            category: string;
+            description: string;
+            fix: string;
+        }[] | undefined;
+    };
+    tokenBudget: {
+        contextTokensUsed: number;
+        recommendedMaxTurns: number;
+    };
+}, {
+    runId: string;
+    issueId: string;
+    stage: string;
+    timestamp: string;
+    summary: string;
+    filesChanged: string[];
+    approach: string;
+    context: {
+        issueIntent: string;
+        constraints: string[];
+        assumptions: string[];
+        testResults?: {
+            passed: number;
+            failed: number;
+            firstFailure?: {
+                test: string;
+                error: string;
+                file: string;
+            } | undefined;
+        } | undefined;
+        reviewFindings?: {
+            file: string;
+            severity: "blocking" | "warning" | "suggestion";
+            line: number;
+            category: string;
+            description: string;
+            fix: string;
+        }[] | undefined;
+    };
+    tokenBudget: {
+        contextTokensUsed: number;
+        recommendedMaxTurns: number;
+    };
+}>;
+export type HandoffArtifact = z.infer<typeof HandoffArtifactSchema>;
+export declare const ReviewCommentSchema: z.ZodObject<{
+    author: z.ZodString;
+    body: z.ZodString;
+    file: z.ZodOptional<z.ZodString>;
+    line: z.ZodOptional<z.ZodNumber>;
+    diffHunk: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    author: string;
+    body: string;
+    createdAt: string;
+    file?: string | undefined;
+    line?: number | undefined;
+    diffHunk?: string | undefined;
+}, {
+    author: string;
+    body: string;
+    createdAt: string;
+    file?: string | undefined;
+    line?: number | undefined;
+    diffHunk?: string | undefined;
+}>;
+export type ReviewComment = z.infer<typeof ReviewCommentSchema>;
+export declare const ReviewFeedbackContextSchema: z.ZodObject<{
+    /** The URL of the PR being reviewed. */
+    prUrl: z.ZodString;
+    /** The branch to push fixes to (the existing PR branch). */
+    prBranch: z.ZodString;
+    /** Inline review comments with file/line context. */
+    comments: z.ZodArray<z.ZodObject<{
+        author: z.ZodString;
+        body: z.ZodString;
+        file: z.ZodOptional<z.ZodString>;
+        line: z.ZodOptional<z.ZodNumber>;
+        diffHunk: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        author: string;
+        body: string;
+        createdAt: string;
+        file?: string | undefined;
+        line?: number | undefined;
+        diffHunk?: string | undefined;
+    }, {
+        author: string;
+        body: string;
+        createdAt: string;
+        file?: string | undefined;
+        line?: number | undefined;
+        diffHunk?: string | undefined;
+    }>, "many">;
+    /** Optional overall review summary body (for full reviews, not just inline comments). */
+    reviewBody: z.ZodOptional<z.ZodString>;
+    /** The original implement handoff, for context on what was done. */
+    previousHandoff: z.ZodOptional<z.ZodObject<{
+        runId: z.ZodString;
+        issueId: z.ZodString;
+        stage: z.ZodString;
+        timestamp: z.ZodString;
+        summary: z.ZodString;
+        filesChanged: z.ZodArray<z.ZodString, "many">;
+        approach: z.ZodString;
+        context: z.ZodObject<{
+            issueIntent: z.ZodString;
+            constraints: z.ZodArray<z.ZodString, "many">;
+            assumptions: z.ZodArray<z.ZodString, "many">;
+            testResults: z.ZodOptional<z.ZodObject<{
+                passed: z.ZodNumber;
+                failed: z.ZodNumber;
+                firstFailure: z.ZodOptional<z.ZodObject<{
+                    test: z.ZodString;
+                    error: z.ZodString;
+                    file: z.ZodString;
+                }, "strip", z.ZodTypeAny, {
+                    test: string;
+                    error: string;
+                    file: string;
+                }, {
+                    test: string;
+                    error: string;
+                    file: string;
+                }>>;
+            }, "strip", z.ZodTypeAny, {
+                passed: number;
+                failed: number;
+                firstFailure?: {
+                    test: string;
+                    error: string;
+                    file: string;
+                } | undefined;
+            }, {
+                passed: number;
+                failed: number;
+                firstFailure?: {
+                    test: string;
+                    error: string;
+                    file: string;
+                } | undefined;
+            }>>;
+            reviewFindings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                severity: z.ZodEnum<["blocking", "warning", "suggestion"]>;
+                file: z.ZodString;
+                line: z.ZodNumber;
+                category: z.ZodString;
+                description: z.ZodString;
+                fix: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                file: string;
+                severity: "blocking" | "warning" | "suggestion";
+                line: number;
+                category: string;
+                description: string;
+                fix: string;
+            }, {
+                file: string;
+                severity: "blocking" | "warning" | "suggestion";
+                line: number;
+                category: string;
+                description: string;
+                fix: string;
+            }>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            issueIntent: string;
+            constraints: string[];
+            assumptions: string[];
+            testResults?: {
+                passed: number;
+                failed: number;
+                firstFailure?: {
+                    test: string;
+                    error: string;
+                    file: string;
+                } | undefined;
+            } | undefined;
+            reviewFindings?: {
+                file: string;
+                severity: "blocking" | "warning" | "suggestion";
+                line: number;
+                category: string;
+                description: string;
+                fix: string;
+            }[] | undefined;
+        }, {
+            issueIntent: string;
+            constraints: string[];
+            assumptions: string[];
+            testResults?: {
+                passed: number;
+                failed: number;
+                firstFailure?: {
+                    test: string;
+                    error: string;
+                    file: string;
+                } | undefined;
+            } | undefined;
+            reviewFindings?: {
+                file: string;
+                severity: "blocking" | "warning" | "suggestion";
+                line: number;
+                category: string;
+                description: string;
+                fix: string;
+            }[] | undefined;
+        }>;
+        tokenBudget: z.ZodObject<{
+            contextTokensUsed: z.ZodNumber;
+            recommendedMaxTurns: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            contextTokensUsed: number;
+            recommendedMaxTurns: number;
+        }, {
+            contextTokensUsed: number;
+            recommendedMaxTurns: number;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        runId: string;
+        issueId: string;
+        stage: string;
+        timestamp: string;
+        summary: string;
+        filesChanged: string[];
+        approach: string;
+        context: {
+            issueIntent: string;
+            constraints: string[];
+            assumptions: string[];
+            testResults?: {
+                passed: number;
+                failed: number;
+                firstFailure?: {
+                    test: string;
+                    error: string;
+                    file: string;
+                } | undefined;
+            } | undefined;
+            reviewFindings?: {
+                file: string;
+                severity: "blocking" | "warning" | "suggestion";
+                line: number;
+                category: string;
+                description: string;
+                fix: string;
+            }[] | undefined;
+        };
+        tokenBudget: {
+            contextTokensUsed: number;
+            recommendedMaxTurns: number;
+        };
+    }, {
+        runId: string;
+        issueId: string;
+        stage: string;
+        timestamp: string;
+        summary: string;
+        filesChanged: string[];
+        approach: string;
+        context: {
+            issueIntent: string;
+            constraints: string[];
+            assumptions: string[];
+            testResults?: {
+                passed: number;
+                failed: number;
+                firstFailure?: {
+                    test: string;
+                    error: string;
+                    file: string;
+                } | undefined;
+            } | undefined;
+            reviewFindings?: {
+                file: string;
+                severity: "blocking" | "warning" | "suggestion";
+                line: number;
+                category: string;
+                description: string;
+                fix: string;
+            }[] | undefined;
+        };
+        tokenBudget: {
+            contextTokensUsed: number;
+            recommendedMaxTurns: number;
+        };
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    prUrl: string;
+    prBranch: string;
+    comments: {
+        author: string;
+        body: string;
+        createdAt: string;
+        file?: string | undefined;
+        line?: number | undefined;
+        diffHunk?: string | undefined;
+    }[];
+    reviewBody?: string | undefined;
+    previousHandoff?: {
+        runId: string;
+        issueId: string;
+        stage: string;
+        timestamp: string;
+        summary: string;
+        filesChanged: string[];
+        approach: string;
+        context: {
+            issueIntent: string;
+            constraints: string[];
+            assumptions: string[];
+            testResults?: {
+                passed: number;
+                failed: number;
+                firstFailure?: {
+                    test: string;
+                    error: string;
+                    file: string;
+                } | undefined;
+            } | undefined;
+            reviewFindings?: {
+                file: string;
+                severity: "blocking" | "warning" | "suggestion";
+                line: number;
+                category: string;
+                description: string;
+                fix: string;
+            }[] | undefined;
+        };
+        tokenBudget: {
+            contextTokensUsed: number;
+            recommendedMaxTurns: number;
+        };
+    } | undefined;
+}, {
+    prUrl: string;
+    prBranch: string;
+    comments: {
+        author: string;
+        body: string;
+        createdAt: string;
+        file?: string | undefined;
+        line?: number | undefined;
+        diffHunk?: string | undefined;
+    }[];
+    reviewBody?: string | undefined;
+    previousHandoff?: {
+        runId: string;
+        issueId: string;
+        stage: string;
+        timestamp: string;
+        summary: string;
+        filesChanged: string[];
+        approach: string;
+        context: {
+            issueIntent: string;
+            constraints: string[];
+            assumptions: string[];
+            testResults?: {
+                passed: number;
+                failed: number;
+                firstFailure?: {
+                    test: string;
+                    error: string;
+                    file: string;
+                } | undefined;
+            } | undefined;
+            reviewFindings?: {
+                file: string;
+                severity: "blocking" | "warning" | "suggestion";
+                line: number;
+                category: string;
+                description: string;
+                fix: string;
+            }[] | undefined;
+        };
+        tokenBudget: {
+            contextTokensUsed: number;
+            recommendedMaxTurns: number;
+        };
+    } | undefined;
+}>;
+export type ReviewFeedbackContext = z.infer<typeof ReviewFeedbackContextSchema>;
+export interface AgentProfile {
+    tools: string[];
+    maxInputTokens: number;
+    maxTurns: number;
+    model?: string;
+}
+export interface TokenBudget {
+    maxInputTokens: number;
+    maxTurns: number;
+}
+export type PipelineRunStatus = "queued" | "running" | "completed" | "failed" | "aborted" | "paused";
+export type StageRunStatus = "running" | "completed" | "failed" | "skipped";
+export type AgentLogType = "tool_call" | "tool_result" | "message" | "error";
+export interface SanitizedIssue {
+    id: string;
+    slug: string;
+    title: string;
+    description: string;
+    acceptanceCriteria: string[];
+    labels: string[];
+    priority: number;
+}
+export interface StageResult {
+    status: "completed" | "failed";
+    handoffArtifact?: HandoffArtifact;
+    /** True when the agent produced a valid structured handoff JSON block.
+     *  NOTE: not persisted to DB yet — runtime-only. Add a column if needed for dashboards/queries. */
+    handoffIsStructured?: boolean;
+    inputTokens: number;
+    outputTokens: number;
+    turns: number;
+    errorMessage?: string;
+}
+export interface PipelineRun {
+    id: string;
+    issueId: string;
+    issueTitle: string;
+    pipelineKey: string;
+    repoUrl: string;
+    branch: string | null;
+    status: PipelineRunStatus;
+    startedAt: Date;
+    completedAt?: Date;
+    prUrl?: string;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    /** True when the pipeline auto-merged the PR. Persisted to DB. */
+    autoMerged?: boolean;
+    /** Reason for the auto-merge decision (success reason or skip reason). Persisted to DB. */
+    autoMergeReason?: string;
+    /** True when auto-commit was triggered because the agent did not commit its work. Quality metric. */
+    autoCommitted?: boolean;
+}
+export interface PipelineResult {
+    prUrl: string;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    stagesCompleted: number;
+    autoMerged?: boolean;
+}
+export interface PipelineError {
+    stage: string;
+    message: string;
+    retriesExhausted: boolean;
+}
+export interface DailyTokenSummary {
+    date: string;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    runsCompleted: number;
+    runsFailed: number;
+}
+export interface Notifier {
+    onPipelineStart(run: PipelineRun): Promise<void>;
+    onStageComplete(run: PipelineRun, stage: string, result: StageResult): Promise<void>;
+    onPipelineComplete(run: PipelineRun, result: PipelineResult): Promise<void>;
+    onPipelineFailed(run: PipelineRun, error: PipelineError): Promise<void>;
+    /** Called when a PR needs human review (not auto-merged). */
+    onHumanReviewNeeded?(run: PipelineRun, prUrl: string, reason: string): Promise<void>;
+    /** Called once when token usage reaches 80% of maxTokens. */
+    onTokenBudgetAlert?(run: PipelineRun, usedTokens: number, maxTokens: number): Promise<void>;
+    /** Called by sendDailyTokenSummary() with aggregated usage for a given date. */
+    onDailyTokenSummary?(summary: DailyTokenSummary): Promise<void>;
+}
+export interface SandboxConfig {
+    workdir: string;
+    allowedDomains: string[];
+    denyRead: string[];
+    denyWrite: string[];
+}
+//# sourceMappingURL=types.d.ts.map