agentfootprint 1.0.0

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

@@ -0,0 +1,83 @@
+/**
+ * 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());
+ */
+export 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 = [];
+    }
+}
+//# sourceMappingURL=TurnRecorder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TurnRecorder.js","sourceRoot":"","sources":["../../../../src/recorders/v2/TurnRecorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAcH,MAAM,OAAO,YAAY;IACd,EAAE,CAAS;IACZ,KAAK,GAAgB,EAAE,CAAC;IAEhC,YAAY,EAAE,GAAG,eAAe;QAC9B,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,CAAC;IAED,WAAW,CAAC,KAAqB;QAC/B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YACd,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,MAAM,EAAE,SAAS;SAClB,CAAC,CAAC;IACL,CAAC;IAED,cAAc,CAAC,KAAwB;QACrC,sDAAsD;QACtD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAC9B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,CACnE,CAAC;QACF,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;YACb,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG;gBAChB,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;gBAClB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,YAAY,EAAE,KAAK,CAAC,YAAY;gBAChC,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;gBAC9C,MAAM,EAAE,WAAW;aACpB,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;gBACd,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,OAAO,EAAE,EAAE;gBACX,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,YAAY,EAAE,KAAK,CAAC,YAAY;gBAChC,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;gBAC9C,MAAM,EAAE,WAAW;aACpB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,CAAC,KAAsB;QAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAC9B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,CACnE,CAAC;QACF,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;YACb,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG;gBAChB,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;gBAClB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,MAAM,EAAE,OAAO;aAChB,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,mEAAmE;YACnE,iDAAiD;YACjD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;gBACd,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,OAAO,EAAE,EAAE;gBACX,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,MAAM,EAAE,OAAO;aAChB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,QAAQ;QACN,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,iBAAiB;QACf,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM,CAAC;IACnE,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,MAAM,CAAC;IAC/D,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IAClB,CAAC;CACF"}

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

@@ -0,0 +1,62 @@
+/**
+ * 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 },
+ *   },
+ * });
+ * ```
+ */
+import { CompositeRecorder } from './CompositeRecorder';
+import { CostRecorder } from './CostRecorder';
+import { TokenRecorder } from './TokenRecorder';
+import { ToolUsageRecorder } from './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).
+ */
+export function agentObservability(options) {
+    const tokenRec = new TokenRecorder();
+    const toolRec = new ToolUsageRecorder();
+    const costRec = new CostRecorder(options?.pricing ? { pricingTable: options.pricing } : undefined);
+    const composite = new 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;
+}
+//# sourceMappingURL=agentObservability.js.map

package/dist/esm/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,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAqBxD;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAmC;IACpE,MAAM,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;IACrC,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAE,CAAC;IACxC,MAAM,OAAO,GAAG,IAAI,YAAY,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,iBAAiB,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"}

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

@@ -0,0 +1,13 @@
+/**
+ * recorders/ — AgentRecorder implementations.
+ */
+export { TokenRecorder } from './TokenRecorder';
+export { CostRecorder } from './CostRecorder';
+export { ToolUsageRecorder } from './ToolUsageRecorder';
+export { TurnRecorder } from './TurnRecorder';
+export { QualityRecorder } from './QualityRecorder';
+export { GuardrailRecorder } from './GuardrailRecorder';
+export { CompositeRecorder } from './CompositeRecorder';
+export { PermissionRecorder } from './PermissionRecorder';
+export { agentObservability } from './agentObservability';
+//# sourceMappingURL=index.js.map

package/dist/esm/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,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAM9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/esm/resilience.barrel.js

@@ -0,0 +1,16 @@
+/**
+ * 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]);
+ * ```
+ */
+export { withRetry, withFallback, withCircuitBreaker, CircuitBreaker } from './compositions';
+export { resilientProvider, fallbackProvider } from './adapters';
+//# sourceMappingURL=resilience.barrel.js.map

