@trazum/cli 2.4.3 → 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/dist/i18n/es.js CHANGED
@@ -199,30 +199,30 @@ ${bold('OPCIONES DE reconcile')}
199
199
  GET /v1/organizations/cost_report de Anthropic o
200
200
  el GET /v1/organization/costs de OpenAI, que se
201
201
  distinguen por su forma.
202
- -o, --out <archivo> Escribe la comparacion ahi en vez de en stdout.
202
+ -o, --out <archivo> Escribe la comparación ahí en vez de en stdout.
203
203
 
204
- Lo que Trazum calculo junto a lo que el proveedor facturo, nunca sumado:
204
+ Lo que Trazum calculo junto a lo que el proveedor facturó, nunca sumado:
205
205
  dos tablas de precios en una sola cifra es como un informe se vuelve
206
206
  silenciosamente falso. Descarga el de Anthropic con group_by[]=description
207
207
  y el de OpenAI con group_by[]=line_item, y la diferencia queda atribuida -
208
208
  lo que ninguna tarifa por token cubre, y en Anthropic lo que fue batch -
209
- dejando un resto que es la unica cifra que merece discusion. El informe de
210
- OpenAI nunca nombra batch, asi que ahi se queda dentro del resto y la
211
- ejecucion lo dice. Las ventanas deben coincidir o no se compara nada, y una
209
+ dejando un resto que es la única cifra que merece discusión. El informe de
210
+ OpenAI nunca nombra batch, así que ahí se queda dentro del resto y la
211
+ ejecución lo dice. Las ventanas deben coincidir o no se compara nada, y una
212
212
  moneda sin tipo de cambio se rechaza en vez de convertirse.
213
213
 
214
214
  ${bold('OPCIONES DE from-anthropic')}
215
215
  --label <nombre> El proyecto al que pertenece este uso. El
216
216
  proveedor no conoce tus nombres de proyecto.
217
- -o, --out <archivo> Escribe el log de uso ahi en vez de en stdout.
217
+ -o, --out <archivo> Escribe el log de uso ahí en vez de en stdout.
218
218
 
219
- El informe de uso de Anthropic, leido como log. Lo descargas tu con tu propia
220
- credencial de admin; esto lee la respuesta, asi que Trazum nunca sostiene una
219
+ El informe de uso de Anthropic, leído como log. Lo descargas tú con tu propia
220
+ credencial de admin; esto lee la respuesta, así que Trazum nunca sostiene una
221
221
  clave de proveedor. Pide group_by[]=model, porque una fila sin modelo no se
222
222
  puede cobrar, y group_by[]=service_tier, porque batch se factura con
223
- descuento y cobrarlo a tarifa de catalogo inflaria la factura. Las filas de
224
- cualquier otro tramo se quedan fuera y se cuentan, las busquedas web se
225
- cuentan y nunca se cobran por token, y has_more avisa de que falta pagina.
223
+ descuento y cobrarlo a tarifa de catálogo inflaría la factura. Las filas de
224
+ cualquier otro tramo se quedan fuera y se cuentan, las búsquedas web se
225
+ cuentan y nunca se cobran por token, y has_more avisa de que falta página.
226
226
 
227
227
  ${bold('OPCIONES DE from-openai')}
228
228
  --label <nombre> El proyecto al que pertenece este uso. El
@@ -230,13 +230,13 @@ ${bold('OPCIONES DE from-openai')}
230
230
  --label-by-project <archivo> Una etiqueta por id de proyecto, como array JSON
231
231
  de {"project": "proj_…", "label": "nombre"}.
232
232
  Coincidencia exacta; --label es el respaldo.
233
- -o, --out <archivo> Escribe el log de uso ahi en vez de en stdout.
233
+ -o, --out <archivo> Escribe el log de uso ahí en vez de en stdout.
234
234
 
235
- El informe de uso de OpenAI, leido como log, con el mismo arreglo que
235
+ El informe de uso de OpenAI, leído como log, con el mismo arreglo que
236
236
  from-anthropic: tu curl, tu clave de admin, y esto lee la respuesta. Pide
237
237
  group_by[]=model, porque una fila sin modelo no se puede cobrar, y
