@strands-agents/sdk 1.4.0 → 1.5.0

package/README.md

@@ -14,10 +14,10 @@
   </h2>
 
   <div align="center">
-    <a href="https://github.com/strands-agents/sdk-python/graphs/commit-activity"><img alt="GitHub commit activity" src="https://img.shields.io/github/commit-activity/m/strands-agents/sdk-python"/></a>
-    <a href="https://github.com/strands-agents/sdk-python/issues"><img alt="GitHub open issues" src="https://img.shields.io/github/issues/strands-agents/sdk-python"/></a>
-    <a href="https://github.com/strands-agents/sdk-python/pulls"><img alt="GitHub open pull requests" src="https://img.shields.io/github/issues-pr/strands-agents/sdk-python"/></a>
-    <a href="https://github.com/strands-agents/sdk-python/blob/main/LICENSE.APACHE"><img alt="License" src="https://img.shields.io/github/license/strands-agents/sdk-python"/></a>
+    <a href="https://github.com/strands-agents/harness-sdk/graphs/commit-activity"><img alt="GitHub commit activity" src="https://img.shields.io/github/commit-activity/m/strands-agents/harness-sdk"/></a>
+    <a href="https://github.com/strands-agents/harness-sdk/issues"><img alt="GitHub open issues" src="https://img.shields.io/github/issues/strands-agents/harness-sdk"/></a>
+    <a href="https://github.com/strands-agents/harness-sdk/pulls"><img alt="GitHub open pull requests" src="https://img.shields.io/github/issues-pr/strands-agents/harness-sdk"/></a>
+    <a href="https://github.com/strands-agents/harness-sdk/blob/main/LICENSE.APACHE"><img alt="License" src="https://img.shields.io/github/license/strands-agents/harness-sdk"/></a>
     <a href="https://www.npmjs.com/package/@strands-agents/sdk"><img alt="NPM Version" src="https://img.shields.io/npm/v/@strands-agents/sdk"/></a>
     <a href="https://discord.gg/strands"><img alt="Strands Discord" src="https://img.shields.io/badge/Discord-Strands-5865F2?logo=discord&logoColor=white"/></a>
   </div>
@@ -25,7 +25,7 @@
   <p>
     <a href="https://strandsagents.com/">Documentation</a>
     ◆ <a href="https://github.com/strands-agents/samples">Samples</a>
-    ◆ <a href="https://github.com/strands-agents/sdk-python">Python SDK</a>
+    ◆ <a href="https://github.com/strands-agents/harness-sdk/tree/main/strands-py">Python SDK</a>
     ◆ <a href="https://github.com/strands-agents/tools">Tools</a>
     ◆ <a href="https://github.com/strands-agents/agent-builder">Agent Builder</a>
     ◆ <a href="https://github.com/strands-agents/mcp-server">MCP Server</a>
