@xingular/harness 0.1.7 → 1.0.0

package/dist/sdk/sessions/contracts.d.ts

@@ -0,0 +1,534 @@
+import { z } from 'zod';
+export declare const runStatusSchema: z.ZodEnum<{
+    queued: "queued";
+    running: "running";
+    waiting_for_approval: "waiting_for_approval";
+    waiting_for_input: "waiting_for_input";
+    interrupted: "interrupted";
+    completed: "completed";
+    failed: "failed";
+}>;
+export type RunStatus = z.infer<typeof runStatusSchema>;
+export declare const runEventTypeSchema: z.ZodEnum<{
+    completed: "completed";
+    failed: "failed";
+    started: "started";
+    "context.snapshot": "context.snapshot";
+    "message.delta": "message.delta";
+    "message.completed": "message.completed";
+    "message.steered": "message.steered";
+    "tool.started": "tool.started";
+    "tool.completed": "tool.completed";
+    "retry.started": "retry.started";
+    "retry.ended": "retry.ended";
+    "compaction.started": "compaction.started";
+    "compaction.ended": "compaction.ended";
+    "approval.requested": "approval.requested";
+    "approval.resolved": "approval.resolved";
+    "question.requested": "question.requested";
+    "question.answered": "question.answered";
+    "extension.notice": "extension.notice";
+    "reaction.added": "reaction.added";
+    "agent.message": "agent.message";
+    "checklist.updated": "checklist.updated";
+    "artifact.added": "artifact.added";
+    "file.changed": "file.changed";
+    "usage.updated": "usage.updated";
+    "account.status": "account.status";
+    "status.changed": "status.changed";
+}>;
+export type RunEventType = z.infer<typeof runEventTypeSchema>;
+/** Generic reference to content a provider stores outside the run-event stream. */
+export declare const toolAttachmentRefSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    mimeType: z.ZodString;
+}, z.core.$strict>;
+export declare const toolAttachmentRefsSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    mimeType: z.ZodString;
+}, z.core.$strict>>;
+export type ToolAttachmentRef = z.infer<typeof toolAttachmentRefSchema>;
+export declare const questionOptionSchema: z.ZodObject<{
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    recommended: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type QuestionOption = z.infer<typeof questionOptionSchema>;
+/** One line of the run's checklist. The list has no ids: every update replaces all of it. */
+export declare const checklistItemSchema: z.ZodObject<{
+    text: z.ZodString;
+    status: z.ZodEnum<{
+        completed: "completed";
+        pending: "pending";
+        in_progress: "in_progress";
+    }>;
+}, z.core.$strict>;
+export type ChecklistItem = z.infer<typeof checklistItemSchema>;
+export declare const MAX_CHECKLIST_ITEMS = 50;
+/** Where a cost figure comes from: Pi reported it, or the tokens were priced at list rates. */
+export declare const costSourceSchema: z.ZodEnum<{
+    harness: "harness";
+    estimate: "estimate";
+    mixed: "mixed";
+}>;
+export type CostSource = z.infer<typeof costSourceSchema>;
+/** What one model request used. Token fields mean the same as on the run's totals. */
+export declare const usageRequestSchema: z.ZodObject<{
+    index: z.ZodNumber;
+    responseId: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    provider: z.ZodOptional<z.ZodString>;
+    inputTokens: z.ZodOptional<z.ZodNumber>;
+    cacheReadTokens: z.ZodOptional<z.ZodNumber>;
+    cacheWriteTokens: z.ZodOptional<z.ZodNumber>;
+    outputTokens: z.ZodOptional<z.ZodNumber>;
+    reasoningTokens: z.ZodOptional<z.ZodNumber>;
+    costUsd: z.ZodOptional<z.ZodNumber>;
+    costSource: z.ZodOptional<z.ZodEnum<{
+        harness: "harness";
+        estimate: "estimate";
+    }>>;
+    reasoningSummary: z.ZodOptional<z.ZodString>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    ttftMs: z.ZodOptional<z.ZodNumber>;
+    stopReason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type UsageRequest = z.infer<typeof usageRequestSchema>;
+/** Token totals so far in this run (cumulative for the run, not the native session). */
+export declare const usagePayloadSchema: z.ZodObject<{
+    inputTokens: z.ZodOptional<z.ZodNumber>;
+    outputTokens: z.ZodOptional<z.ZodNumber>;
+    cacheReadTokens: z.ZodOptional<z.ZodNumber>;
+    cacheWriteTokens: z.ZodOptional<z.ZodNumber>;
+    reasoningTokens: z.ZodOptional<z.ZodNumber>;
+    costUsd: z.ZodOptional<z.ZodNumber>;
+    costSource: z.ZodOptional<z.ZodEnum<{
+        harness: "harness";
+        estimate: "estimate";
+        mixed: "mixed";
+    }>>;
+    requests: z.ZodOptional<z.ZodNumber>;
+    contextTokens: z.ZodOptional<z.ZodNumber>;
+    contextWindow: z.ZodOptional<z.ZodNumber>;
+    model: z.ZodOptional<z.ZodString>;
+    provider: z.ZodOptional<z.ZodString>;
+    request: z.ZodOptional<z.ZodObject<{
+        index: z.ZodNumber;
+        responseId: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+        provider: z.ZodOptional<z.ZodString>;
+        inputTokens: z.ZodOptional<z.ZodNumber>;
+        cacheReadTokens: z.ZodOptional<z.ZodNumber>;
+        cacheWriteTokens: z.ZodOptional<z.ZodNumber>;
+        outputTokens: z.ZodOptional<z.ZodNumber>;
+        reasoningTokens: z.ZodOptional<z.ZodNumber>;
+        costUsd: z.ZodOptional<z.ZodNumber>;
+        costSource: z.ZodOptional<z.ZodEnum<{
+            harness: "harness";
+            estimate: "estimate";
+        }>>;
+        reasoningSummary: z.ZodOptional<z.ZodString>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        ttftMs: z.ZodOptional<z.ZodNumber>;
+        stopReason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type UsagePayload = z.infer<typeof usagePayloadSchema>;
+export declare const accountIssueCategorySchema: z.ZodEnum<{
+    unknown: "unknown";
+    auth_expired: "auth_expired";
+    rate_limited: "rate_limited";
+    quota: "quota";
+    network: "network";
+}>;
+export type AccountIssueCategory = z.infer<typeof accountIssueCategorySchema>;
+export declare const accountLimitSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    usedPercent: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    resetsAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    windowMinutes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type AccountLimit = z.infer<typeof accountLimitSchema>;
+/** Payload schema per discriminant. */
+export declare const runEventPayloadSchemas: {
+    started: z.ZodObject<{}, z.core.$loose>;
+    'context.snapshot': z.ZodObject<{
+        systemPrompt: z.ZodString;
+        contextUpdate: z.ZodOptional<z.ZodString>;
+        tools: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodString;
+            parameters: z.ZodUnknown;
+        }, z.core.$strip>>;
+        systemPromptTruncated: z.ZodOptional<z.ZodBoolean>;
+        contextUpdateTruncated: z.ZodOptional<z.ZodBoolean>;
+        toolsTruncated: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    'message.delta': z.ZodObject<{
+        messageId: z.ZodString;
+        text: z.ZodString;
+    }, z.core.$strip>;
+    'message.completed': z.ZodObject<{
+        messageId: z.ZodString;
+        role: z.ZodEnum<{
+            user: "user";
+            assistant: "assistant";
+        }>;
+        text: z.ZodString;
+    }, z.core.$strip>;
+    'message.steered': z.ZodObject<{
+        text: z.ZodString;
+    }, z.core.$strip>;
+    'tool.started': z.ZodObject<{
+        toolCallId: z.ZodString;
+        name: z.ZodString;
+        summary: z.ZodOptional<z.ZodString>;
+        input: z.ZodOptional<z.ZodString>;
+        inputTruncated: z.ZodOptional<z.ZodBoolean>;
+        output: z.ZodOptional<z.ZodString>;
+        outputTruncated: z.ZodOptional<z.ZodBoolean>;
+        ok: z.ZodOptional<z.ZodBoolean>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        resultChars: z.ZodOptional<z.ZodNumber>;
+        attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            mimeType: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strip>;
+    'tool.completed': z.ZodObject<{
+        toolCallId: z.ZodString;
+        name: z.ZodString;
+        summary: z.ZodOptional<z.ZodString>;
+        input: z.ZodOptional<z.ZodString>;
+        inputTruncated: z.ZodOptional<z.ZodBoolean>;
+        output: z.ZodOptional<z.ZodString>;
+        outputTruncated: z.ZodOptional<z.ZodBoolean>;
+        ok: z.ZodOptional<z.ZodBoolean>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        resultChars: z.ZodOptional<z.ZodNumber>;
+        attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            mimeType: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strip>;
+    'retry.started': z.ZodObject<{
+        attempt: z.ZodNumber;
+        maxAttempts: z.ZodNumber;
+        delayMs: z.ZodNumber;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    'retry.ended': z.ZodObject<{
+        attempt: z.ZodNumber;
+        success: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    'compaction.started': z.ZodObject<{
+        reason: z.ZodString;
+    }, z.core.$strip>;
+    'compaction.ended': z.ZodObject<{
+        reason: z.ZodString;
+        aborted: z.ZodBoolean;
+        willRetry: z.ZodOptional<z.ZodBoolean>;
+        error: z.ZodOptional<z.ZodString>;
+        tokensBefore: z.ZodOptional<z.ZodNumber>;
+        tokensAfter: z.ZodOptional<z.ZodNumber>;
+        summary: z.ZodOptional<z.ZodString>;
+        summaryTruncated: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    'approval.requested': z.ZodObject<{
+        approvalId: z.ZodString;
+        target: z.ZodString;
+        action: z.ZodString;
+        screenshotRef: z.ZodOptional<z.ZodString>;
+        operation: z.ZodOptional<z.ZodObject<{
+            tool: z.ZodString;
+            args: z.ZodUnknown;
+        }, z.core.$strip>>;
+        rememberable: z.ZodOptional<z.ZodBoolean>;
+        automatic: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            remembered: "remembered";
+            scope: "scope";
+        }>>;
+    }, z.core.$strip>;
+    'approval.resolved': z.ZodObject<{
+        approvalId: z.ZodString;
+        decision: z.ZodEnum<{
+            approved: "approved";
+            denied: "denied";
+            native: "native";
+        }>;
+        automatic: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            remembered: "remembered";
+            scope: "scope";
+        }>>;
+    }, z.core.$strip>;
+    'question.requested': z.ZodObject<{
+        batchId: z.ZodOptional<z.ZodString>;
+        batchIndex: z.ZodOptional<z.ZodNumber>;
+        batchCount: z.ZodOptional<z.ZodNumber>;
+        questionId: z.ZodString;
+        question: z.ZodString;
+        summary: z.ZodOptional<z.ZodString>;
+        options: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            recommended: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        multiSelect: z.ZodBoolean;
+        allowText: z.ZodBoolean;
+        userOnly: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    'question.answered': z.ZodObject<{
+        batchId: z.ZodOptional<z.ZodString>;
+        batchIndex: z.ZodOptional<z.ZodNumber>;
+        batchCount: z.ZodOptional<z.ZodNumber>;
+        questionId: z.ZodString;
+        selected: z.ZodArray<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        notes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>;
+    'extension.notice': z.ZodObject<{
+        kind: z.ZodEnum<{
+            error: "error";
+            notify: "notify";
+            status: "status";
+            widget: "widget";
+            title: "title";
+        }>;
+        level: z.ZodOptional<z.ZodEnum<{
+            error: "error";
+            info: "info";
+            warning: "warning";
+        }>>;
+        key: z.ZodOptional<z.ZodString>;
+        text: z.ZodString;
+        extension: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    'reaction.added': z.ZodObject<{
+        emoji: z.ZodString;
+    }, z.core.$strip>;
+    'agent.message': z.ZodObject<{
+        direction: z.ZodEnum<{
+            to: "to";
+            from: "from";
+        }>;
+        agentId: z.ZodString;
+        agentName: z.ZodString;
+        text: z.ZodString;
+    }, z.core.$strip>;
+    'checklist.updated': z.ZodObject<{
+        items: z.ZodArray<z.ZodObject<{
+            text: z.ZodString;
+            status: z.ZodEnum<{
+                completed: "completed";
+                pending: "pending";
+                in_progress: "in_progress";
+            }>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    'artifact.added': z.ZodObject<{
+        artifactId: z.ZodString;
+        name: z.ZodString;
+        file: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$strip>;
+    'file.changed': z.ZodObject<{
+        path: z.ZodString;
+        change: z.ZodEnum<{
+            added: "added";
+            modified: "modified";
+            deleted: "deleted";
+        }>;
+    }, z.core.$strip>;
+    'usage.updated': z.ZodObject<{
+        inputTokens: z.ZodOptional<z.ZodNumber>;
+        outputTokens: z.ZodOptional<z.ZodNumber>;
+        cacheReadTokens: z.ZodOptional<z.ZodNumber>;
+        cacheWriteTokens: z.ZodOptional<z.ZodNumber>;
+        reasoningTokens: z.ZodOptional<z.ZodNumber>;
+        costUsd: z.ZodOptional<z.ZodNumber>;
+        costSource: z.ZodOptional<z.ZodEnum<{
+            harness: "harness";
+            estimate: "estimate";
+            mixed: "mixed";
+        }>>;
+        requests: z.ZodOptional<z.ZodNumber>;
+        contextTokens: z.ZodOptional<z.ZodNumber>;
+        contextWindow: z.ZodOptional<z.ZodNumber>;
+        model: z.ZodOptional<z.ZodString>;
+        provider: z.ZodOptional<z.ZodString>;
+        request: z.ZodOptional<z.ZodObject<{
+            index: z.ZodNumber;
+            responseId: z.ZodOptional<z.ZodString>;
+            model: z.ZodOptional<z.ZodString>;
+            provider: z.ZodOptional<z.ZodString>;
+            inputTokens: z.ZodOptional<z.ZodNumber>;
+            cacheReadTokens: z.ZodOptional<z.ZodNumber>;
+            cacheWriteTokens: z.ZodOptional<z.ZodNumber>;
+            outputTokens: z.ZodOptional<z.ZodNumber>;
+            reasoningTokens: z.ZodOptional<z.ZodNumber>;
+            costUsd: z.ZodOptional<z.ZodNumber>;
+            costSource: z.ZodOptional<z.ZodEnum<{
+                harness: "harness";
+                estimate: "estimate";
+            }>>;
+            reasoningSummary: z.ZodOptional<z.ZodString>;
+            durationMs: z.ZodOptional<z.ZodNumber>;
+            ttftMs: z.ZodOptional<z.ZodNumber>;
+            stopReason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    'account.status': z.ZodObject<{
+        accountId: z.ZodString;
+        category: z.ZodOptional<z.ZodEnum<{
+            unknown: "unknown";
+            auth_expired: "auth_expired";
+            rate_limited: "rate_limited";
+            quota: "quota";
+            network: "network";
+        }>>;
+        message: z.ZodOptional<z.ZodString>;
+        resetsAt: z.ZodOptional<z.ZodString>;
+        plan: z.ZodOptional<z.ZodString>;
+        limits: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            usedPercent: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            resetsAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            windowMinutes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+    'status.changed': z.ZodObject<{
+        status: z.ZodEnum<{
+            queued: "queued";
+            running: "running";
+            waiting_for_approval: "waiting_for_approval";
+            waiting_for_input: "waiting_for_input";
+            interrupted: "interrupted";
+            completed: "completed";
+            failed: "failed";
+        }>;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    failed: z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+    }, z.core.$strip>;
+    completed: z.ZodObject<{}, z.core.$loose>;
+};
+export declare const runEventSchema: z.ZodObject<{
+    id: z.ZodString;
+    runId: z.ZodString;
+    sessionId: z.ZodString;
+    sequence: z.ZodNumber;
+    timestamp: z.ZodString;
+    type: z.ZodEnum<{
+        completed: "completed";
+        failed: "failed";
+        started: "started";
+        "context.snapshot": "context.snapshot";
+        "message.delta": "message.delta";
+        "message.completed": "message.completed";
+        "message.steered": "message.steered";
+        "tool.started": "tool.started";
+        "tool.completed": "tool.completed";
+        "retry.started": "retry.started";
+        "retry.ended": "retry.ended";
+        "compaction.started": "compaction.started";
+        "compaction.ended": "compaction.ended";
+        "approval.requested": "approval.requested";
+        "approval.resolved": "approval.resolved";
+        "question.requested": "question.requested";
+        "question.answered": "question.answered";
+        "extension.notice": "extension.notice";
+        "reaction.added": "reaction.added";
+        "agent.message": "agent.message";
+        "checklist.updated": "checklist.updated";
+        "artifact.added": "artifact.added";
+        "file.changed": "file.changed";
+        "usage.updated": "usage.updated";
+        "account.status": "account.status";
+        "status.changed": "status.changed";
+    }>;
+    payload: z.ZodUnknown;
+    native: z.ZodOptional<z.ZodUnknown>;
+    coalescedFrom: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type RunEvent = z.infer<typeof runEventSchema>;
+/**
+ * One tracked execution interval of a session. `mode`, `harness`, `sessionType`, `worktreeId`,
+ * `attachmentCount`, `exitCode`, `handoffId` and `trigger` belong to the embedding application:
+ * the harness stores and returns them, and reads only `mode` (`chat` is an agent's own
+ * conversation, `code` is a session in a project).
+ */
+export interface RunRecord {
+    resumedFromRunId: string | null;
+    /** Opaque run lineage supplied by the embedding application. */
+    parentRunId: string | null;
+    relation: string | null;
+    terminalReason: string | null;
+    id: string;
+    projectId: string | null;
+    mode: string;
+    harness: string;
+    sessionType: string;
+    sessionId: string;
+    nativeSessionId: string | null;
+    workingDirectory: string | null;
+    worktreeId: string | null;
+    goal: string | null;
+    attachmentCount: number;
+    startedAt: string;
+    endedAt: string | null;
+    status: string;
+    exitCode: number | null;
+    handoffId: string | null;
+    /** The account the run used. */
+    accountId: string | null;
+    /** The agent that replied. */
+    agentId: string | null;
+    /** What started the run. */
+    trigger: string | null;
+    /** The variant the run used: its scope and version fingerprint. */
+    variantScope?: string | null;
+    variantVersion?: string | null;
+}
+export declare const runRecordSchema: z.ZodObject<{
+    resumedFromRunId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | null, string | null | undefined>>;
+    parentRunId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | null, string | null | undefined>>;
+    relation: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | null, string | null | undefined>>;
+    terminalReason: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | null, string | null | undefined>>;
+    id: z.ZodString;
+    projectId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | null, string | null | undefined>>;
+    mode: z.ZodString;
+    harness: z.ZodString;
+    sessionType: z.ZodString;
+    sessionId: z.ZodString;
+    nativeSessionId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | null, string | null | undefined>>;
+    workingDirectory: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | null, string | null | undefined>>;
+    worktreeId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | null, string | null | undefined>>;
+    goal: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | null, string | null | undefined>>;
+    attachmentCount: z.ZodDefault<z.ZodNumber>;
+    startedAt: z.ZodString;
+    endedAt: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | null, string | null | undefined>>;
+    status: z.ZodString;
+    exitCode: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodNumber>>, z.ZodTransform<number | null, number | null | undefined>>;
+    handoffId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | null, string | null | undefined>>;
+    accountId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | null, string | null | undefined>>;
+    agentId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | null, string | null | undefined>>;
+    trigger: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | null, string | null | undefined>>;
+    variantScope: z.ZodOptional<z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | null, string | null | undefined>>>;
+    variantVersion: z.ZodOptional<z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | null, string | null | undefined>>>;
+}, z.core.$strip>;
+/** Records written before PROP-0009 name the variant `harnessScope` and `harnessVersion`. */
+export declare function upgradeRunRecord(raw: unknown): unknown;
+export declare const ACTIVE_STATUSES: readonly string[];
+export declare function isActiveStatus(status: string): boolean;