agentfootprint 8.20.0 → 9.0.0

package/dist/esm/providers.d.ts

@@ -1,11 +1,11 @@
 /**
- * LLM provider adapters — implementation behind the `agentfootprint/llm-providers`
+ * LLM provider adapters — implementation behind the `agentfootprint/providers`
  * subpath (which re-exports this file).
  *
  * The standalone `agentfootprint/providers` subpath alias was removed in 4.0.0.
  * Import from the canonical subpath:
  *
- *   import { mock, anthropic, openai } from 'agentfootprint/llm-providers';
+ *   import { mock, anthropic, openai } from 'agentfootprint/providers';
  *
  * Pattern: Adapter (GoF) — concrete `LLMProvider` implementations that
  *          translate the agentfootprint port to a specific vendor SDK.

package/dist/esm/providers.js

@@ -1,11 +1,11 @@
 /**
- * LLM provider adapters — implementation behind the `agentfootprint/llm-providers`
+ * LLM provider adapters — implementation behind the `agentfootprint/providers`
  * subpath (which re-exports this file).
  *
  * The standalone `agentfootprint/providers` subpath alias was removed in 4.0.0.
  * Import from the canonical subpath:
  *
- *   import { mock, anthropic, openai } from 'agentfootprint/llm-providers';
+ *   import { mock, anthropic, openai } from 'agentfootprint/providers';
  *
  * Pattern: Adapter (GoF) — concrete `LLMProvider` implementations that
  *          translate the agentfootprint port to a specific vendor SDK.

package/dist/esm/recorders/core/ContextRecorder.js

@@ -121,18 +121,21 @@ export class ContextRecorder {
         if (!records)
             return;
         for (const rec of records) {
-            // The payload REQUIRES `unit` / `cap` / `projected` (8.14.0); the record
-            // does not, because slot builders — including any a consumer wrote —
-            // still typecheck without them. Filling `'chars'` here is not a guess:
-            // this handler only ever sees writes to `COMPOSITION_KEYS.BUDGET_PRESSURE`,
-            // which come off a slot composition, and a slot composition counts
-            // `String.length`. A window strategy never travels this path — it emits
-            // the event directly, with `unit: 'tokens'`.
+            // The payload REQUIRES `unit`; the record does not, because slot
+            // builders — including any a consumer wrote — still typecheck without
+            // it. Filling `'chars'` here is not a guess: this handler only ever
+            // sees writes to `COMPOSITION_KEYS.BUDGET_PRESSURE`, which come off a
+            // slot composition, and a slot composition counts `String.length`. A
+            // window strategy never travels this path — it emits the event
+            // directly, with `unit: 'tokens'`.
+            const { cap, projected } = readPressureNumbers(rec);
             this.dispatch('agentfootprint.context.budget_pressure', {
-                ...rec,
+                slot: rec.slot,
+                overflowBy: rec.overflowBy,
+                planAction: rec.planAction,
                 unit: rec.unit ?? 'chars',
-                cap: rec.cap ?? rec.capTokens,
-                projected: rec.projected ?? rec.projectedTokens,
+                cap,
+                projected,
             }, event);
         }
     }
@@ -219,10 +222,43 @@ export class ContextRecorder {
             const rec = r;
             if (typeof rec.slot !== 'string')
                 return undefined;
-            if (typeof rec.capTokens !== 'number')
+            if (typeof rec.cap !== 'number' && typeof rec.capTokens !== 'number')
                 return undefined;
         }
         return value;
     }
 }
+let warnedLegacyPressureNames = false;
+/**
+ * Read a pressure record's two numbers, accepting the 8.x spelling once more.
+ *
+ * 9.0.0 grace, not support: `cap` / `projected` win whenever they are present,
+ * and a record carrying only the old names is read AND reported — once per
+ * process, because a slot builder that writes them writes them on every
+ * composition and a warning per event is a warning nobody reads.
+ *
+ * A refusal would have been the wrong shape here. This is a recorder: a throw
+ * is isolated by footprintjs and swallowed, so refusing would delete the
+ * consumer's budget signal and say nothing about why. Reading the value and
+ * naming the new fields is the version of "teach" that survives the channel.
+ *
+ * The fallback is deleted in 10.0.0; then a legacy-only record fails
+ * `asPressureArray` and no event is emitted at all.
+ */
+function readPressureNumbers(rec) {
+    const legacy = rec;
+    const cap = legacy.cap ?? legacy.capTokens ?? 0;
+    const projected = legacy.projected ?? legacy.projectedTokens ?? 0;
+    if (legacy.cap === undefined && legacy.capTokens !== undefined && !warnedLegacyPressureNames) {
+        warnedLegacyPressureNames = true;
+        // eslint-disable-next-line no-console
+        console.warn(`[agentfootprint] a budget-pressure record for slot '${rec.slot}' carries the 8.x field ` +
+            `names \`capTokens\` / \`projectedTokens\`, which were removed in 9.0.0. They are read ` +
+            `this once so your budget signal still fires, and the fallback is deleted in 10.0.0. ` +
+            `Write \`cap\` / \`projected\` with \`unit\` instead — the old names asserted TOKENS on ` +
+            `a channel that counts CHARACTERS. Whichever slot builder produced this record needs ` +
+            `the three-field shape.`);
+    }
+    return { cap, projected };
+}
 //# sourceMappingURL=ContextRecorder.js.map

