@cereworker/core 0.2.0 → 0.5.0

package/dist/sub-agent-manager.js

@@ -0,0 +1,372 @@
+import { nanoid } from 'nanoid';
+import { existsSync, mkdirSync, writeFileSync, readFileSync, appendFileSync, readdirSync, rmSync, } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { ConversationStore } from './conversation.js';
+export class SubAgentManager {
+    agents = new Map();
+    cerebrum;
+    tools;
+    maxConcurrent;
+    baseDir;
+    constructor(opts) {
+        this.cerebrum = opts.cerebrum;
+        this.tools = opts.tools;
+        this.maxConcurrent = opts.maxConcurrent ?? 5;
+        this.baseDir = opts.baseDir ?? join(homedir(), '.cereworker', 'agents');
+        this.ensureDir(this.baseDir);
+    }
+    ensureDir(dir) {
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+    }
+    async spawn(task, opts) {
+        const running = this.listAgents().filter((a) => a.status === 'running' || a.status === 'pending');
+        if (running.length >= this.maxConcurrent) {
+            throw new Error(`Max concurrent sub-agents (${this.maxConcurrent}) reached`);
+        }
+        const id = nanoid(10);
+        const sessionKey = `agent:main:subagent:${id}`;
+        const agentDir = join(this.baseDir, id);
+        const memoryDir = join(agentDir, 'memory');
+        this.ensureDir(agentDir);
+        this.ensureDir(memoryDir);
+        // Initialize empty MEMORY.md for the agent
+        writeFileSync(join(memoryDir, 'MEMORY.md'), '', 'utf-8');
+        const conversation = new ConversationStore(join(agentDir, 'conversations.db'));
+        const conv = conversation.create();
+        const instance = {
+            id,
+            sessionKey,
+            parentSessionKey: opts?.parentSessionKey ?? 'agent:main',
+            task,
+            label: opts?.label,
+            status: 'pending',
+            cleanup: opts?.cleanup ?? 'delete',
+            spawnedAt: Date.now(),
+            lastActivityAt: Date.now(),
+            timeoutMs: opts?.timeoutMs ?? 5 * 60_000,
+            retryCount: 0,
+            conversation,
+            conversationId: conv.id,
+            agentDir,
+            abortController: new AbortController(),
+            messagesCount: 0,
+            toolCallsCount: 0,
+        };
+        this.agents.set(id, instance);
+        this.saveSessionMeta(instance);
+        // Run agent asynchronously (fire and forget, errors are captured)
+        this.runAgent(instance).catch(() => {
+            // Errors are already handled inside runAgent
+        });
+        return id;
+    }
+    getAgent(id) {
+        const instance = this.agents.get(id);
+        if (!instance)
+            return null;
+        return this.toState(instance);
+    }
+    listAgents() {
+        return Array.from(this.agents.values()).map((i) => this.toState(i));
+    }
+    getSummary() {
+        const agents = this.listAgents();
+        return {
+            total: agents.length,
+            running: agents.filter((a) => a.status === 'running' || a.status === 'pending').length,
+            completed: agents.filter((a) => a.status === 'completed').length,
+            failed: agents.filter((a) => a.status === 'failed' || a.status === 'timeout' || a.status === 'cancelled').length,
+        };
+    }
+    cancel(id) {
+        const instance = this.agents.get(id);
+        if (!instance)
+            return;
+        if (instance.status !== 'running' && instance.status !== 'pending')
+            return;
+        instance.abortController.abort();
+        instance.status = 'cancelled';
+        this.saveSessionMeta(instance);
+    }
+    async retry(id) {
+        const instance = this.agents.get(id);
+        if (!instance)
+            throw new Error(`Agent ${id} not found`);
+        if (instance.status === 'running' || instance.status === 'pending') {
+            throw new Error(`Agent ${id} is still running`);
+        }
+        // Re-spawn with same task in the same directory
+        instance.status = 'pending';
+        instance.retryCount++;
+        instance.lastActivityAt = Date.now();
+        instance.abortController = new AbortController();
+        instance.result = undefined;
+        instance.error = undefined;
+        // Create a new conversation for the retry
+        const conv = instance.conversation.create();
+        instance.conversationId = conv.id;
+        instance.messagesCount = 0;
+        instance.toolCallsCount = 0;
+        this.saveSessionMeta(instance);
+        this.runAgent(instance).catch(() => { });
+        return id;
+    }
+    ping(id) {
+        const instance = this.agents.get(id);
+        if (!instance || instance.status !== 'running')
+            return;
+        instance.conversation.appendMessage(instance.conversationId, 'system', 'You appear to be stalled. Please continue working on your task or report your findings.');
+        instance.lastActivityAt = Date.now();
+        instance.messagesCount++;
+    }
+    prune(maxAgeMs = 30 * 60_000) {
+        const now = Date.now();
+        for (const [id, instance] of this.agents) {
+            if (instance.status === 'running' || instance.status === 'pending')
+                continue;
+            if (now - instance.lastActivityAt < maxAgeMs)
+                continue;
+            if (instance.cleanup === 'delete') {
+                try {
+                    rmSync(instance.agentDir, { recursive: true, force: true });
+                }
+                catch {
+                    // Ignore cleanup errors
+                }
+            }
+            this.agents.delete(id);
+        }
+    }
+    readTranscript(id) {
+        const instance = this.agents.get(id);
+        if (!instance)
+            return null;
+        return instance.conversation.getMessages(instance.conversationId);
+    }
+    async runAgent(instance) {
+        instance.status = 'running';
+        this.saveSessionMeta(instance);
+        // Set up timeout
+        const timeoutId = setTimeout(() => {
+            instance.abortController.abort();
+        }, instance.timeoutMs);
+        try {
+            // Send the task as the first message
+            instance.conversation.appendMessage(instance.conversationId, 'system', 'You are a sub-agent. Complete the given task and respond with your findings. Use memory_write to save important findings to your own memory.');
+            instance.conversation.appendMessage(instance.conversationId, 'user', instance.task);
+            instance.messagesCount += 2;
+            this.appendTranscript(instance, { role: 'system', content: 'You are a sub-agent...' });
+            this.appendTranscript(instance, { role: 'user', content: instance.task });
+            const agentTools = this.createAgentTools(instance.agentDir);
+            // Stream the cerebrum response
+            const messages = instance.conversation.getMessages(instance.conversationId);
+            const toolDefs = Object.fromEntries(agentTools);
+            let fullContent = '';
+            await new Promise((resolve, reject) => {
+                if (instance.abortController.signal.aborted) {
+                    reject(new Error('Agent aborted'));
+                    return;
+                }
+                const abortHandler = () => reject(new Error('Agent aborted'));
+                instance.abortController.signal.addEventListener('abort', abortHandler, { once: true });
+                this.cerebrum
+                    .stream(messages, toolDefs, {
+                    onChunk: (chunk) => {
+                        fullContent += chunk;
+                        instance.lastActivityAt = Date.now();
+                    },
+                    onToolCall: async (toolCall) => {
+                        instance.lastActivityAt = Date.now();
+                        instance.toolCallsCount++;
+                        const tool = agentTools.get(toolCall.name);
+                        if (!tool) {
+                            return { callId: toolCall.id, output: `Unknown tool: ${toolCall.name}`, isError: true };
+                        }
+                        try {
+                            const output = await tool.execute(toolCall.args);
+                            const result = { callId: toolCall.id, output, isError: false };
+                            instance.conversation.appendMessage(instance.conversationId, 'tool', output, {
+                                toolResult: result,
+                            });
+                            instance.messagesCount++;
+                            this.appendTranscript(instance, { role: 'tool', content: output, toolName: toolCall.name });
+                            return result;
+                        }
+                        catch (err) {
+                            const errMsg = err instanceof Error ? err.message : String(err);
+                            const result = { callId: toolCall.id, output: errMsg, isError: true };
+                            instance.conversation.appendMessage(instance.conversationId, 'tool', errMsg, {
+                                toolResult: result,
+                            });
+                            instance.messagesCount++;
+                            return result;
+                        }
+                    },
+                    onFinish: (content) => {
+                        instance.conversation.appendMessage(instance.conversationId, 'cerebrum', content);
+                        instance.messagesCount++;
+                        instance.result = content;
+                        this.appendTranscript(instance, { role: 'cerebrum', content });
+                        instance.abortController.signal.removeEventListener('abort', abortHandler);
+                        resolve();
+                    },
+                    onError: (error) => {
+                        instance.abortController.signal.removeEventListener('abort', abortHandler);
+                        reject(error);
+                    },
+                })
+                    .catch(reject);
+            });
+            instance.status = 'completed';
+        }
+        catch (err) {
+            if (instance.abortController.signal.aborted) {
+                // Check if it was a timeout or manual cancel (status may have been
+                // set to 'cancelled' externally by cancel())
+                if (instance.status !== 'cancelled') {
+                    instance.status = 'timeout';
+                }
+            }
+            else {
+                instance.status = 'failed';
+                instance.error = err instanceof Error ? err.message : String(err);
+            }
+        }
+        finally {
+            clearTimeout(timeoutId);
+            this.saveSessionMeta(instance);
+        }
+    }
+    createAgentTools(agentDir) {
+        const agentTools = new Map();
+        const memoryDir = join(agentDir, 'memory');
+        // Copy shared tools (shell, file ops, etc.) but NOT sub-agent tools (no recursion)
+        for (const [name, tool] of this.tools) {
+            if (name === 'spawn_agent' || name === 'query_agents' || name === 'cancel_agent') {
+                continue;
+            }
+            // Replace memory tools with agent-scoped versions
+            if (name.startsWith('memory_')) {
+                continue;
+            }
+            agentTools.set(name, tool);
+        }
+        // Agent-scoped memory tools
+        agentTools.set('memory_read', {
+            description: 'Read your memory file (MEMORY.md or a daily log)',
+            parameters: {},
+            execute: async (args) => {
+                const file = args.file ?? 'MEMORY.md';
+                const safeName = file.replace(/[/\\]/g, '');
+                const path = join(memoryDir, safeName);
+                if (!existsSync(path))
+                    return `File "${file}" not found.`;
+                return readFileSync(path, 'utf-8') || '(empty file)';
+            },
+        });
+        agentTools.set('memory_write', {
+            description: 'Write/update your MEMORY.md file',
+            parameters: {},
+            execute: async (args) => {
+                const content = args.content;
+                writeFileSync(join(memoryDir, 'MEMORY.md'), content, 'utf-8');
+                return 'MEMORY.md updated successfully.';
+            },
+        });
+        agentTools.set('memory_log', {
+            description: "Append a note to today's daily log",
+            parameters: {},
+            execute: async (args) => {
+                const content = args.content;
+                const today = new Date().toISOString().slice(0, 10);
+                const entry = `\n---\n_${new Date().toISOString()}_\n\n${content}\n`;
+                appendFileSync(join(memoryDir, `${today}.md`), entry, 'utf-8');
+                return `Logged to ${today}.md`;
+            },
+        });
+        agentTools.set('memory_search', {
+            description: 'Search across your memory files',
+            parameters: {},
+            execute: async (args) => {
+                const query = args.query.toLowerCase();
+                const files = existsSync(memoryDir)
+                    ? readdirSync(memoryDir).filter((f) => f.endsWith('.md'))
+                    : [];
+                const results = [];
+                for (const file of files) {
+                    const content = readFileSync(join(memoryDir, file), 'utf-8');
+                    if (content.toLowerCase().includes(query)) {
+                        const lines = content
+                            .split('\n')
+                            .filter((l) => l.toLowerCase().includes(query))
+                            .slice(0, 5);
+                        results.push(`## ${file}\n${lines.join('\n')}`);
+                    }
+                }
+                return results.length > 0 ? results.join('\n\n') : `No matches found for "${query}"`;
+            },
+        });
+        return agentTools;
+    }
+    saveSessionMeta(instance) {
+        const meta = {
+            id: instance.id,
+            sessionKey: instance.sessionKey,
+            parentSessionKey: instance.parentSessionKey,
+            task: instance.task,
+            label: instance.label,
+            status: instance.status,
+            cleanup: instance.cleanup,
+            spawnedAt: instance.spawnedAt,
+            lastActivityAt: instance.lastActivityAt,
+            timeoutMs: instance.timeoutMs,
+            result: instance.result,
+            error: instance.error,
+            messagesCount: instance.messagesCount,
+            toolCallsCount: instance.toolCallsCount,
+            retryCount: instance.retryCount,
+        };
+        try {
+            writeFileSync(join(instance.agentDir, 'session.json'), JSON.stringify(meta, null, 2), 'utf-8');
+        }
+        catch {
+            // Ignore write errors
+        }
+    }
+    appendTranscript(instance, entry) {
+        const line = JSON.stringify({
+            ...entry,
+            timestamp: Date.now(),
+        });
+        try {
+            appendFileSync(join(instance.agentDir, 'transcript.jsonl'), line + '\n', 'utf-8');
+        }
+        catch {
+            // Ignore write errors
+        }
+    }
+    toState(instance) {
+        return {
+            id: instance.id,
+            sessionKey: instance.sessionKey,
+            parentSessionKey: instance.parentSessionKey,
+            task: instance.task,
+            label: instance.label,
+            status: instance.status,
+            cleanup: instance.cleanup,
+            spawnedAt: instance.spawnedAt,
+            lastActivityAt: instance.lastActivityAt,
+            timeoutMs: instance.timeoutMs,
+            result: instance.result,
+            error: instance.error,
+            messagesCount: instance.messagesCount,
+            toolCallsCount: instance.toolCallsCount,
+            retryCount: instance.retryCount,
+            memoryDir: join(instance.agentDir, 'memory'),
+        };
+    }
+}
+//# sourceMappingURL=sub-agent-manager.js.map

