@roackb2/heddle 0.0.2

package/dist/src/tools/run-shell.d.ts

@@ -0,0 +1,41 @@
+import type { ToolDefinition, ToolResult } from '../types.js';
+export type RunShellScope = 'inspect' | 'workspace' | 'external';
+export type RunShellRisk = 'low' | 'medium' | 'unknown';
+export type RunShellCapability = 'workspace_listing' | 'file_inspection' | 'workspace_search' | 'structured_inspection' | 'environment_inspection' | 'git_inspection' | 'dependency' | 'verification' | 'formatting' | 'file_operation' | 'git_staging' | 'project_script' | 'unknown_workspace';
+export type RunShellPolicyDecision = {
+    binary: string;
+    scope: RunShellScope;
+    risk: RunShellRisk;
+    capability: RunShellCapability;
+    reason: string;
+};
+type RunShellRule = {
+    binary: string;
+    argsPrefix?: string[];
+    scope: RunShellScope;
+    risk: RunShellRisk;
+    capability: RunShellCapability;
+    reason: string;
+};
+export type RunShellOptions = {
+    rules?: RunShellRule[];
+};
+export declare const DEFAULT_INSPECT_RULES: RunShellRule[];
+export declare const DEFAULT_MUTATE_RULES: RunShellRule[];
+export declare function createRunShellInspectTool(options?: RunShellOptions): ToolDefinition;
+export declare function createRunShellMutateTool(options?: RunShellOptions): ToolDefinition;
+export declare function createRunShellTool(options?: RunShellOptions): ToolDefinition;
+export declare function runShellCommand(raw: unknown, options: {
+    toolName: string;
+    rules: RunShellRule[];
+    allowUnknown: boolean;
+}, signal?: AbortSignal): Promise<ToolResult>;
+export declare function classifyShellCommandPolicy(command: string, options: {
+    toolName: string;
+    rules: RunShellRule[];
+    allowUnknown: boolean;
+}): RunShellPolicyDecision | {
+    error: string;
+};
+export {};
+//# sourceMappingURL=run-shell.d.ts.map

package/dist/src/tools/run-shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-shell.d.ts","sourceRoot":"","sources":["../../../src/tools/run-shell.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAM9D,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC;AACjE,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC;AACxD,MAAM,MAAM,kBAAkB,GAC1B,mBAAmB,GACnB,iBAAiB,GACjB,kBAAkB,GAClB,uBAAuB,GACvB,wBAAwB,GACxB,gBAAgB,GAChB,YAAY,GACZ,cAAc,GACd,YAAY,GACZ,gBAAgB,GAChB,aAAa,GACb,gBAAgB,GAChB,mBAAmB,CAAC;AAExB,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,KAAK,YAAY,GAAG;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAUF,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;CACxB,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,YAAY,EA+B/C,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,YAAY,EAwB9C,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,OAAO,GAAE,eAAoB,GAAG,cAAc,CAcvF;AAED,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,eAAoB,GAAG,cAAc,CAetF;AAED,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,eAAoB,GAAG,cAAc,CAEhF;AAgBD,wBAAgB,eAAe,CAC7B,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE;IACP,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;CACvB,EACD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CA+JrB;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;IACP,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;CACvB,GACA,sBAAsB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CA+B5C"}

package/dist/src/tools/run-shell.js

