@strands-agents/sdk 1.7.0 → 1.9.0

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"}

package/dist/src/__fixtures__/mock-message-model.d.ts

@@ -1,103 +0,0 @@
-/**
- * Test message model provider for simplified agent testing.
- * This module provides a content-focused test model that generates appropriate
- * ModelStreamEvents from ContentBlock objects, eliminating the need to manually
- * construct events in tests.
- */
-import { Model } from '../models/model.js';
-import type { Message, StopReason } from '../types/messages.js';
-import type { ModelStreamEvent, Usage } from '../models/streaming.js';
-import type { BaseModelConfig, StreamOptions } from '../models/model.js';
-import type { PlainContentBlock } from './slim-types.js';
-/**
- * Input type for addTurn - accepts plain objects or class instances.
- */
-type ContentBlockInput = PlainContentBlock | PlainContentBlock[] | Error;
-/**
- * Test model provider that operates at the content block level.
- * Simplifies agent loop tests by allowing specification of content blocks
- * instead of manually yielding individual ModelStreamEvents.
- */
-export declare class MockMessageModel extends Model<BaseModelConfig> {
-    private _turns;
-    private _currentTurnIndex;
-    private _config;
-    /**
-     * Creates a new MockMessageModel.
-     */
-    constructor();
-    /**
-     * The number of turns that have been invoked thus far.
-     */
-    get callCount(): number;
-    /**
-     * Adds a turn to the test sequence.
-     * Returns this for method chaining.
-     *
-     * @param turn - ContentBlock, ContentBlock[], or Error to add
-     * @param options - Optional stop reason and token usage
-     * @returns This provider for chaining
-     *
-     * @example
-     * ```typescript
-     * provider
-     *   .addTurn({ type: 'textBlock', text: 'Hello' })  // Single block
-     *   .addTurn([{ type: 'toolUseBlock', ... }])  // Array of blocks
-     *   .addTurn({ type: 'textBlock', text: 'Done' }, { stopReason: 'maxTokens' })  // Explicit stopReason
-     *   .addTurn({ type: 'textBlock', text: 'Hi' }, { usage: { inputTokens: 10, outputTokens: 5, totalTokens: 15 } })
-     *   .addTurn(new Error('Failed'))  // Error turn
-     * ```
-     */
-    addTurn(turn: ContentBlockInput, options?: {
-        stopReason?: StopReason;
-        usage?: Usage;
-    }): this;
-    /**
-     * Updates the model configuration.
-     *
-     * @param modelConfig - Configuration to merge with existing config
-     */
-    updateConfig(modelConfig: BaseModelConfig): void;
-    /**
-     * Retrieves the current model configuration.
-     *
-     * @returns Current configuration object
-     */
-    getConfig(): BaseModelConfig;
-    /**
-     * Streams a conversation with the model.
-     * Generates appropriate ModelStreamEvents from the content blocks.
-     *
-     * Single-turn behavior: Reuses the same turn indefinitely
-     * Multi-turn behavior: Advances through turns and throws when exhausted
-     *
-     * @param _messages - Conversation messages (ignored by test provider)
-     * @param _options - Streaming options (ignored by test provider)
-     * @returns Async iterable of ModelStreamEvents
-     */
-    stream(_messages: Message[], _options?: StreamOptions): AsyncGenerator<ModelStreamEvent>;
-    /**
-     * Generates appropriate ModelStreamEvents for content blocks.
-     * All messages have role 'assistant' since this is for testing model responses.
-     */
-    private _generateEventsForContent;
-    /**
-     * Creates a Turn object from ContentBlock(s) or Error.
-     */
-    private _createTurn;
-    /**
-     * Auto-derives stopReason from content blocks.
-     * Returns 'toolUse' if content contains any ToolUseBlock, otherwise 'endTurn'.
-     */
-    private _deriveStopReason;
-    /**
-     * Generates appropriate ModelStreamEvents for a message.
-     */
-    private _generateEventsForMessage;
-    /**
-     * Generates appropriate ModelStreamEvents for a content block.
-     */
-    private _generateEventsForBlock;
-}
-export {};
-//# sourceMappingURL=mock-message-model.d.ts.map

package/dist/src/__fixtures__/mock-message-model.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mock-message-model.d.ts","sourceRoot":"","sources":["../../../src/__fixtures__/mock-message-model.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAExD;;GAEG;AACH,KAAK,iBAAiB,GAAG,iBAAiB,GAAG,iBAAiB,EAAE,GAAG,KAAK,CAAA;AAUxE;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,KAAK,CAAC,eAAe,CAAC;IAC1D,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,iBAAiB,CAAQ;IACjC,OAAO,CAAC,OAAO,CAAiB;IAEhC;;OAEG;;IAQH;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,UAAU,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE,GAAG,IAAI;IAK5F;;;;OAIG;IACH,YAAY,CAAC,WAAW,EAAE,eAAe,GAAG,IAAI;IAIhD;;;;OAIG;IACH,SAAS,IAAI,eAAe;IAI5B;;;;;;;;;;OAUG;IACI,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,cAAc,CAAC,gBAAgB,CAAC;IA4B/F;;;OAGG;YACY,yBAAyB;IAuBxC;;OAEG;IACH,OAAO,CAAC,WAAW;IAgBnB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;OAEG;YACY,yBAAyB;IAcxC;;OAEG;YACY,uBAAuB;CA8FvC"}