@revealui/ai 0.2.0 → 0.2.4

package/dist/tools/coding/safety.js

@@ -0,0 +1,104 @@
+/**
+ * Coding Tools Safety Module
+ * Path sandboxing and command denylist for secure tool execution
+ */
+import { relative, resolve } from 'node:path';
+const DEFAULT_SAFETY = {
+    allowedPaths: [],
+    extraDeniedCommands: [],
+    deniedPathPatterns: [
+        /\.env(?:\.|$)/,
+        /credentials?\.\w+$/,
+        /\.pem$/,
+        /\.key$/,
+        /id_(?:rsa|ed25519|ecdsa)/,
+    ],
+};
+// Commands that should never be executed by the agent
+const DENIED_COMMANDS = [
+    // Destructive system commands
+    'rm -rf /',
+    'mkfs',
+    'dd if=',
+    'chmod -R 777',
+    // Network exfiltration
+    'curl.*--upload',
+    'wget.*--post',
+    'nc -l',
+    'ncat',
+    // Process/system manipulation
+    'kill -9 1',
+    'shutdown',
+    'reboot',
+    'systemctl',
+    // Package-level destruction
+    'npm publish',
+    'pnpm publish',
+    'yarn publish',
+    // Git force operations
+    'git push.*--force',
+    'git reset --hard',
+    'git clean -fd',
+    // Credential access
+    'cat.*\\.env',
+    'cat.*id_rsa',
+    'cat.*credentials',
+];
+// ---------------------------------------------------------------------------
+// Path Validation
+// ---------------------------------------------------------------------------
+export function validatePath(filePath, config) {
+    const resolvedPath = resolve(config.projectRoot, filePath);
+    const rel = relative(config.projectRoot, resolvedPath);
+    // Must be within project root (no ../ escapes)
+    if (rel.startsWith('..') || resolve(resolvedPath) !== resolvedPath.replace(/\/$/, '')) {
+        // Check allowed paths
+        const allowed = config.allowedPaths ?? DEFAULT_SAFETY.allowedPaths;
+        const inAllowed = allowed.some((dir) => resolvedPath.startsWith(resolve(dir)));
+        if (!inAllowed) {
+            return { safe: false, reason: `Path escapes project root: ${filePath}` };
+        }
+    }
+    // Check denied path patterns
+    const deniedPatterns = [
+        ...DEFAULT_SAFETY.deniedPathPatterns,
+        ...(config.deniedPathPatterns ?? []),
+    ];
+    for (const pattern of deniedPatterns) {
+        if (pattern.test(filePath)) {
+            return { safe: false, reason: `Path matches denied pattern: ${filePath}` };
+        }
+    }
+    return { safe: true };
+}
+export function resolveSafePath(filePath, config) {
+    return resolve(config.projectRoot, filePath);
+}
+// ---------------------------------------------------------------------------
+// Command Validation
+// ---------------------------------------------------------------------------
+export function validateCommand(command, config) {
+    const allDenied = [
+        ...DENIED_COMMANDS,
+        ...(config.extraDeniedCommands ?? DEFAULT_SAFETY.extraDeniedCommands),
+    ];
+    for (const pattern of allDenied) {
+        if (new RegExp(pattern, 'i').test(command)) {
+            return { safe: false, reason: `Command matches denied pattern: ${pattern}` };
+        }
+    }
+    return { safe: true };
+}
+// ---------------------------------------------------------------------------
+// Shared Config Builder
+// ---------------------------------------------------------------------------
+let _activeConfig;
+export function configureSafety(config) {
+    _activeConfig = config;
+}
+export function getSafetyConfig() {
+    if (!_activeConfig) {
+        throw new Error('Safety not configured. Call configureSafety() before using coding tools.');
+    }
+    return _activeConfig;
+}

package/dist/tools/coding/shell-exec.d.ts

@@ -0,0 +1,6 @@
+/**
+ * shell_exec — Sandboxed shell command execution
+ */
+import type { Tool } from '../base.js';
+export declare const shellExecTool: Tool;
+//# sourceMappingURL=shell-exec.d.ts.map

package/dist/tools/coding/shell-exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-exec.d.ts","sourceRoot":"","sources":["../../../src/tools/coding/shell-exec.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAC;AASnD,eAAO,MAAM,aAAa,EAAE,IAwF3B,CAAC"}

