agentfootprint 1.0.0

package/dist/providers/prompt/template.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * templatePrompt — PromptProvider that interpolates {{variables}} from context.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.templatePrompt = void 0;
+function templatePrompt(template, vars = {}) {
+    return {
+        resolve: (ctx) => {
+            const allVars = {
+                message: ctx.message,
+                turnNumber: ctx.turnNumber,
+                ...vars,
+            };
+            const value = template.replace(/\{\{(\w+)\}\}/g, (_, key) => {
+                const val = allVars[key];
+                return val !== undefined ? String(val) : `{{${key}}}`;
+            });
+            return { value, chosen: 'template' };
+        },
+    };
+}
+exports.templatePrompt = templatePrompt;
+//# sourceMappingURL=template.js.map

package/dist/providers/prompt/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../../src/providers/prompt/template.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAIH,SAAgB,cAAc,CAC5B,QAAgB,EAChB,OAAwC,EAAE;IAE1C,OAAO;QACL,OAAO,EAAE,CAAC,GAAkB,EAAE,EAAE;YAC9B,MAAM,OAAO,GAAoC;gBAC/C,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,GAAG,IAAI;aACR,CAAC;YACF,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;gBAC1D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;gBACzB,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC;YACxD,CAAC,CAAC,CAAC;YACH,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QACvC,CAAC;KACF,CAAC;AACJ,CAAC;AAlBD,wCAkBC"}

package/dist/providers/tools/PermissionPolicy.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * PermissionPolicy — centralized, shareable permission policy for tool gating.
+ *
+ * Addresses the "per-agent, not centralized" con of gatedTools().
+ * Create one policy, share it across multiple agents/swarms.
+ *
+ * Features:
+ *   - grant/revoke at runtime (mid-conversation permission changes)
+ *   - wildcard support ('*' grants all)
+ *   - role-based presets (pass a Set of tool IDs per role)
+ *   - onChange callback for audit/logging
+ *
+ * Usage:
+ *   // Centralized policy — shared across agents
+ *   const policy = new PermissionPolicy(['search', 'calc']);
+ *
+ *   const agent1 = Agent.create({ provider })
+ *     .toolProvider(gatedTools(tools, policy.checker()))
+ *     .build();
+ *
+ *   const agent2 = Agent.create({ provider })
+ *     .toolProvider(gatedTools(otherTools, policy.checker()))
+ *     .build();
+ *
+ *   // Runtime changes — both agents see it immediately
+ *   policy.grant('admin-tool');
+ *   policy.revoke('search');
+ *
+ *   // Role-based
+ *   const policy = PermissionPolicy.fromRoles({
+ *     user: ['search', 'calc'],
+ *     admin: ['search', 'calc', 'delete-user', 'run-code'],
+ *   }, 'user');  // current role
+ *   policy.setRole('admin');  // upgrade mid-conversation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PermissionPolicy = void 0;
+class PermissionPolicy {
+    allowed;
+    onChange;
+    // Role-based state
+    roles;
+    currentRole;
+    constructor(initialAllowed = [], options) {
+        this.allowed = new Set(initialAllowed);
+        this.onChange = options?.onChange;
+    }
+    /**
+     * Create a policy from role definitions.
+     * The active role determines which tools are allowed.
+     */
+    static fromRoles(roles, activeRole, options) {
+        const tools = roles[activeRole] ?? [];
+        const policy = new PermissionPolicy(tools, options);
+        policy.roles = roles;
+        policy.currentRole = activeRole;
+        return policy;
+    }
+    /** Grant access to a tool. Takes effect on next resolve() call. */
+    grant(toolId) {
+        this.allowed.add(toolId);
+        this.onChange?.({ type: 'grant', toolId, allowed: this.getAllowed() });
+        return this;
+    }
+    /** Revoke access to a tool. */
+    revoke(toolId) {
+        this.allowed.delete(toolId);
+        this.onChange?.({ type: 'revoke', toolId, allowed: this.getAllowed() });
+        return this;
+    }
+    /** Switch to a different role (role-based policies only). */
+    setRole(role) {
+        if (!this.roles)
+            throw new Error('[PermissionPolicy] setRole requires fromRoles()');
+        if (!this.roles[role])
+            throw new Error(`[PermissionPolicy] Unknown role: "${role}"`);
+        this.currentRole = role;
+        this.allowed = new Set(this.roles[role]);
+        this.onChange?.({ type: 'role-change', role, allowed: this.getAllowed() });
+        return this;
+    }
+    /** Current role (if using role-based policy). */
+    getRole() {
+        return this.currentRole;
+    }
+    /** Check if a tool is allowed. */
+    isAllowed(toolId) {
+        return this.allowed.has('*') || this.allowed.has(toolId);
+    }
+    /** Get all currently allowed tool IDs. */
+    getAllowed() {
+        return [...this.allowed];
+    }
+    /**
+     * Returns a PermissionChecker compatible with gatedTools().
+     * This is the bridge — create one policy, pass checker() to multiple gatedTools.
+     */
+    checker() {
+        return (toolId) => this.isAllowed(toolId);
+    }
+}
+exports.PermissionPolicy = PermissionPolicy;
+//# sourceMappingURL=PermissionPolicy.js.map

