@sylix/coworker 1.5.3 → 2.0.0

package/README.md

@@ -1,191 +1,84 @@
-# CoWorker by Sylix
+# CoWorker by Sylix (Vision 2.0)
 
-A powerful AI-powered CLI coding assistant that runs in your terminal.
+A powerful, production-grade AI-powered CLI coding assistant with Claude Code parity.
 
-![CoWorker Banner](https://img.shields.io/badge/CoWorker-Sylix-cyan)
+![CoWorker Banner](https://img.shields.io/badge/CoWorker-v2.0.0-cyan)
+![Vision 2.0](https://img.shields.io/badge/Vision%202.0-Ready-green)
 
-## Features
+## 🚀 Vision 2.0 Features
 
-- **Ask**: Query your codebase with natural language questions
-- **Explain**: Get clear explanations of any file's purpose and structure
-- **Edit**: AI-assisted file editing with diff preview and confirmation
-- **Run**: Execute tasks with intelligent command suggestions
-- **Config**: Easy configuration management for your Sylix API credentials
+CoWorker v2.0 is a major upgrade introducing enterprise-grade agentic capabilities:
 
-## Installation
+- **Hook Engine (20+ Events)**: Deeply instrumented lifecycle with Command, HTTP, and Prompt handlers.
+- **SQLite Session Persistence**: Robust message storage with forking, archiving, and full-text search.
+- **2-Phase Compaction**: Intelligent context management that preserves recent history while summarizing older tool outputs.
+- **Subagent System**: Tiered agent architecture (`explore`, `plan`, `review`) with scoped toolsets and permission modes.
+- **Auto Memory**: Persistent cross-session learnings that automatically inject project-specific knowledge.
+- **LSP Integration**: Real-time code navigation via Language Server Protocol (Definition/References).
+- **Premium UX**: High-fidelity terminal output with `<thinking>` tag support, animated status indicators, and custom themes.
 
-### Prerequisites
-
-- Node.js 18 or higher
-- npm or yarn
-- Sylix API access
+## 🛠 Installation
 
-### Install Dependencies
+### Prerequisites
+- Node.js 18 or higher (v20 recommended)
+- Git (for snapshot/undo support)
+- SQLite (included via `better-sqlite3`)
 
+### Setup
 ```bash
+git clone https://github.com/sylix/coworker
 cd coworker
 npm install
-```
-
-### Build
-
-```bash
 npm run build
-```
-
-### Global Installation (Optional)
-
-To use `coworker` command anywhere:
-
-```bash
 npm link
 ```
 
-## Configuration
-
-Before using CoWorker, configure your Sylix API credentials:
-
-```bash
-coworker config init
-```
-
-You'll be prompted for:
-- **Base URL**: Your Sylix API endpoint (default: `https://api.sylix.ai`)
-- **API Key**: Your Sylix API key
-- **Default Model**: Model to use (default: `sylix-4`)
-
-To view your current configuration:
-
-```bash
-coworker config show
-```
-
-## Usage
-
-### Ask a Question
-
-Ask questions about your codebase with context awareness:
+## ⌨️ Usage
 
+### Interactive Chat (REPL)
+Start the agent in your current workspace:
 ```bash
-coworker ask "What does the authentication module do?"
+coworker
 ```
 
-```bash
-coworker ask "How can I optimize the database queries in this project?"
-```
-
-### Explain a File
+### Protocol Modes
+- `/explore <query>`: Read-only exploration mode (mutations blocked).
+- `/plan <task>`: Strict planning mode (enforces `TodoWrite` before execution).
 
-Get detailed explanations of any file:
+### Slash Commands
+- `/sessions`: Search, fork, or resume previous conversations.
+- `/memory`: Manage persistent project learnings and auto-extracted facts.
+- `/context`: View real-time token usage and compaction status.
+- `/undo`: Revert the last code modification via snapshotting.
+- `/config`: Quick access to model, theme, and effort settings.
 
-```bash
-coworker explain src/api/sylix.ts
-```
-
-```bash
-coworker explain package.json
-```
-
-### Edit a File
-
-AI-assisted editing with diff preview:
-
-```bash
-coworker edit src/utils/helper.ts "Add input validation to the parseConfig function"
-```
-
-```bash
-coworker edit app.js "Convert the callback-based function to use async/await"
-```
-
-### Run a Task
-
-Execute tasks with command suggestions:
-
-```bash
-coworker run "Set up a new React component library"
-```
-
-```bash
-coworker run "Run all tests and show me the results"
-```
-
-The assistant will suggest commands and ask for confirmation before executing them.
-
-## Project Structure
+## 📁 Project Structure
 
 ```
 coworker/
 ├── src/
-│   ├── cli.ts              # Main CLI entry point
-│   ├── api/
-│   │   └── sylix.ts        # Sylix API client
-│   ├── context/
-│   │   └── reader.ts       # Context reader for codebase
-│   ├── commands/
-│   │   ├── ask.ts          # Ask command implementation
-│   │   ├── edit.ts         # Edit command implementation
-│   │   ├── explain.ts      # Explain command implementation
-│   │   ├── run.ts          # Run command implementation
-│   │   └── config.ts       # Config commands
-│   └── utils/
-│       └── output.ts       # Output formatting utilities
-├── package.json
-├── tsconfig.json
-└── README.md
-```
-
-## API Configuration
-
-The configuration is stored at `~/.coworker/config.json`:
-
-```json
-{
-  "baseUrl": "https://api.sylix.ai",
-  "apiKey": "your-api-key",
-  "defaultModel": "sylix-4"
-}
-```
-
-## Development
-
-### Run in Development Mode
-
-```bash
-npm run dev -- ask "What does this project do?"
-```
-
-### Build
-
-```bash
-npm run build
-```
-
-## Output Formatting
-
-CoWorker provides beautifully formatted terminal output:
-
-- **Cyan** - Branding and headers
-- **Green** - Success messages
-- **Red** - Errors
-- **Yellow** - Warnings
-- **Code blocks** - Syntax highlighted with line numbers
-- **Spinners** - Loading indicators for async operations
-
-## Security
-
-- API keys are stored locally in `~/.coworker/config.json`
-- Never commit your config file to version control
-- The config file path respects your home directory across platforms
-
-## License
-
-MIT License - Copyright (c) Sylix
-
-## Support
-
-For issues and feature requests, please visit the [GitHub repository](https://github.com/sylix/coworker).
+│   ├── core/               # Agentic Loop & Context Reader
+│   ├── hooks/              # HookEngine (Event Bus)
+│   ├── session/            # SQLite Session Management
+│   ├── agents/             # Subagent Loader & Runner
+│   ├── permissions/        # Mode-based Permission Interceptor
+│   ├── tools/              # Native Tools (Bash, Write, LSP, etc.)
+│   ├── memory/             # Persistent Auto Memory
+│   └── utils/              # Premium UI & Stream Rendering
+├── .coworker/
+│   ├── agents/             # Custom Agent Definitions (.md)
+│   └── skills/             # Reusable Agent Skills
+└── package.json
+```
+
+## 🛡 Security & Permissions
+CoWorker implements a multi-layer permission system:
+1. **Consent Mode**: Always asks before executing destructive commands (Bash, Edit).
+2. **Read-Only Mode**: Activated via `/explore`.
+3. **Environment Isolation**: Support for sandboxed browser execution.
+
+## 📄 License
+MIT License - Copyright (c) 2026 Sylix
 
 ---
-
-**CoWorker by Sylix** - Your AI pair programmer in the terminal.
+**CoWorker by Sylix** — The ultimate open-source alternative to Claude Code.

package/dist/agents/SubagentLoader.d.ts

@@ -0,0 +1,59 @@
+export interface SubagentDefinition {
+    name: string;
+    description: string;
+    /** Allowlist of tools this agent can use */
+    tools?: string[];
+    /** Denylist of tools this agent cannot use */
+    disallowedTools?: string[];
+    /** Model to use (overrides default) */
+    model?: string;
+    /** Maximum LLM turns before stopping */
+    maxTurns: number;
+    /** Permission mode for this agent */
+    permissionMode?: 'default' | 'plan' | 'auto';
+    /** System prompt body (markdown after frontmatter) */
+    systemPrompt: string;
+    /** Source file path */
+    source: string;
+}
+/**
+ * Loads subagent definitions from .coworker/agents/*.md and built-in defaults.
+ */
+export declare class SubagentLoader {
+    private agents;
+    /**
+     * Scan both built-in and user-defined agent directories.
+     */
+    load(): Promise<void>;
+    private scanDirectory;
+    /**
+     * Parse a markdown file with YAML frontmatter into a SubagentDefinition.
+     *
+     * Expected format:
+     * ```
+     * ---
+     * name: explore
+     * description: Read-only codebase search
+     * tools: Read, Glob, Grep, LS
+     * model: helix-fast
+     * maxTurns: 15
+     * permissionMode: plan
+     * ---
+     * You are a fast codebase explorer...
+     * ```
+     */
+    private parseDefinition;
+    /**
+     * Get a specific agent definition by name.
+     */
+    get(name: string): SubagentDefinition | undefined;
+    /**
+     * Get all loaded agent definitions.
+     */
+    list(): SubagentDefinition[];
+    /**
+     * Check if an agent exists.
+     */
+    has(name: string): boolean;
+}
+//# sourceMappingURL=SubagentLoader.d.ts.map

package/dist/agents/SubagentLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubagentLoader.d.ts","sourceRoot":"","sources":["../../src/agents/SubagentLoader.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,8CAA8C;IAC9C,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,cAAc,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IAC7C,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;IACrB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAA8C;IAE5D;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAcb,aAAa;IAgB3B;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,eAAe;IA+BvB;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAIjD;;OAEG;IACH,IAAI,IAAI,kBAAkB,EAAE;IAI5B;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAG3B"}

package/dist/agents/SubagentLoader.js

@@ -0,0 +1,140 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubagentLoader = void 0;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+/**
+ * Loads subagent definitions from .coworker/agents/*.md and built-in defaults.
+ */
+class SubagentLoader {
+    constructor() {
+        this.agents = new Map();
+    }
+    /**
+     * Scan both built-in and user-defined agent directories.
+     */
+    async load() {
+        // 1. Load built-in defaults
+        const builtInDir = path.join(__dirname, 'defaults');
+        await this.scanDirectory(builtInDir);
+        // 2. Load user/project agents (can override built-ins)
+        const userDir = path.join(process.cwd(), '.coworker', 'agents');
+        await this.scanDirectory(userDir);
+        if (process.env.CW_VERBOSE) {
+            console.log(`[SubagentLoader] Loaded ${this.agents.size} agent definitions`);
+        }
+    }
+    async scanDirectory(dirPath) {
+        try {
+            const files = await fs.readdir(dirPath);
+            for (const file of files) {
+                if (!file.endsWith('.md'))
+                    continue;
+                const content = await fs.readFile(path.join(dirPath, file), 'utf8');
+                const def = this.parseDefinition(content, path.join(dirPath, file));
+                if (def) {
+                    this.agents.set(def.name, def);
+                }
+            }
+        }
+        catch {
+            // Directory doesn't exist — skip silently
+        }
+    }
+    /**
+     * Parse a markdown file with YAML frontmatter into a SubagentDefinition.
+     *
+     * Expected format:
+     * ```
+     * ---
+     * name: explore
+     * description: Read-only codebase search
+     * tools: Read, Glob, Grep, LS
+     * model: helix-fast
+     * maxTurns: 15
+     * permissionMode: plan
+     * ---
+     * You are a fast codebase explorer...
+     * ```
+     */
+    parseDefinition(content, source) {
+        const yamlMatch = content.match(/^---\n([\s\S]*?)\n---/);
+        if (!yamlMatch)
+            return null;
+        const rawYaml = yamlMatch[1];
+        const body = content.replace(yamlMatch[0], '').trim();
+        const get = (key) => {
+            const match = rawYaml.match(new RegExp(`^${key}:\\s*(.+)`, 'm'));
+            return match ? match[1].trim() : undefined;
+        };
+        const name = get('name');
+        if (!name)
+            return null;
+        const toolsStr = get('tools');
+        const disallowedStr = get('disallowedTools');
+        return {
+            name,
+            description: get('description') || `${name} subagent`,
+            tools: toolsStr ? toolsStr.split(',').map(t => t.trim()) : undefined,
+            disallowedTools: disallowedStr ? disallowedStr.split(',').map(t => t.trim()) : undefined,
+            model: get('model'),
+            maxTurns: parseInt(get('maxTurns') || '20', 10),
+            permissionMode: get('permissionMode') || 'default',
+            systemPrompt: body,
+            source,
+        };
+    }
+    /**
+     * Get a specific agent definition by name.
+     */
+    get(name) {
+        return this.agents.get(name);
+    }
+    /**
+     * Get all loaded agent definitions.
+     */
+    list() {
+        return Array.from(this.agents.values());
+    }
+    /**
+     * Check if an agent exists.
+     */
+    has(name) {
+        return this.agents.has(name);
+    }
+}
+exports.SubagentLoader = SubagentLoader;
+//# sourceMappingURL=SubagentLoader.js.map

package/dist/agents/SubagentLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubagentLoader.js","sourceRoot":"","sources":["../../src/agents/SubagentLoader.ts"],"names":[],"mappings":"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"}

package/dist/agents/SubagentRunner.d.ts

@@ -0,0 +1,15 @@
+import { SubagentDefinition } from './SubagentLoader';
+/**
+ * Result of a subagent execution.
+ */
+export interface SubagentResult {
+    output: string;
+    turnsUsed: number;
+    toolsCalled: string[];
+    success: boolean;
+}
+/**
+ * Run a scoped subagent with tool/model/turn restrictions.
+ */
+export declare function runSubagent(definition: SubagentDefinition, task: string, parentCwd?: string): Promise<SubagentResult>;
+//# sourceMappingURL=SubagentRunner.d.ts.map

package/dist/agents/SubagentRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubagentRunner.d.ts","sourceRoot":"","sources":["../../src/agents/SubagentRunner.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAStD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;CAClB;AAQD;;GAEG;AACH,wBAAsB,WAAW,CAC/B,UAAU,EAAE,kBAAkB,EAC9B,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,CAAC,CA4EzB"}

package/dist/agents/SubagentRunner.js

@@ -0,0 +1,116 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSubagent = runSubagent;
+const CoWorkerAgent_1 = require("../core/CoWorkerAgent");
+/**
+ * Tracks the current nesting depth to prevent infinite subagent recursion.
+ */
+let currentDepth = 0;
+const MAX_DEPTH = 1; // Subagents cannot spawn sub-subagents
+/**
+ * Run a scoped subagent with tool/model/turn restrictions.
+ */
+async function runSubagent(definition, task, parentCwd) {
+    if (currentDepth >= MAX_DEPTH) {
+        return {
+            output: '[SUBAGENT ERROR] Cannot spawn sub-subagents (max nesting depth reached).',
+            turnsUsed: 0,
+            toolsCalled: [],
+            success: false,
+        };
+    }
+    currentDepth++;
+    const result = {
+        output: '',
+        turnsUsed: 0,
+        toolsCalled: [],
+        success: true,
+    };
+    try {
+        // Create a scoped agent with the definition's settings
+        const options = {
+            model: definition.model || 'helix-1.2',
+            role: 'General',
+            cwd: parentCwd || process.cwd(),
+        };
+        const agent = new CoWorkerAgent_1.CoWorkerAgent(options);
+        await agent.boot();
+        // Apply permission mode
+        if (definition.permissionMode === 'plan') {
+            agent.permissions = new (await Promise.resolve().then(() => __importStar(require('../permissions/PermissionInterceptor')))).PermissionInterceptor({
+                mode: 'plan',
+            });
+        }
+        // Override system prompt with subagent-specific prompt
+        if (definition.systemPrompt) {
+            agent.systemPrompt = definition.systemPrompt +
+                `\n\n## Constraints\n` +
+                `- You are a ${definition.name} subagent\n` +
+                `- Max turns: ${definition.maxTurns}\n` +
+                (definition.tools ? `- You may ONLY use these tools: ${definition.tools.join(', ')}\n` : '') +
+                (definition.disallowedTools ? `- You may NOT use these tools: ${definition.disallowedTools.join(', ')}\n` : '') +
+                `- You CANNOT spawn sub-subagents\n` +
+                `- Stay focused on the task. Be concise in your responses.\n`;
+        }
+        // Execute with turn limiting
+        let turnCount = 0;
+        for await (const chunk of agent.chat(task)) {
+            result.output += chunk;
+            // Track tool calls by checking for the tool indicator
+            if (chunk.includes('◈')) {
+                turnCount++;
+                const toolMatch = chunk.match(/◈\s+(\S+)/);
+                if (toolMatch)
+                    result.toolsCalled.push(toolMatch[1]);
+            }
+            // Enforce max turns
+            if (turnCount >= definition.maxTurns) {
+                result.output += `\n[SUBAGENT] Reached max turns limit (${definition.maxTurns}). Stopping.`;
+                break;
+            }
+        }
+        result.turnsUsed = turnCount;
+    }
+    catch (e) {
+        result.output = `[SUBAGENT ERROR] ${e.message}`;
+        result.success = false;
+    }
+    finally {
+        currentDepth--;
+    }
+    return result;
+}
+//# sourceMappingURL=SubagentRunner.js.map

package/dist/agents/SubagentRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubagentRunner.js","sourceRoot":"","sources":["../../src/agents/SubagentRunner.ts"],"names":[],"mappings":"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"}

package/dist/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AA0VA,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAmLvD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AA+UA,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAmLvD"}

package/dist/cli/index.js

@@ -258,15 +258,6 @@ async function runInteractiveChat(agent, opts) {
             continue;
         }
         // ── Regular chat message ──
-        // Clear the input frame drawn by ask() (bottom border + status)
-        process.stdout.write('\x1b[1A\x1b[2K'); // clear status line
-        process.stdout.write('\x1b[1A\x1b[2K'); // clear bottom border
-        process.stdout.write('\x1b[1A\x1b[2K'); // clear input line
-        process.stdout.write('\x1b[1A\x1b[2K'); // clear top border
-        // Show user message above
-        console.log('');
-        console.log(`  ${output_1.theme.dim('you')}  ${output_1.theme.brand('\u203a')}  ${input}`);
-        console.log('');
         // Thinking animation
         const thinking = new output_1.ThinkingAnimation();
         thinking.start();