@substrate-ai/factory 0.19.54

package/dist/llm/__tests__/types.test.js

@@ -0,0 +1,289 @@
+import { describe, it, expect } from 'vitest';
+// ---------------------------------------------------------------------------
+// MockAdapter — implements ProviderAdapter; TypeScript compile-time verification
+// ---------------------------------------------------------------------------
+class MockAdapter {
+    name = 'mock';
+    async complete(request) {
+        return {
+            content: 'hello',
+            toolCalls: [],
+            usage: { inputTokens: 10, outputTokens: 5, totalTokens: 15 },
+            model: request.model,
+            stopReason: 'stop',
+            providerMetadata: {},
+        };
+    }
+    async *stream(_request) {
+        yield { type: 'text_delta', delta: 'hello' };
+        yield { type: 'message_stop', finishReason: { reason: 'stop' } };
+    }
+}
+// ---------------------------------------------------------------------------
+// AC1: ProviderAdapter interface
+// ---------------------------------------------------------------------------
+describe('ProviderAdapter interface (AC1)', () => {
+    it('MockAdapter has a string name property', () => {
+        const adapter = new MockAdapter();
+        expect(typeof adapter.name).toBe('string');
+        expect(adapter.name).toBe('mock');
+    });
+    it('complete() returns a value satisfying LLMResponse shape', async () => {
+        const adapter = new MockAdapter();
+        const response = await adapter.complete({
+            model: 'test-model',
+            messages: [{ role: 'user', content: [{ kind: 'text', text: 'hi' }] }],
+        });
+        expect(response.content).toBe('hello');
+        expect(response.toolCalls).toEqual([]);
+        expect(response.stopReason).toBe('stop');
+        expect(response.model).toBe('test-model');
+        expect(response.providerMetadata).toEqual({});
+    });
+    it('stream() yields StreamEvent objects', async () => {
+        const adapter = new MockAdapter();
+        const events = [];
+        for await (const event of adapter.stream({
+            model: 'test-model',
+            messages: [{ role: 'user', content: [{ kind: 'text', text: 'hi' }] }],
+        })) {
+            events.push(event);
+        }
+        expect(events).toHaveLength(2);
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        expect(events[0].type).toBe('text_delta');
+        expect(events[0].delta).toBe('hello');
+        expect(events[1].type).toBe('message_stop');
+    });
+    it('optional methods (close, initialize, supportsToolChoice) are not required', () => {
+        // MockAdapter does not implement optional methods — TypeScript compile-time check
+        const adapter = new MockAdapter();
+        expect(adapter.close).toBeUndefined();
+        expect(adapter.initialize).toBeUndefined();
+        expect(adapter.supportsToolChoice).toBeUndefined();
+    });
+});
+// ---------------------------------------------------------------------------
+// AC2: LLMRequest — required and optional fields
+// ---------------------------------------------------------------------------
+describe('LLMRequest type (AC2)', () => {
+    it('minimal request requires only model and messages', () => {
+        const req = {
+            model: 'claude-opus-4-5',
+            messages: [{ role: 'user', content: [{ kind: 'text', text: 'Hello' }] }],
+        };
+        expect(req.model).toBe('claude-opus-4-5');
+        expect(req.messages).toHaveLength(1);
+    });
+    it('maximal request accepts all optional fields', () => {
+        const tool = {
+            name: 'search',
+            description: 'Search the web',
+            parameters: { type: 'object', properties: {} },
+        };
+        const req = {
+            model: 'gpt-4o',
+            messages: [{ role: 'user', content: [{ kind: 'text', text: 'Hi' }] }],
+            systemPrompt: 'You are helpful',
+            tools: [tool],
+            toolChoice: 'auto',
+            maxTokens: 1024,
+            temperature: 0.7,
+            reasoningEffort: 'high',
+            metadata: { sessionId: 'abc123' },
+            extra: { anthropicVersion: '2023-06-01' },
+        };
+        expect(req).toMatchObject({
+            model: 'gpt-4o',
+            systemPrompt: 'You are helpful',
+            toolChoice: 'auto',
+            maxTokens: 1024,
+            temperature: 0.7,
+            reasoningEffort: 'high',
+        });
+        expect(req.extra?.anthropicVersion).toBe('2023-06-01');
+    });
+    it('toolChoice can be an object with type:function', () => {
+        const req = {
+            model: 'test',
+            messages: [],
+            toolChoice: { type: 'function', name: 'my_tool' },
+        };
+        expect(req.toolChoice).toEqual({ type: 'function', name: 'my_tool' });
+    });
+});
+// ---------------------------------------------------------------------------
+// AC3: LLMResponse — all required fields
+// ---------------------------------------------------------------------------
+describe('LLMResponse type (AC3)', () => {
+    it('response satisfies all six required fields', () => {
+        const response = {
+            content: 'The answer is 42',
+            toolCalls: [],
+            usage: { inputTokens: 20, outputTokens: 10, totalTokens: 30 },
+            model: 'claude-opus-4-5',
+            stopReason: 'stop',
+            providerMetadata: { requestId: 'req_123' },
+        };
+        expect(response.content).toBeDefined();
+        expect(Array.isArray(response.toolCalls)).toBe(true);
+        expect(response.usage).toBeDefined();
+        expect(response.model).toBeDefined();
+        expect(response.stopReason).toBeDefined();
+        expect(response.providerMetadata).toBeDefined();
+    });
+    it('response accepts optional fields without error', () => {
+        const response = {
+            content: 'ok',
+            toolCalls: [],
+            usage: { inputTokens: 5, outputTokens: 5, totalTokens: 10 },
+            model: 'test',
+            stopReason: 'length',
+            providerMetadata: {},
+            id: 'msg_abc',
+            finishReason: { reason: 'length', raw: 'max_tokens' },
+            warnings: [{ message: 'Temperature capped', code: 'TEMP_CAP' }],
+        };
+        expect(response.id).toBe('msg_abc');
+        expect(response.finishReason?.reason).toBe('length');
+        expect(response.warnings?.[0]?.message).toBe('Temperature capped');
+    });
+});
+// ---------------------------------------------------------------------------
+// AC4: LLMToolCall — parsed arguments
+// ---------------------------------------------------------------------------
+describe('LLMToolCall type (AC4)', () => {
+    it('toolCall contains id, name, and parsed arguments', () => {
+        const tc = {
+            id: 'call_001',
+            name: 'get_weather',
+            arguments: { location: 'Paris', unit: 'celsius' },
+        };
+        expect(tc.id).toBe('call_001');
+        expect(tc.name).toBe('get_weather');
+        expect(tc.arguments.location).toBe('Paris');
+    });
+    it('rawArguments is optional — omitting it does not cause an error', () => {
+        const tc = {
+            id: 'call_002',
+            name: 'search',
+            arguments: { query: 'hello' },
+        };
+        expect(tc.rawArguments).toBeUndefined();
+    });
+    it('LLMToolCallData embeds the same shape for content parts', () => {
+        const data = {
+            id: 'tc_1',
+            name: 'run_query',
+            arguments: { sql: 'SELECT 1' },
+            rawArguments: '{"sql":"SELECT 1"}',
+        };
+        expect(data.rawArguments).toBe('{"sql":"SELECT 1"}');
+    });
+});
+// ---------------------------------------------------------------------------
+// AC5: LLMMessage and LLMRole
+// ---------------------------------------------------------------------------
+describe('LLMMessage and LLMRole types (AC5)', () => {
+    it('constructs a user message with text content part', () => {
+        const msg = {
+            role: 'user',
+            content: [{ kind: 'text', text: 'Hello!' }],
+        };
+        expect(msg.role).toBe('user');
+        expect(Array.isArray(msg.content)).toBe(true);
+        expect(msg.content[0]?.kind).toBe('text');
+        expect(msg.content[0]?.text).toBe('Hello!');
+    });
+    it('constructs an assistant message', () => {
+        const msg = {
+            role: 'assistant',
+            content: [{ kind: 'text', text: 'How can I help?' }],
+        };
+        expect(msg.role).toBe('assistant');
+    });
+    it('constructs a tool role message with toolCallId', () => {
+        const msg = {
+            role: 'tool',
+            content: [{ kind: 'tool_result', toolResult: { toolCallId: 'c1', content: 'done', isError: false } }],
+            toolCallId: 'c1',
+        };
+        expect(msg.role).toBe('tool');
+        expect(msg.toolCallId).toBe('c1');
+    });
+    it('LLMContentPart accepts tool_call kind with toolCall field', () => {
+        const part = {
+            kind: 'tool_call',
+            toolCall: { id: 'tc_1', name: 'my_tool', arguments: {} },
+        };
+        expect(part.kind).toBe('tool_call');
+        expect(part.toolCall?.name).toBe('my_tool');
+    });
+    it('constructs a system message', () => {
+        const msg = {
+            role: 'system',
+            content: [{ kind: 'text', text: 'You are a helpful assistant.' }],
+        };
+        expect(msg.role).toBe('system');
+    });
+});
+// ---------------------------------------------------------------------------
+// AC6: LLMUsage token tracking
+// ---------------------------------------------------------------------------
+describe('LLMUsage type (AC6)', () => {
+    it('minimal usage with only required fields', () => {
+        const usage = {
+            inputTokens: 100,
+            outputTokens: 50,
+            totalTokens: 150,
+        };
+        expect(usage.inputTokens).toBe(100);
+        expect(usage.outputTokens).toBe(50);
+        expect(usage.totalTokens).toBe(150);
+        expect(usage.reasoningTokens).toBeUndefined();
+        expect(usage.cacheReadTokens).toBeUndefined();
+        expect(usage.cacheWriteTokens).toBeUndefined();
+    });
+    it('full usage with all optional fields', () => {
+        const usage = {
+            inputTokens: 200,
+            outputTokens: 80,
+            totalTokens: 280,
+            reasoningTokens: 40,
+            cacheReadTokens: 120,
+            cacheWriteTokens: 80,
+        };
+        expect(usage).toMatchObject({
+            inputTokens: 200,
+            outputTokens: 80,
+            totalTokens: 280,
+            reasoningTokens: 40,
+            cacheReadTokens: 120,
+            cacheWriteTokens: 80,
+        });
+    });
+});
+// ---------------------------------------------------------------------------
+// Additional: LLMToolResult and LLMToolDefinition shape checks
+// ---------------------------------------------------------------------------
+describe('LLMToolResult and LLMToolDefinition types', () => {
+    it('LLMToolResult accepts string content', () => {
+        const result = {
+            toolCallId: 'c1',
+            content: 'Paris, 18°C',
+            isError: false,
+        };
+        expect(result.content).toBe('Paris, 18°C');
+        expect(result.isError).toBe(false);
+    });
+    it('LLMToolDefinition has name, description, and parameters', () => {
+        const def = {
+            name: 'calculator',
+            description: 'Performs arithmetic',
+            parameters: { type: 'object', properties: { expr: { type: 'string' } } },
+        };
+        expect(def.name).toBe('calculator');
+        expect(def.parameters.type).toBe('object');
+    });
+});
+//# sourceMappingURL=types.test.js.map

