@kooka/agent-sdk 0.1.0

package/dist/tools/builtin/grep.js

@@ -0,0 +1,190 @@
+import * as fs from 'fs/promises';
+import { createReadStream } from 'fs';
+import * as path from 'path';
+import { glob } from 'glob';
+import * as readline from 'readline';
+import { optionalString, requireString } from '@kooka/core';
+import { getWorkspaceRoot, resolveToolPath, toPosixPath } from './workspace.js';
+const MAX_LINE_LENGTH = 2000;
+const MAX_MATCHES = 100;
+const MAX_FILE_BYTES = 2_000_000;
+export const grepTool = {
+    id: 'grep',
+    name: 'Search in Files',
+    description: 'Search for a regex pattern in files. Supports optional path (file or directory, workspace-scoped) and include glob. Returns up to 100 matches grouped by file.',
+    parameters: {
+        type: 'object',
+        properties: {
+            pattern: { type: 'string', description: 'Regex pattern to search for' },
+            path: {
+                type: 'string',
+                description: 'File or directory to search in (absolute or workspace-relative). Must be within the current workspace. Omit for workspace root.',
+            },
+            include: { type: 'string', description: 'File glob to include (e.g., **/*.{ts,tsx})' },
+        },
+        required: ['pattern'],
+    },
+    execution: { type: 'function', handler: 'builtin.grep' },
+    metadata: {
+        category: 'file',
+        icon: 'search',
+        requiresApproval: false,
+        permission: 'grep',
+        readOnly: true,
+        permissionPatterns: [
+            { arg: 'pattern', kind: 'raw' },
+            { arg: 'path', kind: 'path' },
+            { arg: 'include', kind: 'raw' },
+        ],
+    },
+};
+function looksBinary(text) {
+    // basic guard: if file contains NUL, treat as binary
+    return text.includes('\u0000');
+}
+export const grepHandler = async (args, context) => {
+    try {
+        const patternResult = requireString(args, 'pattern');
+        if ('error' in patternResult)
+            return { success: false, error: patternResult.error };
+        const rawPattern = patternResult.value;
+        let re;
+        try {
+            re = new RegExp(rawPattern, 'i');
+        }
+        catch (error) {
+            return { success: false, error: `Invalid regex pattern: ${rawPattern}\n${error instanceof Error ? error.message : String(error)}` };
+        }
+        const baseDir = optionalString(args, 'path');
+        const include = optionalString(args, 'include');
+        const notes = [];
+        const workspaceRoot = getWorkspaceRoot(context);
+        let targetAbsPath = workspaceRoot;
+        if (baseDir) {
+            const resolved = resolveToolPath(baseDir, { ...context, allowExternalPaths: true });
+            if (resolved.isExternal) {
+                notes.push('Provided path was outside the current workspace; searching the workspace root instead.');
+                targetAbsPath = workspaceRoot;
+            }
+            else {
+                targetAbsPath = resolved.absPath;
+            }
+        }
+        let stat;
+        try {
+            stat = await fs.stat(targetAbsPath);
+        }
+        catch {
+            stat = null;
+        }
+        const isFile = !!stat?.isFile?.();
+        const isDir = !!stat?.isDirectory?.();
+        const matchesByFile = new Map();
+        let totalMatches = 0;
+        const addMatch = (m) => {
+            if (totalMatches >= MAX_MATCHES)
+                return;
+            const list = matchesByFile.get(m.filePath) ?? [];
+            list.push(m);
+            matchesByFile.set(m.filePath, list);
+            totalMatches++;
+        };
+        const searchFile = async (filePath) => {
+            if (totalMatches >= MAX_MATCHES)
+                return;
+            try {
+                const stat = await fs.stat(filePath);
+                if (!stat.isFile())
+                    return;
+                if (stat.size > MAX_FILE_BYTES)
+                    return;
+            }
+            catch {
+                return;
+            }
+            const stream = createReadStream(filePath, { encoding: 'utf8' });
+            const rl = readline.createInterface({ input: stream, crlfDelay: Infinity });
+            let lineNumber = 0;
+            try {
+                for await (const line of rl) {
+                    if (totalMatches >= MAX_MATCHES)
+                        break;
+                    lineNumber += 1;
+                    const lineText = String(line ?? '');
+                    if (looksBinary(lineText)) {
+                        break;
+                    }
+                    if (!re.test(lineText))
+                        continue;
+                    const trimmed = lineText.length > MAX_LINE_LENGTH ? lineText.slice(0, MAX_LINE_LENGTH) + '...' : lineText;
+                    addMatch({ filePath, line: lineNumber, text: trimmed });
+                }
+            }
+            catch {
+                // ignore read/parse errors
+            }
+            finally {
+                try {
+                    rl.close();
+                }
+                catch { }
+                try {
+                    stream.destroy();
+                }
+                catch { }
+            }
+        };
+        if (isFile) {
+            await searchFile(targetAbsPath);
+        }
+        else if (isDir) {
+            const pattern = include && include.trim() ? include.trim() : '**/*';
+            const relMatches = await glob(pattern, {
+                cwd: targetAbsPath,
+                ignore: ['**/node_modules/**', '**/.git/**'],
+                nodir: true,
+                dot: true,
+                follow: false,
+                windowsPathsNoEscape: true,
+            });
+            for (const rel of relMatches) {
+                if (totalMatches >= MAX_MATCHES)
+                    break;
+                await searchFile(path.resolve(targetAbsPath, rel));
+            }
+        }
+        else {
+            return { success: true, data: 'No files found' };
+        }
+        const files = Array.from(matchesByFile.keys()).sort((a, b) => a.localeCompare(b));
+        if (files.length === 0) {
+            const outputLines = [];
+            if (notes.length > 0) {
+                outputLines.push(`Note: ${notes.join(' ')}`, '');
+            }
+            outputLines.push('No matches found');
+            return { success: true, data: outputLines.join('\n') };
+        }
+        const lines = [];
+        if (notes.length > 0) {
+            lines.push(`Note: ${notes.join(' ')}`, '');
+        }
+        for (const filePath of files) {
+            const rel = context.workspaceRoot ? path.relative(context.workspaceRoot, filePath) : filePath;
+            lines.push(`${toPosixPath(rel)}:`);
+            const matches = matchesByFile.get(filePath) ?? [];
+            for (const m of matches) {
+                lines.push(`  ${String(m.line).padStart(5, ' ')}| ${m.text}`);
+            }
+            lines.push('');
+        }
+        if (totalMatches >= MAX_MATCHES) {
+            lines.push('(Results are truncated.)');
+        }
+        return { success: true, data: lines.join('\n').trimEnd() };
+    }
+    catch (error) {
+        return { success: false, error: error instanceof Error ? error.message : String(error) };
+    }
+};
+//# sourceMappingURL=grep.js.map

