agentfootprint 6.45.0 → 7.1.0

package/dist/esm/tool-providers/index.d.ts

@@ -38,4 +38,4 @@ export { gatedTools } from './gatedTools.js';
 export { skillScopedTools } from './skillScopedTools.js';
 export type { ToolProvider, ToolDispatchContext, ToolGatePredicate } from './types.js';
 export { mcpClient, mockMcpClient } from '../lib/mcp/index.js';
-export type { McpClient, McpClientOptions, McpTransport, McpStdioTransport, McpHttpTransport, MockMcpClientOptions, MockMcpTool, } from '../lib/mcp/index.js';
+export type { McpClient, McpClientOptions, McpSdkClient, McpTransport, McpStdioTransport, McpHttpTransport, MockMcpClientOptions, MockMcpTool, } from '../lib/mcp/index.js';

package/dist/events.js

@@ -0,0 +1,42 @@
+"use strict";
+/**
+ * agentfootprint/events — the typed event system.
+ *
+ * Every agentfootprint run emits a single, strongly-typed event stream:
+ * the registry (`EVENT_NAMES`, `AgentfootprintEventMap`, `AgentfootprintEvent`),
+ * the dispatcher (`EventDispatcher` + listener/wildcard types), the shared
+ * context/composition types, and the ~60 typed payload shapes (grouped
+ * under the `Payloads` namespace).
+ *
+ * This is observability infrastructure, not core agent API, so in v7 it
+ * lives on its own subpath — consistent with `/observe`, `/memory`, etc.
+ * Recorders (`agentfootprint/observe`) and viewer libraries consume it;
+ * the `Agent` builder wires it for you.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventDispatcher = exports.ALL_EVENT_TYPES = exports.EVENT_NAMES = void 0;
+// Shared event/context/composition types.
+__exportStar(require("./events/types.js"), exports);
+// Registry — the event-name set + the typed map/union/discriminant.
+var registry_js_1 = require("./events/registry.js");
+Object.defineProperty(exports, "EVENT_NAMES", { enumerable: true, get: function () { return registry_js_1.EVENT_NAMES; } });
+Object.defineProperty(exports, "ALL_EVENT_TYPES", { enumerable: true, get: function () { return registry_js_1.ALL_EVENT_TYPES; } });
+// Dispatcher — subscribe to the stream (`.on(type, listener)`), wildcard
+// subscriptions, and the unsubscribe handle.
+var dispatcher_js_1 = require("./events/dispatcher.js");
+Object.defineProperty(exports, "EventDispatcher", { enumerable: true, get: function () { return dispatcher_js_1.EventDispatcher; } });
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;;;;;;;;;;;;;;;AAEH,0CAA0C;AAC1C,oDAAkC;AAQlC,oEAAoE;AACpE,oDAM8B;AAL5B,0GAAA,WAAW,OAAA;AACX,8GAAA,eAAe,OAAA;AAMjB,yEAAyE;AACzE,6CAA6C;AAC7C,wDASgC;AAR9B,gHAAA,eAAe,OAAA"}

package/dist/index.js

@@ -21,9 +21,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SequenceBuilder = exports.Sequence = exports.formatToolContractCheckup = exports.toolContractCheckup = exports.warnIfInvalidToolName = exports.assertValidToolName = exports.defineTool = exports.flowchartAsTool = exports.RunCheckpointError = exports.buildDefaultInstruction = exports.applyOutputSchema = exports.OutputSchemaError = exports.AgentBuilder = exports.Agent = exports.buildAgentMessageApiChart = exports.buildMessageApiChart = exports.LLMCallBuilder = exports.LLMCall = exports.renderStatusLine = exports.selectStatus = exports.defaultStatusTemplates = exports.selectCommentaryKey = exports.renderCommentary = exports.extractCommentaryVars = exports.extractAgentName = exports.defaultCommentaryTemplates = exports.isPaused = exports.isPauseRequest = exports.askHuman = exports.pauseHere = exports.makeRunId = exports.RunnerBase = exports.typedEmit = exports.EmitBridge = exports.BASELINE_SOURCES = exports.ENGINEERED_SOURCES = exports.isBaselineSource = exports.isEngineeredSource = exports.contextEngineering = exports.parseSubflowPath = exports.buildEventMeta = exports.COMPOSITION_KEYS = exports.milestoneFor = exports.stageRole = exports.isInjectionKey = exports.injectionKeyForSlot = exports.INJECTION_KEYS = exports.EventDispatcher = exports.ALL_EVENT_TYPES = exports.EVENT_NAMES = void 0;
-exports.patternFactExtractor = exports.llmExtractor = exports.heuristicExtractor = exports.autoPipeline = exports.semanticPipeline = exports.narrativePipeline = exports.factPipeline = exports.ephemeralPipeline = exports.defaultPipeline = exports.skillToolNames = exports.checkSkillContracts = exports.checkSkillContract = exports.rankEntries = exports.embeddingScorer = exports.keywordScorer = exports.SKILL_GRAPH_METADATA_KEY = exports.decide = exports.skillGraph = exports.defineInjection = exports.defineFact = exports.defineSteering = exports.buildReadSkillTool = exports.buildListSkillsTool = exports.SkillRegistry = exports.resolveSurfaceMode = exports.defineSkill = exports.defineRelevanceHint = exports.defineInstruction = exports.projectActiveInjection = exports.buildInjectionEngineSubflow = exports.evaluateInjections = exports.encodeSSE = exports.SSEFormatter = exports.toSSE = exports.providerFromEnv = exports.createProvider = exports.BrowserAzureOpenAIProvider = exports.browserAzureOpenai = exports.BrowserOpenAIProvider = exports.browserOpenai = exports.BrowserAnthropicProvider = exports.browserAnthropic = exports.mock = exports.MockProvider = exports.LoopBuilder = exports.Loop = exports.ConditionalBuilder = exports.Conditional = exports.ParallelBuilder = exports.Parallel = void 0;
-exports.validateMessages = exports.composeMessages = exports.defaultThinkingMessages = exports.defaultCommentaryMessages = exports.PolicyHaltError = exports.PermissionPolicy = exports.skillScopedTools = exports.gatedTools = exports.staticTools = exports.mockMcpClient = exports.mcpClient = exports.indexDocuments = exports.defineRAG = exports.identityNamespace = exports.mockEmbedder = exports.InMemoryStore = exports.SNAPSHOT_PROJECTIONS = exports.MEMORY_TIMING = exports.MEMORY_STRATEGIES = exports.MEMORY_TYPES = exports.defineMemory = exports.llmFactExtractor = void 0;
+exports.indexDocuments = exports.defineRAG = exports.providerFromEnv = exports.LoopBuilder = exports.Loop = exports.ConditionalBuilder = exports.Conditional = exports.ParallelBuilder = exports.Parallel = exports.SequenceBuilder = exports.Sequence = exports.formatToolContractCheckup = exports.toolContractCheckup = exports.warnIfInvalidToolName = exports.assertValidToolName = exports.defineTool = exports.flowchartAsTool = exports.RunCheckpointError = exports.applyOutputSchema = exports.OutputSchemaError = exports.AgentBuilder = exports.Agent = exports.buildAgentMessageApiChart = exports.LLMCallBuilder = exports.LLMCall = exports.selectCommentaryKey = exports.renderCommentary = exports.extractCommentaryVars = exports.extractAgentName = exports.defaultCommentaryTemplates = exports.isPaused = exports.isPauseRequest = exports.askHuman = exports.pauseHere = exports.makeRunId = exports.RunnerBase = exports.BASELINE_SOURCES = exports.ENGINEERED_SOURCES = exports.isBaselineSource = exports.isEngineeredSource = exports.contextEngineering = exports.COMPOSITION_KEYS = exports.milestoneFor = exports.stageRole = exports.isInjectionKey = exports.injectionKeyForSlot = exports.INJECTION_KEYS = void 0;
 // Side-effect imports — auto-register v2.6+ cache strategies in the
 // strategy registry. Without these, only the wildcard NoOp is
 // registered and `Agent.create({ provider: browserAnthropic({...}) })`
@@ -33,14 +31,6 @@ exports.validateMessages = exports.composeMessages = exports.defaultThinkingMess
 require("./cache/strategies/AnthropicCacheStrategy.js");
 require("./cache/strategies/OpenAICacheStrategy.js");
 require("./cache/strategies/BedrockCacheStrategy.js");
-// Events — registry, types, payloads
-__exportStar(require("./events/types.js"), exports);
-var registry_js_1 = require("./events/registry.js");
-Object.defineProperty(exports, "EVENT_NAMES", { enumerable: true, get: function () { return registry_js_1.EVENT_NAMES; } });
-Object.defineProperty(exports, "ALL_EVENT_TYPES", { enumerable: true, get: function () { return registry_js_1.ALL_EVENT_TYPES; } });
-// Dispatcher
-var dispatcher_js_1 = require("./events/dispatcher.js");
-Object.defineProperty(exports, "EventDispatcher", { enumerable: true, get: function () { return dispatcher_js_1.EventDispatcher; } });
 // Adapter interfaces (ports)
 __exportStar(require("./adapters/types.js"), exports);
 // Injection keys + recorder authoring helpers — needed by anyone writing
@@ -66,10 +56,6 @@ Object.defineProperty(exports, "milestoneFor", { enumerable: true, get: function
 // import; downstream code should never need them.
 var types_js_1 = require("./recorders/core/types.js");
 Object.defineProperty(exports, "COMPOSITION_KEYS", { enumerable: true, get: function () { return types_js_1.COMPOSITION_KEYS; } });
-// Bridge helper
-var eventMeta_js_1 = require("./bridge/eventMeta.js");
-Object.defineProperty(exports, "buildEventMeta", { enumerable: true, get: function () { return eventMeta_js_1.buildEventMeta; } });
-Object.defineProperty(exports, "parseSubflowPath", { enumerable: true, get: function () { return eventMeta_js_1.parseSubflowPath; } });
 // Context-engineering + emit primitives.
 //
 // The observability recorder FACTORIES (ContextRecorder, streamRecorder,
@@ -85,10 +71,6 @@ Object.defineProperty(exports, "isEngineeredSource", { enumerable: true, get: fu
 Object.defineProperty(exports, "isBaselineSource", { enumerable: true, get: function () { return contextEngineering_js_1.isBaselineSource; } });
 Object.defineProperty(exports, "ENGINEERED_SOURCES", { enumerable: true, get: function () { return contextEngineering_js_1.ENGINEERED_SOURCES; } });
 Object.defineProperty(exports, "BASELINE_SOURCES", { enumerable: true, get: function () { return contextEngineering_js_1.BASELINE_SOURCES; } });
-var EmitBridge_js_1 = require("./recorders/core/EmitBridge.js");
-Object.defineProperty(exports, "EmitBridge", { enumerable: true, get: function () { return EmitBridge_js_1.EmitBridge; } });
-var typedEmit_js_1 = require("./recorders/core/typedEmit.js");
-Object.defineProperty(exports, "typedEmit", { enumerable: true, get: function () { return typedEmit_js_1.typedEmit; } });
 var RunnerBase_js_1 = require("./core/RunnerBase.js");
 Object.defineProperty(exports, "RunnerBase", { enumerable: true, get: function () { return RunnerBase_js_1.RunnerBase; } });
 Object.defineProperty(exports, "makeRunId", { enumerable: true, get: function () { return RunnerBase_js_1.makeRunId; } });
@@ -107,6 +89,9 @@ Object.defineProperty(exports, "isPaused", { enumerable: true, get: function ()
 // shape; viewers (Lens, CLI tail, log file) consume this surface.
 var commentaryTemplates_js_1 = require("./recorders/observability/commentary/commentaryTemplates.js");
 Object.defineProperty(exports, "defaultCommentaryTemplates", { enumerable: true, get: function () { return commentaryTemplates_js_1.defaultCommentaryTemplates; } });
+// Commentary engine helpers — advanced surface consumed by viewer
+// libraries (agentfootprint-lens) to render run narration. Not the
+// everyday API, but de-facto public: keep exported.
 Object.defineProperty(exports, "extractAgentName", { enumerable: true, get: function () { return commentaryTemplates_js_1.extractAgentName; } });
 Object.defineProperty(exports, "extractCommentaryVars", { enumerable: true, get: function () { return commentaryTemplates_js_1.extractCommentaryVars; } });
 Object.defineProperty(exports, "renderCommentary", { enumerable: true, get: function () { return commentaryTemplates_js_1.renderCommentary; } });
@@ -119,19 +104,10 @@ Object.defineProperty(exports, "selectCommentaryKey", { enumerable: true, get: f
 // supported, missing keys ignored) but a different vocabulary —
 // first-person status, mid-call only. Per-tool keys (`tool.<toolName>`)
 // win over the generic `tool` key.
-var statusTemplates_js_1 = require("./recorders/observability/status/statusTemplates.js");
-Object.defineProperty(exports, "defaultStatusTemplates", { enumerable: true, get: function () { return statusTemplates_js_1.defaultStatusTemplates; } });
-Object.defineProperty(exports, "selectStatus", { enumerable: true, get: function () { return statusTemplates_js_1.selectStatus; } });
-Object.defineProperty(exports, "renderStatusLine", { enumerable: true, get: function () { return statusTemplates_js_1.renderStatusLine; } });
 // Primitives (core/)
 var LLMCall_js_1 = require("./core/LLMCall.js");
 Object.defineProperty(exports, "LLMCall", { enumerable: true, get: function () { return LLMCall_js_1.LLMCall; } });
 Object.defineProperty(exports, "LLMCallBuilder", { enumerable: true, get: function () { return LLMCall_js_1.LLMCallBuilder; } });
-// messageAPI merge-tree proof chart (LLM-only) — Context-selector → slot
-// subflows → messageAPI assembly stage → Call-LLM. The locked shape that
-// will later serve both Static and Dynamic agents. See buildMessageApiChart.
-var buildMessageApiChart_js_1 = require("./core/agent/buildMessageApiChart.js");
-Object.defineProperty(exports, "buildMessageApiChart", { enumerable: true, get: function () { return buildMessageApiChart_js_1.buildMessageApiChart; } });
 // Agent (ReAct) form of the merge-tree — Context root selector → two-stage
 // convergence: [sf-message-api (system-prompt+messages → messageAPI), sf-tools]
 // → Call-LLM → route → [tool-exec → loop] / final. tools + the loop are the
@@ -144,7 +120,6 @@ Object.defineProperty(exports, "AgentBuilder", { enumerable: true, get: function
 var outputSchema_js_1 = require("./core/outputSchema.js");
 Object.defineProperty(exports, "OutputSchemaError", { enumerable: true, get: function () { return outputSchema_js_1.OutputSchemaError; } });
 Object.defineProperty(exports, "applyOutputSchema", { enumerable: true, get: function () { return outputSchema_js_1.applyOutputSchema; } });
-Object.defineProperty(exports, "buildDefaultInstruction", { enumerable: true, get: function () { return outputSchema_js_1.buildDefaultInstruction; } });
 var runCheckpoint_js_1 = require("./core/runCheckpoint.js");
 Object.defineProperty(exports, "RunCheckpointError", { enumerable: true, get: function () { return runCheckpoint_js_1.RunCheckpointError; } });
 var flowchartAsTool_js_1 = require("./core/flowchartAsTool.js");
@@ -192,56 +167,11 @@ Object.defineProperty(exports, "LoopBuilder", { enumerable: true, get: function
 //
 //   import { AnthropicProvider } from 'agentfootprint';                  // ❌ not exported
 //   import { AnthropicProvider } from 'agentfootprint/llm-providers';    // ✓ canonical
-var MockProvider_js_1 = require("./adapters/llm/MockProvider.js");
-Object.defineProperty(exports, "MockProvider", { enumerable: true, get: function () { return MockProvider_js_1.MockProvider; } });
-Object.defineProperty(exports, "mock", { enumerable: true, get: function () { return MockProvider_js_1.mock; } });
-var BrowserAnthropicProvider_js_1 = require("./adapters/llm/BrowserAnthropicProvider.js");
-Object.defineProperty(exports, "browserAnthropic", { enumerable: true, get: function () { return BrowserAnthropicProvider_js_1.browserAnthropic; } });
-Object.defineProperty(exports, "BrowserAnthropicProvider", { enumerable: true, get: function () { return BrowserAnthropicProvider_js_1.BrowserAnthropicProvider; } });
-var BrowserOpenAIProvider_js_1 = require("./adapters/llm/BrowserOpenAIProvider.js");
-Object.defineProperty(exports, "browserOpenai", { enumerable: true, get: function () { return BrowserOpenAIProvider_js_1.browserOpenai; } });
-Object.defineProperty(exports, "BrowserOpenAIProvider", { enumerable: true, get: function () { return BrowserOpenAIProvider_js_1.BrowserOpenAIProvider; } });
-Object.defineProperty(exports, "browserAzureOpenai", { enumerable: true, get: function () { return BrowserOpenAIProvider_js_1.browserAzureOpenai; } });
-Object.defineProperty(exports, "BrowserAzureOpenAIProvider", { enumerable: true, get: function () { return BrowserOpenAIProvider_js_1.BrowserAzureOpenAIProvider; } });
 var createProvider_js_1 = require("./adapters/llm/createProvider.js");
-Object.defineProperty(exports, "createProvider", { enumerable: true, get: function () { return createProvider_js_1.createProvider; } });
 Object.defineProperty(exports, "providerFromEnv", { enumerable: true, get: function () { return createProvider_js_1.providerFromEnv; } });
 // Streaming helpers — agent events → SSE for browser delivery.
-var stream_js_1 = require("./stream.js");
-Object.defineProperty(exports, "toSSE", { enumerable: true, get: function () { return stream_js_1.toSSE; } });
-Object.defineProperty(exports, "SSEFormatter", { enumerable: true, get: function () { return stream_js_1.SSEFormatter; } });
-Object.defineProperty(exports, "encodeSSE", { enumerable: true, get: function () { return stream_js_1.encodeSSE; } });
 // Injection Engine — the unifying primitive of context engineering.
 // One Injection type, four sugar factories, one engine subflow.
-var index_js_1 = require("./lib/injection-engine/index.js");
-// Engine
-Object.defineProperty(exports, "evaluateInjections", { enumerable: true, get: function () { return index_js_1.evaluateInjections; } });
-Object.defineProperty(exports, "buildInjectionEngineSubflow", { enumerable: true, get: function () { return index_js_1.buildInjectionEngineSubflow; } });
-Object.defineProperty(exports, "projectActiveInjection", { enumerable: true, get: function () { return index_js_1.projectActiveInjection; } });
-// Sugar factories — one per injection flavor
-Object.defineProperty(exports, "defineInstruction", { enumerable: true, get: function () { return index_js_1.defineInstruction; } });
-Object.defineProperty(exports, "defineRelevanceHint", { enumerable: true, get: function () { return index_js_1.defineRelevanceHint; } });
-Object.defineProperty(exports, "defineSkill", { enumerable: true, get: function () { return index_js_1.defineSkill; } });
-Object.defineProperty(exports, "resolveSurfaceMode", { enumerable: true, get: function () { return index_js_1.resolveSurfaceMode; } });
-Object.defineProperty(exports, "SkillRegistry", { enumerable: true, get: function () { return index_js_1.SkillRegistry; } });
-Object.defineProperty(exports, "buildListSkillsTool", { enumerable: true, get: function () { return index_js_1.buildListSkillsTool; } });
-Object.defineProperty(exports, "buildReadSkillTool", { enumerable: true, get: function () { return index_js_1.buildReadSkillTool; } });
-Object.defineProperty(exports, "defineSteering", { enumerable: true, get: function () { return index_js_1.defineSteering; } });
-Object.defineProperty(exports, "defineFact", { enumerable: true, get: function () { return index_js_1.defineFact; } });
-// Unified factory (type-discriminant over the four named factories above)
-Object.defineProperty(exports, "defineInjection", { enumerable: true, get: function () { return index_js_1.defineInjection; } });
-// Declarative skill graph (proposal 002)
-Object.defineProperty(exports, "skillGraph", { enumerable: true, get: function () { return index_js_1.skillGraph; } });
-Object.defineProperty(exports, "decide", { enumerable: true, get: function () { return index_js_1.decide; } });
-Object.defineProperty(exports, "SKILL_GRAPH_METADATA_KEY", { enumerable: true, get: function () { return index_js_1.SKILL_GRAPH_METADATA_KEY; } });
-// Pluggable entry-relevance scorer strategy + built-ins (keyword / embedding)
-Object.defineProperty(exports, "keywordScorer", { enumerable: true, get: function () { return index_js_1.keywordScorer; } });
-Object.defineProperty(exports, "embeddingScorer", { enumerable: true, get: function () { return index_js_1.embeddingScorer; } });
-Object.defineProperty(exports, "rankEntries", { enumerable: true, get: function () { return index_js_1.rankEntries; } });
-// Proposal 009 Tier 1 — skill-body ↔ tool-contract consistency check
-Object.defineProperty(exports, "checkSkillContract", { enumerable: true, get: function () { return index_js_1.checkSkillContract; } });
-Object.defineProperty(exports, "checkSkillContracts", { enumerable: true, get: function () { return index_js_1.checkSkillContracts; } });
-Object.defineProperty(exports, "skillToolNames", { enumerable: true, get: function () { return index_js_1.skillToolNames; } });
 // Patterns — factory functions composing primitives + core-flow into
 // well-known agent patterns from the research literature.
 __exportStar(require("./patterns/index.js"), exports);
@@ -250,69 +180,25 @@ __exportStar(require("./patterns/index.js"), exports);
 // the most-used factories; the full subsystem (including types that
 // would collide with adapter types like MemoryStore) is reachable via
 // the `agentfootprint/memory` subpath import.
-var index_js_2 = require("./memory/pipeline/index.js");
-// Pipelines
-Object.defineProperty(exports, "defaultPipeline", { enumerable: true, get: function () { return index_js_2.defaultPipeline; } });
-Object.defineProperty(exports, "ephemeralPipeline", { enumerable: true, get: function () { return index_js_2.ephemeralPipeline; } });
-Object.defineProperty(exports, "factPipeline", { enumerable: true, get: function () { return index_js_2.factPipeline; } });
-Object.defineProperty(exports, "narrativePipeline", { enumerable: true, get: function () { return index_js_2.narrativePipeline; } });
-Object.defineProperty(exports, "semanticPipeline", { enumerable: true, get: function () { return index_js_2.semanticPipeline; } });
-Object.defineProperty(exports, "autoPipeline", { enumerable: true, get: function () { return index_js_2.autoPipeline; } });
-var index_js_3 = require("./memory/beats/index.js");
-// Beat extractors
-Object.defineProperty(exports, "heuristicExtractor", { enumerable: true, get: function () { return index_js_3.heuristicExtractor; } });
-Object.defineProperty(exports, "llmExtractor", { enumerable: true, get: function () { return index_js_3.llmExtractor; } });
-var index_js_4 = require("./memory/facts/index.js");
-// Fact extractors
-Object.defineProperty(exports, "patternFactExtractor", { enumerable: true, get: function () { return index_js_4.patternFactExtractor; } });
-Object.defineProperty(exports, "llmFactExtractor", { enumerable: true, get: function () { return index_js_4.llmFactExtractor; } });
-var index_js_5 = require("./memory/index.js");
-// Layered memory API — consumer-facing factory + const-objects
-Object.defineProperty(exports, "defineMemory", { enumerable: true, get: function () { return index_js_5.defineMemory; } });
-Object.defineProperty(exports, "MEMORY_TYPES", { enumerable: true, get: function () { return index_js_5.MEMORY_TYPES; } });
-Object.defineProperty(exports, "MEMORY_STRATEGIES", { enumerable: true, get: function () { return index_js_5.MEMORY_STRATEGIES; } });
-Object.defineProperty(exports, "MEMORY_TIMING", { enumerable: true, get: function () { return index_js_5.MEMORY_TIMING; } });
-Object.defineProperty(exports, "SNAPSHOT_PROJECTIONS", { enumerable: true, get: function () { return index_js_5.SNAPSHOT_PROJECTIONS; } });
-// Reference implementations + helpers consumers reach for daily.
-// Real-backend adapters (Redis, Postgres, Pinecone, ...) ship as
-// separate subpath exports.
-Object.defineProperty(exports, "InMemoryStore", { enumerable: true, get: function () { return index_js_5.InMemoryStore; } });
-Object.defineProperty(exports, "mockEmbedder", { enumerable: true, get: function () { return index_js_5.mockEmbedder; } });
-Object.defineProperty(exports, "identityNamespace", { enumerable: true, get: function () { return index_js_5.identityNamespace; } });
 // RAG — retrieval-augmented generation as a context-engineering flavor.
 // Thin sugar over `defineMemory({ type: SEMANTIC, strategy: TOP_K })`
 // plus the `indexDocuments` helper for seeding the corpus at startup.
-var index_js_6 = require("./lib/rag/index.js");
-Object.defineProperty(exports, "defineRAG", { enumerable: true, get: function () { return index_js_6.defineRAG; } });
-Object.defineProperty(exports, "indexDocuments", { enumerable: true, get: function () { return index_js_6.indexDocuments; } });
+var index_js_1 = require("./lib/rag/index.js");
+Object.defineProperty(exports, "defineRAG", { enumerable: true, get: function () { return index_js_1.defineRAG; } });
+Object.defineProperty(exports, "indexDocuments", { enumerable: true, get: function () { return index_js_1.indexDocuments; } });
 // MCP — Model Context Protocol client. Connect to MCP servers and
 // expose their tools as agentfootprint Tool[] for `agent.tools(...)`.
 // `@modelcontextprotocol/sdk` is a lazy-required peer-dep (no runtime
 // cost when MCP isn't used).
-var index_js_7 = require("./lib/mcp/index.js");
-Object.defineProperty(exports, "mcpClient", { enumerable: true, get: function () { return index_js_7.mcpClient; } });
-Object.defineProperty(exports, "mockMcpClient", { enumerable: true, get: function () { return index_js_7.mockMcpClient; } });
 // Tool dispatch primitives (v2.5+). New `agentfootprint/tool-providers`
 // subpath bundles tool sources (mcpClient / mockMcpClient) with tool
 // dispatch primitives (staticTools / gatedTools) so consumers find
 // "everything tool-related" in one place. Top-level barrel re-exports
 // the dispatch primitives too — `mcpClient` already re-exports above.
-var index_js_8 = require("./tool-providers/index.js");
-Object.defineProperty(exports, "staticTools", { enumerable: true, get: function () { return index_js_8.staticTools; } });
-Object.defineProperty(exports, "gatedTools", { enumerable: true, get: function () { return index_js_8.gatedTools; } });
-Object.defineProperty(exports, "skillScopedTools", { enumerable: true, get: function () { return index_js_8.skillScopedTools; } });
 // Cross-cutting authorization (v2.5+). `agentfootprint/security` is the
 // dedicated subpath; the root barrel also re-exports `PermissionPolicy`
 // so existing v2.4 consumers find it at the top level.
-var index_js_9 = require("./security/index.js");
-Object.defineProperty(exports, "PermissionPolicy", { enumerable: true, get: function () { return index_js_9.PermissionPolicy; } });
-Object.defineProperty(exports, "PolicyHaltError", { enumerable: true, get: function () { return index_js_9.PolicyHaltError; } });
 // Message Catalog Pattern (v2.5+). `agentfootprint/locales` is the
 // dedicated subpath; the root barrel also re-exports the helpers so
 // existing v2.4 consumers find them at the top level.
-var index_js_10 = require("./locales/index.js");
-Object.defineProperty(exports, "defaultCommentaryMessages", { enumerable: true, get: function () { return index_js_10.defaultCommentaryMessages; } });
-Object.defineProperty(exports, "defaultThinkingMessages", { enumerable: true, get: function () { return index_js_10.defaultThinkingMessages; } });
-Object.defineProperty(exports, "composeMessages", { enumerable: true, get: function () { return index_js_10.composeMessages; } });
-Object.defineProperty(exports, "validateMessages", { enumerable: true, get: function () { return index_js_10.validateMessages; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/lib/context-bisect/index.js

@@ -19,7 +19,7 @@
  * may change before GA.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CONTEXT_BISECT_DEFAULTS = exports.bisectCulprits = exports.findLoopHeads = exports.bucketByAnchors = exports.assembleTrajectory = exports.buildWriterFrameIndex = exports.walkTrajectory = exports.walkToRoot = exports.DEFAULT_RECENCY_DECAY = exports.shortlistEarlyCulprits = exports.MIN_LOOPS_SAVED = exports.classifySuspect = exports.assignCostVerdicts = exports.verdictFor = exports.runAblationProbe = exports.probeFlipped = exports.median = exports.defaultOutcomeComparator = exports.costStatsFrom = exports.applyAblations = exports.ablationForSuspect = exports.toBacktrackTrace = exports.suspectLabel = exports.localizeContextBug = exports.llmCallIdsFromEvents = exports.formatContextBugReport = exports.defaultSuspectClassifier = exports.runRestorationProbe = exports.findDroppedContext = exports.stepOutputText = exports.llmEdgeWeigher = void 0;
+exports.CONTEXT_BISECT_DEFAULTS = exports.bisectCulprits = exports.findLoopHeads = exports.bucketByAnchors = exports.assembleTrajectory = exports.buildWriterFrameIndex = exports.walkTrajectory = exports.walkToRoot = exports.DEFAULT_RECENCY_DECAY = exports.shortlistEarlyCulprits = exports.MIN_LOOPS_SAVED = exports.classifySuspect = exports.assignCostVerdicts = exports.verdictFor = exports.runAblationProbe = exports.probeFlipped = exports.median = exports.defaultOutcomeComparator = exports.costStatsFrom = exports.applyAblations = exports.ablationForSuspect = exports.sliceToBacktrackTrace = exports.toBacktrackTrace = exports.suspectLabel = exports.localizeContextBug = exports.llmCallIdsFromEvents = exports.formatContextBugReport = exports.defaultSuspectClassifier = exports.runRestorationProbe = exports.findDroppedContext = exports.stepOutputText = exports.llmEdgeWeigher = void 0;
 var llmEdgeWeigher_js_1 = require("./llmEdgeWeigher.js");
 Object.defineProperty(exports, "llmEdgeWeigher", { enumerable: true, get: function () { return llmEdgeWeigher_js_1.llmEdgeWeigher; } });
 Object.defineProperty(exports, "stepOutputText", { enumerable: true, get: function () { return llmEdgeWeigher_js_1.stepOutputText; } });
@@ -36,6 +36,10 @@ Object.defineProperty(exports, "localizeContextBug", { enumerable: true, get: fu
 Object.defineProperty(exports, "suspectLabel", { enumerable: true, get: function () { return localize_js_1.suspectLabel; } });
 var toBacktrackTrace_js_1 = require("./toBacktrackTrace.js");
 Object.defineProperty(exports, "toBacktrackTrace", { enumerable: true, get: function () { return toBacktrackTrace_js_1.toBacktrackTrace; } });
+// sliceToBacktrackTrace — the STRUCTURAL sibling: a footprintjs variable
+// slice (sliceToJSON) on the same atui board, honestly weaker chips.
+var sliceToBacktrackTrace_js_1 = require("./sliceToBacktrackTrace.js");
+Object.defineProperty(exports, "sliceToBacktrackTrace", { enumerable: true, get: function () { return sliceToBacktrackTrace_js_1.sliceToBacktrackTrace; } });
 var ablation_js_1 = require("./ablation.js");
 Object.defineProperty(exports, "ablationForSuspect", { enumerable: true, get: function () { return ablation_js_1.ablationForSuspect; } });
 Object.defineProperty(exports, "applyAblations", { enumerable: true, get: function () { return ablation_js_1.applyAblations; } });

package/dist/lib/context-bisect/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/context-bisect/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;AAEH,yDAM6B;AAL3B,mHAAA,cAAc,OAAA;AACd,mHAAA,cAAc,OAAA;AAMhB,oFAAoF;AACpF,yDAK6B;AAJ3B,uHAAA,kBAAkB,OAAA;AAKpB,mDAK0B;AAJxB,qHAAA,mBAAmB,OAAA;AAMrB,6CAUuB;AATrB,uHAAA,wBAAwB,OAAA;AACxB,qHAAA,sBAAsB,OAAA;AACtB,mHAAA,oBAAoB,OAAA;AACpB,iHAAA,kBAAkB,OAAA;AAClB,2GAAA,YAAY,OAAA;AAOd,6DAQ+B;AAP7B,uHAAA,gBAAgB,OAAA;AASlB,6CAWuB;AAVrB,iHAAA,kBAAkB,OAAA;AAClB,6GAAA,cAAc,OAAA;AACd,4GAAA,aAAa,OAAA;AACb,uHAAA,wBAAwB,OAAA;AACxB,qGAAA,MAAM,OAAA;AACN,2GAAA,YAAY,OAAA;AACZ,+GAAA,gBAAgB,OAAA;AAChB,yGAAA,UAAU,OAAA;AAKZ,8EAA8E;AAC9E,qCAAiF;AAAxE,6GAAA,kBAAkB,OAAA;AAAE,0GAAA,eAAe,OAAA;AAAE,0GAAA,eAAe,OAAA;AAE7D,gGAAgG;AAChG,mDAM0B;AALxB,wHAAA,sBAAsB,OAAA;AACtB,uHAAA,qBAAqB,OAAA;AAMvB,qGAAqG;AACrG,qDAQ2B;AAPzB,6GAAA,UAAU,OAAA;AACV,iHAAA,cAAc,OAAA;AACd,wHAAA,qBAAqB,OAAA;AAOvB,4EAA4E;AAC5E,6CAA6C;AAC7C,iDAUyB;AATvB,mHAAA,kBAAkB,OAAA;AAClB,gHAAA,eAAe,OAAA;AACf,8GAAA,aAAa,OAAA;AASf,yCAKqB;AAJnB,2GAAA,cAAc,OAAA;AAMhB,uCA2BoB;AA1BlB,mHAAA,uBAAuB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/context-bisect/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;AAEH,yDAM6B;AAL3B,mHAAA,cAAc,OAAA;AACd,mHAAA,cAAc,OAAA;AAMhB,oFAAoF;AACpF,yDAK6B;AAJ3B,uHAAA,kBAAkB,OAAA;AAKpB,mDAK0B;AAJxB,qHAAA,mBAAmB,OAAA;AAMrB,6CAUuB;AATrB,uHAAA,wBAAwB,OAAA;AACxB,qHAAA,sBAAsB,OAAA;AACtB,mHAAA,oBAAoB,OAAA;AACpB,iHAAA,kBAAkB,OAAA;AAClB,2GAAA,YAAY,OAAA;AAOd,6DAQ+B;AAP7B,uHAAA,gBAAgB,OAAA;AAQlB,yEAAyE;AACzE,qEAAqE;AACrE,uEAAsG;AAA7F,iIAAA,qBAAqB,OAAA;AAE9B,6CAWuB;AAVrB,iHAAA,kBAAkB,OAAA;AAClB,6GAAA,cAAc,OAAA;AACd,4GAAA,aAAa,OAAA;AACb,uHAAA,wBAAwB,OAAA;AACxB,qGAAA,MAAM,OAAA;AACN,2GAAA,YAAY,OAAA;AACZ,+GAAA,gBAAgB,OAAA;AAChB,yGAAA,UAAU,OAAA;AAKZ,8EAA8E;AAC9E,qCAAiF;AAAxE,6GAAA,kBAAkB,OAAA;AAAE,0GAAA,eAAe,OAAA;AAAE,0GAAA,eAAe,OAAA;AAE7D,gGAAgG;AAChG,mDAM0B;AALxB,wHAAA,sBAAsB,OAAA;AACtB,uHAAA,qBAAqB,OAAA;AAMvB,qGAAqG;AACrG,qDAQ2B;AAPzB,6GAAA,UAAU,OAAA;AACV,iHAAA,cAAc,OAAA;AACd,wHAAA,qBAAqB,OAAA;AAOvB,4EAA4E;AAC5E,6CAA6C;AAC7C,iDAUyB;AATvB,mHAAA,kBAAkB,OAAA;AAClB,gHAAA,eAAe,OAAA;AACf,8GAAA,aAAa,OAAA;AASf,yCAKqB;AAJnB,2GAAA,cAAc,OAAA;AAMhB,uCA2BoB;AA1BlB,mHAAA,uBAAuB,OAAA"}

package/dist/lib/context-bisect/sliceToBacktrackTrace.js

@@ -0,0 +1,154 @@
+"use strict";
+/**
+ * sliceToBacktrackTrace — serialize a footprintjs VARIABLE SLICE
+ * (`sliceToJSON(sliceForKey(...))` from `footprintjs/trace`) into the
+ * BacktrackTrace shape agentThinkingUI's <BacktrackView>/<BacktrackOverlay>
+ * renders.
+ *
+ * The sibling of {@link toBacktrackTrace}: that one maps a LOCALIZER REPORT
+ * (scored suspects, ablation verdicts); this one maps a STRUCTURAL SLICE —
+ * the exact dependency chain behind one variable, with no influence claims
+ * at all. Same board, honestly weaker chips:
+ *
+ *   - `mode` is ALWAYS 'correlational' — a slice is exact STRUCTURE, but it
+ *     never tested influence; the default modeLabel says exactly that.
+ *   - every card is `upperBound: true` (the UI's hatched meter + star): the
+ *     score is 1/(1+depth) — hop PROXIMITY, a deterministic layout aid, not
+ *     evidence. The honesty lines state the formula so nobody reads it as
+ *     influence.
+ *   - slice honesty rides along verbatim: reads-coverage warning
+ *     (readTracking off), truncation, per-node incomplete-sources counts,
+ *     and honest ABSENCE — a missing slice renders an empty board whose
+ *     honesty lines say why ('never written' → initial state / frozen args /
+ *     closure), never a fabricated suspect.
+ *
+ * Pure mapping, no UI dependency, framework-agnostic JSON on both sides —
+ * the human and the LLM triage the SAME artifact (the parity loop: an agent
+ * emits this, a person confirms or overrides on the board).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sliceToBacktrackTrace = void 0;
+/** The structural-honesty lines every slice board carries. */
+const SLICE_CLAIMS_LINES = [
+    'scores are hop proximity (1/(1+depth)) — a layout aid, not influence; every card is a path-only upper bound.',
+    'this board shows exact dependency STRUCTURE; only ablation verdicts make causal claims.',
+];
+/**
+ * Shortest hop chain root → node over the slice's id-referenced edges
+ * (BFS; edges point child→parent, i.e. away from the root).
+ */
+function pathTo(json, targetId) {
+    if (!json.edges || !json.writerId || targetId === json.writerId)
+        return undefined;
+    const prev = new Map();
+    const queue = [json.writerId];
+    const seen = new Set(queue);
+    while (queue.length > 0) {
+        const cur = queue.shift();
+        if (cur === targetId)
+            break;
+        for (const e of json.edges) {
+            if (e.from !== cur || seen.has(e.to))
+                continue;
+            seen.add(e.to);
+            prev.set(e.to, { from: e.from, key: e.key, kind: e.kind });
+            queue.push(e.to);
+        }
+    }
+    if (!prev.has(targetId))
+        return undefined;
+    const hops = [];
+    let cur = targetId;
+    while (cur !== json.writerId) {
+        const p = prev.get(cur);
+        hops.unshift({ key: p.key ?? '', kind: p.kind, via: `${p.from} ← ${cur}` });
+        cur = p.from;
+    }
+    return hops.length > 1 ? hops : undefined;
+}
+/**
+ * Serialize a variable slice for agentThinkingUI's BacktrackView. See the
+ * module doc — structural honesty is the whole design.
+ */
+function sliceToBacktrackTrace(json, opts) {
+    const max = opts.maxSuspects ?? 6;
+    const claim = opts.claim ?? `Why is '${json.key}' what it is?`;
+    const honesty = [];
+    if (json.missing === 'never-written') {
+        honesty.push(`⚠ '${json.key}' was never written in this run — the value came from initial state, frozen run input (args), or a closure; the commit log cannot see those.`);
+    }
+    else if (json.missing === 'empty-log') {
+        honesty.push('⚠ the commit log is empty — nothing executed.');
+    }
+    if (json.readsCoverage && json.readsCoverage.steps > 1 && json.readsCoverage.stepsWithReads === 0) {
+        honesty.push('⚠ reads were not recorded (readTracking off) — upstream dependencies are unknowable, NOT absent.');
+    }
+    if (json.truncated) {
+        honesty.push(`⚠ slice truncated (${[json.truncated.byDepth && 'depth', json.truncated.byNodes && 'node budget']
+            .filter(Boolean)
+            .join(' + ')}) — older causes exist beyond this horizon.`);
+    }
+    // Honest absence: an empty board whose honesty says why.
+    if (!json.writerId || !json.nodes) {
+        return {
+            claim,
+            mode: 'correlational',
+            modeLabel: opts.modeLabel ?? 'no slice — see honesty',
+            agent: opts.agent,
+            model: opts.model,
+            answer: opts.answer,
+            decidedAt: { id: json.key, label: `'${json.key}' (no recorded writer)`, kind: opts.decidedAtKind ?? 'rule' },
+            suspects: [],
+            honesty: [...honesty, ...SLICE_CLAIMS_LINES],
+        };
+    }
+    const writer = json.nodes[json.writerId];
+    let incompleteCount = 0;
+    // Non-root nodes in their BFS insertion order (sliceToJSON preserves it).
+    const entries = Object.entries(json.nodes).filter(([id]) => id !== json.writerId);
+    const cards = entries.map(([id, node], i) => {
+        if (node.incompleteSources && node.incompleteSources.length > 0)
+            incompleteCount++;
+        const inboundEdge = json.edges?.find((e) => e.to === id);
+        return {
+            kind: 'stage',
+            name: node.stageName,
+            score: Number((1 / (1 + node.depth)).toFixed(2)),
+            rank: i + 1,
+            upperBound: true,
+            edge: inboundEdge
+                ? { key: inboundEdge.key, weight: inboundEdge.weight, kind: inboundEdge.kind }
+                : undefined,
+            path: pathTo(json, id),
+            bornAt: { id, label: node.stageName, via: 'stage commit' },
+        };
+    });
+    if (incompleteCount > 0) {
+        honesty.push(`⚠ ${incompleteCount} step${incompleteCount === 1 ? '' : 's'} in the chain also consumed untracked inputs (args/env/silent reads) — the slice may be incomplete there.`);
+    }
+    const selected = cards.slice(0, max);
+    const dropped = cards.slice(max);
+    const folded = dropped.length > 0
+        ? `${dropped.length} more step${dropped.length === 1 ? '' : 's'} folded — ` +
+            dropped.map((c) => `#${c.rank} ${c.bornAt.id}`).join(' · ') +
+            ' — every id drillable with the trace toolpack'
+        : undefined;
+    return {
+        claim,
+        mode: 'correlational',
+        modeLabel: opts.modeLabel ?? 'exact dependency chain — structural, not ablation-tested',
+        agent: opts.agent,
+        model: opts.model,
+        answer: opts.answer,
+        decidedAt: {
+            id: json.writerId,
+            label: writer?.stageName,
+            kind: opts.decidedAtKind ?? 'rule',
+        },
+        suspects: selected,
+        folded,
+        honesty: [...honesty, ...SLICE_CLAIMS_LINES],
+    };
+}
+exports.sliceToBacktrackTrace = sliceToBacktrackTrace;
+//# sourceMappingURL=sliceToBacktrackTrace.js.map

