agentfootprint 1.22.0 → 2.0.1

package/dist/lib/injection-engine/buildInjectionEngineSubflow.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * Injection Engine — subflow builder.
+ *
+ * Pattern: Subflow Builder (returns a FlowChart mountable via
+ *          `addSubFlowChartNext`). Each subflow stands alone.
+ * Role:    Layer-3 context-engineering primitive. Sits BEFORE the
+ *          three slot subflows in any primitive (Agent, LLMCall) that
+ *          uses Injections. Evaluates every Injection's trigger once
+ *          per iteration.
+ * Emits:   `agentfootprint.context.evaluated` at exit, with
+ *          aggregate metadata. The slot subflows that follow emit
+ *          `agentfootprint.context.injected` per InjectionRecord placed.
+ *
+ * Mount with:
+ *   builder.addSubFlowChartNext(
+ *     SUBFLOW_IDS.INJECTION_ENGINE,
+ *     buildInjectionEngineSubflow({ injections }),
+ *     'Injection Engine',
+ *     {
+ *       inputMapper: (parent) => ({
+ *         iteration: parent.iteration,
+ *         userMessage: parent.userMessage,
+ *         history: parent.history,
+ *         lastToolResult: parent.lastToolResult,
+ *         activatedInjectionIds: parent.activatedInjectionIds ?? [],
+ *       }),
+ *       outputMapper: (sf) => ({ activeInjections: sf.activeInjections }),
+ *     },
+ *   )
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildInjectionEngineSubflow = void 0;
+const footprintjs_1 = require("footprintjs");
+const evaluator_js_1 = require("./evaluator.js");
+const types_js_1 = require("./types.js");
+/**
+ * Build the Injection Engine subflow. One stage: `evaluate`.
+ * Pure function over the injection list + the iteration context.
+ */
+function buildInjectionEngineSubflow(config) {
+    const injections = config.injections;
+    return (0, footprintjs_1.flowChart)('Evaluate', (scope) => {
+        const args = scope.$getArgs();
+        const ctx = {
+            iteration: args.iteration ?? 1,
+            userMessage: args.userMessage ?? '',
+            history: args.history ?? [],
+            ...(args.lastToolResult && { lastToolResult: args.lastToolResult }),
+            activatedInjectionIds: args.activatedInjectionIds ?? [],
+        };
+        const evaluation = (0, evaluator_js_1.evaluateInjections)(injections, ctx);
+        // Two scope writes:
+        //   1. activeInjections — POJO projections (no trigger functions,
+        //      no Tool execute functions) so they survive footprintjs's
+        //      transactional scope buffer (which clones on write).
+        //      Tool schemas are preserved + tagged by injectionId so the
+        //      Agent's closure-held registry can look up the executable.
+        //   2. injectionEvaluation — aggregate metadata for observability.
+        const activePOJOs = evaluation.active.map(types_js_1.projectActiveInjection);
+        scope.$setValue('activeInjections', activePOJOs);
+        scope.$setValue('injectionEvaluation', {
+            activeCount: evaluation.active.length,
+            skippedCount: evaluation.skipped.length,
+            evaluatedTotal: injections.length,
+            activeIds: evaluation.active.map((i) => i.id),
+            skippedDetails: evaluation.skipped,
+            triggerKindCounts: countTriggerKinds(evaluation.active),
+        });
+    }, 'evaluate', undefined, 'Evaluate every Injection trigger; produce activeInjections + metadata').build();
+}
+exports.buildInjectionEngineSubflow = buildInjectionEngineSubflow;
+/** Count active injections by trigger kind (observability metric). */
+function countTriggerKinds(active) {
+    const counts = {};
+    for (const inj of active) {
+        counts[inj.trigger.kind] = (counts[inj.trigger.kind] ?? 0) + 1;
+    }
+    return counts;
+}
+//# sourceMappingURL=buildInjectionEngineSubflow.js.map

