agentfootprint 1.0.0

package/dist/recorders/v2/ToolUsageRecorder.js

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * ToolUsageRecorder — tracks which tools are called, how often, and latency.
+ *
+ * Useful for understanding agent behavior: which tools are hot,
+ * which are slow, and which are erroring.
+ *
+ * Usage:
+ *   const toolUsage = new ToolUsageRecorder();
+ *   agent.recorder(toolUsage);
+ *   await agent.run(...);
+ *   console.log(toolUsage.getStats());
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolUsageRecorder = void 0;
+class ToolUsageRecorder {
+    id;
+    toolCalls = [];
+    constructor(id = 'tool-usage-recorder') {
+        this.id = id;
+    }
+    onToolCall(event) {
+        this.toolCalls.push(event);
+    }
+    getStats() {
+        const byTool = {};
+        for (const call of this.toolCalls) {
+            if (!byTool[call.toolName]) {
+                byTool[call.toolName] = { calls: 0, errors: 0, totalLatencyMs: 0 };
+            }
+            byTool[call.toolName].calls++;
+            byTool[call.toolName].totalLatencyMs += call.latencyMs;
+            if (call.result.error) {
+                byTool[call.toolName].errors++;
+            }
+        }
+        const result = {};
+        for (const [name, stats] of Object.entries(byTool)) {
+            result[name] = {
+                ...stats,
+                averageLatencyMs: stats.calls > 0 ? Math.round(stats.totalLatencyMs / stats.calls) : 0,
+            };
+        }
+        return {
+            totalCalls: this.toolCalls.length,
+            totalErrors: this.toolCalls.filter((c) => c.result.error).length,
+            byTool: result,
+        };
+    }
+    getToolNames() {
+        return [...new Set(this.toolCalls.map((c) => c.toolName))];
+    }
+    clear() {
+        this.toolCalls = [];
+    }
+}
+exports.ToolUsageRecorder = ToolUsageRecorder;
+//# sourceMappingURL=ToolUsageRecorder.js.map

package/dist/recorders/v2/ToolUsageRecorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolUsageRecorder.js","sourceRoot":"","sources":["../../../src/recorders/v2/ToolUsageRecorder.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAiBH,MAAa,iBAAiB;IACnB,EAAE,CAAS;IACZ,SAAS,GAAoB,EAAE,CAAC;IAExC,YAAY,EAAE,GAAG,qBAAqB;QACpC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,CAAC;IAED,UAAU,CAAC,KAAoB;QAC7B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,QAAQ;QACN,MAAM,MAAM,GAA8E,EAAE,CAAC;QAE7F,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAClC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC3B,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;YACrE,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,cAAc,IAAI,IAAI,CAAC,SAAS,CAAC;YACvD,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBACtB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC;YACjC,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAA8B,EAAE,CAAC;QAC7C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACnD,MAAM,CAAC,IAAI,CAAC,GAAG;gBACb,GAAG,KAAK;gBACR,gBAAgB,EAAE,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;aACvF,CAAC;QACJ,CAAC;QAED,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM;YACjC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM;YAChE,MAAM,EAAE,MAAM;SACf,CAAC;IACJ,CAAC;IAED,YAAY;QACV,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK;QACH,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;IACtB,CAAC;CACF;AAhDD,8CAgDC"}

package/dist/recorders/v2/TurnRecorder.js

