@strands-agents/sdk 0.6.0 → 0.7.0

package/dist/src/a2a/a2a-agent.js

@@ -0,0 +1,255 @@
+/**
+ * A2A agent that wraps a remote A2A agent as an InvokableAgent.
+ *
+ * Implements the InvokableAgent interface so it can be used anywhere a local Agent
+ * can be used. The remote agent is invoked via the A2A protocol.
+ * The A2A protocol is experimental, so breaking changes in the underlying SDK
+ * may require breaking changes in this module.
+ */
+import { ClientFactory } from '@a2a-js/sdk/client';
+import { AgentResult } from '../types/agent.js';
+import { Message, TextBlock } from '../types/messages.js';
+import { A2AStreamUpdateEvent, A2AResultEvent } from './events.js';
+import { logger } from '../logging/logger.js';
+import { logExperimentalWarning } from './logging.js';
+/**
+ * Wraps a remote A2A agent as an InvokableAgent.
+ *
+ * Implements `InvokableAgent` so it can be used polymorphically with local `Agent` instances.
+ * On invocation, the agent lazily connects to the remote endpoint via the A2A protocol
+ * and returns the response as an `AgentResult`.
+ *
+ * @example
+ * ```typescript
+ * import { A2AAgent } from '@strands-agents/sdk/a2a'
+ *
+ * const remoteAgent = new A2AAgent({ url: 'http://localhost:9000' })
+ * const result = await remoteAgent.invoke('Hello, remote agent!')
+ * console.log(result.toString())
+ * ```
+ */
+export class A2AAgent {
+    _config;
+    _client;
+    _agentCard;
+    /**
+     * The unique identifier of the agent instance.
+     */
+    id;
+    /**
+     * The name of the agent.
+     * If not provided in config, populated from the agent card after connection.
+     */
+    name;
+    /**
+     * Optional description of what the agent does.
+     * If not provided in config, populated from the agent card after connection.
+     */
+    description;
+    /**
+     * Creates a new A2AAgent.
+     *
+     * @param config - Configuration for connecting to the remote agent
+     */
+    constructor(config) {
+        this._config = config;
+        this.id = config.id ?? config.url;
+        if (config.name !== undefined)
+            this.name = config.name;
+        if (config.description !== undefined)
+            this.description = config.description;
+    }
+    /**
+     * Invokes the remote agent and returns the final result.
+     *
+     * Built on top of `stream()` — consumes the full event stream and returns the final result.
+     *
+     * @param args - Arguments for invoking the agent
+     * @param options - Optional invocation options (unused for remote agents)
+     * @returns Promise that resolves to the AgentResult
+     */
+    async invoke(args, options) {
+        const gen = this.stream(args, options);
+        let next = await gen.next();
+        while (!next.done) {
+            next = await gen.next();
+        }
+        return next.value;
+    }
+    /**
+     * Streams the remote agent execution, yielding A2A events as they arrive.
+     *
+     * Yields `A2AStreamUpdateEvent` for each raw A2A protocol event (Message, Task,
+     * TaskStatusUpdateEvent, TaskArtifactUpdateEvent), followed by an `A2AResultEvent`
+     * containing the final result built from the last complete event.
+     *
+     * @param args - Arguments for invoking the agent
+     * @param _options - Optional invocation options (unused for remote agents)
+     * @returns Async generator that yields AgentStreamEvent objects and returns AgentResult
+     */
+    async *stream(args, _options) {
+        const client = await this._getClient();
+        const text = this._extractTextFromArgs(args);
+        let lastEvent;
+        let lastCompleteEvent;
+        const artifactTexts = new Map();
+        const eventStream = client.sendMessageStream({
+            message: {
+                kind: 'message',
+                messageId: globalThis.crypto.randomUUID(),
+                role: 'user',
+                parts: [{ kind: 'text', text }],
+            },
+        });
+        for await (const event of eventStream) {
+            lastEvent = event;
+            if (this._isCompleteEvent(event)) {
+                lastCompleteEvent = event;
+            }
+            if (event.kind === 'artifact-update') {
+                const id = event.artifact.artifactId;
+                if (!event.append) {
+                    artifactTexts.set(id, []);
+                }
+                const chunks = artifactTexts.get(id) ?? [];
+                const chunkText = this._textFromParts(event.artifact.parts);
+                if (chunkText) {
+                    chunks.push(chunkText);
+                    artifactTexts.set(id, chunks);
+                }
+            }
+            yield new A2AStreamUpdateEvent(event);
+        }
+        const finalEvent = lastCompleteEvent ?? lastEvent;
+        const accumulatedText = [...artifactTexts.values()].map((chunks) => chunks.join('')).join('\n');
+        const result = this._buildResult(finalEvent, accumulatedText);
+        yield new A2AResultEvent({ result });
+        return result;
+    }
+    /**
+     * Returns the cached A2A SDK client, creating one lazily on first use.
+     * Also fetches and caches the agent card for name/description.
+     *
+     * @returns The A2A SDK client
+     */
+    async _getClient() {
+        if (this._client) {
+            return this._client;
+        }
+        logExperimentalWarning();
+        const factory = new ClientFactory();
+        const client = await factory.createFromUrl(this._config.url, this._config.agentCardPath);
+        this._agentCard = await client.getAgentCard();
+        if (this.name === undefined && this._agentCard?.name) {
+            ;
+            this.name = this._agentCard.name;
+        }
+        if (this.description === undefined && this._agentCard?.description) {
+            ;
+            this.description = this._agentCard.description;
+        }
+        this._client = client;
+        return client;
+    }
+    /**
+     * Extracts a text string from InvokeArgs for sending to the remote agent.
+     *
+     * @param args - The invocation arguments
+     * @returns The extracted text string
+     */
+    _extractTextFromArgs(args) {
+        if (typeof args === 'string')
+            return args;
+        if (!Array.isArray(args) || args.length === 0)
+            return '';
+        // Message[] or MessageData[] — find last user message's content
+        if ('role' in args[0]) {
+            const messages = args;
+            const lastUser = messages
+                .slice()
+                .reverse()
+                .find((m) => m.role === 'user');
+            if (!lastUser)
+                return '';
+            args = lastUser instanceof Message ? lastUser.content : lastUser.content;
+        }
+        // ContentBlock[] or ContentBlockData[] — join text from all text blocks
+        const blocks = args;
+        const nonTextCount = blocks.filter((b) => ('type' in b ? b.type !== 'textBlock' : !('text' in b))).length;
+        if (nonTextCount > 0) {
+            logger.info(`non_text_blocks=<${nonTextCount}> | stripping non-text content blocks, a2a only supports text`);
+        }
+        return blocks
+            .filter((b) => ('type' in b ? b.type === 'textBlock' : 'text' in b))
+            .map((b) => b.text)
+            .join('\n');
+    }
+    /**
+     * Checks whether an A2A streaming event represents a complete response.
+     *
+     * @param event - The A2A streaming event
+     * @returns True if the event is a terminal/complete event
+     */
+    _isCompleteEvent(event) {
+        if (event.kind === 'message')
+            return true;
+        if (event.kind === 'task')
+            return true;
+        if (event.kind === 'artifact-update')
+            return event.lastChunk === true;
+        if (event.kind === 'status-update')
+            return event.status.state === 'completed';
+        return false;
+    }
+    /**
+     * Builds an AgentResult from the final A2A streaming event.
+     *
+     * @param event - The final A2A event, or undefined if no events were received
+     * @returns The constructed AgentResult
+     */
+    _buildResult(event, accumulatedText) {
+        const text = this._extractTextFromEvent(event) || accumulatedText || '';
+        const lastMessage = new Message({
+            role: 'assistant',
+            content: [new TextBlock(text)],
+        });
+        return new AgentResult({ stopReason: 'endTurn', lastMessage });
+    }
+    /**
+     * Extracts text content from an A2A streaming event.
+     *
+     * @param event - The A2A streaming event
+     * @returns Extracted text content
+     */
+    _extractTextFromEvent(event) {
+        if (!event)
+            return '';
+        if (event.kind === 'message') {
+            return this._textFromParts(event.parts);
+        }
+        if (event.kind === 'task') {
+            const parts = event.artifacts?.flatMap((a) => a.parts) ?? [];
+            return this._textFromParts(parts) || this._textFromParts(event.status?.message?.parts ?? []);
+        }
+        if (event.kind === 'artifact-update') {
+            return this._textFromParts(event.artifact.parts);
+        }
+        if (event.kind === 'status-update' && event.status.message) {
+            return this._textFromParts(event.status.message.parts);
+        }
+        return '';
+    }
+    /**
+     * Joins text from A2A parts, filtering out non-text parts.
+     *
+     * @param parts - Array of A2A parts
+     * @returns Joined text content
+     */
+    _textFromParts(parts) {
+        return parts
+            .filter((p) => p.kind === 'text')
+            .map((p) => p.text)
+            .join('\n');
+    }
+}
+//# sourceMappingURL=a2a-agent.js.map

