@agent-finops/core 0.8.0 → 0.9.0

package/dist/agentEconomicsReceipt.d.ts

@@ -2,8 +2,8 @@ import { z } from "zod";
 export declare const AGENT_ECONOMICS_RECEIPT_KIND: "aibill.agent_economics_receipt";
 export declare const AGENT_ECONOMICS_RECEIPT_V0_VERSION: "0.1.0";
 declare const financialEvidenceWithAmountSchema: z.ZodEnum<{
-    verified: "verified";
     estimated: "estimated";
+    verified: "verified";
     detected_unverified: "detected_unverified";
 }>;
 export declare const receiptModeValues: readonly ["local", "connected", "mixed", "sample"];
@@ -25,10 +25,10 @@ export declare const receiptSourceKindSchema: z.ZodEnum<{
 export type ReceiptSourceKind = z.infer<typeof receiptSourceKindSchema>;
 export declare const receiptProvenanceOriginValues: readonly ["provider_reported", "locally_observed", "user_declared", "sample"];
 export declare const receiptProvenanceOriginSchema: z.ZodEnum<{
-    sample: "sample";
     provider_reported: "provider_reported";
-    locally_observed: "locally_observed";
     user_declared: "user_declared";
+    sample: "sample";
+    locally_observed: "locally_observed";
 }>;
 export type ReceiptProvenanceOrigin = z.infer<typeof receiptProvenanceOriginSchema>;
 export declare const receiptTransformationValues: readonly ["normalized", "aggregated", "api_rate_estimated"];
@@ -40,9 +40,9 @@ export declare const receiptTransformationSchema: z.ZodEnum<{
 export type ReceiptTransformation = z.infer<typeof receiptTransformationSchema>;
 export declare const receiptAccountingBasisValues: readonly ["provider_billed", "api_equivalent", "user_declared"];
 export declare const receiptAccountingBasisSchema: z.ZodEnum<{
-    api_equivalent: "api_equivalent";
-    provider_billed: "provider_billed";
     user_declared: "user_declared";
+    provider_billed: "provider_billed";
+    api_equivalent: "api_equivalent";
 }>;
 export type ReceiptAccountingBasis = z.infer<typeof receiptAccountingBasisSchema>;
 export declare const receiptMappingGapCodeValues: readonly ["cost_unsplit", "cost_unpriced", "model_unmapped", "provider_unmapped", "source_record_unmapped"];
@@ -124,10 +124,10 @@ export type ReceiptSourceRecordReference = z.infer<typeof receiptSourceRecordRef
 export declare function createReceiptSourceRecordReference(sourceId: string, sourceRecordId: string): ReceiptSourceRecordReference;
 export declare const receiptProvenanceSchema: z.ZodObject<{
     origin: z.ZodEnum<{
-        sample: "sample";
         provider_reported: "provider_reported";
-        locally_observed: "locally_observed";
         user_declared: "user_declared";
+        sample: "sample";
+        locally_observed: "locally_observed";
     }>;
     transformations: z.ZodArray<z.ZodEnum<{
         normalized: "normalized";
@@ -147,9 +147,9 @@ export declare const receiptTokenUsageLineSchema: z.ZodObject<{
     sourceId: z.ZodString;
     observedAt: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
     granularity: z.ZodEnum<{
+        session: "session";
         call: "call";
         invocation: "invocation";
-        session: "session";
         daily_aggregate: "daily_aggregate";
         usage_bucket: "usage_bucket";
         billing_bucket: "billing_bucket";
@@ -158,10 +158,10 @@ export declare const receiptTokenUsageLineSchema: z.ZodObject<{
     }>;
     provenance: z.ZodObject<{
         origin: z.ZodEnum<{
-            sample: "sample";
             provider_reported: "provider_reported";
-            locally_observed: "locally_observed";
             user_declared: "user_declared";
+            sample: "sample";
+            locally_observed: "locally_observed";
         }>;
         transformations: z.ZodArray<z.ZodEnum<{
             normalized: "normalized";
@@ -180,22 +180,22 @@ export declare const receiptFinancialCostLineSchema: z.ZodObject<{
     amountUsd: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
     currency: z.ZodLiteral<"USD">;
     accountingBasis: z.ZodEnum<{
-        api_equivalent: "api_equivalent";
-        provider_billed: "provider_billed";
         user_declared: "user_declared";
+        provider_billed: "provider_billed";
+        api_equivalent: "api_equivalent";
     }>;
     financialEvidence: z.ZodEnum<{
-        verified: "verified";
         estimated: "estimated";
+        verified: "verified";
         detected_unverified: "detected_unverified";
     }>;
     id: z.ZodString;
     sourceId: z.ZodString;
     observedAt: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
     granularity: z.ZodEnum<{
+        session: "session";
         call: "call";
         invocation: "invocation";
-        session: "session";
         daily_aggregate: "daily_aggregate";
         usage_bucket: "usage_bucket";
         billing_bucket: "billing_bucket";
@@ -204,10 +204,10 @@ export declare const receiptFinancialCostLineSchema: z.ZodObject<{
     }>;
     provenance: z.ZodObject<{
         origin: z.ZodEnum<{
-            sample: "sample";
             provider_reported: "provider_reported";
-            locally_observed: "locally_observed";
             user_declared: "user_declared";
+            sample: "sample";
+            locally_observed: "locally_observed";
         }>;
         transformations: z.ZodArray<z.ZodEnum<{
             normalized: "normalized";
@@ -232,9 +232,9 @@ export declare const receiptLineSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     sourceId: z.ZodString;
     observedAt: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
     granularity: z.ZodEnum<{
+        session: "session";
         call: "call";
         invocation: "invocation";
-        session: "session";
         daily_aggregate: "daily_aggregate";
         usage_bucket: "usage_bucket";
         billing_bucket: "billing_bucket";
@@ -243,10 +243,10 @@ export declare const receiptLineSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }>;
     provenance: z.ZodObject<{
         origin: z.ZodEnum<{
-            sample: "sample";
             provider_reported: "provider_reported";
-            locally_observed: "locally_observed";
             user_declared: "user_declared";
+            sample: "sample";
+            locally_observed: "locally_observed";
         }>;
         transformations: z.ZodArray<z.ZodEnum<{
             normalized: "normalized";
@@ -263,22 +263,22 @@ export declare const receiptLineSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     amountUsd: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
     currency: z.ZodLiteral<"USD">;
     accountingBasis: z.ZodEnum<{
-        api_equivalent: "api_equivalent";
-        provider_billed: "provider_billed";
         user_declared: "user_declared";
+        provider_billed: "provider_billed";
+        api_equivalent: "api_equivalent";
     }>;
     financialEvidence: z.ZodEnum<{
-        verified: "verified";
         estimated: "estimated";
+        verified: "verified";
         detected_unverified: "detected_unverified";
     }>;
     id: z.ZodString;
     sourceId: z.ZodString;
     observedAt: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
     granularity: z.ZodEnum<{
+        session: "session";
         call: "call";
         invocation: "invocation";
-        session: "session";
         daily_aggregate: "daily_aggregate";
         usage_bucket: "usage_bucket";
         billing_bucket: "billing_bucket";
@@ -287,10 +287,10 @@ export declare const receiptLineSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }>;
     provenance: z.ZodObject<{
         origin: z.ZodEnum<{
-            sample: "sample";
             provider_reported: "provider_reported";
-            locally_observed: "locally_observed";
             user_declared: "user_declared";
+            sample: "sample";
+            locally_observed: "locally_observed";
         }>;
         transformations: z.ZodArray<z.ZodEnum<{
             normalized: "normalized";
@@ -326,13 +326,13 @@ export declare const receiptMappingGapSchema: z.ZodPipe<z.ZodObject<{
 export type ReceiptMappingGap = z.infer<typeof receiptMappingGapSchema>;
 export declare const receiptCostTotalSchema: z.ZodObject<{
     accountingBasis: z.ZodEnum<{
-        api_equivalent: "api_equivalent";
-        provider_billed: "provider_billed";
         user_declared: "user_declared";
+        provider_billed: "provider_billed";
+        api_equivalent: "api_equivalent";
     }>;
     financialEvidence: z.ZodEnum<{
-        verified: "verified";
         estimated: "estimated";
+        verified: "verified";
         detected_unverified: "detected_unverified";
     }>;
     currency: z.ZodLiteral<"USD">;
@@ -404,9 +404,9 @@ declare const receiptBodyObjectSchema: z.ZodObject<{
         sourceId: z.ZodString;
         observedAt: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
         granularity: z.ZodEnum<{
+            session: "session";
             call: "call";
             invocation: "invocation";
-            session: "session";
             daily_aggregate: "daily_aggregate";
             usage_bucket: "usage_bucket";
             billing_bucket: "billing_bucket";
@@ -415,10 +415,10 @@ declare const receiptBodyObjectSchema: z.ZodObject<{
         }>;
         provenance: z.ZodObject<{
             origin: z.ZodEnum<{
-                sample: "sample";
                 provider_reported: "provider_reported";
-                locally_observed: "locally_observed";
                 user_declared: "user_declared";
+                sample: "sample";
+                locally_observed: "locally_observed";
             }>;
             transformations: z.ZodArray<z.ZodEnum<{
                 normalized: "normalized";
@@ -435,22 +435,22 @@ declare const receiptBodyObjectSchema: z.ZodObject<{
         amountUsd: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
         currency: z.ZodLiteral<"USD">;
         accountingBasis: z.ZodEnum<{
-            api_equivalent: "api_equivalent";
-            provider_billed: "provider_billed";
             user_declared: "user_declared";
+            provider_billed: "provider_billed";
+            api_equivalent: "api_equivalent";
         }>;
         financialEvidence: z.ZodEnum<{
-            verified: "verified";
             estimated: "estimated";
+            verified: "verified";
             detected_unverified: "detected_unverified";
         }>;
         id: z.ZodString;
         sourceId: z.ZodString;
         observedAt: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
         granularity: z.ZodEnum<{
+            session: "session";
             call: "call";
             invocation: "invocation";
-            session: "session";
             daily_aggregate: "daily_aggregate";
             usage_bucket: "usage_bucket";
             billing_bucket: "billing_bucket";
@@ -459,10 +459,10 @@ declare const receiptBodyObjectSchema: z.ZodObject<{
         }>;
         provenance: z.ZodObject<{
             origin: z.ZodEnum<{
-                sample: "sample";
                 provider_reported: "provider_reported";
-                locally_observed: "locally_observed";
                 user_declared: "user_declared";
+                sample: "sample";
+                locally_observed: "locally_observed";
             }>;
             transformations: z.ZodArray<z.ZodEnum<{
                 normalized: "normalized";
@@ -559,9 +559,9 @@ export declare const agentEconomicsReceiptV0DraftSchema: z.ZodObject<{
         sourceId: z.ZodString;
         observedAt: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
         granularity: z.ZodEnum<{
+            session: "session";
             call: "call";
             invocation: "invocation";
-            session: "session";
             daily_aggregate: "daily_aggregate";
             usage_bucket: "usage_bucket";
             billing_bucket: "billing_bucket";
@@ -570,10 +570,10 @@ export declare const agentEconomicsReceiptV0DraftSchema: z.ZodObject<{
         }>;
         provenance: z.ZodObject<{
             origin: z.ZodEnum<{
-                sample: "sample";
                 provider_reported: "provider_reported";
-                locally_observed: "locally_observed";
                 user_declared: "user_declared";
+                sample: "sample";
+                locally_observed: "locally_observed";
             }>;
             transformations: z.ZodArray<z.ZodEnum<{
                 normalized: "normalized";
@@ -590,22 +590,22 @@ export declare const agentEconomicsReceiptV0DraftSchema: z.ZodObject<{
         amountUsd: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
         currency: z.ZodLiteral<"USD">;
         accountingBasis: z.ZodEnum<{
-            api_equivalent: "api_equivalent";
-            provider_billed: "provider_billed";
             user_declared: "user_declared";
+            provider_billed: "provider_billed";
+            api_equivalent: "api_equivalent";
         }>;
         financialEvidence: z.ZodEnum<{
-            verified: "verified";
             estimated: "estimated";
+            verified: "verified";
             detected_unverified: "detected_unverified";
         }>;
         id: z.ZodString;
         sourceId: z.ZodString;
         observedAt: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
         granularity: z.ZodEnum<{
+            session: "session";
             call: "call";
             invocation: "invocation";
-            session: "session";
             daily_aggregate: "daily_aggregate";
             usage_bucket: "usage_bucket";
             billing_bucket: "billing_bucket";
@@ -614,10 +614,10 @@ export declare const agentEconomicsReceiptV0DraftSchema: z.ZodObject<{
         }>;
         provenance: z.ZodObject<{
             origin: z.ZodEnum<{
-                sample: "sample";
                 provider_reported: "provider_reported";
-                locally_observed: "locally_observed";
                 user_declared: "user_declared";
+                sample: "sample";
+                locally_observed: "locally_observed";
             }>;
             transformations: z.ZodArray<z.ZodEnum<{
                 normalized: "normalized";
@@ -716,9 +716,9 @@ export declare const agentEconomicsReceiptV0Schema: z.ZodObject<{
         sourceId: z.ZodString;
         observedAt: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
         granularity: z.ZodEnum<{
+            session: "session";
             call: "call";
             invocation: "invocation";
-            session: "session";
             daily_aggregate: "daily_aggregate";
             usage_bucket: "usage_bucket";
             billing_bucket: "billing_bucket";
@@ -727,10 +727,10 @@ export declare const agentEconomicsReceiptV0Schema: z.ZodObject<{
         }>;
         provenance: z.ZodObject<{
             origin: z.ZodEnum<{
-                sample: "sample";
                 provider_reported: "provider_reported";
-                locally_observed: "locally_observed";
                 user_declared: "user_declared";
+                sample: "sample";
+                locally_observed: "locally_observed";
             }>;
             transformations: z.ZodArray<z.ZodEnum<{
                 normalized: "normalized";
@@ -747,22 +747,22 @@ export declare const agentEconomicsReceiptV0Schema: z.ZodObject<{
         amountUsd: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
         currency: z.ZodLiteral<"USD">;
         accountingBasis: z.ZodEnum<{
-            api_equivalent: "api_equivalent";
-            provider_billed: "provider_billed";
             user_declared: "user_declared";
+            provider_billed: "provider_billed";
+            api_equivalent: "api_equivalent";
         }>;
         financialEvidence: z.ZodEnum<{
-            verified: "verified";
             estimated: "estimated";
+            verified: "verified";
             detected_unverified: "detected_unverified";
         }>;
         id: z.ZodString;
         sourceId: z.ZodString;
         observedAt: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
         granularity: z.ZodEnum<{
+            session: "session";
             call: "call";
             invocation: "invocation";
-            session: "session";
             daily_aggregate: "daily_aggregate";
             usage_bucket: "usage_bucket";
             billing_bucket: "billing_bucket";
@@ -771,10 +771,10 @@ export declare const agentEconomicsReceiptV0Schema: z.ZodObject<{
         }>;
         provenance: z.ZodObject<{
             origin: z.ZodEnum<{
-                sample: "sample";
                 provider_reported: "provider_reported";
-                locally_observed: "locally_observed";
                 user_declared: "user_declared";
+                sample: "sample";
+                locally_observed: "locally_observed";
             }>;
             transformations: z.ZodArray<z.ZodEnum<{
                 normalized: "normalized";
@@ -809,13 +809,13 @@ export declare const agentEconomicsReceiptV0Schema: z.ZodObject<{
     id: z.ZodString;
     costTotals: z.ZodArray<z.ZodObject<{
         accountingBasis: z.ZodEnum<{
-            api_equivalent: "api_equivalent";
-            provider_billed: "provider_billed";
             user_declared: "user_declared";
+            provider_billed: "provider_billed";
+            api_equivalent: "api_equivalent";
         }>;
         financialEvidence: z.ZodEnum<{
-            verified: "verified";
             estimated: "estimated";
+            verified: "verified";
             detected_unverified: "detected_unverified";
         }>;
         currency: z.ZodLiteral<"USD">;

package/dist/analyze.js

@@ -346,6 +346,8 @@ function roundRatio(value) {
     return Math.round(value * 10_000) / 10_000;
 }
 function roundMoney(value) {
-    return Math.round(value * 100) / 100;
+    // Persist fractional-cent evidence instead of turning a real positive amount
+    // into numeric zero. Presentation layers decide whether to show `<$0.01`.
+    return Math.round(value * 10_000) / 10_000;
 }
 //# sourceMappingURL=analyze.js.map

package/dist/cutList.js

@@ -332,6 +332,6 @@ function stableSuffix(value) {
     return (hash >>> 0).toString(36);
 }
 function roundMoney(value) {
-    return Math.round(value * 100) / 100;
+    return Math.round(value * 10_000) / 10_000;
 }
 //# sourceMappingURL=cutList.js.map

package/dist/glance.d.ts

@@ -1,6 +1,7 @@
 import { type LocalAgentActivity, type LocalAgentCall, type LocalAgentLogResult, type LocalAgentRateLimitWindow } from "./localAgentLogs.js";
 import type { DetectedPlan } from "./planDetection.js";
 import { type ContextHealthResult } from "./contextHealth.js";
+import type { ActionVerificationProjectionV0 } from "./actionPlanner.js";
 export type GlanceSession = {
     status: "active" | "recent";
     agent: LocalAgentCall["agent"];
@@ -28,6 +29,8 @@ export type GlanceLimit = {
     observedAt: string;
     resetsAt: string;
     source: "transcript_reported";
+    /** Old transcript evidence remains visible but is never presented as live runway. */
+    freshness: "current" | "stale";
     projectedExhaustionAt: string | null;
     projectedToExhaustBeforeReset: boolean;
     projectionConfidence: "estimated";
@@ -115,6 +118,12 @@ export type GlanceProvenance = {
         execution: "copy_prompt";
         automaticExecution: false;
     };
+    tokenExperiment: {
+        source: "canonical_action_verification_projection" | "not_available";
+        calculation: "core_experiment_evaluator";
+        cohort: "matched_local_sessions";
+        automaticExecution: false;
+    };
     network: {
         uploaded: false;
     };
@@ -124,11 +133,17 @@ export type UsageGlanceSnapshot = {
     generatedAt: string;
     coverage: {
         filesParsed: number;
+        qualitative: {
+            status: "complete" | "partial" | "unknown";
+            selectedFiles: number;
+            readCompletely: number;
+            skippedForBudget: number;
+        };
         supportedTranscriptAgents: Array<LocalAgentCall["agent"]>;
         detectedAgents: Array<LocalAgentCall["agent"]>;
         rateLimitMetadata: Array<{
             agent: LocalAgentCall["agent"];
-            status: "reported" | "not_reported_by_transcript" | "not_seen";
+            status: "reported" | "stale" | "not_reported_by_transcript" | "not_seen";
             windowsReported: Array<LocalAgentRateLimitWindow["kind"]>;
         }>;
         providerConnectionRequired: ["cursor", "github-copilot"];
@@ -139,8 +154,17 @@ export type UsageGlanceSnapshot = {
     limits: GlanceLimit[];
     focus: GlanceFocus | null;
     anomaly: GlanceAnomaly | null;
-    sessionHealth: ContextHealthResult;
+    sessionHealth: ContextHealthResult & {
+        /** Same bounded qualitative-coverage contract returned by the CLI context view. */
+        qualitativeCoverage: UsageGlanceSnapshot["coverage"]["qualitative"];
+    };
     primaryAction: GlancePrimaryAction;
+    /**
+     * Compact, canonical read projection of one locally persisted token test.
+     * The experiment evaluator owns every count, percentage, and evidence label;
+     * Glance only carries this projection and never recalculates it.
+     */
+    tokenExperiment?: ActionVerificationProjectionV0;
     caveats: string[];
 };
 export type BuildUsageGlanceOptions = {
@@ -148,6 +172,8 @@ export type BuildUsageGlanceOptions = {
     activeWithinMinutes?: number;
     focusWindowDays?: number;
     filesParsed?: number;
+    /** Bounded qualitative/action coverage. Partial evidence cannot drive a global focus/action. */
+    qualitativeCoverage?: UsageGlanceSnapshot["coverage"]["qualitative"];
     detectedAgents?: Array<LocalAgentCall["agent"]>;
     /** Locally detected or explicitly declared subscription/API billing modes. */
     detectedPlans?: DetectedPlan[];
@@ -155,6 +181,8 @@ export type BuildUsageGlanceOptions = {
     limitCalls?: LocalAgentCall[];
     /** Canonical result shared with CLI/MCP. Falls back to session-only health. */
     contextHealth?: ContextHealthResult;
+    /** Must come from buildActionVerificationProjectionV0; Glance never evaluates it. */
+    actionVerificationProjection?: ActionVerificationProjectionV0;
 };
 /**
  * Build the read model used by the native Glance surface.