@trazum/cli 1.81.0 → 1.83.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
@@ -37,8 +37,12 @@ ${bold('USO')}
37
37
  trazum schema <contrato>
38
38
  trazum rollup <documento...|dir> [--json] [--html-out <fichero>]
39
39
  trazum position <uso.jsonl>
40
+ trazum receipt <uso.jsonl|dir> [--stamp] [-o <fichero>]
40
41
  trazum from-claude-code <fichero|dir> [--label <nombre>] [-o <fichero>]
41
42
  trazum from-otel <fichero|dir> [--label-from-service] [-o <fichero>]
43
+ trazum from-litellm <fichero|dir> [-o <fichero>]
44
+ trazum from-helicone <fichero|dir> [-o <fichero>]
45
+ trazum from-langsmith <fichero|dir> [-o <fichero>]
42
46
  trazum switch <uso.jsonl> --to <modelo> [--migration-usd <n>] [--cases <n>]
43
47
  trazum ownrate --gpu-usd-hour <n> --tokens-per-second <n> [--utilization <0-1>]
44
48
  trazum pulse [--max-stale-hours <n>]
@@ -110,6 +114,29 @@ ${bold('OPCIONES DE rollup')}
110
114
 
111
115
  Sale con 1 cuando una contribución se entregó y no se pudo agregar.
112
116
 
117
+ ${bold('OPCIONES DE receipt')}
118
+ --stamp Registra la hora de emisión en el documento.
119
+ Desactivado por defecto para que dos ejecuciones
120
+ sobre un log den los mismos bytes: el periodo que
121
+ cubren las cifras ya está dentro, leído del reloj
122
+ del propio log.
123
+ -o, --out <fichero> Escribe el recibo ahí en vez de en la salida
124
+ estándar. El resumen siempre va al error
125
+ estándar, así que una redirección escribe un
126
+ documento y no un documento con un resumen
127
+ pegado delante.
128
+ --pricing <fichero> Lo precia con tu propia tarjeta de precios en
129
+ vez de con el catálogo incluido.
130
+ --pricing-live Lo precia con tarifas en vivo vía OpenRouter.
131
+
132
+ Un perfil responde donde se ejecutó. Un recibo son las mismas cifras con la
133
+ forma que las deja seguir respondiendo en otro sitio: cada línea lleva las
134
+ tarifas que produjeron su dinero y la fecha en que las de ese proveedor se
135
+ leyeron por última vez de su propia página. Lo que no lleva es texto del
136
+ prompt, respuestas, rutas de fichero, nombres de rama, credenciales ni
137
+ sesiones: no censurados, ausentes, porque la forma de la que se construye no
138
+ tiene campo donde meterlos. No envía nada a ningún sitio.
139
+
113
140
  ${bold('OPCIONES DE write')}
114
141
  --answers <fichero> Un objeto JSON de ids de slot y respuestas. Sin
115
142
  esto, las preguntas se hacen una a una; una línea
@@ -161,6 +188,44 @@ ${bold('OPCIONES DE ownrate')}
161
188
  en trazum.config.json, de modo que el modelo que tú mismo sirves sea una
162
189
  fila de primera en cada informe, tasado por ti y marcado como tal.
163
190
 
