@strands-agents/sdk 1.3.0 → 1.5.0

package/dist/src/a2a/executor.d.ts

@@ -7,58 +7,93 @@
 import type { ExecutionEventBus, RequestContext } from '@a2a-js/sdk/server';
 import type { AgentExecutor } from '@a2a-js/sdk/server';
 import type { InvokableAgent } from '../types/agent.js';
+/** Builds a fresh agent for a given A2A `contextId`, invoked once per context. */
+export type AgentFactory = (contextId: string) => InvokableAgent;
+/** Default cap on concurrently tracked A2A contexts. */
+export declare const DEFAULT_MAX_CONTEXTS = 1000;
+/**
+ * Options for constructing an {@link A2AExecutor}.
+ *
+ * Provide exactly one of `agent` (deprecated) or `agentFactory`.
+ */
+export interface A2AExecutorOptions {
+    /** @deprecated A single agent reused across contexts. Prefer `agentFactory`. */
+    agent?: InvokableAgent;
+    /** Callable that returns a fresh agent per `contextId`. Recommended. */
+    agentFactory?: AgentFactory;
+    /** Maximum contexts to retain; the least-recently-used is evicted beyond it. Must be at least 1. */
+    maxContexts?: number;
+}
 /**
  * Bridges a Strands Agent into the A2A protocol as an AgentExecutor.
  *
  * Converts A2A message parts to Strands content blocks, streams the agent
  * execution, and publishes text deltas as artifact updates through the A2A
- * event bus. Text chunks are appended to a single artifact as they arrive,
- * implementing A2A-compliant streaming behavior.
+ * event bus.
  *
- * ## Invocation state
+ * Conversation state is isolated per A2A `contextId`. There are two modes:
  *
- * The executor populates the agent's `invocationState` with the incoming A2A
- * {@link RequestContext} under the reserved key `a2aRequestContext`. Hooks and
- * tools running inside the agent can read `event.invocationState.a2aRequestContext`
- * to correlate with the A2A request (taskId, contextId, user message metadata)
- * for logging, metrics, or audit.
+ * - **`agentFactory`** (recommended): returns a dedicated agent per context. Each
+ *   context owns an independent agent under its own lock, so different contexts run
+ *   concurrently and never share state. The factory is also where per-context
+ *   concerns such as a `sessionManager` are wired.
+ * - **`agent`** (deprecated): a single agent reused across contexts, with each
+ *   context's state swapped on/off it under a lock. Not multi-tenant safe; prefer
+ *   `agentFactory`.
  *
- * Because the A2A framework (not user code) drives `execute()`, there is no
- * per-request path for the user to supply their own `invocationState`. If a
- * user hook writes to the `a2aRequestContext` key, it will be overwritten on
- * the next request.
+ * `contextId` is client-supplied and is **not** an authentication boundary: a caller
+ * that knows another's `contextId` can attach to that conversation. Multi-tenant
+ * deployments must enforce authenticated identity at the transport/gateway layer.
+ *
+ * The incoming {@link RequestContext} is forwarded to the agent's `invocationState`
+ * under the reserved key `a2aRequestContext` for hooks and tools to read.
  *
  * @example
  * ```typescript
  * import { Agent } from '@strands-agents/sdk'
  * import { A2AExecutor } from '@strands-agents/sdk/a2a'
  *
- * const agent = new Agent({ model: 'my-model' })
- * const executor = new A2AExecutor(agent)
+ * const executor = new A2AExecutor({ agentFactory: (contextId) => new Agent({ model: 'my-model' }) })
  * ```
  */
 export declare class A2AExecutor implements AgentExecutor {
-    private _agent;
+    private readonly _agentFactory?;
+    private readonly _maxContexts;
+    /** Serializes single-agent mode: only one request may use the shared agent at a time. */
+    private readonly _sharedAgentLock;
+    private readonly _contexts;
+    private readonly _agent?;
+    private readonly _templateSnapshot?;
+    private readonly _snapshots;
     /**
      * Creates a new A2AExecutor.
      *
-     * @param agent - The agent to execute for incoming A2A requests
+     * Provide exactly one of `agent` (deprecated) or `agentFactory`.
+     *
+     * @param options - Executor options: `agent` or `agentFactory`, plus optional `maxContexts`.
      */
-    constructor(agent: InvokableAgent);
+    constructor(options?: A2AExecutorOptions);
+    /** Snapshot an agent's session state. */
+    private _captureState;
+    /** Load a snapshot into an agent, restoring its session state. */
+    private _restoreState;
+    /** Evict least-recently-used contexts beyond `maxContexts`. */
+    private _evictExcessContexts;
+    /** Return the dedicated agent and lock for a context, creating it on first use (factory mode). */
+    private _acquireContextAgent;
     /**
      * Executes the agent in response to an A2A message.
      *
-     * Converts A2A message parts to Strands content blocks, then streams the
-     * agent execution. Text deltas are streamed incrementally into a single
-     * artifact; non-text content blocks (images, videos, documents) are each
-     * published as separate complete artifacts. A final artifact with
-     * `lastChunk: true` signals the end of the text artifact, followed by a
-     * completed status update.
-     *
      * @param context - The A2A request context containing the user message
      * @param eventBus - The event bus for publishing A2A artifact and status events
      */
     execute(context: RequestContext, eventBus: ExecutionEventBus): Promise<void>;
+    /** Factory mode: run against this context's dedicated agent, serialized only per context. */
+    private _runWithContextAgent;
+    /** Single-agent mode: swap this context's snapshot on/off the shared agent under a lock. */
+    private _runWithSharedAgent;
+    /** Streams one agent invocation and translates its events to A2A artifact updates. */
+    private _streamAgent;
     /**
      * Cancels a running task. Not supported by this executor.
      *

package/dist/src/a2a/executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/a2a/executor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAMvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,WAAY,YAAW,aAAa;IAC/C,OAAO,CAAC,MAAM,CAAgB;IAE9B;;;;OAIG;gBACS,KAAK,EAAE,cAAc;IAIjC;;;;;;;;;;;;OAYG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoFlF;;;;;OAKG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;CAG/E"}
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/a2a/executor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,mBAAmB,CAAA;AASnE,kFAAkF;AAClF,MAAM,MAAM,YAAY,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,cAAc,CAAA;AAEhE,wDAAwD;AACxD,eAAO,MAAM,oBAAoB,OAAO,CAAA;AAQxC;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,gFAAgF;IAChF,KAAK,CAAC,EAAE,cAAc,CAAA;IACtB,wEAAwE;IACxE,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,oGAAoG;IACpG,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAsBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,WAAY,YAAW,aAAa;IAC/C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAc;IAC7C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;IAErC,yFAAyF;IACzF,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkB;IAGnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;IAG5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAU;IAC7C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8B;IAEzD;;;;;;OAMG;gBACS,OAAO,GAAE,kBAAuB;IAiC5C,yCAAyC;IACzC,OAAO,CAAC,aAAa;IAIrB,kEAAkE;IAClE,OAAO,CAAC,aAAa;IAIrB,+DAA+D;IAC/D,OAAO,CAAC,oBAAoB;IAS5B,kGAAkG;IAClG,OAAO,CAAC,oBAAoB;IAc5B;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBlF,6FAA6F;YAC/E,oBAAoB;IAUlC,4FAA4F;YAC9E,mBAAmB;IAmBjC,sFAAsF;YACxE,YAAY;IA6E1B;;;;;OAKG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;CAG/E"}

package/dist/src/a2a/executor.js

@@ -4,61 +4,190 @@
  * Implements the AgentExecutor interface from `@a2a-js/sdk/server` to allow
  * a Strands Agent to handle A2A JSON-RPC requests.
  */
+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 { A2AError } from '@a2a-js/sdk/server';
 import { ModelStreamUpdateEvent, ContentBlockEvent } from '../hooks/events.js';
 import { contentBlocksToParts, partsToContentBlocks } from './adapters.js';
 import { normalizeError } from '../errors.js';
 import { logger } from '../logging/logger.js';
+import { AsyncLock } from './async-lock.js';
+/** Default cap on concurrently tracked A2A contexts. */
+export const DEFAULT_MAX_CONTEXTS = 1000;
+/** Narrows to a {@link SnapshotAgent}, throwing if the agent lacks snapshot support. */
+function asSnapshotAgent(agent) {
+    const candidate = agent;
+    if (typeof candidate.takeSnapshot !== 'function' || typeof candidate.loadSnapshot !== 'function') {
+        throw new Error('A2AExecutor requires an Agent that supports snapshots (takeSnapshot/loadSnapshot). ' +
+            'Pass a Strands Agent instance.');
+    }
+    return agent;
+}
+/** Whether the agent has a configured `sessionManager` (a field not declared on {@link InvokableAgent}). */
+function hasSessionManager(agent) {
+    return agent.sessionManager !== undefined;
+}
 /**
  * Bridges a Strands Agent into the A2A protocol as an AgentExecutor.
  *
  * Converts A2A message parts to Strands content blocks, streams the agent
  * execution, and publishes text deltas as artifact updates through the A2A
- * event bus. Text chunks are appended to a single artifact as they arrive,
- * implementing A2A-compliant streaming behavior.
+ * event bus.
+ *
+ * Conversation state is isolated per A2A `contextId`. There are two modes:
  *
- * ## Invocation state
+ * - **`agentFactory`** (recommended): returns a dedicated agent per context. Each
+ *   context owns an independent agent under its own lock, so different contexts run
+ *   concurrently and never share state. The factory is also where per-context
+ *   concerns such as a `sessionManager` are wired.
+ * - **`agent`** (deprecated): a single agent reused across contexts, with each
+ *   context's state swapped on/off it under a lock. Not multi-tenant safe; prefer
+ *   `agentFactory`.
  *
- * The executor populates the agent's `invocationState` with the incoming A2A
- * {@link RequestContext} under the reserved key `a2aRequestContext`. Hooks and
- * tools running inside the agent can read `event.invocationState.a2aRequestContext`
- * to correlate with the A2A request (taskId, contextId, user message metadata)
- * for logging, metrics, or audit.
+ * `contextId` is client-supplied and is **not** an authentication boundary: a caller
+ * that knows another's `contextId` can attach to that conversation. Multi-tenant
+ * deployments must enforce authenticated identity at the transport/gateway layer.
  *
- * Because the A2A framework (not user code) drives `execute()`, there is no
- * per-request path for the user to supply their own `invocationState`. If a
- * user hook writes to the `a2aRequestContext` key, it will be overwritten on
- * the next request.
+ * The incoming {@link RequestContext} is forwarded to the agent's `invocationState`
+ * under the reserved key `a2aRequestContext` for hooks and tools to read.
  *
  * @example
  * ```typescript
  * import { Agent } from '@strands-agents/sdk'
  * import { A2AExecutor } from '@strands-agents/sdk/a2a'
  *
- * const agent = new Agent({ model: 'my-model' })
- * const executor = new A2AExecutor(agent)
+ * const executor = new A2AExecutor({ agentFactory: (contextId) => new Agent({ model: 'my-model' }) })
  * ```
  */
 export class A2AExecutor {
+    _agentFactory;
+    _maxContexts;
+    /** Serializes single-agent mode: only one request may use the shared agent at a time. */
+    _sharedAgentLock = new AsyncLock();
+    // Factory mode: a dedicated agent and lock per context.
+    _contexts = new Map();
+    // Single-agent mode: one shared agent, swapping each context's snapshot on/off it.
     _agent;
+    _templateSnapshot;
+    _snapshots = new Map();
     /**
      * Creates a new A2AExecutor.
      *
-     * @param agent - The agent to execute for incoming A2A requests
+     * Provide exactly one of `agent` (deprecated) or `agentFactory`.
+     *
+     * @param options - Executor options: `agent` or `agentFactory`, plus optional `maxContexts`.
      */
-    constructor(agent) {
-        this._agent = agent;
+    constructor(options = {}) {
+        const { agent, agentFactory, maxContexts = DEFAULT_MAX_CONTEXTS } = options;
+        if (maxContexts < 1) {
+            throw new Error(`maxContexts must be at least 1, got ${maxContexts}`);
+        }
+        if ((agent === undefined) === (agentFactory === undefined)) {
+            throw new Error("Provide exactly one of 'agent' or 'agentFactory'.");
+        }
+        this._maxContexts = maxContexts;
+        if (agentFactory !== undefined) {
+            this._agentFactory = agentFactory;
+        }
+        else {
+            const sharedAgent = asSnapshotAgent(agent);
+            if (hasSessionManager(sharedAgent)) {
+                throw new Error("A single 'agent' with a sessionManager is not supported: the session manager " +
+                    "persists every context's messages into one interleaved session. Use " +
+                    "'agentFactory' to build a per-context agent with its own sessionManager.");
+            }
+            logger.warn("Passing a single 'agent' to A2AExecutor is deprecated and will be removed in a future " +
+                'version. A single agent serializes all requests; pass an agentFactory (a callable taking ' +
+                'the contextId) instead to isolate conversations per context.');
+            this._agent = sharedAgent;
+            this._templateSnapshot = this._captureState(sharedAgent);
+        }
+    }
+    /** Snapshot an agent's session state. */
+    _captureState(agent) {
+        return agent.takeSnapshot({ preset: 'session' });
+    }
+    /** Load a snapshot into an agent, restoring its session state. */
+    _restoreState(agent, snapshot) {
+        agent.loadSnapshot(snapshot);
+    }
+    /** Evict least-recently-used contexts beyond `maxContexts`. */
+    _evictExcessContexts() {
+        const contexts = this._agentFactory !== undefined ? this._contexts : this._snapshots;
+        while (contexts.size > this._maxContexts) {
+            const evictedId = contexts.keys().next().value;
+            contexts.delete(evictedId);
+            logger.debug(`context_id=<${evictedId}> | evicted least-recently-used A2A context`);
+        }
+    }
+    /** Return the dedicated agent and lock for a context, creating it on first use (factory mode). */
+    _acquireContextAgent(contextId) {
+        let entry = this._contexts.get(contextId);
+        if (entry === undefined) {
+            entry = { agent: this._agentFactory(contextId), lock: new AsyncLock() };
+            this._contexts.set(contextId, entry);
+            this._evictExcessContexts();
+        }
+        else {
+            // Move to most-recently-used end.
+            this._contexts.delete(contextId);
+            this._contexts.set(contextId, entry);
+        }
+        return entry;
     }
     /**
      * Executes the agent in response to an A2A message.
      *
-     * Converts A2A message parts to Strands content blocks, then streams the
-     * agent execution. Text deltas are streamed incrementally into a single
-     * artifact; non-text content blocks (images, videos, documents) are each
-     * published as separate complete artifacts. A final artifact with
-     * `lastChunk: true` signals the end of the text artifact, followed by a
-     * completed status update.
-     *
      * @param context - The A2A request context containing the user message
      * @param eventBus - The event bus for publishing A2A artifact and status events
      */
@@ -68,16 +197,64 @@ export class A2AExecutor {
         if (contentBlocks.length === 0) {
             throw A2AError.invalidRequest('No content blocks available');
         }
-        // Publish initial task event to register the task with the ResultManager.
-        // Without this, artifact and status events are ignored as "unknown task".
+        // Register the task with the ResultManager; without this, later events are ignored as "unknown task".
         eventBus.publish({ kind: 'task', id: taskId, contextId, status: { state: 'working' } });
+        if (this._agentFactory !== undefined) {
+            await this._runWithContextAgent(context, contentBlocks, eventBus);
+        }
+        else {
+            await this._runWithSharedAgent(context, contentBlocks, eventBus);
+        }
+    }
+    /** Factory mode: run against this context's dedicated agent, serialized only per context. */
+    async _runWithContextAgent(context, contentBlocks, eventBus) {
+        const env_1 = { stack: [], error: void 0, hasError: false };
+        try {
+            const { agent, lock } = this._acquireContextAgent(context.contextId);
+            const _release = __addDisposableResource(env_1, await lock.acquire(), false);
+            await this._streamAgent(agent, context, contentBlocks, eventBus);
+        }
+        catch (e_1) {
+            env_1.error = e_1;
+            env_1.hasError = true;
+        }
+        finally {
+            __disposeResources(env_1);
+        }
+    }
+    /** Single-agent mode: swap this context's snapshot on/off the shared agent under a lock. */
+    async _runWithSharedAgent(context, contentBlocks, eventBus) {
+        const env_2 = { stack: [], error: void 0, hasError: false };
+        try {
+            const agent = this._agent;
+            const _release = __addDisposableResource(env_2, await this._sharedAgentLock.acquire(), false);
+            this._restoreState(agent, this._snapshots.get(context.contextId) ?? this._templateSnapshot);
+            try {
+                await this._streamAgent(agent, context, contentBlocks, eventBus);
+            }
+            finally {
+                // Persist updated history (even on error), evict, then reset the agent for the next caller.
+                this._snapshots.delete(context.contextId);
+                this._snapshots.set(context.contextId, this._captureState(agent));
+                this._evictExcessContexts();
+                this._restoreState(agent, this._templateSnapshot);
+            }
+        }
+        catch (e_2) {
+            env_2.error = e_2;
+            env_2.hasError = true;
+        }
+        finally {
+            __disposeResources(env_2);
+        }
+    }
+    /** Streams one agent invocation and translates its events to A2A artifact updates. */
+    async _streamAgent(agent, context, contentBlocks, eventBus) {
+        const { taskId, contextId } = context;
         const artifactId = globalThis.crypto.randomUUID();
         let isFirstChunk = true;
         try {
-            // Forward the A2A RequestContext to the agent under a reserved key so
-            // hooks and tools can correlate with the A2A request (taskId, contextId,
-            // user message metadata).
-            const stream = this._agent.stream(contentBlocks, {
+            const stream = agent.stream(contentBlocks, {
                 invocationState: { a2aRequestContext: context },
             });
             let next = await stream.next();
@@ -125,8 +302,8 @@ export class A2AExecutor {
                     // If no deltas were streamed, publish the full result; otherwise empty to close the artifact
                     parts: [{ kind: 'text', text: isFirstChunk && next.value ? next.value.toString() : '' }],
                 },
-                append: !isFirstChunk, // false for new artifact, true to append to streamed chunks
-                lastChunk: true, // Always true — this runs after the stream loop ends
+                append: !isFirstChunk,
+                lastChunk: true,
             });
             eventBus.publish({ kind: 'status-update', taskId, contextId, status: { state: 'completed' }, final: true });
         }

package/dist/src/a2a/executor.js.map

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

package/dist/src/a2a/index.d.ts

@@ -11,5 +11,5 @@
 export { A2AServer, type A2AServerConfig } from './server.js';
 export { A2AAgent, type A2AAgentConfig } from './a2a-agent.js';
 export { A2AStreamUpdateEvent, A2AResultEvent, type A2AEventData, type A2AStreamEvent } from './events.js';
-export { A2AExecutor } from './executor.js';
+export { A2AExecutor, type AgentFactory, type A2AExecutorOptions, DEFAULT_MAX_CONTEXTS } from './executor.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/a2a/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/a2a/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7D,OAAO,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC9D,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAA;AAC1G,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/a2a/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7D,OAAO,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC9D,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAA;AAC1G,OAAO,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,KAAK,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA"}

package/dist/src/a2a/index.js

@@ -11,5 +11,5 @@
 export { A2AServer } from './server.js';
 export { A2AAgent } from './a2a-agent.js';
 export { A2AStreamUpdateEvent, A2AResultEvent } from './events.js';
-export { A2AExecutor } from './executor.js';
+export { A2AExecutor, DEFAULT_MAX_CONTEXTS } from './executor.js';
 //# sourceMappingURL=index.js.map

package/dist/src/a2a/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/a2a/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAwB,MAAM,aAAa,CAAA;AAC7D,OAAO,EAAE,QAAQ,EAAuB,MAAM,gBAAgB,CAAA;AAC9D,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAA0C,MAAM,aAAa,CAAA;AAC1G,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/a2a/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAwB,MAAM,aAAa,CAAA;AAC7D,OAAO,EAAE,QAAQ,EAAuB,MAAM,gBAAgB,CAAA;AAC9D,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAA0C,MAAM,aAAa,CAAA;AAC1G,OAAO,EAAE,WAAW,EAA8C,oBAAoB,EAAE,MAAM,eAAe,CAAA"}

package/dist/src/a2a/server.d.ts

@@ -10,12 +10,28 @@
 import type { AgentCard, AgentSkill } from '@a2a-js/sdk';
 import type { TaskStore, A2ARequestHandler } from '@a2a-js/sdk/server';
 import type { InvokableAgent } from '../types/agent.js';
+import { type AgentFactory } from './executor.js';
 /**
  * Configuration options for creating an A2AServer.
+ *
+ * Provide exactly one of `agent` (deprecated) or `agentFactory`.
  */
 export interface A2AServerConfig {
-    /** The Strands Agent to serve via A2A protocol */
-    agent: InvokableAgent;
+    /** @deprecated The Strands Agent to serve via A2A protocol. Prefer `agentFactory`. */
+    agent?: InvokableAgent;
+    /**
+     * Callable that takes a `contextId` and returns a dedicated agent per A2A context.
+     * Contexts run concurrently and the factory is where per-context concerns such as a
+     * context-scoped `sessionManager` are wired. At construction it is invoked once with a
+     * placeholder context id to derive the agent card metadata, so it should not
+     * unconditionally allocate expensive resources.
+     */
+    agentFactory?: AgentFactory;
+    /**
+     * Maximum number of per-context agents to retain concurrently (factory mode);
+     * the least-recently-used is evicted beyond this. Must be at least 1.
+     */
+    maxContexts?: number;
     /** Human-readable name for the agent */
     name: string;
     /** Optional description of the agent's purpose */

package/dist/src/a2a/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/a2a/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAGvD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,KAAK,EAAE,cAAc,CAAA;IACrB,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAA;IACZ,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,UAAU,EAAE,CAAA;IACrB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,SAAS;IACpB,SAAS,CAAC,UAAU,EAAE,SAAS,CAAA;IAC/B,SAAS,CAAC,eAAe,EAAE,iBAAiB,CAAA;IAE5C;;;;OAIG;gBACS,MAAM,EAAE,eAAe;IAsBnC;;OAEG;IACH,IAAI,SAAS,IAAI,SAAS,CAEzB;CACF"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/a2a/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,eAAe,CAAA;AAK9D;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,sFAAsF;IACtF,KAAK,CAAC,EAAE,cAAc,CAAA;IACtB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAA;IACZ,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,UAAU,EAAE,CAAA;IACrB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,SAAS;IACpB,SAAS,CAAC,UAAU,EAAE,SAAS,CAAA;IAC/B,SAAS,CAAC,eAAe,EAAE,iBAAiB,CAAA;IAE5C;;;;OAIG;gBACS,MAAM,EAAE,eAAe;IAiCnC;;OAEG;IACH,IAAI,SAAS,IAAI,SAAS,CAEzB;CACF"}

package/dist/src/a2a/server.js

@@ -9,6 +9,8 @@
  */
 import { DefaultRequestHandler, InMemoryTaskStore } from '@a2a-js/sdk/server';
 import { A2AExecutor } from './executor.js';
+/** Placeholder context id used to build a representative agent for card metadata in factory mode. */
+const AGENT_CARD_CONTEXT_ID = '__agent_card__';
 /**
  * Base A2A server that manages agent card and request handler setup.
  *
@@ -39,10 +41,15 @@ export class A2AServer {
      * @param config - Configuration for the server
      */
     constructor(config) {
+        if ((config.agent === undefined) === (config.agentFactory === undefined)) {
+            throw new Error("Provide exactly one of 'agent' or 'agentFactory'.");
+        }
         const httpUrl = config.httpUrl ?? '';
+        // Build a representative agent for card metadata (via the factory in factory mode).
+        const cardAgent = config.agent ?? config.agentFactory(AGENT_CARD_CONTEXT_ID);
         this._agentCard = {
             name: config.name,
-            description: config.description ?? '',
+            description: config.description ?? cardAgent.description ?? '',
             version: config.version ?? '0.0.1',
             protocolVersion: '0.2.0',
             url: httpUrl,
@@ -54,7 +61,11 @@ export class A2AServer {
             },
         };
         const taskStore = config.taskStore ?? new InMemoryTaskStore();
-        const executor = new A2AExecutor(config.agent);
+        const executor = new A2AExecutor({
+            ...(config.agent !== undefined && { agent: config.agent }),
+            ...(config.agentFactory !== undefined && { agentFactory: config.agentFactory }),
+            ...(config.maxContexts !== undefined && { maxContexts: config.maxContexts }),
+        });
         this._requestHandler = new DefaultRequestHandler(this._agentCard, taskStore, executor);
     }
     /**

package/dist/src/a2a/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/a2a/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAE7E,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAsB3C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,SAAS;IACV,UAAU,CAAW;IACrB,eAAe,CAAmB;IAE5C;;;;OAIG;IACH,YAAY,MAAuB;QACjC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAA;QAEpC,IAAI,CAAC,UAAU,GAAG;YAChB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,EAAE;YACrC,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,OAAO;YAClC,eAAe,EAAE,OAAO;YACxB,GAAG,EAAE,OAAO;YACZ,iBAAiB,EAAE,CAAC,YAAY,CAAC;YACjC,kBAAkB,EAAE,CAAC,YAAY,CAAC;YAClC,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;YAC3B,YAAY,EAAE;gBACZ,SAAS,EAAE,IAAI;aAChB;SACF,CAAA;QAED,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,IAAI,iBAAiB,EAAE,CAAA;QAC7D,MAAM,QAAQ,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAC9C,IAAI,CAAC,eAAe,GAAG,IAAI,qBAAqB,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAA;IACxF,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAA;IACxB,CAAC;CACF"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/a2a/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAE7E,OAAO,EAAE,WAAW,EAAqB,MAAM,eAAe,CAAA;AAE9D,qGAAqG;AACrG,MAAM,qBAAqB,GAAG,gBAAgB,CAAA;AAqC9C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,SAAS;IACV,UAAU,CAAW;IACrB,eAAe,CAAmB;IAE5C;;;;OAIG;IACH,YAAY,MAAuB;QACjC,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,KAAK,SAAS,CAAC,EAAE,CAAC;YACzE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;QACtE,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAA;QAEpC,oFAAoF;QACpF,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,YAAa,CAAC,qBAAqB,CAAC,CAAA;QAE7E,IAAI,CAAC,UAAU,GAAG;YAChB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,SAAS,CAAC,WAAW,IAAI,EAAE;YAC9D,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,OAAO;YAClC,eAAe,EAAE,OAAO;YACxB,GAAG,EAAE,OAAO;YACZ,iBAAiB,EAAE,CAAC,YAAY,CAAC;YACjC,kBAAkB,EAAE,CAAC,YAAY,CAAC;YAClC,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;YAC3B,YAAY,EAAE;gBACZ,SAAS,EAAE,IAAI;aAChB;SACF,CAAA;QAED,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,IAAI,iBAAiB,EAAE,CAAA;QAC7D,MAAM,QAAQ,GAAG,IAAI,WAAW,CAAC;YAC/B,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;YAC1D,GAAG,CAAC,MAAM,CAAC,YAAY,KAAK,SAAS,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;YAC/E,GAAG,CAAC,MAAM,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC;SAC7E,CAAC,CAAA;QACF,IAAI,CAAC,eAAe,GAAG,IAAI,qBAAqB,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAA;IACxF,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAA;IACxB,CAAC;CACF"}

package/dist/src/agent/__tests__/agent.context-manager.test.d.ts

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

package/dist/src/agent/__tests__/agent.context-manager.test.d.ts.map

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