@trazum/cli 2.3.0 → 2.4.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/i18n/es.js CHANGED
@@ -38,9 +38,14 @@ ${bold('USO')}
38
38
  trazum rollup <documento...|dir> [--json] [--html-out <fichero>]
39
39
  trazum position <uso.jsonl>
40
40
  trazum receipt <uso.jsonl|dir> [--stamp] [-o <fichero>]
41
+ trazum bill <fichero|dir> [--label <nombre>] [--stamp] [-o <fichero>]
41
42
  trazum from-claude-code <fichero|dir> [--label <nombre>] [-o <fichero>]
42
43
  trazum from-otel <fichero|dir> [--label-from-service] [-o <fichero>]
43
44
  trazum from-litellm <fichero|dir> [-o <fichero>]
45
+ trazum from-anthropic <usage.json> [--label <name>] [--label-by-workspace <file>] [-o <file>]
46
+ trazum from-openai <usage.json> [--label <name>] [--label-by-project <file>] [-o <file>]
47
+ trazum from-openrouter <activity.json> [--label <name>] [--label-by-workspace <file>] [-o <file>]
48
+ trazum reconcile <receipt.json> --against <cost.json> [-o <file>]
44
49
  trazum from-helicone <fichero|dir> [-o <fichero>]
45
50
  trazum from-langsmith <fichero|dir> [-o <fichero>]
46
51
  trazum switch <uso.jsonl> --to <modelo> [--migration-usd <n>] [--cases <n>]
@@ -188,6 +193,85 @@ ${bold('OPCIONES DE ownrate')}
188
193
  en trazum.config.json, de modo que el modelo que tú mismo sirves sea una
189
194
  fila de primera en cada informe, tasado por ti y marcado como tal.
190
195
 
