@strands-agents/sdk 0.3.0 → 0.5.0

package/dist/src/multiagent/__tests__/nodes.test.js

@@ -0,0 +1,194 @@
+import { beforeEach, describe, expect, it } from 'vitest';
+import { z } from 'zod';
+import { Agent } from '../../agent/agent.js';
+import { MockMessageModel } from '../../__fixtures__/mock-message-model.js';
+import { collectGenerator } from '../../__fixtures__/model-test-helpers.js';
+import { TextBlock } from '../../types/messages.js';
+import { MultiAgentResult, MultiAgentState, NodeResult, Status } from '../state.js';
+import { MultiAgentHandoffEvent, NodeStreamUpdateEvent } from '../events.js';
+import { AgentNode, MultiAgentNode, Node } from '../nodes.js';
+/**
+ * Concrete Node subclass for testing the abstract base class.
+ */
+class TestNode extends Node {
+    _fn;
+    constructor(id, fn) {
+        super(id, {});
+        this._fn = fn;
+    }
+    async *handle(args, state) {
+        return yield* this._fn(args, state);
+    }
+}
+describe('Node', () => {
+    let state;
+    beforeEach(() => {
+        state = new MultiAgentState();
+    });
+    describe('stream', () => {
+        it('returns COMPLETED NodeResult on successful execution', async () => {
+            const content = [new TextBlock('result')];
+            // eslint-disable-next-line require-yield
+            const node = new TestNode('test-node', async function* () {
+                return { content };
+            });
+            const { result } = await collectGenerator(node.stream([], state));
+            expect(result).toEqual({
+                type: 'nodeResult',
+                nodeId: 'test-node',
+                status: Status.COMPLETED,
+                content,
+                duration: expect.any(Number),
+            });
+        });
+        it('catches errors and returns FAILED NodeResult', async () => {
+            // eslint-disable-next-line require-yield
+            const node = new TestNode('fail-node', async function* () {
+                throw new Error('boom');
+            });
+            const { result } = await collectGenerator(node.stream([], state));
+            expect(result).toEqual({
+                type: 'nodeResult',
+                nodeId: 'fail-node',
+                status: Status.FAILED,
+                content: [],
+                duration: expect.any(Number),
+                error: expect.objectContaining({ message: 'boom' }),
+            });
+        });
+    });
+});
+describe('AgentNode', () => {
+    let agent;
+    let node;
+    let state;
+    beforeEach(() => {
+        const model = new MockMessageModel().addTurn(new TextBlock('reply'));
+        agent = new Agent({ model, printer: false, state: { key1: 'value1' } });
+        node = new AgentNode({ id: 'agent-1', agent });
+        state = new MultiAgentState();
+    });
+    describe('handle', () => {
+        it('wraps agent events and returns content', async () => {
+            const { items, result } = await collectGenerator(node.stream([new TextBlock('prompt')], state));
+            const streamEvents = items.filter((e) => e.type === 'nodeStreamUpdateEvent');
+            expect(streamEvents.length).toBeGreaterThan(0);
+            for (const event of streamEvents) {
+                expect(event).toEqual(expect.objectContaining({ type: 'nodeStreamUpdateEvent', nodeId: 'agent-1', nodeType: 'agentNode' }));
+            }
+            const resultEvent = items.find((e) => e.type === 'nodeResultEvent');
+            expect(resultEvent).toEqual(expect.objectContaining({ type: 'nodeResultEvent', nodeId: 'agent-1', nodeType: 'agentNode', result }));
+            expect(result).toEqual({
+                type: 'nodeResult',
+                nodeId: 'agent-1',
+                status: Status.COMPLETED,
+                content: expect.arrayContaining([expect.objectContaining({ type: 'textBlock', text: 'reply' })]),
+                duration: expect.any(Number),
+            });
+        });
+        it('restores agent messages and state after execution', async () => {
+            const messagesBefore = [...agent.messages];
+            const stateBefore = agent.state.getAll();
+            await collectGenerator(node.stream([new TextBlock('prompt')], state));
+            expect(agent.messages).toStrictEqual(messagesBefore);
+            expect(agent.state.getAll()).toStrictEqual(stateBefore);
+        });
+        it('passes structuredOutputSchema from state to the agent', async () => {
+            const schema = z.object({ agentName: z.string().optional(), message: z.string() });
+            const model = new MockMessageModel()
+                .addTurn({
+                type: 'toolUseBlock',
+                name: 'strands_structured_output',
+                toolUseId: 'tool-1',
+                input: { message: 'hello' },
+            })
+                .addTurn({ type: 'textBlock', text: 'Done' });
+            agent = new Agent({ model, printer: false });
+            node = new AgentNode({ id: 'schema-agent', agent });
+            state = new MultiAgentState({ structuredOutputSchema: schema });
+            const { result } = await collectGenerator(node.stream('test', state));
+            expect(result.structuredOutput).toStrictEqual({ message: 'hello' });
+        });
+    });
+    describe('agent', () => {
+        it('exposes the wrapped agent instance', () => {
+            expect(node.agent).toBe(agent);
+        });
+    });
+});
+describe('MultiAgentNode', () => {
+    const content = [new TextBlock('inner-result')];
+    /**
+     * Creates a mock orchestrator that yields the given events and returns a result with the given content.
+     */
+    function mockOrchestrator(id, events) {
+        return {
+            id,
+            invoke: async () => new MultiAgentResult({ results: [], duration: 0 }),
+            async *stream() {
+                for (const event of events) {
+                    yield event;
+                }
+                return new MultiAgentResult({
+                    results: [new NodeResult({ nodeId: id, status: Status.COMPLETED, duration: 0, content })],
+                    content,
+                    duration: 0,
+                });
+            },
+        };
+    }
+    let node;
+    let state;
+    beforeEach(() => {
+        const orchestrator = mockOrchestrator('inner', []);
+        node = new MultiAgentNode({ orchestrator });
+        state = new MultiAgentState();
+    });
+    describe('constructor', () => {
+        it('derives id from orchestrator', () => {
+            expect(node.id).toBe('inner');
+        });
+    });
+    describe('handle', () => {
+        it('passes through inner NodeStreamUpdateEvents', async () => {
+            const innerUpdate = new MultiAgentHandoffEvent({ source: 'x', targets: ['y'] });
+            const innerEvent = new NodeStreamUpdateEvent({
+                nodeId: 'deep-node',
+                nodeType: 'agentNode',
+                event: innerUpdate,
+            });
+            const orchestrator = mockOrchestrator('inner', [innerEvent]);
+            node = new MultiAgentNode({ orchestrator });
+            const { items } = await collectGenerator(node.stream([], state));
+            const streamEvents = items.filter((e) => e.type === 'nodeStreamUpdateEvent');
+            const passthrough = streamEvents.find((e) => e.nodeId === 'deep-node');
+            expect(passthrough).toBe(innerEvent);
+        });
+        it('wraps non-NodeStreamUpdateEvents with this node identity', async () => {
+            const handoff = new MultiAgentHandoffEvent({ source: 'a', targets: ['b'] });
+            const orchestrator = mockOrchestrator('inner', [handoff]);
+            node = new MultiAgentNode({ orchestrator });
+            const { items } = await collectGenerator(node.stream([], state));
+            const streamEvents = items.filter((e) => e.type === 'nodeStreamUpdateEvent');
+            const wrapped = streamEvents.find((e) => e.nodeId === 'inner' && e.event === handoff);
+            expect(wrapped).toBeDefined();
+            expect(wrapped.nodeType).toBe('multiAgentNode');
+        });
+        it('returns orchestrator content', async () => {
+            const { result } = await collectGenerator(node.stream([], state));
+            expect(result).toEqual(expect.objectContaining({
+                nodeId: 'inner',
+                status: Status.COMPLETED,
+                content,
+            }));
+        });
+    });
+    describe('orchestrator', () => {
+        it('exposes the wrapped orchestrator instance', () => {
+            const orchestrator = mockOrchestrator('test', []);
+            node = new MultiAgentNode({ orchestrator });
+            expect(node.orchestrator).toBe(orchestrator);
+        });
+    });
+});
+//# sourceMappingURL=nodes.test.js.map

