agentfootprint 2.7.3 → 2.8.1

package/dist/strategies/compose.js.map

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

package/dist/strategies/defaults/chatBubbleLiveStatus.js

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * `chatBubbleLiveStatus()` — default LiveStatusStrategy.
+ *
+ * Pattern: Strategy. Adapter for a consumer-supplied callback.
+ * Role:    The "every chat UI" sink. Wraps a `(line: string) => void`
+ *          callback so the consumer just hands us the function their
+ *          chat-bubble component needs and we drive it on every
+ *          rendered status update.
+ *
+ * Use when:
+ *   - Building a chat UI (Neo, Lens, embedded widget) where the
+ *     consumer owns rendering but not state derivation
+ *   - Tier-1 of compose chains (`compose([chatBubble(setLine), stdout()])`
+ *     so dev console mirrors what the user sees)
+ *
+ * The callback runs on EVERY status transition. Consumer can debounce
+ * / coalesce per their needs (we don't impose UI policy).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chatBubbleLiveStatus = void 0;
+function chatBubbleLiveStatus(opts) {
+    return {
+        name: 'chat-bubble',
+        capabilities: { streaming: true },
+        renderStatus(update) {
+            opts.onLine(update.line);
+        },
+        validate() {
+            if (typeof opts.onLine !== 'function') {
+                throw new Error('chatBubbleLiveStatus: required `onLine` callback is missing or not a function. ' +
+                    'Pass the function that should receive each rendered status line.');
+            }
+        },
+    };
+}
+exports.chatBubbleLiveStatus = chatBubbleLiveStatus;
+//# sourceMappingURL=chatBubbleLiveStatus.js.map

package/dist/strategies/defaults/chatBubbleLiveStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatBubbleLiveStatus.js","sourceRoot":"","sources":["../../../src/strategies/defaults/chatBubbleLiveStatus.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;AAqBH,SAAgB,oBAAoB,CAAC,IAAiC;IACpE,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE;QACjC,YAAY,CAAC,MAAoB;YAC/B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QACD,QAAQ;YACN,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;gBACtC,MAAM,IAAI,KAAK,CACb,iFAAiF;oBAC/E,kEAAkE,CACrE,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAhBD,oDAgBC"}

package/dist/strategies/defaults/consoleObservability.js

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * `consoleObservability()` — default ObservabilityStrategy.
+ *
+ * Pattern: Strategy. Adapter for `globalThis.console`. Used when no
+ *          vendor-specific strategy is configured (zero-config dev
+ *          experience). Same role as `NoOpCacheStrategy` is for the
+ *          cache layer.
+ * Role:    Tier-1 fallback — print every event to the console with a
+ *          one-line type+payload summary. Vendor-neutral, dependency-
+ *          free, works in browser + Node + Deno + Bun.
+ *
+ * Use when:
+ *   - Local development (`agent.enable.observability()` with no opts)
+ *   - CI logs ("what events fired during this test?")
+ *   - Tier-1 of compose chains (`compose([console(), datadog()])`)
+ *
+ * Don't use when: production. Console output is unstructured + can't
+ * be queried; switch to a vendor strategy (Datadog, OTel, CloudWatch).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.consoleObservability = void 0;
+/**
+ * Default formatter — emits a single structured JSON line per event.
+ * Honeycomb / Datadog / Loki / any structured-log pipeline can ingest
+ * directly; `grep` still works because every line is `{` … `}`.
+ *
+ * Shape: `{type, ...payload}` — flattens payload to top level so
+ * filter expressions like `.type == "agentfootprint.cost.tick"` work
+ * without nesting.
+ */
+const DEFAULT_FORMAT = (event) => {
+    const payload = typeof event.payload === 'object' && event.payload !== null
+        ? event.payload
+        : { value: event.payload };
+    return safeJson({ type: event.type, ...payload });
+};
+/**
+ * Factory. Returns a fresh ObservabilityStrategy each call so multiple
+ * agents in the same process get independent instances.
+ */
+function consoleObservability(opts = {}) {
+    const sink = opts.logger ?? globalThis.console;
+    const format = opts.format ?? DEFAULT_FORMAT;
+    return {
+        name: 'console',
+        capabilities: { events: true, logs: true },
+        exportEvent(event) {
+            sink.log(format(event));
+        },
+    };
+}
+exports.consoleObservability = consoleObservability;
+/** JSON.stringify with circular-safety. Avoids breaking the agent loop
+ *  if a payload contains a circular ref. Returns the type alone if
+ *  serialization fails. */
+function safeJson(value) {
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return '[unserializable]';
+    }
+}
+//# sourceMappingURL=consoleObservability.js.map

