import { type UiPersistenceOptions } from "./artifact-store.js"; import { type DecisionProvider, type UiAction, type UiDecision, type UiOutcome, type UiSnapshot } from "./contracts.js"; export declare const MAX_UI_TRACE_EVENTS = 500; export declare const MAX_UI_TRACE_EVENT_BYTES = 65536; export interface UiTraceProvenance { applicationFamily?: string; modelRevision?: string; } export interface UiTraceCost { latencyMs?: number; visionCalls?: number; plannerCalls?: number; } export interface UiRecordedChoice { id: string; kind: UiAction["kind"]; description: string; } export interface UiRecordedEvent { sequence: number; previousDigest: string | null; digest: string; state: UiSnapshot; featuresTruncated: boolean; actions: UiRecordedChoice[]; chosenActionId?: string; result: { status: UiOutcome["status"]; dispatchStatus: "dispatched" | "rejected" | "unknown"; verified: boolean; actionDigest?: string; receiptDigest?: string; afterRevision?: string; }; provenance: UiTraceProvenance & { source: "host_ui_outcome"; }; cost: UiTraceCost; } export interface UiTraceArchive { schema: "omnius.ui-trace.v1"; id: string; events: UiRecordedEvent[]; headDigest: string | null; revision: string; } export declare function parseUiTraceArchive(value: unknown, expectedRevision: string): UiTraceArchive; /** Only the host connects these tickets to controller outcomes. No model-success input exists. */ export declare class UiTraceRecorder { readonly id: string; private readonly events; private readonly positives; private pending?; constructor(id?: string); begin(state: UiSnapshot, actions: readonly UiAction[], metadata?: UiTraceProvenance): string; complete(ticket: string, outcome: UiOutcome, measurements?: UiTraceCost): UiRecordedEvent; snapshot(): UiTraceArchive; } export declare class UiTraceStore { private readonly files; constructor(options: UiPersistenceOptions); save(recorder: UiTraceRecorder, signal?: AbortSignal): Promise; load(id: string, expectedRevision: string, signal?: AbortSignal): Promise; } export interface UiTracePlaybackRow { sequence: number; recordedHostChoice?: string; recordedHostVerified: boolean; policies: Array; } /** Shadow-only: no executor/adapter/controller is accepted. Providers must already be host-preflighted. */ export declare function playbackUiTrace(archive: UiTraceArchive, providers: readonly DecisionProvider[], options?: { signal?: AbortSignal; timeoutMs?: number; }): Promise<{ status: "completed" | "cancelled"; rows: UiTracePlaybackRow[]; }>;