agentfootprint 1.0.0

package/dist/adapters/browser/BrowserOpenAIAdapter.js.map

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

package/dist/adapters/browser/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserOpenAIAdapter = exports.BrowserAnthropicAdapter = void 0;
+var BrowserAnthropicAdapter_1 = require("./BrowserAnthropicAdapter");
+Object.defineProperty(exports, "BrowserAnthropicAdapter", { enumerable: true, get: function () { return BrowserAnthropicAdapter_1.BrowserAnthropicAdapter; } });
+var BrowserOpenAIAdapter_1 = require("./BrowserOpenAIAdapter");
+Object.defineProperty(exports, "BrowserOpenAIAdapter", { enumerable: true, get: function () { return BrowserOpenAIAdapter_1.BrowserOpenAIAdapter; } });
+//# sourceMappingURL=index.js.map

package/dist/adapters/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/browser/index.ts"],"names":[],"mappings":";;;AAAA,qEAAoE;AAA3D,kIAAA,uBAAuB,OAAA;AAEhC,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA"}

package/dist/adapters/createAdapterSubflow.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * Creates a 3-stage adapter subflow (FormatRequest → ExecuteCall → MapResponse).
+ *
+ * This is the key architectural insight: the adapter is a FlowChart subflow.
+ * Swapping mock for real only changes the ExecuteCall stage.
+ * The rest of the agent flowchart runs identically.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAdapterSubflow = void 0;
+const footprintjs_1 = require("footprintjs");
+const helpers_1 = require("../stages/helpers");
+/**
+ * Build a 3-stage subflow for LLM calls.
+ *
+ * Stage 1 (FormatRequest): Read messages + tools from scope → write adapter request
+ * Stage 2 (ExecuteCall): Call provider.chat() → write raw response
+ * Stage 3 (MapResponse): Normalize to AdapterResult → write result
+ */
+function createAdapterSubflow(config) {
+    const adapterId = config.id ?? 'llm-adapter';
+    const formatRequest = (scope) => {
+        const messages = scope.messages;
+        const tools = scope.toolDescriptions ?? [];
+        if (!messages || messages.length === 0) {
+            throw new Error('AdapterSubflow: no messages in scope');
+        }
+        scope.adapterRequest = { messages, tools };
+    };
+    const executeCall = async (scope) => {
+        const request = scope.adapterRequest;
+        const options = request.tools.length > 0 ? { tools: request.tools } : undefined;
+        const response = await config.provider.chat(request.messages, options);
+        scope.adapterRawResponse = response;
+    };
+    const mapResponse = (scope) => {
+        const response = scope.adapterRawResponse;
+        scope.adapterResult = (0, helpers_1.normalizeAdapterResponse)(response);
+    };
+    return (0, footprintjs_1.flowChart)('FormatRequest', formatRequest, `${adapterId}-format`)
+        .addFunction('ExecuteCall', executeCall, `${adapterId}-call`)
+        .addFunction('MapResponse', mapResponse, `${adapterId}-map`)
+        .build();
+}
+exports.createAdapterSubflow = createAdapterSubflow;
+//# sourceMappingURL=createAdapterSubflow.js.map

package/dist/adapters/createAdapterSubflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAdapterSubflow.js","sourceRoot":"","sources":["../../src/adapters/createAdapterSubflow.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,6CAAwC;AAIxC,+CAA6D;AAkB7D;;;;;;GAMG;AACH,SAAgB,oBAAoB,CAAC,MAA4B;IAC/D,MAAM,SAAS,GAAG,MAAM,CAAC,EAAE,IAAI,aAAa,CAAC;IAE7C,MAAM,aAAa,GAAG,CAAC,KAAsC,EAAE,EAAE;QAC/D,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAChC,MAAM,KAAK,GAAG,KAAK,CAAC,gBAAgB,IAAI,EAAE,CAAC;QAE3C,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QAED,KAAK,CAAC,cAAc,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC7C,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,KAAK,EAAE,KAAsC,EAAE,EAAE;QACnE,MAAM,OAAO,GAAG,KAAK,CAAC,cAAc,CAAC;QAErC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAChF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAEvE,KAAK,CAAC,kBAAkB,GAAG,QAAQ,CAAC;IACtC,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,CAAC,KAAsC,EAAE,EAAE;QAC7D,MAAM,QAAQ,GAAG,KAAK,CAAC,kBAAkB,CAAC;QAC1C,KAAK,CAAC,aAAa,GAAG,IAAA,kCAAwB,EAAC,QAAQ,CAAC,CAAC;IAC3D,CAAC,CAAC;IAEF,OAAO,IAAA,uBAAS,EAAsB,eAAe,EAAE,aAAa,EAAE,GAAG,SAAS,SAAS,CAAC;SACzF,WAAW,CAAC,aAAa,EAAE,WAAW,EAAE,GAAG,SAAS,OAAO,CAAC;SAC5D,WAAW,CAAC,aAAa,EAAE,WAAW,EAAE,GAAG,SAAS,MAAM,CAAC;SAC3D,KAAK,EAAE,CAAC;AACb,CAAC;AAhCD,oDAgCC"}

