@trazum/cli 2.4.3 → 2.5.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.
package/src/i18n/en.ts CHANGED
@@ -59,9 +59,9 @@ ${bold('USAGE')}
59
59
  trazum schema <contract>
60
60
  trazum rollup <document...|dir> [--json] [--html-out <file>]
61
61
  trazum position <usage.jsonl>
62
- trazum receipt <usage.jsonl|dir> [--stamp] [-o <file>]
62
+ trazum receipt <usage.jsonl|dir> [--stamp] [--since <when>] [--until <when>] [-o <file>]
63
63
  trazum bill [<file|dir>...] [--label <name>] [--no-label-from-project] [--receipt|--table] [--stamp] [-o <file>]
64
- [--pdf-out|--html-out|--markdown-out|--csv-out <file>]
64
+ [--since <when>] [--until <when>] [--pdf-out|--html-out|--markdown-out|--csv-out <file>]
65
65
  trazum from-claude-code <file|dir> [--label <name>] [-o <file>]
66
66
  trazum from-otel <file|dir> [--label-from-service] [-o <file>]
67
67
  trazum from-litellm <file|dir> [-o <file>]
@@ -226,6 +226,12 @@ ${bold('OPTIONS FOR from-openai')}
226
226
  ${bold('OPTIONS FOR bill')}
227
227
  --label <name> The project this usage belongs to, for the
228
228
  shapes that take one.
229
+ --since <when> Bill only the calls in this period: a UTC day
230
+ --until <when> (2026-10-01), a full ISO 8601 timestamp, a
231
+ relative window (30d, 24h) or "now". A bare day
232
+ means the whole of it. Calls with no timestamp
233
+ cannot be placed and are left out, counted on
234
+ the receipt as a gap, never dropped silently.
229
235
  --stamp Stamp the receipt with the time it was written.
230
236
  -o, --out <file> Write the receipt there instead of stdout.
231
237
 
@@ -335,6 +341,10 @@ ${bold('OPTIONS FOR receipt')}
335
341
  output. The summary always goes to standard
336
342
  error, so a redirect writes a document and not a
337
343
  document with a summary stapled to the front.
344
+ --since <when> The period the receipt covers, as bill takes it:
345
+ --until <when> a UTC day, a timestamp, 30d or "now". Calls with
346
+ no timestamp are left out and named as an
347
+ undated-excluded gap.
338
348
  --pricing <file> Price it with your own card instead of the
339
349
  bundled catalogue.
340
350
  --pricing-live Price it against live rates via OpenRouter.
@@ -1192,6 +1202,9 @@ ${bold('EXAMPLES')}
1192
1202
  'rank tables are twenty-two megabytes and @trazum/core depends on nothing.\n' +
1193
1203
  ` npm install ${packageName}\n` +
1194
1204
  'Or drop --exact-tokens for the estimate, which says how far out it is.',
1205
+ exactTokensNoEncoding: (model, packageName, known) =>
1206
+ `--exact-tokens cannot count ${model} exactly: ${packageName} is installed and holds no rank table for it (it holds ${known}). ` +
1207
+ 'Counting it with the nearest table would put the word exact on a guess. Drop --exact-tokens for the estimate, which says how far out it is.',
1195
1208
  checkNeedsMaxTokens: () => 'trazum check needs --max-tokens <n>.',
1196
1209
  evalNeedsCases: () => 'trazum eval needs --cases <file>.',
1197
1210
  unknownExportFormat: (received, allowed) =>
@@ -1874,6 +1887,8 @@ ${bold('EXAMPLES')}
1874
1887
  unread: (count) => `${count} line(s) of the log could not be read, and the receipt says so.`,
1875
1888
  noClock: () =>
1876
1889
  'The log carries no clock, so the receipt is unbounded in time and states that rather than inventing a period.',
1890
+ undatedExcluded: (calls) =>
1891
+ `${count(calls)} ${calls === 1 ? 'call carries' : 'calls carry'} no timestamp and cannot be placed in this period, so ${calls === 1 ? 'it is' : 'they are'} not in this bill: the total is a floor on the period.`,
1877
1892
  nothingToBill: () => 'Nothing in this log could be priced, so the receipt has no lines.',
1878
1893
  },
1879
1894
 
@@ -1977,6 +1992,8 @@ ${bold('EXAMPLES')}
1977
1992
  'The report never named a service tier. Everything was read as the default tier. Add group_by[]=service_tier if any of this usage runs on another.',
1978
1993
  mixed: (rows, tokens, cacheWrites) =>
1979
1994
  `${rows} row(s) carried audio or image tokens, which a text rate is not the rate for. Each was reduced to its text part; ${tokens} audio and image token(s) are in no line of the output${cacheWrites > 0 ? `, and ${cacheWrites} cache-write token(s) on those rows were left out too, because the report gives them no modality` : ''}.`,
1995
+ cacheWrite12h: (tokens) =>
1996
+ `${tokens} token(s) were written to the 12-hour cache. No price for that write is published where Trazum can read it, so they stay in the prompt total at the plain input rate: those tokens' figure is a floor.`,
1980
1997
  unsplit: (count) =>
1981
1998
  `${count} row(s) carried audio or image tokens and no text split to reduce them by, and are not in the output. Pricing them at a text rate would be a guess.`,
1982
1999
  truncated: () =>
@@ -2014,6 +2031,11 @@ ${bold('EXAMPLES')}
2014
2031
  colCalls: () => 'calls',
2015
2032
  colShare: () => 'share',
2016
2033
  moreRows: (count) => `… and ${count} more`,
2034
+ colMonth: () => 'month',
2035
+ earlierMonths: (count) => `… and ${count} earlier month(s)`,
2036
+ monthsUndated: (calls, usd) =>
2037
+ `${usd} from ${calls} call(s) with no timestamp is in the total and in no month.`,
2038
+ monthHint: (since, until) => `One month on its own: --since ${since} --until ${until}.`,
2017
2039
  statementUnpriced: (models, calls) =>
2018
2040
  `Not in the total: ${calls} call(s) to ${models}, which the catalogue does not price. Named, never counted as $0.`,
2019
2041
  statementUnread: (lines) => `${lines} line(s) could not be read as usage and are not in the total.`,
@@ -2032,7 +2054,13 @@ ${bold('EXAMPLES')}
2032
2054
  nothingRead: () => 'Nothing here was a usage source this tool reads, so there is nothing to bill.',
2033
2055
  sources: (read, seen) => `${read} of ${seen} file(s) read as usage.`,
2034
2056
  pricingLiveHint: (count) =>
2035
- `${count} unpriced model id(s) are OpenRouter slugs, which the bundled catalogue does not carry. Run again with --pricing-live to price them from OpenRouter's own list.`,
2057
+ `${count} unpriced model id(s) carry a provider prefix, the way OpenRouter and LiteLLM name models, and the bundled catalogue does not carry those. Run again with --pricing-live to price OpenRouter's slugs from its own list.`,
2058
+ apiEquivalent: () =>
2059
+ 'Claude Code transcripts are priced at Anthropic\'s API rates. On a Pro or Max plan you paid the plan, not this: read it as what the same work would cost through the API.',
2060
+ prefixedKnown: (ids) =>
2061
+ `${ids}: the model after the slash is priced here under its own name. The prefix is not stripped for you, because the same model through a router can bill differently. If those calls went straight to the provider, log the model without the prefix.`,
2062
+ windowMatchesNothing: (from, to) =>
2063
+ `No call falls inside this period. What was read covers ${from} → ${to}. A period with nothing in it is not a $0 bill: check the dates, or leave --since/--until off to bill everything.`,
2036
2064
  written: (file) => `Wrote ${file}.`,
