agentfootprint 1.23.0 → 2.1.0

package/dist/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;AAEH,kEAKwC;AAJtC,+GAAA,YAAY,OAAA;AACZ,uGAAA,IAAI,OAAA;AAKN,4EAI6C;AAH3C,iHAAA,SAAS,OAAA;AACT,yHAAA,iBAAiB,OAAA;AAInB,sEAK0C;AAJxC,2GAAA,MAAM,OAAA;AACN,mHAAA,cAAc,OAAA;AACd,2GAAA,MAAM,OAAA;AAIR,wEAI2C;AAHzC,6GAAA,OAAO,OAAA;AACP,qHAAA,eAAe,OAAA;AAIjB,0FAIoD;AAHlD,+HAAA,gBAAgB,OAAA;AAChB,uIAAA,wBAAwB,OAAA;AAI1B,oFAIiD;AAH/C,yHAAA,aAAa,OAAA;AACb,iIAAA,qBAAqB,OAAA;AAIvB,sEAI0C;AAHxC,mHAAA,cAAc,OAAA"}

package/dist/recorders/core/AgentRecorder.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * AgentRecorder — forwards `agentfootprint.agent.*` emits to the dispatcher.
+ *
+ * Pattern: Factory (GoF) returning an EmitBridge instance.
+ * Role:    Convenience constructor for the agent-lifecycle bridge recorder.
+ *          Same mechanics as StreamRecorder, scoped to agent.* events
+ *          (turns + iterations + route decisions + handoffs).
+ * Emits:   agentfootprint.agent.turn_start / turn_end / iteration_start /
+ *          iteration_end / route_decided / handoff
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentRecorder = void 0;
+const EmitBridge_js_1 = require("./EmitBridge.js");
+function agentRecorder(options) {
+    return new EmitBridge_js_1.EmitBridge({
+        id: options.id ?? 'agentfootprint.agent-recorder',
+        prefix: 'agentfootprint.agent.',
+        dispatcher: options.dispatcher,
+        getRunContext: options.getRunContext,
+    });
+}
+exports.agentRecorder = agentRecorder;
+//# sourceMappingURL=AgentRecorder.js.map

package/dist/recorders/core/AgentRecorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRecorder.js","sourceRoot":"","sources":["../../../src/recorders/core/AgentRecorder.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,mDAAqE;AAMrE,SAAgB,aAAa,CAAC,OAA6B;IACzD,OAAO,IAAI,0BAAU,CAAC;QACpB,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,+BAA+B;QACjD,MAAM,EAAE,uBAAuB;QAC/B,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,aAAa,EAAE,OAAO,CAAC,aAAa;KACrC,CAAC,CAAC;AACL,CAAC;AAPD,sCAOC"}

package/dist/recorders/core/CompositionRecorder.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * CompositionRecorder — forwards `agentfootprint.composition.*` emits to the dispatcher.
+ *
+ * Pattern: Factory (GoF) returning an EmitBridge instance.
+ * Role:    Convenience constructor for the composition-domain bridge recorder.
+ *          Compositions (Sequence, Parallel, Conditional, Loop) typedEmit
+ *          composition.enter/exit/fork_start/branch_complete/merge_end/
+ *          route_decided/iteration_start/iteration_exit from their internal
+ *          stages; this recorder observes via footprintjs's EmitRecorder
+ *          channel and re-dispatches with typed payloads + meta.
+ * Emits:   agentfootprint.composition.*
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compositionRecorder = void 0;
+const EmitBridge_js_1 = require("./EmitBridge.js");
+function compositionRecorder(options) {
+    return new EmitBridge_js_1.EmitBridge({
+        id: options.id ?? 'agentfootprint.composition-recorder',
+        prefix: 'agentfootprint.composition.',
+        dispatcher: options.dispatcher,
+        getRunContext: options.getRunContext,
+    });
+}
+exports.compositionRecorder = compositionRecorder;
+//# sourceMappingURL=CompositionRecorder.js.map

