@open-multi-agent/core 1.4.0

package/dist/tool/framework.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Tool definition framework for open-multi-agent.
+ *
+ * Provides the core primitives for declaring, registering, and converting
+ * tools to the JSON Schema format that LLM APIs expect.
+ *
+ * Types shared with the rest of the framework (`ToolDefinition`, `ToolResult`,
+ * `ToolUseContext`) are imported from `../types` to ensure a single source of
+ * truth.  This file re-exports them for the convenience of downstream callers
+ * who only need to import from `tool/framework`.
+ */
+import { type ZodSchema } from 'zod';
+import type { ToolDefinition, ToolResult, ToolUseContext, LLMToolDef } from '../types.js';
+export type { ToolDefinition, ToolResult, ToolUseContext };
+/** Minimal JSON Schema for a single property. */
+export type JSONSchemaProperty = {
+    type: 'string';
+    description?: string;
+    enum?: string[];
+} | {
+    type: 'number';
+    description?: string;
+} | {
+    type: 'integer';
+    description?: string;
+} | {
+    type: 'boolean';
+    description?: string;
+} | {
+    type: 'null';
+    description?: string;
+} | {
+    type: 'array';
+    items: JSONSchemaProperty;
+    description?: string;
+} | {
+    type: 'object';
+    properties: Record<string, JSONSchemaProperty>;
+    required?: string[];
+    description?: string;
+} | {
+    anyOf: JSONSchemaProperty[];
+    description?: string;
+} | {
+    const: unknown;
+    description?: string;
+} | Record<string, unknown>;
+/**
+ * Define a typed tool.  This is the single entry-point for creating tools
+ * that can be registered with a {@link ToolRegistry}.
+ *
+ * The returned object satisfies the {@link ToolDefinition} interface imported
+ * from `../types`.
+ *
+ * @example
+ * ```ts
+ * const echoTool = defineTool({
+ *   name: 'echo',
+ *   description: 'Echo the input message back to the caller.',
+ *   inputSchema: z.object({ message: z.string() }),
+ *   execute: async ({ message }) => ({
+ *     data: message,
+ *     isError: false,
+ *   }),
+ * })
+ * ```
+ */
+export declare function defineTool<TInput>(config: {
+    name: string;
+    description: string;
+    inputSchema: ZodSchema<TInput>;
+    /**
+     * Optional runtime validator for `ToolResult.data`.
+     * When omitted, output validation is skipped.
+     *
+     * `ToolResult.data` is always a `string`, so the schema is fixed to
+     * `ZodSchema<string>` — use `z.string().refine(...)` / `z.string().regex(...)`
+     * (or similar) to enforce structural constraints on the serialised output.
+     */
+    outputSchema?: ZodSchema<string>;
+    /**
+     * Optional JSON Schema for the LLM (bypasses Zod → JSON Schema conversion).
+     */
+    llmInputSchema?: Record<string, unknown>;
+    /**
+     * Per-tool maximum output length in characters. When set, tool output
+     * exceeding this limit is truncated (head + tail with a marker in between).
+     * Takes priority over agent-level `maxToolOutputChars`.
+     */
+    maxOutputChars?: number;
+    execute: (input: TInput, context: ToolUseContext) => Promise<ToolResult>;
+}): ToolDefinition<TInput>;
+/**
+ * Registry that holds a set of named tools and can produce the JSON Schema
+ * representation expected by LLM APIs (Anthropic, OpenAI, etc.).
+ */
+export declare class ToolRegistry {
+    private readonly tools;
+    private readonly runtimeToolNames;
+    /**
+     * Add a tool to the registry.  Throws if a tool with the same name has
+     * already been registered — prevents silent overwrites.
+     */
+    register(tool: ToolDefinition<any>, options?: {
+        runtimeAdded?: boolean;
+    }): void;
+    /** Return a tool by name, or `undefined` if not found. */
+    get(name: string): ToolDefinition<any> | undefined;
+    /**
+     * Return all registered tool definitions as an array.
+     *
+     * Callers that only need names can do `registry.list().map(t => t.name)`.
+     * This matches the agent's `getTools()` pattern.
+     */
+    list(): ToolDefinition<any>[];
+    /**
+     * Return all registered tool definitions as an array.
+     * Alias for {@link list} — available for callers that prefer explicit naming.
+     */
+    getAll(): ToolDefinition<any>[];
+    /** Return true when a tool with the given name is registered. */
+    has(name: string): boolean;
+    /**
+     * Remove a tool by name.
+     * No-op if the tool was not registered — matches the agent's expected
+     * behaviour where `removeTool` is a graceful operation.
+     */
+    unregister(name: string): void;
+    /** Alias for {@link unregister} — available for symmetry with `register`. */
+    deregister(name: string): void;
+    /**
+     * Convert all registered tools to the {@link LLMToolDef} format used by LLM
+     * adapters.  This is the primary method called by the agent runner before
+     * each LLM API call.
+     */
+    toToolDefs(): LLMToolDef[];
+    /**
+     * Return only tools that were added dynamically at runtime (e.g. via
+     * `agent.addTool()`), in LLM definition format.
+     */
+    toRuntimeToolDefs(): LLMToolDef[];
+    /**
+     * Convert all registered tools to the Anthropic-style `input_schema`
+     * format.  Prefer {@link toToolDefs} for normal use; this method is exposed
+     * for callers that construct their own API payloads.
+     */
+    toLLMTools(): Array<{
+        name: string;
+        description: string;
+        /** Anthropic-style tool input JSON Schema (`type` is usually `object`). */
+        input_schema: Record<string, unknown>;
+    }>;
+}
+/**
+ * Convert a Zod schema to a plain JSON Schema object suitable for inclusion
+ * in LLM API calls.
+ *
+ * Supported Zod types:
+ *   z.string(), z.number(), z.boolean(), z.enum(), z.array(), z.object(),
+ *   z.optional(), z.union(), z.literal(), z.describe(), z.nullable(),
+ *   z.default(), z.intersection(), z.discriminatedUnion(), z.record(),
+ *   z.tuple(), z.any(), z.unknown(), z.never(), z.effects() (transforms)
+ *
+ * Unsupported types fall back to `{}` (any) which is still valid JSON Schema.
+ */
+export declare function zodToJsonSchema(schema: ZodSchema): Record<string, unknown>;
+//# sourceMappingURL=framework.d.ts.map

