@duckcodeailabs/dql-agent 1.14.2 → 1.14.4

package/dist/ask-observability/instrumentation.js

@@ -0,0 +1,523 @@
+import { fingerprint } from './utils.js';
+const tierSpan = {
+    certified: 'cascade.certified',
+    semantic: 'cascade.semantic',
+    governed_relational: 'cascade.governed_relational',
+    exploratory_sql: 'cascade.exploratory_sql',
+    clarify_or_gap: 'cascade.clarify_or_gap',
+};
+/**
+ * The router hands observability an already-authoritative decision. Projecting
+ * the same immutable decision into the cascade and freeze spans must not spend
+ * a second canonical JSON + SHA-256 pass per Ask. Weak ownership keeps this a
+ * pure producer cache: it cannot retain a route or become routing authority.
+ */
+const safeCascadeDecisionCache = new WeakMap();
+const safeCascadeAttemptCache = new WeakMap();
+/**
+ * V8 is the terminal authority for an authoritative-V2 run. The trace
+ * envelope is intentionally a small indexed projection, so it needs this
+ * explicit bridge rather than falling back to a stale V1/V3 cascade field.
+ */
+function selectedTierFromAuthoritativeV8(run) {
+    const receipt = run.diagnosticReceiptV8;
+    if (receipt?.mode !== 'authoritative_v2')
+        return undefined;
+    return receipt.tierAttempts.find((attempt) => attempt.frozen)?.tier
+        ?? receipt.tierAttempts.find((attempt) => attempt.outcome === 'executed')?.tier
+        ?? (receipt.planFrozen ? run.routeDecision?.askAgentV2Decision?.state.resolvedPlan?.tier : undefined)
+        // An unfrozen V2 run still has one authoritative controller position.
+        // Preserve it in the indexed envelope instead of inheriting a stale V1
+        // cascade selection (for example, semantic after the controller has
+        // already advanced to governed relational or exploratory SQL).
+        ?? receipt.controllerTier;
+}
+export function recordAuthoritativeRouterDecisionV1(observer, decision) {
+    if (!observer.enabled)
+        return;
+    const evidence = decision.retrievalEvidence;
+    if (evidence) {
+        const snapshot = observer.startSpan({
+            name: 'snapshot.acquire', stage: 'snapshot', reasonCode: 'completed',
+            payload: { kind: 'snapshot', snapshotId: evidence.snapshotId, sourceFingerprint: evidence.sourceFingerprint, freshness: 'unknown' },
+        });
+        observer.finishSpan(snapshot, { outcome: 'ok', reasonCode: 'completed' });
+        const retrieval = observer.startSpan({
+            name: 'retrieval', stage: 'retrieval', reasonCode: 'completed',
+            payload: { kind: 'retrieval', candidateCount: evidence.candidateCount, fingerprint: evidence.sourceFingerprint },
+        });
+        observer.finishSpan(retrieval, { outcome: 'ok', reasonCode: 'completed' });
+    }
+    const requirements = decision.analyticalCascadeDecision?.requirements;
+    // A missing meaning result is not itself a rejected model decision. In
+    // particular, deterministic pre-meaning clarifications (such as an
+    // undeclared fiscal calendar) deliberately skip the model call. Keep that
+    // span non-issue and let the authoritative cascade own the clarification.
+    const meaningRejected = Boolean(decision.meaningResolutionErrorCode);
+    const meaningResolved = Boolean(decision.meaningResolution);
+    const meaningReasonCode = meaningRejected
+        ? 'meaning_rejected'
+        : meaningResolved
+            ? 'meaning_resolved'
+            : decision.analyticalCascadeDecision?.stopReason === 'coverage_gap'
+                ? 'cascade_unavailable'
+                : 'unknown';
+    const meaningOutcome = meaningRejected
+        ? 'error'
+        : decision.requiresClarification || !meaningResolved
+            ? 'skipped'
+            : 'ok';
+    const meaning = observer.startSpan({
+        name: 'meaning.resolve', stage: 'meaning', reasonCode: meaningReasonCode,
+        payload: {
+            kind: 'meaning',
+            selectedCandidateIds: uniqueIds([
+                ...(decision.meaningResolution?.selectedConceptIds ?? []),
+                decision.meaningResolution?.recommendedExecutionId ?? '',
+            ]),
+            rejectedCandidateIds: uniqueIds((decision.meaningResolution?.rejectedCandidates ?? []).map((candidate) => candidate.id)),
+            ...(requirements ? { requirementFingerprint: fingerprint(requirements) } : {}),
+            source: decision.source === 'llm' ? 'model' : decision.source === 'cache' ? 'cache' : decision.requiresClarification ? 'selection' : 'heuristic',
+        },
+    });
+    observer.finishSpan(meaning, {
+        outcome: meaningOutcome,
+        reasonCode: meaningReasonCode,
+    });
+    // Meaning selections are only traceable when the router preserved the
+    // candidate's actual role and retrieval source. Never invent a generic
+    // `conversation/context` role simply because this adapter runs after the
+    // decision has frozen.
+    const metadata = new Map((evidence?.candidateTraceMetadata ?? []).map((entry) => [`${entry.candidateId}\u0000${entry.role}`, entry]));
+    // Authoritative V2 intentionally has no pre-tool model meaning selection.
+    // Its retrieved cards are still real snapshot admission decisions, not an
+    // empty trace.  Record the bounded initial package as admitted and the
+    // retained server-side workspace as reserved so the header and decision
+    // story distinguish "not shown to the model yet" from "not retrieved".
+    // Shadow keeps the legacy projection alone to avoid double-counting an
+    // answer it does not serve.
+    const v2State = decision.askAgentV2Decision?.mode === 'authoritative_v2'
+        ? decision.askAgentV2Decision.state
+        : undefined;
+    if (v2State) {
+        const retained = new Set(v2State.retainedCandidateIds);
+        const initial = new Set(v2State.initialCandidateIds);
+        for (const entry of metadata.values()) {
+            if (!retained.has(entry.candidateId))
+                continue;
+            const exactCertified = entry.candidateId === v2State.exactCertifiedCandidateId;
+            observer.recordCandidateDecision({
+                candidateId: entry.candidateId,
+                role: entry.role,
+                source: entry.source,
+                ...(entry.lanes?.length ? { lanes: entry.lanes, lane: entry.lanes[0]?.lane, laneRank: entry.lanes[0]?.rank } : {}),
+                decision: initial.has(entry.candidateId) ? 'admitted' : 'reserved',
+                reasonCode: exactCertified
+                    ? 'exact_name_match'
+                    : initial.has(entry.candidateId)
+                        ? 'role_reserved'
+                        : 'fused_relevance_fill',
+                compatibilityCode: 'unknown',
+            });
+        }
+    }
+    const recordMeaningCandidates = (candidateIds, decisionKind) => {
+        for (const candidateId of uniqueIds(candidateIds)) {
+            for (const entry of [...metadata.values()].filter((item) => item.candidateId === candidateId)) {
+                observer.recordCandidateDecision({
+                    candidateId,
+                    role: entry.role,
+                    source: entry.source,
+                    ...(entry.lanes?.length ? { lanes: entry.lanes, lane: entry.lanes[0]?.lane, laneRank: entry.lanes[0]?.rank } : {}),
+                    decision: decisionKind,
+                    reasonCode: decisionKind,
+                    compatibilityCode: 'unknown',
+                });
+            }
+        }
+    };
+    recordMeaningCandidates([
+        ...(decision.meaningResolution?.selectedConceptIds ?? []),
+        decision.meaningResolution?.recommendedExecutionId ?? '',
+    ], 'model_selected');
+    recordMeaningCandidates((decision.meaningResolution?.rejectedCandidates ?? []).map((candidate) => candidate.id), 'model_rejected');
+    if (decision.analyticalCascadeDecision)
+        recordCascadeDecisionV1(observer, decision.analyticalCascadeDecision);
+}
+export function recordCascadeDecisionV1(observer, decision) {
+    const traceDecision = cascadeThroughFirstFrozenTierV1(decision);
+    // The authoritative cascade keeps useful human-facing reason text. Do not
+    // leak it into a durable trace: this projection preserves only decision
+    // mechanics, qualified IDs, and one-way fingerprints of reasons.
+    const safeDecision = safeCascadeDecision(traceDecision);
+    const cascade = observer.startSpan({
+        name: 'cascade.evaluate', stage: 'cascade',
+        reasonCode: traceDecision.stopReason === 'selected' ? 'cascade_selected' : traceDecision.stopReason === 'denied' ? 'cascade_denied' : traceDecision.stopReason === 'ambiguous' ? 'cascade_ambiguous' : traceDecision.stopReason === 'post_freeze_failure' ? 'post_freeze_failure' : 'cascade_unavailable',
+        payload: { kind: 'cascade', decision: safeDecision },
+    });
+    for (const attempt of traceDecision.attempts) {
+        const span = observer.startSpan({
+            name: (tierSpan[attempt.tier] ?? 'cascade.clarify_or_gap'),
+            stage: 'cascade',
+            parentSpanId: cascade,
+            reasonCode: attempt.outcome === 'executable' ? 'cascade_selected' : attempt.outcome === 'denied' ? 'cascade_denied' : attempt.outcome === 'ambiguous' ? 'cascade_ambiguous' : attempt.outcome === 'unavailable' ? 'cascade_unavailable' : 'cascade_ineligible',
+            payload: { kind: 'cascade', decision: { ...safeDecision, attempts: [safeCascadeAttempt(attempt)] } },
+        });
+        observer.finishSpan(span, {
+            outcome: attempt.outcome === 'executable' ? 'ok' : attempt.outcome === 'denied' ? 'denied' : attempt.outcome === 'unavailable' ? 'unavailable' : attempt.outcome === 'ambiguous' ? 'skipped' : 'skipped',
+            reasonCode: attempt.outcome === 'executable' ? 'cascade_selected' : attempt.outcome === 'denied' ? 'cascade_denied' : attempt.outcome === 'ambiguous' ? 'cascade_ambiguous' : attempt.outcome === 'unavailable' ? 'cascade_unavailable' : 'cascade_ineligible',
+        });
+    }
+    observer.finishSpan(cascade, {
+        outcome: traceDecision.stopReason === 'denied' ? 'denied' : traceDecision.stopReason === 'post_freeze_failure' ? 'error' : 'ok',
+        reasonCode: traceDecision.stopReason === 'selected' ? 'cascade_selected' : traceDecision.stopReason === 'denied' ? 'cascade_denied' : traceDecision.stopReason === 'ambiguous' ? 'cascade_ambiguous' : traceDecision.stopReason === 'post_freeze_failure' ? 'post_freeze_failure' : 'cascade_unavailable',
+    });
+    recordAuthoritativePlanFreezeV1(observer, traceDecision);
+}
+/**
+ * A freeze may be present in the router's initial cascade decision or arrive
+ * only when the host validates an exploratory execution receipt. Project the
+ * exact authoritative state at either boundary; callers guard late promotion
+ * so a plan is never represented as freezing twice.
+ */
+export function recordAuthoritativePlanFreezeV1(observer, decision) {
+    if (!observer.enabled || !decision.planFrozen)
+        return;
+    const traceDecision = cascadeThroughFirstFrozenTierV1(decision);
+    const freeze = observer.startSpan({
+        name: 'plan.freeze', stage: 'plan', reasonCode: 'plan_frozen',
+        payload: { kind: 'cascade', decision: safeCascadeDecision(traceDecision) },
+    });
+    observer.finishSpan(freeze, { outcome: 'ok', reasonCode: 'plan_frozen' });
+}
+/**
+ * Defensive projection for legacy/manual callers: once a tier reports an
+ * immutable freeze, later attempted tiers cannot be part of the same trace.
+ * Router construction already enforces this invariant, but observability must
+ * not turn a malformed old receipt into a misleading portable cascade.
+ */
+function cascadeThroughFirstFrozenTierV1(decision) {
+    const selectedFreeze = decision.planFrozen === true && decision.selectedTier
+        ? decision.selectedTier
+        : undefined;
+    let normalized = false;
+    const normalizedAttempts = decision.attempts.map((attempt) => {
+        if (selectedFreeze !== attempt.tier || attempt.planFrozen)
+            return attempt;
+        normalized = true;
+        return { ...attempt, planFrozen: true };
+    });
+    const frozenIndex = normalizedAttempts.findIndex((attempt) => attempt.planFrozen);
+    if (frozenIndex < 0 || frozenIndex === normalizedAttempts.length - 1) {
+        return normalized ? { ...decision, attempts: normalizedAttempts } : decision;
+    }
+    return {
+        ...decision,
+        attempts: normalizedAttempts.slice(0, frozenIndex + 1),
+    };
+}
+export function recordEngineTraceEventV1(observer, event) {
+    if (!observer.enabled)
+        return;
+    if (event.type === 'plan.created') {
+        const span = observer.startSpan({ name: 'meaning.package', stage: 'meaning', reasonCode: 'completed', payload: { kind: 'stage', route: event.route } });
+        observer.finishSpan(span, { outcome: 'ok', reasonCode: 'completed' });
+    }
+    else if (event.type === 'artifact.created') {
+        // The artifact is the engine's already-accepted result boundary. Project
+        // only its checksum/count/trust into the trace; never copy rows, SQL, or
+        // answer text. This lets the trace prove that the selected frozen route
+        // and persisted result receipt refer to the same physical result.
+        const result = resultTraceProjection(event.payload);
+        // An artifact can carry a blocked answer shell or a narration-only
+        // receipt. Neither proves that a result was normalized. Require the
+        // canonical result fingerprint before recording successful completion.
+        if (!result?.resultFingerprint)
+            return;
+        const span = observer.startSpan({
+            name: 'result.normalize',
+            stage: 'result',
+            reasonCode: 'result_accepted',
+            payload: {
+                kind: 'result',
+                trustState: event.trustState,
+                ...(result?.resultFingerprint ? { resultFingerprint: result.resultFingerprint } : {}),
+                ...(result?.rowCount !== undefined ? { rowCount: result.rowCount } : {}),
+            },
+        });
+        observer.finishSpan(span, { outcome: 'ok', reasonCode: 'result_accepted' });
+    }
+}
+function resultTraceProjection(payload) {
+    if (!payload || typeof payload !== 'object' || Array.isArray(payload))
+        return undefined;
+    const artifact = payload;
+    if (!artifact.payload || typeof artifact.payload !== 'object' || Array.isArray(artifact.payload))
+        return undefined;
+    const answer = artifact.payload;
+    if (!answer.result || typeof answer.result !== 'object' || Array.isArray(answer.result))
+        return undefined;
+    const result = answer.result;
+    const receipt = result.executionReceipt && typeof result.executionReceipt === 'object' && !Array.isArray(result.executionReceipt)
+        ? result.executionReceipt
+        : undefined;
+    const fingerprint = typeof result.resultFingerprint === 'string'
+        ? result.resultFingerprint
+        : typeof receipt?.resultFingerprint === 'string'
+            ? receipt.resultFingerprint
+            : undefined;
+    const safeFingerprint = fingerprint && /^(?:sha256:)?[a-f0-9]{64}$/i.test(fingerprint)
+        ? fingerprint
+        : undefined;
+    const rowCount = typeof result.rowCount === 'number'
+        && Number.isSafeInteger(result.rowCount)
+        && result.rowCount >= 0
+        ? result.rowCount
+        : undefined;
+    return safeFingerprint || rowCount !== undefined
+        ? { ...(safeFingerprint ? { resultFingerprint: safeFingerprint } : {}), ...(rowCount !== undefined ? { rowCount } : {}) }
+        : undefined;
+}
+/**
+ * Capture only terminal, receipt-derived narration evidence here. Physical
+ * provider/tool/SQL spans are emitted at their runtime boundaries; recreating
+ * them from counters would invent timing/outcomes and double-count a real
+ * execution in the trace.
+ */
+export function recordExecutionAttemptSummaryV1(observer, result) {
+    if (!observer.enabled)
+        return;
+    if (result.narrationIntegrityReceipt) {
+        const narration = observer.startSpan({ name: 'narration.verify', stage: 'narration', reasonCode: result.narrationIntegrityReceipt.outcome === 'deterministic_fallback' ? 'narration_fallback' : 'completed', payload: { kind: 'stage', count: result.narrationIntegrityReceipt.factCount } });
+        observer.finishSpan(narration, { outcome: result.narrationIntegrityReceipt.outcome === 'error' ? 'error' : 'ok', reasonCode: result.narrationIntegrityReceipt.outcome === 'deterministic_fallback' ? 'narration_fallback' : 'completed' });
+    }
+}
+export function finalizeAgentRunTraceV1(observer, run) {
+    if (!observer.enabled)
+        return;
+    // A root Research deadline is not a generic request failure. Its child
+    // spans/receipts may already show partial progress, and this explicit
+    // terminal span lets the root tell the same bounded-deadline story without
+    // reconstructing an incident from prose or counters.
+    if (run.diagnosticReceipt?.failure?.code === 'RESEARCH_RUN_DEADLINE') {
+        const deadline = observer.startSpan({
+            // Root spans are owned by the observer and cannot be emitted through
+            // the producer API. `research.synthesize` is the precise missing phase:
+            // child work ended, but finalization could not start before the deadline.
+            name: 'research.synthesize',
+            stage: 'research',
+            reasonCode: 'run_deadline',
+            payload: { kind: 'research', branchStopReason: 'run_deadline' },
+        });
+        observer.finishSpan(deadline, { outcome: 'error', reasonCode: 'run_deadline' });
+    }
+    recordFrozenPlanTerminalFailureV1(observer, run);
+    const conversation = observer.startSpan({
+        name: 'conversation.persist',
+        stage: 'conversation',
+        reasonCode: 'completed',
+        payload: {
+            kind: 'conversation',
+            persisted: Boolean(run.traceReference || run.answer),
+            continuation: (run.conversationBinding ?? 'none') !== 'none',
+            binding: run.conversationBinding ?? (run.routeDecision?.followsUp ? 'prior_result' : 'none'),
+        },
+    });
+    observer.finishSpan(conversation, { outcome: 'ok', reasonCode: 'completed' });
+    const persistence = observer.startSpan({ name: 'run.persist', stage: 'persistence', reasonCode: 'completed', payload: { kind: 'persistence', recordingStatus: observer.recordingStatus } });
+    observer.finishSpan(persistence, { outcome: 'ok', reasonCode: 'completed' });
+    const status = run.status === 'cancelled' ? 'cancelled' : run.status === 'blocked' ? 'blocked' : 'completed';
+    const reference = observer.finalize({
+        status,
+        terminalOutcome: run.status,
+        trustState: run.trustState,
+        selectedTier: selectedTierFromAuthoritativeV8(run)
+            ?? run.diagnosticReceiptV3?.cascade?.selectedTier,
+        completedAt: run.completedAt,
+    });
+    if (reference)
+        run.traceReference = reference;
+}
+/**
+ * A router-frozen plan must not be silently downgraded. When its immutable
+ * semantic/analytical execution fails, the run artifact is the authoritative
+ * terminal boundary. Project only its allowlisted failure code and action so
+ * the trace explains the post-freeze stop without retaining compiler text.
+ */
+function recordFrozenPlanTerminalFailureV1(observer, run) {
+    const frozen = run.routeDecision?.analyticalCascadeDecision?.planFrozen
+        ?? run.diagnosticReceiptV3?.planFrozen
+        ?? false;
+    if (!frozen || run.status !== 'blocked')
+        return;
+    const failure = terminalAnalyticalFailureForRun(run);
+    if (!failure)
+        return;
+    const compilationFailure = failure.phase === 'compilation';
+    const semanticCompilation = compilationFailure && isSemanticCompilationForRun(run);
+    const span = observer.startSpan({
+        // Compilation happens after the plan froze but before a SQL statement
+        // exists. Labeling it as result normalization made a compiler refusal look
+        // like a warehouse/result problem in both trace views.
+        name: semanticCompilation ? 'semantic.compile' : compilationFailure ? 'plan.compile' : 'result.normalize',
+        stage: compilationFailure ? 'plan' : 'result',
+        reasonCode: 'post_freeze_failure',
+        payload: {
+            kind: 'result',
+            trustState: run.trustState,
+            failureCode: failure.code,
+            ...(failure.safeAction ? { safeAction: failure.safeAction } : {}),
+        },
+    });
+    observer.finishSpan(span, {
+        outcome: failure.code === 'POLICY_DENIED' || failure.code === 'PERMISSION_DENIED'
+            ? 'denied'
+            : failure.code === 'EXECUTION_CANCELLED'
+                ? 'cancelled'
+                : 'error',
+        reasonCode: 'post_freeze_failure',
+    });
+}
+function isSemanticCompilationForRun(run) {
+    // Use the same router-owned condition as V4. A route label or legacy plan
+    // capability alone cannot reconstruct a semantic tier after the fact.
+    return run.routeDecision?.analyticalCascadeDecision?.selectedTier === 'semantic';
+}
+function terminalAnalyticalFailureForRun(run) {
+    const executionSetupFailure = run.artifacts
+        .map((artifact) => artifact.payload)
+        .filter((payload) => Boolean(payload) && typeof payload === 'object' && !Array.isArray(payload))
+        .map((payload) => payload.observabilityExecutionFailure)
+        .find((candidate) => Boolean(candidate)
+        && typeof candidate === 'object'
+        && !Array.isArray(candidate)
+        && isConnectionNotConfiguredFailureV1(candidate));
+    if (executionSetupFailure) {
+        return { code: 'CONNECTION_NOT_CONFIGURED', safeAction: 'configure_connection' };
+    }
+    const warehouseFailure = run.artifacts
+        .map((artifact) => artifact.payload)
+        .filter((payload) => Boolean(payload) && typeof payload === 'object' && !Array.isArray(payload))
+        .map((payload) => payload.warehouseFailure)
+        .find((candidate) => {
+        if (!candidate || typeof candidate !== 'object' || Array.isArray(candidate))
+            return false;
+        const record = candidate;
+        return record.version === 1
+            && record.origin === 'warehouse'
+            && typeof record.category === 'string';
+    });
+    const failure = run.artifacts
+        .map((artifact) => artifact.payload)
+        .filter((payload) => Boolean(payload) && typeof payload === 'object' && !Array.isArray(payload))
+        .map((payload) => payload.analyticalFailure)
+        .find((candidate) => Boolean(candidate) && typeof candidate === 'object' && !Array.isArray(candidate));
+    if (!failure)
+        return undefined;
+    const code = safeTerminalFailureCodeV1(failure.code);
+    if (!code)
+        return undefined;
+    const actions = Array.isArray(failure.safeActions) ? failure.safeActions : [];
+    const safeAction = warehouseFailure?.category === 'unknown_relation'
+        ? 'change_authorized_connection'
+        : actions.map(safeTraceActionV1).find((action) => Boolean(action));
+    const phase = typeof failure.phase === 'string'
+        && ['planning', 'compilation', 'validation', 'execution', 'result_validation'].includes(failure.phase)
+        ? failure.phase
+        : undefined;
+    // A compilation refusal still needs one concrete, stable recovery action in
+    // the trace. V4 uses the same `inspect_failure` fallback when the producer
+    // supplied no allowlisted action, so inspector and full trace cannot diverge.
+    const resolvedSafeAction = safeAction
+        ?? (code === 'COMPILATION_FAILED' && phase === 'compilation' ? 'inspect_failure' : undefined);
+    return { code, ...(resolvedSafeAction ? { safeAction: resolvedSafeAction } : {}), ...(phase ? { phase } : {}) };
+}
+/**
+ * The execution producer emits this tiny strict allowlist only after a frozen
+ * plan failed before compilation/SQL handoff. Keep it structural so raw error
+ * text can never be promoted into the local trace.
+ */
+function isConnectionNotConfiguredFailureV1(value) {
+    return value.version === 1
+        && value.phase === 'execution'
+        && value.cause === 'connection_not_configured'
+        && value.safeAction === 'configure_connection';
+}
+function safeTerminalFailureCodeV1(value) {
+    const codes = [
+        'COLUMN_NOT_FOUND', 'RELATION_NOT_FOUND', 'PERMISSION_DENIED', 'AMBIGUOUS_COLUMN', 'DIALECT_ERROR',
+        'SNAPSHOT_DRIFT', 'TIMEOUT', 'RESULT_CONTRACT_MISMATCH', 'COMPILATION_FAILED', 'POLICY_DENIED',
+        'SEMANTIC_ADAPTER_NOT_READY', 'SEMANTIC_TARGET_BINDING_MISSING', 'EXECUTION_TARGET_MISMATCH',
+        'SEMANTIC_SOURCE_DRIFT', 'SEMANTIC_MEMBER_BINDING_FAILED', 'SEMANTIC_PATH_AMBIGUOUS',
+        'IDENTIFIER_SCOPE_INVALID', 'CONNECTION_NOT_CONFIGURED', 'EXECUTION_CANCELLED', 'SEMANTIC_COMPILATION_TIMEOUT',
+    ];
+    return typeof value === 'string' && codes.includes(value)
+        ? value
+        : undefined;
+}
+function safeTraceActionV1(value) {
+    const actions = [
+        'inspect_failure', 'retry_same_plan', 'retry_same_request', 'refresh_snapshot', 'edit_dql',
+        'open_sql_notebook', 'request_access', 'change_authorized_connection', 'reapply_semantic_runtime',
+        'configure_connection', 'review_analytical_failure',
+    ];
+    return typeof value === 'string' && actions.includes(value)
+        ? value
+        : undefined;
+}
+export function traceCandidateReasonForCandidateV1(input) {
+    if (input.selected)
+        return 'model_selected';
+    if (input.excluded || input.eligible === false)
+        return 'below_fused_limit';
+    if (input.exact)
+        return 'exact_name_match';
+    if ((input.aliases?.length ?? 0) > 0)
+        return 'alias_match';
+    return 'fused_relevance_fill';
+}
+function uniqueIds(ids) {
+    return [...new Set(ids.map((value) => value.trim()).filter(Boolean))].slice(0, 32);
+}
+function safeCascadeDecision(decision) {
+    const cached = safeCascadeDecisionCache.get(decision);
+    if (cached)
+        return cached;
+    const safe = {
+        ...(decision.selectedTier ? { selectedTier: decision.selectedTier } : {}),
+        planFrozen: decision.planFrozen,
+        stopReason: decision.stopReason,
+        ...(decision.requirements.time?.requiresDeclaredFiscalCalendar ? { requiresDeclaredFiscalCalendar: true } : {}),
+        ...(decision.terminalGap ? {
+            terminalGap: {
+                code: decision.terminalGap.code,
+                requirement: decision.terminalGap.requirement,
+                witnessCandidateIds: uniqueIds(decision.terminalGap.witnessCandidateIds),
+            },
+        } : {}),
+        sourceCoverage: decision.sourceCoverage.slice(0, 16).map((coverage) => ({
+            source: coverage.source,
+            status: coverage.status,
+            candidateIds: uniqueIds(coverage.candidateIds),
+            ...(coverage.reason ? { reasonFingerprint: fingerprint(coverage.reason) } : {}),
+        })),
+        attempts: decision.attempts.slice(0, 8).map(safeCascadeAttempt),
+    };
+    safeCascadeDecisionCache.set(decision, safe);
+    return safe;
+}
+function safeCascadeAttempt(attempt) {
+    const cached = safeCascadeAttemptCache.get(attempt);
+    if (cached)
+        return cached;
+    const safe = {
+        tier: attempt.tier,
+        outcome: attempt.outcome,
+        candidateIds: uniqueIds(attempt.candidateIds),
+        planFrozen: attempt.planFrozen,
+        reasonFingerprint: fingerprint(attempt.reason),
+    };
+    safeCascadeAttemptCache.set(attempt, safe);
+    return safe;
+}
+//# sourceMappingURL=instrumentation.js.map

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

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

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

