@windagency/valora 2.1.4 → 2.2.0

package/dist/batch/batch.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.types.d.ts","sourceRoot":"","sources":["../../src/batch/batch.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEjF,MAAM,WAAW,YAAY;IAC5B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,OAAO,EAAE,oBAAoB,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC3B,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,yBAAyB;IACzB,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,gBAAgB,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,YAAY,GAAG,QAAQ,CAAC;AAE1G,MAAM,WAAW,eAAe;IAC/B,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,gBAAgB,CAAC;IACzB,eAAe;IACf,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,eAAe,CAAC;CAC5B"}

package/dist/batch/batch.types.js

@@ -0,0 +1,5 @@
+/**
+ * Batch processing type definitions
+ */
+export {};
+//# sourceMappingURL=batch.types.js.map

package/dist/batch/batch.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.types.js","sourceRoot":"","sources":["../../src/batch/batch.types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/batch/providers/anthropic.batch-provider.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Anthropic Message Batches helper functions
+ *
+ * Used by AnthropicProvider to implement BatchableProvider.
+ * Handles request formatting, status mapping, and response parsing
+ * specific to the Anthropic batch API.
+ */
+import type Anthropic from '@anthropic-ai/sdk';
+import type { BatchResult, BatchStatusInfo, BatchStatusValue, BatchSubmission } from '../batch.types.js';
+/**
+ * Maps Anthropic processing_status → BatchStatusValue
+ */
+export declare function mapAnthropicStatus(status: string): BatchStatusValue;
+/**
+ * Submit requests to the Anthropic Message Batches API
+ */
+export declare function submitAnthropicBatch(client: Anthropic, requests: Array<{
+    customId: string;
+    params: Anthropic.MessageCreateParamsNonStreaming;
+}>, providerName: string, localId: string): Promise<BatchSubmission>;
+/**
+ * Retrieve batch status from Anthropic
+ */
+export declare function getAnthropicBatchStatus(client: Anthropic, batchId: string): Promise<BatchStatusInfo>;
+/**
+ * Retrieve completed batch results from Anthropic
+ */
+export declare function getAnthropicBatchResults(client: Anthropic, batchId: string): Promise<BatchResult[]>;
+/**
+ * Cancel a batch job
+ */
+export declare function cancelAnthropicBatch(client: Anthropic, batchId: string): Promise<void>;
+//# sourceMappingURL=anthropic.batch-provider.d.ts.map

package/dist/batch/providers/anthropic.batch-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.batch-provider.d.ts","sourceRoot":"","sources":["../../../src/batch/providers/anthropic.batch-provider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIzG;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAWnE;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACzC,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,KAAK,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,CAAC,+BAA+B,CAAC;CAClD,CAAC,EACF,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,CAAC,CAgB1B;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAY1G;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CA0CzG;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5F"}

package/dist/batch/providers/anthropic.batch-provider.js

