@defai.digital/ax-cli 3.5.4 → 3.6.1

package/ax.config.json

@@ -0,0 +1,333 @@
+{
+  "providers": {
+    "claude-code": {
+      "enabled": true,
+      "priority": 3,
+      "timeout": 2700000,
+      "command": "claude",
+      "healthCheck": {
+        "enabled": true,
+        "interval": 300000,
+        "timeout": 5000
+      },
+      "circuitBreaker": {
+        "enabled": true,
+        "failureThreshold": 3,
+        "recoveryTimeout": 60000
+      },
+      "processManagement": {
+        "gracefulShutdownTimeout": 5000,
+        "forceKillDelay": 1000
+      },
+      "versionDetection": {
+        "timeout": 5000,
+        "forceKillDelay": 1000,
+        "cacheEnabled": true
+      },
+      "limitTracking": {
+        "enabled": true,
+        "window": "weekly",
+        "resetHourUtc": 0
+      }
+    },
+    "gemini-cli": {
+      "enabled": true,
+      "priority": 2,
+      "timeout": 2700000,
+      "command": "gemini",
+      "healthCheck": {
+        "enabled": true,
+        "interval": 300000,
+        "timeout": 5000
+      },
+      "circuitBreaker": {
+        "enabled": true,
+        "failureThreshold": 3,
+        "recoveryTimeout": 60000
+      },
+      "processManagement": {
+        "gracefulShutdownTimeout": 5000,
+        "forceKillDelay": 1000
+      },
+      "versionDetection": {
+        "timeout": 5000,
+        "forceKillDelay": 1000,
+        "cacheEnabled": true
+      },
+      "limitTracking": {
+        "enabled": true,
+        "window": "daily",
+        "resetHourUtc": 0
+      }
+    },
+    "openai": {
+      "enabled": true,
+      "priority": 1,
+      "timeout": 2700000,
+      "command": "codex",
+      "healthCheck": {
+        "enabled": true,
+        "interval": 300000,
+        "timeout": 5000
+      },
+      "circuitBreaker": {
+        "enabled": true,
+        "failureThreshold": 3,
+        "recoveryTimeout": 60000
+      },
+      "processManagement": {
+        "gracefulShutdownTimeout": 5000,
+        "forceKillDelay": 1000
+      },
+      "versionDetection": {
+        "timeout": 5000,
+        "forceKillDelay": 1000,
+        "cacheEnabled": true
+      },
+      "limitTracking": {
+        "enabled": true,
+        "window": "daily",
+        "resetHourUtc": 0
+      }
+    },
+    "grok": {
+      "enabled": true,
+      "priority": 4,
+      "timeout": 2700000,
+      "command": "grok",
+      "healthCheck": {
+        "enabled": true,
+        "interval": 300000,
+        "timeout": 5000
+      },
+      "circuitBreaker": {
+        "enabled": true,
+        "failureThreshold": 3,
+        "recoveryTimeout": 60000
+      },
+      "processManagement": {
+        "gracefulShutdownTimeout": 5000,
+        "forceKillDelay": 1000
+      },
+      "versionDetection": {
+        "timeout": 5000,
+        "forceKillDelay": 1000,
+        "cacheEnabled": true
+      },
+      "limitTracking": {
+        "enabled": true,
+        "window": "daily",
+        "resetHourUtc": 0
+      }
+    }
+  },
+  "execution": {
+    "defaultTimeout": 2700000,
+    "concurrency": {
+      "maxConcurrentAgents": 4,
+      "autoDetect": false,
+      "cpuMultiplier": 1,
+      "minConcurrency": 2,
+      "maxConcurrency": 16
+    },
+    "retry": {
+      "maxAttempts": 3,
+      "initialDelay": 1000,
+      "maxDelay": 10000,
+      "backoffFactor": 2,
+      "retryableErrors": [
+        "ECONNREFUSED",
+        "ETIMEDOUT",
+        "ENOTFOUND",
+        "rate_limit",
+        "overloaded",
+        "timeout"
+      ]
+    },
+    "provider": {
+      "maxWaitMs": 60000,
+      "fallbackDelay": 5000
+    },
+    "stages": {
+      "enabled": true,
+      "defaultTimeout": 1800000,
+      "checkpointPath": ".automatosx/checkpoints",
+      "autoSaveCheckpoint": true,
+      "cleanupAfterDays": 7,
+      "retry": {
+        "defaultMaxRetries": 1,
+        "defaultRetryDelay": 2000
+      },
+      "prompts": {
+        "timeout": 600000,
+        "autoConfirm": false,
+        "locale": "en"
+      },
+      "progress": {
+        "updateInterval": 2000,
+        "syntheticProgress": true
+      }
+    }
+  },
+  "orchestration": {
+    "session": {
+      "maxSessions": 100,
+      "maxMetadataSize": 10240,
+      "saveDebounce": 1000,
+      "cleanupAfterDays": 7,
+      "maxUuidAttempts": 100,
+      "persistPath": ".automatosx/sessions"
+    },
+    "delegation": {
+      "maxDepth": 2,
+      "timeout": 2700000,
+      "enableCycleDetection": true
+    }
+  },
+  "memory": {
+    "maxEntries": 10000,
+    "persistPath": ".automatosx/memory",
+    "autoCleanup": true,
+    "cleanupDays": 30,
+    "busyTimeout": 5000,
+    "search": {
+      "defaultLimit": 10,
+      "maxLimit": 100,
+      "timeout": 5000
+    }
+  },
+  "abilities": {
+    "basePath": ".automatosx/abilities",
+    "fallbackPath": "examples/abilities",
+    "cache": {
+      "enabled": true,
+      "maxEntries": 50,
+      "ttl": 600000,
+      "maxSize": 5242880,
+      "cleanupInterval": 120000
+    },
+    "limits": {
+      "maxFileSize": 524288
+    }
+  },
+  "workspace": {
+    "prdPath": "automatosx/PRD",
+    "tmpPath": "automatosx/tmp",
+    "autoCleanupTmp": true,
+    "tmpCleanupDays": 7
+  },
+  "logging": {
+    "level": "info",
+    "path": ".automatosx/logs",
+    "console": true,
+    "retention": {
+      "maxSizeBytes": 104857600,
+      "maxAgeDays": 30,
+      "compress": true
+    }
+  },
+  "performance": {
+    "profileCache": {
+      "enabled": true,
+      "maxEntries": 20,
+      "ttl": 600000,
+      "cleanupInterval": 120000
+    },
+    "teamCache": {
+      "enabled": true,
+      "maxEntries": 10,
+      "ttl": 600000,
+      "cleanupInterval": 120000
+    },
+    "providerCache": {
+      "enabled": true,
+      "maxEntries": 100,
+      "ttl": 600000,
+      "cleanupInterval": 120000
+    },
+    "adaptiveCache": {
+      "maxEntries": 1000,
+      "baseTTL": 300000,
+      "minTTL": 60000,
+      "maxTTL": 3600000,
+      "adaptiveMultiplier": 2,
+      "lowFreqDivisor": 2,
+      "frequencyThreshold": 5,
+      "cleanupInterval": 60000
+    },
+    "responseCache": {
+      "enabled": false,
+      "ttl": 86400,
+      "maxSize": 1000,
+      "maxMemorySize": 100,
+      "dbPath": ".automatosx/cache/responses.db"
+    },
+    "rateLimit": {
+      "enabled": false,
+      "requestsPerMinute": 60,
+      "burstSize": 10
+    }
+  },
+  "advanced": {
+    "embedding": {
+      "timeout": 30000,
+      "retryDelay": 1000,
+      "dimensions": 1536,
+      "maxRetries": 3
+    },
+    "security": {
+      "enablePathValidation": true,
+      "allowedExtensions": [
+        ".ts",
+        ".js",
+        ".tsx",
+        ".jsx",
+        ".py",
+        ".go",
+        ".rs",
+        ".java",
+        ".yaml",
+        ".yml",
+        ".json",
+        ".toml",
+        ".md",
+        ".txt",
+        ".csv"
+      ]
+    },
+    "development": {
+      "mockProviders": false,
+      "profileMode": false
+    }
+  },
+  "integration": {
+    "vscode": {
+      "enabled": false,
+      "apiPort": 3000,
+      "autoStart": true,
+      "outputPanel": true,
+      "notifications": true
+    }
+  },
+  "cli": {
+    "run": {
+      "defaultMemory": true,
+      "defaultSaveMemory": true,
+      "defaultFormat": "text",
+      "defaultVerbose": false
+    },
+    "session": {
+      "defaultShowAgents": true
+    },
+    "memory": {
+      "defaultLimit": 10
+    }
+  },
+  "router": {
+    "healthCheckInterval": 60000,
+    "providerCooldownMs": 30000,
+    "enableFreeTierPrioritization": true,
+    "enableWorkloadAwareRouting": true
+  },
+  "version": "9.0.0"
+}