@@ -0,0 +1,407 @@
+// ---------------------------------------------------------------------------
+// Tools: run_shell_inspect / run_shell_mutate
+// Policy-based shell execution with explicit scope/risk metadata.
+// ---------------------------------------------------------------------------
+import { spawn } from 'node:child_process';
+export const DEFAULT_INSPECT_RULES = [
+    inspectRule('ls', 'workspace_listing', 'workspace listing'),
+    inspectRule('nl', 'file_inspection', 'numbered file inspection'),
+    inspectRule('cat', 'file_inspection', 'file inspection'),
+    inspectRule('head', 'file_inspection', 'file inspection'),
+    inspectRule('tail', 'file_inspection', 'file inspection'),
+    inspectRule('wc', 'file_inspection', 'workspace inspection'),
+    inspectRule('grep', 'workspace_search', 'workspace inspection'),
+    inspectRule('rg', 'workspace_search', 'workspace inspection'),
+    inspectRule('find', 'workspace_search', 'workspace inspection'),
+    inspectRule('sed', 'file_inspection', 'workspace inspection'),
+    inspectRule('sort', 'structured_inspection', 'workspace inspection'),
+    inspectRule('uniq', 'structured_inspection', 'workspace inspection'),
+    inspectRule('jq', 'structured_inspection', 'structured output inspection'),
+    inspectRule('echo', 'environment_inspection', 'simple shell inspection'),
+    inspectRule('pwd', 'environment_inspection', 'workspace location check'),
+    inspectRule('which', 'environment_inspection', 'binary discovery'),
+    inspectRule('file', 'file_inspection', 'file metadata inspection'),
+    inspectRule('tree', 'workspace_listing', 'workspace tree inspection'),
+    inspectRule('du', 'environment_inspection', 'workspace disk inspection'),
+    inspectRule('df', 'environment_inspection', 'filesystem inspection'),
+    inspectRule('git', 'git_inspection', 'git history inspection', ['log']),
+    inspectRule('git', 'git_inspection', 'git diff inspection', ['diff']),
+    inspectRule('git', 'git_inspection', 'git status inspection', ['status']),
+    inspectRule('git', 'git_inspection', 'git object inspection', ['show']),
+    inspectRule('git', 'git_inspection', 'git revision inspection', ['rev-parse']),
+    inspectRule('git', 'git_inspection', 'git file inventory inspection', ['ls-files']),
+    inspectRule('git', 'git_inspection', 'git content search inspection', ['grep']),
+    inspectRule('git', 'git_inspection', 'git branch inspection', ['branch']),
+    inspectRule('git', 'git_inspection', 'git tag inspection', ['tag']),
+    inspectRule('git', 'git_inspection', 'git remote inspection', ['remote']),
+];
+export const DEFAULT_MUTATE_RULES = [
+    workspaceRule('yarn', 'medium', 'dependency', 'workspace dependency install command', ['add']),
+    workspaceRule('yarn', 'medium', 'dependency', 'workspace dependency install command', ['install']),
+    workspaceRule('yarn', 'medium', 'dependency', 'workspace dependency removal command', ['remove']),
+    workspaceRule('yarn', 'low', 'verification', 'workspace verification command', ['test']),
+    workspaceRule('yarn', 'low', 'verification', 'workspace verification command', ['build']),
+    workspaceRule('yarn', 'low', 'verification', 'workspace verification command', ['lint']),
+    workspaceRule('yarn', 'low', 'verification', 'workspace verification command', ['vitest']),
+    workspaceRule('vitest', 'low', 'verification', 'workspace verification command'),
+    workspaceRule('tsc', 'low', 'verification', 'workspace verification command'),
+    workspaceRule('yarn', 'medium', 'project_script', 'workspace project script command', ['run']),
+    workspaceRule('yarn', 'medium', 'formatting', 'workspace formatting command', ['format']),
+    workspaceRule('yarn', 'medium', 'formatting', 'workspace formatting command', ['prettier']),
+    workspaceRule('yarn', 'medium', 'formatting', 'workspace formatting command', ['eslint']),
+    workspaceRule('npx', 'medium', 'formatting', 'workspace formatting command', ['prettier', '--write']),
+    workspaceRule('npx', 'medium', 'formatting', 'workspace formatting command', ['eslint', '--fix']),
+    workspaceRule('prettier', 'medium', 'formatting', 'workspace formatting command', ['--write']),
+    workspaceRule('eslint', 'medium', 'formatting', 'workspace formatting command', ['--fix']),
+    workspaceRule('mkdir', 'medium', 'file_operation', 'workspace file operation'),
+    workspaceRule('touch', 'medium', 'file_operation', 'workspace file operation'),
+    workspaceRule('mv', 'medium', 'file_operation', 'workspace file operation'),
+    workspaceRule('cp', 'medium', 'file_operation', 'workspace file operation'),
+    workspaceRule('git', 'medium', 'git_staging', 'git staging operation', ['add']),
+    workspaceRule('git', 'medium', 'file_operation', 'git file move operation', ['mv']),
+];
+export function createRunShellInspectTool(options = {}) {
+    const rules = options.rules ?? DEFAULT_INSPECT_RULES;
+    return {
+        name: 'run_shell_inspect',
+        description: `Run a bounded read-oriented shell command inside the current workspace. Use this for CLI-native inspection, search, diff, and git state checks when mature commands like rg, git, sed, or ls are a better fit than bespoke file tools. Returns structured output with command, exitCode, stdout, stderr, and policy metadata. This tool is governed by low-risk inspect rules, not arbitrary shell access. Use this when the command is clearly read-oriented and likely to fit the inspect policy. If inspect rejects a command because it is arbitrary, uses inline scripts, or needs broader shell expressiveness, retry with run_shell_mutate instead of concluding the command cannot be run. Read-only pipelines with | are allowed for inspection commands, but redirects, command chaining, and subshells are blocked.`,
+        parameters: buildParameters(),
+        execute: (raw) => runShellCommand(raw, {
+            toolName: 'run_shell_inspect',
+            rules,
+            allowUnknown: false,
+        }),
+    };
+}
+export function createRunShellMutateTool(options = {}) {
+    const rules = options.rules ?? DEFAULT_MUTATE_RULES;
+    return {
+        name: 'run_shell_mutate',
+        requiresApproval: true,
+        description: `Run an approval-gated shell command inside the current workspace. Use this when inspection is not enough, when the command is arbitrary or unclassified, when you need inline scripts or broader shell expressiveness, or when run_shell_inspect rejects a still-necessary command. Returns structured output with command, exitCode, stdout, stderr, and policy metadata. This tool is governed by host-side execution rules with explicit risk classification and approval instead of a narrow command allowlist. Arbitrary commands are allowed here through approval; do not assume a command is impossible just because inspect refused it.`,
+        parameters: buildParameters(),
+        execute: (raw) => runShellCommand(raw, {
+            toolName: 'run_shell_mutate',
+            rules,
+            allowUnknown: true,
+        }),
+    };
+}
+export function createRunShellTool(options = {}) {
+    return createRunShellInspectTool(options);
+}
+function buildParameters() {
+    return {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+            command: {
+                type: 'string',
+                description: 'The shell command to execute',
+            },
+        },
+        required: ['command'],
+    };
+}
+export function runShellCommand(raw, options, signal) {
+    if (!isRunShellInput(raw)) {
+        return Promise.resolve({
+            ok: false,
+            error: `Invalid input for ${options.toolName}. Required field: command.`,
+        });
+    }
+    const cmd = raw.command.trim();
+    const mutateCatastrophicError = getCatastrophicCommandError(cmd, options.toolName);
+    if (mutateCatastrophicError) {
+        return Promise.resolve({
+            ok: false,
+            error: mutateCatastrophicError,
+        });
+    }
+    if (containsBlockedShellControlOperators(cmd, options.toolName)) {
+        return Promise.resolve({
+            ok: false,
+            error: 'Command not allowed. Inspect mode permits read-only pipes, but redirects, command chaining, backgrounding, and subshells are blocked. If the command is still needed, retry with run_shell_mutate.',
+        });
+    }
+    const argv = tokenizeCommand(cmd);
+    if (argv.length === 0) {
+        return Promise.resolve({
+            ok: false,
+            error: 'Command not allowed. The command must not be empty.',
+        });
+    }
+    const policy = classifyCommand(argv, options.rules, options.allowUnknown);
+    if (!policy) {
+        return Promise.resolve({
+            ok: false,
+            error: options.toolName === 'run_shell_inspect' ?
+                `Command not allowed by ${options.toolName} policy. This tool only permits bounded read-oriented commands that match its configured workspace risk/scope rules. If the command is still needed, retry with run_shell_mutate.`
+                : `Command not allowed by ${options.toolName} policy. This tool only permits bounded commands that match its configured workspace risk/scope rules.`,
+        });
+    }
+    return new Promise((resolve) => {
+        let stdout = '';
+        let stderr = '';
+        let settled = false;
+        let timedOut = false;
+        let aborted = false;
+        const child = spawn(cmd, {
+            shell: true,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        const cleanup = () => {
+            clearTimeout(timeoutId);
+            if (signal) {
+                signal.removeEventListener('abort', onAbort);
+            }
+        };
+        const finish = (result) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            cleanup();
+            resolve(result);
+        };
+        const onAbort = () => {
+            aborted = true;
+            child.kill('SIGTERM');
+            setTimeout(() => {
+                if (!child.killed) {
+                    child.kill('SIGKILL');
+                }
+            }, 500).unref();
+        };
+        const timeoutId = setTimeout(() => {
+            timedOut = true;
+            child.kill('SIGTERM');
+            setTimeout(() => {
+                if (!child.killed) {
+                    child.kill('SIGKILL');
+                }
+            }, 500).unref();
+        }, 30_000);
+        if (signal?.aborted) {
+            onAbort();
+        }
+        else if (signal) {
+            signal.addEventListener('abort', onAbort, { once: true });
+        }
+        child.stdout?.on('data', (chunk) => {
+            stdout += chunk.toString();
+            if (stdout.length > 1024 * 1024) {
+                stdout = stdout.slice(-1024 * 1024);
+            }
+        });
+        child.stderr?.on('data', (chunk) => {
+            stderr += chunk.toString();
+            if (stderr.length > 1024 * 1024) {
+                stderr = stderr.slice(-1024 * 1024);
+            }
+        });
+        child.on('error', (error) => {
+            finish({
+                ok: false,
+                error: `Shell command failed: ${error.message}`,
+            });
+        });
+        child.on('close', (code) => {
+            const output = {
+                command: cmd,
+                exitCode: code ?? 0,
+                stdout: stdout.trim(),
+                stderr: stderr.trim(),
+                policy,
+            };
+            if (aborted) {
+                finish({
+                    ok: false,
+                    error: 'Shell command aborted by host request',
+                    output,
+                });
+                return;
+            }
+            if (timedOut) {
+                finish({
+                    ok: false,
+                    error: 'Shell command timed out after 30000ms',
+                    output,
+                });
+                return;
+            }
+            if ((code ?? 0) !== 0) {
+                finish({
+                    ok: false,
+                    error: `Shell command failed with exit code ${output.exitCode}`,
+                    output,
+                });
+                return;
+            }
+            finish({ ok: true, output });
+        });
+    });
+}
+export function classifyShellCommandPolicy(command, options) {
+    const normalized = command.trim();
+    if (!normalized) {
+        return { error: 'Command not allowed. The command must not be empty.' };
+    }
+    const mutateCatastrophicError = getCatastrophicCommandError(normalized, options.toolName);
+    if (mutateCatastrophicError) {
+        return { error: mutateCatastrophicError };
+    }
+    if (containsBlockedShellControlOperators(normalized, options.toolName)) {
+        return {
+            error: 'Command not allowed. Inspect mode permits read-only pipes, but redirects, command chaining, backgrounding, and subshells are blocked.',
+        };
+    }
+    const argv = tokenizeCommand(normalized);
+    if (argv.length === 0) {
+        return { error: 'Command not allowed. The command must not be empty.' };
+    }
+    const policy = classifyCommand(argv, options.rules, options.allowUnknown);
+    if (!policy) {
+        return {
+            error: `Command not allowed by ${options.toolName} policy. This tool only permits bounded commands that match its configured workspace risk/scope rules.`,
+        };
+    }
+    return policy;
+}
+function classifyCommand(argv, rules, allowUnknown) {
+    const binary = argv[0] ?? '';
+    const args = argv.slice(1);
+    const rule = rules.find((candidate) => {
+        if (candidate.binary !== binary) {
+            return false;
+        }
+        if (!candidate.argsPrefix || candidate.argsPrefix.length === 0) {
+            return true;
+        }
+        return candidate.argsPrefix.every((part, index) => args[index] === part);
+    });
+    if (!rule) {
+        if (!allowUnknown) {
+            return undefined;
+        }
+        return {
+            binary,
+            scope: 'workspace',
+            risk: 'unknown',
+            capability: 'unknown_workspace',
+            reason: 'unclassified workspace command requiring explicit approval',
+        };
+    }
+    return {
+        binary: rule.binary,
+        scope: rule.scope,
+        risk: rule.risk,
+        capability: rule.capability,
+        reason: rule.reason,
+    };
+}
+function tokenizeCommand(command) {
+    return command
+        .trim()
+        .split(/\s+/)
+        .filter(Boolean);
+}
+function isRunShellInput(raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+        return false;
+    }
+    const input = raw;
+    return typeof input.command === 'string';
+}
+function containsBlockedShellControlOperators(command, toolName) {
+    const inspectMode = toolName === 'run_shell_inspect';
+    if (!inspectMode) {
+        return false;
+    }
+    let quote;
+    let escaped = false;
+    for (let index = 0; index < command.length; index++) {
+        const current = command[index] ?? '';
+        const next = command[index + 1] ?? '';
+        if (escaped) {
+            escaped = false;
+            continue;
+        }
+        if (current === '\\') {
+            escaped = true;
+            continue;
+        }
+        if (quote) {
+            if (current === quote) {
+                quote = undefined;
+            }
+            continue;
+        }
+        if (current === '"' || current === "'") {
+            quote = current;
+            continue;
+        }
+        if (current === '|' && inspectMode && next === '|') {
+            return true;
+        }
+        if (current === '&' && next === '&') {
+            return true;
+        }
+        if (current === ';' || current === '`') {
+            return true;
+        }
+        if (current === '&') {
+            return true;
+        }
+        if (inspectMode && (current === '>' || current === '<')) {
+            return true;
+        }
+        if (current === '$' && next === '(') {
+            return true;
+        }
+    }
+    return false;
+}
+function getCatastrophicCommandError(command, toolName) {
+    if (toolName !== 'run_shell_mutate') {
+        return undefined;
+    }
+    const normalized = command.trim().toLowerCase().replace(/\s+/g, ' ');
+    if (!normalized) {
+        return undefined;
+    }
+    const catastrophicPatterns = [
+        /(?:^|[;&|])\s*rm\s+-rf\s+\/$/,
+        /(?:^|[;&|])\s*rm\s+-rf\s+\/\s/,
+        /(?:^|[;&|])\s*rm\s+-rf\s+~(?:\/|$)/,
+        /(?:^|[;&|])\s*rm\s+-rf\s+\$home(?:\/|$)/,
+        /(?:^|[;&|])\s*rm\s+-rf\s+"?\/"?(?:\s|$)/,
+        /(?:^|[;&|])\s*rm\s+-rf\s+"?~"?(?:\s|$)/,
+        /(?:^|[;&|])\s*mkfs(?:\.[^\s]+)?\b/,
+        /(?:^|[;&|])\s*dd\b.*\bof=\/dev\//,
+    ];
+    return catastrophicPatterns.some((pattern) => pattern.test(normalized)) ?
+        'Command not allowed. This command appears catastrophically destructive (home/root/disk-level) and is blocked even in approval-gated mutate mode.'
+        : undefined;
+}
+function inspectRule(binary, capability, reason, argsPrefix) {
+    return {
+        binary,
+        argsPrefix,
+        scope: 'inspect',
+        risk: 'low',
+        capability,
+        reason,
+    };
+}
+function workspaceRule(binary, risk, capability, reason, argsPrefix) {
+    return {
+        binary,
+        argsPrefix,
+        scope: 'workspace',
+        risk,
+        capability,
+        reason,
+    };
+}
+//# sourceMappingURL=run-shell.js.map