package/dist/esm/resilience.barrel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resilience.barrel.js","sourceRoot":"","sources":["../../src/resilience.barrel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE7F,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/esm/scope/AgentScope.js

@@ -0,0 +1,153 @@
+/**
+ * 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).
+ */
+/**
+ * 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.
+ */
+export const 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. */
+export const 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. */
+export const MULTI_AGENT_PATHS = {
+    PIPELINE_INPUT: 'pipelineInput',
+    AGENT_RESULTS: 'agentResults',
+    RESULT: 'result',
+    SIGNAL: '_signal',
+    TIMEOUT_MS: '_timeoutMs',
+};
+/** Well-known scope paths for RAG state. */
+export const 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.
+ */
+export const AgentScope = {
+    // ── Reads ──────────────────────────────────────────────
+    getMessages(scope) {
+        const msgs = scope.getValue(AGENT_PATHS.MESSAGES);
+        return msgs ? [...msgs] : [];
+    },
+    getSystemPrompt(scope) {
+        return scope.getValue(AGENT_PATHS.SYSTEM_PROMPT);
+    },
+    getToolDescriptions(scope) {
+        return scope.getValue(AGENT_PATHS.TOOL_DESCRIPTIONS) ?? [];
+    },
+    getAdapterResult(scope) {
+        return scope.getValue(AGENT_PATHS.ADAPTER_RESULT);
+    },
+    getParsedResponse(scope) {
+        return scope.getValue(AGENT_PATHS.PARSED_RESPONSE);
+    },
+    getLoopCount(scope) {
+        return scope.getValue(AGENT_PATHS.LOOP_COUNT) ?? 0;
+    },
+    getMaxIterations(scope) {
+        return scope.getValue(AGENT_PATHS.MAX_ITERATIONS) ?? 10;
+    },
+    getResult(scope) {
+        return scope.getValue(AGENT_PATHS.RESULT);
+    },
+    // ── Writes ─────────────────────────────────────────────
+    setMessages(scope, messages) {
+        scope.setValue(AGENT_PATHS.MESSAGES, messages);
+    },
+    setSystemPrompt(scope, prompt) {
+        scope.setValue(AGENT_PATHS.SYSTEM_PROMPT, prompt);
+    },
+    setToolDescriptions(scope, tools) {
+        scope.setValue(AGENT_PATHS.TOOL_DESCRIPTIONS, tools);
+    },
+    setAdapterResult(scope, result) {
+        scope.setValue(AGENT_PATHS.ADAPTER_RESULT, result);
+    },
+    setParsedResponse(scope, parsed) {
+        scope.setValue(AGENT_PATHS.PARSED_RESPONSE, parsed);
+    },
+    setLoopCount(scope, count) {
+        scope.setValue(AGENT_PATHS.LOOP_COUNT, count);
+    },
+    setMaxIterations(scope, max) {
+        scope.setValue(AGENT_PATHS.MAX_ITERATIONS, max);
+    },
+    setResult(scope, result) {
+        scope.setValue(AGENT_PATHS.RESULT, result);
+    },
+    // ── RAG Reads ───────────────────────────────────────────
+    getRetrievalQuery(scope) {
+        return scope.getValue(RAG_PATHS.RETRIEVAL_QUERY);
+    },
+    getRetrievalResult(scope) {
+        return scope.getValue(RAG_PATHS.RETRIEVAL_RESULT);
+    },
+    getContextWindow(scope) {
+        return scope.getValue(RAG_PATHS.CONTEXT_WINDOW);
+    },
+    // ── RAG Writes ──────────────────────────────────────────
+    setRetrievalQuery(scope, query) {
+        scope.setValue(RAG_PATHS.RETRIEVAL_QUERY, query);
+    },
+    setRetrievalResult(scope, result) {
+        scope.setValue(RAG_PATHS.RETRIEVAL_RESULT, result);
+    },
+    setContextWindow(scope, context) {
+        scope.setValue(RAG_PATHS.CONTEXT_WINDOW, context);
+    },
+    // ── Multi-Agent Reads ──────────────────────────────────────
+    getPipelineInput(scope) {
+        return scope.getValue(MULTI_AGENT_PATHS.PIPELINE_INPUT);
+    },
+    getAgentResults(scope) {
+        return scope.getValue(MULTI_AGENT_PATHS.AGENT_RESULTS) ?? [];
+    },
+    // ── Multi-Agent Writes ─────────────────────────────────────
+    setPipelineInput(scope, input) {
+        scope.setValue(MULTI_AGENT_PATHS.PIPELINE_INPUT, input);
+    },
+    setAgentResults(scope, results) {
+        scope.setValue(MULTI_AGENT_PATHS.AGENT_RESULTS, results);
+    },
+    // ── Memory Reads ───────────────────────────────────────────
+    getShouldCommit(scope) {
+        return scope.getValue(MEMORY_PATHS.SHOULD_COMMIT) === true;
+    },
+    getStoredHistory(scope) {
+        return scope.getValue(MEMORY_PATHS.STORED_HISTORY) ?? [];
+    },
+    getPreparedMessages(scope) {
+        return scope.getValue(MEMORY_PATHS.PREPARED_MESSAGES) ?? [];
+    },
+    // ── Memory Writes ──────────────────────────────────────────
+    setShouldCommit(scope, value) {
+        scope.setValue(MEMORY_PATHS.SHOULD_COMMIT, value);
+    },
+};
+//# sourceMappingURL=AgentScope.js.map