package/dist/sub-agent-manager.js.map

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

package/dist/sub-agent-tools.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from './orchestrator.js';
+import type { SubAgentManager } from './sub-agent-manager.js';
+export declare function createSubAgentTools(manager: SubAgentManager): Record<string, ToolDefinition>;
+//# sourceMappingURL=sub-agent-tools.d.ts.map

package/dist/sub-agent-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-agent-tools.d.ts","sourceRoot":"","sources":["../src/sub-agent-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CA2F5F"}

package/dist/sub-agent-tools.js

@@ -0,0 +1,82 @@
+export function createSubAgentTools(manager) {
+    return {
+        spawn_agent: {
+            description: 'Spawn a sub-agent to handle a task in the background. Returns the agent ID. The sub-agent has its own isolated memory and conversation.',
+            parameters: {
+                task: { type: 'string', description: 'The task for the sub-agent to complete' },
+                timeoutMinutes: { type: 'number', description: 'Max lifetime in minutes (default: 5)' },
+                label: { type: 'string', description: 'Optional short label for the agent' },
+                cleanup: {
+                    type: 'string',
+                    description: '"delete" to remove after completion, "keep" to persist (default: delete)',
+                },
+            },
+            execute: async (args) => {
+                const { task, timeoutMinutes, label, cleanup } = args;
+                try {
+                    const id = await manager.spawn(task, {
+                        timeoutMs: (timeoutMinutes || 5) * 60_000,
+                        label,
+                        cleanup: cleanup === 'keep' ? 'keep' : 'delete',
+                    });
+                    return `Sub-agent ${id} spawned${label ? ` (${label})` : ''}. Use query_agents to check status.`;
+                }
+                catch (err) {
+                    return `Failed to spawn agent: ${err instanceof Error ? err.message : String(err)}`;
+                }
+            },
+        },
+        query_agents: {
+            description: 'Query the status of all sub-agents, or a specific one by ID. Returns status, task, result, and other details.',
+            parameters: {
+                agentId: { type: 'string', description: 'Optional: query a specific agent by ID' },
+            },
+            execute: async (args) => {
+                const { agentId } = args;
+                if (agentId) {
+                    const agent = manager.getAgent(agentId);
+                    if (!agent)
+                        return `Agent ${agentId} not found.`;
+                    return JSON.stringify(agent, null, 2);
+                }
+                const agents = manager.listAgents();
+                if (agents.length === 0)
+                    return 'No sub-agents.';
+                const summary = manager.getSummary();
+                const header = `${summary.total} agents: ${summary.running} running, ${summary.completed} completed, ${summary.failed} failed\n`;
+                const list = agents
+                    .map((a) => {
+                    const elapsed = Math.round((Date.now() - a.spawnedAt) / 1000);
+                    const line = `- [${a.status}] ${a.id}${a.label ? ` (${a.label})` : ''}: ${a.task.slice(0, 80)}${a.task.length > 80 ? '...' : ''} (${elapsed}s)`;
+                    if (a.status === 'completed' && a.result) {
+                        return `${line}\n  Result: ${a.result.slice(0, 200)}${a.result.length > 200 ? '...' : ''}`;
+                    }
+                    if (a.error) {
+                        return `${line}\n  Error: ${a.error}`;
+                    }
+                    return line;
+                })
+                    .join('\n');
+                return header + list;
+            },
+        },
+        cancel_agent: {
+            description: 'Cancel a running sub-agent by ID.',
+            parameters: {
+                agentId: { type: 'string', description: 'The agent ID to cancel' },
+            },
+            execute: async (args) => {
+                const { agentId } = args;
+                const agent = manager.getAgent(agentId);
+                if (!agent)
+                    return `Agent ${agentId} not found.`;
+                if (agent.status !== 'running' && agent.status !== 'pending') {
+                    return `Agent ${agentId} is already ${agent.status}.`;
+                }
+                manager.cancel(agentId);
+                return `Agent ${agentId} cancelled.`;
+            },
+        },
+    };
+}
+//# sourceMappingURL=sub-agent-tools.js.map