@@ -0,0 +1,106 @@
+/**
+ * Anthropic Message Batches helper functions
+ *
+ * Used by AnthropicProvider to implement BatchableProvider.
+ * Handles request formatting, status mapping, and response parsing
+ * specific to the Anthropic batch API.
+ */
+/**
+ * Maps Anthropic processing_status → BatchStatusValue
+ */
+export function mapAnthropicStatus(status) {
+    switch (status) {
+        case 'canceling':
+            return 'cancelled';
+        case 'ended':
+            return 'completed';
+        case 'in_progress':
+            return 'processing';
+        default:
+            return 'queued';
+    }
+}
+/**
+ * Submit requests to the Anthropic Message Batches API
+ */
+export async function submitAnthropicBatch(client, requests, providerName, localId) {
+    const batchRequests = requests.map((r) => ({
+        custom_id: r.customId,
+        params: r.params
+    }));
+    const batch = await client.beta.messages.batches.create({ requests: batchRequests });
+    return {
+        batchId: batch.id,
+        localId,
+        provider: providerName,
+        requestCount: requests.length,
+        status: mapAnthropicStatus(batch.processing_status),
+        submittedAt: new Date().toISOString()
+    };
+}
+/**
+ * Retrieve batch status from Anthropic
+ */
+export async function getAnthropicBatchStatus(client, batchId) {
+    const batch = await client.beta.messages.batches.retrieve(batchId);
+    const counts = batch.request_counts;
+    const totalCount = counts.processing + counts.succeeded + counts.errored + counts.canceled + counts.expired;
+    return {
+        batchId: batch.id,
+        completedCount: counts.succeeded,
+        failedCount: counts.errored,
+        status: mapAnthropicStatus(batch.processing_status),
+        totalCount
+    };
+}
+/**
+ * Retrieve completed batch results from Anthropic
+ */
+export async function getAnthropicBatchResults(client, batchId) {
+    const results = [];
+    for await (const item of await client.beta.messages.batches.results(batchId)) {
+        if (item.result.type === 'succeeded') {
+            const message = item.result.message;
+            const usage = {
+                completion_tokens: message.usage.output_tokens,
+                prompt_tokens: message.usage.input_tokens,
+                total_tokens: message.usage.input_tokens + message.usage.output_tokens
+            };
+            const raw = message.usage;
+            if (typeof raw['cache_creation_input_tokens'] === 'number') {
+                usage.cache_creation_input_tokens = raw['cache_creation_input_tokens'];
+            }
+            if (typeof raw['cache_read_input_tokens'] === 'number') {
+                usage.cache_read_input_tokens = raw['cache_read_input_tokens'];
+            }
+            usage.batch_discount_applied = true;
+            const completion = {
+                content: message.content
+                    .filter((b) => b.type === 'text')
+                    .map((b) => b.text)
+                    .join(''),
+                finish_reason: message.stop_reason ?? undefined,
+                role: 'assistant',
+                usage
+            };
+            results.push({ id: item.custom_id, result: completion });
+        }
+        else if (item.result.type === 'errored') {
+            results.push({
+                error: item.result.error?.type ?? 'unknown error',
+                id: item.custom_id
+            });
+        }
+        else {
+            results.push({ error: `unexpected result type: ${item.result.type}`, id: item.custom_id });
+        }
+    }
+    return results;
+}
+/**
+ * Cancel a batch job
+ */
+export async function cancelAnthropicBatch(client, batchId) {
+    await client.beta.messages.batches.cancel(batchId);
+}
+//# sourceMappingURL=anthropic.batch-provider.js.map

package/dist/batch/providers/anthropic.batch-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.batch-provider.js","sourceRoot":"","sources":["../../../src/batch/providers/anthropic.batch-provider.ts"],"names":[],"mappings":"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"}

package/dist/batch/providers/google.batch-provider.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Google Vertex AI Batch Prediction helper stubs
+ *
+ * Full implementation requires `@google-cloud/aiplatform` and a GCS bucket.
+ * Install `@google-cloud/aiplatform` and set `vertex_project` in provider config
+ * to enable. Until then, `supportsBatch()` returns false and this module is a
+ * no-op placeholder.
+ */
+import type { BatchResult, BatchStatusInfo, BatchSubmission } from '../batch.types.js';
+/**
+ * Check whether Vertex AI batch is configured.
+ * Returns true only when a project ID is provided via config.
+ */
+export declare function isVertexBatchConfigured(config: Record<string, unknown>): boolean;
+/**
+ * Stub: submit a Vertex AI batch job.
+ * Requires `@google-cloud/aiplatform` — throws until implemented.
+ */
+export declare function submitVertexBatch(_config: Record<string, unknown>, _requests: unknown[], _providerName: string, _localId: string): Promise<BatchSubmission>;
+/**
+ * Stub: get Vertex AI batch status.
+ */
+export declare function getVertexBatchStatus(_config: Record<string, unknown>, _batchId: string): Promise<BatchStatusInfo>;
+/**
+ * Stub: get Vertex AI batch results.
+ */
+export declare function getVertexBatchResults(_config: Record<string, unknown>, _batchId: string): Promise<BatchResult[]>;
+/**
+ * Stub: cancel a Vertex AI batch job.
+ */
+export declare function cancelVertexBatch(_config: Record<string, unknown>, _batchId: string): Promise<void>;
+//# sourceMappingURL=google.batch-provider.d.ts.map

package/dist/batch/providers/google.batch-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google.batch-provider.d.ts","sourceRoot":"","sources":["../../../src/batch/providers/google.batch-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEvF;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAEhF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,SAAS,EAAE,OAAO,EAAE,EACpB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GACd,OAAO,CAAC,eAAe,CAAC,CAM1B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAEjH;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAEhH;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnG"}

package/dist/batch/providers/google.batch-provider.js

