agentfootprint 1.23.0 → 2.1.0

package/dist/esm/adapters/mcp/mcpToolProvider.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcpToolProvider.js","sourceRoot":"","sources":["../../../../src/adapters/mcp/mcpToolProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAmCH,MAAM,UAAU,eAAe,CAAC,OAA+B;IAC7D,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAExC,OAAO;QACL,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;YACvC,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC9B,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI;gBACrB,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,EAAE;gBAChC,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,EAAE;aACjC,CAAC,CAAC,CAAC;YACJ,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,MAAM,wBAAwB,EAAE,CAAC;QACtF,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,IAAc,EAAE,OAAqB,EAAgC,EAAE;YACrF,yCAAyC;YACzC,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YACrE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YAC/D,OAAO;gBACL,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,KAAK,EAAE,MAAM,CAAC,OAAO;aACtB,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -1,61 +0,0 @@
-/**
- * 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.' },
- *   ]);
- */
-export 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;
-    }
-}
-/**
- * Factory function for creating a mock model.
- *
- *   const model = mock([{ content: 'Hello!' }]);
- */
-export function mock(responses) {
-    return new MockAdapter(responses);
-}
-//# sourceMappingURL=MockAdapter.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"MockAdapter.js","sourceRoot":"","sources":["../../../../src/adapters/mock/MockAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAWH,MAAM,OAAO,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;AAED;;;;GAIG;AACH,MAAM,UAAU,IAAI,CAAC,SAAyB;IAC5C,OAAO,IAAI,WAAW,CAAC,SAAS,CAAC,CAAC;AACpC,CAAC"}

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

@@ -1,56 +0,0 @@
-/**
- * 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 }] },
- *   ]);
- */
-export 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;
-    }
-}
-/**
- * Factory function for creating a mock retriever.
- *
- *   const retriever = mockRetriever([{ chunks: [{ content: 'doc', score: 0.9 }] }]);
- */
-export function mockRetriever(responses) {
-    return new MockRetriever(responses);
-}
-//# sourceMappingURL=MockRetriever.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"MockRetriever.js","sourceRoot":"","sources":["../../../../src/adapters/mock/MockRetriever.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAaH,MAAM,OAAO,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;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,SAAkC;IAC9D,OAAO,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC"}

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

@@ -1,274 +0,0 @@
-/**
- * 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',
- *   });
- */
-import { wrapSDKError } from '../../types/errors';
-export 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 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 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 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,
-                        },
-                    },
-                }
-                : {}),
-        };
-    }
-}
-// ── 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/esm/adapters/openai/OpenAIAdapter.js.map

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

package/dist/esm/adapters/resilientProvider.js

@@ -1,89 +0,0 @@
-/**
- * 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),
- *   });
- */
-import { CircuitBreaker } from '../compositions/withCircuitBreaker';
-export 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 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,
-    };
-}
-//# sourceMappingURL=resilientProvider.js.map

package/dist/esm/adapters/resilientProvider.js.map

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

package/dist/esm/compositions/index.js

@@ -1,10 +0,0 @@
-/**
- * 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.
- */
-export { withRetry } from './withRetry';
-export { withFallback } from './withFallback';
-export { withCircuitBreaker, CircuitBreaker } from './withCircuitBreaker';
-//# sourceMappingURL=index.js.map

package/dist/esm/compositions/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/compositions/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/esm/compositions/withCircuitBreaker.js

@@ -1,79 +0,0 @@
-/**
- * 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,
- *   });
- */
-export 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;
-    }
-}
-export 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;
-            }
-        },
-        getNarrativeEntries: runner.getNarrativeEntries?.bind(runner),
-        getSnapshot: runner.getSnapshot?.bind(runner),
-    };
-    return wrapped;
-}
-//# sourceMappingURL=withCircuitBreaker.js.map

package/dist/esm/compositions/withCircuitBreaker.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"withCircuitBreaker.js","sourceRoot":"","sources":["../../../src/compositions/withCircuitBreaker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAaH,MAAM,OAAO,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;AAED,MAAM,UAAU,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,mBAAmB,EAAE,MAAM,CAAC,mBAAmB,EAAE,IAAI,CAAC,MAAM,CAAC;QAC7D,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC;KAC9C,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/esm/compositions/withFallback.js

@@ -1,29 +0,0 @@
-/**
- * withFallback — wraps a primary RunnerLike with a fallback.
- *
- * If the primary runner throws, the fallback runner is called instead.
- * Useful for degraded-mode patterns (e.g., expensive LLM → cheap LLM).
- *
- * Usage:
- *   const safe = withFallback(gpt4Agent, gpt35Agent);
- *   const result = await safe.run('Hello');
- */
-export function withFallback(primary, fallback, options = {}) {
-    const { shouldFallback = () => true } = options;
-    return {
-        run: async (message, runOptions) => {
-            try {
-                return await primary.run(message, runOptions);
-            }
-            catch (err) {
-                if (!shouldFallback(err))
-                    throw err;
-                return fallback.run(message, runOptions);
-            }
-        },
-        // Narrative/snapshot from whichever runner succeeded
-        getNarrativeEntries: () => primary.getNarrativeEntries?.() ?? fallback.getNarrativeEntries?.() ?? [],
-        getSnapshot: () => primary.getSnapshot?.() ?? fallback.getSnapshot?.(),
-    };
-}
-//# sourceMappingURL=withFallback.js.map

package/dist/esm/compositions/withFallback.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"withFallback.js","sourceRoot":"","sources":["../../../src/compositions/withFallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,MAAM,UAAU,YAAY,CAC1B,OAAmB,EACnB,QAAoB,EACpB,UAA2B,EAAE;IAE7B,MAAM,EAAE,cAAc,GAAG,GAAG,EAAE,CAAC,IAAI,EAAE,GAAG,OAAO,CAAC;IAEhD,OAAO;QACL,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE;YACjC,IAAI,CAAC;gBACH,OAAO,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;YAChD,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC;oBAAE,MAAM,GAAG,CAAC;gBACpC,OAAO,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;QACD,qDAAqD;QACrD,mBAAmB,EAAE,GAAG,EAAE,CACxB,OAAO,CAAC,mBAAmB,EAAE,EAAE,IAAI,QAAQ,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE;QAC3E,WAAW,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,IAAI,QAAQ,CAAC,WAAW,EAAE,EAAE;KACvE,CAAC;AACJ,CAAC"}