agentfootprint 1.0.0

package/dist/tools/ToolRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolRegistry.js","sourceRoot":"","sources":["../../src/tools/ToolRegistry.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAGH,uDAAiE;AAEjE,MAAa,YAAY;IACN,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;IAE3D,wDAAwD;IACxD,QAAQ,CAAC,IAAoB;QAC3B,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,CAAC,EAAE,sBAAsB,CAAC,CAAC;QACxE,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wBAAwB;IACxB,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,qCAAqC;IACrC,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,mCAAmC;IACnC,GAAG;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,gCAAgC;IAChC,GAAG;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,wEAAwE;IACxE,YAAY,CAAC,OAAkB;QAC7B,MAAM,KAAK,GAAG,OAAO;YACnB,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;gBACjB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAChC,IAAI,CAAC,IAAI;oBAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,EAAE,aAAa,CAAC,CAAC;gBACnE,OAAO,IAAI,CAAC;YACd,CAAC,CAAC;YACJ,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QAEf,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC1B,IAAI,EAAE,IAAI,CAAC,EAAE;YACb,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC,CAAC,CAAC;IACN,CAAC;IAED,kCAAkC;IAClC,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF;AArDD,oCAqDC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,SAAgB,UAAU,CAAC,IAAoB;IAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC;IAEhC,iEAAiE;IACjE,IAAI,IAAA,6BAAW,EAAC,MAAM,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,IAAA,iCAAe,EAAC,MAAa,CAAC,EAAE,CAAC;IAClE,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AATD,gCASC"}

