agentfootprint 8.19.0 → 9.0.0

package/dist/esm/debug/finders.js

@@ -1,17 +1,14 @@
 /**
- * agentfootprint/debug/finders — context-error finder strategies.
+ * debug/finders — context-error finder strategies.
  *
  * Collapsed home for what was the 3-level-deep
- * `agentfootprint/observability/contextError/finders` path. Same
- * tree-shakeable, re-export-only barrel — one finder = one file = one
- * named export — now under the Debug category where it belongs.
+ * `src/observability/contextError/finders/` barrel. Same tree-shakeable,
+ * re-export-only shape — one finder = one file = one named export — now under
+ * the Debug category where it belongs.
  *
- * The old `agentfootprint/observability/contextError/finders` path is kept
- * (deprecated) for one transition version.
- *
- * @deprecated Since 8.0.0 — import from `agentfootprint/observe` instead.
- * This path keeps working for all of 8.x and is removed in 9.0.0. Every name
- * here is the same symbol on the new door, not a copy.
+ * Not an import path of its own since 9.0.0. This is the implementation barrel
+ * behind `agentfootprint/observe`, which re-exports every name here — same
+ * symbols, one door. Import from the door.
  */
 export * from '../observability/contextError/finders/index.js';
 //# sourceMappingURL=finders.js.map

package/dist/esm/debug/finders.js.map