@@ -0,0 +1,41 @@
+/**
+ * Google Vertex AI Batch Prediction helper stubs
+ *
+ * Full implementation requires `@google-cloud/aiplatform` and a GCS bucket.
+ * Install `@google-cloud/aiplatform` and set `vertex_project` in provider config
+ * to enable. Until then, `supportsBatch()` returns false and this module is a
+ * no-op placeholder.
+ */
+/**
+ * Check whether Vertex AI batch is configured.
+ * Returns true only when a project ID is provided via config.
+ */
+export function isVertexBatchConfigured(config) {
+    return typeof config['vertex_project'] === 'string' && config['vertex_project'].length > 0;
+}
+/**
+ * Stub: submit a Vertex AI batch job.
+ * Requires `@google-cloud/aiplatform` — throws until implemented.
+ */
+export function submitVertexBatch(_config, _requests, _providerName, _localId) {
+    return Promise.reject(new Error('Google Vertex AI batch is not yet implemented. Install @google-cloud/aiplatform and configure vertex_project to enable.'));
+}
+/**
+ * Stub: get Vertex AI batch status.
+ */
+export function getVertexBatchStatus(_config, _batchId) {
+    return Promise.reject(new Error('Google Vertex AI batch is not yet implemented.'));
+}
+/**
+ * Stub: get Vertex AI batch results.
+ */
+export function getVertexBatchResults(_config, _batchId) {
+    return Promise.reject(new Error('Google Vertex AI batch is not yet implemented.'));
+}
+/**
+ * Stub: cancel a Vertex AI batch job.
+ */
+export function cancelVertexBatch(_config, _batchId) {
+    return Promise.reject(new Error('Google Vertex AI batch is not yet implemented.'));
+}
+//# sourceMappingURL=google.batch-provider.js.map

package/dist/batch/providers/google.batch-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"google.batch-provider.js","sourceRoot":"","sources":["../../../src/batch/providers/google.batch-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAA+B;IACtE,OAAO,OAAO,MAAM,CAAC,gBAAgB,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,gBAAgB,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;AAC5F,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAChC,OAAgC,EAChC,SAAoB,EACpB,aAAqB,EACrB,QAAgB;IAEhB,OAAO,OAAO,CAAC,MAAM,CACpB,IAAI,KAAK,CACR,yHAAyH,CACzH,CACD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAgC,EAAE,QAAgB;IACtF,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC,CAAC;AACpF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAgC,EAAE,QAAgB;IACvF,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC,CAAC;AACpF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAgC,EAAE,QAAgB;IACnF,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC,CAAC;AACpF,CAAC"}

package/dist/batch/providers/openai.batch-provider.d.ts

@@ -0,0 +1,32 @@
+/**
+ * OpenAI Batch API helper functions
+ *
+ * Used by OpenAIProvider to implement BatchableProvider.
+ * Handles JSONL serialisation, file upload, and response parsing.
+ */
+import type { BatchResult, BatchStatusInfo, BatchStatusValue, BatchSubmission } from '../batch.types.js';
+import type OpenAI from 'openai';
+/**
+ * Maps OpenAI batch status → BatchStatusValue
+ */
+export declare function mapOpenAIStatus(status: string): BatchStatusValue;
+/**
+ * Submit a batch to OpenAI
+ */
+export declare function submitOpenAIBatch(client: OpenAI, requests: Array<{
+    customId: string;
+    params: OpenAI.Chat.Completions.ChatCompletionCreateParamsNonStreaming;
+}>, providerName: string, localId: string): Promise<BatchSubmission>;
+/**
+ * Get batch status from OpenAI
+ */
+export declare function getOpenAIBatchStatus(client: OpenAI, batchId: string): Promise<BatchStatusInfo>;
+/**
+ * Retrieve completed batch results from OpenAI
+ */
+export declare function getOpenAIBatchResults(client: OpenAI, batchId: string): Promise<BatchResult[]>;
+/**
+ * Cancel an OpenAI batch job
+ */
+export declare function cancelOpenAIBatch(client: OpenAI, batchId: string): Promise<void>;
+//# sourceMappingURL=openai.batch-provider.d.ts.map

package/dist/batch/providers/openai.batch-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.batch-provider.d.ts","sourceRoot":"","sources":["../../../src/batch/providers/openai.batch-provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzG,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAMjC;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAiBhE;AAYD;;GAEG;AACH,wBAAsB,iBAAiB,CACtC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,KAAK,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,sCAAsC,CAAC;CACvE,CAAC,EACF,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,CAAC,CA8B1B;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAcpG;AAiED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CA0BnG;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtF"}

package/dist/batch/providers/openai.batch-provider.js

