@strands-agents/sdk 0.5.0 → 0.7.0

package/dist/src/a2a/executor.js

@@ -0,0 +1,130 @@
+/**
+ * A2A executor that bridges a Strands Agent into the A2A protocol.
+ *
+ * Implements the AgentExecutor interface from `@a2a-js/sdk/server` to allow
+ * a Strands Agent to handle A2A JSON-RPC requests.
+ */
+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';
+/**
+ * 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.
+ *
+ * @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)
+ * ```
+ */
+export class A2AExecutor {
+    _agent;
+    /**
+     * Creates a new A2AExecutor.
+     *
+     * @param agent - The agent to execute for incoming A2A requests
+     */
+    constructor(agent) {
+        this._agent = agent;
+    }
+    /**
+     * 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
+     */
+    async execute(context, eventBus) {
+        const { taskId, contextId, userMessage } = context;
+        const contentBlocks = partsToContentBlocks(userMessage.parts);
+        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".
+        eventBus.publish({ kind: 'task', id: taskId, contextId, status: { state: 'working' } });
+        const artifactId = globalThis.crypto.randomUUID();
+        let isFirstChunk = true;
+        try {
+            const stream = this._agent.stream(contentBlocks);
+            let next = await stream.next();
+            while (!next.done) {
+                const event = next.value;
+                // Stream text deltas incrementally into the text artifact
+                if (event instanceof ModelStreamUpdateEvent &&
+                    event.event.type === 'modelContentBlockDeltaEvent' &&
+                    event.event.delta.type === 'textDelta') {
+                    eventBus.publish({
+                        kind: 'artifact-update',
+                        taskId,
+                        contextId,
+                        artifact: {
+                            artifactId,
+                            parts: [{ kind: 'text', text: event.event.delta.text }],
+                        },
+                        append: !isFirstChunk,
+                    });
+                    isFirstChunk = false;
+                }
+                // Publish non-text content blocks (images, videos, documents) as separate artifacts
+                if (event instanceof ContentBlockEvent && event.contentBlock.type !== 'textBlock') {
+                    const parts = contentBlocksToParts([event.contentBlock]);
+                    if (parts.length > 0) {
+                        eventBus.publish({
+                            kind: 'artifact-update',
+                            taskId,
+                            contextId,
+                            artifact: { artifactId: globalThis.crypto.randomUUID(), parts },
+                            append: false,
+                            lastChunk: true,
+                        });
+                    }
+                }
+                next = await stream.next();
+            }
+            // Publish final artifact chunk to signal end of artifact
+            eventBus.publish({
+                kind: 'artifact-update',
+                taskId,
+                contextId,
+                artifact: {
+                    artifactId,
+                    // 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
+            });
+            eventBus.publish({ kind: 'status-update', taskId, contextId, status: { state: 'completed' }, final: true });
+        }
+        catch (error) {
+            logger.error(`task_id=<${taskId}> | error in streaming execution`, normalizeError(error));
+            throw error;
+        }
+    }
+    /**
+     * Cancels a running task. Not supported by this executor.
+     *
+     * @param taskId - The ID of the task to cancel
+     * @param eventBus - The event bus for publishing status events
+     */
+    async cancelTask(_taskId, _eventBus) {
+        throw A2AError.unsupportedOperation('Task cancellation is not supported');
+    }
+}
+//# sourceMappingURL=executor.js.map

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

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

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

@@ -0,0 +1,67 @@
+/**
+ * Express-based A2A server that exposes a Strands Agent as an A2A-compliant HTTP endpoint.
+ *
+ * Separated from the base {@link A2AServer} so that importing the core A2A module
+ * does not pull in Express as a dependency, keeping it browser-compatible.
+ *
+ * The A2A protocol is experimental, so breaking changes in the underlying SDK
+ * may require breaking changes in this module.
+ */
+import { type Router } from 'express';
+import { UserBuilder } from '@a2a-js/sdk/server/express';
+import { A2AServer, type A2AServerConfig } from './server.js';
+/**
+ * Configuration options for creating an A2AExpressServer.
+ */
+export interface A2AExpressServerConfig extends A2AServerConfig {
+    /** Host to bind the server to (default: '127.0.0.1') */
+    host?: string;
+    /** Port to listen on (default: 9000) */
+    port?: number;
+    /** User builder for authentication (default: no authentication) */
+    userBuilder?: UserBuilder;
+}
+/**
+ * Express-based A2A server implementation.
+ *
+ * Provides two usage modes:
+ * - **Standalone**: Call {@link serve} to start a self-contained HTTP server.
+ * - **Middleware**: Call {@link createMiddleware} to get an Express Router that
+ *   can be mounted in an existing Express application.
+ */
+export declare class A2AExpressServer extends A2AServer {
+    private _host;
+    private _port;
+    private _userBuilder;
+    /**
+     * Creates a new A2AExpressServer.
+     *
+     * @param config - Configuration for the server
+     */
+    constructor(config: A2AExpressServerConfig);
+    /**
+     * Returns the port the server is configured to listen on.
+     * After `serve()` resolves, this reflects the actual bound port
+     * (useful when configured with port 0 for OS-assigned ports).
+     */
+    get port(): number;
+    /**
+     * Creates an Express Router middleware for the A2A endpoints.
+     *
+     * Mounts:
+     * - `GET /.well-known/agent-card.json` — Returns the agent card
+     * - `POST /` — Handles A2A JSON-RPC requests
+     *
+     * @returns An Express Router with A2A endpoints mounted
+     */
+    createMiddleware(): Router;
+    /**
+     * Starts the HTTP server and begins listening for A2A requests.
+     *
+     * @param options - Optional server options
+     */
+    serve(options?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+}
+//# sourceMappingURL=express-server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"express-server.d.ts","sourceRoot":"","sources":["../../../src/a2a/express-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAgB,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAA;AAC9C,OAAO,EAAoC,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAC1F,OAAO,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAA;AAI7D;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,eAAe;IAC7D,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,mEAAmE;IACnE,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B;AAED;;;;;;;GAOG;AACH,qBAAa,gBAAiB,SAAQ,SAAS;IAC7C,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,YAAY,CAAyB;IAE7C;;;;OAIG;gBACS,MAAM,EAAE,sBAAsB;IAY1C;;;;OAIG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;;;;OAQG;IACH,gBAAgB,IAAI,MAAM;IAkB1B;;;;OAIG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CA4B/D"}

package/dist/src/a2a/express-server.js

@@ -0,0 +1,95 @@
+/**
+ * Express-based A2A server that exposes a Strands Agent as an A2A-compliant HTTP endpoint.
+ *
+ * Separated from the base {@link A2AServer} so that importing the core A2A module
+ * does not pull in Express as a dependency, keeping it browser-compatible.
+ *
+ * The A2A protocol is experimental, so breaking changes in the underlying SDK
+ * may require breaking changes in this module.
+ */
+import express, {} from 'express';
+import { agentCardHandler, jsonRpcHandler, UserBuilder } from '@a2a-js/sdk/server/express';
+import { A2AServer } from './server.js';
+import { logExperimentalWarning } from './logging.js';
+import { logger } from '../logging/logger.js';
+/**
+ * Express-based A2A server implementation.
+ *
+ * Provides two usage modes:
+ * - **Standalone**: Call {@link serve} to start a self-contained HTTP server.
+ * - **Middleware**: Call {@link createMiddleware} to get an Express Router that
+ *   can be mounted in an existing Express application.
+ */
+export class A2AExpressServer extends A2AServer {
+    _host;
+    _port;
+    _userBuilder;
+    /**
+     * Creates a new A2AExpressServer.
+     *
+     * @param config - Configuration for the server
+     */
+    constructor(config) {
+        const host = config.host ?? '127.0.0.1';
+        const port = config.port ?? 9000;
+        const httpUrl = config.httpUrl ?? `http://${host}:${port}`;
+        super({ ...config, httpUrl });
+        this._host = host;
+        this._port = port;
+        this._userBuilder = config.userBuilder;
+    }
+    /**
+     * Returns the port the server is configured to listen on.
+     * After `serve()` resolves, this reflects the actual bound port
+     * (useful when configured with port 0 for OS-assigned ports).
+     */
+    get port() {
+        return this._port;
+    }
+    /**
+     * Creates an Express Router middleware for the A2A endpoints.
+     *
+     * Mounts:
+     * - `GET /.well-known/agent-card.json` — Returns the agent card
+     * - `POST /` — Handles A2A JSON-RPC requests
+     *
+     * @returns An Express Router with A2A endpoints mounted
+     */
+    createMiddleware() {
+        logExperimentalWarning();
+        const router = express.Router();
+        router.use('/.well-known/agent-card.json', agentCardHandler({ agentCardProvider: this._requestHandler }));
+        router.use('/', jsonRpcHandler({
+            requestHandler: this._requestHandler,
+            userBuilder: this._userBuilder ?? UserBuilder.noAuthentication,
+        }));
+        return router;
+    }
+    /**
+     * Starts the HTTP server and begins listening for A2A requests.
+     *
+     * @param options - Optional server options
+     */
+    async serve(options) {
+        const app = express();
+        app.use(this.createMiddleware());
+        return new Promise((resolve, reject) => {
+            const server = app.listen(this._port, this._host, () => {
+                const addr = server.address();
+                if (addr && typeof addr === 'object') {
+                    this._port = addr.port;
+                    this._agentCard.url = `http://${this._host}:${this._port}`;
+                }
+                logger.info(`a2a server listening on http://${this._host}:${this._port}`);
+                resolve();
+            });
+            server.on('error', reject);
+            if (options?.signal) {
+                options.signal.addEventListener('abort', () => {
+                    server.close();
+                }, { once: true });
+            }
+        });
+    }
+}
+//# sourceMappingURL=express-server.js.map

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

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

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

@@ -0,0 +1,16 @@
+/**
+ * A2A (Agent-to-Agent) protocol support for the Strands Agents SDK.
+ *
+ * This module provides server and client components for the A2A protocol,
+ * allowing Strands agents to communicate with other agents across platforms.
+ *
+ * @remarks
+ * The A2A protocol is experimental, so breaking changes in the underlying SDK
+ * may require breaking changes in this module.
+ */
+export { A2AServer, type A2AServerConfig } from './server.js';
+export { A2AExpressServer, type A2AExpressServerConfig } from './express-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';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AACnF,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"}

package/dist/src/a2a/index.js

@@ -0,0 +1,16 @@
+/**
+ * A2A (Agent-to-Agent) protocol support for the Strands Agents SDK.
+ *
+ * This module provides server and client components for the A2A protocol,
+ * allowing Strands agents to communicate with other agents across platforms.
+ *
+ * @remarks
+ * The A2A protocol is experimental, so breaking changes in the underlying SDK
+ * may require breaking changes in this module.
+ */
+export { A2AServer } from './server.js';
+export { A2AExpressServer } from './express-server.js';
+export { A2AAgent } from './a2a-agent.js';
+export { A2AStreamUpdateEvent, A2AResultEvent } from './events.js';
+export { A2AExecutor } from './executor.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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,gBAAgB,EAA+B,MAAM,qBAAqB,CAAA;AACnF,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"}

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

@@ -0,0 +1,8 @@
+/**
+ * Shared experimental warning for A2A protocol modules.
+ */
+/**
+ * Logs a one-time warning that the A2A protocol is experimental.
+ */
+export declare function logExperimentalWarning(): void;
+//# sourceMappingURL=logging.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../../src/a2a/logging.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAO7C"}

package/dist/src/a2a/logging.js

@@ -0,0 +1,15 @@
+/**
+ * Shared experimental warning for A2A protocol modules.
+ */
+import { logger } from '../logging/logger.js';
+let _logged = false;
+/**
+ * Logs a one-time warning that the A2A protocol is experimental.
+ */
+export function logExperimentalWarning() {
+    if (!_logged) {
+        _logged = true;
+        logger.warn('protocol=<a2a> | experimental, breaking changes in the underlying sdk may require breaking changes in this module');
+    }
+}
+//# sourceMappingURL=logging.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../../../src/a2a/logging.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAE7C,IAAI,OAAO,GAAG,KAAK,CAAA;AAEnB;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,GAAG,IAAI,CAAA;QACd,MAAM,CAAC,IAAI,CACT,mHAAmH,CACpH,CAAA;IACH,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,67 @@
+/**
+ * Base A2A server that manages agent card and request handler setup.
+ *
+ * This module is browser-compatible. For Express-based HTTP serving,
+ * see {@link A2AExpressServer} in `./express-server.ts`.
+ *
+ * The A2A protocol is experimental, so breaking changes in the underlying SDK
+ * may require breaking changes in this module.
+ */
+import type { AgentCard, AgentSkill } from '@a2a-js/sdk';
+import type { TaskStore, A2ARequestHandler } from '@a2a-js/sdk/server';
+import type { InvokableAgent } from '../types/agent.js';
+/**
+ * Configuration options for creating an A2AServer.
+ */
+export interface A2AServerConfig {
+    /** The Strands Agent to serve via A2A protocol */
+    agent: InvokableAgent;
+    /** Human-readable name for the agent */
+    name: string;
+    /** Optional description of the agent's purpose */
+    description?: string;
+    /** Public URL override for the agent card */
+    httpUrl?: string;
+    /** Version string for the agent card (default: '0.0.1') */
+    version?: string;
+    /** Skills to advertise in the agent card */
+    skills?: AgentSkill[];
+    /** Task store for persisting task state */
+    taskStore?: TaskStore;
+}
+/**
+ * Base A2A server that manages agent card and request handler setup.
+ *
+ * Subclass this to integrate with different HTTP frameworks. For Express,
+ * use {@link A2AExpressServer}.
+ *
+ * @example
+ * ```typescript
+ * import { Agent } from '@strands-agents/sdk'
+ * import { A2AExpressServer } from '@strands-agents/sdk/a2a'
+ *
+ * const agent = new Agent({ model: 'my-model' })
+ * const server = new A2AExpressServer({
+ *   agent,
+ *   name: 'My Agent',
+ *   description: 'An agent that helps with tasks',
+ * })
+ *
+ * await server.serve()
+ * ```
+ */
+export declare class A2AServer {
+    protected _agentCard: AgentCard;
+    protected _requestHandler: A2ARequestHandler;
+    /**
+     * Creates a new A2AServer.
+     *
+     * @param config - Configuration for the server
+     */
+    constructor(config: A2AServerConfig);
+    /**
+     * Returns the agent card for this server.
+     */
+    get agentCard(): AgentCard;
+}
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +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"}

package/dist/src/a2a/server.js

@@ -0,0 +1,67 @@
+/**
+ * Base A2A server that manages agent card and request handler setup.
+ *
+ * This module is browser-compatible. For Express-based HTTP serving,
+ * see {@link A2AExpressServer} in `./express-server.ts`.
+ *
+ * The A2A protocol is experimental, so breaking changes in the underlying SDK
+ * may require breaking changes in this module.
+ */
+import { DefaultRequestHandler, InMemoryTaskStore } from '@a2a-js/sdk/server';
+import { A2AExecutor } from './executor.js';
+/**
+ * Base A2A server that manages agent card and request handler setup.
+ *
+ * Subclass this to integrate with different HTTP frameworks. For Express,
+ * use {@link A2AExpressServer}.
+ *
+ * @example
+ * ```typescript
+ * import { Agent } from '@strands-agents/sdk'
+ * import { A2AExpressServer } from '@strands-agents/sdk/a2a'
+ *
+ * const agent = new Agent({ model: 'my-model' })
+ * const server = new A2AExpressServer({
+ *   agent,
+ *   name: 'My Agent',
+ *   description: 'An agent that helps with tasks',
+ * })
+ *
+ * await server.serve()
+ * ```
+ */
+export class A2AServer {
+    _agentCard;
+    _requestHandler;
+    /**
+     * Creates a new A2AServer.
+     *
+     * @param config - Configuration for the server
+     */
+    constructor(config) {
+        const httpUrl = config.httpUrl ?? '';
+        this._agentCard = {
+            name: config.name,
+            description: config.description ?? '',
+            version: config.version ?? '0.0.1',
+            protocolVersion: '0.2.0',
+            url: httpUrl,
+            defaultInputModes: ['text/plain'],
+            defaultOutputModes: ['text/plain'],
+            skills: config.skills ?? [],
+            capabilities: {
+                streaming: true,
+            },
+        };
+        const taskStore = config.taskStore ?? new InMemoryTaskStore();
+        const executor = new A2AExecutor(config.agent);
+        this._requestHandler = new DefaultRequestHandler(this._agentCard, taskStore, executor);
+    }
+    /**
+     * Returns the agent card for this server.
+     */
+    get agentCard() {
+        return this._agentCard;
+    }
+}
+//# sourceMappingURL=server.js.map

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

@@ -0,0 +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"}