@@ -0,0 +1,87 @@
+"use strict";
+/**
+ * TurnRecorder — tracks turn-level lifecycle events.
+ *
+ * Records when turns start and complete, including message counts and
+ * loop iterations. Useful for debugging multi-turn conversations and
+ * understanding agent behavior over time.
+ *
+ * Usage:
+ *   const turns = new TurnRecorder();
+ *   agent.recorder(turns);
+ *   await agent.run(...);
+ *   console.log(turns.getTurns());
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TurnRecorder = void 0;
+class TurnRecorder {
+    id;
+    turns = [];
+    constructor(id = 'turn-recorder') {
+        this.id = id;
+    }
+    onTurnStart(event) {
+        this.turns.push({
+            turnNumber: event.turnNumber,
+            message: event.message,
+            status: 'started',
+        });
+    }
+    onTurnComplete(event) {
+        // Update the matching started entry, or add a new one
+        const idx = this.turns.findIndex((t) => t.turnNumber === event.turnNumber && t.status === 'started');
+        if (idx >= 0) {
+            this.turns[idx] = {
+                ...this.turns[idx],
+                content: event.content,
+                messageCount: event.messageCount,
+                totalLoopIterations: event.totalLoopIterations,
+                status: 'completed',
+            };
+        }
+        else {
+            this.turns.push({
+                turnNumber: event.turnNumber,
+                message: '',
+                content: event.content,
+                messageCount: event.messageCount,
+                totalLoopIterations: event.totalLoopIterations,
+                status: 'completed',
+            });
+        }
+    }
+    onError(event) {
+        const idx = this.turns.findIndex((t) => t.turnNumber === event.turnNumber && t.status === 'started');
+        if (idx >= 0) {
+            this.turns[idx] = {
+                ...this.turns[idx],
+                error: event.error,
+                status: 'error',
+            };
+        }
+        else {
+            // Error fired before onTurnStart (e.g. prompt resolution failure).
+            // Record it anyway — never silently drop errors.
+            this.turns.push({
+                turnNumber: event.turnNumber,
+                message: '',
+                error: event.error,
+                status: 'error',
+            });
+        }
+    }
+    getTurns() {
+        return [...this.turns];
+    }
+    getCompletedCount() {
+        return this.turns.filter((t) => t.status === 'completed').length;
+    }
+    getErrorCount() {
+        return this.turns.filter((t) => t.status === 'error').length;
+    }
+    clear() {
+        this.turns = [];
+    }
+}
+exports.TurnRecorder = TurnRecorder;
+//# sourceMappingURL=TurnRecorder.js.map

package/dist/recorders/v2/TurnRecorder.js.map

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

package/dist/recorders/v2/agentObservability.js

@@ -0,0 +1,66 @@
+"use strict";
+/**
+ * agentObservability() — one-call preset for full agent observability.
+ *
+ * Bundles TokenRecorder, ToolUsageRecorder, and CostRecorder into a single
+ * CompositeRecorder. The consumer attaches one recorder and gets token tracking,
+ * tool usage stats, and cost estimation without knowing the individual types.
+ *
+ * Stage-level timing is auto-attached by the runners (MetricRecorder on the
+ * executor) — this preset covers the agent-level concerns only.
+ *
+ * @example
+ * ```typescript
+ * import { Agent, agentObservability } from 'agentfootprint';
+ *
+ * // One call — tokens, tools, and cost tracking
+ * const obs = agentObservability();
+ * const agent = Agent.create({ provider })
+ *   .recorder(obs)
+ *   .build();
+ *
+ * await agent.run('hello');
+ *
+ * // Access stats
+ * console.log(obs.tokens());     // { totalCalls: 2, totalInputTokens: 150, ... }
+ * console.log(obs.tools());      // { totalCalls: 1, byTool: { search: { calls: 1, ... } } }
+ * console.log(obs.cost());       // 0.0042
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With cost estimation
+ * const obs = agentObservability({
+ *   pricing: {
+ *     'claude-sonnet-4-20250514': { input: 3, output: 15 },
+ *     'gpt-4o': { input: 2.5, output: 10 },
+ *   },
+ * });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentObservability = void 0;
+const CompositeRecorder_1 = require("./CompositeRecorder");
+const CostRecorder_1 = require("./CostRecorder");
+const TokenRecorder_1 = require("./TokenRecorder");
+const ToolUsageRecorder_1 = require("./ToolUsageRecorder");
+/**
+ * Create a bundled agent observability recorder.
+ *
+ * Tracks tokens, tool usage, and cost in a single `.recorder()` call.
+ * Stage timing is handled separately by MetricRecorder (auto-attached by runners).
+ */
+function agentObservability(options) {
+    const tokenRec = new TokenRecorder_1.TokenRecorder();
+    const toolRec = new ToolUsageRecorder_1.ToolUsageRecorder();
+    const costRec = new CostRecorder_1.CostRecorder(options?.pricing ? { pricingTable: options.pricing } : undefined);
+    const composite = new CompositeRecorder_1.CompositeRecorder([tokenRec, toolRec, costRec], options?.id ?? 'agent-observability');
+    // Convenience accessors — no need to dig into children
+    composite.tokens = () => tokenRec.getStats();
+    composite.tools = () => toolRec.getStats();
+    composite.cost = () => costRec.getTotalCost();
+    composite.costEntries = () => costRec.getEntries();
+    return composite;
+}
+exports.agentObservability = agentObservability;
+//# sourceMappingURL=agentObservability.js.map