package/dist/strategies/defaults/consoleObservability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consoleObservability.js","sourceRoot":"","sources":["../../../src/strategies/defaults/consoleObservability.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;AAoBH;;;;;;;;GAQG;AACH,MAAM,cAAc,GAAG,CAAC,KAA0B,EAAU,EAAE;IAC5D,MAAM,OAAO,GACX,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI;QACzD,CAAC,CAAC,KAAK,CAAC,OAAO;QACf,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;IAC/B,OAAO,QAAQ,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;AACpD,CAAC,CAAC;AAEF;;;GAGG;AACH,SAAgB,oBAAoB,CAClC,OAAoC,EAAE;IAEtC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,IAAI,UAAU,CAAC,OAAO,CAAC;IAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,cAAc,CAAC;IAC7C,OAAO;QACL,IAAI,EAAE,SAAS;QACf,YAAY,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;QAC1C,WAAW,CAAC,KAA0B;YACpC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1B,CAAC;KACF,CAAC;AACJ,CAAC;AAZD,oDAYC;AAED;;2BAE2B;AAC3B,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,kBAAkB,CAAC;IAC5B,CAAC;AACH,CAAC"}

package/dist/strategies/defaults/inMemorySinkCost.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * `inMemorySinkCost()` — default CostStrategy.
+ *
+ * Pattern: Strategy. In-process accumulator. Same role as InMemoryStore
+ *          for memory-providers.
+ * Role:    Tier-1 fallback — accumulate cost ticks in a process-local
+ *          array. Consumer reads via `getTicks()` or hooks `onRecord`
+ *          for streaming. Vendor-free.
+ *
+ * Use when:
+ *   - Tests / CI ("what cost did this run accrue?")
+ *   - Local dev before billing integration
+ *   - Tier-1 of compose chains (`compose([inMemorySink(), stripeBilling()])`
+ *     so test assertions can read ticks while production also ships)
+ *
+ * Don't use when: process is long-running with high cost-tick volume —
+ * the buffer grows unbounded. Add a `maxTicks` cap (drops oldest) or
+ * pair with a streaming strategy (`stripeBilling`, `webhook`).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inMemorySinkCost = void 0;
+function inMemorySinkCost(opts = {}) {
+    const buffer = [];
+    const cap = opts.maxTicks ?? Infinity;
+    return {
+        name: 'in-memory-sink',
+        capabilities: { streaming: true, enforcement: false },
+        recordCost(tick) {
+            buffer.push(tick);
+            // FIFO eviction when over cap.
+            while (buffer.length > cap)
+                buffer.shift();
+            opts.onRecord?.(tick);
+        },
+        getTicks() {
+            return buffer.slice();
+        },
+        getTicksCount() {
+            return buffer.length;
+        },
+        getTicksSince(idx) {
+            // Clamp negative / out-of-range. `slice` handles bounds.
+            return buffer.slice(Math.max(0, idx));
+        },
+        clear() {
+            buffer.length = 0;
+        },
+    };
+}
+exports.inMemorySinkCost = inMemorySinkCost;
+//# sourceMappingURL=inMemorySinkCost.js.map

package/dist/strategies/defaults/inMemorySinkCost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inMemorySinkCost.js","sourceRoot":"","sources":["../../../src/strategies/defaults/inMemorySinkCost.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;AAmCH,SAAgB,gBAAgB,CAAC,OAAgC,EAAE;IACjE,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC;IACtC,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE;QACrD,UAAU,CAAC,IAAc;YACvB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClB,+BAA+B;YAC/B,OAAO,MAAM,CAAC,MAAM,GAAG,GAAG;gBAAE,MAAM,CAAC,KAAK,EAAE,CAAC;YAC3C,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;QACD,QAAQ;YACN,OAAO,MAAM,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;QACD,aAAa;YACX,OAAO,MAAM,CAAC,MAAM,CAAC;QACvB,CAAC;QACD,aAAa,CAAC,GAAW;YACvB,yDAAyD;YACzD,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QACxC,CAAC;QACD,KAAK;YACH,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QACpB,CAAC;KACF,CAAC;AACJ,CAAC;AA1BD,4CA0BC"}

