@agent-finops/core 0.8.0 → 0.8.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2,14 +2,14 @@ import { z } from "zod";
2
2
  export declare const AGENT_ECONOMICS_RECEIPT_KIND: "aibill.agent_economics_receipt";
3
3
  export declare const AGENT_ECONOMICS_RECEIPT_V0_VERSION: "0.1.0";
4
4
  declare const financialEvidenceWithAmountSchema: z.ZodEnum<{
5
- verified: "verified";
6
5
  estimated: "estimated";
6
+ verified: "verified";
7
7
  detected_unverified: "detected_unverified";
8
8
  }>;
9
9
  export declare const receiptModeValues: readonly ["local", "connected", "mixed", "sample"];
10
10
  export declare const receiptModeSchema: z.ZodEnum<{
11
- local: "local";
12
11
  mixed: "mixed";
12
+ local: "local";
13
13
  sample: "sample";
14
14
  connected: "connected";
15
15
  }>;
@@ -26,9 +26,9 @@ export type ReceiptSourceKind = z.infer<typeof receiptSourceKindSchema>;
26
26
  export declare const receiptProvenanceOriginValues: readonly ["provider_reported", "locally_observed", "user_declared", "sample"];
27
27
  export declare const receiptProvenanceOriginSchema: z.ZodEnum<{
28
28
  sample: "sample";
29
+ user_declared: "user_declared";
29
30
  provider_reported: "provider_reported";
30
31
  locally_observed: "locally_observed";
31
- user_declared: "user_declared";
32
32
  }>;
33
33
  export type ReceiptProvenanceOrigin = z.infer<typeof receiptProvenanceOriginSchema>;
34
34
  export declare const receiptTransformationValues: readonly ["normalized", "aggregated", "api_rate_estimated"];