package/dist/lib/injection-engine/buildInjectionEngineSubflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildInjectionEngineSubflow.js","sourceRoot":"","sources":["../../../src/lib/injection-engine/buildInjectionEngineSubflow.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;;;AAEH,6CAAwC;AAExC,iDAAoD;AACpD,yCAA2F;AAe3F;;;GAGG;AACH,SAAgB,2BAA2B,CAAC,MAA6B;IACvE,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IAErC,OAAO,IAAA,uBAAS,EACd,UAAU,EACV,CAAC,KAAuC,EAAE,EAAE;QAC1C,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,EAMvB,CAAC;QAEL,MAAM,GAAG,GAAqB;YAC5B,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,CAAC;YAC9B,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;YACnC,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE;YAC3B,GAAG,CAAC,IAAI,CAAC,cAAc,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC;YACnE,qBAAqB,EAAE,IAAI,CAAC,qBAAqB,IAAI,EAAE;SACxD,CAAC;QAEF,MAAM,UAAU,GAAG,IAAA,iCAAkB,EAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAEvD,oBAAoB;QACpB,kEAAkE;QAClE,gEAAgE;QAChE,2DAA2D;QAC3D,iEAAiE;QACjE,iEAAiE;QACjE,mEAAmE;QACnE,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,iCAAsB,CAAC,CAAC;QAClE,KAAK,CAAC,SAAS,CAAC,kBAAkB,EAAE,WAAW,CAAC,CAAC;QACjD,KAAK,CAAC,SAAS,CAAC,qBAAqB,EAAE;YACrC,WAAW,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM;YACrC,YAAY,EAAE,UAAU,CAAC,OAAO,CAAC,MAAM;YACvC,cAAc,EAAE,UAAU,CAAC,MAAM;YACjC,SAAS,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7C,cAAc,EAAE,UAAU,CAAC,OAAO;YAClC,iBAAiB,EAAE,iBAAiB,CAAC,UAAU,CAAC,MAAM,CAAC;SACxD,CAAC,CAAC;IACL,CAAC,EACD,UAAU,EACV,SAAS,EACT,uEAAuE,CACxE,CAAC,KAAK,EAAE,CAAC;AACZ,CAAC;AA9CD,kEA8CC;AAED,sEAAsE;AACtE,SAAS,iBAAiB,CAAC,MAA4B;IACrD,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/lib/injection-engine/evaluator.js