@@ -1 +1 @@
-{"version":3,"file":"finders.js","sourceRoot":"","sources":["../../../src/debug/finders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,cAAc,gDAAgD,CAAC"}
+{"version":3,"file":"finders.js","sourceRoot":"","sources":["../../../src/debug/finders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,cAAc,gDAAgD,CAAC"}

package/dist/esm/debug.d.ts

@@ -1,5 +1,5 @@
 /**
- * agentfootprint/debug — diagnosis tools for a BROKEN run.
+ * debug — diagnosis tools for a BROKEN run.
  *
  * Where `agentfootprint/observe` watches a HEALTHY run (recorders), this
  * subpath is the autopsy kit for a wrong answer. Split out of `observe` in
@@ -17,9 +17,9 @@
  * For backward compatibility these are ALSO re-exported (deprecated) from
  * `agentfootprint/observe` for one transition version.
  *
- * @deprecated Since 8.0.0 — import from `agentfootprint/observe` instead.
- * This path keeps working for all of 8.x and is removed in 9.0.0. Every name
- * here is the same symbol on the new door, not a copy.
+ * Not an import path of its own since 9.0.0. This is the implementation barrel
+ * behind `agentfootprint/observe`, which re-exports every name here — same
+ * symbols, one door. Import from the door.
  */
 export { adaptWeights, averageRelevancy, compositeScore, contentHash, DEFAULT_CLEAR_WINNER_MARGIN, DEFAULT_CLEAR_WINNER_RATIO, DEFAULT_INFLUENCE_WEIGHTS, DEFAULT_MARGIN_THRESHOLD, DEFAULT_PERSISTENCE_THRESHOLD, DEFAULT_SHORTLIST_BAND, EmbeddingCache, embeddingCache, finalAnswerSimilarity, attributeChoice, explainChoice, lexicalOverlapStrategy, listInfluenceStrategies, marginStrategy, pairwiseSimilarity, persistence, rankingConfidence, ratioStrategy, scoreContrastiveInfluence, scoreInfluence, scoreLexicalInfluence, scoreMargin, semanticAlignmentStrategy, snippetUnits, structuralProximity, type AttributeChoiceArgs, type AttributionUnit, type CandidateScore, type ChannelVerdict, type ChoiceAttribution, type ChoiceExplanation, type ConfidenceStrategy, type Embedder, type EmbeddingCacheOptions, type EmbeddingCacheStats, type EvidenceInput, type ExplainChoiceArgs, type InfluenceScore, type InfluenceScorer, type InfluenceStrategy, type InfluenceStrategyRequirement, type InfluenceWeights, type MarginCandidate, type MarginResult, type PairwiseSimilarityArgs, type PairwiseSimilarityResult, type RankingConfidence, type RankingConfidenceOptions, type ScoreContrastiveInfluenceArgs, type ScoreInfluenceArgs, type ScoreLexicalInfluenceArgs, type ScoreMarginArgs, type SignalScores, type SimilarityItem, type SimilarityPair, type SnippetUnitsOptions, type UnitScore, } from './lib/influence-core/index.js';
 export { callTraceTool, lazyTraceToolpack, NO_COMPLETED_RUN_MESSAGE, TOOLPACK_HARD_CAPS, TRACE_TOOL_NAMES, traceToolpack, type TraceToolpackArtifacts, type TraceToolpackOptions, } from './lib/trace-toolpack/index.js';

package/dist/esm/debug.js

@@ -1,5 +1,5 @@
 /**
- * agentfootprint/debug — diagnosis tools for a BROKEN run.
+ * debug — diagnosis tools for a BROKEN run.
  *
  * Where `agentfootprint/observe` watches a HEALTHY run (recorders), this
  * subpath is the autopsy kit for a wrong answer. Split out of `observe` in
@@ -17,9 +17,9 @@
  * For backward compatibility these are ALSO re-exported (deprecated) from
  * `agentfootprint/observe` for one transition version.
  *
- * @deprecated Since 8.0.0 — import from `agentfootprint/observe` instead.
- * This path keeps working for all of 8.x and is removed in 9.0.0. Every name
- * here is the same symbol on the new door, not a copy.
+ * Not an import path of its own since 9.0.0. This is the implementation barrel
+ * behind `agentfootprint/observe`, which re-exports every name here — same
+ * symbols, one door. Import from the door.
  */
 // influence-core — the ONE embedding-based scoring engine (RFC-002/003
 // block D6). Not a recorder: pure, embedder-injected scoring functions

package/dist/esm/doors/context.d.ts

@@ -5,9 +5,9 @@
  * one, and the engine subflow that resolves them into the three slots a
  * request is made of (system prompt, messages, tools).
  *
- * Named for the job rather than the machine — this was
- * `agentfootprint/injection-engine`, which described our implementation
- * instead of your task.
+ * Named for the job rather than the machine — through 8.x this was also
+ * reachable at `agentfootprint/injection-engine`, which described our
+ * implementation instead of your task. That path was removed in 9.0.0.
  *
  * @example
  * ```ts

package/dist/esm/doors/context.js

@@ -5,9 +5,9 @@
  * one, and the engine subflow that resolves them into the three slots a
  * request is made of (system prompt, messages, tools).
  *
- * Named for the job rather than the machine — this was
- * `agentfootprint/injection-engine`, which described our implementation
- * instead of your task.
+ * Named for the job rather than the machine — through 8.x this was also
+ * reachable at `agentfootprint/injection-engine`, which described our
+ * implementation instead of your task. That path was removed in 9.0.0.
  *
  * @example
  * ```ts

package/dist/esm/embedders/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * agentfootprint/embedders — ready-made {@link Embedder} implementations for the
+ * embedders — ready-made {@link Embedder} implementations for the
  * embedding-backed scorers (memory retrieval, toolChoiceRecorder / scoreMargin).
  *
  * The core deliberately ships only `mockEmbedder` (bring-your-own). These are
@@ -36,9 +36,9 @@
  * AgentCoreStore): the library states the surface it needs, the host owns the
  * construction. Nothing changes for Node callers who pass nothing.
  *
- * @deprecated Since 8.0.0 — import from `agentfootprint/providers` instead.
- * This path keeps working for all of 8.x and is removed in 9.0.0. Every name
- * here is the same symbol on the new door, not a copy.
+ * Not an import path of its own since 9.0.0. This is the implementation barrel
+ * behind `agentfootprint/providers`, which re-exports every name here — same
+ * symbols, one door. Import from the door.
  */
 export type { Embedder } from '../memory/embedding/types.js';
 import type { Embedder } from '../memory/embedding/types.js';

package/dist/esm/events/payloads.d.ts

@@ -248,18 +248,6 @@ export interface ContextSlotComposedPayload {
  */
 export interface ContextBudgetPressurePayload {
     readonly slot: ContextSlot;
-    /**
-     * @deprecated Misnamed since the event shipped: this is CHARS on the slot
-     * channel and TOKENS on the window channel. Read {@link cap} with
-     * {@link unit}. Still written, with the identical value, and not going
-     * away in 8.x.
-     */
-    readonly capTokens: number;
-    /**
-     * @deprecated Misnamed — see {@link capTokens}. Read {@link projected} with
-     * {@link unit}. Still written, with the identical value.
-     */
-    readonly projectedTokens: number;
     /** How far over the cap, in {@link unit}. Never carried a unit in its name. */
     readonly overflowBy: number;
     readonly planAction: 'evict' | 'summarize' | 'abort' | 'none';
@@ -270,9 +258,17 @@ export interface ContextBudgetPressurePayload {
      * anything.
      */
     readonly unit: 'chars' | 'tokens';
-    /** The budget that was exceeded, in {@link unit}. Same value as `capTokens`. */
+    /**
+     * The budget that was exceeded, in {@link unit}.
+     *
+     * Called `capTokens` until 9.0.0 — a name that asserted tokens on a channel
+     * that is CHARS half the time, since `contextBudget` is on by default and a
+     * slot counts `String.length`. Both spellings shipped through 8.x with the
+     * identical value; 9.0.0 keeps only this one.
+     */
     readonly cap: number;
-    /** What was measured, in {@link unit}. Same value as `projectedTokens`. */
+    /** What was measured, in {@link unit}. Called `projectedTokens` until 9.0.0
+     *  — see {@link cap}. */
     readonly projected: number;
 }
 /**

package/dist/esm/hosting-providers.d.ts

@@ -1,19 +1,19 @@
 /**
- * agentfootprint/hosting-providers — adapters for the two hosting ports.
+ * hosting-providers — adapters for the two hosting ports.
  *
- *   agentfootprint/hosting            ← the PORTS (`AgentHost`, `SessionLifecycle`),
- *                                       the composer, and the local adapters
- *   agentfootprint/hosting-providers  ← adapters for somewhere you deploy (this file)
+ *   src/hosting/            ← the PORTS (`AgentHost`, `SessionLifecycle`), the
+ *                             composer, and the local adapters
+ *   src/hosting-providers.ts ← adapters for somewhere you deploy (this file)
  *
- * Same split as `agentfootprint/memory` ↔ `agentfootprint/memory-providers`, and
- * for the same reason. `agentfootprint/hosting` promises that not one field,
- * name or assumption in it comes from any cloud, and a test greps its sources
- * for vendor names to keep that honest — including the barrel. So the cloud
- * adapters get their own subpath, and the port subpath stays a file you can
- * read without learning anybody's product names.
+ * The split is a source-tree split, not an import split: both halves come out
+ * of the one `agentfootprint/hosting` door. It exists because the PORT files
+ * promise that not one field, name or assumption in them comes from any cloud,
+ * and a test greps those sources for vendor names to keep that honest. So the
+ * cloud adapters live in this file, and the port files stay readable without
+ * learning anybody's product names.
  *
- * One subpath that grows: an adapter for the next runtime lands here beside
- * this one rather than minting `agentfootprint/hosting-<vendor>`.
+ * One file that grows: an adapter for the next runtime lands here beside this
+ * one.
  *
  * ── What ships here ──────────────────────────────────────────────────────────
  *   • `agentCoreRuntimeHost({ port?, hostname?, busy? })` — an `AgentHost` for
@@ -42,7 +42,7 @@
  *
  * @example  An agent in an AgentCore Runtime container
  *   import { standingAgent } from 'agentfootprint/hosting';
- *   import { agentCoreRuntimeHost, agentCoreSessions } from 'agentfootprint/hosting-providers';
+ *   import { agentCoreRuntimeHost, agentCoreSessions } from 'agentfootprint/hosting';
  *
  *   const handle = await standingAgent({
  *     agent,
@@ -51,9 +51,9 @@
  *   });
  *   process.on('SIGTERM', () => void handle.close());
  *
- * @deprecated Since 8.0.0 — import from `agentfootprint/hosting` instead.
- * This path keeps working for all of 8.x and is removed in 9.0.0. Every name
- * here is the same symbol on the new door, not a copy.
+ * Not an import path of its own since 9.0.0. This is the implementation barrel
+ * behind `agentfootprint/hosting`, which re-exports every name here — same
+ * symbols, one door. Import from the door.
  */
 export { agentCoreRuntimeHost, agentCoreRuntimeWire, readAgentCoreConversation, agentCoreSessions, DEFAULT_SESSION_STORAGE_PATH, } from './adapters/hosting/agentcore.js';
 export type { AgentCoreRuntimeHostOptions, AgentCoreSessionsOptions, AgentCoreSessionStore, AgentCoreFileSessionsOptions, AgentCoreMemorySessionsOptions, AgentCoreSessionClientLike, AgentCoreSessionEvent, BedrockAgentCoreSessionSdkModule, } from './adapters/hosting/agentcore.js';

package/dist/esm/hosting-providers.js

@@ -1,19 +1,19 @@
 /**
- * agentfootprint/hosting-providers — adapters for the two hosting ports.
+ * hosting-providers — adapters for the two hosting ports.
  *
- *   agentfootprint/hosting            ← the PORTS (`AgentHost`, `SessionLifecycle`),
- *                                       the composer, and the local adapters
- *   agentfootprint/hosting-providers  ← adapters for somewhere you deploy (this file)
+ *   src/hosting/            ← the PORTS (`AgentHost`, `SessionLifecycle`), the
+ *                             composer, and the local adapters
+ *   src/hosting-providers.ts ← adapters for somewhere you deploy (this file)
  *
- * Same split as `agentfootprint/memory` ↔ `agentfootprint/memory-providers`, and
- * for the same reason. `agentfootprint/hosting` promises that not one field,
- * name or assumption in it comes from any cloud, and a test greps its sources
- * for vendor names to keep that honest — including the barrel. So the cloud
- * adapters get their own subpath, and the port subpath stays a file you can
- * read without learning anybody's product names.
+ * The split is a source-tree split, not an import split: both halves come out
+ * of the one `agentfootprint/hosting` door. It exists because the PORT files
+ * promise that not one field, name or assumption in them comes from any cloud,
+ * and a test greps those sources for vendor names to keep that honest. So the
+ * cloud adapters live in this file, and the port files stay readable without
+ * learning anybody's product names.
  *
- * One subpath that grows: an adapter for the next runtime lands here beside
- * this one rather than minting `agentfootprint/hosting-<vendor>`.
+ * One file that grows: an adapter for the next runtime lands here beside this
+ * one.
  *
  * ── What ships here ──────────────────────────────────────────────────────────
  *   • `agentCoreRuntimeHost({ port?, hostname?, busy? })` — an `AgentHost` for
@@ -42,7 +42,7 @@
  *
  * @example  An agent in an AgentCore Runtime container
  *   import { standingAgent } from 'agentfootprint/hosting';
- *   import { agentCoreRuntimeHost, agentCoreSessions } from 'agentfootprint/hosting-providers';
+ *   import { agentCoreRuntimeHost, agentCoreSessions } from 'agentfootprint/hosting';
  *
  *   const handle = await standingAgent({
  *     agent,
@@ -51,9 +51,9 @@
  *   });
  *   process.on('SIGTERM', () => void handle.close());
  *
- * @deprecated Since 8.0.0 — import from `agentfootprint/hosting` instead.
- * This path keeps working for all of 8.x and is removed in 9.0.0. Every name
- * here is the same symbol on the new door, not a copy.
+ * Not an import path of its own since 9.0.0. This is the implementation barrel
+ * behind `agentfootprint/hosting`, which re-exports every name here — same
+ * symbols, one door. Import from the door.
  */
 export { agentCoreRuntimeHost, agentCoreRuntimeWire, readAgentCoreConversation, agentCoreSessions, DEFAULT_SESSION_STORAGE_PATH, } from './adapters/hosting/agentcore.js';
 //# sourceMappingURL=hosting-providers.js.map

package/dist/esm/identity/types.d.ts

@@ -1,5 +1,5 @@
 /**
- * agentfootprint/identity — the CredentialProvider port.
+ * identity — the CredentialProvider port.
  *
  * OUTBOUND auth: vend a credential/token so a tool can call a downstream service
  * (GitHub, Slack, Google…) on behalf of the agent or the end user. This is

package/dist/esm/identity/types.js

@@ -1,5 +1,5 @@
 /**
- * agentfootprint/identity — the CredentialProvider port.
+ * identity — the CredentialProvider port.
  *
  * OUTBOUND auth: vend a credential/token so a tool can call a downstream service
  * (GitHub, Slack, Google…) on behalf of the agent or the end user. This is

package/dist/esm/identity/withCredentialRetry.d.ts

@@ -37,7 +37,7 @@
  *     No new event types.
  *
  * @example
- *   import { agentCoreIdentity, withCredentialRetry } from 'agentfootprint/identity';
+ *   import { agentCoreIdentity, withCredentialRetry } from 'agentfootprint/security';
  *
  *   const credentials = withCredentialRetry(agentCoreIdentity({ region: 'us-east-1' }), {
  *     maxAttempts: 3,

package/dist/esm/identity/withCredentialRetry.js

@@ -37,7 +37,7 @@
  *     No new event types.
  *
  * @example
- *   import { agentCoreIdentity, withCredentialRetry } from 'agentfootprint/identity';
+ *   import { agentCoreIdentity, withCredentialRetry } from 'agentfootprint/security';
  *
  *   const credentials = withCredentialRetry(agentCoreIdentity({ region: 'us-east-1' }), {
  *     maxAttempts: 3,

package/dist/esm/identity.d.ts

@@ -1,5 +1,5 @@
 /**
- * agentfootprint/identity — outbound credential vending for agent tools.
+ * identity — outbound credential vending for agent tools.
  *
  * The {@link CredentialProvider} port + adapters. A tool calls
  * `provider.getCredential({ service })` to get a token for a downstream service;
@@ -12,7 +12,7 @@
  *
  * @example
  * ```ts
- * import { agentCoreIdentity } from 'agentfootprint/identity';
+ * import { agentCoreIdentity } from 'agentfootprint/security';
  *
  * const credentials = agentCoreIdentity({ region: 'us-east-1' });
  * const r = await credentials.getCredential({ service: 'github', mode: 'user', scopes: ['repo'] });
@@ -23,9 +23,9 @@
  * }
  * ```
  *
- * @deprecated Since 8.0.0 — import from `agentfootprint/security` instead.
- * This path keeps working for all of 8.x and is removed in 9.0.0. Every name
- * here is the same symbol on the new door, not a copy.
+ * Not an import path of its own since 9.0.0. This is the implementation barrel
+ * behind `agentfootprint/security`, which re-exports every name here — same
+ * symbols, one door. Import from the door.
  */
 export type { Credential, CredentialProvider, CredentialRequest, CredentialResult, CredentialIssued, CredentialAuthorizationRequired, CredentialNeed, } from './identity/types.js';
 export { isCredentialIssued, unconfiguredCredentialProvider } from './identity/types.js';

package/dist/esm/identity.js

@@ -1,5 +1,5 @@
 /**
- * agentfootprint/identity — outbound credential vending for agent tools.
+ * identity — outbound credential vending for agent tools.
  *
  * The {@link CredentialProvider} port + adapters. A tool calls
  * `provider.getCredential({ service })` to get a token for a downstream service;
@@ -12,7 +12,7 @@
  *
  * @example
  * ```ts
- * import { agentCoreIdentity } from 'agentfootprint/identity';
+ * import { agentCoreIdentity } from 'agentfootprint/security';
  *
  * const credentials = agentCoreIdentity({ region: 'us-east-1' });
  * const r = await credentials.getCredential({ service: 'github', mode: 'user', scopes: ['repo'] });
@@ -23,9 +23,9 @@
  * }
  * ```
  *
- * @deprecated Since 8.0.0 — import from `agentfootprint/security` instead.
- * This path keeps working for all of 8.x and is removed in 9.0.0. Every name
- * here is the same symbol on the new door, not a copy.
+ * Not an import path of its own since 9.0.0. This is the implementation barrel
+ * behind `agentfootprint/security`, which re-exports every name here — same
+ * symbols, one door. Import from the door.
  */
 export { isCredentialIssued, unconfiguredCredentialProvider } from './identity/types.js';
 export { bearer, apiKey, basic, headers, } from './identity/kinds.js';

package/dist/esm/index.d.ts

@@ -32,7 +32,7 @@ export { LLMCall, LLMCallBuilder, type LLMCallInput, type LLMCallOptions, type L
 export { type MessageApiChartDeps } from './core/agent/buildMessageApiChart.js';
 export { buildAgentMessageApiChart, type AgentMessageApiChartDeps, } from './core/agent/buildAgentMessageApiChart.js';
 export { Agent, AgentBuilder, type AgentInput, type AgentOptions, type AgentOutput, type ObserverDeliveryOptions, } from './core/Agent.js';
-export { CompactionUnmeasurableError, COMPACTED_FRAME_PREFIX, DROP_NOTICE_PREFIX, foldedMessages, foldedSpanFor, isCompactedSummary, isDropNotice, slidingWindow, summarizeOldest, tokenBudget, type CompactionOptions, type CompactionRecord, type CompactionRetention, type FoldedConversation, type FoldedSpan, type FoldRefusal, type FoldRefusalReason, type RemovalFacts, type RemovalPlan, type SlidingWindowOptions, type SlidingWindowRecord, type TokenBudgetOptions, type TokenBudgetRecord, type Turn, type WindowEviction, type WindowRecord, type WindowRefusal, type WindowRefusalReason, type WindowStrategy, type WindowStrategyInput, type WindowStrategyResult, } from './core/agent/window/index.js';
+export { CompactionUnmeasurableError, COMPACTED_FRAME_PREFIX, DROP_NOTICE_PREFIX, foldedMessages, foldedSpanFor, isCompactedSummary, isDropNotice, slidingWindow, summarizeOldest, tokenBudget, type CompactionOptions, type CompactionRecord, type CompactionRetention, type FoldedConversation, type FoldedSpan, type RemovalFacts, type RemovalPlan, type SlidingWindowOptions, type SlidingWindowRecord, type TokenBudgetOptions, type TokenBudgetRecord, type Turn, type WindowEviction, type WindowRecord, type WindowRefusal, type WindowRefusalReason, type WindowStrategy, type WindowStrategyInput, type WindowStrategyResult, } from './core/agent/window/index.js';
 export type { SelfExplainInclude, SelfExplainOptions } from './lib/trace-toolpack/selfExplain.js';
 export type { ObserverDrainResult, ObserverStats } from 'footprintjs';
 export type { ToolArgValidationMode } from './core/agent/toolArgsValidation.js';

package/dist/esm/index.js

@@ -166,14 +166,14 @@ export { graph, Graph, } from './core-flow/Graph.js';
 // because bundlers walking these never touch optional peer-dep code.
 //
 // Vendor-SDK-backed providers (AnthropicProvider, OpenAIProvider,
-// BedrockProvider) live ONLY at `agentfootprint/llm-providers`. That
+// BedrockProvider) live ONLY at `agentfootprint/providers`. That
 // subpath segregation means bundlers walking from `agentfootprint` main
 // never see the lazy peer-dep requires for `@anthropic-ai/sdk`,
 // `openai`, `@aws-sdk/client-bedrock-runtime`, etc. — automatic
 // tree-shaking, no bundler-side workarounds.
 //
 //   import { AnthropicProvider } from 'agentfootprint';                  // ❌ not exported
-//   import { AnthropicProvider } from 'agentfootprint/llm-providers';    // ✓ canonical
+//   import { AnthropicProvider } from 'agentfootprint/providers';        // ✓ canonical
 export { providerFromEnv, } from './adapters/llm/createProvider.js';
 // Streaming helpers — agent events → SSE for browser delivery.
 // Injection Engine — the unifying primitive of context engineering.
@@ -199,7 +199,7 @@ export { topK, } from './memory/retrieval/index.js';
 // which connect to a Model Context Protocol server and expose its tools
 // as agentfootprint `Tool[]` for `agent.tools(...)` — and the dispatch
 // primitives `staticTools` / `gatedTools` / `skillScopedTools` live
-// ONLY under `agentfootprint/tool-providers`: one subpath for
+// ONLY under `agentfootprint/providers`: one subpath for
 // everything tool-related, so the main barrel stays focused on the core
 // agent API. NONE of them are re-exported here.
 // `@modelcontextprotocol/sdk` stays a lazy-required peer-dep, so an app
@@ -207,7 +207,7 @@ export { topK, } from './memory/retrieval/index.js';
 // 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.
-// Message Catalog Pattern (v2.5+). `agentfootprint/locales` is the
+// Message Catalog Pattern (v2.5+). `agentfootprint/observe` is the
 // dedicated subpath; the root barrel also re-exports the helpers so
 // existing v2.4 consumers find them at the top level.
 //# sourceMappingURL=index.js.map

package/dist/esm/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/esm/injection-engine.d.ts

@@ -1,8 +1,8 @@
 /**
- * agentfootprint/injection-engine — public re-export for the InjectionEngine subsystem.
+ * injection-engine — public re-export for the InjectionEngine subsystem.
  *
- * @deprecated Since 8.0.0 — import from `agentfootprint/context` instead.
- * This path keeps working for all of 8.x and is removed in 9.0.0. Every name
- * here is the same symbol on the new door, not a copy.
+ * Not an import path of its own since 9.0.0. This is the implementation barrel
+ * behind `agentfootprint/context`, which re-exports every name here — same
+ * symbols, one door. Import from the door.
  */
 export * from './lib/injection-engine/index.js';

package/dist/esm/injection-engine.js

@@ -1,9 +1,9 @@
 /**
- * agentfootprint/injection-engine — public re-export for the InjectionEngine subsystem.
+ * injection-engine — public re-export for the InjectionEngine subsystem.
  *
- * @deprecated Since 8.0.0 — import from `agentfootprint/context` instead.
- * This path keeps working for all of 8.x and is removed in 9.0.0. Every name
- * here is the same symbol on the new door, not a copy.
+ * Not an import path of its own since 9.0.0. This is the implementation barrel
+ * behind `agentfootprint/context`, which re-exports every name here — same
+ * symbols, one door. Import from the door.
  */
 export * from './lib/injection-engine/index.js';
 //# sourceMappingURL=injection-engine.js.map

package/dist/esm/lib/context-ledger/gates.d.ts

@@ -36,7 +36,7 @@ export interface LedgerPolicy {
  * TOOL GATE — plug into the existing provider combinator:
  *
  * ```ts
- * import { gatedTools, staticTools } from 'agentfootprint/tool-providers';
+ * import { gatedTools, staticTools } from 'agentfootprint/providers';
  * builder.toolProvider(gatedTools(staticTools(tools), ledgerToolGate(ledger)));
  * ```
  *

package/dist/esm/lib/context-ledger/gates.js

@@ -40,7 +40,7 @@ function makeVerdict(ledger, policy) {
  * TOOL GATE — plug into the existing provider combinator:
  *
  * ```ts
- * import { gatedTools, staticTools } from 'agentfootprint/tool-providers';
+ * import { gatedTools, staticTools } from 'agentfootprint/providers';
  * builder.toolProvider(gatedTools(staticTools(tools), ledgerToolGate(ledger)));
  * ```
  *

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

@@ -111,7 +111,7 @@ export declare class SkillRegistry {
      *   const { listSkills, readSkill } = registry.toTools();
      *   const tools = [listSkills, readSkill, ...other].filter(Boolean) as Tool[];
      *
-     * Composes with `gatedTools` from `agentfootprint/tool-providers`
+     * Composes with `gatedTools` from `agentfootprint/providers`
      * so PermissionPolicy can scope which roles see the skill discovery
      * surface.
      *

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

@@ -120,7 +120,7 @@ export class SkillRegistry {
      *   const { listSkills, readSkill } = registry.toTools();
      *   const tools = [listSkills, readSkill, ...other].filter(Boolean) as Tool[];
      *
-     * Composes with `gatedTools` from `agentfootprint/tool-providers`
+     * Composes with `gatedTools` from `agentfootprint/providers`
      * so PermissionPolicy can scope which roles see the skill discovery
      * surface.
      *

package/dist/esm/lib/injection-engine/factories/defineSkill.d.ts

@@ -107,21 +107,6 @@ export interface DefineSkillOptions {
      *  every leaf. If a tool must never be offered before activation, that is not a
      *  default — say so with `autoActivate`. */
     readonly tools?: readonly Tool[];
-    /**
-     * Override the activation tool name. Defaults to `'read_skill'`.
-     * Multiple Skills sharing one activation tool is the common pattern;
-     * the LLM picks WHICH skill via the tool's argument.
-     *
-     * @deprecated Since 8.7.0 — `'read_skill'` is the only value that has ever worked,
-     * and anything else is now REFUSED when the skill is mounted on an agent. No tool is
-     * built from this name: the evaluator activates an `llm-activated` skill by matching
-     * `ctx.activatedInjectionIds`, which only `read_skill` writes, and it never reads
-     * this field. A skill declaring another name activated through `read_skill` exactly
-     * like every other skill, so the declaration described a door that does not exist.
-     * Drop it — skills already share ONE activation tool and the model picks which skill
-     * by id. Removed in 9.0.0.
-     */
-    readonly viaToolName?: string;
     /**
      * Where the body lands when activated. See `SurfaceMode`. Default
      * `'auto'`, which delivers like `'system-prompt'`; name a mode
@@ -144,7 +129,7 @@ export interface DefineSkillOptions {
      *   static tool list and offered to the model only on iterations where
      *   the Skill is active. Outside the Agent's own wiring, materialize the
      *   same gate with `skillScopedTools(id, tools)` from
-     *   `agentfootprint/tool-providers`.
+     *   `agentfootprint/providers`.
      * - `undefined` (default) — additive: this Skill's tools go into the
      *   agent's registry at BUILD time and the model can see and call them
      *   from iteration 1, activated or not.

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

@@ -58,6 +58,33 @@ export function resolveSurfaceMode(provider, model) {
     }
     return 'tool-only';
 }
+/**
+ * Refuse a `viaToolName` option that no longer exists (9.0.0 grace error).
+ *
+ * The option was deprecated in 8.7.0 and removed here. `'read_skill'` is the
+ * only activation tool this library has ever built: the evaluator activates an
+ * `llm-activated` skill by matching `ctx.activatedInjectionIds`, only
+ * `read_skill` writes that array, and nothing ever read the field. 8.7.0 made
+ * a non-`read_skill` value a mount-time refusal; 9.0.0 deletes the option.
+ *
+ * Deleting a type member alone would have been a silent DOWNGRADE: an object
+ * literal gets an excess-property error, but an options bag arriving through a
+ * variable does not — and the value would then be ignored where 8.7.0 refused
+ * it. So the field is read at run time exactly once more, to say it is gone.
+ *
+ * Deleted in 10.0.0.
+ */
+function assertNoViaToolName(where, opts) {
+    const legacy = opts.viaToolName;
+    if (legacy === undefined)
+        return;
+    throw new Error(`${where}: \`viaToolName\` was removed in 9.0.0 (deprecated since 8.7.0), and this call ` +
+        `passes '${String(legacy)}'. It never did anything: 'read_skill' is the only activation ` +
+        `tool this library builds, the evaluator matches on ctx.activatedInjectionIds — which ` +
+        `only read_skill writes — and no tool was ever created from this name. Drop the option: ` +
+        `skills already share ONE activation tool and the model picks WHICH skill by id. If you ` +
+        `need the skill gated on something else, use a \`rule\` trigger or a skillGraph() edge.`);
+}
 export function defineSkill(opts) {
     if (!opts.id || opts.id.trim().length === 0) {
         throw new Error('defineSkill: `id` is required and must be non-empty.');
@@ -68,13 +95,14 @@ export function defineSkill(opts) {
     if (!opts.body || opts.body.length === 0) {
         throw new Error(`defineSkill(${opts.id}): \`body\` is required.`);
     }
+    assertNoViaToolName(`defineSkill(${opts.id})`, opts);
     return Object.freeze({
         id: opts.id,
         description: opts.description,
         flavor: 'skill',
         trigger: {
             kind: 'llm-activated',
-            viaToolName: opts.viaToolName ?? 'read_skill',
+            viaToolName: 'read_skill',
         },
         inject: {
             systemPrompt: opts.body,

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

@@ -1 +1 @@
-{"version":3,"file":"defineSkill.js","sourceRoot":"","sources":["../../../../../src/lib/injection-engine/factories/defineSkill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAIH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAuJxE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,KAAc;IACjE,MAAM,CAAC,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IACjC,IAAI,CAAC,KAAK,WAAW,EAAE,CAAC;QACtB,2CAA2C;QAC3C,4CAA4C;QAC5C,+EAA+E;QAC/E,gFAAgF;QAChF,IAAI,KAAK,IAAI,iEAAiE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3F,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAwB;IAClD,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CACb,eAAe,IAAI,CAAC,EAAE,0EAA0E,CACjG,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,CAAC,EAAE,0BAA0B,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM,EAAE,OAAgB;QACxB,OAAO,EAAE;YACP,IAAI,EAAE,eAAwB;YAC9B,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,YAAY;SAC9C;QACD,MAAM,EAAE;YACN,YAAY,EAAE,IAAI,CAAC,IAAI;YACvB,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;SAClE;QACD,iEAAiE;QACjE,sEAAsE;QACtE,uEAAuE;QACvE,sEAAsE;QACtE,iBAAiB;QACjB,EAAE;QACF,qDAAqD;QACrD,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC;YACtB,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,MAAM;YACvC,GAAG,CAAC,IAAI,CAAC,aAAa,IAAI,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC;YAChE,GAAG,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC;YAC7D,KAAK,EAAE,kBAAkB,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC;SAC/C,CAAC;KACH,CAAyB,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"defineSkill.js","sourceRoot":"","sources":["../../../../../src/lib/injection-engine/factories/defineSkill.ts"],"names":[],"mappings":"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"}