agent-sory 1.0.0

package/dist/tools/tool-schemas.js

@@ -0,0 +1,482 @@
+/**
+ * Tool schemas for Groq function calling API.
+ * These define the available tools that the LLM can call.
+ */
+// File Operation Tools
+export const READ_FILE_SCHEMA = {
+    type: 'function',
+    function: {
+        name: 'read_file',
+        description: 'Read file contents with optional line range. REQUIRED before edit_file. Use to check if files exist and examine current code before making changes. Example: {"file_path": "src/app.js", "start_line": 10, "end_line": 20}',
+        parameters: {
+            type: 'object',
+            properties: {
+                file_path: {
+                    type: 'string',
+                    description: 'Path to file. For files in current directory use just filename (e.g. "app.js"). For subdirectories use "src/app.js". DO NOT use absolute paths or leading slashes.'
+                },
+                start_line: {
+                    type: 'integer',
+                    description: 'Starting line number (1-indexed, optional)',
+                    minimum: 1
+                },
+                end_line: {
+                    type: 'integer',
+                    description: 'Ending line number (1-indexed, optional)',
+                    minimum: 1
+                }
+            },
+            required: ['file_path']
+        }
+    }
+};
+export const READ_MANY_FILES_SCHEMA = {
+    type: 'function',
+    function: {
+        name: 'read_many_files',
+        description: 'Read multiple files at once. Efficient for exploring dependencies or related files.',
+        parameters: {
+            type: 'object',
+            properties: {
+                file_paths: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'List of file paths to read'
+                }
+            },
+            required: ['file_paths']
+        }
+    }
+};
+export const CREATE_FILE_SCHEMA = {
+    type: 'function',
+    function: {
+        name: 'create_file',
+        description: 'Create NEW files or directories that DO NOT EXIST. CRITICAL: Always check if file exists first using list_files or read_file before creating. If file exists, use edit_file instead. Set overwrite=true only if you explicitly need to replace existing content. Example: {"file_path": "src/utils/new-helper.js", "content": "function helper() { return true; }", "file_type": "file"}',
+        parameters: {
+            type: 'object',
+            properties: {
+                file_path: {
+                    type: 'string',
+                    description: 'Path for new file/directory. For files in current directory use just filename (e.g. "app.js"). For subdirectories use "src/app.js". DO NOT use absolute paths or leading slashes.'
+                },
+                content: {
+                    type: 'string',
+                    description: 'File content (use empty string "" for directories)'
+                },
+                file_type: {
+                    type: 'string',
+                    enum: ['file', 'directory'],
+                    description: 'Create file or directory',
+                    default: 'file'
+                },
+                overwrite: {
+                    type: 'boolean',
+                    description: 'Overwrite existing file',
+                    default: false
+                }
+            },
+            required: ['file_path', 'content']
+        }
+    }
+};
+export const EDIT_FILE_SCHEMA = {
+    type: 'function',
+    function: {
+        name: 'edit_file',
+        description: 'Replaces text within a file. By default, replaces a single occurrence. CRITICAL: Include at least 3 lines of context BEFORE and AFTER the target text to uniquely identify it. Text must match EXACTLY including whitespace and indentation.',
+        parameters: {
+            type: 'object',
+            properties: {
+                file_path: {
+                    type: 'string',
+                    description: 'Path to the file to modify.'
+                },
+                old_string: {
+                    type: 'string',
+                    description: 'The exact literal text to replace. Include context lines.'
+                },
+                new_string: {
+                    type: 'string',
+                    description: 'The replacement text.'
+                },
+                expected_replacements: {
+                    type: 'integer',
+                    description: 'Number of replacements expected. Defaults to 1.',
+                    default: 1
+                },
+                instruction: {
+                    type: 'string',
+                    description: 'A clear description of WHY this change is being made.'
+                }
+            },
+            required: ['file_path', 'old_string', 'new_string']
+        }
+    }
+};
+export const DELETE_FILE_SCHEMA = {
+    type: 'function',
+    function: {
+        name: 'delete_file',
+        description: 'Remove files or directories. Use with caution. Example: {"file_path": "temp/old_file.txt"} or {"file_path": "temp_dir", "recursive": true}',
+        parameters: {
+            type: 'object',
+            properties: {
+                file_path: {
+                    type: 'string',
+                    description: 'Path to file/directory to delete. For files in current directory use just filename (e.g. "app.js"). For subdirectories use "src/app.js". DO NOT use absolute paths or leading slashes.'
+                },
+                recursive: {
+                    type: 'boolean',
+                    description: 'Delete directories and their contents',
+                    default: false
+                }
+            },
+            required: ['file_path']
+        }
+    }
+};
+// Code Execution Tools
+export const EXECUTE_COMMAND_SCHEMA = {
+    type: 'function',
+    function: {
+        name: 'execute_command',
+        description: 'Run shell commands, scripts, or code. SAFETY WARNING: Only use for commands that COMPLETE and EXIT (test scripts, build commands, short-running scripts). NEVER use for commands that run indefinitely (flask server, node app starting, python -m http.server, etc.). Always prefer short-running commands that exit. Example: {"command": "npm test", "command_type": "bash"}',
+        parameters: {
+            type: 'object',
+            properties: {
+                command: {
+                    type: 'string',
+                    description: 'Shell command to execute. Only use commands that exit/stop automatically. Examples: "python my_script.py", "npm test", "ls -la". Avoid: long-running commands, "npm start" (starts servers), etc.'
+                },
+                command_type: {
+                    type: 'string',
+                    enum: ['bash', 'python', 'setup', 'run'],
+                    description: 'Command type: bash (shell), python (script), setup (auto-run), run (needs approval)'
+                },
+                working_directory: {
+                    type: 'string',
+                    description: 'Directory to run command in (optional)'
+                },
+                timeout: {
+                    type: 'integer',
+                    description: 'Max execution time in seconds (1-300)',
+                    minimum: 1,
+                    maximum: 300
+                }
+            },
+            required: ['command', 'command_type']
+        }
+    }
+};
+// Information Tools
+export const SEARCH_FILES_SCHEMA = {
+    type: 'function',
+    function: {
+        name: 'search_files',
+        description: 'Find text patterns in files across the codebase. Perfect for locating functions, classes, or specific code. Example: {"pattern": "function handleClick", "file_pattern": "*.js", "context_lines": 3}',
+        parameters: {
+            type: 'object',
+            properties: {
+                pattern: {
+                    type: 'string',
+                    description: 'Text to search for (can be function names, classes, strings, etc.)'
+                },
+                file_pattern: {
+                    type: 'string',
+                    description: 'File pattern filter (e.g., "*.py", "*.js", "src/*.ts")',
+                    default: '*'
+                },
+                directory: {
+                    type: 'string',
+                    description: 'Directory to search in. Use "." or "" for current directory, "src" for subdirectory. DO NOT include leading slash.',
+                    default: '.'
+                },
+                case_sensitive: {
+                    type: 'boolean',
+                    description: 'Case-sensitive search',
+                    default: false
+                },
+                pattern_type: {
+                    type: 'string',
+                    enum: ['substring', 'regex', 'exact', 'fuzzy'],
+                    description: 'Match type: substring (partial), regex (patterns), exact (whole), fuzzy (similar)',
+                    default: 'substring'
+                },
+                file_types: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'File extensions to include (["py", "js", "ts"])'
+                },
+                exclude_dirs: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Directories to skip (["node_modules", ".git", "dist"])'
+                },
+                exclude_files: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'File patterns to skip (["*.min.js", "*.log"])'
+                },
+                max_results: {
+                    type: 'integer',
+                    description: 'Maximum results to return (1-1000)',
+                    default: 100,
+                    minimum: 1,
+                    maximum: 1000
+                },
+                context_lines: {
+                    type: 'integer',
+                    description: 'Lines of context around matches (0-10)',
+                    default: 0,
+                    minimum: 0,
+                    maximum: 10
+                },
+                group_by_file: {
+                    type: 'boolean',
+                    description: 'Group results by filename',
+                    default: false
+                }
+            },
+            required: ['pattern']
+        }
+    }
+};
+export const LIST_FILES_SCHEMA = {
+    type: 'function',
+    function: {
+        name: 'list_files',
+        description: 'Browse directory contents and file structure. Use to explore project layout and CHECK IF FILES EXIST before deciding between create_file vs edit_file. Example: {"directory": "src", "pattern": "*.js", "recursive": true}',
+        parameters: {
+            type: 'object',
+            properties: {
+                directory: {
+                    type: 'string',
+                    description: 'Directory path to list. Use "." or "" for current directory, "src" for subdirectory. DO NOT include leading slash.',
+                    default: '.'
+                },
+                pattern: {
+                    type: 'string',
+                    description: 'File pattern filter ("*.py", "test_*", etc.)',
+                    default: '*'
+                },
+                recursive: {
+                    type: 'boolean',
+                    description: 'List subdirectories recursively',
+                    default: false
+                },
+                show_hidden: {
+                    type: 'boolean',
+                    description: 'Include hidden files (.gitignore, .env, etc.)',
+                    default: false
+                }
+            },
+            required: []
+        }
+    }
+};
+// Task Management Tools
+export const CREATE_TASKS_SCHEMA = {
+    type: 'function',
+    function: {
+        name: 'create_tasks',
+        description: 'Break down complex requests into organized task lists. Use for multi-step projects. Example: {"user_query": "Build login system", "tasks": [{"id": "1", "description": "Create user model", "status": "pending"}]}',
+        parameters: {
+            type: 'object',
+            properties: {
+                user_query: {
+                    type: 'string',
+                    description: 'Original user request being broken down'
+                },
+                tasks: {
+                    type: 'array',
+                    description: 'List of actionable subtasks',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            id: {
+                                type: 'string',
+                                description: 'Unique task identifier string (e.g., "1", "2", "3")'
+                            },
+                            description: {
+                                type: 'string',
+                                description: 'Clear, actionable task description'
+                            },
+                            status: {
+                                type: 'string',
+                                enum: ['pending', 'in_progress', 'completed'],
+                                description: 'Task status: pending, in_progress, or completed',
+                                default: 'pending'
+                            }
+                        },
+                        required: ['id', 'description']
+                    }
+                }
+            },
+            required: ['user_query', 'tasks']
+        }
+    }
+};
+export const UPDATE_TASKS_SCHEMA = {
+    type: 'function',
+    function: {
+        name: 'update_tasks',
+        description: 'Update task progress and status. Use to mark tasks as started or completed. Example: {"task_updates": [{"id": "1", "status": "completed", "notes": "Successfully implemented"}]}',
+        parameters: {
+            type: 'object',
+            properties: {
+                task_updates: {
+                    type: 'array',
+                    description: 'Array of status updates for specific tasks',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            id: {
+                                type: 'string',
+                                description: 'ID string of task to update (must match existing task ID)'
+                            },
+                            status: {
+                                type: 'string',
+                                enum: ['pending', 'in_progress', 'completed'],
+                                description: 'New status: pending, in_progress, or completed'
+                            },
+                            notes: {
+                                type: 'string',
+                                description: 'Optional progress notes or completion details'
+                            }
+                        },
+                        required: ['id', 'status']
+                    }
+                }
+            },
+            required: ['task_updates']
+        }
+    }
+};
+export const GREP_SCHEMA = {
+    type: 'function',
+    function: {
+        name: 'grep',
+        description: 'FAST, optimized search powered by `ripgrep`. Returns matches with context. Preferred over search_files for large codebases.',
+        parameters: {
+            type: 'object',
+            properties: {
+                pattern: { type: 'string', description: 'The pattern to search for (regex by default).' },
+                include: { type: 'string', description: 'Glob pattern to filter files (e.g., "*.ts", "src/**").' },
+                context: { type: 'integer', description: 'Lines of context around each match.', default: 2 },
+                case_sensitive: { type: 'boolean', description: 'Case-sensitive search.', default: false },
+                dir_path: { type: 'string', description: 'Directory to search in. Defaults to current directory.', default: '.' },
+                fixed_strings: { type: 'boolean', description: 'Treat pattern as a literal string.', default: false }
+            },
+            required: ['pattern']
+        }
+    }
+};
+export const GLOB_SCHEMA = {
+    type: 'function',
+    function: {
+        name: 'glob',
+        description: 'Trouve des fichiers correspondant à un pattern glob spécifique (ex: "**/*.md", "src/ui/*.tsx"). Très utile pour localiser des fichiers sans lister tous les répertoires.',
+        parameters: {
+            type: 'object',
+            properties: {
+                pattern: { type: 'string', description: 'Le pattern glob (ex: "src/**/*.ts")' }
+            },
+            required: ['pattern']
+        }
+    }
+};
+export const SAVE_MEMORY_SCHEMA = {
+    type: 'function',
+    function: {
+        name: 'save_memory',
+        description: 'Enregistre une information cruciale dans la mémoire à long terme du projet (SORY.md). À utiliser quand l\'utilisateur donne une instruction importante pour le futur ou un fait technique clé.',
+        parameters: {
+            type: 'object',
+            properties: {
+                fact: { type: 'string', description: 'Le fait ou l\'instruction à mémoriser (ex: "Le serveur tourne sur le port 4000")' }
+            },
+            required: ['fact']
+        }
+    }
+};
+export const GOOGLE_WEB_SEARCH_SCHEMA = {
+    type: 'function',
+    function: {
+        name: 'google_web_search',
+        description: 'Recherche multi-sources (GitHub, NPM, PyPI, Wikipedia, Web). L\'outil détecte intelligemment la source, mais tu peux forcer une source spécifique.',
+        parameters: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'La requête de recherche (ex: "OpenCode CLI")'
+                },
+                source: {
+                    type: 'string',
+                    enum: ['auto', 'github', 'npm', 'pypi', 'wikipedia', 'web'],
+                    description: 'Optionnel. Force la source de recherche. "github" pour les repos/versions, "npm" pour les outils JS, "wikipedia" pour les définitions.',
+                    default: 'auto'
+                }
+            },
+            required: ['query']
+        }
+    }
+};
+export const WEB_FETCH_SCHEMA = {
+    type: 'function',
+    function: {
+        name: 'web_fetch',
+        description: 'Lit le contenu textuel d\'une page web à partir d\'une URL. Utile pour lire une documentation ou un article de blog trouvé via la recherche.',
+        parameters: {
+            type: 'object',
+            properties: {
+                url: { type: 'string', description: 'L\'URL de la page à lire (commençant par http ou https)' }
+            },
+            required: ['url']
+        }
+    }
+};
+// All tools combined
+export const ALL_TOOL_SCHEMAS = [
+    READ_FILE_SCHEMA,
+    READ_MANY_FILES_SCHEMA,
+    CREATE_FILE_SCHEMA,
+    EDIT_FILE_SCHEMA,
+    DELETE_FILE_SCHEMA,
+    SEARCH_FILES_SCHEMA,
+    LIST_FILES_SCHEMA,
+    CREATE_TASKS_SCHEMA,
+    UPDATE_TASKS_SCHEMA,
+    EXECUTE_COMMAND_SCHEMA,
+    GREP_SCHEMA,
+    GLOB_SCHEMA,
+    SAVE_MEMORY_SCHEMA,
+    GOOGLE_WEB_SEARCH_SCHEMA,
+    WEB_FETCH_SCHEMA
+];
+// Safe tools that can be auto-executed without approval
+export const SAFE_TOOLS = [
+    'read_file',
+    'read_many_files',
+    'list_files',
+    'search_files',
+    'create_tasks',
+    'update_tasks',
+    'grep',
+    'glob',
+    'save_memory',
+    'google_web_search',
+    'web_fetch'
+];
+// Tools that require approval, unless auto-approval is enabled
+export const APPROVAL_REQUIRED_TOOLS = [
+    'create_file',
+    'edit_file',
+];
+// Dangerous tools that always require approval
+export const DANGEROUS_TOOLS = [
+    'delete_file',
+    'execute_command'
+];
+//# sourceMappingURL=tool-schemas.js.map

