@kernel.chat/kbot 1.0.0

package/dist/tools/browser.js

@@ -0,0 +1,116 @@
+// K:BOT Browser Tool — Playwright-based web browsing
+// Requires: npx playwright install (run once)
+// Available at Growth tier and above
+import { registerTool } from './index.js';
+// Lazy-load playwright to avoid requiring it for non-browser users
+let browserInstance = null;
+let pageInstance = null;
+async function getPage() {
+    if (pageInstance)
+        return pageInstance;
+    try {
+        const { chromium } = await import('playwright');
+        browserInstance = await chromium.launch({ headless: true });
+        const context = await browserInstance.newContext({
+            viewport: { width: 1280, height: 720 },
+            userAgent: 'K:BOT/1.0 (Kernel Terminal Agent)',
+        });
+        pageInstance = await context.newPage();
+        return pageInstance;
+    }
+    catch {
+        throw new Error('Playwright not installed. Run: npx playwright install chromium');
+    }
+}
+async function closeBrowser() {
+    if (browserInstance) {
+        await browserInstance.close();
+        browserInstance = null;
+        pageInstance = null;
+    }
+}
+export function registerBrowserTools() {
+    registerTool({
+        name: 'browser_navigate',
+        description: 'Navigate to a URL in a headless browser. Returns the page title and text content.',
+        parameters: {
+            url: { type: 'string', description: 'URL to navigate to', required: true },
+        },
+        tier: 'growth',
+        async execute(args) {
+            const url = String(args.url);
+            const page = await getPage();
+            await page.goto(url, { waitUntil: 'domcontentloaded', timeout: 30_000 });
+            const title = await page.title();
+            const text = await page.innerText('body').catch(() => '');
+            // Truncate to avoid massive responses
+            const truncated = text.length > 5000 ? text.slice(0, 5000) + '\n...(truncated)' : text;
+            return `Title: ${title}\nURL: ${page.url()}\n\n${truncated}`;
+        },
+    });
+    registerTool({
+        name: 'browser_snapshot',
+        description: 'Get the current page\'s accessibility tree (structured text representation).',
+        parameters: {},
+        tier: 'growth',
+        async execute() {
+            const page = await getPage();
+            const snapshot = await page.accessibility.snapshot();
+            return JSON.stringify(snapshot, null, 2);
+        },
+    });
+    registerTool({
+        name: 'browser_click',
+        description: 'Click an element on the page by CSS selector.',
+        parameters: {
+            selector: { type: 'string', description: 'CSS selector of element to click', required: true },
+        },
+        tier: 'growth',
+        async execute(args) {
+            const page = await getPage();
+            await page.click(String(args.selector), { timeout: 10_000 });
+            return `Clicked: ${args.selector}`;
+        },
+    });
+    registerTool({
+        name: 'browser_type',
+        description: 'Type text into a form field identified by CSS selector.',
+        parameters: {
+            selector: { type: 'string', description: 'CSS selector of input element', required: true },
+            text: { type: 'string', description: 'Text to type', required: true },
+        },
+        tier: 'growth',
+        async execute(args) {
+            const page = await getPage();
+            await page.fill(String(args.selector), String(args.text));
+            return `Typed into ${args.selector}`;
+        },
+    });
+    registerTool({
+        name: 'browser_screenshot',
+        description: 'Take a screenshot of the current page. Returns base64-encoded PNG.',
+        parameters: {
+            fullPage: { type: 'boolean', description: 'Capture full page (default: false)' },
+        },
+        tier: 'growth',
+        async execute(args) {
+            const page = await getPage();
+            const buffer = await page.screenshot({
+                fullPage: args.fullPage === true,
+                type: 'png',
+            });
+            return `Screenshot captured (${buffer.length} bytes, base64):\n${buffer.toString('base64').slice(0, 200)}...`;
+        },
+    });
+    registerTool({
+        name: 'browser_close',
+        description: 'Close the browser instance.',
+        parameters: {},
+        tier: 'growth',
+        async execute() {
+            await closeBrowser();
+            return 'Browser closed';
+        },
+    });
+}
+//# sourceMappingURL=browser.js.map

