@qduc/term2 0.1.0

package/dist/tools/ask-mentor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-mentor.js","sourceRoot":"","sources":["../../source/tools/ask-mentor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,OAAO,EACH,aAAa,EACb,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,GACpB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IAChE,OAAO,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,sCAAsC,CAAC;CACxD,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CACzC,IAAS,EACT,KAAa,EACb,qBAA2C,EAC3B,EAAE;IAClB,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,YAAY,GACd,MAAM,IAAI,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC;QACvC,CAAC,CAAC,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC;QACnC,CAAC,CAAC,IAAI,CAAC;IACf,MAAM,cAAc,GAAG,IAAI,EAAE,OAAO,EAAE,SAAS,IAAI,IAAI,EAAE,SAAS,CAAC;IACnE,MAAM,IAAI,GACN,sBAAsB,CAAC,cAAc,CAAC;QACtC,sBAAsB,CAAC,YAAY,CAAC;QACpC,EAAE,CAAC;IAEP,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,kBAAkB,CAAC;IACtD,MAAM,OAAO,GAAG,eAAe,QAAQ,EAAE,CAAC;IAC1C,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,yBAAyB,CAAC;IAChE,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC;IAE5D,OAAO;QACH,iBAAiB,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE;YACrC,OAAO;YACP,MAAM;YACN,OAAO;YACP,QAAQ,EAAE,YAAY;YACtB,QAAQ,EAAE,IAAI;SACjB,CAAC;KACL,CAAC;AACN,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,6BAA6B,GAAG,CACzC,SAAgD,EACjB,EAAE,CAAC,CAAC;IACnC,IAAI,EAAE,YAAY;IAClB,WAAW,EACP,uNAAuN;IAC3N,UAAU,EAAE,eAAe;IAC3B,aAAa,EAAE,GAAG,EAAE,CAAC,KAAK;IAC1B,OAAO,EAAE,KAAK,EAAE,EAAC,QAAQ,EAAE,OAAO,EAAC,EAAE,EAAE;QACnC,MAAM,MAAM,GAAG,OAAO;YAClB,CAAC,CAAC,aAAa,OAAO,kBAAkB,QAAQ,EAAE;YAClD,CAAC,CAAC,QAAQ,CAAC;QACf,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;YACvC,OAAO,MAAM,CAAC;QAClB,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YAClB,OAAO,yBAAyB,KAAK,CAAC,OAAO,kDAAkD,CAAC;QACpG,CAAC;IACL,CAAC;IACD,oBAAoB,EAAE,6BAA6B;CACtD,CAAC,CAAC"}

package/dist/tools/ask-mentor.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ask-mentor.test.d.ts.map

package/dist/tools/ask-mentor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-mentor.test.d.ts","sourceRoot":"","sources":["../../source/tools/ask-mentor.test.ts"],"names":[],"mappings":""}

package/dist/tools/ask-mentor.test.js

@@ -0,0 +1,47 @@
+import test from 'ava';
+import { createAskMentorToolDefinition } from './ask-mentor.js';
+// Mock function helper
+const fn = (impl) => {
+    const mock = (impl ? (...args) => impl(...args) : () => { });
+    mock.calls = [];
+    mock.impl = impl;
+    return new Proxy(mock, {
+        apply: (target, _thisArg, args) => {
+            target.calls.push(args);
+            return target(...args);
+        },
+    });
+};
+test('createAskMentorToolDefinition defines the tool correctly', t => {
+    const mockAskMentor = fn();
+    const tool = createAskMentorToolDefinition(mockAskMentor);
+    t.is(tool.name, 'ask_mentor');
+    t.true(tool.description.includes('mentor'));
+    t.is(tool.needsApproval({ question: 'test', context: null }, undefined), false);
+});
+test('createAskMentorToolDefinition executes correctly', async (t) => {
+    const mockAskMentor = fn(async () => 'Expert advice');
+    const tool = createAskMentorToolDefinition(mockAskMentor);
+    const result = await tool.execute({ question: 'How do I center a div?', context: null }, undefined);
+    t.is(mockAskMentor.calls[0][0], 'How do I center a div?');
+    t.is(result, 'Expert advice');
+});
+test('createAskMentorToolDefinition includes context', async (t) => {
+    const mockAskMentor = fn(async () => 'Contextual advice');
+    const tool = createAskMentorToolDefinition(mockAskMentor);
+    const result = await tool.execute({
+        question: 'Why is this failing?',
+        context: 'Error: invalid prop',
+    }, undefined);
+    t.is(mockAskMentor.calls[0][0], 'Context:\nError: invalid prop\n\nQuestion:\nWhy is this failing?');
+    t.is(result, 'Contextual advice');
+});
+test('createAskMentorToolDefinition handles errors', async (t) => {
+    const mockAskMentor = fn(async () => {
+        throw new Error('API Error');
+    });
+    const tool = createAskMentorToolDefinition(mockAskMentor);
+    const result = await tool.execute({ question: 'fail', context: null }, undefined);
+    t.true(result.includes('Failed to ask mentor: API Error'));
+});
+//# sourceMappingURL=ask-mentor.test.js.map