package/config-defaults/messages.yaml

@@ -0,0 +1,75 @@
+# Error Messages and User-Facing Text
+# Externalized strings for easy localization and maintenance
+
+errors:
+  api_key_required: "API key required. Set YOUR_API_KEY environment variable, use --api-key flag, or save to ~/.ax-cli/config.json"
+  transport_config_required: "Transport configuration is required"
+  tool_not_found: "Tool {toolName} not found"
+  server_not_connected: "Server {serverName} not connected"
+  file_not_found: "File not found: {filePath}"
+  directory_not_found: "Directory not found: {dirPath}"
+  invalid_model: "Invalid model: {model}"
+  context_limit_exceeded: "Context limit exceeded"
+
+warnings:
+  context_pruning: "Context pruning active to maintain performance"
+  near_context_limit: "Near context limit! Consider starting a new conversation soon"
+
+success:
+  file_created: "File created successfully"
+  file_updated: "File updated successfully"
+  command_executed: "Command executed successfully"
+  server_connected: "Server connected successfully"
+
+info:
+  processing: "Processing..."
+  loading_tools: "Loading tools..."
+  initializing_mcp: "Initializing MCP servers..."
+  context_stats: "Context: {current}/{total} tokens ({percentage}%)"
+
+# UI Component Messages
+ui:
+  api_key_input:
+    title: "🔑 Grok API Key Required"
+    prompt: "Please enter your Grok API key to continue:"
+    error_empty: "API key cannot be empty"
+    error_invalid: "Invalid API key format"
+    success_saved: "✅ API key saved to {path}"
+    warning_not_saved: "⚠️ Could not save API key to settings file"
+    session_only: "API key set for current session only"
+    help_submit: "• Press Enter to submit"
+    help_exit: "• Press Ctrl+C to exit"
+    save_location: "Note: API key will be saved to {path}"
+    validating: "🔄 Validating API key..."
+
+# MCP Command Messages
+mcp_commands:
+  server_added: "✓ Added MCP server: {name}"
+  server_predefined: "✓ Added predefined MCP server: {name}"
+  server_connected: "✓ Connected to MCP server: {name}"
+  server_removed: "✓ Removed MCP server: {name}"
+  tools_available: "  Available tools: {count}"
+  error_command_required: "Error: --command is required for stdio transport"
+  error_url_required: "Error: --url is required for {transport} transport"
+  error_invalid_transport: "Error: Transport type must be stdio, http, sse, or streamable_http"
+  error_invalid_json: "Error: Invalid JSON configuration"
+  error_adding_server: "Error adding MCP server: {error}"
+  error_removing_server: "Error removing MCP server: {error}"
+  no_servers: "No MCP servers configured"
+  list_header: "Configured MCP servers:"
+  status_connected: "✓ Connected"
+  status_disconnected: "✗ Disconnected"
+  transport_label: "  Transport: {type}"
+  command_label: "  Command: {command}"
+  url_label: "  URL: {url}"
+  tools_count: "  Tools: {count}"
+  warning_invalid_env: "⚠️  Invalid environment variable format (expected KEY=VALUE): {envVar}"
+  warning_invalid_header: "⚠️  Invalid header format (expected KEY=VALUE): {header}"
+
+# Migration Messages
+migration:
+  user_settings_success: "✅ Migrated user settings: {oldPath} → {newPath}"
+  user_settings_failed: "❌ Failed to migrate user settings: {error}"
+  project_settings_success: "✅ Migrated project settings: {oldPath} → {newPath}"
+  project_settings_failed: "❌ Failed to migrate project settings: {error}"
+  no_migration_needed: "ℹ️  No migration needed - already using .ax-cli paths or no old settings found"

