@oni.bot/core 0.6.2 → 0.8.0

package/dist/harness/agent-loop.js

@@ -0,0 +1,327 @@
+// ============================================================
+// @oni.bot/core/harness — AgentLoop
+// Think → Act → Observe async generator driving each agent node
+// ============================================================
+import { generateId } from "./types.js";
+// ─── agentLoop ─────────────────────────────────────────────────────────────
+export async function* agentLoop(prompt, config) {
+    const sessionId = generateId("ses");
+    const threadId = config.threadId ?? generateId("thr");
+    const maxTurns = config.maxTurns ?? 10;
+    const messages = [];
+    let turn = 0;
+    // ── 1. Session Init ──────────────────────────────────────────────────
+    if (config.hooksEngine) {
+        const hookResult = await config.hooksEngine.fire("SessionStart", {
+            sessionId,
+            agentName: config.agentName,
+            tools: config.tools.map((t) => t.name),
+        });
+        if (hookResult?.additionalContext) {
+            messages.push({ role: "user", content: hookResult.additionalContext });
+            messages.push({ role: "assistant", content: "Context loaded." });
+        }
+    }
+    // Push user prompt
+    messages.push({ role: "user", content: prompt });
+    yield makeMessage("system", sessionId, turn, {
+        subtype: "init",
+        content: `Session ${sessionId} started for agent "${config.agentName}"`,
+    });
+    // ── 2. Build LLMToolDef[] ────────────────────────────────────────────
+    const llmTools = config.tools.map((t) => ({
+        name: t.name,
+        description: t.description,
+        parameters: t.schema,
+    }));
+    // Tool lookup map
+    const toolMap = new Map();
+    for (const t of config.tools) {
+        toolMap.set(t.name, t);
+    }
+    // ── 3. Main Loop ─────────────────────────────────────────────────────
+    while (turn < maxTurns) {
+        // ── 3a. Check AbortSignal ────────────────────────────────────────
+        if (config.signal?.aborted) {
+            yield makeMessage("error", sessionId, turn, {
+                content: "Agent loop aborted by signal",
+            });
+            return;
+        }
+        // ── 3b. Context Compaction ───────────────────────────────────────
+        if (config.compactor && config.compactor.shouldCompact(messages)) {
+            if (config.hooksEngine) {
+                await config.hooksEngine.fire("PreCompact", {
+                    sessionId,
+                    messageCount: messages.length,
+                    estimatedTokens: config.compactor.estimateTokens(messages),
+                });
+            }
+            const compacted = await config.compactor.compact(messages);
+            messages.length = 0;
+            messages.push(...compacted);
+            yield makeMessage("system", sessionId, turn, {
+                subtype: "compact_boundary",
+                content: "Context compacted",
+            });
+        }
+        // ── 3c. Build system prompt ──────────────────────────────────────
+        let systemPrompt = config.systemPrompt;
+        if (config.env) {
+            const envLines = [];
+            if (config.env.cwd)
+                envLines.push(`Working directory: ${config.env.cwd}`);
+            if (config.env.platform)
+                envLines.push(`Platform: ${config.env.platform}`);
+            if (config.env.date)
+                envLines.push(`Date: ${config.env.date}`);
+            if (config.env.gitBranch)
+                envLines.push(`Git branch: ${config.env.gitBranch}`);
+            if (config.env.gitStatus)
+                envLines.push(`Git status: ${config.env.gitStatus}`);
+            if (envLines.length > 0) {
+                systemPrompt += `\n\n<env>\n${envLines.join("\n")}\n</env>`;
+            }
+        }
+        // ── 3d. Skill injection ──────────────────────────────────────────
+        if (config.skillLoader) {
+            const pending = config.skillLoader.getPendingInjection();
+            if (pending) {
+                messages.push({ role: "user", content: pending });
+                messages.push({ role: "assistant", content: "Skill instructions loaded." });
+                config.skillLoader.clearPendingInjection();
+            }
+        }
+        // ── 3e. Inference ────────────────────────────────────────────────
+        let response;
+        try {
+            response = await config.model.chat({
+                messages,
+                tools: llmTools.length > 0 ? llmTools : undefined,
+                systemPrompt,
+                maxTokens: 8192,
+            });
+        }
+        catch (err) {
+            yield makeMessage("error", sessionId, turn, {
+                content: `Inference error: ${err instanceof Error ? err.message : String(err)}`,
+            });
+            return;
+        }
+        // ── 3f. Yield assistant message ──────────────────────────────────
+        yield makeMessage("assistant", sessionId, turn, {
+            content: response.content,
+            toolCalls: response.toolCalls,
+            metadata: {
+                usage: response.usage,
+                stopReason: response.stopReason,
+            },
+        });
+        // ── 3g. Stop condition ───────────────────────────────────────────
+        if (!response.toolCalls || response.toolCalls.length === 0) {
+            if (config.hooksEngine) {
+                const stopResult = await config.hooksEngine.fire("Stop", {
+                    sessionId,
+                    response: response.content,
+                });
+                if (stopResult?.decision === "block") {
+                    // Inject feedback as user message, increment turn, continue
+                    const feedback = stopResult.reason ?? "Please provide a more complete response.";
+                    messages.push({
+                        role: "assistant",
+                        content: response.content,
+                    });
+                    messages.push({
+                        role: "user",
+                        content: feedback,
+                    });
+                    turn++;
+                    continue;
+                }
+            }
+            // Fire SessionEnd and yield result
+            if (config.hooksEngine) {
+                await config.hooksEngine.fire("SessionEnd", {
+                    sessionId,
+                    reason: "completed",
+                    turns: turn + 1,
+                });
+            }
+            yield makeMessage("result", sessionId, turn, {
+                content: response.content,
+                metadata: { totalTurns: turn + 1 },
+            });
+            return;
+        }
+        // ── 3h. Tool execution ───────────────────────────────────────────
+        const toolResults = [];
+        for (const toolCall of response.toolCalls) {
+            // Fire PreToolUse hook
+            if (config.hooksEngine) {
+                const preResult = await config.hooksEngine.fire("PreToolUse", {
+                    sessionId,
+                    toolName: toolCall.name,
+                    input: toolCall.args,
+                });
+                if (preResult?.decision === "deny") {
+                    toolResults.push({
+                        toolCallId: toolCall.id,
+                        toolName: toolCall.name,
+                        content: `Tool use denied: ${preResult.reason ?? "blocked by hook"}`,
+                        isError: true,
+                    });
+                    continue;
+                }
+                // Apply modifiedInput if hook returned one
+                if (preResult?.modifiedInput) {
+                    Object.assign(toolCall.args, preResult.modifiedInput);
+                }
+            }
+            // Safety gate check
+            if (config.safetyGate && config.safetyGate.requiresCheck(toolCall.name)) {
+                const safetyResult = await config.safetyGate.check({
+                    id: toolCall.id,
+                    name: toolCall.name,
+                    args: toolCall.args,
+                });
+                if (!safetyResult.approved) {
+                    toolResults.push({
+                        toolCallId: toolCall.id,
+                        toolName: toolCall.name,
+                        content: `Tool blocked by safety gate: ${safetyResult.reason ?? "unsafe operation"}`,
+                        isError: true,
+                    });
+                    continue;
+                }
+            }
+            // Find and execute tool
+            const toolDef = toolMap.get(toolCall.name);
+            if (!toolDef) {
+                toolResults.push({
+                    toolCallId: toolCall.id,
+                    toolName: toolCall.name,
+                    content: `Unknown tool: ${toolCall.name}`,
+                    isError: true,
+                });
+                continue;
+            }
+            const toolCtx = {
+                config: {},
+                store: null,
+                state: {},
+                emit: () => { },
+                sessionId,
+                threadId,
+                agentName: config.agentName,
+                turn,
+                signal: config.signal,
+            };
+            try {
+                const startTime = Date.now();
+                const rawResult = await toolDef.execute(toolCall.args, toolCtx);
+                const durationMs = Date.now() - startTime;
+                const content = typeof rawResult === "string" ? rawResult : JSON.stringify(rawResult);
+                // Fire PostToolUse
+                if (config.hooksEngine) {
+                    await config.hooksEngine.fire("PostToolUse", {
+                        sessionId,
+                        toolName: toolCall.name,
+                        input: toolCall.args,
+                        output: rawResult,
+                        durationMs,
+                    });
+                }
+                toolResults.push({
+                    toolCallId: toolCall.id,
+                    toolName: toolCall.name,
+                    content,
+                });
+            }
+            catch (err) {
+                const errorMsg = err instanceof Error ? err.message : String(err);
+                // Fire PostToolUseFailure
+                if (config.hooksEngine) {
+                    await config.hooksEngine.fire("PostToolUseFailure", {
+                        sessionId,
+                        toolName: toolCall.name,
+                        input: toolCall.args,
+                        error: err instanceof Error ? err : errorMsg,
+                    });
+                }
+                toolResults.push({
+                    toolCallId: toolCall.id,
+                    toolName: toolCall.name,
+                    content: `Tool error: ${errorMsg}`,
+                    isError: true,
+                });
+            }
+        }
+        // ── 3i. Update messages ──────────────────────────────────────────
+        messages.push({
+            role: "assistant",
+            content: response.content,
+            toolCalls: response.toolCalls,
+        });
+        for (const tr of toolResults) {
+            messages.push({
+                role: "tool",
+                content: tr.content,
+                toolCallId: tr.toolCallId,
+                name: tr.toolName,
+            });
+        }
+        // ── 3j. TODO reminder ────────────────────────────────────────────
+        if (config.todoModule) {
+            const todoState = config.todoModule.getState();
+            if (todoState.todos.length > 0) {
+                const reminder = config.todoModule.toContextString();
+                messages.push({ role: "user", content: `<system-reminder>\n${reminder}\n</system-reminder>` });
+                messages.push({ role: "assistant", content: "Noted." });
+                yield makeMessage("system", sessionId, turn, {
+                    subtype: "todo_reminder",
+                    content: reminder,
+                });
+            }
+        }
+        // ── 3k. Yield tool_result, increment turn ───────────────────────
+        yield makeMessage("tool_result", sessionId, turn, {
+            toolResults,
+        });
+        turn++;
+    }
+    // ── 4. maxTurns exceeded ─────────────────────────────────────────────
+    yield makeMessage("error", sessionId, turn, {
+        content: `Agent loop exceeded maxTurns (${maxTurns})`,
+    });
+}
+// ─── wrapWithAgentLoop ─────────────────────────────────────────────────────
+export function wrapWithAgentLoop(config) {
+    return async (state) => {
+        const prompt = state.task ??
+            state.context ??
+            "";
+        let finalResult = "";
+        for await (const msg of agentLoop(prompt, config)) {
+            if (msg.type === "result") {
+                finalResult = msg.content ?? "";
+            }
+        }
+        return {
+            agentResults: {
+                ...(state.agentResults ?? {}),
+                [config.agentName]: finalResult,
+            },
+        };
+    };
+}
+// ─── Helpers ───────────────────────────────────────────────────────────────
+function makeMessage(type, sessionId, turn, overrides = {}) {
+    return {
+        type,
+        sessionId,
+        turn,
+        timestamp: Date.now(),
+        ...overrides,
+    };
+}
+//# sourceMappingURL=agent-loop.js.map