package/dist/llm/__tests__/types.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.test.js","sourceRoot":"","sources":["../../../src/llm/__tests__/types.test.ts"],"names":[],"mappings":"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"}

package/dist/llm/client.d.ts

@@ -0,0 +1,19 @@
+import type { ProviderAdapter, LLMRequest, LLMResponse, StreamEvent } from './types.js';
+import type { MiddlewareFn } from './middleware/types.js';
+export declare class LLMClient {
+    private adapters;
+    private modelRegistry;
+    private _middleware;
+    constructor(adapters?: Record<string, ProviderAdapter>);
+    registerProvider(name: string, adapter: ProviderAdapter): void;
+    registerModelPattern(pattern: string, providerName: string): void;
+    /**
+     * Register a middleware function that wraps every `complete()` call.
+     * Returns `this` for chaining.
+     */
+    use(mw: MiddlewareFn): this;
+    private resolveAdapter;
+    complete(request: LLMRequest): Promise<LLMResponse>;
+    stream(request: LLMRequest): AsyncIterable<StreamEvent>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/llm/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/llm/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAEvF,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,uBAAuB,CAAA;AAGzE,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,WAAW,CAAqB;gBAE5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC;IAQtD,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI;IAI9D,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAIjE;;;OAGG;IACH,GAAG,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI;IAK3B,OAAO,CAAC,cAAc;IAiBhB,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IAOlD,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,aAAa,CAAC,WAAW,CAAC;CAG/D"}

package/dist/llm/client.js

@@ -0,0 +1,50 @@
+import { ModelRegistry } from './model-registry.js';
+import { buildMiddlewareChain } from './middleware/types.js';
+export class LLMClient {
+    adapters = new Map();
+    modelRegistry = new ModelRegistry();
+    _middleware = [];
+    constructor(adapters) {
+        if (adapters) {
+            for (const [name, adapter] of Object.entries(adapters)) {
+                this.registerProvider(name, adapter);
+            }
+        }
+    }
+    registerProvider(name, adapter) {
+        this.adapters.set(name, adapter);
+    }
+    registerModelPattern(pattern, providerName) {
+        this.modelRegistry.register(pattern, providerName);
+    }
+    /**
+     * Register a middleware function that wraps every `complete()` call.
+     * Returns `this` for chaining.
+     */
+    use(mw) {
+        this._middleware.push(mw);
+        return this;
+    }
+    resolveAdapter(model) {
+        const providerName = this.modelRegistry.resolve(model);
+        const registered = [...this.adapters.keys()];
+        if (!providerName) {
+            throw new Error(`No provider matched model "${model}". Registered providers: ${registered.join(', ') || '(none)'}`);
+        }
+        const adapter = this.adapters.get(providerName);
+        if (!adapter) {
+            throw new Error(`Provider "${providerName}" matched model "${model}" but is not registered. Registered providers: ${registered.join(', ') || '(none)'}`);
+        }
+        return adapter;
+    }
+    async complete(request) {
+        const baseNext = (req) => this.resolveAdapter(req.model).complete(req);
+        const chain = buildMiddlewareChain(this._middleware, baseNext);
+        return chain(request);
+    }
+    // stream() is NOT wrapped by middleware — it delegates directly to the adapter
+    async *stream(request) {
+        yield* this.resolveAdapter(request.model).stream(request);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/llm/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/llm/client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAEnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAE5D,MAAM,OAAO,SAAS;IACZ,QAAQ,GAAG,IAAI,GAAG,EAA2B,CAAA;IAC7C,aAAa,GAAG,IAAI,aAAa,EAAE,CAAA;IACnC,WAAW,GAAmB,EAAE,CAAA;IAExC,YAAY,QAA0C;QACpD,IAAI,QAAQ,EAAE,CAAC;YACb,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACvD,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;YACtC,CAAC;QACH,CAAC;IACH,CAAC;IAED,gBAAgB,CAAC,IAAY,EAAE,OAAwB;QACrD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAClC,CAAC;IAED,oBAAoB,CAAC,OAAe,EAAE,YAAoB;QACxD,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,CAAA;IACpD,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,EAAgB;QAClB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACzB,OAAO,IAAI,CAAA;IACb,CAAC;IAEO,cAAc,CAAC,KAAa;QAClC,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QACtD,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;QAC5C,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CACb,8BAA8B,KAAK,4BAA4B,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CACnG,CAAA;QACH,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;QAC/C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,aAAa,YAAY,oBAAoB,KAAK,kDAAkD,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CACxI,CAAA;QACH,CAAC;QACD,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAmB;QAChC,MAAM,QAAQ,GAAmB,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;QACtF,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;QAC9D,OAAO,KAAK,CAAC,OAAO,CAAC,CAAA;IACvB,CAAC;IAED,+EAA+E;IAC/E,KAAK,CAAC,CAAC,MAAM,CAAC,OAAmB;QAC/B,KAAK,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAC3D,CAAC;CACF"}

package/dist/llm/index.d.ts

@@ -0,0 +1,6 @@
+export * from './types.js';
+export * from './client.js';
+export * from './model-registry.js';
+export * from './middleware/index.js';
+export * from './providers/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/llm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,qBAAqB,CAAA;AACnC,cAAc,uBAAuB,CAAA;AACrC,cAAc,sBAAsB,CAAA"}

package/dist/llm/index.js

@@ -0,0 +1,6 @@
+export * from './types.js';
+export * from './client.js';
+export * from './model-registry.js';
+export * from './middleware/index.js';
+export * from './providers/index.js';
+//# sourceMappingURL=index.js.map

package/dist/llm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,qBAAqB,CAAA;AACnC,cAAc,uBAAuB,CAAA;AACrC,cAAc,sBAAsB,CAAA"}

package/dist/llm/middleware/__tests__/cost-tracking.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cost-tracking.test.d.ts.map

package/dist/llm/middleware/__tests__/cost-tracking.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-tracking.test.d.ts","sourceRoot":"","sources":["../../../../src/llm/middleware/__tests__/cost-tracking.test.ts"],"names":[],"mappings":""}

package/dist/llm/middleware/__tests__/cost-tracking.test.js

@@ -0,0 +1,73 @@
+// packages/factory/src/llm/middleware/__tests__/cost-tracking.test.ts
+import { describe, it, expect, vi } from 'vitest';
+import { createCostTrackingMiddleware } from '../cost-tracking.js';
+// ---------------------------------------------------------------------------
+// Test helpers
+// ---------------------------------------------------------------------------
+function makeRequest(model = 'claude-opus-4-6') {
+    return {
+        model,
+        messages: [{ role: 'user', content: [{ kind: 'text', text: 'hello' }] }],
+    };
+}
+function makeResponse(inputTokens = 100, outputTokens = 50, model = 'claude-opus-4-6') {
+    return {
+        content: 'test response',
+        toolCalls: [],
+        usage: { inputTokens, outputTokens, totalTokens: inputTokens + outputTokens },
+        model,
+        stopReason: 'stop',
+        providerMetadata: {},
+    };
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('createCostTrackingMiddleware', () => {
+    it('AC3: onCost is called with correct model, provider, tokens, costUsd', async () => {
+        const records = [];
+        const mw = createCostTrackingMiddleware({
+            onCost: (r) => { records.push(r); },
+        });
+        await mw(makeRequest('claude-opus-4-6'), async () => makeResponse(100, 50));
+        expect(records).toHaveLength(1);
+        const rec = records[0];
+        expect(rec.model).toBe('claude-opus-4-6');
+        expect(rec.provider).toBe('anthropic');
+        expect(rec.inputTokens).toBe(100);
+        expect(rec.outputTokens).toBe(50);
+        expect(typeof rec.costUsd).toBe('number');
+        expect(typeof rec.timestamp).toBe('number');
+    });
+    it('AC3: costUsd is positive for known model and 0 for unknown model', async () => {
+        const knownRecords = [];
+        const unknownRecords = [];
+        const knownMw = createCostTrackingMiddleware({ onCost: (r) => { knownRecords.push(r); } });
+        const unknownMw = createCostTrackingMiddleware({ onCost: (r) => { unknownRecords.push(r); } });
+        await knownMw(makeRequest('claude-opus-4-6'), async () => makeResponse(100, 50, 'claude-opus-4-6'));
+        await unknownMw(makeRequest('unknown-llm-xyz'), async () => makeResponse(100, 50, 'unknown-llm-xyz'));
+        expect(knownRecords[0].costUsd).toBeGreaterThan(0);
+        expect(unknownRecords[0].costUsd).toBe(0);
+    });
+    it('AC3: error in onCost does NOT propagate', async () => {
+        const mw = createCostTrackingMiddleware({
+            onCost: () => { throw new Error('cost callback failed'); },
+        });
+        // Should not throw despite onCost throwing
+        const response = await mw(makeRequest(), async () => makeResponse());
+        expect(response.content).toBe('test response');
+    });
+    it('AC3: response is returned unchanged after onCost', async () => {
+        const mw = createCostTrackingMiddleware({ onCost: vi.fn() });
+        const expectedResponse = makeResponse(200, 100);
+        const result = await mw(makeRequest(), async () => expectedResponse);
+        expect(result).toBe(expectedResponse);
+    });
+    it('AC3: middleware is a no-op (no crash) when onCost is undefined', async () => {
+        const mw = createCostTrackingMiddleware();
+        const response = makeResponse();
+        const result = await mw(makeRequest(), async () => response);
+        expect(result).toBe(response);
+    });
+});
+//# sourceMappingURL=cost-tracking.test.js.map

package/dist/llm/middleware/__tests__/cost-tracking.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-tracking.test.js","sourceRoot":"","sources":["../../../../src/llm/middleware/__tests__/cost-tracking.test.ts"],"names":[],"mappings":"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"}

package/dist/llm/middleware/__tests__/logging.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=logging.test.d.ts.map

package/dist/llm/middleware/__tests__/logging.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.test.d.ts","sourceRoot":"","sources":["../../../../src/llm/middleware/__tests__/logging.test.ts"],"names":[],"mappings":""}

package/dist/llm/middleware/__tests__/logging.test.js

@@ -0,0 +1,127 @@
+// packages/factory/src/llm/middleware/__tests__/logging.test.ts
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { readFile, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { createLoggingMiddleware } from '../logging.js';
+// ---------------------------------------------------------------------------
+// Test helpers
+// ---------------------------------------------------------------------------
+function makeRequest(model = 'claude-opus-4-6') {
+    return {
+        model,
+        messages: [{ role: 'user', content: [{ kind: 'text', text: 'hello' }] }],
+    };
+}
+function makeResponse(inputTokens = 100, outputTokens = 50, model = 'claude-opus-4-6') {
+    return {
+        content: 'test response',
+        toolCalls: [],
+        usage: { inputTokens, outputTokens, totalTokens: inputTokens + outputTokens },
+        model,
+        stopReason: 'stop',
+        providerMetadata: {},
+    };
+}
+function makeError(message, statusCode) {
+    const err = new Error(message);
+    if (statusCode !== undefined)
+        err.statusCode = statusCode;
+    return err;
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('createLoggingMiddleware', () => {
+    let logsRoot;
+    let logFile;
+    beforeEach(async () => {
+        logsRoot = join(tmpdir(), `logging-mw-test-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+        logFile = join(logsRoot, 'llm-calls.ndjson');
+        // Do NOT pre-create the directory — the middleware must handle it
+    });
+    afterEach(async () => {
+        await rm(logsRoot, { recursive: true, force: true });
+    });
+    it('AC1: success path writes correct NDJSON fields', async () => {
+        const mw = createLoggingMiddleware({ logsRoot });
+        const request = makeRequest('claude-opus-4-6');
+        const response = makeResponse(100, 50, 'claude-opus-4-6');
+        await mw(request, async () => response);
+        const content = await readFile(logFile, 'utf8');
+        const lines = content.trim().split('\n');
+        expect(lines).toHaveLength(1);
+        const record = JSON.parse(lines[0]);
+        expect(record.timestamp).toMatch(/^\d{4}-\d{2}-\d{2}T/);
+        expect(record.model).toBe('claude-opus-4-6');
+        expect(record.inputTokens).toBe(100);
+        expect(record.outputTokens).toBe(50);
+        expect(typeof record.cost_usd).toBe('number');
+        expect(typeof record.durationMs).toBe('number');
+        expect(record.status).toBe('success');
+    });
+    it('AC2: error path writes status: error and errorMessage, then re-throws', async () => {
+        const mw = createLoggingMiddleware({ logsRoot });
+        const request = makeRequest('claude-opus-4-6');
+        const err = makeError('test error');
+        await expect(mw(request, async () => {
+            throw err;
+        })).rejects.toThrow('test error');
+        const content = await readFile(logFile, 'utf8');
+        const lines = content.trim().split('\n');
+        expect(lines).toHaveLength(1);
+        const record = JSON.parse(lines[0]);
+        expect(record.status).toBe('error');
+        expect(record.errorMessage).toBe('test error');
+        expect(typeof record.durationMs).toBe('number');
+    });
+    it('AC1+2: durationMs is a positive number in both success and error paths', async () => {
+        const mw = createLoggingMiddleware({ logsRoot });
+        const request = makeRequest();
+        // Success
+        await mw(request, async () => makeResponse());
+        // Error
+        await expect(mw(request, async () => {
+            throw new Error('boom');
+        })).rejects.toThrow();
+        const content = await readFile(logFile, 'utf8');
+        const lines = content.trim().split('\n');
+        for (const line of lines) {
+            const record = JSON.parse(line);
+            expect(record.durationMs).toBeGreaterThanOrEqual(0);
+            expect(typeof record.durationMs).toBe('number');
+        }
+    });
+    it('creates the log file if it does not exist (directory auto-created)', async () => {
+        const mw = createLoggingMiddleware({ logsRoot });
+        const request = makeRequest();
+        await mw(request, async () => makeResponse());
+        const content = await readFile(logFile, 'utf8');
+        expect(content.length).toBeGreaterThan(0);
+    });
+    it('multiple calls append lines (N calls = N lines)', async () => {
+        const mw = createLoggingMiddleware({ logsRoot });
+        const request = makeRequest();
+        for (let i = 0; i < 3; i++) {
+            await mw(request, async () => makeResponse());
+        }
+        const content = await readFile(logFile, 'utf8');
+        const lines = content.trim().split('\n').filter(Boolean);
+        expect(lines).toHaveLength(3);
+    });
+    it('cost_usd is 0 for an unknown model and positive for claude-opus-4-6', async () => {
+        const mw = createLoggingMiddleware({ logsRoot });
+        // Unknown model
+        await mw(makeRequest('unknown-model-xyz'), async () => makeResponse(100, 50, 'unknown-model-xyz'));
+        // Known model
+        await mw(makeRequest('claude-opus-4-6'), async () => makeResponse(100, 50, 'claude-opus-4-6'));
+        const content = await readFile(logFile, 'utf8');
+        const lines = content.trim().split('\n').filter(Boolean);
+        expect(lines).toHaveLength(2);
+        const unknown = JSON.parse(lines[0]);
+        const known = JSON.parse(lines[1]);
+        expect(unknown.cost_usd).toBe(0);
+        expect(known.cost_usd).toBeGreaterThan(0);
+    });
+});
+//# sourceMappingURL=logging.test.js.map