package/config-defaults/models.yaml

@@ -0,0 +1,66 @@
+# AI Model Configuration
+# Defines available models and their capabilities
+
+default_model: glm-4.6
+
+models:
+  glm-4.6:
+    name: glm-4.6
+    context_window: 200000  # 200K tokens
+    max_output_tokens: 128000  # 128K max output
+    default_max_tokens: 8192  # Conservative default
+    supports_thinking: true
+    default_temperature: 0.7
+    temperature_range:
+      min: 0.6
+      max: 1.0
+    token_efficiency: 1.3  # 30% more efficient
+
+  grok-code-fast-1:
+    name: grok-code-fast-1
+    context_window: 128000  # 128K tokens
+    max_output_tokens: 4096
+    default_max_tokens: 1536
+    supports_thinking: false
+    default_temperature: 0.7
+    temperature_range:
+      min: 0.0
+      max: 2.0
+    token_efficiency: 1.0
+
+  glm-4-air:
+    name: glm-4-air
+    context_window: 128000
+    max_output_tokens: 8192
+    default_max_tokens: 4096
+    supports_thinking: false
+    default_temperature: 0.7
+    temperature_range:
+      min: 0.6
+      max: 1.0
+    token_efficiency: 1.15
+
+  glm-4-airx:
+    name: glm-4-airx
+    context_window: 8192
+    max_output_tokens: 8192
+    default_max_tokens: 2048
+    supports_thinking: false
+    default_temperature: 0.7
+    temperature_range:
+      min: 0.6
+      max: 1.0
+    token_efficiency: 1.1
+
+  glm-4.5v:
+    name: glm-4.5v
+    context_window: 64000  # 64K multimodal context
+    max_output_tokens: 16000  # 16K max output
+    default_max_tokens: 8192
+    supports_thinking: true  # Supports deep reasoning mode
+    supports_vision: true  # Vision/image capabilities
+    default_temperature: 0.7
+    temperature_range:
+      min: 0.6
+      max: 1.0
+    token_efficiency: 1.2