package/dist/strategies/defaults/index.js

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * Default strategies — the four "shipped in core" sinks.
+ *
+ *   `consoleObservability`   — print events to console
+ *   `inMemorySinkCost`       — accumulate cost ticks in a process-local buffer
+ *   `chatBubbleLiveStatus`   — call a consumer-supplied line callback
+ *   `noopLens`               — drop graph updates (zero-arg fallback)
+ *
+ * Vendor strategies (datadog, otel, agentcore, cloudwatch, …) ship as
+ * separate subpaths with peer-dep on the vendor SDK. See
+ * `docs/inspiration/strategy-everywhere.md` for the AWS-first roadmap.
+ *
+ * ─────────────────────────────────────────────────────────────────
+ * Why defaults skip `validate()`:
+ *
+ * The optional `BaseStrategy.validate()` hook is the right place for
+ * runtime config checks (API keys, endpoint reachability, peer-dep
+ * presence). Defaults skip it by design — their inputs are TypeScript-
+ * checked at construction, and they don't talk to a remote vendor that
+ * might be misconfigured.
+ *
+ * Vendor strategies that DO talk to a remote (datadog, agentcore,
+ * cloudwatch) MUST implement `validate()` per the New Relic panel
+ * review — early-fail-with-useful-message beats silent zero-emission.
+ * ─────────────────────────────────────────────────────────────────
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noopLens = exports.chatBubbleLiveStatus = exports.inMemorySinkCost = exports.consoleObservability = void 0;
+var consoleObservability_js_1 = require("./consoleObservability.js");
+Object.defineProperty(exports, "consoleObservability", { enumerable: true, get: function () { return consoleObservability_js_1.consoleObservability; } });
+var inMemorySinkCost_js_1 = require("./inMemorySinkCost.js");
+Object.defineProperty(exports, "inMemorySinkCost", { enumerable: true, get: function () { return inMemorySinkCost_js_1.inMemorySinkCost; } });
+var chatBubbleLiveStatus_js_1 = require("./chatBubbleLiveStatus.js");
+Object.defineProperty(exports, "chatBubbleLiveStatus", { enumerable: true, get: function () { return chatBubbleLiveStatus_js_1.chatBubbleLiveStatus; } });
+var noopLens_js_1 = require("./noopLens.js");
+Object.defineProperty(exports, "noopLens", { enumerable: true, get: function () { return noopLens_js_1.noopLens; } });
+//# sourceMappingURL=index.js.map

package/dist/strategies/defaults/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/strategies/defaults/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;;;AAEH,qEAAmG;AAA1F,+HAAA,oBAAoB,OAAA;AAC7B,6DAI+B;AAH7B,uHAAA,gBAAgB,OAAA;AAIlB,qEAAmG;AAA1F,+HAAA,oBAAoB,OAAA;AAC7B,6CAA+D;AAAtD,uGAAA,QAAQ,OAAA"}

package/dist/strategies/defaults/noopLens.js

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * `noopLens()` — default LensStrategy.
+ *
+ * Pattern: Strategy. Wildcard fallback. Same role as `NoOpCacheStrategy`.
+ * Role:    Drops every update. Used when no Lens vendor strategy is
+ *          configured AND the consumer hasn't supplied a callback.
+ *          Keeps `enable.lens()` callable without args without
+ *          throwing — important for the zero-arg HelloWorld pattern.
+ *
+ * Use when:
+ *   - You want the agent to run without a Lens UI (production
+ *     server-side, headless eval, batch jobs)
+ *   - Tier-1 of compose chains where you want the chain to compile
+ *     even if the real Lens strategy is conditional
+ *
+ * Don't use when: you actually want to see the StepGraph. Use
+ * `lens-browser`, `lens-cli`, or `lens-jsonExport` from the
+ * vendor-strategy subpaths once they ship in v2.12+.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noopLens = void 0;
+function noopLens(opts = {}) {
+    return {
+        name: 'noop-lens',
+        capabilities: { interactive: false, serializable: false },
+        renderGraph(update) {
+            opts.onUpdate?.(update);
+        },
+    };
+}
+exports.noopLens = noopLens;
+//# sourceMappingURL=noopLens.js.map

package/dist/strategies/defaults/noopLens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noopLens.js","sourceRoot":"","sources":["../../../src/strategies/defaults/noopLens.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;AAYH,SAAgB,QAAQ,CAAC,OAAwB,EAAE;IACjD,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,YAAY,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE;QACzD,WAAW,CAAC,MAAkB;YAC5B,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC;KACF,CAAC;AACJ,CAAC;AARD,4BAQC"}