package/dist/tools/ask-mentor.test.js.map

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

package/dist/tools/bash.d.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+import type { ToolDefinition } from './types.js';
+declare const bashParametersSchema: z.ZodObject<{
+    command: z.ZodString;
+    needsApproval: z.ZodBoolean;
+}, z.core.$strip>;
+export type BashToolParams = z.infer<typeof bashParametersSchema>;
+export declare const bashToolDefinition: ToolDefinition<BashToolParams>;
+export {};
+//# sourceMappingURL=bash.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../source/tools/bash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAKtB,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,YAAY,CAAC;AAI/C,QAAA,MAAM,oBAAoB;;;iBAGxB,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,kBAAkB,EAAE,cAAc,CAAC,cAAc,CAgD7D,CAAC"}

package/dist/tools/bash.js

@@ -0,0 +1,55 @@
+import { z } from 'zod';
+import { exec } from 'child_process';
+import util from 'util';
+import { validateCommandSafety } from '../utils/command-safety.js';
+import { logValidationError } from '../utils/command-logger.js';
+const execPromise = util.promisify(exec);
+const bashParametersSchema = z.object({
+    command: z.string().min(1, 'Command cannot be empty'),
+    needsApproval: z.boolean(),
+});
+export const bashToolDefinition = {
+    name: 'bash',
+    description: 'Execute a bash command. Use this to run terminal commands. Assert the safety of the command; if the command does not change system state or read sensitive data, set needsApproval to false. Otherwise set needsApproval to true and wait for user approval before executing.',
+    parameters: bashParametersSchema,
+    needsApproval: async (params) => {
+        try {
+            return (params.needsApproval || validateCommandSafety(params.command));
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logValidationError(`Validation failed: ${errorMessage}`);
+            return true; // fail-safe: require approval on validation errors
+        }
+    },
+    execute: async ({ command }) => {
+        try {
+            if (!command ||
+                typeof command !== 'string' ||
+                command.trim().length === 0) {
+                return JSON.stringify({
+                    command,
+                    output: 'Error: Command cannot be empty',
+                    success: false,
+                });
+            }
+            const { stdout, stderr } = await execPromise(command);
+            return JSON.stringify({
+                command,
+                stdout,
+                stderr,
+                success: true,
+            });
+        }
+        catch (err) {
+            return JSON.stringify({
+                command,
+                stdout: err.stdout,
+                stderr: err.stderr,
+                code: err.code,
+                success: false,
+            });
+        }
+    },
+};
+//# sourceMappingURL=bash.js.map

