agentfootprint 1.0.0

package/dist/adapters/mock/MockAdapter.js

@@ -0,0 +1,66 @@
+"use strict";
+/**
+ * MockAdapter — scripted LLM responses for $0 testing.
+ *
+ * Same flowchart, swap the adapter, zero code changes.
+ * Tests exercise the exact same control flow as production.
+ *
+ * Usage:
+ *   import { mock } from 'agentfootprint';
+ *   const model = mock([
+ *     { content: 'Let me search.', toolCalls: [{ id: '1', name: 'search', arguments: { q: 'test' } }] },
+ *     { content: 'The answer is 42.' },
+ *   ]);
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mock = exports.MockAdapter = void 0;
+class MockAdapter {
+    responses;
+    callIndex = 0;
+    calls = [];
+    constructor(responses) {
+        this.responses = [...responses];
+    }
+    async chat(messages, options) {
+        this.calls.push({ messages: [...messages], options });
+        if (this.callIndex >= this.responses.length) {
+            throw new Error(`MockAdapter: no more responses. Expected ${this.responses.length} calls, got ${this.callIndex + 1}. ` + 'Add more responses to your mock() configuration.');
+        }
+        const response = this.responses[this.callIndex++];
+        return {
+            content: response.content,
+            toolCalls: response.toolCalls,
+            usage: response.usage ?? { inputTokens: 10, outputTokens: 20 },
+            model: response.model ?? 'mock',
+            finishReason: response.toolCalls?.length ? 'tool_calls' : 'stop',
+        };
+    }
+    /** How many times chat() was called. */
+    getCallCount() {
+        return this.calls.length;
+    }
+    /** Get the messages sent in a specific call (0-indexed). */
+    getCall(index) {
+        return this.calls[index];
+    }
+    /** Get all calls for assertion. */
+    getAllCalls() {
+        return this.calls;
+    }
+    /** Reset call history (keep responses). */
+    reset() {
+        this.callIndex = 0;
+        this.calls.length = 0;
+    }
+}
+exports.MockAdapter = MockAdapter;
+/**
+ * Factory function for creating a mock model.
+ *
+ *   const model = mock([{ content: 'Hello!' }]);
+ */
+function mock(responses) {
+    return new MockAdapter(responses);
+}
+exports.mock = mock;
+//# sourceMappingURL=MockAdapter.js.map

package/dist/adapters/mock/MockAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockAdapter.js","sourceRoot":"","sources":["../../../src/adapters/mock/MockAdapter.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAWH,MAAa,WAAW;IACd,SAAS,CAAiB;IAC1B,SAAS,GAAG,CAAC,CAAC;IACL,KAAK,GAA6D,EAAE,CAAC;IAEtF,YAAY,SAAyB;QACnC,IAAI,CAAC,SAAS,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAmB,EAAE,OAAwB;QACtD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QAEtD,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CACb,4CAA4C,IAAI,CAAC,SAAS,CAAC,MAAM,eAC/D,IAAI,CAAC,SAAS,GAAG,CACnB,IAAI,GAAG,kDAAkD,CAC1D,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QAElD,OAAO;YACL,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE;YAC9D,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,MAAM;YAC/B,YAAY,EAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM;SACjE,CAAC;IACJ,CAAC;IAED,wCAAwC;IACxC,YAAY;QACV,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,4DAA4D;IAC5D,OAAO,CAAC,KAAa;QACnB,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED,mCAAmC;IACnC,WAAW;QACT,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,2CAA2C;IAC3C,KAAK;QACH,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IACxB,CAAC;CACF;AAnDD,kCAmDC;AAED;;;;GAIG;AACH,SAAgB,IAAI,CAAC,SAAyB;IAC5C,OAAO,IAAI,WAAW,CAAC,SAAS,CAAC,CAAC;AACpC,CAAC;AAFD,oBAEC"}

