@defai.digital/ax-cli 4.0.0 → 4.0.2

package/dist/llm/tools.d.ts

@@ -1,25 +1,10 @@
 import { LLMTool } from "./client.js";
 import { MCPManager, MCPTool } from "../mcp/client.js";
 /**
- * Legacy tool definitions for the LLM agent
- * @deprecated Kept for reference - now using TOOL_DEFINITIONS from definitions/index.ts
- * Named _BASE_LLM_TOOLS (prefixed with _ to indicate unused)
+ * LLM tool definitions derived from rich Tool System v3.0 definitions
+ * These are the primary exports for tool registration with LLM providers
  */
-declare const _BASE_LLM_TOOLS: LLMTool[];
-/**
- * Rich tool definitions converted to OpenAI format
- * These are derived from the TOOL_DEFINITIONS using format generators
- */
-declare const RICH_LLM_TOOLS: LLMTool[];
-/**
- * Exported tool definitions
- * Now using rich definitions from Tool System v3.0
- * @deprecated Use LLM_TOOLS instead of GROK_TOOLS (legacy name kept for backwards compatibility)
- */
-export declare const GROK_TOOLS: LLMTool[];
 export declare const LLM_TOOLS: LLMTool[];
-export { RICH_LLM_TOOLS as BASE_LLM_TOOLS_V3 };
-export { _BASE_LLM_TOOLS as LEGACY_LLM_TOOLS };
 /**
  * Get or create the MCP manager singleton
  * Note: MCPManager constructor is synchronous, so no race condition is possible
@@ -42,21 +27,15 @@ export declare function initializeMCPServers(): Promise<void>;
  * MCP 2025-06-18: Includes output schema in description for LLM awareness
  */
 export declare function convertMCPToolToLLMTool(mcpTool: MCPTool): LLMTool;
-/** @deprecated Use convertMCPToolToLLMTool instead */
-export declare const convertMCPToolToGrokTool: typeof convertMCPToolToLLMTool;
 /**
  * Merge base tools with MCP tools
  */
 export declare function mergeWithMCPTools(baseTools: LLMTool[]): LLMTool[];
-/** @deprecated Use mergeWithMCPTools instead */
-export declare const addMCPToolsToGrokTools: typeof mergeWithMCPTools;
 /**
  * Get all available tools (base + MCP)
  * Handles MCP initialization with timeout
  */
 export declare function getAllTools(): Promise<LLMTool[]>;
-/** @deprecated Use getAllTools instead */
-export declare const getAllGrokTools: typeof getAllTools;
 /**
  * Get MCP connection status for UI display
  * Returns { connected, failed, connecting, total } counts

package/dist/llm/tools.js

@@ -4,12 +4,8 @@ import { extractErrorMessage } from "../utils/error-handler.js";
 import { TIMEOUT_CONFIG } from "../constants.js";
 import { TOOL_DEFINITIONS } from "../tools/definitions/index.js";
 import { toOpenAIFormat } from "../tools/format-generators.js";
-// Tool configuration constants
-const TOOL_DEFAULTS = {
-    BASH_TIMEOUT_MS: TIMEOUT_CONFIG.BASH_DEFAULT,
-    MCP_INIT_TIMEOUT_MS: TIMEOUT_CONFIG.MCP_INIT,
-    SEARCH_MAX_RESULTS: 50,
-};
+// MCP initialization timeout
+const MCP_INIT_TIMEOUT_MS = TIMEOUT_CONFIG.MCP_INIT;
 // MCP log messages to suppress (verbose connection logs)
 const MCP_SUPPRESSED_LOG_PATTERNS = [
     'Using existing client port',
@@ -22,584 +18,10 @@ const MCP_SUPPRESSED_LOG_PATTERNS = [
     'Remote→Local',
 ];
 /**
- * Legacy tool definitions for the LLM agent
- * @deprecated Kept for reference - now using TOOL_DEFINITIONS from definitions/index.ts
- * Named _BASE_LLM_TOOLS (prefixed with _ to indicate unused)
+ * LLM tool definitions derived from rich Tool System v3.0 definitions
+ * These are the primary exports for tool registration with LLM providers
  */
