@trazum/cli 1.81.0 → 1.82.0

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.
package/src/i18n/types.ts CHANGED
@@ -127,10 +127,25 @@ export interface CliMessages {
127
127
  report: {
128
128
  inputTokens(): string;
129
129
  /**
130
- * @param offFamily Provider name when the model is not the family the
131
- * estimator was calibrated on, otherwise null.
132
- */
133
- estimated(offFamily: string | null): string;
130
+ * Where the input-token figure came from, and how far it can be trusted.
131
+ *
132
+ * Three cases, and the third is the one that took a measurement to earn.
133
+ * `band` is this text's own band, printed alone when the model is the family
134
+ * the estimator was calibrated on. `offFamily` names a tokenizer it was not
135
+ * measured on, and then the Claude band is dropped rather than annotated —
136
+ * a number qualified into meaninglessness is still read as a number.
137
+ * `measuredOff` is the worst error actually measured against that family's
138
+ * own counter, or null where nobody has run it: the difference between
139
+ * *this may be off* and *this was 94.5% off* is the difference between a
140
+ * hedge a reader discounts and one they act on.
141
+ *
142
+ * @param offFamily Provider name when the model is not the calibrated
143
+ * family, otherwise null.
144
+ * @param band This text's own measured band, as a percentage.
145
+ * @param measuredOff Worst measured error against that family's tokenizer,
146
+ * or null when it has never been measured.
147
+ */
148
+ estimated(offFamily: string | null, band: number, measuredOff: number | null): string;
134
149
  exactCount(): string;
135
150
  rulesApplied(): string;
136
151
  nothingToTrim(): string;
@@ -574,6 +589,48 @@ export interface CliMessages {
574
589
  written(file: string): string;
575
590
  };
576
591
 
592
+ /**
593
+ * `from-litellm` — the gateway a great many teams already put in front of
594
+ * every provider, so its spend log is the export most likely to already
595
+ * exist on somebody's disk.
596
+ */
597
+ /**
598
+ * `from-helicone` — the proxy that keeps every request it saw, so a team
599
+ * using it already has the export.
600
+ */
601
+ fromHelicone: {
602
+ noPath(): string;
603
+ notFound(path: string): string;
604
+ noExports(path: string): string;
605
+ summary(files: number, rows: number): string;
606
+ unnamedModel(count: number): string;
607
+ /** A proxy answered with a different model than was asked for. */
608
+ disagreements(count: number): string;
609
+ noTokens(count: number): string;
610
+ /** A cache flag is not a token split, and this says so rather than guessing. */
611
+ cacheFlagged(count: number): string;
612
+ /** Said once per run: a request id is one call, never a conversation. */
613
+ noSessions(): string;
614
+ unparseable(count: number): string;
615
+ written(file: string): string;
616
+ };
617
+
618
+ fromLiteLlm: {
619
+ noPath(): string;
620
+ notFound(path: string): string;
621
+ noExports(path: string): string;
622
+ summary(files: number, rows: number): string;
623
+ /** Rows naming no model: counted, never priced by the route they took. */
624
+ unnamedModel(count: number): string;
625
+ noTokens(count: number): string;
626
+ /** A cache flag is not a token split, and this says so rather than guessing. */
627
+ cacheFlagged(count: number): string;
628
+ /** LiteLLM's own figure, stated and never merged into Trazum's. */
629
+ reportedSpend(usd: string): string;
630
+ unparseable(count: number): string;
631
+ written(file: string): string;
632
+ };
633
+
577
634
  fromClaudeCode: {
578
635
  noPath(): string;
579
636
  notFound(path: string): string;
@@ -771,7 +828,8 @@ export interface CliMessages {
771
828
  goneAt(): string;
772
829
  truncated(shown: number): string;
773
830
  followedRename(from: string): string;
774
- estimateNote(): string;
831
+ /** `band` is the widest band across the texts the trend covers. */
832
+ estimateNote(band: number): string;
775
833
  };
776
834
 
777
835
  /** `trazum doctor` — the survey across a whole workspace. */
@@ -883,7 +941,13 @@ export interface CliMessages {
883
941
  truncated(): string;
884
942
  footer(source: string, level: string): string;
885
943
  pricingOverlaid(count: number, lastReviewed: string): string;
886
- sourceEstimated(): string;
944
+ /**
945
+ * `band` is this text's own measured band, from `bandFor` in core.
946
+ *
947
+ * Never a constant again: the estimator is 6% out on prose and 33% out on
948
+ * a CSV ledger, so one figure printed on both was wrong about one of them.
949
+ */
950
+ sourceEstimated(band: number): string;
887
951
  sourceExact(): string;
888
952
  measuringOptimised(): string;
889
953
  metricTokens(before: string, after: string): string;