@@ -0,0 +1,151 @@
+/**
+ * OpenAI Batch API helper functions
+ *
+ * Used by OpenAIProvider to implement BatchableProvider.
+ * Handles JSONL serialisation, file upload, and response parsing.
+ */
+import { File } from 'buffer';
+/**
+ * Maps OpenAI batch status → BatchStatusValue
+ */
+export function mapOpenAIStatus(status) {
+    switch (status) {
+        case 'cancelled':
+        case 'cancelling':
+            return 'cancelled';
+        case 'completed':
+            return 'completed';
+        case 'expired':
+            return 'expired';
+        case 'failed':
+            return 'failed';
+        case 'finalizing':
+        case 'in_progress':
+            return 'processing';
+        default:
+            return 'queued';
+    }
+}
+/**
+ * Submit a batch to OpenAI
+ */
+export async function submitOpenAIBatch(client, requests, providerName, localId) {
+    // Serialise requests as JSONL
+    const lines = requests.map((r) => ({
+        body: r.params,
+        custom_id: r.customId,
+        method: 'POST',
+        url: '/v1/chat/completions'
+    }));
+    const jsonlContent = lines.map((l) => JSON.stringify(l)).join('\n');
+    // Upload the JSONL file — cast as any to accommodate OpenAI SDK's Uploadable type
+    const file = new File([jsonlContent], 'batch.jsonl', { type: 'application/jsonl' });
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-assignment
+    const uploaded = await client.files.create({ file: file, purpose: 'batch' });
+    // Create the batch job
+    const batch = await client.batches.create({
+        completion_window: '24h',
+        endpoint: '/v1/chat/completions',
+        input_file_id: uploaded.id
+    });
+    return {
+        batchId: batch.id,
+        localId,
+        provider: providerName,
+        requestCount: requests.length,
+        status: mapOpenAIStatus(batch.status),
+        submittedAt: new Date().toISOString()
+    };
+}
+/**
+ * Get batch status from OpenAI
+ */
+export async function getOpenAIBatchStatus(client, batchId) {
+    const batch = await client.batches.retrieve(batchId);
+    const counts = batch.request_counts;
+    const totalCount = counts?.total ?? 0;
+    const completedCount = counts?.completed ?? 0;
+    const failedCount = counts?.failed ?? 0;
+    return {
+        batchId: batch.id,
+        completedCount,
+        failedCount,
+        status: mapOpenAIStatus(batch.status),
+        totalCount
+    };
+}
+/**
+ * Build normalised LLMUsage from an OpenAI CompletionUsage, including cache fields.
+ */
+function buildOpenAIUsage(raw) {
+    const usage = {
+        batch_discount_applied: true,
+        completion_tokens: raw.completion_tokens,
+        prompt_tokens: raw.prompt_tokens,
+        total_tokens: raw.total_tokens
+    };
+    const details = raw.prompt_tokens_details;
+    const cachedTokens = typeof details?.['cached_tokens'] === 'number' ? details['cached_tokens'] : 0;
+    if (cachedTokens > 0) {
+        usage.cache_read_input_tokens = cachedTokens;
+    }
+    return usage;
+}
+/**
+ * Build an LLMCompletionResult from a single OpenAI chat choice.
+ */
+function buildOpenAICompletion(choice, usage) {
+    return {
+        content: choice.message.content ?? '',
+        finish_reason: choice.finish_reason,
+        role: 'assistant',
+        tool_calls: choice.message.tool_calls?.map((tc) => ({
+            arguments: JSON.parse(tc.function.arguments),
+            id: tc.id,
+            name: tc.function.name
+        })),
+        usage
+    };
+}
+/**
+ * Parse a single JSONL line from an OpenAI batch output file into a BatchResult.
+ */
+function parseOpenAIBatchLine(parsed) {
+    if (parsed.error) {
+        return { error: `${parsed.error.code}: ${parsed.error.message}`, id: parsed.custom_id };
+    }
+    const body = parsed.response?.body;
+    const choice = body?.choices?.[0];
+    if (!choice) {
+        return { error: 'no choices in response', id: parsed.custom_id };
+    }
+    const usage = body.usage ? buildOpenAIUsage(body.usage) : undefined;
+    return { id: parsed.custom_id, result: buildOpenAICompletion(choice, usage) };
+}
+/**
+ * Retrieve completed batch results from OpenAI
+ */
+export async function getOpenAIBatchResults(client, batchId) {
+    const batch = await client.batches.retrieve(batchId);
+    if (!batch.output_file_id) {
+        throw new Error(`Batch ${batchId} has no output file — status: ${batch.status}`);
+    }
+    const fileContent = await client.files.content(batch.output_file_id);
+    const rawText = await fileContent.text();
+    const results = [];
+    for (const line of rawText.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        const parsed = JSON.parse(trimmed);
+        results.push(parseOpenAIBatchLine(parsed));
+    }
+    return results;
+}
+/**
+ * Cancel an OpenAI batch job
+ */
+export async function cancelOpenAIBatch(client, batchId) {
+    await client.batches.cancel(batchId);
+}
+//# sourceMappingURL=openai.batch-provider.js.map