package/dist/src/a2a/a2a-agent.js.map

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

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

@@ -0,0 +1,27 @@
+/**
+ * Conversion utilities between Strands SDK content blocks and A2A protocol parts.
+ *
+ * Supports text, images, videos, documents, and structured data.
+ */
+import type { Part } from '@a2a-js/sdk';
+import type { ContentBlock } from '../types/messages.js';
+/**
+ * Converts A2A protocol parts to Strands SDK content blocks.
+ *
+ * Handles text, file (image/video/document), and structured data parts,
+ * @param parts - Array of A2A protocol parts
+ * @returns Array of Strands content blocks
+ */
+export declare function partsToContentBlocks(parts: Part[]): ContentBlock[];
+/**
+ * Converts Strands SDK content blocks to A2A protocol parts.
+ *
+ * Supports text, image, video, and document blocks. Image and video blocks
+ * with byte sources are encoded as base64 file parts; URL-based sources
+ * become URI file parts. Unsupported block types are silently skipped.
+ *
+ * @param blocks - Array of Strands content blocks
+ * @returns Array of A2A parts
+ */
+export declare function contentBlocksToParts(blocks: ContentBlock[]): Part[];
+//# sourceMappingURL=adapters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../../src/a2a/adapters.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAA8B,MAAM,aAAa,CAAA;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAOxD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,YAAY,EAAE,CAsBlE;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,IAAI,EAAE,CAuBnE"}

