daemora 1.0.0-alpha.0

package/dist/core/AgentLoop.d.ts.map

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

package/dist/core/AgentLoop.js

@@ -0,0 +1,428 @@
+/**
+ * AgentLoop — runs one agent turn end to end. Owns:
+ *   - The per-request ToolRegistry (core tools at construction; crew
+ *     tools via installCrews() once the crew runner exists).
+ *   - Calling the model with streaming + tool execution.
+ *   - Surfacing every event (text, tool call, tool result, error) as a
+ *     typed discriminated union the caller can translate to SSE / a UI.
+ */
+import { readFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { stepCountIs, streamText } from "ai";
+import { buildCoreTools } from "../tools/core/index.js";
+import { makeParallelCrewTool } from "../tools/core/parallelCrew.js";
+import { makeListCrewsTool } from "../tools/core/listCrews.js";
+import { makeUseCrewTool } from "../tools/core/useCrew.js";
+import { ToolRegistry } from "../tools/registry.js";
+import { toAiTool } from "../tools/types.js";
+import { CancelledError, ConfigError, toDaemoraError } from "../util/errors.js";
+import { createLogger } from "../util/logger.js";
+const log = createLogger("agent.loop");
+/** Max tool-call iterations per turn. Prevents runaway loops. */
+const DEFAULT_MAX_STEPS = 10;
+/** Tool result payload cap (bytes) over SSE — DB keeps the full thing. */
+const SSE_RESULT_CAP = 4_096;
+export class AgentLoop {
+    tools;
+    models;
+    cfg;
+    skills;
+    mcp;
+    hooks;
+    declarativeMemory;
+    loopDetector;
+    crews;
+    /** Set at the start of every run() before tools can fire. */
+    _currentResolvedModelId = "";
+    /**
+     * Per-session system-prompt cache. Hermes pattern: build once at
+     * session start, reuse across every turn. Invalidated by
+     * `invalidateSystemPromptCache(sessionId)` on compaction, memory
+     * reload, or skill-set change.
+     */
+    systemPromptCache = new Map();
+    getEnabledIntegrations;
+    constructor(deps) {
+        this.cfg = deps.cfg;
+        this.models = deps.models;
+        this.skills = deps.skills;
+        this.mcp = deps.mcp;
+        this.hooks = deps.hooks;
+        this.declarativeMemory = deps.declarativeMemory;
+        this.loopDetector = deps.loopDetector;
+        if (deps.getEnabledIntegrations)
+            this.getEnabledIntegrations = deps.getEnabledIntegrations;
+        this.tools = new ToolRegistry();
+        const skills = deps.skills;
+        const skillLoader = deps.skillLoader;
+        const skillsRoot = deps.skillsRoot;
+        this.tools.registerAll(buildCoreTools({
+            cfg: deps.cfg, guard: deps.guard, memory: deps.memory,
+            skills, models: deps.models,
+            ...(deps.mcp ? { mcp: deps.mcp } : {}),
+            ...(skillLoader ? { skillLoader } : {}),
+            ...(skillsRoot ? { skillsRoot } : {}),
+            ...(deps.declarativeMemory ? { declarativeMemory: deps.declarativeMemory } : {}),
+            ...(deps.sessions ? { sessions: deps.sessions } : {}),
+            ...(deps.bus ? { bus: deps.bus } : {}),
+            ...(skillLoader && skillsRoot
+                ? {
+                    onSkillsChanged: async () => {
+                        const { loaded } = await skillLoader.loadAll();
+                        skills.replace(loaded);
+                        // Skills changed → every session's cached system prompt
+                        // is stale; drop them all so the next turn rebuilds.
+                        this.systemPromptCache.clear();
+                    },
+                }
+                : {}),
+        }));
+    }
+    /**
+     * Install crew delegation tools AFTER the CrewAgentRunner exists.
+     * Split from the constructor because the runner needs a reference
+     * back to THIS AgentLoop's ToolRegistry, closing the init cycle.
+     */
+    installCrews(registry, runner) {
+        this.crews = registry;
+        // list_crews is registered even when there are zero crews loaded —
+        // it just returns an empty list. Doing it unconditionally keeps the
+        // tool catalog stable so the model can probe the registry safely.
+        this.tools.register(makeListCrewsTool(registry));
+        if (registry.size === 0)
+            return;
+        const turn = { resolvedModel: () => this.currentResolvedModel() };
+        this.tools.register(makeUseCrewTool(registry, runner, turn));
+        this.tools.register(makeParallelCrewTool(registry, runner, turn));
+    }
+    /** Model id the live turn is resolved to. Throws if called outside a turn. */
+    currentResolvedModel() {
+        if (!this._currentResolvedModelId) {
+            throw new ConfigError("currentResolvedModel() called outside a turn");
+        }
+        return this._currentResolvedModelId;
+    }
+    /**
+     * Invalidate cached system prompt for a session. Call when:
+     *   - Compaction rolled the session to a child id (the child gets a
+     *     fresh system prompt matching the compacted head).
+     *   - Declarative memory was reloaded.
+     *   - Skill registry was mutated.
+     */
+    invalidateSystemPromptCache(sessionId) {
+        if (!sessionId) {
+            this.systemPromptCache.clear();
+            return;
+        }
+        for (const key of this.systemPromptCache.keys()) {
+            if (key.startsWith(`${sessionId}:`))
+                this.systemPromptCache.delete(key);
+        }
+    }
+    async run(input) {
+        const modelId = input.model ?? this.models.resolveDefault();
+        const resolved = await this.models.resolve(modelId);
+        this._currentResolvedModelId = resolved.id;
+        const enabledIntegrations = this.getEnabledIntegrations?.() ?? new Set();
+        // Pure hermes pattern: no matcher. Every available tool goes into
+        // the turn; the agent decides via the skill index which skills to
+        // load, and calls skill_view(name) to read them.
+        const availableNames = input.allowedTools && input.allowedTools.length > 0
+            ? new Set(input.allowedTools)
+            : new Set(this.tools.list().map((t) => t.name));
+        const allToolDefs = this.tools.available(enabledIntegrations);
+        const toolDefs = input.allowedTools && input.allowedTools.length > 0
+            ? allToolDefs.filter((t) => availableNames.has(t.name))
+            : allToolDefs;
+        // System prompt: cached per-session when sessionId is provided (hermes
+        // pattern). Voice mode flips the prompt content so it gets its own
+        // cache key; sub-agent spawns with allowedTools bypass the cache since
+        // the skills index reflects the narrower toolset.
+        const cacheKey = input.sessionId && !input.voiceMode
+            && !(input.allowedTools && input.allowedTools.length > 0)
+            ? `${input.sessionId}:${resolved.id}` : null;
+        let systemPrompt;
+        if (cacheKey && this.systemPromptCache.has(cacheKey)) {
+            systemPrompt = this.systemPromptCache.get(cacheKey);
+        }
+        else {
+            const skillsIndex = this.skills.renderIndexForPrompt({
+                availableTools: availableNames,
+                enabledIntegrations,
+            });
+            systemPrompt = await this.buildSystemPrompt(skillsIndex, input.voiceMode ?? false);
+            if (cacheKey)
+                this.systemPromptCache.set(cacheKey, systemPrompt);
+        }
+        // Build the user turn. When images are attached we switch to the
+        // multimodal content-parts form: [{type:'text'}, {type:'image'}, …].
+        // The AI SDK transparently drops image parts for non-multimodal
+        // models, so this is safe even if the resolved model is text-only.
+        const hasImages = !!(input.userImages && input.userImages.length > 0);
+        const hasFiles = !!(input.userFiles && input.userFiles.length > 0);
+        const userContent = hasImages || hasFiles
+            ? [
+                { type: "text", text: input.userMessage },
+                ...(input.userImages ?? []).map((p) => ({
+                    type: "image",
+                    image: p.image,
+                    mediaType: p.mimeType,
+                })),
+                ...(input.userFiles ?? []).map((p) => ({
+                    type: "file",
+                    data: p.data,
+                    mediaType: p.mimeType,
+                    ...(p.filename ? { filename: p.filename } : {}),
+                })),
+            ]
+            : input.userMessage;
+        const messages = [
+            ...(input.history ?? []),
+            { role: "user", content: userContent },
+        ];
+        const ctxFactory = (signal) => ({
+            abortSignal: signal,
+            taskId: input.taskId,
+            logger: {
+                info: (msg, ctx) => log.info({ taskId: input.taskId, ...ctx }, msg),
+                warn: (msg, ctx) => log.warn({ taskId: input.taskId, ...ctx }, msg),
+                error: (msg, ctx) => log.error({ taskId: input.taskId, ...ctx }, msg),
+            },
+        });
+        const hooks = this.hooks;
+        const loops = this.loopDetector;
+        const aiTools = Object.fromEntries(toolDefs.map((t) => {
+            let def = t;
+            if (loops)
+                def = wrapWithLoopDetection(def, loops, input.taskId);
+            if (hooks)
+                def = wrapWithHooks(def, hooks, input.taskId);
+            return [t.name, toAiTool(def, ctxFactory)];
+        }));
+        log.info({
+            taskId: input.taskId,
+            modelId,
+            toolCount: toolDefs.length,
+            skillsVisible: this.skills.visible({
+                availableTools: availableNames,
+                enabledIntegrations,
+            }).length,
+            maxSteps: input.maxSteps ?? DEFAULT_MAX_STEPS,
+            crewCount: this.crews?.size ?? 0,
+        }, "agent turn starting");
+        const stream = streamText({
+            model: resolved.model,
+            system: systemPrompt,
+            messages,
+            tools: aiTools,
+            stopWhen: stepCountIs(input.maxSteps ?? DEFAULT_MAX_STEPS),
+            ...(input.abortSignal ? { abortSignal: input.abortSignal } : {}),
+        });
+        const events = translateFullStream(stream.fullStream, input);
+        return {
+            modelId: resolved.id,
+            eventStream: events,
+            responseMessages: async () => {
+                const resp = await stream.response;
+                return resp.messages;
+            },
+        };
+    }
+    async buildSystemPrompt(skillsIndex, voiceMode) {
+        // SOUL.md is the agent's core personality — loaded once and cached.
+        if (!AgentLoop._soulPrompt) {
+            try {
+                const soulPath = join(dirname(fileURLToPath(import.meta.url)), "../../SOUL.md");
+                AgentLoop._soulPrompt = readFileSync(soulPath, "utf-8").trim();
+            }
+            catch {
+                AgentLoop._soulPrompt = "You are Daemora — a personal AI agent. Call tools to complete tasks. Be direct.";
+            }
+        }
+        const sections = [AgentLoop._soulPrompt];
+        // Declarative memory — frozen snapshots injected once per session
+        // so the prefix cache stays warm across every turn.
+        if (this.declarativeMemory) {
+            const userBlock = this.declarativeMemory.formatForSystemPrompt("user");
+            if (userBlock)
+                sections.push("\n" + userBlock);
+            const memBlock = this.declarativeMemory.formatForSystemPrompt("memory");
+            if (memBlock)
+                sections.push("\n" + memBlock);
+        }
+        // Available tools summary so the agent knows what it can call.
+        const toolNames = this.tools.list().map((t) => t.name);
+        sections.push(`\n## Available Tools\n${toolNames.join(", ")}`);
+        if (this.crews && this.crews.size > 0) {
+            sections.push("\n## Available Crews");
+            for (const line of this.crews.summaryLines())
+                sections.push(line);
+        }
+        if (this.mcp) {
+            const all = this.mcp.listStatus();
+            const connected = all.filter((s) => s.status === "connected");
+            const inactive = all.filter((s) => s.status !== "connected");
+            if (connected.length > 0) {
+                sections.push("\n## Connected MCP Servers");
+                for (const s of connected) {
+                    sections.push(`- ${s.name}: ${s.tools.length} tools (${s.tools.map((t) => t.name).join(", ")})`);
+                }
+                sections.push("Call `use_mcp(server, task)` to delegate, or `use_mcp(server, task, tool, args)` to call a specific tool.");
+            }
+            // Make the distinction explicit: the agent should NOT claim these
+            // are currently usable. They exist as configurable integrations
+            // the USER can enable from the /mcp page. If the agent calls
+            // `use_mcp` on one of these it gets a "server is disabled" error.
+            if (inactive.length > 0) {
+                sections.push("\n## Inactive MCP Servers (USER must enable before use)");
+                sections.push("These are registered but not currently connected. " +
+                    "You CANNOT call tools on them. " +
+                    "If the user asks for one, tell them to enable it at `/mcp` and configure any required credentials.");
+                sections.push(inactive.map((s) => `- ${s.name}${s.configured ? "" : " (needs config)"}`).join("\n"));
+            }
+        }
+        if (skillsIndex) {
+            sections.push("\n" + skillsIndex);
+        }
+        if (voiceMode) {
+            sections.push("\n## VOICE MODE ENABLED", "Read aloud. Talk like a human — be short/concise 1 or 1.5 sentences, warm, with emotion.", "- Summarise. Never list, enumerate, or recite identifiers, codes, paths, or technical details.", "- No markdown, bullets, code, emoji, URLs, No numbers read digit-by-digit.", "- Output plain spoken words only. No punctuation/symbols like / * ^ % @ ! # ( ) ~ _ | < > { } [ ] \\ ` — use only .,?! as sentence punctuation.");
+        }
+        void this.cfg;
+        return sections.join("\n");
+    }
+    static _soulPrompt = null;
+}
+async function* translateFullStream(fullStream, input) {
+    try {
+        for await (const raw of fullStream) {
+            const part = raw;
+            switch (part.type) {
+                case "text-delta": {
+                    const text = part["text"] ?? "";
+                    if (text.length > 0)
+                        yield { type: "text-delta", delta: text };
+                    break;
+                }
+                case "reasoning-delta": {
+                    const text = part["text"] ?? "";
+                    if (text.length > 0)
+                        yield { type: "reasoning-delta", delta: text };
+                    break;
+                }
+                case "tool-call": {
+                    const id = String(part["toolCallId"] ?? "");
+                    const name = String(part["toolName"] ?? "");
+                    const args = part["input"] ?? part["args"] ?? null;
+                    log.info({ taskId: input.taskId, toolCallId: id, tool: name, args }, "tool call");
+                    yield { type: "tool-call", id, name, args };
+                    break;
+                }
+                case "tool-result": {
+                    const result = part["output"] ?? part["result"] ?? null;
+                    const { value, truncated } = clipForTransport(result);
+                    const id = String(part["toolCallId"] ?? "");
+                    const name = String(part["toolName"] ?? "");
+                    log.info({ taskId: input.taskId, toolCallId: id, tool: name, truncated }, "tool result");
+                    yield { type: "tool-result", id, name, result: value, truncated };
+                    break;
+                }
+                case "tool-error": {
+                    const err = part["error"];
+                    const message = err?.message ?? String(part["error"] ?? "tool error");
+                    const id = String(part["toolCallId"] ?? "");
+                    const name = String(part["toolName"] ?? "");
+                    log.error({ taskId: input.taskId, toolCallId: id, tool: name, err: message }, "tool error");
+                    yield { type: "tool-error", id, name, message };
+                    break;
+                }
+                case "finish-step": {
+                    yield { type: "step-finish", finishReason: String(part["finishReason"] ?? "unknown") };
+                    break;
+                }
+                case "finish": {
+                    const usage = (part["totalUsage"] ?? part["usage"] ?? {});
+                    yield {
+                        type: "finish",
+                        inputTokens: usage.inputTokens ?? 0,
+                        outputTokens: usage.outputTokens ?? 0,
+                    };
+                    break;
+                }
+                case "error": {
+                    const err = part["error"];
+                    const msg = err instanceof Error ? err.message : String(err ?? "stream error");
+                    yield { type: "error", message: msg };
+                    break;
+                }
+            }
+        }
+    }
+    catch (e) {
+        if (input.abortSignal?.aborted)
+            throw new CancelledError();
+        const err = toDaemoraError(e);
+        log.error({ taskId: input.taskId, err: err.message, code: err.code }, "agent stream error");
+        yield { type: "error", message: err.message };
+    }
+}
+function clipForTransport(value) {
+    const json = safeStringify(value);
+    if (json.length <= SSE_RESULT_CAP)
+        return { value, truncated: false };
+    return {
+        value: `${json.slice(0, SSE_RESULT_CAP)}…[+${json.length - SSE_RESULT_CAP} more bytes]`,
+        truncated: true,
+    };
+}
+function safeStringify(v) {
+    try {
+        return JSON.stringify(v) ?? "";
+    }
+    catch {
+        return String(v);
+    }
+}
+/**
+ * Decorate a tool with loop-detection. Before execute() fires, record
+ * the call in the detector's per-task history. If a loop is detected,
+ * throw — streamText surfaces as tool-error, model reacts.
+ */
+function wrapWithLoopDetection(def, loops, taskId) {
+    return {
+        ...def,
+        execute: async (input, ctx) => {
+            const check = loops.record(def.name, input, taskId);
+            if (check.blocked) {
+                throw new Error(check.message ?? `Loop detected in tool "${def.name}"`);
+            }
+            const parsed = def.inputSchema.parse(input);
+            return def.execute(parsed, ctx);
+        },
+    };
+}
+/**
+ * Decorate a tool with PreToolUse / PostToolUse hooks. A blocking
+ * pre-hook throws — streamText surfaces that as a tool-error and the
+ * model gets a chance to react ("tool blocked: reason"). Modified
+ * input silently replaces the original. Post-hooks are fire-and-forget:
+ * their decision is logged but cannot unmake the side effect.
+ */
+function wrapWithHooks(def, hooks, taskId) {
+    return {
+        ...def,
+        execute: async (input, ctx) => {
+            const pre = await hooks.run("PreToolUse", { taskId, toolName: def.name, toolInput: input });
+            if (pre.decision === "block") {
+                const reason = pre.reason ?? "blocked by hook";
+                throw new Error(`tool ${def.name} blocked by hook: ${reason}`);
+            }
+            const effectiveInput = pre.modifiedInput ?? input;
+            const parsed = def.inputSchema.parse(effectiveInput);
+            const result = await def.execute(parsed, ctx);
+            await hooks.run("PostToolUse", { taskId, toolName: def.name, toolInput: parsed, toolOutput: result });
+            return result;
+        },
+    };
+}
+//# sourceMappingURL=AgentLoop.js.map

package/dist/core/AgentLoop.js.map

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

package/dist/core/AttachmentProcessor.d.ts

@@ -0,0 +1,75 @@
+/**
+ * AttachmentProcessor — normalise inbound files into model-ready input.
+ *
+ * A channel / HTTP upload hands us one or more `InboundAttachment`s.
+ * Before the agent turn starts we:
+ *
+ *   1. Resolve each to a readable local path (downloading remote URLs
+ *      into `<dataDir>/inbox/` if needed).
+ *   2. Decide what to do based on kind/mime:
+ *        image  → emit an `image` content-part alongside the text turn
+ *                 (multimodal models see it inline)
+ *        audio  → transcribe via existing STT pipeline + merge text
+ *        text   → read the file and inline a bounded excerpt
+ *        other  → leave on disk, append a `[file: /path (mime, size)]`
+ *                 hint so the agent can reach for read_file / execute_command
+ *
+ * Returns the potentially-modified user text plus any image parts the
+ * caller should merge into the message content array. Failures never
+ * break the turn — the agent gets a best-effort result with any errors
+ * noted inline.
+ */
+import type { ConfigManager } from "../config/ConfigManager.js";
+export interface RawAttachment {
+    readonly kind: "image" | "audio" | "video" | "document" | "file";
+    readonly url?: string;
+    readonly path?: string;
+    readonly mimeType: string;
+    readonly filename?: string;
+    readonly size?: number;
+    readonly authHeader?: string;
+}
+export interface ImagePart {
+    readonly type: "image";
+    readonly image: Buffer;
+    readonly mimeType: string;
+}
+/**
+ * File content part — forwarded as-is to the model. The AI SDK maps
+ * this to provider-native document APIs (Anthropic's `document` block,
+ * Google Gemini `inline_data`, OpenAI Responses file input) so the
+ * model sees the original PDF with its text, tables, and figures
+ * intact. No local text extraction.
+ */
+export interface FilePart {
+    readonly type: "file";
+    readonly data: Buffer;
+    readonly mimeType: string;
+    readonly filename?: string;
+}
+export interface ProcessedAttachments {
+    /** Amended user text — original text plus any inlined excerpts / hints. */
+    readonly text: string;
+    /** Image content parts to merge into the model message, if any. */
+    readonly imageParts: readonly ImagePart[];
+    /** File content parts (PDFs etc.) to merge into the model message. */
+    readonly fileParts: readonly FilePart[];
+}
+export interface AttachmentProcessorDeps {
+    readonly cfg: ConfigManager;
+    readonly dataDir: string;
+}
+export declare class AttachmentProcessor {
+    private readonly deps;
+    private readonly inboxDir;
+    constructor(deps: AttachmentProcessorDeps);
+    process(baseText: string, attachments: readonly RawAttachment[] | undefined): Promise<ProcessedAttachments>;
+    /**
+     * Return a local path for the attachment. If the channel already
+     * provided one we use it directly; otherwise we download the remote
+     * URL into the inbox directory and return the saved path.
+     */
+    private ensureLocal;
+    private transcribe;
+}
+//# sourceMappingURL=AttachmentProcessor.d.ts.map

package/dist/core/AttachmentProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AttachmentProcessor.d.ts","sourceRoot":"","sources":["../../src/core/AttachmentProcessor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAQH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAqBhE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;IACjE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,QAAQ,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,CAAC;IAC1C,sEAAsE;IACtE,QAAQ,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,mBAAmB;IAGlB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEL,IAAI,EAAE,uBAAuB;IASpD,OAAO,CACX,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,SAAS,aAAa,EAAE,GAAG,SAAS,GAChD,OAAO,CAAC,oBAAoB,CAAC;IAyEhC;;;;OAIG;YACW,WAAW;YAkBX,UAAU;CASzB"}