@@ -75,7 +75,7 @@ const result = await agent.invoke('What is the square root of 1764?')
 console.log(result)
 ```
 
-> **Note**: For the default Amazon Bedrock model provider, you'll need AWS credentials configured and model access enabled for Claude Sonnet 4 in your region.
+> **Note**: For the default Amazon Bedrock model provider, you'll need AWS credentials configured and model access enabled for Claude Sonnet 4.6 in your region.
 
 ---
 
@@ -103,7 +103,7 @@ import { Agent, BedrockModel } from '@strands-agents/sdk'
 
 const model = new BedrockModel({
   region: 'us-east-1',
-  modelId: 'anthropic.claude-3-5-sonnet-20240620-v1:0',
+  modelId: 'global.anthropic.claude-sonnet-4-6',
   maxTokens: 4096,
   temperature: 0.7
 })
@@ -313,13 +313,13 @@ For detailed guidance, tutorials, and concept overviews, please visit:
   - **[MCP](./examples/mcp/)**: MCP integration example
   - **[Browser Agent](./examples/browser-agent/)**: Browser-based agent with DOM manipulation
 
-- **[Contributing Guide](https://github.com/strands-agents/sdk-python/blob/main/CONTRIBUTING.md)**: Development setup and guidelines
+- **[Contributing Guide](https://github.com/strands-agents/harness-sdk/blob/main/CONTRIBUTING.md)**: Development setup and guidelines
 
 ---
 
 ## Contributing ❤️
 
-We welcome contributions! See our [Contributing Guide](https://github.com/strands-agents/sdk-python/blob/main/CONTRIBUTING.md) for details on:
+We welcome contributions! See our [Contributing Guide](https://github.com/strands-agents/harness-sdk/blob/main/CONTRIBUTING.md) for details on:
 
 - Development setup and environment
 - Testing and code quality standards
@@ -336,11 +336,11 @@ Come meet the Strands team and other users on [**Discord**](https://discord.com/
 
 ## License
 
-This project is licensed under the Apache License 2.0 - see the [LICENSE](https://github.com/strands-agents/sdk-python/blob/main/LICENSE.APACHE) file for details.
+This project is licensed under the Apache License 2.0 - see the [LICENSE](https://github.com/strands-agents/harness-sdk/blob/main/LICENSE.APACHE) file for details.
 
 ---
 
 ## Security
 
-See [CONTRIBUTING](https://github.com/strands-agents/sdk-python/blob/main/CONTRIBUTING.md#security-issue-notifications) for more information on reporting security issues.
+See [CONTRIBUTING](https://github.com/strands-agents/harness-sdk/blob/main/CONTRIBUTING.md#security-issue-notifications) for more information on reporting security issues.
 

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

@@ -1 +1 @@
-{"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;AAC3D,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,CAkB/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"}
+{"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,CAuB/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

@@ -6,6 +6,7 @@ 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.
@@ -23,6 +24,11 @@ export function createMockAgent(data) {
         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,

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

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

package/dist/src/__fixtures__/register-node-defaults.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=register-node-defaults.d.ts.map

package/dist/src/__fixtures__/register-node-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-node-defaults.d.ts","sourceRoot":"","sources":["../../../src/__fixtures__/register-node-defaults.ts"],"names":[],"mappings":""}

package/dist/src/__fixtures__/register-node-defaults.js

@@ -0,0 +1,6 @@
+import { defaultSandbox } from '../sandbox/default.js';
+import { NotASandboxLocalEnvironment } from '../sandbox/not-a-sandbox-local-environment.js';
+// In production, index.node.ts registers this on import. Tests don't go through that entry
+// point, so this setup file does it instead.
+defaultSandbox.set(new NotASandboxLocalEnvironment());
+//# sourceMappingURL=register-node-defaults.js.map

package/dist/src/__fixtures__/register-node-defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-node-defaults.js","sourceRoot":"","sources":["../../../src/__fixtures__/register-node-defaults.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAE,2BAA2B,EAAE,MAAM,+CAA+C,CAAA;AAE3F,2FAA2F;AAC3F,6CAA6C;AAC7C,cAAc,CAAC,GAAG,CAAC,IAAI,2BAA2B,EAAE,CAAC,CAAA"}

package/dist/src/__fixtures__/test-sandbox.node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test-sandbox.node.d.ts","sourceRoot":"","sources":["../../../src/__fixtures__/test-sandbox.node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAG7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAEvE;;;;;GAKG;AACH,qBAAa,WAAY,SAAQ,iBAAiB;IAChD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;gBAEf,UAAU,EAAE,MAAM;IAKvB,gBAAgB,CACrB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,cAAc,GACvB,cAAc,CAAC,WAAW,GAAG,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC;CAKlE"}
+{"version":3,"file":"test-sandbox.node.d.ts","sourceRoot":"","sources":["../../../src/__fixtures__/test-sandbox.node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAGlF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAEvE;;;;;GAKG;AACH,qBAAa,WAAY,SAAQ,iBAAiB;IAChD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;gBAEf,UAAU,EAAE,MAAM;IAKvB,gBAAgB,CACrB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,cAAc,GACvB,cAAc,CAAC,WAAW,GAAG,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC;CAMlE"}

package/dist/src/__fixtures__/test-sandbox.node.js

@@ -1,5 +1,5 @@
-import { PosixShellSandbox } from '../sandbox/posix-shell.js';
-import { shellQuote } from '../utils/shell-quote.js';
+import { buildShellEnvPrefix, PosixShellSandbox } from '../sandbox/posix-shell.js';
+import { shellQuote } from '../sandbox/constants.js';
 import { streamProcess } from '../sandbox/stream-process.js';
 /**
  * Test sandbox that executes commands within a specific working directory.
@@ -15,7 +15,8 @@ export class TestSandbox extends PosixShellSandbox {
     }
     async *executeStreaming(command, options) {
         const cwd = options?.cwd ?? this.workingDir;
-        const fullCommand = `cd ${shellQuote(cwd)} && ${command}`;
+        const envPrefix = buildShellEnvPrefix(options?.env);
+        const fullCommand = `cd ${shellQuote(cwd)} && ${envPrefix}${command}`;
         yield* streamProcess('sh', ['-c', fullCommand], { timeout: options?.timeout, signal: options?.signal });
     }
 }

package/dist/src/__fixtures__/test-sandbox.node.js.map

@@ -1 +1 @@
-{"version":3,"file":"test-sandbox.node.js","sourceRoot":"","sources":["../../../src/__fixtures__/test-sandbox.node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAI5D;;;;;GAKG;AACH,MAAM,OAAO,WAAY,SAAQ,iBAAiB;IACvC,UAAU,CAAQ;IAE3B,YAAY,UAAkB;QAC5B,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;IAC9B,CAAC;IAED,KAAK,CAAC,CAAC,gBAAgB,CACrB,OAAe,EACf,OAAwB;QAExB,MAAM,GAAG,GAAG,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,UAAU,CAAA;QAC3C,MAAM,WAAW,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,OAAO,OAAO,EAAE,CAAA;QACzD,KAAK,CAAC,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAA;IACzG,CAAC;CACF"}
+{"version":3,"file":"test-sandbox.node.js","sourceRoot":"","sources":["../../../src/__fixtures__/test-sandbox.node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAClF,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAI5D;;;;;GAKG;AACH,MAAM,OAAO,WAAY,SAAQ,iBAAiB;IACvC,UAAU,CAAQ;IAE3B,YAAY,UAAkB;QAC5B,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;IAC9B,CAAC;IAED,KAAK,CAAC,CAAC,gBAAgB,CACrB,OAAe,EACf,OAAwB;QAExB,MAAM,GAAG,GAAG,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,UAAU,CAAA;QAC3C,MAAM,SAAS,GAAG,mBAAmB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;QACnD,MAAM,WAAW,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,OAAO,SAAS,GAAG,OAAO,EAAE,CAAA;QACrE,KAAK,CAAC,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAA;IACzG,CAAC;CACF"}

package/dist/src/__tests__/default-slot.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=default-slot.test.d.ts.map

package/dist/src/__tests__/default-slot.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-slot.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/default-slot.test.ts"],"names":[],"mappings":""}

package/dist/src/__tests__/default-slot.test.js

@@ -0,0 +1,33 @@
+import { describe, expect, it } from 'vitest';
+import { createDefaultSlot } from '../default-slot.js';
+import { DefaultNotConfiguredError } from '../errors.js';
+describe('createDefaultSlot', () => {
+    it('throws DefaultNotConfiguredError when read before configured', () => {
+        const slot = createDefaultSlot('not set');
+        expect(() => slot.get()).toThrow(DefaultNotConfiguredError);
+        expect(() => slot.get()).toThrow('not set');
+    });
+    it('returns the configured value after set', () => {
+        const slot = createDefaultSlot('not set');
+        slot.set('value');
+        expect(slot.get()).toBe('value');
+    });
+    it('stores falsy values that the sentinel must not confuse with unset', () => {
+        const numbers = createDefaultSlot('no number');
+        numbers.set(0);
+        expect(numbers.get()).toBe(0);
+        const nullable = createDefaultSlot('no value');
+        nullable.set(null);
+        expect(nullable.get()).toBeNull();
+        const maybe = createDefaultSlot('no value');
+        maybe.set(undefined);
+        expect(maybe.get()).toBeUndefined();
+    });
+    it('overwrites on a subsequent set', () => {
+        const slot = createDefaultSlot('not set');
+        slot.set('first');
+        slot.set('second');
+        expect(slot.get()).toBe('second');
+    });
+});
+//# sourceMappingURL=default-slot.test.js.map

package/dist/src/__tests__/default-slot.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-slot.test.js","sourceRoot":"","sources":["../../../src/__tests__/default-slot.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAA;AAExD,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,IAAI,GAAG,iBAAiB,CAAS,SAAS,CAAC,CAAA;QACjD,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAA;QAC3D,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IAC7C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,IAAI,GAAG,iBAAiB,CAAS,SAAS,CAAC,CAAA;QACjD,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACjB,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAClC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,MAAM,OAAO,GAAG,iBAAiB,CAAS,WAAW,CAAC,CAAA;QACtD,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QACd,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAE7B,MAAM,QAAQ,GAAG,iBAAiB,CAAgB,UAAU,CAAC,CAAA;QAC7D,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAClB,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAA;QAEjC,MAAM,KAAK,GAAG,iBAAiB,CAAqB,UAAU,CAAC,CAAA;QAC/D,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;QACpB,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,aAAa,EAAE,CAAA;IACrC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,IAAI,GAAG,iBAAiB,CAAS,SAAS,CAAC,CAAA;QACjD,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACjB,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAClB,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACnC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/src/a2a/__tests__/async-lock.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=async-lock.test.d.ts.map

package/dist/src/a2a/__tests__/async-lock.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-lock.test.d.ts","sourceRoot":"","sources":["../../../../src/a2a/__tests__/async-lock.test.ts"],"names":[],"mappings":""}

package/dist/src/a2a/__tests__/async-lock.test.js

@@ -0,0 +1,137 @@
+var __addDisposableResource = (this && this.__addDisposableResource) || function (env, value, async) {
+    if (value !== null && value !== void 0) {
+        if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected.");
+        var dispose, inner;
+        if (async) {
+            if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined.");
+            dispose = value[Symbol.asyncDispose];
+        }
+        if (dispose === void 0) {
+            if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined.");
+            dispose = value[Symbol.dispose];
+            if (async) inner = dispose;
+        }
+        if (typeof dispose !== "function") throw new TypeError("Object not disposable.");
+        if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } };
+        env.stack.push({ value: value, dispose: dispose, async: async });
+    }
+    else if (async) {
+        env.stack.push({ async: true });
+    }
+    return value;
+};
+var __disposeResources = (this && this.__disposeResources) || (function (SuppressedError) {
+    return function (env) {
+        function fail(e) {
+            env.error = env.hasError ? new SuppressedError(e, env.error, "An error was suppressed during disposal.") : e;
+            env.hasError = true;
+        }
+        var r, s = 0;
+        function next() {
+            while (r = env.stack.pop()) {
+                try {
+                    if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);
+                    if (r.dispose) {
+                        var result = r.dispose.call(r.value);
+                        if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) { fail(e); return next(); });
+                    }
+                    else s |= 1;
+                }
+                catch (e) {
+                    fail(e);
+                }
+            }
+            if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();
+            if (env.hasError) throw env.error;
+        }
+        return next();
+    };
+})(typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+});
+import { describe, expect, it } from 'vitest';
+import { AsyncLock } from '../async-lock.js';
+describe('AsyncLock', () => {
+    it('serializes critical sections in FIFO order', async () => {
+        const lock = new AsyncLock();
+        const order = [];
+        async function task(id, delayMs) {
+            const env_1 = { stack: [], error: void 0, hasError: false };
+            try {
+                const _release = __addDisposableResource(env_1, await lock.acquire(), false);
+                order.push(id);
+                await new Promise((resolve) => setTimeout(resolve, delayMs));
+            }
+            catch (e_1) {
+                env_1.error = e_1;
+                env_1.hasError = true;
+            }
+            finally {
+                __disposeResources(env_1);
+            }
+        }
+        // Start three tasks "concurrently". Despite descending delays, the lock
+        // forces them to run one at a time in acquisition order.
+        await Promise.all([task(1, 15), task(2, 10), task(3, 5)]);
+        expect(order).toStrictEqual([1, 2, 3]);
+    });
+    it('prevents overlap of holders', async () => {
+        const lock = new AsyncLock();
+        let active = 0;
+        let maxActive = 0;
+        async function task() {
+            const env_2 = { stack: [], error: void 0, hasError: false };
+            try {
+                const _release = __addDisposableResource(env_2, await lock.acquire(), false);
+                active++;
+                maxActive = Math.max(maxActive, active);
+                await new Promise((resolve) => setTimeout(resolve, 5));
+                active--;
+            }
+            catch (e_2) {
+                env_2.error = e_2;
+                env_2.hasError = true;
+            }
+            finally {
+                __disposeResources(env_2);
+            }
+        }
+        await Promise.all([task(), task(), task(), task()]);
+        expect(maxActive).toBe(1);
+    });
+    it('releases the lock even if the holder throws', async () => {
+        const env_3 = { stack: [], error: void 0, hasError: false };
+        try {
+            const lock = new AsyncLock();
+            try {
+                const env_4 = { stack: [], error: void 0, hasError: false };
+                try {
+                    const _release = __addDisposableResource(env_4, await lock.acquire(), false);
+                    throw new Error('boom');
+                }
+                catch (e_3) {
+                    env_4.error = e_3;
+                    env_4.hasError = true;
+                }
+                finally {
+                    __disposeResources(env_4);
+                }
+            }
+            catch {
+                // swallow; the `using` handle is disposed as the block unwinds
+            }
+            // A subsequent acquire must resolve (would hang if the lock leaked).
+            const _release2 = __addDisposableResource(env_3, await lock.acquire(), false);
+            expect(true).toBe(true);
+        }
+        catch (e_4) {
+            env_3.error = e_4;
+            env_3.hasError = true;
+        }
+        finally {
+            __disposeResources(env_3);
+        }
+    });
+});
+//# sourceMappingURL=async-lock.test.js.map

package/dist/src/a2a/__tests__/async-lock.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-lock.test.js","sourceRoot":"","sources":["../../../../src/a2a/__tests__/async-lock.test.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAE5C,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,IAAI,GAAG,IAAI,SAAS,EAAE,CAAA;QAC5B,MAAM,KAAK,GAAa,EAAE,CAAA;QAE1B,KAAK,UAAU,IAAI,CAAC,EAAU,EAAE,OAAe;;;gBAC7C,MAAM,QAAQ,kCAAG,MAAM,IAAI,CAAC,OAAO,EAAE,QAAA,CAAA;gBACrC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;gBACd,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;;;;;;;;;SAC7D;QAED,wEAAwE;QACxE,yDAAyD;QACzD,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;QAEzD,MAAM,CAAC,KAAK,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IACxC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6BAA6B,EAAE,KAAK,IAAI,EAAE;QAC3C,MAAM,IAAI,GAAG,IAAI,SAAS,EAAE,CAAA;QAC5B,IAAI,MAAM,GAAG,CAAC,CAAA;QACd,IAAI,SAAS,GAAG,CAAC,CAAA;QAEjB,KAAK,UAAU,IAAI;;;gBACjB,MAAM,QAAQ,kCAAG,MAAM,IAAI,CAAC,OAAO,EAAE,QAAA,CAAA;gBACrC,MAAM,EAAE,CAAA;gBACR,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;gBACvC,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAA;gBACtD,MAAM,EAAE,CAAA;;;;;;;;;SACT;QAED,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;QAEnD,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAC3B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;;;YAC3D,MAAM,IAAI,GAAG,IAAI,SAAS,EAAE,CAAA;YAE5B,IAAI,CAAC;;;oBACH,MAAM,QAAQ,kCAAG,MAAM,IAAI,CAAC,OAAO,EAAE,QAAA,CAAA;oBACrC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,CAAA;;;;;;;;;aACxB;YAAC,MAAM,CAAC;gBACP,+DAA+D;YACjE,CAAC;YAED,qEAAqE;YACrE,MAAM,SAAS,kCAAG,MAAM,IAAI,CAAC,OAAO,EAAE,QAAA,CAAA;YACtC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;;;;;;;;;KACxB,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/src/a2a/__tests__/executor.test.js

@@ -39,7 +39,7 @@ describe('A2AExecutor', () => {
         it('streams text deltas as artifact chunks and publishes completed status', async () => {
             const model = new MockMessageModel().addTurn({ type: 'textBlock', text: 'Agent response' });
             const agent = new Agent({ model, printer: false });
-            const executor = new A2AExecutor(agent);
+            const executor = new A2AExecutor({ agent });
             const eventBus = createMockEventBus();
             await executor.execute(createRequestContext('Hello agent'), eventBus);
             // First event registers the task with the ResultManager
@@ -79,7 +79,7 @@ describe('A2AExecutor', () => {
                 { type: 'textBlock', text: 'Second' },
             ]);
             const agent = new Agent({ model, printer: false });
-            const executor = new A2AExecutor(agent);
+            const executor = new A2AExecutor({ agent });
             const eventBus = createMockEventBus();
             await executor.execute(createRequestContext('Hello'), eventBus);
             const artifactEvents = eventBus.events.filter((e) => e.kind === 'artifact-update');
@@ -92,7 +92,7 @@ describe('A2AExecutor', () => {
             const model = new MockMessageModel().addTurn({ type: 'textBlock', text: 'Response' });
             const agent = new Agent({ model, printer: false });
             vi.spyOn(agent, 'stream');
-            const executor = new A2AExecutor(agent);
+            const executor = new A2AExecutor({ agent });
             const eventBus = createMockEventBus();
             const context = {
                 taskId: 'task-1',
@@ -115,7 +115,7 @@ describe('A2AExecutor', () => {
             const model = new MockMessageModel().addTurn({ type: 'textBlock', text: 'Response' });
             const agent = new Agent({ model, printer: false });
             const streamSpy = vi.spyOn(agent, 'stream');
-            const executor = new A2AExecutor(agent);
+            const executor = new A2AExecutor({ agent });
             const eventBus = createMockEventBus();
             const context = createRequestContext('hello', 'task-42');
             await executor.execute(context, eventBus);
@@ -126,7 +126,7 @@ describe('A2AExecutor', () => {
         it('re-throws when agent throws, publishing only the initial task event', async () => {
             const model = new MockMessageModel().addTurn(new Error('Agent failed'));
             const agent = new Agent({ model, printer: false });
-            const executor = new A2AExecutor(agent);
+            const executor = new A2AExecutor({ agent });
             const eventBus = createMockEventBus();
             await expect(executor.execute(createRequestContext('Hello'), eventBus)).rejects.toThrow('Agent failed');
             // Only the initial task registration event is published before the error
@@ -161,7 +161,7 @@ describe('A2AExecutor', () => {
                     });
                 },
             };
-            const executor = new A2AExecutor(mockAgent);
+            const executor = new A2AExecutor({ agentFactory: () => mockAgent });
             const eventBus = createMockEventBus();
             await executor.execute(createRequestContext('Generate an image'), eventBus);
             const artifactEvents = eventBus.events.filter((e) => e.kind === 'artifact-update');
@@ -182,7 +182,7 @@ describe('A2AExecutor', () => {
         it('throws A2AError.invalidRequest when parts produce no content blocks', async () => {
             const model = new MockMessageModel().addTurn({ type: 'textBlock', text: 'Response' });
             const agent = new Agent({ model, printer: false });
-            const executor = new A2AExecutor(agent);
+            const executor = new A2AExecutor({ agent });
             const eventBus = createMockEventBus();
             const context = {
                 taskId: 'task-1',
@@ -197,11 +197,149 @@ describe('A2AExecutor', () => {
         it('throws A2AError.unsupportedOperation', async () => {
             const model = new MockMessageModel().addTurn({ type: 'textBlock', text: '' });
             const agent = new Agent({ model, printer: false });
-            const executor = new A2AExecutor(agent);
+            const executor = new A2AExecutor({ agent });
             const eventBus = createMockEventBus();
             await expect(executor.cancelTask('task-1', eventBus)).rejects.toThrow('Task cancellation is not supported');
             expect(eventBus.events).toStrictEqual([]);
         });
     });
 });
+// ============================================================================
+// Per-context conversation isolation
+//
+// These tests drive a real Agent (with a deterministic echo model) through a
+// single executor across two distinct A2A contextIds, asserting that no
+// conversation state leaks between contexts, while a single context still
+// accumulates its own history across turns.
+// ============================================================================
+/**
+ * Deterministic, network-free model that echoes the latest user text prefixed
+ * with `ECHO[<history-length>]`, so tests can observe per-context history growth.
+ */
+class EchoModel extends MockMessageModel {
+    async *stream(messages) {
+        const lastUser = [...messages].reverse().find((m) => m.role === 'user');
+        const lastText = lastUser?.content.find((b) => b.type === 'textBlock')?.text ?? '';
+        const reply = `ECHO[${messages.length}]: ${lastText}`;
+        yield { type: 'modelMessageStartEvent', role: 'assistant' };
+        yield { type: 'modelContentBlockStartEvent' };
+        yield { type: 'modelContentBlockDeltaEvent', delta: { type: 'textDelta', text: reply } };
+        yield { type: 'modelContentBlockStopEvent' };
+        yield { type: 'modelMessageStopEvent', stopReason: 'endTurn' };
+    }
+}
+function makeEchoAgent() {
+    return new Agent({ model: new EchoModel(), printer: false });
+}
+function ctxRequest(contextId, taskId, text) {
+    return {
+        taskId,
+        contextId,
+        userMessage: {
+            kind: 'message',
+            messageId: `msg-${taskId}`,
+            role: 'user',
+            parts: [{ kind: 'text', text }],
+        },
+    };
+}
+function artifactTexts(eventBus) {
+    return eventBus.events
+        .filter((e) => e.kind === 'artifact-update')
+        .flatMap((e) => e.artifact.parts)
+        .filter((p) => p.kind === 'text')
+        .map((p) => p.text);
+}
+describe('A2AExecutor context isolation', () => {
+    describe('constructor validation', () => {
+        it('throws when neither agent nor agentFactory is provided', () => {
+            expect(() => new A2AExecutor()).toThrow("Provide exactly one of 'agent' or 'agentFactory'.");
+        });
+        it('throws when both agent and agentFactory are provided', () => {
+            const agent = new Agent({ model: new MockMessageModel(), printer: false });
+            expect(() => new A2AExecutor({ agent, agentFactory: () => agent })).toThrow("Provide exactly one of 'agent' or 'agentFactory'.");
+        });
+        it('throws when maxContexts is less than 1', () => {
+            expect(() => new A2AExecutor({ agentFactory: makeEchoAgent, maxContexts: 0 })).toThrow('maxContexts must be at least 1');
+        });
+    });
+    describe('factory mode', () => {
+        it('builds one agent per context and reuses it within a context', async () => {
+            const built = [];
+            const agentsByContext = new Map();
+            const executor = new A2AExecutor({
+                agentFactory: (contextId) => {
+                    built.push(contextId);
+                    const agent = makeEchoAgent();
+                    agentsByContext.set(contextId, agent);
+                    return agent;
+                },
+            });
+            await executor.execute(ctxRequest('ctx-A', 'a-1', 'first'), createMockEventBus());
+            await executor.execute(ctxRequest('ctx-A', 'a-2', 'second'), createMockEventBus());
+            await executor.execute(ctxRequest('ctx-B', 'b-1', 'first'), createMockEventBus());
+            // Factory invoked once per distinct context, not per request.
+            expect(built).toStrictEqual(['ctx-A', 'ctx-B']);
+            // Distinct Agent instances per context.
+            expect(agentsByContext.get('ctx-A')).not.toBe(agentsByContext.get('ctx-B'));
+        });
+        it('isolates history across contexts and continues it within one', async () => {
+            const executor = new A2AExecutor({ agentFactory: makeEchoAgent });
+            // ctx-A turn 1: just the user message in history -> ECHO[1].
+            let bus = createMockEventBus();
+            await executor.execute(ctxRequest('ctx-A', 'a-1', 'SECRET-AAAA'), bus);
+            expect(artifactTexts(bus).some((t) => t.includes('ECHO[1]:') && t.includes('SECRET-AAAA'))).toBe(true);
+            // ctx-A turn 2: history now has user1, assistant1, user2 -> ECHO[3].
+            bus = createMockEventBus();
+            await executor.execute(ctxRequest('ctx-A', 'a-2', 'again'), bus);
+            expect(artifactTexts(bus).some((t) => t.includes('ECHO[3]:'))).toBe(true);
+            // ctx-B is independent -> starts fresh, never sees ctx-A's secret.
+            bus = createMockEventBus();
+            await executor.execute(ctxRequest('ctx-B', 'b-1', 'hello'), bus);
+            const textsB = artifactTexts(bus);
+            expect(textsB.some((t) => t.includes('ECHO[1]:'))).toBe(true);
+            expect(textsB.some((t) => t.includes('SECRET-AAAA'))).toBe(false);
+        });
+        it('evicts the least-recently-used context beyond maxContexts', async () => {
+            const built = [];
+            const executor = new A2AExecutor({
+                agentFactory: (contextId) => {
+                    built.push(contextId);
+                    return makeEchoAgent();
+                },
+                maxContexts: 2,
+            });
+            await executor.execute(ctxRequest('ctx-A', 'a-1', 'hi'), createMockEventBus());
+            await executor.execute(ctxRequest('ctx-B', 'b-1', 'hi'), createMockEventBus());
+            await executor.execute(ctxRequest('ctx-A', 'a-2', 'again'), createMockEventBus()); // touch A
+            await executor.execute(ctxRequest('ctx-C', 'c-1', 'hi'), createMockEventBus()); // evicts B
+            // B was evicted, so reusing it rebuilds a fresh agent (factory called again for B).
+            await executor.execute(ctxRequest('ctx-B', 'b-2', 'hi'), createMockEventBus());
+            expect(built).toStrictEqual(['ctx-A', 'ctx-B', 'ctx-C', 'ctx-B']);
+        });
+    });
+    describe('single-agent mode (deprecated)', () => {
+        it('isolates history across contexts via snapshot swapping', async () => {
+            const executor = new A2AExecutor({ agent: makeEchoAgent() });
+            let bus = createMockEventBus();
+            await executor.execute(ctxRequest('ctx-A', 'a-1', 'SECRET-AAAA'), bus);
+            expect(artifactTexts(bus).some((t) => t.includes('ECHO[1]:') && t.includes('SECRET-AAAA'))).toBe(true);
+            // ctx-A continues -> ECHO[3].
+            bus = createMockEventBus();
+            await executor.execute(ctxRequest('ctx-A', 'a-2', 'again'), bus);
+            expect(artifactTexts(bus).some((t) => t.includes('ECHO[3]:'))).toBe(true);
+            // ctx-B starts fresh and never sees ctx-A's secret.
+            bus = createMockEventBus();
+            await executor.execute(ctxRequest('ctx-B', 'b-1', 'hello'), bus);
+            const textsB = artifactTexts(bus);
+            expect(textsB.some((t) => t.includes('ECHO[1]:'))).toBe(true);
+            expect(textsB.some((t) => t.includes('SECRET-AAAA'))).toBe(false);
+        });
+        it('throws when a single agent has a sessionManager', () => {
+            const agent = makeEchoAgent();
+            agent.sessionManager = {};
+            expect(() => new A2AExecutor({ agent })).toThrow('sessionManager is not supported');
+        });
+    });
+});
 //# sourceMappingURL=executor.test.js.map