package/dist/strategies/index.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * `agentfootprint/strategies` — typed strategy interfaces + default
+ * sinks for the v2.8 grouped-enabler architecture.
+ *
+ * See:
+ *   - `docs/inspiration/strategy-everywhere.md` — design memo + AWS-first roadmap
+ *   - `types.ts` — typed interfaces (Observability, Cost, LiveStatus, Lens)
+ *   - `defaults/` — the 4 in-core default strategies
+ *
+ * Vendor strategies ship under three GROUPED subpaths (matching the
+ * parallel-providers pattern v2.5 established for `llm-providers` /
+ * `tool-providers` / `memory-providers`). Each subpath holds N
+ * vendor-named factories — adding a vendor never adds a new subpath:
+ *
+ *   - `agentfootprint/observability-providers`
+ *       agentcoreObservability (v2.8.1)
+ *       cloudwatchObservability (v2.8.2)
+ *       xrayObservability (v2.8.3)
+ *       otelObservability (v2.9.x)
+ *       datadogObservability (v2.9.x)
+ *
+ *   - `agentfootprint/cost-providers`
+ *       stripeCost (v2.10.x)
+ *
+ *   - `agentfootprint/lens-providers`
+ *       browserLens / cliLens (v2.12.x)
+ *
+ * Each adapter lazy-imports its vendor SDK via `lib/lazyRequire.ts`,
+ * so consumers who never call a particular factory don't have to
+ * install that SDK. Peer-deps are declared in package.json with
+ * `peerDependenciesMeta.{name}.optional = true`.
+ */
+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.attachLiveStatusStrategy = exports.attachCostStrategy = exports.attachObservabilityStrategy = exports.composeLens = exports.composeLiveStatus = exports.composeCost = exports.composeObservability = void 0;
+__exportStar(require("./types.js"), exports);
+__exportStar(require("./defaults/index.js"), exports);
+var compose_js_1 = require("./compose.js");
+Object.defineProperty(exports, "composeObservability", { enumerable: true, get: function () { return compose_js_1.composeObservability; } });
+Object.defineProperty(exports, "composeCost", { enumerable: true, get: function () { return compose_js_1.composeCost; } });
+Object.defineProperty(exports, "composeLiveStatus", { enumerable: true, get: function () { return compose_js_1.composeLiveStatus; } });
+Object.defineProperty(exports, "composeLens", { enumerable: true, get: function () { return compose_js_1.composeLens; } });
+var attach_js_1 = require("./attach.js");
+Object.defineProperty(exports, "attachObservabilityStrategy", { enumerable: true, get: function () { return attach_js_1.attachObservabilityStrategy; } });
+Object.defineProperty(exports, "attachCostStrategy", { enumerable: true, get: function () { return attach_js_1.attachCostStrategy; } });
+Object.defineProperty(exports, "attachLiveStatusStrategy", { enumerable: true, get: function () { return attach_js_1.attachLiveStatusStrategy; } });
+//# sourceMappingURL=index.js.map

package/dist/strategies/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/strategies/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;;;;;;;;;;;;;;;;;AAEH,6CAA2B;AAC3B,sDAAoC;AACpC,2CAAiG;AAAxF,kHAAA,oBAAoB,OAAA;AAAE,yGAAA,WAAW,OAAA;AAAE,+GAAA,iBAAiB,OAAA;AAAE,yGAAA,WAAW,OAAA;AAC1E,yCAOqB;AANnB,wHAAA,2BAA2B,OAAA;AAC3B,+GAAA,kBAAkB,OAAA;AAClB,qHAAA,wBAAwB,OAAA"}

package/dist/strategies/registry.js

