scoutline 0.1.0 → 0.6.0

package/dist/commands/cache.js

@@ -0,0 +1,203 @@
+/**
+ * Cache command — local cache inspection and clearing
+ * (Cache Module Unification Ticket 03).
+ *
+ * The command is presentation-only: it receives already-resolved stats
+ * or clear results through injected dependencies and wraps them with a
+ * TTY presentation override. Directory resolution, env-var policy, and
+ * on-disk I/O live in `src/lib/cache.ts` (Ticket 01). The dispatcher
+ * (`src/index.ts`) wires production to the real `cacheStats()` and
+ * `clearAllCaches()` and threads them through these dependencies; tests
+ * inject doubles.
+ *
+ * Output format (core-flows artifact):
+ *
+ * ```text
+ * Cache directory: ~/.scoutline/
+ * Status: enabled (TTL 24h, cap 100MB)
+ *
+ * Response cache:
+ *   Entries: 47
+ *   Size: 12.3 MB
+ *
+ * Tool cache:
+ *   Entries: 1
+ *   Size: 8.2 KB
+ * ```
+ *
+ * L1 fix: Doctor's one-line cache summary is computed from the same
+ * `cacheStats()` shape but formatted by the dispatcher, not by this
+ * module. See `formatDoctorCacheSummary`.
+ */
+// ---------------------------------------------------------------------------
+// Pure formatting helpers
+// ---------------------------------------------------------------------------
+/**
+ * Format a byte count as e.g. `"12.3 MB"`, `"8.2 KB"`, `"510 B"`. Used
+ * by `cache stats` presentation and by Doctor's one-line summary. Pure:
+ * no I/O, no env reads.
+ */
+export function formatBytes(bytes) {
+    if (!Number.isFinite(bytes) || bytes < 0)
+        return "0 B";
+    if (bytes < 1024)
+        return `${bytes} B`;
+    const units = ["KB", "MB", "GB", "TB"];
+    let value = bytes / 1024;
+    let unitIndex = 0;
+    while (value >= 1024 && unitIndex < units.length - 1) {
+        value /= 1024;
+        unitIndex += 1;
+    }
+    return `${value.toFixed(1)} ${units[unitIndex]}`;
+}
+/**
+ * Format a TTL in ms as `"24h"`, `"30m"`, or `"60s"`. Chooses the
+ * largest whole-unit that divides the input evenly so the default
+ * 24h renders as `24h` rather than `86400000ms`.
+ */
+export function formatTtl(ms) {
+    if (!Number.isFinite(ms) || ms <= 0)
+        return "0s";
+    if (ms % 3_600_000 === 0)
+        return `${ms / 3_600_000}h`;
+    if (ms % 60_000 === 0)
+        return `${ms / 60_000}m`;
+    return `${Math.round(ms / 1000)}s`;
+}
+/**
+ * Format the size cap (bytes) as e.g. `"100MB"`. Mirrors the
+ * `SCOUTLINE_CACHE_SIZE_MB` env-var spelling so the operator surface
+ * matches the documentation.
+ */
+function formatSizeCap(bytes) {
+    return `${Math.round(bytes / (1024 * 1024))}MB`;
+}
+/**
+ * Pluralize "entry"/"entries" for a count.
+ */
+function pluralEntry(count) {
+    return count === 1 ? "entry" : "entries";
+}
+/**
+ * Format the inventory of both caches as a multi-line TTY block per
+ * the core-flows artifact. Used as the TTY/compact/markdown/refs
+ * presentation for `cache stats`. Pure.
+ */
+export function formatCacheStats(stats) {
+    const lines = [];
+    lines.push(`Cache directory: ${stats.dir}`);
+    if (stats.enabled) {
+        lines.push(`Status: enabled (TTL ${formatTtl(stats.ttlMs)}, cap ${formatSizeCap(stats.sizeCapBytes)})`);
+    }
+    else {
+        lines.push(`Status: disabled`);
+    }
+    lines.push("");
+    lines.push("Response cache:");
+    lines.push(`  Entries: ${stats.responseCache.entries}`);
+    lines.push(`  Size: ${formatBytes(stats.responseCache.totalBytes)}`);
+    lines.push("");
+    lines.push("Tool cache:");
+    lines.push(`  Entries: ${stats.toolCache.entries}`);
+    lines.push(`  Size: ${formatBytes(stats.toolCache.totalBytes)}`);
+    return lines.join("\n");
+}
+/**
+ * Format a clear result as a one-line TTY notice.
+ */
+export function formatCacheClear(result) {
+    return (`Cleared ${result.responsesCleared} response ${pluralEntry(result.responsesCleared)} ` +
+        `and ${result.toolsCleared} tool ${pluralEntry(result.toolsCleared)} ` +
+        `(${formatBytes(result.bytesFreed)} freed)`);
+}
+/**
+ * Format the one-line Doctor cache summary from a `cacheStats()` value.
+ * The dispatcher calls this before invoking `buildDiagnosticsReport`;
+ * the report builder embeds the result verbatim. Examples:
+ *
+ * ```text
+ * Cache: enabled, 47 response entries (12.3 MB), 1 tool entry (8.2 KB), ~/.scoutline/
+ * Cache: disabled
+ * ```
+ *
+ * Pure: never reads env or touches the filesystem.
+ */
+export function formatDoctorCacheSummary(stats) {
+    if (!stats.enabled)
+        return "Cache: disabled";
+    return (`Cache: enabled, ${stats.responseCache.entries} response ${pluralEntry(stats.responseCache.entries)} ` +
+        `(${formatBytes(stats.responseCache.totalBytes)}), ${stats.toolCache.entries} tool ${pluralEntry(stats.toolCache.entries)} ` +
+        `(${formatBytes(stats.toolCache.totalBytes)}), ${stats.dir}`);
+}
+// ---------------------------------------------------------------------------
+// Commands
+// ---------------------------------------------------------------------------
+/** All text modes share the same multi-line inventory rendering. */
+function statsPresentations(stats) {
+    const text = formatCacheStats(stats);
+    return { compact: text, markdown: text, refs: text, tty: text };
+}
+/** All text modes share the same one-line clear notice. */
+function clearPresentations(result) {
+    const text = formatCacheClear(result);
+    return { compact: text, markdown: text, refs: text, tty: text };
+}
+/**
+ * Run the `cache stats` subcommand. Returns the inventory as base data
+ * with a TTY presentation override. Exit code is always 0 on success;
+ * I/O failures propagate as ordinary errors through the dispatcher.
+ */
+export async function cacheStatsCommand(deps) {
+    const stats = await deps.getStats();
+    return {
+        kind: "data",
+        data: stats,
+        presentations: statsPresentations(stats),
+    };
+}
+/**
+ * Run the `cache clear` subcommand. Returns the count of cleared
+ * entries and bytes freed as base data with a TTY presentation
+ * override.
+ */
+export async function cacheClearCommand(deps) {
+    const result = await deps.clear();
+    return {
+        kind: "data",
+        data: result,
+        presentations: clearPresentations(result),
+    };
+}
+export const CACHE_HELP = `
+Cache - Inspect and clear the local cache
+
+Usage:
+  scoutline cache stats   # show inventory of both cache subdirectories
+  scoutline cache clear   # delete every file in both cache subdirectories
+
+Subcommands:
+  stats   Print the cache directory, status (enabled/disabled, TTL, size
+          cap), and per-subdirectory entry count and total size for both
+          the response cache (~/.scoutline/cache/) and the tool cache
+          (~/.scoutline/tools/).
+  clear   Delete every file under <root>/cache/ and <root>/tools/. The
+          directories themselves are preserved so the next invocation
+          recreates entries without a directory-creation race. The
+          orphaned legacy ~/.cache/zai-cli/ directory is never touched.
+
+The cache root defaults to ~/.scoutline/ on every platform; override it
+with SCOUTLINE_CACHE_DIR (ZAI_MCP_CACHE_DIR and ZAI_CACHE_DIR are
+accepted as lower-precedence legacy aliases). Disable both caches with
+SCOUTLINE_CACHE=0 (legacy alias: ZAI_CACHE=0).
+
+Exit codes:
+  0  Success.
+  1  I/O error (reported as a sanitized JSON error envelope).
+
+Examples:
+  scoutline cache stats
+  scoutline cache clear
+  scoutline cache --help
+`.trim();
+//# sourceMappingURL=cache.js.map

