@vinhnt-sdk/tools 1.0.0

package/dist/sandbox.js

@@ -0,0 +1,409 @@
+/**
+ * Tool sandboxing for isolated execution.
+ *
+ * @module tool/sandbox
+ * @packageDocumentation
+ */
+import { parseCommand } from "./shell-parser.js";
+// ---------------------------------------------------------------------------
+// Environment sanitization
+// ---------------------------------------------------------------------------
+const SENSITIVE_ENV_PREFIXES = [
+    "AWS_",
+    "GOOGLE_",
+    "AZURE_",
+    "GITHUB_",
+    "GITLAB_",
+    "npm_",
+    "NODE_",
+];
+const SENSITIVE_ENV_KEYS = new Set([
+    "HOME",
+    "USER",
+    "USERNAME",
+    "PASSWORD",
+    "SECRET",
+    "TOKEN",
+    "API_KEY",
+    "APIKEY",
+    "PRIVATE_KEY",
+    "DATABASE_URL",
+    "DB_URL",
+    "REDIS_URL",
+]);
+function sanitizeEnv() {
+    const safe = {};
+    for (const [key, value] of Object.entries(process.env)) {
+        const upperKey = key.toUpperCase();
+        const isSensitive = SENSITIVE_ENV_PREFIXES.some((p) => upperKey.startsWith(p)) ||
+            SENSITIVE_ENV_KEYS.has(upperKey);
+        if (!isSensitive) {
+            safe[key] = value;
+        }
+    }
+    return safe;
+}
+/**
+ * Create an empty environment with only explicitly allowed variables.
+ * This is the secure default for process isolation.
+ */
+function createEmptyEnv(allowedVars) {
+    const env = {};
+    if (allowedVars) {
+        for (const key of allowedVars) {
+            const value = process.env[key];
+            if (value !== undefined) {
+                env[key] = value;
+            }
+        }
+    }
+    return env;
+}
+// ---------------------------------------------------------------------------
+// Command allowlisting
+// ---------------------------------------------------------------------------
+/** Default allowed commands for process isolation */
+const DEFAULT_ALLOWED_COMMANDS = new Set([
+    "node",
+    "npm",
+    "npx",
+    "pnpm",
+    "git",
+    "ls",
+    "cat",
+    "grep",
+    "find",
+    "head",
+    "tail",
+    "wc",
+    "sort",
+    "uniq",
+    "diff",
+    "echo",
+    "pwd",
+    "whoami",
+    "date",
+]);
+/** Blocked command patterns (security) */
+const BLOCKED_COMMAND_PATTERNS = [
+    /\brm\s+-rf\s+\/[^a-z]/i, // rm -rf / (not /something)
+    /\bmkfs\b/i,
+    /\bdd\b.*of=\/dev/i,
+    /\bformat\b/i,
+    /\bshutdown\b/i,
+    /\breboot\b/i,
+    /\bkill\s+-9\s+1\b/i, // kill PID 1
+    /\bcurl\b.*\|\s*sh/i, // curl | sh
+    /\bwget\b.*\|\s*sh/i, // wget | sh
+];
+/**
+ * Check if a command is allowed in the sandbox.
+ */
+function isCommandAllowed(command, allowedCommands) {
+    const parsed = parseCommand(command);
+    const baseCommand = parsed.file.split("/").pop()?.split("\\").pop() ?? parsed.file;
+    // Check blocked patterns first
+    for (const pattern of BLOCKED_COMMAND_PATTERNS) {
+        if (pattern.test(command)) {
+            return false;
+        }
+    }
+    // Check allowlist
+    const allowlist = allowedCommands ?? DEFAULT_ALLOWED_COMMANDS;
+    return allowlist.has(baseCommand);
+}
+/**
+ * Default sandbox scopes — exported for convenience.
+ * User có thể register custom scope qua ProcessSandbox adapter.
+ */
+export const KNOWN_SANDBOX_SCOPES = ["host", "process", "container"];
+// ---------------------------------------------------------------------------
+// Host sandbox (no isolation — current behavior)
+// ---------------------------------------------------------------------------
+import { execFile } from "node:child_process";
+class HostSandbox {
+    scope = "host";
+    async execute(options) {
+        const start = Date.now();
+        return new Promise((resolve) => {
+            const parsed = parseCommand(options.command);
+            const child = execFile(parsed.file, parsed.args, {
+                cwd: options.cwd,
+                timeout: options.timeoutMs,
+                maxBuffer: 10 * 1024 * 1024,
+                encoding: "utf-8",
+                windowsHide: true,
+                env: options.env && Object.keys(options.env).length > 0
+                    ? { ...sanitizeEnv(), ...options.env }
+                    : undefined,
+            }, (err, stdout, stderr) => {
+                const durationMs = Date.now() - start;
+                if (err) {
+                    const exitCode = typeof err.code === "number" ? err.code : 1;
+                    const timedOut = err.killed === true;
+                    resolve({
+                        result: { stdout: stdout ?? "", stderr: stderr ?? "", exitCode },
+                        exitCode,
+                        durationMs,
+                        timedOut,
+                    });
+                }
+                else {
+                    resolve({
+                        result: { stdout: stdout ?? "", stderr: stderr ?? "", exitCode: 0 },
+                        exitCode: 0,
+                        durationMs,
+                        timedOut: false,
+                    });
+                }
+            });
+            if (options.signal) {
+                if (options.signal.aborted) {
+                    child.kill();
+                    resolve({
+                        result: { stdout: "", stderr: "Aborted", exitCode: 1 },
+                        exitCode: 1,
+                        durationMs: Date.now() - start,
+                        timedOut: false,
+                    });
+                    return;
+                }
+                options.signal.addEventListener("abort", () => {
+                    child.kill();
+                    resolve({
+                        result: { stdout: "", stderr: options.signal?.reason ?? "Aborted", exitCode: 1 },
+                        exitCode: 1,
+                        durationMs: Date.now() - start,
+                        timedOut: false,
+                    });
+                }, { once: true });
+            }
+        });
+    }
+    async destroy() {
+        // No resources to clean up
+    }
+}
+// ---------------------------------------------------------------------------
+// Process sandbox (Node.js Permission Model + command allowlist)
+// ---------------------------------------------------------------------------
+class ProcessSandboxImpl {
+    scope = "process";
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async execute(options) {
+        const start = Date.now();
+        // Validate command against allowlist
+        if (!isCommandAllowed(options.command, this.config.allowedCommands)) {
+            return {
+                result: {
+                    stdout: "",
+                    stderr: `Command not allowed: ${options.command.split(" ")[0]}`,
+                    exitCode: 126,
+                },
+                exitCode: 126,
+                durationMs: Date.now() - start,
+                timedOut: false,
+            };
+        }
+        // Create secure environment (empty by default, only explicitly allowed vars)
+        const secureEnv = this.config.allowedEnvVars
+            ? createEmptyEnv(this.config.allowedEnvVars)
+            : createEmptyEnv();
+        // Parse the command
+        const parsed = parseCommand(options.command);
+        // Build exec args with security options
+        const execArgs = [];
+        // Add Node.js Permission Model flags if enabled (Node 22+)
+        if (this.config.enablePermissionModel && parsed.file === "node") {
+            execArgs.push("--permission");
+            // Allow read-only access to current directory
+            execArgs.push(`--allow-fs-read=${options.cwd}`);
+            // Allow read-write to temp directory
+            execArgs.push("--allow-fs-read=/tmp");
+            execArgs.push("--allow-fs-write=/tmp");
+            // Block all other access by default
+        }
+        // Add resource limits
+        const maxBuffer = 10 * 1024 * 1024; // 10MB
+        return new Promise((resolve) => {
+            const child = execFile(parsed.file, [...execArgs, ...parsed.args], {
+                cwd: options.cwd,
+                timeout: options.timeoutMs,
+                maxBuffer,
+                encoding: "utf-8",
+                windowsHide: true,
+                env: secureEnv,
+                // Security options
+                ...(process.platform !== "win32" ? {
+                    // On Linux/macOS, use additional security
+                    uid: process.getuid?.(),
+                    gid: process.getgid?.(),
+                } : {}),
+            }, (err, stdout, stderr) => {
+                const durationMs = Date.now() - start;
+                if (err) {
+                    const exitCode = typeof err.code === "number" ? err.code : 1;
+                    const timedOut = err.killed === true;
+                    resolve({
+                        result: { stdout: stdout ?? "", stderr: stderr ?? "", exitCode },
+                        exitCode,
+                        durationMs,
+                        timedOut,
+                    });
+                }
+                else {
+                    resolve({
+                        result: { stdout: stdout ?? "", stderr: stderr ?? "", exitCode: 0 },
+                        exitCode: 0,
+                        durationMs,
+                        timedOut: false,
+                    });
+                }
+            });
+            if (options.signal) {
+                if (options.signal.aborted) {
+                    child.kill();
+                    resolve({
+                        result: { stdout: "", stderr: "Aborted", exitCode: 1 },
+                        exitCode: 1,
+                        durationMs: Date.now() - start,
+                        timedOut: false,
+                    });
+                    return;
+                }
+                options.signal.addEventListener("abort", () => {
+                    child.kill();
+                    resolve({
+                        result: { stdout: "", stderr: options.signal?.reason ?? "Aborted", exitCode: 1 },
+                        exitCode: 1,
+                        durationMs: Date.now() - start,
+                        timedOut: false,
+                    });
+                }, { once: true });
+            }
+        });
+    }
+    async destroy() {
+        // Clean up resources if any
+    }
+}
+// ---------------------------------------------------------------------------
+// Container sandbox (placeholder for future implementation)
+// ---------------------------------------------------------------------------
+class ContainerSandboxImpl {
+    scope = "container";
+    async execute(options) {
+        // Container sandbox would use Docker, bubblewrap, or similar
+        // For now, fall back to process sandbox with a warning
+        console.warn("[sandbox] Container sandbox not yet implemented, using process sandbox");
+        const processSandbox = new ProcessSandboxImpl({
+            defaultTimeoutMs: options.timeoutMs,
+            scope: "process",
+        });
+        return processSandbox.execute(options);
+    }
+    async destroy() {
+        // Clean up container resources if any
+    }
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Create a process sandbox based on the configured scope.
+ *
+ * @param config - Sandbox configuration
+ * @returns ProcessSandbox instance
+ */
+export function createSandbox(config) {
+    switch (config.scope) {
+        case "process":
+            return new ProcessSandboxImpl(config);
+        case "container":
+            return new ContainerSandboxImpl();
+        case "host":
+        default:
+            return new HostSandbox();
+    }
+}
+// ---------------------------------------------------------------------------
+// Legacy API (backward compatible)
+// ---------------------------------------------------------------------------
+/** Create a minimal ToolContext from an AbortSignal (for backward compat) */
+export function signalToToolContext(signal) {
+    const ctrl = signal ? new AbortController() : new AbortController();
+    if (signal) {
+        signal.addEventListener("abort", () => ctrl.abort(signal.reason), { once: true });
+    }
+    return {
+        sessionId: "",
+        runId: "",
+        agentId: "",
+        agentName: "",
+        signal: ctrl.signal,
+        env: {},
+        ask: async () => "once",
+        metadata: () => { },
+        setCompensation: () => { },
+    };
+}
+export class ToolSandbox {
+    config;
+    constructor(config = { defaultTimeoutMs: 30_000 }) {
+        this.config = config;
+    }
+    async execute(tool, input, ctx) {
+        const timeout = new AbortController();
+        const timer = setTimeout(() => timeout.abort(), this.config.defaultTimeoutMs);
+        const combinedSignal = combineSignals(ctx.signal, timeout.signal);
+        const augmentedCtx = { ...ctx, signal: combinedSignal };
+        try {
+            const result = await raceAbort(tool.execute(input, augmentedCtx), combinedSignal);
+            return result;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function raceAbort(promise, signal) {
+    if (signal.aborted) {
+        return Promise.reject(new DOMException(signal.reason ?? "Aborted", "AbortError"));
+    }
+    return new Promise((resolve, reject) => {
+        const onAbort = () => {
+            reject(new DOMException(signal.reason ?? "Timed out", "AbortError"));
+        };
+        signal.addEventListener("abort", onAbort, { once: true });
+        promise.then((val) => {
+            signal.removeEventListener("abort", onAbort);
+            resolve(val);
+        }, (err) => {
+            signal.removeEventListener("abort", onAbort);
+            reject(err);
+        });
+    });
+}
+function combineSignals(...signals) {
+    const valid = signals.filter((s) => s !== undefined);
+    if (valid.length === 0)
+        return new AbortController().signal;
+    if (valid.length === 1)
+        return valid[0];
+    const controller = new AbortController();
+    for (const s of valid) {
+        if (s.aborted) {
+            controller.abort(s.reason);
+            return controller.signal;
+        }
+        s.addEventListener("abort", () => controller.abort(s.reason), { once: true });
+    }
+    return controller.signal;
+}
+//# sourceMappingURL=sandbox.js.map

package/dist/sandbox.js.map

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

package/dist/search-tools.d.ts

@@ -0,0 +1,11 @@
+import type { ToolDefinition } from "./definitions.js";
+type RootGetter = string | (() => string);
+/**
+ * Default ignored directories for search — convenience only.
+ * User tự extend: `config.ignoredDirs = [...DEFAULT_IGNORED_DIRS, "my-dir"]`
+ */
+export declare const DEFAULT_IGNORED_DIRS: string[];
+export declare function createGlobFilesTool(workspaceRoot: RootGetter, ignoredDirs?: string[]): ToolDefinition;
+export declare function createGrepFilesTool(workspaceRoot: RootGetter, ignoredDirs?: string[]): ToolDefinition;
+export {};
+//# sourceMappingURL=search-tools.d.ts.map

package/dist/search-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-tools.d.ts","sourceRoot":"","sources":["../src/search-tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAcvD,KAAK,UAAU,GAAG,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;AAM1C;;;GAGG;AACH,eAAO,MAAM,oBAAoB,UAA6E,CAAC;AAiB/G,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,UAAU,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,cAAc,CAuBrG;AAED,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,UAAU,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,cAAc,CA6DrG"}

package/dist/search-tools.js

@@ -0,0 +1,124 @@
+import { readdir, readFile, stat } from "node:fs/promises";
+import { join, relative } from "node:path";
+import { z } from "zod";
+import { defineTool } from "./define-tool.js";
+const GlobFilesSchema = z.object({
+    pattern: z.string().min(1),
+    maxResults: z.number().positive().optional(),
+});
+const GrepFilesSchema = z.object({
+    pattern: z.string().min(1),
+    include: z.string().optional(),
+    maxResults: z.number().positive().optional(),
+});
+function resolveRoot(r) {
+    return typeof r === "function" ? r() : r;
+}
+/**
+ * Default ignored directories for search — convenience only.
+ * User tự extend: `config.ignoredDirs = [...DEFAULT_IGNORED_DIRS, "my-dir"]`
+ */
+export const DEFAULT_IGNORED_DIRS = ["node_modules", ".git", ".next", "dist", ".turbo", "coverage", ".vscode"];
+async function globRecursive(dir, pattern, base, results, ignoreDirs) {
+    const entries = await readdir(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (ignoreDirs.has(entry.name))
+            continue;
+        const fullPath = join(dir, entry.name);
+        const relPath = relative(base, fullPath);
+        if (entry.name.includes(pattern) || relPath.includes(pattern)) {
+            results.push(relPath);
+        }
+        if (entry.isDirectory()) {
+            await globRecursive(fullPath, pattern, base, results, ignoreDirs);
+        }
+    }
+}
+export function createGlobFilesTool(workspaceRoot, ignoredDirs) {
+    const ignoreSet = new Set(ignoredDirs ?? DEFAULT_IGNORED_DIRS);
+    return defineTool({
+        name: "glob_files",
+        description: "Recursively find files matching a pattern in the workspace.",
+        risk: "read",
+        input: GlobFilesSchema,
+        jsonSchema: {
+            type: "object",
+            properties: {
+                pattern: { type: "string", description: "File name or path fragment to match" },
+                maxResults: { type: "number", description: "Maximum results (default 50)", default: 50 },
+            },
+            required: ["pattern"],
+        },
+        async execute(v, _ctx) {
+            const root = resolveRoot(workspaceRoot);
+            const results = [];
+            await globRecursive(root, v.pattern, root, results, ignoreSet);
+            return results.slice(0, v.maxResults ?? 50);
+        },
+    }).toDefinition();
+}
+export function createGrepFilesTool(workspaceRoot, ignoredDirs) {
+    const ignoreSet = new Set(ignoredDirs ?? DEFAULT_IGNORED_DIRS);
+    return defineTool({
+        name: "grep_files",
+        description: "Search file contents for a regex pattern. Returns matches with line numbers.",
+        risk: "read",
+        input: GrepFilesSchema,
+        jsonSchema: {
+            type: "object",
+            properties: {
+                pattern: { type: "string", description: "Regex pattern to search" },
+                include: { type: "string", description: "File pattern filter (e.g. *.ts, *.md)" },
+                maxResults: { type: "number", description: "Maximum match lines (default 30)", default: 30 },
+            },
+            required: ["pattern"],
+        },
+        async execute(v, _ctx) {
+            const root = resolveRoot(workspaceRoot);
+            const maxResults = v.maxResults ?? 30;
+            const regex = new RegExp(v.pattern);
+            const matches = [];
+            async function searchDir(dir) {
+                if (matches.length >= maxResults)
+                    return;
+                const entries = await readdir(dir, { withFileTypes: true });
+                for (const entry of entries) {
+                    if (matches.length >= maxResults)
+                        return;
+                    if (ignoreSet.has(entry.name))
+                        continue;
+                    const fullPath = join(dir, entry.name);
+                    if (entry.isDirectory()) {
+                        await searchDir(fullPath);
+                    }
+                    else if (!v.include || entry.name.endsWith(v.include.replace("*", ""))) {
+                        try {
+                            const st = await stat(fullPath);
+                            if (st.size > 100_000)
+                                continue;
+                            const content = await readFile(fullPath, "utf-8");
+                            const lines = content.split("\n");
+                            for (let i = 0; i < lines.length; i++) {
+                                if (regex.test(lines[i])) {
+                                    matches.push({
+                                        file: relative(root, fullPath),
+                                        line: i + 1,
+                                        content: lines[i].trim().slice(0, 200),
+                                    });
+                                    if (matches.length >= maxResults)
+                                        return;
+                                }
+                            }
+                        }
+                        catch {
+                            continue;
+                        }
+                    }
+                }
+            }
+            await searchDir(root);
+            return matches;
+        },
+    }).toDefinition();
+}
+//# sourceMappingURL=search-tools.js.map

package/dist/search-tools.js.map

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

package/dist/shell-parser.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shell command parsing utility.
+ * Extracts file and args from a command string, handling quotes and escapes.
+ */
+export declare function parseCommand(cmd: string): {
+    file: string;
+    args: string[];
+};
+//# sourceMappingURL=shell-parser.d.ts.map

package/dist/shell-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-parser.d.ts","sourceRoot":"","sources":["../src/shell-parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAiC1E"}

package/dist/shell-parser.js

@@ -0,0 +1,68 @@
+/**
+ * Shell command parsing utility.
+ * Extracts file and args from a command string, handling quotes and escapes.
+ */
+export function parseCommand(cmd) {
+    const trimmed = cmd.trim();
+    if (!trimmed)
+        return { file: "", args: [] };
+    const tokens = [];
+    let i = 0;
+    let current = "";
+    let inSingle = false;
+    let inDouble = false;
+    while (i < trimmed.length) {
+        const ch = trimmed[i] ?? "";
+        if (inSingle) {
+            if (ch === "'") {
+                inSingle = false;
+            }
+            else {
+                current += ch;
+            }
+            i++;
+        }
+        else if (inDouble) {
+            if (ch === '"') {
+                inDouble = false;
+            }
+            else if (ch === "\\" && i + 1 < trimmed.length) {
+                current += trimmed[i + 1];
+                i += 2;
+            }
+            else {
+                current += ch;
+                i++;
+            }
+        }
+        else if (ch === "'") {
+            inSingle = true;
+            i++;
+        }
+        else if (ch === '"') {
+            inDouble = true;
+            i++;
+        }
+        else if (ch === "\\" && i + 1 < trimmed.length) {
+            current += trimmed[i + 1];
+            i += 2;
+        }
+        else if (/\s/.test(ch)) {
+            if (current) {
+                tokens.push(current);
+                current = "";
+            }
+            i++;
+        }
+        else {
+            current += ch;
+            i++;
+        }
+    }
+    if (current)
+        tokens.push(current);
+    if (tokens.length === 0)
+        return { file: "", args: [] };
+    return { file: tokens[0], args: tokens.slice(1) };
+}
+//# sourceMappingURL=shell-parser.js.map

package/dist/shell-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-parser.js","sourceRoot":"","sources":["../src/shell-parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IAE5C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gBAAC,QAAQ,GAAG,KAAK,CAAC;YAAC,CAAC;iBAChC,CAAC;gBAAC,OAAO,IAAI,EAAE,CAAC;YAAC,CAAC;YACvB,CAAC,EAAE,CAAC;QACN,CAAC;aAAM,IAAI,QAAQ,EAAE,CAAC;YACpB,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gBAAC,QAAQ,GAAG,KAAK,CAAC;YAAC,CAAC;iBAChC,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;gBAAC,OAAO,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAC,CAAC,IAAI,CAAC,CAAC;YAAC,CAAC;iBACjF,CAAC;gBAAC,OAAO,IAAI,EAAE,CAAC;gBAAC,CAAC,EAAE,CAAC;YAAC,CAAC;QAC9B,CAAC;aAAM,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YAAC,QAAQ,GAAG,IAAI,CAAC;YAAC,CAAC,EAAE,CAAC;QAAC,CAAC;aAC3C,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YAAC,QAAQ,GAAG,IAAI,CAAC;YAAC,CAAC,EAAE,CAAC;QAAC,CAAC;aACzC,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YAAC,OAAO,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAAC,CAAC,IAAI,CAAC,CAAC;QAAC,CAAC;aACjF,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YACvB,IAAI,OAAO,EAAE,CAAC;gBAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;YAAC,CAAC;YACpD,CAAC,EAAE,CAAC;QACN,CAAC;aACI,CAAC;YAAC,OAAO,IAAI,EAAE,CAAC;YAAC,CAAC,EAAE,CAAC;QAAC,CAAC;IAC9B,CAAC;IACD,IAAI,OAAO;QAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAElC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IACvD,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAE,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AACrD,CAAC"}