2037
2065
  },
2038
2066
 
@@ -2775,14 +2803,18 @@ ${bold('EXAMPLES')}
2775
2803
  'Nothing here clears 1% of the bill: these calls are already on the cheapest model of their family, or their provider has no batch API. That is a real answer, not an empty section.',
2776
2804
  assumedWriteTtl: (calls) =>
2777
2805
  `${count(calls)} ${calls === 1 ? 'call did' : 'calls did'} not say which cache-write TTL was used, so the cheaper 5-minute rate was assumed. A 1-hour entry costs 2x input rather than 1.25x, so this total is a floor for those calls. Record the "cache_creation" object the API returns to remove the assumption.`,
2806
+ tierCeiling: (rows, models, ceiling, floor) =>
2807
+ `${count(rows)} ${rows === 1 ? 'row' : 'rows'} on ${models} ${rows === 1 ? 'sums' : 'sum'} requests without giving any one prompt's length, and that model is priced by prompt length, so ${rows === 1 ? 'it is' : 'they are'} billed at the dearer rate: ${ceiling} of this total. At the cheaper rate the same tokens come to ${floor}; the true figure is between the two. A log with one line per call settles it.`,
2778
2808
  spanLine: (from, to, days) =>
2779
- `This log covers ${from} → ${to} (${days} days). The span is stated, never extrapolated: the monthly arithmetic is yours to do, and now it is valid.`,
2809
+ `This log covers ${from} → ${to} (${days} days): stated, never extrapolated. Scale it to a month yourself, now that you know what it covers.`,
2780
2810
  spanPartial: (withTs, total) =>
2781
2811
  `Only ${withTs} of ${total} calls carry a timestamp; the span describes those.`,
2782
2812
  ttlFitExpires: (label, model, gap) =>
2783
2813
  `${label} on ${model}: turns arrive a median of ${gap} apart and the 5-minute entry is gone by then, writes expire before the next turn reads them, which from the bill is a cache that only writes. The 1-hour TTL costs 2x input to write and would survive these gaps; the other honest option is caching switched off here.`,
2784
2814
  ttlFitExpiresBoth: (label, model, gap) =>
2785
2815
  `${label} on ${model}: turns arrive a median of ${gap} apart, and no cache entry lives that long, even the 1-hour TTL is gone by the next turn. Caching cannot work at this pace; turn it off here and stop paying the write premium.`,
2816
+ ttlFitExpiresOnly: (label, model, gap, ttl) =>
2817
+ `${label} on ${model}: turns arrive a median of ${gap} apart, and this model's cache entry lives ${ttl}, with no longer one to buy. Writes expire before the next turn reads them, so caching cannot work at this pace; turn it off here and stop paying the write premium.`,
2786
2818
  ttlFitOverlong: (label, model, gap, usd) =>
2787
2819
  `${label} on ${model}: turns arrive a median of ${gap} apart, comfortably inside the 5-minute window, and these writes pay the 1-hour rate, 2x input against 1.25x, for endurance the gaps never use. The same writes at the 5-minute TTL are ${usd} cheaper on this log, and that figure is exact: the same tokens at the other published rate.`,
2788
2820
  ttlFitUnsettledGap: (label, model, gap) =>
@@ -2859,6 +2891,8 @@ ${bold('EXAMPLES')}
2859
2891
  whatIfCheaper: () =>
2860
2892
  'Verify before you move anything: trazum route measures one prompt against both models on your own examples.',
2861
2893
  whatIfDearer: () => 'That direction costs more. The arithmetic is here so the number is not a guess.',
2894
+ whatIfTierCeiling: (slices, target, floor) =>
2895
+ `${target} is priced by prompt length, and ${count(slices)} ${slices === 1 ? 'slice holds' : 'slices hold'} a call over its line, so ${slices === 1 ? 'it is' : 'they are'} priced at the dearer band: the figure above is a ceiling. With every call under the line it would be ${floor}.`,
2862
2896
  whatIfBatchOnTarget: (batched, moved) =>
2863
2897
  `If those calls can also wait, the target's Batch API takes the moved bill from ${moved} to ${batched}, the discount applies to the target's rates, not the ones you left. Whether they can wait is not in the log; that half of the decision is yours.`,
2864
2898
  whatIfCacheBeyond: (largest, min, noCache) =>
@@ -3051,7 +3085,7 @@ ${bold('EXAMPLES')}
3051
3085
  sinceAfterUntil: () =>
3052
3086
  '--since is at or after --until, so the window contains no time at all. Check the two dates.',
3053
3087
  badWhen: (flag, value) =>
3054
- `--${flag} could not read "${value}". It takes a UTC day (2026-08-14) or a full ISO 8601 timestamp (2026-08-14T09:30:00Z).`,
3088
+ `--${flag} could not read "${value}". It takes a UTC day (2026-08-14), a full ISO 8601 timestamp (2026-08-14T09:30:00Z), a relative window (7d, 24h) or "now".`,
3055
3089
  singleTurnCeiling: (label, model, single, sessions, usd) =>
3056
3090
  `${label} on ${model}: ${single} of ${sessions} conversations ended after their first turn, and their cache writes, ${usd}, paid for reuse their own conversation never made. Another conversation sharing the same prefix within the TTL could have read them; the log cannot see whose write a read hit, so that figure is a ceiling on the waste, not a bill.`,
3057
3091
  singleTurnConfirmed: (label, model, single, sessions, usd) =>
package/src/i18n/es.ts CHANGED
@@ -46,9 +46,9 @@ ${bold('USO')}
46
46
  trazum schema <contrato>
47
47
  trazum rollup <documento...|dir> [--json] [--html-out <fichero>]
48
48
  trazum position <uso.jsonl>
49
- trazum receipt <uso.jsonl|dir> [--stamp] [-o <fichero>]
49
+ trazum receipt <uso.jsonl|dir> [--stamp] [--since <cuándo>] [--until <cuándo>] [-o <fichero>]
50
50
  trazum bill [<fichero|dir>...] [--label <nombre>] [--no-label-from-project] [--receipt|--table] [--stamp] [-o <fichero>]
51
- [--pdf-out|--html-out|--markdown-out|--csv-out <fichero>]
51
+ [--since <cuándo>] [--until <cuándo>] [--pdf-out|--html-out|--markdown-out|--csv-out <fichero>]
52
52
  trazum from-claude-code <fichero|dir> [--label <nombre>] [-o <fichero>]
53
53
  trazum from-otel <fichero|dir> [--label-from-service] [-o <fichero>]
54
54
  trazum from-litellm <fichero|dir> [-o <fichero>]
@@ -140,6 +140,10 @@ ${bold('OPCIONES DE receipt')}
140
140
  estándar, así que una redirección escribe un
141
141
  documento y no un documento con un resumen
142
142
  pegado delante.
143
+ --since <cuándo> El periodo que cubre el recibo, como lo toma
144
+ --until <cuándo> bill: un día UTC, una marca de tiempo, 30d o
145
+ "now". Las llamadas sin marca de tiempo quedan
146
+ fuera y se nombran como hueco undated-excluded.
143
147
  --pricing <fichero> Lo precia con tu propia tarjeta de precios en
144
148
  vez de con el catálogo incluido.
145
149
  --pricing-live Lo precia con tarifas en vivo vía OpenRouter.
@@ -208,30 +212,30 @@ ${bold('OPCIONES DE reconcile')}
208
212
  GET /v1/organizations/cost_report de Anthropic o
209
213
  el GET /v1/organization/costs de OpenAI, que se
210
214
  distinguen por su forma.
211
- -o, --out <archivo> Escribe la comparacion ahi en vez de en stdout.
215
+ -o, --out <archivo> Escribe la comparación ahí en vez de en stdout.
212
216
 
