@superblocksteam/vite-plugin-file-sync 1.99.99-next.2 → 2.0.0-SNAPSHOT.2143e2e95d0107ab

package/dist/ai-service/state-machine/helpers/pre-session-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-session-metrics.js","sourceRoot":"","sources":["../../../../src/ai-service/state-machine/helpers/pre-session-metrics.ts"],"names":[],"mappings":"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"}

package/dist/ai-service/state-machine/helpers/prompt-billing-metrics.d.ts

@@ -0,0 +1,26 @@
+import type { ChatSessionStore } from "../../chat/chat-session-store.js";
+import { type PromptMetricLabels } from "./prompt-request-metrics.js";
+export declare function _resetPromptBillingMetricsForTesting(): void;
+/**
+ * Flush per-prompt billing and context headroom metrics at any terminal
+ * outcome — success, cancel, or give-up — so credits-per-prompt is not
+ * survivorship-biased toward completed prompts.
+ */
+export declare function finalizePromptBillingMetrics(params: {
+    chatSessionStore: ChatSessionStore;
+    labels: PromptMetricLabels;
+    logger: {
+        info: (...args: unknown[]) => void;
+        warn: (...args: unknown[]) => void;
+    };
+    promptId: string | undefined;
+    promptUsageAlarmThreshold?: number;
+    workflowMetrics?: {
+        hadProviderFallback?: boolean;
+        llmUsage: Parameters<ChatSessionStore["calculatePromptCost"]>[1];
+        llmCallCount: number;
+        minHeadroomTokens?: number;
+        peakContextUsed?: number;
+    };
+}): Promise<void>;
+//# sourceMappingURL=prompt-billing-metrics.d.ts.map

package/dist/ai-service/state-machine/helpers/prompt-billing-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-billing-metrics.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/state-machine/helpers/prompt-billing-metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEzE,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,6BAA6B,CAAC;AAgFrC,wBAAgB,oCAAoC,IAAI,IAAI,CAG3D;AAED;;;;GAIG;AACH,wBAAsB,4BAA4B,CAAC,MAAM,EAAE;IACzD,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,EAAE;QACN,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;QACnC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;KACpC,CAAC;IACF,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,eAAe,CAAC,EAAE;QAChB,mBAAmB,CAAC,EAAE,OAAO,CAAC;QAC9B,QAAQ,EAAE,UAAU,CAAC,gBAAgB,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjE,YAAY,EAAE,MAAM,CAAC;QACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH,GAAG,OAAO,CAAC,IAAI,CAAC,CAkEhB"}

package/dist/ai-service/state-machine/helpers/prompt-billing-metrics.js

