@trazum/cli 2.4.2 → 2.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/src/i18n/es.ts CHANGED
@@ -47,7 +47,7 @@ ${bold('USO')}
47
47
  trazum rollup <documento...|dir> [--json] [--html-out <fichero>]
48
48
  trazum position <uso.jsonl>
49
49
  trazum receipt <uso.jsonl|dir> [--stamp] [-o <fichero>]
50
- trazum bill <fichero|dir>... [--label <nombre>] [--stamp] [-o <fichero>]
50
+ trazum bill [<fichero|dir>...] [--label <nombre>] [--no-label-from-project] [--receipt|--table] [--stamp] [-o <fichero>]
51
51
  [--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>]
@@ -208,30 +208,30 @@ ${bold('OPCIONES DE reconcile')}
208
208
  GET /v1/organizations/cost_report de Anthropic o
209
209
  el GET /v1/organization/costs de OpenAI, que se
210
210
  distinguen por su forma.
211
- -o, --out <archivo> Escribe la comparacion ahi en vez de en stdout.
211
+ -o, --out <archivo> Escribe la comparación ahí en vez de en stdout.
212
212
 
213
- Lo que Trazum calculo junto a lo que el proveedor facturo, nunca sumado:
213
+ Lo que Trazum calculo junto a lo que el proveedor facturó, nunca sumado:
214
214
  dos tablas de precios en una sola cifra es como un informe se vuelve
215
215
  silenciosamente falso. Descarga el de Anthropic con group_by[]=description
216
216
  y el de OpenAI con group_by[]=line_item, y la diferencia queda atribuida -
217
217
  lo que ninguna tarifa por token cubre, y en Anthropic lo que fue batch -
218
- dejando un resto que es la unica cifra que merece discusion. El informe de
219
- OpenAI nunca nombra batch, asi que ahi se queda dentro del resto y la
220
- ejecucion lo dice. Las ventanas deben coincidir o no se compara nada, y una
218
+ dejando un resto que es la única cifra que merece discusión. El informe de
219
+ OpenAI nunca nombra batch, así que ahí se queda dentro del resto y la
220
+ ejecución lo dice. Las ventanas deben coincidir o no se compara nada, y una
221
221
  moneda sin tipo de cambio se rechaza en vez de convertirse.
222
222
 
223
223
  ${bold('OPCIONES DE from-anthropic')}
224
224
  --label <nombre> El proyecto al que pertenece este uso. El
225
225
  proveedor no conoce tus nombres de proyecto.
226
- -o, --out <archivo> Escribe el log de uso ahi en vez de en stdout.
226
+ -o, --out <archivo> Escribe el log de uso ahí en vez de en stdout.
227
227
 
228
- El informe de uso de Anthropic, leido como log. Lo descargas tu con tu propia
229
- credencial de admin; esto lee la respuesta, asi que Trazum nunca sostiene una
228
+ El informe de uso de Anthropic, leído como log. Lo descargas tú con tu propia
229
+ credencial de admin; esto lee la respuesta, así que Trazum nunca sostiene una
230
230
  clave de proveedor. Pide group_by[]=model, porque una fila sin modelo no se
231
231
  puede cobrar, y group_by[]=service_tier, porque batch se factura con
232
- descuento y cobrarlo a tarifa de catalogo inflaria la factura. Las filas de
233
- cualquier otro tramo se quedan fuera y se cuentan, las busquedas web se
234
- cuentan y nunca se cobran por token, y has_more avisa de que falta pagina.
232
+ descuento y cobrarlo a tarifa de catálogo inflaría la factura. Las filas de
233
+ cualquier otro tramo se quedan fuera y se cuentan, las búsquedas web se
234
+ cuentan y nunca se cobran por token, y has_more avisa de que falta página.
235
235
 
236
236
  ${bold('OPCIONES DE from-openai')}
237
237
  --label <nombre> El proyecto al que pertenece este uso. El
@@ -239,13 +239,13 @@ ${bold('OPCIONES DE from-openai')}
239
239
  --label-by-project <archivo> Una etiqueta por id de proyecto, como array JSON
240
240
  de {"project": "proj_…", "label": "nombre"}.
241
241
  Coincidencia exacta; --label es el respaldo.
242
- -o, --out <archivo> Escribe el log de uso ahi en vez de en stdout.
242
+ -o, --out <archivo> Escribe el log de uso ahí en vez de en stdout.
243
243
 
244
- El informe de uso de OpenAI, leido como log, con el mismo arreglo que
244
+ El informe de uso de OpenAI, leído como log, con el mismo arreglo que
245
245
  from-anthropic: tu curl, tu clave de admin, y esto lee la respuesta. Pide
246
246
  group_by[]=model, porque una fila sin modelo no se puede cobrar, y
247
247
  group_by[]=batch, porque un trabajo por lotes se factura con descuento y
