mycontext-cli 1.0.93 → 1.0.95

package/README.md

@@ -44,6 +44,16 @@ mycontext generate-components all --with-tests
 - **🔧 Developer-Friendly**: Built-in validation, testing, and preview capabilities
 - **🆓 Free Tier**: Use Qwen3 Coder model for free testing, or premium X.AI/Claude for production
 
+### 🚀 **Claude Agent SDK Integration** (NEW!)
+
+- **🧠 Advanced Context Management**: Automatic context compaction and intelligent memory management
+- **🔐 Fine-Grained Tool Permissions**: Granular control over AI capabilities with strict/permissive modes
+- **🔌 MCP Integration**: Model Context Protocol support for external tools and services
+- **⚡ Enhanced Workflows**: Intelligent agent coordination with automatic error handling and retry logic
+- **🎯 Smart Fallbacks**: Seamless fallback to standard clients when Agent SDK isn't available
+- **📊 Context Analytics**: Detailed context statistics and compression ratios
+- **🛡️ Security Controls**: File size limits, directory restrictions, and tool validation
+
 ## Commands
 
 ### Project Setup
@@ -216,32 +226,45 @@ MyContext supports multiple AI providers with intelligent fallback:
 
 #### **Recommended (Premium)**
 
-1. **X.AI (Grok) - Best for Code Generation**
+1. **🚀 Claude Agent SDK - Best for Advanced Workflows** (NEW!)
+
+   ```bash
+   echo 'MYCONTEXT_CLAUDE_API_KEY=sk-ant-xxx' > .mycontext/.env
+   ```
+
+   **Features:**
+   - Advanced context management and compaction
+   - Fine-grained tool permissions
+   - MCP (Model Context Protocol) integration
+   - Intelligent agent coordination
+   - Automatic error handling and retry logic
+
+2. **X.AI (Grok) - Best for Code Generation**
 
    ```bash
    echo 'MYCONTEXT_XAI_API_KEY=xai-xxx' > .mycontext/.env
    ```
 
-2. **Claude (Anthropic) - Best for Complex Reasoning**
+3. **Claude (Anthropic) - Best for Complex Reasoning**
 
    ```bash
    echo 'MYCONTEXT_CLAUDE_API_KEY=sk-ant-xxx' > .mycontext/.env
    ```
 
-3. **OpenAI (GPT-4) - Most Versatile**
+4. **OpenAI (GPT-4) - Most Versatile**
    ```bash
    echo 'MYCONTEXT_OPENAI_API_KEY=sk-xxx' > .mycontext/.env
    ```
 
 #### **Testing & Fallback**
 
-4. **Qwen3 Coder (FREE)**
+5. **Qwen3 Coder (FREE)**
 
    ```bash
    echo 'MYCONTEXT_QWEN_API_KEY=sk-or-xxx' > .mycontext/.env
    ```
 
-5. **GitHub Models (Self-hosted)**
+6. **GitHub Models (Self-hosted)**
    ```bash
    echo 'MYCONTEXT_GITHUB_TOKEN=ghp_xxx' > .mycontext/.env
    ```
