@yuaone/tools 0.1.0

package/dist/code-search.js

@@ -0,0 +1,298 @@
+/**
+ * @yuaone/tools — code_search tool
+ *
+ * Phase 1: Symbol-based code search using regex patterns.
+ * (Embedding-based semantic search planned for Phase 2)
+ *
+ * Search modes:
+ * 1. symbol: Find function/class/variable/type/interface definitions by name
+ * 2. reference: Find usages of a specific symbol
+ * 3. definition: Find where a symbol is defined
+ *
+ * Supports: TypeScript, JavaScript, Python
+ * Excludes: node_modules, dist, .git, build, coverage, __pycache__
+ *
+ * riskLevel: 'low' (read-only)
+ */
+import { readFile } from 'node:fs/promises';
+import { relative } from 'node:path';
+import fg from 'fast-glob';
+import { BaseTool } from './base-tool.js';
+const MAX_RESULTS = 50;
+const MAX_FILE_SIZE = 512_000; // 512KB — skip huge files
+const SNIPPET_CONTEXT_LINES = 3;
+/** Language-specific definition patterns. */
+const DEFINITION_PATTERNS = {
+    typescript: (name) => [
+        new RegExp(`(?:export\\s+)?(?:async\\s+)?function\\s+${escapeRegex(name)}\\s*[(<]`, 'gm'),
+        new RegExp(`(?:export\\s+)?class\\s+${escapeRegex(name)}\\s*[{<]`, 'gm'),
+        new RegExp(`(?:export\\s+)?interface\\s+${escapeRegex(name)}\\s*[{<]`, 'gm'),
+        new RegExp(`(?:export\\s+)?type\\s+${escapeRegex(name)}\\s*[=<]`, 'gm'),
+        new RegExp(`(?:export\\s+)?(?:const|let|var)\\s+${escapeRegex(name)}\\s*[=:]`, 'gm'),
+        new RegExp(`(?:export\\s+)?enum\\s+${escapeRegex(name)}\\s*\\{`, 'gm'),
+        // Method definitions
+        new RegExp(`^\\s*(?:async\\s+)?${escapeRegex(name)}\\s*\\(`, 'gm'),
+    ],
+    javascript: (name) => [
+        new RegExp(`(?:export\\s+)?(?:async\\s+)?function\\s+${escapeRegex(name)}\\s*[(<]`, 'gm'),
+        new RegExp(`(?:export\\s+)?class\\s+${escapeRegex(name)}\\s*[{<]`, 'gm'),
+        new RegExp(`(?:export\\s+)?(?:const|let|var)\\s+${escapeRegex(name)}\\s*[=:]`, 'gm'),
+        new RegExp(`^\\s*(?:async\\s+)?${escapeRegex(name)}\\s*\\(`, 'gm'),
+    ],
+    python: (name) => [
+        new RegExp(`^\\s*def\\s+${escapeRegex(name)}\\s*\\(`, 'gm'),
+        new RegExp(`^\\s*class\\s+${escapeRegex(name)}\\s*[:(]`, 'gm'),
+        new RegExp(`^${escapeRegex(name)}\\s*=`, 'gm'),
+    ],
+};
+/** Map file extensions to language keys. */
+const EXT_TO_LANG = {
+    '.ts': 'typescript', '.tsx': 'typescript',
+    '.js': 'javascript', '.jsx': 'javascript', '.mjs': 'javascript', '.cjs': 'javascript',
+    '.py': 'python',
+};
+/** File globs per language. */
+const LANG_GLOBS = {
+    typescript: ['**/*.ts', '**/*.tsx'],
+    javascript: ['**/*.js', '**/*.jsx', '**/*.mjs', '**/*.cjs'],
+    python: ['**/*.py'],
+};
+const IGNORE_DIRS = [
+    '**/node_modules/**', '**/dist/**', '**/.git/**', '**/build/**',
+    '**/coverage/**', '**/__pycache__/**', '**/.next/**', '**/.nuxt/**',
+    '**/vendor/**', '**/.venv/**', '**/venv/**',
+];
+export class CodeSearchTool extends BaseTool {
+    name = 'code_search';
+    description = 'Search for code symbols (functions, classes, types, variables) by name. ' +
+        'Modes: symbol (definitions), reference (usages), definition (where defined). ' +
+        'Supports TypeScript, JavaScript, Python.';
+    riskLevel = 'low';
+    parameters = {
+        query: {
+            type: 'string',
+            description: 'Symbol name or pattern to search for',
+            required: true,
+        },
+        mode: {
+            type: 'string',
+            description: 'Search mode: symbol (find definitions), reference (find usages), definition (find where defined)',
+            required: false,
+            enum: ['symbol', 'reference', 'definition'],
+            default: 'symbol',
+        },
+        path: {
+            type: 'string',
+            description: 'Search scope directory (relative to project root, default: entire project)',
+            required: false,
+        },
+        language: {
+            type: 'string',
+            description: 'Language filter: typescript, javascript, python (default: all supported)',
+            required: false,
+            enum: ['typescript', 'javascript', 'python'],
+        },
+        maxResults: {
+            type: 'number',
+            description: 'Maximum results to return (default: 20)',
+            required: false,
+            default: 20,
+        },
+    };
+    async execute(args, workDir) {
+        const toolCallId = args._toolCallId ?? '';
+        const query = args.query;
+        const mode = args.mode ?? 'symbol';
+        const searchPath = args.path;
+        const language = args.language;
+        const maxResults = Math.min(args.maxResults ?? 20, MAX_RESULTS);
+        if (!query) {
+            return this.fail(toolCallId, 'Missing required parameter: query');
+        }
+        // Validate path if provided
+        let searchDir = workDir;
+        if (searchPath) {
+            try {
+                searchDir = this.validatePath(searchPath, workDir);
+            }
+            catch (err) {
+                return this.fail(toolCallId, err.message);
+            }
+        }
+        try {
+            // Collect file globs
+            let globs;
+            if (language && LANG_GLOBS[language]) {
+                globs = LANG_GLOBS[language];
+            }
+            else {
+                globs = Object.values(LANG_GLOBS).flat();
+            }
+            // Find files
+            const files = await fg(globs, {
+                cwd: searchDir,
+                ignore: IGNORE_DIRS,
+                absolute: true,
+                onlyFiles: true,
+                followSymbolicLinks: false,
+            });
+            // Search files
+            const results = [];
+            for (const filePath of files) {
+                if (results.length >= maxResults)
+                    break;
+                try {
+                    const content = await readFile(filePath, 'utf-8');
+                    if (content.length > MAX_FILE_SIZE)
+                        continue;
+                    const relPath = relative(workDir, filePath);
+                    const ext = filePath.match(/\.[^.]+$/)?.[0] ?? '';
+                    const lang = EXT_TO_LANG[ext];
+                    if (!lang)
+                        continue;
+                    const fileResults = this.searchFile(content, relPath, lang, query, mode);
+                    for (const r of fileResults) {
+                        if (results.length >= maxResults)
+                            break;
+                        results.push(r);
+                    }
+                }
+                catch {
+                    // Skip unreadable files
+                }
+            }
+            // Format output
+            const output = this.formatResults(results, query, mode);
+            return this.ok(toolCallId, output);
+        }
+        catch (err) {
+            return this.fail(toolCallId, `Code search failed: ${err.message}`);
+        }
+    }
+    /**
+     * Search a single file for matching symbols.
+     */
+    searchFile(content, relPath, lang, query, mode) {
+        const lines = content.split('\n');
+        const results = [];
+        if (mode === 'symbol' || mode === 'definition') {
+            // Find definitions of the symbol
+            const patterns = DEFINITION_PATTERNS[lang]?.(query) ?? DEFINITION_PATTERNS.typescript(query);
+            for (const pattern of patterns) {
+                pattern.lastIndex = 0;
+                let match;
+                while ((match = pattern.exec(content)) !== null) {
+                    const lineNumber = content.slice(0, match.index).split('\n').length;
+                    const lineContent = lines[lineNumber - 1]?.trim() ?? '';
+                    const kind = this.inferKind(lineContent, lang);
+                    const column = match.index - content.lastIndexOf('\n', match.index - 1);
+                    results.push({
+                        file: relPath,
+                        line: lineNumber,
+                        column,
+                        content: this.getSnippet(lines, lineNumber),
+                        kind,
+                    });
+                }
+            }
+        }
+        else if (mode === 'reference') {
+            // Find all usages of the symbol (excluding definitions for cleaner results)
+            const refPattern = new RegExp(`\\b${escapeRegex(query)}\\b`, 'g');
+            const defPatterns = DEFINITION_PATTERNS[lang]?.(query) ?? DEFINITION_PATTERNS.typescript(query);
+            // Collect definition line numbers to exclude
+            const defLines = new Set();
+            for (const dp of defPatterns) {
+                dp.lastIndex = 0;
+                let m;
+                while ((m = dp.exec(content)) !== null) {
+                    const ln = content.slice(0, m.index).split('\n').length;
+                    defLines.add(ln);
+                }
+            }
+            let match;
+            while ((match = refPattern.exec(content)) !== null) {
+                const lineNumber = content.slice(0, match.index).split('\n').length;
+                if (defLines.has(lineNumber))
+                    continue; // Skip definition lines
+                const lineContent = lines[lineNumber - 1]?.trim() ?? '';
+                const column = match.index - content.lastIndexOf('\n', match.index - 1);
+                results.push({
+                    file: relPath,
+                    line: lineNumber,
+                    column,
+                    content: lineContent,
+                    kind: 'reference',
+                });
+            }
+        }
+        return results;
+    }
+    /**
+     * Infer the kind of symbol from the line content.
+     */
+    inferKind(line, lang) {
+        if (lang === 'python') {
+            if (/^\s*def\s/.test(line))
+                return 'function';
+            if (/^\s*class\s/.test(line))
+                return 'class';
+            return 'variable';
+        }
+        // TypeScript / JavaScript
+        if (/\bfunction\b/.test(line))
+            return 'function';
+        if (/\bclass\b/.test(line))
+            return 'class';
+        if (/\binterface\b/.test(line))
+            return 'interface';
+        if (/\btype\b/.test(line))
+            return 'type';
+        if (/\benum\b/.test(line))
+            return 'enum';
+        if (/\bconst\b|\blet\b|\bvar\b/.test(line))
+            return 'variable';
+        if (/\basync\b/.test(line))
+            return 'function';
+        return 'symbol';
+    }
+    /**
+     * Get a snippet with context lines around a match.
+     */
+    getSnippet(lines, lineNumber) {
+        const start = Math.max(0, lineNumber - 1 - SNIPPET_CONTEXT_LINES);
+        const end = Math.min(lines.length, lineNumber + SNIPPET_CONTEXT_LINES);
+        return lines
+            .slice(start, end)
+            .map((l, i) => {
+            const ln = start + i + 1;
+            const marker = ln === lineNumber ? '>' : ' ';
+            return `${marker} ${ln}: ${l}`;
+        })
+            .join('\n');
+    }
+    /**
+     * Format results for output.
+     */
+    formatResults(results, query, mode) {
+        if (results.length === 0) {
+            return `No results found for "${query}" (mode: ${mode})`;
+        }
+        const lines = [];
+        lines.push(`[Code Search: "${query}" — mode: ${mode}]`);
+        lines.push(`Found ${results.length} result(s)\n`);
+        for (const r of results) {
+            lines.push(`--- ${r.file}:${r.line} [${r.kind}] ---`);
+            lines.push(r.content);
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+}
+/**
+ * Escape special regex characters in a string.
+ */
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=code-search.js.map

package/dist/code-search.js.map

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

package/dist/design-tools.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @yuaone/tools — Design Mode Tools
+ *
+ * 6 design-specific tools that wrap BrowserTool for visual design iteration:
+ * - design_snapshot:   Get DOM accessibility tree
+ * - design_screenshot: Capture page screenshot
+ * - design_navigate:   Navigate to URL/route
+ * - design_resize:     Change viewport size (presets or custom)
+ * - design_inspect:    Get computed CSS styles for an element
+ * - design_scroll:     Scroll to element or position
+ *
+ * These tools share a single browser session managed via
+ * setDesignBrowserSession() / clearDesignBrowserSession().
+ */
+import type { ParameterDef, RiskLevel } from './types.js';
+import type { ToolResult } from '@yuaone/core';
+import { BaseTool } from './base-tool.js';
+import { BrowserTool } from './browser-tool.js';
+/**
+ * Set the shared browser session used by all design tools.
+ * Call this after opening a browser via BrowserTool's "open" action.
+ */
+export declare function setDesignBrowserSession(sessionId: string, browserTool: BrowserTool): void;
+/** Clear the shared browser session. */
+export declare function clearDesignBrowserSession(): void;
+export declare class DesignSnapshotTool extends BaseTool {
+    readonly name = "design_snapshot";
+    readonly description: string;
+    readonly riskLevel: RiskLevel;
+    readonly parameters: Record<string, ParameterDef>;
+    execute(args: Record<string, unknown>, workDir: string, _abortSignal?: AbortSignal): Promise<ToolResult>;
+}
+export declare class DesignScreenshotTool extends BaseTool {
+    readonly name = "design_screenshot";
+    readonly description: string;
+    readonly riskLevel: RiskLevel;
+    readonly parameters: Record<string, ParameterDef>;
+    execute(args: Record<string, unknown>, workDir: string, _abortSignal?: AbortSignal): Promise<ToolResult>;
+}
+export declare class DesignNavigateTool extends BaseTool {
+    readonly name = "design_navigate";
+    readonly description: string;
+    readonly riskLevel: RiskLevel;
+    readonly parameters: Record<string, ParameterDef>;
+    execute(args: Record<string, unknown>, workDir: string, _abortSignal?: AbortSignal): Promise<ToolResult>;
+}
+export declare class DesignResizeTool extends BaseTool {
+    readonly name = "design_resize";
+    readonly description: string;
+    readonly riskLevel: RiskLevel;
+    readonly parameters: Record<string, ParameterDef>;
+    execute(args: Record<string, unknown>, workDir: string, _abortSignal?: AbortSignal): Promise<ToolResult>;
+}
+export declare class DesignInspectTool extends BaseTool {
+    readonly name = "design_inspect";
+    readonly description: string;
+    readonly riskLevel: RiskLevel;
+    readonly parameters: Record<string, ParameterDef>;
+    execute(args: Record<string, unknown>, workDir: string, _abortSignal?: AbortSignal): Promise<ToolResult>;
+}
+export declare class DesignScrollTool extends BaseTool {
+    readonly name = "design_scroll";
+    readonly description: string;
+    readonly riskLevel: RiskLevel;
+    readonly parameters: Record<string, ParameterDef>;
+    execute(args: Record<string, unknown>, workDir: string, _abortSignal?: AbortSignal): Promise<ToolResult>;
+}
+/** Create instances of all 6 design tools. */
+export declare function createDesignTools(): BaseTool[];
+//# sourceMappingURL=design-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"design-tools.d.ts","sourceRoot":"","sources":["../src/design-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAShD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,IAAI,CAGzF;AAED,wCAAwC;AACxC,wBAAgB,yBAAyB,IAAI,IAAI,CAGhD;AAsBD,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,QAAQ,CAAC,IAAI,qBAAqB;IAClC,QAAQ,CAAC,WAAW,SAG8C;IAClE,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAS;IAEtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAM;IAEjD,OAAO,CACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,WAAW,GACzB,OAAO,CAAC,UAAU,CAAC;CAUvB;AAMD,qBAAa,oBAAqB,SAAQ,QAAQ;IAChD,QAAQ,CAAC,IAAI,uBAAuB;IACpC,QAAQ,CAAC,WAAW,SAG0C;IAC9D,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAS;IAEtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAO/C;IAEI,OAAO,CACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,WAAW,GACzB,OAAO,CAAC,UAAU,CAAC;CAYvB;AAMD,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,QAAQ,CAAC,IAAI,qBAAqB;IAClC,QAAQ,CAAC,WAAW,SAGmC;IACvD,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAS;IAEtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAM/C;IAEI,OAAO,CACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,WAAW,GACzB,OAAO,CAAC,UAAU,CAAC;CAgFvB;AAaD,qBAAa,gBAAiB,SAAQ,QAAQ;IAC5C,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,WAAW,SAEoG;IACxH,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAS;IAEtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAiB/C;IAEI,OAAO,CACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,WAAW,GACzB,OAAO,CAAC,UAAU,CAAC;CA2EvB;AAMD,qBAAa,iBAAkB,SAAQ,QAAQ;IAC7C,QAAQ,CAAC,IAAI,oBAAoB;IACjC,QAAQ,CAAC,WAAW,SAG4C;IAChE,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAS;IAEtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAW/C;IAEI,OAAO,CACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,WAAW,GACzB,OAAO,CAAC,UAAU,CAAC;CAwEvB;AAMD,qBAAa,gBAAiB,SAAQ,QAAQ;IAC5C,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,WAAW,SAG2B;IAC/C,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAS;IAEtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAiB/C;IAEI,OAAO,CACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,WAAW,GACzB,OAAO,CAAC,UAAU,CAAC;CA0EvB;AAMD,8CAA8C;AAC9C,wBAAgB,iBAAiB,IAAI,QAAQ,EAAE,CAS9C"}