package/dist/tools/tool-schemas.js.map

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

package/dist/tools/tools.d.ts

@@ -0,0 +1,114 @@
+export interface ToolResult {
+    success: boolean;
+    content?: any;
+    data?: any;
+    message?: string;
+    error?: string;
+}
+interface TaskUpdate {
+    id: string;
+    status: 'pending' | 'in_progress' | 'completed';
+    notes?: string;
+}
+interface Task {
+    id: string;
+    description: string;
+    status: 'pending' | 'in_progress' | 'completed';
+    notes?: string;
+    updated_at?: string;
+}
+export declare function getReadFilesTracker(): Set<string>;
+/**
+ * Format key parameters for tool call display
+ */
+export declare function formatToolParams(toolName: string, toolArgs: Record<string, any>, options?: {
+    includePrefix?: boolean;
+    separator?: string;
+}): string;
+/**
+ * Create a standardized tool response format
+ */
+export declare function createToolResponse(success: boolean, data?: any, message?: string, error?: string): ToolResult;
+/**
+ * Read the contents of a file, optionally specifying line range
+ */
+export declare function readFile(filePath: string, startLine?: number, endLine?: number): Promise<ToolResult>;
+/**
+ * Read multiple files at once
+ */
+export declare function readManyFiles(filePaths: string[]): Promise<ToolResult>;
+/**
+ * Create a new file or directory with specified content
+ */
+export declare function createFile(filePath: string, content: string, fileType?: string, overwrite?: boolean): Promise<ToolResult>;
+/**
+ * Edit a file by replacing text strings using multiple strategies (exact, flexible, regex)
+ */
+export declare function editFile(filePath: string, oldString: string, newString: string, expectedReplacements?: number): Promise<ToolResult>;
+/**
+ * Delete a file or directory with safety checks
+ */
+export declare function deleteFile(filePath: string, recursive?: boolean): Promise<ToolResult>;
+/**
+ * List files and directories in a path with tree-style display
+ */
+export declare function listFiles(directory?: string, pattern?: string, recursive?: boolean, showHidden?: boolean): Promise<ToolResult>;
+/**
+ * Search for text patterns in files with advanced filtering and matching options
+ */
+export declare function searchFiles(pattern: string, filePattern?: string, directory?: string, caseSensitive?: boolean, patternType?: 'substring' | 'regex' | 'exact' | 'fuzzy', fileTypes?: string[], excludeDirs?: string[], excludeFiles?: string[], maxResults?: number, contextLines?: number, groupByFile?: boolean): Promise<ToolResult>;
+/**
+ * Execute a shell command or run code
+ */
+export declare function executeCommand(command: string, commandType: string, workingDirectory?: string, timeout?: number): Promise<ToolResult>;
+/**
+ * Create a task list of subtasks to complete the user's request
+ */
+export declare function createTasks(userQuery: string, tasks: Task[]): Promise<ToolResult>;
+/**
+ * Update the status of one or more tasks in the task list
+ */
+export declare function updateTasks(taskUpdates: TaskUpdate[]): Promise<ToolResult>;
+/**
+ * Find files matching a glob pattern
+ */
+export declare function glob(pattern: string): Promise<ToolResult>;
+/**
+ * Search text in files using ripgrep
+ */
+export declare function grep(pattern: string, include?: string, context?: number, caseSensitive?: boolean, directory?: string, fixedStrings?: boolean): Promise<ToolResult>;
+/**
+ * Save a fact to the project's long-term memory (SORY.md)
+ */
+export declare function saveMemory(fact: string): Promise<ToolResult>;
+/**
+ * Search the web using multiple sources with technical prioritization and manual override
+ */
+export declare function googleWebSearch(query: string, source?: 'auto' | 'github' | 'npm' | 'pypi' | 'wikipedia' | 'web'): Promise<ToolResult>;
+/**
+ * Fetch and extract text from a website
+ */
+export declare function webFetch(url: string): Promise<ToolResult>;
+export declare const TOOL_REGISTRY: {
+    read_file: typeof readFile;
+    create_file: typeof createFile;
+    edit_file: typeof editFile;
+    delete_file: typeof deleteFile;
+    list_files: typeof listFiles;
+    search_files: typeof searchFiles;
+    execute_command: typeof executeCommand;
+    create_tasks: typeof createTasks;
+    update_tasks: typeof updateTasks;
+    grep: typeof grep;
+    glob: typeof glob;
+    read_many_files: typeof readManyFiles;
+    save_memory: typeof saveMemory;
+    google_web_search: typeof googleWebSearch;
+    web_fetch: typeof webFetch;
+};
+/**
+ * Execute a tool by name with given arguments
+ */
+export declare function executeTool(toolName: string, toolArgs: Record<string, any>): Promise<ToolResult>;
+export {};
+//# sourceMappingURL=tools.d.ts.map

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

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