package/dist/adapters/mock/MockRetriever.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * MockRetriever — scripted retrieval responses for $0 testing.
+ *
+ * Same flowchart, swap the retriever, zero code changes.
+ *
+ * Usage:
+ *   import { mockRetriever } from 'agentfootprint';
+ *   const retriever = mockRetriever([
+ *     { chunks: [{ content: 'Relevant doc', score: 0.95 }] },
+ *   ]);
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mockRetriever = exports.MockRetriever = void 0;
+class MockRetriever {
+    responses;
+    callIndex = 0;
+    calls = [];
+    constructor(responses) {
+        this.responses = [...responses];
+    }
+    async retrieve(query, options) {
+        this.calls.push({ query, options });
+        if (this.callIndex >= this.responses.length) {
+            throw new Error(`MockRetriever: no more responses. Expected ${this.responses.length} calls, got ${this.callIndex + 1}. ` + 'Add more responses to your mockRetriever() configuration.');
+        }
+        const response = this.responses[this.callIndex++];
+        return {
+            chunks: response.chunks,
+            query,
+        };
+    }
+    /** How many times retrieve() was called. */
+    getCallCount() {
+        return this.calls.length;
+    }
+    /** Get a specific call (0-indexed). */
+    getCall(index) {
+        return this.calls[index];
+    }
+    /** Get all calls for assertion. */
+    getAllCalls() {
+        return this.calls;
+    }
+    /** Reset call history (keep responses). */
+    reset() {
+        this.callIndex = 0;
+        this.calls.length = 0;
+    }
+}
+exports.MockRetriever = MockRetriever;
+/**
+ * Factory function for creating a mock retriever.
+ *
+ *   const retriever = mockRetriever([{ chunks: [{ content: 'doc', score: 0.9 }] }]);
+ */
+function mockRetriever(responses) {
+    return new MockRetriever(responses);
+}
+exports.mockRetriever = mockRetriever;
+//# sourceMappingURL=MockRetriever.js.map

package/dist/adapters/mock/MockRetriever.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockRetriever.js","sourceRoot":"","sources":["../../../src/adapters/mock/MockRetriever.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAaH,MAAa,aAAa;IAChB,SAAS,CAA0B;IACnC,SAAS,GAAG,CAAC,CAAC;IACL,KAAK,GAAwD,EAAE,CAAC;IAEjF,YAAY,SAAkC;QAC5C,IAAI,CAAC,SAAS,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAAa,EAAE,OAAyB;QACrD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAEpC,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CACb,8CAA8C,IAAI,CAAC,SAAS,CAAC,MAAM,eACjE,IAAI,CAAC,SAAS,GAAG,CACnB,IAAI,GAAG,2DAA2D,CACnE,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QAElD,OAAO;YACL,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,KAAK;SACN,CAAC;IACJ,CAAC;IAED,4CAA4C;IAC5C,YAAY;QACV,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,uCAAuC;IACvC,OAAO,CAAC,KAAa;QACnB,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED,mCAAmC;IACnC,WAAW;QACT,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,2CAA2C;IAC3C,KAAK;QACH,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IACxB,CAAC;CACF;AAhDD,sCAgDC;AAED;;;;GAIG;AACH,SAAgB,aAAa,CAAC,SAAkC;IAC9D,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAFD,sCAEC"}

package/dist/adapters/openai/OpenAIAdapter.js

