@sowonai/crewx-cli 0.4.0-dev.3 → 0.4.0-dev.31

package/templates/agents/minimal.yaml

@@ -0,0 +1,16 @@
+# CrewX Minimal Layout Definition
+#
+# This layout provides a lightweight structure that simply wraps the agent prompt
+# and preserves backward compatibility with inline system prompts.
+
+layouts:
+  minimal: |
+    <system_prompt key="{{vars.security_key}}">
+    {{{agent.inline.prompt}}}
+    </system_prompt>
+
+    {{#if vars.user_input}}
+    <user_query key="{{vars.security_key}}">
+    {{{vars.user_input}}}
+    </user_query>
+    {{/if}}

package/templates/documents/crewcode-manual.md

@@ -0,0 +1,292 @@
+# CrewX User Manual
+
+## Quick Start
+
+CrewX is a multi-AI agent collaboration tool that works with Claude, Gemini, and GitHub Copilot.
+
+## Basic Commands
+
+### Query (Read-Only Analysis)
+```bash
+crewx query "@agent your question"
+crewx q "@agent your question"  # shortcut
+```
+
+### Execute (File Creation/Modification)
+```bash
+crewx execute "@agent your task"
+crewx x "@agent your task"  # shortcut
+```
+
+### System Commands
+```bash
+crewx init      # Initialize agents.yaml
+crewx doctor    # Check AI provider status
+crewx logs [id] # View task logs
+```
+
+## Agent Mention Syntax
+
+### Basic Agent Mention
+```bash
+crewx q "@claude analyze this code"
+crewx q "@gemini search latest AI news"
+crewx q "@copilot suggest improvements"
+```
+
+### Model Selection
+Specify AI model using colon syntax:
+```bash
+crewx q "@claude:opus complex architecture design"
+crewx q "@claude:sonnet general development tasks"
+crewx q "@claude:haiku quick simple questions"
+crewx q "@gemini:gemini-2.5-pro advanced analysis"
+```
+
+### Multiple Agents (Parallel Execution)
+Query multiple agents simultaneously:
+```bash
+crewx q "@claude @gemini @copilot review this code"
+```
+
+Each agent processes independently and results are returned in parallel.
+
+## Built-in Agents
+
+### @crewx (This Agent)
+Your CrewX assistant. Fallback mechanism: claude → gemini → copilot
+```bash
+crewx q "@crewx how do I use multiple agents?"
+```
+
+### @claude (Anthropic Claude)
+Best for: Complex reasoning, code analysis, architecture
+```bash
+crewx q "@claude explain this design pattern"
+```
+
+### @gemini (Google Gemini)
+Best for: Performance optimization, data analysis, research
+```bash
+crewx q "@gemini optimize this algorithm"
+```
+
+### @copilot (GitHub Copilot)
+Best for: Code implementation, best practices, testing
+```bash
+crewx q "@copilot write unit tests for this function"
+```
+
+## Custom Agents
+
+### Creating Custom Agents
+
+Create `agents.yaml` in your project:
+
+```yaml
+agents:
+  - id: "my_agent"
+    name: "My Custom Agent"
+    role: "developer"
+    inline:
+      provider: "claude"
+      model: "sonnet"
+      system_prompt: |
+        You are a specialized assistant for...
+```
+
+### Using Custom Agents
+```bash
+crewx q "@my_agent your question"
+```
+
+## Document System
+
+### Using Documents in Agents
+
+Reference documents in system_prompt:
+
+```yaml
+agents:
+  - id: "helper"
+    inline:
+      system_prompt: |
+        <manual>
+        {{{documents.user-guide.content}}}
+        </manual>
+```
+
+### Document Levels
+1. `documents.yaml` - Global documents
+2. `agents.yaml` documents: - Project documents
+3. `agent.inline.documents` - Agent-specific
+
+### Template Variables
+- `{{{documents.name.content}}}` - Full content
+- `{{{documents.name.toc}}}` - Table of contents
+- `{{documents.name.summary}}` - Summary
+
+## MCP Integration
+
+### VS Code
+Add to `.vscode/mcp.json`:
+```json
+{
+  "servers": {
+    "crewx": {
+      "command": "npx",
+      "args": ["-y", "crewx", "mcp"],
+      "env": {
+        "CREWX_CONFIG": "${workspaceFolder}/crewx.yaml"
+      }
+    }
+  }
+}
+```
+
+### Claude Desktop
+Add to `claude_desktop_config.json`:
+```json
+{
+  "mcpServers": {
+    "crewx": {
+      "command": "npx",
+      "args": ["-y", "crewx", "mcp"]
+    }
+  }
+}
+```
+
+## Common Patterns
+
+### Code Review
+```bash
+crewx q "@claude @copilot review this pull request"
+```
+
+### Architecture Design
+```bash
+crewx q "@claude:opus design user authentication system"
+```
+
+### Implementation
+```bash
+crewx x "@copilot implement JWT middleware"
+```
+
+### Multi-Perspective Analysis
+```bash
+crewx q "@claude @gemini @copilot analyze performance issues"
+```
+
+## Troubleshooting
+
+### Check AI Provider Status
+```bash
+crewx doctor
+```
+
+### View Task Logs
+```bash
+crewx logs
+crewx logs task_1234567890_abcdef
+```
+
+### Common Issues
+
+**Agent not found:**
+- Check `agents.yaml` exists
+- Verify agent ID is correct
+- Use `@crewx` for built-in help
+
+**AI provider unavailable:**
+- Run `crewx doctor`
+- Install required CLI: claude, gemini, copilot
+- Check authentication
+
+**Template errors:**
+- Verify document references exist
+- Check YAML syntax
+- Use `{{{...}}}` for unescaped content
+
+## Tips & Best Practices
+
+### Choose the Right Model
+- **opus**: Complex reasoning, architecture
+- **sonnet**: Balanced performance (default)
+- **haiku**: Fast, simple tasks
+
+### Leverage Parallel Execution
+Query multiple agents for comprehensive analysis:
+```bash
+crewx q "@claude @gemini @copilot what's the best approach?"
+```
+
+### Use Documents for Context
+Provide project-specific knowledge to agents via documents:
+- Coding standards
+- API documentation
+- Architecture guidelines
+
+### Read-Only vs Execute Mode
+- **Query mode**: Safe analysis, no modifications
+- **Execute mode**: Can create/modify files
+
+### Task Logs
+Review logs to understand agent execution:
+```bash
+crewx logs  # List recent tasks
+crewx logs [taskId]  # View specific task
+```
+
+## Advanced Features
+
+### Template Processing
+Documents support Handlebars templates:
+```yaml
+system_prompt: |
+  Project guidelines:
+  {{{documents.guidelines.content}}}
+  
+  Available APIs:
+  {{{documents.api-docs.toc}}}
+```
+
+### Lazy Loading
+Large documents can be loaded on-demand:
+```yaml
+documents:
+  large-manual:
+    path: "docs/manual.md"
+    lazy: true
+```
+
+### Agent-Specific Options
+Configure CLI options per agent:
+```yaml
+agents:
+  - id: "reviewer"
+    options:
+      query:
+        - "--add-dir=."
+        - "--verbose"
+      execute:
+        - "--add-dir=."
+        - "--allowedTools=Edit"
+```
+
+## Getting Help
+
+### Ask @crewx
+```bash
+crewx q "@crewx how do I...?"
+```
+
+### Documentation
+- GitHub: https://github.com/sowonlabs/crewx
+- CLI Reference: README.cli.md
+- Agent Configuration: README.md
+
+### Community
+- Report issues: GitHub Issues
+- Discussions: GitHub Discussions

package/templates/versions.json

@@ -0,0 +1,19 @@
+{
+  "latest": "v0.1.8",
+  "versions": {
+    "v0.1.8": {
+      "released": "2025-01-01",
+      "templates": ["default", "minimal", "development", "production"],
+      "description": "Initial template system with @crewx agent and model selection support",
+      "minCrewxVersion": "0.1.8",
+      "maxCrewxVersion": null
+    },
+    "main": {
+      "released": "development",
+      "templates": ["default", "minimal", "secure-wrapper", "development", "production"],
+      "description": "Development branch - latest unreleased features",
+      "minCrewxVersion": "0.1.8",
+      "maxCrewxVersion": null
+    }
+  }
+}

package/dist/providers/base-ai.provider.d.ts

@@ -1,50 +0,0 @@
-import { Logger } from '@nestjs/common';
-import { AIProvider, AIQueryOptions, AIResponse } from '@sowonai/crewx-sdk';
-import { ToolCallService } from '../services/tool-call.service';
-export declare abstract class BaseAIProvider implements AIProvider {
-    abstract readonly name: string;
-    protected readonly logger: Logger;
-    protected toolCallService?: ToolCallService;
-    private readonly logsDir;
-    private cachedPath;
-    protected readonly timeoutConfig: import("@sowonai/crewx-sdk").TimeoutConfig;
-    constructor(loggerContext: string);
-    protected abstract getCliCommand(): string;
-    protected abstract getDefaultArgs(): string[];
-    protected abstract getExecuteArgs(): string[];
-    protected abstract getNotInstalledMessage(): string;
-    protected getPromptInArgs(): boolean;
-    protected getDefaultQueryTimeout(): number;
-    protected getDefaultExecuteTimeout(): number;
-    protected getDefaultModel(): string | null;
-    protected getEnv(): Record<string, string>;
-    protected substituteModelPlaceholders(args: string[], model: string): string[];
-    protected setToolCallService(toolCallService: ToolCallService): void;
-    protected parseToolUse(content: string): {
-        isToolUse: boolean;
-        toolName?: string;
-        toolInput?: any;
-    };
-    protected parseToolUseProviderSpecific(parsed: any): {
-        isToolUse: boolean;
-        toolName?: string;
-        toolInput?: any;
-    };
-    protected filterToolUseFromResponse(content: string): string;
-    parseProviderError(stderr: string, stdout: string): {
-        error: boolean;
-        message: string;
-    };
-    getToolPath(): Promise<string | null>;
-    protected wrapUserQueryWithSecurity(userQuery: string, securityKey: string): string;
-    protected extractUserQuery(wrappedQuery: string, securityKey: string): string;
-    isAvailable(): Promise<boolean>;
-    private createTaskLogFile;
-    private appendTaskLog;
-    query(prompt: string, options?: AIQueryOptions): Promise<AIResponse>;
-    execute(prompt: string, options?: AIQueryOptions): Promise<AIResponse>;
-    protected shouldPipeContext(_options?: AIQueryOptions): boolean;
-    private buildPipedContext;
-    protected isStructuredPayload(value: string): boolean;
-    protected createStructuredPayload(prompt: string, context: string | null, options?: AIQueryOptions): string;
-}