package/dist/tools/bash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash.js","sourceRoot":"","sources":["../../source/tools/bash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AACtB,OAAO,EAAC,IAAI,EAAC,MAAM,eAAe,CAAC;AACnC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAC,qBAAqB,EAAC,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAC,kBAAkB,EAAC,MAAM,4BAA4B,CAAC;AAG9D,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AAEzC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,yBAAyB,CAAC;IACrD,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE;CAC1B,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,kBAAkB,GAAmC;IACjE,IAAI,EAAE,MAAM;IACZ,WAAW,EACV,+QAA+Q;IAChR,UAAU,EAAE,oBAAoB;IAChC,aAAa,EAAE,KAAK,EAAC,MAAM,EAAC,EAAE;QAC7B,IAAI,CAAC;YACJ,OAAO,CACN,MAAM,CAAC,aAAa,IAAI,qBAAqB,CAAC,MAAM,CAAC,OAAO,CAAC,CAC7D,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,YAAY,GACjB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACxD,kBAAkB,CAAC,sBAAsB,YAAY,EAAE,CAAC,CAAC;YACzD,OAAO,IAAI,CAAC,CAAC,mDAAmD;QACjE,CAAC;IACF,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,EAAC,OAAO,EAAC,EAAE,EAAE;QAC5B,IAAI,CAAC;YACJ,IACC,CAAC,OAAO;gBACR,OAAO,OAAO,KAAK,QAAQ;gBAC3B,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAC1B,CAAC;gBACF,OAAO,IAAI,CAAC,SAAS,CAAC;oBACrB,OAAO;oBACP,MAAM,EAAE,gCAAgC;oBACxC,OAAO,EAAE,KAAK;iBACd,CAAC,CAAC;YACJ,CAAC;YAED,MAAM,EAAC,MAAM,EAAE,MAAM,EAAC,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;YACpD,OAAO,IAAI,CAAC,SAAS,CAAC;gBACrB,OAAO;gBACP,MAAM;gBACN,MAAM;gBACN,OAAO,EAAE,IAAI;aACb,CAAC,CAAC;QACJ,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC,SAAS,CAAC;gBACrB,OAAO;gBACP,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,OAAO,EAAE,KAAK;aACd,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;CACD,CAAC"}

package/dist/tools/find-files.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import type { ToolDefinition, CommandMessage } from './types.js';
+declare const findFilesParametersSchema: z.ZodObject<{
+    pattern: z.ZodString;
+    path: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    max_results: z.ZodNullable<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+}, z.core.$strip>;
+export type FindFilesToolParams = z.infer<typeof findFilesParametersSchema>;
+import { ExecutionContext } from '../services/execution-context.js';
+export declare const formatFindFilesCommandMessage: (item: any, index: number, toolCallArgumentsById: Map<string, unknown>) => CommandMessage[];
+export declare const createFindFilesToolDefinition: (deps?: {
+    executionContext?: ExecutionContext;
+}) => ToolDefinition<FindFilesToolParams>;
+export {};
+//# sourceMappingURL=find-files.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"find-files.d.ts","sourceRoot":"","sources":["../../source/tools/find-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAItB,OAAO,KAAK,EAAC,cAAc,EAAE,cAAc,EAAC,MAAM,YAAY,CAAC;AAU/D,QAAA,MAAM,yBAAyB;;;;iBAmB7B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAgCpE,eAAO,MAAM,6BAA6B,GACzC,MAAM,GAAG,EACT,OAAO,MAAM,EACb,uBAAuB,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,KACzC,cAAc,EAsChB,CAAC;AAEF,eAAO,MAAM,6BAA6B,GAAI,OAAM;IAAE,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;CAAO,KAAG,cAAc,CAAC,mBAAmB,CAiHpI,CAAC"}

package/dist/tools/find-files.js

