centaurus-cli 2.4.0 → 2.5.0

package/README.md

@@ -12,6 +12,7 @@
 - Support for Google Gemini (2.5 Flash, 2.5 Pro, 2.0 Flash, and more)
 - Intelligent code generation and editing
 - Context-aware file operations
+- **Enhanced Agentic Loop** - Autonomous multi-turn task completion
 
 🔧 **Developer Tools**
 - Read, write, and edit files with AI assistance
@@ -33,6 +34,12 @@
 - Seamless authentication with Google
 - Secure backend-managed AI access
 
+🤖 **Autonomous Operation**
+- Continuous multi-turn execution until task completion
+- Automatic detection of incomplete work
+- Smart continuation without manual prompting
+- Handles complex multi-file projects seamlessly
+
 ## Installation
 
 ### Global Installation (Recommended)
@@ -106,7 +113,11 @@ Your settings are stored in `~/.centaurus/config.json`:
 - Auto-accept preferences
 - Plan mode settings
 
-**Note:** API keys are no longer stored in the CLI. They are managed centrally by the backend service.
+**Note:** API keys and system prompts are managed centrally by the backend service. This ensures:
+- Consistent AI behavior across all Centaurus clients (CLI, Desktop, Web)
+- Easy updates to AI instructions without client changes
+- Secure credential management
+- Environment-aware responses (OS, shell, working directory)
 
 ## Commands
 
@@ -137,6 +148,39 @@ Your settings are stored in `~/.centaurus/config.json`:
 
 ## Features in Detail
 
+### Enhanced Agentic Loop
+
+Centaurus CLI features a robust autonomous operation system that works continuously until your task is complete:
+
+**How It Works:**
+- The AI executes multiple turns automatically without manual prompting
+- Detects when work is incomplete and continues autonomously
+- Handles complex multi-file projects in a single session
+- Supports up to 100 turns for complex tasks
+- Automatically stops when the task is complete
+
+**Example - Multi-File Project:**
+```
+> Create a landing page with HTML, CSS, and JavaScript
+```
+
+The AI will:
+1. Create `index.html` with structure
+2. Create `styles.css` with styling
+3. Create `script.js` with interactivity
+4. Complete the task automatically without additional prompts
+
+**Smart Continuation:**
+- Detects incomplete responses (e.g., "I created the HTML file...")
+- Automatically prompts the AI to continue with remaining steps
+- Prevents premature stopping on complex tasks
+
+**Safety Features:**
+- 500ms delay between turns to prevent rate limiting
+- Maximum 100 turns to prevent infinite loops
+- Long-running command protection (blocks `npm run dev`, etc.)
+- 30-second timeout for command executions
+
 ### File Operations
 
 Centaurus can read, write, and edit files in your project:
@@ -176,6 +220,8 @@ Execute shell commands safely:
 > Check the git status
 ```
 
+**Note:** Long-running commands (like `npm run dev`, `yarn start`, or development servers) are automatically blocked. Run these manually in a separate terminal.
+
 ### Plan Mode
 
 For complex tasks, enable plan mode to see the implementation plan before execution:
@@ -213,6 +259,29 @@ Centaurus CLI requires a connection to the backend service:
 - Ensures secure and centralized API key management
 - No local API key storage required
 
+### System Prompt Management
+
+System prompts (the foundational AI instructions) are managed entirely by the backend:
+
+**Benefits:**
+- **Consistency**: All Centaurus clients use the same AI behavior
+- **Easy Updates**: Prompt improvements are deployed instantly without client updates
+- **Environment Awareness**: Backend injects your OS, shell, and working directory context
+- **Mode Support**: Different prompts for default, plan, and command modes
+
+**How It Works:**
+1. CLI sends your message and environment context to the backend
+2. Backend injects the appropriate system prompt with your environment details
+3. AI receives complete context and responds appropriately
+4. No prompt management needed on your end!
+
+**Environment Context Sent:**
+- Operating system (Windows, macOS, Linux)
+- Shell type (cmd, PowerShell, bash, zsh)
+- Current working directory
+- Home directory path
+- Current mode (default, plan, command)
+
 ## Advanced Usage
 
 ### Custom Backend
@@ -268,6 +337,78 @@ npm start
 
 The backend has exhausted its API quota. This is managed by the backend administrator. Wait a few moments and try again.
 
+### AI Stops Before Task is Complete
+
+If the AI stops working before finishing your task:
+
+**Possible Causes:**
+1. **Network interruption** - Check your internet connection
+2. **Backend timeout** - The backend may have timed out; try again
+3. **Turn limit reached** - Very complex tasks may hit the 100-turn safety limit
+
+**Solutions:**
+- For simple continuation: Send a follow-up message like "Continue with the remaining steps"
+- For complex tasks: Break the task into smaller, more specific requests
+- Check backend logs for errors if the issue persists
+
+### AI Keeps Working After Task is Done
+
+The enhanced agentic loop should automatically detect completion. If it continues unnecessarily:
+
+**What to Do:**
+- Press `Ctrl+C` to stop the current operation
+- The AI should detect completion within 2-3 turns after finishing
+- If this happens frequently, report it as a bug with your task description
+
+### Long-Running Commands Blocked
+
+Commands like `npm run dev`, `yarn start`, or `python -m http.server` are automatically blocked:
+
+**Why:**
+- These commands don't terminate and would hang the CLI
+- They're meant to run in separate terminal sessions
+
+**Solution:**
+- Run development servers manually in a separate terminal
+- The AI will inform you when you need to run these commands yourself
+
+### Slow Response or Timeouts
+
+If responses are slow or timing out:
+
+**Troubleshooting Steps:**
+1. Check your internet connection speed
+2. Verify backend is responsive: `curl http://localhost:3000/api/health`
+3. Check backend logs for rate limiting or API errors
+4. Try a simpler query to test connectivity
+5. Restart the CLI and try again
+
+### Commands Timing Out
+
+Individual commands have a 30-second timeout:
+
+**If a command times out:**
+- The command may be too slow or hanging
+- Check if the command works when run manually
+- Consider breaking complex commands into smaller steps
+- Some operations (large file processing) may need to be done outside the CLI
+
+### Environment Context Issues
+
+If the AI doesn't seem aware of your OS or environment:
+
+**Check:**
+1. Backend is receiving environment context (check backend logs)
+2. Your shell environment variables are set correctly
+3. Backend system prompt service is functioning
+
+**Verify:**
+```bash
+# Check environment variables
+echo $SHELL          # macOS/Linux
+echo %ComSpec%       # Windows
+```
+
 ### Reset Configuration
 
 Delete the config file to start fresh:
@@ -284,6 +425,15 @@ rm ~/.centaurus/config.json
 
 **Note:** This will clear your model preferences and settings, but you'll need to re-authenticate.
 
+### Getting Help
+
+If you're still experiencing issues:
+
+1. **Check Backend Logs**: Most issues originate from backend connectivity or configuration
+2. **Enable Debug Logging**: Set `DEBUG=centaurus:*` environment variable
+3. **Report Issues**: Include your OS, Node version, and error messages
+4. **Community Support**: Check discussions for similar issues and solutions
+
 ## Requirements
 
 - Node.js >= 18.0.0

package/dist/cli-adapter.d.ts

@@ -1,8 +1,8 @@
+import { SubshellContext } from './context/types.js';
 export declare class CentaurusCLI {
     private configManager;
     private toolRegistry;
     private conversationHistory;
-    private systemPrompt;
     private cwd;
     private planMode;
     private commandMode;
@@ -17,7 +17,12 @@ export declare class CentaurusCLI {
     private onToolStreamingOutput?;
     private onPlanModeChange?;
     private onPlanApprovalRequest?;
+    private onPasswordRequest?;
     private conversationStarted;
+    private contextManager;
+    private commandDetector;
+    private aiContextInjector;
+    private onSubshellContextChange?;
     constructor();
     setOnResponseCallback(callback: (message: string) => void): void;
     setOnResponseStreamCallback(callback: (chunk: string) => void): void;
@@ -59,10 +64,14 @@ export declare class CentaurusCLI {
     }) => Promise<boolean>): void;
     setOnCommandModeChange(callback: (commandMode: boolean) => void): void;
     setOnCwdChange(callback: (cwd: string) => void): void;
+    setOnSubshellContextChange(callback: (context: SubshellContext) => void): void;
+    setOnPasswordRequest(callback: (message: string) => Promise<string>): void;
     getPlanMode(): boolean;
     getCommandMode(): boolean;
     getCurrentWorkingDirectory(): string;
+    getCurrentSubshellContext(): SubshellContext;
     handlePickerSelection(selection: string, pickerType: 'model'): Promise<void>;