package/dist/harness/agent-loop.js.map

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

package/dist/harness/context-compactor.d.ts

@@ -0,0 +1,73 @@
+import type { ONIModel, ONIModelMessage } from "../models/types.js";
+export interface CompactorConfig {
+    /** Model used to generate the summary (typically a fast/cheap model) */
+    summaryModel: ONIModel;
+    /**
+     * Usage fraction at which compaction triggers.
+     * Research: performance degrades non-linearly above 65%.
+     * @default 0.68
+     */
+    threshold?: number;
+    /**
+     * Maximum token budget for the context window.
+     * @default 200_000
+     */
+    maxTokens?: number;
+    /**
+     * Approximate characters per token for estimation.
+     * @default 4
+     */
+    charsPerToken?: number;
+    /**
+     * Additional instructions included in the summarization prompt.
+     */
+    compactInstructions?: string;
+}
+export declare class ContextCompactor {
+    private readonly summaryModel;
+    private readonly threshold;
+    private readonly maxTokens;
+    private readonly charsPerToken;
+    private readonly compactInstructions?;
+    constructor(config: CompactorConfig);
+    /**
+     * Estimate token count from total character length of all messages.
+     * Uses ceiling to avoid underestimation.
+     */
+    estimateTokens(messages: ONIModelMessage[]): number;
+    /**
+     * Returns true when estimated usage exceeds the compaction threshold.
+     */
+    shouldCompact(messages: ONIModelMessage[]): boolean;
+    /**
+     * Current usage as a fraction of maxTokens (0–1+).
+     */
+    usageFraction(messages: ONIModelMessage[]): number;
+    /**
+     * Two-stage compaction:
+     * 1. Clear old tool results (less lossy)
+     * 2. Full summarization if still over threshold
+     *
+     * Returns the compacted message array.
+     */
+    compact(messages: ONIModelMessage[]): Promise<ONIModelMessage[]>;
+    /**
+     * Remove tool-role messages from the older portion of the conversation,
+     * keeping the most recent `keepRecent` messages intact.
+     */
+    private clearOldToolResults;
+    /**
+     * Build a history text from all messages and ask the summary model
+     * to produce a compact summary wrapped in <summary> tags.
+     */
+    private summarize;
+    /**
+     * Fallback when the summary model fails — return a minimal truncation notice.
+     */
+    private fallbackTruncation;
+    /**
+     * Get the character length of a message's content.
+     */
+    private contentLength;
+}
+//# sourceMappingURL=context-compactor.d.ts.map