@@ -57,9 +57,9 @@ export type ReceiptMappingGapCode = z.infer<typeof receiptMappingGapCodeSchema>;
57
57
  export declare const receiptFreshnessSchema: z.ZodPipe<z.ZodObject<{
58
58
  status: z.ZodEnum<{
59
59
  error: "error";
60
- fresh: "fresh";
61
- stale: "stale";
62
60
  not_checked: "not_checked";
61
+ stale: "stale";
62
+ fresh: "fresh";
63
63
  }>;
64
64
  checkedAt: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
65
65
  latestEvidenceAt: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
@@ -68,9 +68,9 @@ export declare const receiptFreshnessSchema: z.ZodPipe<z.ZodObject<{
68
68
  errorCode?: string | undefined;
69
69
  latestEvidenceAt?: string | undefined;
70
70
  checkedAt?: string | undefined;
71
- status: "error" | "fresh" | "stale" | "not_checked";
71
+ status: "error" | "not_checked" | "stale" | "fresh";
72
72
  }, {
73
- status: "error" | "fresh" | "stale" | "not_checked";
73
+ status: "error" | "not_checked" | "stale" | "fresh";
74
74
  checkedAt?: string | undefined;
75
75
  latestEvidenceAt?: string | undefined;
76
76
  errorCode?: string | undefined;
@@ -95,9 +95,9 @@ export declare const receiptSourceSchema: z.ZodObject<{
95
95
  freshness: z.ZodPipe<z.ZodObject<{
96
96
  status: z.ZodEnum<{
97
97
  error: "error";
98
- fresh: "fresh";
99
- stale: "stale";
100
98
  not_checked: "not_checked";
99
+ stale: "stale";
100
+ fresh: "fresh";
101
101
  }>;
102
102
  checkedAt: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
103
103
  latestEvidenceAt: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
@@ -106,9 +106,9 @@ export declare const receiptSourceSchema: z.ZodObject<{
106
106
  errorCode?: string | undefined;
107
107
  latestEvidenceAt?: string | undefined;
108
108
  checkedAt?: string | undefined;
109
- status: "error" | "fresh" | "stale" | "not_checked";
109
+ status: "error" | "not_checked" | "stale" | "fresh";
110
110
  }, {
111
- status: "error" | "fresh" | "stale" | "not_checked";
111
+ status: "error" | "not_checked" | "stale" | "fresh";
112
112
  checkedAt?: string | undefined;
113
113
  latestEvidenceAt?: string | undefined;
114
114
  errorCode?: string | undefined;
@@ -125,9 +125,9 @@ export declare function createReceiptSourceRecordReference(sourceId: string, sou
125
125
  export declare const receiptProvenanceSchema: z.ZodObject<{
126
126
  origin: z.ZodEnum<{
127
127
  sample: "sample";
128
+ user_declared: "user_declared";
128
129
  provider_reported: "provider_reported";
129
130
  locally_observed: "locally_observed";
130
- user_declared: "user_declared";
131
131
  }>;
132
132
  transformations: z.ZodArray<z.ZodEnum<{
133
133
  normalized: "normalized";
@@ -159,9 +159,9 @@ export declare const receiptTokenUsageLineSchema: z.ZodObject<{
159
159
  provenance: z.ZodObject<{
160
160
  origin: z.ZodEnum<{
161
161
  sample: "sample";
162
+ user_declared: "user_declared";
162
163
  provider_reported: "provider_reported";
163
164
  locally_observed: "locally_observed";
164
- user_declared: "user_declared";
165
165
  }>;
166
166
  transformations: z.ZodArray<z.ZodEnum<{
167
167
  normalized: "normalized";
@@ -185,8 +185,8 @@ export declare const receiptFinancialCostLineSchema: z.ZodObject<{
185
185
  user_declared: "user_declared";
186
186
  }>;
187
187
  financialEvidence: z.ZodEnum<{
188
- verified: "verified";
189
188
  estimated: "estimated";
189
+ verified: "verified";
190
190
  detected_unverified: "detected_unverified";
191
191
  }>;
192
192
  id: z.ZodString;
@@ -205,9 +205,9 @@ export declare const receiptFinancialCostLineSchema: z.ZodObject<{
205
205
  provenance: z.ZodObject<{
206
206
  origin: z.ZodEnum<{
207
207
  sample: "sample";
208
+ user_declared: "user_declared";
208
209
  provider_reported: "provider_reported";
209
210
  locally_observed: "locally_observed";
210
- user_declared: "user_declared";
211
211
  }>;
212
212
  transformations: z.ZodArray<z.ZodEnum<{
213
213
  normalized: "normalized";
@@ -244,9 +244,9 @@ export declare const receiptLineSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
244
244
  provenance: z.ZodObject<{
245
245
  origin: z.ZodEnum<{
246
246
  sample: "sample";
247
+ user_declared: "user_declared";
247
248
  provider_reported: "provider_reported";
248
249
  locally_observed: "locally_observed";
249
- user_declared: "user_declared";
250
250
  }>;
251
251
  transformations: z.ZodArray<z.ZodEnum<{
252
252
  normalized: "normalized";
@@ -268,8 +268,8 @@ export declare const receiptLineSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
268
268
  user_declared: "user_declared";
269
269
  }>;
270
270
  financialEvidence: z.ZodEnum<{
271
- verified: "verified";
272
271
  estimated: "estimated";
272
+ verified: "verified";
273
273
  detected_unverified: "detected_unverified";
274
274
  }>;
275
275
  id: z.ZodString;
@@ -288,9 +288,9 @@ export declare const receiptLineSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
288
288
  provenance: z.ZodObject<{
289
289
  origin: z.ZodEnum<{
290
290
  sample: "sample";
291
+ user_declared: "user_declared";
291
292
  provider_reported: "provider_reported";
292
293
  locally_observed: "locally_observed";
293
- user_declared: "user_declared";
294
294
  }>;
295
295
  transformations: z.ZodArray<z.ZodEnum<{
296
296
  normalized: "normalized";
@@ -331,8 +331,8 @@ export declare const receiptCostTotalSchema: z.ZodObject<{
331
331
  user_declared: "user_declared";
332
332
  }>;
333
333
  financialEvidence: z.ZodEnum<{
334
- verified: "verified";
335
334
  estimated: "estimated";
335
+ verified: "verified";
336
336
  detected_unverified: "detected_unverified";
337
337
  }>;
338
338
  currency: z.ZodLiteral<"USD">;
@@ -345,8 +345,8 @@ declare const receiptBodyObjectSchema: z.ZodObject<{
345
345
  schemaVersion: z.ZodLiteral<"0.1.0">;
346
346
  generatedAt: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
347
347
  mode: z.ZodEnum<{
348
- local: "local";
349
348
  mixed: "mixed";
349
+ local: "local";
350
350
  sample: "sample";
351
351
  connected: "connected";
352
352
  }>;
@@ -374,9 +374,9 @@ declare const receiptBodyObjectSchema: z.ZodObject<{
374
374
  freshness: z.ZodPipe<z.ZodObject<{
375
375
  status: z.ZodEnum<{
376
376
  error: "error";
377
- fresh: "fresh";
378
- stale: "stale";
379
377
  not_checked: "not_checked";
378
+ stale: "stale";
379
+ fresh: "fresh";
380
380
  }>;
381
381
  checkedAt: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
382
382
  latestEvidenceAt: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
@@ -385,9 +385,9 @@ declare const receiptBodyObjectSchema: z.ZodObject<{
385
385
  errorCode?: string | undefined;
386
386
  latestEvidenceAt?: string | undefined;
387
387
  checkedAt?: string | undefined;
388
- status: "error" | "fresh" | "stale" | "not_checked";
388
+ status: "error" | "not_checked" | "stale" | "fresh";
389
389
  }, {
390
- status: "error" | "fresh" | "stale" | "not_checked";
390
+ status: "error" | "not_checked" | "stale" | "fresh";
391
391
  checkedAt?: string | undefined;
392
392
  latestEvidenceAt?: string | undefined;
393
393
  errorCode?: string | undefined;
@@ -416,9 +416,9 @@ declare const receiptBodyObjectSchema: z.ZodObject<{
416
416
  provenance: z.ZodObject<{
417
417
  origin: z.ZodEnum<{
418
418
  sample: "sample";
419
+ user_declared: "user_declared";
419
420
  provider_reported: "provider_reported";
420
421
  locally_observed: "locally_observed";
421
- user_declared: "user_declared";
422
422
  }>;
423
423
  transformations: z.ZodArray<z.ZodEnum<{
424
424
  normalized: "normalized";
@@ -440,8 +440,8 @@ declare const receiptBodyObjectSchema: z.ZodObject<{
440
440
  user_declared: "user_declared";
441
441
  }>;
442
442
  financialEvidence: z.ZodEnum<{
443
- verified: "verified";
444
443
  estimated: "estimated";
444
+ verified: "verified";
445
445
  detected_unverified: "detected_unverified";
446
446
  }>;
447
447
  id: z.ZodString;
@@ -460,9 +460,9 @@ declare const receiptBodyObjectSchema: z.ZodObject<{
460
460
  provenance: z.ZodObject<{
461
461
  origin: z.ZodEnum<{
462
462
  sample: "sample";
463
+ user_declared: "user_declared";
463
464
  provider_reported: "provider_reported";
464
465
  locally_observed: "locally_observed";
465
- user_declared: "user_declared";
466
466
  }>;
467
467
  transformations: z.ZodArray<z.ZodEnum<{
468
468
  normalized: "normalized";
@@ -500,8 +500,8 @@ export declare const agentEconomicsReceiptV0DraftSchema: z.ZodObject<{
500
500
  schemaVersion: z.ZodLiteral<"0.1.0">;
501
501
  generatedAt: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
502
502
  mode: z.ZodEnum<{
503
- local: "local";
504
503
  mixed: "mixed";
504
+ local: "local";
505
505
  sample: "sample";
506
506
  connected: "connected";
507
507
  }>;
@@ -529,9 +529,9 @@ export declare const agentEconomicsReceiptV0DraftSchema: z.ZodObject<{
529
529
  freshness: z.ZodPipe<z.ZodObject<{
530
530
  status: z.ZodEnum<{
531
531
  error: "error";
532
- fresh: "fresh";
533
- stale: "stale";
534
532
  not_checked: "not_checked";
533
+ stale: "stale";
534
+ fresh: "fresh";
535
535
  }>;
536
536
  checkedAt: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
537
537
  latestEvidenceAt: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
@@ -540,9 +540,9 @@ export declare const agentEconomicsReceiptV0DraftSchema: z.ZodObject<{
540
540
  errorCode?: string | undefined;
541
541
  latestEvidenceAt?: string | undefined;
542
542
  checkedAt?: string | undefined;
543
- status: "error" | "fresh" | "stale" | "not_checked";
543
+ status: "error" | "not_checked" | "stale" | "fresh";
544
544
  }, {
545
- status: "error" | "fresh" | "stale" | "not_checked";
545
+ status: "error" | "not_checked" | "stale" | "fresh";
546
546
  checkedAt?: string | undefined;
547
547
  latestEvidenceAt?: string | undefined;
548
548
  errorCode?: string | undefined;
@@ -571,9 +571,9 @@ export declare const agentEconomicsReceiptV0DraftSchema: z.ZodObject<{
571
571
  provenance: z.ZodObject<{
572
572
  origin: z.ZodEnum<{
573
573
  sample: "sample";
574
+ user_declared: "user_declared";
574
575
  provider_reported: "provider_reported";
575
576
  locally_observed: "locally_observed";
576
- user_declared: "user_declared";
577
577
  }>;
578
578
  transformations: z.ZodArray<z.ZodEnum<{
579
579
  normalized: "normalized";
@@ -595,8 +595,8 @@ export declare const agentEconomicsReceiptV0DraftSchema: z.ZodObject<{
595
595
  user_declared: "user_declared";
596
596
  }>;
597
597
  financialEvidence: z.ZodEnum<{
598
- verified: "verified";
599
598
  estimated: "estimated";
599
+ verified: "verified";
600
600
  detected_unverified: "detected_unverified";
601
601
  }>;
602
602
  id: z.ZodString;
@@ -615,9 +615,9 @@ export declare const agentEconomicsReceiptV0DraftSchema: z.ZodObject<{
615
615
  provenance: z.ZodObject<{
616
616
  origin: z.ZodEnum<{
617
617
  sample: "sample";
618
+ user_declared: "user_declared";
618
619
  provider_reported: "provider_reported";
619
620
  locally_observed: "locally_observed";
620
- user_declared: "user_declared";
621
621
  }>;
622
622
  transformations: z.ZodArray<z.ZodEnum<{
623
623
  normalized: "normalized";
@@ -657,8 +657,8 @@ export declare const agentEconomicsReceiptV0Schema: z.ZodObject<{
657
657
  schemaVersion: z.ZodLiteral<"0.1.0">;
658
658
  generatedAt: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
659
659
  mode: z.ZodEnum<{
660
- local: "local";
661
660
  mixed: "mixed";
661
+ local: "local";
662
662
  sample: "sample";
663
663
  connected: "connected";
664
664
  }>;
@@ -686,9 +686,9 @@ export declare const agentEconomicsReceiptV0Schema: z.ZodObject<{
686
686
  freshness: z.ZodPipe<z.ZodObject<{
687
687
  status: z.ZodEnum<{
688
688
  error: "error";
689
- fresh: "fresh";
690
- stale: "stale";
691
689
  not_checked: "not_checked";
690
+ stale: "stale";
691
+ fresh: "fresh";
692
692
  }>;
693
693
  checkedAt: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
694
694
  latestEvidenceAt: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
@@ -697,9 +697,9 @@ export declare const agentEconomicsReceiptV0Schema: z.ZodObject<{
697
697
  errorCode?: string | undefined;
698
698
  latestEvidenceAt?: string | undefined;
699
699
  checkedAt?: string | undefined;
700
- status: "error" | "fresh" | "stale" | "not_checked";
700
+ status: "error" | "not_checked" | "stale" | "fresh";
701
701
  }, {
702
- status: "error" | "fresh" | "stale" | "not_checked";
702
+ status: "error" | "not_checked" | "stale" | "fresh";
703
703
  checkedAt?: string | undefined;
704
704
  latestEvidenceAt?: string | undefined;
705
705
  errorCode?: string | undefined;
@@ -728,9 +728,9 @@ export declare const agentEconomicsReceiptV0Schema: z.ZodObject<{
728
728
  provenance: z.ZodObject<{
729
729
  origin: z.ZodEnum<{
730
730
  sample: "sample";
731
+ user_declared: "user_declared";
731
732
  provider_reported: "provider_reported";
732
733
  locally_observed: "locally_observed";
733
- user_declared: "user_declared";
734
734
  }>;
735
735
  transformations: z.ZodArray<z.ZodEnum<{
736
736
  normalized: "normalized";
@@ -752,8 +752,8 @@ export declare const agentEconomicsReceiptV0Schema: z.ZodObject<{
752
752
  user_declared: "user_declared";
753
753
  }>;
754
754
  financialEvidence: z.ZodEnum<{
755
- verified: "verified";
756
755
  estimated: "estimated";
756
+ verified: "verified";
757
757
  detected_unverified: "detected_unverified";
758
758
  }>;
759
759
  id: z.ZodString;
@@ -772,9 +772,9 @@ export declare const agentEconomicsReceiptV0Schema: z.ZodObject<{
772
772
  provenance: z.ZodObject<{
773
773
  origin: z.ZodEnum<{
774
774
  sample: "sample";
775
+ user_declared: "user_declared";
775
776
  provider_reported: "provider_reported";
776
777
  locally_observed: "locally_observed";
777
- user_declared: "user_declared";
778
778
  }>;
779
779
  transformations: z.ZodArray<z.ZodEnum<{
780
780
  normalized: "normalized";
@@ -814,8 +814,8 @@ export declare const agentEconomicsReceiptV0Schema: z.ZodObject<{
814
814
  user_declared: "user_declared";
815
815
  }>;
816
816
  financialEvidence: z.ZodEnum<{
817
- verified: "verified";
818
817
  estimated: "estimated";
818
+ verified: "verified";
819
819
  detected_unverified: "detected_unverified";
820
820
  }>;
821
821
  currency: z.ZodLiteral<"USD">;
package/dist/analyze.js CHANGED
@@ -346,6 +346,8 @@ function roundRatio(value) {
346
346
  return Math.round(value * 10_000) / 10_000;
347
347
  }
348
348
  function roundMoney(value) {
349
- return Math.round(value * 100) / 100;
349
+ // Persist fractional-cent evidence instead of turning a real positive amount
350
+ // into numeric zero. Presentation layers decide whether to show `<$0.01`.
351
+ return Math.round(value * 10_000) / 10_000;
350
352
  }
351
353
  //# sourceMappingURL=analyze.js.map
package/dist/cutList.js CHANGED
@@ -332,6 +332,6 @@ function stableSuffix(value) {
332
332
  return (hash >>> 0).toString(36);
333
333
  }
334
334
  function roundMoney(value) {
335
- return Math.round(value * 100) / 100;
335
+ return Math.round(value * 10_000) / 10_000;
336
336
  }
337
337
  //# sourceMappingURL=cutList.js.map
package/dist/glance.d.ts CHANGED
@@ -28,6 +28,8 @@ export type GlanceLimit = {
28
28
  observedAt: string;
29
29
  resetsAt: string;
30
30
  source: "transcript_reported";
31
+ /** Old transcript evidence remains visible but is never presented as live runway. */
32
+ freshness: "current" | "stale";
31
33
  projectedExhaustionAt: string | null;
32
34
  projectedToExhaustBeforeReset: boolean;
33
35
  projectionConfidence: "estimated";
@@ -128,7 +130,7 @@ export type UsageGlanceSnapshot = {
128
130
  detectedAgents: Array<LocalAgentCall["agent"]>;
129
131
  rateLimitMetadata: Array<{
130
132
  agent: LocalAgentCall["agent"];
131
- status: "reported" | "not_reported_by_transcript" | "not_seen";
133
+ status: "reported" | "stale" | "not_reported_by_transcript" | "not_seen";
132
134
  windowsReported: Array<LocalAgentRateLimitWindow["kind"]>;
133
135
  }>;
134
136
  providerConnectionRequired: ["cursor", "github-copilot"];