248
- cobrarlo a tarifa de catalogo inflaria la factura. Cualquier tramo de
248
+ cobrarlo a tarifa de catálogo inflaría la factura. Cualquier tramo de
249
249
  servicio que no sea default se queda fuera y se nombra. Los tokens de audio
250
250
  e imagen nunca se cobran a tarifa de texto: una fila que los trae se reduce
251
251
  a su parte de texto y el resto se cuenta donde puedas verlo.
@@ -253,18 +253,18 @@ ${bold('OPCIONES DE from-openai')}
253
253
  ${bold('OPCIONES DE bill')}
254
254
  --label <nombre> El proyecto al que pertenece este uso, para las
255
255
  formas que lo admiten.
256
- --stamp Sella el recibo con la hora en que se escribio.
257
- -o, --out <archivo> Escribe el recibo ahi en vez de en stdout.
256
+ --stamp Sella el recibo con la hora en que se escribió.
257
+ -o, --out <archivo> Escribe el recibo ahí en vez de en stdout.
258
258
 
259
259
  Una sola puerta. Lee un archivo o un directorio, reconoce la forma de cada
260
- archivo por su propio texto - una transcripcion de Claude Code, spans OTel,
260
+ archivo por su propio texto - una transcripción de Claude Code, spans OTel,
261
261
  un export de LiteLLM, Helicone o LangSmith, un informe de Anthropic, OpenAI
262
262
  u OpenRouter, o un log de uso plano - lo convierte con el mismo conversor
263
263
  que usa el comando dedicado, lo cobra y termina en el recibo. Un archivo
264
264
  que ninguna forma reclama se nombra, no se adivina; uno que reclaman dos se
265
265
  nombra como ambiguo y se deja en paz; un informe de costes de proveedor se
266
- remite a reconcile. La linea de cada archivo dice cuantas filas quedaron
267
- fuera, y el comando from-<forma> dedicado dice por que.
266
+ remite a reconcile. La línea de cada archivo dice cuántas filas quedaron
267
+ fuera, y el comando from-<forma> dedicado dice por qué.
268
268
 
269
269
  ${bold('OPCIONES DE from-openrouter')}
270
270
  --label <nombre> El proyecto al que pertenece este uso.
@@ -272,14 +272,14 @@ ${bold('OPCIONES DE from-openrouter')}
272
272
  JSON de {"workspace": "…", "label": "nombre"}.
273
273
  Coincidencia exacta; --label es el respaldo.
274
274
  Requiere el informe pedido con group_by=workspace.
275
- -o, --out <archivo> Escribe el log de uso ahi en vez de en stdout.
275
+ -o, --out <archivo> Escribe el log de uso ahí en vez de en stdout.
276
276
 
277
277
  El informe de actividad de OpenRouter (GET /api/v1/activity, clave de
278
- gestion, los ultimos treinta dias), leido como log de uso con los mismos
279
- slugs de modelo que usa el overlay de precios de OpenRouter, asi que cientos
280
- de modelos se pueden cobrar de golpe. Lo que OpenRouter cobro se imprime
278
+ gestión, los últimos treinta días), leído como log de uso con los mismos
279
+ slugs de modelo que usa el overlay de precios de OpenRouter, así que cientos
280
+ de modelos se pueden cobrar de golpe. Lo que OpenRouter cobró se imprime
281
281
  junto a la cifra de Trazum y nunca se suma a ella. Los tokens de razonamiento
282
- se cuentan y no se anaden, porque el esquema no dice si el recuento de
282
+ se cuentan y no se añaden, porque el esquema no dice si el recuento de
283
283
  completado ya los incluye.
284
284
 
285
285
  ${bold('OPCIONES DE from-helicone')}
@@ -1226,6 +1226,9 @@ ${bold('EJEMPLOS')}
1226
1226
  }. 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
1227
  provider === null ? 'ese modelo' : provider
1228
1228
  }.`,
1229
+ exactTokensNoEncoding: (model, packageName, known) =>
1230
+ `--exact-tokens no puede contar ${model} con exactitud: ${packageName} está instalado y no tiene tabla de rangos para él (tiene ${known}). ` +
1231
+ '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
1232
  exactTokensNeedsPackage: (model, packageName) =>
1230
1233
  `--exact-tokens puede contar ${model} de forma exacta, sin conexión y sin clave, pero ` +
1231
1234
  `necesita ${packageName}, que no está instalado. Es un paquete aparte porque sus tablas ` +
@@ -1698,7 +1701,7 @@ ${bold('EJEMPLOS')}
1698
1701
  problemsHeading: (label) => `${label}: esta escalera no va a hacer lo que parece`,
1699
1702
  problem: (kind, detail) =>
1700
1703
  kind === 'escalate-on-a-success'
1701
- ? `escalateOn nombra "${detail}", que "outcomes.success" declara como \u00c9XITO. Esta escalera paga dos veces por trabajo que ya funcion\u00f3, en cada llamada, con el aspecto exacto de una medida de ahorro.`
1704
+ ? `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
1705
  : kind === 'escalate-on-undeclared'