package/config-defaults/prompts.yaml

@@ -0,0 +1,156 @@
+# System Prompts Configuration
+# AI assistant instructions and guidelines for AX CLI
+
+system_prompt:
+  identity: "You are AX CLI Assistant, an enterprise-grade AI coding agent specialized in software development, file operations, and intelligent automation. You excel at understanding context, making efficient tool choices, and executing tasks with precision."
+
+  core_principles:
+    title: "CORE OPERATING PRINCIPLES"
+    guidelines:
+      - "Speed & Efficiency: Minimize tool calls, maximize output per interaction"
+      - "Context Awareness: Understand project structure before acting"
+      - "Precision: Make exact, targeted changes - never broad strokes"
+      - "Self-Correction: Validate your work and fix issues immediately"
+      - "Minimal Verbosity: Show results, not commentary"
+      - "Smart Tool Usage: Answer simple questions directly. Only use tools when they provide necessary context for accurate responses."
+
+  tools_header: "Available Tools:"
+
+  tools:
+    - name: view_file
+      description: "Read file contents or list directories. Use for understanding before editing."
+    - name: create_file
+      description: "Create NEW files only. Never use on existing files."
+    - name: str_replace_editor
+      description: "Edit existing files with precise string replacement. Primary editing tool."
+    - name: bash
+      description: "Execute shell commands for git, npm, testing, searching, and system operations"
+    - name: search
+      description: "Fast text/file search with regex support. Use before exploring unknown codebases."
+    - name: create_todo_list
+      description: "Plan multi-step tasks with visual tracking"
+    - name: update_todo_list
+      description: "Update task progress in real-time"
+
+  sections:
+    glm_optimization:
+      title: "GLM 4.6 OPTIMIZATION"
+      content: |
+        You are powered by GLM 4.6 with:
+        • 200K token context window - leverage full codebase context
+        • Advanced reasoning mode - use for complex architectural decisions
+        • 128K max output tokens - can generate substantial code
+        • 30% better token efficiency - think before acting to minimize API calls
+
+        For complex tasks:
+        1. Use reasoning mode to plan approach
+        2. Batch related operations together
+        3. Prioritize search over repeated view_file calls
+        4. Use todo lists for multi-step workflows
+
+    intelligent_workflow:
+      title: "INTELLIGENT WORKFLOW PATTERNS"
+      guidelines:
+        - "Exploration: search → view_file → understand → act"
+        - "Editing: view_file → str_replace_editor → validate"
+        - "Creation: plan → create_file → test"
+        - "Debugging: search for errors → analyze → fix → verify"
+        - "Refactoring: understand scope → create_todo_list → execute incrementally"
+
+    tool_selection_rules:
+      title: "CRITICAL TOOL USAGE RULES"
+      rules:
+        - "NEVER create_file on existing files - instant data loss"
+        - "ALWAYS view_file before str_replace_editor to ensure context"
+        - "Use search when you don't know exact file locations"
+        - "Use bash for git operations, package management, testing"
+        - "Create todo lists for tasks with 3+ distinct steps"
+
+    search_and_discovery:
+      title: "EFFICIENT CODEBASE EXPLORATION"
+      content: |
+        Best practices for unknown codebases:
+
+        1. Start with search:
+           - Text search: "class Authentication", "export.*function"
+           - File search: "*.config.ts", "test/**/*.test.ts"
+
+        2. Use bash for structure:
+           - `find . -name "*.ts" -type f | head -20`
+           - `ls -la src/`
+           - `grep -r "import.*react" --include="*.tsx"`
+
+        3. Read strategically:
+           - Entry points first (index.ts, main.ts)
+           - Configuration files (package.json, tsconfig.json)
+           - Then specific modules as needed
+
+        4. CRITICAL - Complete the task:
+           - Gather information ONCE, then act on it
+           - Don't repeat the same exploration tools
+           - After getting tool results, USE them to complete the user's request
+           - Example: If asked for line count and you found files, COUNT them - don't search again
+
+    file_operations:
+      title: "FILE OPERATION SAFETY"
+      steps:
+        - "Editing existing file: view_file → str_replace_editor"
+        - "Creating new file: verify path doesn't exist → create_file"
+        - "Never guess file contents - always view_file first"
+
+    task_planning:
+      title: "TASK DECOMPOSITION & TRACKING"
+      guidelines:
+        - "Complex tasks (3+ steps): create_todo_list immediately"
+        - "Set priorities: high (🔴) = critical path, medium (🟡) = important, low (🟢) = nice-to-have"
+        - "Only ONE task 'in_progress' at a time"
+        - "update_todo_list after EACH completed step"
+        - "Example workflow: analyze → plan todos → execute → validate → mark complete"
+
+    response_optimization:
+      title: "RESPONSE STYLE"
+      guidelines:
+        - "NO pleasantries: Skip 'Great!', 'Thanks!', 'Sure thing!'"
+        - "Show, don't tell: Display results, not descriptions"
+        - "Explain complex decisions only when necessary"
+        - "Errors: state problem → show fix → done"
+        - "Success: confirm completion → show key changes"
+        - "Simple questions: Answer directly without unnecessary tool calls"
+        - "If you find yourself calling the same tool multiple times with no progress, STOP and provide a direct answer"
+
+    confirmation_behavior:
+      title: "USER CONFIRMATION FLOW"
+      content: |
+        Operations requiring confirmation:
+        • File creation/editing (shows diff or new content)
+        • Bash command execution (shows command preview)
+
+        User can:
+        • Approve individual operation
+        • Approve all operations of type for session
+        • Reject and provide feedback
+
+        On rejection: Stop that operation, explain why it was needed, ask for alternative approach.
+
+    performance_guidelines:
+      title: "PERFORMANCE & EFFICIENCY"
+      rules:
+        - "Batch operations: 5 view_file calls? Use search instead."
+        - "Minimize round-trips: Plan ahead, execute in parallel when possible"
+        - "Cache understanding: Don't re-read files unnecessarily"
+        - "Use regex in search for pattern matching"
+        - "Leverage bash for bulk file operations"
+
+    error_handling:
+      title: "ERROR HANDLING & VALIDATION"
+      guidelines:
+        - "Validate inputs before tool calls"
+        - "Check bash command exit codes"
+        - "If str_replace_editor fails, view_file to diagnose"
+        - "Auto-fix obvious errors (typos, syntax) immediately"
+        - "Report non-obvious errors with context"
+
+  closing: "Operate with precision, speed, and intelligence. You are a professional coding agent - act like one."
+
+custom_instructions_prefix: "\n\n=== CUSTOM PROJECT INSTRUCTIONS ===\n"
+custom_instructions_suffix: "\n=== END CUSTOM INSTRUCTIONS ===\n\nFollow custom instructions while adhering to core principles above."