package/dist/esm/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/esm/scope/index.js

@@ -0,0 +1,2 @@
+export { AgentScope, AGENT_PATHS, RAG_PATHS, MULTI_AGENT_PATHS, MEMORY_PATHS } from './AgentScope';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/scope/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/esm/scope/types.js

@@ -0,0 +1,37 @@
+/**
+ * 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
+ *   })
+ */
+// ── 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.
+ */
+export 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 || (AgentScopeKey = {}));
+//# sourceMappingURL=types.js.map

package/dist/esm/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,MAAM,CAAN,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,KAAb,aAAa,QAkBxB"}

package/dist/esm/security.barrel.js

@@ -0,0 +1,17 @@
+/**
+ * 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();
+ * ```
+ */
+export { gatedTools, PermissionPolicy } from './providers';
+// PermissionRecorder lives in agentfootprint/observe (it's a recorder, not a security primitive)
+//# sourceMappingURL=security.barrel.js.map

package/dist/esm/security.barrel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.barrel.js","sourceRoot":"","sources":["../../src/security.barrel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE3D,iGAAiG"}

package/dist/esm/stages/augmentPrompt.js

@@ -0,0 +1,28 @@
+/**
+ * AugmentPrompt stage — injects retrieved context into messages before LLM call.
+ */
+import { systemMessage } from '../types';
+export 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 = 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];
+    }
+}
+//# sourceMappingURL=augmentPrompt.js.map

package/dist/esm/stages/augmentPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"augmentPrompt.js","sourceRoot":"","sources":["../../../src/stages/augmentPrompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,MAAM,UAAU,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,aAAa,CAC9B,+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"}

package/dist/esm/stages/callLLM.js

@@ -0,0 +1,15 @@
+/**
+ * CallLLM stage — sends messages to LLM via adapter, writes AdapterResult to scope.
+ */
+import { normalizeAdapterResponse } from './helpers';
+export 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 = normalizeAdapterResponse(response);
+    };
+}
+//# sourceMappingURL=callLLM.js.map

package/dist/esm/stages/callLLM.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callLLM.js","sourceRoot":"","sources":["../../../src/stages/callLLM.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAErD,MAAM,UAAU,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,wBAAwB,CAAC,QAAQ,CAAC,CAAC;IAC3D,CAAC,CAAC;AACJ,CAAC"}

package/dist/esm/stages/commitMemory.js