package/dist/tools/browser.js.map

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

package/dist/tools/computer.d.ts

@@ -0,0 +1,2 @@
+export declare function registerComputerTools(): void;
+//# sourceMappingURL=computer.d.ts.map

package/dist/tools/computer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computer.d.ts","sourceRoot":"","sources":["../../src/tools/computer.ts"],"names":[],"mappings":"AAYA,wBAAgB,qBAAqB,IAAI,IAAI,CA2J5C"}

package/dist/tools/computer.js

@@ -0,0 +1,176 @@
+// K:BOT Computer Use Tool — Screenshot, click, type on the desktop
+// Enterprise tier only. Requires explicit opt-in via --computer-use flag.
+// Uses native OS commands (screencapture on macOS, etc.)
+import { execSync } from 'node:child_process';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { readFileSync, unlinkSync } from 'node:fs';
+import { registerTool } from './index.js';
+const platform = process.platform;
+export function registerComputerTools() {
+    registerTool({
+        name: 'screenshot',
+        description: 'Capture a screenshot of the entire screen. Returns base64-encoded PNG. Requires --computer-use flag.',
+        parameters: {},
+        tier: 'enterprise',
+        async execute() {
+            const tmpPath = join(tmpdir(), `kbot-screenshot-${Date.now()}.png`);
+            try {
+                if (platform === 'darwin') {
+                    execSync(`screencapture -x ${tmpPath}`, { timeout: 10_000 });
+                }
+                else if (platform === 'linux') {
+                    // Try various screenshot tools
+                    try {
+                        execSync(`import -window root ${tmpPath}`, { timeout: 10_000 });
+                    }
+                    catch {
+                        execSync(`gnome-screenshot -f ${tmpPath}`, { timeout: 10_000 });
+                    }
+                }
+                else {
+                    return 'Error: Computer use not supported on this platform';
+                }
+                const buffer = readFileSync(tmpPath);
+                unlinkSync(tmpPath);
+                return `Screenshot captured (${buffer.length} bytes). Base64 preview: ${buffer.toString('base64').slice(0, 100)}...`;
+            }
+            catch (err) {
+                return `Screenshot failed: ${err instanceof Error ? err.message : String(err)}`;
+            }
+        },
+    });
+    registerTool({
+        name: 'mouse_click',
+        description: 'Click at specific screen coordinates. Requires --computer-use flag.',
+        parameters: {
+            x: { type: 'number', description: 'X coordinate', required: true },
+            y: { type: 'number', description: 'Y coordinate', required: true },
+            button: { type: 'string', description: 'Mouse button: left, right, middle (default: left)' },
+        },
+        tier: 'enterprise',
+        async execute(args) {
+            const x = Number(args.x);
+            const y = Number(args.y);
+            const button = args.button === 'right' ? 2 : 1;
+            if (platform === 'darwin') {
+                // Use AppleScript for mouse control on macOS
+                const script = button === 1
+                    ? `tell application "System Events" to click at {${x}, ${y}}`
+                    : `tell application "System Events" to click at {${x}, ${y}} using control down`;
+                try {
+                    execSync(`osascript -e '${script}'`, { timeout: 5_000 });
+                    return `Clicked at (${x}, ${y})`;
+                }
+                catch {
+                    // Fallback to cliclick if available
+                    try {
+                        execSync(`cliclick c:${x},${y}`, { timeout: 5_000 });
+                        return `Clicked at (${x}, ${y})`;
+                    }
+                    catch {
+                        return 'Error: Mouse click requires cliclick (brew install cliclick) or accessibility permissions';
+                    }
+                }
+            }
+            else if (platform === 'linux') {
+                try {
+                    execSync(`xdotool mousemove ${x} ${y} click ${button}`, { timeout: 5_000 });
+                    return `Clicked at (${x}, ${y})`;
+                }
+                catch {
+                    return 'Error: Mouse click requires xdotool (apt install xdotool)';
+                }
+            }
+            return 'Error: Computer use not supported on this platform';
+        },
+    });
+    registerTool({
+        name: 'keyboard_type',
+        description: 'Type text using the keyboard. Requires --computer-use flag.',
+        parameters: {
+            text: { type: 'string', description: 'Text to type', required: true },
+        },
+        tier: 'enterprise',
+        async execute(args) {
+            const text = String(args.text);
+            if (platform === 'darwin') {
+                // Escape for AppleScript
+                const escaped = text.replace(/"/g, '\\"').replace(/'/g, "\\'");
+                try {
+                    execSync(`osascript -e 'tell application "System Events" to keystroke "${escaped}"'`, { timeout: 10_000 });
+                    return `Typed: ${text.slice(0, 50)}${text.length > 50 ? '...' : ''}`;
+                }
+                catch {
+                    return 'Error: Typing requires accessibility permissions';
+                }
+            }
+            else if (platform === 'linux') {
+                try {
+                    execSync(`xdotool type -- "${text.replace(/"/g, '\\"')}"`, { timeout: 10_000 });
+                    return `Typed: ${text.slice(0, 50)}${text.length > 50 ? '...' : ''}`;
+                }
+                catch {
+                    return 'Error: Typing requires xdotool';
+                }
+            }
+            return 'Error: Computer use not supported on this platform';
+        },
+    });
+    registerTool({
+        name: 'keyboard_key',
+        description: 'Press a specific key or key combination. Requires --computer-use flag.',
+        parameters: {
+            key: { type: 'string', description: 'Key name: enter, tab, escape, space, backspace, cmd+c, ctrl+v, etc.', required: true },
+        },
+        tier: 'enterprise',
+        async execute(args) {
+            const key = String(args.key).toLowerCase();
+            if (platform === 'darwin') {
+                // Map common keys to AppleScript key codes
+                const keyMap = {
+                    enter: 'return', tab: 'tab', escape: 'escape 53',
+                    space: 'space', backspace: 'delete', delete: 'forward delete',
+                };
+                const mapped = keyMap[key] || key;
+                try {
+                    if (key.includes('+')) {
+                        // Key combination: cmd+c → keystroke "c" using command down
+                        const parts = key.split('+');
+                        const mainKey = parts.pop();
+                        const modifiers = parts.map(m => {
+                            if (m === 'cmd' || m === 'command')
+                                return 'command down';
+                            if (m === 'ctrl' || m === 'control')
+                                return 'control down';
+                            if (m === 'alt' || m === 'option')
+                                return 'option down';
+                            if (m === 'shift')
+                                return 'shift down';
+                            return '';
+                        }).filter(Boolean).join(', ');
+                        execSync(`osascript -e 'tell application "System Events" to keystroke "${mainKey}" using {${modifiers}}'`, { timeout: 5_000 });
+                    }
+                    else {
+                        execSync(`osascript -e 'tell application "System Events" to key code ${mapped}'`, { timeout: 5_000 });
+                    }
+                    return `Pressed: ${key}`;
+                }
+                catch {
+                    return 'Error: Key press requires accessibility permissions';
+                }
+            }
+            else if (platform === 'linux') {
+                try {
+                    execSync(`xdotool key ${key.replace('+', '+')}`, { timeout: 5_000 });
+                    return `Pressed: ${key}`;
+                }
+                catch {
+                    return 'Error: Key press requires xdotool';
+                }
+            }
+            return 'Error: Computer use not supported on this platform';
+        },
+    });
+}
+//# sourceMappingURL=computer.js.map

