@ebowwa/glm-daemon 0.1.0

package/README.md

@@ -0,0 +1,264 @@
+# @ebowwa/glm-daemon
+
+Autonomous GLM 4.7 agent daemon with hooks, tools, and teammates.
+
+## Overview
+
+GLM Daemon is an autonomous AI agent daemon powered by GLM 4.7. It implements the **SLAM pattern** (State → Loop → Action → Memory) for relentless task execution, similar to Ralph Iterative but with GLM as the LLM backend.
+
+### Features
+
+- **GLM 4.7 Integration**: Uses `@ebowwa/ai` for GLM 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/glm-daemon
+```
+
+## Quick Start
+
+```typescript
+import { startGLMDaemon } from "@ebowwa/glm-daemon";
+
+const teamName = await startGLMDaemon(
+  {
+    teamName: "my-glm-agent",
+    cwd: process.cwd(),
+    model: "glm-4.7",
+    enableWorktree: true,
+    autoCommit: true,
+    completionPromise: "TASK_COMPLETE",
+  },
+  "Build a REST API for user authentication"
+);
+
+console.log(`GLM 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

package/dist/agent.d.ts

@@ -0,0 +1,37 @@
+/**
+ * GLM Agent - Individual GLM-powered agent
+ *
+ * Wraps GLM 4.7 API with tool access and hook integration.
+ */
+import type { GLMAgentConfig, GLMToolResult } from "./types.js";
+export declare class GLMAgent {
+    private config;
+    private client;
+    private tools;
+    constructor(config: GLMAgentConfig);
+    /**
+     * Execute a prompt and get response
+     */
+    execute(prompt: string, tools?: Record<string, unknown>): Promise<string>;
+    /**
+     * Execute a tool call
+     */
+    executeTool(toolName: string, args: unknown): Promise<GLMToolResult>;
+    /**
+     * Register a tool
+     */
+    registerTool(name: string, handler: (args: unknown) => Promise<unknown>): void;
+    /**
+     * Get available tools
+     */
+    getAvailableTools(): string[];
+    /**
+     * Get agent ID
+     */
+    get agentId(): string;
+    /**
+     * Get agent name
+     */
+    get name(): string;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhE,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,KAAK,CAA+D;gBAEhE,MAAM,EAAE,cAAc;IAKlC;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IA6B/E;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC;IA4B1E;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI;IAI9E;;OAEG;IACH,iBAAiB,IAAI,MAAM,EAAE;IAI7B;;OAEG;IACH,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/agent.js

@@ -0,0 +1,97 @@
+/**
+ * GLM Agent - Individual GLM-powered agent
+ *
+ * Wraps GLM 4.7 API with tool access and hook integration.
+ */
+import { GLMClient } from "@ebowwa/ai/client";
+export class GLMAgent {
+    config;
+    client;
+    tools = new Map();
+    constructor(config) {
+        this.config = config;
+        this.client = new GLMClient();
+    }
+    /**
+     * Execute a prompt and get response
+     */
+    async execute(prompt, tools) {
+        const messages = [
+            {
+                role: "system",
+                content: this.config.prompt,
+            },
+            {
+                role: "user",
+                content: prompt,
+            },
+        ];
+        // Add tool context if provided
+        if (tools) {
+            messages.push({
+                role: "user",
+                content: `\nAvailable tools: ${Object.keys(tools).join(", ")}`,
+            });
+        }
+        const response = await this.client.chatCompletion(messages, {
+            model: this.config.model || "glm-4.7",
+            temperature: this.config.temperature || 0.7,
+            maxTokens: this.config.maxTokens || 4096,
+        });
+        return response.choices[0]?.message?.content || "";
+    }
+    /**
+     * Execute a tool call
+     */
+    async executeTool(toolName, args) {
+        const start = Date.now();
+        const tool = this.tools.get(toolName);
+        if (!tool) {
+            return {
+                success: false,
+                error: `Tool not found: ${toolName}`,
+                duration: Date.now() - start,
+            };
+        }
+        try {
+            const result = await tool(args);
+            return {
+                success: true,
+                result,
+                duration: Date.now() - start,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+                duration: Date.now() - start,
+            };
+        }
+    }
+    /**
+     * Register a tool
+     */
+    registerTool(name, handler) {
+        this.tools.set(name, handler);
+    }
+    /**
+     * Get available tools
+     */
+    getAvailableTools() {
+        return Array.from(this.tools.keys());
+    }
+    /**
+     * Get agent ID
+     */
+    get agentId() {
+        return this.config.agentId;
+    }
+    /**
+     * Get agent name
+     */
+    get name() {
+        return this.config.name;
+    }
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

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

package/dist/daemon.d.ts

@@ -0,0 +1,91 @@
+/**
+ * GLM Daemon - Core Daemon
+ *
+ * Main orchestrator for autonomous GLM 4.7 agents.
+ * Implements SLAM pattern: State → Loop → Action → Memory
+ */
+import type { GLMDaemonConfig, GLMDaemonStatus } from "./types.js";
+export declare class GLMDaemon {
+    private config;
+    private state;
+    private statePath;
+    private agent;
+    private hooks;
+    private tools;
+    private stateManager;
+    private worktreeManager;
+    private team;
+    private subagents;
+    private running;
+    private client;
+    constructor(config: GLMDaemonConfig);
+    /**
+     * Initialize daemon state
+     */
+    private initializeState;
+    /**
+     * Build system prompt from config and state
+     */
+    private buildSystemPrompt;
+    /**
+     * Start the daemon with a prompt
+     */
+    start(prompt: string): Promise<string>;
+    /**
+     * Main daemon loop (SLAM pattern)
+     */
+    private runLoop;
+    /**
+     * Execute current SLAM phase
+     */
+    private executePhase;
+    /**
+     * Planning phase - break down task into subtasks
+     */
+    private phasePlanning;
+    /**
+     * Executing phase - work on current subtask
+     */
+    private phaseExecuting;
+    /**
+     * Paranoid phase - quality check after every edit
+     */
+    private phaseParanoid;
+    /**
+     * Reviewing phase - final quality review
+     */
+    private phaseReviewing;
+    /**
+     * Fixing phase - fix issues found
+     */
+    private phaseFixing;
+    /**
+     * Committing phase - commit changes
+     */
+    private phaseCommitting;
+    /**
+     * Complete the daemon run
+     */
+    private complete;
+    /**
+     * Stop the daemon
+     */
+    stop(): Promise<void>;
+    /**
+     * Get daemon status
+     */
+    getStatus(): GLMDaemonStatus;
+    /**
+     * Parse subtasks from agent response
+     */
+    private parseSubtasks;
+    /**
+     * Detect issues in paranoid check response
+     */
+    private detectIssues;
+    /**
+     * Check if completion promise is met
+     */
+    private checkCompletion;
+}
+//# sourceMappingURL=daemon.d.ts.map

package/dist/daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../src/daemon.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,eAAe,EAGf,eAAe,EAChB,MAAM,YAAY,CAAC;AAYpB,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAY;gBAEd,MAAM,EAAE,eAAe;IAwBnC;;OAEG;IACH,OAAO,CAAC,eAAe;IAiDvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAqBzB;;OAEG;IACG,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqC5C;;OAEG;YACW,OAAO;IAoCrB;;OAEG;YACW,YAAY;IA4B1B;;OAEG;YACW,aAAa;IAsB3B;;OAEG;YACW,cAAc;IA0C5B;;OAEG;YACW,aAAa;IA4B3B;;OAEG;YACW,cAAc;IAwB5B;;OAEG;YACW,WAAW;IAazB;;OAEG;YACW,eAAe;IAc7B;;OAEG;YACW,QAAQ;IAoBtB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAa3B;;OAEG;IACH,SAAS,IAAI,eAAe;IAe5B;;OAEG;IACH,OAAO,CAAC,aAAa;IAgCrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAUpB;;OAEG;IACH,OAAO,CAAC,eAAe;CASxB"}