@trazum/cli 2.5.0 → 2.5.2

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.
Files changed (64) hide show
  1. package/README.md +75 -6
  2. package/dist/filter.d.ts +2 -0
  3. package/dist/filter.d.ts.map +1 -0
  4. package/dist/filter.js +151 -0
  5. package/dist/filter.js.map +1 -0
  6. package/dist/gateway-server.d.ts +2 -0
  7. package/dist/gateway-server.d.ts.map +1 -1
  8. package/dist/gateway-server.js +49 -9
  9. package/dist/gateway-server.js.map +1 -1
  10. package/dist/gateway-spend.d.ts +32 -0
  11. package/dist/gateway-spend.d.ts.map +1 -0
  12. package/dist/gateway-spend.js +116 -0
  13. package/dist/gateway-spend.js.map +1 -0
  14. package/dist/html.d.ts.map +1 -1
  15. package/dist/html.js +25 -2
  16. package/dist/html.js.map +1 -1
  17. package/dist/i18n/en.d.ts.map +1 -1
  18. package/dist/i18n/en.js +50 -6
  19. package/dist/i18n/en.js.map +1 -1
  20. package/dist/i18n/es.d.ts.map +1 -1
  21. package/dist/i18n/es.js +51 -6
  22. package/dist/i18n/es.js.map +1 -1
  23. package/dist/i18n/types.d.ts +28 -1
  24. package/dist/i18n/types.d.ts.map +1 -1
  25. package/dist/index.d.ts.map +1 -1
  26. package/dist/index.js +225 -41
  27. package/dist/index.js.map +1 -1
  28. package/dist/markdown.d.ts +7 -0
  29. package/dist/markdown.d.ts.map +1 -1
  30. package/dist/markdown.js +24 -2
  31. package/dist/markdown.js.map +1 -1
  32. package/dist/pdf.d.ts.map +1 -1
  33. package/dist/pdf.js +41 -2
  34. package/dist/pdf.js.map +1 -1
  35. package/dist/serve-savings-schema.d.ts +65 -0
  36. package/dist/serve-savings-schema.d.ts.map +1 -0
  37. package/dist/serve-savings-schema.js +54 -0
  38. package/dist/serve-savings-schema.js.map +1 -0
  39. package/dist/serve-savings.d.ts +55 -0
  40. package/dist/serve-savings.d.ts.map +1 -0
  41. package/dist/serve-savings.js +144 -0
  42. package/dist/serve-savings.js.map +1 -0
  43. package/dist/serve-schema.d.ts +536 -0
  44. package/dist/serve-schema.d.ts.map +1 -0
  45. package/dist/serve-schema.js +143 -0
  46. package/dist/serve-schema.js.map +1 -0
  47. package/dist/serve.d.ts.map +1 -1
  48. package/dist/serve.js +30 -5
  49. package/dist/serve.js.map +1 -1
  50. package/package.json +2 -2
  51. package/src/filter.ts +114 -0
  52. package/src/gateway-server.ts +46 -10
  53. package/src/gateway-spend.ts +120 -0
  54. package/src/html.ts +27 -2
  55. package/src/i18n/en.ts +57 -7
  56. package/src/i18n/es.ts +58 -7
  57. package/src/i18n/types.ts +29 -1
  58. package/src/index.ts +227 -43
  59. package/src/markdown.ts +32 -2
  60. package/src/pdf.ts +38 -2
  61. package/src/serve-savings-schema.ts +53 -0
  62. package/src/serve-savings.ts +140 -0
  63. package/src/serve-schema.ts +147 -0
  64. package/src/serve.ts +31 -5