-const _BASE_LLM_TOOLS = [
-    {
-        type: "function",
-        function: {
-            name: "view_file",
-            description: "View contents of a file or list directory contents",
-            parameters: {
-                type: "object",
-                properties: {
-                    path: {
-                        type: "string",
-                        description: "Path to file or directory to view",
-                    },
-                    start_line: {
-                        type: "number",
-                        description: "Starting line number for partial file view (optional)",
-                    },
-                    end_line: {
-                        type: "number",
-                        description: "Ending line number for partial file view (optional)",
-                    },
-                },
-                required: ["path"],
-            },
-        },
-    },
-    {
-        type: "function",
-        function: {
-            name: "create_file",
-            description: "Create a new file with specified content",
-            parameters: {
-                type: "object",
-                properties: {
-                    path: {
-                        type: "string",
-                        description: "Path where the file should be created",
-                    },
-                    content: {
-                        type: "string",
-                        description: "Content to write to the file",
-                    },
-                },
-                required: ["path", "content"],
-            },
-        },
-    },
-    {
-        type: "function",
-        function: {
-            name: "str_replace_editor",
-            description: "Edit existing files with precise string replacement. Can replace single or multi-line text blocks. For multiple changes to the same file, include more context in old_str to make a single comprehensive edit rather than multiple separate calls.",
-            parameters: {
-                type: "object",
-                properties: {
-                    path: {
-                        type: "string",
-                        description: "Path to the file to edit",
-                    },
-                    old_str: {
-                        type: "string",
-                        description: "Text to replace - can be single line or multi-line block. Include sufficient context (surrounding lines) to uniquely identify the location and enable consolidated edits.",
-                    },
-                    new_str: {
-                        type: "string",
-                        description: "Replacement text - can be single line or entire function/block",
-                    },
-                    replace_all: {
-                        type: "boolean",
-                        description: "Replace all occurrences (default: false, only replaces first occurrence). Useful for variable renaming across file.",
-                    },
-                },
-                required: ["path", "old_str", "new_str"],
-            },
-        },
-    },
-    {
-        type: "function",
-        function: {
-            name: "multi_edit",
-            description: "Make multiple edits to a single file in one atomic operation. Use this instead of multiple str_replace_editor calls when you need to make several changes to the same file. Edits are applied sequentially and the operation fails entirely if any edit is invalid (all-or-nothing).",
-            parameters: {
-                type: "object",
-                properties: {
-                    path: {
-                        type: "string",
-                        description: "Path to the file to edit",
-                    },
-                    edits: {
-                        type: "array",
-                        description: "Array of edits to apply sequentially. Each edit operates on the result of the previous edit.",
-                        items: {
-                            type: "object",
-                            properties: {
-                                old_str: {
-                                    type: "string",
-                                    description: "Text to replace",
-                                },
-                                new_str: {
-                                    type: "string",
-                                    description: "Replacement text",
-                                },
-                            },
-                            required: ["old_str", "new_str"],
-                        },
-                    },
-                },
-                required: ["path", "edits"],
-            },
-        },
-    },
-    {
-        type: "function",
-        function: {
-            name: "bash",
-            description: "Execute a bash command. Append ' &' to run in background.",
-            parameters: {
-                type: "object",
-                properties: {
-                    command: {
-                        type: "string",
-                        description: "The bash command to execute. Append ' &' to run in background (e.g., 'npm run dev &')",
-                    },
-                    background: {
-                        type: "boolean",
-                        description: "Run command in background (alternative to appending ' &'). Useful for long-running processes like dev servers.",
-                    },
-                    timeout: {
-                        type: "number",
-                        description: `Timeout in milliseconds (default: ${TOOL_DEFAULTS.BASH_TIMEOUT_MS}). Ignored for background commands.`,
-                    },
-                },
-                required: ["command"],
-            },
-        },
-    },
-    {
-        type: "function",
-        function: {
-            name: "bash_output",
-            description: "Get output from a background task. Use after running a command with ' &' or background:true",
-            parameters: {
-                type: "object",
-                properties: {
-                    task_id: {
-                        type: "string",
-                        description: "The background task ID (returned when starting a background command)",
-                    },
-                    wait: {
-                        type: "boolean",
-                        description: "Wait for task to complete before returning output (default: false)",
-                    },
-                    timeout: {
-                        type: "number",
-                        description: `Maximum time to wait in milliseconds if wait is true (default: ${TOOL_DEFAULTS.BASH_TIMEOUT_MS})`,
-                    },
-                },
-                required: ["task_id"],
-            },
-        },
-    },
-    {
-        type: "function",
-        function: {
-            name: "search",
-            description: "Unified search tool for finding text content or files (similar to Cursor's search)",
-            parameters: {
-                type: "object",
-                properties: {
-                    query: {
-                        type: "string",
-                        description: "Text to search for or file name/path pattern",
-                    },
-                    search_type: {
-                        type: "string",
-                        enum: ["text", "files", "both"],
-                        description: "Type of search: 'text' for content search, 'files' for file names, 'both' for both (default: 'both')",
-                    },
-                    include_pattern: {
-                        type: "string",
-                        description: "Glob pattern for files to include (e.g. '*.ts', '*.js')",
-                    },
-                    exclude_pattern: {
-                        type: "string",
-                        description: "Glob pattern for files to exclude (e.g. '*.log', 'node_modules')",
-                    },
-                    case_sensitive: {
-                        type: "boolean",
-                        description: "Whether search should be case sensitive (default: false)",
-                    },
-                    whole_word: {
-                        type: "boolean",
-                        description: "Whether to match whole words only (default: false)",
-                    },
-                    regex: {
-                        type: "boolean",
-                        description: "Whether query is a regex pattern (default: false)",
-                    },
-                    max_results: {
-                        type: "number",
-                        description: `Maximum number of results to return (default: ${TOOL_DEFAULTS.SEARCH_MAX_RESULTS})`,
-                    },
-                    file_types: {
-                        type: "array",
-                        items: { type: "string" },
-                        description: "File types to search (e.g. ['js', 'ts', 'py'])",
-                    },
-                    include_hidden: {
-                        type: "boolean",
-                        description: "Whether to include hidden files (default: false)",
-                    },
-                },
-                required: ["query"],
-            },
-        },
-    },
-    {
-        type: "function",
-        function: {
-            name: "create_todo_list",
-            description: "Create a new todo list for planning and tracking tasks",
-            parameters: {
-                type: "object",
-                properties: {
-                    todos: {
-                        type: "array",
-                        description: "Array of todo items",
-                        items: {
-                            type: "object",
-                            properties: {
-                                id: {
-                                    type: "string",
-                                    description: "Unique identifier for the todo item",
-                                },
-                                content: {
-                                    type: "string",
-                                    description: "Description of the todo item",
-                                },
-                                status: {
-                                    type: "string",
-                                    enum: ["pending", "in_progress", "completed"],
-                                    description: "Current status of the todo item",
-                                },
-                                priority: {
-                                    type: "string",
-                                    enum: ["high", "medium", "low"],
-                                    description: "Priority level of the todo item",
-                                },
-                            },
-                            required: ["id", "content", "status", "priority"],
-                        },
-                    },
-                },
-                required: ["todos"],
-            },
-        },
-    },
-    {
-        type: "function",
-        function: {
-            name: "update_todo_list",
-            description: "Update existing todos in the todo list",
-            parameters: {
-                type: "object",
-                properties: {
-                    updates: {
-                        type: "array",
-                        description: "Array of todo updates",
-                        items: {
-                            type: "object",
-                            properties: {
-                                id: {
-                                    type: "string",
-                                    description: "ID of the todo item to update",
-                                },
-                                status: {
-                                    type: "string",
-                                    enum: ["pending", "in_progress", "completed"],
-                                    description: "New status for the todo item",
-                                },
-                                content: {
-                                    type: "string",
-                                    description: "New content for the todo item",
-                                },
-                                priority: {
-                                    type: "string",
-                                    enum: ["high", "medium", "low"],
-                                    description: "New priority for the todo item",
-                                },
-                            },
-                            required: ["id"],
-                        },
-                    },
-                },
-                required: ["updates"],
-            },
-        },
-    },
-    // NOTE: analyze_architecture and validate_best_practices were removed.
-    // The backend analyzers were deleted. Use ax_agent with avery/stan instead.
-    {
-        type: "function",
-        function: {
-            name: "ask_user",
-            description: "Ask the user questions to gather preferences, clarify requirements, or get decisions on implementation choices. Use this when you need user input before proceeding. Supports multiple choice questions with 2-4 options per question.",
-            parameters: {
-                type: "object",
-                properties: {
-                    questions: {
-                        type: "array",
-                        description: "Questions to ask the user (1-4 questions)",
-                        items: {
-                            type: "object",
-                            properties: {
-                                question: {
-                                    type: "string",
-                                    description: "The complete question to ask the user. Should be clear and specific.",
-                                },
-                                header: {
-                                    type: "string",
-                                    description: "Short label for the question (max 12 chars). E.g., 'Auth method', 'Library'.",
-                                },
-                                options: {
-                                    type: "array",
-                                    description: "Available choices (2-4 options). 'Other' is added automatically.",
-                                    items: {
-                                        type: "object",
-                                        properties: {
-                                            label: {
-                                                type: "string",
-                                                description: "Display text for this option (1-5 words).",
-                                            },
-                                            description: {
-                                                type: "string",
-                                                description: "Explanation of what this option means.",
-                                            },
-                                        },
-                                        required: ["label", "description"],
-                                    },
-                                },
-                                multiSelect: {
-                                    type: "boolean",
-                                    description: "Allow multiple selections (default: false).",
-                                },
-                            },
-                            required: ["question", "options"],
-                        },
-                    },
-                },
-                required: ["questions"],
-            },
-        },
-    },
-    // ==========================================================================
-    // AutomatosX Agent Invocation
-    // ==========================================================================
-    {
-        type: "function",
-        function: {
-            name: "ax_agent",
-            description: "Invoke an AutomatosX AI agent for collaborative analysis, code review, architecture advice, or strategic guidance. USE THIS when the user wants to WORK WITH a specific agent persona (Tony/CTO, Bob/Backend, Avery/Architect, Stan/Standards, Steve/Security, etc.). Returns the agent's AI-generated response. IMPORTANT: When the user asks to work with MULTIPLE agents, invoke ALL agents IN PARALLEL by making multiple ax_agent calls in the same response - they will execute concurrently for faster results.",
-            parameters: {
-                type: "object",
-                properties: {
-                    agent: {
-                        type: "string",
-                        enum: ["tony", "bob", "avery", "stan", "steve", "felix", "frank", "queenie", "wendy", "oliver", "paris", "maya", "dana", "daisy", "debbee", "eric", "rodman", "candy", "quinn", "astrid"],
-                        description: "Agent to invoke: tony (CTO/strategy), bob (backend), avery (architect), stan (code standards), steve (security), felix (fullstack), frank (frontend), queenie (QA), wendy (writer), oliver (devops), paris (product), maya (mobile), dana (data science), daisy (data eng), debbee (design), eric (exec), rodman (research), candy (marketing), quinn (quantum), astrid (aerospace)",
-                    },
-                    task: {
-                        type: "string",
-                        description: "Task or question for the agent. Be specific about what you want analyzed or reviewed.",
-                    },
-                    format: {
-                        type: "string",
-                        enum: ["text", "markdown"],
-                        description: "Output format (default: markdown)",
-                    },
-                    save: {
-                        type: "string",
-                        description: "Optional file path to save output (e.g., automatosx/tmp/review.md)",
-                    },
-                },
-                required: ["agent", "task"],
-            },
-        },
-    },
-    // ==========================================================================
-    // Design Tools (Figma Integration)
-    // ==========================================================================
-    {
-        type: "function",
-        function: {
-            name: "figma_map",
-            description: "Map a Figma file structure to see its pages, frames, and components. Requires FIGMA_ACCESS_TOKEN environment variable.",
-            parameters: {
-                type: "object",
-                properties: {
-                    file_key: {
-                        type: "string",
-                        description: "Figma file key (from the URL: figma.com/file/FILE_KEY/...)",
-                    },
-                    depth: {
-                        type: "number",
-                        description: "Maximum depth to traverse (optional)",
-                    },
-                    format: {
-                        type: "string",
-                        enum: ["tree", "json", "flat"],
-                        description: "Output format (default: tree)",
-                    },
-                    show_ids: {
-                        type: "boolean",
-                        description: "Include node IDs in output",
-                    },
-                    show_types: {
-                        type: "boolean",
-                        description: "Include node types in output",
-                    },
-                    frames_only: {
-                        type: "boolean",
-                        description: "Show only frames and components",
-                    },
-                },
-                required: ["file_key"],
-            },
-        },
-    },
-    {
-        type: "function",
-        function: {
-            name: "figma_tokens",
-            description: "Extract design tokens (colors, spacing, radii) from a Figma file's variables. Requires FIGMA_ACCESS_TOKEN environment variable.",
-            parameters: {
-                type: "object",
-                properties: {
-                    file_key: {
-                        type: "string",
-                        description: "Figma file key containing design tokens/variables",
-                    },
-                    format: {
-                        type: "string",
-                        enum: ["json", "tailwind", "css", "scss"],
-                        description: "Output format (default: json)",
-                    },
-                    color_format: {
-                        type: "string",
-                        enum: ["hex", "rgb", "hsl"],
-                        description: "Color output format (default: hex)",
-                    },
-                    dimension_unit: {
-                        type: "string",
-                        enum: ["px", "rem"],
-                        description: "Dimension unit (default: px)",
-                    },
-                    rem_base: {
-                        type: "number",
-                        description: "Base value for rem conversion (default: 16)",
-                    },
-                },
-                required: ["file_key"],
-            },
-        },
-    },
-    {
-        type: "function",
-        function: {
-            name: "figma_audit",
-            description: "Run a design audit on a Figma file to check for naming conventions, missing auto-layout, and other best practices. Requires FIGMA_ACCESS_TOKEN environment variable.",
-            parameters: {
-                type: "object",
-                properties: {
-                    file_key: {
-                        type: "string",
-                        description: "Figma file key to audit",
-                    },
-                    depth: {
-                        type: "number",
-                        description: "Maximum depth to traverse (optional)",
-                    },
-                    rules: {
-                        type: "array",
-                        items: { type: "string" },
-                        description: "Specific rules to run (e.g., ['layer-naming', 'missing-autolayout']). Runs all by default.",
-                    },
-                    exclude_rules: {
-                        type: "array",
-                        items: { type: "string" },
-                        description: "Rules to exclude from the audit",
-                    },
-                },
-                required: ["file_key"],
-            },
-        },
-    },
-    {
-        type: "function",
-        function: {
-            name: "figma_search",
-            description: "Search for nodes in a Figma file by name, type, or text content. Requires FIGMA_ACCESS_TOKEN environment variable.",
-            parameters: {
-                type: "object",
-                properties: {
-                    file_key: {
-                        type: "string",
-                        description: "Figma file key to search in",
-                    },
-                    name: {
-                        type: "string",
-                        description: "Search by node name (partial match)",
-                    },
-                    type: {
-                        type: "string",
-                        description: "Filter by node type (e.g., FRAME, TEXT, COMPONENT)",
-                    },
-                    text: {
-                        type: "string",
-                        description: "Search text nodes by content",
-                    },
-                    limit: {
-                        type: "number",
-                        description: "Maximum results to return (default: 10)",
-                    },
-                },
-                required: ["file_key"],
-            },
-        },
-    },
-    {
-        type: "function",
-        function: {
-            name: "figma_alias_list",
-            description: "List all saved Figma design aliases (shortcuts to specific files/nodes)",
-            parameters: {
-                type: "object",
-                properties: {},
-                required: [],
-            },
-        },
-    },
-    {
-        type: "function",
-        function: {
-            name: "figma_alias_resolve",
-            description: "Resolve a design alias to its Figma file key and node ID",
-            parameters: {
-                type: "object",
-                properties: {
-                    alias: {
-                        type: "string",
-                        description: "Alias name to resolve",
-                    },
-                },
-                required: ["alias"],
-            },
-        },
-    },
-];
-/**
- * Rich tool definitions converted to OpenAI format
- * These are derived from the TOOL_DEFINITIONS using format generators
- */
-const RICH_LLM_TOOLS = TOOL_DEFINITIONS.map(toOpenAIFormat);
-/**
- * Exported tool definitions
- * Now using rich definitions from Tool System v3.0
- * @deprecated Use LLM_TOOLS instead of GROK_TOOLS (legacy name kept for backwards compatibility)
- */
-export const GROK_TOOLS = [...RICH_LLM_TOOLS];
-export const LLM_TOOLS = GROK_TOOLS; // Preferred name
-// Keep legacy BASE_LLM_TOOLS reference for any code that imports it directly
-export { RICH_LLM_TOOLS as BASE_LLM_TOOLS_V3 };
-// Export legacy definitions for backward compatibility (if any code still uses them)
-export { _BASE_LLM_TOOLS as LEGACY_LLM_TOOLS };
+export const LLM_TOOLS = TOOL_DEFINITIONS.map(toOpenAIFormat);
 // Global MCP manager instance (singleton pattern)
 let mcpManager = null;
 /**
@@ -723,8 +145,6 @@ export function convertMCPToolToLLMTool(mcpTool) {
         }
     };
 }
-/** @deprecated Use convertMCPToolToLLMTool instead */
-export const convertMCPToolToGrokTool = convertMCPToolToLLMTool;
 /**
  * Merge base tools with MCP tools
  */
