@amodalai/runtime 0.1.25 → 0.1.26

package/dist/src/errors.d.ts

@@ -0,0 +1,145 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * A discriminated result type for operations that can fail.
+ * Forces callers to handle both success and error cases.
+ */
+export type Result<T, E = Error> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: E;
+};
+/**
+ * Base error class for all Amodal runtime errors.
+ *
+ * Every error carries:
+ * - `code` — a unique, stable string for programmatic matching
+ * - `context` — structured data about what was happening when the error occurred
+ * - `cause` — the underlying error (standard Error.cause)
+ */
+export declare class AmodalError extends Error {
+    readonly code: string;
+    readonly context: Record<string, unknown>;
+    constructor(code: string, message: string, context?: Record<string, unknown>, cause?: unknown);
+    /**
+     * Serialize to a structured object suitable for logging or JSON responses.
+     */
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Error from an LLM provider call (Anthropic, OpenAI, Google, etc.).
+ */
+export declare class ProviderError extends AmodalError {
+    readonly provider: string;
+    readonly statusCode?: number;
+    readonly retryable: boolean;
+    constructor(message: string, options: {
+        provider: string;
+        statusCode?: number;
+        retryable?: boolean;
+        cause?: unknown;
+        context?: Record<string, unknown>;
+    });
+}
+/**
+ * Thrown on 429 rate limit responses.
+ */
+export declare class RateLimitError extends ProviderError {
+    readonly retryAfterMs?: number;
+    constructor(message: string, options: {
+        provider: string;
+        retryAfterMs?: number;
+        cause?: unknown;
+    });
+}
+/**
+ * Thrown when a provider request times out.
+ */
+export declare class ProviderTimeoutError extends ProviderError {
+    constructor(message: string, options: {
+        provider: string;
+        cause?: unknown;
+    });
+}
+/**
+ * Error during tool execution (custom tools, store tools, request tool, etc.).
+ */
+export declare class ToolExecutionError extends AmodalError {
+    readonly toolName: string;
+    readonly callId: string;
+    constructor(message: string, options: {
+        toolName: string;
+        callId: string;
+        cause?: unknown;
+        context?: Record<string, unknown>;
+    });
+}
+/**
+ * Error from a store backend operation (PGLite, Postgres, etc.).
+ */
+export declare class StoreError extends AmodalError {
+    readonly store: string;
+    readonly operation: string;
+    constructor(message: string, options: {
+        store: string;
+        operation: string;
+        cause?: unknown;
+        context?: Record<string, unknown>;
+    });
+}
+/**
+ * Error from a connection request (REST API calls, MCP, etc.).
+ */
+export declare class ConnectionError extends AmodalError {
+    readonly connection: string;
+    readonly action: string;
+    constructor(message: string, options: {
+        connection: string;
+        action: string;
+        cause?: unknown;
+        context?: Record<string, unknown>;
+    });
+}
+/**
+ * Error in session lifecycle (creation, destroy, state transitions).
+ */
+export declare class SessionError extends AmodalError {
+    readonly sessionId: string;
+    constructor(message: string, options: {
+        sessionId: string;
+        cause?: unknown;
+        context?: Record<string, unknown>;
+    });
+}
+/**
+ * Error during context compaction (summarization, truncation).
+ */
+export declare class CompactionError extends AmodalError {
+    readonly stage: string;
+    constructor(message: string, options: {
+        stage: string;
+        cause?: unknown;
+        context?: Record<string, unknown>;
+    });
+}
+/**
+ * Error in configuration loading or validation.
+ * Includes a `suggestion` field with actionable fix instructions.
+ */
+export declare class ConfigError extends AmodalError {
+    readonly key: string;
+    readonly suggestion: string;
+    constructor(message: string, options: {
+        key: string;
+        suggestion?: string;
+        cause?: unknown;
+        context?: Record<string, unknown>;
+    });
+    /** Format as a multi-line error message for CLI output. */
+    format(): string;
+}

package/dist/src/errors.js

@@ -0,0 +1,218 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+// ---------------------------------------------------------------------------
+// Base error
+// ---------------------------------------------------------------------------
+/**
+ * Base error class for all Amodal runtime errors.
+ *
+ * Every error carries:
+ * - `code` — a unique, stable string for programmatic matching
+ * - `context` — structured data about what was happening when the error occurred
+ * - `cause` — the underlying error (standard Error.cause)
+ */
+export class AmodalError extends Error {
+    code;
+    context;
+    constructor(code, message, context = {}, cause) {
+        super(message, { cause });
+        this.name = 'AmodalError';
+        this.code = code;
+        this.context = context;
+    }
+    /**
+     * Serialize to a structured object suitable for logging or JSON responses.
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            message: this.message,
+            context: this.context,
+            ...(this.cause instanceof Error
+                ? { cause: { name: this.cause.name, message: this.cause.message } }
+                : this.cause !== undefined
+                    ? { cause: String(this.cause) }
+                    : {}),
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// Provider errors
+// ---------------------------------------------------------------------------
+/**
+ * Error from an LLM provider call (Anthropic, OpenAI, Google, etc.).
+ */
+export class ProviderError extends AmodalError {
+    provider;
+    statusCode;
+    retryable;
+    constructor(message, options) {
+        super('PROVIDER_ERROR', message, {
+            provider: options.provider,
+            statusCode: options.statusCode,
+            ...options.context,
+        }, options.cause);
+        this.name = 'ProviderError';
+        this.provider = options.provider;
+        this.statusCode = options.statusCode;
+        this.retryable = options.retryable ?? false;
+    }
+}
+/**
+ * Thrown on 429 rate limit responses.
+ */
+export class RateLimitError extends ProviderError {
+    retryAfterMs;
+    constructor(message, options) {
+        super(message, {
+            provider: options.provider,
+            statusCode: 429,
+            retryable: true,
+            cause: options.cause,
+            context: { retryAfterMs: options.retryAfterMs },
+        });
+        this.name = 'RateLimitError';
+        this.retryAfterMs = options.retryAfterMs;
+    }
+}
+/**
+ * Thrown when a provider request times out.
+ */
+export class ProviderTimeoutError extends ProviderError {
+    constructor(message, options) {
+        super(message, {
+            provider: options.provider,
+            retryable: true,
+            cause: options.cause,
+        });
+        this.name = 'ProviderTimeoutError';
+    }
+}
+// ---------------------------------------------------------------------------
+// Tool errors
+// ---------------------------------------------------------------------------
+/**
+ * Error during tool execution (custom tools, store tools, request tool, etc.).
+ */
+export class ToolExecutionError extends AmodalError {
+    toolName;
+    callId;
+    constructor(message, options) {
+        super('TOOL_EXECUTION_ERROR', message, {
+            toolName: options.toolName,
+            callId: options.callId,
+            ...options.context,
+        }, options.cause);
+        this.name = 'ToolExecutionError';
+        this.toolName = options.toolName;
+        this.callId = options.callId;
+    }
+}
+// ---------------------------------------------------------------------------
+// Store errors
+// ---------------------------------------------------------------------------
+/**
+ * Error from a store backend operation (PGLite, Postgres, etc.).
+ */
+export class StoreError extends AmodalError {
+    store;
+    operation;
+    constructor(message, options) {
+        super('STORE_ERROR', message, {
+            store: options.store,
+            operation: options.operation,
+            ...options.context,
+        }, options.cause);
+        this.name = 'StoreError';
+        this.store = options.store;
+        this.operation = options.operation;
+    }
+}
+// ---------------------------------------------------------------------------
+// Connection errors
+// ---------------------------------------------------------------------------
+/**
+ * Error from a connection request (REST API calls, MCP, etc.).
+ */
+export class ConnectionError extends AmodalError {
+    connection;
+    action;
+    constructor(message, options) {
+        super('CONNECTION_ERROR', message, {
+            connection: options.connection,
+            action: options.action,
+            ...options.context,
+        }, options.cause);
+        this.name = 'ConnectionError';
+        this.connection = options.connection;
+        this.action = options.action;
+    }
+}
+// ---------------------------------------------------------------------------
+// Session errors
+// ---------------------------------------------------------------------------
+/**
+ * Error in session lifecycle (creation, destroy, state transitions).
+ */
+export class SessionError extends AmodalError {
+    sessionId;
+    constructor(message, options) {
+        super('SESSION_ERROR', message, {
+            sessionId: options.sessionId,
+            ...options.context,
+        }, options.cause);
+        this.name = 'SessionError';
+        this.sessionId = options.sessionId;
+    }
+}
+// ---------------------------------------------------------------------------
+// Compaction errors
+// ---------------------------------------------------------------------------
+/**
+ * Error during context compaction (summarization, truncation).
+ */
+export class CompactionError extends AmodalError {
+    stage;
+    constructor(message, options) {
+        super('COMPACTION_ERROR', message, {
+            stage: options.stage,
+            ...options.context,
+        }, options.cause);
+        this.name = 'CompactionError';
+        this.stage = options.stage;
+    }
+}
+// ---------------------------------------------------------------------------
+// Config errors
+// ---------------------------------------------------------------------------
+/**
+ * Error in configuration loading or validation.
+ * Includes a `suggestion` field with actionable fix instructions.
+ */
+export class ConfigError extends AmodalError {
+    key;
+    suggestion;
+    constructor(message, options) {
+        super('CONFIG_ERROR', message, {
+            key: options.key,
+            ...options.context,
+        }, options.cause);
+        this.name = 'ConfigError';
+        this.key = options.key;
+        this.suggestion = options.suggestion ?? '';
+    }
+    /** Format as a multi-line error message for CLI output. */
+    format() {
+        const lines = [`Config error: ${this.message}`];
+        if (this.key)
+            lines.push(`  Key: ${this.key}`);
+        if (this.suggestion)
+            lines.push(`  Fix: ${this.suggestion}`);
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/errors.js.map

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

package/dist/src/errors.test.d.ts

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

package/dist/src/errors.test.js

@@ -0,0 +1,203 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { describe, it, expect } from 'vitest';
+import { AmodalError, ProviderError, RateLimitError, ProviderTimeoutError, ToolExecutionError, StoreError, ConnectionError, SessionError, CompactionError, ConfigError, } from './errors.js';
+describe('AmodalError', () => {
+    it('carries code, message, and context', () => {
+        const err = new AmodalError('TEST_CODE', 'something broke', { foo: 'bar' });
+        expect(err.code).toBe('TEST_CODE');
+        expect(err.message).toBe('something broke');
+        expect(err.context).toEqual({ foo: 'bar' });
+        expect(err.name).toBe('AmodalError');
+        expect(err).toBeInstanceOf(Error);
+    });
+    it('defaults context to empty object', () => {
+        const err = new AmodalError('X', 'msg');
+        expect(err.context).toEqual({});
+    });
+    it('preserves cause chain', () => {
+        const cause = new Error('root cause');
+        const err = new AmodalError('X', 'wrapped', {}, cause);
+        expect(err.cause).toBe(cause);
+    });
+    it('serializes to JSON with cause', () => {
+        const cause = new Error('root');
+        const err = new AmodalError('TEST', 'msg', { k: 1 }, cause);
+        const json = err.toJSON();
+        expect(json).toEqual({
+            name: 'AmodalError',
+            code: 'TEST',
+            message: 'msg',
+            context: { k: 1 },
+            cause: { name: 'Error', message: 'root' },
+        });
+    });
+    it('serializes to JSON without cause', () => {
+        const err = new AmodalError('TEST', 'msg');
+        const json = err.toJSON();
+        expect(json).not.toHaveProperty('cause');
+    });
+    it('serializes non-Error cause as string', () => {
+        const err = new AmodalError('TEST', 'msg', {}, 'string cause');
+        expect(err.toJSON()['cause']).toBe('string cause');
+    });
+});
+describe('ProviderError', () => {
+    it('has correct code and provider fields', () => {
+        const err = new ProviderError('API failed', { provider: 'anthropic', statusCode: 500 });
+        expect(err.code).toBe('PROVIDER_ERROR');
+        expect(err.provider).toBe('anthropic');
+        expect(err.statusCode).toBe(500);
+        expect(err.retryable).toBe(false);
+        expect(err.name).toBe('ProviderError');
+        expect(err).toBeInstanceOf(AmodalError);
+        expect(err.context['provider']).toBe('anthropic');
+        expect(err.context['statusCode']).toBe(500);
+    });
+    it('defaults retryable to false', () => {
+        const err = new ProviderError('fail', { provider: 'openai' });
+        expect(err.retryable).toBe(false);
+    });
+});
+describe('RateLimitError', () => {
+    it('is a retryable ProviderError with 429 status', () => {
+        const err = new RateLimitError('slow down', { provider: 'anthropic', retryAfterMs: 5000 });
+        expect(err.statusCode).toBe(429);
+        expect(err.retryable).toBe(true);
+        expect(err.retryAfterMs).toBe(5000);
+        expect(err.name).toBe('RateLimitError');
+        expect(err).toBeInstanceOf(ProviderError);
+        expect(err).toBeInstanceOf(AmodalError);
+    });
+});
+describe('ProviderTimeoutError', () => {
+    it('is a retryable ProviderError', () => {
+        const err = new ProviderTimeoutError('timed out', { provider: 'google' });
+        expect(err.retryable).toBe(true);
+        expect(err.name).toBe('ProviderTimeoutError');
+        expect(err).toBeInstanceOf(ProviderError);
+    });
+});
+describe('ToolExecutionError', () => {
+    it('carries tool name and call ID in context', () => {
+        const err = new ToolExecutionError('tool crashed', {
+            toolName: 'fetch_deals',
+            callId: 'call_123',
+            context: { args: { limit: 10 } },
+        });
+        expect(err.code).toBe('TOOL_EXECUTION_ERROR');
+        expect(err.toolName).toBe('fetch_deals');
+        expect(err.callId).toBe('call_123');
+        expect(err.context['toolName']).toBe('fetch_deals');
+        expect(err.context['args']).toEqual({ limit: 10 });
+        expect(err).toBeInstanceOf(AmodalError);
+    });
+});
+describe('StoreError', () => {
+    it('carries store name and operation', () => {
+        const cause = new Error('PGLite crash');
+        const err = new StoreError('write failed', {
+            store: 'alerts',
+            operation: 'put',
+            cause,
+            context: { key: 'alert-1' },
+        });
+        expect(err.code).toBe('STORE_ERROR');
+        expect(err.store).toBe('alerts');
+        expect(err.operation).toBe('put');
+        expect(err.context['key']).toBe('alert-1');
+        expect(err.cause).toBe(cause);
+        expect(err).toBeInstanceOf(AmodalError);
+    });
+});
+describe('ConnectionError', () => {
+    it('carries connection name and action', () => {
+        const err = new ConnectionError('auth failed', {
+            connection: 'typefully',
+            action: 'POST /social-sets',
+        });
+        expect(err.code).toBe('CONNECTION_ERROR');
+        expect(err.connection).toBe('typefully');
+        expect(err.action).toBe('POST /social-sets');
+        expect(err).toBeInstanceOf(AmodalError);
+    });
+});
+describe('SessionError', () => {
+    it('carries session ID', () => {
+        const err = new SessionError('session expired', {
+            sessionId: 'sess_abc',
+            context: { tenantId: 'tenant_1' },
+        });
+        expect(err.code).toBe('SESSION_ERROR');
+        expect(err.sessionId).toBe('sess_abc');
+        expect(err.context['tenantId']).toBe('tenant_1');
+        expect(err).toBeInstanceOf(AmodalError);
+    });
+});
+describe('CompactionError', () => {
+    it('carries stage', () => {
+        const err = new CompactionError('summarization failed', { stage: 'pre_summarize' });
+        expect(err.code).toBe('COMPACTION_ERROR');
+        expect(err.stage).toBe('pre_summarize');
+        expect(err).toBeInstanceOf(AmodalError);
+    });
+});
+describe('ConfigError', () => {
+    it('carries config key', () => {
+        const err = new ConfigError('missing API key', {
+            key: 'providers.primary.apiKey',
+            context: { checked: ['env:ANTHROPIC_API_KEY', 'amodal.json'] },
+        });
+        expect(err.code).toBe('CONFIG_ERROR');
+        expect(err.key).toBe('providers.primary.apiKey');
+        expect(err.context['checked']).toEqual(['env:ANTHROPIC_API_KEY', 'amodal.json']);
+        expect(err).toBeInstanceOf(AmodalError);
+    });
+    it('formats a multi-line error with key and suggestion', () => {
+        const err = new ConfigError('API key not found', {
+            key: 'models.main.provider',
+            suggestion: 'Set ANTHROPIC_API_KEY in your .env file.',
+        });
+        expect(err.format()).toBe('Config error: API key not found\n' +
+            '  Key: models.main.provider\n' +
+            '  Fix: Set ANTHROPIC_API_KEY in your .env file.');
+    });
+    it('formats without suggestion when omitted', () => {
+        const err = new ConfigError('bad value', { key: 'stores.backend' });
+        expect(err.suggestion).toBe('');
+        expect(err.format()).toBe('Config error: bad value\n  Key: stores.backend');
+    });
+});
+describe('unique error codes', () => {
+    it('each subclass has a distinct code', () => {
+        const codes = [
+            new ProviderError('', { provider: '' }),
+            new ToolExecutionError('', { toolName: '', callId: '' }),
+            new StoreError('', { store: '', operation: '' }),
+            new ConnectionError('', { connection: '', action: '' }),
+            new SessionError('', { sessionId: '' }),
+            new CompactionError('', { stage: '' }),
+            new ConfigError('', { key: '' }),
+        ].map(e => e.code);
+        expect(new Set(codes).size).toBe(codes.length);
+    });
+});
+describe('Result type', () => {
+    it('narrows on ok check', () => {
+        const success = { ok: true, value: 42 };
+        const failure = {
+            ok: false,
+            error: new StoreError('not found', { store: 'alerts', operation: 'get' }),
+        };
+        if (success.ok) {
+            expect(success.value).toBe(42);
+        }
+        if (!failure.ok) {
+            expect(failure.error.store).toBe('alerts');
+        }
+    });
+});
+//# sourceMappingURL=errors.test.js.map

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

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

package/dist/src/index.d.ts

@@ -26,4 +26,9 @@ export type { StreamHooks } from './session/session-runner.js';
 export { runMessage } from './session/session-runner.js';
 export { routeOutput } from './output/output-router.js';
 export { errorHandler } from './middleware/error-handler.js';
-export { log, setLogLevel, getLogLevel, LogLevel, initLogLevel, interceptConsole, verbosityToLogLevel } from './logger.js';
+export { AmodalError, ProviderError, RateLimitError, ProviderTimeoutError, ToolExecutionError, StoreError, ConnectionError, SessionError, CompactionError, ConfigError, } from './errors.js';
+export type { Result } from './errors.js';
+export { log, setLogLevel, getLogLevel, setLogFormat, getLogFormat, setSanitize, LogLevel, initLogLevel, interceptConsole, verbosityToLogLevel, createLogger } from './logger.js';
+export type { Logger, LoggerConfig, LogFormat } from './logger.js';
+export { loadConfig } from './config.js';
+export type { AgentConfig, ConfigOverrides, LoadConfigOptions, McpServerConfig } from './config.js';

package/dist/src/index.js

@@ -25,8 +25,12 @@ export { runMessage } from './session/session-runner.js';
 export { routeOutput } from './output/output-router.js';
 // Error handler
 export { errorHandler } from './middleware/error-handler.js';
+// Typed error classes
+export { AmodalError, ProviderError, RateLimitError, ProviderTimeoutError, ToolExecutionError, StoreError, ConnectionError, SessionError, CompactionError, ConfigError, } from './errors.js';
 // Logger
-export { log, setLogLevel, getLogLevel, LogLevel, initLogLevel, interceptConsole, verbosityToLogLevel } from './logger.js';
+export { log, setLogLevel, getLogLevel, setLogFormat, getLogFormat, setSanitize, LogLevel, initLogLevel, interceptConsole, verbosityToLogLevel, createLogger } from './logger.js';
+// Config
+export { loadConfig } from './config.js';
 // ---------------------------------------------------------------------------
 // Environment variable parsing
 // ---------------------------------------------------------------------------

package/dist/src/index.js.map

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