package/dist/recorders/core/CompositionRecorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompositionRecorder.js","sourceRoot":"","sources":["../../../src/recorders/core/CompositionRecorder.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAEH,mDAAqE;AAMrE,SAAgB,mBAAmB,CAAC,OAAmC;IACrE,OAAO,IAAI,0BAAU,CAAC;QACpB,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,qCAAqC;QACvD,MAAM,EAAE,6BAA6B;QACrC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,aAAa,EAAE,OAAO,CAAC,aAAa;KACrC,CAAC,CAAC;AACL,CAAC;AAPD,kDAOC"}

package/dist/recorders/core/ContextRecorder.js

@@ -0,0 +1,222 @@
+"use strict";
+/**
+ * ContextRecorder — observes footprintjs subflow + scope events, emits
+ * grouped `context.*` domain events via the EventDispatcher.
+ *
+ * Pattern: Observer (GoF) + Pipes & Filters (Hohpe & Woolf, 2003).
+ * Role:    Core semantic grouping layer for the 3-slot model. Watches
+ *          slot subflows (sf-system-prompt / sf-messages / sf-tools) and
+ *          translates raw writes into context.injected / evicted /
+ *          slot_composed / budget_pressure events.
+ * Emits:   agentfootprint.context.injected
+ *          agentfootprint.context.evicted
+ *          agentfootprint.context.slot_composed
+ *          agentfootprint.context.budget_pressure
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextRecorder = void 0;
+const conventions_js_1 = require("../../conventions.js");
+const eventMeta_js_1 = require("../../bridge/eventMeta.js");
+const types_js_1 = require("./types.js");
+class ContextRecorder {
+    id;
+    dispatcher;
+    getRunContext;
+    // Active slot stack — stacked because a slot subflow CAN nest another
+    // (rare but possible if a custom source is a subflow itself).
+    slotStack = [];
+    // Previously seen injections per slot, by scope key. We diff old-vs-new
+    // on each write to identify NEW injections (the builder may write the
+    // whole array multiple times; we only emit events for the additions).
+    seenInjections = new Map();
+    constructor(options) {
+        this.dispatcher = options.dispatcher;
+        this.id = options.id ?? 'agentfootprint.context-recorder';
+        this.getRunContext = options.getRunContext;
+    }
+    // ─── Subflow boundaries ────────────────────────────────────────
+    onSubflowEntry(event) {
+        const slot = event.subflowId ? (0, conventions_js_1.slotFromSubflowId)(event.subflowId) : undefined;
+        if (!slot)
+            return;
+        this.slotStack.push(slot);
+        // Reset the seen-set for this slot — new iteration.
+        this.seenInjections.set(slot, new Set());
+    }
+    onSubflowExit(event) {
+        if (!event.subflowId)
+            return;
+        const slot = (0, conventions_js_1.slotFromSubflowId)(event.subflowId);
+        if (!slot)
+            return;
+        // Pop only if this is the active top (defensive against mis-ordering).
+        if (this.slotStack[this.slotStack.length - 1] === slot) {
+            this.slotStack.pop();
+        }
+        this.seenInjections.delete(slot);
+    }
+    // ─── Scope writes — the injection / eviction / pressure signals ──
+    onWrite(event) {
+        const activeSlot = this.currentSlot();
+        if (!activeSlot)
+            return;
+        const key = event.key;
+        // Injection signals (INJECTION_KEYS) — per-slot arrays of InjectionRecord.
+        if (key === conventions_js_1.INJECTION_KEYS.SYSTEM_PROMPT && activeSlot === 'system-prompt') {
+            this.handleInjectionsWrite(activeSlot, event);
+            return;
+        }
+        if (key === conventions_js_1.INJECTION_KEYS.MESSAGES && activeSlot === 'messages') {
+            this.handleInjectionsWrite(activeSlot, event);
+            return;
+        }
+        if (key === conventions_js_1.INJECTION_KEYS.TOOLS && activeSlot === 'tools') {
+            this.handleInjectionsWrite(activeSlot, event);
+            return;
+        }
+        // Composition summary — ONE record per slot exit, written just before exit.
+        if (key === types_js_1.COMPOSITION_KEYS.SLOT_COMPOSED) {
+            this.handleSlotComposedWrite(event);
+            return;
+        }
+        // Evictions — per-piece removals under budget pressure.
+        if (key === types_js_1.COMPOSITION_KEYS.EVICTED) {
+            this.handleEvictionsWrite(event);
+            return;
+        }
+        // Budget-pressure warnings — fired BEFORE evictions.
+        if (key === types_js_1.COMPOSITION_KEYS.BUDGET_PRESSURE) {
+            this.handleBudgetPressureWrite(event);
+            return;
+        }
+    }
+    // ─── Internals ─────────────────────────────────────────────────
+    currentSlot() {
+        return this.slotStack[this.slotStack.length - 1];
+    }
+    handleInjectionsWrite(slot, event) {
+        const records = this.asInjectionArray(event.value);
+        if (!records)
+            return;
+        const seen = this.seenInjections.get(slot) ?? new Set();
+        for (const rec of records) {
+            if (seen.has(rec.contentHash))
+                continue;
+            seen.add(rec.contentHash);
+            this.emitInjected(rec, event);
+        }
+        this.seenInjections.set(slot, seen);
+    }
+    handleSlotComposedWrite(event) {
+        const rec = this.asSlotComposition(event.value);
+        if (!rec)
+            return;
+        this.dispatch('agentfootprint.context.slot_composed', rec, event);
+    }
+    handleEvictionsWrite(event) {
+        const records = this.asEvictionArray(event.value);
+        if (!records)
+            return;
+        for (const rec of records) {
+            this.dispatch('agentfootprint.context.evicted', rec, event);
+        }
+    }
+    handleBudgetPressureWrite(event) {
+        const records = this.asPressureArray(event.value);
+        if (!records)
+            return;
+        for (const rec of records) {
+            this.dispatch('agentfootprint.context.budget_pressure', rec, event);
+        }
+    }
+    emitInjected(rec, event) {
+        // Payload is a structural subset of InjectionRecord — InjectionRecord is
+        // designed to carry exactly what ContextInjectedPayload needs, so we
+        // copy through directly.
+        //
+        // Redaction: footprintjs's scope layer sets `event.redacted = true` if
+        // its RedactionPolicy matched the scope key. We trust that flag —
+        // `rec.rawContent` arrives already-redacted if it was going to be. We
+        // do NOT re-implement redaction here (single source of truth in
+        // footprintjs's RedactionPolicy).
+        this.dispatch('agentfootprint.context.injected', rec, event);
+    }
+    dispatch(type, payload, source) {
+        if (!this.dispatcher.hasListenersFor(type))
+            return;
+        // FlowSubflowEvent nests traversal info under .traversalContext.
+        // WriteEvent flattens runtimeStageId + stageId at the top level via
+        // RecorderContext. buildEventMeta accepts either shape.
+        const origin = 'traversalContext' in source && source.traversalContext
+            ? source.traversalContext
+            : source;
+        const meta = (0, eventMeta_js_1.buildEventMeta)(origin, this.getRunContext());
+        this.dispatcher.dispatch({ type, payload, meta });
+    }
+    // ─── Type-narrowing helpers ────────────────────────────────────
+    asInjectionArray(value) {
+        if (!Array.isArray(value))
+            return undefined;
+        // Duck-type — require at least `contentHash` + `slot` + `source`.
+        for (const r of value) {
+            if (!r || typeof r !== 'object')
+                return undefined;
+            const rec = r;
+            if (typeof rec.contentHash !== 'string')
+                return undefined;
+            if (typeof rec.slot !== 'string')
+                return undefined;
+            if (typeof rec.source !== 'string')
+                return undefined;
+        }
+        return value;
+    }
+    asSlotComposition(value) {
+        if (!value || typeof value !== 'object')
+            return undefined;
+        const rec = value;
+        if (typeof rec.slot !== 'string')
+            return undefined;
+        if (typeof rec.iteration !== 'number')
+            return undefined;
+        if (!rec.budget || typeof rec.budget !== 'object')
+            return undefined;
+        if (!rec.sourceBreakdown || typeof rec.sourceBreakdown !== 'object')
+            return undefined;
+        if (typeof rec.droppedCount !== 'number')
+            return undefined;
+        if (!Array.isArray(rec.droppedSummaries))
+            return undefined;
+        return value;
+    }
+    asEvictionArray(value) {
+        if (!Array.isArray(value))
+            return undefined;
+        for (const r of value) {
+            if (!r || typeof r !== 'object')
+                return undefined;
+            const rec = r;
+            if (typeof rec.slot !== 'string')
+                return undefined;
+            if (typeof rec.contentHash !== 'string')
+                return undefined;
+        }
+        return value;
+    }
+    asPressureArray(value) {
+        if (!Array.isArray(value))
+            return undefined;
+        for (const r of value) {
+            if (!r || typeof r !== 'object')
+                return undefined;
+            const rec = r;
+            if (typeof rec.slot !== 'string')
+                return undefined;
+            if (typeof rec.capTokens !== 'number')
+                return undefined;
+        }
+        return value;
+    }
+}
+exports.ContextRecorder = ContextRecorder;
+//# sourceMappingURL=ContextRecorder.js.map

package/dist/recorders/core/ContextRecorder.js.map

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

package/dist/recorders/core/CostRecorder.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * CostRecorder — forwards `agentfootprint.cost.*` emits to the dispatcher.
+ *
+ * Pattern: Factory (GoF) returning an EmitBridge instance.
+ * Role:    Bridges `cost.tick` + `cost.limit_hit` emits from LLMCall / Agent
+ *          stages (via `emitCostTick`) to the EventDispatcher so typed
+ *          consumer listeners fire.
+ * Emits:   agentfootprint.cost.tick / cost.limit_hit
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.costRecorder = void 0;
+const EmitBridge_js_1 = require("./EmitBridge.js");
+function costRecorder(options) {
+    return new EmitBridge_js_1.EmitBridge({
+        id: options.id ?? 'agentfootprint.cost-recorder',
+        prefix: 'agentfootprint.cost.',
+        dispatcher: options.dispatcher,
+        getRunContext: options.getRunContext,
+    });
+}
+exports.costRecorder = costRecorder;
+//# sourceMappingURL=CostRecorder.js.map

package/dist/recorders/core/CostRecorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CostRecorder.js","sourceRoot":"","sources":["../../../src/recorders/core/CostRecorder.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,mDAAqE;AAMrE,SAAgB,YAAY,CAAC,OAA4B;IACvD,OAAO,IAAI,0BAAU,CAAC;QACpB,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,8BAA8B;QAChD,MAAM,EAAE,sBAAsB;QAC9B,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,aAAa,EAAE,OAAO,CAAC,aAAa;KACrC,CAAC,CAAC;AACL,CAAC;AAPD,oCAOC"}

package/dist/recorders/core/EmitBridge.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * EmitBridge — forwards footprintjs emits whose name starts with a given
+ * prefix to the EventDispatcher, enriched with EventMeta.
+ *
+ * Pattern: Adapter (GoF) + Pipes & Filters (Hohpe & Woolf, 2003).
+ * Role:    Single reusable translation layer for every "pass-through"
+ *          prefix recorder (StreamRecorder, AgentRecorder, and any
+ *          future domain whose events are emitted via typedEmit()).
+ * Emits:   Any event whose name matches `prefix` — type derived from the
+ *          emit name and validated by the consumer's EventMap subscription.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmitBridge = void 0;
+const eventMeta_js_1 = require("../../bridge/eventMeta.js");
+class EmitBridge {
+    id;
+    dispatcher;
+    prefix;
+    getRunContext;
+    constructor(options) {
+        this.dispatcher = options.dispatcher;
+        this.id = options.id;
+        this.prefix = options.prefix;
+        this.getRunContext = options.getRunContext;
+    }
+    onEmit(event) {
+        if (typeof event.name !== 'string')
+            return;
+        if (!event.name.startsWith(this.prefix))
+            return;
+        const type = event.name;
+        if (!this.dispatcher.hasListenersFor(type))
+            return;
+        const payload = event.payload;
+        const meta = (0, eventMeta_js_1.buildEventMeta)({ runtimeStageId: event.runtimeStageId, subflowPath: event.subflowPath }, this.getRunContext());
+        this.dispatcher.dispatch({
+            type,
+            payload,
+            meta,
+        });
+    }
+}
+exports.EmitBridge = EmitBridge;
+//# sourceMappingURL=EmitBridge.js.map

package/dist/recorders/core/EmitBridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmitBridge.js","sourceRoot":"","sources":["../../../src/recorders/core/EmitBridge.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAKH,4DAA4E;AAW5E,MAAa,UAAU;IACZ,EAAE,CAAS;IACH,UAAU,CAAkB;IAC5B,MAAM,CAAS;IACf,aAAa,CAAmB;IAEjD,YAAY,OAA0B;QACpC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAC7C,CAAC;IAED,MAAM,CAAC,KAAgB;QACrB,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO;QAC3C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,OAAO;QAChD,MAAM,IAAI,GAAG,KAAK,CAAC,IAA+B,CAAC;QACnD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,IAAI,CAAC;YAAE,OAAO;QAEnD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAqE,CAAC;QAC5F,MAAM,IAAI,GAAG,IAAA,6BAAc,EACzB,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,EACxE,IAAI,CAAC,aAAa,EAAE,CACrB,CAAC;QAEF,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;YACvB,IAAI;YACJ,OAAO;YACP,IAAI;SAC8C,CAAC,CAAC;IACxD,CAAC;CACF;AA/BD,gCA+BC"}

package/dist/recorders/core/EvalRecorder.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * EvalRecorder — forwards `agentfootprint.eval.*` emits to the dispatcher.
+ *
+ * Pattern: Factory over EmitBridge.
+ * Role:    Bridges consumer-emitted `eval.score` + `eval.threshold_crossed`
+ *          events to typed listeners. Evaluation is a consumer concern
+ *          (LLM-based grading, heuristic checks, reference-output diffs),
+ *          so the library only provides transport — not any built-in
+ *          evaluators.
+ * Emits:   agentfootprint.eval.score / eval.threshold_crossed
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.evalRecorder = void 0;
+const EmitBridge_js_1 = require("./EmitBridge.js");
+function evalRecorder(options) {
+    return new EmitBridge_js_1.EmitBridge({
+        id: options.id ?? 'agentfootprint.eval-recorder',
+        prefix: 'agentfootprint.eval.',
+        dispatcher: options.dispatcher,
+        getRunContext: options.getRunContext,
+    });
+}
+exports.evalRecorder = evalRecorder;
+//# sourceMappingURL=EvalRecorder.js.map

package/dist/recorders/core/EvalRecorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EvalRecorder.js","sourceRoot":"","sources":["../../../src/recorders/core/EvalRecorder.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEH,mDAAqE;AAMrE,SAAgB,YAAY,CAAC,OAA4B;IACvD,OAAO,IAAI,0BAAU,CAAC;QACpB,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,8BAA8B;QAChD,MAAM,EAAE,sBAAsB;QAC9B,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,aAAa,EAAE,OAAO,CAAC,aAAa;KACrC,CAAC,CAAC;AACL,CAAC;AAPD,oCAOC"}

package/dist/recorders/core/MemoryRecorder.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * MemoryRecorder — forwards `agentfootprint.memory.*` emits to the dispatcher.
+ *
+ * Pattern: Factory over EmitBridge.
+ * Role:    Bridges memory-layer events (strategy_applied, attached,
+ *          detached, written) emitted by consumer memory adapters.
+ *          The library does not ship a memory implementation; consumers
+ *          plug in their own store and emit these events where relevant
+ *          (e.g., before/after sliding-window summarization).
+ * Emits:   agentfootprint.memory.strategy_applied / attached /
+ *          detached / written
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.memoryRecorder = void 0;
+const EmitBridge_js_1 = require("./EmitBridge.js");
+function memoryRecorder(options) {
+    return new EmitBridge_js_1.EmitBridge({
+        id: options.id ?? 'agentfootprint.memory-recorder',
+        prefix: 'agentfootprint.memory.',
+        dispatcher: options.dispatcher,
+        getRunContext: options.getRunContext,
+    });
+}
+exports.memoryRecorder = memoryRecorder;
+//# sourceMappingURL=MemoryRecorder.js.map

package/dist/recorders/core/MemoryRecorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryRecorder.js","sourceRoot":"","sources":["../../../src/recorders/core/MemoryRecorder.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAEH,mDAAqE;AAMrE,SAAgB,cAAc,CAAC,OAA8B;IAC3D,OAAO,IAAI,0BAAU,CAAC;QACpB,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,gCAAgC;QAClD,MAAM,EAAE,wBAAwB;QAChC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,aAAa,EAAE,OAAO,CAAC,aAAa;KACrC,CAAC,CAAC;AACL,CAAC;AAPD,wCAOC"}

package/dist/recorders/core/PermissionRecorder.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * PermissionRecorder — forwards `agentfootprint.permission.*` emits
+ * to the dispatcher.
+ *
+ * Pattern: Factory over EmitBridge.
+ * Role:    Bridges permission.check, permission.gate_opened, and
+ *          permission.gate_closed emits into the typed dispatcher so
+ *          consumer `.on('agentfootprint.permission.check', ...)`
+ *          listeners fire.
+ * Emits:   agentfootprint.permission.check / gate_opened / gate_closed
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.permissionRecorder = void 0;
+const EmitBridge_js_1 = require("./EmitBridge.js");
+function permissionRecorder(options) {
+    return new EmitBridge_js_1.EmitBridge({
+        id: options.id ?? 'agentfootprint.permission-recorder',
+        prefix: 'agentfootprint.permission.',
+        dispatcher: options.dispatcher,
+        getRunContext: options.getRunContext,
+    });
+}
+exports.permissionRecorder = permissionRecorder;
+//# sourceMappingURL=PermissionRecorder.js.map

package/dist/recorders/core/PermissionRecorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PermissionRecorder.js","sourceRoot":"","sources":["../../../src/recorders/core/PermissionRecorder.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEH,mDAAqE;AAMrE,SAAgB,kBAAkB,CAAC,OAAkC;IACnE,OAAO,IAAI,0BAAU,CAAC;QACpB,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,oCAAoC;QACtD,MAAM,EAAE,4BAA4B;QACpC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,aAAa,EAAE,OAAO,CAAC,aAAa;KACrC,CAAC,CAAC;AACL,CAAC;AAPD,gDAOC"}

package/dist/recorders/core/SkillRecorder.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * SkillRecorder — forwards `agentfootprint.skill.*` emits to the dispatcher.
+ *
+ * Pattern: Factory over EmitBridge.
+ * Role:    Bridges skill lifecycle events (activated, deactivated) emitted
+ *          by consumer skill-management code. Skills are a consumer-owned
+ *          context-engineering concern; the library only provides transport.
+ * Emits:   agentfootprint.skill.activated / skill.deactivated
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.skillRecorder = void 0;
+const EmitBridge_js_1 = require("./EmitBridge.js");
+function skillRecorder(options) {
+    return new EmitBridge_js_1.EmitBridge({
+        id: options.id ?? 'agentfootprint.skill-recorder',
+        prefix: 'agentfootprint.skill.',
+        dispatcher: options.dispatcher,
+        getRunContext: options.getRunContext,
+    });
+}
+exports.skillRecorder = skillRecorder;
+//# sourceMappingURL=SkillRecorder.js.map

package/dist/recorders/core/SkillRecorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillRecorder.js","sourceRoot":"","sources":["../../../src/recorders/core/SkillRecorder.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,mDAAqE;AAMrE,SAAgB,aAAa,CAAC,OAA6B;IACzD,OAAO,IAAI,0BAAU,CAAC;QACpB,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,+BAA+B;QACjD,MAAM,EAAE,uBAAuB;QAC/B,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,aAAa,EAAE,OAAO,CAAC,aAAa;KACrC,CAAC,CAAC;AACL,CAAC;AAPD,sCAOC"}

package/dist/recorders/core/StreamRecorder.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * StreamRecorder — forwards `agentfootprint.stream.*` emits to the dispatcher.
+ *
+ * Pattern: Factory (GoF) returning an EmitBridge instance.
+ * Role:    Convenience constructor for the stream-domain bridge recorder.
+ *          Stage code in LLMCall/Agent calls `typedEmit(scope, 'agentfootprint.stream.llm_start', {...})`;
+ *          this recorder observes via footprintjs's EmitRecorder channel
+ *          and re-dispatches with typed payloads + enriched meta.
+ * Emits:   agentfootprint.stream.llm_start / llm_end / token / tool_start / tool_end
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.streamRecorder = void 0;
+const EmitBridge_js_1 = require("./EmitBridge.js");
+function streamRecorder(options) {
+    return new EmitBridge_js_1.EmitBridge({
+        id: options.id ?? 'agentfootprint.stream-recorder',
+        prefix: 'agentfootprint.stream.',
+        dispatcher: options.dispatcher,
+        getRunContext: options.getRunContext,
+    });
+}
+exports.streamRecorder = streamRecorder;
+//# sourceMappingURL=StreamRecorder.js.map

package/dist/recorders/core/StreamRecorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StreamRecorder.js","sourceRoot":"","sources":["../../../src/recorders/core/StreamRecorder.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,mDAAqE;AAMrE,SAAgB,cAAc,CAAC,OAA8B;IAC3D,OAAO,IAAI,0BAAU,CAAC;QACpB,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,gCAAgC;QAClD,MAAM,EAAE,wBAAwB;QAChC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,aAAa,EAAE,OAAO,CAAC,aAAa;KACrC,CAAC,CAAC;AACL,CAAC;AAPD,wCAOC"}

package/dist/recorders/core/typedEmit.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * typedEmit — typed facade over footprintjs's `scope.$emit(name, payload)`.
+ *
+ * Pattern: Facade (GoF) over an untyped API.
+ * Role:    Stage code inside LLMCall/Agent/slot subflows calls this helper
+ *          to emit events. The EventMap + TS generics reject typos and
+ *          payload drift at compile time; the runtime call is identical
+ *          to footprintjs's `$emit`.
+ * Emits:   Whatever `T` is — the consumer passes the type and payload.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.typedEmit = void 0;
+/**
+ * Emit a typed event from inside stage code.
+ *
+ * @example
+ *   typedEmit(scope, 'agentfootprint.stream.llm_start', {
+ *     iteration: 1,
+ *     provider: 'anthropic',
+ *     model: 'claude-opus-4-7',
+ *     systemPromptChars: 800,
+ *     messagesCount: 2,
+ *     toolsCount: 0,
+ *   });
+ */
+function typedEmit(scope, type, payload) {
+    scope.$emit(type, payload);
+}
+exports.typedEmit = typedEmit;
+//# sourceMappingURL=typedEmit.js.map

