@open-multi-agent/core 1.4.0

package/dist/llm/openai.js

@@ -0,0 +1,256 @@
+/**
+ * @fileoverview OpenAI adapter implementing {@link LLMAdapter}.
+ *
+ * Converts between the framework's internal {@link ContentBlock} types and the
+ * OpenAI Chat Completions wire format. Key mapping decisions:
+ *
+ * - Framework `tool_use` blocks in assistant messages → OpenAI `tool_calls`
+ * - Framework `tool_result` blocks in user messages  → OpenAI `tool` role messages
+ * - Framework `image` blocks in user messages        → OpenAI image content parts
+ * - System prompt in {@link LLMChatOptions}           → prepended `system` message
+ *
+ * Because OpenAI and Anthropic use fundamentally different role-based structures
+ * for tool calling (Anthropic embeds tool results in user-role content arrays;
+ * OpenAI uses a dedicated `tool` role), the conversion necessarily splits
+ * `tool_result` blocks out into separate top-level messages.
+ *
+ * API key resolution order:
+ *   1. `apiKey` constructor argument
+ *   2. `OPENAI_API_KEY` environment variable
+ *
+ * @example
+ * ```ts
+ * import { OpenAIAdapter } from './openai.js'
+ *
+ * const adapter = new OpenAIAdapter()
+ * const response = await adapter.chat(messages, {
+ *   model: 'gpt-5.4',
+ *   maxTokens: 1024,
+ * })
+ * ```
+ */
+import OpenAI from 'openai';
+import { toOpenAITool, fromOpenAICompletion, normalizeFinishReason, buildOpenAIMessageList, getOpenAIReasoningText, } from './openai-common.js';
+import { extractToolCallsFromText } from '../tool/text-tool-extractor.js';
+// ---------------------------------------------------------------------------
+// Adapter implementation
+// ---------------------------------------------------------------------------
+/**
+ * LLM adapter backed by the OpenAI Chat Completions API.
+ *
+ * Thread-safe — a single instance may be shared across concurrent agent runs.
+ */
+export class OpenAIAdapter {
+    name = 'openai';
+    #client;
+    constructor(apiKey, baseURL) {
+        this.#client = new OpenAI({
+            apiKey: apiKey ?? process.env['OPENAI_API_KEY'],
+            baseURL,
+        });
+    }
+    // -------------------------------------------------------------------------
+    // chat()
+    // -------------------------------------------------------------------------
+    /**
+     * Send a synchronous (non-streaming) chat request and return the complete
+     * {@link LLMResponse}.
+     *
+     * Throws an `OpenAI.APIError` on non-2xx responses. Callers should catch and
+     * handle these (e.g. rate limits, context length exceeded).
+     */
+    async chat(messages, options) {
+        const openAIMessages = buildOpenAIMessageList(messages, options.systemPrompt);
+        const completion = await this.#client.chat.completions.create({
+            // Sampling params first so extraBody can override them. Structural
+            // fields (model/messages/tools/stream) come after extraBody so users
+            // cannot accidentally clobber them via extraBody.
+            max_tokens: options.maxTokens,
+            temperature: options.temperature,
+            frequency_penalty: options.frequencyPenalty,
+            presence_penalty: options.presencePenalty,
+            top_p: options.topP,
+            top_k: options.topK,
+            min_p: options.minP,
+            parallel_tool_calls: options.parallelToolCalls,
+            reasoning_effort: options.thinking?.effort,
+            ...options.extraBody,
+            model: options.model,
+            messages: openAIMessages,
+            tools: options.tools ? options.tools.map(toOpenAITool) : undefined,
+            stream: false,
+            // Cast covers `top_k` / `min_p` and arbitrary `extraBody` keys,
+            // which local OpenAI-compatible servers (vLLM, llama-server) accept
+            // but the upstream SDK type does not declare.
+        }, {
+            signal: options.abortSignal,
+        });
+        const toolNames = options.tools?.map(t => t.name);
+        return fromOpenAICompletion(completion, toolNames);
+    }
+    // -------------------------------------------------------------------------
+    // stream()
+    // -------------------------------------------------------------------------
+    /**
+     * Send a streaming chat request and yield {@link StreamEvent}s incrementally.
+     *
+     * Sequence guarantees match {@link AnthropicAdapter.stream}:
+     * - Zero or more `text` events
+     * - Zero or more `reasoning` events
+     * - Zero or more `tool_use` events (emitted once per tool call, after
+     *   arguments have been fully assembled)
+     * - Exactly one terminal event: `done` or `error`
+     */
+    async *stream(messages, options) {
+        const openAIMessages = buildOpenAIMessageList(messages, options.systemPrompt);
+        // We request usage in the final chunk so we can include it in the `done` event.
+        const streamResponse = await this.#client.chat.completions.create({
+            // See chat() above for the rationale behind this field ordering.
+            max_tokens: options.maxTokens,
+            temperature: options.temperature,
+            frequency_penalty: options.frequencyPenalty,
+            presence_penalty: options.presencePenalty,
+            top_p: options.topP,
+            top_k: options.topK,
+            min_p: options.minP,
+            parallel_tool_calls: options.parallelToolCalls,
+            reasoning_effort: options.thinking?.effort,
+            ...options.extraBody,
+            model: options.model,
+            messages: openAIMessages,
+            tools: options.tools ? options.tools.map(toOpenAITool) : undefined,
+            stream: true,
+            stream_options: { include_usage: true },
+        }, {
+            signal: options.abortSignal,
+        });
+        // Accumulate state across chunks.
+        let completionId = '';
+        let completionModel = '';
+        let finalFinishReason = 'stop';
+        let inputTokens = 0;
+        let outputTokens = 0;
+        // tool_calls are streamed piecemeal; key = tool call index
+        const toolCallBuffers = new Map();
+        // Full text accumulator for the `done` response.
+        let fullReasoning = '';
+        let fullText = '';
+        try {
+            for await (const chunk of streamResponse) {
+                completionId = chunk.id;
+                completionModel = chunk.model;
+                // Usage is only populated in the final chunk when stream_options.include_usage is set.
+                if (chunk.usage !== null && chunk.usage !== undefined) {
+                    inputTokens = chunk.usage.prompt_tokens;
+                    outputTokens = chunk.usage.completion_tokens;
+                }
+                const choice = chunk.choices[0];
+                if (choice === undefined)
+                    continue;
+                const delta = choice.delta;
+                // --- text delta ---
+                if (delta.content !== null && delta.content !== undefined) {
+                    fullText += delta.content;
+                    const textEvent = { type: 'text', data: delta.content };
+                    yield textEvent;
+                }
+                // --- reasoning delta ---
+                const reasoningDelta = getOpenAIReasoningText(delta);
+                if (reasoningDelta.length > 0) {
+                    fullReasoning += reasoningDelta;
+                    const reasoningEvent = { type: 'reasoning', data: reasoningDelta };
+                    yield reasoningEvent;
+                }
+                // --- tool call delta ---
+                for (const toolCallDelta of delta.tool_calls ?? []) {
+                    const idx = toolCallDelta.index;
+                    if (!toolCallBuffers.has(idx)) {
+                        toolCallBuffers.set(idx, {
+                            id: toolCallDelta.id ?? '',
+                            name: toolCallDelta.function?.name ?? '',
+                            argsJson: '',
+                        });
+                    }
+                    const buf = toolCallBuffers.get(idx);
+                    // buf is guaranteed to exist: we just set it above.
+                    if (buf !== undefined) {
+                        if (toolCallDelta.id)
+                            buf.id = toolCallDelta.id;
+                        if (toolCallDelta.function?.name)
+                            buf.name = toolCallDelta.function.name;
+                        if (toolCallDelta.function?.arguments) {
+                            buf.argsJson += toolCallDelta.function.arguments;
+                        }
+                    }
+                }
+                if (choice.finish_reason !== null && choice.finish_reason !== undefined) {
+                    finalFinishReason = choice.finish_reason;
+                }
+            }
+            // Emit accumulated tool_use events after the stream ends.
+            const finalToolUseBlocks = [];
+            for (const buf of toolCallBuffers.values()) {
+                let parsedInput = {};
+                try {
+                    const parsed = JSON.parse(buf.argsJson);
+                    if (parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed)) {
+                        parsedInput = parsed;
+                    }
+                }
+                catch {
+                    // Malformed JSON — surface as empty object.
+                }
+                const toolUseBlock = {
+                    type: 'tool_use',
+                    id: buf.id,
+                    name: buf.name,
+                    input: parsedInput,
+                };
+                finalToolUseBlocks.push(toolUseBlock);
+                const toolUseEvent = { type: 'tool_use', data: toolUseBlock };
+                yield toolUseEvent;
+            }
+            // Build the complete content array for the done response.
+            const doneContent = [];
+            if (fullReasoning.length > 0) {
+                doneContent.push({ type: 'reasoning', text: fullReasoning });
+            }
+            if (fullText.length > 0) {
+                const textBlock = { type: 'text', text: fullText };
+                doneContent.push(textBlock);
+            }
+            doneContent.push(...finalToolUseBlocks);
+            // Fallback: extract tool calls from text when streaming produced no
+            // native tool_calls (same logic as fromOpenAICompletion).
+            if (finalToolUseBlocks.length === 0 && fullText.length > 0 && options.tools) {
+                const toolNames = options.tools.map(t => t.name);
+                const extracted = extractToolCallsFromText(fullText, toolNames);
+                if (extracted.length > 0) {
+                    doneContent.push(...extracted);
+                    for (const block of extracted) {
+                        yield { type: 'tool_use', data: block };
+                    }
+                }
+            }
+            const hasToolUseBlocks = doneContent.some(b => b.type === 'tool_use');
+            const resolvedStopReason = hasToolUseBlocks && finalFinishReason === 'stop'
+                ? 'tool_use'
+                : normalizeFinishReason(finalFinishReason);
+            const finalResponse = {
+                id: completionId,
+                content: doneContent,
+                model: completionModel,
+                stop_reason: resolvedStopReason,
+                usage: { input_tokens: inputTokens, output_tokens: outputTokens },
+            };
+            const doneEvent = { type: 'done', data: finalResponse };
+            yield doneEvent;
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            const errorEvent = { type: 'error', data: error };
+            yield errorEvent;
+        }
+    }
+}
+//# sourceMappingURL=openai.js.map

