agentfootprint 2.8.1 → 2.8.3

package/dist/esm/adapters/observability/cloudwatch.js

@@ -0,0 +1,198 @@
+/**
+ * cloudwatchObservability — Generic AWS CloudWatch Logs adapter.
+ *
+ * Ships every `AgentfootprintEvent` to a CloudWatch Logs stream. Use
+ * when you want agent telemetry alongside the rest of your AWS
+ * observability stack — CloudWatch Insights queries, alarms,
+ * cross-service correlation. Same SDK as `agentcoreObservability`
+ * but **without** the AgentCore-specific defaults (log-stream
+ * convention, format opinions). Use this when:
+ *
+ *   1. You're shipping to CloudWatch but NOT running inside Bedrock
+ *      AgentCore (most common case).
+ *   2. You want full control over log group / stream / format and
+ *      don't need AgentCore's hosted-agent telemetry conventions.
+ *
+ * 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`).
+ *
+ * This module also exports the underlying base function used by
+ * `agentcoreObservability` — keeps the per-event hot path in one
+ * place so improvements (batching, retry, backpressure) flow to
+ * every CloudWatch-shaped adapter automatically.
+ *
+ * @example
+ * ```ts
+ * import { cloudwatchObservability } from 'agentfootprint/observability-providers';
+ * import { microtaskBatchDriver } from 'footprintjs/detach';
+ *
+ * agent.enable.observability({
+ *   strategy: cloudwatchObservability({
+ *     region: 'us-east-1',
+ *     logGroupName: '/myapp/agent-prod',
+ *     logStreamName: `${process.env.HOSTNAME}/${Date.now()}`,
+ *   }),
+ *   detach: { driver: microtaskBatchDriver, mode: 'forget' },
+ * });
+ * ```
+ */
+import { lazyRequire } from '../../lib/lazyRequire.js';
+// ─── Generic base — also used by agentcoreObservability ──────────────
+/**
+ * Internal: shared CloudWatch Logs base used by every adapter that
+ * ships to CWL. `cloudwatchObservability` is the public generic
+ * factory; `agentcoreObservability` calls this with AgentCore-flavored
+ * defaults.
+ *
+ * Exported for adapter authors only — consumers should call
+ * `cloudwatchObservability` or `agentcoreObservability` directly.
+ *
+ * @internal
+ */
+export function _buildCloudWatchObservability(opts, strategyName) {
+    if (!opts.logGroupName) {
+        throw new TypeError(`[${strategyName}Observability] \`logGroupName\` is required. ` +
+            `Pass an existing CloudWatch log group, e.g. '/myapp/agent-prod'.`);
+    }
+    const logStreamName = opts.logStreamName ?? 'agentfootprint';
+    const maxBatchEvents = opts.maxBatchEvents ?? 100;
+    const maxBatchBytes = opts.maxBatchBytes ?? 10_240;
+    const flushIntervalMs = opts.flushIntervalMs ?? 1000;
+    // Buffered batch — drained by `flush()` / size-trigger / time-trigger.
+    const buffer = [];
+    let bufferBytes = 0;
+    let lastFlushPromise = Promise.resolve();
+    let timer;
+    let stopped = false;
+    let onErrorHook;
+    // Lazy-resolved on first flush so consumers who never trigger a
+    // flush (because nothing was emitted) don't even hit the SDK.
+    let client = opts._client;
+    function ensureClient() {
+        if (client)
+            return client;
+        client = createCloudWatchClient(opts.region, strategyName);
+        return client;
+    }
+    function scheduleTimedFlush() {
+        if (timer || flushIntervalMs <= 0 || stopped)
+            return;
+        timer = setTimeout(() => {
+            timer = undefined;
+            void doFlush();
+        }, flushIntervalMs);
+    }
+    async function doFlush() {
+        if (buffer.length === 0 || stopped)
+            return;
+        // Snapshot + clear so concurrent emits during the in-flight put
+        // accumulate into the next batch.
+        const batch = buffer.splice(0);
+        bufferBytes = 0;
+        try {
+            await ensureClient().putLogEvents({
+                logGroupName: opts.logGroupName,
+                logStreamName,
+                logEvents: batch,
+            });
+        }
+        catch (err) {
+            onErrorHook?.(err instanceof Error ? err : new Error(String(err)));
+        }
+    }
+    function enqueue(event) {
+        if (stopped)
+            return;
+        const message = JSON.stringify(event);
+        const bytes = Buffer.byteLength(message, 'utf8');
+        buffer.push({ timestamp: Date.now(), message });
+        bufferBytes += bytes;
+        if (buffer.length >= maxBatchEvents || bufferBytes >= maxBatchBytes) {
+            // Size trigger — flush immediately. Chain onto last to preserve
+            // CloudWatch's per-stream ordering requirement.
+            lastFlushPromise = lastFlushPromise.then(doFlush, doFlush);
+        }
+        else {
+            scheduleTimedFlush();
+        }
+    }
+    return {
+        name: strategyName,
+        capabilities: { events: true, logs: true },
+        exportEvent: enqueue,
+        async flush() {
+            // Drain anything pending. Awaits both an in-flight put AND any
+            // newly-buffered events that arrived during it.
+            while (buffer.length > 0 || lastFlushPromise !== Promise.resolve()) {
+                const before = lastFlushPromise;
+                await before;
+                if (buffer.length > 0) {
+                    lastFlushPromise = doFlush();
+                }
+                // Loop one more pass if the chained doFlush() queued more
+                // work, then bail.
+                if (lastFlushPromise === before && buffer.length === 0)
+                    break;
+            }
+        },
+        stop() {
+            stopped = true;
+            if (timer) {
+                clearTimeout(timer);
+                timer = undefined;
+            }
+        },
+        _onError(err, event) {
+            // Capture for use inside doFlush (the strategy doesn't know what
+            // the consumer's error sink is unless they wire `_onError` via
+            // the strategy options. We store it on this hook so put-failures
+            // route correctly).
+            onErrorHook =
+                onErrorHook ??
+                    ((e) => {
+                        // eslint-disable-next-line no-console
+                        console.error(`[${strategyName}Observability] flush failed:`, e.message);
+                    });
+            onErrorHook(err, event);
+        },
+    };
+}
+// ─── Public factory: cloudwatchObservability ─────────────────────────
+/**
+ * Generic CloudWatch Logs observability adapter. See
+ * `CloudwatchObservabilityOptions` for the per-option contract.
+ *
+ * For AgentCore-specific conventions, use `agentcoreObservability`
+ * which thin-wraps this with AgentCore-flavored defaults.
+ */
+export function cloudwatchObservability(opts) {
+    return _buildCloudWatchObservability(opts, 'cloudwatch');
+}
+// ─── SDK client construction (lazy) ──────────────────────────────────
+function createCloudWatchClient(region, strategyName) {
+    let mod;
+    try {
+        mod = lazyRequire('@aws-sdk/client-cloudwatch-logs');
+    }
+    catch {
+        throw new Error(`[${strategyName}Observability] requires the \`@aws-sdk/client-cloudwatch-logs\` peer dependency.\n` +
+            `  Install:  npm install @aws-sdk/client-cloudwatch-logs\n` +
+            `  Or pass \`_client\` for test injection.`);
+    }
+    if (!mod.CloudWatchLogsClient || !mod.PutLogEventsCommand) {
+        throw new Error(`[${strategyName}Observability]: \`@aws-sdk/client-cloudwatch-logs\` is installed but ` +
+            `\`CloudWatchLogsClient\` / \`PutLogEventsCommand\` was not found. Update the SDK.`);
+    }
+    const sdkClient = new mod.CloudWatchLogsClient({ ...(region && { region }) });
+    return {
+        async putLogEvents(input) {
+            // Cast the SDK constructor to the call shape — same trick as
+            // the memory adapter to stay forward-compat with SDK shape drift.
+            const cmd = new mod.PutLogEventsCommand(input);
+            await sdkClient.send(cmd);
+        },
+    };
+}
+//# sourceMappingURL=cloudwatch.js.map

