@nodetool-ai/agents 0.7.0-rc.11

package/dist/team/types.d.ts

@@ -0,0 +1,198 @@
+/**
+ * Core type definitions for the multi-agent team system.
+ *
+ * Inspired by the A2A (Agent-to-Agent) protocol task lifecycle
+ * and blackboard architecture patterns.
+ */
+export interface AgentIdentity {
+    /** Unique ID within the team. */
+    id: string;
+    /** Human-readable name, e.g. "researcher", "writer". */
+    name: string;
+    /** Freeform role description injected into LLM system prompt. */
+    role: string;
+    /** Skill tags for task matching, e.g. ["web_search", "code_generation"]. */
+    skills: string[];
+    /** LLM provider key. */
+    provider: string;
+    /** Model identifier. */
+    model: string;
+    /** Tool names this agent can use (beyond team tools). */
+    tools: string[];
+}
+export type MessageType = "request" | "response" | "info" | "handoff";
+export interface AgentMessage {
+    id: string;
+    from: string;
+    to: string | "all";
+    type: MessageType;
+    subject: string;
+    body: string;
+    replyTo?: string;
+    taskId?: string;
+    timestamp: number;
+}
+export type TaskStatus = "open" | "claimed" | "working" | "blocked" | "done" | "failed";
+export interface BoardTask {
+    id: string;
+    title: string;
+    description: string;
+    status: TaskStatus;
+    createdBy: string;
+    claimedBy?: string;
+    dependsOn: string[];
+    requiredSkills: string[];
+    priority: number;
+    artifacts: unknown[];
+    parentTaskId?: string;
+    result?: unknown;
+    failureReason?: string;
+    createdAt: number;
+    updatedAt: number;
+}
+export type TeamEvent = {
+    type: "agent_started";
+    agentId: string;
+    timestamp: number;
+} | {
+    type: "agent_idle";
+    agentId: string;
+    timestamp: number;
+} | {
+    type: "agent_finished";
+    agentId: string;
+    timestamp: number;
+} | {
+    type: "task_created";
+    task: BoardTask;
+    timestamp: number;
+} | {
+    type: "task_claimed";
+    taskId: string;
+    agentId: string;
+    timestamp: number;
+} | {
+    type: "task_working";
+    taskId: string;
+    agentId: string;
+    timestamp: number;
+} | {
+    type: "task_completed";
+    taskId: string;
+    artifacts: unknown[];
+    timestamp: number;
+} | {
+    type: "task_failed";
+    taskId: string;
+    reason: string;
+    timestamp: number;
+} | {
+    type: "message_sent";
+    message: AgentMessage;
+    timestamp: number;
+} | {
+    type: "chunk";
+    agentId: string;
+    content: string;
+    timestamp: number;
+} | {
+    type: "team_complete";
+    result: unknown;
+    timestamp: number;
+} | {
+    type: "deadlock_detected";
+    blockingTasks: string[];
+    timestamp: number;
+};
+export interface IMessageBus {
+    /** Register an agent so it has an inbox. */
+    register(agentId: string): void;
+    /** Send a message to a specific agent or broadcast to all. */
+    send(opts: {
+        from: string;
+        to: string | "all";
+        type: MessageType;
+        subject: string;
+        body: string;
+        replyTo?: string;
+        taskId?: string;
+    }): AgentMessage;
+    /** Pull and drain pending messages for an agent. */
+    receive(agentId: string): AgentMessage[];
+    /** Peek at pending messages without consuming. */
+    peek(agentId: string): AgentMessage[];
+    /** Subscribe to real-time message delivery. Returns unsubscribe fn. */
+    subscribe(agentId: string, handler: (msg: AgentMessage) => void): () => void;
+    /** Get the conversation thread from a message ID. */
+    getThread(messageId: string): AgentMessage[];
+    /** Get full message history. */
+    getHistory(): AgentMessage[];
+    /** Count of pending messages for an agent. */
+    pendingCount(agentId: string): number;
+}
+export interface ITaskBoard {
+    /** Create a new task on the board. */
+    create(opts: {
+        title: string;
+        description: string;
+        createdBy: string;
+        dependsOn?: string[];
+        requiredSkills?: string[];
+        priority?: number;
+        parentTaskId?: string;
+    }): BoardTask;
+    /** Atomically claim an open task. */
+    claim(taskId: string, agentId: string): boolean;
+    /** Mark a claimed task as actively being worked on. */
+    startWork(taskId: string, agentId: string): boolean;
+    /** Complete a task with optional result and artifacts. */
+    complete(taskId: string, opts?: {
+        result?: unknown;
+        artifacts?: unknown[];
+    }): boolean;
+    /** Mark a task as failed. */
+    fail(taskId: string, reason: string): boolean;
+    /** Block a task. */
+    block(taskId: string): boolean;
+    /** Unblock a task back to open. */
+    unblock(taskId: string): boolean;
+    /** Decompose a task into subtasks. Parent becomes blocked. */
+    decompose(parentTaskId: string, subtasks: Array<{
+        title: string;
+        description: string;
+        createdBy: string;
+        requiredSkills?: string[];
+        priority?: number;
+        dependsOn?: string[];
+    }>): BoardTask[];
+    /** Get tasks available for an agent to claim. */
+    getAvailable(agent?: AgentIdentity): BoardTask[];
+    /** Get a single task by ID. */
+    get(taskId: string): BoardTask | undefined;
+    /** Full board snapshot. */
+    getSnapshot(): BoardTask[];
+    /** Get subtasks of a parent. */
+    getSubtasks(parentTaskId: string): BoardTask[];
+    /** Check if all tasks are terminal. */
+    isComplete(): boolean;
+    /** Detect deadlock. Returns stuck task IDs or null. */
+    detectDeadlock(): string[] | null;
+    /** Auto-complete parent tasks when all subtasks done. */
+    resolveParents(): void;
+    /** Subscribe to board events. Returns unsubscribe fn. */
+    onEvent(handler: (event: TeamEvent) => void): () => void;
+}
+export type TeamStrategy = "coordinator" | "autonomous" | "hybrid";
+export interface TeamConfig {
+    /** Overall objective for the team. */
+    objective: string;
+    /** Team members. First agent is coordinator when strategy is "coordinator". */
+    agents: AgentIdentity[];
+    /** Execution strategy. */
+    strategy: TeamStrategy;
+    /** Maximum total iterations across all agents before forced completion. */
+    maxIterations?: number;
+    /** Maximum concurrent agents running simultaneously. */
+    maxConcurrency?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/team/types.d.ts.map

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

package/dist/team/types.js

@@ -0,0 +1,8 @@
+/**
+ * Core type definitions for the multi-agent team system.
+ *
+ * Inspired by the A2A (Agent-to-Agent) protocol task lifecycle
+ * and blackboard architecture patterns.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/team/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/team/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/tools/add-edge-tool.d.ts

@@ -0,0 +1,18 @@
+/**
+ * AddEdgeTool -- planner tool that connects two nodes in the graph.
+ */
+import type { ProcessingContext } from "@nodetool-ai/runtime";
+import type { NodeRegistry } from "@nodetool-ai/node-sdk";
+import { Tool } from "./base-tool.js";
+import { type GraphBuilder } from "../graph-builder.js";
+export declare class AddEdgeTool extends Tool {
+    private readonly builder;
+    private readonly registry;
+    readonly name = "add_edge";
+    readonly description = "Connect two nodes by creating an edge from a source output to a target input.";
+    readonly inputSchema: Record<string, unknown>;
+    constructor(builder: GraphBuilder, registry: NodeRegistry);
+    process(_context: ProcessingContext, params: Record<string, unknown>): Promise<unknown>;
+    userMessage(params: Record<string, unknown>): string;
+}
+//# sourceMappingURL=add-edge-tool.d.ts.map

package/dist/tools/add-edge-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-edge-tool.d.ts","sourceRoot":"","sources":["../../src/tools/add-edge-tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAwB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAyB9E,qBAAa,WAAY,SAAQ,IAAI;IAOjC,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAP3B,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,WAAW,mFAC8D;IAClF,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAyB;gBAGnD,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,YAAY;IAKnC,OAAO,CACX,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC;IAkEnB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;CAGrD"}

package/dist/tools/add-edge-tool.js

@@ -0,0 +1,92 @@
+/**
+ * AddEdgeTool -- planner tool that connects two nodes in the graph.
+ */
+import { Tool } from "./base-tool.js";
+import { AGENT_STEP_NODE_TYPE } from "../graph-builder.js";
+const ADD_EDGE_INPUT_SCHEMA = {
+    type: "object",
+    properties: {
+        source: {
+            type: "string",
+            description: "ID of the source node"
+        },
+        source_handle: {
+            type: "string",
+            description: "Output slot name on the source node"
+        },
+        target: {
+            type: "string",
+            description: "ID of the target node"
+        },
+        target_handle: {
+            type: "string",
+            description: "Input property name on the target node"
+        }
+    },
+    required: ["source", "source_handle", "target", "target_handle"]
+};
+export class AddEdgeTool extends Tool {
+    builder;
+    registry;
+    name = "add_edge";
+    description = "Connect two nodes by creating an edge from a source output to a target input.";
+    inputSchema = ADD_EDGE_INPUT_SCHEMA;
+    constructor(builder, registry) {
+        super();
+        this.builder = builder;
+        this.registry = registry;
+    }
+    async process(_context, params) {
+        const source = params["source"];
+        const sourceHandle = params["source_handle"];
+        const target = params["target"];
+        const targetHandle = params["target_handle"];
+        if (!source || !sourceHandle || !target || !targetHandle) {
+            return {
+                status: "error",
+                errors: [
+                    "All fields required: source, source_handle, target, target_handle"
+                ]
+            };
+        }
+        // Validate handles against registry metadata for deterministic nodes
+        const validationErrors = [];
+        const sourceNode = this.builder.getNode(source);
+        if (sourceNode && sourceNode.type !== AGENT_STEP_NODE_TYPE) {
+            const meta = this.registry.getMetadata(sourceNode.type);
+            if (meta) {
+                const outputNames = meta.outputs.map((o) => o.name);
+                if (outputNames.length > 0 && !outputNames.includes(sourceHandle)) {
+                    validationErrors.push(`Source node '${source}' (${sourceNode.type}) has no output '${sourceHandle}'. Available: ${outputNames.join(", ")}`);
+                }
+            }
+        }
+        const targetNode = this.builder.getNode(target);
+        if (targetNode && targetNode.type !== AGENT_STEP_NODE_TYPE) {
+            const meta = this.registry.getMetadata(targetNode.type);
+            if (meta) {
+                const inputNames = meta.properties.map((p) => p.name);
+                if (inputNames.length > 0 && !inputNames.includes(targetHandle)) {
+                    validationErrors.push(`Target node '${target}' (${targetNode.type}) has no input '${targetHandle}'. Available: ${inputNames.join(", ")}`);
+                }
+            }
+        }
+        if (validationErrors.length > 0) {
+            return { status: "error", errors: validationErrors };
+        }
+        const errors = this.builder.addEdge(source, sourceHandle, target, targetHandle);
+        if (errors.length > 0) {
+            return { status: "error", errors };
+        }
+        return {
+            status: "edge_added",
+            from: `${source}.${sourceHandle}`,
+            to: `${target}.${targetHandle}`,
+            total_edges: this.builder.edgeCount
+        };
+    }
+    userMessage(params) {
+        return `Connecting ${params["source"]}.${params["source_handle"]} → ${params["target"]}.${params["target_handle"]}`;
+    }
+}
+//# sourceMappingURL=add-edge-tool.js.map

package/dist/tools/add-edge-tool.js.map

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

package/dist/tools/add-node-tool.d.ts

@@ -0,0 +1,22 @@
+/**
+ * AddNodeTool -- planner tool that adds a node to the graph being built.
+ *
+ * The LLM calls this to add either:
+ * - A deterministic workflow node (type from NodeRegistry)
+ * - An agent step node (type: "nodetool.agents.AgentStep")
+ */
+import type { ProcessingContext } from "@nodetool-ai/runtime";
+import type { NodeRegistry } from "@nodetool-ai/node-sdk";
+import { Tool } from "./base-tool.js";
+import { type GraphBuilder } from "../graph-builder.js";
+export declare class AddNodeTool extends Tool {
+    private readonly builder;
+    private readonly registry;
+    readonly name = "add_node";
+    readonly description: string;
+    readonly inputSchema: Record<string, unknown>;
+    constructor(builder: GraphBuilder, registry: NodeRegistry);
+    process(_context: ProcessingContext, params: Record<string, unknown>): Promise<unknown>;
+    userMessage(params: Record<string, unknown>): string;
+}
+//# sourceMappingURL=add-node-tool.d.ts.map

package/dist/tools/add-node-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-node-tool.d.ts","sourceRoot":"","sources":["../../src/tools/add-node-tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAwB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAiC9E,qBAAa,WAAY,SAAQ,IAAI;IASjC,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAT3B,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,WAAW,SAGmF;IACvG,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAyB;gBAGnD,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,YAAY;IAKnC,OAAO,CACX,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC;IAmFnB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;CAKrD"}

package/dist/tools/add-node-tool.js

@@ -0,0 +1,128 @@
+/**
+ * AddNodeTool -- planner tool that adds a node to the graph being built.
+ *
+ * The LLM calls this to add either:
+ * - A deterministic workflow node (type from NodeRegistry)
+ * - An agent step node (type: "nodetool.agents.AgentStep")
+ */
+import { Tool } from "./base-tool.js";
+import { AGENT_STEP_NODE_TYPE } from "../graph-builder.js";
+import { createLogger } from "@nodetool-ai/config";
+const log = createLogger("nodetool.agents.add-node-tool");
+const ADD_NODE_INPUT_SCHEMA = {
+    type: "object",
+    properties: {
+        id: {
+            type: "string",
+            description: "Unique identifier for this node (snake_case recommended)"
+        },
+        type: {
+            type: "string",
+            description: 'Fully-qualified node type from registry, or "nodetool.agents.AgentStep" for LLM-driven steps'
+        },
+        node_properties: {
+            type: "object",
+            description: 'Configuration values for the node. Example: {"value": "Hello World"} for a String constant, ' +
+                '{"delimiter": " "} for a Split node. Use get_node_info to see available properties. ' +
+                "Pass {} if no configuration is needed (e.g. the node only receives input via edges)."
+        },
+        name: {
+            type: "string",
+            description: "Optional human-readable name for the node"
+        }
+    },
+    required: ["id", "type"],
+    additionalProperties: true
+};
+export class AddNodeTool extends Tool {
+    builder;
+    registry;
+    name = "add_node";
+    description = "Add a node to the workflow graph. Set node configuration either via node_properties object " +
+        "or as direct parameters (e.g. value: \"Hello World\" for a String constant). " +
+        'Use a registry node type for deterministic work, or "nodetool.agents.AgentStep" for LLM reasoning.';
+    inputSchema = ADD_NODE_INPUT_SCHEMA;
+    constructor(builder, registry) {
+        super();
+        this.builder = builder;
+        this.registry = registry;
+    }
+    async process(_context, params) {
+        const id = params["id"];
+        const type = params["type"];
+        const name = params["name"];
+        // Accept properties from node_properties, properties, or any extra params
+        const knownKeys = new Set(["id", "type", "name", "node_properties", "properties"]);
+        const extraProps = {};
+        for (const [k, v] of Object.entries(params)) {
+            if (!knownKeys.has(k)) {
+                extraProps[k] = v;
+            }
+        }
+        const properties = params["node_properties"] ??
+            params["properties"] ??
+            (Object.keys(extraProps).length > 0 ? extraProps : {});
+        log.debug("add_node", { id, type, properties });
+        if (!id || typeof id !== "string") {
+            return { status: "error", errors: ["id must be a non-empty string."] };
+        }
+        if (!type || typeof type !== "string") {
+            return { status: "error", errors: ["type must be a non-empty string."] };
+        }
+        // Validate node type
+        const isAgentStep = type === AGENT_STEP_NODE_TYPE;
+        if (!isAgentStep && !this.registry.has(type)) {
+            // Check loaded metadata for Python-only nodes
+            const meta = this.registry.getMetadata(type);
+            if (!meta) {
+                return {
+                    status: "error",
+                    errors: [
+                        `Unknown node type: '${type}'. Use search_nodes to find available types.`
+                    ]
+                };
+            }
+        }
+        // Validate agent step properties
+        if (isAgentStep) {
+            const instructions = properties["instructions"];
+            if (!instructions || typeof instructions !== "string") {
+                return {
+                    status: "error",
+                    errors: [
+                        'AgentStep nodes require an "instructions" property (non-empty string).'
+                    ]
+                };
+            }
+        }
+        const errors = this.builder.addNode(id, type, properties, name);
+        if (errors.length > 0) {
+            return { status: "error", errors };
+        }
+        // Include set properties in response and warn if none were set
+        const propsSet = Object.keys(properties);
+        const meta = !isAgentStep ? this.registry.getMetadata(type) : null;
+        const configurableProps = meta?.properties
+            ?.filter((p) => p.name !== "text" && p.name !== "input") // skip edge-connected inputs
+            ?.map((p) => `${p.name} (default: ${JSON.stringify(p.default)})`) ?? [];
+        const result = {
+            status: "node_added",
+            id,
+            type,
+            properties_set: propsSet,
+            total_nodes: this.builder.nodeCount
+        };
+        if (propsSet.length === 0 && configurableProps.length > 0) {
+            result["warning"] =
+                `No node_properties were set. This node has configurable properties: [${configurableProps.join(", ")}]. ` +
+                    `If any need non-default values, remove this node and re-add with node_properties set.`;
+        }
+        return result;
+    }
+    userMessage(params) {
+        const id = params["id"] ?? "?";
+        const type = params["type"] ?? "?";
+        return `Adding node: ${id} (${type})`;
+    }
+}
+//# sourceMappingURL=add-node-tool.js.map

package/dist/tools/add-node-tool.js.map

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

package/dist/tools/asset-tools.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Asset management tools for the agent system.
+ *
+ * Port of src/nodetool/agents/tools/asset_tools.py
+ *
+ * Provides:
+ * - SaveAssetTool: Save text or binary (base64) content as an asset.
+ *   Prefers `context.createAsset` (DB + storage, returns asset:// URI) and
+ *   falls back to the lower-level storage adapter for plain text/key-value.
+ * - ReadAssetTool: Read content from a stored asset file.
+ */
+import type { ProcessingContext } from "@nodetool-ai/runtime";
+import { Tool } from "./base-tool.js";
+export declare class SaveAssetTool extends Tool {
+    readonly name = "save_asset";
+    readonly description = "Save content as an asset. Use this for any artifact you want to surface in the chat (text reports, JSON, manifests, images, audio). Pass `content_base64` for binary data and `content` for text. Returns an asset_id and asset:// URI you can reference in later steps.";
+    readonly inputSchema: {
+        type: "object";
+        properties: {
+            name: {
+                type: "string";
+                description: string;
+            };
+            content: {
+                type: "string";
+                description: string;
+            };
+            content_base64: {
+                type: "string";
+                description: string;
+            };
+            content_type: {
+                type: "string";
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    process(context: ProcessingContext, params: Record<string, unknown>): Promise<unknown>;
+    userMessage(params: Record<string, unknown>): string;
+}
+export declare class ReadAssetTool extends Tool {
+    readonly name = "read_asset";
+    readonly description = "Read an asset file";
+    readonly inputSchema: {
+        type: "object";
+        properties: {
+            name: {
+                type: "string";
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    process(context: ProcessingContext, params: Record<string, unknown>): Promise<unknown>;
+    userMessage(params: Record<string, unknown>): string;
+}
+//# sourceMappingURL=asset-tools.d.ts.map

package/dist/tools/asset-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-tools.d.ts","sourceRoot":"","sources":["../../src/tools/asset-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEtC,qBAAa,aAAc,SAAQ,IAAI;IACrC,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,WAAW,8QACyP;IAC7Q,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;;;;;;kBAwBI,MAAM,EAAE;MAC9B;IAEI,OAAO,CACX,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC;IA+EnB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;CAQrD;AAED,qBAAa,aAAc,SAAQ,IAAI;IACrC,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,WAAW,wBAAwB;IAC5C,QAAQ,CAAC,WAAW;;;;;;;;kBAQI,MAAM,EAAE;MAC9B;IAEI,OAAO,CACX,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC;IA0DnB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;CAQrD"}