@zenalexa/unicli 0.213.1 → 0.213.3

package/dist/mcp/tools.js

@@ -0,0 +1,237 @@
+/**
+ * MCP tool-definition builders.
+ *
+ * Three build modes:
+ *   1. `buildDefaultTools()`  — 4 meta-tools (~200 tokens handshake)
+ *   2. `buildExpandedTools()` — one tool per adapter command (~160K tokens)
+ *   3. `buildDeferredTools()` — stubs for ToolSearch/deferred clients (~8K)
+ *
+ * Extracted from `server.ts` to keep that file's responsibility limited to
+ * JSON-RPC transport wiring.
+ */
+import { getAllAdapters } from "../registry.js";
+import { buildInputSchema, buildOutputSchema, buildToolName, truncateDescription, } from "./schema.js";
+/**
+ * Reverse-lookup registry for expanded-mode tool calls. Maps the normalized
+ * tool name to the resolved adapter + original command name.
+ */
+export const expandedRegistry = new Map();
+export const DEFAULT_TOOL_NAMES = new Set([
+    "unicli_run",
+    "unicli_list",
+    "unicli_search",
+    "unicli_explore",
+    "unicli_discover",
+]);
+export function buildDefaultTools() {
+    return [
+        {
+            name: "unicli_run",
+            description: "Execute any Uni-CLI command. Returns JSON results.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    site: {
+                        type: "string",
+                        description: "Site name (e.g. hackernews, github, bilibili)",
+                    },
+                    command: {
+                        type: "string",
+                        description: "Command to run (e.g. top, search, hot)",
+                    },
+                    args: {
+                        type: "object",
+                        description: 'Key-value arguments (e.g. {"query": "ai", "limit": 10})',
+                        additionalProperties: true,
+                    },
+                },
+                required: ["site", "command"],
+            },
+            _meta: {
+                "anthropic/searchHint": "Execute CLI commands on 200+ websites and desktop apps. Run adapters by site and command name.",
+            },
+            annotations: {
+                readOnlyHint: false,
+                destructiveHint: false,
+                idempotentHint: false,
+                openWorldHint: true,
+            },
+        },
+        {
+            name: "unicli_list",
+            description: "List available commands. Filter by site or adapter type.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    site: {
+                        type: "string",
+                        description: "Filter by site name (partial match)",
+                    },
+                    type: {
+                        type: "string",
+                        description: "Filter by adapter type",
+                        enum: ["web-api", "desktop", "browser", "bridge", "service"],
+                    },
+                },
+            },
+            _meta: {
+                "anthropic/searchHint": "Browse available Uni-CLI sites and commands. Filter by site name or adapter type.",
+                "anthropic/alwaysLoad": true,
+            },
+            annotations: {
+                readOnlyHint: true,
+                idempotentHint: true,
+                openWorldHint: false,
+            },
+        },
+        {
+            name: "unicli_search",
+            description: "Search 200+ sites and 956 commands by intent. Bilingual (EN/ZH). Returns top matches with usage examples.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    query: {
+                        type: "string",
+                        description: "Natural language intent (e.g. 'download video', '推特热门', 'stock price')",
+                    },
+                    limit: {
+                        type: "integer",
+                        description: "Max results (default 5)",
+                        default: 5,
+                    },
+                },
+                required: ["query"],
+            },
+            _meta: {
+                "anthropic/searchHint": "Find CLI commands by intent. Semantic search across websites, desktop apps, macOS. Bilingual Chinese/English.",
+                "anthropic/alwaysLoad": true,
+            },
+            annotations: {
+                readOnlyHint: true,
+                idempotentHint: true,
+                openWorldHint: false,
+            },
+        },
+        {
+            name: "unicli_explore",
+            description: "Auto-discover API endpoints for any URL. Navigates the page, captures network requests, generates YAML adapters.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    url: { type: "string", description: "Website URL to explore" },
+                    goal: {
+                        type: "string",
+                        description: "Capability to find (e.g. 'search', 'hot', 'feed')",
+                    },
+                },
+                required: ["url"],
+            },
+            _meta: {
+                "anthropic/searchHint": "Auto-discover API endpoints for any website URL. Generate YAML adapters for new sites.",
+            },
+            annotations: {
+                readOnlyHint: false,
+                destructiveHint: false,
+                idempotentHint: false,
+                openWorldHint: true,
+            },
+        },
+    ];
+}
+/**
+ * Build the expanded tool set: 4 default meta-tools + one full tool per
+ * adapter command. Clients see the complete Uni-CLI surface area.
+ *
+ * Token cost: ~160K for 956 commands. Use only when the client can handle it.
+ */
+export function buildExpandedTools() {
+    const tools = [];
+    tools.push(...buildDefaultTools());
+    expandedRegistry.clear();
+    const seen = new Set(DEFAULT_TOOL_NAMES);
+    for (const adapter of getAllAdapters()) {
+        for (const [cmdName, cmd] of Object.entries(adapter.commands)) {
+            const rawDesc = cmd.description?.trim() ||
+                adapter.description?.trim() ||
+                `${cmdName} for ${adapter.name}`;
+            const toolName = buildToolName(adapter.name, cmdName);
+            if (seen.has(toolName)) {
+                process.stderr.write(`unicli MCP: tool name collision: ${toolName} — shadowing ${adapter.name}/${cmdName}\n`);
+                continue;
+            }
+            seen.add(toolName);
+            expandedRegistry.set(toolName, { adapter, cmdName, cmd });
+            tools.push({
+                name: toolName,
+                description: truncateDescription(`[${adapter.name}] ${rawDesc}`),
+                inputSchema: buildInputSchema(cmd),
+                outputSchema: buildOutputSchema(cmd),
+                _meta: {
+                    "anthropic/searchHint": `${adapter.name}: ${rawDesc}`,
+                },
+                annotations: {
+                    readOnlyHint: true,
+                    idempotentHint: true,
+                    openWorldHint: true,
+                },
+            });
+        }
+    }
+    return tools;
+}
+/**
+ * Build deferred tool set: 4 default meta-tools with full schemas, plus
+ * lightweight stubs for all adapter commands (name + searchHint only,
+ * minimal inputSchema). Clients like Claude Code's ToolSearch can discover
+ * tools by searchHint and then call them — the handler resolves the full
+ * command at call time via the expandedRegistry.
+ *
+ * Token cost: ~8K (vs ~160K for expanded). 95% reduction.
+ */
+export function buildDeferredTools() {
+    const tools = [];
+    tools.push(...buildDefaultTools());
+    expandedRegistry.clear();
+    const seen = new Set(DEFAULT_TOOL_NAMES);
+    for (const adapter of getAllAdapters()) {
+        for (const [cmdName, cmd] of Object.entries(adapter.commands)) {
+            const rawDesc = cmd.description?.trim() ||
+                adapter.description?.trim() ||
+                `${cmdName} for ${adapter.name}`;
+            const toolName = buildToolName(adapter.name, cmdName);
+            if (seen.has(toolName)) {
+                process.stderr.write(`unicli MCP: tool name collision: ${toolName} — shadowing ${adapter.name}/${cmdName}\n`);
+                continue;
+            }
+            seen.add(toolName);
+            // Register in the lookup table for runtime dispatch
+            expandedRegistry.set(toolName, { adapter, cmdName, cmd });
+            // Lightweight stub: name + searchHint + minimal schema.
+            // Full inputSchema is resolved at call time via expandedRegistry.
+            tools.push({
+                name: toolName,
+                description: truncateDescription(`[${adapter.name}] ${rawDesc}`),
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        _args: {
+                            type: "object",
+                            description: "Command arguments (pass key-value pairs)",
+                            additionalProperties: true,
+                        },
+                    },
+                },
+                _meta: {
+                    "anthropic/searchHint": `${adapter.name}: ${rawDesc}`,
+                },
+                annotations: {
+                    readOnlyHint: true,
+                    idempotentHint: true,
+                    openWorldHint: true,
+                },
+            });
+        }
+    }
+    return tools;
+}
+//# sourceMappingURL=tools.js.map

