byterover-cli 1.6.0 → 1.7.0

package/dist/agent/infra/tools/implementations/delete-memory-tool.d.ts

@@ -0,0 +1,12 @@
+import type { Tool } from '../../../core/domain/tools/types.js';
+import type { MemoryManager } from '../../memory/memory-manager.js';
+/**
+ * Delete memory tool.
+ *
+ * Removes a memory from the scratch pad. Also deletes any blob attachments
+ * associated with the memory. Use this to clean up outdated or unnecessary context.
+ *
+ * @param memoryManager - Memory manager service dependency
+ * @returns Configured delete memory tool
+ */
+export declare function createDeleteMemoryTool(memoryManager: MemoryManager): Tool;

package/dist/agent/infra/tools/implementations/delete-memory-tool.js

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+import { ToolName } from '../../../core/domain/tools/constants.js';
+/**
+ * Input schema for delete memory tool.
+ */
+const DeleteMemoryInputSchema = z
+    .object({
+    id: z.string().min(1).describe('Unique identifier of the memory to delete'),
+})
+    .strict();
+/**
+ * Delete memory tool.
+ *
+ * Removes a memory from the scratch pad. Also deletes any blob attachments
+ * associated with the memory. Use this to clean up outdated or unnecessary context.
+ *
+ * @param memoryManager - Memory manager service dependency
+ * @returns Configured delete memory tool
+ */
+export function createDeleteMemoryTool(memoryManager) {
+    return {
+        description: 'Delete a memory by ID. Removes the memory and all associated attachments from the scratch pad. Use this to clean up outdated context.',
+        async execute(input, _context) {
+            const { id } = input;
+            // Delete memory
+            await memoryManager.delete(id);
+            // Return confirmation
+            return {
+                deleted: true,
+                id,
+                message: `Memory ${id} has been deleted successfully`,
+            };
+        },
+        id: ToolName.DELETE_MEMORY,
+        inputSchema: DeleteMemoryInputSchema,
+    };
+}

package/dist/agent/infra/tools/implementations/edit-file-tool.d.ts

@@ -0,0 +1,13 @@
+import type { Tool } from '../../../core/domain/tools/types.js';
+import type { IFileSystem } from '../../../core/interfaces/i-file-system.js';
+/**
+ * Creates the edit file tool.
+ *
+ * Edits a file by replacing text.
+ * By default, requires oldString to be unique (only one occurrence).
+ * Set replaceAll to true to replace all occurrences.
+ *
+ * @param fileSystemService - File system service dependency
+ * @returns Configured edit file tool
+ */
+export declare function createEditFileTool(fileSystemService: IFileSystem): Tool;

package/dist/agent/infra/tools/implementations/edit-file-tool.js

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+import { ToolName } from '../../../core/domain/tools/constants.js';
+/**
+ * Input schema for edit file tool.
+ */
+const EditFileInputSchema = z
+    .object({
+    filePath: z.string().describe('Absolute path to the file to edit'),
+    newString: z.string().describe('Replacement text'),
+    oldString: z.string().describe('Text to replace (must be unique unless replaceAll is true)'),
+    replaceAll: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Replace all occurrences (default: false, requires unique match)'),
+})
+    .strict();
+/**
+ * Creates the edit file tool.
+ *
+ * Edits a file by replacing text.
+ * By default, requires oldString to be unique (only one occurrence).
+ * Set replaceAll to true to replace all occurrences.
+ *
+ * @param fileSystemService - File system service dependency
+ * @returns Configured edit file tool
+ */
+export function createEditFileTool(fileSystemService) {
+    return {
+        description: 'Edit a file by replacing text. By default requires unique match (set replaceAll=true for multiple replacements).',
+        async execute(input, _context) {
+            const { filePath, newString, oldString, replaceAll } = input;
+            // Call file system service
+            const result = await fileSystemService.editFile(filePath, {
+                newString,
+                oldString,
+                replaceAll,
+            }, {});
+            // Return formatted result
+            return {
+                bytesWritten: result.bytesWritten,
+                path: result.path,
+                replacements: result.replacements,
+                success: result.success,
+            };
+        },
+        id: ToolName.EDIT_FILE,
+        inputSchema: EditFileInputSchema,
+    };
+}