238
238
  group_by[]=batch, porque un trabajo por lotes se factura con descuento y
239
- cobrarlo a tarifa de catalogo inflaria la factura. Cualquier tramo de
239
+ cobrarlo a tarifa de catálogo inflaría la factura. Cualquier tramo de
240
240
  servicio que no sea default se queda fuera y se nombra. Los tokens de audio
241
241
  e imagen nunca se cobran a tarifa de texto: una fila que los trae se reduce
242
242
  a su parte de texto y el resto se cuenta donde puedas verlo.
@@ -244,18 +244,18 @@ ${bold('OPCIONES DE from-openai')}
244
244
  ${bold('OPCIONES DE bill')}
245
245
  --label <nombre> El proyecto al que pertenece este uso, para las
246
246
  formas que lo admiten.
247
- --stamp Sella el recibo con la hora en que se escribio.
248
- -o, --out <archivo> Escribe el recibo ahi en vez de en stdout.
247
+ --stamp Sella el recibo con la hora en que se escribió.
248
+ -o, --out <archivo> Escribe el recibo ahí en vez de en stdout.
249
249
 
250
250
  Una sola puerta. Lee un archivo o un directorio, reconoce la forma de cada
251
- archivo por su propio texto - una transcripcion de Claude Code, spans OTel,
251
+ archivo por su propio texto - una transcripción de Claude Code, spans OTel,
252
252
  un export de LiteLLM, Helicone o LangSmith, un informe de Anthropic, OpenAI
253
253
  u OpenRouter, o un log de uso plano - lo convierte con el mismo conversor
254
254
  que usa el comando dedicado, lo cobra y termina en el recibo. Un archivo
255
255
  que ninguna forma reclama se nombra, no se adivina; uno que reclaman dos se
256
256
  nombra como ambiguo y se deja en paz; un informe de costes de proveedor se
257
- remite a reconcile. La linea de cada archivo dice cuantas filas quedaron
258
- fuera, y el comando from-<forma> dedicado dice por que.
257
+ remite a reconcile. La línea de cada archivo dice cuántas filas quedaron
258
+ fuera, y el comando from-<forma> dedicado dice por qué.
259
259
 
260
260
  ${bold('OPCIONES DE from-openrouter')}
261
261
  --label <nombre> El proyecto al que pertenece este uso.
@@ -263,14 +263,14 @@ ${bold('OPCIONES DE from-openrouter')}
263
263
  JSON de {"workspace": "…", "label": "nombre"}.
264
264
  Coincidencia exacta; --label es el respaldo.
265
265
  Requiere el informe pedido con group_by=workspace.
266
- -o, --out <archivo> Escribe el log de uso ahi en vez de en stdout.
266
+ -o, --out <archivo> Escribe el log de uso ahí en vez de en stdout.
267
267
 
268
268
  El informe de actividad de OpenRouter (GET /api/v1/activity, clave de
269
- gestion, los ultimos treinta dias), leido como log de uso con los mismos
270
- slugs de modelo que usa el overlay de precios de OpenRouter, asi que cientos
271
- de modelos se pueden cobrar de golpe. Lo que OpenRouter cobro se imprime
269
+ gestión, los últimos treinta días), leído como log de uso con los mismos
270
+ slugs de modelo que usa el overlay de precios de OpenRouter, así que cientos
271
+ de modelos se pueden cobrar de golpe. Lo que OpenRouter cobró se imprime
272
272
  junto a la cifra de Trazum y nunca se suma a ella. Los tokens de razonamiento
273
- se cuentan y no se anaden, porque el esquema no dice si el recuento de
273
+ se cuentan y no se añaden, porque el esquema no dice si el recuento de
274
274
  completado ya los incluye.
275
275
 
276
276
  ${bold('OPCIONES DE from-helicone')}
@@ -1190,6 +1190,8 @@ ${bold('EJEMPLOS')}
1190
1190
  exactTokensWrongFamily: (model, provider) => `--exact-tokens cuenta con el endpoint de Anthropic, que cuenta el tokenizador de Claude${provider === null
1191
1191
  ? `, y el catálogo no registra proveedor para "${model}": qué tokenizador usa no es algo que Trazum sepa`
1192
1192
  : `, 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}.`,
1193
+ 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}). ` +
1194
+ '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
1195
  exactTokensNeedsPackage: (model, packageName) => `--exact-tokens puede contar ${model} de forma exacta, sin conexión y sin clave, pero ` +