+    private sshHandler?;
     initialize(): Promise<void>;
     /**
      * Get migration message if configuration was migrated
@@ -84,8 +93,38 @@ export declare class CentaurusCLI {
     getModel(): string;
     handleMessage(message: string): Promise<void>;
     private handleSlashCommand;
-    private loadSystemPrompt;
+    /**
+     * Get environment context for backend
+     * Returns structured environment information to be sent to backend
+     */
     private getEnvironmentContext;
+    /**
+     * Get current mode
+     * Returns the current mode (default, plan, or command)
+     */
+    private getMode;
+    /**
+     * Check if response contains completion marker
+     * Returns true if the <TASK_COMPLETE> marker is found in the text
+     */
+    private hasCompletionMarker;
+    /**
+     * Remove completion marker from text
+     * Strips the <TASK_COMPLETE> marker from display text
+     */
+    private removeCompletionMarker;
+    /**
+     * Check if response contains strong completion phrases
+     * Returns true if the text contains phrases that strongly indicate task completion
+     * Used as fallback when completion marker is not present
+     */
+    private hasStrongCompletionPhrase;
+    /**
+     * Check if response seems incomplete
+     * Returns true if the text contains phrases that suggest the AI stopped prematurely
+     * Only triggers within first 15 turns to prevent infinite loops
+     */
+    private seemsIncomplete;
     private getPlanModeInstructions;
     private parsePlanResponse;
     /**

package/dist/cli-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-adapter.d.ts","sourceRoot":"","sources":["../src/cli-adapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli-adapter.d.ts","sourceRoot":"","sources":["../src/cli-adapter.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD,qBAAa,YAAY;IACvB,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,mBAAmB,CAAmB;IAC9C,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,YAAY,CAAyC;IAC7D,OAAO,CAAC,kBAAkB,CAAC,CAA4B;IACvD,OAAO,CAAC,wBAAwB,CAAC,CAA0B;IAC3D,OAAO,CAAC,mBAAmB,CAAC,CAAiC;IAC7D,OAAO,CAAC,WAAW,CAAC,CAAwB;IAC5C,OAAO,CAAC,oBAAoB,CAAC,CAA0G;IACvI,OAAO,CAAC,qBAAqB,CAAC,CAAwJ;IACtL,OAAO,CAAC,qBAAqB,CAAC,CAAsP;IACpR,OAAO,CAAC,qBAAqB,CAAC,CAAmF;IACjH,OAAO,CAAC,gBAAgB,CAAC,CAA8B;IACvD,OAAO,CAAC,qBAAqB,CAAC,CAAoE;IAClG,OAAO,CAAC,iBAAiB,CAAC,CAAuC;IACjE,OAAO,CAAC,mBAAmB,CAAkB;IAC7C,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,uBAAuB,CAAC,CAAqC;;IAwBrE,qBAAqB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIhE,2BAA2B,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIpE,uBAAuB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI;IAIhJ,wBAAwB,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,WAAW,GAAG,WAAW,GAAG,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI;IAI/L,wBAAwB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,aAAa,CAAC,EAAE,YAAY,GAAG,WAAW,GAAG,iBAAiB,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI;IAI7R,wBAAwB,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI;IAI1H,mBAAmB,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;IAIhE,wBAAwB,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI;IAI3G,sBAAsB,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;IAItE,cAAc,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIrD,0BAA0B,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,GAAG,IAAI;IAI9E,oBAAoB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI;IAQ1E,WAAW,IAAI,OAAO;IAItB,cAAc,IAAI,OAAO;IAIzB,0BAA0B,IAAI,MAAM;IAIpC,yBAAyB,IAAI,eAAe;IAItC,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBlF,OAAO,CAAC,UAAU,CAAC,CAAa;IAE1B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAmCjC;;;OAGG;IACH,mBAAmB,IAAI,MAAM,GAAG,IAAI;IAkCpC;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;YACW,yBAAyB;IAuBvC;;OAEG;YACW,oBAAoB;IAoBlC,QAAQ,IAAI,MAAM;IAKZ,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAyYrC,kBAAkB;IA2NhC;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAe7B;;;OAGG;IACH,OAAO,CAAC,OAAO;IAMf;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAI9B;;;;OAIG;IACH,OAAO,CAAC,yBAAyB;IAqCjC;;;;OAIG;IACH,OAAO,CAAC,eAAe;IA6CvB,OAAO,CAAC,uBAAuB;IAI/B,OAAO,CAAC,iBAAiB;IAqBzB;;OAEG;IACH,iBAAiB,IAAI,IAAI;IA6BzB;;OAEG;YACW,0BAA0B;CAqIzC"}