@@ -304,6 +327,77 @@ mycontext build-strategy --compare
 mycontext build-strategy --context
 ```
 
+## 🚀 **Claude Agent SDK Features**
+
+### **Advanced Context Management**
+
+The Claude Agent SDK provides intelligent context management with automatic compaction:
+
+```bash
+# Context is automatically managed and compacted when it exceeds limits
+mycontext build-app --description "Complex enterprise application"
+```
+
+**Features:**
+
+- **Automatic Compaction**: Context is compressed when it exceeds size limits
+- **Smart Preservation**: Recent outputs and important data are preserved
+- **Context Analytics**: Detailed statistics on context size and compression ratios
+- **Memory Management**: Persistent context storage across sessions
+
+### **Fine-Grained Tool Permissions**
+
+Control exactly what the AI can do with granular permissions:
+
+```bash
+# Tool permissions are automatically configured based on your project needs
+mycontext setup
+```
+
+**Permission Modes:**
+
+- **Strict**: Deny by default, require explicit permission
+- **Permissive**: Allow by default, block specific tools
+- **Custom**: Fine-grained control over individual tools
+
+**Security Features:**
+
+- File size limits and type restrictions
+- Directory access controls
+- API call rate limiting
+- Tool validation and restrictions
+
+### **MCP (Model Context Protocol) Integration**
+
+Connect to external tools and services through MCP:
+
+```bash
+# Set up MCP integration
+mycontext setup-mcp --provider instantdb
+```
+
+**Supported Providers:**
+
+- **InstantDB**: Real-time database integration
+- **GitHub**: Repository and issue management
+- **Custom**: Your own MCP servers
+
+### **Enhanced Workflows**
+
+Intelligent agent coordination with automatic error handling:
+
+```bash
+# Enhanced workflows automatically use Claude Agent SDK when available
+mycontext build-app --interactive
+```
+
+**Workflow Features:**
+
+- **Smart Fallbacks**: Seamless fallback to standard clients
+- **Error Recovery**: Automatic retry logic with exponential backoff
+- **Context Awareness**: Each step builds on previous context
+- **Progress Tracking**: Detailed progress reporting and analytics
+
 ## Documentation
 
 - [Full Documentation](https://mycontext.fbien.com/docs)

package/dist/agents/implementations/ClaudeAgentWorkflow.d.ts

@@ -0,0 +1,110 @@
+/**
+ * ClaudeAgentWorkflow Implementation
+ *
+ * Enhanced workflow agent that leverages Claude Agent SDK for advanced
+ * context management, tool permissions, and MCP integration.
+ */
+import { SubAgent, WorkflowInput, WorkflowOutput } from "../interfaces/SubAgent";
+export declare class ClaudeAgentWorkflow implements SubAgent<WorkflowInput, WorkflowOutput> {
+    name: string;
+    description: string;
+    personality: string;
+    llmProvider: string;
+    expertise: string[];
+    private claudeAgentClient;
+    private contextManager;
+    private permissionManager;
+    private mcpIntegration;
+    private completedSteps;
+    private failedSteps;
+    private userInteractions;
+    private totalRetries;
+    private workflowContext;
+    constructor(workingDirectory?: string);
+    /**
+     * Check if Claude Agent SDK is available
+     */
+    isClaudeAgentAvailable(): boolean;
+    run(input: WorkflowInput): Promise<WorkflowOutput>;
+    /**
+     * Initialize Claude Agent SDK with enhanced configuration
+     */
+    private initializeClaudeAgent;
+    /**
+     * Prepare workflow context
+     */
+    private prepareWorkflowContext;
+    /**
+     * Define enhanced workflow steps with Claude Agent SDK
+     */
+    private defineEnhancedWorkflowSteps;
+    /**
+     * Execute enhanced workflow with Claude Agent SDK
+     */
+    private executeEnhancedWorkflow;
+    /**
+     * Execute individual step using Claude Agent SDK
+     */
+    private executeStepWithClaudeAgent;
+    /**
+     * Build step-specific prompt for Claude Agent SDK
+     */
+    private buildStepPrompt;
+    /**
+     * Build context analysis prompt
+     */
+    private buildContextAnalysisPrompt;
+    /**
+     * Build project setup prompt
+     */
+    private buildProjectSetupPrompt;
+    /**
+     * Build requirement gathering prompt
+     */
+    private buildRequirementGatheringPrompt;
+    /**
+     * Build context generation prompt
+     */
+    private buildContextGenerationPrompt;
+    /**
+     * Build component generation prompt
+     */
+    private buildComponentGenerationPrompt;
+    /**
+     * Build validation testing prompt
+     */
+    private buildValidationTestingPrompt;
+    /**
+     * Process step result
+     */
+    private processStepResult;
+    /**
+     * Process context analysis result
+     */
+    private processContextAnalysisResult;
+    /**
+     * Process project setup result
+     */
+    private processProjectSetupResult;
+    /**
+     * Process requirement gathering result
+     */
+    private processRequirementGatheringResult;
+    /**
+     * Process context generation result
+     */
+    private processContextGenerationResult;
+    /**
+     * Process component generation result
+     */
+    private processComponentGenerationResult;
+    /**
+     * Process validation testing result
+     */
+    private processValidationTestingResult;
+    /**
+     * Get enhanced system prompt for Claude Agent SDK
+     */
+    private getEnhancedSystemPrompt;
+}
+//# sourceMappingURL=ClaudeAgentWorkflow.d.ts.map

package/dist/agents/implementations/ClaudeAgentWorkflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClaudeAgentWorkflow.d.ts","sourceRoot":"","sources":["../../../src/agents/implementations/ClaudeAgentWorkflow.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,QAAQ,EACR,aAAa,EACb,cAAc,EAEf,MAAM,wBAAwB,CAAC;AAOhC,qBAAa,mBACX,YAAW,QAAQ,CAAC,aAAa,EAAE,cAAc,CAAC;IAElD,IAAI,SAAyB;IAC7B,WAAW,SAC6F;IACxG,WAAW,SACwF;IACnG,WAAW,SAAsB;IACjC,SAAS,WAQP;IAEF,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,iBAAiB,CAAwB;IACjD,OAAO,CAAC,cAAc,CAAsB;IAE5C,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,eAAe,CAAsB;gBAEjC,gBAAgB,CAAC,EAAE,MAAM;IAOrC;;OAEG;IACH,sBAAsB,IAAI,OAAO;IAI3B,GAAG,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAmFxD;;OAEG;YACW,qBAAqB;IAoCnC;;OAEG;YACW,sBAAsB;IAgDpC;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAyGnC;;OAEG;YACW,uBAAuB;IAUrC;;OAEG;YACW,0BAA0B;IAkFxC;;OAEG;IACH,OAAO,CAAC,eAAe;IAwBvB;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAgBlC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAgB/B;;OAEG;IACH,OAAO,CAAC,+BAA+B;IAevC;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAiBpC;;OAEG;IACH,OAAO,CAAC,8BAA8B;IAgBtC;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAcpC;;OAEG;YACW,iBAAiB;IA2B/B;;OAEG;YACW,4BAA4B;IAK1C;;OAEG;YACW,yBAAyB;IAKvC;;OAEG;YACW,iCAAiC;IAK/C;;OAEG;YACW,8BAA8B;IAK5C;;OAEG;YACW,gCAAgC;IAK9C;;OAEG;YACW,8BAA8B;IAK5C;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAoBhC"}