@strands-agents/sdk 0.5.0 → 0.7.0

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

@@ -0,0 +1,196 @@
+import { describe, expect, it, vi } from 'vitest';
+import { A2AExecutor } from '../executor.js';
+import { Agent } from '../../agent/agent.js';
+import { MockMessageModel } from '../../__fixtures__/mock-message-model.js';
+import { createMockAgent } from '../../__fixtures__/agent-helpers.js';
+import { TextBlock } from '../../types/messages.js';
+import { ImageBlock, encodeBase64 } from '../../types/media.js';
+import { ContentBlockEvent, ModelStreamUpdateEvent } from '../../hooks/events.js';
+import { AgentResult } from '../../types/agent.js';
+import { Message } from '../../types/messages.js';
+function createMockEventBus() {
+    const events = [];
+    return {
+        events,
+        publish: vi.fn((event) => {
+            events.push(event);
+        }),
+        on: vi.fn().mockReturnThis(),
+        off: vi.fn().mockReturnThis(),
+        once: vi.fn().mockReturnThis(),
+        removeAllListeners: vi.fn().mockReturnThis(),
+        finished: vi.fn(),
+    };
+}
+function createRequestContext(text, taskId = 'task-1') {
+    return {
+        taskId,
+        contextId: 'ctx-1',
+        userMessage: {
+            kind: 'message',
+            messageId: 'msg-1',
+            role: 'user',
+            parts: [{ kind: 'text', text }],
+        },
+    };
+}
+describe('A2AExecutor', () => {
+    describe('execute', () => {
+        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 eventBus = createMockEventBus();
+            await executor.execute(createRequestContext('Hello agent'), eventBus);
+            // First event registers the task with the ResultManager
+            expect(eventBus.events[0]).toStrictEqual({
+                kind: 'task',
+                id: 'task-1',
+                contextId: 'ctx-1',
+                status: { state: 'working' },
+            });
+            const artifactEvents = eventBus.events.filter((e) => e.kind === 'artifact-update');
+            const statusEvents = eventBus.events.filter((e) => e.kind === 'status-update');
+            // Should have at least 2 artifact events (text delta + lastChunk)
+            expect(artifactEvents.length).toBeGreaterThanOrEqual(2);
+            // First artifact: text delta, creates new artifact
+            expect(artifactEvents[0]).toStrictEqual({
+                kind: 'artifact-update',
+                taskId: 'task-1',
+                contextId: 'ctx-1',
+                append: false,
+                artifact: { artifactId: expect.any(String), parts: [{ kind: 'text', text: 'Agent response' }] },
+            });
+            // Last artifact: lastChunk marker, appends to existing artifact
+            expect(artifactEvents[artifactEvents.length - 1]).toStrictEqual(expect.objectContaining({ append: true, lastChunk: true }));
+            // All artifact events share the same artifactId
+            const artifactId = artifactEvents[0].artifact.artifactId;
+            for (const event of artifactEvents) {
+                expect(event.artifact.artifactId).toBe(artifactId);
+            }
+            // Only completed status — no working status (A2A-compliant streaming)
+            expect(statusEvents).toStrictEqual([
+                { kind: 'status-update', taskId: 'task-1', contextId: 'ctx-1', status: { state: 'completed' }, final: true },
+            ]);
+        });
+        it('sets append to true for subsequent chunks after the first', async () => {
+            const model = new MockMessageModel().addTurn([
+                { type: 'textBlock', text: 'First' },
+                { type: 'textBlock', text: 'Second' },
+            ]);
+            const agent = new Agent({ model, printer: false });
+            const executor = new A2AExecutor(agent);
+            const eventBus = createMockEventBus();
+            await executor.execute(createRequestContext('Hello'), eventBus);
+            const artifactEvents = eventBus.events.filter((e) => e.kind === 'artifact-update');
+            // 2 text deltas + 1 lastChunk
+            expect(artifactEvents).toHaveLength(3);
+            expect(artifactEvents.map((e) => e.append)).toStrictEqual([false, true, true]);
+            expect(artifactEvents[2].lastChunk).toBe(true);
+        });
+        it('converts A2A parts to content blocks and passes to stream', async () => {
+            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 eventBus = createMockEventBus();
+            const context = {
+                taskId: 'task-1',
+                contextId: 'ctx-1',
+                userMessage: {
+                    kind: 'message',
+                    messageId: 'msg-1',
+                    role: 'user',
+                    parts: [
+                        { kind: 'text', text: 'Line 1' },
+                        { kind: 'file', file: { uri: 'file://test.txt' } },
+                        { kind: 'text', text: 'Line 2' },
+                    ],
+                },
+            };
+            await executor.execute(context, eventBus);
+            expect(agent.stream).toHaveBeenCalledWith([
+                new TextBlock('Line 1'),
+                new TextBlock('[File: file (file://test.txt)]'),
+                new TextBlock('Line 2'),
+            ]);
+        });
+        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 eventBus = createMockEventBus();
+            await expect(executor.execute(createRequestContext('Hello'), eventBus)).rejects.toThrow('Agent failed');
+            // Only the initial task registration event is published before the error
+            expect(eventBus.events).toStrictEqual([
+                { kind: 'task', id: 'task-1', contextId: 'ctx-1', status: { state: 'working' } },
+            ]);
+        });
+        it('publishes image content blocks as separate file artifacts', async () => {
+            const imageBytes = new Uint8Array([137, 80, 78, 71]);
+            const mockAgent = {
+                id: 'test-agent',
+                name: 'Test Agent',
+                invoke: vi.fn(),
+                async *stream() {
+                    const agent = createMockAgent();
+                    // Text delta
+                    yield new ModelStreamUpdateEvent({
+                        agent,
+                        event: { type: 'modelContentBlockDeltaEvent', delta: { type: 'textDelta', text: 'Here is the image:' } },
+                    });
+                    // Image content block
+                    yield new ContentBlockEvent({
+                        agent,
+                        contentBlock: new ImageBlock({ format: 'png', source: { bytes: imageBytes } }),
+                    });
+                    return new AgentResult({
+                        stopReason: 'endTurn',
+                        lastMessage: new Message({ role: 'assistant', content: [new TextBlock('Here is the image:')] }),
+                    });
+                },
+            };
+            const executor = new A2AExecutor(mockAgent);
+            const eventBus = createMockEventBus();
+            await executor.execute(createRequestContext('Generate an image'), eventBus);
+            const artifactEvents = eventBus.events.filter((e) => e.kind === 'artifact-update');
+            // text delta + image artifact + final text lastChunk = 3
+            expect(artifactEvents).toHaveLength(3);
+            // First: text delta
+            expect(artifactEvents[0].artifact.parts).toStrictEqual([{ kind: 'text', text: 'Here is the image:' }]);
+            // Second: image as file part with its own artifactId
+            expect(artifactEvents[1].artifact.artifactId).not.toBe(artifactEvents[0].artifact.artifactId);
+            expect(artifactEvents[1].lastChunk).toBe(true);
+            expect(artifactEvents[1].append).toBe(false);
+            expect(artifactEvents[1].artifact.parts).toStrictEqual([
+                { kind: 'file', file: { bytes: encodeBase64(imageBytes), mimeType: 'image/png' } },
+            ]);
+            // Third: final text lastChunk
+            expect(artifactEvents[2].lastChunk).toBe(true);
+        });
+        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 eventBus = createMockEventBus();
+            const context = {
+                taskId: 'task-1',
+                contextId: 'ctx-1',
+                userMessage: { kind: 'message', messageId: 'msg-1', role: 'user', parts: [] },
+            };
+            await expect(executor.execute(context, eventBus)).rejects.toThrow('No content blocks available');
+            expect(eventBus.events).toStrictEqual([]);
+        });
+    });
+    describe('cancelTask', () => {
+        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 eventBus = createMockEventBus();
+            await expect(executor.cancelTask('task-1', eventBus)).rejects.toThrow('Task cancellation is not supported');
+            expect(eventBus.events).toStrictEqual([]);
+        });
+    });
+});
+//# sourceMappingURL=executor.test.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,51 @@
+import { describe, expect, it, vi } from 'vitest';
+import { A2AServer } from '../server.js';
+import { Agent } from '../../agent/agent.js';
+import { MockMessageModel } from '../../__fixtures__/mock-message-model.js';
+describe('A2AServer', () => {
+    describe('constructor', () => {
+        it('builds agent card with provided values', () => {
+            const model = new MockMessageModel().addTurn({ type: 'textBlock', text: 'Hello' });
+            const server = new A2AServer({
+                agent: new Agent({ model, printer: false }),
+                name: 'Base Agent',
+                description: 'A base agent',
+                httpUrl: 'http://example.com',
+                version: '2.0.0',
+            });
+            expect(server.agentCard).toStrictEqual({
+                name: 'Base Agent',
+                description: 'A base agent',
+                version: '2.0.0',
+                protocolVersion: '0.2.0',
+                url: 'http://example.com',
+                defaultInputModes: ['text/plain'],
+                defaultOutputModes: ['text/plain'],
+                skills: [],
+                capabilities: { streaming: true },
+            });
+        });
+        it('uses default values when optional config is omitted', () => {
+            const model = new MockMessageModel().addTurn({ type: 'textBlock', text: 'Hello' });
+            const server = new A2AServer({
+                agent: new Agent({ model, printer: false }),
+                name: 'Minimal Agent',
+            });
+            expect(server.agentCard.description).toBe('');
+            expect(server.agentCard.version).toBe('0.0.1');
+            expect(server.agentCard.url).toBe('');
+            expect(server.agentCard.skills).toStrictEqual([]);
+        });
+        it('accepts custom taskStore', () => {
+            const model = new MockMessageModel().addTurn({ type: 'textBlock', text: 'Hello' });
+            const taskStore = { save: vi.fn(), load: vi.fn() };
+            const server = new A2AServer({
+                agent: new Agent({ model, printer: false }),
+                name: 'Agent',
+                taskStore,
+            });
+            expect(server.agentCard).toBeDefined();
+        });
+    });
+});
+//# sourceMappingURL=server.test.js.map

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

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