package/dist/src/tools/run-shell.js.map

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

package/dist/src/tools/search-files.d.ts

@@ -0,0 +1,8 @@
+import type { ToolDefinition } from '../types.js';
+export declare const DEFAULT_SEARCH_EXCLUDED_DIRS: string[];
+export type SearchFilesOptions = {
+    excludedDirs?: string[];
+};
+export declare function createSearchFilesTool(options?: SearchFilesOptions): ToolDefinition;
+export declare const searchFilesTool: ToolDefinition;
+//# sourceMappingURL=search-files.d.ts.map

package/dist/src/tools/search-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-files.d.ts","sourceRoot":"","sources":["../../../src/tools/search-files.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,aAAa,CAAC;AAO9D,eAAO,MAAM,4BAA4B,UAAuD,CAAC;AAEjG,MAAM,MAAM,kBAAkB,GAAG;IAC/B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,kBAAuB,GAAG,cAAc,CA+CtF;AAED,eAAO,MAAM,eAAe,EAAE,cAAwC,CAAC"}

package/dist/src/tools/search-files.js

@@ -0,0 +1,86 @@
+// ---------------------------------------------------------------------------
+// Tool: search_files
+// Uses grep — the real human tool, per project philosophy.
+// ---------------------------------------------------------------------------
+import { execSync } from 'node:child_process';
+import { resolve } from 'node:path';
+export const DEFAULT_SEARCH_EXCLUDED_DIRS = ['.git', 'dist', 'node_modules', 'local', '.heddle'];
+export function createSearchFilesTool(options = {}) {
+    const excludedDirNames = sanitizeExcludedDirs(options.excludedDirs);
+    return {
+        name: 'search_files',
+        description: 'Search for a text pattern in files using grep. Use this when you need to locate a specific symbol or text string, not when a likely folder or file is already obvious from the workspace structure. Prefer searching for concrete terms such as tool names, symbols, or filenames rather than copying broad question text. Relative paths are resolved from the current working directory and may also point to nearby parent or sibling folders. Returns newline-separated matches in grep-style path:line:content format, or "No matches found.". Ignores generated or state directories like .git, dist, node_modules, local, and .heddle by default, but if you explicitly target one of those directories via path then that path is searched. Example inputs: { "query": "createUser" }, { "query": "incident", "path": "../shared-notes" }',
+        parameters: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'The text pattern to search for',
+                },
+                path: {
+                    type: 'string',
+                    description: 'Directory to search in. Defaults to "."',
+                },
+            },
+            required: ['query'],
+        },
+        async execute(raw) {
+            if (!isSearchFilesInput(raw)) {
+                return { ok: false, error: 'Invalid input for search_files. Required field: query. Optional field: path.' };
+            }
+            const input = raw;
+            const dir = resolve(input.path ?? '.');
+            const effectiveExcludedDirs = excludedDirNames.filter((name) => !isExplicitlyTargetingExcludedDir(dir, name));
+            const excludedDirs = effectiveExcludedDirs.map((name) => `--exclude-dir=${escapeShellArg(name)}`).join(' ');
+            try {
+                // -r recursive, -n line numbers, -I skip binary, --include common text files
+                const output = execSync(`grep -rnI ${excludedDirs} --include='*.ts' --include='*.js' --include='*.json' --include='*.md' --include='*.txt' --include='*.yaml' --include='*.yml' ${escapeShellArg(input.query)} ${escapeShellArg(dir)}`, { encoding: 'utf-8', timeout: 15_000, maxBuffer: 1024 * 1024 });
+                return { ok: true, output: output.trim() };
+            }
+            catch (err) {
+                if (err && typeof err === 'object' && 'status' in err && err.status === 1) {
+                    return { ok: true, output: 'No matches found.' };
+                }
+                return { ok: false, error: `Search failed: ${err instanceof Error ? err.message : String(err)}` };
+            }
+        },
+    };
+}
+export const searchFilesTool = createSearchFilesTool();
+function isSearchFilesInput(raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+        return false;
+    }
+    const input = raw;
+    const keys = Object.keys(input);
+    if (keys.some((key) => key !== 'query' && key !== 'path')) {
+        return false;
+    }
+    if (typeof input.query !== 'string') {
+        return false;
+    }
+    return input.path === undefined || typeof input.path === 'string';
+}
+function escapeShellArg(arg) {
+    return `'${arg.replace(/'/g, "'\\''")}'`;
+}
+function sanitizeExcludedDirs(custom) {
+    if (!custom || custom.length === 0) {
+        return DEFAULT_SEARCH_EXCLUDED_DIRS;
+    }
+    const normalized = custom
+        .map((value) => value.trim())
+        .filter(Boolean)
+        .map((value) => value.replace(/^\.?\//, '').replace(/\/+$/, ''));
+    return normalized.length > 0 ? normalized : DEFAULT_SEARCH_EXCLUDED_DIRS;
+}
+function isExplicitlyTargetingExcludedDir(dir, excludedName) {
+    const normalizedExcludedName = excludedName.trim().replace(/^\.?\//, '').replace(/\/+$/, '');
+    if (!normalizedExcludedName) {
+        return false;
+    }
+    const segments = dir.split(/[/\\]+/).filter(Boolean);
+    return segments.includes(normalizedExcludedName);
+}
+//# sourceMappingURL=search-files.js.map

package/dist/src/tools/search-files.js.map

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

package/dist/src/tools/update-plan.d.ts

@@ -0,0 +1,8 @@
+import type { ToolDefinition } from '../types.js';
+export type PlanItemStatus = 'pending' | 'in_progress' | 'completed';
+export type PlanItem = {
+    step: string;
+    status: PlanItemStatus;
+};
+export declare const updatePlanTool: ToolDefinition;
+//# sourceMappingURL=update-plan.d.ts.map

package/dist/src/tools/update-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-plan.d.ts","sourceRoot":"","sources":["../../../src/tools/update-plan.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,aAAa,CAAC;AAE9D,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,CAAC;AAErE,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,cAAc,CAAC;CACxB,CAAC;AAOF,eAAO,MAAM,cAAc,EAAE,cA+C5B,CAAC"}