191
+ ${bold('OPCIONES DE from-helicone')}
192
+ -o, --out <fichero> Escribe el log de uso ahí en vez de en stdout.
193
+
194
+ Un export de peticiones de Helicone, leído como un log de uso: modelo, marca
195
+ de tiempo, etiqueta y los recuentos de tokens de cada fila, y nada más. El
196
+ cuerpo de la petición, el de la respuesta y el id de usuario se quedan en la
197
+ fila. Se pone precio al modelo que respondió, y las filas respondidas por un
198
+ modelo distinto del pedido se cuentan. cache_enabled es una bandera y nunca
199
+ un reparto de tokens, así que los veredictos de caché dicen "no se puede
200
+ saber". Un request id es una llamada y nunca una conversación, así que los
201
+ registros no llevan sesión y los hallazgos de conversación no se pueden
202
+ responder desde este registro; se dice en cada ejecución.
203
+
204
+ ${bold('OPCIONES DE from-langsmith')}
205
+ -o, --out <fichero> Escribe el log de uso ahí en vez de en stdout.
206
+
207
+ Un export de runs de LangSmith, leído como un log de uso: modelo, marca de
208
+ tiempo, etiqueta, la traza como sesión y los recuentos de tokens, y nada más.
209
+ Los inputs y los outputs se quedan en el run, y de los metadatos se leen
210
+ claves con nombre y nunca se copian enteros. Solo run_type "llm" es una
211
+ llamada: cadenas, herramientas y retrievers se saltan y se cuentan, porque la
212
+ cadena que envuelve una llamada repite los tokens de su hijo. Un run cuyos
213
+ metadatos no nombran modelo se rechaza en lugar de tarifarlo por el nombre
214
+ del run, que es una clase cliente. El coste propio de LangSmith se informa
215
+ aparte y nunca se mezcla con el de Trazum.
216
+
217
+ ${bold('OPCIONES DE from-litellm')}
218
+ -o, --out <fichero> Escribe el log de uso ahí en vez de en stdout.
219
+
220
+ Un spend log de LiteLLM, leído como un log de uso: modelo, marca de tiempo,
221
+ etiqueta, sesión y los recuentos de tokens de cada fila, y nada más. Los
222
+ mensajes, la respuesta, la clave con hash, la dirección del solicitante y el
223
+ usuario final se quedan en la fila. cache_hit es una bandera y nunca un
224
+ reparto de tokens, así que los veredictos de caché dicen "no se puede saber"
225
+ en vez de uno inventado. Las filas que no nombran modelo se cuentan y se
226
+ dejan fuera: model_group es una ruta, no un modelo. La cifra de gasto propia
227
+ de LiteLLM se imprime al lado de la de Trazum y nunca se funde con ella.
228
+
164
229
  ${bold('OPCIONES DE from-otel')}
165
230
  --label-from-service Etiqueta cada registro con el nombre de servicio
166
231
  de su span, para que salga una factura por
@@ -1005,6 +1070,10 @@ ${bold('EJEMPLOS')}
1005
1070
  used: (hits, misses) => `Sugerencias: ${hits} desde la caché, ${misses} consultadas. Las respuestas en caché son lo que el modelo dijo la última vez; usa --clear-suggestion-cache para empezar de nuevo.`,
1006
1071
  },
1007
1072
  errors: {
1073
+ fileNotFound: (path) => `${path}: no encontrado. Revisa la ruta, o apunta esto al directorio que lo contiene.`,
1074
+ fileIsDirectory: (path) => `${path} es un directorio, y este comando lee un fichero. Nombra el fichero de dentro, o usa un comando que recorra una carpeta.`,
1075
+ fileIsDirectoryUnnamed: () => 'esa ruta es un directorio, y este comando lee un fichero. Nombra el fichero de dentro, o usa un comando que recorra una carpeta.',
1076
+ fileNotReadable: (path) => `${path}: sin permiso de lectura. Revisa el dueño y los permisos del fichero, y vuelve a ejecutarlo.`,
1008
1077
  livePricingFailed: (url, detail) => `No se han podido cargar los precios en vivo desde ${url}: ${detail}. Los precios incluidos siguen ahí: quita --pricing-live para usarlos.`,
1009
1078
  optionNeedsValue: (name) => `La opción --${name} necesita un valor.`,
1010
1079
  mustBeNonNegative: (name, raw) => `--${name} debe ser un número no negativo (recibido: "${raw}").`,
@@ -1047,9 +1116,15 @@ ${bold('EJEMPLOS')}
1047
1116
  },