@@ -0,0 +1,79 @@
+"use strict";
+/**
+ * Injection Engine — evaluator.
+ *
+ * Pattern: Pure function. Stateless.
+ * Role:    Internal helper. Called once per iteration by the
+ *          InjectionEngine subflow's compose stage. Slot subflows
+ *          read the `active` array and filter by their slot target.
+ * Emits:   N/A. Caller (the subflow) emits
+ *          `agentfootprint.context.evaluated`.
+ *
+ * Behavior per trigger kind:
+ *   • `always`             → always active.
+ *   • `rule`               → predicate runs against `ctx`. Errors are
+ *                            caught + reported in `skipped`; never
+ *                            propagate. Run never crashes.
+ *   • `on-tool-return`     → active when `ctx.lastToolResult.toolName`
+ *                            matches `trigger.toolName` (string equal
+ *                            or regex test).
+ *   • `llm-activated`      → active when the Injection's `id` is in
+ *                            `ctx.activatedInjectionIds` (the LLM
+ *                            previously called `viaToolName(<id>)`).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.evaluateInjections = void 0;
+function evaluateInjections(injections, ctx) {
+    const active = [];
+    const skipped = [];
+    for (const inj of injections) {
+        const t = inj.trigger;
+        switch (t.kind) {
+            case 'always': {
+                active.push(inj);
+                break;
+            }
+            case 'rule': {
+                try {
+                    if (t.activeWhen(ctx))
+                        active.push(inj);
+                }
+                catch (err) {
+                    skipped.push({
+                        id: inj.id,
+                        reason: 'predicate-threw',
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                }
+                break;
+            }
+            case 'on-tool-return': {
+                const toolName = ctx.lastToolResult?.toolName;
+                if (!toolName)
+                    break;
+                const matches = typeof t.toolName === 'string' ? t.toolName === toolName : t.toolName.test(toolName);
+                if (matches)
+                    active.push(inj);
+                break;
+            }
+            case 'llm-activated': {
+                if (ctx.activatedInjectionIds.includes(inj.id))
+                    active.push(inj);
+                break;
+            }
+            default: {
+                // Defensive: unknown trigger kind (custom user code that
+                // didn't typecheck). Skipped for observability; never crashes.
+                const _exhaustive = t;
+                skipped.push({
+                    id: inj.id,
+                    reason: 'unknown-trigger-kind',
+                    error: `Unhandled trigger: ${JSON.stringify(_exhaustive)}`,
+                });
+            }
+        }
+    }
+    return { active, skipped };
+}
+exports.evaluateInjections = evaluateInjections;
+//# sourceMappingURL=evaluator.js.map

package/dist/lib/injection-engine/evaluator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator.js","sourceRoot":"","sources":["../../../src/lib/injection-engine/evaluator.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;AAIH,SAAgB,kBAAkB,CAChC,UAAgC,EAChC,GAAqB;IAErB,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,MAAM,OAAO,GAIR,EAAE,CAAC;IAER,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC;QACtB,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;YACf,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACjB,MAAM;YACR,CAAC;YACD,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,IAAI,CAAC;oBACH,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;wBAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC1C,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,OAAO,CAAC,IAAI,CAAC;wBACX,EAAE,EAAE,GAAG,CAAC,EAAE;wBACV,MAAM,EAAE,iBAAiB;wBACzB,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;qBACxD,CAAC,CAAC;gBACL,CAAC;gBACD,MAAM;YACR,CAAC;YACD,KAAK,gBAAgB,CAAC,CAAC,CAAC;gBACtB,MAAM,QAAQ,GAAG,GAAG,CAAC,cAAc,EAAE,QAAQ,CAAC;gBAC9C,IAAI,CAAC,QAAQ;oBAAE,MAAM;gBACrB,MAAM,OAAO,GACX,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACvF,IAAI,OAAO;oBAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC9B,MAAM;YACR,CAAC;YACD,KAAK,eAAe,CAAC,CAAC,CAAC;gBACrB,IAAI,GAAG,CAAC,qBAAqB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACjE,MAAM;YACR,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACR,yDAAyD;gBACzD,+DAA+D;gBAC/D,MAAM,WAAW,GAAU,CAAC,CAAC;gBAC7B,OAAO,CAAC,IAAI,CAAC;oBACX,EAAE,EAAE,GAAG,CAAC,EAAE;oBACV,MAAM,EAAE,sBAAsB;oBAC9B,KAAK,EAAE,sBAAsB,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE;iBAC3D,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC;AAxDD,gDAwDC"}

package/dist/lib/injection-engine/factories/defineFact.js

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * defineFact — sugar for context-style Injections (data, not behavior).
+ *
+ * Use for developer-supplied facts the LLM should see in addition to
+ * user messages and tool results. Examples: user profile, env info,
+ * computed conversation summary, cached config, current time. Distinct
+ * from Skills (LLM-activated guidance) and Steering (always-on rules)
+ * in INTENT — they share the engine.
+ *
+ * Produces an `Injection` with:
+ *   - flavor: `'fact'`
+ *   - trigger: configurable (default `'always'`)
+ *   - inject: targets `systemPrompt` OR `messages` (consumer chooses)
+ *
+ * @example
+ *   const userProfile = defineFact({
+ *     id: 'user-profile',
+ *     data: `Name: ${user.name}, Plan: ${user.plan}, Joined: ${user.joinedAt}`,
+ *   });
+ *
+ *   const turnTime = defineFact({
+ *     id: 'turn-time',
+ *     data: `Current time: ${new Date().toISOString()}`,
+ *     slot: 'messages',
+ *     role: 'system',
+ *   });
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineFact = void 0;
+function defineFact(opts) {
+    if (!opts.id || opts.id.trim().length === 0) {
+        throw new Error('defineFact: `id` is required and must be non-empty.');
+    }
+    if (!opts.data || opts.data.length === 0) {
+        throw new Error(`defineFact(${opts.id}): \`data\` is required.`);
+    }
+    const trigger = opts.activeWhen
+        ? { kind: 'rule', activeWhen: opts.activeWhen }
+        : { kind: 'always' };
+    const slot = opts.slot ?? 'system-prompt';
+    const inject = slot === 'messages'
+        ? { messages: [{ role: opts.role ?? 'system', content: opts.data }] }
+        : { systemPrompt: opts.data };
+    // Two-stage cast (`as unknown as Injection`) is required because
+    // `flavor: 'fact'` narrows tighter than `ContextSource`. Both stages
+    // are type-safe at the call site — `flavor` IS a valid `ContextSource`
+    // member; TypeScript just can't narrow back through the freeze.
+    return Object.freeze({
+        id: opts.id,
+        ...(opts.description && { description: opts.description }),
+        flavor: 'fact',
+        trigger,
+        inject,
+    });
+}
+exports.defineFact = defineFact;
+//# sourceMappingURL=defineFact.js.map

package/dist/lib/injection-engine/factories/defineFact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineFact.js","sourceRoot":"","sources":["../../../../src/lib/injection-engine/factories/defineFact.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;;;AA2BH,SAAgB,UAAU,CAAC,IAAuB;IAChD,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,cAAc,IAAI,CAAC,EAAE,0BAA0B,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,OAAO,GAAqB,IAAI,CAAC,UAAU;QAC/C,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE;QAC/C,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACvB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,eAAe,CAAC;IAC1C,MAAM,MAAM,GACV,IAAI,KAAK,UAAU;QACjB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,IAAK,QAAkB,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE;QAChF,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IAElC,iEAAiE;IACjE,qEAAqE;IACrE,uEAAuE;IACvE,gEAAgE;IAChE,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1D,MAAM,EAAE,MAAe;QACvB,OAAO;QACP,MAAM;KACP,CAAyB,CAAC;AAC7B,CAAC;AA3BD,gCA2BC"}

package/dist/lib/injection-engine/factories/defineInstruction.js

@@ -0,0 +1,56 @@
+"use strict";
+/**
+ * defineInstruction — sugar for rule-based system-prompt Injections.
+ *
+ * The most flexible Instruction-style flavor: a predicate decides
+ * activation each iteration. Use for "if condition X is true, give
+ * the LLM this guidance". Compared to:
+ *   - Steering (always-on, no predicate)
+ *   - Skill (LLM-activated via `read_skill`)
+ *   - on-tool-return (specific tool just ran — Dynamic ReAct)
+ *
+ * Produces an `Injection` with:
+ *   - flavor: `'instructions'`
+ *   - trigger: `{ kind: 'rule', activeWhen }` (or `'always'` if omitted)
+ *   - inject: `{ systemPrompt: prompt }`
+ *
+ * @example
+ *   const calmTone = defineInstruction({
+ *     id: 'calm-tone',
+ *     description: 'Use a calm, empathetic tone with frustrated users.',
+ *     activeWhen: (ctx) => /upset|angry|frustrated/.test(ctx.userMessage),
+ *     prompt: 'Acknowledge feelings before facts. Avoid corporate jargon.',
+ *   });
+ *
+ *   const piiAfterRedact = defineInstruction({
+ *     id: 'pii-after-redact',
+ *     activeWhen: (ctx) => ctx.lastToolResult?.toolName === 'redact_pii',
+ *     prompt: 'PII has been redacted. Do not include emails or phone numbers.',
+ *   });
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineInstruction = void 0;
+function defineInstruction(opts) {
+    if (!opts.id || opts.id.trim().length === 0) {
+        throw new Error('defineInstruction: `id` is required and must be non-empty.');
+    }
+    if (!opts.prompt || opts.prompt.length === 0) {
+        throw new Error(`defineInstruction(${opts.id}): \`prompt\` is required.`);
+    }
+    const trigger = opts.activeWhen
+        ? { kind: 'rule', activeWhen: opts.activeWhen }
+        : { kind: 'always' };
+    const slot = opts.slot ?? 'system-prompt';
+    const inject = slot === 'messages'
+        ? { messages: [{ role: opts.role ?? 'system', content: opts.prompt }] }
+        : { systemPrompt: opts.prompt };
+    return Object.freeze({
+        id: opts.id,
+        ...(opts.description && { description: opts.description }),
+        flavor: 'instructions',
+        trigger,
+        inject,
+    });
+}
+exports.defineInstruction = defineInstruction;
+//# sourceMappingURL=defineInstruction.js.map

package/dist/lib/injection-engine/factories/defineInstruction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineInstruction.js","sourceRoot":"","sources":["../../../../src/lib/injection-engine/factories/defineInstruction.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;;;AAyCH,SAAgB,iBAAiB,CAAC,IAA8B;IAC9D,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,CAAC,EAAE,4BAA4B,CAAC,CAAC;IAC5E,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU;QAC7B,CAAC,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE;QACxD,CAAC,CAAC,EAAE,IAAI,EAAE,QAAiB,EAAE,CAAC;IAChC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,eAAe,CAAC;IAC1C,MAAM,MAAM,GACV,IAAI,KAAK,UAAU;QACjB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE;QACvE,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;IACpC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1D,MAAM,EAAE,cAAuB;QAC/B,OAAO;QACP,MAAM;KACP,CAAyB,CAAC;AAC7B,CAAC;AAtBD,8CAsBC"}

package/dist/lib/injection-engine/factories/defineSkill.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * defineSkill — sugar for LLM-activated Injections that target both
+ * system-prompt + tools.
+ *
+ * A Skill is a bundle of (1) a body of guidance and (2) optionally
+ * unlocked tools. The LLM decides when a Skill is needed by calling
+ * a designated activation tool — by default `read_skill(<id>)`.
+ *
+ * Produces an `Injection` with:
+ *   - flavor: `'skill'`
+ *   - trigger: `{ kind: 'llm-activated', viaToolName: 'read_skill' }`
+ *   - inject: `{ systemPrompt: body, tools }`
+ *
+ * The Agent integration auto-attaches the `read_skill` tool when one
+ * or more Skills are present. When the LLM calls
+ * `read_skill('billing')`, the engine adds `'billing'` to
+ * `ctx.activatedInjectionIds`; the next iteration's evaluator
+ * matches this Skill's `id`, activates it, and the body + tools land
+ * in the slot subflows.
+ *
+ * @example
+ *   const billingSkill = defineSkill({
+ *     id: 'billing',
+ *     description: 'Use for refunds, charges, billing questions.',
+ *     body: 'When handling billing: confirm identity first, then…',
+ *     tools: [refundTool, chargeHistoryTool],
+ *   });
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineSkill = void 0;
+function defineSkill(opts) {
+    if (!opts.id || opts.id.trim().length === 0) {
+        throw new Error('defineSkill: `id` is required and must be non-empty.');
+    }
+    if (!opts.description || opts.description.length === 0) {
+        throw new Error(`defineSkill(${opts.id}): \`description\` is required (LLM uses it to decide when to activate).`);
+    }
+    if (!opts.body || opts.body.length === 0) {
+        throw new Error(`defineSkill(${opts.id}): \`body\` is required.`);
+    }
+    return Object.freeze({
+        id: opts.id,
+        description: opts.description,
+        flavor: 'skill',
+        trigger: {
+            kind: 'llm-activated',
+            viaToolName: opts.viaToolName ?? 'read_skill',
+        },
+        inject: {
+            systemPrompt: opts.body,
+            ...(opts.tools && opts.tools.length > 0 && { tools: opts.tools }),
+        },
+    });
+}
+exports.defineSkill = defineSkill;
+//# sourceMappingURL=defineSkill.js.map

package/dist/lib/injection-engine/factories/defineSkill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineSkill.js","sourceRoot":"","sources":["../../../../src/lib/injection-engine/factories/defineSkill.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;;;AAqBH,SAAgB,WAAW,CAAC,IAAwB;IAClD,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CACb,eAAe,IAAI,CAAC,EAAE,0EAA0E,CACjG,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,CAAC,EAAE,0BAA0B,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM,EAAE,OAAgB;QACxB,OAAO,EAAE;YACP,IAAI,EAAE,eAAwB;YAC9B,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,YAAY;SAC9C;QACD,MAAM,EAAE;YACN,YAAY,EAAE,IAAI,CAAC,IAAI;YACvB,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;SAClE;KACF,CAAyB,CAAC;AAC7B,CAAC;AAzBD,kCAyBC"}

package/dist/lib/injection-engine/factories/defineSteering.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * defineSteering — sugar for always-on system-prompt Injections.
+ *
+ * Steering docs are the simplest form of context engineering: a fixed
+ * piece of guidance the LLM should follow on every iteration. Style
+ * guides, output format rules, persona statements, safety policies.
+ *
+ * Produces an `Injection` with:
+ *   - flavor: `'steering'`
+ *   - trigger: `{ kind: 'always' }`
+ *   - inject: `{ systemPrompt: prompt }`
+ *
+ * @example
+ *   const jsonOnly = defineSteering({
+ *     id: 'json-only',
+ *     description: 'Always respond with valid JSON.',
+ *     prompt: 'Respond with JSON only. No prose. No markdown.',
+ *   });
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineSteering = void 0;
+function defineSteering(opts) {
+    if (!opts.id || opts.id.trim().length === 0) {
+        throw new Error('defineSteering: `id` is required and must be non-empty.');
+    }
+    if (!opts.prompt || opts.prompt.length === 0) {
+        throw new Error(`defineSteering(${opts.id}): \`prompt\` is required.`);
+    }
+    return Object.freeze({
+        id: opts.id,
+        ...(opts.description && { description: opts.description }),
+        flavor: 'steering',
+        trigger: { kind: 'always' },
+        inject: { systemPrompt: opts.prompt },
+    });
+}
+exports.defineSteering = defineSteering;
+//# sourceMappingURL=defineSteering.js.map

package/dist/lib/injection-engine/factories/defineSteering.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineSteering.js","sourceRoot":"","sources":["../../../../src/lib/injection-engine/factories/defineSteering.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;AAWH,SAAgB,cAAc,CAAC,IAA2B;IACxD,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,CAAC,EAAE,4BAA4B,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1D,MAAM,EAAE,UAAmB;QAC3B,OAAO,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;QACpC,MAAM,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,MAAM,EAAE;KACtC,CAAyB,CAAC;AAC7B,CAAC;AAdD,wCAcC"}

package/dist/lib/injection-engine/index.js

@@ -0,0 +1,79 @@
+"use strict";
+/**
+ * agentfootprint Injection Engine — public barrel.
+ *
+ * The unifying primitive of agentfootprint context engineering.
+ * One `Injection` type. One `InjectionEngine` subflow. N typed sugar
+ * factories. See `README.md` in this folder for the full concept.
+ *
+ * ─── 7-panel design review (2026-04-28) ─────────────────────────────
+ *
+ *   LLM-AI system design   ✓ ONE primitive replaces N feature-specific
+ *                            subsystems. Skill, Steering, Instruction,
+ *                            Context (and RAG, Memory, Guardrail)
+ *                            are typed sugar producing the same shape.
+ *                            Engine is shared; observability is shared;
+ *                            Lens chips are shared.
+ *
+ *   Performance            ✓ Trigger evaluation O(N) per iteration.
+ *                            Subflow ceremony ~50µs per iteration.
+ *                            Negligible. Active set materialized once,
+ *                            consumed by 3 slot subflows.
+ *
+ *   Scalability            ✓ Adding a flavor = adding a sugar factory
+ *                            file. Zero engine change. Library scales
+ *                            to 50+ flavors without bloating the
+ *                            engine. The "narrow waist" pattern.
+ *
+ *   Research alignment     ✓ Maps to "Augmented LM" framing
+ *                            (Mialon et al. 2023): every external
+ *                            input is an augmentation; agentfootprint
+ *                            calls them Injections. Factory names
+ *                            preserve research vocabulary (Skill, RAG,
+ *                            Memory, Steering) at the API surface.
+ *
+ *   Flexibility            ✓ Discriminated `trigger` union handles
+ *                            always / rule / on-tool-return /
+ *                            llm-activated. New trigger kinds extend
+ *                            cleanly. Multi-slot per Injection covers
+ *                            Skills (system-prompt + tools).
+ *
+ *   Abstraction-modular    ✓ Engine = subflow (drill-able). Factories
+ *                            = small files (one per flavor). Slot
+ *                            subflows are unchanged consumers.
+ *                            Textbook narrow-waist architecture.
+ *
+ *   Software engineering   ✓ Predicate exceptions caught + reported
+ *                            via `skipped[]`, never propagate. Frozen
+ *                            Injections. Validation in factories.
+ *                            7-pattern test coverage. Subpath export
+ *                            for tree-shake.
+ *
+ * Plus footprintjs integration check ✓ — uses existing slot subflow
+ * convention (writes activeInjections to scope; slots filter by
+ * targeted slot) + ContextRecorder picks up source field zero-change.
+ *
+ * Plus TypeScript engineer check ✓ — discriminated union, no `any`,
+ * frozen returns, exhaustiveness check on trigger kind.
+ *
+ * ─── 7-pattern test coverage ────────────────────────────────────────
+ *
+ *   See `test/lib/injection-engine/*.test.ts`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineFact = exports.defineSteering = exports.defineSkill = exports.defineInstruction = exports.buildInjectionEngineSubflow = exports.evaluateInjections = void 0;
+// Engine
+var evaluator_js_1 = require("./evaluator.js");
+Object.defineProperty(exports, "evaluateInjections", { enumerable: true, get: function () { return evaluator_js_1.evaluateInjections; } });
+var buildInjectionEngineSubflow_js_1 = require("./buildInjectionEngineSubflow.js");
+Object.defineProperty(exports, "buildInjectionEngineSubflow", { enumerable: true, get: function () { return buildInjectionEngineSubflow_js_1.buildInjectionEngineSubflow; } });
+// Sugar factories — Ships four; more flavors planned (RAG / Memory / Guardrail)
+var defineInstruction_js_1 = require("./factories/defineInstruction.js");
+Object.defineProperty(exports, "defineInstruction", { enumerable: true, get: function () { return defineInstruction_js_1.defineInstruction; } });
+var defineSkill_js_1 = require("./factories/defineSkill.js");
+Object.defineProperty(exports, "defineSkill", { enumerable: true, get: function () { return defineSkill_js_1.defineSkill; } });
+var defineSteering_js_1 = require("./factories/defineSteering.js");
+Object.defineProperty(exports, "defineSteering", { enumerable: true, get: function () { return defineSteering_js_1.defineSteering; } });
+var defineFact_js_1 = require("./factories/defineFact.js");
+Object.defineProperty(exports, "defineFact", { enumerable: true, get: function () { return defineFact_js_1.defineFact; } });
+//# sourceMappingURL=index.js.map

package/dist/lib/injection-engine/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/injection-engine/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;;;AAWH,SAAS;AACT,+CAAoD;AAA3C,kHAAA,kBAAkB,OAAA;AAC3B,mFAG0C;AAFxC,6IAAA,2BAA2B,OAAA;AAI7B,gFAAgF;AAChF,yEAAoG;AAA3F,yHAAA,iBAAiB,OAAA;AAE1B,6DAAkF;AAAzE,6GAAA,WAAW,OAAA;AAEpB,mEAA2F;AAAlF,mHAAA,cAAc,OAAA;AAEvB,2DAA+E;AAAtE,2GAAA,UAAU,OAAA"}

package/dist/lib/injection-engine/types.js

@@ -0,0 +1,42 @@
+"use strict";
+/**
+ * Injection Engine — types.
+ *
+ * THE primitive that unifies every form of context engineering in the
+ * library. Skills, Steering docs, Instructions, RAG, Memory, custom
+ * Context — all reduce to one shape: an `Injection` with a `trigger`
+ * (when), `inject` (what — one or more slot targets), and a `flavor`
+ * (observability tag).
+ *
+ * Pattern: Strategy (GoF) — each Injection's trigger is a strategy for
+ *          "should I activate this iteration?". Each Injection's
+ *          `inject` is the Memento (GoF) carrying content to slots.
+ * Role:    Layer-3 context engineering primitive in the stack.
+ *          Sits below the slot subflows.
+ * Emits:   Engine emits `agentfootprint.context.evaluated` once per
+ *          iteration. Slot subflows emit `agentfootprint.context.injected`
+ *          for each InjectionRecord they place.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectActiveInjection = void 0;
+/** Project a full Injection (with functions) into a scope-safe POJO. */
+function projectActiveInjection(inj) {
+    const out = {
+        id: inj.id,
+        flavor: inj.flavor,
+        ...(inj.description && { description: inj.description }),
+        inject: {
+            ...(inj.inject.systemPrompt && { systemPrompt: inj.inject.systemPrompt }),
+            ...(inj.inject.messages && { messages: inj.inject.messages.map((m) => ({ ...m })) }),
+            ...(inj.inject.tools && {
+                tools: inj.inject.tools.map((t) => ({
+                    schema: { ...t.schema },
+                    injectionId: inj.id,
+                })),
+            }),
+        },
+    };
+    return out;
+}
+exports.projectActiveInjection = projectActiveInjection;
+//# sourceMappingURL=types.js.map

