tsunami-code 3.1.0 → 3.2.0

package/index.js

@@ -7,6 +7,8 @@ import os from 'os';
 import { agentLoop, quickCompletion, setModel, getModel, tokenStats } from './lib/loop.js';
 import { injectServerContext } from './lib/tools.js';
 import { loadSkills, getSkillCommand, createSkill, listSkills } from './lib/skills.js';
+import { isCoordinatorTask, stripCoordinatorPrefix, buildCoordinatorSystemPrompt } from './lib/coordinator.js';
+import { getDueTasks, markDone, cancelTask, listTasks, formatTaskList } from './lib/kairos.js';
 import { buildSystemPrompt } from './lib/prompt.js';
 import { runPreflight, checkServer } from './lib/preflight.js';
 import { setSession, undo, undoStackSize } from './lib/tools.js';
@@ -22,7 +24,7 @@ import {
   getSessionContext
 } from './lib/memory.js';
 
-const VERSION = '3.1.0';
+const VERSION = '3.2.0';
 const CONFIG_DIR = join(os.homedir(), '.tsunami-code');
 const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
 const DEFAULT_SERVER = 'https://radiometric-reita-amuck.ngrok-free.dev';
@@ -223,6 +225,31 @@ async function run() {
     dim(` · ${sessionId} · Type your task. /help for commands. Ctrl+C to exit.\n`)
   );
 
+  // KAIROS: run due background tasks on startup
+  const dueTasks = getDueTasks();
+  if (dueTasks.length > 0) {
+    console.log(yellow(`  ⏰ KAIROS: ${dueTasks.length} background task(s) due\n`));
+    for (const task of dueTasks) {
+      console.log(dim(`  Running: ${task.prompt.slice(0, 80)}...\n`));
+      const kairosMessages = [
+        { role: 'system', content: buildSystemPrompt() },
+        { role: 'user', content: `[KAIROS background task]\n${task.prompt}` }
+      ];
+      try {
+        await agentLoop(serverUrl, kairosMessages,
+          (t) => process.stdout.write(t),
+          () => {},
+          { sessionDir, cwd, planMode: false },
+          null, 10
+        );
+        markDone(task.id);
+        process.stdout.write('\n\n');
+      } catch (e) {
+        console.log(red(`  KAIROS task failed: ${e.message}\n`));
+      }
+    }
+  }
+
   // Load last session summary if available
   const lastSessionSummary = getLastSessionSummary(cwd);
 