package/dist/mcp/tools.js.map

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

package/dist/output/envelope.d.ts

@@ -23,6 +23,31 @@ export interface AgentContent {
     data?: string;
     uri?: string;
 }
+/**
+ * HATEOAS action hint — a templated command the agent can run next, with
+ * typed parameter metadata (value / default / enum / description). Lets
+ * the response itself drive navigation without the agent having to
+ * reconstruct command shape from memory. Pattern from joelclaw.com
+ * "CLI Design for AI Agents" (2026-02).
+ */
+export interface AgentNextActionParam {
+    /** Concrete value already filled in from the current response context. */
+    value?: string | number | boolean;
+    /** Default applied when the agent omits the flag entirely. */
+    default?: string | number | boolean;
+    /** Valid closed-set choices the agent must pick from. */
+    enum?: Array<string | number>;
+    /** What this parameter means. */
+    description?: string;
+}
+export interface AgentNextAction {
+    /** POSIX-style template (e.g. `unicli repair <site> <cmd>`) or literal command. */
+    command: string;
+    /** One-line description of when/why to run this. */
+    description: string;
+    /** Presence of `params` marks the `command` as a template to be filled. */
+    params?: Record<string, AgentNextActionParam>;
+}
 /** Timing, pagination, and provenance metadata on every envelope. */
 export interface AgentMeta {
     duration_ms: number;
@@ -86,6 +111,8 @@ export interface AgentContext {
     pagination?: AgentMeta["pagination"];
     /** Set on the error path in format() — makeEnvelope ignores this field. */
     error?: AgentError;
+    /** Optional HATEOAS hints attached to the resulting envelope. */
+    next_actions?: AgentNextAction[];
 }
 /** Success arm of the discriminated union. */
 export interface AgentEnvelopeOk {
@@ -96,6 +123,7 @@ export interface AgentEnvelopeOk {
     data: unknown[] | Record<string, unknown>;
     error: null;
     content?: AgentContent[];
+    next_actions?: AgentNextAction[];
 }
 /** Error arm of the discriminated union. */
 export interface AgentEnvelopeErr {
@@ -106,6 +134,7 @@ export interface AgentEnvelopeErr {
     data: null;
     error: AgentError;
     content?: AgentContent[];
+    next_actions?: AgentNextAction[];
 }
 export type AgentEnvelope = AgentEnvelopeOk | AgentEnvelopeErr;
 /**

package/dist/output/envelope.d.ts.map

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

package/dist/output/envelope.js

@@ -67,6 +67,9 @@ export function makeEnvelope(ctx, data, content) {
         data,
         error: null,
         ...(content !== undefined && content.length > 0 ? { content } : {}),
+        ...(ctx.next_actions !== undefined && ctx.next_actions.length > 0
+            ? { next_actions: ctx.next_actions }
+            : {}),
     };
 }
 /** Build an error envelope. `data` is forced to null. */
@@ -85,6 +88,9 @@ export function makeError(ctx, err) {
         },
         data: null,
         error: err,
+        ...(ctx.next_actions !== undefined && ctx.next_actions.length > 0
+            ? { next_actions: ctx.next_actions }
+            : {}),
     };
 }
 /**

package/dist/output/envelope.js.map

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

package/dist/output/next-actions.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Default HATEOAS `next_actions` hints. Every CLI response carries a small
+ * set of templates so the agent always has a navigable next step without
+ * re-reading docs. Agents read `params.<name>.value` / `.default` / `.enum`
+ * to fill templates instead of guessing flag syntax.
+ *
+ * Pattern from joelclaw.com "CLI Design for AI Agents" (2026-02), refined
+ * for Uni-CLI's self-repair contract so failure paths also suggest
+ * `unicli repair` + stdin-JSON channel switch.
+ */
+import type { AgentNextAction } from "./envelope.js";
+/** Hints shown alongside a successful result for site-<cmd>. */
+export declare function defaultSuccessNextActions(site: string, cmdName: string, opts?: {
+    supportsPagination?: boolean;
+}): AgentNextAction[];
+/** Hints shown on the error path — biased toward repair + channel switch. */
+export declare function defaultErrorNextActions(site: string, cmdName: string, errCode: string): AgentNextAction[];
+//# sourceMappingURL=next-actions.d.ts.map

package/dist/output/next-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-actions.d.ts","sourceRoot":"","sources":["../../src/output/next-actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,gEAAgE;AAChE,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;IAAE,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAAE,GACtC,eAAe,EAAE,CAyBnB;AAED,6EAA6E;AAC7E,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,eAAe,EAAE,CAmCnB"}

package/dist/output/next-actions.js

@@ -0,0 +1,64 @@
+/**
+ * Default HATEOAS `next_actions` hints. Every CLI response carries a small
+ * set of templates so the agent always has a navigable next step without
+ * re-reading docs. Agents read `params.<name>.value` / `.default` / `.enum`
+ * to fill templates instead of guessing flag syntax.
+ *
+ * Pattern from joelclaw.com "CLI Design for AI Agents" (2026-02), refined
+ * for Uni-CLI's self-repair contract so failure paths also suggest
+ * `unicli repair` + stdin-JSON channel switch.
+ */
+/** Hints shown alongside a successful result for site-<cmd>. */
+export function defaultSuccessNextActions(site, cmdName, opts) {
+    const actions = [
+        {
+            command: `unicli describe ${site} ${cmdName}`,
+            description: "Inspect the command's JSON schema, channels, and example payload",
+        },
+        {
+            command: `unicli ${site} ${cmdName} --args-file <path.json>`,
+            description: "Re-run with a JSON payload from file (avoids shell-quote hell)",
+            params: {
+                path: {
+                    description: "Absolute path to a JSON object file with command args",
+                },
+            },
+        },
+    ];
+    if (opts?.supportsPagination) {
+        actions.push({
+            command: `unicli ${site} ${cmdName} --cursor <next_cursor>`,
+            description: "Fetch the next page using meta.pagination.next_cursor",
+        });
+    }
+    return actions;
+}
+/** Hints shown on the error path — biased toward repair + channel switch. */
+export function defaultErrorNextActions(site, cmdName, errCode) {
+    const actions = [
+        {
+            command: `unicli describe ${site} ${cmdName}`,
+            description: "Read the exact schema the command expects (often resolves invalid_input)",
+        },
+    ];
+    if (errCode === "invalid_input" ||
+        errCode === "selector_miss" ||
+        errCode === "parse_error") {
+        actions.push({
+            command: `echo '{...}' | unicli ${site} ${cmdName}`,
+            description: "Retry using stdin-JSON channel — payloads with quotes/emoji/JSON often fail the shell-args path",
+        });
+    }
+    if (errCode === "auth_required" || errCode === "not_authenticated") {
+        actions.push({
+            command: `unicli auth setup ${site}`,
+            description: "Save cookies / token for this site",
+        });
+    }
+    actions.push({
+        command: `unicli repair ${site} ${cmdName}`,
+        description: "Ask an agent to repair the adapter YAML if the upstream API has drifted",
+    });
+    return actions;
+}
+//# sourceMappingURL=next-actions.js.map

package/dist/output/next-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-actions.js","sourceRoot":"","sources":["../../src/output/next-actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,gEAAgE;AAChE,MAAM,UAAU,yBAAyB,CACvC,IAAY,EACZ,OAAe,EACf,IAAuC;IAEvC,MAAM,OAAO,GAAsB;QACjC;YACE,OAAO,EAAE,mBAAmB,IAAI,IAAI,OAAO,EAAE;YAC7C,WAAW,EACT,kEAAkE;SACrE;QACD;YACE,OAAO,EAAE,UAAU,IAAI,IAAI,OAAO,0BAA0B;YAC5D,WAAW,EACT,gEAAgE;YAClE,MAAM,EAAE;gBACN,IAAI,EAAE;oBACJ,WAAW,EAAE,uDAAuD;iBACrE;aACF;SACF;KACF,CAAC;IACF,IAAI,IAAI,EAAE,kBAAkB,EAAE,CAAC;QAC7B,OAAO,CAAC,IAAI,CAAC;YACX,OAAO,EAAE,UAAU,IAAI,IAAI,OAAO,yBAAyB;YAC3D,WAAW,EAAE,uDAAuD;SACrE,CAAC,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,uBAAuB,CACrC,IAAY,EACZ,OAAe,EACf,OAAe;IAEf,MAAM,OAAO,GAAsB;QACjC;YACE,OAAO,EAAE,mBAAmB,IAAI,IAAI,OAAO,EAAE;YAC7C,WAAW,EACT,0EAA0E;SAC7E;KACF,CAAC;IAEF,IACE,OAAO,KAAK,eAAe;QAC3B,OAAO,KAAK,eAAe;QAC3B,OAAO,KAAK,aAAa,EACzB,CAAC;QACD,OAAO,CAAC,IAAI,CAAC;YACX,OAAO,EAAE,yBAAyB,IAAI,IAAI,OAAO,EAAE;YACnD,WAAW,EACT,iGAAiG;SACpG,CAAC,CAAC;IACL,CAAC;IAED,IAAI,OAAO,KAAK,eAAe,IAAI,OAAO,KAAK,mBAAmB,EAAE,CAAC;QACnE,OAAO,CAAC,IAAI,CAAC;YACX,OAAO,EAAE,qBAAqB,IAAI,EAAE;YACpC,WAAW,EAAE,oCAAoC;SAClD,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,IAAI,CAAC;QACX,OAAO,EAAE,iBAAiB,IAAI,IAAI,OAAO,EAAE;QAC3C,WAAW,EACT,yEAAyE;KAC5E,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/output/projection.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Output-side projection helpers — `--select` / `--fields` / `--pluck` / `--pluck0`.
+ *
+ * These flags externalize the `| jq` / `| awk` step agents used to apply to
+ * `unicli` output. The kernel produces a raw `results[]` array; the CLI
+ * surface projects it *before* `format()` so every envelope format (json /
+ * yaml / md / csv / compact) benefits. MCP and ACP do NOT honor these —
+ * they speak JSON, agents project client-side.
+ *
+ * Precedence (highest wins when multiple flags are set):
+ *   --pluck0  >  --pluck  >  --select  >  --fields
+ *
+ * When multiple are set, a single stderr warning is emitted and only the
+ * highest-priority flag applies.
+ */
+export interface ProjectionOptions {
+    /** JSONPath expression applied to the results array. */
+    select?: string;
+    /** Comma-separated column list (used when rendering tabular output). */
+    fields?: string;
+    /** Single field name → newline-delimited stream (wins over select/fields). */
+    pluck?: string;
+    /** Single field name → NUL-delimited stream (wins over pluck). */
+    pluck0?: string;
+}
+/** Thrown when `--select` fails to parse. Distinguishes user typo from empty match. */
+export declare class ProjectionError extends Error {
+    readonly detail: {
+        flag: "select";
+        expression: string;
+        cause: string;
+    };
+    constructor(message: string, detail: {
+        flag: "select";
+        expression: string;
+        cause: string;
+    });
+}
+export interface ProjectionResult {
+    /** The results array after `--select` / `--pluck` / `--pluck0` have been applied. */
+    results: unknown[];
+    /** The columns override from `--fields` (undefined when unset). */
+    columns: string[] | undefined;
+    /** When true, caller must emit a plain-text newline-delimited stream. */
+    pluckMode: boolean;
+    /** When true, caller must emit a NUL-delimited stream (for `xargs -0`). */
+    pluck0Mode: boolean;
+}
+/**
+ * Render a single row as the stringified value of the plucked field. Nested
+ * objects serialize as JSON (one line, no indent) so agents can still pipe
+ * the stream into `xargs -I{} jq ...` if a column happens to be structured.
+ *
+ * Newlines in string values are collapsed to a single space — a raw `\n`
+ * would break every `while read` / `xargs -n1` loop downstream. Callers
+ * that need newline-preserving output should use `--format json` instead.
+ * Returns both the sanitized string and a flag indicating whether any
+ * `\r` or `\n` was stripped, so the caller can emit one debounced warning
+ * per invocation.
+ */
+export declare function pluckRow(row: unknown, field: string): {
+    value: string;
+    sanitized: boolean;
+};
+/**
+ * Apply the three projection flags in priority order. Returns the
+ * post-projection `results`, the column override (for `--fields`), and
+ * a `pluckMode` flag that directs the caller to print a newline-delimited
+ * stream instead of a formatted envelope.
+ *
+ * A single stderr warning is emitted when more than one flag is set so
+ * the agent can see that a lower-priority flag was suppressed.
+ */
+export declare function applyProjection(results: unknown[], options: ProjectionOptions, warn?: (msg: string) => void): ProjectionResult;
+/**
+ * Render `results` as the `--pluck` plain-text stream. One row per line,
+ * field value stringified via `pluckRow`. No header, no trailing newline
+ * (the caller adds it through `console.log`).
+ *
+ * A single stderr warning is emitted if any value had embedded newlines
+ * stripped — agents that need newline-preserving output should use
+ * `--format json` instead. Warning is debounced: one line per invocation,
+ * not one line per row.
+ */
+export declare function renderPluck(results: unknown[], field: string, warn?: (msg: string) => void): string;
+/**
+ * Render `results` as the `--pluck0` NUL-delimited stream (xargs -0).
+ * Each value is followed by `\0`, including the last one — matches the
+ * convention of `find -print0` so downstream `xargs -0` counts rows
+ * correctly. Same newline-sanitization as `--pluck`.
+ */
+export declare function renderPluck0(results: unknown[], field: string, warn?: (msg: string) => void): string;
+//# sourceMappingURL=projection.d.ts.map

package/dist/output/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../src/output/projection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,MAAM,WAAW,iBAAiB;IAChC,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,uFAAuF;AACvF,qBAAa,eAAgB,SAAQ,KAAK;aAGtB,MAAM,EAAE;QACtB,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;KACf;gBALD,OAAO,EAAE,MAAM,EACC,MAAM,EAAE;QACtB,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;KACf;CAKJ;AAED,MAAM,WAAW,gBAAgB;IAC/B,qFAAqF;IACrF,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,mEAAmE;IACnE,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC9B,yEAAyE;IACzE,SAAS,EAAE,OAAO,CAAC;IACnB,2EAA2E;IAC3E,UAAU,EAAE,OAAO,CAAC;CACrB;AAgGD;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,MAAM,GACZ;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAUvC;AAOD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAAE,EAClB,OAAO,EAAE,iBAAiB,EAC1B,IAAI,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAgD,GACtE,gBAAgB,CA4DlB;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,OAAO,EAAE,EAClB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAgD,GACtE,MAAM,CAWR;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,OAAO,EAAE,EAClB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAgD,GACtE,MAAM,CAYR"}