package/dist/adapters/createProvider.js

@@ -0,0 +1,107 @@
+"use strict";
+/**
+ * createProvider — bridges ModelConfig → LLMProvider.
+ *
+ * Resolves a ModelConfig (from anthropic(), openai(), ollama(), bedrock())
+ * into the appropriate adapter instance.
+ *
+ * Usage:
+ *   import { createProvider, anthropic } from 'agentfootprint';
+ *
+ *   // Config-based (simple DX):
+ *   const provider = createProvider(anthropic('claude-sonnet-4-20250514'));
+ *
+ *   // With options:
+ *   const provider = createProvider(openai('gpt-4o', { apiKey: 'sk-...' }));
+ *
+ *   // Ollama (auto-configured):
+ *   const provider = createProvider(ollama('llama3'));
+ *
+ *   // Bedrock with region:
+ *   const provider = createProvider(bedrock('anthropic.claude-sonnet-4-20250514-v1:0', { region: 'us-east-1' }));
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createProvider = exports.resolveProvider = exports.isLLMProvider = void 0;
+const AnthropicAdapter_1 = require("./anthropic/AnthropicAdapter");
+const OpenAIAdapter_1 = require("./openai/OpenAIAdapter");
+const BedrockAdapter_1 = require("./bedrock/BedrockAdapter");
+const MockAdapter_1 = require("./mock/MockAdapter");
+/**
+ * Check if the value is already an LLMProvider (has a `.chat` method).
+ * Used for auto-detection in Agent.create(), LLMCall.create(), etc.
+ */
+function isLLMProvider(value) {
+    return typeof value === 'object' && value !== null && typeof value.chat === 'function';
+}
+exports.isLLMProvider = isLLMProvider;
+/**
+ * Resolve a provider-or-config to an LLMProvider.
+ *
+ * Accepts either an LLMProvider directly or a ModelConfig (from anthropic(), openai(), etc.).
+ * This enables:
+ *   Agent.create({ provider: anthropic('claude-sonnet-4-20250514') })
+ * without wrapping in createProvider().
+ */
+function resolveProvider(providerOrConfig) {
+    if (isLLMProvider(providerOrConfig))
+        return providerOrConfig;
+    return createProvider(providerOrConfig);
+}
+exports.resolveProvider = resolveProvider;
+/**
+ * Create an LLMProvider from a ModelConfig.
+ *
+ * Maps provider factories (anthropic(), openai(), ollama(), bedrock())
+ * to their real adapter implementations.
+ */
+function createProvider(config) {
+    switch (config.provider) {
+        case 'anthropic':
+            return new AnthropicAdapter_1.AnthropicAdapter({
+                model: config.modelId,
+                apiKey: config.apiKey,
+                maxTokens: config.options?.maxTokens,
+                _client: config._client,
+            });
+        case 'openai':
+            return new OpenAIAdapter_1.OpenAIAdapter({
+                model: config.modelId,
+                apiKey: config.apiKey,
+                baseURL: config.baseUrl,
+                maxTokens: config.options?.maxTokens,
+                _client: config._client,
+            });
+        case 'ollama':
+            try {
+                return new OpenAIAdapter_1.OpenAIAdapter({
+                    model: config.modelId,
+                    baseURL: config.baseUrl ?? 'http://localhost:11434/v1',
+                    maxTokens: config.options?.maxTokens,
+                    _client: config._client,
+                });
+            }
+            catch (err) {
+                // OpenAIAdapter throws its own clear message if 'openai' package is missing.
+                // Re-wrap to mention Ollama specifically so the user knows which adapter failed.
+                if (err instanceof Error && err.message.includes('openai')) {
+                    throw new Error('Ollama adapter requires the "openai" package (OpenAI-compatible API).\n' +
+                        'Install it: npm install openai');
+                }
+                throw err;
+            }
+        case 'bedrock':
+            return new BedrockAdapter_1.BedrockAdapter({
+                model: config.modelId,
+                region: config.region,
+                maxTokens: config.options?.maxTokens,
+                _client: config._client,
+            });
+        case 'mock':
+            return new MockAdapter_1.MockAdapter([]);
+        default:
+            throw new Error(`Unknown provider "${config.provider}". ` +
+                'Supported: anthropic, openai, ollama, bedrock, mock.');
+    }
+}
+exports.createProvider = createProvider;
+//# sourceMappingURL=createProvider.js.map

