@duckcodeailabs/dql-agent 1.14.1 → 1.14.3-rc.1

package/dist/ask-observability/observer.js

@@ -0,0 +1,537 @@
+import { ASK_TRACE_SCHEMA_VERSION } from './types.js';
+import { durationMs, fingerprint, isoNow, mintHexId } from './utils.js';
+export const ASK_TRACE_OBSERVER_V1 = Symbol('dql.askTraceObserver.v1');
+/**
+ * Explicit no-op is the universal failure mode. Callers must not need a
+ * conditional and an observability failure cannot influence the answer path.
+ */
+export const noOpAskTraceObserverV1 = Object.freeze({
+    recordingStatus: 'unavailable',
+    enabled: false,
+    startSpan: () => undefined,
+    finishSpan: () => { },
+    recordCandidateDecision: () => { },
+    recordLink: () => { },
+    finalize: () => undefined,
+    markPartial: () => { },
+    reference: () => undefined,
+});
+/**
+ * A skipped span normally documents an expected branch, rather than a failure.
+ * Only an explicit terminal/failure reason may make it the trace's first
+ * issue. This prevents an expected skipped meaning stage from eclipsing the
+ * authoritative cascade clarification or gap that follows it.
+ */
+const ISSUE_ELIGIBLE_SKIPPED_REASONS = new Set([
+    'meaning_rejected',
+    'snapshot_unavailable',
+    'source_stale',
+    'source_unavailable',
+    'cascade_ambiguous',
+    'cascade_unavailable',
+    'cascade_denied',
+    'post_freeze_failure',
+    'provider_failure',
+    'tool_failure',
+    'sql_denied',
+    'sql_failure',
+    'cancelled',
+    'interrupted',
+    'recording_failure',
+    'cap_reached',
+]);
+/** Exported for focused contract tests; never used as routing authority. */
+export function isAskTraceIssueSpanV1(input) {
+    if (input.outcome === 'error' || input.outcome === 'denied' || input.outcome === 'unavailable' || input.outcome === 'interrupted' || input.outcome === 'cancelled')
+        return true;
+    return input.outcome === 'skipped' && ISSUE_ELIGIBLE_SKIPPED_REASONS.has(input.reasonCode);
+}
+function isFinishedAskTraceSpanV1(input) {
+    if (!input || typeof input !== 'object')
+        return false;
+    const record = input;
+    return typeof record.reasonCode === 'string'
+        && (record.outcome === 'ok'
+            || record.outcome === 'error'
+            || record.outcome === 'denied'
+            || record.outcome === 'cancelled'
+            || record.outcome === 'skipped'
+            || record.outcome === 'unavailable'
+            || record.outcome === 'interrupted');
+}
+class BufferedAskTraceObserverV1 {
+    store;
+    traceId;
+    rootSpanId;
+    enabled = true;
+    envelope;
+    spans = new Map();
+    sequence = 0;
+    /** One random root seed yields collision-resistant unique child IDs per trace. */
+    spanSeed = 0n;
+    spanIdSequence = 0n;
+    candidateSequence = 0;
+    dropped = 0;
+    partial = false;
+    /** True only after the envelope itself is safely persisted. */
+    started = false;
+    finalized = false;
+    constructor(store, input) {
+        this.store = store;
+        const startedAtDate = input.now ? input.now() : new Date();
+        const now = startedAtDate.toISOString();
+        this.traceId = mintHexId(16);
+        this.rootSpanId = mintHexId(8);
+        this.spanSeed = BigInt(`0x${this.rootSpanId}`);
+        this.envelope = {
+            version: 1,
+            traceId: this.traceId,
+            rootSpanId: this.rootSpanId,
+            runId: input.runId,
+            surface: input.surface,
+            mode: input.mode,
+            ...(input.threadId ? { threadId: fingerprint(input.threadId) } : {}),
+            ...(input.snapshotId ? { snapshotId: input.snapshotId } : {}),
+            questionFingerprint: input.questionFingerprint,
+            status: 'running',
+            recordingStatus: 'recording',
+            startedAt: now,
+            spanCount: 1,
+            candidateDecisionCount: 0,
+            droppedRecordCount: 0,
+            ...(input.parentTraceId ? { parentTraceId: input.parentTraceId } : {}),
+            ...(input.parentRunId ? { parentRunId: input.parentRunId } : {}),
+        };
+        const begin = this.store.begin(this.envelope);
+        if (!begin.accepted) {
+            // Do not hand a caller an apparently-live observer when no envelope
+            // exists. The factory converts this exact start failure into the shared
+            // explicit no-op, preserving Ask's normal path and transport shape.
+            return;
+        }
+        this.started = true;
+        const root = {
+            version: 1,
+            traceId: this.traceId,
+            spanId: this.rootSpanId,
+            ordinal: this.sequence++,
+            name: input.mode === 'research' ? 'research.run' : 'ask.run',
+            stage: 'request',
+            startedAt: now,
+            outcome: 'ok',
+            reasonCode: 'started',
+            payload: { kind: 'stage', requestedMode: input.mode, fingerprint: input.questionFingerprint },
+            startedAtMs: startedAtDate.getTime(),
+        };
+        this.spans.set(this.rootSpanId, root);
+        const rootResult = this.store.appendSpan(root);
+        if (!rootResult.accepted)
+            this.markPartial('recording_failure', storeAlreadyRecordedDrop(rootResult.dropped));
+    }
+    get recordingStatus() {
+        return this.finalized ? this.envelope.recordingStatus : this.partial ? 'partial' : 'recording';
+    }
+    get initialized() {
+        return this.started;
+    }
+    startSpan(input) {
+        if (this.finalized)
+            return undefined;
+        try {
+            const spanId = this.mintChildSpanId();
+            const started = input.startedAt ? undefined : new Date();
+            const startedAt = input.startedAt ?? started.toISOString();
+            const span = {
+                version: 1,
+                traceId: this.traceId,
+                spanId,
+                parentSpanId: input.parentSpanId ?? this.rootSpanId,
+                ordinal: this.sequence++,
+                name: input.name,
+                stage: input.stage,
+                startedAt,
+                startedAtMs: input.startedAt ? Date.parse(input.startedAt) : started.getTime(),
+                outcome: 'ok',
+                reasonCode: input.reasonCode ?? 'started',
+                payload: input.payload,
+            };
+            this.spans.set(spanId, span);
+            // Most logical stages complete synchronously in the same call stack. A
+            // start record followed immediately by its finish was previously pushed
+            // through the producer twice only to be coalesced before SQLite. Retain
+            // the authoritative start timestamp in memory and persist one completed
+            // span at the physical completion boundary. The root span is still
+            // admitted at run start, so a process restart continues to expose an
+            // interrupted run even when no child stage could complete.
+            return spanId;
+        }
+        catch {
+            this.markPartial('recording_failure');
+            return undefined;
+        }
+    }
+    finishSpan(spanId, input = {}) {
+        if (!spanId || this.finalized)
+            return;
+        const previous = this.spans.get(spanId);
+        if (!previous)
+            return;
+        try {
+            const completed = input.completedAt ? undefined : new Date();
+            const completedAt = input.completedAt ?? completed.toISOString();
+            const completedAtMs = input.completedAt ? Date.parse(input.completedAt) : completed.getTime();
+            const outcome = input.outcome ?? 'ok';
+            const reasonCode = input.reasonCode ?? (outcome === 'ok' ? 'completed' : outcome === 'cancelled' ? 'cancelled' : 'unknown');
+            const next = {
+                version: 1,
+                traceId: this.traceId,
+                spanId,
+                ...(previous.parentSpanId ? { parentSpanId: previous.parentSpanId } : {}),
+                ordinal: previous.ordinal,
+                name: previous.name,
+                stage: previous.stage,
+                startedAt: previous.startedAt,
+                startedAtMs: previous.startedAtMs,
+                completedAt,
+                durationMs: elapsedDurationMs(previous.startedAtMs, completedAtMs, previous.startedAt, completedAt),
+                outcome,
+                reasonCode,
+                payload: input.payload ?? previous.payload,
+            };
+            this.spans.set(spanId, next);
+            const result = this.store.appendSpan(next);
+            if (!result.accepted)
+                this.markPartial(result.dropped === 'detail_cap' ? 'cap_reached' : 'recording_failure', storeAlreadyRecordedDrop(result.dropped));
+        }
+        catch {
+            this.markPartial('recording_failure');
+        }
+    }
+    recordCandidateDecision(input) {
+        if (this.finalized)
+            return;
+        try {
+            const result = this.store.appendCandidate({ version: 1, traceId: this.traceId, sequence: this.candidateSequence++, ...input });
+            if (!result.accepted)
+                this.markPartial(result.dropped === 'candidate_cap' || result.dropped === 'detail_cap' ? 'cap_reached' : 'recording_failure', storeAlreadyRecordedDrop(result.dropped));
+        }
+        catch {
+            this.markPartial('recording_failure');
+        }
+    }
+    recordLink(input) {
+        if (this.finalized)
+            return;
+        try {
+            const result = this.store.appendLink({
+                version: 1,
+                sourceTraceId: this.traceId,
+                sourceRunId: this.envelope.runId,
+                createdAt: isoNow(),
+                ...input,
+            });
+            if (!result.accepted)
+                this.markPartial('recording_failure', storeAlreadyRecordedDrop(result.dropped));
+        }
+        catch {
+            this.markPartial('recording_failure');
+        }
+    }
+    finalize(input) {
+        if (this.finalized)
+            return this.reference();
+        this.finalized = true;
+        const droppedReader = this.store.droppedRecordCount;
+        const storeDropped = typeof droppedReader === 'function' ? droppedReader.call(this.store, this.traceId) : 0;
+        if (storeDropped > this.dropped) {
+            this.dropped = storeDropped;
+            this.partial = true;
+        }
+        const completed = input.completedAt ? undefined : new Date();
+        const completedAt = input.completedAt ?? completed.toISOString();
+        const completedAtMs = input.completedAt ? Date.parse(input.completedAt) : completed.getTime();
+        // The root is intentionally left open until all server-owned stages have
+        // completed.  Derive its terminal reason from the recorded typed issue
+        // before closing it so a real analytical coverage gap is not presented as
+        // the generic `unknown` incident merely because the root has no direct
+        // executor callback.
+        const rootTerminalReason = terminalRootReasonCodeV1(this.spans.values(), input.status);
+        for (const [spanId, span] of this.spans) {
+            // Do not reopen a root that happened to be updated as an ordinary span.
+            if (!('completedAt' in span) || !span.completedAt) {
+                this.finishBeforeFinalize(spanId, span, completedAt, completedAtMs, input.status, rootTerminalReason);
+            }
+        }
+        // Older callers may still provide a provisional first issue. Keep it only
+        // when it wins the same authoritative priority calculation; this prevents
+        // a stale pre-freeze pointer from masking a terminal post-freeze failure.
+        // This calculation needs the full trace to distinguish a recoverable
+        // pre-freeze cascade attempt from a later physical failure. Computing it
+        // once at finalization preserves the same result while avoiding an O(n²)
+        // scan over the growing span map on every producer completion.
+        const firstIssueSpanId = selectAskTraceIssueSpanIdV1(this.spans.values(), input.firstIssueSpanId);
+        const traceFingerprint = fingerprint({
+            traceId: this.traceId,
+            runId: this.envelope.runId,
+            status: input.status,
+            terminalOutcome: input.terminalOutcome,
+            selectedTier: input.selectedTier,
+            spanCount: this.sequence,
+            candidateDecisionCount: this.candidateSequence,
+            dropped: this.dropped,
+        });
+        this.envelope = {
+            ...this.envelope,
+            status: input.status,
+            ...(input.terminalOutcome ? { terminalOutcome: input.terminalOutcome } : {}),
+            recordingStatus: this.partial ? 'partial' : 'complete',
+            ...(input.trustState ? { trustState: input.trustState } : {}),
+            ...(input.selectedTier ? { selectedTier: input.selectedTier } : {}),
+            completedAt,
+            durationMs: durationMs(this.envelope.startedAt, completedAt),
+            ...(firstIssueSpanId ? { firstIssueSpanId } : {}),
+            traceFingerprint,
+            spanCount: this.sequence,
+            candidateDecisionCount: this.candidateSequence,
+            droppedRecordCount: this.dropped,
+        };
+        const persisted = this.store.finalize(this.envelope);
+        if (!persisted.accepted) {
+            this.envelope = { ...this.envelope, recordingStatus: 'unavailable' };
+        }
+        return this.reference();
+    }
+    markPartial(_reason = 'recording_failure', alreadyRecorded = false) {
+        this.partial = true;
+        if (!alreadyRecorded) {
+            this.dropped += 1;
+            try {
+                this.store.markPartial(this.traceId);
+            }
+            catch { /* fail open */ }
+        }
+        const storeDropped = this.store.droppedRecordCount?.(this.traceId) ?? 0;
+        this.dropped = Math.max(this.dropped, storeDropped);
+    }
+    reference() {
+        return {
+            version: 1,
+            traceId: this.traceId,
+            recordingStatus: this.recordingStatus,
+            storeSchemaVersion: ASK_TRACE_SCHEMA_VERSION,
+            ...(this.envelope.traceFingerprint ? { traceFingerprint: this.envelope.traceFingerprint } : {}),
+        };
+    }
+    finishBeforeFinalize(spanId, span, completedAt, completedAtMs, status, rootTerminalReason) {
+        const outcome = status === 'cancelled' ? 'cancelled' : status === 'interrupted' ? 'interrupted' : status === 'failed' || status === 'blocked' ? 'error' : 'ok';
+        const next = {
+            version: 1,
+            traceId: this.traceId,
+            spanId,
+            ...(span.parentSpanId ? { parentSpanId: span.parentSpanId } : {}),
+            ordinal: span.ordinal,
+            name: span.name,
+            stage: span.stage,
+            startedAt: span.startedAt,
+            startedAtMs: span.startedAtMs,
+            completedAt,
+            durationMs: elapsedDurationMs(span.startedAtMs, completedAtMs, span.startedAt, completedAt),
+            outcome,
+            reasonCode: outcome === 'ok'
+                ? 'completed'
+                : outcome === 'cancelled'
+                    ? 'cancelled'
+                    : outcome === 'interrupted'
+                        ? 'interrupted'
+                        : (span.name === 'ask.run' || span.name === 'research.run') && rootTerminalReason
+                            ? rootTerminalReason
+                            : 'unknown',
+            payload: span.payload,
+        };
+        this.spans.set(spanId, next);
+        const result = this.store.appendSpan(next);
+        if (!result.accepted)
+            this.markPartial('recording_failure', storeAlreadyRecordedDrop(result.dropped));
+    }
+    mintChildSpanId() {
+        const mask = 0xffffffffffffffffn;
+        let value = (this.spanSeed + (++this.spanIdSequence)) & mask;
+        // W3C IDs may not be all-zero. A wrap can only happen at the boundary,
+        // but preserve the invariant without consuming a second random byte draw.
+        if (value === 0n)
+            value = (this.spanSeed + (++this.spanIdSequence)) & mask;
+        return value.toString(16).padStart(16, '0');
+    }
+}
+/**
+ * Root spans have no independent route authority. They may, however, reflect
+ * the terminal typed stage already persisted in the same trace. This keeps a
+ * coverage gap, provider failure, or SQL refusal actionable without deriving
+ * an incident from user-facing prose.
+ */
+function terminalRootReasonCodeV1(values, status) {
+    if (status !== 'blocked' && status !== 'failed')
+        return undefined;
+    const spans = [...values].filter(isFinishedTraceIssueSpanV1);
+    const cascade = spans.find((span) => {
+        const decision = safeCascadeDecisionRecordV1(span);
+        return decision?.stopReason === 'coverage_gap';
+    });
+    if (cascade)
+        return 'cascade_unavailable';
+    if (spans.some((span) => span.reasonCode === 'cascade_denied'))
+        return 'cascade_denied';
+    if (spans.some((span) => span.reasonCode === 'cascade_ambiguous'))
+        return 'cascade_ambiguous';
+    if (spans.some((span) => span.reasonCode === 'run_deadline'))
+        return 'run_deadline';
+    if (spans.some((span) => span.reasonCode === 'research_branch_timeout'))
+        return 'research_branch_timeout';
+    if (spans.some((span) => span.reasonCode === 'execution_failed'))
+        return 'execution_failed';
+    if (spans.some((span) => span.reasonCode === 'provider_failure'))
+        return 'provider_failure';
+    if (spans.some((span) => span.reasonCode === 'sql_denied'))
+        return 'sql_denied';
+    if (spans.some((span) => span.reasonCode === 'sql_failure'))
+        return 'sql_failure';
+    if (spans.some((span) => span.reasonCode === 'post_freeze_failure'))
+        return 'post_freeze_failure';
+    return undefined;
+}
+/**
+ * Select the incident that a local operator can act on. This deliberately
+ * differs from `isAskTraceIssueSpanV1`: that exported predicate remains a
+ * small compatibility check for one span, while the selection needs the
+ * cascade and freeze context carried by the full trace.
+ */
+function selectAskTraceIssueSpanIdV1(values, _explicitIssueSpanId) {
+    const spans = [...values].filter(isFinishedTraceIssueSpanV1);
+    const candidates = spans
+        .map((span) => ({ span, priority: askTraceIssuePriorityV1(span, spans) }))
+        .filter((entry) => entry.priority > 0)
+        .sort((left, right) => right.priority - left.priority || right.span.ordinal - left.span.ordinal);
+    return candidates[0]?.span.spanId;
+}
+function isFinishedTraceIssueSpanV1(value) {
+    if (!isFinishedAskTraceSpanV1(value) || !value || typeof value !== 'object')
+        return false;
+    const span = value;
+    return typeof span.spanId === 'string'
+        && typeof span.ordinal === 'number'
+        && typeof span.name === 'string'
+        && typeof span.stage === 'string'
+        && Boolean(span.payload && typeof span.payload === 'object');
+}
+function askTraceIssuePriorityV1(span, allSpans) {
+    if (!isAskTraceIssueSpanV1(span))
+        return 0;
+    if (isRecoverableCascadeAttemptV1(span))
+        return 0;
+    if (isPostFreezePhysicalFailureV1(span, allSpans))
+        return 40;
+    if (isTerminalCascadeIssueV1(span))
+        return 30;
+    if (span.outcome === 'denied')
+        return 20;
+    return 10;
+}
+function isRecoverableCascadeAttemptV1(span) {
+    if (span.stage !== 'cascade' || !span.name.startsWith('cascade.') || span.name === 'cascade.evaluate' || span.name === 'cascade.clarify_or_gap')
+        return false;
+    if (span.outcome !== 'unavailable' && !(span.outcome === 'skipped' && span.reasonCode === 'cascade_ineligible'))
+        return false;
+    const decision = safeCascadeDecisionRecordV1(span);
+    if (!decision || decision.stopReason !== 'selected' || !decision.selectedTier || decision.selectedTier === tierForCascadeSpanV1(span.name))
+        return false;
+    const attempt = Array.isArray(decision.attempts) ? decision.attempts[0] : undefined;
+    return Boolean(attempt && typeof attempt === 'object'
+        && (attempt.outcome === 'unavailable' || attempt.outcome === 'ineligible'));
+}
+function isTerminalCascadeIssueV1(span) {
+    if (span.stage !== 'cascade')
+        return false;
+    const decision = safeCascadeDecisionRecordV1(span);
+    if (!decision)
+        return false;
+    if (decision.stopReason === 'post_freeze_failure')
+        return true;
+    if (span.name === 'cascade.clarify_or_gap') {
+        return decision.stopReason === 'ambiguous' || decision.stopReason === 'coverage_gap' || decision.stopReason === 'denied';
+    }
+    return span.name === 'cascade.evaluate' && (decision.stopReason === 'denied' || decision.stopReason === 'coverage_gap');
+}
+function isPostFreezePhysicalFailureV1(span, allSpans) {
+    if (span.reasonCode === 'post_freeze_failure')
+        return true;
+    if (span.stage !== 'provider' && span.stage !== 'tool' && span.stage !== 'sql' && span.stage !== 'result')
+        return false;
+    return allSpans.some((candidate) => candidate.name === 'plan.freeze'
+        && candidate.outcome === 'ok'
+        && candidate.ordinal < span.ordinal);
+}
+function safeCascadeDecisionRecordV1(span) {
+    if (span.payload.kind !== 'cascade')
+        return undefined;
+    const payload = span.payload;
+    const nested = payload.decision;
+    return nested && typeof nested === 'object' && !Array.isArray(nested)
+        ? nested
+        : undefined;
+}
+function tierForCascadeSpanV1(name) {
+    const tiers = {
+        'cascade.certified': 'certified',
+        'cascade.semantic': 'semantic',
+        'cascade.governed_relational': 'governed_relational',
+        'cascade.exploratory_sql': 'exploratory_sql',
+        'cascade.clarify_or_gap': 'clarify_or_gap',
+    };
+    return tiers[name];
+}
+function elapsedDurationMs(startedAtMs, completedAtMs, startedAt, completedAt) {
+    if (Number.isFinite(startedAtMs) && Number.isFinite(completedAtMs))
+        return Math.max(0, completedAtMs - startedAtMs);
+    return durationMs(startedAt, completedAt);
+}
+function storeAlreadyRecordedDrop(dropped) {
+    return dropped === 'span_cap'
+        || dropped === 'candidate_cap'
+        || dropped === 'detail_cap'
+        || dropped === 'store_cap'
+        || dropped === 'queue_cap';
+}
+export function createAskTraceObserverV1(input) {
+    if (!input.store || !input.store.status().recordingEnabled || process.env.DQL_ASK_OBSERVABILITY === 'off') {
+        return noOpAskTraceObserverV1;
+    }
+    try {
+        const observer = new BufferedAskTraceObserverV1(input.store, input);
+        return observer.initialized ? observer : noOpAskTraceObserverV1;
+    }
+    catch {
+        return noOpAskTraceObserverV1;
+    }
+}
+/** The observer deliberately does not enumerate into HTTP/client payloads. */
+export function attachAskTraceObserverV1(target, observer) {
+    try {
+        Object.defineProperty(target, ASK_TRACE_OBSERVER_V1, {
+            value: observer,
+            enumerable: false,
+            configurable: true,
+            writable: false,
+        });
+    }
+    catch {
+        // Frozen caller input remains executable without observability.
+    }
+    return target;
+}
+export function askTraceObserverForV1(value) {
+    if (!value || (typeof value !== 'object' && typeof value !== 'function'))
+        return noOpAskTraceObserverV1;
+    return value[ASK_TRACE_OBSERVER_V1]
+        ?? noOpAskTraceObserverV1;
+}
+//# sourceMappingURL=observer.js.map