package/dist/providers/tools/PermissionPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PermissionPolicy.js","sourceRoot":"","sources":["../../../src/providers/tools/PermissionPolicy.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;;;AAgBH,MAAa,gBAAgB;IACnB,OAAO,CAAc;IACZ,QAAQ,CAA0C;IAEnE,mBAAmB;IACX,KAAK,CAAqC;IAC1C,WAAW,CAAU;IAE7B,YAAY,iBAAmC,EAAE,EAAE,OAAiC;QAClF,IAAI,CAAC,OAAO,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC;QACvC,IAAI,CAAC,QAAQ,GAAG,OAAO,EAAE,QAAQ,CAAC;IACpC,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,SAAS,CACd,KAAwC,EACxC,UAAkB,EAClB,OAAiC;QAEjC,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACpD,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;QACrB,MAAM,CAAC,WAAW,GAAG,UAAU,CAAC;QAChC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,mEAAmE;IACnE,KAAK,CAAC,MAAc;QAClB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACzB,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QACvE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,+BAA+B;IAC/B,MAAM,CAAC,MAAc;QACnB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5B,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QACxE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,6DAA6D;IAC7D,OAAO,CAAC,IAAY;QAClB,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACpF,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,IAAI,GAAG,CAAC,CAAC;QACrF,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,OAAO,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACzC,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAC3E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,iDAAiD;IACjD,OAAO;QACL,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,kCAAkC;IAClC,SAAS,CAAC,MAAc;QACtB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3D,CAAC;IAED,0CAA0C;IAC1C,UAAU;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,OAAO,CAAC,MAAc,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACpD,CAAC;CACF;AA3ED,4CA2EC"}

package/dist/providers/tools/agentAsTool.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * agentAsTool — wraps a RunnerLike as a ToolDefinition.
+ *
+ * Turns any agent (or runner) into a callable tool. The LLM can invoke it
+ * like any other tool, passing a message. The runner executes and returns
+ * the result as tool output.
+ *
+ * This is the primitive for delegation patterns: an orchestrator agent
+ * can call specialist agents as tools (Swarm handoff, hierarchy, etc.).
+ *
+ * Usage:
+ *   const researchTool = agentAsTool({
+ *     id: 'research',
+ *     description: 'Research a topic in depth.',
+ *     runner: researchAgent,
+ *   });
+ *   const orchestrator = Agent.create({ provider })
+ *     .tool(researchTool)
+ *     .build();
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentAsTool = void 0;
+const DEFAULT_INPUT_SCHEMA = {
+    type: 'object',
+    properties: {
+        message: { type: 'string', description: 'The message to send to the agent.' },
+    },
+    required: ['message'],
+};
+function agentAsTool(config) {
+    const { id, description, runner, inputSchema = DEFAULT_INPUT_SCHEMA, inputMapper = (input) => input.message ?? '', signal, timeoutMs, } = config;
+    return {
+        id,
+        description,
+        inputSchema,
+        handler: async (input) => {
+            try {
+                const message = inputMapper(input);
+                const result = await runner.run(message, { signal, timeoutMs });
+                return { content: result.content };
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                return { content: `Agent error: ${msg}`, error: true };
+            }
+        },
+    };
+}
+exports.agentAsTool = agentAsTool;
+//# sourceMappingURL=agentAsTool.js.map

package/dist/providers/tools/agentAsTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentAsTool.js","sourceRoot":"","sources":["../../../src/providers/tools/agentAsTool.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;AAsBH,MAAM,oBAAoB,GAA4B;IACpD,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mCAAmC,EAAE;KAC9E;IACD,QAAQ,EAAE,CAAC,SAAS,CAAC;CACtB,CAAC;AAEF,SAAgB,WAAW,CAAC,MAAyB;IACnD,MAAM,EACJ,EAAE,EACF,WAAW,EACX,MAAM,EACN,WAAW,GAAG,oBAAoB,EAClC,WAAW,GAAG,CAAC,KAAK,EAAE,EAAE,CAAE,KAAK,CAAC,OAAkB,IAAI,EAAE,EACxD,MAAM,EACN,SAAS,GACV,GAAG,MAAM,CAAC;IAEX,OAAO;QACL,EAAE;QACF,WAAW;QACX,WAAW;QACX,OAAO,EAAE,KAAK,EAAE,KAA8B,EAAuB,EAAE;YACrE,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;gBACnC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;gBAChE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;YACrC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC7D,OAAO,EAAE,OAAO,EAAE,gBAAgB,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;YACzD,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AA1BD,kCA0BC"}