@@ -0,0 +1,128 @@
+import { recordPromptContextHeadroom } from "../../llm/context-v2/context-metrics.js";
+import { recordPromptCredits, } from "./prompt-request-metrics.js";
+/** Cost round-trips currently in flight, keyed by prompt. */
+const inflightCostRpcs = new Map();
+/**
+ * Prompts already priced by a successful round-trip, keyed by promptId with
+ * the expiry timestamp (ms). Entries only need to outlive concurrent terminal
+ * paths for the same prompt; after that they are pruned so the map cannot grow
+ * without bound under sustained traffic.
+ */
+const pricedPrompts = new Map();
+/** How long a successful pricing claim is remembered for race dedupe. */
+const PRICED_PROMPT_TTL_MS = 60_000;
+function pruneExpiredPricedPrompts(now) {
+    for (const [promptId, expiresAt] of pricedPrompts) {
+        if (expiresAt <= now) {
+            pricedPrompts.delete(promptId);
+        }
+    }
+}
+function isPromptPriced(promptId, now = Date.now()) {
+    pruneExpiredPricedPrompts(now);
+    return pricedPrompts.has(promptId);
+}
+function markPromptPriced(promptId, now = Date.now()) {
+    pruneExpiredPricedPrompts(now);
+    pricedPrompts.set(promptId, now + PRICED_PROMPT_TTL_MS);
+}
+/**
+ * Price a prompt exactly once across terminal paths, returning `undefined`
+ * when someone else has already accounted for it.
+ *
+ * Terminal paths both overlap and repeat. Aborting the stream drives the FSM
+ * into its own cancel handler while `handleUserCanceled` is still awaiting the
+ * cost call, so a concurrent caller joins the in-flight round-trip; a caller
+ * arriving after one succeeded is turned away by `pricedPrompts`.
+ *
+ * A joiner waits on the result rather than returning immediately, because
+ * returning loses the prompt outright when the round-trip fails — it would
+ * already be gone by the time the failure surfaced, leaving nobody to retry.
+ * Cancel is when the call is most likely to fail, so a joiner that sees a
+ * rejection retries instead. Only a success marks the prompt priced, which is
+ * what lets a later terminal path pick up after a failed attempt.
+ */
+async function calculatePromptCostOnce(chatSessionStore, promptId, llmUsage) {
+    if (isPromptPriced(promptId)) {
+        return undefined;
+    }
+    const inflight = inflightCostRpcs.get(promptId);
+    if (inflight) {
+        try {
+            await inflight;
+            return undefined;
+        }
+        catch {
+            // Fall through and retry; the owner has already dropped the slot.
+        }
+    }
+    const attempt = chatSessionStore.calculatePromptCost(promptId, llmUsage);
+    inflightCostRpcs.set(promptId, attempt);
+    try {
+        const credits = await attempt;
+        markPromptPriced(promptId);
+        return credits;
+    }
+    finally {
+        inflightCostRpcs.delete(promptId);
+    }
+}
+export function _resetPromptBillingMetricsForTesting() {
+    inflightCostRpcs.clear();
+    pricedPrompts.clear();
+}
+/**
+ * Flush per-prompt billing and context headroom metrics at any terminal
+ * outcome — success, cancel, or give-up — so credits-per-prompt is not
+ * survivorship-biased toward completed prompts.
+ */
+export async function finalizePromptBillingMetrics(params) {
+    const { promptId, workflowMetrics } = params;
+    if (!promptId || !workflowMetrics) {
+        return;
+    }
+    // Local measurement off workflowMetrics, so it stays above the RPC: a
+    // transient socket failure must not punch holes in the context signal.
+    recordPromptContextHeadroom({
+        coreModel: params.labels.coreModel,
+        dedupeKey: promptId,
+        minHeadroomTokens: workflowMetrics.minHeadroomTokens,
+        peakContextUsed: workflowMetrics.peakContextUsed,
+    });
+    let totalCreditsUsed;
+    try {
+        totalCreditsUsed = await calculatePromptCostOnce(params.chatSessionStore, promptId, workflowMetrics.llmUsage);
+    }
+    catch (error) {
+        params.logger.warn("[billing:prompt-cost] Failed to calculate prompt credits", {
+            promptId,
+            error: error instanceof Error ? error.message : String(error),
+        });
+        return;
+    }
+    if (totalCreditsUsed === undefined) {
+        return;
+    }
+    recordPromptCredits({
+        ...params.labels,
+        credits: totalCreditsUsed,
+        dedupeKey: promptId,
+    });
+    const threshold = params.promptUsageAlarmThreshold;
+    if (threshold === undefined) {
+        return;
+    }
+    const costSummary = {
+        llmCallCount: workflowMetrics.llmCallCount,
+        promptId,
+        threshold,
+        totalCreditsUsed,
+    };
+    if (totalCreditsUsed > threshold) {
+        params.logger.warn(`[billing:prompt-cost] Prompt credit usage ${totalCreditsUsed} exceeds threshold of ${threshold}`, costSummary);
+    }
+    else {
+        params.logger.info(`[billing:prompt-cost] Prompt cost summary: ${totalCreditsUsed} credits across ${workflowMetrics.llmCallCount} LLM calls`, costSummary);
+    }
+}
+//# sourceMappingURL=prompt-billing-metrics.js.map

package/dist/ai-service/state-machine/helpers/prompt-billing-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-billing-metrics.js","sourceRoot":"","sources":["../../../../src/ai-service/state-machine/helpers/prompt-billing-metrics.ts"],"names":[],"mappings":"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"}

package/dist/ai-service/state-machine/helpers/prompt-degradation-metrics.d.ts