package/dist/agent/infra/tools/implementations/edit-memory-tool.d.ts

@@ -0,0 +1,13 @@
+import type { Tool } from '../../../core/domain/tools/types.js';
+import type { MemoryManager } from '../../memory/memory-manager.js';
+/**
+ * Creates the edit memory tool.
+ *
+ * Updates an existing memory's content, tags, or pinned status. Metadata is merged
+ * while content and tags are replaced if provided. Use this to refine or update
+ * context in the scratch pad.
+ *
+ * @param memoryManager - Memory manager service dependency
+ * @returns Configured edit memory tool
+ */
+export declare function createEditMemoryTool(memoryManager: MemoryManager): Tool;

package/dist/agent/infra/tools/implementations/edit-memory-tool.js

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+import { ToolName } from '../../../core/domain/tools/constants.js';
+/**
+ * Input schema for edit memory tool.
+ */
+const EditMemoryInputSchema = z
+    .object({
+    content: z
+        .string()
+        .min(1, 'Memory content cannot be empty')
+        .max(10_000, 'Memory content cannot exceed 10,000 characters')
+        .optional()
+        .describe('Updated content for the memory'),
+    id: z.string().min(1).describe('Unique identifier of the memory to edit'),
+    pinned: z.boolean().optional().describe('Updated pinned status'),
+})
+    .strict();
+/**
+ * Creates the edit memory tool.
+ *
+ * Updates an existing memory's content, tags, or pinned status. Metadata is merged
+ * while content and tags are replaced if provided. Use this to refine or update
+ * context in the scratch pad.
+ *
+ * @param memoryManager - Memory manager service dependency
+ * @returns Configured edit memory tool
+ */
+export function createEditMemoryTool(memoryManager) {
+    return {
+        description: 'Edit an existing memory. Update content, tags, or pinned status. Use this to refine or update previously stored context.',
+        async execute(input, _context) {
+            const { content, id, pinned } = input;
+            // Build update input
+            const updateInput = {};
+            if (content !== undefined) {
+                updateInput.content = content;
+            }
+            if (pinned !== undefined) {
+                updateInput.metadata = { pinned };
+            }
+            // Update memory
+            const updatedMemory = await memoryManager.update(id, updateInput);
+            // Return formatted result
+            return {
+                content: updatedMemory.content,
+                id: updatedMemory.id,
+                updatedAt: new Date(updatedMemory.updatedAt).toISOString(),
+            };
+        },
+        id: ToolName.EDIT_MEMORY,
+        inputSchema: EditMemoryInputSchema,
+    };
+}

package/dist/agent/infra/tools/implementations/glob-files-tool.d.ts

@@ -0,0 +1,18 @@
+import type { Tool } from '../../../core/domain/tools/types.js';
+import type { IFileSystem } from '../../../core/interfaces/i-file-system.js';
+/**
+ * Creates the glob files tool.
+ *
+ * Finds files matching a glob pattern.
+ * Supports standard glob syntax with ** for recursive matching.
+ *
+ * Features:
+ * - Case sensitivity control
+ * - Gitignore filtering (respects .gitignore rules by default)
+ * - Smart sorting: recently modified files (within 24h) appear first
+ * - Handles file names containing glob special characters
+ *
+ * @param fileSystemService - File system service dependency
+ * @returns Configured glob files tool
+ */
+export declare function createGlobFilesTool(fileSystemService: IFileSystem): Tool;

package/dist/agent/infra/tools/implementations/glob-files-tool.js