package/dist/providers/tools/compositeTools.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * compositeTools — ToolProvider that merges multiple ToolProviders.
+ *
+ * Resolves all providers and merges their tool lists. If multiple providers
+ * return a tool with the same name, later providers win (last-write-wins).
+ *
+ * Execute delegates to the provider that owns the tool (by resolve order,
+ * last provider that resolved a tool of that name handles execution).
+ *
+ * Usage:
+ *   const tools = compositeTools([
+ *     staticTools([searchTool]),
+ *     dynamicTools((ctx) => ctx.turnNumber > 3 ? [submitTool] : []),
+ *   ]);
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compositeTools = void 0;
+function compositeTools(providers) {
+    return {
+        resolve: async (context) => {
+            const allDecisions = await Promise.all(providers.map((p) => p.resolve(context)));
+            // Merge with last-write-wins by tool name
+            const toolMap = new Map();
+            for (const decision of allDecisions) {
+                for (const tool of decision.value) {
+                    toolMap.set(tool.name, tool);
+                }
+            }
+            const merged = Array.from(toolMap.values());
+            const labels = allDecisions.map((d) => d.chosen).filter((c) => c !== 'static');
+            return {
+                value: merged,
+                chosen: labels.length > 0 ? `composite: ${labels.join(' + ')}` : 'composite',
+                rationale: `${merged.length} tools from ${providers.length} providers`,
+            };
+        },
+        execute: async (call, signal) => {
+            // Walk providers in reverse — last provider that can execute wins
+            for (let i = providers.length - 1; i >= 0; i--) {
+                const provider = providers[i];
+                if (provider.execute) {
+                    // Try this provider — it may not know the tool, but that's ok
+                    // since we already validated via resolve
+                    return provider.execute(call, signal);
+                }
+            }
+            return { content: `No executor found for tool: ${call.name}`, error: true };
+        },
+    };
+}
+exports.compositeTools = compositeTools;
+//# sourceMappingURL=compositeTools.js.map

package/dist/providers/tools/compositeTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compositeTools.js","sourceRoot":"","sources":["../../../src/providers/tools/compositeTools.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAMH,SAAgB,cAAc,CAAC,SAAkC;IAC/D,OAAO;QACL,OAAO,EAAE,KAAK,EAAE,OAAoB,EAAE,EAAE;YACtC,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAEjF,0CAA0C;YAC1C,MAAM,OAAO,GAAG,IAAI,GAAG,EAA8B,CAAC;YACtD,KAAK,MAAM,QAAQ,IAAI,YAAY,EAAE,CAAC;gBACpC,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;oBAClC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;YAED,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YAC5C,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC;YAC/E,OAAO;gBACL,KAAK,EAAE,MAAM;gBACb,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW;gBAC5E,SAAS,EAAE,GAAG,MAAM,CAAC,MAAM,eAAe,SAAS,CAAC,MAAM,YAAY;aACvE,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,IAAc,EAAE,MAAoB,EAAgC,EAAE;YACpF,kEAAkE;YAClE,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC/C,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;gBAC9B,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;oBACrB,8DAA8D;oBAC9D,yCAAyC;oBACzC,OAAO,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;gBACxC,CAAC;YACH,CAAC;YACD,OAAO,EAAE,OAAO,EAAE,+BAA+B,IAAI,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAC9E,CAAC;KACF,CAAC;AACJ,CAAC;AAnCD,wCAmCC"}