1194
1196
  `necesita ${packageName}, que no está instalado. Es un paquete aparte porque sus tablas ` +
1195
1197
  'de rangos ocupan veintidós megabytes y @trazum/core no depende de nada.\n' +
@@ -1519,7 +1521,7 @@ ${bold('EJEMPLOS')}
1519
1521
  : 'No se puede decir: esta escalera no declara valores de escalado.',
1520
1522
  problemsHeading: (label) => `${label}: esta escalera no va a hacer lo que parece`,
1521
1523
  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 funcion\u00f3, en cada llamada, con el aspecto exacto de una medida de ahorro.`
1524
+ ? `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
1525
  : kind === 'escalate-on-undeclared'
1524
1526
  ? `escalateOn nombra "${detail}", que "outcomes.values" no declara. Esta escalera no se dispara nunca, en silencio.`
1525
1527
  : kind === 'tiers-not-cheapest-first'
@@ -1693,58 +1695,59 @@ ${bold('EJEMPLOS')}
1693
1695
  notAReceipt: (file) => `${file}: no es un recibo. Necesita total.usd y span.fromMs/toMs, que es lo que escribe «trazum receipt».`,
1694
1696
  reportUnreadable: (file) => `${file}: no encontrado.`,
1695
1697
  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 calculo $${computed.toFixed(2)}; el proveedor facturo $${billed.toFixed(2)}. Diferencia: $${difference.toFixed(2)}.`,
1697
- notTokens: (usd) => `$${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.`,
1698
- batch: (usd) => `$${usd.toFixed(2)} es del tramo batch, que from-anthropic deja fuera en vez de cobrarlo a tarifa de catalogo.`,
1699
- remainder: (usd) => `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.`,
1700
- notAttributable: () => '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.',
1701
- notAttributableByLineItem: () => '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.',
1702
- batchNotSeparable: () => '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.',
1703
- unknownUnit: (usd) => `$${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.`,
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 dias es una cifra equivocada bajo un titulo correcto, asi que no se comparo nada.`,
1705
- noBilledWindow: () => 'El informe de costes no tiene intervalos, asi que no hay ventana contra la que comparar.',
1706
- otherCurrency: (list) => `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.`,
1707
- truncated: () => '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.',
1708
- unreadableAmount: (count) => `${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.`,
1698
+ summary: (computed, billed, difference) => `Trazum calculó $${computed.toFixed(2)}; el proveedor facturó $${billed.toFixed(2)}. Diferencia: $${difference.toFixed(2)}.`,
1699
+ 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.`,
1700
+ batch: (usd) => `$${usd.toFixed(2)} es del tramo batch, que from-anthropic deja fuera en vez de cobrarlo a tarifa de catálogo.`,
1701
+ 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.`,
1702
+ 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.',
1703
+ 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.',
1704
+ 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.',
1705
+ 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ó.`,
1706
+ 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.`,
1707
+ noBilledWindow: () => 'El informe de costes no tiene intervalos, así que no hay ventana contra la que comparar.',
1708
+ 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.`,
1709
+ 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.',
1710
+ 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
1711
  written: (file) => `Escrito ${file}.`,
1710
1712
  },
1711
1713
  fromAnthropic: {
1712
- noPath: () => 'from-anthropic necesita el informe de uso que produjo tu propio curl: trazum from-anthropic usage.json --label facturacion',
1714
+ noPath: () => 'from-anthropic necesita el informe de uso que produjo tu propio curl: trazum from-anthropic usage.json --label facturación',
1713
1715
  notFound: (path) => `${path}: no encontrado`,
1714
- summary: (buckets, rows) => `${buckets} intervalo(s), ${rows} fila(s) de uso leida(s).`,
1715
- unnamedModel: (count) => `${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.`,
1716
- nonStandardTier: (count) => `${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.`,
1717
- tierUnknown: () => '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.',
1718
- webSearch: (count) => `${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.`,
1719
- truncated: () => '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.',
1716
+ summary: (buckets, rows) => `${buckets} intervalo(s), ${rows} fila(s) de uso leída(s).`,
1717
+ 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.`,
1718
+ 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.`,
1719
+ 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.',
1720
+ 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.`,
1721
+ 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
1722
  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
1723
  labelledByWorkspace: (count) => `${count} fila(s) tomaron su etiqueta del mapeo de workspaces.`,
1722
- unruledWorkspace: (count) => `${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.`,
1723
- workspaceNotGrouped: () => '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.',
1724
+ 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.`,
1725
+ 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
1726
  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 decision.`,
1726
- rulesEmpty: (file) => `${file}: no hay reglas dentro. Pasaste --label-by-workspace para repartir algo, y un archivo vacio repartiria nada en silencio.`,
1727
+ 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.`,
1728
+ 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
1729
  written: (file) => `Escrito ${file}.`,
1728
1730
  },
1729
1731
  fromOpenai: {
1730
- noPath: () => 'from-openai necesita el informe de uso que produjo tu propio curl: trazum from-openai usage.json --label facturacion',
1732
+ noPath: () => 'from-openai necesita el informe de uso que produjo tu propio curl: trazum from-openai usage.json --label facturación',
1731
1733
  notFound: (path) => `${path}: no encontrado`,
1732
- summary: (buckets, rows, requests) => `${buckets} intervalo(s), ${rows} fila(s) de uso leida(s), que cubren ${requests} peticion(es).`,
1733
- unnamedModel: (count) => `${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.`,
1734
- batch: (count) => `${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.`,
1735
- batchUnknown: () => '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.',
1736
- nonDefaultTier: (count, tiers) => `${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.`,
1737
- tierUnknown: () => '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.',
1738
- mixed: (rows, tokens, cacheWrites) => `${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` : ''}.`,
1739
- unsplit: (count) => `${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.`,
1740
- truncated: () => '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.',
1734
+ summary: (buckets, rows, requests) => `${buckets} intervalo(s), ${rows} fila(s) de uso leída(s), que cubren ${requests} petición(es).`,
1735
+ 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.`,
1736
+ 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.`,
1737
+ 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.',
1738
+ 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.`,
1739
+ 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.',
1740
+ 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` : ''}.`,
1741
+ 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.`,
1742
+ 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.`,
1743
+ 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
1744
  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
1745
  labelledByProject: (count) => `${count} fila(s) tomaron su etiqueta del mapeo de proyectos.`,
1743
- unruledProject: (count) => `${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.`,
1744
- projectNotGrouped: () => '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.',
1746
+ 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.`,
1747
+ 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
1748
  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 vacias.`,
1747
- rulesEmpty: (file) => `${file}: no hay reglas dentro. Pasaste --label-by-project para repartir algo, y un archivo vacio repartiria nada en silencio.`,
1749
+ 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.`,
1750
+ 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
1751
  written: (file) => `Escrito ${file}.`,
1749
1752
  },
1750
1753
  bill: {
@@ -1766,30 +1769,30 @@ ${bold('EJEMPLOS')}
1766
1769
  statementNext: () => 'El recibo como datos: --receipt, o -o recibo.json. El documento para quien paga: --pdf-out factura.pdf.',
1767
1770
  notFound: (path) => `${path}: no encontrado`,
1768
1771
  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 ? ', leido tal cual' : `, ${records} registro(s)`}${leftOut > 0 ? `, ${leftOut} fila(s) fuera. Ejecuta trazum from-${shape} sobre el para ver por que.` : '.'}`,
1770
- unknown: (path) => `${path}: ninguna forma que esta herramienta lee lo reclama, asi que no se adivino y no esta en la factura.`,
1771
- ambiguous: (path, shapes) => `${path}: lo reclama mas de una forma (${shapes}), asi que no se convirtio. Ejecuta el comando from-<forma> dedicado y di cual.`,
1772
+ 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é.` : '.'}`,
1773
+ unknown: (path) => `${path}: ninguna forma que esta herramienta lee lo reclama, así que no se adivinó y no está en la factura.`,
1774
+ 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
1775
  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, asi que no hay nada que facturar.',
1774
- sources: (read, seen) => `${read} de ${seen} archivo(s) leido(s) como uso.`,
1775
- pricingLiveHint: (count) => `${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.`,
1776
+ nothingRead: () => 'Nada de esto era una fuente de uso que esta herramienta lea, así que no hay nada que facturar.',
1777
+ sources: (read, seen) => `${read} de ${seen} archivo(s) leído(s) como uso.`,
1778
+ pricingLiveHint: (count) => `${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.`,
1776
1779
  written: (file) => `Escrito ${file}.`,
1777
1780
  },
1778
1781
  fromOpenrouter: {
1779
- noPath: () => 'from-openrouter necesita el informe de actividad que produjo tu propio curl: trazum from-openrouter activity.json --label facturacion',
1782
+ noPath: () => 'from-openrouter necesita el informe de actividad que produjo tu propio curl: trazum from-openrouter activity.json --label facturación',
1780
1783
  notFound: (path) => `${path}: no encontrado`,
1781
- summary: (rows, days, requests) => `${rows} fila(s) de actividad leida(s) en ${days} dia(s), que cubren ${requests} peticion(es).`,
1782
- reportedUsage: (usd, byokUsd) => `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.`,
1783
- reasoning: (tokens) => `${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.`,
1784
- unnamedModel: (count) => `${count} fila(s) no nombraron modelo y no estan en la salida: nada en la fila dice que respondio.`,
1785
- undated: (count) => `${count} fila(s) traian una fecha que no es un dia YYYY-MM-DD y no estan en la salida.`,
1784
+ summary: (rows, days, requests) => `${rows} fila(s) de actividad leída(s) en ${days} día(s), que cubren ${requests} petición(es).`,
1785
+ 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.`,
1786
+ 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.`,
1787
+ unnamedModel: (count) => `${count} fila(s) no nombraron modelo y no están en la salida: nada en la fila dice qué respondió.`,
1788
+ 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
1789
  unparseable: () => 'Eso no es el JSON que devuelve GET /api/v1/activity. Pasa el cuerpo de la respuesta entero, no un campo suyo.',
1787
1790
  labelledByWorkspace: (count) => `${count} fila(s) tomaron su etiqueta del mapeo de workspaces.`,
1788
- unruledWorkspace: (count) => `${count} fila(s) traian un workspace que ninguna regla nombra. Conservan --label si lo diste y quedan sin atribuir si no.`,
1789
- workspaceNotGrouped: () => '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.',
1791
+ unruledWorkspace: (count) => `${count} fila(s) traían un workspace que ninguna regla nombra. Conservan --label si lo diste y quedan sin atribuir si no.`,
1792
+ 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
1793
  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 vacias.`,
1792
- rulesEmpty: (file) => `${file}: no hay reglas dentro. Pasaste --label-by-workspace para repartir algo, y un archivo vacio repartiria nada en silencio.`,
1794
+ 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.`,
1795
+ 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
1796
  written: (file) => `Escrito ${file}.`,
1794
1797
  },
1795
1798
  fromHelicone: {
@@ -2306,10 +2309,12 @@ ${bold('EJEMPLOS')}
2306
2309
  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
2310
  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
2311
  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
- spanLine: (from, to, days) => `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.`,
2312
+ 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.`,
2313
+ 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
2314
  spanPartial: (withTs, total) => `Solo ${withTs} de ${total} llamadas llevan marca de tiempo; el periodo describe esas.`,
2311
2315
  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
2316
  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.`,
2317
+ 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
2318
  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
2319
  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
2320
  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 +2357,7 @@ ${bold('EJEMPLOS')}
2352
2357
  whatIfTotal: (current, target, delta) => `${current} de gasto movible habrían sido ${target}, una diferencia de ${delta}.`,
2353
2358
  whatIfCheaper: () => 'Compruébalo antes de mover nada: trazum route mide un prompt contra ambos modelos con tus propios ejemplos.',
2354
2359
  whatIfDearer: () => 'Esa dirección cuesta más. La aritmética está aquí para que el número no sea una suposición.',
2360
+ 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
2361
  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
2362
  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
2363
  whatIfSlice: (label, model, current, target) => `${label} en ${model}: ${current} → ${target}`,