@@ -0,0 +1,179 @@
+import { z } from 'zod';
+import { exec } from 'child_process';
+import util from 'util';
+import { resolveWorkspacePath, relaxedNumber } from './utils.js';
+import { getOutputText, normalizeToolArguments, createBaseMessage, getCallIdFromItem, } from './format-helpers.js';
+const execPromise = util.promisify(exec);
+const findFilesParametersSchema = z.object({
+    pattern: z
+        .string()
+        .describe('Glob pattern or filename to search for (e.g., "*.ts", "**/*.test.ts", "README.md")'),
+    path: z
+        .string()
+        .optional()
+        .nullable()
+        .describe('Directory to search in. Use "." for current directory. Defaults to current directory.'),
+    max_results: relaxedNumber
+        .int()
+        .positive()
+        .optional()
+        .nullable()
+        .describe('Maximum number of results to return. Defaults to 50.'),
+});
+import { executeShellCommand } from '../utils/execute-shell.js';
+let hasFd = null;
+let hasFdRemote = null;
+async function checkFdAvailability(executionContext) {
+    const isRemote = executionContext?.isRemote() ?? false;
+    if (isRemote) {
+        if (hasFdRemote !== null)
+            return hasFdRemote;
+        try {
+            const sshService = executionContext?.getSSHService();
+            if (!sshService)
+                return false;
+            await sshService.executeCommand('fd --version');
+            hasFdRemote = true;
+        }
+        catch {
+            hasFdRemote = false;
+        }
+        return hasFdRemote;
+    }
+    else {
+        if (hasFd !== null)
+            return hasFd;
+        try {
+            await execPromise('fd --version');
+            hasFd = true;
+        }
+        catch {
+            hasFd = false;
+        }
+        return hasFd;
+    }
+}
+export const formatFindFilesCommandMessage = (item, index, toolCallArgumentsById) => {
+    const callId = getCallIdFromItem(item);
+    const fallbackArgs = callId && toolCallArgumentsById.has(callId)
+        ? toolCallArgumentsById.get(callId)
+        : null;
+    const normalizedArgs = item?.rawItem?.arguments ?? item?.arguments;
+    const args = normalizeToolArguments(normalizedArgs) ??
+        normalizeToolArguments(fallbackArgs) ??
+        {};
+    const pattern = args?.pattern ?? '';
+    const searchPath = args?.path ?? '.';
+    const maxResults = args?.max_results;
+    const parts = [`find_files "${pattern}"`];
+    if (searchPath !== '.' && searchPath) {
+        parts.push(`"${searchPath}"`);
+    }
+    if (maxResults) {
+        parts.push(`--max ${maxResults}`);
+    }
+    const command = parts.join(' ');
+    const output = getOutputText(item) || 'No output';
+    const success = !output.startsWith('Error:') && !output.startsWith('No files found');
+    return [
+        createBaseMessage(item, index, 0, false, {
+            command,
+            output,
+            success,
+            toolName: 'find_files',
+            toolArgs: args,
+        }),
+    ];
+};
+export const createFindFilesToolDefinition = (deps = {}) => {
+    const { executionContext } = deps;
+    return {
+        name: 'find_files',
+        description: 'Search for files by name in the workspace. Useful for finding files by pattern, exploring project structure, or locating specific files.',
+        parameters: findFilesParametersSchema,
+        needsApproval: () => false, // Search is read-only and safe
+        execute: async (params) => {
+            const { pattern, path: searchPath, max_results } = params;
+            // Validate pattern is not empty
+            if (!pattern || pattern.trim() === '') {
+                return 'Error: Search pattern cannot be empty. Please provide a valid file name or glob pattern.';
+            }
+            const limit = max_results ?? 50;
+            const targetPath = searchPath?.trim() || '.';
+            const cwd = executionContext?.getCwd() || process.cwd();
+            try {
+                // Validate path is within workspace
+                const absolutePath = resolveWorkspacePath(targetPath, cwd);
+                const useFd = await checkFdAvailability(executionContext);
+                let command = '';
+                if (useFd) {
+                    // Use fd (faster and more user-friendly)
+                    const args = [
+                        'fd',
+                        '--color=never',
+                        '--type',
+                        'f', // files only
+                        '--glob', // use glob pattern matching
+                    ];
+                    // Escape pattern for shell
+                    args.push(`'${pattern.replace(/'/g, "'\\''")}'`);
+                    args.push(`'${absolutePath.replace(/'/g, "'\\''")}'`);
+                    command = args.join(' ');
+                }
+                else {
+                    // Fallback to find
+                    const args = [
+                        'find',
+                        `'${absolutePath.replace(/'/g, "'\\''")}'`,
+                        '-type',
+                        'f',
+                        '-name',
+                    ];
+                    // Escape pattern for shell
+                    args.push(`'${pattern.replace(/'/g, "'\\''")}'`);
+                    command = args.join(' ');
+                }
+                const sshService = executionContext?.getSSHService();
+                const result = await executeShellCommand(command, {
+                    maxBuffer: 10 * 1024 * 1024, // 10MB buffer
+                    cwd,
+                    sshService,
+                });
+                if (result.exitCode === 1) {
+                    return `No files found matching pattern: ${pattern}`;
+                }
+                if (result.exitCode !== 0 && result.exitCode !== null) {
+                    throw new Error(result.stderr || 'Unknown error');
+                }
+                const trimmed = result.stdout.trim();
+                if (!trimmed) {
+                    return `No files found matching pattern: ${pattern}`;
+                }
+                const lines = trimmed.split('\n');
+                // Remove './' prefix from paths for cleaner output
+                const cleanedLines = lines.map(line => line.startsWith('./') ? line.substring(2) : line);
+                // Apply limit
+                let resultText = cleanedLines.slice(0, limit).join('\n');
+                // Add note if results were truncated
+                if (cleanedLines.length > limit) {
+                    resultText += `\n\nNote: Results limited to ${limit} files. Found ${cleanedLines.length} total matches. Use max_results parameter to see more.`;
+                }
+                return resultText;
+            }
+            catch (error) {
+                // Handle path resolution errors
+                if (error.message?.includes('outside workspace')) {
+                    return `Error: ${error.message}`;
+                }
+                // fd/find returns exit code 1 if no matches found
+                if (error.code === 1) {
+                    return `No files found matching pattern: ${pattern}`;
+                }
+                // Handle other errors
+                return `Error: ${error.message || String(error)}`;
+            }
+        },
+        formatCommandMessage: formatFindFilesCommandMessage,
+    };
+};
+//# sourceMappingURL=find-files.js.map

