ralph-research 0.1.2 → 0.1.4

package/dist/core/model/research-session.d.ts

@@ -0,0 +1,1143 @@
+import { z } from "zod";
+export declare const researchSessionStatusSchema: z.ZodEnum<{
+    running: "running";
+    draft: "draft";
+    awaiting_resume: "awaiting_resume";
+    halted: "halted";
+    goal_achieved: "goal_achieved";
+    failed: "failed";
+}>;
+export declare const RESUMABLE_RESEARCH_SESSION_STATUSES: readonly ["running", "awaiting_resume", "halted"];
+export declare const researchSessionAgentSchema: z.ZodObject<{
+    type: z.ZodLiteral<"codex_cli">;
+    command: z.ZodDefault<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    approvalPolicy: z.ZodDefault<z.ZodEnum<{
+        never: "never";
+        "on-failure": "on-failure";
+        "on-request": "on-request";
+        untrusted: "untrusted";
+    }>>;
+    sandboxMode: z.ZodDefault<z.ZodEnum<{
+        "workspace-write": "workspace-write";
+        "read-only": "read-only";
+        "danger-full-access": "danger-full-access";
+    }>>;
+    ttySession: z.ZodDefault<z.ZodObject<{
+        startupTimeoutSec: z.ZodDefault<z.ZodNumber>;
+        turnTimeoutSec: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const researchSessionWorkspaceSchema: z.ZodObject<{
+    strategy: z.ZodLiteral<"git_worktree">;
+    baseRef: z.ZodOptional<z.ZodString>;
+    currentRef: z.ZodOptional<z.ZodString>;
+    currentPath: z.ZodOptional<z.ZodString>;
+    promoted: z.ZodDefault<z.ZodBoolean>;
+    promotedAt: z.ZodOptional<z.ZodString>;
+    promotedRunId: z.ZodOptional<z.ZodString>;
+    promotedDecisionId: z.ZodOptional<z.ZodString>;
+    promotedCommitSha: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const researchSessionContextSchema: z.ZodObject<{
+    trackableGlobs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    webSearch: z.ZodDefault<z.ZodBoolean>;
+    shellCommandAllowlistAdditions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    shellCommandAllowlistRemovals: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const researchSessionStopPolicySchema: z.ZodObject<{
+    repeatedFailures: z.ZodDefault<z.ZodNumber>;
+    noMeaningfulProgress: z.ZodDefault<z.ZodNumber>;
+    insufficientEvidence: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const researchSessionGoalStepDraftSchema: z.ZodObject<{
+    goal: z.ZodOptional<z.ZodString>;
+    agentCommand: z.ZodOptional<z.ZodString>;
+    repeatedFailures: z.ZodOptional<z.ZodString>;
+    noMeaningfulProgress: z.ZodOptional<z.ZodString>;
+    insufficientEvidence: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const researchSessionAgentStepDraftSchema: z.ZodObject<{
+    command: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    approvalPolicy: z.ZodOptional<z.ZodString>;
+    sandboxMode: z.ZodOptional<z.ZodString>;
+    startupTimeoutSec: z.ZodOptional<z.ZodString>;
+    turnTimeoutSec: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const researchSessionWorkspaceStepDraftSchema: z.ZodObject<{
+    workingDirectory: z.ZodOptional<z.ZodString>;
+    baseRef: z.ZodOptional<z.ZodString>;
+    allowedGlobs: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const researchSessionContextStepDraftSchema: z.ZodObject<{
+    trackableGlobs: z.ZodOptional<z.ZodString>;
+    webSearch: z.ZodOptional<z.ZodString>;
+    shellCommandAllowlistAdditions: z.ZodOptional<z.ZodString>;
+    shellCommandAllowlistRemovals: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const researchSessionPermissionsFlowStateSchema: z.ZodObject<{
+    workingDirectory: z.ZodOptional<z.ZodString>;
+    webSearch: z.ZodOptional<z.ZodString>;
+    shellCommandAllowlistAdditions: z.ZodOptional<z.ZodString>;
+    shellCommandAllowlistRemovals: z.ZodOptional<z.ZodString>;
+    approvalPolicy: z.ZodOptional<z.ZodString>;
+    sandboxMode: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const researchSessionStopRulesFlowStateSchema: z.ZodObject<{
+    repeatedFailures: z.ZodOptional<z.ZodString>;
+    noMeaningfulProgress: z.ZodOptional<z.ZodString>;
+    insufficientEvidence: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const researchSessionOutputsFlowStateSchema: z.ZodObject<{
+    goal: z.ZodOptional<z.ZodString>;
+    trackableGlobs: z.ZodOptional<z.ZodString>;
+    baseRef: z.ZodOptional<z.ZodString>;
+    agentCommand: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    startupTimeoutSec: z.ZodOptional<z.ZodString>;
+    turnTimeoutSec: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const researchSessionReviewSummaryFieldSchema: z.ZodObject<{
+    label: z.ZodString;
+    value: z.ZodString;
+}, z.core.$strip>;
+export declare const researchSessionReviewSectionFlowStateSchema: z.ZodObject<{
+    index: z.ZodString;
+    label: z.ZodString;
+    step: z.ZodEnum<{
+        outputs: "outputs";
+        permissions: "permissions";
+        stopRules: "stopRules";
+    }>;
+    fields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const researchSessionReviewFlowStateSchema: z.ZodObject<{
+    sections: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        index: z.ZodString;
+        label: z.ZodString;
+        step: z.ZodEnum<{
+            outputs: "outputs";
+            permissions: "permissions";
+            stopRules: "stopRules";
+        }>;
+        fields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const researchSessionFlowStateSchema: z.ZodObject<{
+    permissions: z.ZodOptional<z.ZodObject<{
+        workingDirectory: z.ZodOptional<z.ZodString>;
+        webSearch: z.ZodOptional<z.ZodString>;
+        shellCommandAllowlistAdditions: z.ZodOptional<z.ZodString>;
+        shellCommandAllowlistRemovals: z.ZodOptional<z.ZodString>;
+        approvalPolicy: z.ZodOptional<z.ZodString>;
+        sandboxMode: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    stopRules: z.ZodOptional<z.ZodObject<{
+        repeatedFailures: z.ZodOptional<z.ZodString>;
+        noMeaningfulProgress: z.ZodOptional<z.ZodString>;
+        insufficientEvidence: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    outputs: z.ZodOptional<z.ZodObject<{
+        goal: z.ZodOptional<z.ZodString>;
+        trackableGlobs: z.ZodOptional<z.ZodString>;
+        baseRef: z.ZodOptional<z.ZodString>;
+        agentCommand: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+        startupTimeoutSec: z.ZodOptional<z.ZodString>;
+        turnTimeoutSec: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    review: z.ZodOptional<z.ZodObject<{
+        sections: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            index: z.ZodString;
+            label: z.ZodString;
+            step: z.ZodEnum<{
+                outputs: "outputs";
+                permissions: "permissions";
+                stopRules: "stopRules";
+            }>;
+            fields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                value: z.ZodString;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const researchSessionDraftStepSchema: z.ZodEnum<{
+    outputs: "outputs";
+    permissions: "permissions";
+    stopRules: "stopRules";
+    review: "review";
+}>;
+export declare const researchSessionDraftStateSchema: z.ZodObject<{
+    currentStep: z.ZodDefault<z.ZodEnum<{
+        outputs: "outputs";
+        permissions: "permissions";
+        stopRules: "stopRules";
+        review: "review";
+    }>>;
+    completedSteps: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        outputs: "outputs";
+        permissions: "permissions";
+        stopRules: "stopRules";
+        review: "review";
+    }>>>;
+    returnToReview: z.ZodDefault<z.ZodBoolean>;
+    reviewConfirmed: z.ZodDefault<z.ZodBoolean>;
+    flowState: z.ZodOptional<z.ZodObject<{
+        permissions: z.ZodOptional<z.ZodObject<{
+            workingDirectory: z.ZodOptional<z.ZodString>;
+            webSearch: z.ZodOptional<z.ZodString>;
+            shellCommandAllowlistAdditions: z.ZodOptional<z.ZodString>;
+            shellCommandAllowlistRemovals: z.ZodOptional<z.ZodString>;
+            approvalPolicy: z.ZodOptional<z.ZodString>;
+            sandboxMode: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        stopRules: z.ZodOptional<z.ZodObject<{
+            repeatedFailures: z.ZodOptional<z.ZodString>;
+            noMeaningfulProgress: z.ZodOptional<z.ZodString>;
+            insufficientEvidence: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        outputs: z.ZodOptional<z.ZodObject<{
+            goal: z.ZodOptional<z.ZodString>;
+            trackableGlobs: z.ZodOptional<z.ZodString>;
+            baseRef: z.ZodOptional<z.ZodString>;
+            agentCommand: z.ZodOptional<z.ZodString>;
+            model: z.ZodOptional<z.ZodString>;
+            startupTimeoutSec: z.ZodOptional<z.ZodString>;
+            turnTimeoutSec: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        review: z.ZodOptional<z.ZodObject<{
+            sections: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                index: z.ZodString;
+                label: z.ZodString;
+                step: z.ZodEnum<{
+                    outputs: "outputs";
+                    permissions: "permissions";
+                    stopRules: "stopRules";
+                }>;
+                fields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    label: z.ZodString;
+                    value: z.ZodString;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    goalStep: z.ZodOptional<z.ZodObject<{
+        goal: z.ZodOptional<z.ZodString>;
+        agentCommand: z.ZodOptional<z.ZodString>;
+        repeatedFailures: z.ZodOptional<z.ZodString>;
+        noMeaningfulProgress: z.ZodOptional<z.ZodString>;
+        insufficientEvidence: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    contextStep: z.ZodOptional<z.ZodObject<{
+        trackableGlobs: z.ZodOptional<z.ZodString>;
+        webSearch: z.ZodOptional<z.ZodString>;
+        shellCommandAllowlistAdditions: z.ZodOptional<z.ZodString>;
+        shellCommandAllowlistRemovals: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    workspaceStep: z.ZodOptional<z.ZodObject<{
+        workingDirectory: z.ZodOptional<z.ZodString>;
+        baseRef: z.ZodOptional<z.ZodString>;
+        allowedGlobs: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    agentStep: z.ZodOptional<z.ZodObject<{
+        command: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+        approvalPolicy: z.ZodOptional<z.ZodString>;
+        sandboxMode: z.ZodOptional<z.ZodString>;
+        startupTimeoutSec: z.ZodOptional<z.ZodString>;
+        turnTimeoutSec: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const researchSessionCycleOutcomeSchema: z.ZodEnum<{
+    accepted: "accepted";
+    rejected: "rejected";
+    needs_human: "needs_human";
+    failed: "failed";
+}>;
+export declare const researchSessionProgressSignalSchema: z.ZodObject<{
+    cycle: z.ZodNumber;
+    outcome: z.ZodEnum<{
+        accepted: "accepted";
+        rejected: "rejected";
+        needs_human: "needs_human";
+        failed: "failed";
+    }>;
+    changedFileCount: z.ZodDefault<z.ZodNumber>;
+    diffLineCount: z.ZodDefault<z.ZodNumber>;
+    repeatedDiff: z.ZodDefault<z.ZodBoolean>;
+    verificationDelta: z.ZodOptional<z.ZodNumber>;
+    newArtifacts: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    meaningfulProgress: z.ZodBoolean;
+    insufficientEvidence: z.ZodDefault<z.ZodBoolean>;
+    agentTieBreakerUsed: z.ZodDefault<z.ZodBoolean>;
+    agentSummary: z.ZodOptional<z.ZodString>;
+    reasons: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const researchSessionProgressSchema: z.ZodObject<{
+    completedCycles: z.ZodDefault<z.ZodNumber>;
+    nextCycle: z.ZodDefault<z.ZodNumber>;
+    latestRunId: z.ZodOptional<z.ZodString>;
+    latestDecisionId: z.ZodOptional<z.ZodString>;
+    latestFrontierIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    repeatedFailureStreak: z.ZodDefault<z.ZodNumber>;
+    noMeaningfulProgressStreak: z.ZodDefault<z.ZodNumber>;
+    insufficientEvidenceStreak: z.ZodDefault<z.ZodNumber>;
+    lastMeaningfulProgressCycle: z.ZodOptional<z.ZodNumber>;
+    lastCheckpointAt: z.ZodOptional<z.ZodString>;
+    lastSignals: z.ZodOptional<z.ZodObject<{
+        cycle: z.ZodNumber;
+        outcome: z.ZodEnum<{
+            accepted: "accepted";
+            rejected: "rejected";
+            needs_human: "needs_human";
+            failed: "failed";
+        }>;
+        changedFileCount: z.ZodDefault<z.ZodNumber>;
+        diffLineCount: z.ZodDefault<z.ZodNumber>;
+        repeatedDiff: z.ZodDefault<z.ZodBoolean>;
+        verificationDelta: z.ZodOptional<z.ZodNumber>;
+        newArtifacts: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        meaningfulProgress: z.ZodBoolean;
+        insufficientEvidence: z.ZodDefault<z.ZodBoolean>;
+        agentTieBreakerUsed: z.ZodDefault<z.ZodBoolean>;
+        agentSummary: z.ZodOptional<z.ZodString>;
+        reasons: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const researchSessionStopConditionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"none">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"goal_achieved">;
+    summary: z.ZodString;
+    achievedAtCycle: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"repeated_failures">;
+    count: z.ZodNumber;
+    threshold: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"no_meaningful_progress">;
+    count: z.ZodNumber;
+    threshold: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"insufficient_evidence">;
+    count: z.ZodNumber;
+    threshold: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"operator_stop">;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"unrecoverable_error">;
+    message: z.ZodString;
+    stack: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "type">;
+export declare const researchSessionResumeSchema: z.ZodObject<{
+    resumable: z.ZodDefault<z.ZodBoolean>;
+    checkpointType: z.ZodLiteral<"completed_cycle_boundary">;
+    resumeFromCycle: z.ZodNumber;
+    requiresUserConfirmation: z.ZodDefault<z.ZodBoolean>;
+    checkpointRunId: z.ZodOptional<z.ZodString>;
+    checkpointDecisionId: z.ZodOptional<z.ZodString>;
+    interruptionDetectedAt: z.ZodOptional<z.ZodString>;
+    interruptedDuringCycle: z.ZodOptional<z.ZodNumber>;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const researchSessionTuiSelectedCandidateDecisionSchema: z.ZodEnum<{
+    resume: "resume";
+    new_session: "new_session";
+}>;
+export declare const researchSessionTuiSelectedCandidateConfirmationSchema: z.ZodObject<{
+    required: z.ZodLiteral<true>;
+    decision: z.ZodOptional<z.ZodEnum<{
+        resume: "resume";
+        new_session: "new_session";
+    }>>;
+}, z.core.$strip>;
+export declare const researchSessionRecoveryClassificationSchema: z.ZodEnum<{
+    resumable: "resumable";
+    inspect_only: "inspect_only";
+    non_recoverable: "non_recoverable";
+}>;
+export declare const researchSessionRuntimeStateSchema: z.ZodEnum<{
+    active: "active";
+    stale: "stale";
+    exited: "exited";
+    missing: "missing";
+}>;
+export declare const researchSessionTuiSelectedCandidateCheckpointSchema: z.ZodObject<{
+    completedCycles: z.ZodNumber;
+    latestRunId: z.ZodOptional<z.ZodString>;
+    latestDecisionId: z.ZodOptional<z.ZodString>;
+    lastCheckpointAt: z.ZodOptional<z.ZodString>;
+    stopCondition: z.ZodString;
+}, z.core.$strip>;
+export declare const researchSessionTuiSelectedCandidateLatestCycleSchema: z.ZodObject<{
+    outcome: z.ZodEnum<{
+        accepted: "accepted";
+        rejected: "rejected";
+        needs_human: "needs_human";
+        failed: "failed";
+    }>;
+    meaningfulProgress: z.ZodBoolean;
+    insufficientEvidence: z.ZodBoolean;
+    changedFileCount: z.ZodNumber;
+    diffLineCount: z.ZodNumber;
+    newArtifactCount: z.ZodNumber;
+    agentSummary: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const researchSessionTuiSelectedCandidateRecoverySchema: z.ZodObject<{
+    classification: z.ZodEnum<{
+        resumable: "resumable";
+        inspect_only: "inspect_only";
+        non_recoverable: "non_recoverable";
+    }>;
+    resumeAllowed: z.ZodBoolean;
+    reason: z.ZodString;
+    runtimeState: z.ZodEnum<{
+        active: "active";
+        stale: "stale";
+        exited: "exited";
+        missing: "missing";
+    }>;
+    codexPhase: z.ZodOptional<z.ZodEnum<{
+        starting: "starting";
+        running: "running";
+        clean_exit: "clean_exit";
+        signaled: "signaled";
+        non_zero_exit: "non_zero_exit";
+        startup_error: "startup_error";
+        runtime_error: "runtime_error";
+    }>>;
+}, z.core.$strip>;
+export declare const researchSessionTuiSelectedCandidateSummarySchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    status: z.ZodEnum<{
+        running: "running";
+        awaiting_resume: "awaiting_resume";
+        halted: "halted";
+    }>;
+    goal: z.ZodString;
+    updatedAt: z.ZodString;
+    resumeFromCycle: z.ZodNumber;
+    checkpoint: z.ZodObject<{
+        completedCycles: z.ZodNumber;
+        latestRunId: z.ZodOptional<z.ZodString>;
+        latestDecisionId: z.ZodOptional<z.ZodString>;
+        lastCheckpointAt: z.ZodOptional<z.ZodString>;
+        stopCondition: z.ZodString;
+    }, z.core.$strip>;
+    latestCycle: z.ZodOptional<z.ZodObject<{
+        outcome: z.ZodEnum<{
+            accepted: "accepted";
+            rejected: "rejected";
+            needs_human: "needs_human";
+            failed: "failed";
+        }>;
+        meaningfulProgress: z.ZodBoolean;
+        insufficientEvidence: z.ZodBoolean;
+        changedFileCount: z.ZodNumber;
+        diffLineCount: z.ZodNumber;
+        newArtifactCount: z.ZodNumber;
+        agentSummary: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    recovery: z.ZodOptional<z.ZodObject<{
+        classification: z.ZodEnum<{
+            resumable: "resumable";
+            inspect_only: "inspect_only";
+            non_recoverable: "non_recoverable";
+        }>;
+        resumeAllowed: z.ZodBoolean;
+        reason: z.ZodString;
+        runtimeState: z.ZodEnum<{
+            active: "active";
+            stale: "stale";
+            exited: "exited";
+            missing: "missing";
+        }>;
+        codexPhase: z.ZodOptional<z.ZodEnum<{
+            starting: "starting";
+            running: "running";
+            clean_exit: "clean_exit";
+            signaled: "signaled";
+            non_zero_exit: "non_zero_exit";
+            startup_error: "startup_error";
+            runtime_error: "runtime_error";
+        }>>;
+    }, z.core.$strip>>;
+    userConfirmation: z.ZodObject<{
+        required: z.ZodLiteral<true>;
+        decision: z.ZodOptional<z.ZodEnum<{
+            resume: "resume";
+            new_session: "new_session";
+        }>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const researchSessionMetadataSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    goal: z.ZodString;
+    workingDirectory: z.ZodString;
+    status: z.ZodEnum<{
+        running: "running";
+        draft: "draft";
+        awaiting_resume: "awaiting_resume";
+        halted: "halted";
+        goal_achieved: "goal_achieved";
+        failed: "failed";
+    }>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    completedCycles: z.ZodNumber;
+    lastCheckpointAt: z.ZodOptional<z.ZodString>;
+    resumeFromCycle: z.ZodNumber;
+}, z.core.$strip>;
+export declare const researchSessionSubmittedSnapshotSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    goal: z.ZodString;
+    workingDirectory: z.ZodString;
+    status: z.ZodEnum<{
+        running: "running";
+        draft: "draft";
+        awaiting_resume: "awaiting_resume";
+        halted: "halted";
+        goal_achieved: "goal_achieved";
+        failed: "failed";
+    }>;
+    agent: z.ZodObject<{
+        type: z.ZodLiteral<"codex_cli">;
+        command: z.ZodDefault<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+        approvalPolicy: z.ZodDefault<z.ZodEnum<{
+            never: "never";
+            "on-failure": "on-failure";
+            "on-request": "on-request";
+            untrusted: "untrusted";
+        }>>;
+        sandboxMode: z.ZodDefault<z.ZodEnum<{
+            "workspace-write": "workspace-write";
+            "read-only": "read-only";
+            "danger-full-access": "danger-full-access";
+        }>>;
+        ttySession: z.ZodDefault<z.ZodObject<{
+            startupTimeoutSec: z.ZodDefault<z.ZodNumber>;
+            turnTimeoutSec: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    context: z.ZodObject<{
+        trackableGlobs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        webSearch: z.ZodDefault<z.ZodBoolean>;
+        shellCommandAllowlistAdditions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        shellCommandAllowlistRemovals: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+    workspace: z.ZodObject<{
+        strategy: z.ZodLiteral<"git_worktree">;
+        baseRef: z.ZodOptional<z.ZodString>;
+        currentRef: z.ZodOptional<z.ZodString>;
+        currentPath: z.ZodOptional<z.ZodString>;
+        promoted: z.ZodDefault<z.ZodBoolean>;
+        promotedAt: z.ZodOptional<z.ZodString>;
+        promotedRunId: z.ZodOptional<z.ZodString>;
+        promotedDecisionId: z.ZodOptional<z.ZodString>;
+        promotedCommitSha: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    stopPolicy: z.ZodObject<{
+        repeatedFailures: z.ZodDefault<z.ZodNumber>;
+        noMeaningfulProgress: z.ZodDefault<z.ZodNumber>;
+        insufficientEvidence: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    progress: z.ZodObject<{
+        completedCycles: z.ZodDefault<z.ZodNumber>;
+        nextCycle: z.ZodDefault<z.ZodNumber>;
+        latestRunId: z.ZodOptional<z.ZodString>;
+        latestDecisionId: z.ZodOptional<z.ZodString>;
+        latestFrontierIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        repeatedFailureStreak: z.ZodDefault<z.ZodNumber>;
+        noMeaningfulProgressStreak: z.ZodDefault<z.ZodNumber>;
+        insufficientEvidenceStreak: z.ZodDefault<z.ZodNumber>;
+        lastMeaningfulProgressCycle: z.ZodOptional<z.ZodNumber>;
+        lastCheckpointAt: z.ZodOptional<z.ZodString>;
+        lastSignals: z.ZodOptional<z.ZodObject<{
+            cycle: z.ZodNumber;
+            outcome: z.ZodEnum<{
+                accepted: "accepted";
+                rejected: "rejected";
+                needs_human: "needs_human";
+                failed: "failed";
+            }>;
+            changedFileCount: z.ZodDefault<z.ZodNumber>;
+            diffLineCount: z.ZodDefault<z.ZodNumber>;
+            repeatedDiff: z.ZodDefault<z.ZodBoolean>;
+            verificationDelta: z.ZodOptional<z.ZodNumber>;
+            newArtifacts: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            meaningfulProgress: z.ZodBoolean;
+            insufficientEvidence: z.ZodDefault<z.ZodBoolean>;
+            agentTieBreakerUsed: z.ZodDefault<z.ZodBoolean>;
+            agentSummary: z.ZodOptional<z.ZodString>;
+            reasons: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    stopCondition: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"none">;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"goal_achieved">;
+        summary: z.ZodString;
+        achievedAtCycle: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"repeated_failures">;
+        count: z.ZodNumber;
+        threshold: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"no_meaningful_progress">;
+        count: z.ZodNumber;
+        threshold: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"insufficient_evidence">;
+        count: z.ZodNumber;
+        threshold: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"operator_stop">;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"unrecoverable_error">;
+        message: z.ZodString;
+        stack: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "type">;
+    resume: z.ZodObject<{
+        resumable: z.ZodDefault<z.ZodBoolean>;
+        checkpointType: z.ZodLiteral<"completed_cycle_boundary">;
+        resumeFromCycle: z.ZodNumber;
+        requiresUserConfirmation: z.ZodDefault<z.ZodBoolean>;
+        checkpointRunId: z.ZodOptional<z.ZodString>;
+        checkpointDecisionId: z.ZodOptional<z.ZodString>;
+        interruptionDetectedAt: z.ZodOptional<z.ZodString>;
+        interruptedDuringCycle: z.ZodOptional<z.ZodNumber>;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    draftState: z.ZodOptional<z.ZodObject<{
+        currentStep: z.ZodDefault<z.ZodEnum<{
+            outputs: "outputs";
+            permissions: "permissions";
+            stopRules: "stopRules";
+            review: "review";
+        }>>;
+        completedSteps: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+            outputs: "outputs";
+            permissions: "permissions";
+            stopRules: "stopRules";
+            review: "review";
+        }>>>;
+        returnToReview: z.ZodDefault<z.ZodBoolean>;
+        reviewConfirmed: z.ZodDefault<z.ZodBoolean>;
+        flowState: z.ZodOptional<z.ZodObject<{
+            permissions: z.ZodOptional<z.ZodObject<{
+                workingDirectory: z.ZodOptional<z.ZodString>;
+                webSearch: z.ZodOptional<z.ZodString>;
+                shellCommandAllowlistAdditions: z.ZodOptional<z.ZodString>;
+                shellCommandAllowlistRemovals: z.ZodOptional<z.ZodString>;
+                approvalPolicy: z.ZodOptional<z.ZodString>;
+                sandboxMode: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            stopRules: z.ZodOptional<z.ZodObject<{
+                repeatedFailures: z.ZodOptional<z.ZodString>;
+                noMeaningfulProgress: z.ZodOptional<z.ZodString>;
+                insufficientEvidence: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            outputs: z.ZodOptional<z.ZodObject<{
+                goal: z.ZodOptional<z.ZodString>;
+                trackableGlobs: z.ZodOptional<z.ZodString>;
+                baseRef: z.ZodOptional<z.ZodString>;
+                agentCommand: z.ZodOptional<z.ZodString>;
+                model: z.ZodOptional<z.ZodString>;
+                startupTimeoutSec: z.ZodOptional<z.ZodString>;
+                turnTimeoutSec: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            review: z.ZodOptional<z.ZodObject<{
+                sections: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    index: z.ZodString;
+                    label: z.ZodString;
+                    step: z.ZodEnum<{
+                        outputs: "outputs";
+                        permissions: "permissions";
+                        stopRules: "stopRules";
+                    }>;
+                    fields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                        label: z.ZodString;
+                        value: z.ZodString;
+                    }, z.core.$strip>>>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        goalStep: z.ZodOptional<z.ZodObject<{
+            goal: z.ZodOptional<z.ZodString>;
+            agentCommand: z.ZodOptional<z.ZodString>;
+            repeatedFailures: z.ZodOptional<z.ZodString>;
+            noMeaningfulProgress: z.ZodOptional<z.ZodString>;
+            insufficientEvidence: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        contextStep: z.ZodOptional<z.ZodObject<{
+            trackableGlobs: z.ZodOptional<z.ZodString>;
+            webSearch: z.ZodOptional<z.ZodString>;
+            shellCommandAllowlistAdditions: z.ZodOptional<z.ZodString>;
+            shellCommandAllowlistRemovals: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        workspaceStep: z.ZodOptional<z.ZodObject<{
+            workingDirectory: z.ZodOptional<z.ZodString>;
+            baseRef: z.ZodOptional<z.ZodString>;
+            allowedGlobs: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        agentStep: z.ZodOptional<z.ZodObject<{
+            command: z.ZodOptional<z.ZodString>;
+            model: z.ZodOptional<z.ZodString>;
+            approvalPolicy: z.ZodOptional<z.ZodString>;
+            sandboxMode: z.ZodOptional<z.ZodString>;
+            startupTimeoutSec: z.ZodOptional<z.ZodString>;
+            turnTimeoutSec: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    endedAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const researchSessionRecordSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    goal: z.ZodString;
+    workingDirectory: z.ZodString;
+    status: z.ZodEnum<{
+        running: "running";
+        draft: "draft";
+        awaiting_resume: "awaiting_resume";
+        halted: "halted";
+        goal_achieved: "goal_achieved";
+        failed: "failed";
+    }>;
+    agent: z.ZodDefault<z.ZodObject<{
+        type: z.ZodLiteral<"codex_cli">;
+        command: z.ZodDefault<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+        approvalPolicy: z.ZodDefault<z.ZodEnum<{
+            never: "never";
+            "on-failure": "on-failure";
+            "on-request": "on-request";
+            untrusted: "untrusted";
+        }>>;
+        sandboxMode: z.ZodDefault<z.ZodEnum<{
+            "workspace-write": "workspace-write";
+            "read-only": "read-only";
+            "danger-full-access": "danger-full-access";
+        }>>;
+        ttySession: z.ZodDefault<z.ZodObject<{
+            startupTimeoutSec: z.ZodDefault<z.ZodNumber>;
+            turnTimeoutSec: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    context: z.ZodDefault<z.ZodObject<{
+        trackableGlobs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        webSearch: z.ZodDefault<z.ZodBoolean>;
+        shellCommandAllowlistAdditions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        shellCommandAllowlistRemovals: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    workspace: z.ZodDefault<z.ZodObject<{
+        strategy: z.ZodLiteral<"git_worktree">;
+        baseRef: z.ZodOptional<z.ZodString>;
+        currentRef: z.ZodOptional<z.ZodString>;
+        currentPath: z.ZodOptional<z.ZodString>;
+        promoted: z.ZodDefault<z.ZodBoolean>;
+        promotedAt: z.ZodOptional<z.ZodString>;
+        promotedRunId: z.ZodOptional<z.ZodString>;
+        promotedDecisionId: z.ZodOptional<z.ZodString>;
+        promotedCommitSha: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    stopPolicy: z.ZodDefault<z.ZodObject<{
+        repeatedFailures: z.ZodDefault<z.ZodNumber>;
+        noMeaningfulProgress: z.ZodDefault<z.ZodNumber>;
+        insufficientEvidence: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    progress: z.ZodDefault<z.ZodObject<{
+        completedCycles: z.ZodDefault<z.ZodNumber>;
+        nextCycle: z.ZodDefault<z.ZodNumber>;
+        latestRunId: z.ZodOptional<z.ZodString>;
+        latestDecisionId: z.ZodOptional<z.ZodString>;
+        latestFrontierIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        repeatedFailureStreak: z.ZodDefault<z.ZodNumber>;
+        noMeaningfulProgressStreak: z.ZodDefault<z.ZodNumber>;
+        insufficientEvidenceStreak: z.ZodDefault<z.ZodNumber>;
+        lastMeaningfulProgressCycle: z.ZodOptional<z.ZodNumber>;
+        lastCheckpointAt: z.ZodOptional<z.ZodString>;
+        lastSignals: z.ZodOptional<z.ZodObject<{
+            cycle: z.ZodNumber;
+            outcome: z.ZodEnum<{
+                accepted: "accepted";
+                rejected: "rejected";
+                needs_human: "needs_human";
+                failed: "failed";
+            }>;
+            changedFileCount: z.ZodDefault<z.ZodNumber>;
+            diffLineCount: z.ZodDefault<z.ZodNumber>;
+            repeatedDiff: z.ZodDefault<z.ZodBoolean>;
+            verificationDelta: z.ZodOptional<z.ZodNumber>;
+            newArtifacts: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            meaningfulProgress: z.ZodBoolean;
+            insufficientEvidence: z.ZodDefault<z.ZodBoolean>;
+            agentTieBreakerUsed: z.ZodDefault<z.ZodBoolean>;
+            agentSummary: z.ZodOptional<z.ZodString>;
+            reasons: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    stopCondition: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"none">;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"goal_achieved">;
+        summary: z.ZodString;
+        achievedAtCycle: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"repeated_failures">;
+        count: z.ZodNumber;
+        threshold: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"no_meaningful_progress">;
+        count: z.ZodNumber;
+        threshold: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"insufficient_evidence">;
+        count: z.ZodNumber;
+        threshold: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"operator_stop">;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"unrecoverable_error">;
+        message: z.ZodString;
+        stack: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "type">>;
+    resume: z.ZodDefault<z.ZodObject<{
+        resumable: z.ZodDefault<z.ZodBoolean>;
+        checkpointType: z.ZodLiteral<"completed_cycle_boundary">;
+        resumeFromCycle: z.ZodNumber;
+        requiresUserConfirmation: z.ZodDefault<z.ZodBoolean>;
+        checkpointRunId: z.ZodOptional<z.ZodString>;
+        checkpointDecisionId: z.ZodOptional<z.ZodString>;
+        interruptionDetectedAt: z.ZodOptional<z.ZodString>;
+        interruptedDuringCycle: z.ZodOptional<z.ZodNumber>;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    submittedSnapshot: z.ZodOptional<z.ZodObject<{
+        sessionId: z.ZodString;
+        goal: z.ZodString;
+        workingDirectory: z.ZodString;
+        status: z.ZodEnum<{
+            running: "running";
+            draft: "draft";
+            awaiting_resume: "awaiting_resume";
+            halted: "halted";
+            goal_achieved: "goal_achieved";
+            failed: "failed";
+        }>;
+        agent: z.ZodObject<{
+            type: z.ZodLiteral<"codex_cli">;
+            command: z.ZodDefault<z.ZodString>;
+            model: z.ZodOptional<z.ZodString>;
+            approvalPolicy: z.ZodDefault<z.ZodEnum<{
+                never: "never";
+                "on-failure": "on-failure";
+                "on-request": "on-request";
+                untrusted: "untrusted";
+            }>>;
+            sandboxMode: z.ZodDefault<z.ZodEnum<{
+                "workspace-write": "workspace-write";
+                "read-only": "read-only";
+                "danger-full-access": "danger-full-access";
+            }>>;
+            ttySession: z.ZodDefault<z.ZodObject<{
+                startupTimeoutSec: z.ZodDefault<z.ZodNumber>;
+                turnTimeoutSec: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        context: z.ZodObject<{
+            trackableGlobs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            webSearch: z.ZodDefault<z.ZodBoolean>;
+            shellCommandAllowlistAdditions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            shellCommandAllowlistRemovals: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>;
+        workspace: z.ZodObject<{
+            strategy: z.ZodLiteral<"git_worktree">;
+            baseRef: z.ZodOptional<z.ZodString>;
+            currentRef: z.ZodOptional<z.ZodString>;
+            currentPath: z.ZodOptional<z.ZodString>;
+            promoted: z.ZodDefault<z.ZodBoolean>;
+            promotedAt: z.ZodOptional<z.ZodString>;
+            promotedRunId: z.ZodOptional<z.ZodString>;
+            promotedDecisionId: z.ZodOptional<z.ZodString>;
+            promotedCommitSha: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        stopPolicy: z.ZodObject<{
+            repeatedFailures: z.ZodDefault<z.ZodNumber>;
+            noMeaningfulProgress: z.ZodDefault<z.ZodNumber>;
+            insufficientEvidence: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>;
+        progress: z.ZodObject<{
+            completedCycles: z.ZodDefault<z.ZodNumber>;
+            nextCycle: z.ZodDefault<z.ZodNumber>;
+            latestRunId: z.ZodOptional<z.ZodString>;
+            latestDecisionId: z.ZodOptional<z.ZodString>;
+            latestFrontierIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            repeatedFailureStreak: z.ZodDefault<z.ZodNumber>;
+            noMeaningfulProgressStreak: z.ZodDefault<z.ZodNumber>;
+            insufficientEvidenceStreak: z.ZodDefault<z.ZodNumber>;
+            lastMeaningfulProgressCycle: z.ZodOptional<z.ZodNumber>;
+            lastCheckpointAt: z.ZodOptional<z.ZodString>;
+            lastSignals: z.ZodOptional<z.ZodObject<{
+                cycle: z.ZodNumber;
+                outcome: z.ZodEnum<{
+                    accepted: "accepted";
+                    rejected: "rejected";
+                    needs_human: "needs_human";
+                    failed: "failed";
+                }>;
+                changedFileCount: z.ZodDefault<z.ZodNumber>;
+                diffLineCount: z.ZodDefault<z.ZodNumber>;
+                repeatedDiff: z.ZodDefault<z.ZodBoolean>;
+                verificationDelta: z.ZodOptional<z.ZodNumber>;
+                newArtifacts: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                meaningfulProgress: z.ZodBoolean;
+                insufficientEvidence: z.ZodDefault<z.ZodBoolean>;
+                agentTieBreakerUsed: z.ZodDefault<z.ZodBoolean>;
+                agentSummary: z.ZodOptional<z.ZodString>;
+                reasons: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        stopCondition: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"none">;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"goal_achieved">;
+            summary: z.ZodString;
+            achievedAtCycle: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"repeated_failures">;
+            count: z.ZodNumber;
+            threshold: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"no_meaningful_progress">;
+            count: z.ZodNumber;
+            threshold: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"insufficient_evidence">;
+            count: z.ZodNumber;
+            threshold: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"operator_stop">;
+            note: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"unrecoverable_error">;
+            message: z.ZodString;
+            stack: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>], "type">;
+        resume: z.ZodObject<{
+            resumable: z.ZodDefault<z.ZodBoolean>;
+            checkpointType: z.ZodLiteral<"completed_cycle_boundary">;
+            resumeFromCycle: z.ZodNumber;
+            requiresUserConfirmation: z.ZodDefault<z.ZodBoolean>;
+            checkpointRunId: z.ZodOptional<z.ZodString>;
+            checkpointDecisionId: z.ZodOptional<z.ZodString>;
+            interruptionDetectedAt: z.ZodOptional<z.ZodString>;
+            interruptedDuringCycle: z.ZodOptional<z.ZodNumber>;
+            note: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        draftState: z.ZodOptional<z.ZodObject<{
+            currentStep: z.ZodDefault<z.ZodEnum<{
+                outputs: "outputs";
+                permissions: "permissions";
+                stopRules: "stopRules";
+                review: "review";
+            }>>;
+            completedSteps: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                outputs: "outputs";
+                permissions: "permissions";
+                stopRules: "stopRules";
+                review: "review";
+            }>>>;
+            returnToReview: z.ZodDefault<z.ZodBoolean>;
+            reviewConfirmed: z.ZodDefault<z.ZodBoolean>;
+            flowState: z.ZodOptional<z.ZodObject<{
+                permissions: z.ZodOptional<z.ZodObject<{
+                    workingDirectory: z.ZodOptional<z.ZodString>;
+                    webSearch: z.ZodOptional<z.ZodString>;
+                    shellCommandAllowlistAdditions: z.ZodOptional<z.ZodString>;
+                    shellCommandAllowlistRemovals: z.ZodOptional<z.ZodString>;
+                    approvalPolicy: z.ZodOptional<z.ZodString>;
+                    sandboxMode: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                stopRules: z.ZodOptional<z.ZodObject<{
+                    repeatedFailures: z.ZodOptional<z.ZodString>;
+                    noMeaningfulProgress: z.ZodOptional<z.ZodString>;
+                    insufficientEvidence: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                outputs: z.ZodOptional<z.ZodObject<{
+                    goal: z.ZodOptional<z.ZodString>;
+                    trackableGlobs: z.ZodOptional<z.ZodString>;
+                    baseRef: z.ZodOptional<z.ZodString>;
+                    agentCommand: z.ZodOptional<z.ZodString>;
+                    model: z.ZodOptional<z.ZodString>;
+                    startupTimeoutSec: z.ZodOptional<z.ZodString>;
+                    turnTimeoutSec: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                review: z.ZodOptional<z.ZodObject<{
+                    sections: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                        index: z.ZodString;
+                        label: z.ZodString;
+                        step: z.ZodEnum<{
+                            outputs: "outputs";
+                            permissions: "permissions";
+                            stopRules: "stopRules";
+                        }>;
+                        fields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                            label: z.ZodString;
+                            value: z.ZodString;
+                        }, z.core.$strip>>>;
+                    }, z.core.$strip>>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            goalStep: z.ZodOptional<z.ZodObject<{
+                goal: z.ZodOptional<z.ZodString>;
+                agentCommand: z.ZodOptional<z.ZodString>;
+                repeatedFailures: z.ZodOptional<z.ZodString>;
+                noMeaningfulProgress: z.ZodOptional<z.ZodString>;
+                insufficientEvidence: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            contextStep: z.ZodOptional<z.ZodObject<{
+                trackableGlobs: z.ZodOptional<z.ZodString>;
+                webSearch: z.ZodOptional<z.ZodString>;
+                shellCommandAllowlistAdditions: z.ZodOptional<z.ZodString>;
+                shellCommandAllowlistRemovals: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            workspaceStep: z.ZodOptional<z.ZodObject<{
+                workingDirectory: z.ZodOptional<z.ZodString>;
+                baseRef: z.ZodOptional<z.ZodString>;
+                allowedGlobs: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            agentStep: z.ZodOptional<z.ZodObject<{
+                command: z.ZodOptional<z.ZodString>;
+                model: z.ZodOptional<z.ZodString>;
+                approvalPolicy: z.ZodOptional<z.ZodString>;
+                sandboxMode: z.ZodOptional<z.ZodString>;
+                startupTimeoutSec: z.ZodOptional<z.ZodString>;
+                turnTimeoutSec: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+        endedAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    draftState: z.ZodOptional<z.ZodObject<{
+        currentStep: z.ZodDefault<z.ZodEnum<{
+            outputs: "outputs";
+            permissions: "permissions";
+            stopRules: "stopRules";
+            review: "review";
+        }>>;
+        completedSteps: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+            outputs: "outputs";
+            permissions: "permissions";
+            stopRules: "stopRules";
+            review: "review";
+        }>>>;
+        returnToReview: z.ZodDefault<z.ZodBoolean>;
+        reviewConfirmed: z.ZodDefault<z.ZodBoolean>;
+        flowState: z.ZodOptional<z.ZodObject<{
+            permissions: z.ZodOptional<z.ZodObject<{
+                workingDirectory: z.ZodOptional<z.ZodString>;
+                webSearch: z.ZodOptional<z.ZodString>;
+                shellCommandAllowlistAdditions: z.ZodOptional<z.ZodString>;
+                shellCommandAllowlistRemovals: z.ZodOptional<z.ZodString>;
+                approvalPolicy: z.ZodOptional<z.ZodString>;
+                sandboxMode: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            stopRules: z.ZodOptional<z.ZodObject<{
+                repeatedFailures: z.ZodOptional<z.ZodString>;
+                noMeaningfulProgress: z.ZodOptional<z.ZodString>;
+                insufficientEvidence: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            outputs: z.ZodOptional<z.ZodObject<{
+                goal: z.ZodOptional<z.ZodString>;
+                trackableGlobs: z.ZodOptional<z.ZodString>;
+                baseRef: z.ZodOptional<z.ZodString>;
+                agentCommand: z.ZodOptional<z.ZodString>;
+                model: z.ZodOptional<z.ZodString>;
+                startupTimeoutSec: z.ZodOptional<z.ZodString>;
+                turnTimeoutSec: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            review: z.ZodOptional<z.ZodObject<{
+                sections: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    index: z.ZodString;
+                    label: z.ZodString;
+                    step: z.ZodEnum<{
+                        outputs: "outputs";
+                        permissions: "permissions";
+                        stopRules: "stopRules";
+                    }>;
+                    fields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                        label: z.ZodString;
+                        value: z.ZodString;
+                    }, z.core.$strip>>>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        goalStep: z.ZodOptional<z.ZodObject<{
+            goal: z.ZodOptional<z.ZodString>;
+            agentCommand: z.ZodOptional<z.ZodString>;
+            repeatedFailures: z.ZodOptional<z.ZodString>;
+            noMeaningfulProgress: z.ZodOptional<z.ZodString>;
+            insufficientEvidence: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        contextStep: z.ZodOptional<z.ZodObject<{
+            trackableGlobs: z.ZodOptional<z.ZodString>;
+            webSearch: z.ZodOptional<z.ZodString>;
+            shellCommandAllowlistAdditions: z.ZodOptional<z.ZodString>;
+            shellCommandAllowlistRemovals: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        workspaceStep: z.ZodOptional<z.ZodObject<{
+            workingDirectory: z.ZodOptional<z.ZodString>;
+            baseRef: z.ZodOptional<z.ZodString>;
+            allowedGlobs: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        agentStep: z.ZodOptional<z.ZodObject<{
+            command: z.ZodOptional<z.ZodString>;
+            model: z.ZodOptional<z.ZodString>;
+            approvalPolicy: z.ZodOptional<z.ZodString>;
+            sandboxMode: z.ZodOptional<z.ZodString>;
+            startupTimeoutSec: z.ZodOptional<z.ZodString>;
+            turnTimeoutSec: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    evidenceBundlePath: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    endedAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ResearchSessionRecord = z.infer<typeof researchSessionRecordSchema>;
+export type ResearchSessionAgent = z.infer<typeof researchSessionAgentSchema>;
+export type ResearchSessionStatus = z.infer<typeof researchSessionStatusSchema>;
+export type ResumableResearchSessionStatus = (typeof RESUMABLE_RESEARCH_SESSION_STATUSES)[number];
+export type ResearchSessionWorkspace = z.infer<typeof researchSessionWorkspaceSchema>;
+export type ResearchSessionStopPolicy = z.infer<typeof researchSessionStopPolicySchema>;
+export type ResearchSessionCycleOutcome = z.infer<typeof researchSessionCycleOutcomeSchema>;
+export type ResearchSessionProgress = z.infer<typeof researchSessionProgressSchema>;
+export type ResearchSessionProgressSignal = z.infer<typeof researchSessionProgressSignalSchema>;
+export type ResearchSessionStopCondition = z.infer<typeof researchSessionStopConditionSchema>;
+export type ResearchSessionResume = z.infer<typeof researchSessionResumeSchema>;
+export type ResearchSessionTuiSelectedCandidateDecision = z.infer<typeof researchSessionTuiSelectedCandidateDecisionSchema>;
+export type ResearchSessionTuiSelectedCandidateConfirmation = z.infer<typeof researchSessionTuiSelectedCandidateConfirmationSchema>;
+export type ResearchSessionTuiSelectedCandidateSummary = z.infer<typeof researchSessionTuiSelectedCandidateSummarySchema>;
+export type ResearchSessionMetadata = z.infer<typeof researchSessionMetadataSchema>;
+export interface BuildResearchSessionTuiSelectedCandidateSummaryOptions {
+    recovery?: ResearchSessionTuiSelectedCandidateSummary["recovery"];
+}
+export declare function isResumableResearchSessionStatus(status: ResearchSessionStatus): status is ResumableResearchSessionStatus;
+export declare function buildResearchSessionTuiSelectedCandidateSummary(session: ResearchSessionRecord, options?: BuildResearchSessionTuiSelectedCandidateSummaryOptions): ResearchSessionTuiSelectedCandidateSummary;
+export declare function buildResearchSessionMetadata(session: Pick<ResearchSessionRecord, "sessionId" | "goal" | "workingDirectory" | "status" | "createdAt" | "updatedAt" | "progress" | "resume">): ResearchSessionMetadata;
+export declare function parsePersistedResearchSessionMetadata(value: unknown): ResearchSessionMetadata;