agim-cli 1.2.45 → 1.2.49

package/dist/core/commands/router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../../src/core/commands/router.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAMhD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,MAAM,CAAC,CAsEjB"}
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../../src/core/commands/router.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAOhD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,MAAM,CAAC,CA8EjB"}

package/dist/core/commands/router.js

@@ -3,6 +3,7 @@ import { classifyIntent } from '../intent.js';
 import { circuitBreaker } from '../circuit-breaker.js';
 import { registry } from '../registry.js';
 import { sessionManager } from '../session.js';
+import { handleRouterCompareCommand } from './router-compare.js';
 export async function handleRouterCommand(args, ctx) {
     const parts = args.trim().split(/\s+/).filter(Boolean);
     const subcommand = parts[0] || 'status';
@@ -64,8 +65,15 @@ export async function handleRouterCommand(args, ctx) {
             circuitBreaker.reset();
             return '✅ Cleared all circuit breakers.';
         }
+        case 'compare':
+        case 'cmp':
+        case 'ab':
+            // Stage 5 — A/B evaluator. Delegated to router-compare.ts so the
+            // dispatch surface stays small and the slash-command body lives
+            // next to runRouterCompare / formatCompareResult.
+            return handleRouterCompareCommand(rest, ctx);
         default:
-            return `用法: /router [status|policy|explain <msg>|reset [<agent>]]`;
+            return `用法: /router [status|policy|explain <msg>|reset [<agent>]|compare <a> <b> <prompt>]`;
     }
 }
 //# sourceMappingURL=router.js.map

package/dist/core/commands/router.js.map

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

package/dist/core/commands/skill.d.ts

@@ -0,0 +1,3 @@
+import type { RouteContext } from '../router.js';
+export declare function handleSkillCommand(args: string, ctx: RouteContext): Promise<string>;
+//# sourceMappingURL=skill.d.ts.map

package/dist/core/commands/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../../src/core/commands/skill.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AA2BhD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CA0CzF"}

package/dist/core/commands/skill.js