package/dist/recorders/core/typedEmit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typedEmit.js","sourceRoot":"","sources":["../../../src/recorders/core/typedEmit.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAaH;;;;;;;;;;;;GAYG;AACH,SAAgB,SAAS,CACvB,KAAoB,EACpB,IAAO,EACP,OAA6C;IAE7C,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC7B,CAAC;AAND,8BAMC"}

package/dist/recorders/core/types.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * Recorder-layer types — shapes builders use to communicate with recorders.
+ *
+ * Pattern: Data Transfer Object (Fowler, PoEAA).
+ * Role:    Shared vocabulary between builders (which WRITE injections) and
+ *          recorders (which OBSERVE those writes and emit grouped events).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMPOSITION_KEYS = void 0;
+// Convention scope keys for composition / eviction / pressure signals.
+// These live alongside INJECTION_KEYS in conventions.ts; re-exported here
+// for recorder convenience.
+exports.COMPOSITION_KEYS = {
+    SLOT_COMPOSED: 'slotCompositions',
+    EVICTED: 'slotEvictions',
+    BUDGET_PRESSURE: 'slotBudgetPressures',
+};
+//# sourceMappingURL=types.js.map

package/dist/recorders/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/recorders/core/types.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AA6FH,uEAAuE;AACvE,0EAA0E;AAC1E,4BAA4B;AACf,QAAA,gBAAgB,GAAG;IAC9B,aAAa,EAAE,kBAAkB;IACjC,OAAO,EAAE,eAAe;IACxB,eAAe,EAAE,qBAAqB;CAC9B,CAAC"}