package/dist/tools/computer.js.map

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

package/dist/tools/files.d.ts

@@ -0,0 +1,2 @@
+export declare function registerFileTools(): void;
+//# sourceMappingURL=files.d.ts.map

package/dist/tools/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/tools/files.ts"],"names":[],"mappings":"AAOA,wBAAgB,iBAAiB,IAAI,IAAI,CAsJxC"}

package/dist/tools/files.js

@@ -0,0 +1,147 @@
+// K:BOT File Tools — Read, write, edit, glob, grep
+// All operations are local — zero API calls.
+import { readFileSync, writeFileSync, existsSync, statSync } from 'node:fs';
+import { execSync } from 'node:child_process';
+import { registerTool } from './index.js';
+export function registerFileTools() {
+    registerTool({
+        name: 'read_file',
+        description: 'Read the contents of a file. Returns the file content with line numbers.',
+        parameters: {
+            path: { type: 'string', description: 'File path (absolute or relative to cwd)', required: true },
+            offset: { type: 'number', description: 'Line number to start from (1-based)' },
+            limit: { type: 'number', description: 'Number of lines to read' },
+        },
+        tier: 'free',
+        async execute(args) {
+            const path = String(args.path);
+            if (!existsSync(path))
+                return `Error: File not found: ${path}`;
+            const stat = statSync(path);
+            if (stat.isDirectory())
+                return `Error: ${path} is a directory, not a file`;
+            if (stat.size > 5 * 1024 * 1024)
+                return `Error: File too large (${(stat.size / 1024 / 1024).toFixed(1)}MB). Max 5MB.`;
+            const content = readFileSync(path, 'utf-8');
+            const lines = content.split('\n');
+            const offset = typeof args.offset === 'number' ? Math.max(0, args.offset - 1) : 0;
+            const limit = typeof args.limit === 'number' ? args.limit : lines.length;
+            const sliced = lines.slice(offset, offset + limit);
+            return sliced.map((line, i) => `${String(offset + i + 1).padStart(6)} │ ${line}`).join('\n');
+        },
+    });
+    registerTool({
+        name: 'write_file',
+        description: 'Write content to a file. Creates the file if it does not exist, overwrites if it does.',
+        parameters: {
+            path: { type: 'string', description: 'File path', required: true },
+            content: { type: 'string', description: 'Content to write', required: true },
+        },
+        tier: 'free',
+        async execute(args) {
+            const path = String(args.path);
+            const content = String(args.content);
+            writeFileSync(path, content);
+            return `Written ${content.length} bytes to ${path}`;
+        },
+    });
+    registerTool({
+        name: 'edit_file',
+        description: 'Find and replace text in a file. The old_string must be unique in the file.',
+        parameters: {
+            path: { type: 'string', description: 'File path', required: true },
+            old_string: { type: 'string', description: 'Text to find', required: true },
+            new_string: { type: 'string', description: 'Replacement text', required: true },
+        },
+        tier: 'free',
+        async execute(args) {
+            const path = String(args.path);
+            if (!existsSync(path))
+                return `Error: File not found: ${path}`;
+            const content = readFileSync(path, 'utf-8');
+            const old_string = String(args.old_string);
+            const new_string = String(args.new_string);
+            const count = content.split(old_string).length - 1;
+            if (count === 0)
+                return `Error: old_string not found in ${path}`;
+            if (count > 1)
+                return `Error: old_string found ${count} times — must be unique. Add more context.`;
+            const updated = content.replace(old_string, new_string);
+            writeFileSync(path, updated);
+            return `Edited ${path}: replaced 1 occurrence`;
+        },
+    });
+    registerTool({
+        name: 'glob',
+        description: 'Find files matching a glob pattern. Returns file paths.',
+        parameters: {
+            pattern: { type: 'string', description: 'Glob pattern (e.g., "**/*.ts", "src/**/*.tsx")', required: true },
+            path: { type: 'string', description: 'Directory to search in (defaults to cwd)' },
+        },
+        tier: 'free',
+        async execute(args) {
+            const pattern = String(args.pattern);
+            const cwd = args.path ? String(args.path) : process.cwd();
+            try {
+                // Use find for simple patterns, or shell glob expansion
+                const result = execSync(`find ${cwd} -path '*/${pattern}' -type f 2>/dev/null | head -50`, { encoding: 'utf-8', timeout: 10000 }).trim();
+                if (!result) {
+                    // Fallback to using shell expansion
+                    const result2 = execSync(`ls -1 ${cwd}/${pattern} 2>/dev/null | head -50`, { encoding: 'utf-8', timeout: 10000 }).trim();
+                    return result2 || 'No files found';
+                }
+                return result;
+            }
+            catch {
+                return 'No files found matching pattern';
+            }
+        },
+    });
+    registerTool({
+        name: 'grep',
+        description: 'Search file contents for a regex pattern. Returns matching lines with file paths and line numbers.',
+        parameters: {
+            pattern: { type: 'string', description: 'Regex pattern to search for', required: true },
+            path: { type: 'string', description: 'File or directory to search in (defaults to cwd)' },
+            type: { type: 'string', description: 'File type filter (e.g., "ts", "py", "js")' },
+        },
+        tier: 'free',
+        async execute(args) {
+            const pattern = String(args.pattern);
+            const searchPath = args.path ? String(args.path) : '.';
+            const typeFlag = args.type ? `--type ${args.type}` : '';
+            try {
+                // Prefer ripgrep, fall back to grep
+                const cmd = existsSync('/usr/bin/rg') || existsSync('/usr/local/bin/rg') || existsSync('/opt/homebrew/bin/rg')
+                    ? `rg -n --max-count 30 ${typeFlag} '${pattern.replace(/'/g, "\\'")}' ${searchPath} 2>/dev/null`
+                    : `grep -rn --include='*.${args.type || '*'}' '${pattern.replace(/'/g, "\\'")}' ${searchPath} 2>/dev/null | head -30`;
+                const result = execSync(cmd, { encoding: 'utf-8', timeout: 15000 }).trim();
+                return result || 'No matches found';
+            }
+            catch {
+                return 'No matches found';
+            }
+        },
+    });
+    registerTool({
+        name: 'list_directory',
+        description: 'List files and directories in a path. Shows file sizes and types.',
+        parameters: {
+            path: { type: 'string', description: 'Directory path (defaults to cwd)' },
+        },
+        tier: 'free',
+        async execute(args) {
+            const dir = args.path ? String(args.path) : '.';
+            try {
+                const result = execSync(`ls -la ${dir} 2>/dev/null | head -50`, {
+                    encoding: 'utf-8', timeout: 5000,
+                }).trim();
+                return result || 'Empty directory';
+            }
+            catch {
+                return `Error: Cannot list directory: ${dir}`;
+            }
+        },
+    });
+}
+//# sourceMappingURL=files.js.map