196
+ ${bold('OPCIONES DE reconcile')}
197
+ --against <archivo> El informe de costes del proveedor: el
198
+ GET /v1/organizations/cost_report de Anthropic o
199
+ el GET /v1/organization/costs de OpenAI, que se
200
+ distinguen por su forma.
201
+ -o, --out <archivo> Escribe la comparacion ahi en vez de en stdout.
202
+
203
+ Lo que Trazum calculo junto a lo que el proveedor facturo, nunca sumado:
204
+ dos tablas de precios en una sola cifra es como un informe se vuelve
205
+ silenciosamente falso. Descarga el de Anthropic con group_by[]=description
206
+ y el de OpenAI con group_by[]=line_item, y la diferencia queda atribuida -
207
+ lo que ninguna tarifa por token cubre, y en Anthropic lo que fue batch -
208
+ dejando un resto que es la unica cifra que merece discusion. El informe de
209
+ OpenAI nunca nombra batch, asi que ahi se queda dentro del resto y la
210
+ ejecucion lo dice. Las ventanas deben coincidir o no se compara nada, y una
211
+ moneda sin tipo de cambio se rechaza en vez de convertirse.
212
+
213
+ ${bold('OPCIONES DE from-anthropic')}
214
+ --label <nombre> El proyecto al que pertenece este uso. El
215
+ proveedor no conoce tus nombres de proyecto.
216
+ -o, --out <archivo> Escribe el log de uso ahi en vez de en stdout.
217
+
218
+ El informe de uso de Anthropic, leido como log. Lo descargas tu con tu propia
219
+ credencial de admin; esto lee la respuesta, asi que Trazum nunca sostiene una
220
+ clave de proveedor. Pide group_by[]=model, porque una fila sin modelo no se
221
+ puede cobrar, y group_by[]=service_tier, porque batch se factura con
222
+ descuento y cobrarlo a tarifa de catalogo inflaria la factura. Las filas de
223
+ cualquier otro tramo se quedan fuera y se cuentan, las busquedas web se
224
+ cuentan y nunca se cobran por token, y has_more avisa de que falta pagina.
225
+
226
+ ${bold('OPCIONES DE from-openai')}
227
+ --label <nombre> El proyecto al que pertenece este uso. El
228
+ proveedor no conoce tus nombres de proyecto.
229
+ --label-by-project <archivo> Una etiqueta por id de proyecto, como array JSON
230
+ de {"project": "proj_…", "label": "nombre"}.
231
+ Coincidencia exacta; --label es el respaldo.
232
+ -o, --out <archivo> Escribe el log de uso ahi en vez de en stdout.
233
+
234
+ El informe de uso de OpenAI, leido como log, con el mismo arreglo que
235
+ from-anthropic: tu curl, tu clave de admin, y esto lee la respuesta. Pide
236
+ group_by[]=model, porque una fila sin modelo no se puede cobrar, y
237
+ group_by[]=batch, porque un trabajo por lotes se factura con descuento y
238
+ cobrarlo a tarifa de catalogo inflaria la factura. Cualquier tramo de
239
+ servicio que no sea default se queda fuera y se nombra. Los tokens de audio
240
+ e imagen nunca se cobran a tarifa de texto: una fila que los trae se reduce
241
+ a su parte de texto y el resto se cuenta donde puedas verlo.
242
+
243
+ ${bold('OPCIONES DE bill')}
244
+ --label <nombre> El proyecto al que pertenece este uso, para las
245
+ formas que lo admiten.
246
+ --stamp Sella el recibo con la hora en que se escribio.
247
+ -o, --out <archivo> Escribe el recibo ahi en vez de en stdout.
248
+
249
+ Una sola puerta. Lee un archivo o un directorio, reconoce la forma de cada
250
+ archivo por su propio texto - una transcripcion de Claude Code, spans OTel,
251
+ un export de LiteLLM, Helicone o LangSmith, un informe de Anthropic, OpenAI
252
+ u OpenRouter, o un log de uso plano - lo convierte con el mismo conversor
253
+ que usa el comando dedicado, lo cobra y termina en el recibo. Un archivo
254
+ que ninguna forma reclama se nombra, no se adivina; uno que reclaman dos se
255
+ nombra como ambiguo y se deja en paz; un informe de costes de proveedor se
256
+ remite a reconcile. La linea de cada archivo dice cuantas filas quedaron
257
+ fuera, y el comando from-<forma> dedicado dice por que.
258
+
259
+ ${bold('OPCIONES DE from-openrouter')}
260
+ --label <nombre> El proyecto al que pertenece este uso.
261
+ --label-by-workspace <archivo> Una etiqueta por id de workspace, como array
262
+ JSON de {"workspace": "…", "label": "nombre"}.
263
+ Coincidencia exacta; --label es el respaldo.
264
+ Requiere el informe pedido con group_by=workspace.
265
+ -o, --out <archivo> Escribe el log de uso ahi en vez de en stdout.
266
+
267
+ El informe de actividad de OpenRouter (GET /api/v1/activity, clave de
268
+ gestion, los ultimos treinta dias), leido como log de uso con los mismos
269
+ slugs de modelo que usa el overlay de precios de OpenRouter, asi que cientos
270
+ de modelos se pueden cobrar de golpe. Lo que OpenRouter cobro se imprime
271
+ junto a la cifra de Trazum y nunca se suma a ella. Los tokens de razonamiento
272
+ se cuentan y no se anaden, porque el esquema no dice si el recuento de
273
+ completado ya los incluye.
274
+
191
275
  ${bold('OPCIONES DE from-helicone')}
192
276
  -o, --out <fichero> Escribe el log de uso ahí en vez de en stdout.
193
277
 
@@ -1591,6 +1675,97 @@ ${bold('EJEMPLOS')}
1591
1675
  unparseable: (count) => `${count} línea(s) no se pudieron parsear como JSON.`,
1592
1676
  written: (file) => `Escrito ${file}.`,
1593
1677
  },