package/dist/esm/adapters/observability/cloudwatch.js.map

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

package/dist/esm/adapters/observability/xray.js

@@ -0,0 +1,366 @@
+/**
+ * xrayObservability — AWS X-Ray distributed-tracing adapter.
+ *
+ * Maps agentfootprint's event taxonomy onto AWS X-Ray segment trees:
+ *
+ *     agent.turn_start          ↦  root segment (one trace per turn)
+ *     agent.turn_end            ↦  close root segment + flush
+ *     agent.iteration_start     ↦  push subsegment under root
+ *     agent.iteration_end       ↦  close iteration subsegment
+ *     stream.llm_start          ↦  push leaf subsegment (model call)
+ *     stream.llm_end            ↦  close llm subsegment
+ *     stream.tool_start         ↦  push leaf subsegment (tool call)
+ *     stream.tool_end           ↦  close tool subsegment
+ *
+ * The result in the X-Ray Trace Map: a hierarchical timeline of every
+ * agent run — turn → iteration → llm-call/tool-call — queryable in
+ * X-Ray Insights, joinable with the rest of your AWS distributed
+ * trace via `AWSTraceHeader` propagation (consumer's responsibility
+ * to wire upstream/downstream IDs).
+ *
+ * Subpath:  `agentfootprint/observability-providers`
+ * Peer dep: `@aws-sdk/client-xray` (OPTIONAL — installed only when
+ *           this adapter is used).
+ *
+ * Sampling:
+ *   By default every turn produces one trace. Pass `sampleRate: 0.1`
+ *   to sample 10% of turns — sampling decisions are made at
+ *   `turn_start` and persist for the whole turn (so partial traces
+ *   never reach X-Ray).
+ *
+ * @example
+ * ```ts
+ * import { xrayObservability } from 'agentfootprint/observability-providers';
+ * import { microtaskBatchDriver } from 'footprintjs/detach';
+ *
+ * agent.enable.observability({
+ *   strategy: xrayObservability({
+ *     region: 'us-east-1',
+ *     serviceName: 'my-agent',
+ *     sampleRate: 0.1,                    // 10% sampling
+ *   }),
+ *   detach: { driver: microtaskBatchDriver, mode: 'forget' },
+ * });
+ * ```
+ *
+ * @example Test injection
+ * ```ts
+ * xrayObservability({
+ *   serviceName: 'test',
+ *   _client: {
+ *     putTraceSegments: async (input) => { capturedDocs.push(input); },
+ *   },
+ * });
+ * ```
+ */
+import { lazyRequire } from '../../lib/lazyRequire.js';
+// ─── Strategy factory ────────────────────────────────────────────────
+export function xrayObservability(opts) {
+    if (!opts.serviceName) {
+        throw new TypeError(`[xrayObservability] \`serviceName\` is required. ` +
+            `Pass an identifier visible in your X-Ray service map, e.g. 'my-agent-prod'.`);
+    }
+    const sampleRate = opts.sampleRate ?? 1;
+    const maxBatchSegments = opts.maxBatchSegments ?? 25;
+    const flushIntervalMs = opts.flushIntervalMs ?? 1000;
+    // Per-turn state. agentfootprint events arrive interleaved across
+    // multiple in-flight turns; we key the active stack by `runId`
+    // (every event payload carries it after enrichment).
+    const activeTurns = new Map();
+    // Outbound segment buffer (flat list of closed segments ready for
+    // PutTraceSegments). Drained by flush() / size-trigger / time-trigger.
+    const outbox = [];
+    let lastFlushPromise = Promise.resolve();
+    let timer;
+    let stopped = false;
+    let onErrorHook;
+    // Lazy SDK client.
+    let client = opts._client;
+    function ensureClient() {
+        if (client)
+            return client;
+        client = createXRayClient(opts.region);
+        return client;
+    }
+    function scheduleTimedFlush() {
+        if (timer || flushIntervalMs <= 0 || stopped)
+            return;
+        timer = setTimeout(() => {
+            timer = undefined;
+            void doFlush();
+        }, flushIntervalMs);
+    }
+    async function doFlush() {
+        if (outbox.length === 0 || stopped)
+            return;
+        const batch = outbox.splice(0, maxBatchSegments);
+        try {
+            await ensureClient().putTraceSegments({
+                TraceSegmentDocuments: batch.map((s) => JSON.stringify(s)),
+            });
+        }
+        catch (err) {
+            onErrorHook?.(err instanceof Error ? err : new Error(String(err)));
+        }
+        // If outbox grew during the put (size > maxBatchSegments emits
+        // arrived), chain another flush.
+        if (outbox.length > 0 && !stopped) {
+            lastFlushPromise = lastFlushPromise.then(doFlush, doFlush);
+        }
+    }
+    function pushSegment(turnState, name) {
+        const parent = turnState.stack[turnState.stack.length - 1];
+        const seg = {
+            name,
+            id: hexId(16),
+            trace_id: turnState.traceId,
+            ...(parent && { parent_id: parent.id }),
+            start_time: nowSeconds(),
+            in_progress: true,
+        };
+        turnState.stack.push(seg);
+        return seg;
+    }
+    function popSegment(turnState, expectedName) {
+        // Defensive: pop the topmost segment whose name matches (if
+        // provided). Out-of-order events would otherwise leave dangling
+        // segments. If no match, pop the topmost.
+        let idx = turnState.stack.length - 1;
+        if (expectedName) {
+            while (idx >= 0 && turnState.stack[idx].name !== expectedName)
+                idx--;
+        }
+        if (idx < 0)
+            return undefined;
+        const seg = turnState.stack.splice(idx, 1)[0];
+        seg.end_time = nowSeconds();
+        delete seg.in_progress;
+        return seg;
+    }
+    function closeSegment(turnState, expectedName, extra) {
+        const seg = popSegment(turnState, expectedName);
+        if (!seg)
+            return;
+        if (extra?.error)
+            seg.error = true;
+        if (extra?.annotations)
+            seg.annotations = { ...seg.annotations, ...extra.annotations };
+        if (extra?.metadata)
+            seg.metadata = { default: { ...(seg.metadata?.default ?? {}), ...extra.metadata } };
+        if (turnState.sampled) {
+            turnState.closed.push(seg);
+            // Once the root closes, the whole turn graduates to outbox.
+            if (turnState.stack.length === 0) {
+                outbox.push(...turnState.closed);
+                if (outbox.length >= maxBatchSegments) {
+                    lastFlushPromise = lastFlushPromise.then(doFlush, doFlush);
+                }
+                else {
+                    scheduleTimedFlush();
+                }
+            }
+        }
+    }
+    // ─── Event-to-segment dispatch ─────────────────────────────────────
+    function handleEvent(event) {
+        if (stopped)
+            return;
+        const runId = event.payload?.runId;
+        if (!runId)
+            return; // Events without a turn anchor — skip.
+        switch (event.type) {
+            case 'agentfootprint.agent.turn_start': {
+                const sampled = sampleRate >= 1 || Math.random() < sampleRate;
+                const turnState = {
+                    traceId: makeTraceId(),
+                    stack: [],
+                    closed: [],
+                    sampled,
+                };
+                activeTurns.set(runId, turnState);
+                if (sampled)
+                    pushSegment(turnState, opts.serviceName);
+                break;
+            }
+            case 'agentfootprint.agent.turn_end': {
+                const t = activeTurns.get(runId);
+                if (!t)
+                    break;
+                // Close everything still on the stack — defensive against
+                // missing `_end` events (e.g., pause/resume mid-turn).
+                while (t.stack.length > 0)
+                    closeSegment(t, undefined);
+                activeTurns.delete(runId);
+                break;
+            }
+            case 'agentfootprint.agent.iteration_start': {
+                const t = activeTurns.get(runId);
+                if (t?.sampled)
+                    pushSegment(t, `iteration:${event.payload.iteration ?? '?'}`);
+                break;
+            }
+            case 'agentfootprint.agent.iteration_end': {
+                const t = activeTurns.get(runId);
+                if (t?.sampled)
+                    closeSegment(t, undefined);
+                break;
+            }
+            case 'agentfootprint.stream.llm_start': {
+                const t = activeTurns.get(runId);
+                if (!t?.sampled)
+                    break;
+                const seg = pushSegment(t, 'llm');
+                const model = event.payload.model;
+                if (model)
+                    seg.annotations = { model };
+                break;
+            }
+            case 'agentfootprint.stream.llm_end': {
+                const t = activeTurns.get(runId);
+                if (!t?.sampled)
+                    break;
+                closeSegment(t, 'llm', {
+                    metadata: { event: event.payload },
+                });
+                break;
+            }
+            case 'agentfootprint.stream.tool_start': {
+                const t = activeTurns.get(runId);
+                if (!t?.sampled)
+                    break;
+                const toolName = event.payload.toolName ?? 'tool';
+                const seg = pushSegment(t, `tool:${toolName}`);
+                seg.annotations = { toolName };
+                break;
+            }
+            case 'agentfootprint.stream.tool_end': {
+                const t = activeTurns.get(runId);
+                if (!t?.sampled)
+                    break;
+                const toolName = event.payload.toolName;
+                closeSegment(t, toolName ? `tool:${toolName}` : undefined, {
+                    error: event.payload.error !== undefined,
+                });
+                break;
+            }
+            // Other events become annotations on the topmost active segment
+            // (cheaper than spawning a subsegment per event).
+            default: {
+                const t = activeTurns.get(runId);
+                const top = t?.stack[t.stack.length - 1];
+                if (!t?.sampled || !top)
+                    break;
+                // Annotate cost ticks specially so they're queryable in
+                // X-Ray Insights.
+                if (event.type === 'agentfootprint.cost.tick') {
+                    const p = event.payload;
+                    if (typeof p.cumulativeCostUsd === 'number') {
+                        top.annotations = { ...top.annotations, cumulativeCostUsd: p.cumulativeCostUsd };
+                    }
+                }
+                break;
+            }
+        }
+    }
+    return {
+        name: 'xray',
+        capabilities: { events: true, traces: true },
+        exportEvent: handleEvent,
+        async flush() {
+            // Force-close any in-flight turn segments so partial traces
+            // make it into X-Ray on shutdown.
+            for (const [, t] of activeTurns) {
+                if (!t.sampled)
+                    continue;
+                while (t.stack.length > 0)
+                    closeSegment(t, undefined);
+            }
+            while (outbox.length > 0) {
+                const before = lastFlushPromise;
+                await before;
+                if (outbox.length > 0) {
+                    lastFlushPromise = doFlush();
+                }
+                if (lastFlushPromise === before && outbox.length === 0)
+                    break;
+            }
+        },
+        stop() {
+            stopped = true;
+            if (timer) {
+                clearTimeout(timer);
+                timer = undefined;
+            }
+        },
+        _onError(err, event) {
+            onErrorHook =
+                onErrorHook ??
+                    ((e) => {
+                        // eslint-disable-next-line no-console
+                        console.error(`[xrayObservability] flush failed:`, e.message);
+                    });
+            onErrorHook(err, event);
+        },
+    };
+}
+// ─── ID + time helpers ───────────────────────────────────────────────
+/**
+ * Generate an X-Ray trace ID. Format:
+ *   `1-{8-hex-of-unix-timestamp}-{24-hex-random}`
+ * (Note X-Ray's docs say "12 hex" for the random part; the actual
+ * spec is 24 hex / 96-bit. AWS examples use 24.)
+ */
+function makeTraceId() {
+    const seconds = Math.floor(Date.now() / 1000);
+    return `1-${seconds.toString(16).padStart(8, '0')}-${hexId(24)}`;
+}
+/** Generate a hex string of `len` chars, cryptographically-strong
+ *  where available, falling back to Math.random for environments
+ *  without `crypto.getRandomValues` (older runtimes). */
+function hexId(len) {
+    const bytes = Math.ceil(len / 2);
+    // Try the Web Crypto / Node Crypto API first.
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const cryptoApi = globalThis.crypto;
+    if (cryptoApi?.getRandomValues) {
+        const buf = new Uint8Array(bytes);
+        cryptoApi.getRandomValues(buf);
+        return Array.from(buf, (b) => b.toString(16).padStart(2, '0'))
+            .join('')
+            .slice(0, len);
+    }
+    // Fallback (deterministic-quality, NOT for security-critical IDs —
+    // X-Ray IDs aren't security boundaries, just trace correlation).
+    let s = '';
+    while (s.length < len)
+        s += Math.random().toString(16).slice(2);
+    return s.slice(0, len);
+}
+/** X-Ray timestamps are unix seconds with fractional precision. */
+function nowSeconds() {
+    return Date.now() / 1000;
+}
+// ─── SDK construction (lazy) ─────────────────────────────────────────
+function createXRayClient(region) {
+    let mod;
+    try {
+        mod = lazyRequire('@aws-sdk/client-xray');
+    }
+    catch {
+        throw new Error('xrayObservability requires the `@aws-sdk/client-xray` peer dependency.\n' +
+            '  Install:  npm install @aws-sdk/client-xray\n' +
+            '  Or pass `_client` for test injection.');
+    }
+    if (!mod.XRayClient || !mod.PutTraceSegmentsCommand) {
+        throw new Error('xrayObservability: `@aws-sdk/client-xray` is installed but `XRayClient` / ' +
+            '`PutTraceSegmentsCommand` was not found. Update the SDK.');
+    }
+    const sdkClient = new mod.XRayClient({ ...(region && { region }) });
+    return {
+        async putTraceSegments(input) {
+            const cmd = new mod.PutTraceSegmentsCommand(input);
+            await sdkClient.send(cmd);
+        },
+    };
+}
+//# sourceMappingURL=xray.js.map

