@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/dist/html.d.ts.map +1 -1
- package/dist/html.js +7 -1
- package/dist/html.js.map +1 -1
- package/dist/i18n/en.d.ts.map +1 -1
- package/dist/i18n/en.js +29 -5
- package/dist/i18n/en.js.map +1 -1
- package/dist/i18n/es.d.ts.map +1 -1
- package/dist/i18n/es.js +108 -83
- package/dist/i18n/es.js.map +1 -1
- package/dist/i18n/types.d.ts +29 -0
- package/dist/i18n/types.d.ts.map +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +187 -16
- package/dist/index.js.map +1 -1
- package/dist/markdown.d.ts +14 -0
- package/dist/markdown.d.ts.map +1 -1
- package/dist/markdown.js +29 -5
- package/dist/markdown.js.map +1 -1
- package/dist/pdf.d.ts.map +1 -1
- package/dist/pdf.js +6 -1
- package/dist/pdf.js.map +1 -1
- package/package.json +2 -2
- package/src/html.ts +6 -1
- package/src/i18n/en.ts +39 -5
- package/src/i18n/es.ts +118 -83
- package/src/i18n/types.ts +29 -0
- package/src/index.ts +207 -15
- package/src/markdown.ts +42 -5
- package/src/pdf.ts +4 -1
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)
|
|
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)
|
|
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)
|
|
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
|
|
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
|
|
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
|
|
219
|
-
OpenAI nunca nombra batch,
|
|
220
|
-
|
|
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
|
|
230
|
+
-o, --out <archivo> Escribe el log de uso ahí en vez de en stdout.
|
|
227
231
|
|
|
228
|
-
El informe de uso de Anthropic,
|
|
229
|
-
credencial de admin; esto lee la respuesta,
|
|
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
|
|
233
|
-
cualquier otro tramo se quedan fuera y se cuentan, las
|
|
234
|
-
cuentan y nunca se cobran por token, y has_more avisa de que falta
|
|
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
|
|
246
|
+
-o, --out <archivo> Escribe el log de uso ahí en vez de en stdout.
|
|
243
247
|
|
|
244
|
-
El informe de uso de OpenAI,
|
|
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
|
|
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
|
-
--
|
|
257
|
-
|
|
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
|
|
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
|
|
267
|
-
fuera, y el comando from-<forma> dedicado dice por
|
|
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
|
|
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
|
-
|
|
279
|
-
slugs de modelo que usa el overlay de precios de OpenRouter,
|
|
280
|
-
de modelos se pueden cobrar de golpe. Lo que OpenRouter
|
|
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
|
|
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
|
|
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
|
|
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:
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
1948
|
-
noBilledWindow: () => 'El informe de costes no tiene intervalos,
|
|
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}
|
|
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,
|
|
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)
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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}
|
|
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
|
|
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)
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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,
|
|
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
|
|
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
|
|
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)
|
|
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)
|
|
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
|
|
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)
|
|
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
|
|
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
|
|
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
|
|
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 ? ',
|
|
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,
|
|
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
|
|
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,
|
|
2061
|
-
sources: (read, seen) => `${read} de ${seen} archivo(s)
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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)
|
|
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)
|
|
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
|
|
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
|
|
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
|
|
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)
|
|
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)
|
|
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) =>
|