package/dist/batch/providers/openai.batch-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.batch-provider.js","sourceRoot":"","sources":["../../../src/batch/providers/openai.batch-provider.ts"],"names":[],"mappings":"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"}

package/dist/cli/command-executor.d.ts

@@ -103,6 +103,11 @@ export declare class CommandExecutor {
      * Calculate detailed token usage breakdown from command result
      */
     private calculateTokenUsage;
+    /**
+     * Compute cost from a token breakdown and append a record to the spending ledger.
+     * Returns the cost result for passing through to the result presenter.
+     */
+    private computeAndRecordSpending;
     /**
      * List available commands
      */

package/dist/cli/command-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-executor.d.ts","sourceRoot":"","sources":["../../src/cli/command-executor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"command-executor.d.ts","sourceRoot":"","sources":["../../src/cli/command-executor.ts"],"names":[],"mappings":"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"}

package/dist/cli/command-executor.js

@@ -18,6 +18,8 @@ import { SessionStore } from '../session/store.js';
 import { getPromptAdapter } from '../ui/prompt-adapter.interface.js';
 import { formatErrorMessage } from '../utils/error-utils.js';
 import { incrementCounter, timeAsync } from '../utils/metrics-collector.js';
+import { getSpendingTracker } from '../utils/spending-tracker.js';
+import { calculateActualCost } from '../utils/token-estimator.js';
 import { CommandErrorHandler } from './command-error-handler.js';
 import { CommandResolver } from './command-resolver.js';
 import { CommandValidator } from './command-validator.js';