@@ -0,0 +1,28 @@
+import type { PromptOutcome } from "./prompt-request-metrics.js";
+import { type PromptRequestMetricIdentity } from "./prompt-request-metrics.js";
+export declare const DEGRADATION_REASONS: readonly ["context_documents_dropped", "context_restore_empty", "empty_tool_call", "pre_session_stall", "provider_fallback", "stall_retried", "tool_timeout"];
+export type DegradationReason = (typeof DEGRADATION_REASONS)[number];
+export declare const DEGRADATION_NOTE_DROP_REASONS: readonly ["evicted", "missing_key", "unknown_key"];
+export type DegradationNoteDropReason = (typeof DEGRADATION_NOTE_DROP_REASONS)[number];
+export declare const DEGRADATION_REASON_TAG = "degradation_reason";
+export declare const DEGRADATION_NOTE_DROP_REASON_TAG = "drop_reason";
+export declare const PROMPT_DEGRADATION_OUTCOME_TAG = "outcome";
+export declare function degradationKeyLogAttribute(degradationKey: string | undefined): {
+    degradation_key: string;
+} | Record<string, never>;
+export declare const METRIC_DEGRADED_TOTAL = "superblocks.clark.prompt.degraded_total";
+export declare const METRIC_DEGRADATIONS_TOTAL = "superblocks.clark.prompt.degradations_total";
+export declare const METRIC_DEGRADATION_NOTES_DROPPED_TOTAL = "superblocks.clark.prompt.degradation_notes_dropped_total";
+/** Max in-flight prompt buckets per process. Oldest un-emitted entries are evicted. */
+export declare const DEGRADATION_BUCKET_CAP = 256;
+export declare function setPromptDegradationMetricIdentity(identity: PromptRequestMetricIdentity): void;
+export declare function beginPromptDegradation(dedupeKey: string): void;
+export declare function notePromptDegradation(reason: DegradationReason): void;
+export declare function notePromptDegradationForKey(dedupeKey: string | undefined, reason: DegradationReason): void;
+export declare function emitPromptDegradation(params: {
+    dedupeKey: string;
+    outcome: PromptOutcome;
+}): void;
+export declare function _resetPromptDegradationMetricsForTesting(): void;
+export declare function _setPromptDegradationBucketCapForTesting(cap: number): void;
+//# sourceMappingURL=prompt-degradation-metrics.d.ts.map

package/dist/ai-service/state-machine/helpers/prompt-degradation-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-degradation-metrics.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/state-machine/helpers/prompt-degradation-metrics.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAGL,KAAK,2BAA2B,EACjC,MAAM,6BAA6B,CAAC;AAErC,eAAO,MAAM,mBAAmB,+JAQtB,CAAC;AACX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAErE,eAAO,MAAM,6BAA6B,oDAIhC,CAAC;AACX,MAAM,MAAM,yBAAyB,GACnC,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjD,eAAO,MAAM,sBAAsB,uBAAuB,CAAC;AAC3D,eAAO,MAAM,gCAAgC,gBAAgB,CAAC;AAC9D,eAAO,MAAM,8BAA8B,YAAY,CAAC;AAUxD,wBAAgB,0BAA0B,CACxC,cAAc,EAAE,MAAM,GAAG,SAAS,GACjC;IAAE,eAAe,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAQrD;AAGD,eAAO,MAAM,qBAAqB,4CAA4C,CAAC;AAC/E,eAAO,MAAM,yBAAyB,gDACS,CAAC;AAChD,eAAO,MAAM,sCAAsC,6DACS,CAAC;AAE7D,uFAAuF;AACvF,eAAO,MAAM,sBAAsB,MAAM,CAAC;AA2L1C,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,2BAA2B,GACpC,IAAI,CAEN;AAUD,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAI9D;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAIrE;AAED,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,MAAM,EAAE,iBAAiB,GACxB,IAAI,CAIN;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,aAAa,CAAC;CACxB,GAAG,IAAI,CAIP;AAED,wBAAgB,wCAAwC,IAAI,IAAI,CAE/D;AAED,wBAAgB,wCAAwC,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE1E"}

package/dist/ai-service/state-machine/helpers/prompt-degradation-metrics.js