package/dist/src/a2a/adapters.js

@@ -0,0 +1,175 @@
+/**
+ * Conversion utilities between Strands SDK content blocks and A2A protocol parts.
+ *
+ * Supports text, images, videos, documents, and structured data.
+ */
+import { TextBlock } from '../types/messages.js';
+import { toMimeType, toMediaFormat } from '../mime.js';
+import { ImageBlock, VideoBlock, DocumentBlock, decodeBase64, encodeBase64 } from '../types/media.js';
+import { logger } from '../logging/logger.js';
+/**
+ * Converts A2A protocol parts to Strands SDK content blocks.
+ *
+ * Handles text, file (image/video/document), and structured data parts,
+ * @param parts - Array of A2A protocol parts
+ * @returns Array of Strands content blocks
+ */
+export function partsToContentBlocks(parts) {
+    const blocks = [];
+    for (const part of parts) {
+        try {
+            switch (part.kind) {
+                case 'text':
+                    blocks.push(new TextBlock(part.text));
+                    break;
+                case 'file':
+                    blocks.push(_convertFilePart(part.file));
+                    break;
+                case 'data':
+                    blocks.push(new TextBlock(`[Structured Data]\n${JSON.stringify(part.data, null, 2)}`));
+                    break;
+            }
+        }
+        catch {
+            logger.warn(`part_kind=<${part.kind}> | failed to convert A2A part to content block`);
+        }
+    }
+    return blocks;
+}
+/**
+ * Converts Strands SDK content blocks to A2A protocol parts.
+ *
+ * Supports text, image, video, and document blocks. Image and video blocks
+ * with byte sources are encoded as base64 file parts; URL-based sources
+ * become URI file parts. Unsupported block types are silently skipped.
+ *
+ * @param blocks - Array of Strands content blocks
+ * @returns Array of A2A parts
+ */
+export function contentBlocksToParts(blocks) {
+    const parts = [];
+    for (const block of blocks) {
+        switch (block.type) {
+            case 'textBlock':
+                parts.push({ kind: 'text', text: block.text });
+                break;
+            case 'imageBlock':
+            case 'videoBlock': {
+                const filePart = _mediaBlockToFilePart(block);
+                if (filePart)
+                    parts.push(filePart);
+                break;
+            }
+            case 'documentBlock': {
+                const filePart = _documentBlockToFilePart(block);
+                if (filePart)
+                    parts.push(filePart);
+                break;
+            }
+        }
+    }
+    return parts;
+}
+/**
+ * Converts an A2A FilePart to the appropriate Strands content block.
+ *
+ * @param file - The file object from a FilePart (either bytes or URI based)
+ * @returns ContentBlock for the file
+ */
+function _convertFilePart(file) {
+    if ('bytes' in file) {
+        const decoded = decodeBase64(file.bytes);
+        const fileType = _getFileType(file.mimeType);
+        const format = _getFormat(file.mimeType, fileType);
+        if (fileType === 'image') {
+            return new ImageBlock({ format: format, source: { bytes: decoded } });
+        }
+        if (fileType === 'video') {
+            return new VideoBlock({ format: format, source: { bytes: decoded } });
+        }
+        // Document or unknown — treat as document
+        return new DocumentBlock({
+            name: file.name ?? 'document',
+            format: format,
+            source: { bytes: decoded },
+        });
+    }
+    const name = file.name ?? 'file';
+    return new TextBlock(`[File: ${name} (${file.uri})]`);
+}
+/**
+ * Classifies a MIME type into a file category.
+ *
+ * @param mimeType - The MIME type string
+ * @returns The file type category
+ */
+function _getFileType(mimeType) {
+    if (!mimeType) {
+        return 'unknown';
+    }
+    const lower = mimeType.toLowerCase();
+    if (lower.startsWith('image/'))
+        return 'image';
+    if (lower.startsWith('video/'))
+        return 'video';
+    if (lower.startsWith('text/') || lower.startsWith('application/'))
+        return 'document';
+    return 'unknown';
+}
+/**
+ * Resolves a MIME type to a Strands media format using the reverse MIME_TYPES lookup.
+ * Falls back to the MIME subtype for unrecognized types.
+ *
+ * @param mimeType - The MIME type string
+ * @param fileType - The classified file type
+ * @returns The format string
+ */
+function _getFormat(mimeType, fileType) {
+    if (!mimeType) {
+        return fileType === 'image' ? 'png' : fileType === 'video' ? 'mp4' : 'txt';
+    }
+    const lower = mimeType.toLowerCase();
+    // Use the reverse lookup (handles complex types like application/vnd.ms-excel → xls)
+    const known = toMediaFormat(lower);
+    if (known) {
+        return known;
+    }
+    // Fallback: extract subtype from MIME (e.g., image/tiff → tiff)
+    if (lower.includes('/')) {
+        return lower.split('/').pop();
+    }
+    return 'txt';
+}
+/**
+ * Converts an ImageBlock or VideoBlock to an A2A FilePart.
+ *
+ * @param block - The image or video block
+ * @returns A2A FilePart, or undefined if the source type is unsupported
+ */
+function _mediaBlockToFilePart(block) {
+    const mimeType = toMimeType(block.format);
+    if (block.source.type === 'imageSourceBytes' || block.source.type === 'videoSourceBytes') {
+        return { kind: 'file', file: { bytes: encodeBase64(block.source.bytes), mimeType } };
+    }
+    if (block.source.type === 'imageSourceUrl') {
+        return { kind: 'file', file: { uri: block.source.url, mimeType } };
+    }
+    return undefined;
+}
+/**
+ * Converts a DocumentBlock to an A2A FilePart.
+ *
+ * @param block - The document block
+ * @returns A2A FilePart, or undefined if the source type is unsupported
+ */
+function _documentBlockToFilePart(block) {
+    const mimeType = toMimeType(block.format);
+    if (block.source.type === 'documentSourceBytes') {
+        return { kind: 'file', file: { bytes: encodeBase64(block.source.bytes), mimeType, name: block.name } };
+    }
+    if (block.source.type === 'documentSourceText') {
+        return { kind: 'text', text: block.source.text };
+    }
+    return undefined;
+}
+//# sourceMappingURL=adapters.js.map

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

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

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