package/dist/tools/coding/shell-exec.js

@@ -0,0 +1,79 @@
+/**
+ * shell_exec — Sandboxed shell command execution
+ */
+import { execSync } from 'node:child_process';
+import { z } from 'zod/v4';
+import { getSafetyConfig, validateCommand } from './safety.js';
+/** Default timeout: 30 seconds */
+const DEFAULT_TIMEOUT_MS = 30_000;
+/** Max output size: 100KB */
+const MAX_OUTPUT_BYTES = 100 * 1024;
+export const shellExecTool = {
+    name: 'shell_exec',
+    label: 'Run Command',
+    description: 'Execute a shell command in the project directory. Commands are validated against a safety denylist. Use for build scripts, test runners, package managers, and general automation.',
+    parameters: z.object({
+        command: z.string().describe('The shell command to execute'),
+        timeout: z
+            .number()
+            .optional()
+            .describe(`Timeout in milliseconds (default: ${DEFAULT_TIMEOUT_MS}, max: 300000)`),
+        cwd: z
+            .string()
+            .optional()
+            .describe('Working directory relative to project root (default: project root)'),
+    }),
+    async execute(params) {
+        const { command, timeout, cwd } = params;
+        const config = getSafetyConfig();
+        // Validate command against denylist
+        const check = validateCommand(command, config);
+        if (!check.safe) {
+            return { success: false, error: check.reason };
+        }
+        const timeoutMs = Math.min(timeout ?? DEFAULT_TIMEOUT_MS, 300_000);
+        const workDir = cwd ? `${config.projectRoot}/${cwd}` : config.projectRoot;
+        try {
+            const output = execSync(command, {
+                cwd: workDir,
+                timeout: timeoutMs,
+                maxBuffer: MAX_OUTPUT_BYTES,
+                encoding: 'utf8',
+                stdio: ['pipe', 'pipe', 'pipe'],
+                env: {
+                    ...process.env,
+                    // Prevent interactive prompts
+                    CI: 'true',
+                    FORCE_COLOR: '0',
+                },
+            });
+            const trimmed = output.trim();
+            const lines = trimmed.split('\n').length;
+            return {
+                success: true,
+                data: { command, exitCode: 0, output: trimmed },
+                content: trimmed.length > 2000
+                    ? `Command succeeded (${lines} lines, truncated):\n${trimmed.slice(0, 2000)}…`
+                    : `Command succeeded:\n${trimmed}`,
+            };
+        }
+        catch (err) {
+            const execErr = err;
+            if (execErr.killed) {
+                return {
+                    success: false,
+                    error: `Command timed out after ${timeoutMs}ms: ${command}`,
+                };
+            }
+            const stdout = (execErr.stdout ?? '').toString().trim();
+            const stderr = (execErr.stderr ?? '').toString().trim();
+            const combined = [stdout, stderr].filter(Boolean).join('\n');
+            const exitCode = execErr.status ?? 1;
+            return {
+                success: false,
+                data: { command, exitCode, stdout, stderr },
+                error: `Command failed (exit ${exitCode}):\n${combined.slice(0, 2000)}`,
+            };
+        }
+    },
+};

package/dist/tools/coding/test-runner.d.ts

@@ -0,0 +1,10 @@
+/**
+ * test_runner — Run tests and return structured results
+ *
+ * Detects the test framework (Vitest, Jest, Mocha) and runs tests with
+ * machine-parseable output. Returns structured pass/fail/skip counts
+ * and failure details.
+ */
+import type { Tool } from '../base.js';
+export declare const testRunnerTool: Tool;
+//# sourceMappingURL=test-runner.d.ts.map

package/dist/tools/coding/test-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-runner.d.ts","sourceRoot":"","sources":["../../../src/tools/coding/test-runner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAC;AAqJnD,eAAO,MAAM,cAAc,EAAE,IA0G5B,CAAC"}

package/dist/tools/coding/test-runner.js