213
- Lo que Trazum calculo junto a lo que el proveedor facturo, nunca sumado:
217
+ Lo que Trazum calculo junto a lo que el proveedor facturó, nunca sumado:
214
218
  dos tablas de precios en una sola cifra es como un informe se vuelve
215
219
  silenciosamente falso. Descarga el de Anthropic con group_by[]=description
216
220
  y el de OpenAI con group_by[]=line_item, y la diferencia queda atribuida -
217
221
  lo que ninguna tarifa por token cubre, y en Anthropic lo que fue batch -
218
- dejando un resto que es la unica cifra que merece discusion. El informe de
219
- OpenAI nunca nombra batch, asi que ahi se queda dentro del resto y la
220
- ejecucion lo dice. Las ventanas deben coincidir o no se compara nada, y una
222
+ dejando un resto que es la única cifra que merece discusión. El informe de
223
+ OpenAI nunca nombra batch, así que ahí se queda dentro del resto y la
224
+ ejecución lo dice. Las ventanas deben coincidir o no se compara nada, y una
221
225
  moneda sin tipo de cambio se rechaza en vez de convertirse.
222
226
 
223
227
  ${bold('OPCIONES DE from-anthropic')}
224
228
  --label <nombre> El proyecto al que pertenece este uso. El
225
229
  proveedor no conoce tus nombres de proyecto.
226
- -o, --out <archivo> Escribe el log de uso ahi en vez de en stdout.
230
+ -o, --out <archivo> Escribe el log de uso ahí en vez de en stdout.
227
231
 
228
- El informe de uso de Anthropic, leido como log. Lo descargas tu con tu propia
229
- credencial de admin; esto lee la respuesta, asi que Trazum nunca sostiene una
232
+ El informe de uso de Anthropic, leído como log. Lo descargas tú con tu propia
233
+ credencial de admin; esto lee la respuesta, así que Trazum nunca sostiene una
230
234
  clave de proveedor. Pide group_by[]=model, porque una fila sin modelo no se
231
235
  puede cobrar, y group_by[]=service_tier, porque batch se factura con
232
- descuento y cobrarlo a tarifa de catalogo inflaria la factura. Las filas de
233
- cualquier otro tramo se quedan fuera y se cuentan, las busquedas web se
234
- cuentan y nunca se cobran por token, y has_more avisa de que falta pagina.
236
+ descuento y cobrarlo a tarifa de catálogo inflaría la factura. Las filas de
237
+ cualquier otro tramo se quedan fuera y se cuentan, las búsquedas web se
238
+ cuentan y nunca se cobran por token, y has_more avisa de que falta página.
235
239
 
236
240
  ${bold('OPCIONES DE from-openai')}
237
241
  --label <nombre> El proyecto al que pertenece este uso. El
@@ -239,13 +243,13 @@ ${bold('OPCIONES DE from-openai')}
239
243
  --label-by-project <archivo> Una etiqueta por id de proyecto, como array JSON
240
244
  de {"project": "proj_…", "label": "nombre"}.
241
245
  Coincidencia exacta; --label es el respaldo.
242
- -o, --out <archivo> Escribe el log de uso ahi en vez de en stdout.
246
+ -o, --out <archivo> Escribe el log de uso ahí en vez de en stdout.
243
247
 
244
- El informe de uso de OpenAI, leido como log, con el mismo arreglo que
248
+ El informe de uso de OpenAI, leído como log, con el mismo arreglo que
245
249
  from-anthropic: tu curl, tu clave de admin, y esto lee la respuesta. Pide
246
250
  group_by[]=model, porque una fila sin modelo no se puede cobrar, y
247
251
  group_by[]=batch, porque un trabajo por lotes se factura con descuento y
248
- cobrarlo a tarifa de catalogo inflaria la factura. Cualquier tramo de
252
+ cobrarlo a tarifa de catálogo inflaría la factura. Cualquier tramo de
249
253
  servicio que no sea default se queda fuera y se nombra. Los tokens de audio
250
254
  e imagen nunca se cobran a tarifa de texto: una fila que los trae se reduce
251
255
  a su parte de texto y el resto se cuenta donde puedas verlo.
@@ -253,18 +257,25 @@ ${bold('OPCIONES DE from-openai')}
253
257
  ${bold('OPCIONES DE bill')}
254
258
  --label <nombre> El proyecto al que pertenece este uso, para las
255
259
  formas que lo admiten.
256
- --stamp Sella el recibo con la hora en que se escribio.
257
- -o, --out <archivo> Escribe el recibo ahi en vez de en stdout.
260
+ --since <cuándo> Factura solo las llamadas de este periodo: un día
261
+ --until <cuándo> UTC (2026-10-01), una marca ISO 8601 completa,
262
+ una ventana relativa (30d, 24h) o "now". Un día
263
+ solo significa el día entero. Las llamadas sin
264
+ marca de tiempo no se pueden situar y quedan
265
+ fuera, contadas en el recibo como hueco, nunca
266
+ tiradas en silencio.
267
+ --stamp Sella el recibo con la hora en que se escribió.
268
+ -o, --out <archivo> Escribe el recibo ahí en vez de en stdout.
258
269
 
259
270
  Una sola puerta. Lee un archivo o un directorio, reconoce la forma de cada
260
- archivo por su propio texto - una transcripcion de Claude Code, spans OTel,
271
+ archivo por su propio texto - una transcripción de Claude Code, spans OTel,
261
272
  un export de LiteLLM, Helicone o LangSmith, un informe de Anthropic, OpenAI
262
273
  u OpenRouter, o un log de uso plano - lo convierte con el mismo conversor
263
274
  que usa el comando dedicado, lo cobra y termina en el recibo. Un archivo
264
275
  que ninguna forma reclama se nombra, no se adivina; uno que reclaman dos se
265
276
  nombra como ambiguo y se deja en paz; un informe de costes de proveedor se
266
- remite a reconcile. La linea de cada archivo dice cuantas filas quedaron
267
- fuera, y el comando from-<forma> dedicado dice por que.
277
+ remite a reconcile. La línea de cada archivo dice cuántas filas quedaron
278
+ fuera, y el comando from-<forma> dedicado dice por qué.
268
279
 
269
280
  ${bold('OPCIONES DE from-openrouter')}
270
281
  --label <nombre> El proyecto al que pertenece este uso.
@@ -272,14 +283,14 @@ ${bold('OPCIONES DE from-openrouter')}
272
283
  JSON de {"workspace": "…", "label": "nombre"}.
273
284
  Coincidencia exacta; --label es el respaldo.
274
285
  Requiere el informe pedido con group_by=workspace.
275
- -o, --out <archivo> Escribe el log de uso ahi en vez de en stdout.
286
+ -o, --out <archivo> Escribe el log de uso ahí en vez de en stdout.
276
287
 
277
288
  El informe de actividad de OpenRouter (GET /api/v1/activity, clave de
278
- gestion, los ultimos treinta dias), leido como log de uso con los mismos
279
- slugs de modelo que usa el overlay de precios de OpenRouter, asi que cientos
280
- de modelos se pueden cobrar de golpe. Lo que OpenRouter cobro se imprime
289
+ gestión, los últimos treinta días), leído como log de uso con los mismos
290
+ slugs de modelo que usa el overlay de precios de OpenRouter, así que cientos
291
+ de modelos se pueden cobrar de golpe. Lo que OpenRouter cobró se imprime
281
292
  junto a la cifra de Trazum y nunca se suma a ella. Los tokens de razonamiento