1703
1706
  ? `escalateOn nombra "${detail}", que "outcomes.values" no declara. Esta escalera no se dispara nunca, en silencio.`
1704
1707
  : kind === 'tiers-not-cheapest-first'
@@ -1928,149 +1931,171 @@ ${bold('EJEMPLOS')}
1928
1931
  notAReport: (file) =>
1929
1932
  `${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
1933
  summary: (computed, billed, difference) =>
1931
- `Trazum calculo $${computed.toFixed(2)}; el proveedor facturo $${billed.toFixed(2)}. Diferencia: $${difference.toFixed(2)}.`,
1934
+ `Trazum calculó $${computed.toFixed(2)}; el proveedor facturó $${billed.toFixed(2)}. Diferencia: $${difference.toFixed(2)}.`,
1932
1935
  notTokens: (usd) =>
1933
- `$${usd.toFixed(2)} de eso se factura por algo que ninguna tarifa por token cubre: busqueda web, ejecucion de codigo, uso de sesion. Trazum cobra tokens y nunca dijo cubrir esto.`,
1936
+ `$${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
1937
  batch: (usd) =>
1935
- `$${usd.toFixed(2)} es del tramo batch, que from-anthropic deja fuera en vez de cobrarlo a tarifa de catalogo.`,
1938
+ `$${usd.toFixed(2)} es del tramo batch, que from-anthropic deja fuera en vez de cobrarlo a tarifa de catálogo.`,
1936
1939
  remainder: (usd) =>
1937
- `Quedan $${usd.toFixed(2)}, y es la unica cifra aqui que merece discusion: los mismos tokens estandar cobrados de dos maneras, o uso que tu log nunca vio. Si es negativa, Trazum cobro mas de lo que te facturaron, que es una tarifa desactualizada en la direccion que te cuesta dinero.`,
1940
+ `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
1941
  notAttributable: () =>
1939
- 'La diferencia no se puede atribuir: este informe no se agrupo por descripcion, asi que ninguna fila dice si fue tokens, una busqueda web o un batch. Anade group_by[]=description.',
1942
+ '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
1943
  notAttributableByLineItem: () =>
1941
- 'La diferencia no se puede atribuir: este informe no se agrupo por line item, asi que ninguna fila dice a que fue el dinero. Anade group_by[]=line_item.',
1944
+ '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
1945
  batchNotSeparable: () =>
1943
- 'Este informe nunca dice si una linea fue un trabajo por lotes, asi que el descuento de batch, si lo hay, esta dentro de ese resto y no fuera de el.',
1946
+ '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
1947
  unknownUnit: (usd) =>
1945
- `$${usd.toFixed(2)} del resto esta en line items cuya unidad es null: el informe dice que ninguna unidad aplica, asi que ni se cuenta como tokens ni como lo contrario. Se nombra aqui para que el resto no descanse sobre una unidad que nadie declaro.`,
1948
+ `$${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
1949
  windowNotCovered: (fromComputed, toComputed, fromBilled, toBilled) =>
1947
- `No son la misma ventana. El recibo cubre de ${fromComputed} a ${toComputed}; el informe cubre de ${fromBilled} a ${toBilled}. Un recibo comparado con una factura de otros dias es una cifra equivocada bajo un titulo correcto, asi que no se comparo nada.`,
1948
- noBilledWindow: () => 'El informe de costes no tiene intervalos, asi que no hay ventana contra la que comparar.',
1950
+ `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.`,
1951
+ noBilledWindow: () => 'El informe de costes no tiene intervalos, así que no hay ventana contra la que comparar.',
1949
1952
  otherCurrency: (list) =>
1950
- `El informe trae ${list} ademas de USD. Sumar dos monedas en un total necesita un tipo de cambio, e inventarlo es justo lo que este producto existe para no hacer. No se comparo nada.`,
1953
+ `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
1954
  truncated: () =>
1952
- 'El informe dice has_more: true, asi que la cifra facturada se queda una pagina corta y la diferencia sale menor de lo que es.',
1955
+ '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
1956
  unreadableAmount: (count) =>
1954
- `${count} fila(s) traian un importe que no es un numero. Se cuentan, nunca se leen como cero: un cero encogeria la factura en silencio.`,
1957
+ `${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
1958
  written: (file) => `Escrito ${file}.`,
1956
1959
  },
1957
1960
 
1958
1961
  fromAnthropic: {
1959
1962
  noPath: () =>
1960
- 'from-anthropic necesita el informe de uso que produjo tu propio curl: trazum from-anthropic usage.json --label facturacion',
1963
+ 'from-anthropic necesita el informe de uso que produjo tu propio curl: trazum from-anthropic usage.json --label facturación',
1961
1964
  notFound: (path) => `${path}: no encontrado`,
1962
- summary: (buckets, rows) => `${buckets} intervalo(s), ${rows} fila(s) de uso leida(s).`,
1965
+ summary: (buckets, rows) => `${buckets} intervalo(s), ${rows} fila(s) de uso leída(s).`,
1963
1966
  unnamedModel: (count) =>
1964
- `${count} fila(s) no nombraron modelo y no estan en la salida: el informe no se agrupo por modelo, asi que nada en la fila dice que respondio. Anade group_by[]=model a la peticion.`,
1967
+ `${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
1968
  nonStandardTier: (count) =>
1966
- `${count} fila(s) se facturaron en un tramo para el que una tarifa de catalogo no es la tarifa (batch, priority, flex) y no estan en la salida. Cobrarlas a la tarifa estandar inflaria la factura y pareceria correcto.`,
1969
+ `${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
1970
  tierUnknown: () =>
1968
- 'El informe no nombro ningun tramo de servicio, asi que una fila batch y una estandar son indistinguibles aqui. Todo se leyo como estandar. Anade group_by[]=service_tier si parte de este uso va por lotes.',
1971
+ '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
1972
  webSearch: (count) =>
1970
- `${count} peticion(es) de busqueda web estan en el informe y en ninguna linea de la salida: las herramientas de servidor se facturan por peticion, no por token, asi que ninguna tarifa por token llega a ellas.`,
1973
+ `${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
1974
  truncated: () =>
1972
- 'El informe dice has_more: true. Esto es una pagina de varias y una factura hecha con ella se queda corta. Sigue next_page hasta que has_more sea false, y convierte cada pagina.',
1975
+ '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
1976
  unparseable: () =>
1974
1977
  '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
1978
  labelledByWorkspace: (count) =>
1976
1979
  `${count} fila(s) tomaron su etiqueta del mapeo de workspaces.`,
1977
1980
  unruledWorkspace: (count) =>
1978
- `${count} fila(s) traian un workspace que ninguna regla nombra. Conservan --label si lo diste y quedan sin atribuir si no: un workspace para el que nadie escribio una regla esta mejor sin atribuir que atribuido al vecino.`,
1981
+ `${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
1982
  workspaceNotGrouped: () =>
1980
- 'Diste un mapeo de workspaces y ninguna fila traia id de workspace, asi que el reparto que pediste no se hizo. O el informe no se agrupo por workspace o esta organizacion solo usa el de por defecto, y nada aqui puede distinguirlo. Anade group_by[]=workspace_id.',
1983
+ '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
1984
  rulesUnreadable: (file) =>
1982
1985
  `${file}: no se puede leer como mapeo de workspaces. Es un array JSON de {"workspace": "wrkspc_…" | null, "label": "nombre"}.`,
1983
1986
  ruleBad: (file, at) =>
1984
- `${file}: la entrada ${at} no es una regla. Cada una necesita "label" y "workspace", que puede ser null para el workspace por defecto pero no puede faltar: un campo que falta es una errata y null es una decision.`,
1987
+ `${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
1988
  rulesEmpty: (file) =>
1986
- `${file}: no hay reglas dentro. Pasaste --label-by-workspace para repartir algo, y un archivo vacio repartiria nada en silencio.`,
1989
+ `${file}: no hay reglas dentro. Pasaste --label-by-workspace para repartir algo, y un archivo vacío repartiría nada en silencio.`,
1987
1990
  written: (file) => `Escrito ${file}.`,
1988
1991
  },
1989
1992
 
1990
1993
  fromOpenai: {
1991
1994
  noPath: () =>
1992
- 'from-openai necesita el informe de uso que produjo tu propio curl: trazum from-openai usage.json --label facturacion',
1995
+ 'from-openai necesita el informe de uso que produjo tu propio curl: trazum from-openai usage.json --label facturación',
1993
1996
  notFound: (path) => `${path}: no encontrado`,
1994
1997
  summary: (buckets, rows, requests) =>
1995
- `${buckets} intervalo(s), ${rows} fila(s) de uso leida(s), que cubren ${requests} peticion(es).`,
1998
+ `${buckets} intervalo(s), ${rows} fila(s) de uso leída(s), que cubren ${requests} petición(es).`,
1996
1999
  unnamedModel: (count) =>
1997
- `${count} fila(s) no nombraron modelo y no estan en la salida: el informe no se agrupo por modelo, asi que nada en la fila dice que respondio. Anade group_by[]=model a la peticion.`,
2000
+ `${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
2001
  batch: (count) =>
1999
- `${count} fila(s) eran trabajos por lotes y no estan en la salida: batch se factura con descuento, y cobrarlo a tarifa de catalogo inflaria la factura y pareceria correcto.`,
2002
+ `${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
2003
  batchUnknown: () =>
2001
- 'El informe nunca dijo si algo fue batch, asi que una fila por lotes y una estandar son indistinguibles aqui. Todo se leyo como estandar. Anade group_by[]=batch si parte de este uso va por lotes.',
2004
+ '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
2005
  nonDefaultTier: (count, tiers) =>
2003
- `${count} fila(s) estaban en un tramo de servicio para el que una tarifa de catalogo no es la tarifa (${tiers}) y no estan en la salida. El esquema no lista los tramos, asi que se nombran en vez de adivinarse.`,
2006
+ `${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
2007
  tierUnknown: () =>
2005
- 'El informe no nombro ningun tramo de servicio. Todo se leyo como el tramo por defecto. Anade group_by[]=service_tier si parte de este uso corre en otro.',
2008
+ '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
2009
  mixed: (rows, tokens, cacheWrites) =>
2007
- `${rows} fila(s) traian tokens de audio o imagen, para los que una tarifa de texto no es la tarifa. Cada una se redujo a su parte de texto; ${tokens} token(s) de audio e imagen no estan en ninguna linea de la salida${cacheWrites > 0 ? `, y ${cacheWrites} token(s) de escritura de cache de esas filas se quedaron fuera tambien, porque el informe no les da modalidad` : ''}.`,
2010
+ `${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` : ''}.`,
2011
+ cacheWrite12h: (tokens) =>
2012
+ `${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
2013
  unsplit: (count) =>
2009
- `${count} fila(s) traian tokens de audio o imagen y ningun desglose de texto por el que reducirlas, y no estan en la salida. Cobrarlas a tarifa de texto seria adivinar.`,
2014
+ `${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
2015
  truncated: () =>
2011
- 'El informe dice has_more: true. Esto es una pagina de varias y una factura hecha con ella se queda corta. Sigue next_page hasta que has_more sea false, y convierte cada pagina.',
2016
+ '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
2017
  unparseable: () =>
2013
2018
  'Eso no es el JSON que devuelve GET /v1/organization/usage/completions. Pasa el cuerpo de la respuesta entero, no un campo suyo.',
2014
2019
  labelledByProject: (count) => `${count} fila(s) tomaron su etiqueta del mapeo de proyectos.`,
2015
2020
  unruledProject: (count) =>
2016
- `${count} fila(s) traian un proyecto que ninguna regla nombra. Conservan --label si lo diste y quedan sin atribuir si no: un proyecto para el que nadie escribio una regla esta mejor sin atribuir que atribuido al vecino.`,
2021
+ `${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
2022
  projectNotGrouped: () =>
2018
- 'Diste un mapeo de proyectos y ninguna fila traia id de proyecto, asi que el reparto que pediste no se hizo. Anade group_by[]=project_id.',
2023
+ '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
2024
  rulesUnreadable: (file) =>
2020
2025
  `${file}: no se puede leer como mapeo de proyectos. Es un array JSON de {"project": "proj_…", "label": "nombre"}.`,
2021
2026
  ruleBad: (file, at) =>
2022
- `${file}: la entrada ${at} no es una regla. Cada una necesita un id en "project" y una "label", ambos cadenas no vacias.`,
2027
+ `${file}: la entrada ${at} no es una regla. Cada una necesita un id en "project" y una "label", ambos cadenas no vacías.`,
2023
2028
  rulesEmpty: (file) =>
2024
- `${file}: no hay reglas dentro. Pasaste --label-by-project para repartir algo, y un archivo vacio repartiria nada en silencio.`,
2029
+ `${file}: no hay reglas dentro. Pasaste --label-by-project para repartir algo, y un archivo vacío repartiría nada en silencio.`,
2025
2030
  written: (file) => `Escrito ${file}.`,
2026
2031
  },
2027
2032
 
2028
2033
  bill: {
2029
- noPath: () => 'bill necesita un archivo o un directorio que leer: trazum bill ~/.claude/projects',
2034
+ noPath: (tried) =>
2035
+ `bill necesita un archivo o un directorio que leer, y no encontró ninguna carpeta de Claude Code en ${tried}. Indica una: trazum bill ~/.claude/projects, o trazum bill uso.jsonl.`,
2036
+ defaultPath: (dirs) => `Sin ruta, así que leo la carpeta propia de Claude Code: ${dirs}`,
2037
+ labelledByProject: (files) =>
2038
+ `${files} transcripción(es) de Claude Code etiquetada(s) por su carpeta de proyecto. --label pone una sola etiqueta, --no-label-from-project las deja sin etiqueta.`,
2039
+ unknownMore: (count) => `${count} archivo(s) más que ninguna forma reclama, sin adivinar y fuera de la factura.`,
2040
+ shapeSummary: (shape, files, records, leftOut) =>
2041
+ `${files} archivo(s): ${shape}${records === null ? ', leídos tal cual' : `, ${records} registro(s)`}${leftOut > 0 ? `, ${leftOut} fila(s) fuera. trazum from-${shape} sobre un archivo dice por qué.` : '.'}`,
2042
+ statementHeading: () => 'Tu factura',
2043
+ statementTotal: (usd, calls) => `${usd} en ${calls.toLocaleString('es-ES')} llamada(s) con precio`,
2044
+ colProject: () => 'proyecto',
2045
+ colWorkload: () => 'carga',
2046
+ colModel: () => 'modelo',
2047
+ colCalls: () => 'llamadas',
2048
+ colShare: () => 'parte',
2049
+ moreRows: (count) => `… y ${count} más`,
2050
+ statementUnpriced: (models, calls) =>
2051
+ `Fuera del total: ${calls} llamada(s) a ${models}, que el catálogo no tiene con precio. Se nombran, nunca se cuentan como $0.`,
2052
+ statementUnread: (lines) => `${lines} línea(s) no se pudieron leer como uso y no están en el total.`,
2053
+ statementNext: () =>
2054
+ 'El recibo como datos: --receipt, o -o recibo.json. El documento para quien paga: --pdf-out factura.pdf.',
2030
2055
  notFound: (path) => `${path}: no encontrado`,
2031
2056
  noFiles: (path) => `${path}: no hay archivos .json, .jsonl, .ndjson ni .log dentro, ni sin comprimir ni en .gz.`,
2032
2057
  file: (path, shape, records, leftOut) =>
2033
- `${path}: ${shape}${records === null ? ', leido tal cual' : `, ${records} registro(s)`}${leftOut > 0 ? `, ${leftOut} fila(s) fuera. Ejecuta trazum from-${shape} sobre el para ver por que.` : '.'}`,
2058
+ `${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é.` : '.'}`,
2034
2059
  unknown: (path) =>
2035
- `${path}: ninguna forma que esta herramienta lee lo reclama, asi que no se adivino y no esta en la factura.`,
2060
+ `${path}: ninguna forma que esta herramienta lee lo reclama, así que no se adivinó y no está en la factura.`,
2036
2061
  ambiguous: (path, shapes) =>
2037
- `${path}: lo reclama mas de una forma (${shapes}), asi que no se convirtio. Ejecuta el comando from-<forma> dedicado y di cual.`,
2062
+ `${path}: lo reclama más de una forma (${shapes}), así que no se convirtió. Ejecuta el comando from-<forma> dedicado y di cuál.`,
2038
2063
  costReport: (path) =>
2039
2064
  `${path}: un informe de costes de proveedor, que es una factura y no uso. Ponlo junto a un recibo con trazum reconcile.`,
2040
- nothingRead: () => 'Nada de esto era una fuente de uso que esta herramienta lea, asi que no hay nada que facturar.',
2041
- sources: (read, seen) => `${read} de ${seen} archivo(s) leido(s) como uso.`,
2065
+ nothingRead: () => 'Nada de esto era una fuente de uso que esta herramienta lea, así que no hay nada que facturar.',
2066
+ sources: (read, seen) => `${read} de ${seen} archivo(s) leído(s) como uso.`,
2042
2067
  pricingLiveHint: (count) =>
2043
- `${count} id(s) de modelo sin precio son slugs de OpenRouter, que el catalogo incluido no trae. Vuelve a ejecutar con --pricing-live para cobrarlos desde la propia lista de OpenRouter.`,
2068
+ `${count} id(s) de modelo sin precio son slugs de OpenRouter, que el catálogo incluido no trae. Vuelve a ejecutar con --pricing-live para cobrarlos desde la propia lista de OpenRouter.`,
2044
2069
  written: (file) => `Escrito ${file}.`,
2045
2070
  },
2046
2071
 
2047
2072
  fromOpenrouter: {
2048
2073
  noPath: () =>
2049
- 'from-openrouter necesita el informe de actividad que produjo tu propio curl: trazum from-openrouter activity.json --label facturacion',
2074
+ 'from-openrouter necesita el informe de actividad que produjo tu propio curl: trazum from-openrouter activity.json --label facturación',
2050
2075
  notFound: (path) => `${path}: no encontrado`,
2051
2076
  summary: (rows, days, requests) =>
2052
- `${rows} fila(s) de actividad leida(s) en ${days} dia(s), que cubren ${requests} peticion(es).`,
2077
+ `${rows} fila(s) de actividad leída(s) en ${days} día(s), que cubren ${requests} petición(es).`,
2053
2078
  reportedUsage: (usd, byokUsd) =>
2054
- `OpenRouter dice que cobro $${usd.toFixed(4)}${byokUsd > 0 ? ` mas $${byokUsd.toFixed(4)} facturados aguas arriba con tus propias claves` : ''}. Esa cifra es de OpenRouter, impresa junto a la de Trazum y nunca sumada a ella: dos tablas de precios en una sola cifra es como un informe se vuelve silenciosamente falso.`,
2079
+ `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.`,
2055
2080
  reasoning: (tokens) =>
2056
- `${tokens} token(s) de razonamiento estan en este informe y no se anadieron a ningun registro: el esquema no dice si completion_tokens ya los incluye, y anadirlos si es asi cobraria el razonamiento dos veces.`,
2081
+ `${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.`,
2057
2082
  unnamedModel: (count) =>
2058
- `${count} fila(s) no nombraron modelo y no estan en la salida: nada en la fila dice que respondio.`,
2083
+ `${count} fila(s) no nombraron modelo y no están en la salida: nada en la fila dice qué respondió.`,
2059
2084
  undated: (count) =>
2060
- `${count} fila(s) traian una fecha que no es un dia YYYY-MM-DD y no estan en la salida.`,
2085
+ `${count} fila(s) traían una fecha que no es un día YYYY-MM-DD y no están en la salida.`,
2061
2086
  unparseable: () =>
2062
2087
  'Eso no es el JSON que devuelve GET /api/v1/activity. Pasa el cuerpo de la respuesta entero, no un campo suyo.',
2063
2088
  labelledByWorkspace: (count) => `${count} fila(s) tomaron su etiqueta del mapeo de workspaces.`,
2064
2089
  unruledWorkspace: (count) =>
2065
- `${count} fila(s) traian un workspace que ninguna regla nombra. Conservan --label si lo diste y quedan sin atribuir si no.`,
2090
+ `${count} fila(s) traían un workspace que ninguna regla nombra. Conservan --label si lo diste y quedan sin atribuir si no.`,
2066
2091
  workspaceNotGrouped: () =>
2067
- 'Diste un mapeo de workspaces y ninguna fila traia id de workspace, asi que el reparto que pediste no se hizo. Pide el informe con group_by=workspace.',
2092
+ '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.',
2068
2093
  rulesUnreadable: (file) =>
2069
2094
  `${file}: no se puede leer como mapeo de workspaces. Es un array JSON de {"workspace": "…", "label": "nombre"}.`,
2070
2095
  ruleBad: (file, at) =>
2071
- `${file}: la entrada ${at} no es una regla. Cada una necesita un id en "workspace" y una "label", ambos cadenas no vacias.`,
2096
+ `${file}: la entrada ${at} no es una regla. Cada una necesita un id en "workspace" y una "label", ambos cadenas no vacías.`,
2072
2097
  rulesEmpty: (file) =>
2073
- `${file}: no hay reglas dentro. Pasaste --label-by-workspace para repartir algo, y un archivo vacio repartiria nada en silencio.`,
2098
+ `${file}: no hay reglas dentro. Pasaste --label-by-workspace para repartir algo, y un archivo vacío repartiría nada en silencio.`,
2074
2099
  written: (file) => `Escrito ${file}.`,
2075
2100
  },
2076
2101
 
@@ -2780,14 +2805,18 @@ ${bold('EJEMPLOS')}
2780
2805
  '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.',
2781
2806
  assumedWriteTtl: (calls) =>
2782
2807
  `${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.`,
2808
+ tierCeiling: (rows, models, ceiling, floor) =>
2809
+ `${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.`,
2783
2810
  spanLine: (from, to, days) =>
2784
- `Este registro abarca ${from} → ${to} (${days} días). El periodo se declara, nunca se extrapola: la aritmética mensual es tuya, y ahora es válida.`,
2811
+ `Este registro abarca ${from} → ${to} (${days} días): declarado, nunca extrapolado. Escálalo tú a un mes, ahora que sabes qué cubre.`,
2785
2812
  spanPartial: (withTs, total) =>
2786
2813
  `Solo ${withTs} de ${total} llamadas llevan marca de tiempo; el periodo describe esas.`,
2787
2814
  ttlFitExpires: (label, model, gap) =>
2788
2815
  `${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í.`,
2789
2816
  ttlFitExpiresBoth: (label, model, gap) =>
2790
2817
  `${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.`,
2818
+ ttlFitExpiresOnly: (label, model, gap, ttl) =>
2819
+ `${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.`,
2791
2820
  ttlFitOverlong: (label, model, gap, usd) =>
2792
2821
  `${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.`,
2793
2822
  ttlFitUnsettledGap: (label, model, gap) =>
@@ -2865,6 +2894,8 @@ ${bold('EJEMPLOS')}
2865
2894
  whatIfCheaper: () =>
2866
2895
  'Compruébalo antes de mover nada: trazum route mide un prompt contra ambos modelos con tus propios ejemplos.',
2867
2896
  whatIfDearer: () => 'Esa dirección cuesta más. La aritmética está aquí para que el número no sea una suposición.',
2897
+ whatIfTierCeiling: (slices, target, floor) =>
2898
+ `${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}.`,
2868
2899
  whatIfBatchOnTarget: (batched, moved) =>
2869
2900
  `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.`,
2870
2901
  whatIfCacheBeyond: (largest, min, noCache) =>
package/src/i18n/types.ts CHANGED
@@ -137,6 +137,8 @@ export interface CliMessages {
137
137
  * tool when the answer ships under the same scope is a worse refusal than
138
138
  * the one it replaced.
139
139
  */
140
+ /** The optional counter is installed and has no rank table for this model. */
141
+ exactTokensNoEncoding(model: string, packageName: string, known: string): string;
140
142
  exactTokensNeedsPackage(model: string, packageName: string): string;
141
143
  checkNeedsMaxTokens(): string;
142
144
  evalNeedsCases(): string;
@@ -710,6 +712,8 @@ export interface CliMessages {
710
712
  tierUnknown(): string;
711
713
  /** Rows reduced to their text part; audio and image tokens set aside. */
712
714
  mixed(rows: number, tokens: number, cacheWrites: number): string;
715
+ /** 12-hour cache writes: in the prompt total at the plain input rate, a floor. */
716
+ cacheWrite12h(tokens: number): string;
713
717
  /** Mixed rows the report gave no text split for, refused whole. */
714
718
  unsplit(count: number): string;
715
719
  truncated(): string;
@@ -724,7 +728,28 @@ export interface CliMessages {
724
728
  };
725
729
 
726
730
  bill: {
727
- noPath(): string;
731
+ /** No path given and no Claude Code folder where Claude Code keeps one. */
732
+ noPath(tried: string): string;
733
+ /** No path given: the folders found and read instead, named. */
734
+ defaultPath(dirs: string): string;
735
+ /** Claude Code sessions took their label from their project folder. */
736
+ labelledByProject(files: number): string;
737
+ /** The unclaimed files past the first few, counted rather than listed. */
738
+ unknownMore(count: number): string;
739
+ /** Many files of one shape: one line for the shape, not one per file. */
740
+ shapeSummary(shape: string, files: number, records: number | null, leftOut: number): string;
741
+ /** The human statement a terminal gets instead of the JSON receipt. */
742
+ statementHeading(): string;
743
+ statementTotal(usd: string, calls: number): string;
744
+ colProject(): string;
745
+ colWorkload(): string;
746
+ colModel(): string;
747
+ colCalls(): string;
748
+ colShare(): string;
749
+ moreRows(count: number): string;
750
+ statementUnpriced(models: string, calls: number): string;
751
+ statementUnread(lines: number): string;
752
+ statementNext(): string;
728
753
  notFound(path: string): string;
729
754
  noFiles(path: string): string;
730
755
  /** One line per file: its shape, what it became, what was left out. */
@@ -1477,6 +1502,12 @@ export interface CliMessages {
1477
1502
  truncationRetryNote(): string;
1478
1503
  inputFullRate(): string;
1479
1504
  assumedWriteTtl(calls: number): string;
1505
+ /**
1506
+ * Rows billed at the dearer of two rates: a model priced by prompt length,
1507
+ * and rows that sum requests without giving one prompt's length. The total
1508
+ * is a ceiling on them, and the cheaper figure is printed beside it.
1509
+ */
1510
+ tierCeiling(rows: number, models: string, ceiling: string, floor: string): string;
1480
1511
  /**
1481
1512
  * The period the log covers, when its records carry a clock. Stated and
1482
1513
  * never extrapolated: naming the span makes the reader's own monthly
@@ -1495,6 +1526,8 @@ export interface CliMessages {
1495
1526
  */
1496
1527
  ttlFitExpires(label: string, model: string, gap: string): string;
1497
1528
  ttlFitExpiresBoth(label: string, model: string, gap: string): string;
1529
+ /** A provider that sells one kind of entry: there is no longer TTL to suggest. */
1530
+ ttlFitExpiresOnly(label: string, model: string, gap: string, ttl: string): string;
1498
1531
  ttlFitOverlong(label: string, model: string, gap: string, usd: string): string;
1499
1532
  ttlFitUnsettledGap(label: string, model: string, gap: string): string;
1500
1533
  ttlFitFits(label: string, model: string, gap: string): string;
@@ -1726,6 +1759,8 @@ export interface CliMessages {
1726
1759
  * summed with the move.
1727
1760
  */
1728
1761
  whatIfBatchOnTarget(batched: string, moved: string): string;
1762
+ /** The target is priced by prompt length and some slices could not be placed in a band. */
1763
+ whatIfTierCeiling(slices: number, target: string, floor: string): string;
1729
1764
  whatIfCacheBeyond(largest: string, min: string, noCache: string): string;
1730
1765
  whatIfSlice(label: string, model: string, current: string, target: string): string;
1731
1766
  /** A call the target's context window could not have accepted. */