@@ -0,0 +1,91 @@
+// /skill command — operator-facing reader for the agim skills loader
+// (Stage 3 / P0 #3).
+//
+// Subcommands:
+//   /skill                  same as /skill list
+//   /skill help
+//   /skill list             one row per skill with status flag
+//   /skill show <name>      full SKILL.md body (tier-2 manual fetch)
+//   /skill refresh          force re-scan (after dropping a new SKILL.md)
+//   /skill check            same as list but include requires status detail
+import { listSkills, readSkillBody, invalidateSkillsCache, } from '../skills/loader.js';
+const HELP = [
+    '🧠 **/skill** — agim skills loader（agent 跨后端共享的 SKILL.md）',
+    '',
+    '用法：',
+    '  `/skill`                列出所有已加载 skill (= /skill list)',
+    '  `/skill list`           同上',
+    '  `/skill show <name>`    打印某个 skill 的完整 SKILL.md',
+    '  `/skill refresh`        强制重新扫描磁盘',
+    '  `/skill check`          列出详细的 requires 状态（缺什么）',
+    '',
+    '在哪里放 SKILL.md：',
+    '  ~/.agim/skills/<name>/SKILL.md   （operator 自定义，优先）',
+    '  <agim-dist>/skills/builtin/...   （agim 内置，被同名 workspace 覆盖）',
+    '',
+    '三层加载：',
+    '  · tier 1: 名字 + 描述，每轮注入 prompt（自动）',
+    '  · tier 2: 全文 body，agent 用 mcp__imhub__read_skill(name) 取',
+    '  · tier 3: scripts/ references/ assets/ 子目录，agent 走文件读取工具',
+].join('\n');
+export async function handleSkillCommand(args, ctx) {
+    void ctx; // unused; skills are global
+    const trimmed = args.trim();
+    const parts = trimmed.split(/\s+/).filter(Boolean);
+    const sub = (parts[0] || '').toLowerCase();
+    const rest = trimmed.slice(parts[0]?.length ?? 0).trim();
+    if (!sub || sub === 'list' || sub === 'ls') {
+        return renderList(false);
+    }
+    switch (sub) {
+        case 'help':
+        case '?':
+            return HELP;
+        case 'check':
+        case 'status':
+            return renderList(true);
+        case 'show':
+        case 'cat':
+        case 'view': {
+            const name = rest.trim();
+            if (!name)
+                return '用法：`/skill show <name>`（用 `/skill list` 查名字）';
+            const body = readSkillBody(name);
+            if (body === null)
+                return `❌ 未找到 skill: ${name}`;
+            // IM 大段 markdown 由 viewer 自动路由；这里直接返回就行。
+            return body;
+        }
+        case 'refresh':
+        case 'reload':
+        case 'rescan': {
+            invalidateSkillsCache();
+            const after = listSkills();
+            return `✅ 已重新扫描。当前 ${after.length} 个 skill。`;
+        }
+        default:
+            return `未知子命令：\`/skill ${sub}\`。用 \`/skill help\` 查看用法。`;
+    }
+}
+function renderList(detail) {
+    const skills = listSkills();
+    if (skills.length === 0) {
+        return '（当前没有 skill。把 SKILL.md 放到 `~/.agim/skills/<name>/SKILL.md` 后用 `/skill refresh` 重新扫描。）';
+    }
+    const lines = ['🧠 **agim skills**'];
+    for (const s of skills.slice().sort((a, b) => a.name.localeCompare(b.name))) {
+        const flag = s.available ? (s.always ? '⭐' : '✅') : '⏸';
+        const src = s.source === 'workspace' ? 'ws' : 'builtin';
+        const reason = !s.available && s.unavailableReason ? ` — ${s.unavailableReason}` : '';
+        lines.push(`${flag} \`${s.name}\` [${src}] — ${s.description}${reason}`);
+        if (detail) {
+            if (s.requiresBins.length > 0)
+                lines.push(`     requires bins: ${s.requiresBins.join(', ')}`);
+            if (s.requiresEnv.length > 0)
+                lines.push(`     requires env:  ${s.requiresEnv.join(', ')}`);
+            lines.push(`     dir: ${s.dir}`);
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=skill.js.map

package/dist/core/commands/skill.js.map

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

package/dist/core/config-schema.d.ts

@@ -46,6 +46,34 @@ export declare const configSchema: z.ZodObject<{
             burst: z.ZodNumber;
         }, z.core.$strip>>;
     }, z.core.$strip>>>;
+    llmBackends: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        provider: z.ZodEnum<{
+            "openai-compat": "openai-compat";
+            anthropic: "anthropic";
+        }>;
+        model: z.ZodString;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        label: z.ZodOptional<z.ZodString>;
+        extraHeaders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        maxTokens: z.ZodOptional<z.ZodNumber>;
+        retryOnTransient: z.ZodOptional<z.ZodNumber>;
+        enabled: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    llmRoles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    mcpServers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        command: z.ZodOptional<z.ZodString>;
+        args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        cwd: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        toolTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        enabledTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        enabled: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
 }, z.core.$loose>;
 export type ValidatedConfig = z.infer<typeof configSchema>;
 export declare function validateConfig(data: unknown): {

package/dist/core/config-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-schema.d.ts","sourceRoot":"","sources":["../../src/core/config-schema.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAiCvB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuBT,CAAA;AAEhB,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AAE1D,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAC1C;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAsBnH"}
+{"version":3,"file":"config-schema.d.ts","sourceRoot":"","sources":["../../src/core/config-schema.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAuJvB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkCT,CAAA;AAEhB,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AAE1D,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAC1C;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAsBnH"}

package/dist/core/config-schema.js

@@ -26,6 +26,119 @@ const discordSchema = z.object({
     allowedGuilds: z.array(z.string()).optional(),
     allowedChannels: z.array(z.string()).optional(),
 });
+/**
+ * External MCP (Model Context Protocol) server to attach (Stage 2 of
+ * the D+ plan, sub-PR #2). Discovered tools are exposed to the native
+ * agent loop via the LLM registry's MCP layer; they're independent of
+ * llmBackends (it's perfectly fine to configure mcpServers without any
+ * llmBackends, and the CLI agents can also use them through their own
+ * MCP configs).
+ *
+ * Transport selection:
+ *   - `command` present     -> stdio (spawn subprocess)
+ *   - `url` ends with /sse  -> SSE
+ *   - `url` otherwise       -> streamable HTTP (the modern transport)
+ *
+ * Tools discovered at startup are passed to the native agent loop as
+ * `ToolDef[]`; tool names get the `mcp_{server}_` prefix to dodge
+ * collisions when multiple servers expose the same tool name. See
+ * src/core/llm/mcp-client.ts.
+ */
+const mcpServerSchema = z.object({
+    /** Server identifier, unique within mcpServers[]. Used as the
+     *  tool-name prefix; must be alphanumeric (with . _ - allowed). */
+    name: z.string().min(1).regex(safeNamePattern, 'MCP server name must be alphanumeric (with . _ - allowed)'),
+    /** stdio: executable to spawn. Mutually exclusive with `url`. */
+    command: z.string().min(1).optional(),
+    /** stdio: positional args. Ignored when `command` is absent. */
+    args: z.array(z.string()).optional(),
+    /** stdio: extra env merged onto the child process env. */
+    env: z.record(z.string(), z.string()).optional(),
+    /** stdio: cwd for the child. Defaults to agim's cwd. */
+    cwd: z.string().optional(),
+    /** http/sse: target URL. Mutually exclusive with `command`.
+     *  URLs ending with /sse use the SSE transport; everything else uses
+     *  streamable HTTP. */
+    url: z.string().url().optional(),
+    /** http/sse: extra headers (Authorization, custom auth tokens, …). */
+    headers: z.record(z.string(), z.string()).optional(),
+    /** Per-tool-call hard timeout (ms). Default 30s. */
+    toolTimeoutMs: z.number().int().positive().optional(),
+    /** Filter the tool set the server advertises. ['*'] = all tools (the
+     *  default). Otherwise only tools whose original OR namespaced name
+     *  is in the list are registered. */
+    enabledTools: z.array(z.string()).optional(),
+    /** Soft kill-switch — set false to keep the row around without
+     *  attempting to connect at startup. */
+    enabled: z.boolean().optional(),
+}).superRefine((cfg, ctx) => {
+    // Either `command` or `url` must be set; never both.
+    const hasCmd = typeof cfg.command === 'string' && cfg.command.length > 0;
+    const hasUrl = typeof cfg.url === 'string' && cfg.url.length > 0;
+    if (hasCmd === hasUrl) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'mcpServer entries must set exactly one of `command` (stdio) or `url` (http/sse)',
+        });
+    }
+});
+/**
+ * Native LLM backend (Stage 1 of the D+ plan, 2026-05-23).
+ *
+ * Each entry describes one OpenAI/Anthropic-compatible API endpoint
+ * agim can talk to *directly* (without spawning a CLI agent). Used by
+ * internal introspection callers (memory-distill / memory-consolidate /
+ * intent-llm now; heartbeat evaluator + native chat agent later).
+ *
+ * The API key is NOT stored here — secrets live in
+ * `~/.agim/llm-secrets.json` (or the AGIM_LLM_SECRET_<NAME> env). See
+ * src/core/llm/secrets.ts.
+ *
+ * Stage 1 ships only `provider: 'openai-compat'`. Anthropic native +
+ * Ollama land in Stage 2.
+ */
+const llmBackendSchema = z.object({
+    /** Backend identifier referenced by llmRoles. Must be unique within
+     *  the array; the registry de-duplicates with a `last wins` rule and
+     *  logs a warning on collision. Match safeNamePattern so it's safe to
+     *  shove into the AGIM_LLM_SECRET_<NAME> env var suffix. */
+    name: z.string().min(1).regex(safeNamePattern, 'LLM backend name must be alphanumeric (with . _ - allowed)'),
+    /** Transport / dialect. Supported: openai-compat (OpenAI / DeepSeek /
+     *  Moonshot / Qwen / Ollama / vLLM / OpenRouter / ...), anthropic
+     *  (Anthropic Messages API). */
+    provider: z.enum(['openai-compat', 'anthropic']),
+    /** Default model id. Caller may override per call via ChatOptions.model. */
+    model: z.string().min(1),
+    /** Full base URL up to (but not including) `/chat/completions`.
+     *  Optional — when omitted, the OpenAI-compat provider defaults to
+     *  https://api.openai.com/v1. */
+    baseUrl: z.string().url().optional(),
+    /** Display label for the cost dashboard / logs. Lets DeepSeek and Kimi
+     *  show up under their own brand instead of all under "openai-compat". */
+    label: z.string().optional(),
+    /** Extra HTTP headers — OpenRouter (`HTTP-Referer` / `X-Title`), Azure
+     *  (`api-key`), private gateways. Authorization is set by the provider
+     *  and is NOT overridable here on purpose. */
+    extraHeaders: z.record(z.string(), z.string()).optional(),
+    /** Default temperature (provider default 0.3 — we want deterministic
+     *  JSON for introspection callers, not creativity). */
+    temperature: z.number().min(0).max(2).optional(),
+    /** Default max output tokens (provider default 1024). */
+    maxTokens: z.number().int().positive().optional(),
+    /** Number of retries on transient (429 / 5xx). Provider default 1. */
+    retryOnTransient: z.number().int().min(0).max(5).optional(),
+    /** Soft kill-switch — set false to keep the row around but make
+     *  registry.getProvider() pretend it doesn't exist. */
+    enabled: z.boolean().optional(),
+});
+/**
+ * Role → backend-name mapping. Roles are operational concepts agim
+ * internal callers ask for ("give me a cheap JSON-grade backend" /
+ * "give me an evaluator-grade backend"). Multiple roles may resolve to
+ * the same backend. Stage 1 recognises: cheap, evaluator, native-chat.
+ * Unknown keys are accepted for forward compatibility.
+ */
+const llmRolesSchema = z.record(z.string(), z.string());
 export const configSchema = z.object({
     messengers: z.array(z.string()).default([]),
     agents: z.array(z.string()).default([]),
@@ -49,6 +162,17 @@ export const configSchema = z.object({
             burst: z.number().int().positive(),
         }).optional(),
     })).optional(),
