groove-dev 0.9.2 → 0.10.0

package/node_modules/@groove-dev/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@groove-dev/cli",
-  "version": "0.9.2",
+  "version": "0.10.0",
   "description": "GROOVE CLI — manage AI coding agents from your terminal",
   "license": "FSL-1.1-Apache-2.0",
   "type": "module",

package/node_modules/@groove-dev/daemon/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@groove-dev/daemon",
-  "version": "0.9.2",
+  "version": "0.10.0",
   "description": "GROOVE daemon — agent orchestration engine",
   "license": "FSL-1.1-Apache-2.0",
   "type": "module",

package/node_modules/@groove-dev/daemon/src/api.js

@@ -254,8 +254,9 @@ export function createApi(app, daemon) {
     }
   });
 
-  // Instruct an agent (rotation with user message appended)
-  // Works for both running agents (rotates with handoff) and dead agents (continues conversation)
+  // Instruct an agent — resumes session if possible, falls back to rotation
+  // Resume = zero cold-start (uses --resume SESSION_ID)
+  // Rotation = full handoff brief (only for degradation or no session)
   app.post('/api/agents/:id/instruct', async (req, res) => {
     try {
       const { message } = req.body;
@@ -264,9 +265,13 @@ export function createApi(app, daemon) {
       }
       const agent = daemon.registry.get(req.params.id);
       if (!agent) return res.status(404).json({ error: 'Agent not found' });
-      const newAgent = await daemon.rotator.rotate(req.params.id, {
-        additionalPrompt: message.trim(),
-      });
+
+      // Try session resume first (zero cold-start)
+      // Falls back to rotation if no session ID or provider doesn't support resume
+      const newAgent = agent.sessionId
+        ? await daemon.processes.resume(req.params.id, message.trim())
+        : await daemon.rotator.rotate(req.params.id, { additionalPrompt: message.trim() });
+
       res.json(newAgent);
     } catch (err) {
       res.status(400).json({ error: err.message });

package/node_modules/@groove-dev/daemon/src/process.js

@@ -194,6 +194,10 @@ For normal file edits within your scope, proceed without review.
         this.daemon.classifier.addEvent(agent.id, output);
 
         const updates = { lastActivity: new Date().toISOString() };
+        // Capture session_id for --resume support (zero cold-start continuation)
+        if (output.sessionId) {
+          updates.sessionId = output.sessionId;
+        }
         if (output.tokensUsed !== undefined && output.tokensUsed > 0) {
           const current = registry.get(agent.id);
           if (current) {
@@ -262,6 +266,135 @@ For normal file edits within your scope, proceed without review.
     return agent;
   }
 
+  /**
+   * Resume a completed agent's session with a new message.
+   * Uses --resume SESSION_ID for zero cold-start continuation.
+   * Falls back to full spawn if no session ID available.
+   */
+  async resume(agentId, message) {
+    const { registry, locks } = this.daemon;
+    const agent = registry.get(agentId);
+    if (!agent) throw new Error(`Agent ${agentId} not found`);
+
+    // If no session ID, fall back to rotation (handoff brief)
+    if (!agent.sessionId) {
+      return this.daemon.rotator.rotate(agentId, { additionalPrompt: message });
+    }
+
+    const provider = getProvider(agent.provider || 'claude-code');
+    if (!provider?.buildResumeCommand) {
+      return this.daemon.rotator.rotate(agentId, { additionalPrompt: message });
+    }
+
+    // Clean up old agent entry but keep the data we need
+    const config = { ...agent };
+    const sessionId = agent.sessionId;
+
+    // Kill if still running, or remove if dead
+    if (this.handles.has(agentId)) {
+      await this.kill(agentId);
+    } else {
+      locks.release(agentId);
+      registry.remove(agentId);
+    }
+
+    // Build resume command
+    const { command, args, env } = provider.buildResumeCommand(sessionId, message, config.model);
+
+    // Set up log capture
+    const logDir = resolve(this.daemon.grooveDir, 'logs');
+    mkdirSync(logDir, { recursive: true });
+    const logPath = resolve(logDir, `${sanitizeFilename(config.name)}.log`);
+    const logStream = createWriteStream(logPath, { flags: 'a', mode: 0o600 });
+
+    const resumeLine = `[${new Date().toISOString()}] GROOVE resuming session: ${command} --resume ${sessionId}\n`;
+    logStream.write(resumeLine);
+
+    // Re-register in registry with same name
+    const newAgent = registry.add({
+      role: config.role,
+      scope: config.scope,
+      provider: config.provider,
+      model: config.model,
+      prompt: config.prompt,
+      permission: config.permission,
+      workingDir: config.workingDir,
+      name: config.name,
+    });
+
+    // Carry cumulative tokens
+    if (config.tokensUsed > 0) {
+      registry.update(newAgent.id, { tokensUsed: config.tokensUsed });
+    }
+
+    // Re-register locks
+    if (newAgent.scope && newAgent.scope.length > 0) {
+      locks.register(newAgent.id, newAgent.scope);
+    }
+
+    // Spawn the resumed process
+    const proc = cpSpawn(command, args, {
+      cwd: config.workingDir || this.daemon.projectDir,
+      env: { ...process.env, ...env, GROOVE_AGENT_ID: newAgent.id, GROOVE_AGENT_NAME: newAgent.name },
+      stdio: ['ignore', 'pipe', 'pipe'],
+      detached: false,
+    });
+
+    if (!proc.pid) {
+      registry.remove(newAgent.id);
+      locks.release(newAgent.id);
+      logStream.end();
+      throw new Error(`Failed to resume — process has no PID`);
+    }
+
+    this.handles.set(newAgent.id, { proc, logStream });
+    registry.update(newAgent.id, { status: 'running', pid: proc.pid });
+
+    // Same stdout/stderr/exit handling as spawn
+    proc.stdout.on('data', (chunk) => {
+      logStream.write(chunk);
+      const output = provider.parseOutput(chunk.toString());
+      if (output) {
+        this.daemon.classifier.addEvent(newAgent.id, output);
+        const updates = { lastActivity: new Date().toISOString() };
+        if (output.sessionId) updates.sessionId = output.sessionId;
+        if (output.tokensUsed !== undefined && output.tokensUsed > 0) {
+          const current = registry.get(newAgent.id);
+          if (current) {
+            updates.tokensUsed = current.tokensUsed + output.tokensUsed;
+            this.daemon.tokens.record(newAgent.id, output.tokensUsed);
+          }
+        }
+        if (output.contextUsage !== undefined) updates.contextUsage = output.contextUsage;
+        registry.update(newAgent.id, updates);
+        this.daemon.broadcast({ type: 'agent:output', agentId: newAgent.id, data: output });
+      }
+    });
+
+    proc.stderr.on('data', (chunk) => { logStream.write(`[stderr] ${chunk}`); });
+
+    proc.on('exit', (code, signal) => {
+      logStream.write(`[${new Date().toISOString()}] Process exited: code=${code} signal=${signal}\n`);
+      logStream.end();
+      this.handles.delete(newAgent.id);
+      const finalStatus = signal === 'SIGTERM' || signal === 'SIGKILL' ? 'killed' : code === 0 ? 'completed' : 'crashed';
+      registry.update(newAgent.id, { status: finalStatus, pid: null });
+      this.daemon.broadcast({ type: 'agent:exit', agentId: newAgent.id, code, signal, status: finalStatus });
+      if (finalStatus === 'completed' && this.daemon.journalist) {
+        this.daemon.journalist.cycle().catch(() => {});
+      }
+    });
+
+    proc.on('error', (err) => {
+      logStream.write(`[error] ${err.message}\n`);
+      logStream.end();
+      this.handles.delete(newAgent.id);
+      registry.update(newAgent.id, { status: 'crashed', pid: null });
+    });
+
+    return newAgent;
+  }
+
   async kill(agentId) {
     const handle = this.handles.get(agentId);
 

package/node_modules/@groove-dev/daemon/src/providers/claude-code.js

@@ -61,6 +61,15 @@ export class ClaudeCodeProvider extends Provider {
     };
   }
 
+  buildResumeCommand(sessionId, prompt, model) {
+    // Resume a previous session — preserves full conversation history
+    // No cold start, no handoff brief needed
+    const args = ['--resume', sessionId, '--output-format', 'stream-json', '--verbose', '--dangerously-skip-permissions'];
+    if (model) args.push('--model', model);
+    if (prompt) args.push(prompt);
+    return { command: 'claude', args, env: {} };
+  }
+
   buildHeadlessCommand(prompt, model) {
     const args = ['-p', prompt, '--output-format', 'stream-json', '--verbose'];
     if (model) args.push('--model', model);
@@ -109,6 +118,11 @@ export class ClaudeCodeProvider extends Provider {
       try {
         const data = JSON.parse(l);
 
+        // Capture session_id for --resume support
+        if (data.session_id) {
+          events.push({ type: 'session', sessionId: data.session_id });
+        }
+
         if (data.type === 'assistant') {
           events.push({
             type: 'activity',

package/node_modules/@groove-dev/daemon/src/registry.js

@@ -48,7 +48,7 @@ export class Registry extends EventEmitter {
     if (!agent) return null;
 
     // Only allow known fields to prevent prototype pollution
-    const SAFE_FIELDS = ['status', 'pid', 'tokensUsed', 'contextUsage', 'lastActivity', 'model', 'name', 'routingMode', 'routingReason'];
+    const SAFE_FIELDS = ['status', 'pid', 'tokensUsed', 'contextUsage', 'lastActivity', 'model', 'name', 'routingMode', 'routingReason', 'sessionId'];
     for (const key of Object.keys(updates)) {
       if (SAFE_FIELDS.includes(key)) {
         agent[key] = updates[key];

package/node_modules/@groove-dev/gui/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@groove-dev/gui",
-  "version": "0.9.2",
+  "version": "0.10.0",
   "description": "GROOVE GUI — visual agent control plane",
   "license": "FSL-1.1-Apache-2.0",
   "type": "module",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "groove-dev",
-  "version": "0.9.2",
+  "version": "0.10.0",
   "description": "Open-source agent orchestration layer for AI coding tools. GUI dashboard, multi-agent coordination, zero cold-start (Journalist), infinite sessions (adaptive context rotation), AI Project Manager, Quick Launch. Works with Claude Code, Codex, Gemini CLI, Ollama.",
   "license": "FSL-1.1-Apache-2.0",
   "author": "Groove Dev <hello@groovedev.ai> (https://groovedev.ai)",

package/packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@groove-dev/cli",
-  "version": "0.9.2",
+  "version": "0.10.0",
   "description": "GROOVE CLI — manage AI coding agents from your terminal",
   "license": "FSL-1.1-Apache-2.0",
   "type": "module",

package/packages/daemon/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@groove-dev/daemon",
-  "version": "0.9.2",
+  "version": "0.10.0",
   "description": "GROOVE daemon — agent orchestration engine",
   "license": "FSL-1.1-Apache-2.0",
   "type": "module",

package/packages/daemon/src/api.js

@@ -254,8 +254,9 @@ export function createApi(app, daemon) {
     }
   });
 
-  // Instruct an agent (rotation with user message appended)
-  // Works for both running agents (rotates with handoff) and dead agents (continues conversation)
+  // Instruct an agent — resumes session if possible, falls back to rotation
+  // Resume = zero cold-start (uses --resume SESSION_ID)
+  // Rotation = full handoff brief (only for degradation or no session)
   app.post('/api/agents/:id/instruct', async (req, res) => {
     try {
       const { message } = req.body;
@@ -264,9 +265,13 @@ export function createApi(app, daemon) {
       }
       const agent = daemon.registry.get(req.params.id);
       if (!agent) return res.status(404).json({ error: 'Agent not found' });
-      const newAgent = await daemon.rotator.rotate(req.params.id, {
-        additionalPrompt: message.trim(),
-      });
+
+      // Try session resume first (zero cold-start)
+      // Falls back to rotation if no session ID or provider doesn't support resume
+      const newAgent = agent.sessionId
+        ? await daemon.processes.resume(req.params.id, message.trim())
+        : await daemon.rotator.rotate(req.params.id, { additionalPrompt: message.trim() });
+
       res.json(newAgent);
     } catch (err) {
       res.status(400).json({ error: err.message });

package/packages/daemon/src/process.js

@@ -194,6 +194,10 @@ For normal file edits within your scope, proceed without review.
         this.daemon.classifier.addEvent(agent.id, output);
 
         const updates = { lastActivity: new Date().toISOString() };
+        // Capture session_id for --resume support (zero cold-start continuation)
+        if (output.sessionId) {
+          updates.sessionId = output.sessionId;
+        }
         if (output.tokensUsed !== undefined && output.tokensUsed > 0) {
           const current = registry.get(agent.id);
           if (current) {
@@ -262,6 +266,135 @@ For normal file edits within your scope, proceed without review.
     return agent;
   }
 
+  /**
+   * Resume a completed agent's session with a new message.
+   * Uses --resume SESSION_ID for zero cold-start continuation.
+   * Falls back to full spawn if no session ID available.
+   */
+  async resume(agentId, message) {
+    const { registry, locks } = this.daemon;
+    const agent = registry.get(agentId);
+    if (!agent) throw new Error(`Agent ${agentId} not found`);
+
+    // If no session ID, fall back to rotation (handoff brief)
+    if (!agent.sessionId) {
+      return this.daemon.rotator.rotate(agentId, { additionalPrompt: message });
+    }
+
+    const provider = getProvider(agent.provider || 'claude-code');
+    if (!provider?.buildResumeCommand) {
+      return this.daemon.rotator.rotate(agentId, { additionalPrompt: message });
+    }
+
+    // Clean up old agent entry but keep the data we need
+    const config = { ...agent };
+    const sessionId = agent.sessionId;
+
+    // Kill if still running, or remove if dead
+    if (this.handles.has(agentId)) {
+      await this.kill(agentId);
+    } else {
+      locks.release(agentId);
+      registry.remove(agentId);
+    }
+
+    // Build resume command
+    const { command, args, env } = provider.buildResumeCommand(sessionId, message, config.model);
+
+    // Set up log capture
+    const logDir = resolve(this.daemon.grooveDir, 'logs');
+    mkdirSync(logDir, { recursive: true });
+    const logPath = resolve(logDir, `${sanitizeFilename(config.name)}.log`);
+    const logStream = createWriteStream(logPath, { flags: 'a', mode: 0o600 });
+
+    const resumeLine = `[${new Date().toISOString()}] GROOVE resuming session: ${command} --resume ${sessionId}\n`;
+    logStream.write(resumeLine);
+
+    // Re-register in registry with same name
+    const newAgent = registry.add({
+      role: config.role,
+      scope: config.scope,
+      provider: config.provider,
+      model: config.model,
+      prompt: config.prompt,
+      permission: config.permission,
+      workingDir: config.workingDir,
+      name: config.name,
+    });
+
+    // Carry cumulative tokens
+    if (config.tokensUsed > 0) {
+      registry.update(newAgent.id, { tokensUsed: config.tokensUsed });
+    }
+
+    // Re-register locks
+    if (newAgent.scope && newAgent.scope.length > 0) {
+      locks.register(newAgent.id, newAgent.scope);
+    }
+
+    // Spawn the resumed process
+    const proc = cpSpawn(command, args, {
+      cwd: config.workingDir || this.daemon.projectDir,
+      env: { ...process.env, ...env, GROOVE_AGENT_ID: newAgent.id, GROOVE_AGENT_NAME: newAgent.name },
+      stdio: ['ignore', 'pipe', 'pipe'],
+      detached: false,
+    });
+
+    if (!proc.pid) {
+      registry.remove(newAgent.id);
+      locks.release(newAgent.id);
+      logStream.end();
+      throw new Error(`Failed to resume — process has no PID`);
+    }
+
+    this.handles.set(newAgent.id, { proc, logStream });
+    registry.update(newAgent.id, { status: 'running', pid: proc.pid });
+
+    // Same stdout/stderr/exit handling as spawn
+    proc.stdout.on('data', (chunk) => {
+      logStream.write(chunk);
+      const output = provider.parseOutput(chunk.toString());
+      if (output) {
+        this.daemon.classifier.addEvent(newAgent.id, output);
+        const updates = { lastActivity: new Date().toISOString() };
+        if (output.sessionId) updates.sessionId = output.sessionId;
+        if (output.tokensUsed !== undefined && output.tokensUsed > 0) {
+          const current = registry.get(newAgent.id);
+          if (current) {
+            updates.tokensUsed = current.tokensUsed + output.tokensUsed;
+            this.daemon.tokens.record(newAgent.id, output.tokensUsed);
+          }
+        }
+        if (output.contextUsage !== undefined) updates.contextUsage = output.contextUsage;
+        registry.update(newAgent.id, updates);
+        this.daemon.broadcast({ type: 'agent:output', agentId: newAgent.id, data: output });
+      }
+    });
+
+    proc.stderr.on('data', (chunk) => { logStream.write(`[stderr] ${chunk}`); });
+
+    proc.on('exit', (code, signal) => {
+      logStream.write(`[${new Date().toISOString()}] Process exited: code=${code} signal=${signal}\n`);
+      logStream.end();
+      this.handles.delete(newAgent.id);
+      const finalStatus = signal === 'SIGTERM' || signal === 'SIGKILL' ? 'killed' : code === 0 ? 'completed' : 'crashed';
+      registry.update(newAgent.id, { status: finalStatus, pid: null });
+      this.daemon.broadcast({ type: 'agent:exit', agentId: newAgent.id, code, signal, status: finalStatus });
+      if (finalStatus === 'completed' && this.daemon.journalist) {
+        this.daemon.journalist.cycle().catch(() => {});
+      }
+    });
+
+    proc.on('error', (err) => {
+      logStream.write(`[error] ${err.message}\n`);
+      logStream.end();
+      this.handles.delete(newAgent.id);
+      registry.update(newAgent.id, { status: 'crashed', pid: null });
+    });
+
+    return newAgent;
+  }
+
   async kill(agentId) {
     const handle = this.handles.get(agentId);
 

package/packages/daemon/src/providers/claude-code.js

@@ -61,6 +61,15 @@ export class ClaudeCodeProvider extends Provider {
     };
   }
 
+  buildResumeCommand(sessionId, prompt, model) {
+    // Resume a previous session — preserves full conversation history
+    // No cold start, no handoff brief needed
+    const args = ['--resume', sessionId, '--output-format', 'stream-json', '--verbose', '--dangerously-skip-permissions'];
+    if (model) args.push('--model', model);
+    if (prompt) args.push(prompt);
+    return { command: 'claude', args, env: {} };
+  }
+
   buildHeadlessCommand(prompt, model) {
     const args = ['-p', prompt, '--output-format', 'stream-json', '--verbose'];
     if (model) args.push('--model', model);
@@ -109,6 +118,11 @@ export class ClaudeCodeProvider extends Provider {
       try {
         const data = JSON.parse(l);
 
+        // Capture session_id for --resume support
+        if (data.session_id) {
+          events.push({ type: 'session', sessionId: data.session_id });
+        }
+
         if (data.type === 'assistant') {
           events.push({
             type: 'activity',

package/packages/daemon/src/registry.js

@@ -48,7 +48,7 @@ export class Registry extends EventEmitter {
     if (!agent) return null;
 
     // Only allow known fields to prevent prototype pollution
-    const SAFE_FIELDS = ['status', 'pid', 'tokensUsed', 'contextUsage', 'lastActivity', 'model', 'name', 'routingMode', 'routingReason'];
+    const SAFE_FIELDS = ['status', 'pid', 'tokensUsed', 'contextUsage', 'lastActivity', 'model', 'name', 'routingMode', 'routingReason', 'sessionId'];
     for (const key of Object.keys(updates)) {
       if (SAFE_FIELDS.includes(key)) {
         agent[key] = updates[key];

package/packages/gui/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@groove-dev/gui",
-  "version": "0.9.2",
+  "version": "0.10.0",
   "description": "GROOVE GUI — visual agent control plane",
   "license": "FSL-1.1-Apache-2.0",
   "type": "module",