@@ -0,0 +1,94 @@
+/**
+ * CommitMemory stage — persist conversation history after the turn completes.
+ *
+ * Behavior:
+ *   - Reads `memory_shouldCommit` flag set by HandleResponse when the turn finalizes.
+ *   - If true: fires `store.save(conversationId, messages)` as a non-blocking Promise
+ *     (fire-and-forget), then calls scope.$break() so the loop ends.
+ *   - If false (tool-call turn still in progress): no-op — loop continues normally.
+ *
+ * Fire-and-forget rationale:
+ *   The caller receives the agent result immediately, without waiting for the DB write
+ *   to complete. This matches the design goal of LangGraph vs agentfootprint: LangGraph
+ *   blocks on its checkpointer; agentfootprint commits in parallel. Save errors are
+ *   caught internally and surfaced via the provided `onSaveError` callback (if any).
+ *
+ *   Dev-mode: if `onSaveError` is omitted and save() fails, a console.warn is emitted in
+ *   non-production environments so silent storage failures surface during development.
+ *
+ * Placement in the chart:
+ *   CommitMemory is placed BEFORE `loopTo('call-llm')`. On tool-call turns it
+ *   passes through (shouldCommit=false). On final turns it saves + breaks.
+ *   This means every loop pass checks whether the turn is done.
+ *
+ * Example:
+ *   SeedScope → PrepareMemory → ... → HandleResponse → CommitMemory → loopTo(CallLLM)
+ */
+const isDevMode = () => process.env['NODE_ENV'] !== 'production';
+/**
+ * Build the CommitMemory stage function.
+ *
+ * Usage:
+ * ```typescript
+ * .addFunction('CommitMemory', createCommitMemoryStage(config), 'commit-memory')
+ * .loopTo('call-llm')
+ * ```
+ */
+export function createCommitMemoryStage(config) {
+    return async (scope) => {
+        const shouldCommit = scope.memory_shouldCommit === true;
+        if (!shouldCommit) {
+            // Tool-call turn — loop continues, nothing to save yet
+            return;
+        }
+        // Reconstruct the full conversation history for storage.
+        //
+        // When a sliding window strategy is active, `messages` in scope contains only
+        // the windowed context + new LLM messages — the oldest turns were trimmed.
+        // We detect this by comparing storedHistory.length vs preparedMessages.length:
+        // if they differ, windowing occurred and we must rebuild from storedHistory.
+        //
+        // Full history = storedHistory (pre-LLM, includes new user message)
+        //              + newLLMMessages (messages appended by CallLLM/ParseResponse)
+        //
+        // PromptAssembly may inject a system message at position 0 when the windowed
+        // prepared context doesn't start with one. We account for that 1-message offset.
+        const messages = scope.messages ?? [];
+        const storedHistory = scope.memory_storedHistory ?? [];
+        const prepared = scope.memory_preparedMessages ?? [];
+        let toSave;
+        if (storedHistory.length > 0 && prepared.length < storedHistory.length) {
+            // Windowing trimmed the history — reconstruct: storedHistory + newLLMMessages.
+            const systemInjected = messages.length > 0 &&
+                messages[0].role === 'system' &&
+                (prepared.length === 0 || prepared[0].role !== 'system');
+            const preparedEnd = systemInjected ? prepared.length + 1 : prepared.length;
+            const newLLMMessages = messages.slice(preparedEnd);
+            toSave = [...storedHistory, ...newLLMMessages];
+        }
+        else {
+            // No windowing — messages array is the complete history.
+            toSave = messages;
+        }
+        // Fire-and-forget: don't await the save — caller gets result immediately.
+        // Use instanceof check to avoid allocating a Promise for synchronous save() returns.
+        const saveResult = config.store.save(config.conversationId, toSave);
+        if (saveResult instanceof Promise) {
+            saveResult.catch((error) => {
+                if (config.onSaveError) {
+                    config.onSaveError(error);
+                }
+                else if (isDevMode()) {
+                    // eslint-disable-next-line no-console
+                    console.warn('[agentfootprint] CommitMemory: store.save() failed and no onSaveError handler was provided.', error);
+                }
+            });
+        }
+        // Break the loop first — this is the real termination signal.
+        scope.$break();
+        // Reset the flag after breaking so CommitMemory is a no-op on any future loop
+        // passes (defensive — $break() already ends the loop).
+        scope.memory_shouldCommit = false;
+    };
+}
+//# sourceMappingURL=commitMemory.js.map