package/dist/providers/tools/dynamicTools.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * dynamicTools — resolver-only ToolProvider that resolves tools based on context.
+ *
+ * The resolver function receives the current ToolContext and returns
+ * the tools available for this turn. Useful when:
+ * - Different tools are available based on conversation state
+ * - Tools are loaded from an external source (MCP, DB, API)
+ * - Tool availability depends on user permissions
+ *
+ * This provider does NOT include `execute` — the core loop calls
+ * `ToolDefinition.handler` directly from the resolved set. This avoids
+ * stale cache issues and temporal coupling between resolve/execute.
+ *
+ * For providers where execution is remote (MCP, A2A), implement
+ * `ToolProvider` directly with both `resolve` and `execute`.
+ *
+ * Usage:
+ *   agentLoop().toolProvider(dynamicTools((ctx) => {
+ *     if (ctx.message.includes('code')) return [runCodeTool];
+ *     return [searchTool];
+ *   }))
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dynamicTools = void 0;
+function dynamicTools(resolver) {
+    return {
+        resolve: async (context) => {
+            const tools = await resolver(context);
+            return {
+                value: tools.map((t) => ({
+                    name: t.id,
+                    description: t.description,
+                    inputSchema: t.inputSchema,
+                })),
+                chosen: 'dynamic',
+                rationale: `${tools.length} tool${tools.length !== 1 ? 's' : ''} resolved`,
+            };
+        },
+        // No execute — core loop uses ToolDefinition.handler from resolved set.
+        // This avoids cache staleness. For remote execution, implement ToolProvider directly.
+    };
+}
+exports.dynamicTools = dynamicTools;
+//# sourceMappingURL=dynamicTools.js.map

package/dist/providers/tools/dynamicTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamicTools.js","sourceRoot":"","sources":["../../../src/providers/tools/dynamicTools.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;AAOH,SAAgB,YAAY,CAAC,QAAsB;IACjD,OAAO;QACL,OAAO,EAAE,KAAK,EAAE,OAAoB,EAAE,EAAE;YACtC,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;YACtC,OAAO;gBACL,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACvB,IAAI,EAAE,CAAC,CAAC,EAAE;oBACV,WAAW,EAAE,CAAC,CAAC,WAAW;oBAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;iBAC3B,CAAC,CAAC;gBACH,MAAM,EAAE,SAAS;gBACjB,SAAS,EAAE,GAAG,KAAK,CAAC,MAAM,QAAQ,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,WAAW;aAC3E,CAAC;QACJ,CAAC;QACD,wEAAwE;QACxE,sFAAsF;KACvF,CAAC;AACJ,CAAC;AAjBD,oCAiBC"}

package/dist/providers/tools/gatedTools.js

