@strands-agents/sdk 1.6.0 → 1.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@strands-agents/sdk",
-  "version": "1.6.0",
+  "version": "1.8.0",
   "description": "TypeScript SDK for Strands Agents framework",
   "main": "dist/src/index.js",
   "module": "dist/src/index.js",
@@ -12,6 +12,9 @@
   ],
   "files": [
     "dist",
+    "!dist/**/__tests__",
+    "!dist/**/__fixtures__",
+    "!dist/**/*.test.*",
     "README.md",
     "LICENSE"
   ],
@@ -77,6 +80,10 @@
       "types": "./dist/src/vended-memory-stores/bedrock-knowledge-base/index.d.ts",
       "default": "./dist/src/vended-memory-stores/bedrock-knowledge-base/index.js"
     },
+    "./vended-memory-stores/local": {
+      "types": "./dist/src/vended-memory-stores/local/index.d.ts",
+      "default": "./dist/src/vended-memory-stores/local/index.js"
+    },
     "./telemetry": {
       "types": "./dist/src/telemetry/index.d.ts",
       "default": "./dist/src/telemetry/index.js"
@@ -148,7 +155,7 @@
     "test:browser:install": "npx playwright install --with-deps chromium",
     "test:all": "vitest run --project unit-node --project unit-browser",
     "test:all:coverage": "vitest run --coverage --project unit-node --project unit-browser",
-    "test:package": "cd test/packages/esm-module && npm install && node esm.js && cd ../cjs-module && npm install && node cjs.js",
+    "test:package": "npm run build && cd test/packages/esm-module && npm install && node esm.js && cd ../cjs-module && npm install && node cjs.js && cd ../../.. && npm pack --dry-run --ignore-scripts --json | node test/packages/assert-package-contents.js",
     "lint": "eslint src test/integ",
     "lint:fix": "eslint src test/integ --fix",
     "format": "prettier --write src test/integ",
@@ -167,46 +174,46 @@
   "license": "Apache-2.0",
   "devDependencies": {
     "@a2a-js/sdk": "^0.3.10",
-    "@ai-sdk/amazon-bedrock": "^4.0.77",
+    "@ai-sdk/amazon-bedrock": "^4.0.128",
     "@ai-sdk/openai": "^3.0.41",
     "@ai-sdk/provider": "^3.0.0",
-    "@anthropic-ai/sdk": "^0.92.0",
-    "@aws-sdk/client-bedrock": "^3.943.0",
-    "@aws-sdk/client-bedrock-agent": "^3.943.0",
-    "@aws-sdk/client-bedrock-agent-runtime": "^3.943.0",
-    "@aws-sdk/client-s3": "^3.943.0",
-    "@aws-sdk/client-secrets-manager": "^3.943.0",
-    "@aws-sdk/client-ssm": "^3.943.0",
-    "@aws-sdk/client-sts": "^3.996.0",
-    "@aws-sdk/credential-providers": "^3.943.0",
+    "@anthropic-ai/sdk": "^0.106.0",
+    "@aws-sdk/client-bedrock": "^3.1069.0",
+    "@aws-sdk/client-bedrock-agent": "^3.1075.0",
+    "@aws-sdk/client-bedrock-agent-runtime": "^3.1075.0",
+    "@aws-sdk/client-s3": "^3.1069.0",
+    "@aws-sdk/client-secrets-manager": "^3.1069.0",
+    "@aws-sdk/client-ssm": "^3.1069.0",
+    "@aws-sdk/client-sts": "^3.1069.0",
+    "@aws-sdk/credential-providers": "^3.1069.0",
     "@aws/bedrock-token-generator": "^1.1.0",
-    "@cedar-policy/cedar-wasm": "^4.11.0",
+    "@cedar-policy/cedar-wasm": "^4.11.2",
     "@cedar-policy/mcp-schema-generator-wasm": "^0.6.0",
-    "@eslint/js": "^9.39.4",
-    "@google/genai": "^1.40.0",
+    "@eslint/js": "^10.0.1",
+    "@google/genai": "^2.6.0",
     "@opentelemetry/api": "^1.9.0",
-    "@opentelemetry/exporter-metrics-otlp-http": "^0.214.0",
-    "@opentelemetry/exporter-trace-otlp-http": "^0.214.0",
-    "@opentelemetry/resources": "^2.6.1",
+    "@opentelemetry/exporter-metrics-otlp-http": "^0.219.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.219.0",
+    "@opentelemetry/resources": "^2.8.0",
     "@opentelemetry/sdk-metrics": "^2.6.1",
     "@opentelemetry/sdk-trace-base": "^2.6.1",
     "@opentelemetry/sdk-trace-node": "^2.6.1",
-    "@smithy/types": "^4.0.0",
+    "@smithy/types": "^4.15.1",
     "@types/express": "^5.0.6",
-    "@types/node": "^25.6.0",
+    "@types/node": "^25.9.4",
     "@types/uuid": "^11.0.0",
-    "@typescript-eslint/eslint-plugin": "^8.48.1",
+    "@typescript-eslint/eslint-plugin": "^8.62.1",
     "@typescript-eslint/parser": "^8.0.0",
-    "@vitest/browser": "^4.1.6",
+    "@vitest/browser": "^4.1.9",
     "@vitest/browser-playwright": "^4.1.6",
     "@vitest/coverage-v8": "^4.1.6",
-    "eslint": "^10.2.0",
+    "eslint": "^10.6.0",
     "eslint-plugin-tsdoc": "^0.5.0",
     "express": "^5.2.1",
-    "openai": "^6.7.0",
-    "playwright": "^1.60.0",
-    "tsx": "^4.21.0",
-    "typescript": "^6.0.2",
+    "openai": "^6.45.0",
+    "playwright": "^1.61.0",
+    "tsx": "^4.22.5",
+    "typescript": "^6.0.3",
     "vitest": "^4.1.6"
   },
   "engines": {
@@ -221,33 +228,33 @@
   },
   "homepage": "https://github.com/strands-agents/harness-sdk#readme",
   "dependencies": {
-    "@aws-sdk/client-bedrock-runtime": "^3.1037.0",
+    "@aws-sdk/client-bedrock-runtime": "^3.1069.0",
     "@types/json-schema": "^7.0.15",
-    "uuid": "^14.0.0",
+    "uuid": "^14.0.1",
     "yaml": "^2.8.3"
   },
   "peerDependencies": {
     "@a2a-js/sdk": "^0.3.10",
     "@ai-sdk/provider": "^3.0.0",
-    "@anthropic-ai/sdk": "^0.92.0",
-    "@aws-sdk/client-bedrock-agent": "^3.943.0",
-    "@aws-sdk/client-bedrock-agent-runtime": "^3.943.0",
-    "@aws-sdk/client-s3": "^3.943.0",
+    "@anthropic-ai/sdk": "^0.106.0",
+    "@aws-sdk/client-bedrock-agent": "^3.1075.0",
+    "@aws-sdk/client-bedrock-agent-runtime": "^3.1075.0",
+    "@aws-sdk/client-s3": "^3.1069.0",
     "@aws/bedrock-token-generator": "^1.1.0",
     "@cedar-policy/cedar-wasm": "^4.0.0",
     "@cedar-policy/mcp-schema-generator-wasm": "^0.6.0",
-    "@google/genai": "^1.40.0",
+    "@google/genai": "^2.6.0",
     "@modelcontextprotocol/sdk": "^1.25.2",
     "@opentelemetry/api": "^1.9.0",
-    "@opentelemetry/exporter-metrics-otlp-http": "^0.214.0",
-    "@opentelemetry/exporter-trace-otlp-http": "^0.214.0",
-    "@opentelemetry/resources": "^2.6.1",
+    "@opentelemetry/exporter-metrics-otlp-http": "^0.219.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.219.0",
+    "@opentelemetry/resources": "^2.8.0",
     "@opentelemetry/sdk-metrics": "^2.6.1",
     "@opentelemetry/sdk-trace-base": "^2.6.1",
     "@opentelemetry/sdk-trace-node": "^2.6.1",
-    "@smithy/types": "^4.0.0",
+    "@smithy/types": "^4.15.1",
     "express": "^5.1.0",
-    "openai": "^6.7.0",
+    "openai": "^6.45.0",
     "zod": "^4.1.12"
   },
   "peerDependenciesMeta": {

package/dist/src/__fixtures__/agent-helpers.d.ts

@@ -1,136 +0,0 @@
-/**
- * Test fixtures and helpers for Agent testing.
- * This module provides utilities for testing Agent-related implementations.
- */
-import type { Agent } from '../agent/agent.js';
-import type { AgentResult, InvokableAgent } from '../types/agent.js';
-import type { StopReason } from '../types/messages.js';
-import { Message } from '../types/messages.js';
-import type { Role } from '../types/messages.js';
-import type { JSONValue } from '../types/json.js';
-import { ToolRegistry } from '../registry/tool-registry.js';
-import type { HookableEvent } from '../hooks/events.js';
-import type { HookableEventConstructor, HookCallback } from '../hooks/types.js';
-import { type LoopMetricsMatcher } from './metrics-helpers.js';
-/**
- * A hook registration captured by the mock agent's addHook.
- */
-export type TrackedHook = {
-    eventType: HookableEventConstructor<HookableEvent>;
-    callback: HookCallback<HookableEvent>;
-};
-/**
- * Data for creating a mock Agent.
- */
-export interface MockAgentData {
-    /**
-     * Messages for the agent.
-     */
-    messages?: Message[];
-    /**
-     * Initial state for the agent.
-     */
-    appState?: Record<string, JSONValue>;
-    /**
-     * Optional tool registry for the agent.
-     */
-    toolRegistry?: ToolRegistry;
-    /**
-     * Additional properties to spread onto the mock agent.
-     */
-    extra?: Partial<Agent>;
-}
-/**
- * A mock Agent with a `trackedHooks` array populated by `addHook` calls.
- */
-export type MockAgent = Agent & {
-    trackedHooks: TrackedHook[];
-};
-/**
- * Helper to create a mock Agent for testing.
- * Provides minimal Agent interface with messages, appState, and tool registry.
- * `addHook` captures registrations into `trackedHooks` for test inspection.
- *
- * @param data - Optional mock agent data
- * @returns Mock Agent with trackedHooks
- */
-export declare function createMockAgent(data?: MockAgentData): MockAgent;
-/**
- * Creates a Message with the given role containing a single TextBlock.
- *
- * @param role - The message role
- * @param text - The text content
- * @returns A Message with the specified role
- */
-export declare function textMessage(role: Role, text: string): Message;
-/**
- * Finds the tracked hook for the given event type and invokes it with the provided event.
- * Throws if no hook is registered for that event type.
- *
- * @param agent - The mock agent with tracked hooks
- * @param event - The event instance to dispatch
- */
-export declare function invokeTrackedHook<T extends HookableEvent>(agent: MockAgent, event: T): Promise<void>;
-/**
- * Options for building an AgentResult matcher.
- */
-export interface AgentResultMatcher extends Omit<LoopMetricsMatcher, 'cycleCount'> {
-    /**
-     * Expected stop reason from the final model response.
-     */
-    stopReason: StopReason;
-    /**
-     * Expected text content in the last assistant message's TextBlock.
-     * When provided, asserts exact text match in a TextBlock with role 'assistant'.
-     * When omitted, only validates lastMessage exists with role 'assistant'.
-     */
-    messageText?: string;
-    /**
-     * Expected number of agent loop cycles.
-     */
-    cycleCount: number;
-    /**
-     * Expected number of traces. When provided, asserts exact array length.
-     * When omitted, asserts traces array exists with at least one element.
-     */
-    traceCount?: number;
-    /**
-     * Expected `invocationState` on the result. When provided, the full object
-     * must match exactly — extra keys fail. When omitted, only asserts
-     * `invocationState` is present (any object).
-     */
-    invocationState?: Record<string, unknown>;
-}
-/**
- * Creates an asymmetric matcher that validates AgentResult structure and values.
- * Reduces nesting in test assertions by providing a clean, readable matcher.
- *
- * @param options - Expected result values
- * @returns An asymmetric matcher suitable for use in expect().toEqual()
- *
- * @example
- * ```typescript
- * expect(result).toEqual(expectAgentResult({
- *   stopReason: 'endTurn',
- *   messageText: 'Hello',
- *   cycleCount: 1,
- * }))
- * ```
- */
-export declare function expectAgentResult(options: AgentResultMatcher): AgentResult;
-/**
- * Creates a minimal InvokableAgent that sleeps for `delayMs` before resolving,
- * aborting the sleep early when the invocation's `cancelSignal` fires. Used to
- * exercise timeout and cancellation behavior deterministically without spinning
- * up a full Agent.
- *
- * @param id - The agent id
- * @param delayMs - How long the agent should sleep before returning
- * @param structuredOutput - Optional structured output (e.g. a swarm handoff). When present,
- *   its `message` field is used as the assistant text.
- */
-export declare function createCancellableAgent(id: string, delayMs: number, structuredOutput?: {
-    agentId?: string;
-    message: string;
-}): InvokableAgent;
-//# sourceMappingURL=agent-helpers.d.ts.map

package/dist/src/__fixtures__/agent-helpers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-helpers.d.ts","sourceRoot":"","sources":["../../../src/__fixtures__/agent-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAA6B,MAAM,mBAAmB,CAAA;AAC/F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,OAAO,EAAa,MAAM,sBAAsB,CAAA;AACzD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAEhD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAG3D,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,oBAAoB,CAAA;AACpE,OAAO,KAAK,EAAE,wBAAwB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAC/E,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAEjF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,SAAS,EAAE,wBAAwB,CAAC,aAAa,CAAC,CAAA;IAClD,QAAQ,EAAE,YAAY,CAAC,aAAa,CAAC,CAAA;CACtC,CAAA;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAA;IACpB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IACpC;;OAEG;IACH,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG;IAAE,YAAY,EAAE,WAAW,EAAE,CAAA;CAAE,CAAA;AAE/D;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,aAAa,GAAG,SAAS,CA0B/D;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,SAAS,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAM1G;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,kBAAkB,EAAE,YAAY,CAAC;IAChF;;OAEG;IACH,UAAU,EAAE,UAAU,CAAA;IAEtB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAA;IAElB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC1C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAgC1E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,gBAAgB,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAwB,GAC5E,cAAc,CA8BhB"}

package/dist/src/__fixtures__/agent-helpers.js

@@ -1,156 +0,0 @@
-/**
- * Test fixtures and helpers for Agent testing.
- * This module provides utilities for testing Agent-related implementations.
- */
-import { expect } from 'vitest';
-import { Message, TextBlock } from '../types/messages.js';
-import { StateStore } from '../state-store.js';
-import { ToolRegistry } from '../registry/tool-registry.js';
-import { defaultSandbox } from '../sandbox/default.js';
-import { expectLoopMetrics } from './metrics-helpers.js';
-/**
- * Helper to create a mock Agent for testing.
- * Provides minimal Agent interface with messages, appState, and tool registry.
- * `addHook` captures registrations into `trackedHooks` for test inspection.
- *
- * @param data - Optional mock agent data
- * @returns Mock Agent with trackedHooks
- */
-export function createMockAgent(data) {
-    const trackedHooks = [];
-    return {
-        messages: data?.messages ?? [],
-        appState: new StateStore(data?.appState ?? {}),
-        modelState: new StateStore(),
-        toolRegistry: data?.toolRegistry ?? new ToolRegistry(),
-        cancelSignal: new AbortController().signal,
-        // Mirror the real Agent.sandbox getter: resolve the environment default lazily.
-        // An explicit `extra.sandbox` below overrides this accessor.
-        get sandbox() {
-            return defaultSandbox.get();
-        },
-        addHook: (eventType, callback) => {
-            trackedHooks.push({
-                eventType: eventType,
-                callback: callback,
-            });
-            return () => { };
-        },
-        // No-op so plugins that register middleware in initAgent (e.g. MemoryManager injection) work
-        // out of the box. Tests that inspect registrations override this via `extra.addMiddleware`.
-        addMiddleware: () => () => { },
-        ...data?.extra,
-        trackedHooks,
-    };
-}
-/**
- * Creates a Message with the given role containing a single TextBlock.
- *
- * @param role - The message role
- * @param text - The text content
- * @returns A Message with the specified role
- */
-export function textMessage(role, text) {
-    return new Message({ role, content: [new TextBlock(text)] });
-}
-/**
- * Finds the tracked hook for the given event type and invokes it with the provided event.
- * Throws if no hook is registered for that event type.
- *
- * @param agent - The mock agent with tracked hooks
- * @param event - The event instance to dispatch
- */
-export async function invokeTrackedHook(agent, event) {
-    const hook = agent.trackedHooks.find((h) => h.eventType === event.constructor);
-    if (!hook) {
-        throw new Error(`No hook registered for event type: ${event.constructor.name}`);
-    }
-    await hook.callback(event);
-}
-/**
- * Creates an asymmetric matcher that validates AgentResult structure and values.
- * Reduces nesting in test assertions by providing a clean, readable matcher.
- *
- * @param options - Expected result values
- * @returns An asymmetric matcher suitable for use in expect().toEqual()
- *
- * @example
- * ```typescript
- * expect(result).toEqual(expectAgentResult({
- *   stopReason: 'endTurn',
- *   messageText: 'Hello',
- *   cycleCount: 1,
- * }))
- * ```
- */
-export function expectAgentResult(options) {
-    const { stopReason, messageText, cycleCount, traceCount, toolNames, usage, invocationState } = options;
-    const expectedLastMessage = messageText
-        ? expect.objectContaining({
-            role: 'assistant',
-            content: expect.arrayContaining([expect.objectContaining({ type: 'textBlock', text: messageText })]),
-        })
-        : expect.objectContaining({ role: 'assistant' });
-    const expectedTraces = traceCount !== undefined
-        ? expect.objectContaining({ length: traceCount })
-        : expect.arrayContaining([expect.objectContaining({ name: expect.any(String) })]);
-    // Build metrics matcher options, only including defined properties
-    const metricsOptions = { cycleCount };
-    if (toolNames !== undefined) {
-        metricsOptions.toolNames = toolNames;
-    }
-    if (usage !== undefined) {
-        metricsOptions.usage = usage;
-    }
-    return expect.objectContaining({
-        type: 'agentResult',
-        stopReason,
-        lastMessage: expectedLastMessage,
-        metrics: expectLoopMetrics(metricsOptions),
-        traces: expectedTraces,
-        invocationState: invocationState ?? expect.any(Object),
-    });
-}
-/**
- * Creates a minimal InvokableAgent that sleeps for `delayMs` before resolving,
- * aborting the sleep early when the invocation's `cancelSignal` fires. Used to
- * exercise timeout and cancellation behavior deterministically without spinning
- * up a full Agent.
- *
- * @param id - The agent id
- * @param delayMs - How long the agent should sleep before returning
- * @param structuredOutput - Optional structured output (e.g. a swarm handoff). When present,
- *   its `message` field is used as the assistant text.
- */
-export function createCancellableAgent(id, delayMs, structuredOutput = { message: 'done' }) {
-    const sleep = (signal) => new Promise((resolve, reject) => {
-        const timer = setTimeout(resolve, delayMs);
-        if (signal) {
-            const onAbort = () => {
-                clearTimeout(timer);
-                reject(new Error('cancelled'));
-            };
-            if (signal.aborted)
-                onAbort();
-            else
-                signal.addEventListener('abort', onAbort, { once: true });
-        }
-    });
-    return {
-        id,
-        description: `Agent ${id}`,
-        async invoke(_args, options) {
-            await sleep(options?.cancelSignal);
-            return {
-                stopReason: 'endTurn',
-                lastMessage: { role: 'assistant', content: [new TextBlock(structuredOutput.message)] },
-                structuredOutput,
-            };
-        },
-        // eslint-disable-next-line require-yield
-        async *stream(args, options) {
-            return await this.invoke(args, options);
-        },
-    };
-}
-//# sourceMappingURL=agent-helpers.js.map

package/dist/src/__fixtures__/agent-helpers.js.map

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

package/dist/src/__fixtures__/environment.d.ts

@@ -1,12 +0,0 @@
-/**
- * Environment detection utilities for tests
- */
-/**
- * Detects if the current environment is Node.js
- */
-export declare const isNode: boolean;
-/**
- * Detects if the current environment is a browser
- */
-export declare const isBrowser: boolean;
-//# sourceMappingURL=environment.d.ts.map

package/dist/src/__fixtures__/environment.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../../src/__fixtures__/environment.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,eAAO,MAAM,MAAM,SACmF,CAAA;AAEtG;;GAEG;AACH,eAAO,MAAM,SAAS,SAAgC,CAAA"}

package/dist/src/__fixtures__/environment.js

@@ -1,12 +0,0 @@
-/**
- * Environment detection utilities for tests
- */
-/**
- * Detects if the current environment is Node.js
- */
-export const isNode = typeof process !== 'undefined' && typeof process.versions !== 'undefined' && !!process.versions.node;
-/**
- * Detects if the current environment is a browser
- */
-export const isBrowser = typeof window !== 'undefined';
-//# sourceMappingURL=environment.js.map

package/dist/src/__fixtures__/environment.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../../src/__fixtures__/environment.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GACjB,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,WAAW,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAA;AAEtG;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,MAAM,KAAK,WAAW,CAAA"}

package/dist/src/__fixtures__/metrics-helpers.d.ts

@@ -1,55 +0,0 @@
-/**
- * Test helpers for asserting on AgentMetrics in agent tests.
- */
-import type { Usage } from '../models/streaming.js';
-import { AgentMetrics } from '../telemetry/meter.js';
-/**
- * Options for building an AgentMetrics matcher.
- */
-export interface LoopMetricsMatcher {
-    /**
-     * Expected number of agent loop cycles.
-     */
-    cycleCount: number;
-    /**
-     * Expected tool names that were invoked.
-     */
-    toolNames?: string[];
-    /**
-     * Expected accumulated token usage. When provided, asserts exact values.
-     * When omitted, asserts the shape with expect.any(Number).
-     */
-    usage?: Usage;
-}
-/**
- * Creates an asymmetric matcher that validates AgentMetrics structure and values.
- *
- * @param options - Expected metric values
- * @returns An asymmetric matcher suitable for use in expect().toEqual()
- */
-export declare function expectLoopMetrics(options: LoopMetricsMatcher): AgentMetrics;
-/**
- * Finds the latest data point value for a named metric from OTEL ResourceMetrics.
- *
- * Flattens the ResourceMetrics → ScopeMetrics → MetricData hierarchy and
- * returns the value of the last data point for the matching metric name.
- * For counters this is a number; for histograms it is an object with
- * sum, count, min, max, etc.
- *
- * @param resourceMetrics - Array of ResourceMetrics from an InMemoryMetricExporter
- * @param metricName - The metric descriptor name to search for
- * @returns The value of the last data point, or undefined if not found
- */
-export declare function findMetricValue(resourceMetrics: {
-    scopeMetrics: {
-        metrics: {
-            descriptor: {
-                name: string;
-            };
-            dataPoints: {
-                value: unknown;
-            }[];
-        }[];
-    }[];
-}[], metricName: string): unknown;
-//# sourceMappingURL=metrics-helpers.d.ts.map

package/dist/src/__fixtures__/metrics-helpers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"metrics-helpers.d.ts","sourceRoot":"","sources":["../../../src/__fixtures__/metrics-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAEpD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAA;IAElB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IAEpB;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,CAAA;CACd;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,YAAY,CA2B3E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,eAAe,EAAE;IACf,YAAY,EAAE;QAAE,OAAO,EAAE;YAAE,UAAU,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAA;aAAE,CAAC;YAAC,UAAU,EAAE;gBAAE,KAAK,EAAE,OAAO,CAAA;aAAE,EAAE,CAAA;SAAE,EAAE,CAAA;KAAE,EAAE,CAAA;CAClG,EAAE,EACH,UAAU,EAAE,MAAM,GACjB,OAAO,CAQT"}

package/dist/src/__fixtures__/metrics-helpers.js

@@ -1,57 +0,0 @@
-/**
- * Test helpers for asserting on AgentMetrics in agent tests.
- */
-import { expect } from 'vitest';
-import { AgentMetrics } from '../telemetry/meter.js';
-/**
- * Creates an asymmetric matcher that validates AgentMetrics structure and values.
- *
- * @param options - Expected metric values
- * @returns An asymmetric matcher suitable for use in expect().toEqual()
- */
-export function expectLoopMetrics(options) {
-    const { cycleCount, toolNames = [], usage } = options;
-    const expectedToolMetrics = {};
-    for (const name of toolNames) {
-        expectedToolMetrics[name] = {
-            callCount: expect.any(Number),
-            successCount: expect.any(Number),
-            errorCount: expect.any(Number),
-            totalTime: expect.any(Number),
-        };
-    }
-    const expectedUsage = usage ??
-        expect.objectContaining({
-            inputTokens: expect.any(Number),
-            outputTokens: expect.any(Number),
-            totalTokens: expect.any(Number),
-        });
-    return expect.objectContaining({
-        cycleCount,
-        toolMetrics: toolNames.length > 0 ? expect.objectContaining(expectedToolMetrics) : {},
-        accumulatedUsage: expectedUsage,
-        accumulatedMetrics: { latencyMs: expect.any(Number) },
-    });
-}
-/**
- * Finds the latest data point value for a named metric from OTEL ResourceMetrics.
- *
- * Flattens the ResourceMetrics → ScopeMetrics → MetricData hierarchy and
- * returns the value of the last data point for the matching metric name.
- * For counters this is a number; for histograms it is an object with
- * sum, count, min, max, etc.
- *
- * @param resourceMetrics - Array of ResourceMetrics from an InMemoryMetricExporter
- * @param metricName - The metric descriptor name to search for
- * @returns The value of the last data point, or undefined if not found
- */
-export function findMetricValue(resourceMetrics, metricName) {
-    const dp = resourceMetrics
-        .flatMap((rm) => rm.scopeMetrics)
-        .flatMap((sm) => sm.metrics)
-        .filter((m) => m.descriptor.name === metricName)
-        .flatMap((m) => m.dataPoints)
-        .at(-1);
-    return dp?.value;
-}
-//# sourceMappingURL=metrics-helpers.js.map

package/dist/src/__fixtures__/metrics-helpers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"metrics-helpers.js","sourceRoot":"","sources":["../../../src/__fixtures__/metrics-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAuBpD;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAA2B;IAC3D,MAAM,EAAE,UAAU,EAAE,SAAS,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,CAAA;IAErD,MAAM,mBAAmB,GAA4B,EAAE,CAAA;IACvD,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,mBAAmB,CAAC,IAAI,CAAC,GAAG;YAC1B,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC;YAC7B,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC;YAChC,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC;YAC9B,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC;SAC9B,CAAA;IACH,CAAC;IAED,MAAM,aAAa,GACjB,KAAK;QACL,MAAM,CAAC,gBAAgB,CAAC;YACtB,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC;YAC/B,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC;YAChC,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC;SAChC,CAAC,CAAA;IAEJ,OAAO,MAAM,CAAC,gBAAgB,CAAC;QAC7B,UAAU;QACV,WAAW,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,EAAE;QACrF,gBAAgB,EAAE,aAAa;QAC/B,kBAAkB,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE;KACtD,CAAiB,CAAA;AACpB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAC7B,eAEG,EACH,UAAkB;IAElB,MAAM,EAAE,GAAG,eAAe;SACvB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,YAAY,CAAC;SAChC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC;SAC3B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,KAAK,UAAU,CAAC;SAC/C,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;SAC5B,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;IACT,OAAO,EAAE,EAAE,KAAK,CAAA;AAClB,CAAC"}