package/dist/harness/context-compactor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-compactor.d.ts","sourceRoot":"","sources":["../../src/harness/context-compactor.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAIpE,MAAM,WAAW,eAAe;IAC9B,wEAAwE;IACxE,YAAY,EAAE,QAAQ,CAAC;IAEvB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAID,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAW;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAS;gBAElC,MAAM,EAAE,eAAe;IAUnC;;;OAGG;IACH,cAAc,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,MAAM;IAQnD;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,OAAO;IAInD;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,MAAM;IAKlD;;;;;;OAMG;IACG,OAAO,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAsBtE;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAiB3B;;;OAGG;YACW,SAAS;IAmDvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAe1B;;OAEG;IACH,OAAO,CAAC,aAAa;CAYtB"}

package/dist/harness/context-compactor.js

@@ -0,0 +1,162 @@
+// ============================================================
+// @oni.bot/core/harness — ContextCompactor
+// Monitors token usage and compacts conversation history
+// before context quality degrades (triggers at 68% by default).
+// ============================================================
+// ─── ContextCompactor ────────────────────────────────────────────────────────
+export class ContextCompactor {
+    summaryModel;
+    threshold;
+    maxTokens;
+    charsPerToken;
+    compactInstructions;
+    constructor(config) {
+        this.summaryModel = config.summaryModel;
+        this.threshold = config.threshold ?? 0.68;
+        this.maxTokens = config.maxTokens ?? 200_000;
+        this.charsPerToken = config.charsPerToken ?? 4;
+        this.compactInstructions = config.compactInstructions;
+    }
+    // ── Public API ──────────────────────────────────────────────────────────
+    /**
+     * Estimate token count from total character length of all messages.
+     * Uses ceiling to avoid underestimation.
+     */
+    estimateTokens(messages) {
+        let totalChars = 0;
+        for (const msg of messages) {
+            totalChars += this.contentLength(msg);
+        }
+        return Math.ceil(totalChars / this.charsPerToken);
+    }
+    /**
+     * Returns true when estimated usage exceeds the compaction threshold.
+     */
+    shouldCompact(messages) {
+        return this.usageFraction(messages) >= this.threshold;
+    }
+    /**
+     * Current usage as a fraction of maxTokens (0–1+).
+     */
+    usageFraction(messages) {
+        if (messages.length === 0)
+            return 0;
+        return this.estimateTokens(messages) / this.maxTokens;
+    }
+    /**
+     * Two-stage compaction:
+     * 1. Clear old tool results (less lossy)
+     * 2. Full summarization if still over threshold
+     *
+     * Returns the compacted message array.
+     */
+    async compact(messages) {
+        if (!this.shouldCompact(messages)) {
+            return messages;
+        }
+        // Stage 1: clear old tool results
+        const cleaned = this.clearOldToolResults(messages);
+        if (!this.shouldCompact(cleaned)) {
+            return cleaned;
+        }
+        // Stage 2: full summarization
+        try {
+            return await this.summarize(cleaned);
+        }
+        catch {
+            // Fallback: simple truncation message
+            return this.fallbackTruncation();
+        }
+    }
+    // ── Private ─────────────────────────────────────────────────────────────
+    /**
+     * Remove tool-role messages from the older portion of the conversation,
+     * keeping the most recent `keepRecent` messages intact.
+     */
+    clearOldToolResults(messages, keepRecent = 10) {
+        if (messages.length <= keepRecent) {
+            return messages;
+        }
+        const cutoff = messages.length - keepRecent;
+        const olderPortion = messages.slice(0, cutoff);
+        const recentPortion = messages.slice(cutoff);
+        const filteredOlder = olderPortion.filter((m) => m.role !== "tool");
+        return [...filteredOlder, ...recentPortion];
+    }
+    /**
+     * Build a history text from all messages and ask the summary model
+     * to produce a compact summary wrapped in <summary> tags.
+     */
+    async summarize(messages) {
+        const historyText = messages
+            .map((m) => {
+            const text = typeof m.content === "string"
+                ? m.content
+                : m.content
+                    .map((p) => p.text ?? "[image]")
+                    .join(" ");
+            return `[${m.role}]: ${text}`;
+        })
+            .join("\n");
+        const instructions = this.compactInstructions
+            ? `\n\nAdditional instructions: ${this.compactInstructions}`
+            : "";
+        const systemMessage = {
+            role: "user",
+            content: `Summarize the following conversation history into a concise summary. ` +
+                `Preserve key decisions, code context, file paths, and task progress. ` +
+                `Wrap your summary in <summary></summary> tags.${instructions}\n\n` +
+                `--- CONVERSATION HISTORY ---\n${historyText}`,
+        };
+        const response = await this.summaryModel.chat({
+            messages: [systemMessage],
+            maxTokens: 2048,
+        });
+        const summaryMatch = /<summary>([\s\S]*?)<\/summary>/.exec(response.content);
+        const summaryText = summaryMatch
+            ? summaryMatch[1].trim()
+            : response.content.trim();
+        return [
+            {
+                role: "user",
+                content: `[Previous conversation was compacted. Summary of prior context]\n\n${summaryText}`,
+            },
+            {
+                role: "assistant",
+                content: "Context loaded.",
+            },
+        ];
+    }
+    /**
+     * Fallback when the summary model fails — return a minimal truncation notice.
+     */
+    fallbackTruncation() {
+        return [
+            {
+                role: "user",
+                content: "[The previous conversation was truncated due to context limits. " +
+                    "Please continue from where we left off.]",
+            },
+            {
+                role: "assistant",
+                content: "Context loaded.",
+            },
+        ];
+    }
+    /**
+     * Get the character length of a message's content.
+     */
+    contentLength(msg) {
+        if (typeof msg.content === "string") {
+            return msg.content.length;
+        }
+        let len = 0;
+        for (const part of msg.content) {
+            if (part.text) {
+                len += part.text.length;
+            }
+        }
+        return len;
+    }
+}
+//# sourceMappingURL=context-compactor.js.map