@@ -0,0 +1,143 @@
1
+ import { SAVINGS_SCHEMAS } from './serve-savings-schema.js';
2
+ /** Public contract for local, read-only cost and savings analysis. No provider calls occur here. */
3
+ const ref = (name) => ({ $ref: `#/components/schemas/${name}` });
4
+ const nullable = (schema) => ({ anyOf: [schema, { type: 'null' }] });
5
+ const object = (properties) => ({
6
+ type: 'object', properties, required: Object.keys(properties), additionalProperties: false,
7
+ });
8
+ const amount = { type: 'number', minimum: 0 };
9
+ const verdict = { enum: ['within', 'over', 'cannot-tell'] };
10
+ const restsOn = { enum: ['measured', 'measured+estimated', null] };
11
+ export const COST_REQUEST_SCHEMA = {
12
+ type: 'object',
13
+ description: 'All fields are optional. Missing counts default to zero. Unknown fields are ignored. An empty body is equivalent to {}.',
14
+ additionalProperties: true,
15
+ properties: {
16
+ model: { type: 'string', description: 'Catalogue model identifier. Unknown models produce an unpriced call, not a substitute.' },
17
+ inputTokens: { ...amount, description: 'Finite non-negative count; fractional counts remain accepted for compatibility.', default: 0 },
18
+ outputTokens: { ...amount, description: 'Finite non-negative count; fractional counts remain accepted for compatibility.', default: 0 },
19
+ basis: { type: 'string', enum: ['heuristic', 'token-count'], default: 'token-count' },
20
+ label: { type: 'string', description: 'Optional policy scope. Empty string means absent.' },
21
+ session: { type: 'string', description: 'Optional policy lookup key. Empty string means absent. Never echoed in the answer.' },
22
+ },
23
+ };
24
+ /** Same accepted fields as the published schema; invalid shapes never reach the core. */
25
+ export function validateCostPayload(value) {
26
+ if (value === null || typeof value !== 'object' || Array.isArray(value)) {
27
+ throw new Error('The body must be a JSON object.');
28
+ }
29
+ const payload = value;
30
+ for (const field of ['model', 'label', 'session']) {
31
+ if (payload[field] !== undefined && typeof payload[field] !== 'string') {
32
+ throw new Error(`${field} must be a string.`);
33
+ }
34
+ }
35
+ for (const field of ['inputTokens', 'outputTokens']) {
36
+ const count = payload[field];
37
+ if (count !== undefined && (typeof count !== 'number' || !Number.isFinite(count) || count < 0)) {
38
+ throw new Error(`${field} must be a non-negative finite number.`);
39
+ }
40
+ }
41
+ if (payload.basis !== undefined && payload.basis !== 'heuristic' && payload.basis !== 'token-count') {
42
+ throw new Error('basis must be heuristic or token-count.');
43
+ }
44
+ }
45
+ const schemas = {
46
+ ...SAVINGS_SCHEMAS,
47
+ CostRequest: COST_REQUEST_SCHEMA,
48
+ HarnessCapabilities: object({
49
+ schemaVersion: { const: 1 },
50
+ accessChannels: { type: 'array', items: { enum: ['cli', 'mcp', 'http'] }, description: 'Trazum entry points, not installed or automatically connected harness integrations.' },
51
+ taskQuality: { const: 'not-measured' },
52
+ harnesses: { type: 'array', items: ref('HarnessCapability') },
53
+ }),
54
+ HarnessCapability: object({
55
+ id: { type: 'string' }, name: { type: 'string' },
56
+ nativeImport: nullable({
57
+ oneOf: [
58
+ object({ command: { const: 'from-claude-code' }, format: { const: 'claude-code-transcript-jsonl' } }),
59
+ object({ command: { const: 'from-codex' }, format: { const: 'codex-session-jsonl' } }),
60
+ ],
61
+ }),
62
+ normalizedUsage: object({ command: { const: 'bill' }, format: { const: 'trazum-usage-jsonl' } }),
63
+ billingMode: { const: 'unknown', description: 'The harness does not determine subscription, API billing, or actual invoice amounts.' },
64
+ automaticInterception: { const: false, description: 'Gateway use is explicit; native hooks are not installed automatically.' },
65
+ }),
66
+ Health: object({ ok: { const: true }, schemaVersion: { const: 1 } }),
67
+ Error: object({ error: { enum: ['bad-request', 'not-found'] }, detail: { type: 'string' } }),
68
+ Window: object({ fromMs: { type: 'number' }, toMs: { type: 'number' } }),
69
+ CallEstimate: object({
70
+ model: { type: 'string' }, inputTokens: amount, outputTokens: amount, estimatedUsd: amount,
71
+ provenance: { const: 'estimated' }, basis: { enum: ['heuristic', 'token-count'] },
72
+ }),
73
+ BudgetPosition: object({
74
+ limitUsd: amount, consumedUsd: amount, remainingUsd: { type: 'number' },
75
+ provenance: { const: 'measured' }, window: nullable(ref('Window')),
76
+ }),
77
+ AfterCall: object({ usd: amount, halves: object({ measuredUsd: amount, estimatedUsd: amount }) }),
78
+ LimitJudgement: {
79
+ ...object({
80
+ scope: { enum: ['day', 'session', 'label'] }, label: { type: ['string', 'null'] },
81
+ limitUsd: amount, verdict, restsOn,
82
+ reason: { enum: ['nothing-measured', 'model-unpriced', 'no-label-on-call', 'no-session-on-call', null] },
83
+ measuredUsd: nullable(amount), window: nullable(ref('Window')), afterCallUsd: nullable(amount),
84
+ waived: nullable(object({ reason: { type: 'string' }, until: { type: 'string' } })),
85
+ }),
86
+ oneOf: [
87
+ { properties: { verdict: { const: 'cannot-tell' }, restsOn: { type: 'null' }, reason: { type: 'string' }, afterCallUsd: { type: 'null' } } },
88
+ { properties: { verdict: { enum: ['within', 'over'] }, restsOn: { enum: ['measured', 'measured+estimated'] }, reason: { type: 'null' }, afterCallUsd: amount } },
89
+ ],
90
+ },
91
+ PolicyJudgement: {
92
+ ...object({ schemaVersion: { const: 1 }, verdict, reason: { enum: ['no-policy', null] }, judgements: { type: 'array', items: ref('LimitJudgement') } }),
93
+ oneOf: [
94
+ { properties: { verdict: { const: 'cannot-tell' }, reason: { const: 'no-policy' }, judgements: { maxItems: 0 } } },
95
+ { properties: { reason: { type: 'null' }, judgements: { minItems: 1 } } },
96
+ ],
97
+ },
98
+ CostAnswer: {
99
+ ...object({
100
+ schemaVersion: { const: 1 }, call: nullable(ref('CallEstimate')), budget: nullable(ref('BudgetPosition')),
101
+ verdict, restsOn, reason: { enum: ['no-budget-configured', 'nothing-measured', 'model-unpriced', null] },
102
+ afterCall: nullable(ref('AfterCall')), policy: ref('PolicyJudgement'),
103
+ }),
104
+ oneOf: [
105
+ { properties: { verdict: { const: 'cannot-tell' }, reason: { enum: ['no-budget-configured', 'nothing-measured'] }, budget: { type: 'null' }, restsOn: { type: 'null' }, afterCall: { type: 'null' } } },
106
+ { properties: { verdict: { const: 'cannot-tell' }, reason: { const: 'model-unpriced' }, budget: ref('BudgetPosition'), call: { type: 'null' }, restsOn: { type: 'null' }, afterCall: { type: 'null' } } },
107
+ { properties: { verdict: { enum: ['within', 'over'] }, reason: { type: 'null' }, budget: ref('BudgetPosition'), restsOn: { enum: ['measured', 'measured+estimated'] }, afterCall: ref('AfterCall') } },
108
+ ],
109
+ },
110
+ };
111
+ const response = (name, description) => ({ description, content: { 'application/json': { schema: ref(name) } } });
112
+ export const SERVE_OPENAPI = {
113
+ openapi: '3.1.0',
114
+ jsonSchemaDialect: 'https://json-schema.org/draft/2020-12/schema',
115
+ info: { title: 'Trazum local cost and savings API', version: '1.0.0', description: 'Loopback-only read-only estimates, policy judgements and savings analysis. No authentication or CORS. Does not reserve budget, send model calls, or enforce an upstream decision. Measured positions are snapshots supplied by the CLI; inspect their windows.' },
116
+ servers: [{ url: 'http://127.0.0.1:7317', description: 'Default TCP listener. Substitute the chosen --port, or use the Unix socket transport.' }],
117
+ paths: {
118
+ '/capabilities': { get: { operationId: 'getCapabilities', summary: 'Discover native import formats and Trazum access channels', responses: { '200': response('HarnessCapabilities', 'Static metadata; no environment, filesystem, session or network discovery.') } } },
119
+ '/health': { get: { operationId: 'getHealth', summary: 'Check the local process', responses: { '200': response('Health', 'Process is available.') } } },
120
+ '/openapi.json': { get: { operationId: 'getOpenApi', summary: 'Read this OpenAPI document', responses: { '200': { description: 'OpenAPI 3.1 document.', content: { 'application/json': { schema: { type: 'object', required: ['openapi', 'info', 'paths', 'components'] } } } } } } },
121
+ '/savings/plan': { post: {
122
+ operationId: 'planSavings', summary: 'Rank savings actions from normalized usage',
123
+ description: 'Read-only text inputs, priced using the server catalogue. No filesystem, provider or network calls. Unknown properties and empty text are refused. Whole-body limit: 1,000,000 UTF-8 bytes, including JSON escaping. Evidence gaps remain explicit; success does not certify realized savings or task quality.',
124
+ requestBody: { required: true, content: { 'application/json': { schema: ref('SavingsPlanRequest') } } },
125
+ responses: { '200': response('SavingsPlanAnswer', 'Savings analysis with evidence and limitations.'), '400': response('Error', 'Malformed, unreadable or oversized inputs.') },
126
+ } },
127
+ '/savings/verify': { post: {
128
+ operationId: 'verifySavings', summary: 'Verify a saved plan against later normalized usage',
129
+ description: 'Read-only text inputs, priced using the server catalogue. No filesystem, provider or network calls. Unknown properties and empty text are refused. Whole-body limit: 1,000,000 UTF-8 bytes, including JSON escaping. Evidence gaps remain explicit; success does not certify realized savings or task quality.',
130
+ requestBody: { required: true, content: { 'application/json': { schema: ref('SavingsVerifyRequest') } } },
131
+ responses: { '200': response('SavingsVerifyAnswer', 'Savings analysis with evidence and limitations.'), '400': response('Error', 'Malformed, unreadable or oversized inputs.') },
132
+ } },
133
+ '/cost': { post: {
134
+ operationId: 'estimateCost', summary: 'Estimate a proposed call against measured budget and scoped policy',
135
+ description: 'Body limit: 1,000,000 bytes; violations return 400. Missing or whitespace-only body is {}. Unknown properties are ignored. Content-Type is not enforced by the server; send application/json. All successful judgements, including over and cannot-tell, return 200. A judgement does not reserve or spend funds.',
136
+ requestBody: { required: false, content: { 'application/json': { schema: ref('CostRequest') } } },
137
+ responses: { '200': response('CostAnswer', 'A judgement, not permission to invoke a provider.'), '400': response('Error', 'Invalid JSON, invalid field types or values, or body over the byte limit.') },
138
+ } },
139
+ },
140
+ components: { schemas },
141
+ 'x-unmatched-routes': { status: 404, schema: ref('Error'), description: 'All other path and method combinations, including OPTIONS, return 404. No CORS headers are emitted.' },
142
+ };
143
+ //# sourceMappingURL=serve-schema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"serve-schema.js","sourceRoot":"","sources":["../src/serve-schema.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../src/serve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,KAAK,EAAmB,MAAM,EAAkB,MAAM,WAAW,CAAC;AAEzE,OAAO,KAAK,EAAc,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE7G,0EAA0E;AAC1E,eAAO,MAAM,SAAS,cAAc,CAAC;AAErC,eAAO,MAAM,YAAY,OAAO,CAAC;AAEjC;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,UAAY,CAAC;AAExC,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,gBAAgB,CAAC;IAC5B;;;;;;;;OAQG;IACH,QAAQ,EAAE,MAAM;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAA;KAAE,CAAC;IAC9G,uDAAuD;IACvD,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,gBAAgB,CAAC;IAC5E,kFAAkF;IAClF,OAAO,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;CACjC;AAyBD,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CA+FzD;AAED,MAAM,WAAW,YAAY;IAC3B,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAa5E"}
1
+ {"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../src/serve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAKH,OAAO,KAAK,EAAmB,MAAM,EAAkB,MAAM,WAAW,CAAC;AAEzE,OAAO,KAAK,EAAc,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE7G,0EAA0E;AAC1E,eAAO,MAAM,SAAS,cAAc,CAAC;AAErC,eAAO,MAAM,YAAY,OAAO,CAAC;AAEjC;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,UAAY,CAAC;AAExC,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,gBAAgB,CAAC;IAC5B;;;;;;;;OAQG;IACH,QAAQ,EAAE,MAAM;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAA;KAAE,CAAC;IAC9G,uDAAuD;IACvD,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,gBAAgB,CAAC;IAC5E,kFAAkF;IAClF,OAAO,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;CACjC;AAyBD,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAuHzD;AAED,MAAM,WAAW,YAAY;IAC3B,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAa5E"}
package/dist/serve.js CHANGED
@@ -23,7 +23,9 @@
23
23
  * into a hot path.