+    /** D+ Stage 1: native LLM backends (OpenAI-compat now, Anthropic /
+     *  Ollama in Stage 2). Optional — when absent the registry returns
+     *  no providers and every caller falls back to its CLI agent path. */
+    llmBackends: z.array(llmBackendSchema).optional(),
+    /** D+ Stage 1: role → backend-name map. See llmRolesSchema. */
+    llmRoles: llmRolesSchema.optional(),
+    /** D+ Stage 2 sub-PR #2: external MCP servers to attach. Their tools
+     *  are exposed to the native agent loop. Optional — when absent, only
+     *  the built-in agim MCP server's tools (mcp__imhub__*) are available
+     *  to the native agent. */
+    mcpServers: z.array(mcpServerSchema).optional(),
 }).passthrough();
 export function validateConfig(data) {
     const result = configSchema.safeParse(data);

package/dist/core/config-schema.js.map

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

package/dist/core/goals.d.ts

@@ -0,0 +1,81 @@
+/** Hard caps. Goals are user-typed prose; tight limits keep prompt
+ *  injection from blowing the context window on a single thread. */
+export declare const MAX_TITLE_CHARS = 200;
+export declare const MAX_BODY_CHARS = 4000;
+export declare const MAX_PROGRESS_NOTE_CHARS = 500;
+export declare const MAX_PROGRESS_NOTES_INJECTED = 5;
+/** Goal lifecycle states.
+ *  - active: counted as the thread's current goal; injected into prompts
+ *  - paused: kept around but NOT injected (operator wants a break)
+ *  - completed / cancelled: historical only */
+export type GoalStatus = 'active' | 'paused' | 'completed' | 'cancelled';
+export interface ProgressNote {
+    ts: string;
+    by: string;
+    text: string;
+}
+export interface GoalRow {
+    id: number;
+    platform: string;
+    channelId: string;
+    threadId: string;
+    userId: string;
+    title: string;
+    body: string;
+    status: GoalStatus;
+    /** Newest-last array (push on progress; render reversed for "most recent first"). */
+    progressLog: ProgressNote[];
+    createdAt: string;
+    updatedAt: string;
+    /** ISO timestamp of completion / cancellation, when applicable. */
+    closedAt: string | null;
+}
+/**
+ * Set (or replace) the ACTIVE goal for a thread. Idempotent semantics:
+ * if there's already an active goal, it's auto-paused first (kept in
+ * the table) and a fresh row replaces it. This avoids accidental
+ * silent drops of partially-tracked work — the operator can /goal
+ * list to find paused predecessors and /goal resume <id> if they
+ * changed their mind.
+ */
+export declare function setActiveGoal(input: {
+    platform: string;
+    channelId: string;
+    threadId: string;
+    userId: string;
+    title: string;
+    body?: string;
+}): GoalRow | null;
+/** Append a progress note to a goal. Caller picks `by` (typically
+ *  'user' for /goal progress, 'agent' for future MCP tool call,
+ *  'system' for status transitions). */
+export declare function appendProgress(goalId: number, by: ProgressNote['by'], text: string): boolean;
+export declare function updateStatus(goalId: number, status: GoalStatus): boolean;
+/** Resume a paused goal — also auto-pauses any currently-active goal
+ *  in the same thread so there's never more than one active. */
+export declare function resumeGoal(goalId: number): boolean;
+export declare function getGoalById(id: number): GoalRow | null;
+/** The single active goal for a thread (or null if none). */
+export declare function getActiveGoal(platform: string, channelId: string, threadId: string): GoalRow | null;
+/** All goals (any status) for a thread, newest first. Used by /goal list. */
+export declare function listGoalsForThread(platform: string, channelId: string, threadId: string, limit?: number): GoalRow[];
+/** Admin / debug — every active goal across the install. */
+export declare function listAllActiveGoals(): GoalRow[];
+/**
+ * Build the per-turn prompt-prefix snippet for the active goal. Bounded
+ * to ~MAX_PROGRESS_NOTES_INJECTED recent notes + truncated body so a
+ * verbose goal doesn't dominate the prompt budget. Empty string when no
+ * active goal — router treats falsy snippets as "skip this block".
+ *
+ * The snippet is OVER THE WIRE only — it's prepended to the prompt the
+ * agent sees but NOT stored in session history, so it doesn't bloat the
+ * persisted conversation.
+ */
+export declare function buildGoalSnippet(platform: string, channelId: string, threadId: string): string;
+/** For /goal show — render an operator-facing summary including ALL
+ *  retained progress notes (capped at MAX_PROGRESS_NOTES_LISTED so the
+ *  IM bubble doesn't explode). */
+export declare function formatGoalShow(goal: GoalRow): string;
+/** Test-only. Drops everything; safe to call repeatedly in beforeEach. */
+export declare function _truncateForTests(): void;
+//# sourceMappingURL=goals.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"goals.d.ts","sourceRoot":"","sources":["../../src/core/goals.ts"],"names":[],"mappings":"AA8BA;oEACoE;AACpE,eAAO,MAAM,eAAe,MAAM,CAAA;AAClC,eAAO,MAAM,cAAc,OAAQ,CAAA;AACnC,eAAO,MAAM,uBAAuB,MAAM,CAAA;AAC1C,eAAO,MAAM,2BAA2B,IAAI,CAAA;AAK5C;;;+CAG+C;AAC/C,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAA;AAExE,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,UAAU,CAAA;IAClB,qFAAqF;IACrF,WAAW,EAAE,YAAY,EAAE,CAAA;IAC3B,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,mEAAmE;IACnE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AA4ED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE;IACnC,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,GAAG,OAAO,GAAG,IAAI,CA6BjB;AAED;;wCAEwC;AACxC,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAgC5F;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAiBxE;AAED;gEACgE;AAChE,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAwBlD;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAUtD;AAED,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAcnG;AAED,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,EAAE,CAc/G;AAED,4DAA4D;AAC5D,wBAAgB,kBAAkB,IAAI,OAAO,EAAE,CAY9C;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAuB9F;AAED;;kCAEkC;AAClC,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CA4BpD;AAED,0EAA0E;AAC1E,wBAAgB,iBAAiB,IAAI,IAAI,CAIxC"}