package/dist/tools/find-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-files.js","sourceRoot":"","sources":["../../source/tools/find-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AACtB,OAAO,EAAC,IAAI,EAAC,MAAM,eAAe,CAAC;AACnC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEjE,OAAO,EACH,aAAa,EACb,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,GACpB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AAEzC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,CACR,oFAAoF,CACpF;IACF,IAAI,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CACR,uFAAuF,CACvF;IACF,WAAW,EAAE,aAAa;SACxB,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,sDAAsD,CAAC;CAClE,CAAC,CAAC;AAKH,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE,IAAI,KAAK,GAAmB,IAAI,CAAC;AACjC,IAAI,WAAW,GAAmB,IAAI,CAAC;AAEvC,KAAK,UAAU,mBAAmB,CAAC,gBAAmC;IACrE,MAAM,QAAQ,GAAG,gBAAgB,EAAE,QAAQ,EAAE,IAAI,KAAK,CAAC;IAEvD,IAAI,QAAQ,EAAE,CAAC;QACd,IAAI,WAAW,KAAK,IAAI;YAAE,OAAO,WAAW,CAAC;QAC7C,IAAI,CAAC;YACJ,MAAM,UAAU,GAAG,gBAAgB,EAAE,aAAa,EAAE,CAAC;YACrD,IAAI,CAAC,UAAU;gBAAE,OAAO,KAAK,CAAC;YAC9B,MAAM,UAAU,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;YAChD,WAAW,GAAG,IAAI,CAAC;QACpB,CAAC;QAAC,MAAM,CAAC;YACR,WAAW,GAAG,KAAK,CAAC;QACrB,CAAC;QACD,OAAO,WAAW,CAAC;IACpB,CAAC;SAAM,CAAC;QACP,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QACjC,IAAI,CAAC;YACJ,MAAM,WAAW,CAAC,cAAc,CAAC,CAAC;YAClC,KAAK,GAAG,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACR,KAAK,GAAG,KAAK,CAAC;QACf,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC;AACF,CAAC;AAED,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAC5C,IAAS,EACT,KAAa,EACb,qBAA2C,EACxB,EAAE;IACrB,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,YAAY,GACjB,MAAM,IAAI,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC;QAC1C,CAAC,CAAC,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC;QACnC,CAAC,CAAC,IAAI,CAAC;IACT,MAAM,cAAc,GAAG,IAAI,EAAE,OAAO,EAAE,SAAS,IAAI,IAAI,EAAE,SAAS,CAAC;IACnE,MAAM,IAAI,GACT,sBAAsB,CAAC,cAAc,CAAC;QACtC,sBAAsB,CAAC,YAAY,CAAC;QACpC,EAAE,CAAC;IAEJ,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC;IACpC,MAAM,UAAU,GAAG,IAAI,EAAE,IAAI,IAAI,GAAG,CAAC;IACrC,MAAM,UAAU,GAAG,IAAI,EAAE,WAAW,CAAC;IAErC,MAAM,KAAK,GAAG,CAAC,eAAe,OAAO,GAAG,CAAC,CAAC;IAC1C,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,GAAG,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,UAAU,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,SAAS,UAAU,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC;IAClD,MAAM,OAAO,GACZ,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAEtE,OAAO;QACN,iBAAiB,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE;YACxC,OAAO;YACP,MAAM;YACN,OAAO;YACP,QAAQ,EAAE,YAAY;YACtB,QAAQ,EAAE,IAAI;SACd,CAAC;KACF,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,OAAgD,EAAE,EAAuC,EAAE;IACxI,MAAM,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC;IAClC,OAAO;QACN,IAAI,EAAE,YAAY;QAClB,WAAW,EACV,0IAA0I;QAC3I,UAAU,EAAE,yBAAyB;QACrC,aAAa,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,+BAA+B;QAC3D,OAAO,EAAE,KAAK,EAAC,MAAM,EAAC,EAAE;YACvB,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;YAE1D,gCAAgC;YAChC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBACvC,OAAO,0FAA0F,CAAC;YACnG,CAAC;YAED,MAAM,KAAK,GAAG,WAAW,IAAI,EAAE,CAAC;YAChC,MAAM,UAAU,GAAG,UAAU,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC;YAC7C,MAAM,GAAG,GAAG,gBAAgB,EAAE,MAAM,EAAE,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAExD,IAAI,CAAC;gBACL,oCAAoC;gBACnC,MAAM,YAAY,GAAG,oBAAoB,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;gBAE3D,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;gBAC1D,IAAI,OAAO,GAAG,EAAE,CAAC;gBAEjB,IAAI,KAAK,EAAE,CAAC;oBACX,yCAAyC;oBACzC,MAAM,IAAI,GAAG;wBACZ,IAAI;wBACJ,eAAe;wBACf,QAAQ;wBACR,GAAG,EAAE,aAAa;wBAClB,QAAQ,EAAE,4BAA4B;qBACtC,CAAC;oBAEF,2BAA2B;oBAC3B,IAAI,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;oBACjD,IAAI,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;oBAEtD,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC1B,CAAC;qBAAM,CAAC;oBACP,mBAAmB;oBACnB,MAAM,IAAI,GAAG;wBACZ,MAAM;wBACN,IAAI,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG;wBAC1C,OAAO;wBACP,GAAG;wBACH,OAAO;qBACP,CAAC;oBAEF,2BAA2B;oBAC3B,IAAI,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;oBAEjD,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC1B,CAAC;gBAED,MAAM,UAAU,GAAG,gBAAgB,EAAE,aAAa,EAAE,CAAC;gBAErD,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,OAAO,EAAE;oBACjD,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,cAAc;oBAC3C,GAAG;oBACH,UAAU;iBACV,CAAC,CAAC;gBAEH,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;oBAC3B,OAAO,oCAAoC,OAAO,EAAE,CAAC;gBACtD,CAAC;gBAED,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;oBACvD,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,IAAI,eAAe,CAAC,CAAC;gBACnD,CAAC;gBAED,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;gBAErC,IAAI,CAAC,OAAO,EAAE,CAAC;oBACd,OAAO,oCAAoC,OAAO,EAAE,CAAC;gBACtD,CAAC;gBAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAElC,mDAAmD;gBACnD,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CACrC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAChD,CAAC;gBAEF,cAAc;gBACd,IAAI,UAAU,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAEzD,qCAAqC;gBACrC,IAAI,YAAY,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;oBACjC,UAAU,IAAI,gCAAgC,KAAK,iBAAiB,YAAY,CAAC,MAAM,wDAAwD,CAAC;gBACjJ,CAAC;gBAED,OAAO,UAAU,CAAC;YACnB,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACrB,gCAAgC;gBAChC,IAAI,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;oBAClD,OAAO,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC;gBAClC,CAAC;gBAED,kDAAkD;gBAClD,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;oBACtB,OAAO,oCAAoC,OAAO,EAAE,CAAC;gBACtD,CAAC;gBAED,sBAAsB;gBACtB,OAAO,UAAU,KAAK,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACnD,CAAC;QACF,CAAC;QACD,oBAAoB,EAAE,6BAA6B;KACnD,CAAC;AACH,CAAC,CAAC"}