@@ -220,6 +222,9 @@ export class CommandExecutor {
                 this.updateSessionState(commandName, options, result, duration, tokenBreakdown, finalSessionManager);
                 // Step 5.5: Restore stashed changes if stash protection was used
                 await this.restoreStashProtection(stashProtection);
+                // Compute cost from token breakdown and record to spending ledger
+                const model = resolvedCommand.command.model;
+                const costResult = this.computeAndRecordSpending(commandName, options, tokenBreakdown, model, duration, result);
                 // Step 6: Handle result (success or failure)
                 if (result.success) {
                     const isDryRun = options.flags['dryRun'] === true || options.flags['dry-run'] === true;
@@ -227,7 +232,9 @@ export class CommandExecutor {
                     const taskId = typeof taskIdFlag === 'string' ? taskIdFlag : undefined;
                     const documentOptions = { ...(options.documentOutput ?? { enabled: true }), taskId };
                     return await this.handleSuccessfulResult({
+                        cacheSavingsUsd: costResult.cacheSavings,
                         commandName,
+                        costUsd: costResult.totalCost,
                         documentOptions,
                         duration,
                         isDryRun,
@@ -238,7 +245,7 @@ export class CommandExecutor {
                         totalSessionTokens
                     });
                 }
-                await this.handleFailedResult(commandName, result, duration, finalSessionManager.getSession().session_id, tokenBreakdown, totalSessionTokens);
+                await this.handleFailedResult(commandName, result, duration, finalSessionManager.getSession().session_id, tokenBreakdown, totalSessionTokens, costResult.totalCost, costResult.cacheSavings);
                 return result;
             }
             catch (error) {
@@ -326,15 +333,61 @@ export class CommandExecutor {
         const tokenUsage = result.stages.reduce((acc, stage) => {
             const usageValue = stage.outputs?.['usage'];
             if (usageValue && isTokenUsage(usageValue)) {
+                const usage = usageValue;
+                const cacheRead = typeof usage['cache_read_input_tokens'] === 'number'
+                    ? usage['cache_read_input_tokens']
+                    : 0;
+                const cacheWrite = typeof usage['cache_creation_input_tokens'] === 'number'
+                    ? usage['cache_creation_input_tokens']
+                    : 0;
                 return {
-                    context: acc.context + (usageValue.prompt_tokens ?? 0),
-                    generation: acc.generation + (usageValue.completion_tokens ?? 0),
-                    total: acc.total + (usageValue.total_tokens ?? 0)
+                    cache_read: acc.cache_read + cacheRead,
+                    cache_write: acc.cache_write + cacheWrite,
+                    context: acc.context + (usage.prompt_tokens ?? 0),
+                    generation: acc.generation + (usage.completion_tokens ?? 0),
+                    total: acc.total + (usage.total_tokens ?? 0)
                 };
             }
             return acc;
-        }, { context: 0, generation: 0, total: 0 });
-        return tokenUsage;
+        }, { cache_read: 0, cache_write: 0, context: 0, generation: 0, total: 0 });
+        // Only include cache fields if they have values
+        return {
+            ...(tokenUsage.cache_read > 0 ? { cache_read: tokenUsage.cache_read } : {}),
+            ...(tokenUsage.cache_write > 0 ? { cache_write: tokenUsage.cache_write } : {}),
+            context: tokenUsage.context,
+            generation: tokenUsage.generation,
+            total: tokenUsage.total
+        };
+    }
+    /**
+     * Compute cost from a token breakdown and append a record to the spending ledger.
+     * Returns the cost result for passing through to the result presenter.
+     */
+    computeAndRecordSpending(commandName, options, tokenBreakdown, model, duration, result) {
+        const costResult = calculateActualCost({
+            cache_creation_input_tokens: tokenBreakdown.cache_write ?? 0,
+            cache_read_input_tokens: tokenBreakdown.cache_read ?? 0,
+            completion_tokens: tokenBreakdown.generation,
+            prompt_tokens: tokenBreakdown.context,
+            total_tokens: tokenBreakdown.total
+        }, model);
+        getSpendingTracker().record({
+            batchDiscounted: options.flags['batch'] === true,
+            cacheReadTokens: tokenBreakdown.cache_read ?? 0,
+            cacheSavingsUsd: costResult.cacheSavings,
+            cacheWriteTokens: tokenBreakdown.cache_write ?? 0,
+            command: commandName,
+            completionTokens: tokenBreakdown.generation,
+            costUsd: costResult.totalCost,
+            durationMs: duration,
+            id: `${Date.now()}-${commandName}`,
+            model: model ?? 'unknown',
+            promptTokens: tokenBreakdown.context,
+            stage: result.stages.map((s) => s.stage).join('+'),
+            timestamp: new Date().toISOString(),
+            totalTokens: tokenBreakdown.total
+        });
+        return costResult;
     }
     /**
      * List available commands
@@ -359,7 +412,7 @@ export class CommandExecutor {
      * Handle successful command result (display and document processing)
      */
     async handleSuccessfulResult(ctx) {
-        this.resultPresenter.displaySuccess(ctx.commandName, ctx.result.outputs, ctx.duration, ctx.sessionManager.getSession().session_id, ctx.resolvedCommand.command.agent, ctx.resolvedCommand.command.model, ctx.tokenBreakdown, ctx.totalSessionTokens);
+        this.resultPresenter.displaySuccess(ctx.commandName, ctx.result.outputs, ctx.duration, ctx.sessionManager.getSession().session_id, ctx.resolvedCommand.command.agent, ctx.resolvedCommand.command.model, ctx.tokenBreakdown, ctx.totalSessionTokens, ctx.costUsd, ctx.cacheSavingsUsd);
         if (ctx.isDryRun) {
             await this.sessionManager.completeSession();
             return ctx.result;
@@ -386,8 +439,8 @@ export class CommandExecutor {
     /**
      * Handle failed command result (display and lifecycle)
      */
-    async handleFailedResult(commandName, result, duration, sessionId, tokenBreakdown, totalSessionTokens) {
-        this.resultPresenter.displayFailure(commandName, result.error, duration, sessionId, tokenBreakdown, totalSessionTokens);
+    async handleFailedResult(commandName, result, duration, sessionId, tokenBreakdown, totalSessionTokens, costUsd, cacheSavingsUsd) {
+        this.resultPresenter.displayFailure(commandName, result.error, duration, sessionId, tokenBreakdown, totalSessionTokens, costUsd, cacheSavingsUsd);
         await this.sessionLifecycle.fail(result.error);
     }
     /**
@@ -475,8 +528,7 @@ export class CommandExecutor {
         const stageOutputs = {};
         for (const stage of result.stages) {
             if (stage.success && stage.outputs) {
-                // Use stage.prompt as the key since it's unique within a command
-                const stageKey = `${stage.stage}_${stage.prompt}`;
+                const stageKey = stage.stage;
                 stageOutputs[stageKey] = stage.outputs;
             }
         }