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

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

@@ -0,0 +1,168 @@
+export const PROMPT_FAILURE_ORIGINS = [
+    "llm_provider",
+    "platform",
+    "user",
+];
+/**
+ * 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 const TELEMETRY_FAILURE_ORIGINS = [
+    "llm_provider",
+    "platform",
+    "user_action",
+    "user_paywall",
+];
+export const PLATFORM_PROMPT_FAILURE_REASONS = [
+    "aborted",
+    "api_error",
+    "handler_error",
+    "integration_fetch",
+    "no_output",
+    "peer_disconnect",
+    "rate_limit",
+    "retries_exhausted",
+    "service_busy",
+    "service_dead",
+    "unexpected",
+];
+export const USER_PROMPT_FAILURE_REASONS = ["user_canceled"];
+function isClarkProviderError(error) {
+    return error.data?.isClark === true;
+}
+export function originFromLlmError(error) {
+    const category = error.type;
+    if (category === "ai_quota_exceeded") {
+        return "user";
+    }
+    if (category === "aborted") {
+        return "platform";
+    }
+    if (category === "auth_error" || category === "validation_error") {
+        return isClarkProviderError(error) ? "platform" : "llm_provider";
+    }
+    switch (category) {
+        case "api_error":
+        case "no_output":
+        case "rate_limit":
+        case "retries_exhausted":
+            return "platform";
+        case "timeout":
+        case "stall":
+        case "network":
+        case "overloaded":
+        case "not_found":
+        case "unknown":
+            return "llm_provider";
+        default:
+            return "platform";
+    }
+}
+function platformReasonFromLlmError(error) {
+    switch (error.type) {
+        case "aborted":
+        case "api_error":
+        case "no_output":
+        case "rate_limit":
+        case "retries_exhausted":
+            return error.type;
+        default:
+            return "unexpected";
+    }
+}
+/** True when the user explicitly canceled or interrupted the in-flight prompt. */
+export function isUserInitiatedPromptAbort(context) {
+    return (context.userInitiatedPromptAbort === true ||
+        context.isInterruptAbort === true);
+}
+/** Classify stream abort telemetry from FSM context, not the raw error alone. */
+export function promptFailureFromStreamAbort(context) {
+    return isUserInitiatedPromptAbort(context)
+        ? promptFailureUserCanceled()
+        : promptFailurePlatform("aborted");
+}
+export function promptFailureFromLlmError(error) {
+    const origin = originFromLlmError(error);
+    if (origin === "llm_provider") {
+        return { origin, category: error.type };
+    }
+    if (origin === "user") {
+        return { origin: "user", paywallReason: "credit_limit_exceeded" };
+    }
+    return {
+        origin: "platform",
+        platformReason: platformReasonFromLlmError(error),
+    };
+}
+export function promptFailurePaywall(paywallReason) {
+    return { origin: "user", paywallReason };
+}
+const GENERIC_PAYWALL_STOP_ADVICE = "I stopped because credits ran out. Add credits, then send any message to pick up from here.";
+/**
+ * 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 function paywallStopAdvice(paywallReason) {
+    switch (paywallReason) {
+        case "user_credit_limit_exceeded":
+            return "I stopped because you've reached your personal usage limit for this cycle. An org admin can raise it under Spend Management — then send any message to pick up from here.";
+        case "payment_past_due":
+            return "I stopped because your organization's subscription payment failed. An org admin can update the payment method under Manage Plan — then send any message to pick up from here.";
+        case "provisioning_error":
+            return "I stopped because your organization's plan hasn't finished provisioning, so its usage allowance isn't available yet. Try again in a few minutes — if this keeps happening, contact support@superblocks.com.";
+        default:
+            return GENERIC_PAYWALL_STOP_ADVICE;
+    }
+}
+export function promptFailurePlatform(platformReason) {
+    return { origin: "platform", platformReason };
+}
+export function promptFailureUserCanceled() {
+    return { origin: "user", userReason: "user_canceled" };
+}
+export function promptFailureLlmProviderUnknown() {
+    return { origin: "llm_provider", category: "unknown" };
+}
+/** Flat drill-down value for metrics and cross-origin queries. */
+export function failureDetailFromPromptFailure(failure) {
+    switch (failure.origin) {
+        case "llm_provider":
+            return failure.category;
+        case "platform":
+            return failure.platformReason;
+        case "user":
+            return failure.paywallReason ?? failure.userReason ?? "unknown";
+    }
+}
+export function telemetryFailureOrigin(failure) {
+    switch (failure.origin) {
+        case "llm_provider":
+        case "platform":
+            return failure.origin;
+        case "user":
+            return failure.paywallReason !== undefined
+                ? "user_paywall"
+                : "user_action";
+    }
+}
+export function promptFailureAttributes(failure) {
+    return {
+        failure_detail: failureDetailFromPromptFailure(failure),
+        failure_origin: telemetryFailureOrigin(failure),
+    };
+}
+export const PROMPT_OUTCOME_TAG = "prompt.outcome";
+export const PROMPT_FAILURE_ORIGIN_TAG = "prompt.failure_origin";
+export const PROMPT_FAILURE_DETAIL_TAG = "prompt.failure.detail";
+export function promptOutcomeTagsFromFailure(failure) {
+    return {
+        [PROMPT_OUTCOME_TAG]: "failure",
+        [PROMPT_FAILURE_ORIGIN_TAG]: telemetryFailureOrigin(failure),
+        [PROMPT_FAILURE_DETAIL_TAG]: failureDetailFromPromptFailure(failure),
+    };
+}
+//# sourceMappingURL=prompt-failure.js.map

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

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

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