package/dist/tool/framework.d.ts.map

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

package/dist/tool/framework.js

@@ -0,0 +1,402 @@
+/**
+ * Tool definition framework for open-multi-agent.
+ *
+ * Provides the core primitives for declaring, registering, and converting
+ * tools to the JSON Schema format that LLM APIs expect.
+ *
+ * Types shared with the rest of the framework (`ToolDefinition`, `ToolResult`,
+ * `ToolUseContext`) are imported from `../types` to ensure a single source of
+ * truth.  This file re-exports them for the convenience of downstream callers
+ * who only need to import from `tool/framework`.
+ */
+// ---------------------------------------------------------------------------
+// defineTool
+// ---------------------------------------------------------------------------
+/**
+ * Define a typed tool.  This is the single entry-point for creating tools
+ * that can be registered with a {@link ToolRegistry}.
+ *
+ * The returned object satisfies the {@link ToolDefinition} interface imported
+ * from `../types`.
+ *
+ * @example
+ * ```ts
+ * const echoTool = defineTool({
+ *   name: 'echo',
+ *   description: 'Echo the input message back to the caller.',
+ *   inputSchema: z.object({ message: z.string() }),
+ *   execute: async ({ message }) => ({
+ *     data: message,
+ *     isError: false,
+ *   }),
+ * })
+ * ```
+ */
+export function defineTool(config) {
+    return {
+        name: config.name,
+        description: config.description,
+        inputSchema: config.inputSchema,
+        ...(config.outputSchema !== undefined
+            ? { outputSchema: config.outputSchema }
+            : {}),
+        ...(config.llmInputSchema !== undefined
+            ? { llmInputSchema: config.llmInputSchema }
+            : {}),
+        ...(config.maxOutputChars !== undefined
+            ? { maxOutputChars: config.maxOutputChars }
+            : {}),
+        execute: config.execute,
+    };
+}
+// ---------------------------------------------------------------------------
+// ToolRegistry
+// ---------------------------------------------------------------------------
+/**
+ * Registry that holds a set of named tools and can produce the JSON Schema
+ * representation expected by LLM APIs (Anthropic, OpenAI, etc.).
+ */
+export class ToolRegistry {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    tools = new Map();
+    runtimeToolNames = new Set();
+    /**
+     * Add a tool to the registry.  Throws if a tool with the same name has
+     * already been registered — prevents silent overwrites.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    register(tool, options) {
+        if (this.tools.has(tool.name)) {
+            throw new Error(`ToolRegistry: a tool named "${tool.name}" is already registered. ` +
+                'Use a unique name or deregister the existing one first.');
+        }
+        this.tools.set(tool.name, tool);
+        if (options?.runtimeAdded === true) {
+            this.runtimeToolNames.add(tool.name);
+        }
+    }
+    /** Return a tool by name, or `undefined` if not found. */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    get(name) {
+        return this.tools.get(name);
+    }
+    /**
+     * Return all registered tool definitions as an array.
+     *
+     * Callers that only need names can do `registry.list().map(t => t.name)`.
+     * This matches the agent's `getTools()` pattern.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    list() {
+        return Array.from(this.tools.values());
+    }
+    /**
+     * Return all registered tool definitions as an array.
+     * Alias for {@link list} — available for callers that prefer explicit naming.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    getAll() {
+        return Array.from(this.tools.values());
+    }
+    /** Return true when a tool with the given name is registered. */
+    has(name) {
+        return this.tools.has(name);
+    }
+    /**
+     * Remove a tool by name.
+     * No-op if the tool was not registered — matches the agent's expected
+     * behaviour where `removeTool` is a graceful operation.
+     */
+    unregister(name) {
+        this.tools.delete(name);
+        this.runtimeToolNames.delete(name);
+    }
+    /** Alias for {@link unregister} — available for symmetry with `register`. */
+    deregister(name) {
+        this.unregister(name);
+    }
+    /**
+     * Convert all registered tools to the {@link LLMToolDef} format used by LLM
+     * adapters.  This is the primary method called by the agent runner before
+     * each LLM API call.
+     */
+    toToolDefs() {
+        return Array.from(this.tools.values()).map((tool) => {
+            const schema = tool.llmInputSchema ?? zodToJsonSchema(tool.inputSchema);
+            return {
+                name: tool.name,
+                description: tool.description,
+                inputSchema: schema,
+            };
+        });
+    }
+    /**
+     * Return only tools that were added dynamically at runtime (e.g. via
+     * `agent.addTool()`), in LLM definition format.
+     */
+    toRuntimeToolDefs() {
+        return this.toToolDefs().filter(tool => this.runtimeToolNames.has(tool.name));
+    }
+    /**
+     * Convert all registered tools to the Anthropic-style `input_schema`
+     * format.  Prefer {@link toToolDefs} for normal use; this method is exposed
+     * for callers that construct their own API payloads.
+     */
+    toLLMTools() {
+        return Array.from(this.tools.values()).map((tool) => {
+            if (tool.llmInputSchema !== undefined) {
+                return {
+                    name: tool.name,
+                    description: tool.description,
+                    input_schema: {
+                        type: 'object',
+                        ...tool.llmInputSchema,
+                    },
+                };
+            }
+            const schema = zodToJsonSchema(tool.inputSchema);
+            return {
+                name: tool.name,
+                description: tool.description,
+                input_schema: {
+                    type: 'object',
+                    properties: schema.properties ?? {},
+                    ...(schema.required !== undefined
+                        ? { required: schema.required }
+                        : {}),
+                },
+            };
+        });
+    }
+}
+// ---------------------------------------------------------------------------
+// zodToJsonSchema
+// ---------------------------------------------------------------------------
+/**
+ * Convert a Zod schema to a plain JSON Schema object suitable for inclusion
+ * in LLM API calls.
+ *
+ * Supported Zod types:
+ *   z.string(), z.number(), z.boolean(), z.enum(), z.array(), z.object(),
+ *   z.optional(), z.union(), z.literal(), z.describe(), z.nullable(),
+ *   z.default(), z.intersection(), z.discriminatedUnion(), z.record(),
+ *   z.tuple(), z.any(), z.unknown(), z.never(), z.effects() (transforms)
+ *
+ * Unsupported types fall back to `{}` (any) which is still valid JSON Schema.
+ */
+export function zodToJsonSchema(schema) {
+    return convertZodType(schema);
+}
+// Internal recursive converter.  We access Zod's internal `_def` structure
+// because Zod v3 does not ship a first-class JSON Schema exporter.
+function convertZodType(schema) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const def = schema._def;
+    const description = def.description;
+    const withDesc = (result) => description !== undefined ? { ...result, description } : result;
+    switch (def.typeName) {
+        // -----------------------------------------------------------------------
+        // Primitives
+        // -----------------------------------------------------------------------
+        case ZodTypeName.ZodString:
+            return withDesc({ type: 'string' });
+        case ZodTypeName.ZodNumber:
+            return withDesc({ type: 'number' });
+        case ZodTypeName.ZodBigInt:
+            return withDesc({ type: 'integer' });
+        case ZodTypeName.ZodBoolean:
+            return withDesc({ type: 'boolean' });
+        case ZodTypeName.ZodNull:
+            return withDesc({ type: 'null' });
+        case ZodTypeName.ZodUndefined:
+            return withDesc({ type: 'null' });
+        case ZodTypeName.ZodDate:
+            return withDesc({ type: 'string', format: 'date-time' });
+        // -----------------------------------------------------------------------
+        // Literals
+        // -----------------------------------------------------------------------
+        case ZodTypeName.ZodLiteral: {
+            const literalDef = def;
+            return withDesc({ const: literalDef.value });
+        }
+        // -----------------------------------------------------------------------
+        // Enums
+        // -----------------------------------------------------------------------
+        case ZodTypeName.ZodEnum: {
+            const enumDef = def;
+            return withDesc({ type: 'string', enum: enumDef.values });
+        }
+        case ZodTypeName.ZodNativeEnum: {
+            const nativeEnumDef = def;
+            const values = Object.values(nativeEnumDef.values).filter((v) => typeof v === 'string' || typeof v === 'number');
+            return withDesc({ enum: values });
+        }
+        // -----------------------------------------------------------------------
+        // Arrays
+        // -----------------------------------------------------------------------
+        case ZodTypeName.ZodArray: {
+            const arrayDef = def;
+            return withDesc({
+                type: 'array',
+                items: convertZodType(arrayDef.type),
+            });
+        }
+        case ZodTypeName.ZodTuple: {
+            const tupleDef = def;
+            return withDesc({
+                type: 'array',
+                prefixItems: tupleDef.items.map(convertZodType),
+            });
+        }
+        // -----------------------------------------------------------------------
+        // Objects
+        // -----------------------------------------------------------------------
+        case ZodTypeName.ZodObject: {
+            const objectDef = def;
+            const properties = {};
+            const required = [];
+            for (const [key, value] of Object.entries(objectDef.shape())) {
+                properties[key] = convertZodType(value);
+                const innerDef = value._def;
+                const isOptional = innerDef.typeName === ZodTypeName.ZodOptional ||
+                    innerDef.typeName === ZodTypeName.ZodDefault ||
+                    innerDef.typeName === ZodTypeName.ZodNullable;
+                if (!isOptional) {
+                    required.push(key);
+                }
+            }
+            const result = { type: 'object', properties };
+            if (required.length > 0)
+                result.required = required;
+            return withDesc(result);
+        }
+        case ZodTypeName.ZodRecord: {
+            const recordDef = def;
+            return withDesc({
+                type: 'object',
+                additionalProperties: convertZodType(recordDef.valueType),
+            });
+        }
+        // -----------------------------------------------------------------------
+        // Optional / Nullable / Default
+        // -----------------------------------------------------------------------
+        case ZodTypeName.ZodOptional: {
+            const optionalDef = def;
+            const inner = convertZodType(optionalDef.innerType);
+            return description !== undefined ? { ...inner, description } : inner;
+        }
+        case ZodTypeName.ZodNullable: {
+            const nullableDef = def;
+            const inner = convertZodType(nullableDef.innerType);
+            const type = inner.type;
+            if (typeof type === 'string') {
+                return withDesc({ ...inner, type: [type, 'null'] });
+            }
+            return withDesc({ anyOf: [inner, { type: 'null' }] });
+        }
+        case ZodTypeName.ZodDefault: {
+            const defaultDef = def;
+            const inner = convertZodType(defaultDef.innerType);
+            return withDesc({ ...inner, default: defaultDef.defaultValue() });
+        }
+        // -----------------------------------------------------------------------
+        // Union / Intersection / Discriminated Union
+        // -----------------------------------------------------------------------
+        case ZodTypeName.ZodUnion: {
+            const unionDef = def;
+            const options = unionDef.options.map(convertZodType);
+            return withDesc({ anyOf: options });
+        }
+        case ZodTypeName.ZodDiscriminatedUnion: {
+            const duDef = def;
+            const options = duDef.options.map(convertZodType);
+            return withDesc({ anyOf: options });
+        }
+        case ZodTypeName.ZodIntersection: {
+            const intDef = def;
+            return withDesc({
+                allOf: [convertZodType(intDef.left), convertZodType(intDef.right)],
+            });
+        }
+        // -----------------------------------------------------------------------
+        // Wrappers that forward to their inner type
+        // -----------------------------------------------------------------------
+        case ZodTypeName.ZodEffects: {
+            const effectsDef = def;
+            const inner = convertZodType(effectsDef.schema);
+            return description !== undefined ? { ...inner, description } : inner;
+        }
+        case ZodTypeName.ZodBranded: {
+            const brandedDef = def;
+            return withDesc(convertZodType(brandedDef.type));
+        }
+        case ZodTypeName.ZodReadonly: {
+            const readonlyDef = def;
+            return withDesc(convertZodType(readonlyDef.innerType));
+        }
+        case ZodTypeName.ZodCatch: {
+            const catchDef = def;
+            return withDesc(convertZodType(catchDef.innerType));
+        }
+        case ZodTypeName.ZodPipeline: {
+            const pipelineDef = def;
+            return withDesc(convertZodType(pipelineDef.in));
+        }
+        // -----------------------------------------------------------------------
+        // Any / Unknown – JSON Schema wildcard
+        // -----------------------------------------------------------------------
+        case ZodTypeName.ZodAny:
+        case ZodTypeName.ZodUnknown:
+            return withDesc({});
+        case ZodTypeName.ZodNever:
+            return withDesc({ not: {} });
+        case ZodTypeName.ZodVoid:
+            return withDesc({ type: 'null' });
+        // -----------------------------------------------------------------------
+        // Fallback
+        // -----------------------------------------------------------------------
+        default:
+            return withDesc({});
+    }
+}
+// ---------------------------------------------------------------------------
+// Internal Zod type-name enum (mirrors Zod's internal ZodFirstPartyTypeKind)
+// ---------------------------------------------------------------------------
+var ZodTypeName;
+(function (ZodTypeName) {
+    ZodTypeName["ZodString"] = "ZodString";
+    ZodTypeName["ZodNumber"] = "ZodNumber";
+    ZodTypeName["ZodBigInt"] = "ZodBigInt";
+    ZodTypeName["ZodBoolean"] = "ZodBoolean";
+    ZodTypeName["ZodDate"] = "ZodDate";
+    ZodTypeName["ZodUndefined"] = "ZodUndefined";
+    ZodTypeName["ZodNull"] = "ZodNull";
+    ZodTypeName["ZodAny"] = "ZodAny";
+    ZodTypeName["ZodUnknown"] = "ZodUnknown";
+    ZodTypeName["ZodNever"] = "ZodNever";
+    ZodTypeName["ZodVoid"] = "ZodVoid";
+    ZodTypeName["ZodArray"] = "ZodArray";
+    ZodTypeName["ZodObject"] = "ZodObject";
+    ZodTypeName["ZodUnion"] = "ZodUnion";
+    ZodTypeName["ZodDiscriminatedUnion"] = "ZodDiscriminatedUnion";
+    ZodTypeName["ZodIntersection"] = "ZodIntersection";
+    ZodTypeName["ZodTuple"] = "ZodTuple";
+    ZodTypeName["ZodRecord"] = "ZodRecord";
+    ZodTypeName["ZodMap"] = "ZodMap";
+    ZodTypeName["ZodSet"] = "ZodSet";
+    ZodTypeName["ZodFunction"] = "ZodFunction";
+    ZodTypeName["ZodLazy"] = "ZodLazy";
+    ZodTypeName["ZodLiteral"] = "ZodLiteral";
+    ZodTypeName["ZodEnum"] = "ZodEnum";
+    ZodTypeName["ZodEffects"] = "ZodEffects";
+    ZodTypeName["ZodNativeEnum"] = "ZodNativeEnum";
+    ZodTypeName["ZodOptional"] = "ZodOptional";
+    ZodTypeName["ZodNullable"] = "ZodNullable";
+    ZodTypeName["ZodDefault"] = "ZodDefault";
+    ZodTypeName["ZodCatch"] = "ZodCatch";
+    ZodTypeName["ZodPromise"] = "ZodPromise";
+    ZodTypeName["ZodBranded"] = "ZodBranded";
+    ZodTypeName["ZodPipeline"] = "ZodPipeline";
+    ZodTypeName["ZodReadonly"] = "ZodReadonly";
+})(ZodTypeName || (ZodTypeName = {}));
+//# sourceMappingURL=framework.js.map