package/dist/lib/context-bisect/sliceToBacktrackTrace.js.map

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

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

@@ -7,7 +7,7 @@
  * factories. See `README.md` in this folder for the full concept.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.skillToolNames = exports.checkSkillContracts = exports.checkSkillContract = exports.rankEntries = exports.embeddingScorer = exports.keywordScorer = exports.SKILL_GRAPH_METADATA_KEY = exports.decide = exports.skillGraph = exports.defineInjection = exports.defineFact = exports.defineSteering = exports.buildReadSkillTool = exports.buildListSkillsTool = exports.SkillRegistry = exports.resolveSurfaceMode = exports.defineSkill = exports.defineRelevanceHint = exports.defineInstruction = exports.buildInjectionEngineSubflow = exports.evaluateInjections = exports.projectActiveInjection = void 0;
+exports.skillToolNames = exports.checkSkillContracts = exports.checkSkillContract = exports.rankEntries = exports.embeddingScorer = exports.keywordScorer = exports.SKILL_GRAPH_METADATA_KEY = exports.decideSkill = exports.skillGraph = exports.defineInjection = exports.defineFact = exports.defineSteering = exports.buildReadSkillTool = exports.buildListSkillsTool = exports.SkillRegistry = exports.resolveSurfaceMode = exports.defineSkill = exports.defineRelevanceHint = exports.defineInstruction = exports.buildInjectionEngineSubflow = exports.evaluateInjections = exports.projectActiveInjection = void 0;
 // POJO projection — used by slot subflows + advanced consumers
 var types_js_1 = require("./types.js");
 Object.defineProperty(exports, "projectActiveInjection", { enumerable: true, get: function () { return types_js_1.projectActiveInjection; } });