1048
1117
  report: {
1049
1118
  inputTokens: () => 'Tokens de entrada',
1050
- estimated: (offFamily) => offFamily === null
1051
- ? ' (estimado, ±10%)'
1052
- : ` (estimado: el contador está calibrado sobre Claude, no sobre ${offFamily})`,
1119
+ estimated: (offFamily, band, measuredOff) => {
1120
+ if (offFamily === null)
1121
+ return ` (estimado, ±${band}%)`;
1122
+ return measuredOff === null
1123
+ ? ` (estimado: el contador está calibrado sobre Claude, no sobre ${offFamily}, y nadie ha`
1124
+ + ' medido cuánto se desvía ahí)'
1125
+ : ` (estimado: el contador está calibrado sobre Claude, no sobre ${offFamily}, donde se ha`
1126
+ + ` medido hasta un ${measuredOff}% de desviación)`;
1127
+ },
1053
1128
  exactCount: () => ' (recuento exacto)',
1054
1129
  rulesApplied: () => 'Reglas aplicadas',
1055
1130
  nothingToTrim: () => ' Ninguna regla ha encontrado nada que recortar.',
@@ -1106,7 +1181,7 @@ ${bold('EJEMPLOS')}
1106
1181
  windowNegligible: (tokens, model, window) => `${tokens} tokens de la ventana de ${window} de ${model}: menos de una décima de por ciento, así que la ventana no es lo que limita este prompt.`,
1107
1182
  windowUnmoved: (share, model, window) => `${share} de la ventana de ${window} de ${model}, antes y después: este cambio es demasiado pequeño para moverla.`,
1108
1183
  beyondThisPromptTokensOnly: () => 'Acortar un prompt es la palanca más pequeña que hay: medido en un prompt de soporte corriente, las reglas recuperan alrededor del 1% de una factura mensual. Si alguno de tus prompts va a una API de pago por uso, "trazum profile <usage.jsonl>" lee lo que el proveedor cobró de verdad y calcula las palancas que no son el prompt. Grabar ese registro son unas pocas líneas y nunca contiene texto del prompt.',
1109
- beyondThisPrompt: () => 'Acortar un prompt es la palanca más pequeña que hay: medido en un prompt de soporte corriente, las reglas recuperan alrededor del 1% de una factura mensual. En una API de pago por uso, lo que mueve del 40% al 80% es a qué modelo va la llamada, la Batch API, la caché de prompts, y lo que cuesta reenviar la conversación, y "trazum profile <usage.jsonl>" calcula las cuatro a partir de lo que el proveedor cobró de verdad. Grabar ese registro son unas pocas líneas y nunca contiene texto del prompt.',
1184
+ beyondThisPrompt: () => 'Acortar un prompt es la palanca más pequeña que hay: medido en un prompt de soporte corriente, las reglas recuperan alrededor del 1% de una factura mensual. En una API de pago por uso, lo que mueve del 60% al 80% es a qué modelo va la llamada, la Batch API, la caché de prompts, y lo que cuesta reenviar la conversación, y "trazum profile <usage.jsonl>" calcula las cuatro a partir de lo que el proveedor cobró de verdad. Grabar ese registro son unas pocas líneas y nunca contiene texto del prompt.',
1110
1185
  windowUse: (before, after, model, window) => `Ventana de contexto: ${before} → ${after} de los ${window} tokens de ${model}, sitio que se lleva la conversación.`,
1111
1186
  tokensOnlyAskedFor: () => 'Has nombrado un escenario y no se ha calculado su coste: Trazum se está ejecutando en un sitio que factura por suscripción, así que aquí no hay factura que reducir. Añade --cost para calcularlo igualmente: el host dice dónde se ejecuta Trazum, no a dónde va tu prompt.',
1112
1187
  tokensOnlyCost: () => 'Usa --cost si este prompt va a una API de pago por uso.',
@@ -1492,6 +1567,15 @@ ${bold('EJEMPLOS')}
1492
1567
  declared: () => 'Derivado de tu declaración, honesto solo si el rendimiento se midió. Cada informe que tase este modelo descansará sobre estos dos números.',
1493
1568
  snippetHeading: () => 'Pega en trazum.config.json (el fichero de overlay «pricing»):',
1494
1569
  },