package/dist/commands/cache.js.map

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

package/dist/commands/code.d.ts

@@ -1,13 +1,20 @@
 /**
  * Code Mode commands for tool chaining
+ *
+ * P1-07: each command returns a CommandResult instead of writing
+ * directly to stdout/stderr. stdin is read through CommandContext rather
+ * than the process stream. No Provider selection is added; Phase 0
+ * Code Mode semantics (run, eval, logs, timeout, interfaces, prompt
+ * template) are preserved.
  */
+import type { CommandContext, CommandResult } from "../command-invocation.js";
 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 function runCodeFile(filePath: string, options?: CodeRunOptions, context?: CommandContext): Promise<CommandResult>;
+export declare function evalCode(code: string, options?: CodeRunOptions, context?: CommandContext): Promise<CommandResult>;
+export declare function printInterfaces(context?: CommandContext): Promise<CommandResult>;
+export declare function printPromptTemplate(context?: CommandContext): CommandResult;
 export declare const CODE_HELP: string;
 //# sourceMappingURL=code.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../src/commands/code.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9E,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,cAAmB,EAC5B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,aAAa,CAAC,CAWxB;AAED,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,cAAmB,EAC5B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,aAAa,CAAC,CASxB;AAED,wBAAsB,eAAe,CACnC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,aAAa,CAAC,CAQxB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,aAAa,CAE3E;AAGD,eAAO,MAAM,SAAS,QAkBd,CAAC"}