package/dist/adapters/createProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createProvider.js","sourceRoot":"","sources":["../../src/adapters/createProvider.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAIH,mEAAgE;AAChE,0DAAuD;AACvD,6DAA0D;AAC1D,oDAAiD;AAEjD;;;GAGG;AACH,SAAgB,aAAa,CAAC,KAAc;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,OAAQ,KAAqB,CAAC,IAAI,KAAK,UAAU,CAAC;AAC1G,CAAC;AAFD,sCAEC;AAED;;;;;;;GAOG;AACH,SAAgB,eAAe,CAAC,gBAA2C;IACzE,IAAI,aAAa,CAAC,gBAAgB,CAAC;QAAE,OAAO,gBAAgB,CAAC;IAC7D,OAAO,cAAc,CAAC,gBAAuD,CAAC,CAAC;AACjF,CAAC;AAHD,0CAGC;AAED;;;;;GAKG;AACH,SAAgB,cAAc,CAC5B,MAA2C;IAE3C,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,WAAW;YACd,OAAO,IAAI,mCAAgB,CAAC;gBAC1B,KAAK,EAAE,MAAM,CAAC,OAAO;gBACrB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,SAAS;gBACpC,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB,CAAC,CAAC;QAEL,KAAK,QAAQ;YACX,OAAO,IAAI,6BAAa,CAAC;gBACvB,KAAK,EAAE,MAAM,CAAC,OAAO;gBACrB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,SAAS;gBACpC,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB,CAAC,CAAC;QAEL,KAAK,QAAQ;YACX,IAAI,CAAC;gBACH,OAAO,IAAI,6BAAa,CAAC;oBACvB,KAAK,EAAE,MAAM,CAAC,OAAO;oBACrB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,2BAA2B;oBACtD,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,SAAS;oBACpC,OAAO,EAAE,MAAM,CAAC,OAAO;iBACxB,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,6EAA6E;gBAC7E,iFAAiF;gBACjF,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC3D,MAAM,IAAI,KAAK,CACb,yEAAyE;wBACzE,gCAAgC,CACjC,CAAC;gBACJ,CAAC;gBACD,MAAM,GAAG,CAAC;YACZ,CAAC;QAEH,KAAK,SAAS;YACZ,OAAO,IAAI,+BAAc,CAAC;gBACxB,KAAK,EAAE,MAAM,CAAC,OAAO;gBACrB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,SAAS;gBACpC,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB,CAAC,CAAC;QAEL,KAAK,MAAM;YACT,OAAO,IAAI,yBAAW,CAAC,EAAE,CAAC,CAAC;QAE7B;YACE,MAAM,IAAI,KAAK,CACb,qBAAqB,MAAM,CAAC,QAAQ,KAAK;gBACvC,sDAAsD,CACzD,CAAC;IACN,CAAC;AACH,CAAC;AA1DD,wCA0DC"}

package/dist/adapters/fallbackProvider.js