package/dist/esm/recorders/core/ContextRecorder.js.map

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

package/dist/esm/recorders/core/types.d.ts

@@ -82,15 +82,17 @@ export interface EvictionRecord {
 /**
  * Budget-pressure warning — emitted before evictions fire.
  *
- * `capTokens` / `projectedTokens` are historical names: on THIS channel the
- * numbers are CHARS (`composeSlot` measures `String.length`). Renaming them
- * would be breaking, so they stay and {@link unit} / {@link cap} /
- * {@link projected} were added beside them in 8.14.0.
+ * `cap` and `projected` are counted in {@link unit}. They were added in 8.14.0
+ * beside `capTokens` / `projectedTokens`, which asserted a unit this channel
+ * does not use: on THIS channel the numbers are CHARS (`composeSlot` measures
+ * `String.length`), while a window strategy fills the same event with tokens.
+ * 9.0.0 removed the two misnamed fields, and `cap` / `projected` are required
+ * in their place — a record that carried neither pair would be a record with
+ * no numbers on it.
  *
- * The three new fields are OPTIONAL here, unlike on the event payload, because
- * this record is written by slot builders — including any a consumer wrote —
- * and a record from one of those still typechecks. `ContextRecorder` fills a
- * missing `unit` with `'chars'`, which is not a guess: every write to
+ * {@link unit} stays OPTIONAL, unlike on the event payload, because this
+ * record is written by slot builders — including any a consumer wrote. A
+ * missing `unit` reads as `'chars'`, which is not a guess: every write to
  * `COMPOSITION_KEYS.BUDGET_PRESSURE` comes off a slot composition, and a slot
  * composition is counted in characters by construction.
  *
@@ -100,19 +102,15 @@ export interface EvictionRecord {
  */
 export interface BudgetPressureRecord {
     readonly slot: ContextSlot;
-    /** @deprecated Read {@link cap} with {@link unit}. Still written. */
-    readonly capTokens: number;
-    /** @deprecated Read {@link projected} with {@link unit}. Still written. */
-    readonly projectedTokens: number;
     readonly overflowBy: number;
     readonly planAction: 'evict' | 'summarize' | 'abort' | 'none';
-    /** What the numbers count. Absent on a record written before 8.14.0 (or by
-     *  a third-party slot builder) — the slot channel is `'chars'`. */
+    /** What the numbers count. Absent on a record written by a third-party slot
+     *  builder — the slot channel is `'chars'`. */
     readonly unit?: 'chars' | 'tokens';
-    /** Same value as {@link capTokens}, under a name that asserts no unit. */
-    readonly cap?: number;
-    /** Same value as {@link projectedTokens}, under a name that asserts no unit. */
-    readonly projected?: number;
+    /** The budget, in {@link unit}. */
+    readonly cap: number;
+    /** What was measured against it, in {@link unit}. */
+    readonly projected: number;
 }
 export declare const COMPOSITION_KEYS: {
     readonly SLOT_COMPOSED: "slotCompositions";

package/dist/esm/recorders/core/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/recorders/core/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAsHH,uEAAuE;AACvE,0EAA0E;AAC1E,4BAA4B;AAC5B,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,aAAa,EAAE,kBAAkB;IACjC,OAAO,EAAE,eAAe;IACxB,eAAe,EAAE,qBAAqB;CAC9B,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/recorders/core/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoHH,uEAAuE;AACvE,0EAA0E;AAC1E,4BAA4B;AAC5B,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,aAAa,EAAE,kBAAkB;IACjC,OAAO,EAAE,eAAe;IACxB,eAAe,EAAE,qBAAqB;CAC9B,CAAC"}

package/dist/esm/recorders/observability/RouteRecorder.d.ts

@@ -15,7 +15,7 @@
  *
  * Pattern: CombinedRecorder (Convention 1 — single purpose: route evidence). Owns a
  *          `SequenceStore<RouteHop>`. Convention 4: resets on a new `runId`.
- * Role:    Tier-3 /observe recorder — `Agent.create(...).recorder(routeRecorder())`.
+ * Role:    Tier-3 /observe recorder — `Agent.create(...).watch(routeRecorder())`.
  *          Powers the lens, the "Why this skill?" panel, and paper route figures.
  */
 import type { EmitEvent } from 'footprintjs';

package/dist/esm/recorders/observability/RouteRecorder.js

@@ -15,7 +15,7 @@
  *
  * Pattern: CombinedRecorder (Convention 1 — single purpose: route evidence). Owns a
  *          `SequenceStore<RouteHop>`. Convention 4: resets on a new `runId`.
- * Role:    Tier-3 /observe recorder — `Agent.create(...).recorder(routeRecorder())`.
+ * Role:    Tier-3 /observe recorder — `Agent.create(...).watch(routeRecorder())`.
  *          Powers the lens, the "Why this skill?" panel, and paper route figures.
  */
 import { SequenceStore } from 'footprintjs/trace';

package/dist/esm/recorders/observability/ToolChoiceRecorder.d.ts

@@ -60,7 +60,7 @@
  *          by the LLM call's `runtimeStageId`. Convention 4: resets on a
  *          new `runId` via `FlowRecorder.onRunStart`.
  * Role:    Tier-3 /observe recorder. Attach via `Agent.create(...)
- *          .recorder(handle)` or `executor.attachCombinedRecorder`.
+ *          .watch(handle)` or `executor.attachCombinedRecorder`.
  *
  * Honest claim (RFC-002 §2): margins are embedding geometry between the
  * context and tool descriptions — a deterministic PROXY for the model's

package/dist/esm/recorders/observability/ToolChoiceRecorder.js

@@ -60,7 +60,7 @@
  *          by the LLM call's `runtimeStageId`. Convention 4: resets on a
  *          new `runId` via `FlowRecorder.onRunStart`.
  * Role:    Tier-3 /observe recorder. Attach via `Agent.create(...)
- *          .recorder(handle)` or `executor.attachCombinedRecorder`.
+ *          .watch(handle)` or `executor.attachCombinedRecorder`.
  *
  * Honest claim (RFC-002 §2): margins are embedding geometry between the
  * context and tool descriptions — a deterministic PROXY for the model's

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

@@ -32,9 +32,21 @@
  * different class than the provider decorator does, so this path stays the
  * only home for it. Everything else here is also on the new door.
  *
- * @deprecated Since 8.0.0 — import from `agentfootprint/resilience` 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.
+ * ## Why this path survived 9.0.0
+ *
+ * 9.0.0 removed the other sixteen 8.0.0 door aliases. This one stayed, and the
+ * reason is that ONE name: the gate's `CircuitOpenError` and the decorator's
+ * are two different classes with different constructors and different
+ * `instanceof` answers, `agentfootprint/resilience` carries the decorator's,
+ * and a name cannot be exported twice from one door. Removing this path would
+ * not have renamed the gate's error — it would have made it unreachable, so a
+ * consumer could no longer `instanceof`-check the error their own reliability
+ * gate throws. That is a capability, not a spelling, so the path stayed.
+ *
+ * @deprecated Since 8.0.0 for every name EXCEPT `CircuitOpenError` — those all
+ * live on `agentfootprint/resilience`, which is the door to prefer. This path
+ * is NOT scheduled for removal: it is the only home of the reliability gate's
+ * `CircuitOpenError`, and the removal date announced in 8.0.0 is withdrawn.
  */
 export type { CircuitBreakerConfig, ReliabilityConfig, ReliabilityDecision, ReliabilityFallbackFn, ReliabilityProvider, ReliabilityRule, ReliabilityScope, } from './types.js';
 export { ReliabilityFailFastError } from './types.js';

package/dist/esm/reliability/index.js

@@ -32,9 +32,21 @@
  * different class than the provider decorator does, so this path stays the
  * only home for it. Everything else here is also on the new door.
  *
- * @deprecated Since 8.0.0 — import from `agentfootprint/resilience` 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.
+ * ## Why this path survived 9.0.0
+ *
+ * 9.0.0 removed the other sixteen 8.0.0 door aliases. This one stayed, and the
+ * reason is that ONE name: the gate's `CircuitOpenError` and the decorator's
+ * are two different classes with different constructors and different
+ * `instanceof` answers, `agentfootprint/resilience` carries the decorator's,
+ * and a name cannot be exported twice from one door. Removing this path would
+ * not have renamed the gate's error — it would have made it unreachable, so a
+ * consumer could no longer `instanceof`-check the error their own reliability
+ * gate throws. That is a capability, not a spelling, so the path stayed.
+ *
+ * @deprecated Since 8.0.0 for every name EXCEPT `CircuitOpenError` — those all
+ * live on `agentfootprint/resilience`, which is the door to prefer. This path
+ * is NOT scheduled for removal: it is the only home of the reliability gate's
+ * `CircuitOpenError`, and the removal date announced in 8.0.0 is withdrawn.
  */
 export { ReliabilityFailFastError } from './types.js';
 // CircuitBreaker pure-state-machine surface — exposed so consumers can

package/dist/esm/reliability/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/reliability/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAYH,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEtD,uEAAuE;AACvE,qEAAqE;AACrE,+DAA+D;AAC/D,OAAO,EACL,gBAAgB,EAChB,mBAAmB,GAGpB,MAAM,qBAAqB,CAAC;AAE7B,wEAAwE;AACxE,mEAAmE;AACnE,+DAA+D;AAC/D,sEAAsE;AACtE,mEAAmE;AACnE,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,oBAAoB,GACrB,MAAM,8CAA8C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/reliability/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAYH,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEtD,uEAAuE;AACvE,qEAAqE;AACrE,+DAA+D;AAC/D,OAAO,EACL,gBAAgB,EAChB,mBAAmB,GAGpB,MAAM,qBAAqB,CAAC;AAE7B,wEAAwE;AACxE,mEAAmE;AACnE,+DAA+D;AAC/D,sEAAsE;AACtE,mEAAmE;AACnE,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,oBAAoB,GACrB,MAAM,8CAA8C,CAAC"}

package/dist/esm/resilience/fallbackProvider.d.ts

@@ -10,7 +10,7 @@
  * predicate. The first success wins; if all fail, the last error throws.
  *
  * @example
- *   import { anthropic, openai, mock } from 'agentfootprint/llm-providers';
+ *   import { anthropic, openai, mock } from 'agentfootprint/providers';
  *   import { fallbackProvider } from 'agentfootprint/resilience';
  *
  *   const provider = fallbackProvider(

package/dist/esm/resilience/fallbackProvider.js

@@ -10,7 +10,7 @@
  * predicate. The first success wins; if all fail, the last error throws.
  *
  * @example
- *   import { anthropic, openai, mock } from 'agentfootprint/llm-providers';
+ *   import { anthropic, openai, mock } from 'agentfootprint/providers';
  *   import { fallbackProvider } from 'agentfootprint/resilience';
  *
  *   const provider = fallbackProvider(

package/dist/esm/resilience/withCircuitBreaker.d.ts

@@ -127,7 +127,7 @@ export declare class CircuitOpenError extends Error {
  *
  * @example
  * ```ts
- * import { anthropic, openai } from 'agentfootprint/llm-providers';
+ * import { anthropic, openai } from 'agentfootprint/providers';
  * import { withCircuitBreaker, withFallback } from 'agentfootprint/resilience';
  *
  * const provider = withFallback(

package/dist/esm/resilience/withCircuitBreaker.js

@@ -106,7 +106,7 @@ export class CircuitOpenError extends Error {
  *
  * @example
  * ```ts
- * import { anthropic, openai } from 'agentfootprint/llm-providers';
+ * import { anthropic, openai } from 'agentfootprint/providers';
  * import { withCircuitBreaker, withFallback } from 'agentfootprint/resilience';
  *
  * const provider = withFallback(

package/dist/esm/resilience/withRetry.d.ts

@@ -53,7 +53,7 @@ export interface WithRetryOptions {
  *
  * @example
  *   import { withRetry } from 'agentfootprint/resilience';
- *   import { anthropic } from 'agentfootprint/llm-providers';
+ *   import { anthropic } from 'agentfootprint/providers';
  *
  *   const robust = withRetry(anthropic({ apiKey }), {
  *     maxAttempts: 5,

package/dist/esm/resilience/withRetry.js

@@ -23,7 +23,7 @@
  *
  * @example
  *   import { withRetry } from 'agentfootprint/resilience';
- *   import { anthropic } from 'agentfootprint/llm-providers';
+ *   import { anthropic } from 'agentfootprint/providers';
  *
  *   const robust = withRetry(anthropic({ apiKey }), {
  *     maxAttempts: 5,

package/dist/esm/security/PermissionPolicy.d.ts

@@ -14,7 +14,7 @@
  *      - `PermissionChecker` interface (async check; consumed by Agent
  *        constructor's `permissionChecker` field)
  *      - sync `isAllowed(toolId)` method (consumed by `gatedTools(...)`
- *        from `agentfootprint/tool-providers`)
+ *        from `agentfootprint/providers`)
  *
  * Pattern: Strategy (GoF) for the role-allowlist policy + Adapter
  *          (matches `PermissionChecker` interface so it composes with
@@ -73,7 +73,7 @@ export interface PermissionPolicyOptions {
 /**
  * Data-driven role-based permission policy. Satisfies the v2.4
  * `PermissionChecker` interface AND exposes a sync `isAllowed` method
- * for use with `gatedTools` from `agentfootprint/tool-providers`.
+ * for use with `gatedTools` from `agentfootprint/providers`.
  */
 export declare class PermissionPolicy implements PermissionChecker {
     private readonly opts;

package/dist/esm/security/PermissionPolicy.js

@@ -14,7 +14,7 @@
  *      - `PermissionChecker` interface (async check; consumed by Agent
  *        constructor's `permissionChecker` field)
  *      - sync `isAllowed(toolId)` method (consumed by `gatedTools(...)`
- *        from `agentfootprint/tool-providers`)
+ *        from `agentfootprint/providers`)
  *
  * Pattern: Strategy (GoF) for the role-allowlist policy + Adapter
  *          (matches `PermissionChecker` interface so it composes with
@@ -53,7 +53,7 @@
 /**
  * Data-driven role-based permission policy. Satisfies the v2.4
  * `PermissionChecker` interface AND exposes a sync `isAllowed` method
- * for use with `gatedTools` from `agentfootprint/tool-providers`.
+ * for use with `gatedTools` from `agentfootprint/providers`.
  */
 export class PermissionPolicy {
     opts;

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

@@ -4,13 +4,13 @@
  * Permissions are NOT context engineering — they're a guard ON
  * context-engineering operations (tool dispatch, skill activation,
  * memory writes, output emission). That's why this lives in its own
- * subpath, parallel to `agentfootprint/tool-providers` and the
+ * subpath, parallel to `agentfootprint/providers` and the
  * `agentfootprint/memory-*` and `agentfootprint/providers` subpaths.
  *
  * Today's surface is small and data-driven on purpose: one role
  * allowlist primitive that satisfies BOTH the v2.4 `PermissionChecker`
  * interface AND a sync `isAllowed(toolId)` predicate for use with
- * `gatedTools` from `agentfootprint/tool-providers` — plus
+ * `gatedTools` from `agentfootprint/providers` — plus
  * `agentCorePolicy()`, the same port answered by a remote policy store.
  *
  * A local allowlist and a remote policy engine differ in one way that
@@ -25,7 +25,7 @@
  *
  * @example
  *   import { PermissionPolicy } from 'agentfootprint/security';
- *   import { gatedTools, staticTools } from 'agentfootprint/tool-providers';
+ *   import { gatedTools, staticTools } from 'agentfootprint/providers';
  *
  *   const policy = PermissionPolicy.fromRoles(
  *     {

package/dist/esm/security/index.js

@@ -4,13 +4,13 @@
  * Permissions are NOT context engineering — they're a guard ON
  * context-engineering operations (tool dispatch, skill activation,
  * memory writes, output emission). That's why this lives in its own
- * subpath, parallel to `agentfootprint/tool-providers` and the
+ * subpath, parallel to `agentfootprint/providers` and the
  * `agentfootprint/memory-*` and `agentfootprint/providers` subpaths.
  *
  * Today's surface is small and data-driven on purpose: one role
  * allowlist primitive that satisfies BOTH the v2.4 `PermissionChecker`
  * interface AND a sync `isAllowed(toolId)` predicate for use with
- * `gatedTools` from `agentfootprint/tool-providers` — plus
+ * `gatedTools` from `agentfootprint/providers` — plus
  * `agentCorePolicy()`, the same port answered by a remote policy store.
  *
  * A local allowlist and a remote policy engine differ in one way that
@@ -25,7 +25,7 @@
  *
  * @example
  *   import { PermissionPolicy } from 'agentfootprint/security';
- *   import { gatedTools, staticTools } from 'agentfootprint/tool-providers';
+ *   import { gatedTools, staticTools } from 'agentfootprint/providers';
  *
  *   const policy = PermissionPolicy.fromRoles(
  *     {

package/dist/esm/status.d.ts

@@ -1,5 +1,5 @@
 /**
- * agentfootprint/status — chat-bubble status surface.
+ * status — chat-bubble status surface.
  *
  * Pattern: pure projection. `selectStatus` walks the typed
  *          event log forward, tracking active pause / tool / LLM state,
@@ -10,26 +10,16 @@
  *          right now?" indicator. Output feeds `renderStatusLine`
  *          which resolves a template + variables to a final string.
  *
- * Why a subpath:
- *   - Consistent with `agentfootprint/observe` and
- *     `agentfootprint/locales` — every observability surface gets its
- *     own entry point.
- *   - Self-documenting at the import line: `from 'agentfootprint/status'`
- *     vs an opaque main-export grab.
- *   - Future home for extended-thinking primitives (Anthropic
- *     `thinking_delta` / `redacted_thinking` blocks). Adding them here
- *     is non-breaking; consumers already importing from
- *     `agentfootprint/status` get the new state surface for free.
- *
- * Prose lives elsewhere: the `defaultStatusTemplates` catalog's canonical
- * home is `agentfootprint/locales` (the single i18n home for all prose —
- * commentary, thinking, status). It is re-exported here for convenience, but
- * new code should import the words from `/locales` and the LOGIC
- * (`selectStatus` / `renderStatusLine`) from here.
- *
- * As of v7 these are NOT on the main `agentfootprint` barrel — status is a
- * named subpath like every other observability surface. Import the logic
- * from `agentfootprint/status`, the words from `agentfootprint/locales`.
+ * Future home for extended-thinking primitives (Anthropic `thinking_delta` /
+ * `redacted_thinking` blocks). Adding them here is non-breaking; consumers
+ * already importing from `agentfootprint/observe` get the new state surface
+ * for free.
+ *
+ * Prose lives elsewhere: the `defaultStatusTemplates` catalog's canonical home
+ * is `src/locales/` (the single i18n home for all prose — commentary,
+ * thinking, status). It is re-exported here for convenience. Both come out of
+ * the `agentfootprint/observe` door; these are NOT on the main `agentfootprint`
+ * barrel.
  *
  * State machine (4 states + null):
  *
@@ -51,8 +41,8 @@
  *
  *      (null)        run done / between calls   → bubble hidden
  *
- * @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 { selectStatus, renderStatusLine, type StatusState, type StatusKind, type StatusTemplates, type StatusContext, } from './recorders/observability/status/statusTemplates.js';

package/dist/esm/status.js

@@ -1,5 +1,5 @@
 /**
- * agentfootprint/status — chat-bubble status surface.
+ * status — chat-bubble status surface.
  *
  * Pattern: pure projection. `selectStatus` walks the typed
  *          event log forward, tracking active pause / tool / LLM state,
@@ -10,26 +10,16 @@
  *          right now?" indicator. Output feeds `renderStatusLine`
  *          which resolves a template + variables to a final string.
  *
- * Why a subpath:
- *   - Consistent with `agentfootprint/observe` and
- *     `agentfootprint/locales` — every observability surface gets its
- *     own entry point.
- *   - Self-documenting at the import line: `from 'agentfootprint/status'`
- *     vs an opaque main-export grab.
- *   - Future home for extended-thinking primitives (Anthropic
- *     `thinking_delta` / `redacted_thinking` blocks). Adding them here
- *     is non-breaking; consumers already importing from
- *     `agentfootprint/status` get the new state surface for free.
- *
- * Prose lives elsewhere: the `defaultStatusTemplates` catalog's canonical
- * home is `agentfootprint/locales` (the single i18n home for all prose —
- * commentary, thinking, status). It is re-exported here for convenience, but
- * new code should import the words from `/locales` and the LOGIC
- * (`selectStatus` / `renderStatusLine`) from here.
- *
- * As of v7 these are NOT on the main `agentfootprint` barrel — status is a
- * named subpath like every other observability surface. Import the logic
- * from `agentfootprint/status`, the words from `agentfootprint/locales`.
+ * Future home for extended-thinking primitives (Anthropic `thinking_delta` /
+ * `redacted_thinking` blocks). Adding them here is non-breaking; consumers
+ * already importing from `agentfootprint/observe` get the new state surface
+ * for free.
+ *
+ * Prose lives elsewhere: the `defaultStatusTemplates` catalog's canonical home
+ * is `src/locales/` (the single i18n home for all prose — commentary,
+ * thinking, status). It is re-exported here for convenience. Both come out of
+ * the `agentfootprint/observe` door; these are NOT on the main `agentfootprint`
+ * barrel.
  *
  * State machine (4 states + null):
  *
@@ -51,12 +41,12 @@
  *
  *      (null)        run done / between calls   → bubble hidden
  *
- * @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.
  */
 // Logic only — the status state machine + renderer. The prose catalog
-// (`defaultStatusTemplates`) lives on `agentfootprint/locales`, the single
+// (`defaultStatusTemplates`) lives on `agentfootprint/observe`, the single
 // home for all user-facing text; `renderStatusLine` consumes it.
 export { selectStatus, renderStatusLine, } from './recorders/observability/status/statusTemplates.js';
 //# sourceMappingURL=status.js.map

package/dist/esm/status.js.map

@@ -1 +1 @@
-{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AAEH,sEAAsE;AACtE,2EAA2E;AAC3E,iEAAiE;AACjE,OAAO,EACL,YAAY,EACZ,gBAAgB,GAKjB,MAAM,qDAAqD,CAAC"}
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAEH,sEAAsE;AACtE,2EAA2E;AAC3E,iEAAiE;AACjE,OAAO,EACL,YAAY,EACZ,gBAAgB,GAKjB,MAAM,qDAAqD,CAAC"}