package/dist/tools/files.js.map

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

package/dist/tools/git.d.ts

@@ -0,0 +1,2 @@
+export declare function registerGitTools(): void;
+//# sourceMappingURL=git.d.ts.map

package/dist/tools/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/tools/git.ts"],"names":[],"mappings":"AAmBA,wBAAgB,gBAAgB,IAAI,IAAI,CA0FvC"}

package/dist/tools/git.js

@@ -0,0 +1,102 @@
+// K:BOT Git Tools — Git operations executed locally
+// Zero API calls. All operations happen on the local repo.
+import { execSync } from 'node:child_process';
+import { registerTool } from './index.js';
+function git(command, timeout = 30_000) {
+    try {
+        return execSync(`git ${command}`, {
+            encoding: 'utf-8',
+            timeout,
+            maxBuffer: 5 * 1024 * 1024,
+        }).trim();
+    }
+    catch (err) {
+        const e = err;
+        throw new Error(e.stderr?.trim() || e.message || 'Git command failed');
+    }
+}
+export function registerGitTools() {
+    registerTool({
+        name: 'git_status',
+        description: 'Show the working tree status — modified, staged, and untracked files.',
+        parameters: {},
+        tier: 'free',
+        async execute() {
+            return git('status --short');
+        },
+    });
+    registerTool({
+        name: 'git_diff',
+        description: 'Show changes in the working directory (unstaged and staged).',
+        parameters: {
+            staged: { type: 'boolean', description: 'Show only staged changes' },
+            path: { type: 'string', description: 'Limit diff to a specific file path' },
+        },
+        tier: 'free',
+        async execute(args) {
+            const staged = args.staged ? '--cached' : '';
+            const path = args.path ? `-- ${args.path}` : '';
+            return git(`diff ${staged} ${path}`.trim()) || 'No changes';
+        },
+    });
+    registerTool({
+        name: 'git_log',
+        description: 'Show recent commit history.',
+        parameters: {
+            count: { type: 'number', description: 'Number of commits to show (default: 10)' },
+            oneline: { type: 'boolean', description: 'One-line format (default: true)' },
+        },
+        tier: 'free',
+        async execute(args) {
+            const count = typeof args.count === 'number' ? args.count : 10;
+            const format = args.oneline !== false ? '--oneline' : '';
+            return git(`log -${count} ${format}`.trim());
+        },
+    });
+    registerTool({
+        name: 'git_commit',
+        description: 'Create a git commit with the specified message. Stages specified files first.',
+        parameters: {
+            message: { type: 'string', description: 'Commit message', required: true },
+            files: { type: 'array', description: 'Files to stage before committing. If empty, commits already-staged files.' },
+        },
+        tier: 'starter',
+        async execute(args) {
+            const message = String(args.message);
+            const files = Array.isArray(args.files) ? args.files.map(String) : [];
+            if (files.length > 0) {
+                git(`add ${files.join(' ')}`);
+            }
+            return git(`commit -m "${message.replace(/"/g, '\\"')}"`);
+        },
+    });
+    registerTool({
+        name: 'git_branch',
+        description: 'Create or switch branches.',
+        parameters: {
+            name: { type: 'string', description: 'Branch name', required: true },
+            create: { type: 'boolean', description: 'Create a new branch (default: false)' },
+        },
+        tier: 'starter',
+        async execute(args) {
+            const name = String(args.name);
+            const create = args.create ? '-b' : '';
+            return git(`checkout ${create} ${name}`.trim());
+        },
+    });
+    registerTool({
+        name: 'git_push',
+        description: 'Push commits to the remote repository. Use with caution.',
+        parameters: {
+            remote: { type: 'string', description: 'Remote name (default: origin)' },
+            branch: { type: 'string', description: 'Branch name (default: current branch)' },
+        },
+        tier: 'starter',
+        async execute(args) {
+            const remote = args.remote ? String(args.remote) : 'origin';
+            const branch = args.branch ? String(args.branch) : '';
+            return git(`push ${remote} ${branch}`.trim(), 60_000);
+        },
+    });
+}
+//# sourceMappingURL=git.js.map