@@ -0,0 +1,94 @@
+"use strict";
+/**
+ * fallbackProvider — LLMProvider that tries providers in order until one succeeds.
+ *
+ * Wraps multiple LLMProviders into a single LLMProvider. On each chat() call,
+ * tries providers in order. If one fails (rate limit, timeout, network error),
+ * falls through to the next.
+ *
+ * Narrative integration: the response includes `model` from whichever provider
+ * succeeded — recorders capture this via onLLMCall.model, so the narrative
+ * reflects which provider actually answered. The onFallback callback fires
+ * during traversal (not post-processing) for immediate observability.
+ *
+ * Usage:
+ *   // Try Anthropic, fall back to OpenAI, then local Ollama
+ *   const provider = fallbackProvider([
+ *     new AnthropicAdapter({ model: 'claude-sonnet-4-20250514' }),
+ *     new OpenAIAdapter({ model: 'gpt-4o' }),
+ *     new OpenAIAdapter({ model: 'llama3', baseURL: 'http://localhost:11434/v1' }),
+ *   ]);
+ *
+ *   const agent = Agent.create({ provider }).system('...').build();
+ *
+ *   // With observability
+ *   const provider = fallbackProvider(
+ *     [anthropicAdapter, openaiAdapter],
+ *     {
+ *       onFallback: (fromIndex, toIndex, error) =>
+ *         console.warn(`Provider ${fromIndex} failed, trying ${toIndex}:`, error),
+ *       shouldFallback: (error) => {
+ *         // Only fall back on rate limits and network errors, not auth errors
+ *         if (error instanceof LLMError) return error.statusCode === 429 || error.statusCode >= 500;
+ *         return true;
+ *       },
+ *     },
+ *   );
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fallbackProvider = void 0;
+function fallbackProvider(providers, options) {
+    if (providers.length === 0) {
+        throw new Error('[fallbackProvider] At least one provider is required.');
+    }
+    const { onFallback, shouldFallback = () => true } = options ?? {};
+    return {
+        chat: async (messages, callOptions) => {
+            let lastError;
+            for (let i = 0; i < providers.length; i++) {
+                try {
+                    return await providers[i].chat(messages, callOptions);
+                }
+                catch (error) {
+                    lastError = error;
+                    // Last provider — no more fallbacks
+                    if (i === providers.length - 1)
+                        break;
+                    // Check if we should fall back
+                    if (!shouldFallback(error))
+                        break;
+                    // Notify observer during traversal (not post-processing)
+                    onFallback?.(i, i + 1, error);
+                }
+            }
+            // All providers failed — throw the last error
+            throw lastError;
+        },
+        // Stream falls back the same way
+        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;
+                    try {
+                        yield* provider.chatStream(messages, callOptions);
+                        return; // Success — stop trying
+                    }
+                    catch (error) {
+                        lastError = error;
+                        if (i === providers.length - 1)
+                            break;
+                        if (!shouldFallback(error))
+                            break;
+                        onFallback?.(i, i + 1, error);
+                    }
+                }
+                throw lastError;
+            }
+            : undefined,
+    };
+}
+exports.fallbackProvider = fallbackProvider;
+//# sourceMappingURL=fallbackProvider.js.map

package/dist/adapters/fallbackProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallbackProvider.js","sourceRoot":"","sources":["../../src/adapters/fallbackProvider.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;;;AAYH,SAAgB,gBAAgB,CAC9B,SAAiC,EACjC,OAAiC;IAEjC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,EAAE,UAAU,EAAE,cAAc,GAAG,GAAG,EAAE,CAAC,IAAI,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IAElE,OAAO;QACL,IAAI,EAAE,KAAK,EAAE,QAAmB,EAAE,WAA4B,EAAwB,EAAE;YACtF,IAAI,SAAkB,CAAC;YAEvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC1C,IAAI,CAAC;oBACH,OAAO,MAAM,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;gBACxD,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,SAAS,GAAG,KAAK,CAAC;oBAElB,oCAAoC;oBACpC,IAAI,CAAC,KAAK,SAAS,CAAC,MAAM,GAAG,CAAC;wBAAE,MAAM;oBAEtC,+BAA+B;oBAC/B,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC;wBAAE,MAAM;oBAElC,yDAAyD;oBACzD,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC;YAED,8CAA8C;YAC9C,MAAM,SAAS,CAAC;QAClB,CAAC;QAED,iCAAiC;QACjC,UAAU,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;YAC7C,CAAC,CAAC,KAAK,SAAS,CAAC,EAAE,QAAmB,EAAE,WAA4B;gBAChE,IAAI,SAAkB,CAAC;gBAEvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBAC1C,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;oBAC9B,IAAI,CAAC,QAAQ,CAAC,UAAU;wBAAE,SAAS;oBAEnC,IAAI,CAAC;wBACH,KAAK,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;wBAClD,OAAO,CAAC,wBAAwB;oBAClC,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,SAAS,GAAG,KAAK,CAAC;wBAClB,IAAI,CAAC,KAAK,SAAS,CAAC,MAAM,GAAG,CAAC;4BAAE,MAAM;wBACtC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC;4BAAE,MAAM;wBAClC,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;oBAChC,CAAC;gBACH,CAAC;gBAED,MAAM,SAAS,CAAC;YAClB,CAAC;YACH,CAAC,CAAC,SAAS;KACd,CAAC;AACJ,CAAC;AA3DD,4CA2DC"}

package/dist/adapters/index.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isLLMProvider = exports.resolveProvider = exports.createProvider = exports.resilientProvider = exports.fallbackProvider = exports.BrowserOpenAIAdapter = exports.BrowserAnthropicAdapter = exports.BedrockAdapter = exports.OpenAIAdapter = exports.AnthropicAdapter = exports.a2aRunner = exports.mcpToolProvider = exports.createAdapterSubflow = exports.mockRetriever = exports.MockRetriever = exports.mock = exports.MockAdapter = exports.postgresStore = exports.dynamoStore = exports.redisStore = exports.InMemoryStore = void 0;
+var inMemory_1 = require("./memory/inMemory");
+Object.defineProperty(exports, "InMemoryStore", { enumerable: true, get: function () { return inMemory_1.InMemoryStore; } });
+var stores_1 = require("./memory/stores");
+Object.defineProperty(exports, "redisStore", { enumerable: true, get: function () { return stores_1.redisStore; } });
+Object.defineProperty(exports, "dynamoStore", { enumerable: true, get: function () { return stores_1.dynamoStore; } });
+Object.defineProperty(exports, "postgresStore", { enumerable: true, get: function () { return stores_1.postgresStore; } });
+// ── Mock Adapters ────────────────────────────────────────────
+var MockAdapter_1 = require("./mock/MockAdapter");
+Object.defineProperty(exports, "MockAdapter", { enumerable: true, get: function () { return MockAdapter_1.MockAdapter; } });
+Object.defineProperty(exports, "mock", { enumerable: true, get: function () { return MockAdapter_1.mock; } });
+var MockRetriever_1 = require("./mock/MockRetriever");
+Object.defineProperty(exports, "MockRetriever", { enumerable: true, get: function () { return MockRetriever_1.MockRetriever; } });
+Object.defineProperty(exports, "mockRetriever", { enumerable: true, get: function () { return MockRetriever_1.mockRetriever; } });
+// ── Adapter Subflow ─────────────────────────────────────────
+var createAdapterSubflow_1 = require("./createAdapterSubflow");
+Object.defineProperty(exports, "createAdapterSubflow", { enumerable: true, get: function () { return createAdapterSubflow_1.createAdapterSubflow; } });
+// ── Protocol Adapters ───────────────────────────────────────
+var mcpToolProvider_1 = require("./mcp/mcpToolProvider");
+Object.defineProperty(exports, "mcpToolProvider", { enumerable: true, get: function () { return mcpToolProvider_1.mcpToolProvider; } });
+var a2aRunner_1 = require("./a2a/a2aRunner");
+Object.defineProperty(exports, "a2aRunner", { enumerable: true, get: function () { return a2aRunner_1.a2aRunner; } });
+// ── LLM Provider Adapters ───────────────────────────────────
+var AnthropicAdapter_1 = require("./anthropic/AnthropicAdapter");
+Object.defineProperty(exports, "AnthropicAdapter", { enumerable: true, get: function () { return AnthropicAdapter_1.AnthropicAdapter; } });
+var OpenAIAdapter_1 = require("./openai/OpenAIAdapter");
+Object.defineProperty(exports, "OpenAIAdapter", { enumerable: true, get: function () { return OpenAIAdapter_1.OpenAIAdapter; } });
+var BedrockAdapter_1 = require("./bedrock/BedrockAdapter");
+Object.defineProperty(exports, "BedrockAdapter", { enumerable: true, get: function () { return BedrockAdapter_1.BedrockAdapter; } });
+// ── Browser LLM Adapters (fetch-based, zero deps) ──────────
+var BrowserAnthropicAdapter_1 = require("./browser/BrowserAnthropicAdapter");
+Object.defineProperty(exports, "BrowserAnthropicAdapter", { enumerable: true, get: function () { return BrowserAnthropicAdapter_1.BrowserAnthropicAdapter; } });
+var BrowserOpenAIAdapter_1 = require("./browser/BrowserOpenAIAdapter");
+Object.defineProperty(exports, "BrowserOpenAIAdapter", { enumerable: true, get: function () { return BrowserOpenAIAdapter_1.BrowserOpenAIAdapter; } });
+// ── Provider Composition ───────────────────────────────────
+var fallbackProvider_1 = require("./fallbackProvider");
+Object.defineProperty(exports, "fallbackProvider", { enumerable: true, get: function () { return fallbackProvider_1.fallbackProvider; } });
+var resilientProvider_1 = require("./resilientProvider");
+Object.defineProperty(exports, "resilientProvider", { enumerable: true, get: function () { return resilientProvider_1.resilientProvider; } });
+// ── Provider Bridge ─────────────────────────────────────────
+var createProvider_1 = require("./createProvider");
+Object.defineProperty(exports, "createProvider", { enumerable: true, get: function () { return createProvider_1.createProvider; } });
+Object.defineProperty(exports, "resolveProvider", { enumerable: true, get: function () { return createProvider_1.resolveProvider; } });
+Object.defineProperty(exports, "isLLMProvider", { enumerable: true, get: function () { return createProvider_1.isLLMProvider; } });
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":";;;AAEA,8CAAkD;AAAzC,yGAAA,aAAa,OAAA;AACtB,0CAAyE;AAAhE,oGAAA,UAAU,OAAA;AAAE,qGAAA,WAAW,OAAA;AAAE,uGAAA,aAAa,OAAA;AAG/C,gEAAgE;AAChE,kDAAuD;AAA9C,0GAAA,WAAW,OAAA;AAAE,mGAAA,IAAI,OAAA;AAE1B,sDAAoE;AAA3D,8GAAA,aAAa,OAAA;AAAE,8GAAA,aAAa,OAAA;AAGrC,+DAA+D;AAC/D,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA;AAG7B,+DAA+D;AAC/D,yDAAwD;AAA/C,kHAAA,eAAe,OAAA;AAOxB,6CAA4C;AAAnC,sGAAA,SAAS,OAAA;AAGlB,+DAA+D;AAC/D,iEAAgE;AAAvD,oHAAA,gBAAgB,OAAA;AAEzB,wDAAuD;AAA9C,8GAAA,aAAa,OAAA;AAEtB,2DAA0D;AAAjD,gHAAA,cAAc,OAAA;AAGvB,8DAA8D;AAC9D,6EAA4E;AAAnE,kIAAA,uBAAuB,OAAA;AAEhC,uEAAsE;AAA7D,4HAAA,oBAAoB,OAAA;AAG7B,8DAA8D;AAC9D,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AAEzB,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAG1B,+DAA+D;AAC/D,mDAAkF;AAAzE,gHAAA,cAAc,OAAA;AAAE,iHAAA,eAAe,OAAA;AAAE,+GAAA,aAAa,OAAA"}

package/dist/adapters/mcp/mcpToolProvider.js

@@ -0,0 +1,44 @@
+"use strict";
+/**
+ * mcpToolProvider — wraps an MCP server as a ToolProvider.
+ *
+ * MCP (Model Context Protocol) exposes tools from external servers.
+ * This adapter bridges MCP's tool interface to agentfootprint's ToolProvider,
+ * enabling agents to use MCP tools without knowing the protocol.
+ *
+ * The adapter accepts an MCPClient interface (transport-agnostic).
+ * Users provide their own MCP client implementation — this adapter
+ * only handles the ToolProvider mapping.
+ *
+ * Usage:
+ *   const tools = mcpToolProvider({ client: myMcpClient });
+ *   const agent = Agent.create({ provider }).build();
+ *   // Agent can now call MCP tools
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mcpToolProvider = void 0;
+function mcpToolProvider(options) {
+    const { client, prefix = '' } = options;
+    return {
+        resolve: async () => {
+            const tools = await client.listTools();
+            const value = tools.map((t) => ({
+                name: prefix + t.name,
+                description: t.description ?? '',
+                inputSchema: t.inputSchema ?? {},
+            }));
+            return { value, chosen: 'mcp', rationale: `${value.length} tools from MCP server` };
+        },
+        execute: async (call, _signal) => {
+            // Strip prefix to get original tool name
+            const toolName = prefix ? call.name.slice(prefix.length) : call.name;
+            const result = await client.callTool(toolName, call.arguments);
+            return {
+                content: result.content,
+                error: result.isError,
+            };
+        },
+    };
+}
+exports.mcpToolProvider = mcpToolProvider;
+//# sourceMappingURL=mcpToolProvider.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcpToolProvider.js","sourceRoot":"","sources":["../../../src/adapters/mcp/mcpToolProvider.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;AAmCH,SAAgB,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;AAxBD,0CAwBC"}

package/dist/adapters/memory/inMemory.js

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * InMemoryStore — ConversationStore implementation backed by a plain Map.
+ *
+ * For testing and development only. Data does not survive process restarts.
+ * Use a real backend (Redis, Postgres, DynamoDB) in production.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryStore = void 0;
+class InMemoryStore {
+    conversations = new Map();
+    load(conversationId) {
+        const stored = this.conversations.get(conversationId);
+        return stored ? [...stored] : [];
+    }
+    save(conversationId, messages) {
+        // Shallow copy — prevent external mutation of stored array
+        this.conversations.set(conversationId, [...messages]);
+    }
+    /** Return all conversation IDs currently in store. */
+    ids() {
+        return Array.from(this.conversations.keys());
+    }
+    /** Return number of messages stored for a conversation. */
+    size(conversationId) {
+        return this.conversations.get(conversationId)?.length ?? 0;
+    }
+    /** Clear a specific conversation. */
+    delete(conversationId) {
+        this.conversations.delete(conversationId);
+    }
+    /** Clear all stored conversations. */
+    clear() {
+        this.conversations.clear();
+    }
+}
+exports.InMemoryStore = InMemoryStore;
+//# sourceMappingURL=inMemory.js.map

