@amodalai/runtime 0.1.25 → 0.2.0

package/dist/src/logger.test.js

@@ -0,0 +1,198 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { log, createLogger, setLogLevel, setLogFormat, setSanitize, LogLevel, } from './logger.js';
+describe('Logger', () => {
+    let stderrWrite;
+    let originalWrite;
+    beforeEach(() => {
+        originalWrite = process.stderr.write;
+        stderrWrite = vi.fn().mockReturnValue(true);
+        process.stderr.write = stderrWrite;
+        setLogLevel(LogLevel.TRACE);
+        setLogFormat('text');
+        setSanitize((data) => data);
+    });
+    afterEach(() => {
+        process.stderr.write = originalWrite;
+        setLogLevel(LogLevel.INFO);
+        setLogFormat('text');
+    });
+    describe('backward compatibility', () => {
+        it('accepts (message, tag) string arguments', () => {
+            log.info('Server started', 'server');
+            expect(stderrWrite).toHaveBeenCalledWith('[INFO] [server] Server started\n');
+        });
+        it('works with message only', () => {
+            log.error('Something broke');
+            expect(stderrWrite).toHaveBeenCalledWith('[ERROR] Something broke\n');
+        });
+    });
+    describe('structured data', () => {
+        it('includes data fields in text mode', () => {
+            log.info('request_completed', { method: 'GET', status: 200 });
+            const output = stderrWrite.mock.calls[0]?.[0];
+            expect(output).toContain('[INFO] request_completed');
+            expect(output).toContain('"method":"GET"');
+            expect(output).toContain('"status":200');
+        });
+        it('includes tag and data fields together', () => {
+            log.info('event', { tag: 'mytag', extra: 'val' });
+            const output = stderrWrite.mock.calls[0]?.[0];
+            expect(output).toContain('[mytag]');
+            expect(output).toContain('"extra":"val"');
+        });
+    });
+    describe('log levels', () => {
+        it('respects log level filtering', () => {
+            setLogLevel(LogLevel.WARN);
+            log.debug('should not appear');
+            log.info('should not appear');
+            log.warn('should appear');
+            expect(stderrWrite).toHaveBeenCalledTimes(1);
+            expect(stderrWrite).toHaveBeenCalledWith('[WARN] should appear\n');
+        });
+        it('NONE suppresses all output', () => {
+            setLogLevel(LogLevel.NONE);
+            log.fatal('should not appear');
+            expect(stderrWrite).not.toHaveBeenCalled();
+        });
+    });
+    describe('child()', () => {
+        it('creates a scoped logger with inherited bindings', () => {
+            const sessionLog = log.child({ session: 'sess-123', tenant: 'acme' });
+            sessionLog.info('message_received');
+            const output = stderrWrite.mock.calls[0]?.[0];
+            expect(output).toContain('message_received');
+            expect(output).toContain('"session":"sess-123"');
+            expect(output).toContain('"tenant":"acme"');
+        });
+        it('merges child data with call-site data', () => {
+            const sessionLog = log.child({ session: 'sess-123' });
+            sessionLog.info('tool_call', { tool: 'search', duration: 42 });
+            const output = stderrWrite.mock.calls[0]?.[0];
+            expect(output).toContain('"session":"sess-123"');
+            expect(output).toContain('"tool":"search"');
+            expect(output).toContain('"duration":42');
+        });
+        it('call-site data overrides child bindings', () => {
+            const sessionLog = log.child({ status: 'pending' });
+            sessionLog.info('updated', { status: 'done' });
+            const output = stderrWrite.mock.calls[0]?.[0];
+            expect(output).toContain('"status":"done"');
+            expect(output).not.toContain('"status":"pending"');
+        });
+        it('supports nested children', () => {
+            const sessionLog = log.child({ session: 'sess-1' });
+            const toolLog = sessionLog.child({ tool: 'search' });
+            toolLog.info('executing');
+            const output = stderrWrite.mock.calls[0]?.[0];
+            expect(output).toContain('"session":"sess-1"');
+            expect(output).toContain('"tool":"search"');
+        });
+        it('accepts traceId for distributed tracing', () => {
+            const sessionLog = log.child({ session: 'sess-1', traceId: 'abc-def-123' });
+            sessionLog.info('traced_event');
+            const output = stderrWrite.mock.calls[0]?.[0];
+            expect(output).toContain('"traceId":"abc-def-123"');
+        });
+    });
+    describe('JSON format', () => {
+        it('outputs valid JSON lines', () => {
+            setLogFormat('json');
+            log.info('server_started', { port: 3000 });
+            const output = stderrWrite.mock.calls[0]?.[0];
+            const parsed = JSON.parse(output);
+            expect(parsed['level']).toBe('info');
+            expect(parsed['event']).toBe('server_started');
+            expect(parsed['port']).toBe(3000);
+            expect(parsed['ts']).toBeDefined();
+        });
+        it('includes timestamp as ISO string', () => {
+            setLogFormat('json');
+            log.info('test');
+            const output = stderrWrite.mock.calls[0]?.[0];
+            const parsed = JSON.parse(output);
+            expect(() => new Date(parsed['ts'])).not.toThrow();
+        });
+        it('includes child bindings in JSON output', () => {
+            setLogFormat('json');
+            const sessionLog = log.child({ session: 'sess-42', tenant: 'acme' });
+            sessionLog.warn('rate_limited', { provider: 'anthropic' });
+            const output = stderrWrite.mock.calls[0]?.[0];
+            const parsed = JSON.parse(output);
+            expect(parsed['level']).toBe('warn');
+            expect(parsed['session']).toBe('sess-42');
+            expect(parsed['tenant']).toBe('acme');
+            expect(parsed['provider']).toBe('anthropic');
+        });
+        it('handles backward-compat tag in JSON', () => {
+            setLogFormat('json');
+            log.info('event', 'mytag');
+            const output = stderrWrite.mock.calls[0]?.[0];
+            const parsed = JSON.parse(output);
+            expect(parsed['tag']).toBe('mytag');
+            expect(parsed['event']).toBe('event');
+        });
+    });
+    describe('sanitize hook', () => {
+        it('sanitizes data before output', () => {
+            setSanitize((data) => {
+                const sanitized = { ...data };
+                if ('apiKey' in sanitized) {
+                    sanitized['apiKey'] = '***';
+                }
+                return sanitized;
+            });
+            log.info('provider_init', { provider: 'anthropic', apiKey: 'sk-secret-123' });
+            const output = stderrWrite.mock.calls[0]?.[0];
+            expect(output).toContain('"apiKey":"***"');
+            expect(output).not.toContain('sk-secret-123');
+        });
+        it('sanitizes child bindings too', () => {
+            setSanitize((data) => {
+                const sanitized = { ...data };
+                if (typeof sanitized['email'] === 'string') {
+                    sanitized['email'] = 'user_***@***.com';
+                }
+                return sanitized;
+            });
+            const userLog = log.child({ email: 'bob@example.com' });
+            userLog.info('user_action');
+            const output = stderrWrite.mock.calls[0]?.[0];
+            expect(output).toContain('user_***@***.com');
+            expect(output).not.toContain('bob@example.com');
+        });
+    });
+    describe('createLogger', () => {
+        it('creates an independent logger with bindings', () => {
+            const logger = createLogger({ service: 'scheduler' });
+            logger.info('tick');
+            const output = stderrWrite.mock.calls[0]?.[0];
+            expect(output).toContain('"service":"scheduler"');
+        });
+    });
+    describe('circular reference safety', () => {
+        it('does not throw on circular data in text mode', () => {
+            const circular = { a: 1 };
+            circular['self'] = circular;
+            expect(() => log.info('circular_test', circular)).not.toThrow();
+            expect(stderrWrite).toHaveBeenCalledTimes(1);
+            const output = stderrWrite.mock.calls[0]?.[0];
+            expect(output).toContain('_serializeError');
+        });
+        it('does not throw on circular data in JSON mode', () => {
+            setLogFormat('json');
+            const circular = { b: 2 };
+            circular['self'] = circular;
+            expect(() => log.warn('circular_json', circular)).not.toThrow();
+            expect(stderrWrite).toHaveBeenCalledTimes(1);
+            const output = stderrWrite.mock.calls[0]?.[0];
+            expect(output).toContain('_serializeError');
+        });
+    });
+});
+//# sourceMappingURL=logger.test.js.map

