@nervekit/tools 0.1.0

package/dist/execution/python/runtime.js

@@ -0,0 +1,178 @@
+import { spawn } from "node:child_process";
+import { access } from "node:fs/promises";
+import { join } from "node:path";
+const MIN_VERSION = [3, 9];
+export async function resolvePythonRuntime(options) {
+    const timeoutMs = options.timeoutMs ?? 5000;
+    const candidates = await pythonCandidates(options.cwd, options.manualPath);
+    let lastError = "No Python executable found.";
+    for (const candidate of candidates) {
+        if (candidate.mustExist && !(await pathExists(candidate.command))) {
+            lastError = `Python executable not found: ${candidate.command}`;
+            continue;
+        }
+        const probe = await probePython(candidate.command, candidate.args, timeoutMs);
+        if (!probe.ok) {
+            lastError = probe.error;
+            continue;
+        }
+        if (!supportedVersion(probe.value.versionInfo)) {
+            lastError = `Python ${probe.value.version} is too old; Python ${MIN_VERSION[0]}.${MIN_VERSION[1]}+ is required.`;
+            continue;
+        }
+        return {
+            available: true,
+            command: candidate.command,
+            args: candidate.args,
+            displayPath: probe.value.executable || candidate.command,
+            version: probe.value.version,
+            source: candidate.source,
+        };
+    }
+    return { available: false, source: "unavailable", error: lastError };
+}
+async function pythonCandidates(cwd, manualPath) {
+    if (manualPath?.trim()) {
+        return [
+            {
+                command: manualPath.trim(),
+                args: [],
+                source: "manual",
+                mustExist: true,
+            },
+        ];
+    }
+    const candidates = [];
+    for (const path of projectVenvCandidates(cwd)) {
+        if (await pathExists(path)) {
+            candidates.push({
+                command: path,
+                args: [],
+                source: "project_venv",
+                mustExist: true,
+            });
+        }
+    }
+    if (process.platform === "win32") {
+        candidates.push({ command: "python.exe", args: [], source: "path" }, { command: "python3.exe", args: [], source: "path" }, { command: "py.exe", args: ["-3"], source: "windows_launcher" }, { command: "py", args: ["-3"], source: "windows_launcher" });
+    }
+    else {
+        candidates.push({ command: "python3", args: [], source: "path" }, { command: "python", args: [], source: "path" });
+    }
+    const uvPython = await findUvPython(cwd);
+    if (uvPython) {
+        candidates.push({
+            command: uvPython,
+            args: [],
+            source: "uv",
+            mustExist: true,
+        });
+    }
+    return candidates;
+}
+function projectVenvCandidates(cwd) {
+    if (process.platform === "win32") {
+        return [
+            join(cwd, ".venv", "Scripts", "python.exe"),
+            join(cwd, "venv", "Scripts", "python.exe"),
+        ];
+    }
+    return [
+        join(cwd, ".venv", "bin", "python"),
+        join(cwd, "venv", "bin", "python"),
+    ];
+}
+async function findUvPython(cwd) {
+    const result = await runCommand("uv", ["python", "find"], 5000, cwd, {
+        UV_PYTHON_DOWNLOADS: "never",
+    });
+    if (result.status !== 0)
+        return undefined;
+    const first = result.stdout.trim().split(/\r?\n/)[0]?.trim();
+    return first || undefined;
+}
+async function probePython(command, args, timeoutMs) {
+    const script = [
+        "import json, sys",
+        "print(json.dumps({'executable': sys.executable, 'version': sys.version.split()[0], 'versionInfo': list(sys.version_info[:3])}))",
+    ].join("; ");
+    const result = await runCommand(command, [...args, "-c", script], timeoutMs);
+    if (result.status !== 0) {
+        return {
+            ok: false,
+            error: result.stderr.trim() ||
+                `Python probe failed for ${command} with status ${String(result.status)}`,
+        };
+    }
+    try {
+        const parsed = JSON.parse(result.stdout.trim());
+        const versionInfo = Array.isArray(parsed.versionInfo)
+            ? parsed.versionInfo.map(Number)
+            : [];
+        if (typeof parsed.executable !== "string" ||
+            typeof parsed.version !== "string" ||
+            versionInfo.length < 3 ||
+            versionInfo.some((part) => !Number.isInteger(part))) {
+            return { ok: false, error: `Python probe returned invalid metadata.` };
+        }
+        return {
+            ok: true,
+            value: {
+                executable: parsed.executable,
+                version: parsed.version,
+                versionInfo: [versionInfo[0], versionInfo[1], versionInfo[2]],
+            },
+        };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            error: `Python probe returned invalid JSON: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
+function supportedVersion([major, minor]) {
+    return (major > MIN_VERSION[0] ||
+        (major === MIN_VERSION[0] && minor >= MIN_VERSION[1]));
+}
+async function runCommand(command, args, timeoutMs, cwd, env) {
+    return await new Promise((resolve) => {
+        let stdout = "";
+        let stderr = "";
+        const child = spawn(command, args, {
+            cwd,
+            shell: false,
+            stdio: ["ignore", "pipe", "pipe"],
+            env: { ...process.env, ...(env ?? {}) },
+        });
+        const timeout = setTimeout(() => {
+            child.kill("SIGTERM");
+        }, timeoutMs);
+        child.stdout?.setEncoding("utf8");
+        child.stderr?.setEncoding("utf8");
+        child.stdout?.on("data", (chunk) => {
+            stdout += chunk;
+        });
+        child.stderr?.on("data", (chunk) => {
+            stderr += chunk;
+        });
+        child.on("error", (error) => {
+            clearTimeout(timeout);
+            resolve({ stdout, stderr: error.message, status: null });
+        });
+        child.on("close", (status) => {
+            clearTimeout(timeout);
+            resolve({ stdout, stderr, status });
+        });
+    });
+}
+async function pathExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/execution/python/runtime.js.map

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

package/dist/execution/read.d.ts

@@ -0,0 +1,3 @@
+import type { ToolExecutionContext, ToolExecutionResult } from "../types.js";
+export declare function executeRead(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolExecutionResult>;
+//# sourceMappingURL=read.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/execution/read.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAyC7E,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAgE9B"}

package/dist/execution/read.js

@@ -0,0 +1,97 @@
+import { readFile } from "node:fs/promises";
+import { numberArg } from "./common.js";
+import { isErrnoException, pathNotFoundMessage, resolveReadPath, } from "./path.js";
+import { DEFAULT_MAX_LINES, formatSize, truncateHead } from "./truncate.js";
+const PNG_SIGNATURE = [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a];
+function startsWith(buffer, bytes) {
+    if (buffer.length < bytes.length)
+        return false;
+    return bytes.every((byte, index) => buffer[index] === byte);
+}
+function startsWithAscii(buffer, offset, text) {
+    if (buffer.length < offset + text.length)
+        return false;
+    for (let index = 0; index < text.length; index += 1) {
+        if (buffer[offset + index] !== text.charCodeAt(index))
+            return false;
+    }
+    return true;
+}
+function detectSupportedImageMimeType(buffer) {
+    if (startsWith(buffer, [0xff, 0xd8, 0xff]))
+        return "image/jpeg";
+    if (startsWith(buffer, PNG_SIGNATURE))
+        return "image/png";
+    if (startsWithAscii(buffer, 0, "GIF"))
+        return "image/gif";
+    if (startsWithAscii(buffer, 0, "RIFF") &&
+        startsWithAscii(buffer, 8, "WEBP")) {
+        return "image/webp";
+    }
+    return null;
+}
+export async function executeRead(args, context) {
+    const path = await resolveReadPath(context.cwd, args.path);
+    const buffer = await readFile(path).catch((error) => {
+        if (isErrnoException(error) && error.code === "ENOENT") {
+            throw new Error(pathNotFoundMessage("read", args.path, path));
+        }
+        throw error;
+    });
+    const mimeType = detectSupportedImageMimeType(buffer);
+    if (mimeType) {
+        const content = `Read image file [${mimeType}]`;
+        return {
+            path,
+            content,
+            contentBlocks: [
+                { type: "text", text: content },
+                { type: "image", data: buffer.toString("base64"), mimeType },
+            ],
+        };
+    }
+    const content = buffer.toString("utf8");
+    const lines = content.split(/\r?\n/);
+    const hasExplicitLimit = typeof args.limit === "number";
+    const hasExplicitOffset = typeof args.offset === "number";
+    const offset = numberArg(args.offset, 1);
+    if (hasExplicitLimit || hasExplicitOffset) {
+        const limit = Math.min(numberArg(args.limit, 1000), 5000);
+        const start = Math.max(0, offset - 1);
+        const selected = lines.slice(start, start + limit).join("\n");
+        const remaining = Math.max(0, lines.length - (start + limit));
+        const output = remaining > 0
+            ? `${selected}\n\n[...${remaining} more lines. Continue with offset ${offset + limit}.]`
+            : selected;
+        return {
+            path,
+            content: output,
+            contentBlocks: [{ type: "text", text: output }],
+            details: remaining > 0
+                ? {
+                    truncation: {
+                        omittedLines: remaining,
+                        nextOffset: offset + limit,
+                    },
+                }
+                : undefined,
+        };
+    }
+    const truncated = truncateHead(content);
+    let output = truncated.text;
+    if (truncated.truncated) {
+        output += `\n\n[...output truncated to ${DEFAULT_MAX_LINES} lines or ${formatSize(50 * 1024)}. Continue reading with offset ${countLines(truncated.text) + 1}.]`;
+    }
+    return {
+        path,
+        content: output,
+        contentBlocks: [{ type: "text", text: output }],
+        details: truncated.truncated ? { truncation: truncated } : undefined,
+    };
+}
+function countLines(text) {
+    if (text.length === 0)
+        return 0;
+    return text.split("\n").length;
+}
+//# sourceMappingURL=read.js.map

package/dist/execution/read.js.map

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

package/dist/execution/search-utils.d.ts

@@ -0,0 +1,8 @@
+export type SearchScope = {
+    roots: string[];
+    displayRoot: string;
+};
+export declare function resolveSearchScope(cwd: string, args: Record<string, unknown>, toolName: string): Promise<SearchScope>;
+export declare function walkFiles(root: string, path: string, limit: number, onFile: (absolutePath: string, relativePath: string) => Promise<void>, shouldStop?: () => boolean): Promise<void>;
+export declare function globToRegExp(pattern: string): RegExp;
+//# sourceMappingURL=search-utils.d.ts.map

package/dist/execution/search-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-utils.d.ts","sourceRoot":"","sources":["../../src/execution/search-utils.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAQF,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,CAAC,CAmCtB;AA+CD,wBAAsB,SAAS,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,EACrE,UAAU,CAAC,EAAE,MAAM,OAAO,GACzB,OAAO,CAAC,IAAI,CAAC,CAef;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAqBpD"}

package/dist/execution/search-utils.js

@@ -0,0 +1,110 @@
+import { constants } from "node:fs";
+import { access, readdir, stat } from "node:fs/promises";
+import { dirname, isAbsolute, join, relative } from "node:path";
+import { isErrnoException, resolveToolPath } from "./path.js";
+export async function resolveSearchScope(cwd, args, toolName) {
+    if (args.path !== undefined && args.paths !== undefined) {
+        throw new Error(`${toolName} accepts either 'path' or 'paths', not both.`);
+    }
+    const inputs = searchScopeInputs(args, toolName);
+    const roots = [];
+    for (const input of inputs) {
+        const path = resolveToolPath(cwd, input);
+        const info = await stat(path).catch((error) => {
+            if (isErrnoException(error) && error.code === "ENOENT") {
+                throw new Error(`${toolName} path not found: ${JSON.stringify(input)} (resolved to ${path}). Pass one path in 'path' or multiple paths as 'paths': [...].`);
+            }
+            throw error;
+        });
+        if (!info.isFile() && !info.isDirectory()) {
+            throw new Error(`${toolName} path is not a file or directory: ${JSON.stringify(input)} (resolved to ${path}).`);
+        }
+        roots.push({
+            input,
+            path,
+            kind: info.isDirectory() ? "directory" : "file",
+        });
+    }
+    const rootBases = roots.map((root) => root.kind === "directory" ? root.path : dirname(root.path));
+    const displayRoot = rootBases.length === 1 ? rootBases[0] : commonAncestor(rootBases);
+    return { roots: roots.map((root) => root.path), displayRoot };
+}
+function searchScopeInputs(args, toolName) {
+    if (args.paths !== undefined) {
+        if (!Array.isArray(args.paths) || args.paths.length === 0) {
+            throw new Error(`${toolName} 'paths' must be a non-empty array of strings.`);
+        }
+        return args.paths.map((input) => {
+            if (typeof input !== "string" || input.trim().length === 0) {
+                throw new Error(`${toolName} 'paths' must be a non-empty array of strings.`);
+            }
+            return input;
+        });
+    }
+    if (args.path !== undefined) {
+        if (typeof args.path !== "string" || args.path.trim().length === 0) {
+            throw new Error(`${toolName} 'path' must be a non-empty string.`);
+        }
+        return [args.path];
+    }
+    return ["."];
+}
+function commonAncestor(paths) {
+    let current = paths[0] ?? "/";
+    for (const path of paths.slice(1)) {
+        while (!isInsideOrSame(current, path)) {
+            const parent = dirname(current);
+            if (parent === current)
+                return current;
+            current = parent;
+        }
+    }
+    return current;
+}
+function isInsideOrSame(parent, child) {
+    const rel = relative(parent, child);
+    return rel === "" || (!rel.startsWith("..") && !isAbsolute(rel));
+}
+export async function walkFiles(root, path, limit, onFile, shouldStop) {
+    if (shouldStop?.())
+        return;
+    const info = await stat(path);
+    if (info.isDirectory()) {
+        const entries = await readdir(path, { withFileTypes: true });
+        for (const entry of entries) {
+            if (shouldStop?.())
+                return;
+            if (entry.name === "node_modules" || entry.name === ".git")
+                continue;
+            await walkFiles(root, join(path, entry.name), limit, onFile, shouldStop);
+        }
+        return;
+    }
+    if (!info.isFile())
+        return;
+    await access(path, constants.R_OK);
+    await onFile(path, relative(root, path));
+}
+export function globToRegExp(pattern) {
+    let output = "";
+    for (let index = 0; index < pattern.length; index += 1) {
+        const char = pattern[index];
+        const next = pattern[index + 1];
+        if (char === "*" && next === "*") {
+            output += ".*";
+            index += 1;
+            continue;
+        }
+        if (char === "*") {
+            output += "[^/]*";
+            continue;
+        }
+        if (char === "?") {
+            output += "[^/]";
+            continue;
+        }
+        output += char?.replace(/[.+^${}()|[\]\\]/g, "\\$&") ?? "";
+    }
+    return new RegExp(`^${output}$`);
+}
+//# sourceMappingURL=search-utils.js.map

package/dist/execution/search-utils.js.map

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

package/dist/execution/search.d.ts

@@ -0,0 +1,3 @@
+import type { ToolExecutionContext, ToolExecutionResult } from "../types.js";
+export declare function executeGrep(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolExecutionResult>;
+//# sourceMappingURL=search.d.ts.map

package/dist/execution/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/execution/search.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAc7E,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAgB9B"}

package/dist/execution/search.js

@@ -0,0 +1,131 @@
+import { execFile } from "node:child_process";
+import { readFile, stat } from "node:fs/promises";
+import { relative } from "node:path";
+import { promisify } from "node:util";
+import { numberArg } from "./common.js";
+import { globToRegExp, resolveSearchScope, walkFiles, } from "./search-utils.js";
+import { truncateHead, truncateLine } from "./truncate.js";
+const execFileAsync = promisify(execFile);
+export async function executeGrep(args, context) {
+    if (typeof args.pattern !== "string" || args.pattern.length === 0) {
+        throw new Error("Tool argument 'pattern' must be a non-empty string.");
+    }
+    const scope = await resolveSearchScope(context.cwd, args, "grep");
+    const limit = Math.min(numberArg(args.limit, 100), 2000);
+    const rg = await runRg(args, scope, limit).catch(() => undefined);
+    const matches = rg ?? (await fallbackGrep(args, scope, limit));
+    const formatted = formatMatches(matches, limit);
+    return {
+        path: scope.displayRoot,
+        matches: matches.slice(0, limit),
+        content: formatted.content,
+        contentBlocks: [{ type: "text", text: formatted.content }],
+        details: formatted.details,
+    };
+}
+async function runRg(args, scope, limit) {
+    const rgArgs = [
+        "--line-number",
+        "--color=never",
+        "--hidden",
+        "--with-filename",
+    ];
+    if (args.ignoreCase)
+        rgArgs.push("--ignore-case");
+    if (args.literal)
+        rgArgs.push("--fixed-strings");
+    if (typeof args.glob === "string" && args.glob.length > 0) {
+        rgArgs.push("--glob", args.glob);
+    }
+    const contextLines = numberArg(args.context, 0);
+    if (contextLines > 0)
+        rgArgs.push("--context", String(contextLines));
+    rgArgs.push("--", String(args.pattern), ...scope.roots);
+    const { stdout } = await execFileAsync("rg", rgArgs, {
+        timeout: 30_000,
+        maxBuffer: 1024 * 1024 * 4,
+    });
+    const matches = [];
+    for (const line of stdout.split(/\r?\n/)) {
+        if (!line)
+            continue;
+        const match = /^(.*?):(\d+):(.*)$/.exec(line);
+        if (!match)
+            continue;
+        matches.push({
+            path: relative(scope.displayRoot, match[1] ?? "").replaceAll("\\", "/") ||
+                (match[1] ?? ""),
+            line: Number(match[2]),
+            text: match[3] ?? "",
+        });
+        if (matches.length >= limit)
+            break;
+    }
+    return matches;
+}
+async function fallbackGrep(args, scope, limit) {
+    const matches = [];
+    const literal = Boolean(args.literal);
+    const ignoreCase = Boolean(args.ignoreCase);
+    const pattern = String(args.pattern);
+    const regex = literal
+        ? undefined
+        : new RegExp(pattern, ignoreCase ? "i" : undefined);
+    const needle = ignoreCase ? pattern.toLowerCase() : pattern;
+    const glob = typeof args.glob === "string" ? globToRegExp(args.glob) : undefined;
+    for (const root of scope.roots) {
+        await walkFiles(scope.displayRoot, root, limit, async (absolutePath, relativePath) => {
+            if (glob && !glob.test(relativePath))
+                return;
+            const info = await stat(absolutePath);
+            if (info.size > 1024 * 1024)
+                return;
+            const content = await readFile(absolutePath, "utf8").catch(() => undefined);
+            if (content === undefined)
+                return;
+            const lines = content.split(/\r?\n/);
+            for (const [index, line] of lines.entries()) {
+                const haystack = ignoreCase ? line.toLowerCase() : line;
+                if (regex ? regex.test(line) : haystack.includes(needle)) {
+                    matches.push({
+                        path: relativePath.replaceAll("\\", "/"),
+                        line: index + 1,
+                        text: line,
+                    });
+                    if (matches.length >= limit)
+                        return;
+                }
+            }
+        }, () => matches.length >= limit);
+        if (matches.length >= limit)
+            break;
+    }
+    return matches;
+}
+function formatMatches(matches, limit) {
+    let truncatedLines = 0;
+    const lines = matches.slice(0, limit).map((match) => {
+        const text = truncateLine(match.text);
+        if (text.truncated)
+            truncatedLines += 1;
+        return `${match.path}:${match.line}: ${text.text}`;
+    });
+    if (matches.length === 0)
+        lines.push("No matches found.");
+    if (matches.length >= limit) {
+        lines.push(``, `[Match limit ${limit} reached. Increase limit or refine the pattern for more results.]`);
+    }
+    if (truncatedLines > 0) {
+        lines.push(``, `[${truncatedLines} matching line(s) truncated to 500 characters. Use read to inspect full lines.]`);
+    }
+    const truncated = truncateHead(lines.join("\n"), {
+        maxLines: Number.MAX_SAFE_INTEGER,
+    });
+    return {
+        content: truncated.text,
+        details: truncated.truncated || truncatedLines > 0
+            ? { truncation: truncated, truncatedLines }
+            : undefined,
+    };
+}
+//# sourceMappingURL=search.js.map

package/dist/execution/search.js.map

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

package/dist/execution/shell/bash.d.ts

@@ -0,0 +1,3 @@
+import type { ToolExecutionContext, ToolExecutionResult } from "../../types.js";
+export declare function executeBash(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolExecutionResult>;
+//# sourceMappingURL=bash.d.ts.map

package/dist/execution/shell/bash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../../src/execution/shell/bash.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAOhF,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAsH9B"}