package/dist/esm/stages/commitMemory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commitMemory.js","sourceRoot":"","sources":["../../../src/stages/commitMemory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAkBH,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,YAAY,CAAC;AAEjE;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAA0B;IAChE,OAAO,KAAK,EAAE,KAAiC,EAAE,EAAE;QACjD,MAAM,YAAY,GAAG,KAAK,CAAC,mBAAmB,KAAK,IAAI,CAAC;QAExD,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,uDAAuD;YACvD,OAAO;QACT,CAAC;QAED,yDAAyD;QACzD,EAAE;QACF,8EAA8E;QAC9E,2EAA2E;QAC3E,+EAA+E;QAC/E,6EAA6E;QAC7E,EAAE;QACF,oEAAoE;QACpE,6EAA6E;QAC7E,EAAE;QACF,6EAA6E;QAC7E,iFAAiF;QACjF,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;QACtC,MAAM,aAAa,GAAG,KAAK,CAAC,oBAAoB,IAAI,EAAE,CAAC;QACvD,MAAM,QAAQ,GAAG,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC;QAErD,IAAI,MAAuB,CAAC;QAC5B,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC;YACvE,+EAA+E;YAC/E,MAAM,cAAc,GAClB,QAAQ,CAAC,MAAM,GAAG,CAAC;gBACnB,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ;gBAC7B,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;YAC3D,MAAM,WAAW,GAAG,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC3E,MAAM,cAAc,GAAG,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YACnD,MAAM,GAAG,CAAC,GAAG,aAAa,EAAE,GAAG,cAAc,CAAC,CAAC;QACjD,CAAC;aAAM,CAAC;YACN,yDAAyD;YACzD,MAAM,GAAG,QAAQ,CAAC;QACpB,CAAC;QAED,0EAA0E;QAC1E,qFAAqF;QACrF,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QACpE,IAAI,UAAU,YAAY,OAAO,EAAE,CAAC;YAClC,UAAU,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBAClC,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;oBACvB,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;gBAC5B,CAAC;qBAAM,IAAI,SAAS,EAAE,EAAE,CAAC;oBACvB,sCAAsC;oBACtC,OAAO,CAAC,IAAI,CACV,6FAA6F,EAC7F,KAAK,CACN,CAAC;gBACJ,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;QAED,8DAA8D;QAC9D,KAAK,CAAC,MAAM,EAAE,CAAC;QAEf,8EAA8E;QAC9E,uDAAuD;QACvD,KAAK,CAAC,mBAAmB,GAAG,KAAK,CAAC;IACpC,CAAC,CAAC;AACJ,CAAC"}

package/dist/esm/stages/finalize.js

@@ -0,0 +1,12 @@
+/**
+ * Finalize stage — extract the final response from conversation.
+ */
+import { getTextContent } from '../types/content';
+import { lastAssistantMessage } from '../memory';
+export function finalizeStage(scope) {
+    const messages = scope.messages ?? [];
+    const lastAsst = lastAssistantMessage(messages);
+    const result = lastAsst ? getTextContent(lastAsst.content) : '';
+    scope.result = result;
+}
+//# sourceMappingURL=finalize.js.map

package/dist/esm/stages/finalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finalize.js","sourceRoot":"","sources":["../../../src/stages/finalize.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAEjD,MAAM,UAAU,aAAa,CAAC,KAA+B;IAC3D,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAEhD,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;AACxB,CAAC"}