package/dist/src/a2a/__tests__/server.test.node.d.ts

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

package/dist/src/a2a/__tests__/server.test.node.d.ts.map

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

package/dist/src/a2a/__tests__/server.test.node.js

@@ -0,0 +1,110 @@
+import { describe, expect, it, vi } from 'vitest';
+import { A2AExpressServer } from '../express-server.js';
+import { A2AServer } from '../server.js';
+import { Agent } from '../../agent/agent.js';
+import { MockMessageModel } from '../../__fixtures__/mock-message-model.js';
+// Mock express
+vi.mock('express', () => {
+    const mockRouter = {
+        get: vi.fn(),
+        post: vi.fn(),
+        use: vi.fn(),
+    };
+    const mockApp = {
+        use: vi.fn(),
+        listen: vi.fn((_port, _host, cb) => {
+            cb();
+            return { on: vi.fn(), close: vi.fn(), address: () => ({ port: _port || 54321 }) };
+        }),
+    };
+    const express = Object.assign(vi.fn(() => mockApp), {
+        Router: vi.fn(() => mockRouter),
+        json: vi.fn(() => 'json-middleware'),
+    });
+    return { default: express };
+});
+// Mock A2A SDK express middleware
+const mockAgentCardHandler = vi.fn(() => 'agent-card-handler');
+const mockJsonRpcHandler = vi.fn(() => 'json-rpc-handler');
+vi.mock('@a2a-js/sdk/server/express', () => ({
+    agentCardHandler: (...args) => mockAgentCardHandler(...args),
+    jsonRpcHandler: (...args) => mockJsonRpcHandler(...args),
+    UserBuilder: { noAuthentication: vi.fn() },
+}));
+function createTestConfig(overrides) {
+    const model = new MockMessageModel().addTurn({ type: 'textBlock', text: 'Hello' });
+    return {
+        agent: new Agent({ model, printer: false }),
+        name: 'Test Agent',
+        ...overrides,
+    };
+}
+describe('A2AExpressServer', () => {
+    describe('constructor', () => {
+        it('builds agent card with default values', () => {
+            const server = new A2AExpressServer(createTestConfig());
+            expect(server.agentCard).toStrictEqual({
+                name: 'Test Agent',
+                description: '',
+                version: '0.0.1',
+                protocolVersion: '0.2.0',
+                url: 'http://127.0.0.1:9000',
+                defaultInputModes: ['text/plain'],
+                defaultOutputModes: ['text/plain'],
+                skills: [],
+                capabilities: { streaming: true },
+            });
+        });
+        it('uses custom config values', () => {
+            const server = new A2AExpressServer(createTestConfig({
+                description: 'A helpful agent',
+                host: '0.0.0.0',
+                port: 8080,
+                version: '1.0.0',
+                skills: [{ id: 'skill-1', name: 'Skill 1', description: 'A skill', tags: [] }],
+            }));
+            expect(server.agentCard).toStrictEqual({
+                name: 'Test Agent',
+                description: 'A helpful agent',
+                version: '1.0.0',
+                protocolVersion: '0.2.0',
+                url: 'http://0.0.0.0:8080',
+                defaultInputModes: ['text/plain'],
+                defaultOutputModes: ['text/plain'],
+                skills: [{ id: 'skill-1', name: 'Skill 1', description: 'A skill', tags: [] }],
+                capabilities: { streaming: true },
+            });
+        });
+        it('uses httpUrl override when provided', () => {
+            const server = new A2AExpressServer(createTestConfig({ httpUrl: 'https://my-agent.example.com' }));
+            expect(server.agentCard.url).toBe('https://my-agent.example.com');
+        });
+        it('accepts custom taskStore', () => {
+            const taskStore = { save: vi.fn(), load: vi.fn() };
+            const server = new A2AExpressServer(createTestConfig({ taskStore }));
+            expect(server.agentCard).toBeDefined();
+        });
+        it('is an instance of A2AServer', () => {
+            const server = new A2AExpressServer(createTestConfig());
+            expect(server).toBeInstanceOf(A2AServer);
+        });
+    });
+    describe('createMiddleware', () => {
+        it('returns an express router with SDK middleware', async () => {
+            const server = new A2AExpressServer(createTestConfig());
+            const router = server.createMiddleware();
+            expect(router).toBeDefined();
+            expect(router.use).toHaveBeenCalledTimes(2);
+            expect(router.use).toHaveBeenCalledWith('/.well-known/agent-card.json', 'agent-card-handler');
+            expect(router.use).toHaveBeenCalledWith('/', 'json-rpc-handler');
+            expect(mockAgentCardHandler).toHaveBeenCalledWith({
+                agentCardProvider: expect.objectContaining({ getAgentCard: expect.any(Function) }),
+            });
+            expect(mockJsonRpcHandler).toHaveBeenCalledWith({
+                requestHandler: expect.anything(),
+                userBuilder: expect.anything(),
+            });
+        });
+    });
+});
+//# sourceMappingURL=server.test.node.js.map