@@ -46,7 +46,7 @@ Object.defineProperty(exports, "defineInjection", { enumerable: true, get: funct
 // graph-derived triggers + a drawable topology. Sugar over the trigger model.
 var skillGraph_js_1 = require("./skillGraph.js");
 Object.defineProperty(exports, "skillGraph", { enumerable: true, get: function () { return skillGraph_js_1.skillGraph; } });
-Object.defineProperty(exports, "decide", { enumerable: true, get: function () { return skillGraph_js_1.decide; } });
+Object.defineProperty(exports, "decideSkill", { enumerable: true, get: function () { return skillGraph_js_1.decideSkill; } });
 Object.defineProperty(exports, "SKILL_GRAPH_METADATA_KEY", { enumerable: true, get: function () { return skillGraph_js_1.SKILL_GRAPH_METADATA_KEY; } });
 var entryScorer_js_1 = require("./entryScorer.js");
 Object.defineProperty(exports, "keywordScorer", { enumerable: true, get: function () { return entryScorer_js_1.keywordScorer; } });

package/dist/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,uCAAoD;AAA3C,kHAAA,sBAAsB,OAAA;AAE/B,SAAS;AACT,+CAAoD;AAA3C,kHAAA,kBAAkB,OAAA;AAC3B,mFAG0C;AAFxC,6IAAA,2BAA2B,OAAA;AAI7B,gFAAgF;AAChF,yEAAoG;AAA3F,yHAAA,iBAAiB,OAAA;AAC1B,6EAAoG;AAA3F,6HAAA,mBAAmB,OAAA;AAE5B,6DAOoC;AANlC,6GAAA,WAAW,OAAA;AACX,oHAAA,kBAAkB,OAAA;AAOpB,uDAA8E;AAArE,iHAAA,aAAa,OAAA;AAEtB,wEAAwE;AACxE,sEAAsE;AACtE,iEAAiE;AACjE,+BAA+B;AAC/B,iDAA8F;AAArF,oHAAA,mBAAmB,OAAA;AAAE,mHAAA,kBAAkB,OAAA;AAEhD,mEAA2F;AAAlF,mHAAA,cAAc,OAAA;AAEvB,2DAA+E;AAAtE,2GAAA,UAAU,OAAA;AAEnB,6EAA6E;AAC7E,0EAA0E;AAC1E,qDAAqD;AACrD,qEAIwC;AAHtC,qHAAA,eAAe,OAAA;AAKjB,4EAA4E;AAC5E,8EAA8E;AAC9E,iDAuByB;AAtBvB,2GAAA,UAAU,OAAA;AACV,uGAAA,MAAM,OAAA;AACN,yHAAA,wBAAwB,OAAA;AAqB1B,mDAO0B;AANxB,+GAAA,aAAa,OAAA;AACb,iHAAA,eAAe,OAAA;AACf,6GAAA,WAAW,OAAA;AAKb,uDAA6F;AAApF,sHAAA,kBAAkB,OAAA;AAAE,uHAAA,mBAAmB,OAAA;AAAE,kHAAA,cAAc,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/injection-engine/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAYH,+DAA+D;AAC/D,uCAAoD;AAA3C,kHAAA,sBAAsB,OAAA;AAE/B,SAAS;AACT,+CAAoD;AAA3C,kHAAA,kBAAkB,OAAA;AAC3B,mFAG0C;AAFxC,6IAAA,2BAA2B,OAAA;AAI7B,gFAAgF;AAChF,yEAAoG;AAA3F,yHAAA,iBAAiB,OAAA;AAC1B,6EAAoG;AAA3F,6HAAA,mBAAmB,OAAA;AAE5B,6DAOoC;AANlC,6GAAA,WAAW,OAAA;AACX,oHAAA,kBAAkB,OAAA;AAOpB,uDAA8E;AAArE,iHAAA,aAAa,OAAA;AAEtB,wEAAwE;AACxE,sEAAsE;AACtE,iEAAiE;AACjE,+BAA+B;AAC/B,iDAA8F;AAArF,oHAAA,mBAAmB,OAAA;AAAE,mHAAA,kBAAkB,OAAA;AAEhD,mEAA2F;AAAlF,mHAAA,cAAc,OAAA;AAEvB,2DAA+E;AAAtE,2GAAA,UAAU,OAAA;AAEnB,6EAA6E;AAC7E,0EAA0E;AAC1E,qDAAqD;AACrD,qEAIwC;AAHtC,qHAAA,eAAe,OAAA;AAKjB,4EAA4E;AAC5E,8EAA8E;AAC9E,iDAuByB;AAtBvB,2GAAA,UAAU,OAAA;AACV,4GAAA,WAAW,OAAA;AACX,yHAAA,wBAAwB,OAAA;AAqB1B,mDAO0B;AANxB,+GAAA,aAAa,OAAA;AACb,iHAAA,eAAe,OAAA;AACf,6GAAA,WAAW,OAAA;AAKb,uDAA6F;AAApF,sHAAA,kBAAkB,OAAA;AAAE,uHAAA,mBAAmB,OAAA;AAAE,kHAAA,cAAc,OAAA"}

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

@@ -29,17 +29,18 @@
  * model-reachable set by graph position) remains deferred — see proposal 002.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.skillGraph = exports.SKILL_GRAPH_METADATA_KEY = exports.decide = void 0;
+exports.skillGraph = exports.SKILL_GRAPH_METADATA_KEY = exports.decideSkill = void 0;
 const footprintjs_1 = require("footprintjs");
 const entryScorer_js_1 = require("./entryScorer.js");
 const skillGraphCheckup_js_1 = require("./skillGraphCheckup.js");
 const skillContract_js_1 = require("./skillContract.js");
 /** Build a decision node. Leaves are skills (an `Injection`); internal nodes are
- *  other `decide(...)` results. */
-function decide(predicate, whenTrue, whenFalse, label) {
+ *  other `decideSkill(...)` results. (Renamed from `decide` in v7 to avoid
+ *  colliding with footprintjs's `decide()`.) */
+function decideSkill(predicate, whenTrue, whenFalse, label) {
     return { kind: 'decision', predicate, whenTrue, whenFalse, label };
 }
-exports.decide = decide;
+exports.decideSkill = decideSkill;
 function isDecisionNode(n) {
     return n.kind === 'decision';
 }