@@ -0,0 +1,254 @@
+/**
+ * Clark prompt degradation metrics (APPS-5473).
+ *
+ * Per-prompt accumulator keyed by the same dedupe string as prompt outcomes.
+ * Each unique degradation_reason is counted at most once per prompt so
+ * degradations_total is prompt-weighted rather than event-weighted.
+ *
+ * Metrics:
+ *   - `superblocks.clark.prompt.degraded_total` {outcome}
+ *   - `superblocks.clark.prompt.degradations_total` {outcome, degradation_reason}
+ *   - `superblocks.clark.prompt.degradation_notes_dropped_total` {drop_reason}
+ *
+ * Begin on recordPromptAttempt; emit at a genuine recordPromptOutcome
+ * terminal, using the first outcomes_total label for that key so a later
+ * cancel cannot retag the bucket. Mid-prompt `countsAsPromptSuccess`
+ * handoffs (tool permission, plan approval) record outcomes_total but keep
+ * the bucket so continuation notes still attribute. Handoff dismiss
+ * (cancel / new-prompt) flushes with that stored outcome. Stream and
+ * pre-session pass an explicit frozen key; context notes still use
+ * activeKey (single-flight residual overlap accepted for v1).
+ * Notes that cannot be attributed increment the dropped counter instead of
+ * silently no-oping. `missing_key` includes intentional omit from
+ * judge and editor one-shots, so a non-zero baseline is expected. Subagent
+ * streams inherit the parent Clark key. Eviction only
+ * increments when the dropped bucket had notes.
+ */
+import { metrics } from "@opentelemetry/api";
+import { PROMPT_APPLICATION_ID_TAG, PROMPT_ORGANIZATION_ID_TAG, } from "./prompt-request-metrics.js";
+export const DEGRADATION_REASONS = [
+    "context_documents_dropped",
+    "context_restore_empty",
+    "empty_tool_call",
+    "pre_session_stall",
+    "provider_fallback",
+    "stall_retried",
+    "tool_timeout",
+];
+export const DEGRADATION_NOTE_DROP_REASONS = [
+    "evicted",
+    "missing_key",
+    "unknown_key",
+];
+export const DEGRADATION_REASON_TAG = "degradation_reason";
+export const DEGRADATION_NOTE_DROP_REASON_TAG = "drop_reason";
+export const PROMPT_DEGRADATION_OUTCOME_TAG = "outcome";
+/**
+ * Dedupe keys are also log fields, and the outcome-key fallback is
+ * `ephemeral:<prompt>`. Prompts are user content, so that fallback is
+ * dropped rather than logged.
+ */
+const EPHEMERAL_DEDUPE_KEY_PREFIX = "ephemeral:";
+const DEGRADATION_KEY_LOG_ATTRIBUTE = "degradation_key";
+export function degradationKeyLogAttribute(degradationKey) {
+    if (!degradationKey ||
+        degradationKey.startsWith(EPHEMERAL_DEDUPE_KEY_PREFIX)) {
+        return {};
+    }
+    return { [DEGRADATION_KEY_LOG_ATTRIBUTE]: degradationKey };
+}
+const METER_NAME = "superblocks.clark.prompt";
+export const METRIC_DEGRADED_TOTAL = "superblocks.clark.prompt.degraded_total";
+export const METRIC_DEGRADATIONS_TOTAL = "superblocks.clark.prompt.degradations_total";
+export const METRIC_DEGRADATION_NOTES_DROPPED_TOTAL = "superblocks.clark.prompt.degradation_notes_dropped_total";
+/** Max in-flight prompt buckets per process. Oldest un-emitted entries are evicted. */
+export const DEGRADATION_BUCKET_CAP = 256;
+class PromptDegradationMetrics {
+    cachedMeter;
+    cachedInstruments;
+    applicationId;
+    organizationId;
+    activeKey;
+    bucketCap = DEGRADATION_BUCKET_CAP;
+    buckets = new Map();
+    setIdentity(identity) {
+        this.applicationId = identity.applicationId;
+        this.organizationId = identity.organizationId;
+    }
+    baseAttributes() {
+        const attributes = {};
+        if (this.applicationId) {
+            attributes[PROMPT_APPLICATION_ID_TAG] = this.applicationId;
+        }
+        if (this.organizationId) {
+            attributes[PROMPT_ORGANIZATION_ID_TAG] = this.organizationId;
+        }
+        return attributes;
+    }
+    getInstruments() {
+        const meter = metrics.getMeter(METER_NAME);
+        if (meter === this.cachedMeter && this.cachedInstruments) {
+            return this.cachedInstruments;
+        }
+        this.cachedMeter = meter;
+        this.cachedInstruments = {
+            degradedCounter: meter.createCounter(METRIC_DEGRADED_TOTAL, {
+                description: "Prompts that experienced at least one degradation, counted once per prompt regardless of how many reasons fired. Tagged with terminal outcome so the SLO can restrict to successes.",
+                unit: "1",
+            }),
+            degradationsCounter: meter.createCounter(METRIC_DEGRADATIONS_TOTAL, {
+                description: "Per-prompt degradation breakdown by reason. Each reason increments at most once per prompt even when the underlying event fires multiple times.",
+                unit: "1",
+            }),
+            droppedNotesCounter: meter.createCounter(METRIC_DEGRADATION_NOTES_DROPPED_TOTAL, {
+                description: "Degradation notes that could not be attributed to an in-flight prompt bucket. Coverage signal for missing or stale keys; missing_key includes intentional omit from judge and editor one-shots so a non-zero baseline is expected. Subagent streams inherit the parent Clark key. Evicted only counts buckets that had notes. No org/app labels.",
+                unit: "1",
+            }),
+        };
+        return this.cachedInstruments;
+    }
+    recordDroppedNote(dropReason) {
+        this.getInstruments().droppedNotesCounter.add(1, {
+            [DEGRADATION_NOTE_DROP_REASON_TAG]: dropReason,
+        });
+    }
+    evictOldestUntilRoom() {
+        while (this.buckets.size >= this.bucketCap) {
+            let oldestKey;
+            let oldestAt = Number.POSITIVE_INFINITY;
+            for (const [key, bucket] of this.buckets) {
+                if (bucket.createdAt < oldestAt) {
+                    oldestAt = bucket.createdAt;
+                    oldestKey = key;
+                }
+            }
+            if (oldestKey === undefined) {
+                return;
+            }
+            const evicted = this.buckets.get(oldestKey);
+            this.buckets.delete(oldestKey);
+            if (this.activeKey === oldestKey) {
+                this.activeKey = undefined;
+            }
+            if (evicted && evicted.reasons.size > 0) {
+                this.recordDroppedNote("evicted");
+            }
+        }
+    }
+    begin(dedupeKey) {
+        this.activeKey = dedupeKey;
+        const existing = this.buckets.get(dedupeKey);
+        if (existing) {
+            existing.reasons.clear();
+            existing.createdAt = Date.now();
+            return;
+        }
+        this.evictOldestUntilRoom();
+        this.buckets.set(dedupeKey, {
+            createdAt: Date.now(),
+            reasons: new Set(),
+        });
+    }
+    note(reason) {
+        if (!this.activeKey) {
+            this.recordDroppedNote("missing_key");
+            return;
+        }
+        const bucket = this.buckets.get(this.activeKey);
+        if (!bucket) {
+            this.recordDroppedNote("missing_key");
+            return;
+        }
+        bucket.reasons.add(reason);
+    }
+    noteForKey(dedupeKey, reason) {
+        if (!dedupeKey) {
+            this.recordDroppedNote("missing_key");
+            return;
+        }
+        const bucket = this.buckets.get(dedupeKey);
+        if (!bucket) {
+            this.recordDroppedNote("unknown_key");
+            return;
+        }
+        bucket.reasons.add(reason);
+    }
+    emit(params) {
+        const bucket = this.buckets.get(params.dedupeKey);
+        if (!bucket || bucket.reasons.size === 0) {
+            this.buckets.delete(params.dedupeKey);
+            if (this.activeKey === params.dedupeKey) {
+                this.activeKey = undefined;
+            }
+            return;
+        }
+        const baseAttributes = this.baseAttributes();
+        const outcomeAttributes = {
+            ...baseAttributes,
+            [PROMPT_DEGRADATION_OUTCOME_TAG]: params.outcome,
+        };
+        const instruments = this.getInstruments();
+        instruments.degradedCounter.add(1, outcomeAttributes);
+        for (const reason of bucket.reasons) {
+            instruments.degradationsCounter.add(1, {
+                ...outcomeAttributes,
+                [DEGRADATION_REASON_TAG]: reason,
+            });
+        }
+        this.buckets.delete(params.dedupeKey);
+        if (this.activeKey === params.dedupeKey) {
+            this.activeKey = undefined;
+        }
+    }
+    _setBucketCapForTesting(cap) {
+        this.bucketCap = cap;
+    }
+    _resetForTesting() {
+        this.cachedMeter = undefined;
+        this.cachedInstruments = undefined;
+        this.applicationId = undefined;
+        this.organizationId = undefined;
+        this.activeKey = undefined;
+        this.bucketCap = DEGRADATION_BUCKET_CAP;
+        this.buckets.clear();
+    }
+}
+const promptDegradationMetrics = new PromptDegradationMetrics();
+export function setPromptDegradationMetricIdentity(identity) {
+    promptDegradationMetrics.setIdentity(identity);
+}
+function neverFailPrompt(work) {
+    try {
+        work();
+    }
+    catch {
+        // Degradation metrics must never fail the prompt.
+    }
+}
+export function beginPromptDegradation(dedupeKey) {
+    neverFailPrompt(() => {
+        promptDegradationMetrics.begin(dedupeKey);
+    });
+}
+export function notePromptDegradation(reason) {
+    neverFailPrompt(() => {
+        promptDegradationMetrics.note(reason);
+    });
+}
+export function notePromptDegradationForKey(dedupeKey, reason) {
+    neverFailPrompt(() => {
+        promptDegradationMetrics.noteForKey(dedupeKey, reason);
+    });
+}
+export function emitPromptDegradation(params) {
+    neverFailPrompt(() => {
+        promptDegradationMetrics.emit(params);
+    });
+}
+export function _resetPromptDegradationMetricsForTesting() {
+    promptDegradationMetrics._resetForTesting();
+}
+export function _setPromptDegradationBucketCapForTesting(cap) {
+    promptDegradationMetrics._setBucketCapForTesting(cap);
+}
+//# sourceMappingURL=prompt-degradation-metrics.js.map