@@ -0,0 +1,94 @@
+"use strict";
+/**
+ * gatedTools — Permission-based tool filtering with defense in depth.
+ *
+ * Wraps any ToolProvider to filter tools based on a permission check.
+ * Two layers of enforcement:
+ *   1. resolve() — blocked tools are hidden from LLM (it never sees them)
+ *   2. execute() — if LLM somehow calls a blocked tool, returns error
+ *
+ * The permission check runs every loop iteration (per-turn), so permissions
+ * can change mid-conversation (e.g., user grants access after auth step).
+ *
+ * Narrative integration: blocked execution returns an error result that
+ * flows through the normal tool result path → recorders see it via
+ * onToolCall, LLM sees it in conversation history and can respond.
+ *
+ * Optional onBlocked callback for observability (logging, metrics).
+ *
+ * Usage:
+ *   // Static permission set
+ *   const tools = gatedTools(
+ *     staticTools([searchTool, adminTool, codeTool]),
+ *     (toolId) => userPermissions.has(toolId),
+ *   );
+ *
+ *   // Context-aware (per-turn)
+ *   const tools = gatedTools(
+ *     staticTools(allTools),
+ *     (toolId, ctx) => {
+ *       if (ctx.turnNumber > 5) return false; // rate limit
+ *       return allowedTools.has(toolId);
+ *     },
+ *   );
+ *
+ *   // With observability
+ *   const tools = gatedTools(
+ *     staticTools(allTools),
+ *     (toolId) => permissions.has(toolId),
+ *     { onBlocked: (toolId, phase) => console.log(`Blocked ${toolId} at ${phase}`) },
+ *   );
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.gatedTools = void 0;
+function gatedTools(inner, isAllowed, options) {
+    // Track the last ToolContext for use in execute() which doesn't receive it
+    let lastContext;
+    return {
+        resolve: async (context) => {
+            lastContext = context;
+            const innerDecision = await inner.resolve(context);
+            // Filter: only return tools the user has permission for
+            const allowed = [];
+            const blocked = [];
+            for (const tool of innerDecision.value) {
+                const permitted = await isAllowed(tool.name, context);
+                if (permitted) {
+                    allowed.push(tool);
+                }
+                else {
+                    blocked.push(tool.name);
+                    options?.onBlocked?.(tool.name, 'resolve', context);
+                }
+            }
+            return {
+                value: allowed,
+                chosen: blocked.length > 0 ? 'gated' : innerDecision.chosen,
+                rationale: blocked.length > 0
+                    ? `${allowed.length} allowed, ${blocked.length} blocked: ${blocked.join(', ')}`
+                    : innerDecision.rationale,
+            };
+        },
+        execute: inner.execute
+            ? async (call, signal) => {
+                // Defense in depth: check permission even at execute time
+                // (in case LLM hallucinates a tool name that was filtered from resolve)
+                const ctx = lastContext ?? { message: '', turnNumber: 0, loopIteration: 0, messages: [] };
+                const permitted = await isAllowed(call.name, ctx);
+                if (!permitted) {
+                    options?.onBlocked?.(call.name, 'execute', ctx);
+                    // This error flows into conversation history — LLM sees it
+                    // and recorders capture it via onToolCall
+                    return {
+                        content: `Permission denied: tool "${call.name}" is not available. ` +
+                            `Available tools are listed in the system prompt.`,
+                        error: true,
+                    };
+                }
+                return inner.execute(call, signal);
+            }
+            : undefined,
+    };
+}
+exports.gatedTools = gatedTools;
+//# sourceMappingURL=gatedTools.js.map

package/dist/providers/tools/gatedTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gatedTools.js","sourceRoot":"","sources":["../../../src/providers/tools/gatedTools.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;;;AAiBH,SAAgB,UAAU,CACxB,KAAmB,EACnB,SAA4B,EAC5B,OAA2B;IAE3B,2EAA2E;IAC3E,IAAI,WAAoC,CAAC;IAEzC,OAAO;QACL,OAAO,EAAE,KAAK,EAAE,OAAoB,EAAE,EAAE;YACtC,WAAW,GAAG,OAAO,CAAC;YACtB,MAAM,aAAa,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAEnD,wDAAwD;YACxD,MAAM,OAAO,GAAyB,EAAE,CAAC;YACzC,MAAM,OAAO,GAAa,EAAE,CAAC;YAC7B,KAAK,MAAM,IAAI,IAAI,aAAa,CAAC,KAAK,EAAE,CAAC;gBACvC,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBACtD,IAAI,SAAS,EAAE,CAAC;oBACd,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACrB,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACxB,OAAO,EAAE,SAAS,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;gBACtD,CAAC;YACH,CAAC;YACD,OAAO;gBACL,KAAK,EAAE,OAAO;gBACd,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM;gBAC3D,SAAS,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC;oBAC3B,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,aAAa,OAAO,CAAC,MAAM,aAAa,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;oBAC/E,CAAC,CAAC,aAAa,CAAC,SAAS;aAC5B,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,KAAK,CAAC,OAAO;YACpB,CAAC,CAAC,KAAK,EAAE,IAAc,EAAE,MAAoB,EAAgC,EAAE;gBAC3E,0DAA0D;gBAC1D,wEAAwE;gBACxE,MAAM,GAAG,GAAG,WAAW,IAAK,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAkB,CAAC;gBAC3G,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBAElD,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,OAAO,EAAE,SAAS,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;oBAChD,2DAA2D;oBAC3D,0CAA0C;oBAC1C,OAAO;wBACL,OAAO,EAAE,4BAA4B,IAAI,CAAC,IAAI,sBAAsB;4BAClE,kDAAkD;wBACpD,KAAK,EAAE,IAAI;qBACZ,CAAC;gBACJ,CAAC;gBAED,OAAO,KAAK,CAAC,OAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACtC,CAAC;YACH,CAAC,CAAC,SAAS;KACd,CAAC;AACJ,CAAC;AAxDD,gCAwDC"}

package/dist/providers/tools/index.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * providers/tools/ — Built-in ToolProvider implementations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PermissionPolicy = exports.gatedTools = exports.compositeTools = exports.agentAsTool = exports.noTools = exports.dynamicTools = exports.staticTools = void 0;
+var staticTools_1 = require("./staticTools");
+Object.defineProperty(exports, "staticTools", { enumerable: true, get: function () { return staticTools_1.staticTools; } });
+var dynamicTools_1 = require("./dynamicTools");
+Object.defineProperty(exports, "dynamicTools", { enumerable: true, get: function () { return dynamicTools_1.dynamicTools; } });
+var noTools_1 = require("./noTools");
+Object.defineProperty(exports, "noTools", { enumerable: true, get: function () { return noTools_1.noTools; } });
+var agentAsTool_1 = require("./agentAsTool");
+Object.defineProperty(exports, "agentAsTool", { enumerable: true, get: function () { return agentAsTool_1.agentAsTool; } });
+var compositeTools_1 = require("./compositeTools");
+Object.defineProperty(exports, "compositeTools", { enumerable: true, get: function () { return compositeTools_1.compositeTools; } });
+var gatedTools_1 = require("./gatedTools");
+Object.defineProperty(exports, "gatedTools", { enumerable: true, get: function () { return gatedTools_1.gatedTools; } });
+var PermissionPolicy_1 = require("./PermissionPolicy");
+Object.defineProperty(exports, "PermissionPolicy", { enumerable: true, get: function () { return PermissionPolicy_1.PermissionPolicy; } });
+//# sourceMappingURL=index.js.map

package/dist/providers/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/tools/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AAErB,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAChB,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AAEpB,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AAEnB,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA"}

package/dist/providers/tools/noTools.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * noTools — ToolProvider that provides no tools.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noTools = void 0;
+function noTools() {
+    return {
+        resolve: () => ({ value: [], chosen: 'none' }),
+    };
+}
+exports.noTools = noTools;
+//# sourceMappingURL=noTools.js.map

package/dist/providers/tools/noTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noTools.js","sourceRoot":"","sources":["../../../src/providers/tools/noTools.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAIH,SAAgB,OAAO;IACrB,OAAO;QACL,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;KAC/C,CAAC;AACJ,CAAC;AAJD,0BAIC"}

package/dist/providers/tools/staticTools.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * staticTools — ToolProvider with a fixed list of tools.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.staticTools = void 0;
+function staticTools(tools) {
+    const toolMap = new Map(tools.map((t) => [t.id, t]));
+    return {
+        resolve: () => ({
+            value: tools.map((t) => ({
+                name: t.id,
+                description: t.description,
+                inputSchema: t.inputSchema,
+            })),
+            chosen: 'static',
+            rationale: `${tools.length} tool${tools.length !== 1 ? 's' : ''}`,
+        }),
+        execute: async (call) => {
+            const tool = toolMap.get(call.name);
+            if (!tool) {
+                return { content: `Unknown tool: ${call.name}`, error: true };
+            }
+            return tool.handler(call.arguments);
+        },
+    };
+}
+exports.staticTools = staticTools;
+//# sourceMappingURL=staticTools.js.map

package/dist/providers/tools/staticTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staticTools.js","sourceRoot":"","sources":["../../../src/providers/tools/staticTools.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAMH,SAAgB,WAAW,CAAC,KAAuB;IACjD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAErD,OAAO;QACL,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;YACd,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACvB,IAAI,EAAE,CAAC,CAAC,EAAE;gBACV,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;aAC3B,CAAC,CAAC;YACH,MAAM,EAAE,QAAQ;YAChB,SAAS,EAAE,GAAG,KAAK,CAAC,MAAM,QAAQ,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;SAClE,CAAC;QAEF,OAAO,EAAE,KAAK,EAAE,IAAc,EAAgC,EAAE;YAC9D,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,EAAE,OAAO,EAAE,iBAAiB,IAAI,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;YAChE,CAAC;YACD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtC,CAAC;KACF,CAAC;AACJ,CAAC;AAtBD,kCAsBC"}

package/dist/providers.barrel.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * agentfootprint/providers — Connect to LLM providers.
+ *
+ * Import from here to connect your agent to Anthropic, OpenAI, Bedrock, Ollama, or mock.
+ *
+ * @example
+ * ```typescript
+ * import { mock, anthropic, createProvider } from 'agentfootprint/providers';
+ *
+ * // Testing — deterministic, $0
+ * const provider = mock([{ content: 'Hello!' }]);
+ *
+ * // Production — swap one line
+ * const provider = createProvider(anthropic('claude-sonnet-4-20250514'));
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryStore = exports.compositePrompt = exports.skillBasedPrompt = exports.templatePrompt = exports.staticPrompt = exports.gatedTools = exports.compositeTools = exports.agentAsTool = exports.a2aRunner = exports.mcpToolProvider = exports.BrowserOpenAIAdapter = exports.BrowserAnthropicAdapter = exports.BedrockAdapter = exports.OpenAIAdapter = exports.AnthropicAdapter = exports.createProvider = exports.mockRetriever = exports.MockRetriever = exports.mock = exports.MockAdapter = exports.lookupPricing = exports.DEFAULT_PRICING = exports.bedrock = exports.ollama = exports.openai = exports.anthropic = void 0;
+// Provider factories
+var models_1 = require("./models");
+Object.defineProperty(exports, "anthropic", { enumerable: true, get: function () { return models_1.anthropic; } });
+Object.defineProperty(exports, "openai", { enumerable: true, get: function () { return models_1.openai; } });
+Object.defineProperty(exports, "ollama", { enumerable: true, get: function () { return models_1.ollama; } });
+Object.defineProperty(exports, "bedrock", { enumerable: true, get: function () { return models_1.bedrock; } });
+var models_2 = require("./models");
+Object.defineProperty(exports, "DEFAULT_PRICING", { enumerable: true, get: function () { return models_2.DEFAULT_PRICING; } });
+Object.defineProperty(exports, "lookupPricing", { enumerable: true, get: function () { return models_2.lookupPricing; } });
+// Adapters
+var adapters_1 = require("./adapters");
+Object.defineProperty(exports, "MockAdapter", { enumerable: true, get: function () { return adapters_1.MockAdapter; } });
+Object.defineProperty(exports, "mock", { enumerable: true, get: function () { return adapters_1.mock; } });
+Object.defineProperty(exports, "MockRetriever", { enumerable: true, get: function () { return adapters_1.MockRetriever; } });
+Object.defineProperty(exports, "mockRetriever", { enumerable: true, get: function () { return adapters_1.mockRetriever; } });
+Object.defineProperty(exports, "createProvider", { enumerable: true, get: function () { return adapters_1.createProvider; } });
+var adapters_2 = require("./adapters");
+Object.defineProperty(exports, "AnthropicAdapter", { enumerable: true, get: function () { return adapters_2.AnthropicAdapter; } });
+Object.defineProperty(exports, "OpenAIAdapter", { enumerable: true, get: function () { return adapters_2.OpenAIAdapter; } });
+Object.defineProperty(exports, "BedrockAdapter", { enumerable: true, get: function () { return adapters_2.BedrockAdapter; } });
+var adapters_3 = require("./adapters");
+Object.defineProperty(exports, "BrowserAnthropicAdapter", { enumerable: true, get: function () { return adapters_3.BrowserAnthropicAdapter; } });
+Object.defineProperty(exports, "BrowserOpenAIAdapter", { enumerable: true, get: function () { return adapters_3.BrowserOpenAIAdapter; } });
+// Protocol adapters
+var adapters_4 = require("./adapters");
+Object.defineProperty(exports, "mcpToolProvider", { enumerable: true, get: function () { return adapters_4.mcpToolProvider; } });
+Object.defineProperty(exports, "a2aRunner", { enumerable: true, get: function () { return adapters_4.a2aRunner; } });
+// Tool provider strategies
+var providers_1 = require("./providers");
+Object.defineProperty(exports, "agentAsTool", { enumerable: true, get: function () { return providers_1.agentAsTool; } });
+Object.defineProperty(exports, "compositeTools", { enumerable: true, get: function () { return providers_1.compositeTools; } });
+Object.defineProperty(exports, "gatedTools", { enumerable: true, get: function () { return providers_1.gatedTools; } });
+// Prompt strategies
+var providers_2 = require("./providers");
+Object.defineProperty(exports, "staticPrompt", { enumerable: true, get: function () { return providers_2.staticPrompt; } });
+Object.defineProperty(exports, "templatePrompt", { enumerable: true, get: function () { return providers_2.templatePrompt; } });
+Object.defineProperty(exports, "skillBasedPrompt", { enumerable: true, get: function () { return providers_2.skillBasedPrompt; } });
+Object.defineProperty(exports, "compositePrompt", { enumerable: true, get: function () { return providers_2.compositePrompt; } });
+// Memory strategies
+var inMemory_1 = require("./adapters/memory/inMemory");
+Object.defineProperty(exports, "InMemoryStore", { enumerable: true, get: function () { return inMemory_1.InMemoryStore; } });
+//# sourceMappingURL=providers.barrel.js.map

package/dist/providers.barrel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.barrel.js","sourceRoot":"","sources":["../src/providers.barrel.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;AAEH,qBAAqB;AACrB,mCAA8D;AAArD,mGAAA,SAAS,OAAA;AAAE,gGAAA,MAAM,OAAA;AAAE,gGAAA,MAAM,OAAA;AAAE,iGAAA,OAAO,OAAA;AAE3C,mCAA0D;AAAjD,yGAAA,eAAe,OAAA;AAAE,uGAAA,aAAa,OAAA;AAEvC,WAAW;AACX,uCAA6F;AAApF,uGAAA,WAAW,OAAA;AAAE,gGAAA,IAAI,OAAA;AAAE,yGAAA,aAAa,OAAA;AAAE,yGAAA,aAAa,OAAA;AAAE,0GAAA,cAAc,OAAA;AACxE,uCAA6E;AAApE,4GAAA,gBAAgB,OAAA;AAAE,yGAAA,aAAa,OAAA;AAAE,0GAAA,cAAc,OAAA;AACxD,uCAA2E;AAAlE,mHAAA,uBAAuB,OAAA;AAAE,gHAAA,oBAAoB,OAAA;AAWtD,oBAAoB;AACpB,uCAAwD;AAA/C,2GAAA,eAAe,OAAA;AAAE,qGAAA,SAAS,OAAA;AAOnC,2BAA2B;AAC3B,yCAAsE;AAA7D,wGAAA,WAAW,OAAA;AAAE,2GAAA,cAAc,OAAA;AAAE,uGAAA,UAAU,OAAA;AAGhD,oBAAoB;AACpB,yCAA8F;AAArF,yGAAA,YAAY,OAAA;AAAE,2GAAA,cAAc,OAAA;AAAE,6GAAA,gBAAgB,OAAA;AAAE,4GAAA,eAAe,OAAA;AAGxE,oBAAoB;AACpB,uDAA2D;AAAlD,yGAAA,aAAa,OAAA"}

package/dist/recorders/index.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentObservability = exports.PermissionRecorder = exports.CompositeRecorder = exports.GuardrailRecorder = exports.QualityRecorder = exports.ToolUsageRecorder = exports.TurnRecorder = exports.CostRecorder = exports.TokenRecorder = void 0;
+/**
+ * recorders/ — AgentRecorder implementations.
+ */
+var v2_1 = require("./v2");
+Object.defineProperty(exports, "TokenRecorder", { enumerable: true, get: function () { return v2_1.TokenRecorder; } });
+Object.defineProperty(exports, "CostRecorder", { enumerable: true, get: function () { return v2_1.CostRecorder; } });
+Object.defineProperty(exports, "TurnRecorder", { enumerable: true, get: function () { return v2_1.TurnRecorder; } });
+Object.defineProperty(exports, "ToolUsageRecorder", { enumerable: true, get: function () { return v2_1.ToolUsageRecorder; } });
+Object.defineProperty(exports, "QualityRecorder", { enumerable: true, get: function () { return v2_1.QualityRecorder; } });
+Object.defineProperty(exports, "GuardrailRecorder", { enumerable: true, get: function () { return v2_1.GuardrailRecorder; } });
+Object.defineProperty(exports, "CompositeRecorder", { enumerable: true, get: function () { return v2_1.CompositeRecorder; } });
+Object.defineProperty(exports, "PermissionRecorder", { enumerable: true, get: function () { return v2_1.PermissionRecorder; } });
+Object.defineProperty(exports, "agentObservability", { enumerable: true, get: function () { return v2_1.agentObservability; } });
+//# sourceMappingURL=index.js.map