282
- se cuentan y no se anaden, porque el esquema no dice si el recuento de
293
+ se cuentan y no se añaden, porque el esquema no dice si el recuento de
283
294
  completado ya los incluye.
284
295
 
285
296
  ${bold('OPCIONES DE from-helicone')}
@@ -1226,6 +1237,9 @@ ${bold('EJEMPLOS')}
1226
1237
  }. Contarlo ahí sería rechazado arriba o devolvería un número de otro tokenizador, y esta herramienta no va a llamar exacto a eso. Quita --exact-tokens y quédate con la estimación (que es honesta sobre serlo) o cuenta con las herramientas de ${
1227
1238
  provider === null ? 'ese modelo' : provider
1228
1239
  }.`,
1240
+ exactTokensNoEncoding: (model, packageName, known) =>
1241
+ `--exact-tokens no puede contar ${model} con exactitud: ${packageName} está instalado y no tiene tabla de rangos para él (tiene ${known}). ` +
1242
+ 'Contarlo con la tabla más parecida pondría la palabra exacto sobre una suposición. Quita --exact-tokens para la estimación, que dice cuánto se desvía.',
1229
1243
  exactTokensNeedsPackage: (model, packageName) =>
1230
1244
  `--exact-tokens puede contar ${model} de forma exacta, sin conexión y sin clave, pero ` +
1231
1245
  `necesita ${packageName}, que no está instalado. Es un paquete aparte porque sus tablas ` +
@@ -1698,7 +1712,7 @@ ${bold('EJEMPLOS')}
1698
1712
  problemsHeading: (label) => `${label}: esta escalera no va a hacer lo que parece`,
1699
1713
  problem: (kind, detail) =>
1700
1714
  kind === 'escalate-on-a-success'
1701
- ? `escalateOn nombra "${detail}", que "outcomes.success" declara como \u00c9XITO. Esta escalera paga dos veces por trabajo que ya funcion\u00f3, en cada llamada, con el aspecto exacto de una medida de ahorro.`
1715
+ ? `escalateOn nombra "${detail}", que "outcomes.success" declara como \u00c9XITO. Esta escalera paga dos veces por trabajo que ya función\u00f3, en cada llamada, con el aspecto exacto de una medida de ahorro.`
1702
1716
  : kind === 'escalate-on-undeclared'
1703
1717
  ? `escalateOn nombra "${detail}", que "outcomes.values" no declara. Esta escalera no se dispara nunca, en silencio.`
1704
1718
  : kind === 'tiers-not-cheapest-first'
@@ -1902,6 +1916,8 @@ ${bold('EJEMPLOS')}
1902
1916
  unread: (count) => `${count} línea(s) del log no se pudieron leer, y el recibo lo dice.`,
1903
1917
  noClock: () =>
1904
1918
  'El log no lleva reloj, así que el recibo no está acotado en el tiempo y lo declara en vez de inventarse un periodo.',
1919
+ undatedExcluded: (calls) =>
1920
+ `${count(calls)} ${calls === 1 ? 'llamada no trae' : 'llamadas no traen'} marca de tiempo y no se ${calls === 1 ? 'puede' : 'pueden'} situar en este periodo, así que no ${calls === 1 ? 'está' : 'están'} en esta factura: el total es un suelo del periodo.`,
1905
1921
  nothingToBill: () => 'Nada de este log se pudo precificar, así que el recibo no tiene líneas.',
1906
1922
  },
1907
1923
 
@@ -1928,100 +1944,102 @@ ${bold('EJEMPLOS')}
1928
1944
  notAReport: (file) =>
1929
1945
  `${file}: no es el JSON que devuelve un endpoint de costes, ni el de Anthropic ni el de OpenAI. Pasa el cuerpo de la respuesta entero.`,
1930
1946
  summary: (computed, billed, difference) =>
1931
- `Trazum calculo $${computed.toFixed(2)}; el proveedor facturo $${billed.toFixed(2)}. Diferencia: $${difference.toFixed(2)}.`,
1947
+ `Trazum calculó $${computed.toFixed(2)}; el proveedor facturó $${billed.toFixed(2)}. Diferencia: $${difference.toFixed(2)}.`,
1932
1948
  notTokens: (usd) =>
1933
- `$${usd.toFixed(2)} de eso se factura por algo que ninguna tarifa por token cubre: busqueda web, ejecucion de codigo, uso de sesion. Trazum cobra tokens y nunca dijo cubrir esto.`,
1949
+ `$${usd.toFixed(2)} de eso se factura por algo que ninguna tarifa por token cubre: búsqueda web, ejecución de código, uso de sesión. Trazum cobra tokens y nunca dijo cubrir esto.`,
1934
1950
  batch: (usd) =>
1935
- `$${usd.toFixed(2)} es del tramo batch, que from-anthropic deja fuera en vez de cobrarlo a tarifa de catalogo.`,
1951
+ `$${usd.toFixed(2)} es del tramo batch, que from-anthropic deja fuera en vez de cobrarlo a tarifa de catálogo.`,
1936
1952
  remainder: (usd) =>
1937
- `Quedan $${usd.toFixed(2)}, y es la unica cifra aqui que merece discusion: los mismos tokens estandar cobrados de dos maneras, o uso que tu log nunca vio. Si es negativa, Trazum cobro mas de lo que te facturaron, que es una tarifa desactualizada en la direccion que te cuesta dinero.`,
1953
+ `Quedan $${usd.toFixed(2)}, y es la única cifra aquí que merece discusión: los mismos tokens estándar cobrados de dos maneras, o uso que tu log nunca vio. Si es negativa, Trazum cobró más de lo que te facturaron, que es una tarifa desactualizada en la dirección que te cuesta dinero.`,
1938
1954
  notAttributable: () =>
1939
- 'La diferencia no se puede atribuir: este informe no se agrupo por descripcion, asi que ninguna fila dice si fue tokens, una busqueda web o un batch. Anade group_by[]=description.',
1955
+ 'La diferencia no se puede atribuir: este informe no se agrupó por descripción, así que ninguna fila dice si fue tokens, una búsqueda web o un batch. Añade group_by[]=description.',
1940
1956
  notAttributableByLineItem: () =>
1941
- 'La diferencia no se puede atribuir: este informe no se agrupo por line item, asi que ninguna fila dice a que fue el dinero. Anade group_by[]=line_item.',
1957
+ 'La diferencia no se puede atribuir: este informe no se agrupó por line item, así que ninguna fila dice a qué fue el dinero. Añade group_by[]=line_item.',
1942
1958
  batchNotSeparable: () =>
1943
- 'Este informe nunca dice si una linea fue un trabajo por lotes, asi que el descuento de batch, si lo hay, esta dentro de ese resto y no fuera de el.',
1959
+ 'Este informe nunca dice si una línea fue un trabajo por lotes, así que el descuento de batch, si lo hay, está dentro de ese resto y no fuera de él.',
1944
1960
  unknownUnit: (usd) =>
1945
- `$${usd.toFixed(2)} del resto esta en line items cuya unidad es null: el informe dice que ninguna unidad aplica, asi que ni se cuenta como tokens ni como lo contrario. Se nombra aqui para que el resto no descanse sobre una unidad que nadie declaro.`,
1961
+ `$${usd.toFixed(2)} del resto está en line items cuya unidad es null: el informe dice que ninguna unidad aplica, así que ni se cuenta como tokens ni como lo contrario. Se nombra aquí para que el resto no descanse sobre una unidad que nadie declaró.`,
1946
1962
  windowNotCovered: (fromComputed, toComputed, fromBilled, toBilled) =>
1947
- `No son la misma ventana. El recibo cubre de ${fromComputed} a ${toComputed}; el informe cubre de ${fromBilled} a ${toBilled}. Un recibo comparado con una factura de otros dias es una cifra equivocada bajo un titulo correcto, asi que no se comparo nada.`,
1948
- noBilledWindow: () => 'El informe de costes no tiene intervalos, asi que no hay ventana contra la que comparar.',
1963
+ `No son la misma ventana. El recibo cubre de ${fromComputed} a ${toComputed}; el informe cubre de ${fromBilled} a ${toBilled}. Un recibo comparado con una factura de otros días es una cifra equivocada bajo un título correcto, así que no se comparó nada.`,
1964
+ noBilledWindow: () => 'El informe de costes no tiene intervalos, así que no hay ventana contra la que comparar.',
1949
1965
  otherCurrency: (list) =>
1950
- `El informe trae ${list} ademas de USD. Sumar dos monedas en un total necesita un tipo de cambio, e inventarlo es justo lo que este producto existe para no hacer. No se comparo nada.`,
1966
+ `El informe trae ${list} además de USD. Sumar dos monedas en un total necesita un tipo de cambio, e inventarlo es justo lo que este producto existe para no hacer. No se comparó nada.`,
1951
1967
  truncated: () =>
1952
- 'El informe dice has_more: true, asi que la cifra facturada se queda una pagina corta y la diferencia sale menor de lo que es.',
1968
+ 'El informe dice has_more: true, así que la cifra facturada se queda una página corta y la diferencia sale menor de lo que es.',
1953
1969
  unreadableAmount: (count) =>
1954
- `${count} fila(s) traian un importe que no es un numero. Se cuentan, nunca se leen como cero: un cero encogeria la factura en silencio.`,
1970
+ `${count} fila(s) traían un importe que no es un número. Se cuentan, nunca se leen como cero: un cero encogería la factura en silencio.`,
1955
1971
  written: (file) => `Escrito ${file}.`,
1956
1972
  },
1957
1973
 
1958
1974
  fromAnthropic: {
1959
1975
  noPath: () =>
1960
- 'from-anthropic necesita el informe de uso que produjo tu propio curl: trazum from-anthropic usage.json --label facturacion',
1976
+ 'from-anthropic necesita el informe de uso que produjo tu propio curl: trazum from-anthropic usage.json --label facturación',
1961
1977
  notFound: (path) => `${path}: no encontrado`,
1962
- summary: (buckets, rows) => `${buckets} intervalo(s), ${rows} fila(s) de uso leida(s).`,
1978
+ summary: (buckets, rows) => `${buckets} intervalo(s), ${rows} fila(s) de uso leída(s).`,
1963
1979
  unnamedModel: (count) =>
1964
- `${count} fila(s) no nombraron modelo y no estan en la salida: el informe no se agrupo por modelo, asi que nada en la fila dice que respondio. Anade group_by[]=model a la peticion.`,
1980
+ `${count} fila(s) no nombraron modelo y no están en la salida: el informe no se agrupó por modelo, así que nada en la fila dice qué respondió. Añade group_by[]=model a la petición.`,
1965
1981
  nonStandardTier: (count) =>
1966
- `${count} fila(s) se facturaron en un tramo para el que una tarifa de catalogo no es la tarifa (batch, priority, flex) y no estan en la salida. Cobrarlas a la tarifa estandar inflaria la factura y pareceria correcto.`,
1982
+ `${count} fila(s) se facturaron en un tramo para el que una tarifa de catálogo no es la tarifa (batch, priority, flex) y no están en la salida. Cobrarlas a la tarifa estándar inflaría la factura y parecería correcto.`,
1967
1983
  tierUnknown: () =>
1968
- 'El informe no nombro ningun tramo de servicio, asi que una fila batch y una estandar son indistinguibles aqui. Todo se leyo como estandar. Anade group_by[]=service_tier si parte de este uso va por lotes.',
1984
+ 'El informe no nombró ningún tramo de servicio, así que una fila batch y una estándar son indistinguibles aquí. Todo se leyó como estándar. Añade group_by[]=service_tier si parte de este uso va por lotes.',
1969
1985
  webSearch: (count) =>
1970
- `${count} peticion(es) de busqueda web estan en el informe y en ninguna linea de la salida: las herramientas de servidor se facturan por peticion, no por token, asi que ninguna tarifa por token llega a ellas.`,
1986
+ `${count} petición(es) de búsqueda web están en el informe y en ninguna línea de la salida: las herramientas de servidor se facturan por petición, no por token, así que ninguna tarifa por token llega a ellas.`,
1971
1987
  truncated: () =>
1972
- 'El informe dice has_more: true. Esto es una pagina de varias y una factura hecha con ella se queda corta. Sigue next_page hasta que has_more sea false, y convierte cada pagina.',
1988
+ 'El informe dice has_more: true. Esto es una página de varias y una factura hecha con ella se queda corta. Sigue next_page hasta que has_more sea false, y convierte cada página.',
1973
1989
  unparseable: () =>
1974
1990
  'Eso no es el JSON que devuelve GET /v1/organizations/usage_report/messages. Pasa el cuerpo de la respuesta entero, no un campo suyo.',
1975
1991
  labelledByWorkspace: (count) =>
1976
1992
  `${count} fila(s) tomaron su etiqueta del mapeo de workspaces.`,
1977
1993
  unruledWorkspace: (count) =>
1978
- `${count} fila(s) traian un workspace que ninguna regla nombra. Conservan --label si lo diste y quedan sin atribuir si no: un workspace para el que nadie escribio una regla esta mejor sin atribuir que atribuido al vecino.`,
1994
+ `${count} fila(s) traían un workspace que ninguna regla nombra. Conservan --label si lo diste y quedan sin atribuir si no: un workspace para el que nadie escribió una regla está mejor sin atribuir que atribuido al vecino.`,
1979
1995
  workspaceNotGrouped: () =>
1980
- 'Diste un mapeo de workspaces y ninguna fila traia id de workspace, asi que el reparto que pediste no se hizo. O el informe no se agrupo por workspace o esta organizacion solo usa el de por defecto, y nada aqui puede distinguirlo. Anade group_by[]=workspace_id.',
1996
+ 'Diste un mapeo de workspaces y ninguna fila traía id de workspace, así que el reparto que pediste no se hizo. O el informe no se agrupó por workspace o esta organización solo usa el de por defecto, y nada aquí puede distinguirlo. Añade group_by[]=workspace_id.',
1981
1997
  rulesUnreadable: (file) =>
1982
1998
  `${file}: no se puede leer como mapeo de workspaces. Es un array JSON de {"workspace": "wrkspc_…" | null, "label": "nombre"}.`,
1983
1999
  ruleBad: (file, at) =>
1984
- `${file}: la entrada ${at} no es una regla. Cada una necesita "label" y "workspace", que puede ser null para el workspace por defecto pero no puede faltar: un campo que falta es una errata y null es una decision.`,
2000
+ `${file}: la entrada ${at} no es una regla. Cada una necesita "label" y "workspace", que puede ser null para el workspace por defecto pero no puede faltar: un campo que falta es una errata y null es una decisión.`,
1985
2001
  rulesEmpty: (file) =>
1986
- `${file}: no hay reglas dentro. Pasaste --label-by-workspace para repartir algo, y un archivo vacio repartiria nada en silencio.`,
2002
+ `${file}: no hay reglas dentro. Pasaste --label-by-workspace para repartir algo, y un archivo vacío repartiría nada en silencio.`,
1987
2003
  written: (file) => `Escrito ${file}.`,
1988
2004
  },
1989
2005
 
1990
2006
  fromOpenai: {
1991
2007
  noPath: () =>
1992
- 'from-openai necesita el informe de uso que produjo tu propio curl: trazum from-openai usage.json --label facturacion',
2008
+ 'from-openai necesita el informe de uso que produjo tu propio curl: trazum from-openai usage.json --label facturación',
1993
2009
  notFound: (path) => `${path}: no encontrado`,
1994
2010
  summary: (buckets, rows, requests) =>
1995
- `${buckets} intervalo(s), ${rows} fila(s) de uso leida(s), que cubren ${requests} peticion(es).`,
2011
+ `${buckets} intervalo(s), ${rows} fila(s) de uso leída(s), que cubren ${requests} petición(es).`,
1996
2012
  unnamedModel: (count) =>
1997
- `${count} fila(s) no nombraron modelo y no estan en la salida: el informe no se agrupo por modelo, asi que nada en la fila dice que respondio. Anade group_by[]=model a la peticion.`,
2013
+ `${count} fila(s) no nombraron modelo y no están en la salida: el informe no se agrupó por modelo, así que nada en la fila dice qué respondió. Añade group_by[]=model a la petición.`,
1998
2014
  batch: (count) =>
1999
- `${count} fila(s) eran trabajos por lotes y no estan en la salida: batch se factura con descuento, y cobrarlo a tarifa de catalogo inflaria la factura y pareceria correcto.`,
2015
+ `${count} fila(s) eran trabajos por lotes y no están en la salida: batch se factura con descuento, y cobrarlo a tarifa de catálogo inflaría la factura y parecería correcto.`,
2000
2016
  batchUnknown: () =>
2001
- 'El informe nunca dijo si algo fue batch, asi que una fila por lotes y una estandar son indistinguibles aqui. Todo se leyo como estandar. Anade group_by[]=batch si parte de este uso va por lotes.',
2017
+ 'El informe nunca dijo si algo fue batch, así que una fila por lotes y una estándar son indistinguibles aquí. Todo se leyó como estándar. Añade group_by[]=batch si parte de este uso va por lotes.',
2002
2018
  nonDefaultTier: (count, tiers) =>
2003
- `${count} fila(s) estaban en un tramo de servicio para el que una tarifa de catalogo no es la tarifa (${tiers}) y no estan en la salida. El esquema no lista los tramos, asi que se nombran en vez de adivinarse.`,
2019
+ `${count} fila(s) estaban en un tramo de servicio para el que una tarifa de catálogo no es la tarifa (${tiers}) y no están en la salida. El esquema no lista los tramos, así que se nombran en vez de adivinarse.`,
2004
2020
  tierUnknown: () =>
2005
- 'El informe no nombro ningun tramo de servicio. Todo se leyo como el tramo por defecto. Anade group_by[]=service_tier si parte de este uso corre en otro.',
2021
+ 'El informe no nombró ningún tramo de servicio. Todo se leyó como el tramo por defecto. Añade group_by[]=service_tier si parte de este uso corre en otro.',
2006
2022
  mixed: (rows, tokens, cacheWrites) =>
2007
- `${rows} fila(s) traian tokens de audio o imagen, para los que una tarifa de texto no es la tarifa. Cada una se redujo a su parte de texto; ${tokens} token(s) de audio e imagen no estan en ninguna linea de la salida${cacheWrites > 0 ? `, y ${cacheWrites} token(s) de escritura de cache de esas filas se quedaron fuera tambien, porque el informe no les da modalidad` : ''}.`,
2023
+ `${rows} fila(s) traían tokens de audio o imagen, para los que una tarifa de texto no es la tarifa. Cada una se redujo a su parte de texto; ${tokens} token(s) de audio e imagen no están en ninguna línea de la salida${cacheWrites > 0 ? `, y ${cacheWrites} token(s) de escritura de caché de esas filas se quedaron fuera también, porque el informe no les da modalidad` : ''}.`,
2024
+ cacheWrite12h: (tokens) =>
2025
+ `${tokens} token(s) se escribieron en la caché de 12 horas. Esa escritura no tiene un precio publicado donde Trazum pueda leerlo, así que se quedan en el total del prompt a la tarifa de entrada normal: la cifra de esos tokens es un suelo.`,
2008
2026
  unsplit: (count) =>
2009
- `${count} fila(s) traian tokens de audio o imagen y ningun desglose de texto por el que reducirlas, y no estan en la salida. Cobrarlas a tarifa de texto seria adivinar.`,
2027
+ `${count} fila(s) traían tokens de audio o imagen y ningún desglose de texto por el que reducirlas, y no están en la salida. Cobrarlas a tarifa de texto sería adivinar.`,
2010
2028
  truncated: () =>
2011
- 'El informe dice has_more: true. Esto es una pagina de varias y una factura hecha con ella se queda corta. Sigue next_page hasta que has_more sea false, y convierte cada pagina.',
2029
+ 'El informe dice has_more: true. Esto es una página de varias y una factura hecha con ella se queda corta. Sigue next_page hasta que has_more sea false, y convierte cada página.',
2012
2030
  unparseable: () =>
2013
2031
  'Eso no es el JSON que devuelve GET /v1/organization/usage/completions. Pasa el cuerpo de la respuesta entero, no un campo suyo.',
2014
2032
  labelledByProject: (count) => `${count} fila(s) tomaron su etiqueta del mapeo de proyectos.`,
2015
2033
  unruledProject: (count) =>
2016
- `${count} fila(s) traian un proyecto que ninguna regla nombra. Conservan --label si lo diste y quedan sin atribuir si no: un proyecto para el que nadie escribio una regla esta mejor sin atribuir que atribuido al vecino.`,
2034
+ `${count} fila(s) traían un proyecto que ninguna regla nombra. Conservan --label si lo diste y quedan sin atribuir si no: un proyecto para el que nadie escribió una regla está mejor sin atribuir que atribuido al vecino.`,
2017
2035
  projectNotGrouped: () =>
2018
- 'Diste un mapeo de proyectos y ninguna fila traia id de proyecto, asi que el reparto que pediste no se hizo. Anade group_by[]=project_id.',
2036
+ 'Diste un mapeo de proyectos y ninguna fila traía id de proyecto, así que el reparto que pediste no se hizo. Añade group_by[]=project_id.',
2019
2037
  rulesUnreadable: (file) =>
2020
2038
  `${file}: no se puede leer como mapeo de proyectos. Es un array JSON de {"project": "proj_…", "label": "nombre"}.`,
2021
2039
  ruleBad: (file, at) =>
2022
- `${file}: la entrada ${at} no es una regla. Cada una necesita un id en "project" y una "label", ambos cadenas no vacias.`,
2040
+ `${file}: la entrada ${at} no es una regla. Cada una necesita un id en "project" y una "label", ambos cadenas no vacías.`,
2023
2041
  rulesEmpty: (file) =>
2024
- `${file}: no hay reglas dentro. Pasaste --label-by-project para repartir algo, y un archivo vacio repartiria nada en silencio.`,
2042
+ `${file}: no hay reglas dentro. Pasaste --label-by-project para repartir algo, y un archivo vacío repartiría nada en silencio.`,
2025
2043
  written: (file) => `Escrito ${file}.`,
2026
2044
  },
2027
2045
 
@@ -2042,6 +2060,11 @@ ${bold('EJEMPLOS')}
2042
2060
  colCalls: () => 'llamadas',
2043
2061
  colShare: () => 'parte',
2044
2062
  moreRows: (count) => `… y ${count} más`,
2063
+ colMonth: () => 'mes',
2064
+ earlierMonths: (count) => `… y ${count} mes(es) anterior(es)`,
2065
+ monthsUndated: (calls, usd) =>
2066
+ `${usd} de ${calls} llamada(s) sin marca de tiempo está en el total y en ningún mes.`,
2067
+ monthHint: (since, until) => `Un mes por separado: --since ${since} --until ${until}.`,
2045
2068
  statementUnpriced: (models, calls) =>
2046
2069
  `Fuera del total: ${calls} llamada(s) a ${models}, que el catálogo no tiene con precio. Se nombran, nunca se cuentan como $0.`,
2047
2070
  statementUnread: (lines) => `${lines} línea(s) no se pudieron leer como uso y no están en el total.`,
@@ -2050,47 +2073,53 @@ ${bold('EJEMPLOS')}
2050
2073
  notFound: (path) => `${path}: no encontrado`,
2051
2074
  noFiles: (path) => `${path}: no hay archivos .json, .jsonl, .ndjson ni .log dentro, ni sin comprimir ni en .gz.`,
2052
2075
  file: (path, shape, records, leftOut) =>
2053
- `${path}: ${shape}${records === null ? ', leido tal cual' : `, ${records} registro(s)`}${leftOut > 0 ? `, ${leftOut} fila(s) fuera. Ejecuta trazum from-${shape} sobre el para ver por que.` : '.'}`,
2076
+ `${path}: ${shape}${records === null ? ', leído tal cual' : `, ${records} registro(s)`}${leftOut > 0 ? `, ${leftOut} fila(s) fuera. Ejecuta trazum from-${shape} sobre él para ver por qué.` : '.'}`,
2054
2077
  unknown: (path) =>
2055
- `${path}: ninguna forma que esta herramienta lee lo reclama, asi que no se adivino y no esta en la factura.`,
2078
+ `${path}: ninguna forma que esta herramienta lee lo reclama, así que no se adivinó y no está en la factura.`,
2056
2079
  ambiguous: (path, shapes) =>
2057
- `${path}: lo reclama mas de una forma (${shapes}), asi que no se convirtio. Ejecuta el comando from-<forma> dedicado y di cual.`,
2080
+ `${path}: lo reclama más de una forma (${shapes}), así que no se convirtió. Ejecuta el comando from-<forma> dedicado y di cuál.`,
2058
2081
  costReport: (path) =>
2059
2082
  `${path}: un informe de costes de proveedor, que es una factura y no uso. Ponlo junto a un recibo con trazum reconcile.`,
2060
- nothingRead: () => 'Nada de esto era una fuente de uso que esta herramienta lea, asi que no hay nada que facturar.',
2061
- sources: (read, seen) => `${read} de ${seen} archivo(s) leido(s) como uso.`,
2083
+ nothingRead: () => 'Nada de esto era una fuente de uso que esta herramienta lea, así que no hay nada que facturar.',
2084
+ sources: (read, seen) => `${read} de ${seen} archivo(s) leído(s) como uso.`,
2062
2085
  pricingLiveHint: (count) =>
2063
- `${count} id(s) de modelo sin precio son slugs de OpenRouter, que el catalogo incluido no trae. Vuelve a ejecutar con --pricing-live para cobrarlos desde la propia lista de OpenRouter.`,
2086
+ `${count} id(s) de modelo sin precio llevan prefijo de proveedor, como nombran los modelos OpenRouter y LiteLLM, y el catálogo incluido no los trae. Vuelve a ejecutar con --pricing-live para cobrar los slugs de OpenRouter desde su propia lista.`,
2087
+ apiEquivalent: () =>
2088
+ 'Las transcripciones de Claude Code se cobran a las tarifas de la API de Anthropic. Con un plan Pro o Max pagaste el plan, no esto: léelo como lo que costaría el mismo trabajo a través de la API.',
2089
+ prefixedKnown: (ids) =>
2090
+ `${ids}: el modelo tras la barra tiene precio aquí con su propio nombre. El prefijo no se quita por ti, porque el mismo modelo a través de un router puede facturarse distinto. Si esas llamadas fueron directas al proveedor, registra el modelo sin el prefijo.`,
2091
+ windowMatchesNothing: (from, to) =>
2092
+ `Ninguna llamada cae dentro de este periodo. Lo leído cubre ${from} → ${to}. Un periodo sin nada dentro no es una factura de $0: revisa las fechas, o quita --since/--until para facturarlo todo.`,
2064
2093
  written: (file) => `Escrito ${file}.`,
2065
2094
  },
2066
2095
 
2067
2096
  fromOpenrouter: {
2068
2097
  noPath: () =>
2069
- 'from-openrouter necesita el informe de actividad que produjo tu propio curl: trazum from-openrouter activity.json --label facturacion',
2098
+ 'from-openrouter necesita el informe de actividad que produjo tu propio curl: trazum from-openrouter activity.json --label facturación',
2070
2099
  notFound: (path) => `${path}: no encontrado`,
2071
2100
  summary: (rows, days, requests) =>
2072
- `${rows} fila(s) de actividad leida(s) en ${days} dia(s), que cubren ${requests} peticion(es).`,
2101
+ `${rows} fila(s) de actividad leída(s) en ${days} día(s), que cubren ${requests} petición(es).`,
2073
2102
  reportedUsage: (usd, byokUsd) =>
2074
- `OpenRouter dice que cobro $${usd.toFixed(4)}${byokUsd > 0 ? ` mas $${byokUsd.toFixed(4)} facturados aguas arriba con tus propias claves` : ''}. Esa cifra es de OpenRouter, impresa junto a la de Trazum y nunca sumada a ella: dos tablas de precios en una sola cifra es como un informe se vuelve silenciosamente falso.`,
2103
+ `OpenRouter dice que cobró $${usd.toFixed(4)}${byokUsd > 0 ? ` más $${byokUsd.toFixed(4)} facturados aguas arriba con tus propias claves` : ''}. Esa cifra es de OpenRouter, impresa junto a la de Trazum y nunca sumada a ella: dos tablas de precios en una sola cifra es como un informe se vuelve silenciosamente falso.`,
2075
2104
  reasoning: (tokens) =>
2076
- `${tokens} token(s) de razonamiento estan en este informe y no se anadieron a ningun registro: el esquema no dice si completion_tokens ya los incluye, y anadirlos si es asi cobraria el razonamiento dos veces.`,
2105
+ `${tokens} token(s) de razonamiento están en este informe y no se añadieron a ningún registro: el esquema no dice si completion_tokens ya los incluye, y añadirlos si es así cobraría el razonamiento dos veces.`,
2077
2106
  unnamedModel: (count) =>
2078
- `${count} fila(s) no nombraron modelo y no estan en la salida: nada en la fila dice que respondio.`,
2107
+ `${count} fila(s) no nombraron modelo y no están en la salida: nada en la fila dice qué respondió.`,
2079
2108
  undated: (count) =>
2080
- `${count} fila(s) traian una fecha que no es un dia YYYY-MM-DD y no estan en la salida.`,
2109
+ `${count} fila(s) traían una fecha que no es un día YYYY-MM-DD y no están en la salida.`,
2081
2110
  unparseable: () =>
2082
2111
  'Eso no es el JSON que devuelve GET /api/v1/activity. Pasa el cuerpo de la respuesta entero, no un campo suyo.',
2083
2112
  labelledByWorkspace: (count) => `${count} fila(s) tomaron su etiqueta del mapeo de workspaces.`,
2084
2113
  unruledWorkspace: (count) =>
2085
- `${count} fila(s) traian un workspace que ninguna regla nombra. Conservan --label si lo diste y quedan sin atribuir si no.`,
2114
+ `${count} fila(s) traían un workspace que ninguna regla nombra. Conservan --label si lo diste y quedan sin atribuir si no.`,
2086
2115
  workspaceNotGrouped: () =>
2087
- 'Diste un mapeo de workspaces y ninguna fila traia id de workspace, asi que el reparto que pediste no se hizo. Pide el informe con group_by=workspace.',
2116
+ 'Diste un mapeo de workspaces y ninguna fila traía id de workspace, así que el reparto que pediste no se hizo. Pide el informe con group_by=workspace.',
2088
2117
  rulesUnreadable: (file) =>
2089
2118
  `${file}: no se puede leer como mapeo de workspaces. Es un array JSON de {"workspace": "…", "label": "nombre"}.`,
2090
2119
  ruleBad: (file, at) =>
2091
- `${file}: la entrada ${at} no es una regla. Cada una necesita un id en "workspace" y una "label", ambos cadenas no vacias.`,
2120
+ `${file}: la entrada ${at} no es una regla. Cada una necesita un id en "workspace" y una "label", ambos cadenas no vacías.`,
2092
2121
  rulesEmpty: (file) =>
2093
- `${file}: no hay reglas dentro. Pasaste --label-by-workspace para repartir algo, y un archivo vacio repartiria nada en silencio.`,
2122
+ `${file}: no hay reglas dentro. Pasaste --label-by-workspace para repartir algo, y un archivo vacío repartiría nada en silencio.`,
2094
2123
  written: (file) => `Escrito ${file}.`,
2095
2124
  },
2096
2125
 
@@ -2800,14 +2829,18 @@ ${bold('EJEMPLOS')}
2800
2829
  'Aquí no hay nada que llegue al 1% de la factura: estas llamadas ya van al modelo más barato de su familia, o su proveedor no tiene Batch API. Eso es una respuesta de verdad, no una sección vacía.',
2801
2830
  assumedWriteTtl: (calls) =>
2802
2831
  `${count(calls)} ${calls === 1 ? 'llamada no dijo' : 'llamadas no dijeron'} qué TTL de escritura de caché se usó, así que se asumió la tarifa más barata, la de 5 minutos. Una entrada de 1 hora cuesta 2x la entrada en vez de 1.25x, así que este total es un suelo para esas llamadas. Registra el objeto "cache_creation" que devuelve la API para quitar la suposición.`,
2832
+ tierCeiling: (rows, models, ceiling, floor) =>
2833
+ `${count(rows)} ${rows === 1 ? 'fila' : 'filas'} de ${models} ${rows === 1 ? 'suma' : 'suman'} peticiones sin dar la longitud de ningún prompt, y ese modelo se cobra por longitud de prompt, así que ${rows === 1 ? 'se factura' : 'se facturan'} a la tarifa más cara: ${ceiling} de este total. A la tarifa más barata los mismos tokens suman ${floor}; la cifra real está entre las dos. Un registro con una línea por llamada lo resuelve.`,
2803
2834
  spanLine: (from, to, days) =>
2804
- `Este registro abarca ${from} → ${to} (${days} días). El periodo se declara, nunca se extrapola: la aritmética mensual es tuya, y ahora es válida.`,
2835
+ `Este registro abarca ${from} → ${to} (${days} días): declarado, nunca extrapolado. Escálalo tú a un mes, ahora que sabes qué cubre.`,
2805
2836
  spanPartial: (withTs, total) =>
2806
2837
  `Solo ${withTs} de ${total} llamadas llevan marca de tiempo; el periodo describe esas.`,
2807
2838
  ttlFitExpires: (label, model, gap) =>
2808
2839
  `${label} en ${model}: los turnos llegan con una mediana de ${gap} entre sí y la entrada de 5 minutos ya no existe para entonces: las escrituras caducan antes de que el siguiente turno las lea, que visto desde la factura es una caché que solo escribe. El TTL de 1 hora cuesta 2x la entrada al escribir y sobreviviría a estos huecos; la otra opción honesta es apagar la caché aquí.`,
2809
2840
  ttlFitExpiresBoth: (label, model, gap) =>
2810
2841
  `${label} en ${model}: los turnos llegan con una mediana de ${gap} entre sí, y ninguna entrada de caché vive tanto: hasta el TTL de 1 hora ha caducado para el siguiente turno. La caché no puede funcionar a este ritmo; apágala aquí y deja de pagar la prima de escritura.`,
2842
+ ttlFitExpiresOnly: (label, model, gap, ttl) =>
2843
+ `${label} en ${model}: los turnos llegan con una mediana de ${gap} entre sí, y la entrada de caché de este modelo vive ${ttl}, sin otra más larga que comprar. Las escrituras caducan antes de que el siguiente turno las lea, así que la caché no puede funcionar a este ritmo; apágala aquí y deja de pagar la prima de escritura.`,
2811
2844
  ttlFitOverlong: (label, model, gap, usd) =>
2812
2845
  `${label} en ${model}: los turnos llegan con una mediana de ${gap} entre sí (de sobra dentro de la ventana de 5 minutos) y estas escrituras pagan la tarifa de 1 hora, 2x la entrada frente a 1.25x, por una resistencia que los huecos nunca usan. Las mismas escrituras con el TTL de 5 minutos salen ${usd} más baratas en este registro, y esa cifra es exacta: los mismos tokens a la otra tarifa publicada.`,
2813
2846
  ttlFitUnsettledGap: (label, model, gap) =>
@@ -2885,6 +2918,8 @@ ${bold('EJEMPLOS')}
2885
2918
  whatIfCheaper: () =>
2886
2919
  'Compruébalo antes de mover nada: trazum route mide un prompt contra ambos modelos con tus propios ejemplos.',
2887
2920
  whatIfDearer: () => 'Esa dirección cuesta más. La aritmética está aquí para que el número no sea una suposición.',
2921
+ whatIfTierCeiling: (slices, target, floor) =>
2922
+ `${target} se cobra por longitud de prompt, y ${count(slices)} ${slices === 1 ? 'tramo tiene' : 'tramos tienen'} una llamada por encima de su umbral, así que ${slices === 1 ? 'se cobra' : 'se cobran'} a la banda más cara: la cifra de arriba es un techo. Con todas las llamadas por debajo del umbral sería ${floor}.`,
2888
2923
  whatIfBatchOnTarget: (batched, moved) =>
2889
2924
  `Si esas llamadas además pueden esperar, la Batch API del destino deja la factura trasladada de ${moved} en ${batched}: el descuento aplica a las tarifas del destino, no a las que dejas. Si pueden esperar no está en el registro; esa mitad de la decisión es tuya.`,
2890
2925
  whatIfCacheBeyond: (largest, min, noCache) =>
@@ -3077,7 +3112,7 @@ ${bold('EJEMPLOS')}
3077
3112
  sinceAfterUntil: () =>
3078
3113
  '--since es igual o posterior a --until, así que la ventana no contiene tiempo alguno. Revisa las dos fechas.',
3079
3114
  badWhen: (flag, value) =>
3080
- `--${flag} no pudo leer "${value}". Acepta un día UTC (2026-08-14) o una marca ISO 8601 completa (2026-08-14T09:30:00Z).`,
3115
+ `--${flag} no pudo leer "${value}". Acepta un día UTC (2026-08-14), una marca ISO 8601 completa (2026-08-14T09:30:00Z), una ventana relativa (7d, 24h) o "now".`,
3081
3116
  singleTurnCeiling: (label, model, single, sessions, usd) =>
3082
3117
  `${label} en ${model}: ${single} de ${sessions} conversaciones terminaron tras su primer turno, y sus escrituras de caché (${usd}) pagaron una reutilización que su propia conversación nunca hizo. Otra conversación con el mismo prefijo dentro del TTL pudo haberlas leído; el registro no puede ver de quién era la escritura que una lectura encontró, así que esa cifra es un techo del desperdicio, no una factura.`,
3083
3118
  singleTurnConfirmed: (label, model, single, sessions, usd) =>