package/dist/ai-service/state-machine/helpers/prompt-degradation-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-degradation-metrics.js","sourceRoot":"","sources":["../../../../src/ai-service/state-machine/helpers/prompt-degradation-metrics.ts"],"names":[],"mappings":"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"}

package/dist/ai-service/state-machine/helpers/prompt-failure.d.ts

@@ -0,0 +1,59 @@
+import type { AiQuotaPaywallReason } from "@superblocksteam/shared";
+import type { ErrorCategory } from "../../llm/error.js";
+import type { LLMProviderError } from "../../llm/error.js";
+export declare const PROMPT_FAILURE_ORIGINS: readonly ["llm_provider", "platform", "user"];
+export type PromptFailureOrigin = (typeof PROMPT_FAILURE_ORIGINS)[number];
+/**
+ * Values emitted on metrics/spans as `failure_origin` / `prompt.failure_origin`.
+ *
+ * User failures use a `user_*` prefix, allowing for targeting paywall
+ * failures vs explicit user action failures.
+ */
+export declare const TELEMETRY_FAILURE_ORIGINS: readonly ["llm_provider", "platform", "user_action", "user_paywall"];
+export type TelemetryFailureOrigin = (typeof TELEMETRY_FAILURE_ORIGINS)[number];
+export declare const PLATFORM_PROMPT_FAILURE_REASONS: readonly ["aborted", "api_error", "handler_error", "integration_fetch", "no_output", "peer_disconnect", "rate_limit", "retries_exhausted", "service_busy", "service_dead", "unexpected"];
+export type PlatformPromptFailureReason = (typeof PLATFORM_PROMPT_FAILURE_REASONS)[number];
+export declare const USER_PROMPT_FAILURE_REASONS: readonly ["user_canceled"];
+export type UserPromptFailureReason = (typeof USER_PROMPT_FAILURE_REASONS)[number];
+export type PromptFailure = {
+    origin: "llm_provider";
+    category: ErrorCategory;
+} | {
+    origin: "platform";
+    platformReason: PlatformPromptFailureReason;
+} | {
+    origin: "user";
+    paywallReason?: AiQuotaPaywallReason;
+    userReason?: UserPromptFailureReason;
+};
+export declare function originFromLlmError(error: LLMProviderError): PromptFailureOrigin;
+type PromptAbortContext = {
+    isInterruptAbort?: boolean;
+    userInitiatedPromptAbort?: boolean;
+};
+/** True when the user explicitly canceled or interrupted the in-flight prompt. */
+export declare function isUserInitiatedPromptAbort(context: PromptAbortContext): boolean;
+/** Classify stream abort telemetry from FSM context, not the raw error alone. */
+export declare function promptFailureFromStreamAbort(context: PromptAbortContext): PromptFailure;
+export declare function promptFailureFromLlmError(error: LLMProviderError): PromptFailure;
+export declare function promptFailurePaywall(paywallReason: AiQuotaPaywallReason): PromptFailure;
+/**
+ * User-facing stop message for a paywall pause, matched to the actual block
+ * reason. A per-user cap or a failed payment is not "credits ran out" — the
+ * canned add-credits guidance sends those users to buy GAUs that would not
+ * unblock them.
+ */
+export declare function paywallStopAdvice(paywallReason: AiQuotaPaywallReason): string;
+export declare function promptFailurePlatform(platformReason: PlatformPromptFailureReason): PromptFailure;
+export declare function promptFailureUserCanceled(): PromptFailure;
+export declare function promptFailureLlmProviderUnknown(): PromptFailure;
+/** Flat drill-down value for metrics and cross-origin queries. */
+export declare function failureDetailFromPromptFailure(failure: PromptFailure): string;
+export declare function telemetryFailureOrigin(failure: PromptFailure): TelemetryFailureOrigin;
+export declare function promptFailureAttributes(failure: PromptFailure): Record<string, string>;
+export declare const PROMPT_OUTCOME_TAG = "prompt.outcome";
+export declare const PROMPT_FAILURE_ORIGIN_TAG = "prompt.failure_origin";
+export declare const PROMPT_FAILURE_DETAIL_TAG = "prompt.failure.detail";
+export declare function promptOutcomeTagsFromFailure(failure: PromptFailure): Record<string, string>;
+export {};
+//# sourceMappingURL=prompt-failure.d.ts.map