@@ -0,0 +1,70 @@
+import { z } from 'zod';
+import { ToolName } from '../../../core/domain/tools/constants.js';
+/**
+ * Input schema for glob files tool.
+ */
+const GlobFilesInputSchema = z
+    .object({
+    caseSensitive: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe('Case-sensitive pattern matching (default: true)'),
+    maxResults: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .default(1000)
+        .describe('Maximum number of results to return (default: 1000)'),
+    path: z.string().optional().describe('Base directory to search from (defaults to working directory)'),
+    pattern: z.string().describe('Glob pattern to match files (e.g., "**/*.ts", "src/**/*.js")')
+})
+    .strict();
+/**
+ * Creates the glob files tool.
+ *
+ * Finds files matching a glob pattern.
+ * Supports standard glob syntax with ** for recursive matching.
+ *
+ * Features:
+ * - Case sensitivity control
+ * - Gitignore filtering (respects .gitignore rules by default)
+ * - Smart sorting: recently modified files (within 24h) appear first
+ * - Handles file names containing glob special characters
+ *
+ * @param fileSystemService - File system service dependency
+ * @returns Configured glob files tool
+ */
+export function createGlobFilesTool(fileSystemService) {
+    return {
+        description: 'Find files matching a glob pattern. Supports ** for recursive matching (e.g., "**/*.ts" finds all TypeScript files)',
+        async execute(input, _context) {
+            const { caseSensitive, maxResults, path, pattern } = input;
+            // Call file system service with new options
+            const result = await fileSystemService.globFiles(pattern, {
+                caseSensitive,
+                cwd: path,
+                includeMetadata: true,
+                maxResults,
+                respectGitignore: true,
+            });
+            // Format file metadata
+            const files = result.files.map((file) => ({
+                modified: file.modified.toISOString(),
+                path: file.path,
+                size: file.size,
+            }));
+            // Return formatted result with message for LLM context
+            return {
+                files,
+                ignoredCount: result.ignoredCount,
+                message: result.message,
+                totalFound: result.totalFound,
+                truncated: result.truncated,
+            };
+        },
+        id: ToolName.GLOB_FILES,
+        inputSchema: GlobFilesInputSchema,
+    };
+}

package/dist/agent/infra/tools/implementations/grep-content-tool.d.ts

@@ -0,0 +1,12 @@
+import type { Tool } from '../../../core/domain/tools/types.js';
+import type { IFileSystem } from '../../../core/interfaces/i-file-system.js';
+/**
+ * Creates the grep content tool.
+ *
+ * Searches file contents for a regex pattern.
+ * Can filter files with glob patterns and include context lines.
+ *
+ * @param fileSystemService - File system service dependency
+ * @returns Configured grep content tool
+ */
+export declare function createGrepContentTool(fileSystemService: IFileSystem): Tool;

package/dist/agent/infra/tools/implementations/grep-content-tool.js

@@ -0,0 +1,77 @@
+import { z } from 'zod';
+import { ToolName } from '../../../core/domain/tools/constants.js';
+/**
+ * Input schema for grep content tool.
+ */
+const GrepContentInputSchema = z
+    .object({
+    caseInsensitive: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Perform case-insensitive search (default: false)'),
+    contextLines: z
+        .number()
+        .int()
+        .min(0)
+        .optional()
+        .default(0)
+        .describe('Number of context lines to include before and after each match (default: 0)'),
+    glob: z.string().optional().describe('Glob pattern to filter files (e.g., "*.ts", "**/*.js")'),
+    maxResults: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .default(100)
+        .describe('Maximum number of results to return (default: 100)'),
+    path: z.string().optional().describe('Directory to search in (defaults to working directory)'),
+    pattern: z.string().describe('Regular expression pattern to search for'),
+})
+    .strict();
+/**
+ * Creates the grep content tool.
+ *
+ * Searches file contents for a regex pattern.
+ * Can filter files with glob patterns and include context lines.
+ *
+ * @param fileSystemService - File system service dependency
+ * @returns Configured grep content tool
+ */
+export function createGrepContentTool(fileSystemService) {
+    return {
+        description: 'Search file contents for a regex pattern. Can filter files with glob patterns and include context lines around matches.',
+        async execute(input, _context) {
+            const { caseInsensitive, contextLines, glob, maxResults, path, pattern } = input;
+            // Call file system service
+            const result = await fileSystemService.searchContent(pattern, {
+                caseInsensitive,
+                contextLines,
+                cwd: path,
+                globPattern: glob,
+                maxResults,
+            });
+            // Format matches
+            const matches = result.matches.map((match) => ({
+                context: match.context
+                    ? {
+                        after: match.context.after,
+                        before: match.context.before,
+                    }
+                    : undefined,
+                file: match.file,
+                line: match.line,
+                lineNumber: match.lineNumber,
+            }));
+            // Return formatted result
+            return {
+                filesSearched: result.filesSearched,
+                matches,
+                totalMatches: result.totalMatches,
+                truncated: result.truncated,
+            };
+        },
+        id: ToolName.GREP_CONTENT,
+        inputSchema: GrepContentInputSchema,
+    };
+}