@@ -0,0 +1,276 @@
+"use strict";
+/**
+ * OpenAIAdapter — wraps the openai SDK as an LLMProvider.
+ *
+ * Requires: npm install openai
+ *
+ * Also works with OpenAI-compatible APIs (Ollama, Together, Groq, etc.)
+ * by setting the baseURL option.
+ *
+ * Features:
+ *   - Full chat() + chatStream() support
+ *   - Multi-modal content (text, images via URL)
+ *   - AbortSignal passthrough for cancellation
+ *   - Normalized LLMError for uniform error handling
+ *
+ * Usage:
+ *   import { OpenAIAdapter } from 'agentfootprint';
+ *   const provider = new OpenAIAdapter({ model: 'gpt-4o' });
+ *
+ *   // Ollama (OpenAI-compatible):
+ *   const ollama = new OpenAIAdapter({
+ *     model: 'llama3',
+ *     baseURL: 'http://localhost:11434/v1',
+ *   });
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAIAdapter = void 0;
+const errors_1 = require("../../types/errors");
+class OpenAIAdapter {
+    client;
+    model;
+    defaultMaxTokens;
+    constructor(options) {
+        this.model = options.model;
+        this.defaultMaxTokens = options.maxTokens;
+        if (options._client) {
+            this.client = options._client;
+            return;
+        }
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            const OpenAI = require('openai').default ?? require('openai');
+            this.client = new OpenAI({
+                apiKey: options.apiKey,
+                ...(options.baseURL ? { baseURL: options.baseURL } : {}),
+            });
+        }
+        catch {
+            throw new Error('OpenAIAdapter requires the openai package. Install it:\n  npm install openai');
+        }
+    }
+    async chat(messages, options) {
+        const params = this.buildParams(messages, options);
+        try {
+            const response = await this.client.chat.completions.create(params);
+            return convertResponse(response);
+        }
+        catch (err) {
+            throw (0, errors_1.wrapSDKError)(err, 'openai');
+        }
+    }
+    async *chatStream(messages, options) {
+        const params = this.buildParams(messages, options);
+        let stream;
+        try {
+            stream = this.client.chat.completions.create({
+                ...params,
+                stream: true,
+            });
+        }
+        catch (err) {
+            throw (0, errors_1.wrapSDKError)(err, 'openai');
+        }
+        // Accumulate tool calls across chunks
+        const toolCallAccumulator = new Map();
+        try {
+            for await (const chunk of stream) {
+                const choice = chunk.choices[0];
+                if (!choice)
+                    continue;
+                // Text token
+                if (choice.delta.content) {
+                    yield { type: 'token', content: choice.delta.content };
+                }
+                // Tool call chunks
+                if (choice.delta.tool_calls) {
+                    for (const tc of choice.delta.tool_calls) {
+                        if (!toolCallAccumulator.has(tc.index)) {
+                            toolCallAccumulator.set(tc.index, { id: tc.id ?? '', name: '', args: '' });
+                        }
+                        const acc = toolCallAccumulator.get(tc.index);
+                        if (tc.id)
+                            acc.id = tc.id;
+                        if (tc.function?.name)
+                            acc.name = tc.function.name;
+                        if (tc.function?.arguments)
+                            acc.args += tc.function.arguments;
+                    }
+                }
+                // Usage (final chunk)
+                if (chunk.usage) {
+                    yield {
+                        type: 'usage',
+                        usage: {
+                            inputTokens: chunk.usage.prompt_tokens,
+                            outputTokens: chunk.usage.completion_tokens,
+                            totalTokens: chunk.usage.total_tokens,
+                        },
+                    };
+                }
+                // Emit accumulated tool calls on finish
+                if (choice.finish_reason === 'tool_calls') {
+                    for (const [, tc] of toolCallAccumulator) {
+                        let args = {};
+                        try {
+                            args = JSON.parse(tc.args);
+                        }
+                        catch {
+                            args = { _raw: tc.args };
+                        }
+                        yield {
+                            type: 'tool_call',
+                            toolCall: { id: tc.id, name: tc.name, arguments: args },
+                        };
+                    }
+                }
+            }
+            yield { type: 'done' };
+        }
+        catch (err) {
+            throw (0, errors_1.wrapSDKError)(err, 'openai');
+        }
+    }
+    buildParams(messages, options) {
+        const openaiMessages = convertMessages(messages);
+        const tools = options?.tools?.map(convertTool);
+        return {
+            model: this.model,
+            messages: openaiMessages,
+            ...(tools && tools.length > 0 ? { tools } : {}),
+            ...(options?.maxTokens ?? this.defaultMaxTokens
+                ? { max_tokens: options?.maxTokens ?? this.defaultMaxTokens }
+                : {}),
+            ...(options?.temperature !== undefined ? { temperature: options.temperature } : {}),
+            ...(options?.stop ? { stop: options.stop } : {}),
+            ...(options?.signal ? { signal: options.signal } : {}),
+            ...(options?.responseFormat ? {
+                response_format: {
+                    type: 'json_schema',
+                    json_schema: {
+                        name: options.responseFormat.name ?? 'response',
+                        schema: options.responseFormat.schema,
+                        strict: true,
+                    },
+                },
+            } : {}),
+        };
+    }
+}
+exports.OpenAIAdapter = OpenAIAdapter;
+// ── Converters ───────────────────────────────────────────────
+function convertContent(content) {
+    if (typeof content === 'string')
+        return content;
+    const parts = [];
+    for (const block of content) {
+        switch (block.type) {
+            case 'text':
+                parts.push({ type: 'text', text: block.text });
+                break;
+            case 'image':
+                if (block.source.type === 'url') {
+                    parts.push({ type: 'image_url', image_url: { url: block.source.url } });
+                }
+                else if (block.source.type === 'base64') {
+                    // OpenAI accepts data URLs for base64 images
+                    parts.push({
+                        type: 'image_url',
+                        image_url: { url: `data:${block.source.mediaType};base64,${block.source.data}` },
+                    });
+                }
+                break;
+            // tool_use and tool_result blocks are handled by toolCalls/tool messages
+        }
+    }
+    return parts.length > 0 ? parts : null;
+}
+function convertMessages(messages) {
+    return messages.map((msg) => {
+        switch (msg.role) {
+            case 'system':
+                return {
+                    role: 'system',
+                    content: typeof msg.content === 'string' ? msg.content : String(msg.content),
+                };
+            case 'user':
+                return {
+                    role: 'user',
+                    content: convertContent(msg.content),
+                };
+            case 'assistant': {
+                const toolCalls = msg.toolCalls?.map((tc) => ({
+                    id: tc.id,
+                    type: 'function',
+                    function: {
+                        name: tc.name,
+                        arguments: JSON.stringify(tc.arguments),
+                    },
+                }));
+                return {
+                    role: 'assistant',
+                    content: typeof msg.content === 'string' ? msg.content : null,
+                    ...(toolCalls && toolCalls.length > 0 ? { tool_calls: toolCalls } : {}),
+                };
+            }
+            case 'tool':
+                return {
+                    role: 'tool',
+                    content: typeof msg.content === 'string' ? msg.content : String(msg.content),
+                    tool_call_id: msg.toolCallId,
+                };
+        }
+    });
+}
+function convertTool(tool) {
+    return {
+        type: 'function',
+        function: {
+            name: tool.name,
+            description: tool.description,
+            parameters: tool.inputSchema,
+        },
+    };
+}
+function convertResponse(response) {
+    const choice = response.choices[0];
+    if (!choice) {
+        return { content: '', finishReason: 'error' };
+    }
+    const toolCalls = choice.message.tool_calls?.map((tc) => {
+        let args = {};
+        try {
+            args = JSON.parse(tc.function.arguments);
+        }
+        catch {
+            args = { _raw: tc.function.arguments };
+        }
+        return {
+            id: tc.id,
+            name: tc.function.name,
+            arguments: args,
+        };
+    });
+    const finishReason = choice.finish_reason === 'tool_calls'
+        ? 'tool_calls'
+        : choice.finish_reason === 'length'
+            ? 'length'
+            : choice.finish_reason === 'content_filter'
+                ? 'error'
+                : 'stop';
+    const usage = response.usage
+        ? {
+            inputTokens: response.usage.prompt_tokens,
+            outputTokens: response.usage.completion_tokens,
+            totalTokens: response.usage.total_tokens,
+        }
+        : undefined;
+    return {
+        content: choice.message.content ?? '',
+        toolCalls: toolCalls && toolCalls.length > 0 ? toolCalls : undefined,
+        usage,
+        model: response.model,
+        finishReason: finishReason,
+    };
+}
+//# sourceMappingURL=OpenAIAdapter.js.map

package/dist/adapters/openai/OpenAIAdapter.js.map

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

package/dist/adapters/resilientProvider.js

@@ -0,0 +1,93 @@
+"use strict";
+/**
+ * resilientProvider — fallback + circuit breaker in one call.
+ *
+ * Combines fallbackProvider() with per-provider CircuitBreaker instances.
+ * Each provider gets its own breaker. When a provider trips its breaker,
+ * it's skipped instantly (no wasted latency on known-down providers).
+ *
+ * This addresses the "sequential" con of fallbackProvider — with circuit
+ * breakers, a tripped provider is skipped in O(1) instead of waiting
+ * for it to timeout.
+ *
+ * Usage:
+ *   const provider = resilientProvider([
+ *     new AnthropicAdapter({ model: 'claude-sonnet-4-20250514' }),
+ *     new OpenAIAdapter({ model: 'gpt-4o' }),
+ *     new OpenAIAdapter({ model: 'llama3', baseURL: 'http://localhost:11434/v1' }),
+ *   ], {
+ *     circuitBreaker: { threshold: 3, resetAfterMs: 30_000 },
+ *     onFallback: (from, to, err) => console.warn('Switching provider', from, '→', to),
+ *   });
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resilientProvider = void 0;
+const withCircuitBreaker_1 = require("../compositions/withCircuitBreaker");
+function resilientProvider(providers, options) {
+    if (providers.length === 0) {
+        throw new Error('[resilientProvider] At least one provider is required.');
+    }
+    const { onFallback, shouldFallback = () => true, circuitBreaker: cbOpts } = options ?? {};
+    const breakers = providers.map(() => new withCircuitBreaker_1.CircuitBreaker(cbOpts ?? { threshold: 3, resetAfterMs: 30_000 }));
+    return {
+        breakers,
+        chat: async (messages, callOptions) => {
+            let lastError;
+            for (let i = 0; i < providers.length; i++) {
+                const state = breakers[i].getState();
+                // Skip tripped providers (O(1) — no wasted latency)
+                if (state === 'open') {
+                    onFallback?.(i, i + 1, new Error(`Circuit breaker open for provider ${i}`));
+                    continue;
+                }
+                try {
+                    const result = await providers[i].chat(messages, callOptions);
+                    breakers[i].recordSuccess();
+                    return result;
+                }
+                catch (error) {
+                    lastError = error;
+                    breakers[i].recordFailure();
+                    if (i === providers.length - 1)
+                        break;
+                    if (!shouldFallback(error))
+                        break;
+                    onFallback?.(i, i + 1, error);
+                }
+            }
+            throw lastError ?? new Error('All providers failed (circuit breakers open)');
+        },
+        chatStream: providers.some((p) => p.chatStream)
+            ? async function* (messages, callOptions) {
+                let lastError;
+                for (let i = 0; i < providers.length; i++) {
+                    const provider = providers[i];
+                    if (!provider.chatStream)
+                        continue;
+                    const state = breakers[i].getState();
+                    if (state === 'open') {
+                        onFallback?.(i, i + 1, new Error(`Circuit breaker open for provider ${i}`));
+                        continue;
+                    }
+                    try {
+                        yield* provider.chatStream(messages, callOptions);
+                        breakers[i].recordSuccess();
+                        return;
+                    }
+                    catch (error) {
+                        lastError = error;
+                        breakers[i].recordFailure();
+                        if (i === providers.length - 1)
+                            break;
+                        if (!shouldFallback(error))
+                            break;
+                        onFallback?.(i, i + 1, error);
+                    }
+                }
+                throw lastError ?? new Error('All providers failed (circuit breakers open)');
+            }
+            : undefined,
+    };
+}
+exports.resilientProvider = resilientProvider;
+//# sourceMappingURL=resilientProvider.js.map

package/dist/adapters/resilientProvider.js.map

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

package/dist/compositions/index.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * compositions/ — Orchestration wrappers composed from existing primitives.
+ *
+ * These are NOT new concepts — they wrap RunnerLike with cross-cutting
+ * concerns (retry, fallback, circuit breaker) without changing core.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CircuitBreaker = exports.withCircuitBreaker = exports.withFallback = exports.withRetry = void 0;
+var withRetry_1 = require("./withRetry");
+Object.defineProperty(exports, "withRetry", { enumerable: true, get: function () { return withRetry_1.withRetry; } });
+var withFallback_1 = require("./withFallback");
+Object.defineProperty(exports, "withFallback", { enumerable: true, get: function () { return withFallback_1.withFallback; } });
+var withCircuitBreaker_1 = require("./withCircuitBreaker");
+Object.defineProperty(exports, "withCircuitBreaker", { enumerable: true, get: function () { return withCircuitBreaker_1.withCircuitBreaker; } });
+Object.defineProperty(exports, "CircuitBreaker", { enumerable: true, get: function () { return withCircuitBreaker_1.CircuitBreaker; } });
+//# sourceMappingURL=index.js.map

package/dist/compositions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/compositions/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAElB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AAErB,2DAA0E;AAAjE,wHAAA,kBAAkB,OAAA;AAAE,oHAAA,cAAc,OAAA"}

package/dist/compositions/withCircuitBreaker.js

@@ -0,0 +1,84 @@
+"use strict";
+/**
+ * withCircuitBreaker — wraps a RunnerLike with circuit breaker protection.
+ *
+ * Tracks consecutive failures. After `threshold` failures, the circuit
+ * opens and all subsequent calls fail immediately (fast-fail) until
+ * `resetAfterMs` has elapsed, at which point a single probe call is
+ * allowed through (half-open state).
+ *
+ * States:
+ *   CLOSED  → normal operation, counting failures
+ *   OPEN    → fast-fail, no calls to runner
+ *   HALF_OPEN → one probe call allowed; success → CLOSED, failure → OPEN
+ *
+ * Usage:
+ *   const protected = withCircuitBreaker(fragileAgent, {
+ *     threshold: 5,
+ *     resetAfterMs: 30_000,
+ *   });
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withCircuitBreaker = exports.CircuitBreaker = void 0;
+class CircuitBreaker {
+    state = 'closed';
+    failures = 0;
+    lastFailureTime = 0;
+    threshold;
+    resetAfterMs;
+    constructor(options = {}) {
+        this.threshold = options.threshold ?? 5;
+        this.resetAfterMs = options.resetAfterMs ?? 30_000;
+    }
+    getState() {
+        if (this.state === 'open') {
+            if (Date.now() - this.lastFailureTime >= this.resetAfterMs) {
+                this.state = 'half_open';
+            }
+        }
+        return this.state;
+    }
+    recordSuccess() {
+        this.failures = 0;
+        this.state = 'closed';
+    }
+    recordFailure() {
+        this.failures++;
+        this.lastFailureTime = Date.now();
+        if (this.failures >= this.threshold) {
+            this.state = 'open';
+        }
+    }
+    reset() {
+        this.state = 'closed';
+        this.failures = 0;
+        this.lastFailureTime = 0;
+    }
+}
+exports.CircuitBreaker = CircuitBreaker;
+function withCircuitBreaker(runner, options = {}) {
+    const breaker = new CircuitBreaker(options);
+    const wrapped = {
+        breaker,
+        run: async (message, runOptions) => {
+            const state = breaker.getState();
+            if (state === 'open') {
+                throw new Error('Circuit breaker is open');
+            }
+            try {
+                const result = await runner.run(message, runOptions);
+                breaker.recordSuccess();
+                return result;
+            }
+            catch (err) {
+                breaker.recordFailure();
+                throw err;
+            }
+        },
+        getNarrative: runner.getNarrative?.bind(runner),
+        getSnapshot: runner.getSnapshot?.bind(runner),
+    };
+    return wrapped;
+}
+exports.withCircuitBreaker = withCircuitBreaker;
+//# sourceMappingURL=withCircuitBreaker.js.map

package/dist/compositions/withCircuitBreaker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withCircuitBreaker.js","sourceRoot":"","sources":["../../src/compositions/withCircuitBreaker.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;AAaH,MAAa,cAAc;IACjB,KAAK,GAAiB,QAAQ,CAAC;IAC/B,QAAQ,GAAG,CAAC,CAAC;IACb,eAAe,GAAG,CAAC,CAAC;IACX,SAAS,CAAS;IAClB,YAAY,CAAS;IAEtC,YAAY,UAAiC,EAAE;QAC7C,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,MAAM,CAAC;IACrD,CAAC;IAED,QAAQ;QACN,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;YAC1B,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBAC3D,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC;YAC3B,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,aAAa;QACX,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;QAClB,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;IACxB,CAAC;IAED,aAAa;QACX,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAClC,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACpC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC;QACtB,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;QAClB,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC;IAC3B,CAAC;CACF;AAvCD,wCAuCC;AAED,SAAgB,kBAAkB,CAChC,MAAkB,EAClB,UAAiC,EAAE;IAEnC,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC;IAE5C,MAAM,OAAO,GAA6C;QACxD,OAAO;QACP,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE;YACjC,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;YAEjC,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;gBACrB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;YAC7C,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;gBACrD,OAAO,CAAC,aAAa,EAAE,CAAC;gBACxB,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,aAAa,EAAE,CAAC;gBACxB,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;QACD,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC;QAC/C,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC;KAC9C,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC;AA7BD,gDA6BC"}