@@ -0,0 +1,214 @@
+/**
+ * test_runner — Run tests and return structured results
+ *
+ * Detects the test framework (Vitest, Jest, Mocha) and runs tests with
+ * machine-parseable output. Returns structured pass/fail/skip counts
+ * and failure details.
+ */
+import { execSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { z } from 'zod/v4';
+import { getSafetyConfig } from './safety.js';
+/** Default timeout: 120 seconds (tests can be slow) */
+const DEFAULT_TIMEOUT_MS = 120_000;
+/** Max output: 200KB */
+const MAX_OUTPUT_BYTES = 200 * 1024;
+function detectFramework(projectRoot) {
+    const pkgPath = join(projectRoot, 'package.json');
+    if (!existsSync(pkgPath))
+        return 'unknown';
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const pkg = JSON.parse(execSync(`cat "${pkgPath}"`, { encoding: 'utf8', timeout: 5000 }));
+        const deps = {
+            ...pkg.dependencies,
+            ...pkg.devDependencies,
+        };
+        if (deps.vitest)
+            return 'vitest';
+        if (deps.jest || deps['@jest/core'])
+            return 'jest';
+        if (deps.mocha)
+            return 'mocha';
+    }
+    catch {
+        // Fall through
+    }
+    return 'unknown';
+}
+function buildCommand(framework, file, grep) {
+    const fileArg = file ? ` ${file}` : '';
+    const grepArg = grep ? ` -t "${grep}"` : '';
+    switch (framework) {
+        case 'vitest':
+            return `npx vitest run${fileArg}${grep ? ` --reporter=verbose` : ''} --no-color`;
+        case 'jest':
+            return `npx jest${fileArg}${grepArg} --no-color --forceExit`;
+        case 'mocha':
+            return `npx mocha${fileArg}${grepArg} --no-color`;
+        default:
+            // Try pnpm test as fallback
+            return `pnpm test${fileArg ? ` -- ${fileArg.trim()}` : ''}`;
+    }
+}
+function parseVitestOutput(output) {
+    const failures = [];
+    // Parse "Tests  X passed | Y failed | Z skipped (W)"
+    const summaryMatch = output.match(/Tests\s+(?:(\d+)\s+passed)?[^(]*?(?:(\d+)\s+failed)?[^(]*?(?:(\d+)\s+skipped)?[^(]*?\((\d+)\)/);
+    const passed = summaryMatch ? Number.parseInt(summaryMatch[1] ?? '0', 10) : 0;
+    const failed = summaryMatch ? Number.parseInt(summaryMatch[2] ?? '0', 10) : 0;
+    const skipped = summaryMatch ? Number.parseInt(summaryMatch[3] ?? '0', 10) : 0;
+    const total = summaryMatch
+        ? Number.parseInt(summaryMatch[4] ?? '0', 10)
+        : passed + failed + skipped;
+    // Parse duration
+    const durationMatch = output.match(/Duration\s+([\d.]+s)/);
+    const duration = durationMatch?.[1];
+    // Parse failure details: "FAIL  path/to/file.test.ts > suite > test name"
+    const failureBlocks = output.split(/(?=FAIL\s)/);
+    for (const block of failureBlocks) {
+        const headerMatch = block.match(/FAIL\s+(.+?)(?:\s+>\s+(.+))?$/m);
+        if (headerMatch) {
+            const file = headerMatch[1]?.trim();
+            const name = headerMatch[2]?.trim() ?? file ?? 'unknown';
+            // Extract assertion/error message
+            const errorMatch = block.match(/(?:AssertionError|Error|Expected|Received).*$/m);
+            const message = errorMatch?.[0]?.trim() ?? 'Test failed';
+            failures.push({ name, file, message: message.slice(0, 300) });
+        }
+    }
+    return { passed, failed, skipped, total, duration, failures };
+}
+function parseGenericOutput(output) {
+    const failures = [];
+    // Try common patterns
+    const passMatch = output.match(/(\d+)\s+(?:passing|passed)/i);
+    const failMatch = output.match(/(\d+)\s+(?:failing|failed)/i);
+    const skipMatch = output.match(/(\d+)\s+(?:skipped|pending)/i);
+    const passed = passMatch ? Number.parseInt(passMatch[1] ?? '0', 10) : 0;
+    const failed = failMatch ? Number.parseInt(failMatch[1] ?? '0', 10) : 0;
+    const skipped = skipMatch ? Number.parseInt(skipMatch[1] ?? '0', 10) : 0;
+    // Extract failure lines
+    const lines = output.split('\n');
+    let inFailure = false;
+    let currentFailure = {};
+    for (const line of lines) {
+        if (/(?:FAIL|✗|✕|×)\s+/.test(line)) {
+            if (currentFailure.name) {
+                failures.push({
+                    name: currentFailure.name,
+                    file: currentFailure.file,
+                    message: currentFailure.message ?? 'Test failed',
+                });
+            }
+            inFailure = true;
+            currentFailure = { name: line.trim().slice(0, 200) };
+        }
+        else if (inFailure && /(?:Error|Expected|Received|assert)/i.test(line)) {
+            currentFailure.message = line.trim().slice(0, 300);
+            inFailure = false;
+        }
+    }
+    if (currentFailure.name) {
+        failures.push({
+            name: currentFailure.name,
+            file: currentFailure.file,
+            message: currentFailure.message ?? 'Test failed',
+        });
+    }
+    return {
+        passed,
+        failed,
+        skipped,
+        total: passed + failed + skipped,
+        failures,
+    };
+}
+export const testRunnerTool = {
+    name: 'test_runner',
+    label: 'Run Tests',
+    description: 'Run tests and return structured results with pass/fail counts and failure details. Auto-detects the test framework (Vitest, Jest, Mocha). Can run all tests or target a specific file.',
+    parameters: z.object({
+        file: z
+            .string()
+            .optional()
+            .describe('Specific test file or pattern to run (e.g., "src/__tests__/auth.test.ts")'),
+        grep: z.string().optional().describe('Filter tests by name pattern'),
+        timeout: z
+            .number()
+            .optional()
+            .describe(`Timeout in milliseconds (default: ${DEFAULT_TIMEOUT_MS}, max: 300000)`),
+    }),
+    async execute(params) {
+        const { file, grep, timeout } = params;
+        const config = getSafetyConfig();
+        const timeoutMs = Math.min(timeout ?? DEFAULT_TIMEOUT_MS, 300_000);
+        const framework = detectFramework(config.projectRoot);
+        const command = buildCommand(framework, file, grep);
+        let stdout = '';
+        let stderr = '';
+        let exitCode = 0;
+        try {
+            stdout = execSync(command, {
+                cwd: config.projectRoot,
+                timeout: timeoutMs,
+                maxBuffer: MAX_OUTPUT_BYTES,
+                encoding: 'utf8',
+                stdio: ['pipe', 'pipe', 'pipe'],
+                env: {
+                    ...process.env,
+                    CI: 'true',
+                    FORCE_COLOR: '0',
+                    NODE_OPTIONS: '--experimental-vm-modules',
+                },
+            });
+        }
+        catch (err) {
+            const execErr = err;
+            if (execErr.killed || execErr.signal === 'SIGTERM') {
+                return {
+                    success: false,
+                    error: `Tests timed out after ${timeoutMs}ms`,
+                    data: {
+                        framework,
+                        command,
+                        exitCode: -1,
+                        summary: { passed: 0, failed: 0, skipped: 0, total: 0, failures: [] },
+                    },
+                };
+            }
+            exitCode = execErr.status ?? 1;
+            stdout = (execErr.stdout ?? '').toString();
+            stderr = (execErr.stderr ?? '').toString();
+        }
+        const combined = [stdout, stderr].filter(Boolean).join('\n');
+        // Parse results
+        const summary = framework === 'vitest' ? parseVitestOutput(combined) : parseGenericOutput(combined);
+        // Build token-efficient content for LLM
+        const statusIcon = summary.failed > 0 ? '✗' : '✓';
+        const lines = [
+            `${statusIcon} Tests: ${summary.passed} passed, ${summary.failed} failed, ${summary.skipped} skipped (${summary.total} total)`,
+        ];
+        if (summary.duration)
+            lines.push(`Duration: ${summary.duration}`);
+        if (file)
+            lines.push(`File: ${file}`);
+        lines.push(`Framework: ${framework}`);
+        if (summary.failures.length > 0) {
+            lines.push('', 'Failures:');
+            for (const f of summary.failures.slice(0, 10)) {
+                lines.push(`  ${f.file ? `${f.file}: ` : ''}${f.name}`);
+                lines.push(`    ${f.message}`);
+            }
+            if (summary.failures.length > 10) {
+                lines.push(`  ... and ${summary.failures.length - 10} more`);
+            }
+        }
+        return {
+            success: summary.failed === 0,
+            data: { framework, command, exitCode, summary },
+            content: lines.join('\n'),
+        };
+    },
+};

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

@@ -1 +1 @@
-{"version":3,"file":"deduplicator.d.ts","sourceRoot":"","sources":["../../src/tools/deduplicator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AA8B3C,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,KAAK,CAAqC;IAElD,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO;IAIvD,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS;IAIpE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI;IAInE,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}
+{"version":3,"file":"deduplicator.d.ts","sourceRoot":"","sources":["../../src/tools/deduplicator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AA8B5C,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,KAAK,CAAsC;IAEnD,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO;IAIvD,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS;IAIpE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI;IAInE,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/tools/document-summarizer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"document-summarizer.d.ts","sourceRoot":"","sources":["../../src/tools/document-summarizer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAGnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,WAAW,CAAA;AAUjD,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,CA8EtF"}
+{"version":3,"file":"document-summarizer.d.ts","sourceRoot":"","sources":["../../src/tools/document-summarizer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,WAAW,CAAC;AAUlD,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,CA8EtF"}

package/dist/tools/mcp-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-adapter.d.ts","sourceRoot":"","sources":["../../src/tools/mcp-adapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,WAAW,CAAA;AAEjD,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAA;QACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QACnC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KACpB,CAAA;CACF;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACxD;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,IAAI,KAAK,CAAC;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IACnF,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAChF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,CAuB9E;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAA;CAAE,GACvC,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAa1D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,EAAE,CAkC9D"}
+{"version":3,"file":"mcp-adapter.d.ts","sourceRoot":"","sources":["../../src/tools/mcp-adapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,WAAW,CAAC;AAElD,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACzD;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,IAAI,KAAK,CAAC;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACpF,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,CAuB9E;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAA;CAAE,GACvC,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAa1D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,EAAE,CAkC9D"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/memory/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/memory/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/tools/memory/store-memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store-memory.d.ts","sourceRoot":"","sources":["../../../src/tools/memory/store-memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAC1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAA;AAC5E,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAA;AAElD,QAAA,MAAM,uBAAuB;;;;iBAI3B,CAAA;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEvE;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAkEnF"}
+{"version":3,"file":"store-memory.d.ts","sourceRoot":"","sources":["../../../src/tools/memory/store-memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAC;AAEnD,QAAA,MAAM,uBAAuB;;;;iBAI3B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAkEnF"}

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

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAEjD,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAA+B;IAE5C,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAO1B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI9B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAInC,MAAM,IAAI,IAAI,EAAE;IAIhB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,kBAAkB,IAAI,cAAc,EAAE;IAWhC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;CAgBlE;AAED,eAAO,MAAM,kBAAkB,cAAqB,CAAA"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAElD,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAgC;IAE7C,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAO1B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI9B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAInC,MAAM,IAAI,IAAI,EAAE;IAIhB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,kBAAkB,IAAI,cAAc,EAAE;IAWhC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;CAgBlE;AAED,eAAO,MAAM,kBAAkB,cAAqB,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"ticket-tools.d.ts","sourceRoot":"","sources":["../../src/tools/ticket-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,WAAW,CAAA;AAEjD;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,YAAY,CACV,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE;QACJ,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACnC,GACA,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;IAEjD,aAAa,CACX,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;CAChE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,IAAI,EAAE,CAgExF"}
+{"version":3,"file":"ticket-tools.d.ts","sourceRoot":"","sources":["../../src/tools/ticket-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,WAAW,CAAC;AAElD;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,YAAY,CACV,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE;QACJ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GACA,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAElD,aAAa,CACX,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;CACjE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,IAAI,EAAE,CAgExF"}

package/dist/tools/web/duck-duck-go.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"duck-duck-go.d.ts","sourceRoot":"","sources":["../../../src/tools/web/duck-duck-go.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAA;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAmB,MAAM,YAAY,CAAA;AAiCvF;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,iBAAiB;IAC1D,QAAQ,CAAC,IAAI,gBAAe;IAEtB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAwD5E;AAiBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CA8CrE;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,aAAa,EAAE,IA+C3B,CAAA"}
+{"version":3,"file":"duck-duck-go.d.ts","sourceRoot":"","sources":["../../../src/tools/web/duck-duck-go.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAmB,MAAM,YAAY,CAAC;AA0BxF;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,iBAAiB;IAC1D,QAAQ,CAAC,IAAI,gBAAgB;IAEvB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAwD5E;AAiBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CA8CrE;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,aAAa,EAAE,IA+C3B,CAAC"}

package/dist/tools/web/exa.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exa.d.ts","sourceRoot":"","sources":["../../../src/tools/web/exa.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAmB,MAAM,YAAY,CAAA;AAsBvF;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,WAAY,YAAW,iBAAiB;IACnD,QAAQ,CAAC,IAAI,SAAQ;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;gBAEnB,MAAM,EAAE,MAAM;IAKpB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;CA+C5E"}
+{"version":3,"file":"exa.d.ts","sourceRoot":"","sources":["../../../src/tools/web/exa.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAmB,MAAM,YAAY,CAAC;AAsBxF;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,WAAY,YAAW,iBAAiB;IACnD,QAAQ,CAAC,IAAI,SAAS;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,MAAM;IAKpB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;CA+C5E"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/web/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAC1F,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/web/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC3F,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/tools/web/scraper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scraper.d.ts","sourceRoot":"","sources":["../../../src/tools/web/scraper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAA;AA+ClD,eAAO,MAAM,cAAc,EAAE,IAwE5B,CAAA"}
+{"version":3,"file":"scraper.d.ts","sourceRoot":"","sources":["../../../src/tools/web/scraper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAC;AA+CnD,eAAO,MAAM,cAAc,EAAE,IAwE5B,CAAC"}

package/dist/tools/web/tavily.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tavily.d.ts","sourceRoot":"","sources":["../../../src/tools/web/tavily.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAmB,MAAM,YAAY,CAAA;AAsBvF;;;;;;;;;;;;;;GAcG;AACH,qBAAa,cAAe,YAAW,iBAAiB;IACtD,QAAQ,CAAC,IAAI,YAAW;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;gBAEnB,MAAM,EAAE,MAAM;IAKpB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;CA0C5E"}
+{"version":3,"file":"tavily.d.ts","sourceRoot":"","sources":["../../../src/tools/web/tavily.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAmB,MAAM,YAAY,CAAC;AAsBxF;;;;;;;;;;;;;;GAcG;AACH,qBAAa,cAAe,YAAW,iBAAiB;IACtD,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,MAAM;IAKpB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;CA0C5E"}

package/dist/tools/web/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/web/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,eAAe,EAAE,CAAA;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;CACtE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/web/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACvE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@revealui/ai",
-  "version": "0.2.0",
+  "version": "0.2.4",
   "description": "[Pro] AI system for RevealUI - memory, LLM, orchestration, and tools",
   "keywords": [
     "agent",
@@ -25,18 +25,17 @@
   "dependencies": {
     "lru-cache": "^11.2.5",
     "zod": "^4.3.5",
-    "@revealui/db": "0.3.0",
-    "@revealui/core": "0.3.0",
-    "@revealui/contracts": "1.3.0"
+    "@revealui/db": "0.3.3",
+    "@revealui/contracts": "1.3.3",
+    "@revealui/core": "0.5.2"
   },
   "devDependencies": {
     "@testing-library/react": "^16.3.2",
-    "@testing-library/react-hooks": "^8.0.1",
     "@vitest/coverage-v8": "^4.0.18",
-    "jsdom": "^27.4.0",
+    "jsdom": "^29.0.1",
     "react": "^19.2.3",
     "react-dom": "^19.2.3",
-    "typescript": "^5.9.3",
+    "typescript": "^6.0.2",
     "vitest": "^4.0.18",
     "dev": "0.0.1"
   },
@@ -116,6 +115,26 @@
     "./orchestration/agent": {
       "types": "./dist/orchestration/agent.d.ts",
       "import": "./dist/orchestration/agent.js"
+    },
+    "./tools/coding": {
+      "types": "./dist/tools/coding/index.d.ts",
+      "import": "./dist/tools/coding/index.js"
+    },
+    "./inference": {
+      "types": "./dist/inference/index.d.ts",
+      "import": "./dist/inference/index.js"
+    },
+    "./inference/context-budget": {
+      "types": "./dist/inference/context-budget.d.ts",
+      "import": "./dist/inference/context-budget.js"
+    },
+    "./inference/tool-result-compressor": {
+      "types": "./dist/inference/tool-result-compressor.d.ts",
+      "import": "./dist/inference/tool-result-compressor.js"
+    },
+    "./inference/task-decomposer": {
+      "types": "./dist/inference/task-decomposer.d.ts",
+      "import": "./dist/inference/task-decomposer.js"
     }
   },
   "files": [