package/dist/agent/infra/tools/implementations/kill-process-tool.d.ts

@@ -0,0 +1,12 @@
+import type { Tool } from '../../../core/domain/tools/types.js';
+import type { IProcessService } from '../../../core/interfaces/i-process-service.js';
+/**
+ * Create kill_process tool.
+ *
+ * Terminates a background process started by bash_exec.
+ * Uses graceful shutdown (SIGTERM) with escalation to SIGKILL after 5 seconds.
+ *
+ * @param processService - Process service for killing processes
+ * @returns kill_process tool instance
+ */
+export declare function createKillProcessTool(processService: IProcessService): Tool;

package/dist/agent/infra/tools/implementations/kill-process-tool.js

@@ -0,0 +1,55 @@
+import { z } from 'zod';
+import { ToolName } from '../../../core/domain/tools/constants.js';
+/**
+ * Input schema for kill_process tool.
+ */
+const KillProcessInputSchema = z
+    .object({
+    /**
+     * Unique process identifier from bash_exec.
+     */
+    processId: z.string().describe('Unique process identifier from bash_exec'),
+})
+    .strict();
+/**
+ * Create kill_process tool.
+ *
+ * Terminates a background process started by bash_exec.
+ * Uses graceful shutdown (SIGTERM) with escalation to SIGKILL after 5 seconds.
+ *
+ * @param processService - Process service for killing processes
+ * @returns kill_process tool instance
+ */
+export function createKillProcessTool(processService) {
+    return {
+        description: `Terminate a background process started by bash_exec.
+
+Features:
+- Graceful shutdown: Sends SIGTERM first to allow cleanup
+- Force kill: Escalates to SIGKILL after 5 seconds if still running
+- Idempotent: Safe to call on already-terminated processes
+
+Signal handling:
+1. Sends SIGTERM (allows process to cleanup gracefully)
+2. Waits 5 seconds
+3. Sends SIGKILL if process still running (force terminate)
+
+Use cases:
+- Stop long-running commands that are no longer needed
+- Cancel background processes that are taking too long
+- Clean up processes before starting new ones`,
+        async execute(input, _context) {
+            const { processId } = input;
+            // Kill process via process service
+            await processService.killProcess(processId);
+            // Return success confirmation
+            return {
+                message: `Process ${processId} terminated successfully`,
+                processId,
+                success: true,
+            };
+        },
+        id: ToolName.KILL_PROCESS,
+        inputSchema: KillProcessInputSchema,
+    };
+}

package/dist/agent/infra/tools/implementations/list-directory-tool.d.ts

@@ -0,0 +1,12 @@
+import type { Tool } from '../../../core/domain/tools/types.js';
+import type { IFileSystem } from '../../../core/interfaces/i-file-system.js';
+/**
+ * Creates the list directory tool.
+ *
+ * Lists files and directories in a tree structure.
+ * Automatically ignores common build artifacts and caches.
+ *
+ * @param fileSystemService - File system service dependency
+ * @returns Configured list directory tool
+ */
+export declare function createListDirectoryTool(fileSystemService: IFileSystem): Tool;

package/dist/agent/infra/tools/implementations/list-directory-tool.js

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+import { ToolName } from '../../../core/domain/tools/constants.js';
+/**
+ * Input schema for list directory tool.
+ */
+const ListDirectoryInputSchema = z
+    .object({
+    ignore: z
+        .array(z.string())
+        .optional()
+        .describe('Additional glob patterns to ignore (e.g., ["*.log", "temp/"])'),
+    maxResults: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .default(100)
+        .describe('Maximum number of files to return (default: 100)'),
+    path: z
+        .string()
+        .optional()
+        .describe('The absolute path to the directory to list (defaults to working directory)'),
+})
+    .strict();
+/**
+ * Creates the list directory tool.
+ *
+ * Lists files and directories in a tree structure.
+ * Automatically ignores common build artifacts and caches.
+ *
+ * @param fileSystemService - File system service dependency
+ * @returns Configured list directory tool
+ */
+export function createListDirectoryTool(fileSystemService) {
+    return {
+        description: 'Lists files and directories in a tree structure. Automatically ignores common build artifacts (node_modules, dist, .git, etc.).',
+        async execute(input, _context) {
+            const { ignore, maxResults, path } = input;
+            const result = await fileSystemService.listDirectory(path ?? '.', {
+                ignore,
+                maxResults,
+            });
+            return {
+                count: result.count,
+                tree: result.tree,
+                truncated: result.truncated,
+            };
+        },
+        id: ToolName.LIST_DIRECTORY,
+        inputSchema: ListDirectoryInputSchema,
+    };
+}

