agentfootprint 1.22.0 → 2.0.1

package/dist/esm/events/dispatcher.js

@@ -0,0 +1,193 @@
+/**
+ * EventDispatcher — the central event bus (one per runner).
+ *
+ * Pattern: Observer (GoF) + Pub/Sub over a typed discriminated union.
+ * Role:    Single flat dispatcher for every event emitted during a run.
+ *          Replaces DOM-style bubbling — we have a central bus by
+ *          construction, so tree propagation is unnecessary.
+ * Emits:   N/A — this IS the emitter. It ROUTES events to listeners.
+ *
+ * Semantics:
+ *   - Observers are ALWAYS fire-and-forget (inherited from footprintjs's
+ *     recorder contract). Promise returns are never awaited.
+ *   - Listener errors are caught; they become `agentfootprint.error.fatal`
+ *     events with stage:'observer'. The run continues.
+ *   - Dispatch is O(1) hash lookup by event type.
+ *   - Zero allocation when no listener for an event type AND no wildcard.
+ *   - Dev-mode wraps listeners to warn on async listener Promise return.
+ */
+import { isDevMode } from 'footprintjs';
+// ─── Dispatcher ──────────────────────────────────────────────────────
+/**
+ * Central event bus. One per executable runner.
+ *
+ * Zero-alloc fast path: if `hasListenersFor(type)` is false AND there are
+ * no wildcards, `dispatch` returns immediately without iteration.
+ */
+export class EventDispatcher {
+    byType = new Map();
+    domainWildcards = new Map();
+    allWildcards = new Set();
+    // ─── Query ────────────────────────────────────────────────────────
+    /**
+     * Fast-path check. Returns true when at least one listener would fire
+     * for this type. Used by emitters to skip event-object allocation.
+     */
+    hasListenersFor(type) {
+        if (this.allWildcards.size > 0)
+            return true;
+        const typed = this.byType.get(type);
+        if (typed && typed.size > 0)
+            return true;
+        const domainKey = this.domainKey(type);
+        const domain = this.domainWildcards.get(domainKey);
+        return domain ? domain.size > 0 : false;
+    }
+    on(type, listener, options) {
+        if (options?.signal?.aborted) {
+            // Already aborted; register nothing.
+            return () => { };
+        }
+        const wrapped = {
+            fn: wrapForDev(listener, type),
+            once: options?.once === true,
+        };
+        const unsubscribe = this.addListener(type, wrapped);
+        if (options?.signal) {
+            options.signal.addEventListener('abort', unsubscribe, { once: true });
+        }
+        return unsubscribe;
+    }
+    once(type, listener) {
+        // Internal listener-add — the public `on()` overloads constrain `type`
+        // to either typed keys or wildcards, but internally the dispatcher's
+        // bucket logic accepts any string and classifies by shape.
+        const wrapped = { fn: wrapForDev(listener, type), once: true };
+        return this.addListener(type, wrapped);
+    }
+    off(type, listener) {
+        const bucket = this.bucketFor(type);
+        if (!bucket)
+            return;
+        const originalFn = originalsMap.get(listener) ?? listener;
+        for (const stored of bucket) {
+            const storedOriginal = originalsMap.get(stored.fn) ?? stored.fn;
+            if (storedOriginal === originalFn) {
+                bucket.delete(stored);
+                return;
+            }
+        }
+    }
+    // ─── Dispatch ─────────────────────────────────────────────────────
+    /**
+     * Route an event to all matching listeners (typed + domain-wildcard + all).
+     *
+     * Fire-and-forget: any returned Promise is IGNORED. Listener exceptions
+     * are caught and re-dispatched as `error.fatal` events with scope='observer'.
+     * The run continues regardless.
+     */
+    dispatch(event) {
+        this.fireBucket(this.byType.get(event.type), event);
+        this.fireBucket(this.domainWildcards.get(this.domainKey(event.type)), event);
+        this.fireBucket(this.allWildcards, event);
+    }
+    // ─── Internals ────────────────────────────────────────────────────
+    addListener(type, stored) {
+        const bucket = this.ensureBucket(type);
+        bucket.add(stored);
+        return () => {
+            bucket.delete(stored);
+        };
+    }
+    ensureBucket(type) {
+        if (type === '*')
+            return this.allWildcards;
+        if (type.endsWith('.*')) {
+            const key = type.slice(0, -2);
+            let bucket = this.domainWildcards.get(key);
+            if (!bucket) {
+                bucket = new Set();
+                this.domainWildcards.set(key, bucket);
+            }
+            return bucket;
+        }
+        let bucket = this.byType.get(type);
+        if (!bucket) {
+            bucket = new Set();
+            this.byType.set(type, bucket);
+        }
+        return bucket;
+    }
+    bucketFor(type) {
+        if (type === '*')
+            return this.allWildcards;
+        if (type.endsWith('.*'))
+            return this.domainWildcards.get(type.slice(0, -2));
+        return this.byType.get(type);
+    }
+    fireBucket(bucket, event) {
+        if (!bucket || bucket.size === 0)
+            return;
+        // Snapshot to allow self-removal during iteration (once-listeners).
+        const snapshot = [...bucket];
+        for (const stored of snapshot) {
+            if (stored.once)
+                bucket.delete(stored);
+            try {
+                stored.fn(event);
+            }
+            catch (err) {
+                // Error isolation — never let a listener break the run. We do not
+                // re-dispatch here to avoid infinite recursion if an error-listener
+                // itself throws. Errors are surfaced via console.error in dev mode.
+                if (isDevMode()) {
+                    // eslint-disable-next-line no-console
+                    console.error(`[agentfootprint] Listener for "${event.type}" threw:`, err);
+                }
+            }
+        }
+    }
+    domainKey(eventType) {
+        // 'agentfootprint.context.injected' → 'agentfootprint.context'
+        const lastDot = eventType.lastIndexOf('.');
+        return lastDot === -1 ? eventType : eventType.slice(0, lastDot);
+    }
+}
+// ─── Dev-mode async-listener warning wrapper ─────────────────────────
+/**
+ * Original-function map — preserves consumer's function identity across
+ * dev-mode wrapping so `off(type, originalFn)` still finds and removes
+ * the stored listener.
+ */
+// eslint-disable-next-line @typescript-eslint/ban-types -- WeakMap value preserves arbitrary listener identity; narrowing breaks identity equality.
+const originalsMap = new WeakMap();
+/**
+ * Wrap a listener in dev mode to warn if it returns a Promise.
+ * Production pass-through.
+ *
+ * Why: consumers occasionally write `on('x', async (e) => await ...)` and
+ * expect the dispatcher to wait. It does NOT — observers are always
+ * fire-and-forget. This warning catches the mistake loudly in dev.
+ */
+function wrapForDev(listener, type) {
+    if (!isDevMode())
+        return listener;
+    const wrapped = (event) => {
+        const result = listener(event);
+        if (result && typeof result === 'object' && 'then' in result) {
+            // eslint-disable-next-line no-console
+            console.warn(`[agentfootprint] Listener for "${type}" returned a Promise.\n` +
+                `Observers are NEVER awaited — your Promise will run in the background.\n` +
+                `If you need back-pressure, collect promises and await AFTER run().\n` +
+                `  See: https://agentfootprint.dev/docs/events/async-listeners`);
+            // Capture unhandled rejections so they don't vanish silently.
+            result.catch((err) => {
+                // eslint-disable-next-line no-console
+                console.error(`[agentfootprint] Listener Promise for "${type}" rejected:`, err);
+            });
+        }
+    };
+    originalsMap.set(wrapped, listener);
+    return wrapped;
+}
+//# sourceMappingURL=dispatcher.js.map