package/dist/harness/context-compactor.js.map

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

package/dist/harness/harness.d.ts

@@ -0,0 +1,41 @@
+import { TodoModule } from "./todo-module.js";
+import { HooksEngine } from "./hooks-engine.js";
+import type { HooksConfig } from "./hooks-engine.js";
+import { SkillLoader } from "./skill-loader.js";
+import type { SkillDefinition } from "./skill-loader.js";
+import type { HarnessConfig, AgentNodeConfig, LoopMessage } from "./types.js";
+import type { ToolDefinition } from "../tools/types.js";
+export interface SwarmAgentCompat {
+    name: string;
+    description: string;
+    capabilities: string[];
+    handler: (state: Record<string, unknown>) => Promise<Record<string, unknown>>;
+}
+export declare class ONIHarness {
+    private readonly config;
+    private readonly todoModule;
+    private readonly hooksEngine;
+    private readonly compactor;
+    private readonly safetyGate;
+    private readonly skillLoader;
+    private constructor();
+    static create(config: HarnessConfig): ONIHarness;
+    private buildLoopConfig;
+    run(prompt: string, agentConfig: AgentNodeConfig | string): AsyncGenerator<LoopMessage>;
+    runToResult(prompt: string, agentConfig: AgentNodeConfig | string): Promise<string>;
+    asNode<S extends Record<string, unknown> & {
+        task?: string;
+        context?: string;
+        agentResults?: Record<string, string>;
+    }>(agentConfig: AgentNodeConfig): (state: S) => Promise<Partial<S>>;
+    asSwarmAgent(name: string, soul: string, tools?: ToolDefinition[], opts?: {
+        description?: string;
+        capabilities?: string[];
+    }): SwarmAgentCompat;
+    getTodoModule(): TodoModule;
+    getHooksEngine(): HooksEngine;
+    getSkillLoader(): SkillLoader;
+    registerSkill(skill: SkillDefinition): void;
+    addHooks(config: HooksConfig): void;
+}
+//# sourceMappingURL=harness.d.ts.map

package/dist/harness/harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../src/harness/harness.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EAEf,WAAW,EACZ,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAIxD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC/E;AAID,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAC7C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAE1C,OAAO;IA6CP,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,UAAU;IAMhD,OAAO,CAAC,eAAe;IAkChB,GAAG,CACR,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,eAAe,GAAG,MAAM,GACpC,cAAc,CAAC,WAAW,CAAC;IAYxB,WAAW,CACf,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,eAAe,GAAG,MAAM,GACpC,OAAO,CAAC,MAAM,CAAC;IAclB,MAAM,CACJ,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QAClC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACvC,EACD,WAAW,EAAE,eAAe,GAAG,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAOlE,YAAY,CACV,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,cAAc,EAAE,EACxB,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GACvD,gBAAgB;IAcnB,aAAa,IAAI,UAAU;IAI3B,cAAc,IAAI,WAAW;IAI7B,cAAc,IAAI,WAAW;IAM7B,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAI3C,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;CAGpC"}