@snutils/snu 0.1.0

package/dist/cli/index.js

@@ -0,0 +1,296 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERSION = void 0;
+exports.printHelp = printHelp;
+exports.runCli = runCli;
+const util_1 = require("util");
+const registry_js_1 = require("../registry.js");
+const client_js_1 = require("../client.js");
+const stdin_js_1 = require("./stdin.js");
+const format_js_1 = require("./format.js");
+const index_js_1 = require("../mcp/index.js");
+const standalone_js_1 = require("../server/standalone.js");
+exports.VERSION = '0.1.0';
+function printHelp() {
+    console.log(`
+\x1b[1mSN Utils CLI (snu)\x1b[0m — Unified CLI and MCP Bridge for ServiceNow
+
+\x1b[1mUSAGE:\x1b[0m
+  snu <command> [arguments...] [options...]
+  snu --mcp                           Start Model Context Protocol (MCP) server on stdio
+  snu serve [--port <p>] [--ws <p>]   Start persistent standalone bridge daemon
+
+\x1b[1mCORE COMMANDS:\x1b[0m
+  context                             Show active connection, helper tab, and instance roster
+  search <term>                       Fast GraphQL code search across script tables (Pro)
+  schema <table>                      Inspect table columns, types, references, and choices
+  query <table> [query]               Query records with encoded query and field projections
+  run [script]                        Execute server-side Background Script and capture output
+
+\x1b[1mRECORD & ARTIFACT COMMANDS:\x1b[0m
+  record get <table> <sys_id>         Fetch a record by sys_id
+  record update <table> <sys_id> <f>  Update a record field (--value <v>, --file <p>, or stdin)
+  record delete <table> <sys_id>      Delete a record (--confirm or --dry-run)
+  artifact create <table> <name>      Create a scriptable artifact (Script Include, etc.)
+
+\x1b[1mBROWSER COMMANDS:\x1b[0m
+  browser form                        Read live form table, sys_id, and fields via g_form
+  browser set <field> <value>         Set live form field value via g_form.setValue
+  browser action <action>             Trigger form UI action (e.g. save, sysverb_update)
+  browser nav <url>                   Navigate connected tab to URL and wait for load
+  screenshot                          Capture viewport screenshot of active tab
+
+\x1b[1mGLOBAL OPTIONS:\x1b[0m
+  -j, --json                          Output strict JSON on stdout for scripting/agents
+  -i, --instance <name>               Target specific instance folder
+  --port-file <path>                  Explicit path to sn-agent-port.json
+  -h, --help                          Show help
+  -v, --version                       Show version
+`);
+}
+async function runCli(argv = process.argv.slice(2)) {
+    // Check for MCP server trigger first
+    if (argv.includes('--mcp')) {
+        await (0, index_js_1.startMcpServer)();
+        return;
+    }
+    if (argv.includes('-h') || argv.includes('--help') || argv.length === 0) {
+        printHelp();
+        return;
+    }
+    if (argv.includes('-v') || argv.includes('--version')) {
+        console.log(`snu v${exports.VERSION}`);
+        return;
+    }
+    let isJsonMode = argv.includes('-j') || argv.includes('--json');
+    let instance;
+    let portFile;
+    // Extract global options and identify the command tokens
+    const nonGlobalTokens = [];
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === '-j' || arg === '--json') {
+            isJsonMode = true;
+        }
+        else if (arg === '-i' || arg === '--instance') {
+            instance = argv[++i];
+        }
+        else if (arg.startsWith('--instance=')) {
+            instance = arg.slice('--instance='.length);
+        }
+        else if (arg === '--port-file') {
+            portFile = argv[++i];
+        }
+        else if (arg.startsWith('--port-file=')) {
+            portFile = arg.slice('--port-file='.length);
+        }
+        else {
+            nonGlobalTokens.push(arg);
+        }
+    }
+    if (nonGlobalTokens.length === 0) {
+        printHelp();
+        return;
+    }
+    // Handle standalone daemon command: snu serve
+    if (nonGlobalTokens[0] === 'serve') {
+        const standalone = new standalone_js_1.StandaloneBridge({
+            cwd: process.cwd(),
+            onYield: () => {
+                console.log('\n[snu] VS Code requested port handover. Standalone bridge yielded ports.');
+                process.exit(0);
+            },
+        });
+        try {
+            const { httpPort, wsPort } = await standalone.start();
+            console.log(`\n\x1b[1m\x1b[32m[snu] Standalone Bridge Active\x1b[0m`);
+            console.log(`  • HTTP API:    http://127.0.0.1:${httpPort}/api`);
+            console.log(`  • WebSocket:   ws://127.0.0.1:${wsPort} (connect via SN Utils helper tab)`);
+            console.log(`\n\x1b[90mRunning standalone. Press Ctrl+C to stop.\x1b[0m\n`);
+        }
+        catch (err) {
+            (0, format_js_1.outputError)(err, false);
+            process.exit(1);
+        }
+        return;
+    }
+    try {
+        // 1. Check for 2-word command matches (e.g. "record get", "artifact create", "browser form")
+        let tool = nonGlobalTokens.length >= 2 ? (0, registry_js_1.getToolByCliCommand)(`${nonGlobalTokens[0]} ${nonGlobalTokens[1]}`) : undefined;
+        let commandArgOffset = tool ? 2 : 1;
+        // 2. If not matched, check 1-word command matches (e.g. "search", "query", "schema", "context")
+        if (!tool) {
+            tool = (0, registry_js_1.getToolByCliCommand)(nonGlobalTokens[0]);
+        }
+        if (!tool) {
+            throw new client_js_1.ScriptSyncClientError(`Unknown command: ${nonGlobalTokens.join(' ')}. Run 'snu --help' for usage.`, 'E_UNKNOWN_COMMAND');
+        }
+        const commandArgs = nonGlobalTokens.slice(commandArgOffset);
+        // Prepare parseArgs options schema from tool definition
+        const optionsConfig = {
+            json: { type: 'boolean', short: 'j' },
+            instance: { type: 'string', short: 'i' },
+            'port-file': { type: 'string' },
+        };
+        if (tool.cliOptions) {
+            for (const [optName, optDef] of Object.entries(tool.cliOptions)) {
+                optionsConfig[optName] = {
+                    type: optDef.type,
+                    short: optDef.short,
+                };
+            }
+        }
+        const parsed = (0, util_1.parseArgs)({
+            args: commandArgs,
+            options: optionsConfig,
+            allowPositionals: true,
+            strict: false,
+        });
+        const positionals = parsed.positionals;
+        const values = parsed.values;
+        const inputData = {
+            instance: instance || values.instance,
+            ...values,
+        };
+        // Subcommand-specific positional argument mapping & validation
+        switch (tool.cliCommand) {
+            case 'context':
+                break;
+            case 'search':
+                if (!positionals[0])
+                    throw new client_js_1.ScriptSyncClientError('Missing required search term: snu search <term>', 'E_INVALID_PARAMS');
+                inputData.term = positionals.join(' ');
+                break;
+            case 'schema':
+                if (!positionals[0])
+                    throw new client_js_1.ScriptSyncClientError('Missing required table: snu schema <table>', 'E_INVALID_PARAMS');
+                inputData.table = positionals[0];
+                break;
+            case 'query':
+                if (!positionals[0])
+                    throw new client_js_1.ScriptSyncClientError('Missing required table: snu query <table> [query]', 'E_INVALID_PARAMS');
+                inputData.table = positionals[0];
+                inputData.query = positionals.slice(1).join(' ') || values.query;
+                break;
+            case 'record get':
+                if (!positionals[0] || !positionals[1]) {
+                    throw new client_js_1.ScriptSyncClientError('Usage: snu record get <table> <sys_id>', 'E_INVALID_PARAMS');
+                }
+                inputData.table = positionals[0];
+                inputData.sys_id = positionals[1];
+                break;
+            case 'artifact create':
+                if (!positionals[0] || !positionals[1]) {
+                    throw new client_js_1.ScriptSyncClientError('Usage: snu artifact create <table> <name>', 'E_INVALID_PARAMS');
+                }
+                inputData.table = positionals[0];
+                inputData.name = positionals[1];
+                break;
+            case 'record update':
+                if (positionals.length < 2) {
+                    throw new client_js_1.ScriptSyncClientError('Usage: snu record update <table> <sys_id> <field> (--value <v> | --file <path> | stdin)', 'E_INVALID_PARAMS');
+                }
+                inputData.table = positionals[0];
+                inputData.sys_id = positionals[1];
+                // If 3rd positional is given (e.g. "short_description" or "short_description=foo")
+                if (positionals[2]) {
+                    const rawFieldToken = positionals[2];
+                    if (rawFieldToken.includes('=') && values.value === undefined && values.file === undefined) {
+                        const eqIdx = rawFieldToken.indexOf('=');
+                        inputData.field = rawFieldToken.slice(0, eqIdx);
+                        inputData.content = rawFieldToken.slice(eqIdx + 1);
+                    }
+                    else {
+                        inputData.field = rawFieldToken;
+                    }
+                }
+                if (inputData.content === undefined) {
+                    inputData.content = await (0, stdin_js_1.resolveContentInput)({
+                        value: values.value,
+                        filePath: values.file,
+                    });
+                }
+                if (!inputData.field) {
+                    throw new client_js_1.ScriptSyncClientError('Missing field name to update', 'E_INVALID_PARAMS');
+                }
+                if (inputData.content === undefined) {
+                    throw new client_js_1.ScriptSyncClientError('Missing new field content: provide --value <v>, --file <path>, or pipe via stdin', 'E_INVALID_PARAMS');
+                }
+                break;
+            case 'record delete':
+                if (!positionals[0] || !positionals[1]) {
+                    throw new client_js_1.ScriptSyncClientError('Usage: snu record delete <table> <sys_id> [--confirm] [--dry-run]', 'E_INVALID_PARAMS');
+                }
+                inputData.table = positionals[0];
+                inputData.sys_id = positionals[1];
+                break;
+            case 'run':
+                const positionalScript = positionals.length > 0 ? positionals.join(' ') : undefined;
+                inputData.script = await (0, stdin_js_1.resolveContentInput)({
+                    value: positionalScript,
+                    filePath: values.file,
+                });
+                if (!inputData.script) {
+                    throw new client_js_1.ScriptSyncClientError('Usage: snu run [script] [--file <path>] or pipe via stdin', 'E_INVALID_PARAMS');
+                }
+                break;
+            case 'browser form':
+                if (values.fields) {
+                    inputData.fields = String(values.fields).split(',').map((f) => f.trim()).filter(Boolean);
+                }
+                break;
+            case 'browser set':
+                if (!positionals[0] || positionals[1] === undefined) {
+                    throw new client_js_1.ScriptSyncClientError('Usage: snu browser set <field> <value>', 'E_INVALID_PARAMS');
+                }
+                inputData.field = positionals[0];
+                inputData.value = positionals.slice(1).join(' ');
+                break;
+            case 'browser action':
+                if (!positionals[0]) {
+                    throw new client_js_1.ScriptSyncClientError('Usage: snu browser action <action>', 'E_INVALID_PARAMS');
+                }
+                inputData.uiAction = positionals[0];
+                break;
+            case 'browser nav':
+                if (!positionals[0]) {
+                    throw new client_js_1.ScriptSyncClientError('Usage: snu browser nav <url>', 'E_INVALID_PARAMS');
+                }
+                inputData.url = positionals[0];
+                break;
+            case 'screenshot':
+                if (values.url)
+                    inputData.url = values.url;
+                if (values.tab)
+                    inputData.tabId = parseInt(String(values.tab), 10);
+                if (!inputData.url && inputData.tabId === undefined) {
+                    // If neither provided, default to matching ServiceNow tab
+                    inputData.url = 'https://*.service-now.com/*';
+                }
+                break;
+        }
+        // Execute through Client
+        const client = new client_js_1.ScriptSyncClient({ portFile, cwd: process.cwd() });
+        let result;
+        if (tool.agentCommand === 'get_context') {
+            result = await client.getContext(inputData.instance);
+        }
+        else {
+            const mapped = tool.mapInput(inputData);
+            const resp = await client.execute(mapped);
+            result = resp.result;
+        }
+        // Output Result
+        if (isJsonMode) {
+            (0, format_js_1.outputJson)(result);
+        }
+        else {
+            process.stdout.write((0, format_js_1.formatHumanOutput)(tool.agentCommand, result));
+        }
+    }
+    catch (err) {
+        (0, format_js_1.outputError)(err, isJsonMode);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/cli/stdin.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Read all text from process.stdin asynchronously.
+ */
+export declare function readStdin(): Promise<string>;
+/**
+ * Resolve content from either direct string, local file path, or stdin.
+ * Strictly rejects conflicting sources (e.g. both value and file provided).
+ */
+export declare function resolveContentInput(options: {
+    value?: string;
+    filePath?: string;
+    allowStdin?: boolean;
+}): Promise<string | undefined>;
+//# sourceMappingURL=stdin.d.ts.map

package/dist/cli/stdin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdin.d.ts","sourceRoot":"","sources":["../../src/cli/stdin.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAOjD;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAwB9B"}

package/dist/cli/stdin.js

@@ -0,0 +1,75 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readStdin = readStdin;
+exports.resolveContentInput = resolveContentInput;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Read all text from process.stdin asynchronously.
+ */
+async function readStdin() {
+    const chunks = [];
+    return new Promise((resolve, reject) => {
+        process.stdin.on('data', (chunk) => chunks.push(Buffer.from(chunk)));
+        process.stdin.on('end', () => resolve(Buffer.concat(chunks).toString('utf8')));
+        process.stdin.on('error', reject);
+    });
+}
+/**
+ * Resolve content from either direct string, local file path, or stdin.
+ * Strictly rejects conflicting sources (e.g. both value and file provided).
+ */
+async function resolveContentInput(options) {
+    const { value, filePath, allowStdin = true } = options;
+    if (value !== undefined && filePath !== undefined) {
+        throw new Error('Conflicting arguments: provide either a direct value or --file <path>, not both.');
+    }
+    if (value !== undefined) {
+        return value;
+    }
+    if (filePath !== undefined) {
+        const resolved = path.resolve(process.cwd(), filePath);
+        if (!fs.existsSync(resolved)) {
+            throw new Error(`File not found: ${resolved}`);
+        }
+        return fs.readFileSync(resolved, 'utf8');
+    }
+    if (allowStdin && !process.stdin.isTTY) {
+        return await readStdin();
+    }
+    return undefined;
+}
+//# sourceMappingURL=stdin.js.map

package/dist/cli/stdin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdin.js","sourceRoot":"","sources":["../../src/cli/stdin.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMA,8BAOC;AAMD,kDA4BC;AA/CD,uCAAyB;AACzB,2CAA6B;AAE7B;;GAEG;AACI,KAAK,UAAU,SAAS;IAC7B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACrE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC/E,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,mBAAmB,CAAC,OAIzC;IACC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAEvD,IAAI,KAAK,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,kFAAkF,CAAC,CAAC;IACtG,CAAC;IAED,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;QACvD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,UAAU,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACvC,OAAO,MAAM,SAAS,EAAE,CAAC;IAC3B,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,43 @@
+import { AgentResponse, DiscoveryOptions, DiscoveryResult, HealthResponse, MappedCommand } from './types.js';
+export declare const MIN_API_VERSION = 7;
+export declare const DEFAULT_COMMAND_TIMEOUT_MS = 70000;
+export declare const REVIEWED_COMMAND_TIMEOUT_MS = 310000;
+export declare const HEALTH_CHECK_TIMEOUT_MS = 1500;
+export declare class ScriptSyncClientError extends Error {
+    code?: string | undefined;
+    status?: number | undefined;
+    details?: any | undefined;
+    constructor(message: string, code?: string | undefined, status?: number | undefined, details?: any | undefined);
+}
+/**
+ * Global port file path (~/.sn-scriptsync/agent-port.json).
+ * Written when a Pro/Trial/Enterprise license is connected in the browser.
+ */
+export declare function getGlobalPortFilePath(): string;
+/**
+ * Walk up directory tree from startDir looking for .vscode/sn-agent-port.json.
+ */
+export declare function findWorkspacePortFile(startDir: string): string | undefined;
+/**
+ * Discover the active ScriptSync bridge port and token using deterministic precedence.
+ */
+export declare function discoverBridge(options?: DiscoveryOptions): Promise<DiscoveryResult>;
+/**
+ * Probe GET /api/health with a short timeout.
+ */
+export declare function checkHealth(port: number, expectedPid?: number): Promise<HealthResponse>;
+/**
+ * ScriptSync Client for sending typed commands to the bridge.
+ */
+export declare class ScriptSyncClient {
+    private options?;
+    private discoveryResult?;
+    constructor(options?: DiscoveryOptions | undefined);
+    getDiscovery(): Promise<DiscoveryResult>;
+    execute<T = any>(mapped: MappedCommand, timeoutMs?: number): Promise<AgentResponse<T>>;
+    /**
+     * Composite context fetcher for `snu context` / `snu_get_context`
+     */
+    getContext(instance?: string): Promise<Record<string, any>>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,aAAa,EAEb,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,aAAa,EACd,MAAM,YAAY,CAAC;AAGpB,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,0BAA0B,QAAS,CAAC;AACjD,eAAO,MAAM,2BAA2B,SAAU,CAAC;AACnD,eAAO,MAAM,uBAAuB,OAAQ,CAAC;AAE7C,qBAAa,qBAAsB,SAAQ,KAAK;IAGrC,IAAI,CAAC,EAAE,MAAM;IACb,MAAM,CAAC,EAAE,MAAM;IACf,OAAO,CAAC,EAAE,GAAG;gBAHpB,OAAO,EAAE,MAAM,EACR,IAAI,CAAC,EAAE,MAAM,YAAA,EACb,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,OAAO,CAAC,EAAE,GAAG,YAAA;CAKvB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAc1E;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CA+C7F;AAiDD;;GAEG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAoC7F;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAGf,OAAO,CAAC,OAAO,CAAC;IAF5B,OAAO,CAAC,eAAe,CAAC,CAAkB;gBAEtB,OAAO,CAAC,EAAE,gBAAgB,YAAA;IAExC,YAAY,IAAI,OAAO,CAAC,eAAe,CAAC;IAOxC,OAAO,CAAC,CAAC,GAAG,GAAG,EACnB,MAAM,EAAE,aAAa,EACrB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAsF5B;;OAEG;IACG,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CA2DlE"}