package/dist/src/multiagent/__tests__/nodes.test.js.map

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

package/dist/src/multiagent/__tests__/queue.test.d.ts

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

package/dist/src/multiagent/__tests__/queue.test.d.ts.map

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

package/dist/src/multiagent/__tests__/queue.test.js

@@ -0,0 +1,96 @@
+import { beforeEach, describe, expect, it } from 'vitest';
+import { Queue } from '../queue.js';
+import { NodeResult, Status } from '../state.js';
+describe('Queue', () => {
+    let queue;
+    let mockNode;
+    beforeEach(() => {
+        mockNode = { id: 'node-1' };
+        queue = new Queue();
+    });
+    describe('push and shift', () => {
+        it('dequeues in FIFO order', () => {
+            const data1 = {
+                type: 'result',
+                node: mockNode,
+                result: new NodeResult({ nodeId: 'node-1', status: Status.COMPLETED, duration: 10 }),
+            };
+            const data2 = { type: 'error', node: mockNode, error: new Error('fail') };
+            queue.push(data1);
+            queue.push(data2);
+            expect(queue.shift()?.data).toBe(data1);
+            expect(queue.shift()?.data).toBe(data2);
+        });
+        it('returns undefined when empty', () => {
+            expect(queue.shift()).toBeUndefined();
+        });
+        it('provides a no-op ack for fire-and-forget pushes', () => {
+            queue.push({ type: 'error', node: mockNode, error: new Error('a') });
+            const entry = queue.shift();
+            expect(() => entry.ack()).not.toThrow();
+        });
+    });
+    describe('send', () => {
+        it('resolves when consumer calls ack', async () => {
+            const data = { type: 'error', node: mockNode, error: new Error('a') };
+            let resolved = false;
+            const waiting = queue.send(data).then(() => {
+                resolved = true;
+            });
+            await Promise.resolve();
+            expect(resolved).toBe(false);
+            const entry = queue.shift();
+            expect(entry.data).toBe(data);
+            await Promise.resolve();
+            expect(resolved).toBe(false);
+            entry.ack();
+            await waiting;
+            expect(resolved).toBe(true);
+        });
+    });
+    describe('size', () => {
+        it('reflects the current number of entries', () => {
+            expect(queue.size).toBe(0);
+            queue.push({ type: 'error', node: mockNode, error: new Error('a') });
+            queue.push({ type: 'error', node: mockNode, error: new Error('b') });
+            expect(queue.size).toBe(2);
+            queue.shift();
+            expect(queue.size).toBe(1);
+        });
+    });
+    describe('wait', () => {
+        it('resolves immediately when entries are available', async () => {
+            queue.push({ type: 'error', node: mockNode, error: new Error('a') });
+            await queue.wait();
+            expect(queue.size).toBe(1);
+        });
+        it('blocks until data is pushed', async () => {
+            let resolved = false;
+            const waiting = queue.wait().then(() => {
+                resolved = true;
+            });
+            await Promise.resolve();
+            expect(resolved).toBe(false);
+            queue.push({ type: 'error', node: mockNode, error: new Error('a') });
+            await waiting;
+            expect(resolved).toBe(true);
+        });
+        it('blocks until data is sent', async () => {
+            let resolved = false;
+            const waiting = queue.wait().then(() => {
+                resolved = true;
+            });
+            await Promise.resolve();
+            expect(resolved).toBe(false);
+            const data = { type: 'error', node: mockNode, error: new Error('a') };
+            // Don't await send — it won't resolve until ack
+            const sending = queue.send(data);
+            await waiting;
+            expect(resolved).toBe(true);
+            // Clean up: ack so send resolves
+            queue.shift().ack();
+            await sending;
+        });
+    });
+});
+//# sourceMappingURL=queue.test.js.map