@@ -0,0 +1,118 @@
+"use strict";
+/**
+ * Strategy registry — name → factory for each of the 4 groups.
+ *
+ * Mirrors `src/cache/strategyRegistry.ts` exactly: maps a string name
+ * to a factory function that takes vendor-specific config and returns
+ * a typed strategy instance. Vendor adapter subpaths self-register on
+ * import via side-effect.
+ *
+ * Two ways consumers wire a strategy:
+ *
+ *   1. By NAME (registry lookup) — the recommended path for vendor
+ *      adapters:
+ *        ```ts
+ *        import 'agentfootprint/observability-datadog';  // self-registers 'datadog'
+ *        agent.enable.observability({ vendor: 'datadog', config: { apiKey } });
+ *        ```
+ *
+ *   2. By INSTANCE (explicit pass) — for custom in-house strategies
+ *      or test mocks:
+ *        ```ts
+ *        agent.enable.observability({ strategy: myCustomStrategy });
+ *        ```
+ *
+ * The two paths are mutually exclusive in `EnableOptions` — the type
+ * union enforces that consumers pick one.
+ *
+ * Lookup is exact-match by name (case-insensitive fallback). Unknown
+ * names return `undefined`; the consumer's `enable.X` then no-ops
+ * (per "do nothing if not configured" rule).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._resetRegistriesForTests = exports.listLensStrategies = exports.getLensStrategy = exports.registerLensStrategy = exports.listLiveStatusStrategies = exports.getLiveStatusStrategy = exports.registerLiveStatusStrategy = exports.listCostStrategies = exports.getCostStrategy = exports.registerCostStrategy = exports.listObservabilityStrategies = exports.getObservabilityStrategy = exports.registerObservabilityStrategy = void 0;
+// ─── 4 registries (one per group) ────────────────────────────────────
+const OBSERVABILITY_REGISTRY = new Map();
+const COST_REGISTRY = new Map();
+const LIVE_STATUS_REGISTRY = new Map();
+const LENS_REGISTRY = new Map();
+// ─── Register / lookup / list — observability ────────────────────────
+/**
+ * Register a vendor observability strategy by name. Called from the
+ * vendor's subpath at module load (side-effect import):
+ *
+ *   ```ts
+ *   // agentfootprint/observability-datadog/index.ts
+ *   import { registerObservabilityStrategy } from 'agentfootprint/strategies';
+ *   registerObservabilityStrategy('datadog', (config) => datadogObservability(config));
+ *   ```
+ *
+ * Replacing an existing registration is allowed — most-recent wins.
+ * Useful for test mocks.
+ */
+function registerObservabilityStrategy(name, factory) {
+    OBSERVABILITY_REGISTRY.set(name, factory);
+}
+exports.registerObservabilityStrategy = registerObservabilityStrategy;
+/** Look up an observability factory by vendor name. Case-insensitive
+ *  fallback. Returns `undefined` when the name is unknown — caller
+ *  decides to noop or throw. */
+function getObservabilityStrategy(name) {
+    return OBSERVABILITY_REGISTRY.get(name) ?? OBSERVABILITY_REGISTRY.get(name.toLowerCase());
+}
+exports.getObservabilityStrategy = getObservabilityStrategy;
+/** Diagnostic — list all registered vendor names. */
+function listObservabilityStrategies() {
+    return [...OBSERVABILITY_REGISTRY.keys()];
+}
+exports.listObservabilityStrategies = listObservabilityStrategies;
+// ─── Cost ────────────────────────────────────────────────────────────
+function registerCostStrategy(name, factory) {
+    COST_REGISTRY.set(name, factory);
+}
+exports.registerCostStrategy = registerCostStrategy;
+function getCostStrategy(name) {
+    return COST_REGISTRY.get(name) ?? COST_REGISTRY.get(name.toLowerCase());
+}
+exports.getCostStrategy = getCostStrategy;
+function listCostStrategies() {
+    return [...COST_REGISTRY.keys()];
+}
+exports.listCostStrategies = listCostStrategies;
+// ─── Live status ─────────────────────────────────────────────────────
+function registerLiveStatusStrategy(name, factory) {
+    LIVE_STATUS_REGISTRY.set(name, factory);
+}
+exports.registerLiveStatusStrategy = registerLiveStatusStrategy;
+function getLiveStatusStrategy(name) {
+    return LIVE_STATUS_REGISTRY.get(name) ?? LIVE_STATUS_REGISTRY.get(name.toLowerCase());
+}
+exports.getLiveStatusStrategy = getLiveStatusStrategy;
+function listLiveStatusStrategies() {
+    return [...LIVE_STATUS_REGISTRY.keys()];
+}
+exports.listLiveStatusStrategies = listLiveStatusStrategies;
+// ─── Lens ────────────────────────────────────────────────────────────
+function registerLensStrategy(name, factory) {
+    LENS_REGISTRY.set(name, factory);
+}
+exports.registerLensStrategy = registerLensStrategy;
+function getLensStrategy(name) {
+    return LENS_REGISTRY.get(name) ?? LENS_REGISTRY.get(name.toLowerCase());
+}
+exports.getLensStrategy = getLensStrategy;
+function listLensStrategies() {
+    return [...LENS_REGISTRY.keys()];
+}
+exports.listLensStrategies = listLensStrategies;
+// ─── Test helpers ────────────────────────────────────────────────────
+/** Reset every registry to empty. Tests only — not in the public
+ *  barrel. */
+function _resetRegistriesForTests() {
+    OBSERVABILITY_REGISTRY.clear();
+    COST_REGISTRY.clear();
+    LIVE_STATUS_REGISTRY.clear();
+    LENS_REGISTRY.clear();
+}
+exports._resetRegistriesForTests = _resetRegistriesForTests;
+//# sourceMappingURL=registry.js.map