package/dist/tools/askHuman.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * askHuman — Built-in tool that pauses the agent loop for human input.
+ *
+ * When the LLM calls this tool, the agent loop pauses and creates a checkpoint.
+ * The human's response is provided via agent.resume(), which continues the loop
+ * with the answer as the tool result.
+ *
+ * @example
+ * ```typescript
+ * const agent = Agent.create({ provider })
+ *   .system('You are helpful. Use ask_human when you need clarification.')
+ *   .tool(askHuman())
+ *   .build();
+ *
+ * const result = await agent.run('Process my refund');
+ * if (result.paused) {
+ *   console.log(result.pauseData.question); // "What is your order ID?"
+ *   const final = await agent.resume('ORD-123');
+ * }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askHuman = exports.isAskHumanResult = exports.ASK_HUMAN_MARKER = void 0;
+/** Marker on ToolResult indicating this is an ask_human pause. Not globally reachable — only importable from this module. */
+exports.ASK_HUMAN_MARKER = Symbol('askHuman');
+/** Check if a tool result is an ask_human pause. */
+function isAskHumanResult(result) {
+    return (typeof result === 'object' &&
+        result !== null &&
+        Object.getOwnPropertySymbols(result).includes(exports.ASK_HUMAN_MARKER) &&
+        result[exports.ASK_HUMAN_MARKER] === true);
+}
+exports.isAskHumanResult = isAskHumanResult;
+/**
+ * Create the ask_human tool definition.
+ *
+ * @param description - Custom description for the LLM (optional).
+ */
+function askHuman(description) {
+    return {
+        id: 'ask_human',
+        description: description ??
+            'Ask the human user a question. Use this when you need clarification, approval, or any input from the user before proceeding.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                question: {
+                    type: 'string',
+                    description: 'The question to ask the human.',
+                },
+            },
+            required: ['question'],
+        },
+        handler: async (input) => {
+            const question = String(input.question ?? '');
+            // Return a marked result — the tool execution stage detects this and pauses.
+            // The content is a placeholder; it gets replaced with the human's actual response on resume.
+            return {
+                content: `[Waiting for human response to: "${question}"]`,
+                question,
+                [exports.ASK_HUMAN_MARKER]: true,
+            };
+        },
+    };
+}
+exports.askHuman = askHuman;
+//# sourceMappingURL=askHuman.js.map

package/dist/tools/askHuman.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"askHuman.js","sourceRoot":"","sources":["../../src/tools/askHuman.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAIH,6HAA6H;AAChH,QAAA,gBAAgB,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;AASnD,oDAAoD;AACpD,SAAgB,gBAAgB,CAAC,MAAkB;IACjD,OAAO,CACL,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,MAAM,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,wBAAgB,CAAC;QAC9D,MAA6C,CAAC,wBAAgB,CAAC,KAAK,IAAI,CAC1E,CAAC;AACJ,CAAC;AAPD,4CAOC;AAED;;;;GAIG;AACH,SAAgB,QAAQ,CAAC,WAAoB;IAC3C,OAAO;QACL,EAAE,EAAE,WAAW;QACf,WAAW,EACT,WAAW;YACX,8HAA8H;QAChI,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,gCAAgC;iBAC9C;aACF;YACD,QAAQ,EAAE,CAAC,UAAU,CAAC;SACvB;QACD,OAAO,EAAE,KAAK,EAAE,KAA8B,EAA2B,EAAE;YACzE,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;YAC9C,6EAA6E;YAC7E,6FAA6F;YAC7F,OAAO;gBACL,OAAO,EAAE,oCAAoC,QAAQ,IAAI;gBACzD,QAAQ;gBACR,CAAC,wBAAgB,CAAC,EAAE,IAAI;aACzB,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AA3BD,4BA2BC"}

package/dist/tools/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askHuman = exports.defineTool = exports.ToolRegistry = void 0;
+var ToolRegistry_1 = require("./ToolRegistry");
+Object.defineProperty(exports, "ToolRegistry", { enumerable: true, get: function () { return ToolRegistry_1.ToolRegistry; } });
+Object.defineProperty(exports, "defineTool", { enumerable: true, get: function () { return ToolRegistry_1.defineTool; } });
+var askHuman_1 = require("./askHuman");
+Object.defineProperty(exports, "askHuman", { enumerable: true, get: function () { return askHuman_1.askHuman; } });
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";;;AAAA,+CAA0D;AAAjD,4GAAA,YAAY,OAAA;AAAE,0GAAA,UAAU,OAAA;AACjC,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA"}

package/dist/tools/validateInput.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * validateToolInput — lightweight JSON Schema validation for tool arguments.
+ *
+ * Validates LLM-provided tool arguments against the tool's inputSchema
+ * before calling the handler. Catches malformed arguments early with
+ * a clear error message fed back to the LLM.
+ *
+ * Supports: required fields, type checking (string, number, boolean, object, array).
+ * Does NOT support: $ref, oneOf, allOf, pattern, min/max, nested validation.
+ * For complex schemas, use a full validator (Ajv) in the handler.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatValidationErrors = exports.validateToolInput = void 0;
+/**
+ * Validate tool arguments against a JSON Schema.
+ * Returns { valid: true } or { valid: false, errors: [...] }.
+ */
+function validateToolInput(args, schema) {
+    const errors = [];
+    // Check required fields
+    const required = schema.required;
+    if (Array.isArray(required)) {
+        for (const field of required) {
+            if (args[field] === undefined || args[field] === null) {
+                errors.push({ path: field, message: `Required field '${field}' is missing.` });
+            }
+        }
+    }
+    // Check property types
+    const properties = schema.properties;
+    if (properties) {
+        for (const [key, prop] of Object.entries(properties)) {
+            const value = args[key];
+            if (value === undefined || value === null)
+                continue; // Skip optional missing fields
+            if (prop.type) {
+                const expectedType = prop.type;
+                const actualType = Array.isArray(value) ? 'array' : typeof value;
+                if (expectedType === 'integer') {
+                    if (typeof value !== 'number' || !Number.isInteger(value)) {
+                        errors.push({ path: key, message: `Expected integer for '${key}', got ${actualType}.` });
+                    }
+                }
+                else if (expectedType !== actualType) {
+                    errors.push({ path: key, message: `Expected ${expectedType} for '${key}', got ${actualType}.` });
+                }
+            }
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+exports.validateToolInput = validateToolInput;
+/**
+ * Format validation errors as a string for the LLM tool result.
+ */
+function formatValidationErrors(errors) {
+    return errors.map((e) => `${e.path}: ${e.message}`).join('; ');
+}
+exports.formatValidationErrors = formatValidationErrors;
+//# sourceMappingURL=validateInput.js.map

package/dist/tools/validateInput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateInput.js","sourceRoot":"","sources":["../../src/tools/validateInput.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAYH;;;GAGG;AACH,SAAgB,iBAAiB,CAC/B,IAA6B,EAC7B,MAA+B;IAE/B,MAAM,MAAM,GAAsB,EAAE,CAAC;IAErC,wBAAwB;IACxB,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAgC,CAAC;IACzD,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;gBACtD,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,mBAAmB,KAAK,eAAe,EAAE,CAAC,CAAC;YACjF,CAAC;QACH,CAAC;IACH,CAAC;IAED,uBAAuB;IACvB,MAAM,UAAU,GAAG,MAAM,CAAC,UAA2D,CAAC;IACtF,IAAI,UAAU,EAAE,CAAC;QACf,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YACrD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;YACxB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;gBAAE,SAAS,CAAC,+BAA+B;YAEpF,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC;gBAC/B,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC;gBAEjE,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;oBAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;wBAC1D,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,yBAAyB,GAAG,UAAU,UAAU,GAAG,EAAE,CAAC,CAAC;oBAC3F,CAAC;gBACH,CAAC;qBAAM,IAAI,YAAY,KAAK,UAAU,EAAE,CAAC;oBACvC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,YAAY,YAAY,SAAS,GAAG,UAAU,UAAU,GAAG,EAAE,CAAC,CAAC;gBACnG,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC;AAvCD,8CAuCC;AAED;;GAEG;AACH,SAAgB,sBAAsB,CAAC,MAAkC;IACvE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjE,CAAC;AAFD,wDAEC"}

package/dist/tools/zodToJsonSchema.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isZodSchema = exports.zodToJsonSchema = void 0;
+/**
+ * Minimal Zod-to-JSON-Schema converter. Duck-typed — no zod dependency.
+ * Handles: object, string, number, boolean, array, enum, optional, default.
+ * @internal
+ */
+function zodToJsonSchema(zodSchema) {
+    const def = zodSchema._def;
+    if (!def)
+        return { type: 'object' };
+    switch (def.typeName) {
+        case 'ZodObject': {
+            const shape = zodSchema.shape;
+            const properties = {};
+            const required = [];
+            for (const [key, value] of Object.entries(shape)) {
+                properties[key] = zodToJsonSchema(value);
+                if (value._def?.typeName !== 'ZodOptional') {
+                    required.push(key);
+                }
+            }
+            return {
+                type: 'object',
+                properties,
+                ...(required.length > 0 ? { required } : {}),
+            };
+        }
+        case 'ZodString': {
+            const r = { type: 'string' };
+            if (def.description)
+                r.description = def.description;
+            return r;
+        }
+        case 'ZodNumber': {
+            const r = { type: 'number' };
+            if (def.description)
+                r.description = def.description;
+            return r;
+        }
+        case 'ZodBoolean':
+            return { type: 'boolean' };
+        case 'ZodArray':
+            return { type: 'array', items: zodToJsonSchema(def.type) };
+        case 'ZodEnum':
+            return { type: 'string', enum: def.values };
+        case 'ZodOptional':
+            return zodToJsonSchema(def.innerType);
+        case 'ZodDefault':
+            return zodToJsonSchema(def.innerType);
+        case 'ZodNullable': {
+            const inner = zodToJsonSchema(def.innerType);
+            return { ...inner, nullable: true };
+        }
+        case 'ZodLiteral':
+            return { const: def.value };
+        default:
+            return {};
+    }
+}
+exports.zodToJsonSchema = zodToJsonSchema;
+/** Duck-type check: is this a Zod schema? */
+function isZodSchema(value) {
+    return typeof value === 'object' && value !== null
+        && typeof value.safeParse === 'function'
+        && value._def !== undefined;
+}
+exports.isZodSchema = isZodSchema;
+//# sourceMappingURL=zodToJsonSchema.js.map

package/dist/tools/zodToJsonSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zodToJsonSchema.js","sourceRoot":"","sources":["../../src/tools/zodToJsonSchema.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,SAAgB,eAAe,CAAC,SAAc;IAC5C,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC;IAC3B,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAEpC,QAAQ,GAAG,CAAC,QAAQ,EAAE,CAAC;QACrB,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC;YAC9B,MAAM,UAAU,GAA4B,EAAE,CAAC;YAC/C,MAAM,QAAQ,GAAa,EAAE,CAAC;YAE9B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjD,UAAU,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,KAAY,CAAC,CAAC;gBAChD,IAAK,KAAa,CAAC,IAAI,EAAE,QAAQ,KAAK,aAAa,EAAE,CAAC;oBACpD,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACrB,CAAC;YACH,CAAC;YAED,OAAO;gBACL,IAAI,EAAE,QAAQ;gBACd,UAAU;gBACV,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC7C,CAAC;QACJ,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,CAAC,GAA4B,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;YACtD,IAAI,GAAG,CAAC,WAAW;gBAAE,CAAC,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;YACrD,OAAO,CAAC,CAAC;QACX,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,CAAC,GAA4B,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;YACtD,IAAI,GAAG,CAAC,WAAW;gBAAE,CAAC,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;YACrD,OAAO,CAAC,CAAC;QACX,CAAC;QACD,KAAK,YAAY;YACf,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC7B,KAAK,UAAU;YACb,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7D,KAAK,SAAS;YACZ,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;QAC9C,KAAK,aAAa;YAChB,OAAO,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACxC,KAAK,YAAY;YACf,OAAO,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACxC,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC7C,OAAO,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACtC,CAAC;QACD,KAAK,YAAY;YACf,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC;QAC9B;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AApDD,0CAoDC;AAED,6CAA6C;AAC7C,SAAgB,WAAW,CAAC,KAAc;IACxC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;WAC7C,OAAQ,KAAa,CAAC,SAAS,KAAK,UAAU;WAC7C,KAAa,CAAC,IAAI,KAAK,SAAS,CAAC;AACzC,CAAC;AAJD,kCAIC"}

package/dist/types/adapter.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * Adapter result — discriminated union for provider responses.
+ * Adapters normalize any provider's response into one of these shapes.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ADAPTER_PATHS = void 0;
+/** Well-known scope paths for adapter stages. */
+exports.ADAPTER_PATHS = {
+    REQUEST: 'adapterRequest',
+    RESPONSE: 'adapterRawResponse',
+    RESULT: 'adapterResult',
+};
+//# sourceMappingURL=adapter.js.map

package/dist/types/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/types/adapter.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAgCH,iDAAiD;AACpC,QAAA,aAAa,GAAG;IAC3B,OAAO,EAAE,gBAAgB;IACzB,QAAQ,EAAE,oBAAoB;IAC9B,MAAM,EAAE,eAAe;CACf,CAAC"}

package/dist/types/adapters/a2a/a2aRunner.d.ts

@@ -0,0 +1,40 @@
+/**
+ * a2aRunner — wraps an A2A (Agent-to-Agent) endpoint as a RunnerLike.
+ *
+ * A2A protocol enables agents to communicate across services.
+ * This adapter bridges the A2A interface to agentfootprint's RunnerLike,
+ * enabling composition in FlowChart, Swarm, or agentAsTool.
+ *
+ * The adapter accepts an A2AClient interface (transport-agnostic).
+ * Users provide their own A2A client implementation.
+ *
+ * Usage:
+ *   const remoteAgent = a2aRunner({
+ *     client: myA2AClient,
+ *     agentId: 'research-agent',
+ *   });
+ *   const pipeline = FlowChart.create()
+ *     .agent('remote-research', 'Research', remoteAgent)
+ *     .build();
+ */
+import type { RunnerLike } from '../../types/multiAgent';
+/** Minimal A2A client interface. Users bring their own implementation. */
+export interface A2AClient {
+    /** Send a message to an agent and get a response. */
+    sendMessage(agentId: string, message: string, options?: {
+        signal?: AbortSignal;
+        timeoutMs?: number;
+    }): Promise<A2AResponse>;
+}
+export interface A2AResponse {
+    readonly content: string;
+    readonly metadata?: Record<string, unknown>;
+}
+export interface A2ARunnerOptions {
+    /** A2A client instance. */
+    readonly client: A2AClient;
+    /** ID of the remote agent. */
+    readonly agentId: string;
+}
+export declare function a2aRunner(options: A2ARunnerOptions): RunnerLike;
+//# sourceMappingURL=a2aRunner.d.ts.map

package/dist/types/adapters/a2a/a2aRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2aRunner.d.ts","sourceRoot":"","sources":["../../../../src/adapters/a2a/a2aRunner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAIzD,0EAA0E;AAC1E,MAAM,WAAW,SAAS;IACxB,qDAAqD;IACrD,WAAW,CACT,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GACrD,OAAO,CAAC,WAAW,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAID,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,UAAU,CAY/D"}

package/dist/types/adapters/anthropic/AnthropicAdapter.d.ts

@@ -0,0 +1,37 @@
+/**
+ * AnthropicAdapter — wraps @anthropic-ai/sdk as an LLMProvider.
+ *
+ * Requires: npm install @anthropic-ai/sdk
+ *
+ * Features:
+ *   - Full chat() + chatStream() support
+ *   - Multi-modal content (text, images, tool_use, tool_result)
+ *   - AbortSignal passthrough for cancellation
+ *   - Normalized LLMError for uniform error handling
+ *
+ * Usage:
+ *   import { AnthropicAdapter } from 'agentfootprint';
+ *   const provider = new AnthropicAdapter({ model: 'claude-sonnet-4-20250514' });
+ *   const agent = Agent.create({ provider }).build();
+ */
+import type { LLMProvider, LLMResponse, LLMCallOptions, LLMStreamChunk, Message } from '../../types';
+export interface AnthropicAdapterOptions {
+    /** Model ID (e.g., 'claude-sonnet-4-20250514'). */
+    readonly model: string;
+    /** API key. Defaults to ANTHROPIC_API_KEY env var. */
+    readonly apiKey?: string;
+    /** Max tokens in response. Default: 4096. */
+    readonly maxTokens?: number;
+    /** @internal Pre-built client for testing. Skips SDK import. */
+    readonly _client?: unknown;
+}
+export declare class AnthropicAdapter implements LLMProvider {
+    private readonly client;
+    private readonly model;
+    private readonly defaultMaxTokens;
+    constructor(options: AnthropicAdapterOptions);
+    chat(messages: Message[], options?: LLMCallOptions): Promise<LLMResponse>;
+    chatStream(messages: Message[], options?: LLMCallOptions): AsyncIterable<LLMStreamChunk>;
+    private buildParams;
+}
+//# sourceMappingURL=AnthropicAdapter.d.ts.map

package/dist/types/adapters/anthropic/AnthropicAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnthropicAdapter.d.ts","sourceRoot":"","sources":["../../../../src/adapters/anthropic/AnthropicAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,cAAc,EACd,cAAc,EACd,OAAO,EAKR,MAAM,aAAa,CAAC;AA6ErB,MAAM,WAAW,uBAAuB;IACtC,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,gEAAgE;IAChE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,qBAAa,gBAAiB,YAAW,WAAW;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;gBAE9B,OAAO,EAAE,uBAAuB;IAsBtC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC;IAWxE,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,aAAa,CAAC,cAAc,CAAC;IAmD/F,OAAO,CAAC,WAAW;CA4CpB"}

package/dist/types/adapters/bedrock/BedrockAdapter.d.ts

@@ -0,0 +1,44 @@
+/**
+ * BedrockAdapter — wraps AWS Bedrock Converse API as an LLMProvider.
+ *
+ * Requires: npm install @aws-sdk/client-bedrock-runtime
+ *
+ * Uses the model-agnostic Converse API, so it works with any Bedrock model
+ * (Claude, Llama, Mistral, Titan, etc.) without format-specific code.
+ *
+ * Features:
+ *   - Full chat() + chatStream() support via ConverseStream
+ *   - Multi-modal content (text, images)
+ *   - AbortSignal passthrough for cancellation
+ *   - Normalized LLMError for uniform error handling
+ *
+ * Usage:
+ *   import { BedrockAdapter } from 'agentfootprint';
+ *   const provider = new BedrockAdapter({
+ *     model: 'anthropic.claude-sonnet-4-20250514-v1:0',
+ *     region: 'us-east-1',
+ *   });
+ */
+import type { LLMProvider, LLMResponse, LLMCallOptions, LLMStreamChunk, Message } from '../../types';
+export interface BedrockAdapterOptions {
+    /** Bedrock model ID (e.g., 'anthropic.claude-sonnet-4-20250514-v1:0'). */
+    readonly model: string;
+    /** AWS region. Defaults to AWS_REGION env var. */
+    readonly region?: string;
+    /** Max tokens in response. Default: 4096. */
+    readonly maxTokens?: number;
+    /** @internal Pre-built client for testing. Skips SDK import. */
+    readonly _client?: unknown;
+}
+export declare class BedrockAdapter implements LLMProvider {
+    private readonly client;
+    private readonly model;
+    private readonly defaultMaxTokens;
+    private ConverseCommand;
+    private ConverseStreamCommand;
+    constructor(options: BedrockAdapterOptions);
+    chat(messages: Message[], options?: LLMCallOptions): Promise<LLMResponse>;
+    chatStream(messages: Message[], options?: LLMCallOptions): AsyncIterable<LLMStreamChunk>;
+    private buildInput;
+}
+//# sourceMappingURL=BedrockAdapter.d.ts.map

package/dist/types/adapters/bedrock/BedrockAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BedrockAdapter.d.ts","sourceRoot":"","sources":["../../../../src/adapters/bedrock/BedrockAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,cAAc,EACd,cAAc,EACd,OAAO,EAKR,MAAM,aAAa,CAAC;AA0ErB,MAAM,WAAW,qBAAqB;IACpC,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,kDAAkD;IAClD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,gEAAgE;IAChE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,qBAAa,cAAe,YAAW,WAAW;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAG1C,OAAO,CAAC,eAAe,CAA+C;IACtE,OAAO,CAAC,qBAAqB,CAA+C;gBAEhE,OAAO,EAAE,qBAAqB;IA6BpC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC;IAYxE,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,aAAa,CAAC,cAAc,CAAC;IA4E/F,OAAO,CAAC,UAAU;CA4BnB"}

package/dist/types/adapters/browser/BrowserAnthropicAdapter.d.ts

@@ -0,0 +1,40 @@
+/**
+ * BrowserAnthropicAdapter — fetch-based Anthropic adapter for browser environments.
+ *
+ * Zero peer dependencies — uses the global fetch() API.
+ * Works in any modern browser. Requires the user's own API key.
+ *
+ * Note: Anthropic requires the `anthropic-dangerous-direct-browser-access` header
+ * to allow direct browser-to-API calls. This is intentional — the user explicitly
+ * provides their own key for prototyping/playground use.
+ *
+ * Usage:
+ *   import { BrowserAnthropicAdapter } from 'agentfootprint';
+ *   const provider = new BrowserAnthropicAdapter({
+ *     apiKey: 'sk-ant-...',
+ *     model: 'claude-sonnet-4-20250514',
+ *   });
+ */
+import type { LLMProvider, LLMResponse, LLMCallOptions, LLMStreamChunk, Message } from '../../types';
+export interface BrowserAnthropicAdapterOptions {
+    /** API key (required for browser use). */
+    readonly apiKey: string;
+    /** Model ID (e.g., 'claude-sonnet-4-20250514'). */
+    readonly model: string;
+    /** Max tokens in response. Default: 4096. */
+    readonly maxTokens?: number;
+    /** Override API URL (e.g., for proxy). */
+    readonly baseURL?: string;
+}
+export declare class BrowserAnthropicAdapter implements LLMProvider {
+    private readonly apiKey;
+    private readonly model;
+    private readonly defaultMaxTokens;
+    private readonly baseURL;
+    constructor(options: BrowserAnthropicAdapterOptions);
+    chat(messages: Message[], options?: LLMCallOptions): Promise<LLMResponse>;
+    chatStream(messages: Message[], options?: LLMCallOptions): AsyncIterable<LLMStreamChunk>;
+    private buildBody;
+    private fetchAPI;
+}
+//# sourceMappingURL=BrowserAnthropicAdapter.d.ts.map

package/dist/types/adapters/browser/BrowserAnthropicAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserAnthropicAdapter.d.ts","sourceRoot":"","sources":["../../../../src/adapters/browser/BrowserAnthropicAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,cAAc,EACd,cAAc,EACd,OAAO,EAKR,MAAM,aAAa,CAAC;AAsDrB,MAAM,WAAW,8BAA8B;IAC7C,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,uBAAwB,YAAW,WAAW;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,8BAA8B;IAO7C,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC;IAQxE,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,aAAa,CAAC,cAAc,CAAC;IA4G/F,OAAO,CAAC,SAAS;YAwCH,QAAQ;CA0CvB"}

package/dist/types/adapters/browser/BrowserOpenAIAdapter.d.ts

@@ -0,0 +1,46 @@
+/**
+ * BrowserOpenAIAdapter — fetch-based OpenAI adapter for browser environments.
+ *
+ * Zero peer dependencies — uses the global fetch() API.
+ * Works in any modern browser. Requires the user's own API key.
+ *
+ * Also works with OpenAI-compatible APIs (Groq, Together, etc.)
+ * by setting the baseURL option.
+ *
+ * Usage:
+ *   import { BrowserOpenAIAdapter } from 'agentfootprint';
+ *   const provider = new BrowserOpenAIAdapter({
+ *     apiKey: 'sk-...',
+ *     model: 'gpt-4o',
+ *   });
+ *
+ *   // Groq (OpenAI-compatible):
+ *   const groq = new BrowserOpenAIAdapter({
+ *     apiKey: 'gsk_...',
+ *     model: 'llama-3.3-70b-versatile',
+ *     baseURL: 'https://api.groq.com/openai/v1/chat/completions',
+ *   });
+ */
+import type { LLMProvider, LLMResponse, LLMCallOptions, LLMStreamChunk, Message } from '../../types';
+export interface BrowserOpenAIAdapterOptions {
+    /** API key (required for browser use). */
+    readonly apiKey: string;
+    /** Model ID (e.g., 'gpt-4o', 'gpt-4o-mini'). */
+    readonly model: string;
+    /** Max tokens in response. */
+    readonly maxTokens?: number;
+    /** Full URL for OpenAI-compatible APIs. Default: OpenAI. */
+    readonly baseURL?: string;
+}
+export declare class BrowserOpenAIAdapter implements LLMProvider {
+    private readonly apiKey;
+    private readonly model;
+    private readonly defaultMaxTokens?;
+    private readonly baseURL;
+    constructor(options: BrowserOpenAIAdapterOptions);
+    chat(messages: Message[], options?: LLMCallOptions): Promise<LLMResponse>;
+    chatStream(messages: Message[], options?: LLMCallOptions): AsyncIterable<LLMStreamChunk>;
+    private buildBody;
+    private fetchAPI;
+}
+//# sourceMappingURL=BrowserOpenAIAdapter.d.ts.map

package/dist/types/adapters/browser/BrowserOpenAIAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserOpenAIAdapter.d.ts","sourceRoot":"","sources":["../../../../src/adapters/browser/BrowserOpenAIAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,cAAc,EACd,cAAc,EACd,OAAO,EAKR,MAAM,aAAa,CAAC;AAwErB,MAAM,WAAW,2BAA2B;IAC1C,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,oBAAqB,YAAW,WAAW;IACtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,2BAA2B;IAO1C,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC;IAQxE,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,aAAa,CAAC,cAAc,CAAC;IA4G/F,OAAO,CAAC,SAAS;YAgBH,QAAQ;CAwCvB"}

package/dist/types/adapters/browser/index.d.ts

@@ -0,0 +1,5 @@
+export { BrowserAnthropicAdapter } from './BrowserAnthropicAdapter';
+export type { BrowserAnthropicAdapterOptions } from './BrowserAnthropicAdapter';
+export { BrowserOpenAIAdapter } from './BrowserOpenAIAdapter';
+export type { BrowserOpenAIAdapterOptions } from './BrowserOpenAIAdapter';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/adapters/browser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/adapters/browser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,YAAY,EAAE,8BAA8B,EAAE,MAAM,2BAA2B,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/types/adapters/createAdapterSubflow.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 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.
+ */
+import type { TypedScope } from 'footprintjs';
+import type { LLMProvider, LLMToolDescription, LLMResponse, Message, AdapterResult } from '../types';
+export interface AdapterSubflowConfig {
+    /** The LLM provider (real or mock). */
+    readonly provider: LLMProvider;
+    /** Adapter ID for narrative. */
+    readonly id?: string;
+}
+/** Internal state shape for the adapter subflow. */
+interface AdapterSubflowState {
+    messages: Message[];
+    toolDescriptions: LLMToolDescription[];
+    adapterRequest: {
+        messages: Message[];
+        tools: LLMToolDescription[];
+    };
+    adapterRawResponse: LLMResponse;
+    adapterResult: AdapterResult;
+}
+/**
+ * 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
+ */
+export declare function createAdapterSubflow(config: AdapterSubflowConfig): import("footprintjs").RunnableFlowChart<any, TypedScope<AdapterSubflowState>>;
+export {};
+//# sourceMappingURL=createAdapterSubflow.d.ts.map

package/dist/types/adapters/createAdapterSubflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAdapterSubflow.d.ts","sourceRoot":"","sources":["../../../src/adapters/createAdapterSubflow.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGrG,MAAM,WAAW,oBAAoB;IACnC,uCAAuC;IACvC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,gCAAgC;IAChC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,oDAAoD;AACpD,UAAU,mBAAmB;IAC3B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,gBAAgB,EAAE,kBAAkB,EAAE,CAAC;IACvC,cAAc,EAAE;QAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QAAC,KAAK,EAAE,kBAAkB,EAAE,CAAA;KAAE,CAAC;IACrE,kBAAkB,EAAE,WAAW,CAAC;IAChC,aAAa,EAAE,aAAa,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,iFAgChE"}

package/dist/types/adapters/createProvider.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 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' }));
+ */
+import type { LLMProvider } from '../types';
+import type { ModelConfig } from '../models';
+/**
+ * Check if the value is already an LLMProvider (has a `.chat` method).
+ * Used for auto-detection in Agent.create(), LLMCall.create(), etc.
+ */
+export declare function isLLMProvider(value: unknown): value is LLMProvider;
+/**
+ * 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().
+ */
+export declare function resolveProvider(providerOrConfig: LLMProvider | ModelConfig): LLMProvider;
+/**
+ * Create an LLMProvider from a ModelConfig.
+ *
+ * Maps provider factories (anthropic(), openai(), ollama(), bedrock())
+ * to their real adapter implementations.
+ */
+export declare function createProvider(config: ModelConfig & {
+    _client?: unknown;
+}): LLMProvider;
+//# sourceMappingURL=createProvider.d.ts.map

package/dist/types/adapters/createProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createProvider.d.ts","sourceRoot":"","sources":["../../../src/adapters/createProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAM7C;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAElE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,gBAAgB,EAAE,WAAW,GAAG,WAAW,GAAG,WAAW,CAGxF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,WAAW,GAAG;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1C,WAAW,CAwDb"}

package/dist/types/adapters/fallbackProvider.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 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;
+ *       },
+ *     },
+ *   );
+ */
+import type { LLMProvider } from '../types/llm';
+export interface FallbackProviderOptions {
+    /** Called when falling back from one provider to the next (during traversal). */
+    onFallback?: (fromIndex: number, toIndex: number, error: unknown) => void;
+    /** Only fall back if this returns true. Default: always fall back. */
+    shouldFallback?: (error: unknown) => boolean;
+}
+export declare function fallbackProvider(providers: readonly LLMProvider[], options?: FallbackProviderOptions): LLMProvider;
+//# sourceMappingURL=fallbackProvider.d.ts.map

package/dist/types/adapters/fallbackProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallbackProvider.d.ts","sourceRoot":"","sources":["../../../src/adapters/fallbackProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,KAAK,EAAE,WAAW,EAA+C,MAAM,cAAc,CAAC;AAG7F,MAAM,WAAW,uBAAuB;IACtC,iFAAiF;IACjF,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC1E,sEAAsE;IACtE,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CAC9C;AAED,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,SAAS,WAAW,EAAE,EACjC,OAAO,CAAC,EAAE,uBAAuB,GAChC,WAAW,CAwDb"}