package/dist/src/multiagent/__tests__/queue.test.js.map

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

package/dist/src/multiagent/base.d.ts

@@ -0,0 +1,25 @@
+import type { InvokeArgs } from '../agent/agent.js';
+import type { MultiAgentStreamEvent } from './events.js';
+import type { MultiAgentResult } from './state.js';
+/**
+ * Interface for any multi-agent orchestrator that can stream execution.
+ * Implement this interface to create custom orchestration patterns that can be
+ * composed as nodes within other orchestrators via {@link MultiAgentNode}.
+ */
+export interface MultiAgentBase {
+    /** Unique identifier for this orchestrator. */
+    readonly id: string;
+    /**
+     * Execute the orchestrator and return the final result.
+     * @param input - Input to pass to the orchestrator
+     * @returns The aggregate result from all executed nodes
+     */
+    invoke(input: InvokeArgs): Promise<MultiAgentResult>;
+    /**
+     * Execute the orchestrator and stream events as they occur.
+     * @param input - Input to pass to the orchestrator
+     * @returns Async generator yielding events and returning the final result
+     */
+    stream(input: InvokeArgs): AsyncGenerator<MultiAgentStreamEvent, MultiAgentResult, undefined>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/src/multiagent/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/multiagent/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAElD;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IAEnB;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAEpD;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc,CAAC,qBAAqB,EAAE,gBAAgB,EAAE,SAAS,CAAC,CAAA;CAC9F"}

package/dist/src/multiagent/base.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=base.js.map

package/dist/src/multiagent/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/multiagent/base.ts"],"names":[],"mappings":""}

package/dist/src/multiagent/edge.d.ts

@@ -0,0 +1,29 @@
+import type { Node } from './nodes.js';
+import type { MultiAgentState } from './state.js';
+/**
+ * Evaluates whether an edge should be traversed based on the current execution state.
+ */
+export type EdgeHandler = (state: MultiAgentState) => boolean | Promise<boolean>;
+/**
+ * Directed edge between two nodes.
+ */
+export declare class Edge {
+    readonly source: Node;
+    readonly target: Node;
+    /** Edge condition. The edge is always traversed when no handler is provided. */
+    readonly handler: EdgeHandler;
+    constructor(data: {
+        source: Node;
+        target: Node;
+        handler?: EdgeHandler;
+    });
+}
+/**
+ * An edge definition accepted by orchestration constructors.
+ */
+export interface EdgeDefinition {
+    source: string;
+    target: string;
+    handler?: EdgeHandler;
+}
+//# sourceMappingURL=edge.d.ts.map

package/dist/src/multiagent/edge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge.d.ts","sourceRoot":"","sources":["../../../src/multiagent/edge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AACtC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;AAEhF;;GAEG;AACH,qBAAa,IAAI;IACf,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAA;IACrB,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAA;gBAEjB,IAAI,EAAE;QAAE,MAAM,EAAE,IAAI,CAAC;QAAC,MAAM,EAAE,IAAI,CAAC;QAAC,OAAO,CAAC,EAAE,WAAW,CAAA;KAAE;CAKxE;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,WAAW,CAAA;CACtB"}

package/dist/src/multiagent/edge.js

@@ -0,0 +1,15 @@
+/**
+ * Directed edge between two nodes.
+ */
+export class Edge {
+    source;
+    target;
+    /** Edge condition. The edge is always traversed when no handler is provided. */
+    handler;
+    constructor(data) {
+        this.source = data.source;
+        this.target = data.target;
+        this.handler = data.handler ?? (() => true);
+    }
+}
+//# sourceMappingURL=edge.js.map

package/dist/src/multiagent/edge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge.js","sourceRoot":"","sources":["../../../src/multiagent/edge.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,MAAM,OAAO,IAAI;IACN,MAAM,CAAM;IACZ,MAAM,CAAM;IACrB,gFAAgF;IACvE,OAAO,CAAa;IAE7B,YAAY,IAA2D;QACrE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;QACzB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,CAAC,GAAY,EAAE,CAAC,IAAI,CAAC,CAAA;IACtD,CAAC;CACF"}

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

@@ -0,0 +1,135 @@
+import { HookableEvent } from '../hooks/events.js';
+import type { AgentStreamEvent } from '../types/agent.js';
+import type { MultiAgentResult, MultiAgentState, NodeResult } from './state.js';
+import type { MultiAgentBase } from './base.js';
+import type { NodeType } from './nodes.js';
+/**
+ * Event triggered when a multi-agent orchestrator has finished initialization.
+ */
+export declare class MultiAgentInitializedEvent extends HookableEvent {
+    readonly type: "multiAgentInitializedEvent";
+    readonly orchestrator: MultiAgentBase;
+    constructor(data: {
+        orchestrator: MultiAgentBase;
+    });
+}
+/**
+ * Event triggered before orchestrator execution starts.
+ */
+export declare class BeforeMultiAgentInvocationEvent extends HookableEvent {
+    readonly type: "beforeMultiAgentInvocationEvent";
+    readonly orchestrator: MultiAgentBase;
+    readonly state: MultiAgentState;
+    constructor(data: {
+        orchestrator: MultiAgentBase;
+        state: MultiAgentState;
+    });
+}
+/**
+ * Event triggered after orchestrator execution completes.
+ */
+export declare class AfterMultiAgentInvocationEvent extends HookableEvent {
+    readonly type: "afterMultiAgentInvocationEvent";
+    readonly orchestrator: MultiAgentBase;
+    readonly state: MultiAgentState;
+    constructor(data: {
+        orchestrator: MultiAgentBase;
+        state: MultiAgentState;
+    });
+    _shouldReverseCallbacks(): boolean;
+}
+/**
+ * Event triggered before a node begins execution.
+ * Hook callbacks can set {@link cancel} to prevent the node from executing.
+ */
+export declare class BeforeNodeCallEvent extends HookableEvent {
+    readonly type: "beforeNodeCallEvent";
+    readonly orchestrator: MultiAgentBase;
+    readonly state: MultiAgentState;
+    readonly nodeId: string;
+    /**
+     * Set by hook callbacks to cancel node execution.
+     * When set to `true`, a default cancel message is used.
+     * When set to a string, that string is used as the cancel message.
+     */
+    cancel: boolean | string;
+    constructor(data: {
+        orchestrator: MultiAgentBase;
+        state: MultiAgentState;
+        nodeId: string;
+    });
+}
+/**
+ * Event triggered after a node completes execution.
+ */
+export declare class AfterNodeCallEvent extends HookableEvent {
+    readonly type: "afterNodeCallEvent";
+    readonly orchestrator: MultiAgentBase;
+    readonly state: MultiAgentState;
+    readonly nodeId: string;
+    constructor(data: {
+        orchestrator: MultiAgentBase;
+        state: MultiAgentState;
+        nodeId: string;
+    });
+    _shouldReverseCallbacks(): boolean;
+}
+/**
+ * Wraps an inner streaming event from a node with the node's identity.
+ * Emitted during node execution to propagate agent-level or nested
+ * multi-agent events up to the orchestration layer.
+ */
+export declare class NodeStreamUpdateEvent extends HookableEvent {
+    readonly type: "nodeStreamUpdateEvent";
+    readonly nodeId: string;
+    readonly nodeType: NodeType;
+    readonly event: AgentStreamEvent | Exclude<MultiAgentStreamEvent, NodeStreamUpdateEvent>;
+    constructor(data: {
+        nodeId: string;
+        nodeType: NodeType;
+        event: AgentStreamEvent | Exclude<MultiAgentStreamEvent, NodeStreamUpdateEvent>;
+    });
+}
+/**
+ * Event triggered when a node finishes execution.
+ * Wraps the {@link NodeResult} for the completed node.
+ */
+export declare class NodeResultEvent extends HookableEvent {
+    readonly type: "nodeResultEvent";
+    readonly nodeId: string;
+    readonly nodeType: NodeType;
+    readonly result: NodeResult;
+    constructor(data: {
+        nodeId: string;
+        nodeType: NodeType;
+        result: NodeResult;
+    });
+}
+/**
+ * Event triggered when execution transitions between nodes.
+ */
+export declare class MultiAgentHandoffEvent extends HookableEvent {
+    readonly type: "multiAgentHandoffEvent";
+    readonly source: string;
+    readonly targets: string[];
+    constructor(data: {
+        source: string;
+        targets: string[];
+    });
+}
+/**
+ * Event triggered as the final event in the multi-agent stream.
+ * Wraps the {@link MultiAgentResult} containing the aggregate outcome.
+ */
+export declare class MultiAgentResultEvent extends HookableEvent {
+    readonly type: "multiAgentResultEvent";
+    readonly result: MultiAgentResult;
+    constructor(data: {
+        result: MultiAgentResult;
+    });
+}
+/**
+ * Union of all multi-agent streaming events.
+ */
+export type MultiAgentStreamEvent = BeforeMultiAgentInvocationEvent | AfterMultiAgentInvocationEvent | BeforeNodeCallEvent | AfterNodeCallEvent | NodeStreamUpdateEvent | NodeResultEvent | MultiAgentHandoffEvent | MultiAgentResultEvent;
+//# sourceMappingURL=events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/multiagent/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAC/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE1C;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,aAAa;IAC3D,QAAQ,CAAC,IAAI,EAAG,4BAA4B,CAAS;IACrD,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAA;gBAEzB,IAAI,EAAE;QAAE,YAAY,EAAE,cAAc,CAAA;KAAE;CAInD;AAED;;GAEG;AACH,qBAAa,+BAAgC,SAAQ,aAAa;IAChE,QAAQ,CAAC,IAAI,EAAG,iCAAiC,CAAS;IAC1D,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAA;IACrC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAA;gBAEnB,IAAI,EAAE;QAAE,YAAY,EAAE,cAAc,CAAC;QAAC,KAAK,EAAE,eAAe,CAAA;KAAE;CAK3E;AAED;;GAEG;AACH,qBAAa,8BAA+B,SAAQ,aAAa;IAC/D,QAAQ,CAAC,IAAI,EAAG,gCAAgC,CAAS;IACzD,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAA;IACrC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAA;gBAEnB,IAAI,EAAE;QAAE,YAAY,EAAE,cAAc,CAAC;QAAC,KAAK,EAAE,eAAe,CAAA;KAAE;IAMjE,uBAAuB,IAAI,OAAO;CAG5C;AAED;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,aAAa;IACpD,QAAQ,CAAC,IAAI,EAAG,qBAAqB,CAAS;IAC9C,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAA;IACrC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAA;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IAEvB;;;;OAIG;IACH,MAAM,EAAE,OAAO,GAAG,MAAM,CAAQ;gBAEpB,IAAI,EAAE;QAAE,YAAY,EAAE,cAAc,CAAC;QAAC,KAAK,EAAE,eAAe,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CAM3F;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,aAAa;IACnD,QAAQ,CAAC,IAAI,EAAG,oBAAoB,CAAS;IAC7C,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAA;IACrC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAA;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;gBAEX,IAAI,EAAE;QAAE,YAAY,EAAE,cAAc,CAAC;QAAC,KAAK,EAAE,eAAe,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAOjF,uBAAuB,IAAI,OAAO;CAG5C;AAED;;;;GAIG;AACH,qBAAa,qBAAsB,SAAQ,aAAa;IACtD,QAAQ,CAAC,IAAI,EAAG,uBAAuB,CAAS;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,qBAAqB,EAAE,qBAAqB,CAAC,CAAA;gBAE5E,IAAI,EAAE;QAChB,MAAM,EAAE,MAAM,CAAA;QACd,QAAQ,EAAE,QAAQ,CAAA;QAClB,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,qBAAqB,EAAE,qBAAqB,CAAC,CAAA;KAChF;CAMF;AAED;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,aAAa;IAChD,QAAQ,CAAC,IAAI,EAAG,iBAAiB,CAAS;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;gBAEf,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAC;QAAC,MAAM,EAAE,UAAU,CAAA;KAAE;CAM7E;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,aAAa;IACvD,QAAQ,CAAC,IAAI,EAAG,wBAAwB,CAAS;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAA;gBAEd,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE;CAKxD;AAED;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,aAAa;IACtD,QAAQ,CAAC,IAAI,EAAG,uBAAuB,CAAS;IAChD,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;gBAErB,IAAI,EAAE;QAAE,MAAM,EAAE,gBAAgB,CAAA;KAAE;CAI/C;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAC7B,+BAA+B,GAC/B,8BAA8B,GAC9B,mBAAmB,GACnB,kBAAkB,GAClB,qBAAqB,GACrB,eAAe,GACf,sBAAsB,GACtB,qBAAqB,CAAA"}