package/dist/tools/builtin/grep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grep.js","sourceRoot":"","sources":["../../../src/tools/builtin/grep.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,MAAM,IAAI,CAAC;AACtC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AAGrC,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEhF,MAAM,eAAe,GAAG,IAAI,CAAC;AAC7B,MAAM,WAAW,GAAG,GAAG,CAAC;AACxB,MAAM,cAAc,GAAG,SAAS,CAAC;AAEjC,MAAM,CAAC,MAAM,QAAQ,GAAmB;IACtC,EAAE,EAAE,MAAM;IACV,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,gKAAgK;IAClK,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;YACvE,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,iIAAiI;aACpI;YACD,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4CAA4C,EAAE;SACvF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IACD,SAAS,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,EAAE;IACxD,QAAQ,EAAE;QACR,QAAQ,EAAE,MAAM;QAChB,IAAI,EAAE,QAAQ;QACd,gBAAgB,EAAE,KAAK;QACvB,UAAU,EAAE,MAAM;QAClB,QAAQ,EAAE,IAAI;QACd,kBAAkB,EAAE;YAClB,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE;YAC/B,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;YAC7B,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE;SAChC;KACF;CACF,CAAC;AAIF,SAAS,WAAW,CAAC,IAAY;IAC/B,qDAAqD;IACrD,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAgB,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;IAC9D,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,aAAa,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACrD,IAAI,OAAO,IAAI,aAAa;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,CAAC,KAAK,EAAE,CAAC;QACpF,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,CAAC;QAEvC,IAAI,EAAU,CAAC;QACf,IAAI,CAAC;YACH,EAAE,GAAG,IAAI,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,0BAA0B,UAAU,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QACtI,CAAC;QAED,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAEhD,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,aAAa,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAEhD,IAAI,aAAa,GAAG,aAAa,CAAC;QAClC,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC,CAAC;YACpF,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;gBACxB,KAAK,CAAC,IAAI,CAAC,wFAAwF,CAAC,CAAC;gBACrG,aAAa,GAAG,aAAa,CAAC;YAChC,CAAC;iBAAM,CAAC;gBACN,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC;YACnC,CAAC;QACH,CAAC;QAED,IAAI,IAAS,CAAC;QACd,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,GAAG,IAAI,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,CAAC;QAEtC,MAAM,aAAa,GAAG,IAAI,GAAG,EAAmB,CAAC;QACjD,IAAI,YAAY,GAAG,CAAC,CAAC;QAErB,MAAM,QAAQ,GAAG,CAAC,CAAQ,EAAE,EAAE;YAC5B,IAAI,YAAY,IAAI,WAAW;gBAAE,OAAO;YACxC,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACjD,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACb,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YACpC,YAAY,EAAE,CAAC;QACjB,CAAC,CAAC;QAEF,MAAM,UAAU,GAAG,KAAK,EAAE,QAAgB,EAAE,EAAE;YAC5C,IAAI,YAAY,IAAI,WAAW;gBAAE,OAAO;YACxC,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACrC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;oBAAE,OAAO;gBAC3B,IAAI,IAAI,CAAC,IAAI,GAAG,cAAc;oBAAE,OAAO;YACzC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO;YACT,CAAC;YAED,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;YAChE,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC5E,IAAI,UAAU,GAAG,CAAC,CAAC;YACnB,IAAI,CAAC;gBACH,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,EAAE,EAAE,CAAC;oBAC5B,IAAI,YAAY,IAAI,WAAW;wBAAE,MAAM;oBACvC,UAAU,IAAI,CAAC,CAAC;oBAEhB,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;oBACpC,IAAI,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;wBAC1B,MAAM;oBACR,CAAC;oBACD,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC;wBAAE,SAAS;oBAEjC,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;oBAC1G,QAAQ,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;gBAC1D,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,2BAA2B;YAC7B,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC;oBACH,EAAE,CAAC,KAAK,EAAE,CAAC;gBACb,CAAC;gBAAC,MAAM,CAAC,CAAA,CAAC;gBACV,IAAI,CAAC;oBACH,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,CAAC;gBAAC,MAAM,CAAC,CAAA,CAAC;YACZ,CAAC;QACH,CAAC,CAAC;QAEF,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,UAAU,CAAC,aAAa,CAAC,CAAC;QAClC,CAAC;aAAM,IAAI,KAAK,EAAE,CAAC;YACjB,MAAM,OAAO,GAAG,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;YACpE,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE;gBACrC,GAAG,EAAE,aAAa;gBAClB,MAAM,EAAE,CAAC,oBAAoB,EAAE,YAAY,CAAC;gBAC5C,KAAK,EAAE,IAAI;gBACX,GAAG,EAAE,IAAI;gBACT,MAAM,EAAE,KAAK;gBACb,oBAAoB,EAAE,IAAI;aAC3B,CAAC,CAAC;YAEH,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;gBAC7B,IAAI,YAAY,IAAI,WAAW;oBAAE,MAAM;gBACvC,MAAM,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;QACnD,CAAC;QAED,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QAClF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,WAAW,GAAa,EAAE,CAAC;YACjC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrB,WAAW,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YACnD,CAAC;YACD,WAAW,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACzD,CAAC;QAED,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAC7C,CAAC;QAED,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;YAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC9F,KAAK,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACnC,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YAClD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAChE,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,IAAI,YAAY,IAAI,WAAW,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACzC,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;IAC7D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC3F,CAAC;AACH,CAAC,CAAC"}

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

