@agent-finops/core 0.8.1 → 0.9.0

package/dist/activitySnapshot.d.ts

@@ -41,6 +41,18 @@ export type ActivitySnapshotBuildInput = {
     /** Explicit provider-billed overage records; must also be trusted. */
     billedOverageRecordIds?: readonly string[];
     providerCoverage?: readonly ActivitySnapshotProviderCoverageInput[];
+    /**
+     * C-lane §2.1: provider-billed subscriptions with no local agent (cursor).
+     * The builder includes a billed30d amount only when the supplied window is
+     * "verified"; anything else is degraded to a missing window (writer-side
+     * lock — the renderer re-checks independently).
+     */
+    providerSubscriptions?: readonly {
+        provider: ActivitySnapshotProvider;
+        planLabel: string | null;
+        committedUsdPerMonth: number | null;
+        billed30d?: ActivitySnapshotBilledWindow;
+    }[];
     pricingAsOf?: string;
     /** Deliberately accepts only false; a runtime true is rejected as defense in depth. */
     sampleData?: false;
@@ -54,9 +66,9 @@ export declare const activitySnapshotApiEquivalentWindowSchema: z.ZodObject<{
         missing: "missing";
     }>;
     coverage: z.ZodEnum<{
+        missing: "missing";
         complete: "complete";
         partial: "partial";
-        missing: "missing";
     }>;
 }, z.core.$strict>;
 export type ActivitySnapshotApiEquivalentWindow = z.infer<typeof activitySnapshotApiEquivalentWindowSchema>;
@@ -65,13 +77,13 @@ export declare const activitySnapshotBilledWindowSchema: z.ZodObject<{
     recordCount: z.ZodNumber;
     basis: z.ZodLiteral<"provider_billed">;
     financialEvidence: z.ZodEnum<{
-        missing: "missing";
         verified: "verified";
+        missing: "missing";
     }>;
     coverage: z.ZodEnum<{
+        missing: "missing";
         complete: "complete";
         partial: "partial";
-        missing: "missing";
     }>;
 }, z.core.$strict>;
 export type ActivitySnapshotBilledWindow = z.infer<typeof activitySnapshotBilledWindowSchema>;
@@ -85,9 +97,9 @@ export declare const activitySnapshotApiEquivalentWindowsSchema: z.ZodObject<{
             missing: "missing";
         }>;
         coverage: z.ZodEnum<{
+            missing: "missing";
             complete: "complete";
             partial: "partial";
-            missing: "missing";
         }>;
     }, z.core.$strict>;
     sevenDays: z.ZodObject<{
@@ -99,9 +111,9 @@ export declare const activitySnapshotApiEquivalentWindowsSchema: z.ZodObject<{
             missing: "missing";
         }>;
         coverage: z.ZodEnum<{
+            missing: "missing";
             complete: "complete";
             partial: "partial";
-            missing: "missing";
         }>;
     }, z.core.$strict>;
     thirtyDays: z.ZodObject<{
@@ -113,9 +125,9 @@ export declare const activitySnapshotApiEquivalentWindowsSchema: z.ZodObject<{
             missing: "missing";
         }>;
         coverage: z.ZodEnum<{
+            missing: "missing";
             complete: "complete";
             partial: "partial";
-            missing: "missing";
         }>;
     }, z.core.$strict>;
 }, z.core.$strict>;