package/dist/llm/openai.js.map

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

package/dist/llm/qiniu.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview Qiniu adapter.
+ *
+ * Thin wrapper around OpenAIAdapter that hard-codes the official Qiniu
+ * OpenAI-compatible endpoint and QINIU_API_KEY environment variable fallback.
+ */
+import { OpenAIAdapter } from './openai.js';
+/**
+ * LLM adapter for Qiniu models (deepseek-v3 and future models).
+ *
+ * Thread-safe. Can be shared across agents.
+ *
+ * Usage:
+ *   provider: 'qiniu'
+ *   model: 'deepseek-v3' (or any model available to your Qiniu API key)
+ */
+export declare class QiniuAdapter extends OpenAIAdapter {
+    readonly name = "qiniu";
+    constructor(apiKey?: string, baseURL?: string);
+}
+//# sourceMappingURL=qiniu.d.ts.map

package/dist/llm/qiniu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qiniu.d.ts","sourceRoot":"","sources":["../../src/llm/qiniu.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3C;;;;;;;;GAQG;AACH,qBAAa,YAAa,SAAQ,aAAa;IAC7C,QAAQ,CAAC,IAAI,WAAU;gBAEX,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAO9C"}

package/dist/llm/qiniu.js

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview Qiniu adapter.
+ *
+ * Thin wrapper around OpenAIAdapter that hard-codes the official Qiniu
+ * OpenAI-compatible endpoint and QINIU_API_KEY environment variable fallback.
+ */
+import { OpenAIAdapter } from './openai.js';
+/**
+ * LLM adapter for Qiniu models (deepseek-v3 and future models).
+ *
+ * Thread-safe. Can be shared across agents.
+ *
+ * Usage:
+ *   provider: 'qiniu'
+ *   model: 'deepseek-v3' (or any model available to your Qiniu API key)
+ */
+export class QiniuAdapter extends OpenAIAdapter {
+    name = 'qiniu';
+    constructor(apiKey, baseURL) {
+        // Allow override of baseURL (for proxies or future changes) but default to official Qiniu endpoint.
+        super(apiKey ?? process.env['QINIU_API_KEY'], baseURL ?? 'https://api.qnaigc.com/v1');
+    }
+}
+//# sourceMappingURL=qiniu.js.map