package/dist/lib/injection-engine/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/injection-engine/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;AA2KH,wEAAwE;AACxE,SAAgB,sBAAsB,CAAC,GAAc;IACnD,MAAM,GAAG,GAAoB;QAC3B,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,GAAG,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC;QACxD,MAAM,EAAE;YACN,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YACzE,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YACpF,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI;gBACtB,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAClC,MAAM,EAAE,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE;oBACvB,WAAW,EAAE,GAAG,CAAC,EAAE;iBACpB,CAAC,CAAC;aACJ,CAAC;SACH;KACF,CAAC;IACF,OAAO,GAAG,CAAC;AACb,CAAC;AAjBD,wDAiBC"}

package/dist/memory/beats/llmExtractor.js

@@ -36,22 +36,7 @@ function formatMessagesForExtractor(messages, turnNumber) {
         if (m.role === 'system')
             continue;
         const ref = refId(turnNumber, i);
-        const content = typeof m.content === 'string'
-            ? m.content
-            : Array.isArray(m.content)
-                ? m.content
-                    .map((b) => {
-                    if (b && typeof b === 'object') {
-                        const blk = b;
-                        if (blk.type === 'text' && typeof blk.text === 'string')
-                            return blk.text;
-                    }
-                    return '';
-                })
-                    .filter(Boolean)
-                    .join(' ')
-                : '';
-        lines.push(`[${ref}] ${m.role}: ${content}`);
+        lines.push(`[${ref}] ${m.role}: ${m.content}`);
     }
     return lines.join('\n');
 }