package/dist/recorders/v2/agentObservability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentObservability.js","sourceRoot":"","sources":["../../../src/recorders/v2/agentObservability.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;;;AAKH,2DAAwD;AACxD,iDAA8C;AAC9C,mDAAgD;AAChD,2DAAwD;AAqBxD;;;;;GAKG;AACH,SAAgB,kBAAkB,CAAC,OAAmC;IACpE,MAAM,QAAQ,GAAG,IAAI,6BAAa,EAAE,CAAC;IACrC,MAAM,OAAO,GAAG,IAAI,qCAAiB,EAAE,CAAC;IACxC,MAAM,OAAO,GAAG,IAAI,2BAAY,CAC9B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CACjE,CAAC;IAEF,MAAM,SAAS,GAAG,IAAI,qCAAiB,CACrC,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,EAC5B,OAAO,EAAE,EAAE,IAAI,qBAAqB,CACP,CAAC;IAEhC,uDAAuD;IACvD,SAAS,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;IAC7C,SAAS,CAAC,KAAK,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;IAC3C,SAAS,CAAC,IAAI,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;IAC9C,SAAS,CAAC,WAAW,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;IAEnD,OAAO,SAAS,CAAC;AACnB,CAAC;AAnBD,gDAmBC"}

package/dist/recorders/v2/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * recorders/ — AgentRecorder implementations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentObservability = exports.PermissionRecorder = exports.CompositeRecorder = exports.GuardrailRecorder = exports.QualityRecorder = exports.TurnRecorder = exports.ToolUsageRecorder = exports.CostRecorder = exports.TokenRecorder = void 0;
+var TokenRecorder_1 = require("./TokenRecorder");
+Object.defineProperty(exports, "TokenRecorder", { enumerable: true, get: function () { return TokenRecorder_1.TokenRecorder; } });
+var CostRecorder_1 = require("./CostRecorder");
+Object.defineProperty(exports, "CostRecorder", { enumerable: true, get: function () { return CostRecorder_1.CostRecorder; } });
+var ToolUsageRecorder_1 = require("./ToolUsageRecorder");
+Object.defineProperty(exports, "ToolUsageRecorder", { enumerable: true, get: function () { return ToolUsageRecorder_1.ToolUsageRecorder; } });
+var TurnRecorder_1 = require("./TurnRecorder");
+Object.defineProperty(exports, "TurnRecorder", { enumerable: true, get: function () { return TurnRecorder_1.TurnRecorder; } });
+var QualityRecorder_1 = require("./QualityRecorder");
+Object.defineProperty(exports, "QualityRecorder", { enumerable: true, get: function () { return QualityRecorder_1.QualityRecorder; } });
+var GuardrailRecorder_1 = require("./GuardrailRecorder");
+Object.defineProperty(exports, "GuardrailRecorder", { enumerable: true, get: function () { return GuardrailRecorder_1.GuardrailRecorder; } });
+var CompositeRecorder_1 = require("./CompositeRecorder");
+Object.defineProperty(exports, "CompositeRecorder", { enumerable: true, get: function () { return CompositeRecorder_1.CompositeRecorder; } });
+var PermissionRecorder_1 = require("./PermissionRecorder");
+Object.defineProperty(exports, "PermissionRecorder", { enumerable: true, get: function () { return PermissionRecorder_1.PermissionRecorder; } });
+var agentObservability_1 = require("./agentObservability");
+Object.defineProperty(exports, "agentObservability", { enumerable: true, get: function () { return agentObservability_1.agentObservability; } });
+//# sourceMappingURL=index.js.map