1570
+ receipt: {
1571
+ noLog: () => 'Nombra un log de uso del que hacer el recibo.',
1572
+ written: (file, lines) => `Recibo de ${lines} línea(s) escrito en ${file}.`,
1573
+ summary: (lines, usd) => `${lines} línea(s), ${usd} con precio. Cada cifra lleva la tarifa que la produjo y la fecha en que se revisó esa tarifa.`,
1574
+ unpriced: (models, calls) => `${models} modelo(s) que el catálogo no precia, con ${calls} llamada(s): nombrados en los huecos del recibo y fuera del total, en vez de costados a cero.`,
1575
+ unread: (count) => `${count} línea(s) del log no se pudieron leer, y el recibo lo dice.`,
1576
+ noClock: () => 'El log no lleva reloj, así que el recibo no está acotado en el tiempo y lo declara en vez de inventarse un periodo.',
1577
+ nothingToBill: () => 'Nada de este log se pudo precificar, así que el recibo no tiene líneas.',
1578
+ },
1495
1579
  fromOtel: {
1496
1580
  noPath: () => 'from-otel necesita un archivo o directorio OTLP: trazum from-otel spans.json',
1497
1581
  notFound: (path) => `${path}: no existe`,
@@ -1502,6 +1586,43 @@ ${bold('EJEMPLOS')}
1502
1586
  unparseable: (count) => `${count} línea(s) no se pudieron parsear como JSON.`,
1503
1587
  written: (file) => `Escrito ${file}.`,
1504
1588
  },