package/dist/adapters/memory/inMemory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inMemory.js","sourceRoot":"","sources":["../../../src/adapters/memory/inMemory.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAKH,MAAa,aAAa;IACP,aAAa,GAAG,IAAI,GAAG,EAAqB,CAAC;IAE9D,IAAI,CAAC,cAAsB;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACtD,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACnC,CAAC;IAED,IAAI,CAAC,cAAsB,EAAE,QAAmB;QAC9C,2DAA2D;QAC3D,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,sDAAsD;IACtD,GAAG;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,2DAA2D;IAC3D,IAAI,CAAC,cAAsB;QACzB,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;IAC7D,CAAC;IAED,qCAAqC;IACrC,MAAM,CAAC,cAAsB;QAC3B,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IAC5C,CAAC;IAED,sCAAsC;IACtC,KAAK;QACH,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;CACF;AAhCD,sCAgCC"}

package/dist/adapters/memory/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryStore = void 0;
+var inMemory_1 = require("./inMemory");
+Object.defineProperty(exports, "InMemoryStore", { enumerable: true, get: function () { return inMemory_1.InMemoryStore; } });
+//# sourceMappingURL=index.js.map

package/dist/adapters/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/memory/index.ts"],"names":[],"mappings":";;;AACA,uCAA2C;AAAlC,yGAAA,aAAa,OAAA"}