package/dist/src/logger.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.test.js","sourceRoot":"","sources":["../../src/logger.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EACL,GAAG,EACH,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,WAAW,EACX,QAAQ,GACT,MAAM,aAAa,CAAC;AAGrB,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;IACtB,IAAI,WAAqC,CAAC;IAC1C,IAAI,aAA0C,CAAC;IAE/C,UAAU,CAAC,GAAG,EAAE;QACd,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QACrC,WAAW,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC5C,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,WAAqD,CAAC;QAC7E,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC5B,YAAY,CAAC,MAAM,CAAC,CAAC;QACrB,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,aAAa,CAAC;QACrC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC3B,YAAY,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;QACtC,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;YACjD,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;YACrC,MAAM,CAAC,WAAW,CAAC,CAAC,oBAAoB,CAAC,kCAAkC,CAAC,CAAC;QAC/E,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;YACjC,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;YAC7B,MAAM,CAAC,WAAW,CAAC,CAAC,oBAAoB,CAAC,2BAA2B,CAAC,CAAC;QACxE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;QAC/B,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;YAC3C,GAAG,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YAC9D,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAW,CAAC;YACxD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,0BAA0B,CAAC,CAAC;YACrD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;YAC3C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;YAC/C,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YAClD,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAW,CAAC;YACxD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YACpC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC1B,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;YACtC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC3B,GAAG,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;YAC/B,GAAG,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;YAC9B,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAC1B,MAAM,CAAC,WAAW,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;YAC7C,MAAM,CAAC,WAAW,CAAC,CAAC,oBAAoB,CAAC,wBAAwB,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;YACpC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC3B,GAAG,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;YAC/B,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;QACvB,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;YACzD,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YACtE,UAAU,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YACpC,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAW,CAAC;YACxD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;YAC7C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,sBAAsB,CAAC,CAAC;YACjD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;YAC/C,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;YACtD,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;YAC/D,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAW,CAAC;YACxD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,sBAAsB,CAAC,CAAC;YACjD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;YAC5C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;YACjD,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;YACpD,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAW,CAAC;YACxD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;YAC5C,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;YAClC,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;YACpD,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;YACrD,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC1B,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAW,CAAC;YACxD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;YAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;YACjD,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;YAC5E,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAChC,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAW,CAAC;YACxD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;QAC3B,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;YAClC,YAAY,CAAC,MAAM,CAAC,CAAC;YACrB,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3C,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAW,CAAC;YACxD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAA4B,CAAC;YAC7D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YAC/C,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QACrC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;YAC1C,YAAY,CAAC,MAAM,CAAC,CAAC;YACrB,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACjB,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAW,CAAC;YACxD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAA4B,CAAC;YAC7D,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAW,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAC/D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;YAChD,YAAY,CAAC,MAAM,CAAC,CAAC;YACrB,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YACrE,UAAU,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;YAC3D,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAW,CAAC;YACxD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAA4B,CAAC;YAC7D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC1C,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACtC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;YAC7C,YAAY,CAAC,MAAM,CAAC,CAAC;YACrB,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC3B,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAW,CAAC;YACxD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAA4B,CAAC;YAC7D,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;QAC7B,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;YACtC,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE;gBACnB,MAAM,SAAS,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;gBAC9B,IAAI,QAAQ,IAAI,SAAS,EAAE,CAAC;oBAC1B,SAAS,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;gBAC9B,CAAC;gBACD,OAAO,SAAS,CAAC;YACnB,CAAC,CAAC,CAAC;YACH,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;YAC9E,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAW,CAAC;YACxD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;YAC3C,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;YACtC,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE;gBACnB,MAAM,SAAS,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;gBAC9B,IAAI,OAAO,SAAS,CAAC,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;oBAC3C,SAAS,CAAC,OAAO,CAAC,GAAG,kBAAkB,CAAC;gBAC1C,CAAC;gBACD,OAAO,SAAS,CAAC;YACnB,CAAC,CAAC,CAAC;YACH,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC,CAAC;YACxD,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAC5B,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAW,CAAC;YACxD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;YAC7C,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;QAC5B,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;YACrD,MAAM,MAAM,GAAW,YAAY,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;YAC9D,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACpB,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAW,CAAC;YACxD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACzC,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;YACtD,MAAM,QAAQ,GAA4B,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;YACnD,QAAQ,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC;YAC5B,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YAChE,MAAM,CAAC,WAAW,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;YAC7C,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAW,CAAC;YACxD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;YACtD,YAAY,CAAC,MAAM,CAAC,CAAC;YACrB,MAAM,QAAQ,GAA4B,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;YACnD,QAAQ,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC;YAC5B,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YAChE,MAAM,CAAC,WAAW,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;YAC7C,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAW,CAAC;YACxD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/providers/create-provider.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { LLMProvider, ProviderConfig } from './types.js';
+/**
+ * Create an LLMProvider from a ProviderConfig.
+ *
+ * @example
+ * ```ts
+ * const provider = createProvider({
+ *   provider: 'anthropic',
+ *   model: 'claude-sonnet-4-20250514',
+ *   apiKey: process.env.ANTHROPIC_API_KEY,
+ * });
+ *
+ * const result = provider.streamText({
+ *   messages: [{role: 'user', content: [{type: 'text', text: 'Hello'}]}],
+ * });
+ * ```
+ */
+export declare function createProvider(config: ProviderConfig): LLMProvider;