24
24
  */
25
25
  import { createServer } from 'node:http';
26
- import { answerCost, judgeLimits } from '@trazum/core';
26
+ import { planSavings, verifySavings, validateSavingsPayload } from './serve-savings.js';
27
+ import { SERVE_OPENAPI, validateCostPayload } from './serve-schema.js';
28
+ import { answerCost, judgeLimits, HARNESS_CAPABILITIES } from '@trazum/core';
27
29
  /** Compiled in. See the module note: this is the inbound SSRF posture. */
28
30
  export const BIND_HOST = '127.0.0.1';
29
31
  export const DEFAULT_PORT = 7317;
@@ -61,28 +63,51 @@ export function buildServer(context) {
61
63
  return createServer((request, response) => {
62
64
  void (async () => {
63
65
  const url = new URL(request.url ?? '/', `http://${BIND_HOST}`);
66
+ if (request.method === 'GET' && url.pathname === '/capabilities') {
67
+ send(response, 200, HARNESS_CAPABILITIES);
68
+ return;
69
+ }
70
+ if (request.method === 'GET' && url.pathname === '/openapi.json') {
71
+ send(response, 200, SERVE_OPENAPI);
72
+ return;
73
+ }
64
74
  if (request.method === 'GET' && url.pathname === '/health') {
65
75
  send(response, 200, { ok: true, schemaVersion: 1 });
66
76
  return;
67
77
  }
68
- if (request.method !== 'POST' || url.pathname !== '/cost') {
78
+ const savings = url.pathname === '/savings/plan' || url.pathname === '/savings/verify';
79
+ if (request.method !== 'POST' || (url.pathname !== '/cost' && !savings)) {
69
80
  send(response, 404, {
70
81
  error: 'not-found',
71
- detail: 'POST /cost, or GET /health.',
82
+ detail: 'POST /cost, POST /savings/plan, POST /savings/verify, GET /health, GET /capabilities, or GET /openapi.json.',
72
83
  });
73
84
  return;
74
85
  }
75
86
  let payload;
76
87
  try {
77
88
  const raw = await readBody(request);
78
- payload = raw.trim() === '' ? {} : JSON.parse(raw);
89
+ const parsed = raw.trim() === '' ? {} : JSON.parse(raw);
90
+ if (savings) {
91
+ if (url.pathname === '/savings/verify') {
92
+ validateSavingsPayload(parsed, true);
93
+ send(response, 200, verifySavings(parsed, context.catalogue));
94
+ }
95
+ else {
96
+ validateSavingsPayload(parsed, false);
97
+ send(response, 200, planSavings(parsed, context.catalogue));
98
+ }
99
+ return;
100
+ }
101
+ validateCostPayload(parsed);
102
+ payload = parsed;
79
103
  }
80
104
  catch (error) {
81
105
  send(response, 400, {
82
106
  error: 'bad-request',
83
107
  detail: error instanceof Error && error.message === 'body too large'
84
108
  ? `A request body may be at most ${MAX_BODY_BYTES} bytes.`
85
- : 'The body must be JSON.',
109
+ : error instanceof SyntaxError ? 'The body must be JSON.'
110
+ : error instanceof Error ? error.message : 'The body must be JSON.',
86
111
  });
87
112
  return;
88
113
  }
package/dist/serve.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"serve.js","sourceRoot":"","sources":["../src/serve.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"serve.js","sourceRoot":"","sources":["../src/serve.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@trazum/cli",
3
- "version": "2.5.0",
3
+ "version": "2.5.2",
4
4
  "description": "What your AI agents cost, per project, offline: prices Claude Code sessions and Anthropic, OpenAI, OpenRouter, OTel and LiteLLM usage, writes the bill as PDF, HTML or CSV, and enforces budgets in CI.",
5
5
  "license": "MIT",
6
6
  "author": "David Mu\u00f1oz Rey",
@@ -50,7 +50,7 @@
50
50
  "prepublishOnly": "npm run build && npm test"
51
51
  },
52
52
  "dependencies": {
53
- "@trazum/core": "2.5.0"
53
+ "@trazum/core": "2.5.2"
54
54
  },
55
55
  "devDependencies": {
56
56
  "@types/node": "^26.6.3",
package/src/filter.ts ADDED
@@ -0,0 +1,114 @@
1
+ /** Opt-in stdin log filter. No subprocess execution and no provider access. */
2
+ import { constants } from 'node:fs';
3
+ import { mkdir, lstat, open } from 'node:fs/promises';
4
+ import { createHash } from 'node:crypto';
5
+ import { resolve, join } from 'node:path';
6
+ import { once } from 'node:events';
7
+ import { compactToolOutput, EFFICIENT_OUTPUT_INSTRUCTIONS } from '@trazum/core';
8
+
9
+ const MAX_BYTES = 1024 * 1024;
10
+ const HELP = `Usage:
11
+ trazum filter compact --recovery-dir <private-directory> read a tool log from stdin
12
+ trazum filter restore <sha256> --recovery-dir <private-directory>
13
+ trazum filter instructions print optional output guidance
14
+
15
+ Experimental, opt-in display filter. Only consecutive repeated log lines are
16
+ compacted. Errors and unique lines are kept. Not for source files or data pipes.
17
+ Use Bash pipefail to preserve the producing command's failure status.
18
+ Original logs may contain sensitive data: --recovery-dir explicitly opts into local
19
+ retention. Delete that directory when the originals are no longer needed.
20
+ Token counts are estimates, not billing or subscription-quota measurements.
21
+ `;
22
+
23
+ const digest = (bytes: Buffer) => createHash('sha256').update(bytes).digest('hex');
24
+ const quote = (text: string) => `'${text.replaceAll("'", "'\\''")}'`;
25
+ async function emit(bytes: Buffer | string): Promise<void> {
26
+ if (!process.stdout.write(bytes)) await once(process.stdout, 'drain');
27
+ }
28
+ async function privateDirectory(path: string, create: boolean): Promise<void> {
29
+ if (create) await mkdir(path, { recursive: true, mode: 0o700 });
30
+ const stat = await lstat(path);
31
+ if (!stat.isDirectory() || stat.isSymbolicLink()) throw new Error('Store must be a real directory.');
32
+ if (process.platform !== 'win32' && ((stat.mode & 0o077) !== 0 || stat.uid !== process.getuid?.())) {
33
+ throw new Error('Store must be owned by you and have mode 0700.');
34
+ }
35
+ }
36
+ async function readOriginal(store: string, key: string): Promise<Buffer> {
37
+ const file = await open(join(store, `${key}.log`), constants.O_RDONLY | constants.O_NOFOLLOW);
38
+ try {
39
+ const stat = await file.stat();
40
+ if (!stat.isFile() || stat.size > MAX_BYTES) throw new Error('Invalid recovery file.');
41
+ const bytes = await file.readFile();
42
+ if (bytes.length > MAX_BYTES || digest(bytes) !== key) throw new Error('Recovery integrity check failed.');
43
+ return bytes;
44
+ } finally { await file.close(); }
45
+ }
46
+ async function saveOriginal(store: string, key: string, bytes: Buffer): Promise<void> {
47
+ await privateDirectory(store, true);
48
+ let file;
49
+ try { file = await open(join(store, `${key}.log`), 'wx', 0o600); }
50
+ catch (error) {
51
+ if ((error as NodeJS.ErrnoException).code !== 'EEXIST') throw error;
52
+ const existing = await readOriginal(store, key);
53
+ if (!existing.equals(bytes)) throw new Error('Recovery integrity check failed.');
54
+ return;
55
+ }
56
+ try { await file.writeFile(bytes); await file.sync(); }
57
+ finally { await file.close(); }
58
+ }
59
+ async function compact(store: string): Promise<void> {
60
+ const chunks: Buffer[] = [];
61
+ let size = 0;
62
+ let passthrough = false;
63
+ for await (const value of process.stdin) {
64
+ const chunk = Buffer.isBuffer(value) ? value : Buffer.from(value);
65
+ if (passthrough) { await emit(chunk); continue; }
66
+ size += chunk.length;
67
+ if (size > MAX_BYTES) {
68
+ passthrough = true;
69
+ for (const buffered of chunks) await emit(buffered);
70
+ chunks.length = 0;
71
+ await emit(chunk);
72
+ } else { chunks.push(chunk); }
73
+ }
74
+ if (passthrough) return;
75
+ const bytes = Buffer.concat(chunks);
76
+ const input = bytes.toString('utf8');
77
+ // Invalid UTF-8 must pass byte-for-byte rather than acquire replacement chars.
78
+ if (!Buffer.from(input).equals(bytes)) { await emit(bytes); return; }
79
+ const key = digest(bytes);
80
+ const view = compactToolOutput(input, `trazum filter restore ${key} --recovery-dir ${quote(store)}`);
81
+ if (!view.applied) { await emit(bytes); return; }
82
+ try { await saveOriginal(store, key, bytes); }
83
+ catch {
84
+ // A filter must not swallow a tool's output because local persistence failed.
85
+ process.stderr.write('Trazum: original could not be retained; passing log through unchanged.\n');
86
+ await emit(bytes);
87
+ return;
88
+ }
89
+ await emit(view.text);
90
+ }
91
+ export async function runFilter(args: string[]): Promise<void> {
92
+ if (args.length === 0 || (args.length === 1 && ['--help', '-h'].includes(args[0]!))) {
93
+ await emit(HELP); return;
94
+ }
95
+ if (args.length === 1 && args[0] === 'instructions') {
96
+ await emit(`${EFFICIENT_OUTPUT_INSTRUCTIONS}\n`); return;
97
+ }
98
+ const restoring = args[0] === 'restore';
99
+ const offset = restoring ? 2 : 1;
100
+ if ((!restoring && args[0] !== 'compact') || args.length !== offset + 2 ||
101
+ args[offset] !== '--recovery-dir' || !args[offset + 1] || /[\r\n]/.test(args[offset + 1]!)) {
102
+ throw new Error('Invalid arguments. Run trazum filter --help.');
103
+ }
104
+ const store = resolve(args[offset + 1]!);
105
+ if (restoring) {
106
+ const key = args[1]!;
107
+ if (!/^[a-f0-9]{64}$/.test(key)) throw new Error('Expected a SHA-256 recovery identifier.');
108
+ await privateDirectory(store, false);
109
+ await emit(await readOriginal(store, key));
110
+ } else {
111
+ if (process.stdin.isTTY) throw new Error('Pipe a tool log into stdin; interactive tools are not supported.');
112
+ await compact(store);
113
+ }
114
+ }
@@ -35,6 +35,7 @@ import { once } from 'node:events';
35
35
  import { createServer } from 'node:http';
36
36
  import type { IncomingMessage, Server, ServerResponse } from 'node:http';
37
37
  import { estimateTokens, gatewayDecision, streamingUsageReader, usageFromResponse } from '@trazum/core';
38
+ import { GatewaySpend } from './gateway-spend.js';
38
39
  import type {
39
40
  GatewayDecision,
40
41
  GatewayPolicy,
@@ -277,6 +278,8 @@ const HOP_BY_HOP = new Set([
277
278
  ]);
278
279
 
279
280
  export interface GatewayContext {
281
+ /** Add this process's usage and in-flight reservations to startup snapshots. */
282
+ liveBudget?: boolean;
280
283
  provider: string;
281
284
  catalogue: PricingCatalogue;
282
285
  policy: GatewayPolicy;
@@ -466,8 +469,10 @@ function refusalBody(decision: Extract<GatewayDecision, { kind: 'refuse' }>): st
466
469
  export function buildGateway(context: GatewayContext): Server {
467
470
  const upstream = UPSTREAMS[context.provider];
468
471
  const doFetch = context.fetchImpl ?? fetch;
472
+ const spend = context.liveBudget ? new GatewaySpend(context.catalogue) : null;
469
473
 
470
474
  return createServer((request: IncomingMessage, response: ServerResponse) => {
475
+ let ticket: symbol | undefined;
471
476
  void (async () => {
472
477
  if (upstream === undefined) {
473
478
  response.writeHead(500, { 'content-type': 'application/json' });
@@ -560,21 +565,25 @@ export function buildGateway(context: GatewayContext): Server {
560
565
  return;
561
566
  }
562
567
 
568
+ const call = { provider: context.provider, ...described };
569
+ const baseStanding = context.standing();
570
+ const standing = spend === null ? baseStanding : spend.standing(baseStanding);
571
+ const basePosition = context.position?.({
572
+ ...(described.label === null ? {} : { label: described.label }),
573
+ ...(described.session === null ? {} : { session: described.session }),
574
+ });
563
575
  const decision = gatewayDecision(
564
- { provider: context.provider, ...described },
565
- context.standing(),
576
+ call,
577
+ standing,
566
578
  {
567
579
  catalogue: context.catalogue,
568
580
  policy: context.policy,
569
581
  ...(context.limits === undefined ? {} : { limits: context.limits }),
570
582
  ...(context.waivers === undefined ? {} : { waivers: context.waivers }),
571
- ...(context.position === undefined
583
+ ...(basePosition === undefined
572
584
  ? {}
573
585
  : {
574
- position: context.position({
575
- ...(described.label === null ? {} : { label: described.label }),
576
- ...(described.session === null ? {} : { session: described.session }),
577
- }),
586
+ position: spend === null ? basePosition : spend.position(basePosition, call),
578
587
  }),
579
588
  },
580
589
  );
@@ -595,6 +604,16 @@ export function buildGateway(context: GatewayContext): Server {
595
604
  return;
596
605
  }
597
606
 
607
+ if (spend !== null) {
608
+ const admission = spend.reserve(call, decision, standing, context.policy.onCannotTell === 'fail-closed');
609
+ if (admission.refusal !== undefined) {
610
+ response.writeHead(402, { 'content-type': 'application/json' });
611
+ response.end(`${JSON.stringify(admission.refusal)}\n`);
612
+ return;
613
+ }
614
+ ticket = admission.ticket;
615
+ }
616
+
598
617
  const outgoing = new Headers();
599
618
  for (const [name, value] of Object.entries(request.headers)) {
600
619
  if (HOP_BY_HOP.has(name.toLowerCase()) || value === undefined) continue;
@@ -624,6 +643,8 @@ export function buildGateway(context: GatewayContext): Server {
624
643
  body: forwarded,
625
644
  });
626
645
  } catch (error) {
646
+ // A transport failure does not prove the provider did no billable work.
647
+ if (ticket !== undefined) spend?.settle(ticket, described.model, null);
627
648
  /**
628
649
  * The upstream is unreachable. This is **not** a budget refusal and
629
650
  * must not look like one: the caller needs to tell "your provider is
@@ -646,6 +667,13 @@ export function buildGateway(context: GatewayContext): Server {
646
667
 
647
668
  /** Counts only ever reach `record`; the body is never kept, either way. */
648
669
  const recordUsage = (usage: ReturnType<typeof usageFromResponse>): void => {
670
+ if (ticket !== undefined) {
671
+ // Only explicit request/auth/rate-limit rejections establish no generation.
672
+ // Server errors and timeouts may arrive after billable work.
673
+ const rejectedBeforeGeneration = [400, 401, 403, 404, 405, 413, 415, 422, 429].includes(upstreamResponse.status);
674
+ if (rejectedBeforeGeneration && usage === null) spend?.release(ticket);
675
+ else spend?.settle(ticket, decision.kind === 'substitute' ? decision.to.id : described.model, usage);
676
+ }
649
677
  if (usage === null) return;
650
678
  context.record({
651
679
  model: decision.kind === 'substitute' ? decision.to.id : described.model,
@@ -681,7 +709,7 @@ export function buildGateway(context: GatewayContext): Server {
681
709
  } catch {
682
710
  measured = null;
683
711
  }
684
- const buffered = usageFromResponse(context.provider, measured);
712
+ const buffered = usageFromResponse(context.provider, measured, { requireComplete: context.liveBudget === true });
685
713
  /**
686
714
  * The buffered path was the silent one.
687
715
  *
@@ -712,7 +740,7 @@ export function buildGateway(context: GatewayContext): Server {
712
740
 
713
741
  response.writeHead(upstreamResponse.status, back);
714
742
 
715
- const reader = streamingUsageReader(context.provider);
743
+ const reader = streamingUsageReader(context.provider, { requireComplete: context.liveBudget === true });
716
744
  const decoder = new TextDecoder();
717
745
  try {
718
746
  for await (const chunk of upstreamResponse.body as AsyncIterable<Uint8Array>) {
@@ -725,6 +753,7 @@ export function buildGateway(context: GatewayContext): Server {
725
753
  }
726
754
  reader.push(decoder.decode());
727
755
  } catch (error) {
756
+ if (ticket !== undefined) spend?.settle(ticket, described.model, null);
728
757
  /**
729
758
  * The stream broke partway. The head is already sent, so there is no
730
759
  * status left to change and no refusal to render — destroying the
@@ -756,7 +785,14 @@ export function buildGateway(context: GatewayContext): Server {
756
785
  }
757
786
  recordUsage(streamed);
758
787
  response.end();
759
- })();
788
+ })().catch(() => {
789
+ if (ticket !== undefined) spend?.settle(ticket, 'unknown', null);
790
+ if (response.headersSent) response.destroy();
791
+ else {
792
+ response.writeHead(502, { 'content-type': 'application/json' });
793
+ response.end(`${JSON.stringify({ error: { type: 'trazum_gateway_error', message: 'The gateway could not complete this call.' } })}\n`);
794
+ }
795
+ }).finally(() => { if (ticket !== undefined) spend?.release(ticket); });
760
796
  });
761
797
  }
762
798