package/dist/adapters/memory/stores.js

@@ -0,0 +1,137 @@
+"use strict";
+/**
+ * Memory store adapter factories — consumer brings their own client.
+ *
+ * Zero new dependencies. Each factory wraps the consumer's client instance
+ * into a ConversationStore that implements load() + save().
+ *
+ * @example Redis
+ * ```typescript
+ * import Redis from 'ioredis';
+ * import { redisStore } from 'agentfootprint';
+ *
+ * const store = redisStore(new Redis(), { ttlSeconds: 3600 });
+ * agent.memory({ store, conversationId: 'session-123' });
+ * ```
+ *
+ * @example DynamoDB
+ * ```typescript
+ * import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
+ * import { dynamoStore } from 'agentfootprint';
+ *
+ * const store = dynamoStore(new DynamoDBClient({}), { tableName: 'conversations' });
+ * agent.memory({ store, conversationId: 'session-123' });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.postgresStore = exports.dynamoStore = exports.redisStore = void 0;
+/**
+ * Create a ConversationStore backed by Redis.
+ * Consumer provides their own Redis client (ioredis, redis, etc.).
+ */
+function redisStore(client, options) {
+    const prefix = options?.prefix ?? 'agentfp:conv:';
+    const ttl = options?.ttlSeconds;
+    const hasTtl = ttl !== undefined && ttl !== null;
+    return {
+        async load(conversationId) {
+            const data = await client.get(`${prefix}${conversationId}`);
+            if (!data)
+                return null;
+            try {
+                return JSON.parse(data);
+            }
+            catch {
+                return null;
+            }
+        },
+        async save(conversationId, messages) {
+            const key = `${prefix}${conversationId}`;
+            const value = JSON.stringify(messages);
+            try {
+                if (hasTtl) {
+                    // ioredis: set(key, value, 'EX', ttl) — node-redis v4: set(key, value, { EX: ttl })
+                    // Try options object first (node-redis v4), fall back to variadic (ioredis)
+                    try {
+                        await client.set(key, value, { EX: ttl });
+                    }
+                    catch {
+                        await client.set(key, value, 'EX', ttl);
+                    }
+                }
+                else {
+                    await client.set(key, value);
+                }
+            }
+            catch { /* fire-and-forget — ConversationStore contract */ }
+        },
+    };
+}
+exports.redisStore = redisStore;
+/**
+ * Create a ConversationStore backed by DynamoDB.
+ * Consumer provides a thin wrapper around their DynamoDB client.
+ */
+function dynamoStore(client, options) {
+    const { tableName, partitionKey = 'id' } = options;
+    return {
+        async load(conversationId) {
+            try {
+                const item = await client.get(tableName, { [partitionKey]: conversationId });
+                if (!item)
+                    return null;
+                const data = item.messages;
+                if (typeof data === 'string')
+                    return JSON.parse(data);
+                if (Array.isArray(data))
+                    return data;
+                return null;
+            }
+            catch {
+                return null;
+            }
+        },
+        async save(conversationId, messages) {
+            try {
+                await client.put(tableName, {
+                    [partitionKey]: conversationId,
+                    messages: JSON.stringify(messages),
+                    updatedAt: Date.now(),
+                });
+            }
+            catch { /* fire-and-forget — ConversationStore contract */ }
+        },
+    };
+}
+exports.dynamoStore = dynamoStore;
+/**
+ * Create a ConversationStore backed by PostgreSQL.
+ * Consumer provides their own pg client/pool.
+ *
+ * Expects table: CREATE TABLE conversations (id TEXT PRIMARY KEY, messages JSONB, updated_at TIMESTAMPTZ DEFAULT NOW());
+ */
+const SAFE_TABLE_NAME = /^[a-zA-Z_][a-zA-Z0-9_]{0,63}$/;
+function postgresStore(client, options) {
+    const table = options?.tableName ?? 'conversations';
+    if (!SAFE_TABLE_NAME.test(table)) {
+        throw new Error(`Invalid table name "${table}". Use alphanumeric + underscore only.`);
+    }
+    return {
+        async load(conversationId) {
+            const result = await client.query(`SELECT messages FROM ${table} WHERE id = $1`, [conversationId]);
+            if (result.rows.length === 0)
+                return null;
+            const row = result.rows[0];
+            return row.messages;
+        },
+        async save(conversationId, messages) {
+            try {
+                await client.query(`INSERT INTO ${table} (id, messages, updated_at) VALUES ($1, $2, NOW())
+           ON CONFLICT (id) DO UPDATE SET messages = $2, updated_at = NOW()`, [conversationId, JSON.stringify(messages)]);
+            }
+            catch { /* fire-and-forget — ConversationStore contract */ }
+        },
+    };
+}
+exports.postgresStore = postgresStore;
+//# sourceMappingURL=stores.js.map

package/dist/adapters/memory/stores.js.map

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

package/dist/adapters/memory/types.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * Memory adapter types — ConversationStore interface for persistent conversation history.
+ *
+ * ConversationStore is the persistence adapter: it defines WHERE messages are stored.
+ * Implement this interface to plug in Redis, Postgres, DynamoDB, localStorage,
+ * or any other backend. The library ships with InMemoryStore for testing.
+ *
+ * This is the memory equivalent of LLMProvider — same adapter-swap story:
+ *   - Swap mock ↔ real adapter without changing agent logic
+ *   - Swap InMemoryStore ↔ RedisStore without touching flowchart stages
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/adapters/memory/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/adapters/memory/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG"}