package/dist/esm/events/dispatcher.js.map

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

package/dist/esm/events/payloads.js

@@ -0,0 +1,9 @@
+/**
+ * Event payload types — the 45 typed event payloads across 13 domains.
+ *
+ * Pattern: Discriminated Union (Gang of Four inspired, TS-native).
+ * Role:    Contract layer of Event-Driven Hexagonal Architecture.
+ * Emits:   (types only).
+ */
+export {};
+//# sourceMappingURL=payloads.js.map

package/dist/esm/events/payloads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payloads.js","sourceRoot":"","sources":["../../../src/events/payloads.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/esm/events/registry.js

@@ -0,0 +1,151 @@
+/**
+ * Event registry — 45 typed events across 13 domains.
+ *
+ * Pattern: Discriminated Union + Typed Factory (Gang of Four adapted for TS).
+ * Role:    The stable public event contract — the "ports" of the hexagonal
+ *          architecture (Cockburn, 2005).
+ * Emits:   N/A — this file DEFINES event types and factory helpers.
+ *
+ * Consumers subscribe via `.on(type, listener)`. Emitters construct events
+ * via typed helpers (e.g. `makeContextInjected(payload)`) rather than raw
+ * strings — compile-time safety prevents typos and payload drift.
+ *
+ * Events are additive within a major version; breaking changes require a
+ * major bump. See agentfootprint_v2_detailed_design.md for rules.
+ */
+// ─── Event type constants ─────────────────────────────────────────────
+// Single source of truth for every event name. Low cardinality (~45),
+// all under the `agentfootprint.` namespace, three-segment dotted form.
+export const EVENT_NAMES = {
+    composition: {
+        enter: 'agentfootprint.composition.enter',
+        exit: 'agentfootprint.composition.exit',
+        forkStart: 'agentfootprint.composition.fork_start',
+        branchComplete: 'agentfootprint.composition.branch_complete',
+        mergeEnd: 'agentfootprint.composition.merge_end',
+        routeDecided: 'agentfootprint.composition.route_decided',
+        iterationStart: 'agentfootprint.composition.iteration_start',
+        iterationExit: 'agentfootprint.composition.iteration_exit',
+    },
+    agent: {
+        turnStart: 'agentfootprint.agent.turn_start',
+        turnEnd: 'agentfootprint.agent.turn_end',
+        iterationStart: 'agentfootprint.agent.iteration_start',
+        iterationEnd: 'agentfootprint.agent.iteration_end',
+        routeDecided: 'agentfootprint.agent.route_decided',
+        handoff: 'agentfootprint.agent.handoff',
+    },
+    stream: {
+        llmStart: 'agentfootprint.stream.llm_start',
+        llmEnd: 'agentfootprint.stream.llm_end',
+        token: 'agentfootprint.stream.token',
+        toolStart: 'agentfootprint.stream.tool_start',
+        toolEnd: 'agentfootprint.stream.tool_end',
+    },
+    context: {
+        injected: 'agentfootprint.context.injected',
+        evicted: 'agentfootprint.context.evicted',
+        slotComposed: 'agentfootprint.context.slot_composed',
+        budgetPressure: 'agentfootprint.context.budget_pressure',
+    },
+    memory: {
+        strategyApplied: 'agentfootprint.memory.strategy_applied',
+        attached: 'agentfootprint.memory.attached',
+        detached: 'agentfootprint.memory.detached',
+        written: 'agentfootprint.memory.written',
+    },
+    tools: {
+        offered: 'agentfootprint.tools.offered',
+        activated: 'agentfootprint.tools.activated',
+        deactivated: 'agentfootprint.tools.deactivated',
+    },
+    skill: {
+        activated: 'agentfootprint.skill.activated',
+        deactivated: 'agentfootprint.skill.deactivated',
+    },
+    permission: {
+        check: 'agentfootprint.permission.check',
+        gateOpened: 'agentfootprint.permission.gate_opened',
+        gateClosed: 'agentfootprint.permission.gate_closed',
+    },
+    risk: {
+        flagged: 'agentfootprint.risk.flagged',
+    },
+    fallback: {
+        triggered: 'agentfootprint.fallback.triggered',
+    },
+    cost: {
+        tick: 'agentfootprint.cost.tick',
+        limitHit: 'agentfootprint.cost.limit_hit',
+    },
+    eval: {
+        score: 'agentfootprint.eval.score',
+        thresholdCrossed: 'agentfootprint.eval.threshold_crossed',
+    },
+    error: {
+        retried: 'agentfootprint.error.retried',
+        recovered: 'agentfootprint.error.recovered',
+        fatal: 'agentfootprint.error.fatal',
+    },
+    pause: {
+        request: 'agentfootprint.pause.request',
+        resume: 'agentfootprint.pause.resume',
+    },
+    embedding: {
+        generated: 'agentfootprint.embedding.generated',
+    },
+};
+/**
+ * Complete list of every registered event type, for lint / runtime validation.
+ * A new event MUST be added here or the exhaustiveness tests fail.
+ */
+export const ALL_EVENT_TYPES = [
+    'agentfootprint.composition.enter',
+    'agentfootprint.composition.exit',
+    'agentfootprint.composition.fork_start',
+    'agentfootprint.composition.branch_complete',
+    'agentfootprint.composition.merge_end',
+    'agentfootprint.composition.route_decided',
+    'agentfootprint.composition.iteration_start',
+    'agentfootprint.composition.iteration_exit',
+    'agentfootprint.agent.turn_start',
+    'agentfootprint.agent.turn_end',
+    'agentfootprint.agent.iteration_start',
+    'agentfootprint.agent.iteration_end',
+    'agentfootprint.agent.route_decided',
+    'agentfootprint.agent.handoff',
+    'agentfootprint.stream.llm_start',
+    'agentfootprint.stream.llm_end',
+    'agentfootprint.stream.token',
+    'agentfootprint.stream.tool_start',
+    'agentfootprint.stream.tool_end',
+    'agentfootprint.context.injected',
+    'agentfootprint.context.evicted',
+    'agentfootprint.context.slot_composed',
+    'agentfootprint.context.budget_pressure',
+    'agentfootprint.memory.strategy_applied',
+    'agentfootprint.memory.attached',
+    'agentfootprint.memory.detached',
+    'agentfootprint.memory.written',
+    'agentfootprint.tools.offered',
+    'agentfootprint.tools.activated',
+    'agentfootprint.tools.deactivated',
+    'agentfootprint.skill.activated',
+    'agentfootprint.skill.deactivated',
+    'agentfootprint.permission.check',
+    'agentfootprint.permission.gate_opened',
+    'agentfootprint.permission.gate_closed',
+    'agentfootprint.risk.flagged',
+    'agentfootprint.fallback.triggered',
+    'agentfootprint.cost.tick',
+    'agentfootprint.cost.limit_hit',
+    'agentfootprint.eval.score',
+    'agentfootprint.eval.threshold_crossed',
+    'agentfootprint.error.retried',
+    'agentfootprint.error.recovered',
+    'agentfootprint.error.fatal',
+    'agentfootprint.pause.request',
+    'agentfootprint.pause.resume',
+    'agentfootprint.embedding.generated',
+];
+//# sourceMappingURL=registry.js.map