@@ -0,0 +1,42 @@
+/**
+ * A2A-specific stream events yielded by A2AAgent.stream().
+ */
+import type { Message, Task, TaskStatusUpdateEvent, TaskArtifactUpdateEvent } from '@a2a-js/sdk';
+import { StreamEvent } from '../hooks/events.js';
+import type { AgentResultEvent } from '../hooks/events.js';
+/**
+ * Union of raw A2A protocol event types received during streaming.
+ */
+export type A2AEventData = Message | Task | TaskStatusUpdateEvent | TaskArtifactUpdateEvent;
+/**
+ * Event wrapping a raw A2A protocol streaming event.
+ *
+ * Yielded by `A2AAgent.stream()` for each event received from the remote agent.
+ * The `event` property contains the raw A2A SDK event data, discriminated by `kind`:
+ * - `'message'` — A2A Message
+ * - `'task'` — A2A Task
+ * - `'status-update'` — TaskStatusUpdateEvent
+ * - `'artifact-update'` — TaskArtifactUpdateEvent
+ */
+export declare class A2AStreamUpdateEvent extends StreamEvent {
+    readonly type: "a2aStreamUpdateEvent";
+    readonly event: A2AEventData;
+    constructor(event: A2AEventData);
+}
+/**
+ * Event triggered as the final event in the A2A agent stream.
+ * Wraps the agent result containing the stop reason and last message.
+ */
+export declare class A2AResultEvent extends StreamEvent {
+    readonly type: "a2aResultEvent";
+    readonly result: AgentResultEvent['result'];
+    constructor(data: Pick<AgentResultEvent, 'result'>);
+}
+/**
+ * Union of all events yielded by `A2AAgent.stream()`.
+ *
+ * Includes raw A2A protocol events ({@link A2AStreamUpdateEvent}) and the final
+ * result event ({@link A2AResultEvent}).
+ */
+export type A2AStreamEvent = A2AStreamUpdateEvent | A2AResultEvent;
+//# sourceMappingURL=events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/a2a/events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAChG,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAE1D;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,IAAI,GAAG,qBAAqB,GAAG,uBAAuB,CAAA;AAE3F;;;;;;;;;GASG;AACH,qBAAa,oBAAqB,SAAQ,WAAW;IACnD,QAAQ,CAAC,IAAI,EAAG,sBAAsB,CAAS;IAC/C,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAA;gBAEhB,KAAK,EAAE,YAAY;CAIhC;AAED;;;GAGG;AACH,qBAAa,cAAe,SAAQ,WAAW;IAC7C,QAAQ,CAAC,IAAI,EAAG,gBAAgB,CAAS;IACzC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAA;gBAE/B,IAAI,EAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC;CAInD;AAED;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,oBAAoB,GAAG,cAAc,CAAA"}

