chore: change default subAgentMode to 'disabled' and mark sync/async modes as experimental

Author: bhouston

mycoder.config.js

@@ -20,8 +20,8 @@ export default {
     // executablePath: null, // e.g., '/path/to/chrome'
   },
 
-  // Sub-agent workflow mode: 'disabled', 'sync', or 'async' (default)
-  subAgentMode: 'async',
+  // Sub-agent workflow mode: 'disabled' (default), 'sync' (experimental), or 'async' (experimental)
+  subAgentMode: 'disabled',
 
   // Model settings
   //provider: 'anthropic',

packages/agent/src/tools/getTools.ts

@@ -39,7 +39,7 @@ interface GetToolsOptions {
 export function getTools(options?: GetToolsOptions): Tool[] {
   const userPrompt = options?.userPrompt !== false; // Default to true if not specified
   const mcpConfig = options?.mcpConfig || { servers: [], defaultResources: [] };
-  const subAgentMode = options?.subAgentMode || 'async'; // Default to async mode
+  const subAgentMode = options?.subAgentMode || 'disabled'; // Default to disabled mode
 
   // Force cast to Tool type to avoid TypeScript issues
   const tools: Tool[] = [

packages/cli/src/commands/tools.ts

@@ -41,7 +41,7 @@ export const command: CommandModule<object, ToolsArgs> = {
   describe: 'List all available tools and their capabilities',
   handler: () => {
     try {
-      const tools = getTools({ subAgentMode: 'async' });
+      const tools = getTools({ subAgentMode: 'disabled' });
 
       console.log('Available Tools:\n');
 

packages/cli/src/settings/config.ts

@@ -78,7 +78,7 @@ const defaultConfig: Config = {
   upgradeCheck: true,
   tokenUsage: false,
   interactive: false,
-  subAgentMode: 'async',
+  subAgentMode: 'disabled',
 
   // MCP configuration
   mcp: {

packages/docs/docs/usage/configuration.md

@@ -118,11 +118,11 @@ export default {
 
 ### Behavior Customization
 
-| Option         | Description                    | Possible Values                 | Default  |
-| -------------- | ------------------------------ | ------------------------------- | -------- |
-| `customPrompt` | Custom instructions for the AI | Any string                      | `""`     |
-| `githubMode`   | Enable GitHub integration      | `true`, `false`                 | `false`  |
-| `subAgentMode` | Sub-agent workflow mode        | `'disabled'`, `'sync'`, `'async'` | `'async'` |
+| Option         | Description                    | Possible Values                   | Default   |
+| -------------- | ------------------------------ | --------------------------------- | --------- |
+| `customPrompt` | Custom instructions for the AI | Any string                                          | `""`        |
+| `githubMode`   | Enable GitHub integration      | `true`, `false`                                 | `false`     |
+| `subAgentMode` | Sub-agent workflow mode        | `'disabled'`, `'sync'` (experimental), `'async'` (experimental) | `'disabled'` |
 
 Example:
 
@@ -210,8 +210,8 @@ export default {
   profile: true,
   tokenUsage: true,
   tokenCache: true,
-  
+
   // Sub-agent workflow mode
-  subAgentMode: 'async', // Options: 'disabled', 'sync', 'async'
+  subAgentMode: 'disabled', // Options: 'disabled', 'sync' (experimental), 'async' (experimental)
 };
 ```

packages/docs/docs/usage/sub-agent-modes.md

@@ -10,7 +10,7 @@ MyCoder supports different modes for working with sub-agents, giving you flexibi
 
 MyCoder supports three distinct sub-agent workflow modes:
 
-### 1. Disabled Mode
+### 1. Disabled Mode (Default)
 
 In this mode, sub-agent functionality is completely disabled:
 
@@ -19,7 +19,7 @@ In this mode, sub-agent functionality is completely disabled:
 - Useful for simpler tasks or when resource constraints are a concern
 - Reduces memory usage and API costs for straightforward tasks
 
-### 2. Synchronous Mode ("sync")
+### 2. Synchronous Mode ("sync") - Experimental
 
 In synchronous mode, the parent agent waits for sub-agents to complete before continuing:
 
@@ -29,7 +29,7 @@ In synchronous mode, the parent agent waits for sub-agents to complete before co
 - Simpler to reason about as there's no parallel execution
 - Good for tasks where later steps depend on the results of earlier steps
 
-### 3. Asynchronous Mode ("async") - Default
+### 3. Asynchronous Mode ("async") - Experimental
 
 In asynchronous mode, sub-agents run in parallel with the parent agent:
 
@@ -47,9 +47,9 @@ You can set the sub-agent workflow mode in your `mycoder.config.js` file:
 ```javascript
 // mycoder.config.js
 export default {
-  // Sub-agent workflow mode: 'disabled', 'sync', or 'async'
-  subAgentMode: 'async', // Default value
-  
+  // Sub-agent workflow mode: 'disabled', 'sync' (experimental), or 'async' (experimental)
+  subAgentMode: 'disabled', // Default value
+
   // Other configuration options...
 };
 ```
@@ -105,7 +105,7 @@ Ideal for complex projects with independent components:
 ```javascript
 // mycoder.config.js
 export default {
-  subAgentMode: 'async', // This is the default
+  subAgentMode: 'async', // Experimental
   // Other settings...
 };
 ```
@@ -116,4 +116,4 @@ export default {
 - In **sync mode**, only the `agentExecute` and `agentDone` tools are available, ensuring synchronous execution.
 - In **async mode**, the full suite of agent tools (`agentStart`, `agentMessage`, `listAgents`, and `agentDone`) is available, enabling parallel execution.
 
-This implementation allows MyCoder to adapt to different task requirements while maintaining a consistent interface for users.
+This implementation allows MyCoder to adapt to different task requirements while maintaining a consistent interface for users.