@@ -543,6 +570,19 @@ async function run() {
         case 'memory':
           await handleMemoryCommand(rest);
           break;
+        case 'kairos': {
+          const sub = rest[0];
+          if (!sub || sub === 'list') {
+            console.log(blue('\n  KAIROS Scheduled Tasks\n'));
+            console.log(dim(formatTaskList(listTasks()) + '\n'));
+          } else if (sub === 'cancel' && rest[1]) {
+            cancelTask(rest[1]);
+            console.log(green(`  Cancelled: ${rest[1]}\n`));
+          } else {
+            console.log(dim('  Usage: /kairos [list|cancel <id>]\n'));
+          }
+          break;
+        }
         case 'skills':
         case 'skill-list':
           console.log(dim('\n' + listSkills(skills) + '\n'));
@@ -580,13 +620,23 @@ async function run() {
       userContent = `[Previous session summary]\n${lastSessionSummary}\n\n---\n\n${line}`;
     }
 
-    // Frustration injection — tell the model to acknowledge and course-correct
+    // Frustration injection
     if (detectFrustration(line)) {
       userContent += '\n\n[system: User appears frustrated. Acknowledge the issue directly, do not repeat the same approach. Be concise and action-focused.]';
     }
 
+    // Coordinator mode — use special system prompt that instructs parallel worker routing
+    let activeSystemPrompt = systemPrompt;
+    let coordinatorActive = false;
+    if (isCoordinatorTask(line)) {
+      activeSystemPrompt = buildCoordinatorSystemPrompt(systemPrompt);
+      userContent = stripCoordinatorPrefix(userContent);
+      coordinatorActive = true;
+      process.stdout.write(dim('\n  ◈ Coordinator mode activated — routing to parallel workers\n'));
+    }
+
     const fullMessages = [
-      { role: 'system', content: systemPrompt },
+      { role: 'system', content: activeSystemPrompt },
       ...messages,
       { role: 'user', content: userContent }
     ];

package/lib/coordinator.js

@@ -0,0 +1,63 @@
+/**
+ * Coordinator mode — mirrors Claude Code's coordinator/coordinatorMode.js
+ *
+ * When activated (--coordinator flag or @team prefix), a coordinator agent
+ * analyzes the task, decomposes it into independent subtasks, and routes
+ * each to a worker Agent. Workers run in parallel. Coordinator aggregates
+ * results and produces a final summary.
+ *
+ * Architecture (from leaked source):
+ *   Coordinator has a different system prompt:
+ *     - Knows it is orchestrating workers
+ *     - Must break task into INDEPENDENT subtasks (no deps between workers)
+ *     - Must spawn one Agent per subtask
+ *     - Aggregates worker results into a coherent response
+ *
+ *   Workers:
+ *     - Each worker only sees its own subtask
+ *     - No shared state between workers
+ *     - Results flow back to coordinator via Agent tool return values
+ */
+
+export const COORDINATOR_SYSTEM_INJECTION = `
+<coordinator_mode>
+You are operating as a COORDINATOR agent. Your job is NOT to do the work yourself —
+it is to orchestrate WORKER agents that do the work in parallel.
+
+RULES:
+1. Analyze the task and identify subtasks that can run independently
+2. For each independent subtask, call Agent({ task: "..." }) — you can call multiple Agent() in a single response to run them in parallel
+3. Wait for all worker results, then synthesize a final answer
+4. Never do work a worker could do — delegate everything
+5. Keep subtasks self-contained: each worker has no knowledge of other workers
+
+SUBTASK DECOMPOSITION GUIDE:
+- "analyze X and Y" → two Agent calls (analyze X, analyze Y)
+- "search for A then use it in B" → NOT parallelizable (sequential dependency)
+- "update files A, B, C independently" → three Agent calls
+- "refactor module X" → one Agent call (single coherent task)
+
+When you have all worker results, write a final COORDINATOR SUMMARY that:
+- States what was accomplished
+- Highlights any conflicts or issues workers found
+- Lists files changed
+- Notes anything requiring follow-up
+</coordinator_mode>
+`;
+
+export function isCoordinatorTask(input) {
+  // Explicit triggers
+  if (input.startsWith('@team ') || input.startsWith('@coordinator ')) return true;
+  // Heuristic: task mentions multiple independent files/components
+  const parallelKeywords = /\b(and also|in parallel|simultaneously|at the same time|both.*and|all of the following)\b/i;
+  const multiFile = (input.match(/\b\w+\.\w{2,4}\b/g) || []).length >= 3;
+  return parallelKeywords.test(input) && multiFile;
+}
+
+export function stripCoordinatorPrefix(input) {
+  return input.replace(/^@(team|coordinator)\s+/i, '');
+}
+
+export function buildCoordinatorSystemPrompt(baseSystemPrompt) {
+  return baseSystemPrompt + COORDINATOR_SYSTEM_INJECTION;
+}

package/lib/kairos.js

@@ -0,0 +1,75 @@
+/**
+ * KAIROS — background scheduled tasks.
+ * Mirrors Claude Code's unreleased autonomous background agent mode.
+ *
+ * Tasks stored in ~/.tsunami-code/kairos.json
+ * Each task: { id, prompt, schedule, lastRun, status, createdAt }
+ * schedule: 'once' | 'hourly' | 'daily' | cron-like string (HH:MM)
+ */
+
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import os from 'os';
+import { randomBytes } from 'crypto';
+
+const CONFIG_DIR = join(os.homedir(), '.tsunami-code');
+const KAIROS_FILE = join(CONFIG_DIR, 'kairos.json');
+
+function load() {
+  if (!existsSync(KAIROS_FILE)) return [];
+  try { return JSON.parse(readFileSync(KAIROS_FILE, 'utf8')); } catch { return []; }
+}
+
+function save(tasks) {
+  if (!existsSync(CONFIG_DIR)) mkdirSync(CONFIG_DIR, { recursive: true });
+  writeFileSync(KAIROS_FILE, JSON.stringify(tasks, null, 2), 'utf8');
+}
+
+export function scheduleTask(prompt, schedule = 'once') {
+  const tasks = load();
+  const id = randomBytes(4).toString('hex');
+  tasks.push({ id, prompt, schedule, status: 'pending', createdAt: new Date().toISOString(), lastRun: null });
+  save(tasks);
+  return id;
+}
+
+export function listTasks() { return load(); }
+
+export function cancelTask(id) {
+  const tasks = load().filter(t => t.id !== id);
+  save(tasks);
+}
+
+export function markDone(id) {
+  const tasks = load();
+  const t = tasks.find(t => t.id === id);
+  if (t) { t.status = t.schedule === 'once' ? 'done' : 'pending'; t.lastRun = new Date().toISOString(); }
+  save(tasks);
+}
+
+export function getDueTasks() {
+  const now = new Date();
+  return load().filter(t => {
+    if (t.status === 'done') return false;
+    if (t.status === 'running') return false;
+    if (!t.lastRun) return true; // never run
+    const last = new Date(t.lastRun);
+    if (t.schedule === 'once') return t.status === 'pending';
+    if (t.schedule === 'hourly') return (now - last) >= 3600000;
+    if (t.schedule === 'daily') return (now - last) >= 86400000;
+    // HH:MM format
+    if (/^\d{2}:\d{2}$/.test(t.schedule)) {
+      const [h, m] = t.schedule.split(':').map(Number);
+      const due = new Date(now); due.setHours(h, m, 0, 0);
+      return now >= due && (now - last) >= 86400000;
+    }
+    return false;
+  });
+}
+
+export function formatTaskList(tasks) {
+  if (!tasks.length) return 'No KAIROS tasks scheduled.';
+  return tasks.map(t =>
+    `  [${t.id}] ${t.status.padEnd(8)} ${t.schedule.padEnd(8)} ${t.prompt.slice(0, 60)}`
+  ).join('\n');
+}

package/lib/tools.js

@@ -642,10 +642,41 @@ Example:
   }
 };
 