package/dist/recorders/v2/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/recorders/v2/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AAEtB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AAMrB,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAE1B,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AAErB,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AAExB,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAE1B,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAC1B,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA;AAE3B,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA"}

package/dist/resilience.barrel.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * agentfootprint/resilience — Make agents reliable.
+ *
+ * Retry, fallback, circuit breaker, cross-family provider failover.
+ *
+ * @example
+ * ```typescript
+ * import { withRetry, resilientProvider } from 'agentfootprint/resilience';
+ *
+ * const reliable = withRetry(agent, { maxRetries: 3 });
+ * const provider = resilientProvider([anthropicAdapter, openaiAdapter]);
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fallbackProvider = exports.resilientProvider = exports.CircuitBreaker = exports.withCircuitBreaker = exports.withFallback = exports.withRetry = void 0;
+var compositions_1 = require("./compositions");
+Object.defineProperty(exports, "withRetry", { enumerable: true, get: function () { return compositions_1.withRetry; } });
+Object.defineProperty(exports, "withFallback", { enumerable: true, get: function () { return compositions_1.withFallback; } });
+Object.defineProperty(exports, "withCircuitBreaker", { enumerable: true, get: function () { return compositions_1.withCircuitBreaker; } });
+Object.defineProperty(exports, "CircuitBreaker", { enumerable: true, get: function () { return compositions_1.CircuitBreaker; } });
+var adapters_1 = require("./adapters");
+Object.defineProperty(exports, "resilientProvider", { enumerable: true, get: function () { return adapters_1.resilientProvider; } });
+Object.defineProperty(exports, "fallbackProvider", { enumerable: true, get: function () { return adapters_1.fallbackProvider; } });
+//# sourceMappingURL=resilience.barrel.js.map

package/dist/resilience.barrel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resilience.barrel.js","sourceRoot":"","sources":["../src/resilience.barrel.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAEH,+CAA6F;AAApF,yGAAA,SAAS,OAAA;AAAE,4GAAA,YAAY,OAAA;AAAE,kHAAA,kBAAkB,OAAA;AAAE,8GAAA,cAAc,OAAA;AAEpE,uCAAiE;AAAxD,6GAAA,iBAAiB,OAAA;AAAE,4GAAA,gBAAgB,OAAA"}

package/dist/scope/AgentScope.js

@@ -0,0 +1,156 @@
+"use strict";
+/**
+ * AgentScope — typed wrapper over ScopeFacade for agent state.
+ *
+ * Instead of raw scope.getValue('messages'), use scope.getMessages().
+ * All paths come from AGENT_PATHS constants (single source of truth).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentScope = exports.RAG_PATHS = exports.MULTI_AGENT_PATHS = exports.AGENT_PATHS = exports.MEMORY_PATHS = void 0;
+/**
+ * Well-known scope paths for memory subflow state.
+ * These keys are internal to PrepareMemory/CommitMemory and are prefixed
+ * with `memory_` to avoid collision with agent state keys.
+ */
+exports.MEMORY_PATHS = {
+    /** Raw history loaded from ConversationStore (PrepareMemory internal). */
+    STORED_HISTORY: 'memory_storedHistory',
+    /** Prepared messages after strategy applied (PrepareMemory output). */
+    PREPARED_MESSAGES: 'memory_preparedMessages',
+    /**
+     * Set to `true` by HandleResponse when the turn is finalizing (no more tool calls).
+     * CommitMemory reads this to know when to save + break the pipeline.
+     */
+    SHOULD_COMMIT: 'memory_shouldCommit',
+};
+/** Well-known scope paths for agent state. */
+exports.AGENT_PATHS = {
+    MESSAGES: 'messages',
+    SYSTEM_PROMPT: 'systemPrompt',
+    TOOL_DESCRIPTIONS: 'toolDescriptions',
+    ADAPTER_RESULT: 'adapterResult',
+    PARSED_RESPONSE: 'parsedResponse',
+    LOOP_COUNT: 'loopCount',
+    MAX_ITERATIONS: 'maxIterations',
+    RESULT: 'result',
+};
+/** Well-known scope paths for multi-agent pipeline state. */
+exports.MULTI_AGENT_PATHS = {
+    PIPELINE_INPUT: 'pipelineInput',
+    AGENT_RESULTS: 'agentResults',
+    RESULT: 'result',
+    SIGNAL: '_signal',
+    TIMEOUT_MS: '_timeoutMs',
+};
+/** Well-known scope paths for RAG state. */
+exports.RAG_PATHS = {
+    RETRIEVAL_QUERY: 'retrievalQuery',
+    RETRIEVAL_RESULT: 'retrievalResult',
+    CONTEXT_WINDOW: 'contextWindow',
+};
+/**
+ * Typed accessors for agent state in scope.
+ * These are pure functions — no class inheritance needed.
+ */
+exports.AgentScope = {
+    // ── Reads ──────────────────────────────────────────────
+    getMessages(scope) {
+        const msgs = scope.getValue(exports.AGENT_PATHS.MESSAGES);
+        return msgs ? [...msgs] : [];
+    },
+    getSystemPrompt(scope) {
+        return scope.getValue(exports.AGENT_PATHS.SYSTEM_PROMPT);
+    },
+    getToolDescriptions(scope) {
+        return scope.getValue(exports.AGENT_PATHS.TOOL_DESCRIPTIONS) ?? [];
+    },
+    getAdapterResult(scope) {
+        return scope.getValue(exports.AGENT_PATHS.ADAPTER_RESULT);
+    },
+    getParsedResponse(scope) {
+        return scope.getValue(exports.AGENT_PATHS.PARSED_RESPONSE);
+    },
+    getLoopCount(scope) {
+        return scope.getValue(exports.AGENT_PATHS.LOOP_COUNT) ?? 0;
+    },
+    getMaxIterations(scope) {
+        return scope.getValue(exports.AGENT_PATHS.MAX_ITERATIONS) ?? 10;
+    },
+    getResult(scope) {
+        return scope.getValue(exports.AGENT_PATHS.RESULT);
+    },
+    // ── Writes ─────────────────────────────────────────────
+    setMessages(scope, messages) {
+        scope.setValue(exports.AGENT_PATHS.MESSAGES, messages);
+    },
+    setSystemPrompt(scope, prompt) {
+        scope.setValue(exports.AGENT_PATHS.SYSTEM_PROMPT, prompt);
+    },
+    setToolDescriptions(scope, tools) {
+        scope.setValue(exports.AGENT_PATHS.TOOL_DESCRIPTIONS, tools);
+    },
+    setAdapterResult(scope, result) {
+        scope.setValue(exports.AGENT_PATHS.ADAPTER_RESULT, result);
+    },
+    setParsedResponse(scope, parsed) {
+        scope.setValue(exports.AGENT_PATHS.PARSED_RESPONSE, parsed);
+    },
+    setLoopCount(scope, count) {
+        scope.setValue(exports.AGENT_PATHS.LOOP_COUNT, count);
+    },
+    setMaxIterations(scope, max) {
+        scope.setValue(exports.AGENT_PATHS.MAX_ITERATIONS, max);
+    },
+    setResult(scope, result) {
+        scope.setValue(exports.AGENT_PATHS.RESULT, result);
+    },
+    // ── RAG Reads ───────────────────────────────────────────
+    getRetrievalQuery(scope) {
+        return scope.getValue(exports.RAG_PATHS.RETRIEVAL_QUERY);
+    },
+    getRetrievalResult(scope) {
+        return scope.getValue(exports.RAG_PATHS.RETRIEVAL_RESULT);
+    },
+    getContextWindow(scope) {
+        return scope.getValue(exports.RAG_PATHS.CONTEXT_WINDOW);
+    },
+    // ── RAG Writes ──────────────────────────────────────────
+    setRetrievalQuery(scope, query) {
+        scope.setValue(exports.RAG_PATHS.RETRIEVAL_QUERY, query);
+    },
+    setRetrievalResult(scope, result) {
+        scope.setValue(exports.RAG_PATHS.RETRIEVAL_RESULT, result);
+    },
+    setContextWindow(scope, context) {
+        scope.setValue(exports.RAG_PATHS.CONTEXT_WINDOW, context);
+    },
+    // ── Multi-Agent Reads ──────────────────────────────────────
+    getPipelineInput(scope) {
+        return scope.getValue(exports.MULTI_AGENT_PATHS.PIPELINE_INPUT);
+    },
+    getAgentResults(scope) {
+        return scope.getValue(exports.MULTI_AGENT_PATHS.AGENT_RESULTS) ?? [];
+    },
+    // ── Multi-Agent Writes ─────────────────────────────────────
+    setPipelineInput(scope, input) {
+        scope.setValue(exports.MULTI_AGENT_PATHS.PIPELINE_INPUT, input);
+    },
+    setAgentResults(scope, results) {
+        scope.setValue(exports.MULTI_AGENT_PATHS.AGENT_RESULTS, results);
+    },
+    // ── Memory Reads ───────────────────────────────────────────
+    getShouldCommit(scope) {
+        return scope.getValue(exports.MEMORY_PATHS.SHOULD_COMMIT) === true;
+    },
+    getStoredHistory(scope) {
+        return scope.getValue(exports.MEMORY_PATHS.STORED_HISTORY) ?? [];
+    },
+    getPreparedMessages(scope) {
+        return scope.getValue(exports.MEMORY_PATHS.PREPARED_MESSAGES) ?? [];
+    },
+    // ── Memory Writes ──────────────────────────────────────────
+    setShouldCommit(scope, value) {
+        scope.setValue(exports.MEMORY_PATHS.SHOULD_COMMIT, value);
+    },
+};
+//# sourceMappingURL=AgentScope.js.map

package/dist/scope/AgentScope.js.map

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

package/dist/scope/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MEMORY_PATHS = exports.MULTI_AGENT_PATHS = exports.RAG_PATHS = exports.AGENT_PATHS = exports.AgentScope = void 0;
+var AgentScope_1 = require("./AgentScope");
+Object.defineProperty(exports, "AgentScope", { enumerable: true, get: function () { return AgentScope_1.AgentScope; } });
+Object.defineProperty(exports, "AGENT_PATHS", { enumerable: true, get: function () { return AgentScope_1.AGENT_PATHS; } });
+Object.defineProperty(exports, "RAG_PATHS", { enumerable: true, get: function () { return AgentScope_1.RAG_PATHS; } });
+Object.defineProperty(exports, "MULTI_AGENT_PATHS", { enumerable: true, get: function () { return AgentScope_1.MULTI_AGENT_PATHS; } });
+Object.defineProperty(exports, "MEMORY_PATHS", { enumerable: true, get: function () { return AgentScope_1.MEMORY_PATHS; } });
+//# sourceMappingURL=index.js.map

package/dist/scope/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scope/index.ts"],"names":[],"mappings":";;;AAAA,2CAAmG;AAA1F,wGAAA,UAAU,OAAA;AAAE,yGAAA,WAAW,OAAA;AAAE,uGAAA,SAAS,OAAA;AAAE,+GAAA,iBAAiB,OAAA;AAAE,0GAAA,YAAY,OAAA"}

package/dist/scope/types.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * Typed state interfaces for TypedScope<T> in agentfootprint patterns.
+ *
+ * These replace the AgentScope static helpers + AGENT_PATHS string constants.
+ * Each pattern has its own state interface — subflows use narrower slices.
+ *
+ * Usage:
+ *   flowChart<AgentLoopState>('Seed', (scope) => {
+ *     scope.messages = [userMessage('hello')];  // typed write
+ *     scope.loopCount = 0;                       // typed write
+ *   })
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentScopeKey = void 0;
+// ── Agent Loop State ─────────────────────────────────────────
+/**
+ * Well-known scope keys for the agent loop.
+ * Used by grounding helpers, narrative renderer, and suppression lists.
+ * Single source of truth — no magic strings.
+ */
+var AgentScopeKey;
+(function (AgentScopeKey) {
+    // Core state
+    AgentScopeKey["Messages"] = "messages";
+    AgentScopeKey["SystemPrompt"] = "systemPrompt";
+    AgentScopeKey["ToolDescriptions"] = "toolDescriptions";
+    AgentScopeKey["ParsedResponse"] = "parsedResponse";
+    AgentScopeKey["Result"] = "result";
+    AgentScopeKey["LoopCount"] = "loopCount";
+    // Tool execution
+    AgentScopeKey["ToolResultMessages"] = "toolResultMessages";
+    // Decision / Instructions
+    AgentScopeKey["Decision"] = "decision";
+    AgentScopeKey["MatchedInstructions"] = "matchedInstructions";
+    AgentScopeKey["PromptInjections"] = "promptInjections";
+    AgentScopeKey["ToolInjections"] = "toolInjections";
+    AgentScopeKey["ResponseRules"] = "responseRules";
+})(AgentScopeKey || (exports.AgentScopeKey = AgentScopeKey = {}));
+//# sourceMappingURL=types.js.map

package/dist/scope/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/scope/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAoCH,gEAAgE;AAEhE;;;;GAIG;AACH,IAAY,aAkBX;AAlBD,WAAY,aAAa;IACvB,aAAa;IACb,sCAAqB,CAAA;IACrB,8CAA6B,CAAA;IAC7B,sDAAqC,CAAA;IACrC,kDAAiC,CAAA;IACjC,kCAAiB,CAAA;IACjB,wCAAuB,CAAA;IAEvB,iBAAiB;IACjB,0DAAyC,CAAA;IAEzC,0BAA0B;IAC1B,sCAAqB,CAAA;IACrB,4DAA2C,CAAA;IAC3C,sDAAqC,CAAA;IACrC,kDAAiC,CAAA;IACjC,gDAA+B,CAAA;AACjC,CAAC,EAlBW,aAAa,6BAAb,aAAa,QAkBxB"}

package/dist/security.barrel.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * agentfootprint/security — Make agents safe.
+ *
+ * Tool gating hides tools from the LLM. Permission policies control access.
+ * Two layers: resolve-time filtering (LLM never sees blocked tools) + execute-time rejection.
+ *
+ * @example
+ * ```typescript
+ * import { gatedTools, PermissionPolicy } from 'agentfootprint/security';
+ *
+ * const policy = PermissionPolicy.fromRoles({ user: ['search'], admin: ['search', 'delete'] }, 'user');
+ * const agent = Agent.create({ provider }).toolProvider(gatedTools(tools, policy.checker())).build();
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PermissionPolicy = exports.gatedTools = void 0;
+var providers_1 = require("./providers");
+Object.defineProperty(exports, "gatedTools", { enumerable: true, get: function () { return providers_1.gatedTools; } });
+Object.defineProperty(exports, "PermissionPolicy", { enumerable: true, get: function () { return providers_1.PermissionPolicy; } });
+// PermissionRecorder lives in agentfootprint/observe (it's a recorder, not a security primitive)
+//# sourceMappingURL=security.barrel.js.map