@@ -100,10 +85,12 @@ function llmExtractor(config) {
     return {
         async extract(args) {
             const userContent = formatMessagesForExtractor(args.messages, args.turnNumber);
-            const response = await provider.chat([
-                { role: 'system', content: systemPrompt },
-                { role: 'user', content: userContent },
-            ], args.signal ? { signal: args.signal } : undefined);
+            const response = await provider.complete({
+                systemPrompt,
+                messages: [{ role: 'user', content: userContent }],
+                model: 'memory-extractor',
+                ...(args.signal ? { signal: args.signal } : {}),
+            });
             return parseBeatsResponse(response.content ?? '', onParseError);
         },
     };

package/dist/memory/beats/llmExtractor.js.map

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

package/dist/memory/causal/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.snapshotPipeline = exports.loadSnapshot = exports.writeSnapshot = exports.DEFAULT_TOOL_RESULT_PREVIEW_LEN = void 0;
+var types_js_1 = require("./types.js");
+Object.defineProperty(exports, "DEFAULT_TOOL_RESULT_PREVIEW_LEN", { enumerable: true, get: function () { return types_js_1.DEFAULT_TOOL_RESULT_PREVIEW_LEN; } });
+var writeSnapshot_js_1 = require("./writeSnapshot.js");
+Object.defineProperty(exports, "writeSnapshot", { enumerable: true, get: function () { return writeSnapshot_js_1.writeSnapshot; } });
+var loadSnapshot_js_1 = require("./loadSnapshot.js");
+Object.defineProperty(exports, "loadSnapshot", { enumerable: true, get: function () { return loadSnapshot_js_1.loadSnapshot; } });
+var snapshotPipeline_js_1 = require("./snapshotPipeline.js");
+Object.defineProperty(exports, "snapshotPipeline", { enumerable: true, get: function () { return snapshotPipeline_js_1.snapshotPipeline; } });
+//# sourceMappingURL=index.js.map

package/dist/memory/causal/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/memory/causal/index.ts"],"names":[],"mappings":";;;AAOA,uCAA6D;AAApD,2HAAA,+BAA+B,OAAA;AAExC,uDAA6E;AAApE,iHAAA,aAAa,OAAA;AACtB,qDAA0E;AAAjE,+GAAA,YAAY,OAAA;AACrB,6DAAsF;AAA7E,uHAAA,gBAAgB,OAAA"}