package/dist/strategies/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/strategies/registry.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;;;AAmBH,wEAAwE;AAExE,MAAM,sBAAsB,GAAG,IAAI,GAAG,EAAgC,CAAC;AACvE,MAAM,aAAa,GAAG,IAAI,GAAG,EAAuB,CAAC;AACrD,MAAM,oBAAoB,GAAG,IAAI,GAAG,EAA6B,CAAC;AAClE,MAAM,aAAa,GAAG,IAAI,GAAG,EAAuB,CAAC;AAErD,wEAAwE;AAExE;;;;;;;;;;;;GAYG;AACH,SAAgB,6BAA6B,CAAC,IAAY,EAAE,OAA6B;IACvF,sBAAsB,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC;AAFD,sEAEC;AAED;;gCAEgC;AAChC,SAAgB,wBAAwB,CAAC,IAAY;IACnD,OAAO,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;AAC5F,CAAC;AAFD,4DAEC;AAED,qDAAqD;AACrD,SAAgB,2BAA2B;IACzC,OAAO,CAAC,GAAG,sBAAsB,CAAC,IAAI,EAAE,CAAC,CAAC;AAC5C,CAAC;AAFD,kEAEC;AAED,wEAAwE;AAExE,SAAgB,oBAAoB,CAAC,IAAY,EAAE,OAAoB;IACrE,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACnC,CAAC;AAFD,oDAEC;AAED,SAAgB,eAAe,CAAC,IAAY;IAC1C,OAAO,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;AAC1E,CAAC;AAFD,0CAEC;AAED,SAAgB,kBAAkB;IAChC,OAAO,CAAC,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC;AACnC,CAAC;AAFD,gDAEC;AAED,wEAAwE;AAExE,SAAgB,0BAA0B,CAAC,IAAY,EAAE,OAA0B;IACjF,oBAAoB,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAFD,gEAEC;AAED,SAAgB,qBAAqB,CAAC,IAAY;IAChD,OAAO,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;AACxF,CAAC;AAFD,sDAEC;AAED,SAAgB,wBAAwB;IACtC,OAAO,CAAC,GAAG,oBAAoB,CAAC,IAAI,EAAE,CAAC,CAAC;AAC1C,CAAC;AAFD,4DAEC;AAED,wEAAwE;AAExE,SAAgB,oBAAoB,CAAC,IAAY,EAAE,OAAoB;IACrE,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACnC,CAAC;AAFD,oDAEC;AAED,SAAgB,eAAe,CAAC,IAAY;IAC1C,OAAO,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;AAC1E,CAAC;AAFD,0CAEC;AAED,SAAgB,kBAAkB;IAChC,OAAO,CAAC,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC;AACnC,CAAC;AAFD,gDAEC;AAED,wEAAwE;AAExE;cACc;AACd,SAAgB,wBAAwB;IACtC,sBAAsB,CAAC,KAAK,EAAE,CAAC;IAC/B,aAAa,CAAC,KAAK,EAAE,CAAC;IACtB,oBAAoB,CAAC,KAAK,EAAE,CAAC;IAC7B,aAAa,CAAC,KAAK,EAAE,CAAC;AACxB,CAAC;AALD,4DAKC"}