@@ -0,0 +1,62 @@
+import type { AskSpanIdV1, AskTraceIdV1, AskTraceLinkV1, AskTraceModeV1, AskTraceReasonCodeV1, AskTraceRecordingStatusV1, AskTraceStageV1, AskTraceSpanNameV1, AskTraceSpanOutcomeV1, AskTraceSpanPayloadV1, AskTraceSpanV1, AskTraceStatusV1, AskTraceSurfaceV1, AskTraceTerminalOutcomeV1, AgentRunTraceReferenceV1, CandidateDecisionV1 } from './types.js';
+import type { AnalyticalCascadeTierV1 } from '../analytical-orchestration.js';
+import { AskTraceSqliteStoreV1 } from './store.js';
+export declare const ASK_TRACE_OBSERVER_V1: unique symbol;
+export interface AskTraceStartSpanInputV1 {
+    name: Exclude<AskTraceSpanNameV1, 'ask.run' | 'research.run'>;
+    stage: AskTraceStageV1;
+    parentSpanId?: AskSpanIdV1;
+    payload: AskTraceSpanPayloadV1;
+    reasonCode?: AskTraceReasonCodeV1;
+    startedAt?: string;
+}
+export interface AskTraceFinishSpanInputV1 {
+    outcome?: AskTraceSpanOutcomeV1;
+    reasonCode?: AskTraceReasonCodeV1;
+    payload?: AskTraceSpanPayloadV1;
+    completedAt?: string;
+}
+export interface AskTraceObserverV1 {
+    readonly traceId?: AskTraceIdV1;
+    readonly rootSpanId?: AskSpanIdV1;
+    readonly recordingStatus: AskTraceRecordingStatusV1;
+    readonly enabled: boolean;
+    startSpan(input: AskTraceStartSpanInputV1): AskSpanIdV1 | undefined;
+    finishSpan(spanId: AskSpanIdV1 | undefined, input?: AskTraceFinishSpanInputV1): void;
+    recordCandidateDecision(input: Omit<CandidateDecisionV1, 'version' | 'traceId' | 'sequence'>): void;
+    recordLink(input: Omit<AskTraceLinkV1, 'version' | 'sourceTraceId' | 'sourceRunId' | 'createdAt'>): void;
+    finalize(input: {
+        status: AskTraceStatusV1;
+        terminalOutcome?: AskTraceTerminalOutcomeV1;
+        trustState?: string;
+        selectedTier?: AnalyticalCascadeTierV1;
+        completedAt?: string;
+        firstIssueSpanId?: AskSpanIdV1;
+    }): AgentRunTraceReferenceV1 | undefined;
+    markPartial(reason?: AskTraceReasonCodeV1): void;
+    reference(): AgentRunTraceReferenceV1 | undefined;
+}
+export interface CreateAskTraceObserverInputV1 {
+    store?: AskTraceSqliteStoreV1;
+    runId: string;
+    surface: AskTraceSurfaceV1;
+    mode: AskTraceModeV1;
+    questionFingerprint: string;
+    threadId?: string;
+    snapshotId?: string;
+    parentTraceId?: AskTraceIdV1;
+    parentRunId?: string;
+    now?: () => Date;
+}
+/**
+ * Explicit no-op is the universal failure mode. Callers must not need a
+ * conditional and an observability failure cannot influence the answer path.
+ */
+export declare const noOpAskTraceObserverV1: AskTraceObserverV1;
+/** Exported for focused contract tests; never used as routing authority. */
+export declare function isAskTraceIssueSpanV1(input: Pick<AskTraceSpanV1, 'outcome' | 'reasonCode'>): boolean;
+export declare function createAskTraceObserverV1(input: CreateAskTraceObserverInputV1): AskTraceObserverV1;
+/** The observer deliberately does not enumerate into HTTP/client payloads. */
+export declare function attachAskTraceObserverV1<T extends object>(target: T, observer: AskTraceObserverV1): T;
+export declare function askTraceObserverForV1(value: unknown): AskTraceObserverV1;
+//# sourceMappingURL=observer.d.ts.map

package/dist/ask-observability/observer.d.ts.map

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