package/dist/ask-observability/observer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer.js","sourceRoot":"","sources":["../../src/ask-observability/observer.ts"],"names":[],"mappings":"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"}

package/dist/ask-observability/portable.d.ts

@@ -0,0 +1,98 @@
+import type { AskTraceDataV1, AskTraceExportReceiptV1 } from './types.js';
+export type AskTraceExportProfileV1 = 'strict' | 'support';
+export interface AskTraceExportOptionsV1 {
+    profile: AskTraceExportProfileV1;
+    outputDirectory: string;
+    /** Support exports require an explicit human confirmation from the CLI/API. */
+    confirmReviewedIdentifiers?: boolean;
+    /** Never sourced from a stored run: support prose is opt-in reviewed input. */
+    reviewedQuestion?: string;
+    runReceipt?: unknown;
+    provenance?: 'live' | 'recorded' | 'synthetic' | 'migrated' | 'unknown';
+}
+export type AskTracePortableBundleOptionsV1 = Omit<AskTraceExportOptionsV1, 'outputDirectory'>;
+/** A redacted in-memory bundle for the local runtime download endpoint. */
+export interface AskTracePortableBundleV1 {
+    manifest: AskTraceBundleManifestV1;
+    trace: AskTraceDataV1;
+    runReceipt: Record<string, unknown>;
+    redactionReceipt: Record<string, unknown>;
+}
+export interface AskTraceBundleValidationV1 {
+    valid: boolean;
+    errors: string[];
+    manifest?: AskTraceBundleManifestV1;
+}
+export interface AskTraceBundleManifestV1 {
+    version: 1;
+    schema: 'dql.ask-trace-bundle.v1';
+    profile: AskTraceExportProfileV1;
+    createdAt: string;
+    provenance: 'live' | 'recorded' | 'synthetic' | 'migrated' | 'unknown';
+    bundleFingerprint: string;
+    checksums: Record<'trace.json' | 'run-receipt.json' | 'redaction-receipt.json', string>;
+    traceFingerprint?: string;
+    traceId: string;
+}
+export interface AskTraceCompareResultV1 {
+    compatibleIdentity: boolean;
+    leftTraceId: string;
+    rightTraceId: string;
+    selectedTier: {
+        left?: string;
+        right?: string;
+        matches: boolean;
+    };
+    recordingStatus: {
+        left: string;
+        right: string;
+        matches: boolean;
+    };
+    sourceCoverageChanges: Array<{
+        source: string;
+        left?: string;
+        right?: string;
+    }>;
+    candidateReasonChanges: Array<{
+        role: string;
+        reason: string;
+        left: number;
+        right: number;
+    }>;
+    attempts: {
+        left: number;
+        right: number;
+    };
+    providerAttempts: {
+        left: number;
+        right: number;
+    };
+    toolCalls: {
+        left: number;
+        right: number;
+    };
+    sqlAttempts: {
+        left: number;
+        right: number;
+    };
+    trustState: {
+        left?: string;
+        right?: string;
+        matches: boolean;
+    };
+    durationDeltaMs?: number;
+    notes: string[];
+}
+export declare function createAskTracePortableBundleV1(trace: AskTraceDataV1, options: AskTracePortableBundleOptionsV1): AskTracePortableBundleV1;
+export declare function exportAskTraceBundleV1(trace: AskTraceDataV1, options: AskTraceExportOptionsV1): AskTraceExportReceiptV1;
+export declare function validateAskTraceBundleV1(directory: string): AskTraceBundleValidationV1;
+/** Offline-only receipt replay. It validates; it never imports providers/tools/connectors. */
+export declare function replayAskTraceReceiptV1(directory: string): {
+    valid: boolean;
+    errors: string[];
+    trace?: AskTraceDataV1;
+};
+export declare function compareAskTracesV1(left: AskTraceDataV1, right: AskTraceDataV1): AskTraceCompareResultV1;
+/** Portable, local JSON mapper — intentionally no OTLP network exporter. */
+export declare function toOtlpOpenInferenceJsonV1(trace: AskTraceDataV1): Record<string, unknown>;
+//# sourceMappingURL=portable.d.ts.map