agentfootprint 10.2.0 → 10.3.1

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

@@ -0,0 +1,568 @@
+/**
+ * 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.
+ *
+ * Four small, readable stages (was one monolithic `evaluate`):
+ *   1. Gather   — snapshot the turn's inputs (iteration, history size,
+ *                 last tool, LLM-activated count). Observability only.
+ *   2. Evaluate — run every trigger → `activeInjections` (the REAL output
+ *                 the slot subflows read). Logic is UNCHANGED from the old
+ *                 single stage: `activeInjections` is byte-identical, so the
+ *                 slots are 100% unaffected. (Safety invariant.)
+ *   3. Route    — partition `activeInjections` into per-slot buckets
+ *                 (`activeByslot`), mirroring how the slots filter. Pure
+ *                 annotation — the slots still do their own filtering.
+ *   4. Delta    — diff this turn's buckets vs last turn's (`slotDelta`):
+ *                 per slot, what activated / deactivated / stayed. The
+ *                 explainability win ("tools +skill X, system-prompt
+ *                 unchanged"). Reads last turn via `priorActiveByslot`
+ *                 carried by the mount's input/output mappers.
+ *
+ * Nothing here SKIPS a slot — Route/Delta only annotate. See
+ * docs (injection-algorithm blog) + memory agentfootprint_slot_plan_review
+ * for why per-turn skip was deferred.
+ *
+ * Emits:   `agentfootprint.context.evaluated` at the Evaluate stage, with
+ *          aggregate metadata. The per-slot route/delta ride visible stage
+ *          STATE (`activeByslot` / `slotDelta`) so the lens reads them from
+ *          the commit log without a new event-type contract.
+ *
+ * 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,
+ *         toolResults: parent.toolResults, // the whole batch, in call order
+ *         activatedInjectionIds: parent.activatedInjectionIds ?? [],
+ *         priorActiveByslot: parent.activeByslot ?? EMPTY_ACTIVE_BY_SLOT,
+ *       }),
+ *       outputMapper: (sf) => ({
+ *         activeInjections: sf.activeInjections,
+ *         activeByslot: sf.activeByslot, // carried so next turn's Delta can diff
+ *       }),
+ *     },
+ *   )
+ */
+import { flowChart } from 'footprintjs';
+import { typedEmit } from '../recorders/core/typedEmit.js';
+import { iterationsRemainingOf } from '../lib/iterationBudget.js';
+import { evaluateInjections } from './evaluator.js';
+import { projectActiveInjection, toolResultsOf, } from './types.js';
+import { SKILL_GRAPH_METADATA_KEY, } from './skillGraph.js';
+import { menuOutstanding } from './routingPolicy.js';
+import { pointerOf, rekeyStepPointer, } from './skillSteps.js';
+import { activeLeaseIds, pruneLeases, tenantOf, } from './leases.js';
+import { advanceEngagement } from '../maps/engagement/lease.js';
+import { parkCard, PARK_CARD_ID } from '../maps/engagement/parkCard.js';
+/** Empty buckets — turn-1 prior, and the safe default for the mappers. */
+export const EMPTY_ACTIVE_BY_SLOT = {
+    systemPrompt: [],
+    messages: [],
+    tools: [],
+};
+/**
+ * Build the Injection Engine subflow — Gather → Evaluate → Route → Delta.
+ */
+export function buildInjectionEngineSubflow(config) {
+    const injections = config.injections;
+    return flowChart('Gather', gatherStage, 'gather', {
+        description: "Snapshot this turn's injection inputs (iteration, history, last tool, LLM-activated)",
+    })
+        .addFunction('Evaluate', makeEvaluateStage(injections, config.nextSkill, config.explainNextSkill, config.supersededEntries, config.stepPlanFor, config.reachableSkills, config.engagement), 'evaluate', 'Evaluate every Injection trigger; produce activeInjections + metadata')
+        .addFunction('Route', routeStage, 'route', 'Partition active injections into per-slot buckets (system-prompt / messages / tools)')
+        .addFunction('Delta', deltaStage, 'delta', 'Per-slot delta vs last turn: what activated / deactivated / stayed')
+        .build();
+}
+// ── Stage 1: Gather ──────────────────────────────────────────────────────
+/** Observability-only: record what this turn is being evaluated against. */
+function gatherStage(scope) {
+    const args = scope.$getArgs();
+    scope.$setValue('injectionContextSummary', {
+        iteration: args.iteration ?? 1,
+        historyLength: args.history?.length ?? 0,
+        lastToolName: args.lastToolResult?.toolName,
+        activatedInjectionCount: args.activatedInjectionIds?.length ?? 0,
+    });
+}
+// ── Stage 2: Evaluate (logic identical to the old single stage) ──────────
+function makeEvaluateStage(injections, nextSkill, explainNextSkill, supersededEntries, stepPlanFor, reachableSkills, engagementPlan) {
+    return (scope) => {
+        const args = scope.$getArgs();
+        // The accepted transition proposal (9.19.0), VALID only on the iteration
+        // after its grant — one-shot by data, the same one-shot-ness the pick
+        // gets from being rewritten, with zero clearing writes (an agent whose
+        // tools never propose keeps its exact committed keys).
+        const iteration = args.iteration ?? 1;
+        const proposal = args.pendingToolTransition !== undefined &&
+            args.pendingToolTransition.iteration + 1 === iteration
+            ? args.pendingToolTransition
+            : undefined;
+        const baseCtx = {
+            iteration,
+            // The action budget, as ONE fact with two spellings (9.57.0). Written
+            // together so the pairing invariant — both or neither — is a property
+            // of this object literal rather than a rule somebody has to remember.
+            ...(args.maxIterations !== undefined && {
+                maxIterations: args.maxIterations,
+                iterationsRemaining: iterationsRemainingOf(args.maxIterations, iteration),
+            }),
+            userMessage: args.userMessage ?? '',
+            history: args.history ?? [],
+            ...(args.lastToolResult && { lastToolResult: args.lastToolResult }),
+            ...(args.toolResults && { toolResults: args.toolResults }),
+            activatedInjectionIds: args.activatedInjectionIds ?? [],
+            ...(args.currentSkillId !== undefined && { currentSkillId: args.currentSkillId }),
+            ...(args.pendingSkillPick !== undefined && { pendingSkillPick: args.pendingSkillPick }),
+            ...(proposal !== undefined && {
+                pendingToolTransition: { targetSkillId: proposal.targetSkillId },
+            }),
+            ...(args.entryScores !== undefined && { entryScores: args.entryScores }),
+            ...(args.entryScorer !== undefined && { entryScorer: args.entryScorer }),
+            ...(args.turnRoute !== undefined && { turnRoute: args.turnRoute }),
+        };
+        // KEYSTONE cursor advance — derive the next cursor from the SAME ctx the
+        // route triggers gate on (`nextSkill(ctx) === id`), so the active set and the
+        // stored cursor can never disagree. Written to a DISTINCT output key
+        // (`nextSkillCursor`) because `currentSkillId` arrives as a readonly INPUT
+        // here; the mount's outputMapper maps it onto the parent's mutable
+        // `currentSkillId` for the next iteration. Skill-graph agents only.
+        // ONE consultation of the graph per iteration: when the graph can explain
+        // itself (8.5.0) the cursor comes out of `.to`, so asking for the cause costs
+        // nothing extra and cannot answer a different destination than the routing did.
+        const move = explainNextSkill ? explainNextSkill(baseCtx) : undefined;
+        const routes = explainNextSkill !== undefined || nextSkill !== undefined;
+        const cursor = move ? move.to : nextSkill ? nextSkill(baseCtx) : undefined;
+        if (routes) {
+            scope.$setValue('nextSkillCursor', cursor);
+        }
+        // ── The step pointer's TENURE RE-KEY (9.18.0) ─────────────────────
+        // Same discipline as the cursor, one line down from it: `stepPointer`
+        // arrives as a readonly INPUT, so the fresh value goes out under a
+        // DISTINCT key (`nextStepPointer` — the currentSkillId/nextSkillCursor
+        // alias, NOT the turn-constant turnRoute pattern) and the mount mappers
+        // carry it back onto the parent. The tenant is the ADVANCED cursor on
+        // graph agents, else the tail of `activatedInjectionIds` (the shipped
+        // `activeSkillId` notion). Written on EVERY iteration the feature is on
+        // (the `if (routes)` precedent) so a downstream reader never sees a
+        // stale pointer; gated on `stepPlanFor` so agents without steps commit
+        // exactly the keys they always did.
+        //
+        // Computed BEFORE `evaluateInjections`, and the FRESH pointer goes into
+        // the ctx the triggers read — else `defineStepsHint`'s trigger would
+        // judge the stale pointer and the hint would miss the tenure's first
+        // iteration while the banner (tools slot, fresh value) was present.
+        let ctx = baseCtx;
+        if (stepPlanFor) {
+            const activated = args.activatedInjectionIds ?? [];
+            const tenant = routes ? cursor : activated[activated.length - 1];
+            const fresh = rekeyStepPointer({ prior: args.stepPointer, tenant, stepPlanFor });
+            scope.$setValue('nextStepPointer', fresh);
+            const freshPointer = pointerOf(fresh);
+            ctx = { ...baseCtx, ...(freshPointer !== undefined && { stepPointer: freshPointer }) };
+        }
+        // ── Instruction leases (9.19.0) — the `require-instruction` push ───
+        // Validity is COMPUTED per pass against the ADVANCED tenure (a lease
+        // dies the same pass its tenure ends): `'next-call'` serves exactly the
+        // pass after its grant; `'until-skill-exit'` serves while the granting
+        // tenant still holds. The served ids ride the ctx the evaluator reads,
+        // which admits them into the active set beside their own triggers.
+        // Zero-cost gate: no granted lease anywhere → not one line here runs.
+        if (args.instructionLeases !== undefined) {
+            const leaseTenant = tenantOf(routes ? cursor : undefined, args.activatedInjectionIds);
+            if (args.instructionLeases.length > 0) {
+                const leaseIds = activeLeaseIds(args.instructionLeases, ctx.iteration, leaseTenant);
+                if (leaseIds.length > 0) {
+                    ctx = { ...ctx, leaseActiveIds: leaseIds };
+                }
+            }
+            // The TENURE SWEEP — what makes lease death PERMANENT. `skillId ===
+            // tenant` alone cannot tell "held the tenure all along" from
+            // "re-entered the granting skill later" (a cyclic graph makes both
+            // real), so the pass that sees a tenure end removes its dead leases
+            // from the record — computed AFTER `activeLeaseIds` (this pass's
+            // serving is untouched; the swept array feeds only future passes).
+            // Same alias round trip as the cursor: `instructionLeases` is a
+            // readonly boundary INPUT here, so the survivors go out under
+            // `nextInstructionLeases` and the mount mappers carry them back onto
+            // the parent key. Written on EVERY pass the key exists — even as [] —
+            // so no boundary ever re-delivers a stale, pre-sweep array.
+            scope.$setValue('nextInstructionLeases', pruneLeases(args.instructionLeases, ctx.iteration, leaseTenant));
+        }
+        // A parallel batch whose results matched edges to DIFFERENT targets
+        // (9.16.0). The resolver already decided the hop — first match in call
+        // order won — and reported the suppression on the move; here it goes on
+        // the record as its own typed event, stamped the iteration it happened.
+        // Silent-drop was the pre-9.16.0 behavior this replaces: earlier calls of
+        // a batch simply never routed. POJO copies, because event payloads must
+        // be detached plain data.
+        if (move?.conflict) {
+            typedEmit(scope, 'agentfootprint.skill.route_conflict', {
+                iteration: ctx.iteration,
+                ...(ctx.currentSkillId !== undefined && { fromSkillId: ctx.currentSkillId }),
+                winner: { ...move.conflict.winner },
+                losers: move.conflict.losers.map((l) => ({ ...l })),
+            });
+        }
+        // ── Map engagement (9.58.0) — the mount kernel's one pass ──────────
+        // Advanced with the SAME facts the triggers gate on, BEFORE the
+        // evaluator runs, so a re-engagement earned this pass serves this pass
+        // and a park suppresses this pass — the record and the wire can never
+        // disagree. The state rides the boundary as a readonly INPUT
+        // (`mapEngagement`) and leaves under the DISTINCT key
+        // `nextMapEngagement` (the cursor/lease alias discipline). The cursor
+        // itself is untouched by every branch of this block: engagement is the
+        // kernel's axis, position is the map's.
+        let parkCardText;
+        if (engagementPlan !== undefined) {
+            const advance = advanceEngagement(engagementPlan, args.mapEngagement, {
+                iteration: ctx.iteration,
+                ...(cursor !== undefined && { currentNode: cursor }),
+                ...(move?.by !== undefined && { moveBy: move.by }),
+                ...(move?.witness?.text !== undefined && { witness: move.witness.text }),
+                toolResults: toolResultsOf(ctx),
+                ...(ctx.pendingSkillPick !== undefined && { pendingSkillPick: ctx.pendingSkillPick }),
+                // PER-PASS picks (9.59.0), not the turn-cumulative activation list.
+                acceptedSkillPicks: args.acceptedSkillPicks ?? [],
+                // The idle test's SERVED clause (9.59.0) — what the engine actually
+                // put on the wire last pass, carried under the kernel's own key.
+                servedLastPass: args.servedInjectionIds ?? [],
+            });
+            // Written on EVERY pass the feature is on (the `if (routes)` precedent)
+            // so a boundary never re-delivers stale engagement state.
+            scope.$setValue('nextMapEngagement', advance.next);
+            for (const change of advance.changes) {
+                if (change.kind === 'engaged') {
+                    typedEmit(scope, 'agentfootprint.map.engaged', {
+                        mapId: change.mapId,
+                        iteration: change.iteration,
+                        by: change.by,
+                        ...(change.witness !== undefined && { witness: change.witness }),
+                        ...(change.reengaged === true && { reengaged: true }),
+                        // A guess that real evidence confirmed, and the cause it was
+                        // FOUNDED on — so a reader of the record sees both halves of the
+                        // story instead of a `by` that silently rewrote itself (9.59.0).
+                        ...(change.upgraded === true && { upgraded: true }),
+                        // The cursor moved to a different member: eligibility was
+                        // re-derived from THIS member's evidence, not inherited.
+                        ...(change.tenantChanged === true && { tenantChanged: true }),
+                        ...(change.at !== undefined && { at: change.at }),
+                        ...(change.foundedBy !== undefined && { foundedBy: change.foundedBy }),
+                    });
+                }
+                else {
+                    typedEmit(scope, 'agentfootprint.map.parked', {
+                        mapId: change.mapId,
+                        iteration: change.iteration,
+                        by: change.by,
+                        idleCalls: change.idleCalls,
+                        ...(change.witness !== undefined && { witness: change.witness }),
+                    });
+                }
+            }
+            // ── The MODEL-VISIBLE surface (9.59.0) ──────────────────────────
+            // Everything above lands on the RECORD, which the model never reads.
+            // The card is the one thing it does read: cursor and engagement shown
+            // as SEPARATE fields, the reason, and the way back named as a concrete
+            // call. Built from the state that was just advanced, so the card and
+            // the suppression are two views of one decision.
+            parkCardText = parkCard(engagementPlan, advance.next);
+            // Tools come off the wire on the ENGAGEMENT axis, independently of
+            // `scopeTools` — see `EngagementAdvance.parkedToolNames`.
+            scope.$setValue('parkedToolNames', advance.parkedToolNames);
+            if (advance.parkedInjectionIds.length > 0) {
+                ctx = { ...ctx, parkedIds: advance.parkedInjectionIds };
+            }
+        }
+        const evaluation = evaluateInjections(injections, ctx);
+        // The suppression the cursor law performs (8.15.0). Asked ONCE, on the same ctx
+        // the triggers gated on, so the reported suppression and the active set are two
+        // views of one evaluation and cannot disagree.
+        const supersededIds = supersededEntries ? [...supersededEntries(ctx)] : [];
+        // The told-the-truth check. `read_skill` answered "Skill 'X' activated for the
+        // next iteration" and the gate accepted the pick — so X must be in THIS pass's
+        // active set. It normally is (the pick moved the cursor). The one case where it
+        // isn't: a declared edge fired the same turn and won the cursor (`D1 > D2` —
+        // the model emitted a domain tool AND read_skill in one message, and the domain
+        // tool's result matched a route). Rather than let a promise quietly go unmet,
+        // say so on the record. Checked against the REAL active set, not against which
+        // clause won — the question is "did the promised skill load?", and only the
+        // active set answers it.
+        //
+        // 8.15.0 widened WHEN that answer is "no", without changing the question. A
+        // superseded pick onto a rules-form entry used to slip through: the pick lost the
+        // cursor, but the entry's own rule kept it active anyway, so the promise looked
+        // kept by accident. Conditional entries are cursor-gated now, so the same hop
+        // reports itself. `supersededIds` below is a DIFFERENT fact — a continuous
+        // suppression, nobody's broken promise — and deliberately does not come out here.
+        const pick = ctx.pendingSkillPick;
+        if (pick !== undefined && !evaluation.active.some((inj) => inj.id === pick)) {
+            typedEmit(scope, 'agentfootprint.skill.reroute_superseded', {
+                volunteeredId: pick,
+                ...(cursor !== undefined && { wonId: cursor }),
+                ...(ctx.currentSkillId !== undefined && { fromSkillId: ctx.currentSkillId }),
+                iteration: ctx.iteration,
+            });
+        }
+        // The same told-the-truth check for an ACCEPTED transition proposal
+        // (9.19.0): the effect was accepted (`tools.effect { outcome:
+        // 'accepted' }` is on the record) but a declared edge fired on the same
+        // batch and won the cursor (D1 outranks the proposal exactly as it
+        // outranks a pick). Said out loud rather than left as a promise that
+        // quietly went unmet.
+        if (proposal !== undefined && cursor !== proposal.targetSkillId) {
+            typedEmit(scope, 'agentfootprint.skill.reroute_superseded', {
+                volunteeredId: proposal.targetSkillId,
+                ...(cursor !== undefined && { wonId: cursor }),
+                ...(ctx.currentSkillId !== undefined && { fromSkillId: ctx.currentSkillId }),
+                iteration: ctx.iteration,
+                source: 'tool-proposal',
+            });
+        }
+        // activeInjections — the REAL output the slot subflows read. 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.
+        // The ctx goes in (9.57.0): this is the one moment the context and the
+        // content are both in scope, so a templated instruction is rendered here
+        // and every reader downstream sees the same plain text it always saw.
+        const activePOJOs = evaluation.active.map((inj) => projectActiveInjection(inj, ctx));
+        // The park card rides as its own row — a reserved id, so it is one
+        // identifiable line on the record (composition, budget, the context
+        // ledger) instead of an anonymous string glued onto somebody's fragment.
+        // Appended LAST: it is a framework aside about the map, and it should
+        // read after the content it is commenting on.
+        if (parkCardText !== undefined) {
+            activePOJOs.push({
+                id: PARK_CARD_ID,
+                flavor: 'steering',
+                description: 'the mount kernel telling the model which maps are parked, and the way back',
+                inject: { systemPrompt: parkCardText },
+            });
+        }
+        scope.$setValue('activeInjections', activePOJOs);
+        // The kernel's SERVED carrier (9.59.0) — this pass's answer, read as the
+        // previous pass's on the next one. Written on EVERY pass the kernel is
+        // mounted (even as []), so a boundary never re-delivers a stale set.
+        if (engagementPlan !== undefined) {
+            scope.$setValue('nextServedInjectionIds', activePOJOs.map((i) => i.id));
+        }
+        const routing = routingEntriesOf(evaluation.active);
+        // Structural copy (the events layer stays decoupled from `CursorMove`), and a
+        // POJO so it survives the emit channel's clone.
+        //
+        // SG-C decoration: on the iteration a MODEL PICK resolves an outstanding
+        // turn-start menu, the move carries the menu it resolved (`offered`) — and
+        // `declinedOffer: true` when the accepted pick was reachable but NOT on it.
+        // Under 'assist' the model's divergence from the menu is DATA, not a
+        // refusal; without this stamp the record could not tell an on-menu pick
+        // from an off-menu one. `menuOutstanding` is the same one implementation
+        // the envelope and the 'guard' gate use, judged on the PRE-advance cursor
+        // (this very move is what closes the menu).
+        const resolvedMenu = move?.by === 'model-pick' &&
+            move.to !== undefined &&
+            menuOutstanding(ctx.turnRoute, ctx.currentSkillId)
+            ? {
+                offered: [...ctx.turnRoute.offered],
+                ...(ctx.turnRoute.offered.includes(move.to) ? {} : { declinedOffer: true }),
+            }
+            : undefined;
+        // The gate's admissible set from the LANDED cursor (9.50.0) — asked once,
+        // beside the one resolver consultation, so the recorded set and this
+        // iteration's read_skill offer/refusals come from the same answer. A POJO
+        // copy (event payloads are detached plain data); `[]` is a fact (a dead
+        // end), absence means the graph could not say.
+        const reachable = move !== undefined && reachableSkills ? [...reachableSkills(cursor)] : undefined;
+        const cursorMove = move
+            ? {
+                ...(move.from !== undefined && { from: move.from }),
+                ...(move.to !== undefined && { to: move.to }),
+                by: move.by,
+                ...(reachable !== undefined && { reachable }),
+                // Tier-1 DATA-matcher evidence (9.28.0) — what the message said that
+                // routed this hop. Copied field-by-field: the event payload is a
+                // structural shape, never the engine's own object.
+                ...(move.witness !== undefined && {
+                    witness: {
+                        text: move.witness.text,
+                        ...(move.witness.keyword !== undefined && { keyword: move.witness.keyword }),
+                    },
+                }),
+                // Data-guard evidence (9.51.0) — the taken hop's evaluation and the
+                // refusals, copied field-by-field like the witness: the event
+                // payload is a structural shape, never the engine's own object.
+                ...(move.guard !== undefined && { guard: copyGuardEvaluation(move.guard) }),
+                ...(move.guardsClosed !== undefined &&
+                    move.guardsClosed.length > 0 && {
+                    guardsClosed: move.guardsClosed.map(copyGuardEvaluation),
+                }),
+                ...resolvedMenu,
+            }
+            : undefined;
+        // Aggregate evaluation metadata is pure OBSERVABILITY — no flow stage
+        // reads it — so it goes out the EMIT channel where a recorder/Lens can
+        // observe "what was considered, what won, what was skipped and why".
+        typedEmit(scope, 'agentfootprint.context.evaluated', {
+            iteration: ctx.iteration,
+            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),
+            // The Skill menu the LLM was offered (same text as the read_skill tool
+            // description) — pair "offered" with "chosen" (activatedInjectionIds) to
+            // debug a missed/wrong read_skill call.
+            skillCatalog: skillCatalogOf(injections),
+            // Routing PROVENANCE for active skill-graph injections — the decision path
+            // / edge that reached each. Undefined when none came from a skillGraph().
+            //
+            // NOTE the difference from `cursorMove` below, which is the whole reason the
+            // latter exists: `routing[]` is BUILD-TIME provenance ("how is this skill
+            // reachable at all"), stamped once by the compiler. It answers per SKILL, not
+            // per HOP. Reading it as the cause of this turn's move is what made a model
+            // pick get recorded under a declared edge's label.
+            ...(routing && { routing }),
+            // How the CURSOR actually moved this iteration, straight from the clause that
+            // won inside the resolver (8.5.0). Skill-graph agents only; absent for a graph
+            // built before `explainNextSkill` existed.
+            ...(cursorMove && { cursorMove }),
+            // Entries whose own `when` matched and which the cursor law kept OFF the wire
+            // (8.15.0). A conditional entry is active exactly while the cursor is on it,
+            // and a suppression the run cannot name is a silent drop. Omitted when nothing
+            // was suppressed, so the common iteration is byte-identical to 8.14.0.
+            ...(supersededIds.length > 0 && { supersededIds }),
+        });
+    };
+}
+/** One guard evaluation as a DETACHED POJO for the emit channel (9.51.0) —
+ *  field-by-field, conditions included: event payloads must be plain data,
+ *  and value arrays are re-sliced so no live reference rides the record. */
+function copyGuardEvaluation(g) {
+    return {
+        from: g.from,
+        to: g.to,
+        toolName: g.toolName,
+        ...(g.toolCallId !== undefined && { toolCallId: g.toolCallId }),
+        verdict: g.verdict,
+        conditions: g.conditions.map((c) => ({
+            key: c.key,
+            op: c.op,
+            value: Array.isArray(c.value) ? [...c.value] : c.value,
+            actualSummary: c.actualSummary,
+            passed: c.passed,
+        })),
+    };
+}
+/** Per active skill-graph injection: its routing provenance + unlocked tools.
+ *  Returns undefined when no active injection carries skill-graph metadata, so
+ *  the emit payload omits `routing` entirely for non-skill-graph runs. */
+function routingEntriesOf(active) {
+    const entries = active.flatMap((inj) => {
+        const routing = inj.metadata?.[SKILL_GRAPH_METADATA_KEY];
+        if (!routing)
+            return [];
+        return [
+            {
+                injectionId: inj.id,
+                flavor: inj.flavor,
+                via: routing.via,
+                ...(routing.path && {
+                    path: routing.path.map((s) => ({ label: s.label, branch: s.branch })),
+                }),
+                ...(routing.label && { label: routing.label }),
+                ...(routing.from && { from: routing.from }),
+                ...(routing.triggerKind && { triggerKind: routing.triggerKind }),
+                tools: (inj.inject.tools ?? []).map((t) => t.schema.name),
+            },
+        ];
+    });
+    return entries.length > 0 ? entries : undefined;
+}
+// ── Stage 3: Route ───────────────────────────────────────────────────────
+/** Partition active injections by the slot(s) each contributes to. Mirrors
+ *  the slot subflows' own filters so this view matches what they compose.
+ *  Pure — exported for unit tests + reuse (e.g. the lens). */
+export function routeActiveInjections(active) {
+    const systemPrompt = [];
+    const messages = [];
+    const tools = [];
+    for (const inj of active) {
+        const entry = {
+            id: inj.id,
+            source: inj.flavor,
+            reason: inj.description ?? `${inj.flavor} '${inj.id}' active`,
+        };
+        // system-prompt: has prompt content AND not a tool-only Skill
+        // (mirrors buildSystemPromptSlot's Block C suppression).
+        if (inj.inject.systemPrompt &&
+            inj.inject.systemPrompt.length > 0 &&
+            !(inj.flavor === 'skill' && inj.surfaceMode === 'tool-only')) {
+            systemPrompt.push(entry);
+        }
+        if (inj.inject.messages && inj.inject.messages.length > 0)
+            messages.push(entry);
+        if (inj.inject.tools && inj.inject.tools.length > 0)
+            tools.push(entry);
+    }
+    return { systemPrompt, messages, tools };
+}
+function routeStage(scope) {
+    const active = scope.$getValue('activeInjections') ?? [];
+    scope.$setValue('activeByslot', routeActiveInjections(active));
+}
+// ── Stage 4: Delta ───────────────────────────────────────────────────────
+/** Diff this turn's per-slot buckets against last turn's (carried via the
+ *  mount mappers as `priorActiveByslot`). Turn 1 / unwired → all "added". */
+function deltaStage(scope) {
+    const current = scope.$getValue('activeByslot') ?? EMPTY_ACTIVE_BY_SLOT;
+    const prior = scope.$getArgs().priorActiveByslot ?? EMPTY_ACTIVE_BY_SLOT;
+    scope.$setValue('slotDelta', diffActiveBySlot(prior, current));
+}
+/** Diff two per-slot snapshots into a per-slot delta. Pure — exported for
+ *  unit tests + reuse. */
+export function diffActiveBySlot(prior, current) {
+    return {
+        systemPrompt: diffSlot(prior.systemPrompt, current.systemPrompt),
+        messages: diffSlot(prior.messages, current.messages),
+        tools: diffSlot(prior.tools, current.tools),
+    };
+}
+/** added = now-not-before, removed = before-not-now, kept = both. */
+function diffSlot(prior, current) {
+    const priorIds = new Set(prior.map((e) => e.id));
+    const currentIds = new Set(current.map((e) => e.id));
+    return {
+        added: [...currentIds].filter((id) => !priorIds.has(id)),
+        removed: [...priorIds].filter((id) => !currentIds.has(id)),
+        kept: [...currentIds].filter((id) => priorIds.has(id)),
+    };
+}
+/** The Skill catalog the LLM was offered — id + description for every Skill
+ *  injection, mirroring buildReadSkillTool's `(no description)` fallback. */
+function skillCatalogOf(injections) {
+    return injections
+        .filter((i) => i.flavor === 'skill')
+        .map((i) => ({ id: i.id, description: i.description ?? '(no description)' }));
+}
+/** 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/esm/injection-engine/buildInjectionEngineSubflow.js.map

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

package/dist/esm/injection-engine/classifierScorer.d.ts

@@ -0,0 +1,44 @@
+/**
+ * classifierScorer — an {@link EntryScorer} whose ranking IS a calibrated
+ * classifier's distribution (9.104.0; docs/design/2026-09-scored-choice.md
+ * step 2, opened when a provider that scores came in reach).
+ *
+ * `keywordScorer` and `embeddingScorer` compute a raw score per candidate
+ * and let `rankEntries` soften it into a `relevance` share. This scorer has
+ * no raw score to soften: the classifier is asked ONE `choice` question
+ * over the candidates — criteria `{ id: description }`, declared before the
+ * call, the same law as declared tags and routes — and answers with a
+ * probability per candidate and a pick. Both are the provider's data and
+ * both land on `EntryScoring` unchanged: `ranked[].score` and
+ * `ranked[].relevance` are the SAME number (the probability as sent, never
+ * renormalised), and `chosen` is the provider's `choice`, not an argmax the
+ * library took — a provider whose pick differs from its own argmax is
+ * recorded as it answered, which is a fact about the provider.
+ *
+ * A provider failure is NOT a guess: the scorer returns
+ * `scorer: 'classifier:unavailable'`, an EMPTY ranking and no `chosen`.
+ * `stages/pickEntry.ts` leaves the cursor unset on an undefined `chosen`
+ * and the Injection Engine's cold-start entry pick takes over — the
+ * fallback that already exists for a throwing embedder, reached here
+ * through the honest empty result rather than a throw.
+ *
+ * Pure core of the skill-graph fence: the only import outside the folder
+ * is the `Classifier` port type (`src/classify/types.ts`, a zero-import leaf).
+ */
+import type { Classifier } from '../classify/types.js';
+import type { EntryScorer } from './entryScorer.js';
+export interface ClassifierScorerOptions {
+    /** The instruction on the choice question. Default: pick the skill the message is for. */
+    readonly instructions?: string;
+}
+/** The question id every scoring asks under — fixed, so a record reader can find it. */
+export declare const CLASSIFIER_SCORER_QUESTION: "entry";
+/** The `scorer` name on an unavailable result. */
+export declare const CLASSIFIER_SCORER_UNAVAILABLE: "classifier:unavailable";
+/**
+ * `classifierScorer(classifier)` — plug into `skillGraph().entryBy(...)`.
+ * `scorer` on a scoring is `'classifier:' + the provider's model string`
+ * (`'classifier:jev-1.13.0'`), so the "Why this skill?" panel names the
+ * exact model that ranked.
+ */
+export declare function classifierScorer(classifier: Classifier, options?: ClassifierScorerOptions): EntryScorer;