@@ -126,13 +138,13 @@ export declare const activitySnapshotBilledWindowsSchema: z.ZodObject<{
         recordCount: z.ZodNumber;
         basis: z.ZodLiteral<"provider_billed">;
         financialEvidence: z.ZodEnum<{
-            missing: "missing";
             verified: "verified";
+            missing: "missing";
         }>;
         coverage: z.ZodEnum<{
+            missing: "missing";
             complete: "complete";
             partial: "partial";
-            missing: "missing";
         }>;
     }, z.core.$strict>;
     sevenDays: z.ZodObject<{
@@ -140,13 +152,13 @@ export declare const activitySnapshotBilledWindowsSchema: z.ZodObject<{
         recordCount: z.ZodNumber;
         basis: z.ZodLiteral<"provider_billed">;
         financialEvidence: z.ZodEnum<{
-            missing: "missing";
             verified: "verified";
+            missing: "missing";
         }>;
         coverage: z.ZodEnum<{
+            missing: "missing";
             complete: "complete";
             partial: "partial";
-            missing: "missing";
         }>;
     }, z.core.$strict>;
     thirtyDays: z.ZodObject<{
@@ -154,13 +166,13 @@ export declare const activitySnapshotBilledWindowsSchema: z.ZodObject<{
         recordCount: z.ZodNumber;
         basis: z.ZodLiteral<"provider_billed">;
         financialEvidence: z.ZodEnum<{
-            missing: "missing";
             verified: "verified";
+            missing: "missing";
         }>;
         coverage: z.ZodEnum<{
+            missing: "missing";
             complete: "complete";
             partial: "partial";
-            missing: "missing";
         }>;
     }, z.core.$strict>;
 }, z.core.$strict>;
@@ -181,12 +193,13 @@ export declare const activitySnapshotSubscriptionAgentSchema: z.ZodObject<{
     agent: z.ZodString & z.ZodType<ActivitySnapshotAgent, string, z.core.$ZodTypeInternals<ActivitySnapshotAgent, string>>;
     billing: z.ZodLiteral<"subscription">;
     planId: z.ZodNullable<z.ZodEnum<{
-        "claude-pro": "claude-pro";
-        "claude-max-5x": "claude-max-5x";
         "claude-max-20x": "claude-max-20x";
+        "claude-max-5x": "claude-max-5x";
+        "claude-pro": "claude-pro";
         "chatgpt-plus": "chatgpt-plus";
         "chatgpt-pro": "chatgpt-pro";
     }>>;
+    committedUsdPerMonth: z.ZodNullable<z.ZodNumber>;
     apiEquivalent: z.ZodObject<{
         oneDay: z.ZodObject<{
             amountUsd: z.ZodNullable<z.ZodNumber>;
@@ -197,9 +210,9 @@ export declare const activitySnapshotSubscriptionAgentSchema: z.ZodObject<{
                 missing: "missing";
             }>;
             coverage: z.ZodEnum<{
+                missing: "missing";
                 complete: "complete";
                 partial: "partial";
-                missing: "missing";
             }>;
         }, z.core.$strict>;
         sevenDays: z.ZodObject<{
@@ -211,9 +224,9 @@ export declare const activitySnapshotSubscriptionAgentSchema: z.ZodObject<{
                 missing: "missing";
             }>;
             coverage: z.ZodEnum<{
+                missing: "missing";
                 complete: "complete";
                 partial: "partial";
-                missing: "missing";
             }>;
         }, z.core.$strict>;
         thirtyDays: z.ZodObject<{
@@ -225,9 +238,9 @@ export declare const activitySnapshotSubscriptionAgentSchema: z.ZodObject<{
                 missing: "missing";
             }>;
             coverage: z.ZodEnum<{
+                missing: "missing";
                 complete: "complete";
                 partial: "partial";
-                missing: "missing";
             }>;
         }, z.core.$strict>;
     }, z.core.$strict>;
@@ -247,6 +260,47 @@ export declare const activitySnapshotSubscriptionAgentSchema: z.ZodObject<{
     }>>;
 }, z.core.$strict>;
 export type ActivitySnapshotSubscriptionAgent = z.infer<typeof activitySnapshotSubscriptionAgentSchema>;
+/**
+ * C-lane §2.1: a provider-billed subscription with no local agent (cursor
+ * today). The writer includes a billed30d amount ONLY when its financial
+ * evidence is "verified"; the renderer independently drops anything else
+ * (double lock: estimated/unverified provider dollars can never reach a
+ * statusline segment).
+ */
+export declare const activitySnapshotProviderSubscriptionSchema: z.ZodObject<{
+    provider: z.ZodEnum<{
+        anthropic: "anthropic";
+        openai: "openai";
+        cursor: "cursor";
+        other: "other";
+        "github-copilot": "github-copilot";
+    }>;
+    billing: z.ZodLiteral<"subscription">;
+    planLabel: z.ZodNullable<z.ZodString>;
+    committedUsdPerMonth: z.ZodNullable<z.ZodNumber>;
+    billed30d: z.ZodObject<{
+        amountUsd: z.ZodNullable<z.ZodNumber>;
+        recordCount: z.ZodNumber;
+        basis: z.ZodLiteral<"provider_billed">;
+        financialEvidence: z.ZodEnum<{
+            verified: "verified";
+            missing: "missing";
+        }>;
+        coverage: z.ZodEnum<{
+            missing: "missing";
+            complete: "complete";
+            partial: "partial";
+        }>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type ActivitySnapshotProviderSubscription = z.infer<typeof activitySnapshotProviderSubscriptionSchema>;
+/** C-lane §2.1: the committed $/mo total across every detected subscription. */
+export declare const activitySnapshotCommittedTotalSchema: z.ZodObject<{
+    amountUsd: z.ZodNullable<z.ZodNumber>;
+    pricedSubs: z.ZodNumber;
+    totalSubs: z.ZodNumber;
+}, z.core.$strict>;
+export type ActivitySnapshotCommittedTotal = z.infer<typeof activitySnapshotCommittedTotalSchema>;
 export declare const activitySnapshotOverageSchema: z.ZodObject<{
     amountUsd: z.ZodNumber;
     currency: z.ZodLiteral<"USD">;
@@ -276,17 +330,17 @@ export declare const activitySnapshotCoverageSchema: z.ZodObject<{
         nonFinancialBytesPrefiltered: z.ZodNumber;
         jsonlValidationCoverage: z.ZodEnum<{
             complete: "complete";
-            financial_events_only: "financial_events_only";
             not_reported: "not_reported";
+            financial_events_only: "financial_events_only";
         }>;
     }, z.core.$strict>>;
     providers: z.ZodArray<z.ZodObject<{
         provider: z.ZodEnum<{
-            openai: "openai";
             anthropic: "anthropic";
+            openai: "openai";
             cursor: "cursor";
-            "github-copilot": "github-copilot";
             other: "other";
+            "github-copilot": "github-copilot";
         }>;
         status: z.ZodEnum<{
             error: "error";
@@ -320,7 +374,7 @@ export declare const activitySnapshotCoverageSchema: z.ZodObject<{
 export type ActivitySnapshotCoverage = z.infer<typeof activitySnapshotCoverageSchema>;
 export declare const activitySnapshotSchema: z.ZodObject<{
     kind: z.ZodLiteral<"aibill.activity_snapshot">;
-    schemaVersion: z.ZodLiteral<1>;
+    schemaVersion: z.ZodLiteral<2>;
     currency: z.ZodLiteral<"USD">;
     asOf: z.ZodString;
     generatedAt: z.ZodString;
@@ -331,33 +385,34 @@ export declare const activitySnapshotSchema: z.ZodObject<{
     }, z.core.$strict>, z.ZodObject<{
         status: z.ZodLiteral<"error">;
         errorCode: z.ZodEnum<{
+            unknown: "unknown";
+            timeout: "timeout";
             scan_failed: "scan_failed";
             source_unreadable: "source_unreadable";
             invalid_evidence: "invalid_evidence";
-            timeout: "timeout";
             cache_write_failed: "cache_write_failed";
-            unknown: "unknown";
         }>;
     }, z.core.$strict>], "status">;
     mode: z.ZodEnum<{
-        metered: "metered";
+        error: "error";
+        empty: "empty";
         subscription: "subscription";
+        metered: "metered";
         mixed: "mixed";
         unresolved: "unresolved";
-        empty: "empty";
-        error: "error";
     }>;
     subscription: z.ZodNullable<z.ZodObject<{
         agents: z.ZodArray<z.ZodObject<{
             agent: z.ZodString & z.ZodType<ActivitySnapshotAgent, string, z.core.$ZodTypeInternals<ActivitySnapshotAgent, string>>;
             billing: z.ZodLiteral<"subscription">;
             planId: z.ZodNullable<z.ZodEnum<{
-                "claude-pro": "claude-pro";
-                "claude-max-5x": "claude-max-5x";
                 "claude-max-20x": "claude-max-20x";
+                "claude-max-5x": "claude-max-5x";
+                "claude-pro": "claude-pro";
                 "chatgpt-plus": "chatgpt-plus";
                 "chatgpt-pro": "chatgpt-pro";
             }>>;
+            committedUsdPerMonth: z.ZodNullable<z.ZodNumber>;
             apiEquivalent: z.ZodObject<{
                 oneDay: z.ZodObject<{
                     amountUsd: z.ZodNullable<z.ZodNumber>;
@@ -368,9 +423,9 @@ export declare const activitySnapshotSchema: z.ZodObject<{
                         missing: "missing";
                     }>;
                     coverage: z.ZodEnum<{
+                        missing: "missing";
                         complete: "complete";
                         partial: "partial";
-                        missing: "missing";
                     }>;
                 }, z.core.$strict>;
                 sevenDays: z.ZodObject<{
@@ -382,9 +437,9 @@ export declare const activitySnapshotSchema: z.ZodObject<{
                         missing: "missing";
                     }>;
                     coverage: z.ZodEnum<{
+                        missing: "missing";
                         complete: "complete";
                         partial: "partial";
-                        missing: "missing";
                     }>;
                 }, z.core.$strict>;
                 thirtyDays: z.ZodObject<{
@@ -396,9 +451,9 @@ export declare const activitySnapshotSchema: z.ZodObject<{
                         missing: "missing";
                     }>;
                     coverage: z.ZodEnum<{
+                        missing: "missing";
                         complete: "complete";
                         partial: "partial";
-                        missing: "missing";
                     }>;
                 }, z.core.$strict>;
             }, z.core.$strict>;
@@ -423,9 +478,9 @@ export declare const activitySnapshotSchema: z.ZodObject<{
             agent: z.ZodString & z.ZodType<ActivitySnapshotAgent, string, z.core.$ZodTypeInternals<ActivitySnapshotAgent, string>>;
             billing: z.ZodLiteral<"api_key">;
             planId: z.ZodNullable<z.ZodEnum<{
-                "claude-pro": "claude-pro";
-                "claude-max-5x": "claude-max-5x";
                 "claude-max-20x": "claude-max-20x";
+                "claude-max-5x": "claude-max-5x";
+                "claude-pro": "claude-pro";
                 "chatgpt-plus": "chatgpt-plus";
                 "chatgpt-pro": "chatgpt-pro";
             }>>;
@@ -440,9 +495,9 @@ export declare const activitySnapshotSchema: z.ZodObject<{
                     missing: "missing";
                 }>;
                 coverage: z.ZodEnum<{
+                    missing: "missing";
                     complete: "complete";
                     partial: "partial";
-                    missing: "missing";
                 }>;
             }, z.core.$strict>;
             sevenDays: z.ZodObject<{
@@ -454,9 +509,9 @@ export declare const activitySnapshotSchema: z.ZodObject<{
                     missing: "missing";
                 }>;
                 coverage: z.ZodEnum<{
+                    missing: "missing";
                     complete: "complete";
                     partial: "partial";
-                    missing: "missing";
                 }>;
             }, z.core.$strict>;
             thirtyDays: z.ZodObject<{
@@ -468,9 +523,9 @@ export declare const activitySnapshotSchema: z.ZodObject<{
                     missing: "missing";
                 }>;
                 coverage: z.ZodEnum<{
+                    missing: "missing";
                     complete: "complete";
                     partial: "partial";
-                    missing: "missing";
                 }>;
             }, z.core.$strict>;
         }, z.core.$strict>;
@@ -480,13 +535,13 @@ export declare const activitySnapshotSchema: z.ZodObject<{
                 recordCount: z.ZodNumber;
                 basis: z.ZodLiteral<"provider_billed">;
                 financialEvidence: z.ZodEnum<{
-                    missing: "missing";
                     verified: "verified";
+                    missing: "missing";
                 }>;
                 coverage: z.ZodEnum<{
+                    missing: "missing";
                     complete: "complete";
                     partial: "partial";
-                    missing: "missing";
                 }>;
             }, z.core.$strict>;
             sevenDays: z.ZodObject<{
@@ -494,13 +549,13 @@ export declare const activitySnapshotSchema: z.ZodObject<{
                 recordCount: z.ZodNumber;
                 basis: z.ZodLiteral<"provider_billed">;
                 financialEvidence: z.ZodEnum<{
-                    missing: "missing";
                     verified: "verified";
+                    missing: "missing";
                 }>;
                 coverage: z.ZodEnum<{
+                    missing: "missing";
                     complete: "complete";
                     partial: "partial";
-                    missing: "missing";
                 }>;
             }, z.core.$strict>;
             thirtyDays: z.ZodObject<{
@@ -508,13 +563,13 @@ export declare const activitySnapshotSchema: z.ZodObject<{
                 recordCount: z.ZodNumber;
                 basis: z.ZodLiteral<"provider_billed">;
                 financialEvidence: z.ZodEnum<{
-                    missing: "missing";
                     verified: "verified";
+                    missing: "missing";
                 }>;
                 coverage: z.ZodEnum<{
+                    missing: "missing";
                     complete: "complete";
                     partial: "partial";
-                    missing: "missing";
                 }>;
             }, z.core.$strict>;
         }, z.core.$strict>;
@@ -524,9 +579,9 @@ export declare const activitySnapshotSchema: z.ZodObject<{
             agent: z.ZodString & z.ZodType<ActivitySnapshotAgent, string, z.core.$ZodTypeInternals<ActivitySnapshotAgent, string>>;
             billing: z.ZodLiteral<"unknown">;
             planId: z.ZodNullable<z.ZodEnum<{
-                "claude-pro": "claude-pro";
-                "claude-max-5x": "claude-max-5x";
                 "claude-max-20x": "claude-max-20x";
+                "claude-max-5x": "claude-max-5x";
+                "claude-pro": "claude-pro";
                 "chatgpt-plus": "chatgpt-plus";
                 "chatgpt-pro": "chatgpt-pro";
             }>>;
@@ -541,9 +596,9 @@ export declare const activitySnapshotSchema: z.ZodObject<{
                     missing: "missing";
                 }>;
                 coverage: z.ZodEnum<{
+                    missing: "missing";
                     complete: "complete";
                     partial: "partial";
-                    missing: "missing";
                 }>;
             }, z.core.$strict>;
             sevenDays: z.ZodObject<{
@@ -555,9 +610,9 @@ export declare const activitySnapshotSchema: z.ZodObject<{
                     missing: "missing";
                 }>;
                 coverage: z.ZodEnum<{
+                    missing: "missing";
                     complete: "complete";
                     partial: "partial";
-                    missing: "missing";
                 }>;
             }, z.core.$strict>;
             thirtyDays: z.ZodObject<{
@@ -569,13 +624,44 @@ export declare const activitySnapshotSchema: z.ZodObject<{
                     missing: "missing";
                 }>;
                 coverage: z.ZodEnum<{
+                    missing: "missing";
                     complete: "complete";
                     partial: "partial";
-                    missing: "missing";
                 }>;
             }, z.core.$strict>;
         }, z.core.$strict>;
     }, z.core.$strict>>;
+    providers: z.ZodNullable<z.ZodArray<z.ZodObject<{
+        provider: z.ZodEnum<{
+            anthropic: "anthropic";
+            openai: "openai";
+            cursor: "cursor";
+            other: "other";
+            "github-copilot": "github-copilot";
+        }>;
+        billing: z.ZodLiteral<"subscription">;
+        planLabel: z.ZodNullable<z.ZodString>;
+        committedUsdPerMonth: z.ZodNullable<z.ZodNumber>;
+        billed30d: z.ZodObject<{
+            amountUsd: z.ZodNullable<z.ZodNumber>;
+            recordCount: z.ZodNumber;
+            basis: z.ZodLiteral<"provider_billed">;
+            financialEvidence: z.ZodEnum<{
+                verified: "verified";
+                missing: "missing";
+            }>;
+            coverage: z.ZodEnum<{
+                missing: "missing";
+                complete: "complete";
+                partial: "partial";
+            }>;
+        }, z.core.$strict>;
+    }, z.core.$strict>>>;
+    committedTotal: z.ZodObject<{
+        amountUsd: z.ZodNullable<z.ZodNumber>;
+        pricedSubs: z.ZodNumber;
+        totalSubs: z.ZodNumber;
+    }, z.core.$strict>;
     overage: z.ZodNullable<z.ZodObject<{
         amountUsd: z.ZodNumber;
         currency: z.ZodLiteral<"USD">;
@@ -604,17 +690,17 @@ export declare const activitySnapshotSchema: z.ZodObject<{
             nonFinancialBytesPrefiltered: z.ZodNumber;
             jsonlValidationCoverage: z.ZodEnum<{
                 complete: "complete";
-                financial_events_only: "financial_events_only";
                 not_reported: "not_reported";
+                financial_events_only: "financial_events_only";
             }>;
         }, z.core.$strict>>;
         providers: z.ZodArray<z.ZodObject<{
             provider: z.ZodEnum<{
-                openai: "openai";
                 anthropic: "anthropic";
+                openai: "openai";
                 cursor: "cursor";
-                "github-copilot": "github-copilot";
                 other: "other";
+                "github-copilot": "github-copilot";
             }>;
             status: z.ZodEnum<{
                 error: "error";
@@ -654,6 +740,12 @@ export type ActivitySnapshot = z.infer<typeof activitySnapshotSchema>;
  * IDs already validated by the external connected-state trust receipt.
  */
 export declare function buildActivitySnapshot(input: ActivitySnapshotBuildInput): ActivitySnapshot;
+/**
+ * The v1 dual-write payload (C-lane §2.1 fleet back-compat): today's fields
+ * only, so an already-installed v1 runner keeps rendering fresh data instead
+ * of decaying into permanent staleness. Exact v1 key set; no v2 fields.
+ */
+export declare function activitySnapshotV1Payload(snapshot: ActivitySnapshot): Record<string, unknown>;
 /** A bounded no-evidence state for an initial failed refresh. */
 export declare function createActivitySnapshotError(attemptedAt: string, errorCode: ActivitySnapshotRefreshErrorCode): ActivitySnapshot;
 //# sourceMappingURL=activitySnapshot.d.ts.map