@ebowwa/daemons 0.5.0

package/README.md

@@ -0,0 +1,264 @@
+# @ebowwa/daemons
+
+Autonomous agent daemon framework with hooks, tools, and teammates.
+
+## Overview
+
+Daemons is an autonomous AI agent daemon framework. It implements the **SLAM pattern** (State → Loop → Action → Memory) for relentless task execution.
+
+### Features
+
+- **AI Integration**: Uses `@ebowwa/ai` for LLM API calls
+- **SLAM Pattern**: State → Loop → Action → Memory execution model
+- **Hook System**: Pre/post tool use, subagent lifecycle, iteration events
+- **Tool Access**: MCP server integration for tool execution
+- **Multi-Agent Coordination**: Uses `@ebowwa/teammates` for parallel execution
+- **Git Worktree Isolation**: Parallel task execution in isolated environments
+- **State Persistence**: Crash recovery with JSON state files
+
+## Installation
+
+```bash
+bun add @ebowwa/daemons
+```
+
+## Quick Start
+
+```typescript
+import { startDaemon } from "@ebowwa/daemons";
+
+const teamName = await startDaemon(
+  {
+    teamName: "my-agent",
+    cwd: process.cwd(),
+    model: "glm-4.7",
+    enableWorktree: true,
+    autoCommit: true,
+    completionPromise: "TASK_COMPLETE",
+  },
+  "Build a REST API for user authentication"
+);
+
+console.log(`Daemon started: ${teamName}`);
+```
+
+## Architecture
+
+### SLAM Pattern
+
+GLM Daemon follows the SLAM pattern for autonomous execution:
+
+```
+State → Loop → Action → Memory
+```
+
+**Phases:**
+1. **Planning** - Break task into subtasks
+2. **Executing** - Work on current subtask
+3. **Paranoid** - Quality check after every edit
+4. **Reviewing** - Final quality review
+5. **Fixing** - Fix issues found
+6. **Committing** - Commit changes
+7. **Complete** - Task finished
+
+### State File
+
+State is persisted to `.glm-daemon.json` in the working directory:
+
+```json
+{
+  "prompt": "the original task",
+  "promise": "TASK_COMPLETE",
+  "iteration": 0,
+  "maxIterations": 0,
+  "startTime": "2026-02-06T04:30:00.000Z",
+  "lastUpdate": "2026-02-06T04:30:00.000Z",
+  "tokens": {
+    "totalInput": 0,
+    "totalOutput": 0
+  },
+  "slam": {
+    "enabled": true,
+    "phase": "planning",
+    "subtasks": [],
+    "currentSubtask": null,
+    "completedSubtasks": []
+  },
+  "git": {
+    "enabled": true,
+    "autoCommit": true,
+    "autoPR": false
+  }
+}
+```
+
+## Configuration
+
+```typescript
+interface GLMDaemonConfig {
+  teamName: string;           // Team name for coordination
+  model?: string;             // GLM model (default: glm-4.7)
+  cwd: string;                // Working directory
+  enableWorktree?: boolean;   // Git worktree isolation
+  autoCommit?: boolean;       // Auto-commit changes
+  autoPR?: boolean;           // Auto-create PR
+  baseBranch?: string;        // Base branch for PR
+  maxIterations?: number;      // Max iterations (0 = unlimited)
+  completionPromise?: string;  // Completion text
+  hooks?: GLMHooksConfig;     // Hook configuration
+  tools?: GLMToolsConfig;     // Tool configuration
+}
+```
+
+## Hooks
+
+Configure hooks for lifecycle events:
+
+```typescript
+const daemon = await createGLMDaemon({
+  teamName: "my-agent",
+  cwd: process.cwd(),
+  hooks: {
+    onSessionStart: async (state) => {
+      console.log("Session starting:", state.prompt);
+    },
+    onPreToolUse: async (tool, args) => {
+      console.log("Using tool:", tool);
+      return true; // Allow tool use
+    },
+    onIterationEnd: async (iteration, result) => {
+      console.log("Iteration complete:", iteration);
+    },
+  },
+});
+```
+
+Available hooks:
+- `onSessionStart` - Session begins
+- `onSessionEnd` - Session ends
+- `onPreToolUse` - Before tool use (can block)
+- `onPostToolUse` - After tool use
+- `onSubagentStart` - Subagent spawns
+- `onSubagentStop` - Subagent stops
+- `onIterationStart` - Iteration begins
+- `onIterationEnd` - Iteration ends
+
+## Tools
+
+GLM Daemon integrates with MCP servers for tool access:
+
+```typescript
+const daemon = await createGLMDaemon({
+  teamName: "my-agent",
+  cwd: process.cwd(),
+  tools: {
+    enableMCP: true,
+    allowedTools: ["Read", "Write", "Edit", "Bash"],
+    toolTimeout: 30000,
+    maxRetries: 3,
+  },
+});
+```
+
+## Multi-Agent Coordination
+
+GLM Daemon uses `@ebowwa/teammates` for multi-agent coordination:
+
+```typescript
+import { Team, Teammate } from "@ebowwa/teammates";
+
+const team = await Team.create({
+  name: "my-team",
+  description: "Build a REST API",
+});
+
+const explorer = await Teammate.create("my-team", {
+  name: "explorer",
+  subagentType: "Explore",
+  prompt: "Explore the codebase",
+  model: "glm-4.7",
+});
+
+await explorer.sendTo("team-lead", "Found 50 TypeScript files");
+```
+
+## Git Worktree Isolation
+
+For parallel task execution, use git worktrees:
+
+```typescript
+const daemon = await createGLMDaemon({
+  teamName: "my-agent",
+  cwd: process.cwd(),
+  enableWorktree: true,
+  autoCommit: true,
+});
+
+// Creates worktree at: worktrees/glm-1234567890/
+// Creates feature branch: feat/glm-1234567890
+```
+
+## API Reference
+
+### Classes
+
+#### `GLMDaemon`
+
+Main daemon orchestrator.
+
+**Methods:**
+- `start(prompt: string)` - Start daemon with a prompt
+- `stop()` - Stop the daemon
+- `getStatus()` - Get current status
+
+#### `GLMAgent`
+
+Individual GLM-powered agent.
+
+**Methods:**
+- `execute(prompt: string)` - Execute a prompt
+- `executeTool(toolName: string, args)` - Execute a tool
+- `registerTool(name, handler)` - Register a tool
+
+#### `HookSystem`
+
+Hook lifecycle management.
+
+**Methods:**
+- `register(event, handler)` - Register a hook
+- `execute(event, ...args)` - Execute hooks for event
+- `clear(event)` - Clear hooks for event
+
+#### `ToolBridge`
+
+MCP tool integration.
+
+**Methods:**
+- `getAvailableTools()` - Get available tools
+- `isToolAllowed(toolName)` - Check if tool is allowed
+- `executeTool(toolName, args)` - Execute a tool
+
+#### `StateManager`
+
+State persistence.
+
+**Methods:**
+- `load()` - Load state from disk
+- `save(state)` - Save state to disk
+- `update(updates)` - Update state (merge)
+- `delete()` - Delete state file
+
+#### `WorktreeManager`
+
+Git worktree isolation.
+
+**Methods:**
+- `createWorktree()` - Create a new worktree
+- `createBranch()` - Create a feature branch
+- `commitChanges(options)` - Commit changes
+- `createPullRequest(options)` - Create PR
+- `cleanup()` - Clean up worktree
+
+## License
+
+MIT