package/dist/tools/find-files.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=find-files.test.d.ts.map

package/dist/tools/find-files.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-files.test.d.ts","sourceRoot":"","sources":["../../source/tools/find-files.test.ts"],"names":[],"mappings":""}

package/dist/tools/find-files.test.js

@@ -0,0 +1,131 @@
+import test from 'ava';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as os from 'os';
+import { createFindFilesToolDefinition } from './find-files.js';
+const findFilesToolDefinition = createFindFilesToolDefinition();
+// Helper to create a temp dir and change cwd to it
+async function withTempDir(run) {
+    const originalCwd = process.cwd;
+    const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'term2-test-'));
+    // Mock process.cwd
+    process.cwd = () => tempDir;
+    try {
+        await run(tempDir);
+    }
+    finally {
+        process.cwd = originalCwd;
+        await fs.rm(tempDir, { recursive: true, force: true });
+    }
+}
+test.serial('needsApproval: returns false for read-only operation', async (t) => {
+    await withTempDir(async () => {
+        const result = await findFilesToolDefinition.needsApproval({
+            pattern: '*.ts',
+        });
+        t.false(result);
+    });
+});
+test.serial('execute: finds files by exact name', async (t) => {
+    await withTempDir(async (dir) => {
+        // Create test files
+        await fs.writeFile(path.join(dir, 'test.ts'), '');
+        await fs.writeFile(path.join(dir, 'other.js'), '');
+        const result = await findFilesToolDefinition.execute({
+            pattern: 'test.ts',
+        });
+        t.true(result.includes('test.ts'));
+        t.false(result.includes('other.js'));
+    });
+});
+test.serial('execute: finds files by glob pattern', async (t) => {
+    await withTempDir(async (dir) => {
+        // Create test files
+        await fs.writeFile(path.join(dir, 'file1.ts'), '');
+        await fs.writeFile(path.join(dir, 'file2.ts'), '');
+        await fs.writeFile(path.join(dir, 'file3.js'), '');
+        const result = await findFilesToolDefinition.execute({
+            pattern: '*.ts',
+        });
+        t.true(result.includes('file1.ts'));
+        t.true(result.includes('file2.ts'));
+        t.false(result.includes('file3.js'));
+    });
+});
+test.serial('execute: finds files in nested directories with glob pattern', async (t) => {
+    await withTempDir(async (dir) => {
+        // Create nested directory structure
+        await fs.mkdir(path.join(dir, 'src'));
+        await fs.mkdir(path.join(dir, 'src/utils'));
+        await fs.writeFile(path.join(dir, 'src/index.ts'), '');
+        await fs.writeFile(path.join(dir, 'src/utils/helper.ts'), '');
+        await fs.writeFile(path.join(dir, 'readme.md'), '');
+        const result = await findFilesToolDefinition.execute({
+            pattern: '*.ts',
+        });
+        t.true(result.includes('src/index.ts') || result.includes('index.ts'));
+        t.true(result.includes('src/utils/helper.ts') ||
+            result.includes('utils/helper.ts'));
+        t.false(result.includes('readme.md'));
+    });
+});
+test.serial('execute: restricts search to specified path', async (t) => {
+    await withTempDir(async (dir) => {
+        // Create nested directory structure
+        await fs.mkdir(path.join(dir, 'src'));
+        await fs.mkdir(path.join(dir, 'tests'));
+        await fs.writeFile(path.join(dir, 'src/app.ts'), '');
+        await fs.writeFile(path.join(dir, 'tests/app.test.ts'), '');
+        const result = await findFilesToolDefinition.execute({
+            pattern: '*.ts',
+            path: 'src',
+        });
+        t.true(result.includes('app.ts'));
+        t.false(result.includes('app.test.ts'));
+    });
+});
+test.serial('execute: respects max_results limit', async (t) => {
+    await withTempDir(async (dir) => {
+        // Create many files
+        for (let i = 1; i <= 10; i++) {
+            await fs.writeFile(path.join(dir, `file${i}.ts`), '');
+        }
+        const result = await findFilesToolDefinition.execute({
+            pattern: '*.ts',
+            max_results: 5,
+        });
+        const lines = result.trim().split('\n');
+        // Should have 5 file results + empty line + 1 note line = 7 lines max
+        t.true(lines.length <= 8);
+        t.true(result.includes('Results limited to'));
+    });
+});
+test.serial('execute: handles no matches found', async (t) => {
+    await withTempDir(async (dir) => {
+        await fs.writeFile(path.join(dir, 'file.js'), '');
+        const result = await findFilesToolDefinition.execute({
+            pattern: '*.ts',
+        });
+        t.true(result.includes('No files found'));
+    });
+});
+test.serial('execute: rejects path outside workspace', async (t) => {
+    await withTempDir(async () => {
+        const result = await findFilesToolDefinition.execute({
+            pattern: '*.ts',
+            path: '../outside',
+        });
+        t.true(result.includes('Error'));
+        t.true(result.includes('outside workspace'));
+    });
+});
+test.serial('execute: handles non-existent directory', async (t) => {
+    await withTempDir(async () => {
+        const result = await findFilesToolDefinition.execute({
+            pattern: '*.ts',
+            path: 'nonexistent',
+        });
+        t.true(result.includes('Error') || result.includes('No files found'));
+    });
+});
+//# sourceMappingURL=find-files.test.js.map