package/dist/ai-service/state-machine/helpers/prompt-failure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-failure.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/state-machine/helpers/prompt-failure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAEpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,eAAO,MAAM,sBAAsB,+CAIzB,CAAC;AACX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1E;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,sEAK5B,CAAC;AACX,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhF,eAAO,MAAM,+BAA+B,0LAYlC,CAAC;AACX,MAAM,MAAM,2BAA2B,GACrC,CAAC,OAAO,+BAA+B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,eAAO,MAAM,2BAA2B,4BAA6B,CAAC;AACtE,MAAM,MAAM,uBAAuB,GACjC,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/C,MAAM,MAAM,aAAa,GACrB;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,aAAa,CAAA;CAAE,GACnD;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,cAAc,EAAE,2BAA2B,CAAA;CAAE,GACnE;IACE,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,UAAU,CAAC,EAAE,uBAAuB,CAAC;CACtC,CAAC;AAMN,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,gBAAgB,GACtB,mBAAmB,CA+BrB;AAiBD,KAAK,kBAAkB,GAAG;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC,CAAC;AAEF,kFAAkF;AAClF,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAKT;AAED,iFAAiF;AACjF,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,kBAAkB,GAC1B,aAAa,CAIf;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,gBAAgB,GACtB,aAAa,CAef;AAED,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,oBAAoB,GAClC,aAAa,CAEf;AAKD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,oBAAoB,GAAG,MAAM,CAW7E;AAED,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,2BAA2B,GAC1C,aAAa,CAEf;AAED,wBAAgB,yBAAyB,IAAI,aAAa,CAEzD;AAED,wBAAgB,+BAA+B,IAAI,aAAa,CAE/D;AAED,kEAAkE;AAClE,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAS7E;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,aAAa,GACrB,sBAAsB,CAUxB;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,aAAa,GACrB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKxB;AAED,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AACnD,eAAO,MAAM,yBAAyB,0BAA0B,CAAC;AACjE,eAAO,MAAM,yBAAyB,0BAA0B,CAAC;AAEjE,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,aAAa,GACrB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMxB"}