package/dist/security.barrel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.barrel.js","sourceRoot":"","sources":["../src/security.barrel.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAEH,yCAA2D;AAAlD,uGAAA,UAAU,OAAA;AAAE,6GAAA,gBAAgB,OAAA;AAErC,iGAAiG"}

package/dist/stages/augmentPrompt.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * AugmentPrompt stage — injects retrieved context into messages before LLM call.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.augmentPromptStage = void 0;
+const types_1 = require("../types");
+function augmentPromptStage(scope) {
+    const result = scope.retrievalResult;
+    // Graceful degradation: if retrieval returned nothing, skip context injection.
+    // LLM proceeds with user query only — useful in hybrid pipelines where retrieval is optional.
+    if (!result || result.chunks.length === 0)
+        return;
+    // Format chunks into numbered context block
+    const context = result.chunks.map((c, i) => `[${i + 1}] ${c.content}`).join('\n\n');
+    scope.contextWindow = context;
+    // Inject context into messages
+    const messages = scope.messages ?? [];
+    const contextMsg = (0, types_1.systemMessage)(`Use the following context to answer the user's question:\n\n${context}`);
+    // Insert after system prompt if present, otherwise at front
+    const sysIdx = messages.findIndex((m) => m.role === 'system');
+    if (sysIdx >= 0) {
+        const updated = [...messages];
+        updated.splice(sysIdx + 1, 0, contextMsg);
+        scope.messages = updated;
+    }
+    else {
+        scope.messages = [contextMsg, ...messages];
+    }
+}
+exports.augmentPromptStage = augmentPromptStage;
+//# sourceMappingURL=augmentPrompt.js.map

