agentfootprint 1.22.0 → 2.0.1

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"}