package/dist/tools/find-files.test.js.map

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

package/dist/tools/format-helpers.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Helper utilities for formatting tool execution results into command messages.
+ * These utilities are shared across tool formatters to maintain consistency.
+ */
+import type { CommandMessage } from './types.js';
+/**
+ * Coerces various value types into a text string representation.
+ */
+export declare const coerceToText: (value: unknown) => string;
+/**
+ * Extracts call ID from various item formats.
+ */
+export declare const getCallIdFromItem: (item: any) => string | null;
+/**
+ * Extracts output text from various item formats.
+ */
+export declare const getOutputText: (item: any) => string;
+/**
+ * Safely parses JSON payload.
+ */
+export declare const safeJsonParse: (payload: unknown) => any;
+/**
+ * Normalizes tool arguments from various formats.
+ */
+export declare const normalizeToolArguments: (value: unknown) => any;
+/**
+ * Generates a stable ID for a command message.
+ */
+export declare const generateMessageId: (item: any, index: number, subIndex?: number) => string;
+/**
+ * Creates a base command message with common fields filled in.
+ */
+export declare const createBaseMessage: (item: any, index: number, subIndex: number, isApprovalRejection: boolean, partial: Partial<CommandMessage>) => CommandMessage;
+//# sourceMappingURL=format-helpers.d.ts.map

package/dist/tools/format-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-helpers.d.ts","sourceRoot":"","sources":["../../source/tools/format-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,YAAY,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,KAAG,MAiC7C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAM,GAAG,KAAG,MAAM,GAAG,IAmBtD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,GAAG,KAAG,MAiBzC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,SAAS,OAAO,KAAG,GAehD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,OAAO,KAAG,GAUvD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAC1B,MAAM,GAAG,EACT,OAAO,MAAM,EACb,WAAU,MAAU,KACrB,MASF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAC1B,MAAM,GAAG,EACT,OAAO,MAAM,EACb,UAAU,MAAM,EAChB,qBAAqB,OAAO,EAC5B,SAAS,OAAO,CAAC,cAAc,CAAC,KACjC,cAUF,CAAC"}