@cat-factory/sdk 0.5.0

package/dist/models.generated.d.ts

@@ -0,0 +1,795 @@
+export interface CreatePublicJob {
+    /** Length 1..50000. */
+    input: string;
+    /** Length 1..∞. */
+    pipelineId: string;
+    /** Length 0..200. */
+    title?: string;
+}
+export interface CreatePublicTask {
+    /** Length 0..2000. */
+    description?: string;
+    taskType?: 'feature' | 'bug' | 'document' | 'spike' | 'review' | 'ralph' | (string & {});
+    ticket?: PublicTaskTicket;
+    /** Length 1..200. */
+    title: string;
+}
+export interface DebugAgentContextSnapshot {
+    agentKind: string;
+    contextFiles: DebugContextFile[];
+    createdAt: number;
+    extras: Record<string, unknown>;
+    fragments: DebugContextFragment[];
+    /** Always present; `null` when the server has no value for it. */
+    harness: string | null;
+    /** Always present; `null` when the server has no value for it. */
+    model: string | null;
+    runId: string;
+    snapshotId: string;
+    stepIndex: number;
+    systemPrompt: DebugText;
+    userPrompt: DebugText;
+}
+export interface DebugAgentContextSummary {
+    agentKind: string;
+    contextFilesChars: number;
+    createdAt: number;
+    fragmentsChars: number;
+    /** Always present; `null` when the server has no value for it. */
+    harness: string | null;
+    /** Always present; `null` when the server has no value for it. */
+    model: string | null;
+    snapshotId: string;
+    stepIndex: number;
+    systemPromptChars: number;
+    userPromptChars: number;
+}
+export interface DebugContextFile {
+    content: DebugText;
+    path: string;
+    title: string;
+    url: string;
+}
+export interface DebugContextFragment {
+    body: DebugText;
+    id: string;
+}
+export interface DebugInfraLogEntry {
+    /** Always present; `null` when the server has no value for it. */
+    blockId: string | null;
+    createdAt: number;
+    /** Always present; `null` when the server has no value for it. */
+    detail: string | null;
+    /** Always present; `null` when the server has no value for it. */
+    error: string | null;
+    /** Always present; `null` when the server has no value for it. */
+    executionId: string | null;
+    id: string;
+    operation: DebugInfraLogEntryOperation;
+    outcome: DebugInfraLogEntryOutcome;
+    /** Always present; `null` when the server has no value for it. */
+    providerId: string | null;
+    subsystem: DebugInfraLogEntrySubsystem;
+    /** Always present; `null` when the server has no value for it. */
+    targetId: string | null;
+    workspaceId: string;
+}
+export type DebugInfraLogEntryOperation = 'provision' | 'teardown' | 'status' | 'dispatch' | 'release' | 'poll-failure';
+/** Every `DebugInfraLogEntryOperation` value, for exhaustive handling and runtime validation. */
+export declare const DEBUG_INFRA_LOG_ENTRY_OPERATION_VALUES: readonly ['provision', 'teardown', 'status', 'dispatch', 'release', 'poll-failure'];
+export type DebugInfraLogEntryOutcome = 'success' | 'failure';
+/** Every `DebugInfraLogEntryOutcome` value, for exhaustive handling and runtime validation. */
+export declare const DEBUG_INFRA_LOG_ENTRY_OUTCOME_VALUES: readonly ['success', 'failure'];
+export type DebugInfraLogEntrySubsystem = 'environment' | 'runner-pool' | 'container';
+/** Every `DebugInfraLogEntrySubsystem` value, for exhaustive handling and runtime validation. */
+export declare const DEBUG_INFRA_LOG_ENTRY_SUBSYSTEM_VALUES: readonly ['environment', 'runner-pool', 'container'];
+export interface DebugLlmAgentKindRollup {
+    agentKind: string;
+    /** Always present; `null` when the server has no value for it. */
+    cacheHitRate: number | null;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+    calls: number;
+    completionTokens: number;
+    /** Always present; `null` when the server has no value for it. */
+    costEstimate: number | null;
+    errors: number;
+    /** Always present; `null` when the server has no value for it. */
+    maxOutputTokens: number | null;
+    /** Always present; `null` when the server has no value for it. */
+    outputHeadroomRatio: number | null;
+    overheadMs: number;
+    peakCompletionTokens: number;
+    promptTokens: number;
+    /** Always present; `null` when the server has no value for it. */
+    transportOverheadRatio: number | null;
+    truncatedCalls: number;
+    upstreamMs: number;
+    warnings: number;
+}
+export interface DebugLlmCall {
+    agentKind: string;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+    callId: string;
+    completionTokens: number;
+    createdAt: number;
+    elidedLeadingMessages: number;
+    /** Always present; `null` when the server has no value for it. */
+    errorMessage: string | null;
+    /** Always present; `null` when the server has no value for it. */
+    finishReason: string | null;
+    /** Always present; `null` when the server has no value for it. */
+    httpStatus: number | null;
+    messageCount: number;
+    model: string;
+    ok: boolean;
+    outcome: LlmCallOutcome;
+    overheadMs: number;
+    phase: string;
+    prompt: DebugText;
+    promptMessages?: DebugPromptMessage[] | null;
+    promptTokens: number;
+    provider: string;
+    reasoning: DebugText;
+    /** Always present; `null` when the server has no value for it. */
+    requestMaxTokens: number | null;
+    response: DebugText;
+    /** Always present; `null` when the server has no value for it. */
+    runId: string | null;
+    streaming: boolean;
+    toolCount: number;
+    totalMs: number;
+    totalTokens: number;
+    /** Always present; `null` when the server has no value for it. */
+    turnIndex: number | null;
+    upstreamMs: number;
+}
+export interface DebugLlmPhaseRollup {
+    /** Always present; `null` when the server has no value for it. */
+    cacheHitRate: number | null;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+    calls: number;
+    /** Always present; `null` when the server has no value for it. */
+    carryCostShare: number | null;
+    carryCostTokens: number;
+    completionTokens: number;
+    /** Always present; `null` when the server has no value for it. */
+    costEstimate: number | null;
+    errors: number;
+    overheadMs: number;
+    phase: string;
+    promptTokens: number;
+    truncatedCalls: number;
+    upstreamMs: number;
+    warnings: number;
+}
+export interface DebugLlmTotals {
+    /** Always present; `null` when the server has no value for it. */
+    cacheHitRate: number | null;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+    calls: number;
+    completionTokens: number;
+    /** Always present; `null` when the server has no value for it. */
+    costEstimate: number | null;
+    errors: number;
+    overheadMs: number;
+    promptTokens: number;
+    /** Always present; `null` when the server has no value for it. */
+    transportOverheadRatio: number | null;
+    truncatedCalls: number;
+    upstreamMs: number;
+    warnings: number;
+}
+export interface DebugPromptMessage {
+    content: DebugText;
+    index: number;
+    /** Always present; `null` when the server has no value for it. */
+    name: string | null;
+    role: string;
+    /** Always present; `null` when the server has no value for it. */
+    toolCallId: string | null;
+    toolCalls: DebugToolCall[];
+}
+export interface DebugRunFailure {
+    /** Always present; `null` when the server has no value for it. */
+    detail: string | null;
+    /** Always present; `null` when the server has no value for it. */
+    hint: string | null;
+    kind: DebugRunFailureKind;
+    /** Always present; `null` when the server has no value for it. */
+    lastSubtasks: DebugSubtaskCounts | null;
+    message: string;
+    occurredAt: number;
+    reason?: string | null;
+    stepIndex?: number;
+}
+export type DebugRunFailureKind = 'preflight' | 'dispatch' | 'environment' | 'evicted' | 'timeout' | 'agent' | 'job_failed' | 'rejected' | 'companion_rejected' | 'stalled' | 'cancelled' | 'unknown';
+/** Every `DebugRunFailureKind` value, for exhaustive handling and runtime validation. */
+export declare const DEBUG_RUN_FAILURE_KIND_VALUES: readonly ['preflight', 'dispatch', 'environment', 'evicted', 'timeout', 'agent', 'job_failed', 'rejected', 'companion_rejected', 'stalled', 'cancelled', 'unknown'];
+export interface DebugRunOverview {
+    /** Always present; `null` when the server has no value for it. */
+    diagnostics: DebugRunOverviewDiagnostics | null;
+    generatedAt: number;
+    kind: 'cat-factory.run-debug-overview';
+    llm: DebugRunOverviewLlm;
+    run: DebugRunSummary;
+    signals: DebugRunSignal[];
+    sinks: DebugRunOverviewSinks;
+    steps: DebugRunStep[];
+    version: 1;
+}
+export interface DebugRunOverviewDiagnostics {
+    host?: DebugRunOverviewDiagnosticsHost;
+    lastDispatch?: DebugRunOverviewDiagnosticsLastDispatch;
+}
+export interface DebugRunOverviewDiagnosticsHost {
+    platform?: string;
+}
+export interface DebugRunOverviewDiagnosticsLastDispatch {
+    agentKind: string;
+    at: number;
+    executionBackend?: string;
+    model?: string | null;
+    repo?: DebugRunOverviewDiagnosticsLastDispatchRepo;
+    stepIndex: number;
+}
+export interface DebugRunOverviewDiagnosticsLastDispatchRepo {
+    baseBranch?: string;
+    name: string;
+    owner: string;
+    provider?: string;
+}
+export interface DebugRunOverviewLlm {
+    byAgentKind: DebugLlmAgentKindRollup[];
+    byPhase: DebugLlmPhaseRollup[];
+    /** Always present; `null` when the server has no value for it. */
+    costCurrency: string | null;
+    totals: DebugLlmTotals;
+}
+export interface DebugRunOverviewSinks {
+    agentContext: DebugRunOverviewSinksAgentContext;
+    llmCalls: DebugRunOverviewSinksAgentContext;
+    provisioningLog: DebugRunOverviewSinksAgentContext;
+    searchQueries: DebugRunOverviewSinksAgentContext;
+}
+export interface DebugRunOverviewSinksAgentContext {
+    available: boolean;
+    count: number;
+}
+export interface DebugRunSignal {
+    /** Always present; `null` when the server has no value for it. */
+    agentKind: string | null;
+    code: string;
+    /** Always present; `null` when the server has no value for it. */
+    count: number | null;
+    message: string;
+    severity: DebugRunSignalSeverity;
+    /** Always present; `null` when the server has no value for it. */
+    stepIndex: number | null;
+}
+export type DebugRunSignalSeverity = 'info' | 'warning' | 'error';
+/** Every `DebugRunSignalSeverity` value, for exhaustive handling and runtime validation. */
+export declare const DEBUG_RUN_SIGNAL_SEVERITY_VALUES: readonly ['info', 'warning', 'error'];
+export interface DebugRunStep {
+    agentKind: string;
+    evictionRecoveries: number;
+    /** Always present; `null` when the server has no value for it. */
+    finishedAt: number | null;
+    /** Always present; `null` when the server has no value for it. */
+    firstEvictionDetail: DebugText | null;
+    hasStructuredResult: boolean;
+    index: number;
+    /** Always present; `null` when the server has no value for it. */
+    lastActivityAt: number | null;
+    /** Always present; `null` when the server has no value for it. */
+    model: string | null;
+    outputChars: number;
+    progress: number;
+    skipped: boolean;
+    /** Always present; `null` when the server has no value for it. */
+    startedAt: number | null;
+    state: string;
+    /** Always present; `null` when the server has no value for it. */
+    subtasks: RunSubtaskCounts | null;
+}
+export interface DebugRunSummary {
+    blockId: string;
+    createdAt: number;
+    currentStep: number;
+    /** Always present; `null` when the server has no value for it. */
+    failure: DebugRunFailure | null;
+    pipelineId: string;
+    pipelineName: string;
+    runId: string;
+    status: RunStatus;
+    stepCount: number;
+}
+export interface DebugSearchQuery {
+    agentKind: string;
+    createdAt: number;
+    executionId: string;
+    id: string;
+    /** Always present; `null` when the server has no value for it. */
+    provider: DebugSearchQueryProvider | null;
+    query: string;
+    resultCount: number;
+    workspaceId: string;
+}
+export type DebugSearchQueryProvider = 'brave' | 'searxng';
+/** Every `DebugSearchQueryProvider` value, for exhaustive handling and runtime validation. */
+export declare const DEBUG_SEARCH_QUERY_PROVIDER_VALUES: readonly ['brave', 'searxng'];
+export interface DebugSubtaskCounts {
+    completed: number;
+    inProgress: number;
+    items?: DebugSubtaskItem[];
+    total: number;
+}
+export interface DebugSubtaskItem {
+    label: string;
+    status: DebugSubtaskItemStatus;
+}
+export type DebugSubtaskItemStatus = 'pending' | 'in_progress' | 'completed';
+/** Every `DebugSubtaskItemStatus` value, for exhaustive handling and runtime validation. */
+export declare const DEBUG_SUBTASK_ITEM_STATUS_VALUES: readonly ['pending', 'in_progress', 'completed'];
+export interface DebugText {
+    chars: number;
+    matchOffset?: number | null;
+    offset: number;
+    text: string;
+    totalChars: number;
+    truncated: boolean;
+}
+export interface DebugToolCall {
+    args: DebugText;
+    name: string;
+}
+export interface ErrorResponse {
+    error: ErrorResponseError;
+}
+export interface ErrorResponseError {
+    code: string;
+    details?: unknown;
+    issues?: ErrorResponseErrorIssue[];
+    message: string;
+}
+export interface ErrorResponseErrorIssue {
+    message: string;
+    path?: string;
+}
+export type GetDebugLlmCallView = 'raw' | 'messages';
+/** Every `GetDebugLlmCallView` value, for exhaustive handling and runtime validation. */
+export declare const GET_DEBUG_LLM_CALL_VIEW_VALUES: readonly ['raw', 'messages'];
+export interface ListDebugAgentContextResponse {
+    /** Always present; `null` when the server has no value for it. */
+    nextCursor: string | null;
+    snapshots: DebugAgentContextSummary[];
+}
+export type ListDebugLlmCallsOrder = 'newest' | 'oldest';
+/** Every `ListDebugLlmCallsOrder` value, for exhaustive handling and runtime validation. */
+export declare const LIST_DEBUG_LLM_CALLS_ORDER_VALUES: readonly ['newest', 'oldest'];
+export interface ListDebugLlmCallsResponse {
+    calls: DebugLlmCall[];
+    /** Always present; `null` when the server has no value for it. */
+    nextCursor: string | null;
+}
+export interface ListDebugLogsResponse {
+    entries: DebugInfraLogEntry[];
+    /** Always present; `null` when the server has no value for it. */
+    nextCursor: string | null;
+}
+export interface ListDebugRunsResponse {
+    /** Always present; `null` when the server has no value for it. */
+    nextCursor: string | null;
+    runs: DebugRunSummary[];
+}
+export interface ListDebugSearchQueriesResponse {
+    /** Always present; `null` when the server has no value for it. */
+    nextCursor: string | null;
+    queries: DebugSearchQuery[];
+}
+export interface ListPublicJobsResponse {
+    jobs: PublicJob[];
+    /** Always present; `null` when the server has no value for it. */
+    nextCursor: string | null;
+}
+export type LlmCallOutcome = 'ok' | 'warning' | 'error';
+/** Every `LlmCallOutcome` value, for exhaustive handling and runtime validation. */
+export declare const LLM_CALL_OUTCOME_VALUES: readonly ['ok', 'warning', 'error'];
+export interface Notification {
+    /** Always present; `null` when the server has no value for it. */
+    blockId: string | null;
+    body: string;
+    createdAt: number;
+    /** Always present; `null` when the server has no value for it. */
+    executionId: string | null;
+    id: string;
+    payload?: NotificationPayload | null;
+    /** Always present; `null` when the server has no value for it. */
+    resolvedAt: number | null;
+    severity?: NotificationSeverity;
+    status: NotificationStatus;
+    title: string;
+    type: NotificationType;
+}
+export interface NotificationPayload {
+    assessment?: NotificationPayloadAssessment;
+    changeClass?: NotificationPayloadChangeClass;
+    driftAffected?: NotificationPayloadDriftAffected[];
+    findingCount?: number;
+    forkCount?: number;
+    initiativeReason?: NotificationPayloadInitiativeReason;
+    mergeTrackRecordId?: string;
+    mergedRepos?: string[];
+    onCallAssessment?: NotificationPayloadOnCallAssessment;
+    pipelineName?: string;
+    platformAlerts?: NotificationPayloadPlatformAlert[];
+    platformFailedTotal?: number;
+    platformFailingRuns?: NotificationPayloadPlatformFailingRun[];
+    platformWindow?: NotificationPayloadPlatformWindow;
+    prUrl?: string;
+    releaseSignals?: NotificationPayloadReleaseSignal[];
+    revertUrl?: string;
+    sliceCount?: number;
+    targetUserId?: string | null;
+    unmergedRepos?: string[];
+    unreachableAreas?: NotificationPayloadUnreachableArea[];
+}
+export interface NotificationPayloadAssessment {
+    /** Range 0..1. */
+    complexity: number;
+    /** Range 0..1. */
+    impact: number;
+    rationale: string;
+    /** Range 0..1. */
+    risk: number;
+}
+export type NotificationPayloadChangeClass = 'docs' | 'test' | 'dependency' | 'config' | 'source' | 'schema' | 'unknown';
+/** Every `NotificationPayloadChangeClass` value, for exhaustive handling and runtime validation. */
+export declare const NOTIFICATION_PAYLOAD_CHANGE_CLASS_VALUES: readonly ['docs', 'test', 'dependency', 'config', 'source', 'schema', 'unknown'];
+export interface NotificationPayloadDriftAffected {
+    id: string;
+    label: string;
+    reason: NotificationPayloadDriftAffectedReason;
+    /** Always present; `null` when the server has no value for it. */
+    sealedAt: number | null;
+    source: string;
+}
+export type NotificationPayloadDriftAffectedReason = 'key-mismatch' | 'corrupt';
+/** Every `NotificationPayloadDriftAffectedReason` value, for exhaustive handling and runtime validation. */
+export declare const NOTIFICATION_PAYLOAD_DRIFT_AFFECTED_REASON_VALUES: readonly ['key-mismatch', 'corrupt'];
+export type NotificationPayloadInitiativeReason = 'item_blocked' | 'complete' | 'checkpoint';
+/** Every `NotificationPayloadInitiativeReason` value, for exhaustive handling and runtime validation. */
+export declare const NOTIFICATION_PAYLOAD_INITIATIVE_REASON_VALUES: readonly ['item_blocked', 'complete', 'checkpoint'];
+export interface NotificationPayloadOnCallAssessment {
+    /** Range 0..1. */
+    culpritConfidence: number;
+    evidence: string[];
+    rationale: string;
+    recommendation: NotificationPayloadOnCallAssessmentRecommendation;
+}
+export type NotificationPayloadOnCallAssessmentRecommendation = 'revert' | 'hold' | 'monitor';
+/** Every `NotificationPayloadOnCallAssessmentRecommendation` value, for exhaustive handling and runtime validation. */
+export declare const NOTIFICATION_PAYLOAD_ON_CALL_ASSESSMENT_RECOMMENDATION_VALUES: readonly ['revert', 'hold', 'monitor'];
+export type NotificationPayloadPlatformAlert = 'failure_rate_high' | 'duration_p99_high' | 'backlog_high' | 'throughput_stalled' | 'failure_kind_dominant' | 'sweep_degraded';
+/** Every `NotificationPayloadPlatformAlert` value, for exhaustive handling and runtime validation. */
+export declare const NOTIFICATION_PAYLOAD_PLATFORM_ALERT_VALUES: readonly ['failure_rate_high', 'duration_p99_high', 'backlog_high', 'throughput_stalled', 'failure_kind_dominant', 'sweep_degraded'];
+export interface NotificationPayloadPlatformFailingRun {
+    /** Always present; `null` when the server has no value for it. */
+    blockId: string | null;
+    createdAt: number;
+    executionId: string;
+    failureKind: string;
+}
+export type NotificationPayloadPlatformWindow = '1h' | '24h' | '7d';
+/** Every `NotificationPayloadPlatformWindow` value, for exhaustive handling and runtime validation. */
+export declare const NOTIFICATION_PAYLOAD_PLATFORM_WINDOW_VALUES: readonly ['1h', '24h', '7d'];
+export interface NotificationPayloadReleaseSignal {
+    detail?: string;
+    id: string;
+    kind: NotificationPayloadReleaseSignalKind;
+    name: string;
+    state: NotificationPayloadReleaseSignalState;
+}
+export type NotificationPayloadReleaseSignalKind = 'monitor' | 'slo';
+/** Every `NotificationPayloadReleaseSignalKind` value, for exhaustive handling and runtime validation. */
+export declare const NOTIFICATION_PAYLOAD_RELEASE_SIGNAL_KIND_VALUES: readonly ['monitor', 'slo'];
+export type NotificationPayloadReleaseSignalState = 'ok' | 'warn' | 'alert' | 'no_data';
+/** Every `NotificationPayloadReleaseSignalState` value, for exhaustive handling and runtime validation. */
+export declare const NOTIFICATION_PAYLOAD_RELEASE_SIGNAL_STATE_VALUES: readonly ['ok', 'warn', 'alert', 'no_data'];
+export type NotificationPayloadUnreachableArea = 'ephemeralEnvironments' | 'agentExecutor' | 'binaryStorage';
+/** Every `NotificationPayloadUnreachableArea` value, for exhaustive handling and runtime validation. */
+export declare const NOTIFICATION_PAYLOAD_UNREACHABLE_AREA_VALUES: readonly ['ephemeralEnvironments', 'agentExecutor', 'binaryStorage'];
+export type NotificationSeverity = 'normal' | 'urgent';
+/** Every `NotificationSeverity` value, for exhaustive handling and runtime validation. */
+export declare const NOTIFICATION_SEVERITY_VALUES: readonly ['normal', 'urgent'];
+export type NotificationStatus = 'open' | 'acted' | 'dismissed';
+/** Every `NotificationStatus` value, for exhaustive handling and runtime validation. */
+export declare const NOTIFICATION_STATUS_VALUES: readonly ['open', 'acted', 'dismissed'];
+export type NotificationType = 'merge_review' | 'pipeline_complete' | 'ci_failed' | 'test_failed' | 'requirement_review' | 'clarity_review' | 'release_regression' | 'decision_required' | 'human_test_ready' | 'visual_confirmation_ready' | 'human_review' | 'followup_pending' | 'fork_decision_pending' | 'judge_review' | 'pr_review_ready' | 'initiative' | 'platform_health' | 'infra_unreachable' | 'budget_paused' | 'key_drift' | 'merge_tag_request';
+/** Every `NotificationType` value, for exhaustive handling and runtime validation. */
+export declare const NOTIFICATION_TYPE_VALUES: readonly ['merge_review', 'pipeline_complete', 'ci_failed', 'test_failed', 'requirement_review', 'clarity_review', 'release_regression', 'decision_required', 'human_test_ready', 'visual_confirmation_ready', 'human_review', 'followup_pending', 'fork_decision_pending', 'judge_review', 'pr_review_ready', 'initiative', 'platform_health', 'infra_unreachable', 'budget_paused', 'key_drift', 'merge_tag_request'];
+export interface PublicChooseFork {
+    custom?: string | null;
+    forkId?: string | null;
+    note?: string | null;
+}
+/** Discriminated by `kind`. */
+export type PublicDecision = PublicRequirementsDecision | PublicForkDecision | PublicJudgeDecision;
+export interface PublicDecisionList {
+    decisions: PublicDecision[];
+    parked: boolean;
+    runId: string;
+    status: RunStatus;
+    taskId: string;
+}
+export interface PublicForkDecision {
+    forks: PublicForkDecisionFork[];
+    kind: 'fork';
+    /** Always present; `null` when the server has no value for it. */
+    seamSummary: string | null;
+    status: PublicForkDecisionStatus;
+}
+export interface PublicForkDecisionFork {
+    approach: string;
+    id: string;
+    recommended?: boolean;
+    riskNotes?: string | null;
+    summary: string;
+    title: string;
+    tradeoffs: string[];
+}
+export type PublicForkDecisionStatus = 'proposing' | 'awaiting_choice' | 'answering' | 'chosen' | 'single_path' | 'skipped';
+/** Every `PublicForkDecisionStatus` value, for exhaustive handling and runtime validation. */
+export declare const PUBLIC_FORK_DECISION_STATUS_VALUES: readonly ['proposing', 'awaiting_choice', 'answering', 'chosen', 'single_path', 'skipped'];
+export interface PublicIncorporate {
+    /** Length 0..4000. */
+    feedback?: string;
+}
+export interface PublicJob {
+    createdAt: number;
+    /** Always present; `null` when the server has no value for it. */
+    error: RunError | null;
+    jobId: string;
+    pipelineId: string;
+    /** Always present; `null` when the server has no value for it. */
+    result: PublicJobResult | null;
+    status: PublicJobStatus;
+}
+export interface PublicJobAccepted {
+    jobId: string;
+    links: PublicJobAcceptedLinks;
+    status: PublicJobStatus;
+}
+export interface PublicJobAcceptedLinks {
+    events: string;
+    self: string;
+}
+export interface PublicJobResult {
+    /** Always present; `null` when the server has no value for it. */
+    data: unknown | null;
+    output: string;
+}
+export type PublicJobStatus = 'running' | 'succeeded' | 'failed';
+/** Every `PublicJobStatus` value, for exhaustive handling and runtime validation. */
+export declare const PUBLIC_JOB_STATUS_VALUES: readonly ['running', 'succeeded', 'failed'];
+export interface PublicJudgeDecision {
+    bounces: number;
+    kind: 'judge';
+    maxBounces: number;
+    /** Always present; `null` when the server has no value for it. */
+    rubricId: string | null;
+    /** Always present; `null` when the server has no value for it. */
+    rubricName: string | null;
+    status: PublicJudgeDecisionStatus;
+    stepKind: string;
+    /** Always present; `null` when the server has no value for it. */
+    threshold: number | null;
+    /** Always present; `null` when the server has no value for it. */
+    verdict: PublicJudgeVerdict | null;
+}
+export type PublicJudgeDecisionStatus = 'evaluating' | 'awaiting_decision' | 'bouncing' | 'passed' | 'failed' | 'skipped';
+/** Every `PublicJudgeDecisionStatus` value, for exhaustive handling and runtime validation. */
+export declare const PUBLIC_JUDGE_DECISION_STATUS_VALUES: readonly ['evaluating', 'awaiting_decision', 'bouncing', 'passed', 'failed', 'skipped'];
+export interface PublicJudgeFinding {
+    detail?: string;
+    severity: Severity;
+    title: string;
+    where?: string;
+}
+export interface PublicJudgeVerdict {
+    findings: PublicJudgeFinding[];
+    /** Range 0..1. */
+    score: number;
+    summary: string;
+}
+export interface PublicNotificationList {
+    notifications: Notification[];
+}
+export interface PublicPipeline {
+    headlessStartable: boolean;
+    name: string;
+    pipelineId: string;
+    public: boolean;
+    steps: string[];
+}
+export interface PublicPipelineList {
+    pipelines: PublicPipeline[];
+}
+export interface PublicReplyFinding {
+    /** Length 1..4000. */
+    reply: string;
+}
+export interface PublicRequirementsDecision {
+    findings: PublicReviewFinding[];
+    /** Always present; `null` when the server has no value for it. */
+    incorporatedRequirements: string | null;
+    iteration: number;
+    kind: 'requirements-review';
+    maxIterations: number;
+    reviewId: string;
+    status: PublicRequirementsDecisionStatus;
+    taskId: string;
+}
+export type PublicRequirementsDecisionStatus = 'ready' | 'incorporating' | 'reviewing' | 'merged' | 'exceeded' | 'incorporated';
+/** Every `PublicRequirementsDecisionStatus` value, for exhaustive handling and runtime validation. */
+export declare const PUBLIC_REQUIREMENTS_DECISION_STATUS_VALUES: readonly ['ready', 'incorporating', 'reviewing', 'merged', 'exceeded', 'incorporated'];
+export interface PublicResolveExceeded {
+    choice: PublicResolveExceededChoice;
+}
+export type PublicResolveExceededChoice = 'extra-round' | 'proceed' | 'stop-reset';
+/** Every `PublicResolveExceededChoice` value, for exhaustive handling and runtime validation. */
+export declare const PUBLIC_RESOLVE_EXCEEDED_CHOICE_VALUES: readonly ['extra-round', 'proceed', 'stop-reset'];
+export interface PublicResolveJudge {
+    choice: PublicResolveJudgeChoice;
+    feedback?: string | null;
+}
+export type PublicResolveJudgeChoice = 'proceed' | 'bounce' | 'stop';
+/** Every `PublicResolveJudgeChoice` value, for exhaustive handling and runtime validation. */
+export declare const PUBLIC_RESOLVE_JUDGE_CHOICE_VALUES: readonly ['proceed', 'bounce', 'stop'];
+export interface PublicReviewFinding {
+    category: PublicReviewFindingCategory;
+    detail: string;
+    itemId: string;
+    /** Always present; `null` when the server has no value for it. */
+    reply: string | null;
+    severity: PublicReviewFindingSeverity;
+    status: PublicReviewFindingStatus;
+    title: string;
+}
+export type PublicReviewFindingCategory = 'gap' | 'clarification' | 'assumption' | 'risk' | 'question';
+/** Every `PublicReviewFindingCategory` value, for exhaustive handling and runtime validation. */
+export declare const PUBLIC_REVIEW_FINDING_CATEGORY_VALUES: readonly ['gap', 'clarification', 'assumption', 'risk', 'question'];
+export type PublicReviewFindingSeverity = 'low' | 'medium' | 'high';
+/** Every `PublicReviewFindingSeverity` value, for exhaustive handling and runtime validation. */
+export declare const PUBLIC_REVIEW_FINDING_SEVERITY_VALUES: readonly ['low', 'medium', 'high'];
+export type PublicReviewFindingStatus = 'open' | 'answered' | 'resolved' | 'dismissed' | 'recommend_requested';
+/** Every `PublicReviewFindingStatus` value, for exhaustive handling and runtime validation. */
+export declare const PUBLIC_REVIEW_FINDING_STATUS_VALUES: readonly ['open', 'answered', 'resolved', 'dismissed', 'recommend_requested'];
+export interface PublicRun {
+    createdAt: number;
+    currentStep: number;
+    /** Always present; `null` when the server has no value for it. */
+    error: RunError | null;
+    /** Always present; `null` when the server has no value for it. */
+    pullRequest: RunPullRequest | null;
+    runId: string;
+    status: RunStatus;
+    steps: PublicRunStep[];
+    taskId: string;
+}
+export interface PublicRunStep {
+    agentKind: string;
+    progress: number;
+    state: StepState;
+    /** Always present; `null` when the server has no value for it. */
+    subtasks: RunSubtaskCounts | null;
+}
+export interface PublicService {
+    description: string;
+    serviceId: string;
+    status: TaskStatus;
+    title: string;
+    type: PublicServiceType;
+}
+export interface PublicServiceList {
+    services: PublicService[];
+}
+export type PublicServiceType = 'frontend' | 'service' | 'library' | 'document' | 'api' | 'database' | 'queue' | 'integration' | 'external' | 'environment';
+/** Every `PublicServiceType` value, for exhaustive handling and runtime validation. */
+export declare const PUBLIC_SERVICE_TYPE_VALUES: readonly ['frontend', 'service', 'library', 'document', 'api', 'database', 'queue', 'integration', 'external', 'environment'];
+export interface PublicSetFindingStatus {
+    status: PublicSetFindingStatusStatus;
+}
+export type PublicSetFindingStatusStatus = 'dismissed' | 'open';
+/** Every `PublicSetFindingStatusStatus` value, for exhaustive handling and runtime validation. */
+export declare const PUBLIC_SET_FINDING_STATUS_STATUS_VALUES: readonly ['dismissed', 'open'];
+export interface PublicTask {
+    description: string;
+    progress: number;
+    /** Always present; `null` when the server has no value for it. */
+    pullRequestUrl: string | null;
+    /** Always present; `null` when the server has no value for it. */
+    runId: string | null;
+    serviceId: string;
+    status: TaskStatus;
+    taskId: string;
+    taskType: 'feature' | 'bug' | 'document' | 'spike' | 'review' | 'ralph' | 'recurring' | (string & {});
+    title: string;
+}
+export interface PublicTaskList {
+    /** Always present; `null` when the server has no value for it. */
+    nextCursor: string | null;
+    tasks: PublicTask[];
+}
+export interface PublicTaskTicket {
+    /** Length 1..500. */
+    ref: string;
+    source: 'jira' | 'github' | 'linear' | (string & {});
+}
+export interface PublicUsage {
+    budget: PublicUsageBudget;
+    currency: string;
+    periodStart: number;
+    rows: PublicUsageRow[];
+}
+export interface PublicUsageBudget {
+    costLimit: number;
+    costSpent: number;
+    exceeded: boolean;
+    inputTokens: number;
+    outputTokens: number;
+}
+export interface PublicUsageRow {
+    billing: PublicUsageRowBilling;
+    calls: number;
+    costEstimate: number;
+    inputTokens: number;
+    model: string;
+    outputTokens: number;
+    provider: string;
+    /** Always present; `null` when the server has no value for it. */
+    vendor: string | null;
+}
+export type PublicUsageRowBilling = 'metered' | 'subscription';
+/** Every `PublicUsageRowBilling` value, for exhaustive handling and runtime validation. */
+export declare const PUBLIC_USAGE_ROW_BILLING_VALUES: readonly ['metered', 'subscription'];
+export interface RunError {
+    code: string;
+    message: string;
+}
+export interface RunPullRequest {
+    /** Always present; `null` when the server has no value for it. */
+    branch: string | null;
+    url: string;
+}
+export type RunStatus = 'running' | 'blocked' | 'paused' | 'done' | 'failed';
+/** Every `RunStatus` value, for exhaustive handling and runtime validation. */
+export declare const RUN_STATUS_VALUES: readonly ['running', 'blocked', 'paused', 'done', 'failed'];
+export interface RunSubtaskCounts {
+    completed: number;
+    inProgress: number;
+    total: number;
+}
+export type Severity = 'low' | 'medium' | 'high' | 'critical';
+/** Every `Severity` value, for exhaustive handling and runtime validation. */
+export declare const SEVERITY_VALUES: readonly ['low', 'medium', 'high', 'critical'];
+export interface StartPublicTask {
+    /** Length 1..120. */
+    pipelineId?: string;
+}
+export type StepState = 'pending' | 'working' | 'waiting_decision' | 'done';
+/** Every `StepState` value, for exhaustive handling and runtime validation. */
+export declare const STEP_STATE_VALUES: readonly ['pending', 'working', 'waiting_decision', 'done'];
+export type TaskStatus = 'planned' | 'ready' | 'in_progress' | 'blocked' | 'pr_ready' | 'done';
+/** Every `TaskStatus` value, for exhaustive handling and runtime validation. */
+export declare const TASK_STATUS_VALUES: readonly ['planned', 'ready', 'in_progress', 'blocked', 'pr_ready', 'done'];
+export interface UpdatePublicTask {
+    /** Length 0..2000. */
+    description?: string;
+    /** Length 1..200. */
+    title?: string;
+}
+//# sourceMappingURL=models.generated.d.ts.map