agentfootprint 8.4.0 → 8.6.0

package/dist/esm/lib/injection-engine/buildInjectionEngineSubflow.d.ts

@@ -56,6 +56,7 @@
  */
 import type { FlowChart } from 'footprintjs';
 import { type ActiveInjection, type Injection, type InjectionContext } from './types.js';
+import { type CursorMove } from './skillGraph.js';
 export interface InjectionEngineConfig {
     /**
      * The Injection list. Frozen at build time. To change at runtime,
@@ -70,6 +71,17 @@ export interface InjectionEngineConfig {
      * (the keystone). Absent → `currentSkillId` is never written (no graph routing).
      */
     readonly nextSkill?: (ctx: InjectionContext) => string | undefined;
+    /**
+     * The same resolver, reporting the clause that WON (`graph.explainNextSkill`,
+     * 8.5.0). Preferred over `nextSkill` when present — the stage takes the cursor
+     * from `.to`, so the graph is still consulted exactly once per iteration, and
+     * stamps the cause on `context.evaluated` as `cursorMove`.
+     *
+     * Optional for forward-compat with graphs built before it existed; without it
+     * the stage falls back to `nextSkill` and emits no `cursorMove` (an observer
+     * then sees exactly what it saw in 8.4.0).
+     */
+    readonly explainNextSkill?: (ctx: InjectionContext) => CursorMove;
 }
 /** One routed entry per (active injection × slot it contributes to). */
 export interface RoutedInjection {

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

@@ -73,7 +73,7 @@ export function buildInjectionEngineSubflow(config) {
     return flowChart('Gather', gatherStage, 'gather', {
         description: "Snapshot this turn's injection inputs (iteration, history, last tool, LLM-activated)",
     })
-        .addFunction('Evaluate', makeEvaluateStage(injections, config.nextSkill), 'evaluate', 'Evaluate every Injection trigger; produce activeInjections + metadata')
+        .addFunction('Evaluate', makeEvaluateStage(injections, config.nextSkill, config.explainNextSkill), '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();
@@ -90,7 +90,7 @@ function gatherStage(scope) {
     });
 }
 // ── Stage 2: Evaluate (logic identical to the old single stage) ──────────
-function makeEvaluateStage(injections, nextSkill) {
+function makeEvaluateStage(injections, nextSkill, explainNextSkill) {
     return (scope) => {
         const args = scope.$getArgs();
         const ctx = {
@@ -110,8 +110,13 @@ function makeEvaluateStage(injections, nextSkill) {
         // (`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.
-        const cursor = nextSkill ? nextSkill(ctx) : undefined;
-        if (nextSkill) {
+        // 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(ctx) : undefined;
+        const routes = explainNextSkill !== undefined || nextSkill !== undefined;
+        const cursor = move ? move.to : nextSkill ? nextSkill(ctx) : undefined;
+        if (routes) {
             scope.$setValue('nextSkillCursor', cursor);
         }
         const evaluation = evaluateInjections(injections, ctx);
@@ -141,6 +146,15 @@ function makeEvaluateStage(injections, nextSkill) {
         const activePOJOs = evaluation.active.map(projectActiveInjection);
         scope.$setValue('activeInjections', activePOJOs);
         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.
+        const cursorMove = move
+            ? {
+                ...(move.from !== undefined && { from: move.from }),
+                ...(move.to !== undefined && { to: move.to }),
+                by: move.by,
+            }
+            : 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".
@@ -158,7 +172,17 @@ function makeEvaluateStage(injections, nextSkill) {
             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 }),
         });
     };
 }

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

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

package/dist/esm/lib/injection-engine/index.d.ts

@@ -18,6 +18,6 @@ export { buildListSkillsTool, buildReadSkillTool, type SkillToolPair } from './s
 export { defineSteering, type DefineSteeringOptions } from './factories/defineSteering.js';
 export { defineFact, type DefineFactOptions } from './factories/defineFact.js';
 export { defineInjection, type DefineInjectionOptions, type InjectionFlavor, } from './factories/defineInjection.js';
-export { skillGraph, decideSkill, SKILL_GRAPH_METADATA_KEY, type SkillGraph, type SkillGraphBuilder, type SkillRouteOptions, type SkillEntryOptions, type TreeOptions, type SkillEdge, type SkillEdgeKind, type SkillNode, type DecisionNode, type SkillRouting, type SkillRoutingStep, type EntryScore, type EntryScoring, type SkillGraphConfig, type SkillGraphFlatConfig, type SkillGraphTreeConfig, type SkillGraphStart, type SkillGraphStep, type BuildOptions, type GraphCheckMode, type GraphCheckup, type GraphProblem, type GraphProblemCode, } from './skillGraph.js';
+export { skillGraph, decideSkill, SKILL_GRAPH_METADATA_KEY, type SkillGraph, type SkillGraphBuilder, type SkillRouteOptions, type SkillEntryOptions, type TreeOptions, type SkillEdge, type SkillEdgeKind, type SkillNode, type DecisionNode, type SkillRouting, type SkillRoutingStep, type CursorMove, type CursorMoveCause, type EntryScore, type EntryScoring, type SkillGraphConfig, type SkillGraphFlatConfig, type SkillGraphTreeConfig, type SkillGraphStart, type SkillGraphStep, type BuildOptions, type GraphCheckMode, type GraphCheckup, type GraphProblem, type GraphProblemCode, } from './skillGraph.js';
 export { keywordScorer, embeddingScorer, rankEntries, type EntryScorer, type EntryScorerInput, type EntryCandidate, } from './entryScorer.js';
 export { checkSkillContract, checkSkillContracts, skillToolNames } from './skillContract.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/injection-engine/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,+DAA+D;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEpD,SAAS;AACT,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EACL,2BAA2B,GAE5B,MAAM,kCAAkC,CAAC;AAE1C,gFAAgF;AAChF,OAAO,EAAE,iBAAiB,EAAiC,MAAM,kCAAkC,CAAC;AACpG,OAAO,EAAE,mBAAmB,EAA6B,MAAM,oCAAoC,CAAC;AAEpG,OAAO,EACL,WAAW,EACX,kBAAkB,GAKnB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,aAAa,EAA6B,MAAM,oBAAoB,CAAC;AAE9E,8EAA8E;AAC9E,+EAA+E;AAC/E,6DAA6D;AAC7D,OAAO,EAAE,aAAa,EAA6B,MAAM,oBAAoB,CAAC;AAE9E,wEAAwE;AACxE,sEAAsE;AACtE,iEAAiE;AACjE,+BAA+B;AAC/B,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAsB,MAAM,iBAAiB,CAAC;AAE9F,OAAO,EAAE,cAAc,EAA8B,MAAM,+BAA+B,CAAC;AAE3F,OAAO,EAAE,UAAU,EAA0B,MAAM,2BAA2B,CAAC;AAE/E,6EAA6E;AAC7E,0EAA0E;AAC1E,qDAAqD;AACrD,OAAO,EACL,eAAe,GAGhB,MAAM,gCAAgC,CAAC;AAExC,4EAA4E;AAC5E,8EAA8E;AAC9E,OAAO,EACL,UAAU,EACV,WAAW,EACX,wBAAwB,GAwBzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,aAAa,EACb,eAAe,EACf,WAAW,GAIZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/injection-engine/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,+DAA+D;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEpD,SAAS;AACT,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EACL,2BAA2B,GAE5B,MAAM,kCAAkC,CAAC;AAE1C,gFAAgF;AAChF,OAAO,EAAE,iBAAiB,EAAiC,MAAM,kCAAkC,CAAC;AACpG,OAAO,EAAE,mBAAmB,EAA6B,MAAM,oCAAoC,CAAC;AAEpG,OAAO,EACL,WAAW,EACX,kBAAkB,GAKnB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,aAAa,EAA6B,MAAM,oBAAoB,CAAC;AAE9E,8EAA8E;AAC9E,+EAA+E;AAC/E,6DAA6D;AAC7D,OAAO,EAAE,aAAa,EAA6B,MAAM,oBAAoB,CAAC;AAE9E,wEAAwE;AACxE,sEAAsE;AACtE,iEAAiE;AACjE,+BAA+B;AAC/B,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAsB,MAAM,iBAAiB,CAAC;AAE9F,OAAO,EAAE,cAAc,EAA8B,MAAM,+BAA+B,CAAC;AAE3F,OAAO,EAAE,UAAU,EAA0B,MAAM,2BAA2B,CAAC;AAE/E,6EAA6E;AAC7E,0EAA0E;AAC1E,qDAAqD;AACrD,OAAO,EACL,eAAe,GAGhB,MAAM,gCAAgC,CAAC;AAExC,4EAA4E;AAC5E,8EAA8E;AAC9E,OAAO,EACL,UAAU,EACV,WAAW,EACX,wBAAwB,GA4BzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,aAAa,EACb,eAAe,EACf,WAAW,GAIZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/esm/lib/injection-engine/skillBodyDelivery.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Where a skill's BODY actually lands — and the one combination where the honest
+ * answer is "nowhere" (8.5.0).
+ *
+ * `surfaceMode` names a delivery CHANNEL, and `'tool-only'` names the channel that
+ * only exists when the model calls `read_skill`: the body is returned as that tool's
+ * result, and the system slot suppresses it by design (`buildSystemPromptSlot`,
+ * mirrored in `routeActiveInjections`). That is exactly right for a skill `read_skill`
+ * activates, which is what the mode was designed against and what every shipped
+ * Block-C test covers.
+ *
+ * It is a hole for a skill the GRAPH activates. A route target, a flat entry and a
+ * decision-tree leaf all activate off the cursor, without any `read_skill` call — so
+ * the tool result never happens, the system slot suppresses the body anyway, and the
+ * body reaches the model through no channel at all. The skill's TOOLS still arrive,
+ * which makes it worse than the skill not loading: the model is handed the tools of a
+ * procedure it was never told.
+ *
+ * The rule that closes it is the one 8.4.0 already uses for the `read_skill` gate:
+ * `trigger.kind === 'llm-activated'` is precisely "read_skill can really activate
+ * this". A skill may claim the read_skill delivery channel exactly when read_skill is
+ * what activates it.
+ *
+ * Refusal rather than a quiet fall back to the system slot, because the author wrote
+ * `'tool-only'` to keep the body OUT of the system prompt (token cost, attention
+ * placement). Silently putting it back would honour the activation and break the
+ * declaration — a different lie, not a fix. `'both'` already means "deliver it either
+ * way", so the refusal has a real, one-word answer to name.
+ */
+import type { Injection } from './types.js';
+import { type SurfaceMode } from './factories/defineSkill.js';
+/**
+ * The surface mode a skill will be TREATED as at runtime.
+ *
+ * Today the runtime compares the literal string, so `'auto'` is its own mode and
+ * lands in the system slot — pass no provider and that is what you get back, which
+ * is the truth about the current engine.
+ *
+ * Pass a provider (and model) to ask the OTHER question: what would `'auto'` become
+ * if the `resolveSurfaceMode` cascade were wired into the runtime? It resolves to
+ * `'tool-only'` for every non-Claude provider, so wiring it in without this guard
+ * would silently open the delivered-nowhere hole for every OpenAI / Bedrock / Ollama
+ * user at once. Routing both questions through ONE function is what keeps that from
+ * being a future accident: the refusal below is written against this, so the day the
+ * cascade is wired in, the guard already covers it.
+ */
+export declare function resolvedSurfaceModeOf(skill: Injection, provider?: string, model?: string): SurfaceMode;
+/**
+ * Can this skill's body be delivered through the `read_skill` tool result?
+ *
+ * Only if `read_skill` is what activates it. `'llm-activated'` is the one trigger
+ * kind that reads `activatedInjectionIds`, which is the only thing a `read_skill`
+ * call writes — the same clause the gate's open-skill rule turns on (8.4.0).
+ */
+export declare function activatesByRead(skill: Injection): boolean;
+/**
+ * Refuse every skill that claims the `read_skill` delivery channel without being
+ * activated by `read_skill`. Returns the message, or `undefined` when all is well.
+ *
+ * Runs over the FINAL injection list — the agent is the only place that sees every
+ * skill's compiled trigger, whichever call registered it — and names every offender,
+ * because `skillsFromDir({ surfaceMode: 'tool-only' })` under a graph refuses a whole
+ * directory at once and a list is debuggable where one sample is not.
+ */
+export declare function toolOnlyDeliveryRefusal(injections: readonly Injection[]): string | undefined;

package/dist/esm/lib/injection-engine/skillBodyDelivery.js

@@ -0,0 +1,110 @@
+/**
+ * Where a skill's BODY actually lands — and the one combination where the honest
+ * answer is "nowhere" (8.5.0).
+ *
+ * `surfaceMode` names a delivery CHANNEL, and `'tool-only'` names the channel that
+ * only exists when the model calls `read_skill`: the body is returned as that tool's
+ * result, and the system slot suppresses it by design (`buildSystemPromptSlot`,
+ * mirrored in `routeActiveInjections`). That is exactly right for a skill `read_skill`
+ * activates, which is what the mode was designed against and what every shipped
+ * Block-C test covers.
+ *
+ * It is a hole for a skill the GRAPH activates. A route target, a flat entry and a
+ * decision-tree leaf all activate off the cursor, without any `read_skill` call — so
+ * the tool result never happens, the system slot suppresses the body anyway, and the
+ * body reaches the model through no channel at all. The skill's TOOLS still arrive,
+ * which makes it worse than the skill not loading: the model is handed the tools of a
+ * procedure it was never told.
+ *
+ * The rule that closes it is the one 8.4.0 already uses for the `read_skill` gate:
+ * `trigger.kind === 'llm-activated'` is precisely "read_skill can really activate
+ * this". A skill may claim the read_skill delivery channel exactly when read_skill is
+ * what activates it.
+ *
+ * Refusal rather than a quiet fall back to the system slot, because the author wrote
+ * `'tool-only'` to keep the body OUT of the system prompt (token cost, attention
+ * placement). Silently putting it back would honour the activation and break the
+ * declaration — a different lie, not a fix. `'both'` already means "deliver it either
+ * way", so the refusal has a real, one-word answer to name.
+ */
+import { resolveSurfaceMode } from './factories/defineSkill.js';
+/** A skill's declared surface mode, before any provider resolution. */
+function declaredSurfaceModeOf(skill) {
+    const meta = skill.metadata;
+    return meta?.surfaceMode ?? 'auto';
+}
+/**
+ * The surface mode a skill will be TREATED as at runtime.
+ *
+ * Today the runtime compares the literal string, so `'auto'` is its own mode and
+ * lands in the system slot — pass no provider and that is what you get back, which
+ * is the truth about the current engine.
+ *
+ * Pass a provider (and model) to ask the OTHER question: what would `'auto'` become
+ * if the `resolveSurfaceMode` cascade were wired into the runtime? It resolves to
+ * `'tool-only'` for every non-Claude provider, so wiring it in without this guard
+ * would silently open the delivered-nowhere hole for every OpenAI / Bedrock / Ollama
+ * user at once. Routing both questions through ONE function is what keeps that from
+ * being a future accident: the refusal below is written against this, so the day the
+ * cascade is wired in, the guard already covers it.
+ */
+export function resolvedSurfaceModeOf(skill, provider, model) {
+    const declared = declaredSurfaceModeOf(skill);
+    if (declared !== 'auto' || provider === undefined)
+        return declared;
+    return resolveSurfaceMode(provider, model);
+}
+/**
+ * Can this skill's body be delivered through the `read_skill` tool result?
+ *
+ * Only if `read_skill` is what activates it. `'llm-activated'` is the one trigger
+ * kind that reads `activatedInjectionIds`, which is the only thing a `read_skill`
+ * call writes — the same clause the gate's open-skill rule turns on (8.4.0).
+ */
+export function activatesByRead(skill) {
+    return skill.trigger.kind === 'llm-activated';
+}
+/** How a refused skill is identified back to its author, so a directory-sized
+ *  refusal reads as a list of names and reasons rather than one mystery. */
+function describeRouting(skill) {
+    const routing = skill.metadata
+        ?.skillGraph;
+    if (routing?.via === 'route') {
+        return routing.from
+            ? `a route target (the graph routes "${routing.from}" → "${skill.id}")`
+            : 'a route target';
+    }
+    if (routing?.via === 'entry')
+        return 'a graph entry';
+    if (routing?.via === 'tree')
+        return 'a decision-tree leaf';
+    return `activated by rule (trigger '${skill.trigger.kind}')`;
+}
+/**
+ * Refuse every skill that claims the `read_skill` delivery channel without being
+ * activated by `read_skill`. Returns the message, or `undefined` when all is well.
+ *
+ * Runs over the FINAL injection list — the agent is the only place that sees every
+ * skill's compiled trigger, whichever call registered it — and names every offender,
+ * because `skillsFromDir({ surfaceMode: 'tool-only' })` under a graph refuses a whole
+ * directory at once and a list is debuggable where one sample is not.
+ */
+export function toolOnlyDeliveryRefusal(injections) {
+    const offenders = injections.filter((i) => i.flavor === 'skill' &&
+        resolvedSurfaceModeOf(i) === 'tool-only' &&
+        !activatesByRead(i) &&
+        (i.inject.systemPrompt ?? '').length > 0);
+    if (offenders.length === 0)
+        return undefined;
+    const list = offenders.map((s) => `  • "${s.id}" — ${describeRouting(s)}`).join('\n');
+    const subject = offenders.length === 1 ? 'This skill sets' : 'These skills set';
+    const its = offenders.length === 1 ? 'its' : 'their';
+    return (`Agent: ${subject} surfaceMode: 'tool-only', which delivers the body as the ` +
+        `read_skill tool result — but nothing here activates by read_skill, so ${its} ` +
+        `body would reach the model NOWHERE: the system slot suppresses a tool-only body ` +
+        `by design, and no read_skill call happens to carry it.\n${list}\n` +
+        `Use 'both' (system prompt AND tool result) or 'system-prompt'. Only a skill ` +
+        `read_skill actually activates — trigger 'llm-activated', which is every skill a ` +
+        `graph does not route — can be 'tool-only'.`);
+}
+//# sourceMappingURL=skillBodyDelivery.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skillBodyDelivery.js","sourceRoot":"","sources":["../../../../src/lib/injection-engine/skillBodyDelivery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,EAAE,kBAAkB,EAAoB,MAAM,4BAA4B,CAAC;AAElF,uEAAuE;AACvE,SAAS,qBAAqB,CAAC,KAAgB;IAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,QAAqD,CAAC;IACzE,OAAO,IAAI,EAAE,WAAW,IAAI,MAAM,CAAC;AACrC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAgB,EAChB,QAAiB,EACjB,KAAc;IAEd,MAAM,QAAQ,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAC9C,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IACnE,OAAO,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,KAAgB;IAC9C,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,eAAe,CAAC;AAChD,CAAC;AAED;4EAC4E;AAC5E,SAAS,eAAe,CAAC,KAAgB;IACvC,MAAM,OAAO,GAAI,KAAK,CAAC,QAAyE;QAC9F,EAAE,UAAU,CAAC;IACf,IAAI,OAAO,EAAE,GAAG,KAAK,OAAO,EAAE,CAAC;QAC7B,OAAO,OAAO,CAAC,IAAI;YACjB,CAAC,CAAC,qCAAqC,OAAO,CAAC,IAAI,QAAQ,KAAK,CAAC,EAAE,IAAI;YACvE,CAAC,CAAC,gBAAgB,CAAC;IACvB,CAAC;IACD,IAAI,OAAO,EAAE,GAAG,KAAK,OAAO;QAAE,OAAO,eAAe,CAAC;IACrD,IAAI,OAAO,EAAE,GAAG,KAAK,MAAM;QAAE,OAAO,sBAAsB,CAAC;IAC3D,OAAO,+BAA+B,KAAK,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;AAC/D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CAAC,UAAgC;IACtE,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CACjC,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,MAAM,KAAK,OAAO;QACpB,qBAAqB,CAAC,CAAC,CAAC,KAAK,WAAW;QACxC,CAAC,eAAe,CAAC,CAAC,CAAC;QACnB,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAC3C,CAAC;IACF,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAE7C,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtF,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,kBAAkB,CAAC;IAChF,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;IACrD,OAAO,CACL,UAAU,OAAO,4DAA4D;QAC7E,yEAAyE,GAAG,GAAG;QAC/E,kFAAkF;QAClF,2DAA2D,IAAI,IAAI;QACnE,8EAA8E;QAC9E,kFAAkF;QAClF,4CAA4C,CAC7C,CAAC;AACJ,CAAC"}

package/dist/esm/lib/injection-engine/skillGraph.d.ts

@@ -12,8 +12,9 @@
  *
  * **v2 keystone — `from` IS enforced (a sticky cursor state machine).** A skill
  * graph is a state machine over skills; the engine tracks which node it is in via
- * `InjectionContext.currentSkillId` (the cursor). One pure resolver — `nextSkill(ctx)`
- * (see `makeNextSkill`) — is the single source of truth: each route target B
+ * `InjectionContext.currentSkillId` (the cursor). One pure resolver — `resolveCursor`
+ * (see `makeResolveCursor`), of which `nextSkill(ctx)` is the `.to` projection — is the
+ * single source of truth: each route target B
  * compiles to the trigger `nextSkill(ctx) === B`, which delivers `from`-gating
  * (an edge `A→B` fires only while the cursor is on A — no cross-skill edge bleed),
  * stickiness (the cursor stays on B until an edge leaves B), and a clean handoff
@@ -24,16 +25,26 @@
  * compiled trigger is always a `rule`. `toMermaid()` renders declared === drawn.
  *
  * A decision `tree()` routes per-iteration by stable `ctx` predicates (no cursor)
- * and is unaffected by `from`-gating.
+ * and is unaffected by `from`-gating. It has no cursor for `read_skill` to move
+ * either, so `reachableSkills()` is EMPTY there and the gate refuses a leaf pick
+ * (8.5.0) — see `reachableSkills` for why honouring it would break three of this
+ * module's own invariants.
  *
  * **The model moves too (`read_skill`).** Scoped `read_skill` bounds the model to
  * `reachableSkills(cursor)` — the declared successors of where it stands, plus the
  * entries. A pick the gate ACCEPTS moves the cursor exactly like a declared edge
- * does (`ctx.pendingSkillPick`, honoured in `makeNextSkill`), so what the gate
+ * does (`ctx.pendingSkillPick`, honoured in `makeResolveCursor`), so what the gate
  * allows and what actually takes effect are the same set. A declared edge that
  * fires the same turn wins (`D1 > D2`, docs/design/skill-graph.md §4A.1) and the
  * run emits `agentfootprint.skill.reroute_superseded` rather than leaving the
  * model's answered-"activated" claim quietly unmet.
+ *
+ * **The resolver says WHY, it is not asked to be guessed.** `explainNextSkill(ctx)`
+ * returns the destination AND the winning clause (`CursorMove`), decided at the same
+ * `return`. The agent stamps it on `context.evaluated` as `cursorMove`, which is how
+ * `routeRecorder()` can tell a model pick from a declared edge that happens to point
+ * at the same skill (8.5.0 — before, the drawn build-time provenance was read as the
+ * per-hop cause, so a model pick was recorded under a declared edge's label).
  */
 import type { Injection, InjectionContext } from './types.js';
 import type { Embedder } from '../../memory/embedding/types.js';
@@ -152,8 +163,15 @@ export interface TreeOptions {
      * A decision tree routes to EXACTLY ONE skill per iteration, so each leaf is
      * stamped `autoActivate: 'currentSkill'` — its `inject.tools` reach the LLM
      * ONLY when the tree routes there, instead of every skill's tools landing in
-     * the always-on static registry on every call. `read_skill` stays available as
-     * the escape hatch to reach another skill mid-run.
+     * the always-on static registry on every call.
+     *
+     * `read_skill` cannot reach another LEAF mid-run (8.5.0): a tree has no cursor to
+     * move, and this "exactly one leaf" property is one of the reasons — admitting a
+     * second leaf would put two leaves' tools on the wire and make the dev-mode
+     * exactly-one monitor warn. It said otherwise until 8.5.0, and the pick was
+     * accepted and then silently dropped. The escape hatch is a skill registered
+     * BESIDE the graph (`.skill(x)`, `.selfExplain()`), which really does activate by
+     * `read_skill` and is admitted from anywhere.
      *
      * Default `true`. Set `false` for the legacy additive behavior (all leaves'
      * tools always visible). A leaf that sets its OWN `autoActivate` in
@@ -188,6 +206,33 @@ export interface DecisionNode {
  *  other `decideSkill(...)` results. (Renamed from `decide` in v7 to avoid
  *  colliding with footprintjs's `decide()`.) */
 export declare function decideSkill(predicate: (ctx: InjectionContext) => boolean, whenTrue: DecisionNode | Injection, whenFalse: DecisionNode | Injection, label?: string): DecisionNode;
+/**
+ * WHY the cursor landed where it did on one iteration — the winning clause of the
+ * one cursor resolver, reported rather than guessed (8.5.0).
+ *
+ *   • `'entry'`      — cold start: the first entry whose `when` passed;
+ *   • `'route'`      — a declared, `from`-gated edge fired (D1);
+ *   • `'model-pick'` — no declared edge fired, so the model's gate-accepted
+ *                      `read_skill` pick moved the cursor (D2), at cold start or mid-run;
+ *   • `'stay'`       — nothing fired; the cursor is sticky and stayed put;
+ *   • `'none'`       — no cursor at all (cold start with nothing to enter, or a
+ *                      decision `tree()`, which routes by predicate and has no cursor).
+ *
+ * This exists because the DRAWN provenance on a skill (`metadata.skillGraph`) answers
+ * "how is this skill reachable" — a build-time fact — and was being read as "how did
+ * we get here this turn". A model pick into a skill that also has a declared edge was
+ * therefore attributed to that edge, label and all, in the recorded route.
+ */
+export type CursorMoveCause = 'entry' | 'route' | 'model-pick' | 'stay' | 'none';
+/** The cursor resolver's full answer: where, and by which clause. */
+export interface CursorMove {
+    /** The cursor after this iteration (what `nextSkill` returns). */
+    readonly to?: string;
+    /** The cursor before it. */
+    readonly from?: string;
+    /** The winning clause. */
+    readonly by: CursorMoveCause;
+}
 /** A node in the drawn graph — a `predicate` diamond or a `skill` box. */
 export interface SkillNode {
     readonly id: string;
@@ -256,6 +301,19 @@ export interface SkillGraph {
      * by predicate (no cursor) and returns the unchanged `ctx.currentSkillId`.
      */
     nextSkill(ctx: InjectionContext): string | undefined;
+    /**
+     * The same answer as `nextSkill`, plus WHICH CLAUSE produced it — the resolver
+     * reporting its own reasoning instead of a consumer inferring it from the drawn
+     * provenance (8.5.0). `explainNextSkill(ctx).to === nextSkill(ctx)`, always: there
+     * is one resolver and `nextSkill` is a thin projection of this one, so the two can
+     * never drift.
+     *
+     * The agent threads this into the injection engine, which stamps the result on
+     * `agentfootprint.context.evaluated` as `cursorMove` — that is what lets
+     * `routeRecorder()` mark a model-pick hop as a model pick instead of borrowing the
+     * label of a declared edge that never fired.
+     */
+    explainNextSkill(ctx: InjectionContext): CursorMove;
     /**
      * The REACHABLE set — which skills the model may `read_skill`-jump to from the
      * current cursor. The agent's runtime gate rejects any `read_skill('id')` whose
@@ -263,8 +321,19 @@ export interface SkillGraph {
      *   • cold start (`currentSkillId` undefined) → the entry skills;
      *   • otherwise → the current skill's direct successors ∪ the entry skills, minus
      *     the current skill itself (deliberate "stay" is the no-tool-call ReAct stop).
-     * Pure + deterministic. A decision `tree()` has no cursor, so it returns ALL leaf
-     * skills — `read_skill` stays a full escape hatch there.
+     *
+     * A decision `tree()` returns EMPTY (8.5.0). A tree routes by predicate on every
+     * iteration and has no cursor to jump: its leaves compile to `rule` triggers, and a
+     * `read_skill` call writes only `activatedInjectionIds`, which a `rule` trigger does
+     * not read. Until 8.5.0 this returned all the leaves, so the gate accepted a leaf
+     * pick, the tool answered "activated for the next iteration", and the leaf never
+     * activated. That is the same clause 8.4.0 already applies everywhere else — a skill
+     * is open only when its trigger is `llm-activated` — reaching the one set that had
+     * escaped it. The escape hatch under a tree is the OPEN skills (anything registered
+     * beside the graph: `.skill(x)`, `.selfExplain()`), which the agent's gate still
+     * admits from any cursor.
+     *
+     * Pure + deterministic.
      */
     reachableSkills(currentSkillId?: string): readonly string[];
     /**