package/dist/src/providers/create-provider.js

@@ -0,0 +1,185 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { streamText, generateText } from 'ai';
+import { createAnthropic } from '@ai-sdk/anthropic';
+import { createOpenAI } from '@ai-sdk/openai';
+import { createGoogleGenerativeAI } from '@ai-sdk/google';
+import { ConfigError } from '../errors.js';
+/** Default timeout for LLM calls when no AbortSignal is provided (2 minutes). */
+const DEFAULT_LLM_TIMEOUT_MS = 120_000;
+// ---------------------------------------------------------------------------
+// OpenAI-compatible provider base URLs
+// ---------------------------------------------------------------------------
+const OPENAI_COMPATIBLE_BASE_URLS = {
+    deepseek: 'https://api.deepseek.com/v1',
+    groq: 'https://api.groq.com/openai/v1',
+    mistral: 'https://api.mistral.ai/v1',
+    xai: 'https://api.x.ai/v1',
+    fireworks: 'https://api.fireworks.ai/inference/v1',
+    together: 'https://api.together.xyz/v1',
+};
+// ---------------------------------------------------------------------------
+// createLanguageModel — resolve config to an AI SDK LanguageModel
+// ---------------------------------------------------------------------------
+function createLanguageModel(config) {
+    const { provider, model, apiKey, baseUrl } = config;
+    switch (provider) {
+        case 'anthropic': {
+            const anthropic = createAnthropic({
+                apiKey,
+                ...(baseUrl ? { baseURL: baseUrl } : {}),
+            });
+            return anthropic(model);
+        }
+        case 'openai': {
+            const openai = createOpenAI({
+                apiKey,
+                ...(baseUrl ? { baseURL: baseUrl } : {}),
+            });
+            return openai(model);
+        }
+        case 'google': {
+            const google = createGoogleGenerativeAI({
+                apiKey,
+                ...(baseUrl ? { baseURL: baseUrl } : {}),
+            });
+            return google(model);
+        }
+        default: {
+            // OpenAI-compatible providers (DeepSeek, Groq, Mistral, xAI, etc.)
+            const compatBaseUrl = baseUrl ?? OPENAI_COMPATIBLE_BASE_URLS[provider];
+            if (!compatBaseUrl) {
+                throw new ConfigError(`Unknown provider "${provider}". Use a known provider (anthropic, openai, google) or set a baseUrl for OpenAI-compatible providers.`, {
+                    key: 'providers',
+                    context: { provider, model },
+                });
+            }
+            const openai = createOpenAI({
+                apiKey,
+                baseURL: compatBaseUrl,
+            });
+            return openai(model);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// normalizeUsage — map AI SDK LanguageModelUsage to our TokenUsage
+// ---------------------------------------------------------------------------
+function normalizeUsage(usage) {
+    return {
+        inputTokens: usage?.inputTokens ?? 0,
+        outputTokens: usage?.outputTokens ?? 0,
+        cachedInputTokens: usage?.inputTokenDetails?.cacheReadTokens ?? undefined,
+        cacheCreationInputTokens: usage?.inputTokenDetails?.cacheWriteTokens ?? undefined,
+        totalTokens: usage?.totalTokens ?? (usage?.inputTokens ?? 0) + (usage?.outputTokens ?? 0),
+    };
+}
+// ---------------------------------------------------------------------------
+// createProvider — public factory
+// ---------------------------------------------------------------------------
+/**
+ * Create an LLMProvider from a ProviderConfig.
+ *
+ * @example
+ * ```ts
+ * const provider = createProvider({
+ *   provider: 'anthropic',
+ *   model: 'claude-sonnet-4-20250514',
+ *   apiKey: process.env.ANTHROPIC_API_KEY,
+ * });
+ *
+ * const result = provider.streamText({
+ *   messages: [{role: 'user', content: [{type: 'text', text: 'Hello'}]}],
+ * });
+ * ```
+ */
+export function createProvider(config) {
+    const languageModel = createLanguageModel(config);
+    return {
+        model: config.model,
+        provider: config.provider,
+        languageModel,
+        streamText(opts) {
+            const sdkResult = streamText({
+                model: languageModel,
+                messages: opts.messages,
+                system: opts.system,
+                tools: opts.tools,
+                toolChoice: opts.toolChoice,
+                maxOutputTokens: opts.maxOutputTokens,
+                temperature: opts.temperature,
+                abortSignal: opts.abortSignal ?? AbortSignal.timeout(DEFAULT_LLM_TIMEOUT_MS),
+            });
+            const usagePromise = sdkResult.usage.then((u) => normalizeUsage(u));
+            const textPromise = sdkResult.text;
+            return {
+                textStream: sdkResult.textStream,
+                fullStream: (async function* () {
+                    for await (const chunk of sdkResult.fullStream) {
+                        // eslint-disable-next-line @typescript-eslint/switch-exhaustiveness-check -- intentionally ignoring SDK-internal chunk types (reasoning, source, raw, etc.)
+                        switch (chunk.type) {
+                            case 'text-delta':
+                                yield { type: 'text-delta', textDelta: chunk.text };
+                                break;
+                            case 'tool-call':
+                                yield {
+                                    type: 'tool-call',
+                                    toolCallId: chunk.toolCallId,
+                                    toolName: chunk.toolName,
+                                    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- AI SDK boundary: input is tool params from provider
+                                    args: (chunk.input ?? {}),
+                                };
+                                break;
+                            case 'tool-result':
+                                yield {
+                                    type: 'tool-result',
+                                    toolCallId: chunk.toolCallId,
+                                    toolName: chunk.toolName,
+                                    result: chunk.output,
+                                };
+                                break;
+                            case 'finish':
+                                yield { type: 'finish', usage: normalizeUsage(chunk.totalUsage) };
+                                break;
+                            case 'error':
+                                yield { type: 'error', error: chunk.error };
+                                break;
+                            default:
+                                // Ignore other chunk types (step-start, step-finish, reasoning, source, etc.)
+                                break;
+                        }
+                    }
+                })(),
+                usage: usagePromise,
+                text: textPromise,
+            };
+        },
+        async generateText(opts) {
+            const result = await generateText({
+                model: languageModel,
+                messages: opts.messages,
+                system: opts.system,
+                tools: opts.tools,
+                toolChoice: opts.toolChoice,
+                maxOutputTokens: opts.maxOutputTokens,
+                temperature: opts.temperature,
+                abortSignal: opts.abortSignal ?? AbortSignal.timeout(DEFAULT_LLM_TIMEOUT_MS),
+            });
+            return {
+                text: result.text,
+                toolCalls: result.toolCalls.map((tc) => ({
+                    toolCallId: tc.toolCallId,
+                    toolName: tc.toolName,
+                    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- AI SDK boundary: input is tool params from provider
+                    args: (tc.input ?? {}),
+                })),
+                usage: normalizeUsage(result.usage),
+                finishReason: result.finishReason,
+            };
+        },
+    };
+}
+//# sourceMappingURL=create-provider.js.map

package/dist/src/providers/create-provider.js.map

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

package/dist/src/providers/create-provider.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export {};

package/dist/src/providers/create-provider.test.js

@@ -0,0 +1,95 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { describe, it, expect } from 'vitest';
+import { createProvider } from './create-provider.js';
+import { ConfigError } from '../errors.js';
+describe('createProvider', () => {
+    it('creates an Anthropic provider', () => {
+        const provider = createProvider({
+            provider: 'anthropic',
+            model: 'claude-sonnet-4-20250514',
+            apiKey: 'test-key',
+        });
+        expect(provider.provider).toBe('anthropic');
+        expect(provider.model).toBe('claude-sonnet-4-20250514');
+        expect(provider.languageModel).toBeDefined();
+        expect(typeof provider.streamText).toBe('function');
+        expect(typeof provider.generateText).toBe('function');
+    });
+    it('creates an OpenAI provider', () => {
+        const provider = createProvider({
+            provider: 'openai',
+            model: 'gpt-4o',
+            apiKey: 'test-key',
+        });
+        expect(provider.provider).toBe('openai');
+        expect(provider.model).toBe('gpt-4o');
+        expect(provider.languageModel).toBeDefined();
+    });
+    it('creates a Google provider', () => {
+        const provider = createProvider({
+            provider: 'google',
+            model: 'gemini-2.5-flash',
+            apiKey: 'test-key',
+        });
+        expect(provider.provider).toBe('google');
+        expect(provider.model).toBe('gemini-2.5-flash');
+        expect(provider.languageModel).toBeDefined();
+    });
+    it('creates an OpenAI-compatible provider for known providers', () => {
+        const providers = [
+            { provider: 'deepseek', model: 'deepseek-chat', apiKey: 'test-key' },
+            { provider: 'groq', model: 'llama-3.1-70b', apiKey: 'test-key' },
+            { provider: 'mistral', model: 'mistral-large', apiKey: 'test-key' },
+            { provider: 'xai', model: 'grok-3', apiKey: 'test-key' },
+        ];
+        for (const config of providers) {
+            const provider = createProvider(config);
+            expect(provider.provider).toBe(config.provider);
+            expect(provider.model).toBe(config.model);
+            expect(provider.languageModel).toBeDefined();
+        }
+    });
+    it('creates a custom OpenAI-compatible provider with baseUrl', () => {
+        const provider = createProvider({
+            provider: 'custom-llm',
+            model: 'my-model',
+            apiKey: 'test-key',
+            baseUrl: 'https://my-llm.example.com/v1',
+        });
+        expect(provider.provider).toBe('custom-llm');
+        expect(provider.model).toBe('my-model');
+        expect(provider.languageModel).toBeDefined();
+    });
+    it('throws ConfigError for unknown provider without baseUrl', () => {
+        expect(() => createProvider({
+            provider: 'unknown-provider',
+            model: 'some-model',
+            apiKey: 'test-key',
+        })).toThrow(ConfigError);
+    });
+    it('supports baseUrl override for known providers', () => {
+        const provider = createProvider({
+            provider: 'anthropic',
+            model: 'claude-sonnet-4-20250514',
+            apiKey: 'test-key',
+            baseUrl: 'https://proxy.example.com/anthropic',
+        });
+        expect(provider.provider).toBe('anthropic');
+        expect(provider.languageModel).toBeDefined();
+    });
+    it('satisfies LLMProvider interface', () => {
+        const provider = createProvider({
+            provider: 'anthropic',
+            model: 'claude-sonnet-4-20250514',
+            apiKey: 'test-key',
+        });
+        // Type-level check: assignable to LLMProvider
+        const _check = provider;
+        expect(_check).toBeDefined();
+    });
+});
+//# sourceMappingURL=create-provider.test.js.map

package/dist/src/providers/create-provider.test.js.map

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

package/dist/src/providers/failover.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Provider failover chain.
+ *
+ * Tries each provider in sequence. On failure, logs the error and moves
+ * to the next provider. No retries or backoff within a single provider —
+ * the chain itself IS the retry strategy. If you want retries on the
+ * primary, put the same provider config twice in the chain.
+ *
+ * All providers exhausted → throws ProviderError with context about
+ * every attempt.
+ */
+import type { Logger } from '@amodalai/core';
+import type { LLMProvider, ProviderConfig } from './types.js';
+export interface FailoverChainConfig {
+    /** Primary provider (always first in the chain) */
+    primary: ProviderConfig;
+    /** Fallback providers, tried in order after primary fails */
+    fallbacks?: ProviderConfig[];
+    /** Logger for structured events */
+    logger: Logger;
+    /** Session ID for log context */
+    sessionId?: string;
+}
+/**
+ * Create an LLMProvider that tries a chain of providers in order.
+ *
+ * For generateText: tries each provider sequentially until one succeeds.
+ * For streamText: wraps the fullStream so that if a provider's stream
+ * fails before yielding any events, the next provider is tried. Once
+ * events have been yielded, mid-stream errors propagate (can't restart
+ * a partial stream).
+ */
+export declare function createFailoverProvider(config: FailoverChainConfig): LLMProvider;