package/dist/llm/qiniu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qiniu.js","sourceRoot":"","sources":["../../src/llm/qiniu.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3C;;;;;;;;GAQG;AACH,MAAM,OAAO,YAAa,SAAQ,aAAa;IACpC,IAAI,GAAG,OAAO,CAAA;IAEvB,YAAY,MAAe,EAAE,OAAgB;QAC3C,oGAAoG;QACpG,KAAK,CACH,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,EACtC,OAAO,IAAI,2BAA2B,CACvC,CAAA;IACH,CAAC;CACF"}

package/dist/mcp.d.ts

@@ -0,0 +1,3 @@
+export type { ConnectMCPToolsConfig, ConnectedMCPTools, } from './tool/mcp.js';
+export { connectMCPTools } from './tool/mcp.js';
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA"}

package/dist/mcp.js

@@ -0,0 +1,2 @@
+export { connectMCPTools } from './tool/mcp.js';
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA"}

package/dist/memory/shared.d.ts

@@ -0,0 +1,162 @@
+/**
+ * @fileoverview Shared memory layer for teams of cooperating agents.
+ *
+ * Each agent writes under its own namespace (`<agentName>/<key>`) so entries
+ * remain attributable, while any agent may read any entry. The
+ * {@link SharedMemory.getSummary} method produces a human-readable digest
+ * suitable for injecting into an agent's context window.
+ */
+import type { MemoryEntry, MemoryStore } from '../types.js';
+/**
+ * Namespaced shared memory for a team of agents.
+ *
+ * Writes are namespaced as `<agentName>/<key>` so that entries from different
+ * agents never collide and are always attributable. Reads are namespace-aware
+ * but also accept fully-qualified keys, making cross-agent reads straightforward.
+ *
+ * @example
+ * ```ts
+ * const mem = new SharedMemory()
+ *
+ * await mem.write('researcher', 'findings', 'TypeScript 5.5 ships const type params')
+ * await mem.write('coder', 'plan', 'Implement feature X using const type params')
+ *
+ * const entry = await mem.read('researcher/findings')
+ * const all = await mem.listByAgent('researcher')
+ * const summary = await mem.getSummary()
+ * ```
+ */
+export declare class SharedMemory {
+    private readonly store;
+    /**
+     * Monotonic turn counter used to evaluate per-entry `expiresAtTurn`.
+     * Advanced explicitly via {@link advanceTurn}; not bound to any specific
+     * unit (the orchestrator drives it once per completed task in `runTeam` /
+     * `runTasks`).
+     */
+    private turnCount;
+    /**
+     * @param store - Optional custom {@link MemoryStore} backing this shared memory.
+     *                Defaults to an in-process {@link InMemoryStore}. Custom stores
+     *                receive namespaced keys (`<agentName>/<key>`) opaque to them.
+     *                Stores that don't implement {@link MemoryStore.setWithExpiry}
+     *                still work — `writeExpiring` falls back to plain `set` on
+     *                them and the entry never expires.
+     *
+     * @throws {TypeError} when `store` is provided but does not structurally
+     *                     implement {@link MemoryStore} (fails fast on malformed
+     *                     values, e.g. plain objects from untrusted JSON config).
+     */
+    constructor(store?: MemoryStore);
+    /**
+     * Advance the turn counter by one. Entries previously written via
+     * {@link writeExpiring} with `ttlTurns: N` expire once the counter reaches
+     * `(write-time count) + N`.
+     *
+     * Called by the orchestrator after each completed task in `runTeam` and
+     * `runTasks`. Standalone `runAgent` does not advance the counter — there
+     * is no team turn boundary in single-agent runs.
+     */
+    advanceTurn(): void;
+    /** Current turn count. Useful for tests and observability. */
+    getTurnCount(): number;
+    /**
+     * Write `value` under the namespaced key `<agentName>/<key>`.
+     *
+     * Metadata is merged with a `{ agent: agentName }` marker so consumers can
+     * identify provenance when iterating all entries.
+     *
+     * @param agentName - The writing agent's name (used as a namespace prefix).
+     * @param key       - Logical key within the agent's namespace.
+     * @param value     - String value to store (serialise objects before writing).
+     * @param metadata  - Optional extra metadata stored alongside the entry.
+     */
+    write(agentName: string, key: string, value: string, metadata?: Record<string, unknown>): Promise<void>;
+    /**
+     * Like {@link write}, but tags the entry with a turn-count expiry so it is
+     * automatically dropped from reads once the {@link advanceTurn} counter has
+     * advanced `ttlTurns` steps.
+     *
+     * Backends that don't implement {@link MemoryStore.setWithExpiry} fall back
+     * to a plain write — the entry persists indefinitely and `ttlTurns` is
+     * effectively ignored. Custom store authors who need TTL must implement
+     * the optional method.
+     *
+     * @param ttlTurns - Number of turns the entry should remain readable for.
+     *                   Must be an integer ≥ 1; throws {@link RangeError}
+     *                   otherwise.
+     *
+     * @throws {RangeError} when `ttlTurns` is not an integer or is less than 1.
+     *
+     * @remarks
+     * In parallel batch execution (`runTasks` / `runTeam` running multiple
+     * tasks in one batch) the turn counter advances per *completed* task, not
+     * per *invoked* task. So if task A writes a TTL entry while task B is
+     * still running, B completing first will advance the counter and may
+     * expire A's entry sooner than wall-clock intuition suggests. For
+     * cross-task hand-off semantics that need stricter ordering, write the
+     * entry without TTL and delete explicitly.
+     */
+    writeExpiring(agentName: string, key: string, value: string, ttlTurns: number, metadata?: Record<string, unknown>): Promise<void>;
+    /**
+     * Read an entry by its fully-qualified key (`<agentName>/<key>`).
+     *
+     * Returns `null` when the key is absent **or** when the entry has expired
+     * (per its `expiresAtTurn` against the current turn counter). Expired
+     * entries are filtered out but **not** deleted from the underlying store —
+     * deletion is left to the store impl (Redis has native TTL, Postgres a
+     * cron, etc.). Reading is therefore safe to call from concurrent processes
+     * without the risk of stomping on a fresh write to the same key.
+     */
+    read(key: string): Promise<MemoryEntry | null>;
+    /** Returns every non-expired entry in the shared store, regardless of agent. */
+    listAll(): Promise<MemoryEntry[]>;
+    /**
+     * Returns all non-expired entries written by `agentName` (i.e. those whose
+     * key starts with `<agentName>/`).
+     */
+    listByAgent(agentName: string): Promise<MemoryEntry[]>;
+    /**
+     * Produces a human-readable summary of all entries in the store.
+     *
+     * The output is structured as a markdown-style block, grouped by agent, and
+     * is designed to be prepended to an agent's system prompt or injected as a
+     * user turn so the agent has context about what its teammates know.
+     *
+     * Returns an empty string when the store is empty.
+     *
+     * @example
+     * ```
+     * ## Shared Team Memory
+     *
+     * ### researcher
+     * - findings: TypeScript 5.5 ships const type params
+     *
+     * ### coder
+     * - plan: Implement feature X using const type params
+     * ```
+     */
+    getSummary(filter?: {
+        taskIds?: string[];
+    }): Promise<string>;
+    /**
+     * Returns the underlying {@link MemoryStore} so callers that only need the
+     * raw key-value interface can receive a properly typed reference without
+     * accessing private fields via bracket notation.
+     */
+    getStore(): MemoryStore;
+    private static namespaceKey;
+    /** True when `entry.expiresAtTurn` is set and has been reached. */
+    private isExpired;
+    /**
+     * Drops expired entries from `entries`. **Does not delete from the
+     * underlying store** — that would race with concurrent writers in
+     * distributed backends (the entry being deleted may have been
+     * overwritten with a fresh value between our read and our delete).
+     * Stores that want active cleanup should implement their own TTL sweep
+     * (Redis: native EXPIRE; Postgres: a cron). Entries without
+     * `expiresAtTurn` are always kept.
+     */
+    private filterExpired;
+}
+//# sourceMappingURL=shared.d.ts.map

package/dist/memory/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/memory/shared.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AA0B3D;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC;;;;;OAKG;IACH,OAAO,CAAC,SAAS,CAAI;IAErB;;;;;;;;;;;OAWG;gBACS,KAAK,CAAC,EAAE,WAAW;IAc/B;;;;;;;;OAQG;IACH,WAAW,IAAI,IAAI;IAInB,8DAA8D;IAC9D,YAAY,IAAI,MAAM;IAQtB;;;;;;;;;;OAUG;IACG,KAAK,CACT,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC;IAQhB;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,aAAa,CACjB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC;IAsBhB;;;;;;;;;OASG;IACG,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAWpD,gFAAgF;IAC1E,OAAO,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAIvC;;;OAGG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAW5D;;;;;;;;;;;;;;;;;;;OAmBG;IACG,UAAU,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAiDlE;;;;OAIG;IACH,QAAQ,IAAI,WAAW;IAQvB,OAAO,CAAC,MAAM,CAAC,YAAY;IAI3B,mEAAmE;IACnE,OAAO,CAAC,SAAS;IAIjB;;;;;;;;OAQG;IACH,OAAO,CAAC,aAAa;CAGtB"}