package/dist/tool/framework.js.map

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

package/dist/tool/mcp.d.ts

@@ -0,0 +1,31 @@
+import type { ToolDefinition } from '../types.js';
+export interface ConnectMCPToolsConfig {
+    command: string;
+    args?: string[];
+    env?: Record<string, string | undefined>;
+    cwd?: string;
+    /**
+     * Optional segment prepended to MCP tool names for the framework tool (and LLM) name.
+     * Example: prefix `github` + MCP tool `search_issues` → `github_search_issues`.
+     */
+    namePrefix?: string;
+    /**
+     * Timeout (ms) for MCP connect and each `tools/list` page. Defaults to 60000.
+     */
+    requestTimeoutMs?: number;
+    /**
+     * Client metadata sent to the MCP server.
+     */
+    clientName?: string;
+    clientVersion?: string;
+}
+export interface ConnectedMCPTools {
+    tools: ToolDefinition[];
+    disconnect: () => Promise<void>;
+}
+/**
+ * Connect to an MCP server over stdio and convert exposed MCP tools into
+ * open-multi-agent ToolDefinitions.
+ */
+export declare function connectMCPTools(config: ConnectMCPToolsConfig): Promise<ConnectedMCPTools>;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/tool/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/tool/mcp.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAkEjD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;IACxC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,cAAc,EAAE,CAAA;IACvB,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAChC;AAqID;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,iBAAiB,CAAC,CAgE5B"}