package/dist/tools/git.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,37 @@
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: Record<string, {
+        type: string;
+        description: string;
+        required?: boolean;
+        default?: unknown;
+    }>;
+    execute: (args: Record<string, unknown>) => Promise<string>;
+    /** Tier required: 'free' | 'starter' | 'growth' | 'enterprise' */
+    tier: 'free' | 'starter' | 'growth' | 'enterprise';
+}
+export interface ToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+export interface ToolResult {
+    tool_call_id: string;
+    result: string;
+    error?: boolean;
+}
+export declare function registerTool(tool: ToolDefinition): void;
+export declare function getTool(name: string): ToolDefinition | undefined;
+export declare function getAllTools(): ToolDefinition[];
+export declare function getToolsForTier(tier: string): ToolDefinition[];
+/** Get tool definitions in Claude tool-use format for the API */
+export declare function getToolDefinitionsForApi(tier: string): Array<{
+    name: string;
+    description: string;
+}>;
+/** Execute a tool call locally. Returns the result string. */
+export declare function executeTool(call: ToolCall): Promise<ToolResult>;
+/** Register all built-in tools. Call once at startup. */
+export declare function registerAllTools(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;QACzB,IAAI,EAAE,MAAM,CAAA;QACZ,WAAW,EAAE,MAAM,CAAA;QACnB,QAAQ,CAAC,EAAE,OAAO,CAAA;QAClB,OAAO,CAAC,EAAE,OAAO,CAAA;KAClB,CAAC,CAAA;IACF,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAC3D,kEAAkE;IAClE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,YAAY,CAAA;CACnD;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAID,wBAAgB,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAEvD;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEhE;AAED,wBAAgB,WAAW,IAAI,cAAc,EAAE,CAE9C;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE,CAK9D;AAED,iEAAiE;AACjE,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAKnG;AAED,8DAA8D;AAC9D,wBAAsB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAgBrE;AAED,yDAAyD;AACzD,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAStD"}