@capxul/observability 2.5.5 → 2.6.0

package/dist/index.d.mts

@@ -1,38 +1,62 @@
 import { Effect, Schema } from "effect";
 
+//#region ../errors/src/chain-cause.d.ts
+/**
+ * Why an operation failed — the one flat vocabulary. The first four are the
+ * auth/provider diagnoses that predate this file. The rest name the chain
+ * path. `FailureMode` is derived from this list so a runtime membership check
+ * (the SDK's `$exception` projection, the observability schema) and the type
+ * can never drift apart.
+ */
+declare const FAILURE_MODES: readonly [/** OTP cookies live on `localhost:PORT` but OpenFort hits the Convex host. */"auth-origin-mismatch", /** An old `userId` in scoped storage makes the SDK skip re-auth → 401. */"stale-openfort-cache", /** The selected app/deployment origin is not allowlisted → 401. */"app-env-allowlist", /** Sandboxed/headless browser with no Web Crypto. */"no-secure-context", /** One upstream answered HTTP 429 or JSON-RPC -32005. Retryable. */"rate-limited", /** No answer inside the budget. Retryable. */"timeout", /** HTTP 5xx, a connection failure, or a malformed envelope. Retryable. */"upstream-down", /** Simulation or execution reverted; `chain.revert` names it when decodable. */"revert", /** A balance pre-flight shortfall or a decoded `ERC20InsufficientBalance`. */"insufficient-balance", /** A decoded `ERC20InsufficientAllowance`. */"insufficient-allowance", /** The bundler's validation refused the operation (AA2x/AA3x); its text is carried. */"rejected", /** The gateway refused the token. */"unauthorized", /** No cause could be determined. */"unknown"];
+type FailureMode = (typeof FAILURE_MODES)[number];
+/** Who answered. `alto` is the bundler; `gateway` is the AA gateway's own logic. */
+declare const CHAIN_UPSTREAMS: readonly ["alchemy", "infura", "public", "alto", "gateway"];
+type ChainUpstream = (typeof CHAIN_UPSTREAMS)[number];
+/** A decoded revert. `name` is null when the selector is unknown or the data was empty. */
+type RevertSummary = {
+  readonly name: string | null;
+  readonly selector: string;
+  readonly args: Readonly<Record<string, string>>;
+};
+/**
+ * The structured cause of a chain-path failure. Built once by the layer that
+ * saw the failure and passed on unchanged. `providerMessage` is the provider's
+ * own words, bounded and secret-masked by the producer; it is evidence, never
+ * something a consumer routes on.
+ */
+type ChainCause = {
+  readonly mode: FailureMode;
+  readonly upstream: ChainUpstream;
+  readonly method: string;
+  readonly retryable: boolean;
+  readonly httpStatus?: number;
+  readonly rpcCode?: number;
+  readonly revert?: RevertSummary;
+  readonly providerMessage?: string;
+};
+//#endregion
 //#region ../errors/src/errors.d.ts
 declare const CAPXUL_ERROR_CODES: readonly ["NOT_AUTHENTICATED", "EMAIL_DELIVERY_FAILED", "PROFILE_NOT_FOUND", "SMART_ACCOUNT_MISSING", "PLAYER_NOT_FOUND", "ACCOUNT_NOT_FOUND", "PROVIDER_ERROR", "CAPABILITY_UNAVAILABLE", "INVALID_INPUT", "ENV_MISSING", "NOT_IMPLEMENTED", "VERIFICATION_REQUIRED", "INSUFFICIENT_BALANCE", "INVALID_RECIPIENT", "ROLE_PERMISSION_DENIED", "TRANSACTION_FAILED", "RATE_LIMITED", "NETWORK_ERROR", "UNKNOWN", "OTP_EXPIRED", "SIGNER_REJECTED", "CANCELLED", "WRONG_STATE", "STALE_EPOCH", "SUPERSEDED", "WORK_DIED", "ACTOR_STOPPED"];
 type CapxulErrorCode = (typeof CAPXUL_ERROR_CODES)[number];
-/**
- * Why an auth/provider call failed — a flat CAUSE enum. The *where* (which
- * OpenFort operation) stays in the separate `operation` detail field; this
- * names the root cause so a single `$exception` can be triaged without
- * parsing the message. Five members, no free strings:
- *
- * - `auth-origin-mismatch`: OTP cookies live on `localhost:PORT` but OpenFort
- *   hits the Convex host → no session reaches the provider.
- * - `stale-openfort-cache`: an old `userId` in scoped storage makes the SDK
- *   skip re-auth → 401 on `v2/accounts`.
- * - `app-env-allowlist`: the selected app/deployment origin is not allowlisted
- *   → 401.
- * - `no-secure-context`: sandboxed/headless browser with no Web Crypto, so
- *   `getAddress`/`configure` can never produce an address. Previously vanished
- *   into `unknown`; the signer's secure-context probe now names it.
- * - `unknown`: catch-all when no cause could be determined.
- */
-type FailureMode = "auth-origin-mismatch" | "stale-openfort-cache" | "app-env-allowlist" | "no-secure-context" /** #1684: an upstream RPC provider throttled the call (HTTP 429 or JSON-RPC -32005). Retryable. */ | "rate-limited" | "unknown";
 type CapxulErrorDetails = Record<string, unknown>;
 type CapxulErrorOptions = {
   readonly cause?: unknown;
   readonly details?: CapxulErrorDetails;
   readonly correlationId?: string;
   readonly layer?: string;
+  readonly mode?: FailureMode;
+  readonly chain?: ChainCause;
 };
 declare class CapxulError extends Error {
   readonly code: CapxulErrorCode;
   readonly details?: CapxulErrorDetails;
   readonly correlationId?: string;
   readonly layer?: string;
+  /** The one-word cause (`FailureMode`). `chain.mode` when a chain cause is set. */
+  readonly mode?: FailureMode;
+  /** The structured chain-path cause. Never rewritten by a later layer. */
+  readonly chain?: ChainCause;
   constructor(code: CapxulErrorCode, message: string, options?: CapxulErrorOptions);
 }
 //#endregion
@@ -109,7 +133,7 @@ interface TelemetryPort {
 }
 //#endregion
 //#region src/index.d.ts