@@ -0,0 +1,15 @@
+import type { ToolDefinition, ToolHandler } from '../../types.js';
+import { ToolRegistry } from '../registry.js';
+export type BuiltinToolsOptions = {
+    skills?: {
+        enabled?: boolean;
+        paths?: string[];
+    };
+};
+export declare const DEFAULT_SKILL_PATHS: string[];
+export declare function getBuiltinTools(options?: BuiltinToolsOptions): Array<{
+    tool: ToolDefinition;
+    handler: ToolHandler;
+}>;
+export declare function registerBuiltinTools(registry: ToolRegistry, options?: BuiltinToolsOptions): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAU9C,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;CACH,CAAC;AAEF,eAAO,MAAM,mBAAmB,UAQ/B,CAAC;AAEF,wBAAgB,eAAe,CAAC,OAAO,GAAE,mBAAwB,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CAAC,CAexH;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,GAAE,mBAAwB,GAAG,IAAI,CAIpG"}

package/dist/tools/builtin/index.js

@@ -0,0 +1,37 @@
+import { bashHandler, bashTool } from './bash.js';
+import { globHandler, globTool } from './glob.js';
+import { grepHandler, grepTool } from './grep.js';
+import { listHandler, listTool } from './list.js';
+import { readHandler, readTool } from './read.js';
+import { createSkillTool } from './skill.js';
+import { writeHandler, writeTool } from './write.js';
+export const DEFAULT_SKILL_PATHS = [
+    '.lingyun/skills',
+    '.claude/skills',
+    '.opencode/skill',
+    '.opencode/skills',
+    '~/.config/lingyun/skills',
+    '~/.codex/skills',
+    '~/.claude/skills',
+];
+export function getBuiltinTools(options = {}) {
+    const skill = createSkillTool({
+        enabled: options.skills?.enabled,
+        searchPaths: options.skills?.paths?.length ? options.skills.paths : DEFAULT_SKILL_PATHS,
+    });
+    return [
+        { tool: readTool, handler: readHandler },
+        { tool: writeTool, handler: writeHandler },
+        { tool: listTool, handler: listHandler },
+        { tool: globTool, handler: globHandler },
+        { tool: grepTool, handler: grepHandler },
+        { tool: bashTool, handler: bashHandler },
+        { tool: skill.tool, handler: skill.handler },
+    ];
+}
+export function registerBuiltinTools(registry, options = {}) {
+    for (const { tool, handler } of getBuiltinTools(options)) {
+        registry.registerTool(tool, handler);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/builtin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/builtin/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AASrD,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,iBAAiB;IACjB,gBAAgB;IAChB,iBAAiB;IACjB,kBAAkB;IAClB,0BAA0B;IAC1B,iBAAiB;IACjB,kBAAkB;CACnB,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,UAA+B,EAAE;IAC/D,MAAM,KAAK,GAAG,eAAe,CAAC;QAC5B,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO;QAChC,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,mBAAmB;KACxF,CAAC,CAAC;IAEH,OAAO;QACL,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE;QACxC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE;QAC1C,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE;QACxC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE;QACxC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE;QACxC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE;QACxC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE;KAC7C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAsB,EAAE,UAA+B,EAAE;IAC5F,KAAK,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;QACzD,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;AACH,CAAC"}

package/dist/tools/builtin/list.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition, ToolHandler } from '../../types.js';
+export declare const listTool: ToolDefinition;
+export declare const listHandler: ToolHandler;
+//# sourceMappingURL=list.d.ts.map

package/dist/tools/builtin/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/list.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAIlE,eAAO,MAAM,QAAQ,EAAE,cAqBtB,CAAC;AAqEF,eAAO,MAAM,WAAW,EAAE,WAsFzB,CAAC"}

package/dist/tools/builtin/list.js

@@ -0,0 +1,162 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { optionalString } from '@kooka/core';
+import { getWorkspaceRoot, resolveToolPath, toPosixPath } from './workspace.js';
+export const listTool = {
+    id: 'list',
+    name: 'List Directory',
+    description: 'List a directory tree (workspace-scoped). Returns up to 100 files. Use ignore to exclude additional glob patterns.',
+    parameters: {
+        type: 'object',
+        properties: {
+            path: { type: 'string', description: 'Directory to list (absolute or workspace-relative). Omit for workspace root.' },
+            ignore: { type: 'array', description: 'Additional ignore patterns (glob fragments)', items: { type: 'string' } },
+        },
+        required: [],
+    },
+    execution: { type: 'function', handler: 'builtin.list' },
+    metadata: {
+        category: 'file',
+        icon: 'folder',
+        requiresApproval: false,
+        permission: 'list',
+        readOnly: true,
+        permissionPatterns: [{ arg: 'path', kind: 'path' }],
+    },
+};
+const DEFAULT_IGNORE_DIRS = [
+    'node_modules',
+    '.git',
+    'dist',
+    'build',
+    'target',
+    'vendor',
+    'bin',
+    'obj',
+    '.idea',
+    '.vscode',
+    '.cache',
+    'cache',
+    'logs',
+    '.venv',
+    'venv',
+    'env',
+    '__pycache__',
+];
+const MAX_LIST_FILES = 100;
+const MAX_LIST_DEPTH = 25;
+async function walkWorkspaceFiles(baseDir, ignoreDirs) {
+    const relFiles = [];
+    const queue = [{ absDir: baseDir, relDir: '.', depth: 0 }];
+    let truncated = false;
+    while (queue.length > 0) {
+        const next = queue.shift();
+        let entries;
+        try {
+            entries = await fs.readdir(next.absDir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            if (relFiles.length >= MAX_LIST_FILES) {
+                truncated = true;
+                break;
+            }
+            if (entry.isSymbolicLink())
+                continue;
+            const name = entry.name;
+            const childRel = next.relDir === '.' ? name : `${next.relDir}/${name}`;
+            const childAbs = path.join(next.absDir, name);
+            if (entry.isDirectory()) {
+                if (ignoreDirs.has(name))
+                    continue;
+                if (next.depth >= MAX_LIST_DEPTH)
+                    continue;
+                queue.push({ absDir: childAbs, relDir: childRel, depth: next.depth + 1 });
+                continue;
+            }
+            relFiles.push(toPosixPath(childRel));
+        }
+        if (truncated)
+            break;
+    }
+    return { relFiles, truncated };
+}
+export const listHandler = async (args, context) => {
+    try {
+        const baseDir = optionalString(args, 'path');
+        const ignoreExtra = Array.isArray(args.ignore) ? args.ignore.map(String) : [];
+        const ignoreDirs = new Set([...DEFAULT_IGNORE_DIRS, ...ignoreExtra].filter(Boolean));
+        const notes = [];
+        const workspaceRoot = getWorkspaceRoot(context);
+        let base = workspaceRoot;
+        if (baseDir) {
+            const resolved = resolveToolPath(baseDir, { ...context, allowExternalPaths: true });
+            if (resolved.isExternal) {
+                notes.push('Provided path was outside the current workspace; listing the workspace root instead.');
+                base = workspaceRoot;
+            }
+            else {
+                base = resolved.absPath;
+            }
+        }
+        try {
+            const stat = await fs.stat(base);
+            if (!stat.isDirectory()) {
+                base = path.dirname(base);
+            }
+        }
+        catch {
+            base = workspaceRoot;
+        }
+        const listing = await walkWorkspaceFiles(base, ignoreDirs);
+        const truncated = listing.truncated;
+        const relFiles = listing.relFiles.filter((p) => p && p !== '.').sort();
+        const dirs = new Set();
+        const filesByDir = new Map();
+        for (const file of relFiles) {
+            const dir = path.posix.dirname(file);
+            const parts = dir === '.' ? [] : dir.split('/');
+            for (let i = 0; i <= parts.length; i++) {
+                const dirPath = i === 0 ? '.' : parts.slice(0, i).join('/');
+                dirs.add(dirPath);
+            }
+            if (!filesByDir.has(dir))
+                filesByDir.set(dir, []);
+            filesByDir.get(dir).push(path.posix.basename(file));
+        }
+        const renderDir = (dirPath, depth) => {
+            const indent = '  '.repeat(depth);
+            let output = '';
+            if (depth > 0) {
+                output += `${indent}${path.posix.basename(dirPath)}/\n`;
+            }
+            const childIndent = '  '.repeat(depth + 1);
+            const children = Array.from(dirs)
+                .filter((d) => path.posix.dirname(d) === dirPath && d !== dirPath)
+                .sort();
+            for (const child of children) {
+                output += renderDir(child, depth + 1);
+            }
+            const files = (filesByDir.get(dirPath) || []).slice().sort();
+            for (const f of files) {
+                output += `${childIndent}${f}\n`;
+            }
+            return output;
+        };
+        const header = [];
+        if (notes.length > 0) {
+            header.push(`Note: ${notes.join(' ')}`, '');
+        }
+        const output = header.join('\n') +
+            `${base}/\n` +
+            renderDir('.', 0) +
+            (truncated ? '\n(Results are truncated.)\n' : '');
+        return { success: true, data: output.trimEnd() };
+    }
+    catch (error) {
+        return { success: false, error: error instanceof Error ? error.message : String(error) };
+    }
+};
+//# sourceMappingURL=list.js.map

package/dist/tools/builtin/list.js.map

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

package/dist/tools/builtin/read.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition, ToolHandler } from '../../types.js';
+export declare const readTool: ToolDefinition;
+export declare const readHandler: ToolHandler;
+//# sourceMappingURL=read.d.ts.map

package/dist/tools/builtin/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/read.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAOlE,eAAO,MAAM,QAAQ,EAAE,cAyBtB,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,WAmEzB,CAAC"}

package/dist/tools/builtin/read.js

@@ -0,0 +1,92 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { optionalNumber, requireString } from '@kooka/core';
+import { BINARY_EXTENSIONS, containsBinaryData, resolveToolPath } from './workspace.js';
+const DEFAULT_READ_LIMIT = 2000;
+const MAX_LINE_LENGTH = 2000;
+export const readTool = {
+    id: 'read',
+    name: 'Read File',
+    description: 'Reads a file from the workspace. Prefer fileId from glob, or use filePath (absolute or workspace-relative). Supports offset (0-based) and limit (default 2000). Returns cat-style numbered lines.',
+    parameters: {
+        type: 'object',
+        properties: {
+            fileId: { type: 'string', description: 'File handle from glob output (e.g. "F1"). Prefer this over spelling file paths.' },
+            filePath: { type: 'string', description: 'Absolute path or path relative to workspace root' },
+            offset: { type: 'number', description: 'Line offset to start reading from (0-based)' },
+            limit: { type: 'number', description: 'Number of lines to read (default 2000)' },
+        },
+        required: [],
+    },
+    execution: { type: 'function', handler: 'builtin.read' },
+    metadata: {
+        category: 'file',
+        icon: 'file',
+        requiresApproval: false,
+        permission: 'read',
+        supportsExternalPaths: true,
+        readOnly: true,
+        permissionPatterns: [{ arg: 'filePath', kind: 'path' }],
+    },
+};
+export const readHandler = async (args, context) => {
+    const filePathResult = requireString(args, 'filePath');
+    if ('error' in filePathResult)
+        return { success: false, error: filePathResult.error };
+    const filePath = filePathResult.value;
+    let absPath;
+    try {
+        absPath = resolveToolPath(filePath, context).absPath;
+    }
+    catch (error) {
+        return { success: false, error: error instanceof Error ? error.message : String(error) };
+    }
+    const basename = path.basename(absPath);
+    const whitelist = ['.env.sample', '.env.example', '.example', '.env.template'];
+    const shouldBlockEnv = /^\.env(\.|$)/.test(basename) && !whitelist.some((suffix) => basename.endsWith(suffix));
+    if (shouldBlockEnv) {
+        return {
+            success: false,
+            error: `The user has blocked you from reading ${absPath}, DO NOT make further attempts to read it`,
+        };
+    }
+    const ext = path.extname(absPath).toLowerCase();
+    if (BINARY_EXTENSIONS.has(ext)) {
+        return { success: false, error: `Cannot read binary file: ${absPath}` };
+    }
+    let bytes;
+    try {
+        bytes = await fs.readFile(absPath);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return { success: false, error: `File not found: ${absPath}\n\n${message}` };
+    }
+    if (containsBinaryData(bytes)) {
+        return { success: false, error: `Cannot read binary file: ${absPath}` };
+    }
+    const text = new TextDecoder().decode(bytes);
+    const lines = text.replace(/\r\n/g, '\n').split('\n');
+    const offsetRaw = optionalNumber(args, 'offset');
+    const limitRaw = optionalNumber(args, 'limit');
+    const offset = Math.max(0, Math.floor(offsetRaw ?? 0));
+    const limit = Math.max(1, Math.floor(limitRaw ?? DEFAULT_READ_LIMIT));
+    const slice = lines.slice(offset, offset + limit);
+    const numbered = slice.map((line, index) => {
+        const trimmed = line.length > MAX_LINE_LENGTH ? line.substring(0, MAX_LINE_LENGTH) + '...' : line;
+        return `${String(index + offset + 1).padStart(5, '0')}| ${trimmed}`;
+    });
+    const totalLines = lines.length;
+    const lastReadLine = offset + slice.length;
+    const hasMoreLines = totalLines > lastReadLine;
+    let output = '<file>\n' + numbered.join('\n');
+    if (hasMoreLines) {
+        output += `\n\n(File has more lines. Use 'offset' parameter to read beyond line ${lastReadLine})`;
+    }
+    else {
+        output += `\n\n(End of file - total ${totalLines} lines)`;
+    }
+    output += '\n</file>';
+    return { success: true, data: output };
+};
+//# sourceMappingURL=read.js.map

package/dist/tools/builtin/read.js.map

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

package/dist/tools/builtin/skill.d.ts

@@ -0,0 +1,9 @@
+import type { ToolDefinition, ToolHandler } from '../../types.js';
+export declare function createSkillTool(options: {
+    enabled?: boolean;
+    searchPaths: string[];
+}): {
+    tool: ToolDefinition;
+    handler: ToolHandler;
+};
+//# sourceMappingURL=skill.d.ts.map

package/dist/tools/builtin/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/skill.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAkBlE,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACvC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,GAAG;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CA0HjD"}