package/dist/agent/infra/tools/implementations/list-memories-tool.d.ts

@@ -0,0 +1,12 @@
+import type { Tool } from '../../../core/domain/tools/types.js';
+import type { MemoryManager } from '../../memory/memory-manager.js';
+/**
+ * Creates the list memories tool.
+ *
+ * Lists and filters memories stored in the scratch pad. Supports filtering by
+ * tags, pinned status, and source. Results are sorted by most recently updated first.
+ *
+ * @param memoryManager - Memory manager service dependency
+ * @returns Configured list memories tool
+ */
+export declare function createListMemoriesTool(memoryManager: MemoryManager): Tool;

package/dist/agent/infra/tools/implementations/list-memories-tool.js

@@ -0,0 +1,63 @@
+import { z } from 'zod';
+import { ToolName } from '../../../core/domain/tools/constants.js';
+/**
+ * Input schema for list memories tool.
+ */
+const ListMemoriesInputSchema = z
+    .object({
+    limit: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe('Maximum number of memories to return'),
+    offset: z
+        .number()
+        .int()
+        .nonnegative()
+        .optional()
+        .describe('Number of memories to skip (for pagination)'),
+    pinned: z.boolean().optional().describe('Filter by pinned status'),
+    source: z
+        .enum(['agent', 'system', 'user'])
+        .optional()
+        .describe('Filter by source (default: agent)'),
+})
+    .strict();
+/**
+ * Creates the list memories tool.
+ *
+ * Lists and filters memories stored in the scratch pad. Supports filtering by
+ * tags, pinned status, and source. Results are sorted by most recently updated first.
+ *
+ * @param memoryManager - Memory manager service dependency
+ * @returns Configured list memories tool
+ */
+export function createListMemoriesTool(memoryManager) {
+    return {
+        description: 'List and filter memories from the scratch pad. Returns memories sorted by most recent first. Use this to discover what context has been stored.',
+        async execute(input, _context) {
+            const { limit, offset, pinned, source } = input;
+            // List memories with filters
+            const memories = await memoryManager.list({
+                limit,
+                offset,
+                pinned,
+                source,
+            });
+            // Return formatted result with preview
+            return {
+                count: memories.length,
+                memories: memories.map(m => ({
+                    contentPreview: m.content.length > 200 ? `${m.content.slice(0, 200)}...` : m.content,
+                    createdAt: new Date(m.createdAt).toISOString(),
+                    id: m.id,
+                    pinned: m.metadata?.pinned ?? false,
+                    updatedAt: new Date(m.updatedAt).toISOString(),
+                })),
+            };
+        },
+        id: ToolName.LIST_MEMORIES,
+        inputSchema: ListMemoriesInputSchema,
+    };
+}

package/dist/agent/infra/tools/implementations/read-file-tool.d.ts

@@ -0,0 +1,19 @@
+import type { Tool } from '../../../core/domain/tools/types.js';
+import type { IFileSystem } from '../../../core/interfaces/i-file-system.js';
+/**
+ * Creates the read file tool.
+ *
+ * Reads the contents of a file with optional pagination support.
+ *
+ * Features:
+ * - Accepts both absolute and relative paths
+ * - Image/PDF files returned as base64 attachments for multimodal LLMs
+ * - Binary file detection with clear error messages
+ * - .env file blocking with whitelist for example files
+ * - XML-wrapped output for clearer LLM parsing
+ * - Preview metadata for UI display
+ *
+ * @param fileSystemService - File system service dependency
+ * @returns Configured read file tool
+ */
+export declare function createReadFileTool(fileSystemService: IFileSystem): Tool;