package/dist/esm/events/registry.js.map

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

package/dist/esm/events/types.js

@@ -0,0 +1,9 @@
+/**
+ * EventMeta + shared event vocabulary.
+ *
+ * Pattern: Domain-Driven Design value objects (Evans, 2003).
+ * Role:    Shared vocabulary for all 45 typed events in registry.ts.
+ * Emits:   (types only — no runtime behavior here).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/events/types.js.map

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

package/dist/esm/index.js

@@ -1,37 +1,122 @@
 /**
- * agentfootprint — The explainable agent framework.
+ * agentfootprint — public barrel.
  *
- * Core: builders, tools, providers, messages, types.
- *
- * Focused capabilities (also importable from subpaths):
- *   agentfootprint/instructions  → Conditional context injection
- *   agentfootprint/observe       → Monitor execution (recorders)
- *   agentfootprint/resilience    → Retry, fallback, circuit breaker
- *   agentfootprint/security      → Tool gating, permissions
- *   agentfootprint/explain       → Narrative, grounding analysis
- *   agentfootprint/stream        → Real-time lifecycle events
+ * Pattern: Facade (GoF) over the typed sublayers.
+ * Role:    Single entry point consumers import from.
+ * Emits:   N/A.
  */
-// ── Concepts (Builders + Runners) ───────────────────────────
-export { Agent, AgentRunner, LLMCall, LLMCallRunner, RAG, RAGRunner, FlowChart, FlowChartRunner, Swarm, SwarmRunner, Parallel, ParallelRunner, Conditional, ConditionalRunner, } from './concepts';
-// ── Trace export (paste-into-viewer / share-with-support workflow) ─
-export { exportTrace } from './exportTrace';
-// ── Tools ───────────────────────────────────────────────────
-export { defineTool, askHuman, ToolRegistry } from './tools';
-// ── Providers (core — you can't build an agent without these) ─
-export { mock, MockAdapter, mockRetriever, MockRetriever, createProvider } from './adapters';
-export { anthropic, openai, ollama, bedrock } from './models';
-export { AnthropicAdapter, OpenAIAdapter, BedrockAdapter } from './adapters';
-export { BrowserAnthropicAdapter, BrowserOpenAIAdapter } from './adapters';
-// ── Messages + Content ──────────────────────────────────────
-export { systemMessage, userMessage, assistantMessage, toolResultMessage, textBlock, imageBlock, base64Image, urlImage, } from './types';
-// ── Errors ──────────────────────────────────────────────────
-export { LLMError } from './types';
-// ── Agent Loop (low-level engine) ──────────────────────────
-export { agentLoop } from './executor';
-// ── Instructions (also available from agentfootprint/instructions) ──
-export { defineInstruction, AgentPattern, quickBind } from './instructions.barrel';
-// ── Skills (also available from agentfootprint/skills) ──
-export { defineSkill, SkillRegistry } from './skills.barrel';
-// ── Recorders (also available from agentfootprint/observe) ──
-export { TokenRecorder, ToolUsageRecorder, TurnRecorder, CostRecorder, contextEngineering, agentTimeline, } from './observe.barrel';
+// Events — registry, types, payloads
+export * from './events/types.js';
+export * from './events/payloads.js';
+export { EVENT_NAMES, ALL_EVENT_TYPES, } from './events/registry.js';
+// Dispatcher
+export { EventDispatcher, } from './events/dispatcher.js';
+// Adapter interfaces (ports)
+export * from './adapters/types.js';
+// Injection keys + recorder authoring helpers — needed by anyone writing
+// a custom recorder that switches on injection events.
+export { INJECTION_KEYS, injectionKeyForSlot, isInjectionKey, } from './conventions.js';
+// `STAGE_IDS`, `SUBFLOW_IDS`, `isSlotSubflow`, `slotFromSubflowId`,
+// `isKnownStage`, `isKnownSubflow` are intentionally NOT exported — they
+// are the internal builder↔recorder coordination protocol, not consumer
+// API. Library code reaches them via the relative `./conventions.js`
+// import; downstream code should never need them.
+export { COMPOSITION_KEYS, } from './recorders/core/types.js';
+// Bridge helper
+export { buildEventMeta, parseSubflowPath } from './bridge/eventMeta.js';
+// Core recorders
+export { ContextRecorder } from './recorders/core/ContextRecorder.js';
+export { EmitBridge } from './recorders/core/EmitBridge.js';
+export { streamRecorder } from './recorders/core/StreamRecorder.js';
+export { agentRecorder } from './recorders/core/AgentRecorder.js';
+export { compositionRecorder, } from './recorders/core/CompositionRecorder.js';
+export { costRecorder } from './recorders/core/CostRecorder.js';
+export { permissionRecorder, } from './recorders/core/PermissionRecorder.js';
+export { evalRecorder } from './recorders/core/EvalRecorder.js';
+export { memoryRecorder } from './recorders/core/MemoryRecorder.js';
+export { skillRecorder } from './recorders/core/SkillRecorder.js';
+export { typedEmit } from './recorders/core/typedEmit.js';
+export { RunnerBase, makeRunId } from './core/RunnerBase.js';
+// Pause/Resume primitives — consumer API for human-in-the-loop tools.
+// `PauseRequest` (the throwable signal class) stays internal; consumers
+// detect pauses via `isPauseRequest(err)` / `isPaused(outcome)`.
+// `askHuman` is the HITL-named alias for `pauseHere` — same behavior,
+// reads more naturally inside a tool that's asking a person to decide.
+export { pauseHere, askHuman, isPauseRequest, isPaused, } from './core/pause.js';
+// Tier 3 observability (enable.* namespace)
+export { attachThinking, } from './recorders/observability/ThinkingRecorder.js';
+export { attachLogging, LoggingDomains, } from './recorders/observability/LoggingRecorder.js';
+export { attachFlowchart, } from './recorders/observability/FlowchartRecorder.js';
+export { BoundaryRecorder, boundaryRecorder, } from './recorders/observability/BoundaryRecorder.js';
+// Commentary — bundled prose templates + engine for narrating a run.
+// Consumers ship their own JSON locale / brand voice via the same
+// shape; viewers (Lens, CLI tail, log file) consume this surface.
+export { defaultCommentaryTemplates, selectCommentaryKey, extractCommentaryVars, renderCommentary, } from './recorders/observability/commentary/commentaryTemplates.js';
+// Thinking — chat-bubble surface (separate audience: the end user
+// chatting). State machine: idle / streaming / tool / paused. Same
+// contract shape as commentary (`Record<string, string>` with
+// `{{vars}}`, partial overrides supported, missing keys ignored)
+// but a different vocabulary — first-person status, mid-call only.
+// Per-tool keys (`tool.<toolName>`) win over the generic `tool` key.
+export { defaultThinkingTemplates, selectThinkingState, renderThinkingLine, } from './recorders/observability/thinking/thinkingTemplates.js';
+// Primitives (core/)
+export { LLMCall, LLMCallBuilder, } from './core/LLMCall.js';
+export { Agent, AgentBuilder, } from './core/Agent.js';
+export { defineTool } from './core/tools.js';
+// Slot subflow builders are intentionally NOT exported. They are
+// internal helpers used only by `Agent.buildChart()` and
+// `LLMCall.buildChart()` to construct each primitive's three-slot
+// context-engineering subflow tree. Consumers compose at the
+// primitive / composition level (Agent / LLMCall / Sequence / …) — they
+// never construct slot subflows directly. Power-users authoring a
+// custom Agent-like primitive should copy the pattern from
+// `src/core/Agent.ts` rather than depend on a private helper surface.
+// Compositions (core-flow/)
+export { Sequence, SequenceBuilder, } from './core-flow/Sequence.js';
+export { Parallel, ParallelBuilder, } from './core-flow/Parallel.js';
+export { Conditional, ConditionalBuilder, } from './core-flow/Conditional.js';
+export { Loop, LoopBuilder, } from './core-flow/Loop.js';
+// Adapters — LLM providers
+// `mock(...)` is the lowercase factory equivalent to `new MockProvider(...)`.
+// `anthropic(...)` is the real Claude provider via `@anthropic-ai/sdk`.
+export { MockProvider, mock } from './adapters/llm/MockProvider.js';
+export { anthropic, AnthropicProvider, } from './adapters/llm/AnthropicProvider.js';
+export { openai, OpenAIProvider, ollama, } from './adapters/llm/OpenAIProvider.js';
+export { bedrock, BedrockProvider, } from './adapters/llm/BedrockProvider.js';
+export { browserAnthropic, BrowserAnthropicProvider, } from './adapters/llm/BrowserAnthropicProvider.js';
+export { browserOpenai, BrowserOpenAIProvider, } from './adapters/llm/BrowserOpenAIProvider.js';
+export { createProvider, } from './adapters/llm/createProvider.js';
+// Streaming helpers — agent events → SSE for browser delivery.
+export { toSSE, SSEFormatter, encodeSSE } from './stream.js';
+// Injection Engine — the unifying primitive of context engineering.
+// One Injection type, four sugar factories, one engine subflow.
+export { 
+// Engine
+evaluateInjections, buildInjectionEngineSubflow, 
+// Sugar factories — one per injection flavor
+defineInstruction, defineSkill, defineSteering, defineFact, } from './lib/injection-engine/index.js';
+// Patterns — factory functions composing primitives + core-flow into
+// well-known agent patterns from the research literature.
+export * from './patterns/index.js';
+// Memory subsystem — narrative beats, fact extraction, embedding-based
+// retrieval, and pipelines that compose them. Top-level barrel exports
+// the most-used factories; the full subsystem (including types that
+// would collide with adapter types like MemoryStore) is reachable via
+// the `agentfootprint/memory` subpath import.
+export { 
+// Pipelines
+defaultPipeline, ephemeralPipeline, factPipeline, narrativePipeline, semanticPipeline, autoPipeline, } from './memory/pipeline/index.js';
+export { 
+// Beat extractors
+heuristicExtractor, llmExtractor, } from './memory/beats/index.js';
+export { 
+// Fact extractors
+patternFactExtractor, llmFactExtractor, } from './memory/facts/index.js';
+export { 
+// Layered memory API — consumer-facing factory + const-objects
+defineMemory, MEMORY_TYPES, MEMORY_STRATEGIES, MEMORY_TIMING, SNAPSHOT_PROJECTIONS, 
+// Reference implementations + helpers consumers reach for daily.
+// Real-backend adapters (Redis, Postgres, Pinecone, ...) ship as
+// separate subpath exports.
+InMemoryStore, mockEmbedder, identityNamespace, } from './memory/index.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,+DAA+D;AAC/D,OAAO,EACL,KAAK,EACL,WAAW,EACX,OAAO,EACP,aAAa,EACb,GAAG,EACH,SAAS,EACT,SAAS,EACT,eAAe,EACf,KAAK,EACL,WAAW,EACX,QAAQ,EACR,cAAc,EACd,WAAW,EACX,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAQpB,sEAAsE;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,+DAA+D;AAC/D,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE7D,iEAAiE;AACjE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC7F,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAc3E,+DAA+D;AAC/D,OAAO,EACL,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,EACT,UAAU,EACV,WAAW,EACX,QAAQ,GACT,MAAM,SAAS,CAAC;AAEjB,+DAA+D;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AA4BnC,8DAA8D;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGvC,uEAAuE;AACvE,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGnF,2DAA2D;AAC3D,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAS7D,+DAA+D;AAC/D,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,aAAa,GACd,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/esm/injection-engine.js

@@ -0,0 +1,5 @@
+/**
+ * agentfootprint/injection-engine — public re-export for the InjectionEngine subsystem.
+ */
+export * from './lib/injection-engine/index.js';
+//# sourceMappingURL=injection-engine.js.map

package/dist/esm/injection-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"injection-engine.js","sourceRoot":"","sources":["../../src/injection-engine.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,iCAAiC,CAAC"}