@@ -0,0 +1,229 @@
+import type { ClarkUsageSurface } from "@superblocksteam/library-shared/types";
+import { type PromptFailure } from "./prompt-failure.js";
+export declare const PROMPT_OUTCOMES: readonly ["failure", "success"];
+export type PromptOutcome = (typeof PROMPT_OUTCOMES)[number];
+export { PROMPT_OUTCOME_TAG, promptOutcomeTagsFromFailure, type PromptFailure, } from "./prompt-failure.js";
+export { failureDetailFromPromptFailure, PLATFORM_PROMPT_FAILURE_REASONS, PROMPT_FAILURE_ORIGINS, TELEMETRY_FAILURE_ORIGINS, telemetryFailureOrigin, isUserInitiatedPromptAbort, promptFailureFromLlmError, promptFailureFromStreamAbort, promptFailureLlmProviderUnknown, promptFailurePaywall, promptFailurePlatform, promptFailureUserCanceled, type PlatformPromptFailureReason, type PromptFailureOrigin, type TelemetryFailureOrigin, type UserPromptFailureReason, USER_PROMPT_FAILURE_REASONS, } from "./prompt-failure.js";
+export declare const METRIC_AWAITING_USER_DISMISSED = "superblocks.clark.prompt.awaiting_user_dismissed_total";
+export declare const METRIC_BASE_COMMIT_RESOLUTION_FAILED = "superblocks.clark.prompt.base_commit_resolution_failed_total";
+export declare const METRIC_REPEATED_FAILURES = "superblocks.clark.prompt.repeated_failures_total";
+/**
+ * Consecutive failed turns that make a conversation "stuck" (ENG-5477).
+ *
+ * Two is deliberate rather than conservative: in-turn provider retries and the
+ * post-processing debug loop are already exhausted before a terminal outcome is
+ * recorded, so a streak of two means the user's own retry failed too. That is
+ * the signature of a poisoned context or a provider outage, not a flake.
+ */
+export declare const REPEATED_FAILURE_STREAK_THRESHOLD = 2;
+export declare const REPEATED_FAILURE_LOG_MESSAGE = "[clark:prompt] Conversation failing repeatedly";
+/**
+ * Queried as `@event:` by the Datadog monitors in terraform/datadog (both the
+ * cloud-prem and SaaS halves of this alert). Their triage links resolve on this
+ * name, not on the message above, so the prose stays editable -- renaming this
+ * silently breaks them.
+ */
+export declare const REPEATED_FAILURE_LOG_EVENT = "clark.prompt_repeated_failures";
+/** Marks a dedupe key derived from prompt text rather than a request id. */
+export declare const EPHEMERAL_DEDUPE_KEY_PREFIX = "ephemeral:";
+/**
+ * Platform failures that make a conversation "stuck" for the user.
+ *
+ * `outcomes_total` carries every platform reason because a dashboard wants the
+ * full rollup; this metric pages, so the bar is higher. Excluded reasons are
+ * either not a broken conversation or not ours to fix:
+ * - `aborted` / `peer_disconnect`: the client went away mid-stream. The
+ *   user-initiated flags are best-effort, so these skew toward navigation and
+ *   network rather than a conversation that cannot make progress.
+ * - `service_busy`: contention. Two quick sends while a generation is in flight
+ *   produce two rejections with nothing broken, and capacity has its own alerts.
+ *
+ * `unexpected` counts, despite the name reading like a catch-all:
+ * `platformReasonFromLlmError` has no case for `auth_error` or
+ * `validation_error`, so a Clark-side rejection -- a poisoned context, the
+ * incident this alert exists for -- lands here. Advice give-ups (debug-loop
+ * exhaustion, missing/expired JWT) also record `unexpected`; those stuck the
+ * conversation, so they page with it.
+ *
+ * `satisfies Record<PlatformPromptFailureReason, boolean>` is the runtime
+ * classification: adding a platform reason without a decision here fails to
+ * compile, so a mid-incident "add to the ignore list" cannot silently miss
+ * a reason that still pages.
+ */
+export declare const STREAK_POLICY: {
+    readonly aborted: false;
+    readonly api_error: true;
+    readonly handler_error: true;
+    readonly integration_fetch: true;
+    readonly no_output: true;
+    readonly peer_disconnect: false;
+    readonly rate_limit: true;
+    readonly retries_exhausted: true;
+    readonly service_busy: false;
+    readonly service_dead: true;
+    readonly unexpected: true;
+};
+export declare const STREAK_WORTHY_PLATFORM_REASONS: ("aborted" | "no_output" | "rate_limit" | "api_error" | "retries_exhausted" | "handler_error" | "integration_fetch" | "peer_disconnect" | "service_busy" | "service_dead" | "unexpected")[];
+export declare const AWAITING_USER_DISMISS_REASONS: readonly ["cancel", "new_prompt"];
+export type AwaitingUserDismissReason = (typeof AWAITING_USER_DISMISS_REASONS)[number];
+export declare const AWAITING_USER_DISMISS_REASON_TAG = "dismiss_reason";
+export declare const PROMPT_APPLICATION_ID_TAG = "application_id";
+export declare const PROMPT_CORE_MODEL_TAG = "core_model";
+export declare const PROMPT_HAD_FALLBACK_TAG = "had_fallback";
+export declare const PROMPT_ORGANIZATION_ID_TAG = "organization_id";
+export declare const PROMPT_SURFACE_TAG = "surface";
+/**
+ * Closed set of `usageMetadata.origin` values that decide streak eligibility.
+ * Producers (index.ts) and consumers (resolvePromptMetricLabels) must both
+ * reference these literals — a rename that only updates one side is a type error
+ * once the producer uses the const (ENG-5477 scout review).
+ */
+export declare const CLARK_USAGE_ORIGIN: {
+    readonly app_clark_generation: "app_clark_generation";
+    readonly app_migration: "app_migration";
+    readonly policy_gate: "policy_gate";
+};
+export type ClarkUsageOrigin = (typeof CLARK_USAGE_ORIGIN)[keyof typeof CLARK_USAGE_ORIGIN];
+/**
+ * Optional `attempts_total` label distinguishing how a request entered the
+ * agent loop. Omitted for ordinary `aiGenerate` so existing untagged series
+ * stay the bulk of the metric; set only for server-driven continuations
+ * (ENG-5477 scout review).
+ */
+export declare const PROMPT_ATTEMPT_ENTRYPOINT_TAG = "entrypoint";
+export declare const PROMPT_ATTEMPT_ENTRYPOINT: {
+    readonly tool_permission_continuation: "tool_permission_continuation";
+};
+export type PromptAttemptEntrypoint = (typeof PROMPT_ATTEMPT_ENTRYPOINT)[keyof typeof PROMPT_ATTEMPT_ENTRYPOINT];
+export declare const METRIC_CREDITS = "superblocks.clark.prompt.credits";
+/**
+ * Credit-scale bucket boundaries for credits-per-prompt. Centered on the
+ * default prompt-usage alarm threshold (10) so p95/avg dashboards resolve
+ * near the golden-metric alert edge.
+ */
+export declare const PROMPT_CREDITS_BUCKETS: readonly [0.5, 1, 2, 5, 7.5, 10, 15, 25, 50, 100, 250];
+export declare const BASE_COMMIT_RESOLUTION_FAILED_SOURCES: readonly ["chat_store", "chat_store_timeout"];
+export type BaseCommitResolutionFailedSource = (typeof BASE_COMMIT_RESOLUTION_FAILED_SOURCES)[number];
+export declare const BASE_COMMIT_RESOLUTION_FAILED_SOURCE_TAG = "source";
+export declare const BASE_COMMIT_RESOLUTION_PREFERRED_SOURCE_FAILED_TAG = "preferred_source_failed";
+export interface PromptMetricLabels {
+    coreModel?: string;
+    hadFallback?: boolean;
+    surface?: ClarkUsageSurface;
+}
+export declare function resolvePromptMetricLabels(context: {
+    llmConfig?: {
+        coreModel?: string;
+    };
+    usageMetadata?: {
+        origin?: string;
+    };
+    workflowMetrics?: {
+        hadProviderFallback?: boolean;
+    };
+    surface?: ClarkUsageSurface;
+}): PromptMetricLabels & {
+    streakEligible: boolean;
+};
+export interface PromptRequestMetricIdentity {
+    applicationId?: string;
+    organizationId?: string;
+}
+export declare function setPromptRequestMetricIdentity(identity: PromptRequestMetricIdentity): void;
+export declare function recordPromptAttempt(params?: {
+    coreModel?: string;
+    entrypoint?: PromptAttemptEntrypoint;
+    outcomeDedupeKey?: string;
+    surface?: ClarkUsageSurface;
+}): void;
+export declare function recordBaseCommitResolutionFailed(params: {
+    source: BaseCommitResolutionFailedSource;
+    preferredSourceFailed: boolean;
+}): void;
+export declare function resolvePromptOutcomeDedupeKey(context: {
+    promptId?: string;
+    promptOutcomeDedupeKey?: string;
+}): string | undefined;
+export declare function recordPromptOutcome(params: {
+    coreModel?: string;
+    dedupeKey: string | undefined;
+    failure?: PromptFailure;
+    flushDegradation?: boolean;
+    hadFallback?: boolean;
+    outcome: PromptOutcome;
+    promptId?: string;
+    /**
+     * Opt-in: only a user conversation turn may advance or clear the streak.
+     * Omit (or pass false) for background / system-driven outcomes — the default
+     * is off so a forgotten call site cannot silently join the pager (ENG-5477).
+     */
+    streakEligible?: boolean;
+    surface?: ClarkUsageSurface;
+}): void;
+export declare function recordPromptCredits(params: {
+    credits: number;
+    dedupeKey: string | undefined;
+} & PromptMetricLabels): void;
+export declare function resolvePromptRequestDedupeKey(request: {
+    requestId?: string;
+    prompt: string;
+}): string;
+/**
+ * Tags for the Clark root span when a prompt cycle ends via a terminal FSM
+ * transition (pre-FSM entry rejections have no root span).
+ */
+export declare function promptOutcomeTagsFromTerminalEvent(event: {
+    type: string;
+    failure?: PromptFailure;
+    advice?: string;
+    countsAsPromptSuccess?: boolean;
+}): Record<string, string>;
+export declare function promptOutcomeTagsFromAgentNeedsUserInput(event: {
+    advice?: string;
+    countsAsPromptSuccess?: boolean;
+}): Record<string, string>;
+export declare function recordAwaitingUserDismissed(params: {
+    dedupeKey: string | undefined;
+    reason: AwaitingUserDismissReason;
+}): void;
+export declare function isOrganicPromptDuringAwaitingUserHandoff(params: {
+    awaitingUserHandoffRecorded?: boolean;
+    internal?: boolean;
+    responseMetadata?: unknown;
+}): boolean;
+export declare function awaitingUserHandoffDedupeKey(context: {
+    awaitingUserHandoffPromptId?: string;
+    promptId?: string;
+    promptOutcomeDedupeKey?: string;
+}): string | undefined;
+export declare function recordAwaitingUserHandoffDismissed(params: {
+    awaitingUserHandoffPromptId?: string;
+    awaitingUserHandoffRecorded?: boolean;
+    promptId?: string;
+    promptOutcomeDedupeKey?: string;
+    reason: AwaitingUserDismissReason;
+}): void;
+export declare function recordAwaitingUserPromptOutcome(params: {
+    advice?: string;
+    coreModel?: string;
+    countsAsPromptSuccess?: boolean;
+    /**
+     * Opt-in: this success ends the turn (knowledge approval) and should reset
+     * the conversation failure streak. Mid-turn pauses leave this unset.
+     */
+    clearsFailureStreak?: boolean;
+    dedupeKey: string | undefined;
+    hadFallback?: boolean;
+    promptId?: string;
+    streakEligible?: boolean;
+}): boolean;
+/** Record attempt + immediate failure for pre-FSM entry rejections (no promptId yet). */
+export declare function recordPromptEntryRejection(params: {
+    coreModel?: string;
+    dedupeKey: string | undefined;
+    failure: PromptFailure;
+    promptId?: string;
+    surface?: ClarkUsageSurface;
+}): void;
+export declare function _resetPromptRequestMetricsForTesting(): void;
+//# sourceMappingURL=prompt-request-metrics.d.ts.map

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

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