+// ── KAIROS TOOL ───────────────────────────────────────────────────────────────
+export const KairosTool = {
+  name: 'Kairos',
+  description: `Schedule a background task to run automatically. Tasks are stored persistently and checked each time Tsunami Code starts.
+
+Use for:
+- "Run this check every morning"
+- "Remind me to do X next time I open this project"
+- "Watch for Y and alert me when it changes"
+
+Schedules: 'once' | 'hourly' | 'daily' | 'HH:MM' (daily at specific time)`,
+  input_schema: {
+    type: 'object',
+    properties: {
+      prompt:   { type: 'string', description: 'The task prompt to run when triggered' },
+      schedule: { type: 'string', description: "When to run: 'once', 'hourly', 'daily', or 'HH:MM'", default: 'once' }
+    },
+    required: ['prompt']
+  },
+  async run({ prompt, schedule = 'once' }) {
+    try {
+      const { scheduleTask } = await import('./kairos.js');
+      const id = scheduleTask(prompt, schedule);
+      return `Task scheduled [${id}] — will run ${schedule}. View with /kairos.`;
+    } catch (e) {
+      return `Error scheduling task: ${e.message}`;
+    }
+  }
+};
+
 export const ALL_TOOLS = [
   BashTool, ReadTool, WriteTool, EditTool, GlobTool, GrepTool,
   NoteTool, CheckpointTool,
   WebFetchTool, WebSearchTool,
   TodoWriteTool, AskUserTool,
-  AgentTool, SnipTool, BriefTool
+  AgentTool, SnipTool, BriefTool,
+  KairosTool
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tsunami-code",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "description": "Tsunami Code CLI — AI coding agent by Keystone World Management Navy Seal Unit XI3",
   "type": "module",
   "bin": {