-declare const TELEMETRY_EVENT_NAMES: readonly ["auth_otp_requested", "auth_otp_delivered", "auth_otp_expired", "auth_verified", "auth_failed", "auth_signed_out", "onboarding_intent_selected", "onboarding_profile_submitted", "onboarding_organization_submitted", "onboarding_dashboard_reached", "provisioning_safe_created", "provisioning_safe_confirmed", "bootstrap_resolved", "bootstrap_failed", "member_activation_started", "member_activation_ready", "member_activation_failed", "organization_creation_started", "organization_creation_ready", "organization_creation_failed", "aa_gateway_upstream_fallback", "account_balance_read", "account_balance_failed", "faucet_requested", "faucet_confirmed", "faucet_failed", "org_create_started", "org_safe_created", "org_safe_confirmed", "org_roles_seeded", "org_created", "org_create_failed", "org_invite_sent", "org_invite_accepted", "org_invite_expired", "payment_initiated", "payment_settled", "payment_failed", "deposit_initiated", "deposit_settled", "permission_mirror_verification", "movement_scan_window", "movement_scan_checkpoint", "movement_scan_incident"];
+declare const TELEMETRY_EVENT_NAMES: readonly ["auth_otp_requested", "auth_otp_delivered", "auth_otp_expired", "auth_verified", "auth_failed", "auth_signed_out", "onboarding_intent_selected", "onboarding_profile_submitted", "onboarding_organization_submitted", "onboarding_dashboard_reached", "provisioning_safe_created", "provisioning_safe_confirmed", "bootstrap_resolved", "bootstrap_failed", "member_activation_started", "member_activation_ready", "member_activation_failed", "organization_creation_started", "organization_creation_ready", "organization_creation_failed", "chain_upstream_fallback", "bundler_error", "receipt_pending", "operation_retried", "account_balance_read", "account_balance_failed", "faucet_requested", "faucet_confirmed", "faucet_failed", "org_create_started", "org_safe_created", "org_safe_confirmed", "org_roles_seeded", "org_created", "org_create_failed", "org_invite_sent", "org_invite_accepted", "org_invite_expired", "payment_initiated", "payment_settled", "payment_failed", "payment_verification_retry", "deposit_initiated", "deposit_settled", "permission_mirror_verification", "movement_scan_window", "movement_scan_checkpoint", "movement_scan_incident"];
 type TelemetryEventName = (typeof TELEMETRY_EVENT_NAMES)[number];
 type NonEmptyTelemetryEventNames = readonly [TelemetryEventName, ...TelemetryEventName[]];
 type FunnelStepPropertyFilter = {
@@ -297,6 +321,14 @@ declare const SYNCABLE_CAPXUL_ENVS: readonly ["development", "staging", "product
  */
 declare const TELEMETRY_PRODUCERS: readonly ["server", "browser", "sdk", "mcp", "e2e"];
 type TelemetryProducer = (typeof TELEMETRY_PRODUCERS)[number];
+/**
+ * The cause of a failure, flat (ADR-0023 R7–R8). `failure_mode` is the one
+ * word from `@capxul/errors`; the `chain_*` keys are the `ChainCause` when the
+ * failure came from the chain path. Spread into every failure event and posted
+ * on `$exception`, so one PostHog filter finds a cause wherever it was seen.
+ */
+declare const FailureModeSchema: Schema.Literals<readonly ["auth-origin-mismatch", "stale-openfort-cache", "app-env-allowlist", "no-secure-context", "rate-limited", "timeout", "upstream-down", "revert", "insufficient-balance", "insufficient-allowance", "rejected", "unauthorized", "unknown"]>;
+declare const ChainUpstreamSchema: Schema.Literals<readonly ["alchemy", "infura", "public", "alto", "gateway"]>;
 interface TelemetryEnvelopeDefaults {
   readonly capxul_env: CapxulEnv;
   readonly producer: TelemetryProducer;
@@ -365,6 +397,16 @@ declare const AuthFailedTelemetryEventSchema: Schema.Struct<{
     readonly journey_id: Schema.optional<Schema.String>;
     readonly correlation_id: Schema.optional<Schema.String>;
     readonly sdk_version: Schema.optional<Schema.String>;
+    readonly failure_mode: Schema.optional<Schema.Literals<readonly ["auth-origin-mismatch", "stale-openfort-cache", "app-env-allowlist", "no-secure-context", "rate-limited", "timeout", "upstream-down", "revert", "insufficient-balance", "insufficient-allowance", "rejected", "unauthorized", "unknown"]>>;
+    readonly chain_upstream: Schema.optional<Schema.Literals<readonly ["alchemy", "infura", "public", "alto", "gateway"]>>;
+    readonly chain_method: Schema.optional<Schema.String>;
+    readonly chain_retryable: Schema.optional<Schema.Boolean>;
+    readonly chain_http_status: Schema.optional<Schema.Number>;
+    readonly chain_rpc_code: Schema.optional<Schema.Number>;
+    readonly chain_revert_name: Schema.optional<Schema.String>;
+    readonly chain_revert_selector: Schema.optional<Schema.String>;
+    readonly chain_revert_args: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+    readonly chain_provider_message: Schema.optional<Schema.String>;
     readonly email: Schema.optional<Schema.brand<Schema.String, "PII">>;
     readonly auth_type: Schema.optional<Schema.String>;
     readonly reason: Schema.optional<Schema.String>;
@@ -476,6 +518,16 @@ declare const BootstrapFailedTelemetryEventSchema: Schema.Struct<{
     readonly journey_id: Schema.optional<Schema.String>;
     readonly correlation_id: Schema.optional<Schema.String>;
     readonly sdk_version: Schema.optional<Schema.String>;
+    readonly failure_mode: Schema.optional<Schema.Literals<readonly ["auth-origin-mismatch", "stale-openfort-cache", "app-env-allowlist", "no-secure-context", "rate-limited", "timeout", "upstream-down", "revert", "insufficient-balance", "insufficient-allowance", "rejected", "unauthorized", "unknown"]>>;
+    readonly chain_upstream: Schema.optional<Schema.Literals<readonly ["alchemy", "infura", "public", "alto", "gateway"]>>;
+    readonly chain_method: Schema.optional<Schema.String>;
+    readonly chain_retryable: Schema.optional<Schema.Boolean>;
+    readonly chain_http_status: Schema.optional<Schema.Number>;
+    readonly chain_rpc_code: Schema.optional<Schema.Number>;
+    readonly chain_revert_name: Schema.optional<Schema.String>;
+    readonly chain_revert_selector: Schema.optional<Schema.String>;
+    readonly chain_revert_args: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+    readonly chain_provider_message: Schema.optional<Schema.String>;
     readonly applicationId: Schema.optional<Schema.Codec<AppId, string, never, never>>;
     readonly durationMs: Schema.optional<Schema.Codec<DurationMs, number, never, never>>;
     readonly origin: Schema.optional<Schema.String>;
@@ -513,6 +565,16 @@ declare const MemberActivationFailedTelemetryEventSchema: Schema.Struct<{
     readonly journey_id: Schema.optional<Schema.String>;
     readonly correlation_id: Schema.optional<Schema.String>;
     readonly sdk_version: Schema.optional<Schema.String>;
+    readonly failure_mode: Schema.optional<Schema.Literals<readonly ["auth-origin-mismatch", "stale-openfort-cache", "app-env-allowlist", "no-secure-context", "rate-limited", "timeout", "upstream-down", "revert", "insufficient-balance", "insufficient-allowance", "rejected", "unauthorized", "unknown"]>>;
+    readonly chain_upstream: Schema.optional<Schema.Literals<readonly ["alchemy", "infura", "public", "alto", "gateway"]>>;
+    readonly chain_method: Schema.optional<Schema.String>;
+    readonly chain_retryable: Schema.optional<Schema.Boolean>;
+    readonly chain_http_status: Schema.optional<Schema.Number>;
+    readonly chain_rpc_code: Schema.optional<Schema.Number>;
+    readonly chain_revert_name: Schema.optional<Schema.String>;
+    readonly chain_revert_selector: Schema.optional<Schema.String>;
+    readonly chain_revert_args: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+    readonly chain_provider_message: Schema.optional<Schema.String>;
     readonly $insert_id: Schema.String;
     readonly stage: Schema.Literals<readonly ["profile", "accountProvisioning", "accountClaim", "preparingFounderAccount", "awaitingFounderAuthorization", "submittingBootstrap", "confirmingBootstrap"]>;
     readonly error_code: Schema.String;
@@ -554,6 +616,16 @@ declare const OrganizationCreationFailedTelemetryEventSchema: Schema.Struct<{
     readonly journey_id: Schema.optional<Schema.String>;
     readonly correlation_id: Schema.optional<Schema.String>;
     readonly sdk_version: Schema.optional<Schema.String>;
+    readonly failure_mode: Schema.optional<Schema.Literals<readonly ["auth-origin-mismatch", "stale-openfort-cache", "app-env-allowlist", "no-secure-context", "rate-limited", "timeout", "upstream-down", "revert", "insufficient-balance", "insufficient-allowance", "rejected", "unauthorized", "unknown"]>>;
+    readonly chain_upstream: Schema.optional<Schema.Literals<readonly ["alchemy", "infura", "public", "alto", "gateway"]>>;
+    readonly chain_method: Schema.optional<Schema.String>;
+    readonly chain_retryable: Schema.optional<Schema.Boolean>;
+    readonly chain_http_status: Schema.optional<Schema.Number>;
+    readonly chain_rpc_code: Schema.optional<Schema.Number>;
+    readonly chain_revert_name: Schema.optional<Schema.String>;
+    readonly chain_revert_selector: Schema.optional<Schema.String>;
+    readonly chain_revert_args: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+    readonly chain_provider_message: Schema.optional<Schema.String>;
     readonly $insert_id: Schema.String;
     readonly organization_id: Schema.Codec<string, string, never, never>;
     readonly attempt_number: Schema.refine<number, Schema.Number>;
@@ -586,6 +658,16 @@ declare const AccountBalanceFailedTelemetryEventSchema: Schema.Struct<{
     readonly journey_id: Schema.optional<Schema.String>;
     readonly correlation_id: Schema.optional<Schema.String>;
     readonly sdk_version: Schema.optional<Schema.String>;
+    readonly failure_mode: Schema.optional<Schema.Literals<readonly ["auth-origin-mismatch", "stale-openfort-cache", "app-env-allowlist", "no-secure-context", "rate-limited", "timeout", "upstream-down", "revert", "insufficient-balance", "insufficient-allowance", "rejected", "unauthorized", "unknown"]>>;
+    readonly chain_upstream: Schema.optional<Schema.Literals<readonly ["alchemy", "infura", "public", "alto", "gateway"]>>;
+    readonly chain_method: Schema.optional<Schema.String>;
+    readonly chain_retryable: Schema.optional<Schema.Boolean>;
+    readonly chain_http_status: Schema.optional<Schema.Number>;
+    readonly chain_rpc_code: Schema.optional<Schema.Number>;
+    readonly chain_revert_name: Schema.optional<Schema.String>;
+    readonly chain_revert_selector: Schema.optional<Schema.String>;
+    readonly chain_revert_args: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+    readonly chain_provider_message: Schema.optional<Schema.String>;
     readonly reason: Schema.optional<Schema.String>;
   }>;
 }>;
@@ -623,11 +705,39 @@ declare const FaucetFailedTelemetryEventSchema: Schema.Struct<{
     readonly journey_id: Schema.optional<Schema.String>;
     readonly correlation_id: Schema.optional<Schema.String>;
     readonly sdk_version: Schema.optional<Schema.String>;
+    readonly failure_mode: Schema.optional<Schema.Literals<readonly ["auth-origin-mismatch", "stale-openfort-cache", "app-env-allowlist", "no-secure-context", "rate-limited", "timeout", "upstream-down", "revert", "insufficient-balance", "insufficient-allowance", "rejected", "unauthorized", "unknown"]>>;
+    readonly chain_upstream: Schema.optional<Schema.Literals<readonly ["alchemy", "infura", "public", "alto", "gateway"]>>;
+    readonly chain_method: Schema.optional<Schema.String>;
+    readonly chain_retryable: Schema.optional<Schema.Boolean>;
+    readonly chain_http_status: Schema.optional<Schema.Number>;
+    readonly chain_rpc_code: Schema.optional<Schema.Number>;
+    readonly chain_revert_name: Schema.optional<Schema.String>;
+    readonly chain_revert_selector: Schema.optional<Schema.String>;
+    readonly chain_revert_args: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+    readonly chain_provider_message: Schema.optional<Schema.String>;
     readonly reason: Schema.optional<Schema.String>;
   }>;
 }>;
-declare const AaGatewayUpstreamFallbackTelemetryEventSchema: Schema.Struct<{
-  readonly name: Schema.Literal<"aa_gateway_upstream_fallback">;
+declare const ChainUpstreamFallbackTelemetryEventSchema: Schema.Struct<{
+  readonly name: Schema.Literal<"chain_upstream_fallback">;
+  readonly props: Schema.Struct<{
+    readonly capxul_env: Schema.Literals<readonly ["development", "staging", "production", "unknown", "local"]>;
+    readonly producer: Schema.Literals<readonly ["server", "browser", "sdk", "mcp", "e2e"]>;
+    readonly journey_id: Schema.optional<Schema.String>;
+    readonly correlation_id: Schema.optional<Schema.String>;
+    readonly sdk_version: Schema.optional<Schema.String>;
+    readonly service: Schema.Literals<readonly ["aa-gateway", "backend"]>;
+    readonly method: Schema.String;
+    readonly from_upstream: Schema.Literals<readonly ["alchemy", "infura", "public", "alto", "gateway"]>;
+    readonly to_upstream: Schema.optional<Schema.Literals<readonly ["alchemy", "infura", "public", "alto", "gateway"]>>;
+    readonly failure_mode: Schema.Literals<readonly ["auth-origin-mismatch", "stale-openfort-cache", "app-env-allowlist", "no-secure-context", "rate-limited", "timeout", "upstream-down", "revert", "insufficient-balance", "insufficient-allowance", "rejected", "unauthorized", "unknown"]>;
+    readonly exhausted: Schema.Boolean;
+    readonly http_status: Schema.optional<Schema.Number>;
+    readonly rpc_code: Schema.optional<Schema.Number>;
+  }>;
+}>;
+declare const BundlerErrorTelemetryEventSchema: Schema.Struct<{
+  readonly name: Schema.Literal<"bundler_error">;
   readonly props: Schema.Struct<{
     readonly capxul_env: Schema.Literals<readonly ["development", "staging", "production", "unknown", "local"]>;
     readonly producer: Schema.Literals<readonly ["server", "browser", "sdk", "mcp", "e2e"]>;
@@ -635,10 +745,41 @@ declare const AaGatewayUpstreamFallbackTelemetryEventSchema: Schema.Struct<{
     readonly correlation_id: Schema.optional<Schema.String>;
     readonly sdk_version: Schema.optional<Schema.String>;
     readonly method: Schema.String;
-    readonly from_upstream: Schema.Literals<readonly ["alchemy", "infura", "public"]>;
-    readonly to_upstream: Schema.optional<Schema.Literals<readonly ["alchemy", "infura", "public"]>>;
-    readonly failure: Schema.Literals<readonly ["http-429", "http-5xx", "rpc-rate-limit", "timeout", "network"]>;
-    readonly status: Schema.optional<Schema.Number>;
+    readonly failure_mode: Schema.Literals<readonly ["auth-origin-mismatch", "stale-openfort-cache", "app-env-allowlist", "no-secure-context", "rate-limited", "timeout", "upstream-down", "revert", "insufficient-balance", "insufficient-allowance", "rejected", "unauthorized", "unknown"]>;
+    readonly chain_upstream: Schema.Literals<readonly ["alchemy", "infura", "public", "alto", "gateway"]>;
+    readonly chain_retryable: Schema.Boolean;
+    readonly http_status: Schema.optional<Schema.Number>;
+    readonly rpc_code: Schema.optional<Schema.Number>;
+    readonly chain_revert_name: Schema.optional<Schema.String>;
+    readonly chain_provider_message: Schema.optional<Schema.String>;
+  }>;
+}>;
+declare const ReceiptPendingTelemetryEventSchema: Schema.Struct<{
+  readonly name: Schema.Literal<"receipt_pending">;
+  readonly props: Schema.Struct<{
+    readonly capxul_env: Schema.Literals<readonly ["development", "staging", "production", "unknown", "local"]>;
+    readonly producer: Schema.Literals<readonly ["server", "browser", "sdk", "mcp", "e2e"]>;
+    readonly journey_id: Schema.optional<Schema.String>;
+    readonly correlation_id: Schema.optional<Schema.String>;
+    readonly sdk_version: Schema.optional<Schema.String>;
+    readonly service: Schema.Literals<readonly ["aa-gateway", "backend"]>;
+    readonly method: Schema.String;
+    readonly chain_upstream: Schema.Literals<readonly ["alchemy", "infura", "public", "alto", "gateway"]>;
+    readonly reason: Schema.Literals<readonly ["zero_block_hash", "no_receipt"]>;
+  }>;
+}>;
+declare const OperationRetriedTelemetryEventSchema: Schema.Struct<{
+  readonly name: Schema.Literal<"operation_retried">;
+  readonly props: Schema.Struct<{
+    readonly capxul_env: Schema.Literals<readonly ["development", "staging", "production", "unknown", "local"]>;
+    readonly producer: Schema.Literals<readonly ["server", "browser", "sdk", "mcp", "e2e"]>;
+    readonly journey_id: Schema.optional<Schema.String>;
+    readonly correlation_id: Schema.optional<Schema.String>;
+    readonly sdk_version: Schema.optional<Schema.String>;
+    readonly operation: Schema.String;
+    readonly failure_mode: Schema.Literals<readonly ["auth-origin-mismatch", "stale-openfort-cache", "app-env-allowlist", "no-secure-context", "rate-limited", "timeout", "upstream-down", "revert", "insufficient-balance", "insufficient-allowance", "rejected", "unauthorized", "unknown"]>;
+    readonly attempt: Schema.Number;
+    readonly delay_ms: Schema.Codec<DurationMs, number, never, never>;
   }>;
 }>;
 declare const OrgCreateStartedTelemetryEventSchema: Schema.Struct<{
@@ -717,6 +858,16 @@ declare const OrgCreateFailedTelemetryEventSchema: Schema.Struct<{
     readonly journey_id: Schema.optional<Schema.String>;
     readonly correlation_id: Schema.optional<Schema.String>;
     readonly sdk_version: Schema.optional<Schema.String>;
+    readonly failure_mode: Schema.optional<Schema.Literals<readonly ["auth-origin-mismatch", "stale-openfort-cache", "app-env-allowlist", "no-secure-context", "rate-limited", "timeout", "upstream-down", "revert", "insufficient-balance", "insufficient-allowance", "rejected", "unauthorized", "unknown"]>>;
+    readonly chain_upstream: Schema.optional<Schema.Literals<readonly ["alchemy", "infura", "public", "alto", "gateway"]>>;
+    readonly chain_method: Schema.optional<Schema.String>;
+    readonly chain_retryable: Schema.optional<Schema.Boolean>;
+    readonly chain_http_status: Schema.optional<Schema.Number>;
+    readonly chain_rpc_code: Schema.optional<Schema.Number>;
+    readonly chain_revert_name: Schema.optional<Schema.String>;
+    readonly chain_revert_selector: Schema.optional<Schema.String>;
+    readonly chain_revert_args: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+    readonly chain_provider_message: Schema.optional<Schema.String>;
     readonly org_id: Schema.optional<Schema.Codec<string, string, never, never>>;
     readonly reason: Schema.optional<Schema.String>;
   }>;
@@ -796,11 +947,35 @@ declare const PaymentFailedTelemetryEventSchema: Schema.Struct<{
     readonly journey_id: Schema.optional<Schema.String>;
     readonly correlation_id: Schema.optional<Schema.String>;
     readonly sdk_version: Schema.optional<Schema.String>;
+    readonly failure_mode: Schema.optional<Schema.Literals<readonly ["auth-origin-mismatch", "stale-openfort-cache", "app-env-allowlist", "no-secure-context", "rate-limited", "timeout", "upstream-down", "revert", "insufficient-balance", "insufficient-allowance", "rejected", "unauthorized", "unknown"]>>;
+    readonly chain_upstream: Schema.optional<Schema.Literals<readonly ["alchemy", "infura", "public", "alto", "gateway"]>>;
+    readonly chain_method: Schema.optional<Schema.String>;
+    readonly chain_retryable: Schema.optional<Schema.Boolean>;
+    readonly chain_http_status: Schema.optional<Schema.Number>;
+    readonly chain_rpc_code: Schema.optional<Schema.Number>;
+    readonly chain_revert_name: Schema.optional<Schema.String>;
+    readonly chain_revert_selector: Schema.optional<Schema.String>;
+    readonly chain_revert_args: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+    readonly chain_provider_message: Schema.optional<Schema.String>;
     readonly kind: Schema.String;
     readonly payment_id: Schema.String;
     readonly reason_code: Schema.String;
   }>;
 }>;
+declare const PaymentVerificationRetryTelemetryEventSchema: Schema.Struct<{
+  readonly name: Schema.Literal<"payment_verification_retry">;
+  readonly props: Schema.Struct<{
+    readonly capxul_env: Schema.Literals<readonly ["development", "staging", "production", "unknown", "local"]>;
+    readonly producer: Schema.Literals<readonly ["server", "browser", "sdk", "mcp", "e2e"]>;
+    readonly journey_id: Schema.optional<Schema.String>;
+    readonly correlation_id: Schema.optional<Schema.String>;
+    readonly sdk_version: Schema.optional<Schema.String>;
+    readonly command_id: Schema.String;
+    readonly attempt: Schema.Number;
+    readonly reason_code: Schema.String;
+    readonly chain_id: Schema.Number;
+  }>;
+}>;
 declare const DepositInitiatedTelemetryEventSchema: Schema.Struct<{
   readonly name: Schema.Literal<"deposit_initiated">;
   readonly props: Schema.Struct<{
@@ -941,6 +1116,16 @@ declare const TELEMETRY_EVENT_SCHEMAS: {
       readonly journey_id: Schema.optional<Schema.String>;
       readonly correlation_id: Schema.optional<Schema.String>;
       readonly sdk_version: Schema.optional<Schema.String>;
+      readonly failure_mode: Schema.optional<Schema.Literals<readonly ["auth-origin-mismatch", "stale-openfort-cache", "app-env-allowlist", "no-secure-context", "rate-limited", "timeout", "upstream-down", "revert", "insufficient-balance", "insufficient-allowance", "rejected", "unauthorized", "unknown"]>>;
+      readonly chain_upstream: Schema.optional<Schema.Literals<readonly ["alchemy", "infura", "public", "alto", "gateway"]>>;
+      readonly chain_method: Schema.optional<Schema.String>;
+      readonly chain_retryable: Schema.optional<Schema.Boolean>;
+      readonly chain_http_status: Schema.optional<Schema.Number>;
+      readonly chain_rpc_code: Schema.optional<Schema.Number>;
+      readonly chain_revert_name: Schema.optional<Schema.String>;
+      readonly chain_revert_selector: Schema.optional<Schema.String>;
+      readonly chain_revert_args: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+      readonly chain_provider_message: Schema.optional<Schema.String>;
       readonly email: Schema.optional<Schema.brand<Schema.String, "PII">>;
       readonly auth_type: Schema.optional<Schema.String>;
       readonly reason: Schema.optional<Schema.String>;
@@ -1052,6 +1237,16 @@ declare const TELEMETRY_EVENT_SCHEMAS: {
       readonly journey_id: Schema.optional<Schema.String>;
       readonly correlation_id: Schema.optional<Schema.String>;
       readonly sdk_version: Schema.optional<Schema.String>;
+      readonly failure_mode: Schema.optional<Schema.Literals<readonly ["auth-origin-mismatch", "stale-openfort-cache", "app-env-allowlist", "no-secure-context", "rate-limited", "timeout", "upstream-down", "revert", "insufficient-balance", "insufficient-allowance", "rejected", "unauthorized", "unknown"]>>;
+      readonly chain_upstream: Schema.optional<Schema.Literals<readonly ["alchemy", "infura", "public", "alto", "gateway"]>>;
+      readonly chain_method: Schema.optional<Schema.String>;
+      readonly chain_retryable: Schema.optional<Schema.Boolean>;
+      readonly chain_http_status: Schema.optional<Schema.Number>;
+      readonly chain_rpc_code: Schema.optional<Schema.Number>;
+      readonly chain_revert_name: Schema.optional<Schema.String>;
+      readonly chain_revert_selector: Schema.optional<Schema.String>;
+      readonly chain_revert_args: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+      readonly chain_provider_message: Schema.optional<Schema.String>;
       readonly applicationId: Schema.optional<Schema.Codec<AppId, string, never, never>>;
       readonly durationMs: Schema.optional<Schema.Codec<DurationMs, number, never, never>>;
       readonly origin: Schema.optional<Schema.String>;
@@ -1089,6 +1284,16 @@ declare const TELEMETRY_EVENT_SCHEMAS: {
       readonly journey_id: Schema.optional<Schema.String>;
       readonly correlation_id: Schema.optional<Schema.String>;
       readonly sdk_version: Schema.optional<Schema.String>;
+      readonly failure_mode: Schema.optional<Schema.Literals<readonly ["auth-origin-mismatch", "stale-openfort-cache", "app-env-allowlist", "no-secure-context", "rate-limited", "timeout", "upstream-down", "revert", "insufficient-balance", "insufficient-allowance", "rejected", "unauthorized", "unknown"]>>;
+      readonly chain_upstream: Schema.optional<Schema.Literals<readonly ["alchemy", "infura", "public", "alto", "gateway"]>>;
+      readonly chain_method: Schema.optional<Schema.String>;
+      readonly chain_retryable: Schema.optional<Schema.Boolean>;
+      readonly chain_http_status: Schema.optional<Schema.Number>;
+      readonly chain_rpc_code: Schema.optional<Schema.Number>;
+      readonly chain_revert_name: Schema.optional<Schema.String>;
+      readonly chain_revert_selector: Schema.optional<Schema.String>;
+      readonly chain_revert_args: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+      readonly chain_provider_message: Schema.optional<Schema.String>;
       readonly $insert_id: Schema.String;
       readonly stage: Schema.Literals<readonly ["profile", "accountProvisioning", "accountClaim", "preparingFounderAccount", "awaitingFounderAuthorization", "submittingBootstrap", "confirmingBootstrap"]>;
       readonly error_code: Schema.String;
@@ -1130,6 +1335,16 @@ declare const TELEMETRY_EVENT_SCHEMAS: {
       readonly journey_id: Schema.optional<Schema.String>;
       readonly correlation_id: Schema.optional<Schema.String>;
       readonly sdk_version: Schema.optional<Schema.String>;
+      readonly failure_mode: Schema.optional<Schema.Literals<readonly ["auth-origin-mismatch", "stale-openfort-cache", "app-env-allowlist", "no-secure-context", "rate-limited", "timeout", "upstream-down", "revert", "insufficient-balance", "insufficient-allowance", "rejected", "unauthorized", "unknown"]>>;
+      readonly chain_upstream: Schema.optional<Schema.Literals<readonly ["alchemy", "infura", "public", "alto", "gateway"]>>;
+      readonly chain_method: Schema.optional<Schema.String>;
+      readonly chain_retryable: Schema.optional<Schema.Boolean>;
+      readonly chain_http_status: Schema.optional<Schema.Number>;
+      readonly chain_rpc_code: Schema.optional<Schema.Number>;
+      readonly chain_revert_name: Schema.optional<Schema.String>;
+      readonly chain_revert_selector: Schema.optional<Schema.String>;
+      readonly chain_revert_args: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+      readonly chain_provider_message: Schema.optional<Schema.String>;
       readonly $insert_id: Schema.String;
       readonly organization_id: Schema.Codec<string, string, never, never>;
       readonly attempt_number: Schema.refine<number, Schema.Number>;
@@ -1162,6 +1377,16 @@ declare const TELEMETRY_EVENT_SCHEMAS: {
       readonly journey_id: Schema.optional<Schema.String>;
       readonly correlation_id: Schema.optional<Schema.String>;
       readonly sdk_version: Schema.optional<Schema.String>;
+      readonly failure_mode: Schema.optional<Schema.Literals<readonly ["auth-origin-mismatch", "stale-openfort-cache", "app-env-allowlist", "no-secure-context", "rate-limited", "timeout", "upstream-down", "revert", "insufficient-balance", "insufficient-allowance", "rejected", "unauthorized", "unknown"]>>;
+      readonly chain_upstream: Schema.optional<Schema.Literals<readonly ["alchemy", "infura", "public", "alto", "gateway"]>>;
+      readonly chain_method: Schema.optional<Schema.String>;
+      readonly chain_retryable: Schema.optional<Schema.Boolean>;
+      readonly chain_http_status: Schema.optional<Schema.Number>;
+      readonly chain_rpc_code: Schema.optional<Schema.Number>;
+      readonly chain_revert_name: Schema.optional<Schema.String>;
+      readonly chain_revert_selector: Schema.optional<Schema.String>;
+      readonly chain_revert_args: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+      readonly chain_provider_message: Schema.optional<Schema.String>;
       readonly reason: Schema.optional<Schema.String>;
     }>;
   }>;
@@ -1199,22 +1424,81 @@ declare const TELEMETRY_EVENT_SCHEMAS: {
       readonly journey_id: Schema.optional<Schema.String>;
       readonly correlation_id: Schema.optional<Schema.String>;
       readonly sdk_version: Schema.optional<Schema.String>;
+      readonly failure_mode: Schema.optional<Schema.Literals<readonly ["auth-origin-mismatch", "stale-openfort-cache", "app-env-allowlist", "no-secure-context", "rate-limited", "timeout", "upstream-down", "revert", "insufficient-balance", "insufficient-allowance", "rejected", "unauthorized", "unknown"]>>;
+      readonly chain_upstream: Schema.optional<Schema.Literals<readonly ["alchemy", "infura", "public", "alto", "gateway"]>>;
+      readonly chain_method: Schema.optional<Schema.String>;
+      readonly chain_retryable: Schema.optional<Schema.Boolean>;
+      readonly chain_http_status: Schema.optional<Schema.Number>;
+      readonly chain_rpc_code: Schema.optional<Schema.Number>;
+      readonly chain_revert_name: Schema.optional<Schema.String>;
+      readonly chain_revert_selector: Schema.optional<Schema.String>;
+      readonly chain_revert_args: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+      readonly chain_provider_message: Schema.optional<Schema.String>;
       readonly reason: Schema.optional<Schema.String>;
     }>;
   }>;
-  readonly aa_gateway_upstream_fallback: Schema.Struct<{
-    readonly name: Schema.Literal<"aa_gateway_upstream_fallback">;
+  readonly chain_upstream_fallback: Schema.Struct<{
+    readonly name: Schema.Literal<"chain_upstream_fallback">;
+    readonly props: Schema.Struct<{
+      readonly capxul_env: Schema.Literals<readonly ["development", "staging", "production", "unknown", "local"]>;
+      readonly producer: Schema.Literals<readonly ["server", "browser", "sdk", "mcp", "e2e"]>;
+      readonly journey_id: Schema.optional<Schema.String>;
+      readonly correlation_id: Schema.optional<Schema.String>;
+      readonly sdk_version: Schema.optional<Schema.String>;
+      readonly service: Schema.Literals<readonly ["aa-gateway", "backend"]>;
+      readonly method: Schema.String;
+      readonly from_upstream: Schema.Literals<readonly ["alchemy", "infura", "public", "alto", "gateway"]>;
+      readonly to_upstream: Schema.optional<Schema.Literals<readonly ["alchemy", "infura", "public", "alto", "gateway"]>>;
+      readonly failure_mode: Schema.Literals<readonly ["auth-origin-mismatch", "stale-openfort-cache", "app-env-allowlist", "no-secure-context", "rate-limited", "timeout", "upstream-down", "revert", "insufficient-balance", "insufficient-allowance", "rejected", "unauthorized", "unknown"]>;
+      readonly exhausted: Schema.Boolean;
+      readonly http_status: Schema.optional<Schema.Number>;
+      readonly rpc_code: Schema.optional<Schema.Number>;
+    }>;
+  }>;
+  readonly bundler_error: Schema.Struct<{
+    readonly name: Schema.Literal<"bundler_error">;
+    readonly props: Schema.Struct<{
+      readonly capxul_env: Schema.Literals<readonly ["development", "staging", "production", "unknown", "local"]>;
+      readonly producer: Schema.Literals<readonly ["server", "browser", "sdk", "mcp", "e2e"]>;
+      readonly journey_id: Schema.optional<Schema.String>;
+      readonly correlation_id: Schema.optional<Schema.String>;
+      readonly sdk_version: Schema.optional<Schema.String>;
+      readonly method: Schema.String;
+      readonly failure_mode: Schema.Literals<readonly ["auth-origin-mismatch", "stale-openfort-cache", "app-env-allowlist", "no-secure-context", "rate-limited", "timeout", "upstream-down", "revert", "insufficient-balance", "insufficient-allowance", "rejected", "unauthorized", "unknown"]>;
+      readonly chain_upstream: Schema.Literals<readonly ["alchemy", "infura", "public", "alto", "gateway"]>;
+      readonly chain_retryable: Schema.Boolean;
+      readonly http_status: Schema.optional<Schema.Number>;
+      readonly rpc_code: Schema.optional<Schema.Number>;
+      readonly chain_revert_name: Schema.optional<Schema.String>;
+      readonly chain_provider_message: Schema.optional<Schema.String>;
+    }>;
+  }>;
+  readonly receipt_pending: Schema.Struct<{
+    readonly name: Schema.Literal<"receipt_pending">;
     readonly props: Schema.Struct<{
       readonly capxul_env: Schema.Literals<readonly ["development", "staging", "production", "unknown", "local"]>;
       readonly producer: Schema.Literals<readonly ["server", "browser", "sdk", "mcp", "e2e"]>;
       readonly journey_id: Schema.optional<Schema.String>;
       readonly correlation_id: Schema.optional<Schema.String>;
       readonly sdk_version: Schema.optional<Schema.String>;
+      readonly service: Schema.Literals<readonly ["aa-gateway", "backend"]>;
       readonly method: Schema.String;
-      readonly from_upstream: Schema.Literals<readonly ["alchemy", "infura", "public"]>;
-      readonly to_upstream: Schema.optional<Schema.Literals<readonly ["alchemy", "infura", "public"]>>;
-      readonly failure: Schema.Literals<readonly ["http-429", "http-5xx", "rpc-rate-limit", "timeout", "network"]>;
-      readonly status: Schema.optional<Schema.Number>;
+      readonly chain_upstream: Schema.Literals<readonly ["alchemy", "infura", "public", "alto", "gateway"]>;
+      readonly reason: Schema.Literals<readonly ["zero_block_hash", "no_receipt"]>;
+    }>;
+  }>;
+  readonly operation_retried: Schema.Struct<{
+    readonly name: Schema.Literal<"operation_retried">;
+    readonly props: Schema.Struct<{
+      readonly capxul_env: Schema.Literals<readonly ["development", "staging", "production", "unknown", "local"]>;
+      readonly producer: Schema.Literals<readonly ["server", "browser", "sdk", "mcp", "e2e"]>;
+      readonly journey_id: Schema.optional<Schema.String>;
+      readonly correlation_id: Schema.optional<Schema.String>;
+      readonly sdk_version: Schema.optional<Schema.String>;
+      readonly operation: Schema.String;
+      readonly failure_mode: Schema.Literals<readonly ["auth-origin-mismatch", "stale-openfort-cache", "app-env-allowlist", "no-secure-context", "rate-limited", "timeout", "upstream-down", "revert", "insufficient-balance", "insufficient-allowance", "rejected", "unauthorized", "unknown"]>;
+      readonly attempt: Schema.Number;
+      readonly delay_ms: Schema.Codec<DurationMs, number, never, never>;
     }>;
   }>;
   readonly org_create_started: Schema.Struct<{
@@ -1293,6 +1577,16 @@ declare const TELEMETRY_EVENT_SCHEMAS: {
       readonly journey_id: Schema.optional<Schema.String>;
       readonly correlation_id: Schema.optional<Schema.String>;
       readonly sdk_version: Schema.optional<Schema.String>;
+      readonly failure_mode: Schema.optional<Schema.Literals<readonly ["auth-origin-mismatch", "stale-openfort-cache", "app-env-allowlist", "no-secure-context", "rate-limited", "timeout", "upstream-down", "revert", "insufficient-balance", "insufficient-allowance", "rejected", "unauthorized", "unknown"]>>;
+      readonly chain_upstream: Schema.optional<Schema.Literals<readonly ["alchemy", "infura", "public", "alto", "gateway"]>>;
+      readonly chain_method: Schema.optional<Schema.String>;
+      readonly chain_retryable: Schema.optional<Schema.Boolean>;
+      readonly chain_http_status: Schema.optional<Schema.Number>;
+      readonly chain_rpc_code: Schema.optional<Schema.Number>;
+      readonly chain_revert_name: Schema.optional<Schema.String>;
+      readonly chain_revert_selector: Schema.optional<Schema.String>;
+      readonly chain_revert_args: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+      readonly chain_provider_message: Schema.optional<Schema.String>;
       readonly org_id: Schema.optional<Schema.Codec<string, string, never, never>>;
       readonly reason: Schema.optional<Schema.String>;
     }>;
@@ -1372,11 +1666,35 @@ declare const TELEMETRY_EVENT_SCHEMAS: {
       readonly journey_id: Schema.optional<Schema.String>;
       readonly correlation_id: Schema.optional<Schema.String>;
       readonly sdk_version: Schema.optional<Schema.String>;
+      readonly failure_mode: Schema.optional<Schema.Literals<readonly ["auth-origin-mismatch", "stale-openfort-cache", "app-env-allowlist", "no-secure-context", "rate-limited", "timeout", "upstream-down", "revert", "insufficient-balance", "insufficient-allowance", "rejected", "unauthorized", "unknown"]>>;
+      readonly chain_upstream: Schema.optional<Schema.Literals<readonly ["alchemy", "infura", "public", "alto", "gateway"]>>;
+      readonly chain_method: Schema.optional<Schema.String>;
+      readonly chain_retryable: Schema.optional<Schema.Boolean>;
+      readonly chain_http_status: Schema.optional<Schema.Number>;
+      readonly chain_rpc_code: Schema.optional<Schema.Number>;
+      readonly chain_revert_name: Schema.optional<Schema.String>;
+      readonly chain_revert_selector: Schema.optional<Schema.String>;
+      readonly chain_revert_args: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+      readonly chain_provider_message: Schema.optional<Schema.String>;
       readonly kind: Schema.String;
       readonly payment_id: Schema.String;
       readonly reason_code: Schema.String;
     }>;
   }>;
+  readonly payment_verification_retry: Schema.Struct<{
+    readonly name: Schema.Literal<"payment_verification_retry">;
+    readonly props: Schema.Struct<{
+      readonly capxul_env: Schema.Literals<readonly ["development", "staging", "production", "unknown", "local"]>;
+      readonly producer: Schema.Literals<readonly ["server", "browser", "sdk", "mcp", "e2e"]>;
+      readonly journey_id: Schema.optional<Schema.String>;
+      readonly correlation_id: Schema.optional<Schema.String>;
+      readonly sdk_version: Schema.optional<Schema.String>;
+      readonly command_id: Schema.String;
+      readonly attempt: Schema.Number;
+      readonly reason_code: Schema.String;
+      readonly chain_id: Schema.Number;
+    }>;
+  }>;
   readonly deposit_initiated: Schema.Struct<{
     readonly name: Schema.Literal<"deposit_initiated">;
     readonly props: Schema.Struct<{
@@ -1698,4 +2016,4 @@ declare class InMemoryTelemetryBusAdapter implements TelemetryPort {
   reportHandledError(_error: CapxulError, _context?: HandledErrorReportContext): Effect.Effect<void, never>;
 }
 //#endregion
-export { AaGatewayUpstreamFallbackTelemetryEventSchema, AccountBalanceFailedTelemetryEventSchema, AccountBalanceReadTelemetryEventSchema, AuthFailedTelemetryEventSchema, AuthOtpDeliveredTelemetryEventSchema, AuthOtpExpiredTelemetryEventSchema, AuthOtpRequestedTelemetryEventSchema, AuthSignedOutTelemetryEventSchema, AuthVerifiedTelemetryEventSchema, BROWSER_GATED_TELEMETRY_EVENTS, BootstrapFailedTelemetryEventSchema, BootstrapResolvedTelemetryEventSchema, CAPXUL_ENVS, CONTRACT_FIRST_TELEMETRY_EVENTS, CapturedNetworkRequestLike, CapxulBrowserAnalyticsInput, CapxulEnv, DepositInitiatedTelemetryEventSchema, DepositSettledTelemetryEventSchema, FINANCIAL_OPS_TARGET_TELEMETRY_PRODUCERS, FaucetConfirmedTelemetryEventSchema, FaucetFailedTelemetryEventSchema, FaucetRequestedTelemetryEventSchema, FunnelJourney, FunnelStepPropertyFilter, type HandledErrorReportContext, InMemoryTelemetryBusAdapter, InitializePostHogBrowserAnalyticsInput, Journey, MemberActivationFailedTelemetryEventSchema, MemberActivationReadyTelemetryEventSchema, MemberActivationStartedTelemetryEventSchema, MovementScanCheckpointTelemetryEventSchema, MovementScanIncidentTelemetryEventSchema, MovementScanWindowTelemetryEventSchema, NonEmptyTelemetryEventNames, OnboardingDashboardReachedTelemetryEventSchema, OnboardingIntentSelectedTelemetryEventSchema, OnboardingOrganizationSubmittedTelemetryEventSchema, OnboardingProfileSubmittedTelemetryEventSchema, OrgCreateFailedTelemetryEventSchema, OrgCreateStartedTelemetryEventSchema, OrgCreatedTelemetryEventSchema, OrgInviteAcceptedTelemetryEventSchema, OrgInviteExpiredTelemetryEventSchema, OrgInviteSentTelemetryEventSchema, OrgRolesSeededTelemetryEventSchema, OrgSafeConfirmedTelemetryEventSchema, OrgSafeCreatedTelemetryEventSchema, OrganizationCreationFailedTelemetryEventSchema, OrganizationCreationReadyTelemetryEventSchema, OrganizationCreationStartedTelemetryEventSchema, PII, PRODUCT_MAPPER_GATED_TELEMETRY_EVENTS, PaymentFailedTelemetryEventSchema, PaymentInitiatedTelemetryEventSchema, PaymentSettledTelemetryEventSchema, PermissionMirrorVerificationTelemetryEventSchema, PointEventJourney, PostHogBeforeSend, PostHogBrowserCapture, PostHogBrowserInitialize, PostHogBrowserOptions, PostHogBrowserPageviewClient, PostHogProductAppOptions, PostHogTelemetryAdapter, PostHogUtilityAppOptions, ProvisioningSafeConfirmedTelemetryEventSchema, ProvisioningSafeCreatedTelemetryEventSchema, RecordingTelemetryAdapter, SYNCABLE_CAPXUL_ENVS, TELEMETRY_EVENT_NAMES, TELEMETRY_EVENT_SCHEMAS, TELEMETRY_JOURNEYS, TELEMETRY_PRODUCERS, TelemetryEnvelopeDefaults, TelemetryEvent, TelemetryEventName, TelemetryGroupInput, TelemetryIdentifyInput, type TelemetryPort, TelemetryProducer, TelemetryProps, TelemetryRedactionOptions, TrackHandler, createCapxulBeforeSend, createPostHogBrowserPageviewTracker, getTrackHandler, initializeCapxulBrowserAnalytics, initializePostHogBrowserAnalytics, maskCapturedNetworkRequest, productAppAnalytics, redactTelemetryEvent, redactTelemetryProps, sanitizePostHogBrowserEvent, setTrackHandler, stampTelemetryEnvelope, track, utilityAppAnalytics };
+export { AccountBalanceFailedTelemetryEventSchema, AccountBalanceReadTelemetryEventSchema, AuthFailedTelemetryEventSchema, AuthOtpDeliveredTelemetryEventSchema, AuthOtpExpiredTelemetryEventSchema, AuthOtpRequestedTelemetryEventSchema, AuthSignedOutTelemetryEventSchema, AuthVerifiedTelemetryEventSchema, BROWSER_GATED_TELEMETRY_EVENTS, BootstrapFailedTelemetryEventSchema, BootstrapResolvedTelemetryEventSchema, BundlerErrorTelemetryEventSchema, CAPXUL_ENVS, CONTRACT_FIRST_TELEMETRY_EVENTS, CapturedNetworkRequestLike, CapxulBrowserAnalyticsInput, CapxulEnv, ChainUpstreamFallbackTelemetryEventSchema, ChainUpstreamSchema, DepositInitiatedTelemetryEventSchema, DepositSettledTelemetryEventSchema, FINANCIAL_OPS_TARGET_TELEMETRY_PRODUCERS, FailureModeSchema, FaucetConfirmedTelemetryEventSchema, FaucetFailedTelemetryEventSchema, FaucetRequestedTelemetryEventSchema, FunnelJourney, FunnelStepPropertyFilter, type HandledErrorReportContext, InMemoryTelemetryBusAdapter, InitializePostHogBrowserAnalyticsInput, Journey, MemberActivationFailedTelemetryEventSchema, MemberActivationReadyTelemetryEventSchema, MemberActivationStartedTelemetryEventSchema, MovementScanCheckpointTelemetryEventSchema, MovementScanIncidentTelemetryEventSchema, MovementScanWindowTelemetryEventSchema, NonEmptyTelemetryEventNames, OnboardingDashboardReachedTelemetryEventSchema, OnboardingIntentSelectedTelemetryEventSchema, OnboardingOrganizationSubmittedTelemetryEventSchema, OnboardingProfileSubmittedTelemetryEventSchema, OperationRetriedTelemetryEventSchema, OrgCreateFailedTelemetryEventSchema, OrgCreateStartedTelemetryEventSchema, OrgCreatedTelemetryEventSchema, OrgInviteAcceptedTelemetryEventSchema, OrgInviteExpiredTelemetryEventSchema, OrgInviteSentTelemetryEventSchema, OrgRolesSeededTelemetryEventSchema, OrgSafeConfirmedTelemetryEventSchema, OrgSafeCreatedTelemetryEventSchema, OrganizationCreationFailedTelemetryEventSchema, OrganizationCreationReadyTelemetryEventSchema, OrganizationCreationStartedTelemetryEventSchema, PII, PRODUCT_MAPPER_GATED_TELEMETRY_EVENTS, PaymentFailedTelemetryEventSchema, PaymentInitiatedTelemetryEventSchema, PaymentSettledTelemetryEventSchema, PaymentVerificationRetryTelemetryEventSchema, PermissionMirrorVerificationTelemetryEventSchema, PointEventJourney, PostHogBeforeSend, PostHogBrowserCapture, PostHogBrowserInitialize, PostHogBrowserOptions, PostHogBrowserPageviewClient, PostHogProductAppOptions, PostHogTelemetryAdapter, PostHogUtilityAppOptions, ProvisioningSafeConfirmedTelemetryEventSchema, ProvisioningSafeCreatedTelemetryEventSchema, ReceiptPendingTelemetryEventSchema, RecordingTelemetryAdapter, SYNCABLE_CAPXUL_ENVS, TELEMETRY_EVENT_NAMES, TELEMETRY_EVENT_SCHEMAS, TELEMETRY_JOURNEYS, TELEMETRY_PRODUCERS, TelemetryEnvelopeDefaults, TelemetryEvent, TelemetryEventName, TelemetryGroupInput, TelemetryIdentifyInput, type TelemetryPort, TelemetryProducer, TelemetryProps, TelemetryRedactionOptions, TrackHandler, createCapxulBeforeSend, createPostHogBrowserPageviewTracker, getTrackHandler, initializeCapxulBrowserAnalytics, initializePostHogBrowserAnalytics, maskCapturedNetworkRequest, productAppAnalytics, redactTelemetryEvent, redactTelemetryProps, sanitizePostHogBrowserEvent, setTrackHandler, stampTelemetryEnvelope, track, utilityAppAnalytics };

package/dist/index.mjs

@@ -1,4 +1,35 @@
 import { Effect, Schema, SchemaGetter } from "effect";
+//#region ../errors/src/chain-cause.ts
+/**
+* Why an operation failed — the one flat vocabulary. The first four are the
+* auth/provider diagnoses that predate this file. The rest name the chain
+* path. `FailureMode` is derived from this list so a runtime membership check
+* (the SDK's `$exception` projection, the observability schema) and the type
+* can never drift apart.
+*/
+const FAILURE_MODES = [
+	"auth-origin-mismatch",
+	"stale-openfort-cache",
+	"app-env-allowlist",
+	"no-secure-context",
+	"rate-limited",
+	"timeout",
+	"upstream-down",
+	"revert",
+	"insufficient-balance",
+	"insufficient-allowance",
+	"rejected",
+	"unauthorized",
+	"unknown"
+];
+/** Who answered. `alto` is the bundler; `gateway` is the AA gateway's own logic. */
+const CHAIN_UPSTREAMS = [
+	"alchemy",
+	"infura",
+	"public",
+	"alto",
+	"gateway"
+];
 new Set([
 	"NOT_AUTHENTICATED",
 	"EMAIL_DELIVERY_FAILED",
@@ -87,7 +118,10 @@ const TELEMETRY_EVENT_NAMES = [
 	"organization_creation_started",
 	"organization_creation_ready",
 	"organization_creation_failed",
-	"aa_gateway_upstream_fallback",
+	"chain_upstream_fallback",
+	"bundler_error",
+	"receipt_pending",
+	"operation_retried",
 	"account_balance_read",
 	"account_balance_failed",
 	"faucet_requested",
@@ -105,6 +139,7 @@ const TELEMETRY_EVENT_NAMES = [
 	"payment_initiated",
 	"payment_settled",
 	"payment_failed",
+	"payment_verification_retry",
 	"deposit_initiated",
 	"deposit_settled",
 	"permission_mirror_verification",
@@ -371,6 +406,26 @@ const TelemetryEnvelopeProps = {
 	sdk_version: OptionalString
 };
 /**
+* The cause of a failure, flat (ADR-0023 R7–R8). `failure_mode` is the one
+* word from `@capxul/errors`; the `chain_*` keys are the `ChainCause` when the
+* failure came from the chain path. Spread into every failure event and posted
+* on `$exception`, so one PostHog filter finds a cause wherever it was seen.
+*/
+const FailureModeSchema = Schema.Literals(FAILURE_MODES);
+const ChainUpstreamSchema = Schema.Literals(CHAIN_UPSTREAMS);
+const ChainCauseTelemetryProps = {
+	failure_mode: Schema.optional(FailureModeSchema),
+	chain_upstream: Schema.optional(ChainUpstreamSchema),
+	chain_method: OptionalString,
+	chain_retryable: Schema.optional(Schema.Boolean),
+	chain_http_status: Schema.optional(Schema.Number),
+	chain_rpc_code: Schema.optional(Schema.Number),
+	chain_revert_name: OptionalString,
+	chain_revert_selector: OptionalString,
+	chain_revert_args: Schema.optional(Schema.Record(Schema.String, Schema.String)),
+	chain_provider_message: OptionalString
+};
+/**
 * Stamp the required envelope onto an event at its emit boundary. Call-site
 * props win on conflict: a relay that already knows the true producer (the
 * browser-failure relay stamps `browser` while running on the server) must not
@@ -408,6 +463,7 @@ const AuthVerifiedProps = Schema.Struct({
 });
 const AuthFailedProps = Schema.Struct({
 	...TelemetryEnvelopeProps,
+	...ChainCauseTelemetryProps,
 	email: Schema.optional(PII),
 	auth_type: OptionalString,
 	reason: OptionalString
@@ -437,6 +493,7 @@ const BootstrapResolvedProps = Schema.Struct({
 });
 const BootstrapFailedProps = Schema.Struct({
 	...TelemetryEnvelopeProps,
+	...ChainCauseTelemetryProps,
 	applicationId: OptionalAppId,
 	durationMs: OptionalDurationMs,
 	origin: OptionalString,
@@ -451,6 +508,7 @@ const AccountBalanceReadProps = Schema.Struct({
 });
 const AccountBalanceFailedProps = Schema.Struct({
 	...TelemetryEnvelopeProps,
+	...ChainCauseTelemetryProps,
 	reason: OptionalString
 });
 const FaucetRequestedProps = Schema.Struct({
@@ -467,29 +525,45 @@ const FaucetConfirmedProps = Schema.Struct({
 });
 const FaucetFailedProps = Schema.Struct({
 	...TelemetryEnvelopeProps,
+	...ChainCauseTelemetryProps,
 	reason: OptionalString
 });
-const AaGatewayUpstreamFallbackProps = Schema.Struct({
+const ChainServiceSchema = Schema.Literals(["aa-gateway", "backend"]);
+const ChainUpstreamFallbackProps = Schema.Struct({
 	...TelemetryEnvelopeProps,
+	service: ChainServiceSchema,
 	method: Schema.String,
-	from_upstream: Schema.Literals([
-		"alchemy",
-		"infura",
-		"public"
-	]),
-	to_upstream: Schema.optional(Schema.Literals([
-		"alchemy",
-		"infura",
-		"public"
-	])),
-	failure: Schema.Literals([
-		"http-429",
-		"http-5xx",
-		"rpc-rate-limit",
-		"timeout",
-		"network"
-	]),
-	status: Schema.optional(Schema.Number)
+	from_upstream: ChainUpstreamSchema,
+	to_upstream: Schema.optional(ChainUpstreamSchema),
+	failure_mode: FailureModeSchema,
+	exhausted: Schema.Boolean,
+	http_status: Schema.optional(Schema.Number),
+	rpc_code: Schema.optional(Schema.Number)
+});
+const BundlerErrorProps = Schema.Struct({
+	...TelemetryEnvelopeProps,
+	method: Schema.String,
+	failure_mode: FailureModeSchema,
+	chain_upstream: ChainUpstreamSchema,
+	chain_retryable: Schema.Boolean,
+	http_status: Schema.optional(Schema.Number),
+	rpc_code: Schema.optional(Schema.Number),
+	chain_revert_name: OptionalString,
+	chain_provider_message: OptionalString
+});
+const ReceiptPendingProps = Schema.Struct({
+	...TelemetryEnvelopeProps,
+	service: ChainServiceSchema,
+	method: Schema.String,
+	chain_upstream: ChainUpstreamSchema,
+	reason: Schema.Literals(["zero_block_hash", "no_receipt"])
+});
+const OperationRetriedProps = Schema.Struct({
+	...TelemetryEnvelopeProps,
+	operation: Schema.String,
+	failure_mode: FailureModeSchema,
+	attempt: Schema.Number,
+	delay_ms: DurationMsSchema
 });
 const ORG_ID_TELEMETRY_RE = /^org_[0-9A-Za-z]+$/;
 const OrgIdTelemetrySchema = Schema.String.pipe(Schema.refine((value) => ORG_ID_TELEMETRY_RE.test(value), { message: "must be org_ plus an alphanumeric id" }));
@@ -515,6 +589,7 @@ const MemberActivationReadyProps = Schema.Struct({
 });
 const MemberActivationFailedProps = Schema.Struct({
 	...TelemetryEnvelopeProps,
+	...ChainCauseTelemetryProps,
 	$insert_id: Schema.String,
 	stage: OnboardingStageSchema,
 	error_code: Schema.String,
@@ -535,6 +610,7 @@ const OrganizationCreationReadyProps = Schema.Struct({
 });
 const OrganizationCreationFailedProps = Schema.Struct({
 	...TelemetryEnvelopeProps,
+	...ChainCauseTelemetryProps,
 	$insert_id: Schema.String,
 	organization_id: OrgIdTelemetrySchema,
 	attempt_number: AttemptNumberSchema,
@@ -614,6 +690,7 @@ const OrgCreatedProps = Schema.Struct({
 });
 const OrgCreateFailedProps = Schema.Struct({
 	...TelemetryEnvelopeProps,
+	...ChainCauseTelemetryProps,
 	org_id: OptionalOrgId,
 	reason: OptionalString
 });
@@ -651,10 +728,18 @@ const PaymentSettledL2Props = Schema.Struct({
 });
 const PaymentFailedL2Props = Schema.Struct({
 	...TelemetryEnvelopeProps,
+	...ChainCauseTelemetryProps,
 	kind: Schema.String,
 	payment_id: Schema.String,
 	reason_code: Schema.String
 });
+const PaymentVerificationRetryProps = Schema.Struct({
+	...TelemetryEnvelopeProps,
+	command_id: Schema.String,
+	attempt: Schema.Number,
+	reason_code: Schema.String,
+	chain_id: Schema.Number
+});
 const DepositInitiatedProps = Schema.Struct({ ...TelemetryEnvelopeProps });
 const DepositSettledProps = Schema.Struct({
 	...TelemetryEnvelopeProps,
@@ -793,9 +878,21 @@ const FaucetFailedTelemetryEventSchema = Schema.Struct({
 	name: Schema.Literal("faucet_failed"),
 	props: FaucetFailedProps
 });
-const AaGatewayUpstreamFallbackTelemetryEventSchema = Schema.Struct({
-	name: Schema.Literal("aa_gateway_upstream_fallback"),
-	props: AaGatewayUpstreamFallbackProps
+const ChainUpstreamFallbackTelemetryEventSchema = Schema.Struct({
+	name: Schema.Literal("chain_upstream_fallback"),
+	props: ChainUpstreamFallbackProps
+});
+const BundlerErrorTelemetryEventSchema = Schema.Struct({
+	name: Schema.Literal("bundler_error"),
+	props: BundlerErrorProps
+});
+const ReceiptPendingTelemetryEventSchema = Schema.Struct({
+	name: Schema.Literal("receipt_pending"),
+	props: ReceiptPendingProps
+});
+const OperationRetriedTelemetryEventSchema = Schema.Struct({
+	name: Schema.Literal("operation_retried"),
+	props: OperationRetriedProps
 });
 const OrgCreateStartedTelemetryEventSchema = Schema.Struct({
 	name: Schema.Literal("org_create_started"),
@@ -845,6 +942,10 @@ const PaymentFailedTelemetryEventSchema = Schema.Struct({
 	name: Schema.Literal("payment_failed"),
 	props: PaymentFailedL2Props
 });
+const PaymentVerificationRetryTelemetryEventSchema = Schema.Struct({
+	name: Schema.Literal("payment_verification_retry"),
+	props: PaymentVerificationRetryProps
+});
 const DepositInitiatedTelemetryEventSchema = Schema.Struct({
 	name: Schema.Literal("deposit_initiated"),
 	props: DepositInitiatedProps
@@ -895,7 +996,10 @@ const TELEMETRY_EVENT_SCHEMAS = {
 	faucet_requested: FaucetRequestedTelemetryEventSchema,
 	faucet_confirmed: FaucetConfirmedTelemetryEventSchema,
 	faucet_failed: FaucetFailedTelemetryEventSchema,
-	aa_gateway_upstream_fallback: AaGatewayUpstreamFallbackTelemetryEventSchema,
+	chain_upstream_fallback: ChainUpstreamFallbackTelemetryEventSchema,
+	bundler_error: BundlerErrorTelemetryEventSchema,
+	receipt_pending: ReceiptPendingTelemetryEventSchema,
+	operation_retried: OperationRetriedTelemetryEventSchema,
 	org_create_started: OrgCreateStartedTelemetryEventSchema,
 	org_safe_created: OrgSafeCreatedTelemetryEventSchema,
 	org_safe_confirmed: OrgSafeConfirmedTelemetryEventSchema,
@@ -908,6 +1012,7 @@ const TELEMETRY_EVENT_SCHEMAS = {
 	payment_initiated: PaymentInitiatedTelemetryEventSchema,
 	payment_settled: PaymentSettledTelemetryEventSchema,
 	payment_failed: PaymentFailedTelemetryEventSchema,
+	payment_verification_retry: PaymentVerificationRetryTelemetryEventSchema,
 	deposit_initiated: DepositInitiatedTelemetryEventSchema,
 	deposit_settled: DepositSettledTelemetryEventSchema,
 	permission_mirror_verification: PermissionMirrorVerificationTelemetryEventSchema,
@@ -1504,4 +1609,4 @@ function rotr(value, bits) {
 	return value >>> bits | value << 32 - bits;
 }
 //#endregion
-export { AaGatewayUpstreamFallbackTelemetryEventSchema, AccountBalanceFailedTelemetryEventSchema, AccountBalanceReadTelemetryEventSchema, AuthFailedTelemetryEventSchema, AuthOtpDeliveredTelemetryEventSchema, AuthOtpExpiredTelemetryEventSchema, AuthOtpRequestedTelemetryEventSchema, AuthSignedOutTelemetryEventSchema, AuthVerifiedTelemetryEventSchema, BROWSER_GATED_TELEMETRY_EVENTS, BootstrapFailedTelemetryEventSchema, BootstrapResolvedTelemetryEventSchema, CAPXUL_ENVS, CONTRACT_FIRST_TELEMETRY_EVENTS, DepositInitiatedTelemetryEventSchema, DepositSettledTelemetryEventSchema, FINANCIAL_OPS_TARGET_TELEMETRY_PRODUCERS, FaucetConfirmedTelemetryEventSchema, FaucetFailedTelemetryEventSchema, FaucetRequestedTelemetryEventSchema, InMemoryTelemetryBusAdapter, MemberActivationFailedTelemetryEventSchema, MemberActivationReadyTelemetryEventSchema, MemberActivationStartedTelemetryEventSchema, MovementScanCheckpointTelemetryEventSchema, MovementScanIncidentTelemetryEventSchema, MovementScanWindowTelemetryEventSchema, OnboardingDashboardReachedTelemetryEventSchema, OnboardingIntentSelectedTelemetryEventSchema, OnboardingOrganizationSubmittedTelemetryEventSchema, OnboardingProfileSubmittedTelemetryEventSchema, OrgCreateFailedTelemetryEventSchema, OrgCreateStartedTelemetryEventSchema, OrgCreatedTelemetryEventSchema, OrgInviteAcceptedTelemetryEventSchema, OrgInviteExpiredTelemetryEventSchema, OrgInviteSentTelemetryEventSchema, OrgRolesSeededTelemetryEventSchema, OrgSafeConfirmedTelemetryEventSchema, OrgSafeCreatedTelemetryEventSchema, OrganizationCreationFailedTelemetryEventSchema, OrganizationCreationReadyTelemetryEventSchema, OrganizationCreationStartedTelemetryEventSchema, PII, PRODUCT_MAPPER_GATED_TELEMETRY_EVENTS, PaymentFailedTelemetryEventSchema, PaymentInitiatedTelemetryEventSchema, PaymentSettledTelemetryEventSchema, PermissionMirrorVerificationTelemetryEventSchema, PostHogTelemetryAdapter, ProvisioningSafeConfirmedTelemetryEventSchema, ProvisioningSafeCreatedTelemetryEventSchema, RecordingTelemetryAdapter, SYNCABLE_CAPXUL_ENVS, TELEMETRY_EVENT_NAMES, TELEMETRY_EVENT_SCHEMAS, TELEMETRY_JOURNEYS, TELEMETRY_PRODUCERS, createCapxulBeforeSend, createPostHogBrowserPageviewTracker, getTrackHandler, initializeCapxulBrowserAnalytics, initializePostHogBrowserAnalytics, maskCapturedNetworkRequest, productAppAnalytics, redactTelemetryEvent, redactTelemetryProps, sanitizePostHogBrowserEvent, setTrackHandler, stampTelemetryEnvelope, track, utilityAppAnalytics };
+export { AccountBalanceFailedTelemetryEventSchema, AccountBalanceReadTelemetryEventSchema, AuthFailedTelemetryEventSchema, AuthOtpDeliveredTelemetryEventSchema, AuthOtpExpiredTelemetryEventSchema, AuthOtpRequestedTelemetryEventSchema, AuthSignedOutTelemetryEventSchema, AuthVerifiedTelemetryEventSchema, BROWSER_GATED_TELEMETRY_EVENTS, BootstrapFailedTelemetryEventSchema, BootstrapResolvedTelemetryEventSchema, BundlerErrorTelemetryEventSchema, CAPXUL_ENVS, CONTRACT_FIRST_TELEMETRY_EVENTS, ChainUpstreamFallbackTelemetryEventSchema, ChainUpstreamSchema, DepositInitiatedTelemetryEventSchema, DepositSettledTelemetryEventSchema, FINANCIAL_OPS_TARGET_TELEMETRY_PRODUCERS, FailureModeSchema, FaucetConfirmedTelemetryEventSchema, FaucetFailedTelemetryEventSchema, FaucetRequestedTelemetryEventSchema, InMemoryTelemetryBusAdapter, MemberActivationFailedTelemetryEventSchema, MemberActivationReadyTelemetryEventSchema, MemberActivationStartedTelemetryEventSchema, MovementScanCheckpointTelemetryEventSchema, MovementScanIncidentTelemetryEventSchema, MovementScanWindowTelemetryEventSchema, OnboardingDashboardReachedTelemetryEventSchema, OnboardingIntentSelectedTelemetryEventSchema, OnboardingOrganizationSubmittedTelemetryEventSchema, OnboardingProfileSubmittedTelemetryEventSchema, OperationRetriedTelemetryEventSchema, OrgCreateFailedTelemetryEventSchema, OrgCreateStartedTelemetryEventSchema, OrgCreatedTelemetryEventSchema, OrgInviteAcceptedTelemetryEventSchema, OrgInviteExpiredTelemetryEventSchema, OrgInviteSentTelemetryEventSchema, OrgRolesSeededTelemetryEventSchema, OrgSafeConfirmedTelemetryEventSchema, OrgSafeCreatedTelemetryEventSchema, OrganizationCreationFailedTelemetryEventSchema, OrganizationCreationReadyTelemetryEventSchema, OrganizationCreationStartedTelemetryEventSchema, PII, PRODUCT_MAPPER_GATED_TELEMETRY_EVENTS, PaymentFailedTelemetryEventSchema, PaymentInitiatedTelemetryEventSchema, PaymentSettledTelemetryEventSchema, PaymentVerificationRetryTelemetryEventSchema, PermissionMirrorVerificationTelemetryEventSchema, PostHogTelemetryAdapter, ProvisioningSafeConfirmedTelemetryEventSchema, ProvisioningSafeCreatedTelemetryEventSchema, ReceiptPendingTelemetryEventSchema, RecordingTelemetryAdapter, SYNCABLE_CAPXUL_ENVS, TELEMETRY_EVENT_NAMES, TELEMETRY_EVENT_SCHEMAS, TELEMETRY_JOURNEYS, TELEMETRY_PRODUCERS, createCapxulBeforeSend, createPostHogBrowserPageviewTracker, getTrackHandler, initializeCapxulBrowserAnalytics, initializePostHogBrowserAnalytics, maskCapturedNetworkRequest, productAppAnalytics, redactTelemetryEvent, redactTelemetryProps, sanitizePostHogBrowserEvent, setTrackHandler, stampTelemetryEnvelope, track, utilityAppAnalytics };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capxul/observability",
-  "version": "2.5.5",
+  "version": "2.6.0",
   "private": false,
   "repository": {
     "type": "git",