1589
+ fromHelicone: {
1590
+ noPath: () => 'from-helicone necesita un export de peticiones o un directorio: trazum from-helicone requests.json',
1591
+ notFound: (path) => `${path}: no encontrado`,
1592
+ noExports: (path) => `${path}: no hay exports .json/.jsonl/.ndjson dentro. Las peticiones de Helicone salen de su endpoint POST /v1/request/query, o del botón de exportar de la tabla de peticiones.`,
1593
+ summary: (files, rows) => `${files} archivo(s), ${rows} petición(es) leída(s).`,
1594
+ unnamedModel: (count) => `${count} fila(s) no nombran modelo en ninguna de las tres columnas y no están en la salida: nada en la fila dice qué respondió, así que nada puede ponerle precio.`,
1595
+ disagreements: (count) => `${count} fila(s) las respondió un modelo distinto del pedido. Se pone precio al que respondió, porque una factura va de lo que se facturó; el recuento está aquí para que una sustitución sea algo que ves y no algo que encuentras dentro de un total.`,
1596
+ noTokens: (count) => `${count} fila(s) traían cero tokens en ambos lados: peticiones registradas a las que nadie puede poner precio. Se cuentan aquí y merecen un vistazo a Helicone.`,
1597
+ cacheFlagged: (count) => `${count} fila(s) las sirvió la caché de Helicone. Eso es una bandera en la fila y nunca un reparto de tokens, así que los veredictos de caché dicen "no se puede saber" en este registro en vez de uno inventado.`,
1598
+ noSessions: () => 'Sin identidad de sesión: un request id de Helicone nombra una llamada, no una conversación, así que los hallazgos de conversación (caché desperdiciada en un solo turno, presión de contexto) no se pueden responder desde este registro. Hacer pasar un id por llamada como conversación reportaría cada llamada como una conversación de una.',
1599
+ unparseable: (count) => `${count} línea(s) no se pudieron leer como JSON.`,
1600
+ written: (file) => `Escrito ${file}.`,
1601
+ },
1602
+ fromLangsmith: {
1603
+ noPath: () => 'from-langsmith necesita un export de runs o un directorio: trazum from-langsmith runs.json',
1604
+ notFound: (path) => `${path}: no encontrado`,
1605
+ noExports: (path) => `${path}: no hay exports .json/.jsonl/.ndjson dentro. Los runs de LangSmith salen de su endpoint de listado, del list_runs() del SDK o del botón de exportar en la tabla de runs de un proyecto.`,
1606
+ summary: (files, rows) => `${files} archivo(s), ${rows} llamada(s) al modelo leídas.`,
1607
+ notModelCalls: (count) => `${count} run(s) no eran llamadas al modelo y no están en la salida: cadenas, herramientas, retrievers y prompts. Una traza de LangSmith es un árbol y la cadena que envuelve una llamada repite los tokens de su hijo, así que sumar el árbol facturaría los mismos tokens una vez por nivel.`,
1608
+ unnamedModel: (count) => `${count} llamada(s) no nombran modelo en sus metadatos y no están en la salida. El nombre del run es una clase cliente: «ChatAnthropic» no es un modelo que nadie pueda tarifar, así que se rechaza en lugar de adivinarlo. Pon ls_model_name o registra los invocation params.`,
1609
+ noTokens: (count) => `${count} llamada(s) no traían recuento de tokens y no están en la salida: runs registrados que nadie puede tarifar. Se cuentan aquí y merecen una mirada en el tracer.`,
1610
+ reportedCost: (usd) => `LangSmith tarifó estas mismas llamadas en ${usd} con su propia tabla. Esa cifra no se mezcla con nada que calcule Trazum: sumar dos tablas de precios en un total es como un informe se vuelve silenciosamente falso. Compáralas a propósito o no las compares.`,
1611
+ unparseable: (count) => `${count} línea(s) no se han podido leer como JSON.`,
1612
+ written: (file) => `Escrito ${file}.`,
1613
+ },
1614
+ fromLiteLlm: {
1615
+ noPath: () => 'from-litellm necesita un export de spend log o un directorio: trazum from-litellm spend.json',
1616
+ notFound: (path) => `${path}: no encontrado`,
1617
+ noExports: (path) => `${path}: no hay exports .json/.jsonl/.ndjson dentro. Los spend logs de LiteLLM salen de la tabla LiteLLM_SpendLogs, o de los endpoints /spend del propio proxy.`,
1618
+ summary: (files, rows) => `${files} archivo(s), ${rows} llamada(s) registrada(s) leída(s).`,
1619
+ unnamedModel: (count) => `${count} fila(s) no nombran modelo y no están en la salida. "model_group" es el nombre de una ruta del proxy y detrás pueden ir varios modelos, así que poner precio a esas llamadas por la ruta que tomaron sería atribuir una cifra a algo que no describe.`,
1620
+ noTokens: (count) => `${count} fila(s) traían cero tokens en ambos lados: llamadas registradas a las que nadie puede poner precio. Se cuentan aquí y merecen un vistazo al proxy.`,
1621
+ cacheFlagged: (count) => `${count} fila(s) están marcadas como acierto de caché. LiteLLM lo registra como una bandera y nunca como un reparto de tokens, así que los veredictos de caché dicen "no se puede saber" en este registro en vez de uno inventado.`,
1622
+ reportedSpend: (usd) => `LiteLLM puso precio a estas mismas llamadas en ${usd} con su propia tabla. Esa cifra no se funde con nada que calcule Trazum: sumar dos tablas de precios en un total es como un informe se vuelve callado y equivocado. Compáralas a propósito o no las compares.`,
1623
+ unparseable: (count) => `${count} línea(s) no se pudieron leer como JSON.`,
1624
+ written: (file) => `Escrito ${file}.`,
1625
+ },
1505
1626
  fromClaudeCode: {
1506
1627
  noPath: () => 'from-claude-code necesita un archivo o directorio de transcripts: trazum from-claude-code ~/.claude/projects',
1507
1628
  notFound: (path) => `${path}: no existe`,
@@ -1642,6 +1763,8 @@ ${bold('EJEMPLOS')}
1642
1763
  title: () => 'Modelos y precios',
1643
1764
  unit: () => ' (USD por millón de tokens)',
1644
1765
  reviewedOn: (date, days) => ` Tabla revisada el ${date}${hace(days)}. Verifica antes de presupuestar.`,
1766
+ reviewedByProvider: (rows) => ` Por proveedor: ${rows}`,
1767
+ reviewedGroup: (date, days, providers) => `${date}${hace(days)} ${providers}`,
1645
1768
  columns: {
1646
1769
  model: 'modelo',
1647
1770
  input: 'entrada',
@@ -1686,7 +1809,7 @@ ${bold('EJEMPLOS')}
1686
1809
  goneAt: () => 'no existía',
1687
1810
  truncated: (shown) => `Mostrando las ${shown} más recientes. Usa --limit para ver más.`,
1688
1811
  followedRename: (from) => `Se ha seguido un renombrado: las revisiones anteriores son ${from}.`,
1689
- estimateNote: () => 'Los recuentos son estimaciones (±10%). Lo que importa es la tendencia, no las cifras absolutas.',
1812
+ estimateNote: (band) => `Los recuentos son estimaciones (±${band}% para texto de este tipo). Lo que importa es la tendencia, no las cifras absolutas.`,
1690
1813
  },
1691
1814
  languages: {
1692
1815
  and: 'y',
@@ -1849,7 +1972,7 @@ ${bold('EJEMPLOS')}
1849
1972
  truncated: () => 'Se ha parado antes de tiempo: el directorio supera el límite de recorrido, así que esto no es el cuadro completo.',
1850
1973
  footer: (source, level) => `Recuento de tokens ${source} · nivel de reglas \`${level}\``,
1851
1974
  pricingOverlaid: (count, lastReviewed) => `Los precios de ${count} ${count === 1 ? 'modelo' : 'modelos'} vienen de un overlay local revisado el ${lastReviewed}.`,
1852
- sourceEstimated: () => 'estimado, ±10%',
1975
+ sourceEstimated: (band) => `estimado, ±${band}%`,
1853
1976
  sourceExact: () => 'exacto',
1854
1977
  measuringOptimised: () => 'Se mide lo que dejarían las reglas, no lo que está escrito en el fichero.',
1855
1978
  metricTokens: (before, after) => `Tokens de entrada (${before} → ${after})`,
@@ -2124,6 +2247,10 @@ ${bold('EJEMPLOS')}
2124
2247
  windowRelativeEmpty: () => 'Una ventana relativa se mide desde el reloj de esta máquina: si este registro se exportó antes, pide las fechas que cubre.',
2125
2248
  windowNeedsClock: () => 'Ningún registro lleva marca de tiempo, así que --since/--until no tienen por qué filtrar. Una ventana temporal sobre un registro sin reloj no vigilaría nada, y eso no es una respuesta. Añade "ts" a los registros: la receta del README dice dónde.',
2126
2249
  windowMatchesNothing: (from, to) => `Ningún registro cae dentro de esta ventana. El registro cubre ${from} → ${to}. Una ventana que no encuentra nada no debe volverse un informe de $0: bajo --max-usd pasaría una puerta de presupuesto sobre un periodo que el registro no cubre.`,
2250
+ gateNothingMeasured: (reason) => `Hay una puerta de gasto armada y no había nada que juzgar: ${reason}. Una ausencia no es un aprobado, así que esto sale con 1 en vez de reportar $0 contra tu presupuesto. Arregla el registro, o pasa --allow-empty si un periodo sin llamadas es la respuesta esperada.`,
2251
+ nothingUnreadable: (lines) => `las ${count(lines)} ${lines === 1 ? 'línea del fichero era ilegible' : 'líneas del fichero eran ilegibles'}`,
2252
+ nothingUnpriced: (calls) => `se ${count(calls) && calls === 1 ? 'registró 1 llamada' : `registraron ${count(calls)} llamadas`} y ninguno de sus modelos está en la tabla de precios`,
2253
+ nothingEmpty: () => 'el registro no tiene ni un solo apunte',
2127
2254
  sinceAfterUntil: () => '--since es igual o posterior a --until, así que la ventana no contiene tiempo alguno. Revisa las dos fechas.',
2128
2255
  badWhen: (flag, value) => `--${flag} no pudo leer "${value}". Acepta un día UTC (2026-08-14) o una marca ISO 8601 completa (2026-08-14T09:30:00Z).`,
2129
2256
  singleTurnCeiling: (label, model, single, sessions, usd) => `${label} en ${model}: ${single} de ${sessions} conversaciones terminaron tras su primer turno, y sus escrituras de caché (${usd}) pagaron una reutilización que su propia conversación nunca hizo. Otra conversación con el mismo prefijo dentro del TTL pudo haberlas leído; el registro no puede ver de quién era la escritura que una lectura encontró, así que esa cifra es un techo del desperdicio, no una factura.`,