package/dist/esm/adapters/observability/xray.js.map

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

package/dist/esm/observability-providers.js

@@ -27,11 +27,13 @@
  * ```
  *
  * Roadmap:
- *   - agentcoreObservability   ← v2.8.1 (this release)
+ *   - agentcoreObservability   ← v2.8.1
  *   - cloudwatchObservability  ← v2.8.2
- *   - xrayObservability        ← v2.8.3
+ *   - xrayObservability        ← v2.8.3 (this release)
  *   - otelObservability        ← v2.9.x
  *   - datadogObservability     ← v2.9.x
  */
 export { agentcoreObservability, } from './adapters/observability/agentcore.js';
+export { cloudwatchObservability, } from './adapters/observability/cloudwatch.js';
+export { xrayObservability, } from './adapters/observability/xray.js';
 //# sourceMappingURL=observability-providers.js.map

package/dist/esm/observability-providers.js.map

@@ -1 +1 @@
-{"version":3,"file":"observability-providers.js","sourceRoot":"","sources":["../../src/observability-providers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EACL,sBAAsB,GAEvB,MAAM,uCAAuC,CAAC"}
+{"version":3,"file":"observability-providers.js","sourceRoot":"","sources":["../../src/observability-providers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EACL,sBAAsB,GAEvB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,uBAAuB,GAExB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,iBAAiB,GAGlB,MAAM,kCAAkC,CAAC"}

package/dist/observability-providers.js

@@ -28,14 +28,18 @@
  * ```
  *
  * Roadmap:
- *   - agentcoreObservability   ← v2.8.1 (this release)
+ *   - agentcoreObservability   ← v2.8.1
  *   - cloudwatchObservability  ← v2.8.2
- *   - xrayObservability        ← v2.8.3
+ *   - xrayObservability        ← v2.8.3 (this release)
  *   - otelObservability        ← v2.9.x
  *   - datadogObservability     ← v2.9.x
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.agentcoreObservability = void 0;
+exports.xrayObservability = exports.cloudwatchObservability = exports.agentcoreObservability = void 0;
 var agentcore_js_1 = require("./adapters/observability/agentcore.js");
 Object.defineProperty(exports, "agentcoreObservability", { enumerable: true, get: function () { return agentcore_js_1.agentcoreObservability; } });
+var cloudwatch_js_1 = require("./adapters/observability/cloudwatch.js");
+Object.defineProperty(exports, "cloudwatchObservability", { enumerable: true, get: function () { return cloudwatch_js_1.cloudwatchObservability; } });
+var xray_js_1 = require("./adapters/observability/xray.js");
+Object.defineProperty(exports, "xrayObservability", { enumerable: true, get: function () { return xray_js_1.xrayObservability; } });
 //# sourceMappingURL=observability-providers.js.map

package/dist/observability-providers.js.map

@@ -1 +1 @@
-{"version":3,"file":"observability-providers.js","sourceRoot":"","sources":["../src/observability-providers.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;;;AAEH,sEAG+C;AAF7C,sHAAA,sBAAsB,OAAA"}
+{"version":3,"file":"observability-providers.js","sourceRoot":"","sources":["../src/observability-providers.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;;;AAEH,sEAG+C;AAF7C,sHAAA,sBAAsB,OAAA;AAGxB,wEAGgD;AAF9C,wHAAA,uBAAuB,OAAA;AAGzB,4DAI0C;AAHxC,4GAAA,iBAAiB,OAAA"}