@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/dist/i18n/es.js
CHANGED
|
@@ -37,9 +37,9 @@ ${bold('USO')}
|
|
|
37
37
|
trazum schema <contrato>
|
|
38
38
|
trazum rollup <documento...|dir> [--json] [--html-out <fichero>]
|
|
39
39
|
trazum position <uso.jsonl>
|
|
40
|
-
trazum receipt <uso.jsonl|dir> [--stamp] [-o <fichero>]
|
|
40
|
+
trazum receipt <uso.jsonl|dir> [--stamp] [--since <cuándo>] [--until <cuándo>] [-o <fichero>]
|
|
41
41
|
trazum bill [<fichero|dir>...] [--label <nombre>] [--no-label-from-project] [--receipt|--table] [--stamp] [-o <fichero>]
|
|
42
|
-
[--pdf-out|--html-out|--markdown-out|--csv-out <fichero>]
|
|
42
|
+
[--since <cuándo>] [--until <cuándo>] [--pdf-out|--html-out|--markdown-out|--csv-out <fichero>]
|
|
43
43
|
trazum from-claude-code <fichero|dir> [--label <nombre>] [-o <fichero>]
|
|
44
44
|
trazum from-otel <fichero|dir> [--label-from-service] [-o <fichero>]
|
|
45
45
|
trazum from-litellm <fichero|dir> [-o <fichero>]
|
|
@@ -131,6 +131,10 @@ ${bold('OPCIONES DE receipt')}
|
|
|
131
131
|
estándar, así que una redirección escribe un
|
|
132
132
|
documento y no un documento con un resumen
|
|
133
133
|
pegado delante.
|
|
134
|
+
--since <cuándo> El periodo que cubre el recibo, como lo toma
|
|
135
|
+
--until <cuándo> bill: un día UTC, una marca de tiempo, 30d o
|
|
136
|
+
"now". Las llamadas sin marca de tiempo quedan
|
|
137
|
+
fuera y se nombran como hueco undated-excluded.
|
|
134
138
|
--pricing <fichero> Lo precia con tu propia tarjeta de precios en
|
|
135
139
|
vez de con el catálogo incluido.
|
|
136
140
|
--pricing-live Lo precia con tarifas en vivo vía OpenRouter.
|
|
@@ -199,30 +203,30 @@ ${bold('OPCIONES DE reconcile')}
|
|
|
199
203
|
GET /v1/organizations/cost_report de Anthropic o
|
|
200
204
|
el GET /v1/organization/costs de OpenAI, que se
|
|
201
205
|
distinguen por su forma.
|
|
202
|
-
-o, --out <archivo> Escribe la
|
|
206
|
+
-o, --out <archivo> Escribe la comparación ahí en vez de en stdout.
|
|
203
207
|
|
|
204
|
-
Lo que Trazum calculo junto a lo que el proveedor
|
|
208
|
+
Lo que Trazum calculo junto a lo que el proveedor facturó, nunca sumado:
|
|
205
209
|
dos tablas de precios en una sola cifra es como un informe se vuelve
|
|
206
210
|
silenciosamente falso. Descarga el de Anthropic con group_by[]=description
|
|
207
211
|
y el de OpenAI con group_by[]=line_item, y la diferencia queda atribuida -
|
|
208
212
|
lo que ninguna tarifa por token cubre, y en Anthropic lo que fue batch -
|
|
209
|
-
dejando un resto que es la
|
|
210
|
-
OpenAI nunca nombra batch,
|
|
211
|
-
|
|
213
|
+
dejando un resto que es la única cifra que merece discusión. El informe de
|
|
214
|
+
OpenAI nunca nombra batch, así que ahí se queda dentro del resto y la
|
|
215
|
+
ejecución lo dice. Las ventanas deben coincidir o no se compara nada, y una
|
|
212
216
|
moneda sin tipo de cambio se rechaza en vez de convertirse.
|
|
213
217
|
|
|
214
218
|
${bold('OPCIONES DE from-anthropic')}
|
|
215
219
|
--label <nombre> El proyecto al que pertenece este uso. El
|
|
216
220
|
proveedor no conoce tus nombres de proyecto.
|
|
217
|
-
-o, --out <archivo> Escribe el log de uso
|
|
221
|
+
-o, --out <archivo> Escribe el log de uso ahí en vez de en stdout.
|
|
218
222
|
|
|
219
|
-
El informe de uso de Anthropic,
|
|
220
|
-
credencial de admin; esto lee la respuesta,
|
|
223
|
+
El informe de uso de Anthropic, leído como log. Lo descargas tú con tu propia
|
|
224
|
+
credencial de admin; esto lee la respuesta, así que Trazum nunca sostiene una
|
|
221
225
|
clave de proveedor. Pide group_by[]=model, porque una fila sin modelo no se
|
|
222
226
|
puede cobrar, y group_by[]=service_tier, porque batch se factura con
|
|
223
|
-
descuento y cobrarlo a tarifa de
|
|
224
|
-
cualquier otro tramo se quedan fuera y se cuentan, las
|
|
225
|
-
cuentan y nunca se cobran por token, y has_more avisa de que falta
|
|
227
|
+
descuento y cobrarlo a tarifa de catálogo inflaría la factura. Las filas de
|
|
228
|
+
cualquier otro tramo se quedan fuera y se cuentan, las búsquedas web se
|
|
229
|
+
cuentan y nunca se cobran por token, y has_more avisa de que falta página.
|
|
226
230
|
|
|
227
231
|
${bold('OPCIONES DE from-openai')}
|
|
228
232
|
--label <nombre> El proyecto al que pertenece este uso. El
|
|
@@ -230,13 +234,13 @@ ${bold('OPCIONES DE from-openai')}
|
|
|
230
234
|
--label-by-project <archivo> Una etiqueta por id de proyecto, como array JSON
|
|
231
235
|
de {"project": "proj_…", "label": "nombre"}.
|
|
232
236
|
Coincidencia exacta; --label es el respaldo.
|
|
233
|
-
-o, --out <archivo> Escribe el log de uso
|
|
237
|
+
-o, --out <archivo> Escribe el log de uso ahí en vez de en stdout.
|
|
234
238
|
|
|
235
|
-
El informe de uso de OpenAI,
|
|
239
|
+
El informe de uso de OpenAI, leído como log, con el mismo arreglo que
|
|
236
240
|
from-anthropic: tu curl, tu clave de admin, y esto lee la respuesta. Pide
|
|
237
241
|
group_by[]=model, porque una fila sin modelo no se puede cobrar, y
|
|
238
242
|
group_by[]=batch, porque un trabajo por lotes se factura con descuento y
|
|
239
|
-
cobrarlo a tarifa de
|
|
243
|
+
cobrarlo a tarifa de catálogo inflaría la factura. Cualquier tramo de
|
|
240
244
|
servicio que no sea default se queda fuera y se nombra. Los tokens de audio
|
|
241
245
|
e imagen nunca se cobran a tarifa de texto: una fila que los trae se reduce
|
|
242
246
|
a su parte de texto y el resto se cuenta donde puedas verlo.
|
|
@@ -244,18 +248,25 @@ ${bold('OPCIONES DE from-openai')}
|
|
|
244
248
|
${bold('OPCIONES DE bill')}
|
|
245
249
|
--label <nombre> El proyecto al que pertenece este uso, para las
|
|
246
250
|
formas que lo admiten.
|
|
247
|
-
--
|
|
248
|
-
|
|
251
|
+
--since <cuándo> Factura solo las llamadas de este periodo: un día
|
|
252
|
+
--until <cuándo> UTC (2026-10-01), una marca ISO 8601 completa,
|
|
253
|
+
una ventana relativa (30d, 24h) o "now". Un día
|
|
254
|
+
solo significa el día entero. Las llamadas sin
|
|
255
|
+
marca de tiempo no se pueden situar y quedan
|
|
256
|
+
fuera, contadas en el recibo como hueco, nunca
|
|
257
|
+
tiradas en silencio.
|
|
258
|
+
--stamp Sella el recibo con la hora en que se escribió.
|
|
259
|
+
-o, --out <archivo> Escribe el recibo ahí en vez de en stdout.
|
|
249
260
|
|
|
250
261
|
Una sola puerta. Lee un archivo o un directorio, reconoce la forma de cada
|
|
251
|
-
archivo por su propio texto - una
|
|
262
|
+
archivo por su propio texto - una transcripción de Claude Code, spans OTel,
|
|
252
263
|
un export de LiteLLM, Helicone o LangSmith, un informe de Anthropic, OpenAI
|
|
253
264
|
u OpenRouter, o un log de uso plano - lo convierte con el mismo conversor
|
|
254
265
|
que usa el comando dedicado, lo cobra y termina en el recibo. Un archivo
|
|
255
266
|
que ninguna forma reclama se nombra, no se adivina; uno que reclaman dos se
|
|
256
267
|
nombra como ambiguo y se deja en paz; un informe de costes de proveedor se
|
|
257
|
-
remite a reconcile. La
|
|
258
|
-
fuera, y el comando from-<forma> dedicado dice por
|
|
268
|
+
remite a reconcile. La línea de cada archivo dice cuántas filas quedaron
|
|
269
|
+
fuera, y el comando from-<forma> dedicado dice por qué.
|
|
259
270
|
|
|
260
271
|
${bold('OPCIONES DE from-openrouter')}
|
|
261
272
|
--label <nombre> El proyecto al que pertenece este uso.
|
|
@@ -263,14 +274,14 @@ ${bold('OPCIONES DE from-openrouter')}
|
|
|
263
274
|
JSON de {"workspace": "…", "label": "nombre"}.
|
|
264
275
|
Coincidencia exacta; --label es el respaldo.
|
|
265
276
|
Requiere el informe pedido con group_by=workspace.
|
|
266
|
-
-o, --out <archivo> Escribe el log de uso
|
|
277
|
+
-o, --out <archivo> Escribe el log de uso ahí en vez de en stdout.
|
|
267
278
|
|
|
268
279
|
El informe de actividad de OpenRouter (GET /api/v1/activity, clave de
|
|
269
|
-
|
|
270
|
-
slugs de modelo que usa el overlay de precios de OpenRouter,
|
|
271
|
-
de modelos se pueden cobrar de golpe. Lo que OpenRouter
|
|
280
|
+
gestión, los últimos treinta días), leído como log de uso con los mismos
|
|
281
|
+
slugs de modelo que usa el overlay de precios de OpenRouter, así que cientos
|
|
282
|
+
de modelos se pueden cobrar de golpe. Lo que OpenRouter cobró se imprime
|
|
272
283
|
junto a la cifra de Trazum y nunca se suma a ella. Los tokens de razonamiento
|
|
273
|
-
se cuentan y no se
|
|
284
|
+
se cuentan y no se añaden, porque el esquema no dice si el recuento de
|
|
274
285
|
completado ya los incluye.
|
|
275
286
|
|
|
276
287
|
${bold('OPCIONES DE from-helicone')}
|
|
@@ -1190,6 +1201,8 @@ ${bold('EJEMPLOS')}
|
|
|
1190
1201
|
exactTokensWrongFamily: (model, provider) => `--exact-tokens cuenta con el endpoint de Anthropic, que cuenta el tokenizador de Claude${provider === null
|
|
1191
1202
|
? `, y el catálogo no registra proveedor para "${model}": qué tokenizador usa no es algo que Trazum sepa`
|
|
1192
1203
|
: `, y ${model} es un modelo de ${provider}`}. 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 ${provider === null ? 'ese modelo' : provider}.`,
|
|
1204
|
+
exactTokensNoEncoding: (model, packageName, known) => `--exact-tokens no puede contar ${model} con exactitud: ${packageName} está instalado y no tiene tabla de rangos para él (tiene ${known}). ` +
|
|
1205
|
+
'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.',
|
|
1193
1206
|
exactTokensNeedsPackage: (model, packageName) => `--exact-tokens puede contar ${model} de forma exacta, sin conexión y sin clave, pero ` +
|
|
1194
1207
|
`necesita ${packageName}, que no está instalado. Es un paquete aparte porque sus tablas ` +
|
|
1195
1208
|
'de rangos ocupan veintidós megabytes y @trazum/core no depende de nada.\n' +
|
|
@@ -1519,7 +1532,7 @@ ${bold('EJEMPLOS')}
|
|
|
1519
1532
|
: 'No se puede decir: esta escalera no declara valores de escalado.',
|
|
1520
1533
|
problemsHeading: (label) => `${label}: esta escalera no va a hacer lo que parece`,
|
|
1521
1534
|
problem: (kind, detail) => kind === 'escalate-on-a-success'
|
|
1522
|
-
? `escalateOn nombra "${detail}", que "outcomes.success" declara como \u00c9XITO. Esta escalera paga dos veces por trabajo que ya
|
|
1535
|
+
? `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.`
|
|
1523
1536
|
: kind === 'escalate-on-undeclared'
|
|
1524
1537
|
? `escalateOn nombra "${detail}", que "outcomes.values" no declara. Esta escalera no se dispara nunca, en silencio.`
|
|
1525
1538
|
: kind === 'tiers-not-cheapest-first'
|
|
@@ -1674,6 +1687,7 @@ ${bold('EJEMPLOS')}
|
|
|
1674
1687
|
unpriced: (models, calls) => `${models} modelo(s) que el catálogo no precia, con ${calls} llamada(s): nombrados en los huecos del recibo y fuera del total, en vez de costados a cero.`,
|
|
1675
1688
|
unread: (count) => `${count} línea(s) del log no se pudieron leer, y el recibo lo dice.`,
|
|
1676
1689
|
noClock: () => 'El log no lleva reloj, así que el recibo no está acotado en el tiempo y lo declara en vez de inventarse un periodo.',
|
|
1690
|
+
undatedExcluded: (calls) => `${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.`,
|
|
1677
1691
|
nothingToBill: () => 'Nada de este log se pudo precificar, así que el recibo no tiene líneas.',
|
|
1678
1692
|
},
|
|
1679
1693
|
fromOtel: {
|
|
@@ -1693,58 +1707,59 @@ ${bold('EJEMPLOS')}
|
|
|
1693
1707
|
notAReceipt: (file) => `${file}: no es un recibo. Necesita total.usd y span.fromMs/toMs, que es lo que escribe «trazum receipt».`,
|
|
1694
1708
|
reportUnreadable: (file) => `${file}: no encontrado.`,
|
|
1695
1709
|
notAReport: (file) => `${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.`,
|
|
1696
|
-
summary: (computed, billed, difference) => `Trazum
|
|
1697
|
-
notTokens: (usd) => `$${usd.toFixed(2)} de eso se factura por algo que ninguna tarifa por token cubre:
|
|
1698
|
-
batch: (usd) => `$${usd.toFixed(2)} es del tramo batch, que from-anthropic deja fuera en vez de cobrarlo a tarifa de
|
|
1699
|
-
remainder: (usd) => `Quedan $${usd.toFixed(2)}, y es la
|
|
1700
|
-
notAttributable: () => 'La diferencia no se puede atribuir: este informe no se
|
|
1701
|
-
notAttributableByLineItem: () => 'La diferencia no se puede atribuir: este informe no se
|
|
1702
|
-
batchNotSeparable: () => 'Este informe nunca dice si una
|
|
1703
|
-
unknownUnit: (usd) => `$${usd.toFixed(2)} del resto
|
|
1704
|
-
windowNotCovered: (fromComputed, toComputed, fromBilled, toBilled) => `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
|
|
1705
|
-
noBilledWindow: () => 'El informe de costes no tiene intervalos,
|
|
1706
|
-
otherCurrency: (list) => `El informe trae ${list}
|
|
1707
|
-
truncated: () => 'El informe dice has_more: true,
|
|
1708
|
-
unreadableAmount: (count) => `${count} fila(s)
|
|
1710
|
+
summary: (computed, billed, difference) => `Trazum calculó $${computed.toFixed(2)}; el proveedor facturó $${billed.toFixed(2)}. Diferencia: $${difference.toFixed(2)}.`,
|
|
1711
|
+
notTokens: (usd) => `$${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.`,
|
|
1712
|
+
batch: (usd) => `$${usd.toFixed(2)} es del tramo batch, que from-anthropic deja fuera en vez de cobrarlo a tarifa de catálogo.`,
|
|
1713
|
+
remainder: (usd) => `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.`,
|
|
1714
|
+
notAttributable: () => '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.',
|
|
1715
|
+
notAttributableByLineItem: () => '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.',
|
|
1716
|
+
batchNotSeparable: () => '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.',
|
|
1717
|
+
unknownUnit: (usd) => `$${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ó.`,
|
|
1718
|
+
windowNotCovered: (fromComputed, toComputed, fromBilled, toBilled) => `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.`,
|
|
1719
|
+
noBilledWindow: () => 'El informe de costes no tiene intervalos, así que no hay ventana contra la que comparar.',
|
|
1720
|
+
otherCurrency: (list) => `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.`,
|
|
1721
|
+
truncated: () => '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.',
|
|
1722
|
+
unreadableAmount: (count) => `${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.`,
|
|
1709
1723
|
written: (file) => `Escrito ${file}.`,
|
|
1710
1724
|
},
|
|
1711
1725
|
fromAnthropic: {
|
|
1712
|
-
noPath: () => 'from-anthropic necesita el informe de uso que produjo tu propio curl: trazum from-anthropic usage.json --label
|
|
1726
|
+
noPath: () => 'from-anthropic necesita el informe de uso que produjo tu propio curl: trazum from-anthropic usage.json --label facturación',
|
|
1713
1727
|
notFound: (path) => `${path}: no encontrado`,
|
|
1714
|
-
summary: (buckets, rows) => `${buckets} intervalo(s), ${rows} fila(s) de uso
|
|
1715
|
-
unnamedModel: (count) => `${count} fila(s) no nombraron modelo y no
|
|
1716
|
-
nonStandardTier: (count) => `${count} fila(s) se facturaron en un tramo para el que una tarifa de
|
|
1717
|
-
tierUnknown: () => 'El informe no
|
|
1718
|
-
webSearch: (count) => `${count}
|
|
1719
|
-
truncated: () => 'El informe dice has_more: true. Esto es una
|
|
1728
|
+
summary: (buckets, rows) => `${buckets} intervalo(s), ${rows} fila(s) de uso leída(s).`,
|
|
1729
|
+
unnamedModel: (count) => `${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.`,
|
|
1730
|
+
nonStandardTier: (count) => `${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.`,
|
|
1731
|
+
tierUnknown: () => '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.',
|
|
1732
|
+
webSearch: (count) => `${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.`,
|
|
1733
|
+
truncated: () => '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.',
|
|
1720
1734
|
unparseable: () => 'Eso no es el JSON que devuelve GET /v1/organizations/usage_report/messages. Pasa el cuerpo de la respuesta entero, no un campo suyo.',
|
|
1721
1735
|
labelledByWorkspace: (count) => `${count} fila(s) tomaron su etiqueta del mapeo de workspaces.`,
|
|
1722
|
-
unruledWorkspace: (count) => `${count} fila(s)
|
|
1723
|
-
workspaceNotGrouped: () => 'Diste un mapeo de workspaces y ninguna fila
|
|
1736
|
+
unruledWorkspace: (count) => `${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.`,
|
|
1737
|
+
workspaceNotGrouped: () => '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.',
|
|
1724
1738
|
rulesUnreadable: (file) => `${file}: no se puede leer como mapeo de workspaces. Es un array JSON de {"workspace": "wrkspc_…" | null, "label": "nombre"}.`,
|
|
1725
|
-
ruleBad: (file, at) => `${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
|
|
1726
|
-
rulesEmpty: (file) => `${file}: no hay reglas dentro. Pasaste --label-by-workspace para repartir algo, y un archivo
|
|
1739
|
+
ruleBad: (file, at) => `${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.`,
|
|
1740
|
+
rulesEmpty: (file) => `${file}: no hay reglas dentro. Pasaste --label-by-workspace para repartir algo, y un archivo vacío repartiría nada en silencio.`,
|
|
1727
1741
|
written: (file) => `Escrito ${file}.`,
|
|
1728
1742
|
},
|
|
1729
1743
|
fromOpenai: {
|
|
1730
|
-
noPath: () => 'from-openai necesita el informe de uso que produjo tu propio curl: trazum from-openai usage.json --label
|
|
1744
|
+
noPath: () => 'from-openai necesita el informe de uso que produjo tu propio curl: trazum from-openai usage.json --label facturación',
|
|
1731
1745
|
notFound: (path) => `${path}: no encontrado`,
|
|
1732
|
-
summary: (buckets, rows, requests) => `${buckets} intervalo(s), ${rows} fila(s) de uso
|
|
1733
|
-
unnamedModel: (count) => `${count} fila(s) no nombraron modelo y no
|
|
1734
|
-
batch: (count) => `${count} fila(s) eran trabajos por lotes y no
|
|
1735
|
-
batchUnknown: () => 'El informe nunca dijo si algo fue batch,
|
|
1736
|
-
nonDefaultTier: (count, tiers) => `${count} fila(s) estaban en un tramo de servicio para el que una tarifa de
|
|
1737
|
-
tierUnknown: () => 'El informe no
|
|
1738
|
-
mixed: (rows, tokens, cacheWrites) => `${rows} fila(s)
|
|
1739
|
-
|
|
1740
|
-
|
|
1746
|
+
summary: (buckets, rows, requests) => `${buckets} intervalo(s), ${rows} fila(s) de uso leída(s), que cubren ${requests} petición(es).`,
|
|
1747
|
+
unnamedModel: (count) => `${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.`,
|
|
1748
|
+
batch: (count) => `${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.`,
|
|
1749
|
+
batchUnknown: () => '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.',
|
|
1750
|
+
nonDefaultTier: (count, tiers) => `${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.`,
|
|
1751
|
+
tierUnknown: () => '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.',
|
|
1752
|
+
mixed: (rows, tokens, cacheWrites) => `${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` : ''}.`,
|
|
1753
|
+
cacheWrite12h: (tokens) => `${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.`,
|
|
1754
|
+
unsplit: (count) => `${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.`,
|
|
1755
|
+
truncated: () => '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.',
|
|
1741
1756
|
unparseable: () => 'Eso no es el JSON que devuelve GET /v1/organization/usage/completions. Pasa el cuerpo de la respuesta entero, no un campo suyo.',
|
|
1742
1757
|
labelledByProject: (count) => `${count} fila(s) tomaron su etiqueta del mapeo de proyectos.`,
|
|
1743
|
-
unruledProject: (count) => `${count} fila(s)
|
|
1744
|
-
projectNotGrouped: () => 'Diste un mapeo de proyectos y ninguna fila
|
|
1758
|
+
unruledProject: (count) => `${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.`,
|
|
1759
|
+
projectNotGrouped: () => '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.',
|
|
1745
1760
|
rulesUnreadable: (file) => `${file}: no se puede leer como mapeo de proyectos. Es un array JSON de {"project": "proj_…", "label": "nombre"}.`,
|
|
1746
|
-
ruleBad: (file, at) => `${file}: la entrada ${at} no es una regla. Cada una necesita un id en "project" y una "label", ambos cadenas no
|
|
1747
|
-
rulesEmpty: (file) => `${file}: no hay reglas dentro. Pasaste --label-by-project para repartir algo, y un archivo
|
|
1761
|
+
ruleBad: (file, at) => `${file}: la entrada ${at} no es una regla. Cada una necesita un id en "project" y una "label", ambos cadenas no vacías.`,
|
|
1762
|
+
rulesEmpty: (file) => `${file}: no hay reglas dentro. Pasaste --label-by-project para repartir algo, y un archivo vacío repartiría nada en silencio.`,
|
|
1748
1763
|
written: (file) => `Escrito ${file}.`,
|
|
1749
1764
|
},
|
|
1750
1765
|
bill: {
|
|
@@ -1761,35 +1776,42 @@ ${bold('EJEMPLOS')}
|
|
|
1761
1776
|
colCalls: () => 'llamadas',
|
|
1762
1777
|
colShare: () => 'parte',
|
|
1763
1778
|
moreRows: (count) => `… y ${count} más`,
|
|
1779
|
+
colMonth: () => 'mes',
|
|
1780
|
+
earlierMonths: (count) => `… y ${count} mes(es) anterior(es)`,
|
|
1781
|
+
monthsUndated: (calls, usd) => `${usd} de ${calls} llamada(s) sin marca de tiempo está en el total y en ningún mes.`,
|
|
1782
|
+
monthHint: (since, until) => `Un mes por separado: --since ${since} --until ${until}.`,
|
|
1764
1783
|
statementUnpriced: (models, calls) => `Fuera del total: ${calls} llamada(s) a ${models}, que el catálogo no tiene con precio. Se nombran, nunca se cuentan como $0.`,
|
|
1765
1784
|
statementUnread: (lines) => `${lines} línea(s) no se pudieron leer como uso y no están en el total.`,
|
|
1766
1785
|
statementNext: () => 'El recibo como datos: --receipt, o -o recibo.json. El documento para quien paga: --pdf-out factura.pdf.',
|
|
1767
1786
|
notFound: (path) => `${path}: no encontrado`,
|
|
1768
1787
|
noFiles: (path) => `${path}: no hay archivos .json, .jsonl, .ndjson ni .log dentro, ni sin comprimir ni en .gz.`,
|
|
1769
|
-
file: (path, shape, records, leftOut) => `${path}: ${shape}${records === null ? ',
|
|
1770
|
-
unknown: (path) => `${path}: ninguna forma que esta herramienta lee lo reclama,
|
|
1771
|
-
ambiguous: (path, shapes) => `${path}: lo reclama
|
|
1788
|
+
file: (path, shape, records, leftOut) => `${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é.` : '.'}`,
|
|
1789
|
+
unknown: (path) => `${path}: ninguna forma que esta herramienta lee lo reclama, así que no se adivinó y no está en la factura.`,
|
|
1790
|
+
ambiguous: (path, shapes) => `${path}: lo reclama más de una forma (${shapes}), así que no se convirtió. Ejecuta el comando from-<forma> dedicado y di cuál.`,
|
|
1772
1791
|
costReport: (path) => `${path}: un informe de costes de proveedor, que es una factura y no uso. Ponlo junto a un recibo con trazum reconcile.`,
|
|
1773
|
-
nothingRead: () => 'Nada de esto era una fuente de uso que esta herramienta lea,
|
|
1774
|
-
sources: (read, seen) => `${read} de ${seen} archivo(s)
|
|
1775
|
-
pricingLiveHint: (count) => `${count} id(s) de modelo sin precio
|
|
1792
|
+
nothingRead: () => 'Nada de esto era una fuente de uso que esta herramienta lea, así que no hay nada que facturar.',
|
|
1793
|
+
sources: (read, seen) => `${read} de ${seen} archivo(s) leído(s) como uso.`,
|
|
1794
|
+
pricingLiveHint: (count) => `${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.`,
|
|
1795
|
+
apiEquivalent: () => '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.',
|
|
1796
|
+
prefixedKnown: (ids) => `${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.`,
|
|
1797
|
+
windowMatchesNothing: (from, to) => `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.`,
|
|
1776
1798
|
written: (file) => `Escrito ${file}.`,
|
|
1777
1799
|
},
|
|
1778
1800
|
fromOpenrouter: {
|
|
1779
|
-
noPath: () => 'from-openrouter necesita el informe de actividad que produjo tu propio curl: trazum from-openrouter activity.json --label
|
|
1801
|
+
noPath: () => 'from-openrouter necesita el informe de actividad que produjo tu propio curl: trazum from-openrouter activity.json --label facturación',
|
|
1780
1802
|
notFound: (path) => `${path}: no encontrado`,
|
|
1781
|
-
summary: (rows, days, requests) => `${rows} fila(s) de actividad
|
|
1782
|
-
reportedUsage: (usd, byokUsd) => `OpenRouter dice que
|
|
1783
|
-
reasoning: (tokens) => `${tokens} token(s) de razonamiento
|
|
1784
|
-
unnamedModel: (count) => `${count} fila(s) no nombraron modelo y no
|
|
1785
|
-
undated: (count) => `${count} fila(s)
|
|
1803
|
+
summary: (rows, days, requests) => `${rows} fila(s) de actividad leída(s) en ${days} día(s), que cubren ${requests} petición(es).`,
|
|
1804
|
+
reportedUsage: (usd, byokUsd) => `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.`,
|
|
1805
|
+
reasoning: (tokens) => `${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.`,
|
|
1806
|
+
unnamedModel: (count) => `${count} fila(s) no nombraron modelo y no están en la salida: nada en la fila dice qué respondió.`,
|
|
1807
|
+
undated: (count) => `${count} fila(s) traían una fecha que no es un día YYYY-MM-DD y no están en la salida.`,
|
|
1786
1808
|
unparseable: () => 'Eso no es el JSON que devuelve GET /api/v1/activity. Pasa el cuerpo de la respuesta entero, no un campo suyo.',
|
|
1787
1809
|
labelledByWorkspace: (count) => `${count} fila(s) tomaron su etiqueta del mapeo de workspaces.`,
|
|
1788
|
-
unruledWorkspace: (count) => `${count} fila(s)
|
|
1789
|
-
workspaceNotGrouped: () => 'Diste un mapeo de workspaces y ninguna fila
|
|
1810
|
+
unruledWorkspace: (count) => `${count} fila(s) traían un workspace que ninguna regla nombra. Conservan --label si lo diste y quedan sin atribuir si no.`,
|
|
1811
|
+
workspaceNotGrouped: () => '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.',
|
|
1790
1812
|
rulesUnreadable: (file) => `${file}: no se puede leer como mapeo de workspaces. Es un array JSON de {"workspace": "…", "label": "nombre"}.`,
|
|
1791
|
-
ruleBad: (file, at) => `${file}: la entrada ${at} no es una regla. Cada una necesita un id en "workspace" y una "label", ambos cadenas no
|
|
1792
|
-
rulesEmpty: (file) => `${file}: no hay reglas dentro. Pasaste --label-by-workspace para repartir algo, y un archivo
|
|
1813
|
+
ruleBad: (file, at) => `${file}: la entrada ${at} no es una regla. Cada una necesita un id en "workspace" y una "label", ambos cadenas no vacías.`,
|
|
1814
|
+
rulesEmpty: (file) => `${file}: no hay reglas dentro. Pasaste --label-by-workspace para repartir algo, y un archivo vacío repartiría nada en silencio.`,
|
|
1793
1815
|
written: (file) => `Escrito ${file}.`,
|
|
1794
1816
|
},
|
|
1795
1817
|
fromHelicone: {
|
|
@@ -2306,10 +2328,12 @@ ${bold('EJEMPLOS')}
|
|
|
2306
2328
|
inputFullRate: () => 'Casi nada de eso fue lectura de caché, así que cada uno de esos tokens se facturó a tarifa de entrada completa. Si algún prefijo se repite entre estas llamadas, la caché es la palanca con el techo más alto aquí.',
|
|
2307
2329
|
leversNone: () => '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.',
|
|
2308
2330
|
assumedWriteTtl: (calls) => `${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.`,
|
|
2309
|
-
|
|
2331
|
+
tierCeiling: (rows, models, ceiling, floor) => `${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.`,
|
|
2332
|
+
spanLine: (from, to, days) => `Este registro abarca ${from} → ${to} (${days} días): declarado, nunca extrapolado. Escálalo tú a un mes, ahora que sabes qué cubre.`,
|
|
2310
2333
|
spanPartial: (withTs, total) => `Solo ${withTs} de ${total} llamadas llevan marca de tiempo; el periodo describe esas.`,
|
|
2311
2334
|
ttlFitExpires: (label, model, gap) => `${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í.`,
|
|
2312
2335
|
ttlFitExpiresBoth: (label, model, gap) => `${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.`,
|
|
2336
|
+
ttlFitExpiresOnly: (label, model, gap, ttl) => `${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.`,
|
|
2313
2337
|
ttlFitOverlong: (label, model, gap, usd) => `${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.`,
|
|
2314
2338
|
ttlFitUnsettledGap: (label, model, gap) => `${label} en ${model}: los turnos llegan con una mediana de ${gap} entre sí (una entrada de 5 minutos ya no existe para entonces y una de 1 hora sobrevive) y el registro no anotó cuáles eran estas escrituras, así que no se puede resolver si alguna vez se leen de vuelta. Registra el objeto "cache_creation" que devuelve la API y se resuelve solo.`,
|
|
2315
2339
|
ttlFitFits: (label, model, gap) => `${label} en ${model}: los turnos llegan con una mediana de ${gap} entre sí, dentro de la vida útil que usan estas escrituras. El TTL no es el problema aquí.`,
|
|
@@ -2352,6 +2376,7 @@ ${bold('EJEMPLOS')}
|
|
|
2352
2376
|
whatIfTotal: (current, target, delta) => `${current} de gasto movible habrían sido ${target}, una diferencia de ${delta}.`,
|
|
2353
2377
|
whatIfCheaper: () => 'Compruébalo antes de mover nada: trazum route mide un prompt contra ambos modelos con tus propios ejemplos.',
|
|
2354
2378
|
whatIfDearer: () => 'Esa dirección cuesta más. La aritmética está aquí para que el número no sea una suposición.',
|
|
2379
|
+
whatIfTierCeiling: (slices, target, floor) => `${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}.`,
|
|
2355
2380
|
whatIfBatchOnTarget: (batched, moved) => `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.`,
|
|
2356
2381
|
whatIfCacheBeyond: (largest, min, noCache) => `Su tráfico de caché no podría existir allí: la llamada más grande tiene ${largest} tokens frente al mínimo de caché de ${min} tokens del destino, así que ninguna llamada de este slice podría crear una entrada. Sin la caché los mismos tokens cuestan ${noCache}: esa es la cifra que el destino facturaría de verdad, y la fila de arriba favorece el traslado.`,
|
|
2357
2382
|
whatIfSlice: (label, model, current, target) => `${label} en ${model}: ${current} → ${target}`,
|
|
@@ -2468,7 +2493,7 @@ ${bold('EJEMPLOS')}
|
|
|
2468
2493
|
nothingUnpriced: (calls) => `se ${count(calls) && calls === 1 ? 'registró 1 llamada' : `registraron ${count(calls)} llamadas`} y ninguno de sus modelos está en la tabla de precios`,
|
|
2469
2494
|
nothingEmpty: () => 'el registro no tiene ni un solo apunte',
|
|
2470
2495
|
sinceAfterUntil: () => '--since es igual o posterior a --until, así que la ventana no contiene tiempo alguno. Revisa las dos fechas.',
|
|
2471
|
-
badWhen: (flag, value) => `--${flag} no pudo leer "${value}". Acepta un día UTC (2026-08-14)
|
|
2496
|
+
badWhen: (flag, value) => `--${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".`,
|
|
2472
2497
|
singleTurnCeiling: (label, model, single, sessions, usd) => `${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.`,
|
|
2473
2498
|
singleTurnConfirmed: (label, model, single, sessions, usd) => `${label} en ${model}: ${single} de ${sessions} conversaciones terminaron tras su primer turno y gastaron ${usd} escribiendo una caché que nada en este registro leyó jamás. Dentro de la conversación, entre conversaciones: ninguna lectura en ningún sitio, así que esas escrituras no compraron nada. Cachear una llamada de un solo uso es puro sobreprecio de escritura; deja de marcar estas llamadas con cache_control.`,
|
|
2474
2499
|
},
|