1678
+ reconcile: {
1679
+ noReceipt: () => 'reconcile necesita un recibo y un informe de costes: trazum reconcile receipt.json --against cost.json',
1680
+ noReport: () => 'reconcile necesita --against <informe de costes>: el JSON del GET /v1/organizations/cost_report de Anthropic o del GET /v1/organization/costs de OpenAI.',
1681
+ receiptUnreadable: (file) => `${file}: no se puede leer como JSON.`,
1682
+ notAReceipt: (file) => `${file}: no es un recibo. Necesita total.usd y span.fromMs/toMs, que es lo que escribe «trazum receipt».`,
1683
+ reportUnreadable: (file) => `${file}: no encontrado.`,
1684
+ 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.`,
1685
+ summary: (computed, billed, difference) => `Trazum calculo $${computed.toFixed(2)}; el proveedor facturo $${billed.toFixed(2)}. Diferencia: $${difference.toFixed(2)}.`,
1686
+ 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.`,
1687
+ batch: (usd) => `$${usd.toFixed(2)} es del tramo batch, que from-anthropic deja fuera en vez de cobrarlo a tarifa de catalogo.`,
1688
+ 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.`,
1689
+ 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.',
1690
+ 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.',
1691
+ 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.',
1692
+ 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.`,
1693
+ 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.`,
1694
+ noBilledWindow: () => 'El informe de costes no tiene intervalos, asi que no hay ventana contra la que comparar.',
1695
+ 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.`,
1696
+ 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.',
1697
+ 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
+ written: (file) => `Escrito ${file}.`,
1699
+ },
1700
+ fromAnthropic: {
1701
+ noPath: () => 'from-anthropic necesita el informe de uso que produjo tu propio curl: trazum from-anthropic usage.json --label facturacion',
1702
+ notFound: (path) => `${path}: no encontrado`,
1703
+ summary: (buckets, rows) => `${buckets} intervalo(s), ${rows} fila(s) de uso leida(s).`,
1704
+ 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.`,
1705
+ 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.`,
1706
+ 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.',
1707
+ 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.`,
1708
+ 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.',
1709
+ 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.',
1710
+ labelledByWorkspace: (count) => `${count} fila(s) tomaron su etiqueta del mapeo de workspaces.`,
1711
+ 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.`,
1712
+ 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.',
1713
+ rulesUnreadable: (file) => `${file}: no se puede leer como mapeo de workspaces. Es un array JSON de {"workspace": "wrkspc_…" | null, "label": "nombre"}.`,
1714
+ 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.`,
1715
+ rulesEmpty: (file) => `${file}: no hay reglas dentro. Pasaste --label-by-workspace para repartir algo, y un archivo vacio repartiria nada en silencio.`,
1716
+ written: (file) => `Escrito ${file}.`,
1717
+ },
1718
+ fromOpenai: {
1719
+ noPath: () => 'from-openai necesita el informe de uso que produjo tu propio curl: trazum from-openai usage.json --label facturacion',
1720
+ notFound: (path) => `${path}: no encontrado`,
1721
+ summary: (buckets, rows, requests) => `${buckets} intervalo(s), ${rows} fila(s) de uso leida(s), que cubren ${requests} peticion(es).`,
1722
+ 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.`,
1723
+ 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.`,
1724
+ 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.',
1725
+ 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.`,
1726
+ 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.',
1727
+ 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` : ''}.`,
1728
+ 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.`,
1729
+ 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.',
1730
+ unparseable: () => 'Eso no es el JSON que devuelve GET /v1/organization/usage/completions. Pasa el cuerpo de la respuesta entero, no un campo suyo.',
1731
+ labelledByProject: (count) => `${count} fila(s) tomaron su etiqueta del mapeo de proyectos.`,
1732
+ 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.`,
1733
+ 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.',
1734
+ rulesUnreadable: (file) => `${file}: no se puede leer como mapeo de proyectos. Es un array JSON de {"project": "proj_…", "label": "nombre"}.`,
1735
+ 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.`,
1736
+ rulesEmpty: (file) => `${file}: no hay reglas dentro. Pasaste --label-by-project para repartir algo, y un archivo vacio repartiria nada en silencio.`,
1737
+ written: (file) => `Escrito ${file}.`,
1738
+ },
1739
+ bill: {
1740
+ noPath: () => 'bill necesita un archivo o un directorio que leer: trazum bill ~/.claude/projects',
1741
+ notFound: (path) => `${path}: no encontrado`,
1742
+ noFiles: (path) => `${path}: no hay archivos .json, .jsonl ni .ndjson dentro.`,
1743
+ 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.` : '.'}`,
1744
+ unknown: (path) => `${path}: ninguna forma que esta herramienta lee lo reclama, asi que no se adivino y no esta en la factura.`,
1745
+ 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.`,
1746
+ costReport: (path) => `${path}: un informe de costes de proveedor, que es una factura y no uso. Ponlo junto a un recibo con trazum reconcile.`,
1747
+ nothingRead: () => 'Nada de esto era una fuente de uso que esta herramienta lea, asi que no hay nada que facturar.',
1748
+ sources: (read, seen) => `${read} de ${seen} archivo(s) leido(s) como uso.`,
1749
+ 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.`,
1750
+ written: (file) => `Escrito ${file}.`,
1751
+ },
1752
+ fromOpenrouter: {
1753
+ noPath: () => 'from-openrouter necesita el informe de actividad que produjo tu propio curl: trazum from-openrouter activity.json --label facturacion',
1754
+ notFound: (path) => `${path}: no encontrado`,
1755
+ summary: (rows, days, requests) => `${rows} fila(s) de actividad leida(s) en ${days} dia(s), que cubren ${requests} peticion(es).`,
1756
+ 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.`,
1757
+ 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.`,
1758
+ unnamedModel: (count) => `${count} fila(s) no nombraron modelo y no estan en la salida: nada en la fila dice que respondio.`,
1759
+ undated: (count) => `${count} fila(s) traian una fecha que no es un dia YYYY-MM-DD y no estan en la salida.`,
1760
+ unparseable: () => 'Eso no es el JSON que devuelve GET /api/v1/activity. Pasa el cuerpo de la respuesta entero, no un campo suyo.',
1761
+ labelledByWorkspace: (count) => `${count} fila(s) tomaron su etiqueta del mapeo de workspaces.`,
1762
+ unruledWorkspace: (count) => `${count} fila(s) traian un workspace que ninguna regla nombra. Conservan --label si lo diste y quedan sin atribuir si no.`,
1763
+ 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.',
1764
+ rulesUnreadable: (file) => `${file}: no se puede leer como mapeo de workspaces. Es un array JSON de {"workspace": "…", "label": "nombre"}.`,
1765
+ 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.`,
1766
+ rulesEmpty: (file) => `${file}: no hay reglas dentro. Pasaste --label-by-workspace para repartir algo, y un archivo vacio repartiria nada en silencio.`,
1767
+ written: (file) => `Escrito ${file}.`,
1768
+ },
1594
1769
  fromHelicone: {
1595
1770
  noPath: () => 'from-helicone necesita un export de peticiones o un directorio: trazum from-helicone requests.json',
1596
1771
  notFound: (path) => `${path}: no encontrado`,
@@ -1643,6 +1818,10 @@ ${bold('EJEMPLOS')}
1643
1818
  written: (file) => `Escrito ${file}.`,
1644
1819
  stateNeedsFile: () => '--state lee un transcript, no una carpeta: el estado ata un desplazamiento del transcript a una longitud del fichero de salida, y varios transcripts escribiendo en una sola salida no tienen una longitud así. Apúntalo al fichero .jsonl.',
1645
1820
  stateNeedsOut: () => '--state necesita --out: sin fichero de salida no hay nada contra lo que reanudar.',
1821
+ cwdRulesUnreadable: (file) => `${file}: --label-by-cwd espera un JSON con una lista, del estilo [{"prefix": "/trabajo/api", "label": "api"}].`,
1822
+ cwdRuleBad: (file, at) => `${file}: la entrada ${at} necesita "prefix" y "label", ambos cadenas y no vacíos. Aquí no se adivina nada a partir de una ruta, así que una entrada que no es una regla se rechaza en vez de saltarse.`,
1823
+ cwdRulesEmpty: (file) => `${file}: no tiene reglas, así que cada línea acabaría en --label o sin etiqueta. Escribe una regla o quita la opción.`,
1824
+ labelledByCwd: (rules) => `Etiquetado por directorio de trabajo, ${rules} regla(s). El directorio decide cuál de tus etiquetas se aplica y nunca llega a la salida.`,
1646
1825
  resumed: (skipped, offset) => skipped === 0
1647
1826
  ? `Transcript leído entero; punto de reanudación anotado en el byte ${offset}.`
1648
1827
  : `Reanudado en el byte ${skipped}, así que ${skipped} byte(s) no se releyeron. Siguiente punto de reanudación: byte ${offset}.`,