package/dist/src/a2a/__tests__/server.test.node.js.map

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

package/dist/src/a2a/a2a-agent.d.ts

@@ -0,0 +1,132 @@
+/**
+ * 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 type { InvokableAgent, InvokeArgs, InvokeOptions } from '../types/agent.js';
+import { AgentResult } from '../types/agent.js';
+import { type A2AStreamEvent } from './events.js';
+/**
+ * Configuration options for creating an A2AAgent.
+ */
+export interface A2AAgentConfig {
+    /** Base URL of the remote A2A agent */
+    url: string;
+    /** Path to the agent card endpoint (default: '/.well-known/agent-card.json') */
+    agentCardPath?: string;
+    /** Optional unique identifier. Defaults to the URL. */
+    id?: string;
+    /** Optional name. If not provided, populated from the agent card after connection. */
+    name?: string;
+    /** Optional description. If not provided, populated from the agent card after connection. */
+    description?: string;
+}
+/**
+ * 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 declare class A2AAgent implements InvokableAgent {
+    private _config;
+    private _client;
+    private _agentCard;
+    /**
+     * The unique identifier of the agent instance.
+     */
+    readonly id: string;
+    /**
+     * The name of the agent.
+     * If not provided in config, populated from the agent card after connection.
+     */
+    readonly name?: string;
+    /**
+     * Optional description of what the agent does.
+     * If not provided in config, populated from the agent card after connection.
+     */
+    readonly description?: string;
+    /**
+     * Creates a new A2AAgent.
+     *
+     * @param config - Configuration for connecting to the remote agent
+     */
+    constructor(config: A2AAgentConfig);
+    /**
+     * 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
+     */
+    invoke(args: InvokeArgs, options?: InvokeOptions): Promise<AgentResult>;
+    /**
+     * 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
+     */
+    stream(args: InvokeArgs, _options?: InvokeOptions): AsyncGenerator<A2AStreamEvent, AgentResult, undefined>;
+    /**
+     * 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
+     */
+    private _getClient;
+    /**
+     * Extracts a text string from InvokeArgs for sending to the remote agent.
+     *
+     * @param args - The invocation arguments
+     * @returns The extracted text string
+     */
+    private _extractTextFromArgs;
+    /**
+     * 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
+     */
+    private _isCompleteEvent;
+    /**
+     * 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
+     */
+    private _buildResult;
+    /**
+     * Extracts text content from an A2A streaming event.
+     *
+     * @param event - The A2A streaming event
+     * @returns Extracted text content
+     */
+    private _extractTextFromEvent;
+    /**
+     * Joins text from A2A parts, filtering out non-text parts.
+     *
+     * @param parts - Array of A2A parts
+     * @returns Joined text content
+     */
+    private _textFromParts;
+}
+//# sourceMappingURL=a2a-agent.d.ts.map

package/dist/src/a2a/a2a-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a-agent.d.ts","sourceRoot":"","sources":["../../../src/a2a/a2a-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAClF,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C,OAAO,EAA2D,KAAK,cAAc,EAAE,MAAM,aAAa,CAAA;AAI1G;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAA;IACX,gFAAgF;IAChF,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,uDAAuD;IACvD,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,sFAAsF;IACtF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,6FAA6F;IAC7F,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,QAAS,YAAW,cAAc;IAC7C,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,UAAU,CAAuB;IAEzC;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IAEnB;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IAEtB;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAE7B;;;;OAIG;gBACS,MAAM,EAAE,cAAc;IAOlC;;;;;;;;OAQG;IACG,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC;IAS7E;;;;;;;;;;OAUG;IACI,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,cAAc,CAAC,cAAc,EAAE,WAAW,EAAE,SAAS,CAAC;IA6CjH;;;;;OAKG;YACW,UAAU;IAoBxB;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IA4B5B;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IASpB;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;IAkB7B;;;;;OAKG;IACH,OAAO,CAAC,cAAc;CAMvB"}