package/dist/sub-agent-tools.js.map

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

package/dist/types.d.ts

@@ -35,6 +35,60 @@ export interface CerebellumStatus {
     uptimeSeconds: number;
     tasksRegistered: number;
 }
+export interface VerificationCheck {
+    name: string;
+    passed: boolean;
+    description: string;
+}
+export interface VerificationResult {
+    passed: boolean;
+    checks: VerificationCheck[];
+    modelVerdict: boolean;
+    toolCallId: string;
+    toolName: string;
+}
+export type SubAgentStatus = 'pending' | 'running' | 'completed' | 'failed' | 'cancelled' | 'timeout';
+export type SubAgentCleanup = 'delete' | 'keep';
+export interface SubAgentState {
+    id: string;
+    sessionKey: string;
+    parentSessionKey: string;
+    task: string;
+    label?: string;
+    status: SubAgentStatus;
+    cleanup: SubAgentCleanup;
+    spawnedAt: number;
+    lastActivityAt: number;
+    timeoutMs: number;
+    result?: string;
+    error?: string;
+    messagesCount: number;
+    toolCallsCount: number;
+    retryCount: number;
+    memoryDir: string;
+}
+export interface SubAgentSummary {
+    total: number;
+    running: number;
+    completed: number;
+    failed: number;
+}
+export interface AgentHealthAction {
+    agentId: string;
+    action: 'ok' | 'ping' | 'retry' | 'cancel' | 'timeout';
+    reason: string;
+}
+export interface SystemStatus {
+    healthy: boolean;
+    modelName: string;
+    uptimeSeconds: number;
+    tasksRegistered: number;
+    agentsTotal: number;
+    agentsRunning: number;
+    agentsCompleted: number;
+    agentsFailed: number;
+    pendingActions: AgentHealthAction[];
+}
 export interface OrchestratorConfig {
     cerebrum: {
         defaultProvider: string;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,YAAY,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEjF,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC/C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE;QACR,eAAe,EAAE,MAAM,CAAC;QACxB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,UAAU,EAAE;QACV,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cereworker/core",
-  "version": "0.2.0",
+  "version": "0.5.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -16,10 +16,12 @@
     "directory": "packages/core"
   },
   "dependencies": {
+    "better-sqlite3": "^11.7.0",
     "nanoid": "^5.0.9",
-    "@cereworker/config": "0.2.0"
+    "@cereworker/config": "0.5.0"
   },
   "devDependencies": {
+    "@types/better-sqlite3": "^7.6.12",
     "typescript": "^5.7.3"
   },
   "scripts": {