package/dist/strategies/types.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * Strategy interface types for the v2.8 grouped-enabler architecture.
+ *
+ * Pattern: Strategy + Bridge + Hexagonal port. See the design memo
+ *          `docs/inspiration/strategy-everywhere.md`.
+ *
+ * Four groups, four typed strategy interfaces. Each follows the same
+ * shape (one canonical contract, locked at the type level):
+ *
+ *   1. `name: string`            — registry key for auto-registration
+ *   2. `capabilities: {...}`     — what this strategy supports
+ *   3. `onEvent(...)`            — hot path; sync, side-effect-only
+ *   4. `flush?(): Promise<void>` — optional batch flushing
+ *   5. `stop?(): void`           — optional teardown
+ *
+ * Design constraints (from the panel review):
+ *   - **PASSIVE / non-blocking by construction.** Strategies are
+ *     observers — they NEVER block the agent loop. Async work
+ *     (HTTP shipment, disk I/O, batching) is the STRATEGY's internal
+ *     concern: buffer in `onEvent` (sync), drain in `flush()` (async
+ *     OK). The dispatcher never awaits a strategy's `onEvent`.
+ *   - `onEvent` MUST be sync `void`. MUST NOT throw. Errors caught +
+ *     routed to `_onError` at the dispatch layer; one bad strategy
+ *     never breaks the agent loop.
+ *   - Idempotent registration — registering the same `name` twice
+ *     replaces, doesn't double-fire.
+ *   - `stop()` is idempotent — halts everything that strategy enabled,
+ *     nothing else, calling twice is a no-op.
+ *   - `flush()` is optional, may be sync OR async — strategies that
+ *     don't batch can omit it. Consumer's `agent.run()` lifecycle
+ *     calls flush at boundary points (turn end, run end) so batched
+ *     strategies don't lose tail events. Flush is the ONLY async
+ *     path; the hot path is always sync.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/strategies/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/strategies/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG"}

package/dist/types/adapters/observability/agentcore.d.ts

@@ -0,0 +1,86 @@
+/**
+ * agentcoreObservability — AWS Bedrock AgentCore observability adapter.
+ *
+ * Ships every `AgentfootprintEvent` to **CloudWatch Logs** in a
+ * structured-JSON shape AgentCore's hosted-agent telemetry layer
+ * understands. Use when:
+ *
+ *   1. Your agent runs INSIDE AgentCore — events show up alongside
+ *      AgentCore's own runtime telemetry in the same log group.
+ *   2. Your agent runs OUTSIDE AgentCore but you want to query agent
+ *      behavior in CloudWatch Insights / X-Ray traces using the same
+ *      schema AgentCore uses internally.
+ *
+ * Subpath:  `agentfootprint/observability-providers`
+ * Peer dep: `@aws-sdk/client-cloudwatch-logs` (OPTIONAL — installed
+ *           only when this adapter is used; declared via
+ *           `peerDependenciesMeta.{name}.optional = true`).
+ *
+ * Pattern: Adapter (GoF) — translates `AgentfootprintEvent` →
+ *          CloudWatch Logs `PutLogEvents` payloads. Buffers in
+ *          `exportEvent()` (sync, non-throwing); flushes in `flush()`
+ *          (async batch). Default flush window: 1s OR 10 KB,
+ *          whichever first — matches CloudWatch's own optimal batch.
+ *
+ * @example Basic
+ * ```ts
+ * import { agentcoreObservability } from 'agentfootprint/observability-providers';
+ * import { microtaskBatchDriver } from 'footprintjs/detach';
+ *
+ * agent.enable.observability({
+ *   strategy: agentcoreObservability({
+ *     region: 'us-east-1',
+ *     logGroupName: '/agentfootprint/my-agent',
+ *     logStreamName: `${process.env.HOSTNAME}/${Date.now()}`,
+ *   }),
+ *   detach: { driver: microtaskBatchDriver, mode: 'forget' },
+ * });
+ * ```
+ *
+ * @example Test injection (skip SDK require entirely)
+ * ```ts
+ * agentcoreObservability({
+ *   _client: {
+ *     putLogEvents: async (input) => { capturedBatches.push(input); },
+ *   },
+ * });
+ * ```
+ */
+import type { ObservabilityStrategy } from '../../strategies/types.js';
+export interface AgentcoreObservabilityOptions {
+    /** AWS region. Falls back to AWS_REGION / AWS_DEFAULT_REGION env. */
+    readonly region?: string;
+    /** CloudWatch Logs log group. **Required.** Must exist or your IAM
+     *  role must allow `logs:CreateLogGroup`. */
+    readonly logGroupName: string;
+    /** CloudWatch Logs log stream within the group. Conventionally
+     *  `<host>/<startTime>` so multi-instance deployments don't collide.
+     *  Created on first put if it doesn't exist (or your role must
+     *  allow `logs:CreateLogStream`). Defaults to `agentfootprint`. */
+    readonly logStreamName?: string;
+    /** Max events buffered before forced flush. Default 100. */
+    readonly maxBatchEvents?: number;
+    /** Max payload bytes (UTF-8) buffered before forced flush. Default
+     *  10240 (10 KB). CloudWatch hard caps at 1 MB / batch but we keep
+     *  the default low so latency stays bounded. */
+    readonly maxBatchBytes?: number;
+    /** Forced-flush interval when traffic is sparse. Default 1000ms.
+     *  `0` disables time-based flush — only size triggers fire. */
+    readonly flushIntervalMs?: number;
+    /** Test injection — bypasses SDK lazy-require entirely. When set,
+     *  `region` / IAM are ignored. */
+    readonly _client?: CloudWatchLikeClient;
+}
+interface CloudWatchLikeClient {
+    putLogEvents(input: {
+        logGroupName: string;
+        logStreamName: string;
+        logEvents: ReadonlyArray<{
+            timestamp: number;
+            message: string;
+        }>;
+    }): Promise<unknown>;
+}
+export declare function agentcoreObservability(opts: AgentcoreObservabilityOptions): ObservabilityStrategy;
+export {};
+//# sourceMappingURL=agentcore.d.ts.map