@@ -735,8 +155,6 @@ export function mergeWithMCPTools(baseTools) {
     const mcpTools = mcpManager.getTools().map(convertMCPToolToLLMTool);
     return [...baseTools, ...mcpTools];
 }
-/** @deprecated Use mergeWithMCPTools instead */
-export const addMCPToolsToGrokTools = mergeWithMCPTools;
 /**
  * Get all available tools (base + MCP)
  * Handles MCP initialization with timeout
@@ -746,7 +164,7 @@ export async function getAllTools() {
     try {
         let timeoutId;
         const timeoutPromise = new Promise((_, reject) => {
-            timeoutId = setTimeout(() => reject(new Error('MCP init timeout')), TOOL_DEFAULTS.MCP_INIT_TIMEOUT_MS);
+            timeoutId = setTimeout(() => reject(new Error('MCP init timeout')), MCP_INIT_TIMEOUT_MS);
         });
         // Prevent unhandled rejection if timeout loses race
         timeoutPromise.catch(() => { });
@@ -763,8 +181,6 @@ export async function getAllTools() {
     }
     return mergeWithMCPTools(LLM_TOOLS);
 }
-/** @deprecated Use getAllTools instead */
-export const getAllGrokTools = getAllTools;
 /**
  * Get MCP connection status for UI display
  * Returns { connected, failed, connecting, total } counts