package/dist/commands/code.js

@@ -1,75 +1,49 @@
 /**
  * Code Mode commands for tool chaining
+ *
+ * P1-07: each command returns a CommandResult instead of writing
+ * directly to stdout/stderr. stdin is read through CommandContext rather
+ * than the process stream. No Provider selection is added; Phase 0
+ * Code Mode semantics (run, eval, logs, timeout, interfaces, prompt
+ * template) are preserved.
  */
 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 = {}) {
+export async function runCodeFile(filePath, options = {}, context) {
     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);
+        const data = options.includeLogs ? result : result.result;
+        return { kind: "data", data };
     }
     finally {
         await codeClient.close().catch(() => { });
-        restoreConsole();
     }
 }
-export async function evalCode(code, options = {}) {
-    silenceConsole();
+export async function evalCode(code, options = {}, context) {
     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);
+        const data = options.includeLogs ? result : result.result;
+        return { kind: "data", data };
     }
     finally {
         await codeClient.close().catch(() => { });
-        restoreConsole();
     }
 }
-export async function printInterfaces() {
-    silenceConsole();
+export async function printInterfaces(context) {
     const codeClient = new ZaiCodeModeClient();
     try {
         const interfaces = await codeClient.getAllInterfaces();
-        outputSuccess(interfaces);
-    }
-    catch (error) {
-        restoreConsole();
-        console.error(formatErrorOutput(error));
-        process.exit(1);
+        return { kind: "data", data: interfaces };
     }
     finally {
         await codeClient.close().catch(() => { });
-        restoreConsole();
     }
 }
-export function printPromptTemplate() {
-    outputSuccess(ZaiCodeModeClient.getPromptTemplate());
+export function printPromptTemplate(context) {
+    return { kind: "data", data: ZaiCodeModeClient.getPromptTemplate() };
 }
 // Help text
 export const CODE_HELP = `

package/dist/commands/code.js.map

@@ -1 +1 @@
-{"version":3,"file":"code.js","sourceRoot":"","sources":["../../src/commands/code.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"code.js","sourceRoot":"","sources":["../../src/commands/code.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAQxD,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAgB,EAChB,OAAO,GAAmB,EAAE,EAC5B,OAAwB;IAExB,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAEjD,MAAM,UAAU,GAAG,IAAI,iBAAiB,EAAE,CAAC;IAC3C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACrE,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;QAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAChC,CAAC;YAAS,CAAC;QACT,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,IAAY,EACZ,OAAO,GAAmB,EAAE,EAC5B,OAAwB;IAExB,MAAM,UAAU,GAAG,IAAI,iBAAiB,EAAE,CAAC;IAC3C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACrE,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;QAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAChC,CAAC;YAAS,CAAC;QACT,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAwB;IAExB,MAAM,UAAU,GAAG,IAAI,iBAAiB,EAAE,CAAC;IAC3C,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,gBAAgB,EAAE,CAAC;QACvD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAC5C,CAAC;YAAS,CAAC;QACT,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAwB;IAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,CAAC,iBAAiB,EAAE,EAAE,CAAC;AACvE,CAAC;AAED,YAAY;AACZ,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;CAkBxB,CAAC,IAAI,EAAE,CAAC"}

package/dist/commands/doctor.d.ts

@@ -1,10 +1,76 @@
 /**
- * Doctor command for environment and MCP diagnostics
+ * Doctor command — Provider-aware diagnostics (P4-04, DESIGN.md §14).
+ *
+ * The command is presentation-only: it receives a report builder through
+ * injected dependencies and wraps the resulting {@link DiagnosticsReport}
+ * as base data with a computed exit code. Provider resolution, capability
+ * probing, settled collection, and failure redaction live in
+ * {@link buildDiagnosticsReport} so the command never imports a Provider
+ * transport (ZaiMcpClient, monitor client, or environment credential
+ * reads) directly.
+ *
+ * Exit semantics (DESIGN.md §14):
+ *   - Missing effective Provider credentials -> exit 1.
+ *   - Any configured probe error -> exit 1 (successful entries preserved).
+ *   - All configured probes succeed, or only tools-disabled skips -> exit 0.
+ *
+ * Under `--no-tools` the command returns after metadata + configured-state
+ * evaluation and constructs no Adapter and no transport (FR-034).
  */
+import type { CommandResult } from "../command-invocation.js";
+import type { DiagnosticsReport } from "../capabilities/diagnostics.js";
+import type { ProviderDescriptor, ProviderId } from "../providers/types.js";
+export interface DoctorDiagnosticsDependencies {
+    readonly noTools: boolean;
+    readonly effectiveProvider: ProviderId;
+    readonly descriptors: readonly ProviderDescriptor[];
+    readonly env: NodeJS.ProcessEnv;
+    readonly sleep: (ms: number) => Promise<void>;
+    readonly random: () => number;
+    /**
+     * Pre-formatted one-line cache summary (Cache Module Unification
+     * Ticket 03). The dispatcher formats this from `cacheStats()` output
+     * before invoking the report builder; the report builder only embeds
+     * it. Optional for backward compatibility with existing tests that
+     * don't cover the cache surface. When omitted, the returned report
+     * simply leaves out the `cache` field.
+     */
+    readonly cacheSummary?: string;
+}
+/**
+ * Build a schema-version-1 {@link DiagnosticsReport}. Inventory
+ * (`sharedCapabilities`, `zaiOnlyCapabilities`) is derived purely from
+ * `deps.descriptors` — no descriptor.create(), no transport, no
+ * production registry import. Under `--no-tools` the command returns
+ * after metadata + configured-state evaluation. Otherwise each
+ * configured Provider is probed through shared execution with settled
+ * collection, preserving registry order and normalized redacted
+ * failures.
+ */
+export declare function buildDiagnosticsReport(deps: DoctorDiagnosticsDependencies): Promise<DiagnosticsReport>;
+/**
+ * Compute the doctor exit code from a finalized report. Exit 1 when the
+ * effective Provider is unconfigured or any configured probe errored;
+ * otherwise exit 0. A tools-disabled or not-configured skip on a
+ * non-effective Provider never fails the report.
+ */
+export declare function doctorExitCode(report: DiagnosticsReport): number;
 export interface DoctorOptions {
     noTools?: boolean;
-    enableVision?: boolean;
 }
-export declare function doctor(options?: DoctorOptions): Promise<void>;
+/**
+ * Injectable dependencies for the doctor command. `buildReport` resolves
+ * the diagnostics report; the command only wraps it for presentation and
+ * exit-code selection.
+ */
+export interface DoctorCommandDependencies {
+    readonly buildReport: () => Promise<DiagnosticsReport>;
+}
+/**
+ * Run the doctor command. Returns the diagnostics report as base data
+ * with a computed exit code (1 when the effective Provider is
+ * unconfigured or any configured probe failed; otherwise 0).
+ */
+export declare function doctor(deps: DoctorCommandDependencies): Promise<CommandResult<DiagnosticsReport>>;
 export declare const DOCTOR_HELP: string;
 //# sourceMappingURL=doctor.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAEV,iBAAiB,EAElB,MAAM,gCAAgC,CAAC;AASxC,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAsB,MAAM,uBAAuB,CAAC;AAMhG,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,EAAE,UAAU,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACpD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,MAAM,CAAC;IAC9B;;;;;;;OAOG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AA6CD;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,6BAA6B,GAClC,OAAO,CAAC,iBAAiB,CAAC,CAkC5B;AA4CD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAKhE;AAMD,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACxD;AAED;;;;GAIG;AACH,wBAAsB,MAAM,CAC1B,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,aAAa,CAAC,iBAAiB,CAAC,CAAC,CAO3C;AAED,eAAO,MAAM,WAAW,QAuDhB,CAAC"}