package/dist/types/adapters/observability/agentcore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentcore.d.ts","sourceRoot":"","sources":["../../../../src/adapters/observability/agentcore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAIH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAIvE,MAAM,WAAW,6BAA6B;IAC5C,qEAAqE;IACrE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;iDAC6C;IAC7C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B;;;uEAGmE;IACnE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,4DAA4D;IAC5D,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC;;oDAEgD;IAChD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC;mEAC+D;IAC/D,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC;sCACkC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC;CACzC;AAID,UAAU,oBAAoB;IAC5B,YAAY,CAAC,KAAK,EAAE;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,aAAa,CAAC;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAClE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtB;AAUD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,6BAA6B,GAAG,qBAAqB,CA8GjG"}

package/dist/types/core/RunnerBase.d.ts.map

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

package/dist/types/core/runner.d.ts

@@ -19,15 +19,22 @@ import type { AgentfootprintEvent, AgentfootprintEventType } from '../events/reg
 import type { LoggingOptions } from '../recorders/observability/LoggingRecorder.js';
 import type { ThinkingOptions } from '../recorders/observability/ThinkingRecorder.js';
 import type { FlowchartHandle, FlowchartOptions } from '../recorders/observability/FlowchartRecorder.js';
+import type { ObservabilityEnableOptions, CostEnableOptions, LiveStatusEnableOptions } from '../strategies/attach.js';
 /**
  * High-level feature-enable methods. Each attaches a pre-built observability
  * recorder and returns an Unsubscribe function. Additional methods land in
  * Phase 5 (lens, tracing, cost, guardrails, ...).
  */
 export interface EnableNamespace {
-    /** Claude-Code-style live status line. */
+    /**
+     * @deprecated v2.8 — use `enable.liveStatus({ strategy: chatBubbleLiveStatus({onLine}) })`.
+     * Kept for back-compat; removed in v3.0.
+     */
     thinking(opts: ThinkingOptions): Unsubscribe;
-    /** Firehose-style structured logging of every event. */
+    /**
+     * @deprecated v2.8 — use `enable.observability({ strategy: pinoObservability({...}) })`
+     * or another vendor strategy. Kept for back-compat; removed in v3.0.
+     */
     logging(opts?: LoggingOptions): Unsubscribe;
     /**
      * Live composition graph — subflow / fork-branch / decision-branch
@@ -39,6 +46,26 @@ export interface EnableNamespace {
      * at any time (not just via onUpdate).
      */
     flowchart(opts?: FlowchartOptions): FlowchartHandle;
+    /**
+     * v2.8+ — grouped strategy enabler for observability. Pipes every
+     * typed event into a vendor strategy (Datadog, OTel, AgentCore,
+     * CloudWatch, …) or the default `consoleObservability()`. See
+     * `agentfootprint/strategies` + `docs/inspiration/strategy-everywhere.md`.
+     */
+    observability(opts?: ObservabilityEnableOptions): Unsubscribe;
+    /**
+     * v2.8+ — grouped strategy enabler for cost. Subscribes the strategy
+     * to `cost.tick` events; defaults to `inMemorySinkCost()` for
+     * read-back / test inspection.
+     */
+    cost(opts?: CostEnableOptions): Unsubscribe;
+    /**
+     * v2.8+ — grouped strategy enabler for chat-bubble live status.
+     * Maintains the thinking-state machine; calls strategy.renderStatus
+     * each time the rendered line changes (deduped — not on every token).
+     * Strategy is required (consumer must wire UI).
+     */
+    liveStatus(opts: LiveStatusEnableOptions): Unsubscribe;
 }
 /**
  * Every primitive (LLMCall, Agent), every composition (Sequence, Parallel,