scoutline 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Numman Ali
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,146 @@
+<h1 align="center">Scoutline</h1>
+
+<p align="center">
+  A command-line field kit for investigating web, repository, and visual sources.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/scoutline"><img src="https://img.shields.io/npm/v/scoutline.svg" alt="npm version"></a>
+  <a href="https://github.com/vikasagarwal101/scoutline/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a>
+</p>
+
+> Independently maintained by Vikas Agarwal. See [CREDITS.md](https://github.com/vikasagarwal101/scoutline/blob/main/CREDITS.md) for project attribution.
+
+---
+
+## Features
+
+- **Vision** - Analyze images, screenshots, diagrams, charts, videos using GLM-4.6V
+- **Search** - Real-time web search with domain and recency filtering
+- **Reader** - Fetch and parse web pages to markdown
+- **Repo** - Search and read GitHub repository code via ZRead
+- **Tools** - MCP tool discovery, schemas, and raw calls
+- **Code Mode** - TypeScript tool chaining for agent automation
+
+## Quick Start
+
+```bash
+export Z_AI_API_KEY="your-api-key"
+
+npx scoutline --help
+npx scoutline vision analyze ./screenshot.png "What errors do you see?"
+npx scoutline search "React 19 new features" --count 5
+```
+
+Get your API key at: https://z.ai/manage-apikey/apikey-list
+
+## Installation
+
+### As an Agent Skill
+
+**OpenSkills** (universal - works with any AI coding agent):
+
+```bash
+npx openskills install vikasagarwal101/scoutline
+```
+
+**Claude Code** (native skill marketplace):
+
+```bash
+claude skill install vikasagarwal101/scoutline --skill scoutline
+```
+
+### As a CLI Tool
+
+```bash
+npm i -g scoutline
+scoutline --help
+```
+
+Or use directly with npx:
+
+```bash
+npx scoutline --help
+```
+
+## Usage
+
+The CLI is self-documenting. Use `--help` at any level:
+
+```bash
+scoutline --help              # All commands
+scoutline vision --help       # Vision commands
+scoutline search --help       # Search options
+scoutline repo --help         # GitHub repo commands
+```
+
+### Examples
+
+```bash
+# Vision - analyze images
+scoutline vision analyze ./image.png "Describe this"
+scoutline vision ui-to-code ./design.png --output code
+scoutline vision extract-text ./screenshot.png --language python
+scoutline vision diagnose-error ./error.png
+
+# Search - web search
+scoutline search "TypeScript best practices" --count 10
+scoutline search "security news" --recency oneDay
+
+# Reader - fetch web content
+scoutline read https://docs.example.com/api
+scoutline read https://blog.example.com --format text
+
+# Repo - GitHub exploration
+scoutline repo tree facebook/react
+scoutline repo search vercel/next.js "app router"
+scoutline repo read anthropics/anthropic-sdk-python README.md
+scoutline repo search openai/codex "config" --language en
+scoutline repo tree openai/codex --path codex-rs --depth 2
+
+# Doctor - check setup
+scoutline doctor
+scoutline doctor --no-vision
+```
+
+## Output Format
+
+Default output is **data-only** for token efficiency. Use `--output-format json` for structured responses:
+
+```json
+{
+  "success": true,
+  "data": "...",
+  "timestamp": 1234567890
+}
+```
+
+## Notes
+
+- `repo search` defaults to English results. Use `--language zh` for Chinese.
+- `repo tree` supports `--path` (directory scope) and `--depth` (expand subtrees).
+- `tools`, `tool`, `call`, `doctor` accept `--no-vision` to speed startup when vision tools are not needed.
+- `read` supports `--with-images-summary`, `--no-gfm`, and `--keep-img-data-url` for richer parsing control.
+- Vision tool calls automatically retry transient 5xx/network errors (default: 2 retries). Configure with `ZAI_MCP_VISION_RETRY_COUNT` (or `ZAI_MCP_RETRY_COUNT` for all tools).
+- Tool discovery can be cached to speed `tools`/`tool`/`doctor` (default: on, 24h TTL). Configure with `ZAI_MCP_TOOL_CACHE`, `ZAI_MCP_TOOL_CACHE_TTL_MS`, `ZAI_MCP_CACHE_DIR`.
+
+## Contributing
+
+See [CONTRIBUTING.md](https://github.com/vikasagarwal101/scoutline/blob/main/CONTRIBUTING.md) for development setup and guidelines.
+
+## Performance
+
+Benchmark tool discovery (cache on/off):
+
+```bash
+node scripts/bench-tools.mjs
+```
+
+## License
+
+MIT - see [LICENSE](https://github.com/vikasagarwal101/scoutline/blob/main/LICENSE).
+
+## Links
+
+- [GitHub Repository](https://github.com/vikasagarwal101/scoutline)
+- [Documentation](https://github.com/vikasagarwal101/scoutline/tree/main/docs)

package/bin/scoutline.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+
+import("../dist/index.js").catch((err) => {
+  console.error(
+    JSON.stringify(
+      {
+        success: false,
+        error: err.message,
+        code: "LOAD_ERROR",
+        help: 'Make sure to run "npm run build" before running scoutline',
+      },
+      null,
+      2,
+    ),
+  );
+  process.exit(1);
+});

package/dist/commands/code.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Code Mode commands for tool chaining
+ */
+export interface CodeRunOptions {
+    timeout?: number;
+    includeLogs?: boolean;
+}
+export declare function runCodeFile(filePath: string, options?: CodeRunOptions): Promise<void>;
+export declare function evalCode(code: string, options?: CodeRunOptions): Promise<void>;
+export declare function printInterfaces(): Promise<void>;
+export declare function printPromptTemplate(): void;
+export declare const CODE_HELP: string;
+//# sourceMappingURL=code.d.ts.map

package/dist/commands/code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../src/commands/code.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB/F;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBxF;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAcrD;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAGD,eAAO,MAAM,SAAS,QAkBd,CAAC"}

package/dist/commands/code.js

@@ -0,0 +1,94 @@
+/**
+ * Code Mode commands for tool chaining
+ */
+import * as fs from "node:fs/promises";
+import { ZaiCodeModeClient } from "../lib/code-mode.js";
+import { outputSuccess } from "../lib/output.js";
+import { formatErrorOutput } from "../lib/errors.js";
+import { silenceConsole, restoreConsole } from "../lib/silence.js";
+export async function runCodeFile(filePath, options = {}) {
+    const code = await fs.readFile(filePath, "utf8");
+    silenceConsole();
+    const codeClient = new ZaiCodeModeClient();
+    try {
+        const result = await codeClient.callToolChain(code, options.timeout);
+        if (options.includeLogs) {
+            outputSuccess(result);
+        }
+        else {
+            outputSuccess(result.result);
+        }
+    }
+    catch (error) {
+        restoreConsole();
+        console.error(formatErrorOutput(error));
+        process.exit(1);
+    }
+    finally {
+        await codeClient.close().catch(() => { });
+        restoreConsole();
+    }
+}
+export async function evalCode(code, options = {}) {
+    silenceConsole();
+    const codeClient = new ZaiCodeModeClient();
+    try {
+        const result = await codeClient.callToolChain(code, options.timeout);
+        if (options.includeLogs) {
+            outputSuccess(result);
+        }
+        else {
+            outputSuccess(result.result);
+        }
+    }
+    catch (error) {
+        restoreConsole();
+        console.error(formatErrorOutput(error));
+        process.exit(1);
+    }
+    finally {
+        await codeClient.close().catch(() => { });
+        restoreConsole();
+    }
+}
+export async function printInterfaces() {
+    silenceConsole();
+    const codeClient = new ZaiCodeModeClient();
+    try {
+        const interfaces = await codeClient.getAllInterfaces();
+        outputSuccess(interfaces);
+    }
+    catch (error) {
+        restoreConsole();
+        console.error(formatErrorOutput(error));
+        process.exit(1);
+    }
+    finally {
+        await codeClient.close().catch(() => { });
+        restoreConsole();
+    }
+}
+export function printPromptTemplate() {
+    outputSuccess(ZaiCodeModeClient.getPromptTemplate());
+}
+// Help text
+export const CODE_HELP = `
+Code Mode - Execute TypeScript tool chains
+
+Usage:
+  scoutline code run <file> [options]
+  scoutline code eval <code> [options]
+  scoutline code interfaces
+  scoutline code prompt
+
+Options:
+  --timeout <ms>   Execution timeout (default: 30000)
+  --logs           Include console logs in output
+
+Examples:
+  scoutline code run ./chain.ts
+  scoutline code eval "const r = await scoutline.zai.search.webSearchPrime({search_query:'ZAI'}); return r;"
+  scoutline code interfaces
+  scoutline code prompt
+`.trim();
+//# sourceMappingURL=code.js.map

package/dist/commands/code.js.map

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

package/dist/commands/doctor.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Doctor command for environment and MCP diagnostics
+ */
+export interface DoctorOptions {
+    noTools?: boolean;
+    enableVision?: boolean;
+}
+export declare function doctor(options?: DoctorOptions): Promise<void>;
+export declare const DOCTOR_HELP: string;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAOD,wBAAsB,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+CvE;AAED,eAAO,MAAM,WAAW,QAYhB,CAAC"}

package/dist/commands/doctor.js

@@ -0,0 +1,70 @@
+/**
+ * Doctor command for environment and MCP diagnostics
+ */
+import { ZaiMcpClient } from "../lib/mcp-client.js";
+import { outputSuccess } from "../lib/output.js";
+import { formatErrorOutput } from "../lib/errors.js";
+import { silenceConsole, restoreConsole } from "../lib/silence.js";
+function getNodeMajor() {
+    const [major] = process.versions.node.split(".");
+    return parseInt(major, 10);
+}
+export async function doctor(options = {}) {
+    const apiKey = process.env.Z_AI_API_KEY || process.env.ZAI_API_KEY;
+    const mode = (process.env.Z_AI_MODE || process.env.PLATFORM_MODE || "ZAI").toUpperCase();
+    const nodeMajor = getNodeMajor();
+    const report = {
+        env: {
+            apiKeyPresent: Boolean(apiKey),
+            mode,
+            baseUrl: process.env.Z_AI_BASE_URL || undefined,
+        },
+        node: {
+            version: process.versions.node,
+            visionMcpCompatible: nodeMajor >= 22,
+        },
+    };
+    if (options.noTools || !apiKey) {
+        outputSuccess(report);
+        return;
+    }
+    silenceConsole();
+    const client = new ZaiMcpClient({ enableVision: options.enableVision });
+    try {
+        const tools = await client.listTools();
+        const byServer = tools.reduce((acc, tool) => {
+            const parts = tool.name.split(".");
+            const server = parts.length >= 2 ? parts[1] : "unknown";
+            acc[server] = (acc[server] || 0) + 1;
+            return acc;
+        }, {});
+        report.mcp = {
+            toolCount: tools.length,
+            servers: byServer,
+        };
+        outputSuccess(report);
+    }
+    catch (error) {
+        restoreConsole();
+        console.error(formatErrorOutput(error));
+        process.exit(1);
+    }
+    finally {
+        await client.close().catch(() => { });
+        restoreConsole();
+    }
+}
+export const DOCTOR_HELP = `
+Doctor - Check environment and MCP connectivity
+
+Usage: scoutline doctor [options]
+
+Options:
+  --no-tools   Skip tool discovery (env-only check)
+  --no-vision  Skip vision MCP server (faster startup)
+
+Examples:
+  scoutline doctor
+  scoutline doctor --no-tools
+`.trim();
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/quota.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Quota command — authoritative Z.AI Coding Plan usage from the monitor API.
+ */
+export interface QuotaOptions {
+    window?: "current";
+}
+export declare function quota(_options?: QuotaOptions): Promise<void>;
+export declare const QUOTA_HELP: string;
+//# sourceMappingURL=quota.d.ts.map

package/dist/commands/quota.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota.d.ts","sourceRoot":"","sources":["../../src/commands/quota.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED,wBAAsB,KAAK,CAAC,QAAQ,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2CtE;AAED,eAAO,MAAM,UAAU,QAwBf,CAAC"}

package/dist/commands/quota.js

@@ -0,0 +1,77 @@
+/**
+ * Quota command — authoritative Z.AI Coding Plan usage from the monitor API.
+ */
+import { getQuotaLimit, getTimeLimit, getTokensLimit, formatResetTime, } from "../lib/monitor-client.js";
+import { outputSuccess, getOutputMode } from "../lib/output.js";
+import { formatErrorOutput } from "../lib/errors.js";
+import { formatQuotaPretty } from "../lib/tty.js";
+export async function quota(_options = {}) {
+    try {
+        const data = await getQuotaLimit();
+        const timeLimit = getTimeLimit(data);
+        const tokensLimit = getTokensLimit(data);
+        const formatted = {
+            plan: data.level,
+            timeWindow: timeLimit
+                ? {
+                    used: timeLimit.currentValue,
+                    limit: timeLimit.usage,
+                    remaining: timeLimit.remaining,
+                    percentage: timeLimit.percentage,
+                    windowHours: timeLimit.unit,
+                    resetsAt: timeLimit.nextResetTime
+                        ? new Date(timeLimit.nextResetTime).toISOString()
+                        : null,
+                    resetsIn: timeLimit.nextResetTime ? formatResetTime(timeLimit.nextResetTime) : null,
+                    byTool: timeLimit.usageDetails,
+                }
+                : null,
+            tokens: tokensLimit
+                ? {
+                    percentage: tokensLimit.percentage,
+                    resetsAt: tokensLimit.nextResetTime
+                        ? new Date(tokensLimit.nextResetTime).toISOString()
+                        : null,
+                    resetsIn: tokensLimit.nextResetTime ? formatResetTime(tokensLimit.nextResetTime) : null,
+                }
+                : null,
+        };
+        const mode = getOutputMode();
+        if (mode === "tty") {
+            outputSuccess(formatQuotaPretty(formatted));
+        }
+        else {
+            outputSuccess(formatted);
+        }
+    }
+    catch (error) {
+        console.error(formatErrorOutput(error));
+        process.exit(1);
+    }
+}
+export const QUOTA_HELP = `
+Quota Command - Authoritative Z.AI Coding Plan usage from the monitor API
+
+Usage: scoutline quota [options]
+
+Hits GET https://api.z.ai/api/monitor/usage/quota/limit directly (NOT the MCP
+endpoint) to return real-time plan usage, including:
+  - Plan tier (pro / lite / max)
+  - 5-hour rolling window: calls used / limit / remaining / reset time
+  - Per-tool breakdown (search-prime, web-reader, zread)
+  - Token budget percentage + reset time
+
+Options:
+  (none yet — future versions may add --history for 24h/7d/30d windows)
+
+Examples:
+  scoutline quota
+  scoutline quota -O pretty    # human-readable with progress bars
+  scoutline quota -O json      # envelope-wrapped for scripts
+
+Notes:
+  - This call hits a different endpoint than search/read/repo and is not
+    cached by the local response cache.
+  - Auth: tries raw API key first, falls back to Bearer prefix on 401.
+`.trim();
+//# sourceMappingURL=quota.js.map

package/dist/commands/quota.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota.js","sourceRoot":"","sources":["../../src/commands/quota.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,aAAa,EACb,YAAY,EACZ,cAAc,EACd,eAAe,GAChB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAMlD,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,QAAQ,GAAiB,EAAE;IACrD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,aAAa,EAAE,CAAC;QACnC,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QAEzC,MAAM,SAAS,GAAG;YAChB,IAAI,EAAE,IAAI,CAAC,KAAK;YAChB,UAAU,EAAE,SAAS;gBACnB,CAAC,CAAC;oBACE,IAAI,EAAE,SAAS,CAAC,YAAY;oBAC5B,KAAK,EAAE,SAAS,CAAC,KAAK;oBACtB,SAAS,EAAE,SAAS,CAAC,SAAS;oBAC9B,UAAU,EAAE,SAAS,CAAC,UAAU;oBAChC,WAAW,EAAE,SAAS,CAAC,IAAI;oBAC3B,QAAQ,EAAE,SAAS,CAAC,aAAa;wBAC/B,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE;wBACjD,CAAC,CAAC,IAAI;oBACR,QAAQ,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,eAAe,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI;oBACnF,MAAM,EAAE,SAAS,CAAC,YAAY;iBAC/B;gBACH,CAAC,CAAC,IAAI;YACR,MAAM,EAAE,WAAW;gBACjB,CAAC,CAAC;oBACE,UAAU,EAAE,WAAW,CAAC,UAAU;oBAClC,QAAQ,EAAE,WAAW,CAAC,aAAa;wBACjC,CAAC,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE;wBACnD,CAAC,CAAC,IAAI;oBACR,QAAQ,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,eAAe,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI;iBACxF;gBACH,CAAC,CAAC,IAAI;SACT,CAAC;QAEF,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;QAC7B,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;YACnB,aAAa,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,aAAa,CAAC,SAAS,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;CAwBzB,CAAC,IAAI,EAAE,CAAC"}

package/dist/commands/read.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Web reader command using Z.AI WebReader MCP
+ */
+import { type ExtractMode } from "../lib/extract.js";
+export interface ReadOptions {
+    format?: "markdown" | "text";
+    noImages?: boolean;
+    withLinks?: boolean;
+    timeout?: number;
+    noCache?: boolean;
+    noGfm?: boolean;
+    keepImgDataUrl?: boolean;
+    withImagesSummary?: boolean;
+    maxChars?: number;
+    fullEnvelope?: boolean;
+    extract?: ExtractMode;
+}
+export declare function read(url: string, options?: ReadOptions): Promise<void>;
+export declare const READ_HELP: string;
+//# sourceMappingURL=read.d.ts.map

package/dist/commands/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/commands/read.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAA0B,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE7E,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAwDD,wBAAsB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiFhF;AAGD,eAAO,MAAM,SAAS,QAuCd,CAAC"}