package/dist/stages/augmentPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"augmentPrompt.js","sourceRoot":"","sources":["../../src/stages/augmentPrompt.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAGH,oCAAyC;AAGzC,SAAgB,kBAAkB,CAAC,KAA2B;IAC5D,MAAM,MAAM,GAAG,KAAK,CAAC,eAAe,CAAC;IACrC,+EAA+E;IAC/E,8FAA8F;IAC9F,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAElD,4CAA4C;IAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEpF,KAAK,CAAC,aAAa,GAAG,OAAO,CAAC;IAE9B,+BAA+B;IAC/B,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;IACtC,MAAM,UAAU,GAAG,IAAA,qBAAa,EAC9B,+DAA+D,OAAO,EAAE,CACzE,CAAC;IAEF,4DAA4D;IAC5D,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;IAC9D,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAChB,MAAM,OAAO,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC;QAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC;QAC1C,KAAK,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC3B,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,QAAQ,GAAG,CAAC,UAAU,EAAE,GAAG,QAAQ,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC;AA1BD,gDA0BC"}

package/dist/stages/callLLM.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * CallLLM stage — sends messages to LLM via adapter, writes AdapterResult to scope.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCallLLMStage = void 0;
+const helpers_1 = require("./helpers");
+function createCallLLMStage(provider) {
+    return async (scope) => {
+        const messages = scope.messages ?? [];
+        const tools = scope.toolDescriptions ?? [];
+        const options = tools.length > 0 ? { tools } : undefined;
+        const response = await provider.chat(messages, options);
+        scope.adapterRawResponse = response;
+        scope.adapterResult = (0, helpers_1.normalizeAdapterResponse)(response);
+    };
+}
+exports.createCallLLMStage = createCallLLMStage;
+//# sourceMappingURL=callLLM.js.map

package/dist/stages/callLLM.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callLLM.js","sourceRoot":"","sources":["../../src/stages/callLLM.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAKH,uCAAqD;AAErD,SAAgB,kBAAkB,CAAC,QAAqB;IACtD,OAAO,KAAK,EAAE,KAA+B,EAAE,EAAE;QAC/C,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,KAAK,CAAC,gBAAgB,IAAI,EAAE,CAAC;QAE3C,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACzD,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAExD,KAAK,CAAC,kBAAkB,GAAG,QAAQ,CAAC;QACpC,KAAK,CAAC,aAAa,GAAG,IAAA,kCAAwB,EAAC,QAAQ,CAAC,CAAC;IAC3D,CAAC,CAAC;AACJ,CAAC;AAXD,gDAWC"}