package/dist/recorders/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/recorders/index.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,2BAUc;AATZ,mGAAA,aAAa,OAAA;AACb,kGAAA,YAAY,OAAA;AACZ,kGAAA,YAAY,OAAA;AACZ,uGAAA,iBAAiB,OAAA;AACjB,qGAAA,eAAe,OAAA;AACf,uGAAA,iBAAiB,OAAA;AACjB,uGAAA,iBAAiB,OAAA;AACjB,wGAAA,kBAAkB,OAAA;AAClB,wGAAA,kBAAkB,OAAA"}

package/dist/recorders/v2/CompositeRecorder.js

@@ -0,0 +1,69 @@
+"use strict";
+/**
+ * CompositeRecorder — fans out events to multiple AgentRecorders.
+ *
+ * Convenience wrapper that dispatches each event to all child recorders.
+ * Error in one recorder does not affect others (error isolation).
+ *
+ * Usage:
+ *   const composite = new CompositeRecorder([
+ *     new TokenRecorder(),
+ *     new QualityRecorder(judge),
+ *     new GuardrailRecorder(check),
+ *   ]);
+ *   agent.recorder(composite);
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompositeRecorder = void 0;
+class CompositeRecorder {
+    id;
+    recorders;
+    constructor(recorders, id = 'composite-recorder') {
+        this.recorders = recorders;
+        this.id = id;
+    }
+    onTurnStart(event) {
+        this.dispatch('onTurnStart', event);
+    }
+    onLLMCall(event) {
+        this.dispatch('onLLMCall', event);
+    }
+    onToolCall(event) {
+        this.dispatch('onToolCall', event);
+    }
+    onTurnComplete(event) {
+        this.dispatch('onTurnComplete', event);
+    }
+    onError(event) {
+        this.dispatch('onError', event);
+    }
+    clear() {
+        for (const recorder of this.recorders) {
+            try {
+                recorder.clear?.();
+            }
+            catch {
+                /* error isolation */
+            }
+        }
+    }
+    /** Access child recorders for inspection. */
+    getRecorders() {
+        return this.recorders;
+    }
+    dispatch(hook, event) {
+        for (const recorder of this.recorders) {
+            try {
+                const fn = recorder[hook];
+                if (typeof fn === 'function') {
+                    fn.call(recorder, event);
+                }
+            }
+            catch {
+                // Error isolation — one recorder failure must not affect others
+            }
+        }
+    }
+}
+exports.CompositeRecorder = CompositeRecorder;
+//# sourceMappingURL=CompositeRecorder.js.map