package/dist/src/a2a/events.js

@@ -0,0 +1,35 @@
+/**
+ * A2A-specific stream events yielded by A2AAgent.stream().
+ */
+import { StreamEvent } from '../hooks/events.js';
+/**
+ * Event wrapping a raw A2A protocol streaming event.
+ *
+ * Yielded by `A2AAgent.stream()` for each event received from the remote agent.
+ * The `event` property contains the raw A2A SDK event data, discriminated by `kind`:
+ * - `'message'` — A2A Message
+ * - `'task'` — A2A Task
+ * - `'status-update'` — TaskStatusUpdateEvent
+ * - `'artifact-update'` — TaskArtifactUpdateEvent
+ */
+export class A2AStreamUpdateEvent extends StreamEvent {
+    type = 'a2aStreamUpdateEvent';
+    event;
+    constructor(event) {
+        super();
+        this.event = event;
+    }
+}
+/**
+ * Event triggered as the final event in the A2A agent stream.
+ * Wraps the agent result containing the stop reason and last message.
+ */
+export class A2AResultEvent extends StreamEvent {
+    type = 'a2aResultEvent';
+    result;
+    constructor(data) {
+        super();
+        this.result = data.result;
+    }
+}
+//# sourceMappingURL=events.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/a2a/events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAQhD;;;;;;;;;GASG;AACH,MAAM,OAAO,oBAAqB,SAAQ,WAAW;IAC1C,IAAI,GAAG,sBAA+B,CAAA;IACtC,KAAK,CAAc;IAE5B,YAAY,KAAmB;QAC7B,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,cAAe,SAAQ,WAAW;IACpC,IAAI,GAAG,gBAAyB,CAAA;IAChC,MAAM,CAA4B;IAE3C,YAAY,IAAsC;QAChD,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;IAC3B,CAAC;CACF"}

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

@@ -0,0 +1,57 @@
+/**
+ * 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 type { ExecutionEventBus, RequestContext } from '@a2a-js/sdk/server';
+import type { AgentExecutor } from '@a2a-js/sdk/server';
+import type { InvokableAgent } from '../types/agent.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 declare class A2AExecutor implements AgentExecutor {
+    private _agent;
+    /**
+     * Creates a new A2AExecutor.
+     *
+     * @param agent - The agent to execute for incoming A2A requests
+     */
+    constructor(agent: InvokableAgent);
+    /**
+     * 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>;
+    /**
+     * 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
+     */
+    cancelTask(_taskId: string, _eventBus: ExecutionEventBus): Promise<void>;
+}
+//# sourceMappingURL=executor.d.ts.map

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

@@ -0,0 +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;;;;;;;;;;;;;;;;GAgBG;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;IA+ElF;;;;;OAKG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;CAG/E"}