@phuetz/code-buddy 0.1.0

package/dist/agent/multi-agent/session-tools.js

@@ -0,0 +1,396 @@
+/**
+ * Session Tools
+ *
+ * Tools for multi-agent session coordination.
+ * Enables agents to communicate across sessions.
+ *
+ * Inspired by OpenClaw's session tools:
+ * - sessions_list: List active sessions
+ * - sessions_history: Get session transcript
+ * - sessions_send: Message another session
+ * - sessions_spawn: Create isolated sub-agent
+ */
+import { getSessionRegistry, } from './session-registry.js';
+// ============================================================================
+// Tool Definitions
+// ============================================================================
+export const SESSIONS_LIST_TOOL = {
+    type: 'function',
+    function: {
+        name: 'sessions_list',
+        description: `List active sessions in the multi-agent system.
+
+Use this to discover other sessions you can communicate with.
+
+Session kinds:
+- main: Main DM session with user
+- channel: Channel/group session
+- cron: Scheduled cron job session
+- hook: Webhook-triggered session
+- spawn: Spawned sub-agent session
+- node: Companion node session
+
+Example: List all active sessions from the last 10 minutes
+{ "activeMinutes": 10, "limit": 20 }`,
+        parameters: {
+            type: 'object',
+            properties: {
+                kinds: {
+                    type: 'array',
+                    items: {
+                        type: 'string',
+                        enum: ['main', 'channel', 'cron', 'hook', 'spawn', 'node'],
+                    },
+                    description: 'Filter by session kinds',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum sessions to return (default: 50)',
+                },
+                activeMinutes: {
+                    type: 'number',
+                    description: 'Only sessions active in last N minutes',
+                },
+                messageLimit: {
+                    type: 'number',
+                    description: 'Include last N messages per session in preview',
+                },
+            },
+            required: [],
+        },
+    },
+};
+export const SESSIONS_HISTORY_TOOL = {
+    type: 'function',
+    function: {
+        name: 'sessions_history',
+        description: `Get the conversation history of a session.
+
+Use this to understand what happened in another session before sending a message.
+
+You can identify sessions by:
+- sessionKey: Human-readable key like "main", "spawn:abc:task1"
+- sessionId: UUID of the session
+
+Example: Get last 20 messages from main session
+{ "sessionKey": "main", "limit": 20, "includeTools": false }`,
+        parameters: {
+            type: 'object',
+            properties: {
+                sessionKey: {
+                    type: 'string',
+                    description: 'Session key (e.g., "main", "spawn:parent:label")',
+                },
+                sessionId: {
+                    type: 'string',
+                    description: 'Session UUID (alternative to sessionKey)',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum messages to return (default: 50)',
+                },
+                includeTools: {
+                    type: 'boolean',
+                    description: 'Include tool call details (default: false)',
+                },
+            },
+            required: [],
+        },
+    },
+};
+export const SESSIONS_SEND_TOOL = {
+    type: 'function',
+    function: {
+        name: 'sessions_send',
+        description: `Send a message to another session.
+
+Use this to coordinate with other agents or sessions.
+
+Modes:
+- Fire-and-forget (timeoutSeconds=0): Send and continue without waiting
+- Wait for response (timeoutSeconds>0): Wait for the target to reply
+
+Example: Send task update to main session
+{ "sessionKey": "main", "message": "Task completed successfully", "timeoutSeconds": 0 }
+
+Example: Ask another agent and wait for response
+{ "sessionKey": "spawn:abc:researcher", "message": "What did you find?", "timeoutSeconds": 30 }`,
+        parameters: {
+            type: 'object',
+            properties: {
+                sessionKey: {
+                    type: 'string',
+                    description: 'Target session key',
+                },
+                message: {
+                    type: 'string',
+                    description: 'Message to send',
+                },
+                timeoutSeconds: {
+                    type: 'number',
+                    description: 'Wait timeout (0=fire-and-forget, default: 0)',
+                },
+            },
+            required: ['sessionKey', 'message'],
+        },
+    },
+};
+export const SESSIONS_SPAWN_TOOL = {
+    type: 'function',
+    function: {
+        name: 'sessions_spawn',
+        description: `Spawn an isolated sub-agent session for a specific task.
+
+The spawned agent runs in a sandboxed session with its own context.
+Use this to delegate subtasks or run parallel work.
+
+The spawned agent will:
+- Have its own conversation context
+- Run with restricted tools (configurable)
+- Report back through session messaging
+
+Example: Spawn a research agent
+{
+  "task": "Research the latest TypeScript 5.0 features",
+  "label": "ts-researcher",
+  "runTimeoutSeconds": 120
+}
+
+Example: Spawn a code reviewer
+{
+  "task": "Review the changes in src/api/ for security issues",
+  "label": "security-review",
+  "allowedTools": ["view_file", "search", "find_symbols"],
+  "context": { "focus": "security", "severity": "high" }
+}`,
+        parameters: {
+            type: 'object',
+            properties: {
+                task: {
+                    type: 'string',
+                    description: 'Task description for the sub-agent',
+                },
+                label: {
+                    type: 'string',
+                    description: 'Label for the session (used in session key)',
+                },
+                agentId: {
+                    type: 'string',
+                    description: 'Agent ID to use (defaults to current agent)',
+                },
+                model: {
+                    type: 'string',
+                    description: 'Model override for the sub-agent',
+                },
+                runTimeoutSeconds: {
+                    type: 'number',
+                    description: 'Maximum runtime in seconds (default: 300)',
+                },
+                allowedTools: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Tools the sub-agent can use (defaults to safe subset)',
+                },
+                context: {
+                    type: 'object',
+                    description: 'Initial context/data to pass to the sub-agent',
+                },
+            },
+            required: ['task'],
+        },
+    },
+};
+export const SESSION_TOOLS = [
+    SESSIONS_LIST_TOOL,
+    SESSIONS_HISTORY_TOOL,
+    SESSIONS_SEND_TOOL,
+    SESSIONS_SPAWN_TOOL,
+];
+export class SessionToolExecutor {
+    registry;
+    currentSessionId;
+    constructor(registry, currentSessionId) {
+        this.registry = registry || getSessionRegistry();
+        this.currentSessionId = currentSessionId || 'main';
+    }
+    setCurrentSession(sessionId) {
+        this.currentSessionId = sessionId;
+    }
+    async execute(toolName, args) {
+        switch (toolName) {
+            case 'sessions_list':
+                return this.executeSessionsList(args);
+            case 'sessions_history':
+                return this.executeSessionsHistory(args);
+            case 'sessions_send':
+                return this.executeSessionsSend(args);
+            case 'sessions_spawn':
+                return this.executeSessionsSpawn(args);
+            default:
+                return { success: false, error: `Unknown session tool: ${toolName}` };
+        }
+    }
+    executeSessionsList(args) {
+        const sessions = this.registry.listSessions({
+            kinds: args.kinds,
+            limit: args.limit || 50,
+            activeMinutes: args.activeMinutes,
+        });
+        const messageLimit = args.messageLimit || 0;
+        const formatted = sessions.map(s => {
+            const info = {
+                key: s.key,
+                kind: s.kind,
+                status: s.status,
+                messageCount: s.messageCount,
+                lastActivity: this.formatRelativeTime(s.lastActivityAt),
+            };
+            if (s.label)
+                info.label = s.label;
+            if (s.model)
+                info.model = s.model;
+            if (s.sandboxed)
+                info.sandboxed = true;
+            if (messageLimit > 0) {
+                const messages = this.registry.getHistory(s.id, {
+                    limit: messageLimit,
+                    includeTools: false,
+                });
+                info.preview = messages.map(m => ({
+                    role: m.role,
+                    content: m.content.substring(0, 100) + (m.content.length > 100 ? '...' : ''),
+                }));
+            }
+            return info;
+        });
+        return {
+            success: true,
+            output: `Found ${sessions.length} session(s)`,
+            data: { sessions: formatted, total: sessions.length },
+        };
+    }
+    executeSessionsHistory(args) {
+        let session;
+        if (args.sessionKey) {
+            session = this.registry.getSessionByKey(args.sessionKey);
+        }
+        else if (args.sessionId) {
+            session = this.registry.getSession(args.sessionId);
+        }
+        if (!session) {
+            return {
+                success: false,
+                error: `Session not found: ${args.sessionKey || args.sessionId}`,
+            };
+        }
+        const messages = this.registry.getHistory(session.id, {
+            limit: args.limit || 50,
+            includeTools: args.includeTools || false,
+        });
+        const formatted = messages.map(m => ({
+            role: m.role,
+            content: m.content,
+            timestamp: m.timestamp.toISOString(),
+            ...(m.toolCalls ? { toolCalls: m.toolCalls.map(t => t.name) } : {}),
+        }));
+        return {
+            success: true,
+            output: `Retrieved ${messages.length} message(s) from session ${session.key}`,
+            data: {
+                session: {
+                    key: session.key,
+                    kind: session.kind,
+                    status: session.status,
+                    messageCount: session.messageCount,
+                },
+                messages: formatted,
+            },
+        };
+    }
+    async executeSessionsSend(args) {
+        const sessionKey = args.sessionKey;
+        const message = args.message;
+        const timeoutSeconds = args.timeoutSeconds || 0;
+        if (!sessionKey || !message) {
+            return { success: false, error: 'sessionKey and message are required' };
+        }
+        const result = await this.registry.sendToSession(this.currentSessionId, sessionKey, message, timeoutSeconds);
+        if (result.success) {
+            if (result.fireAndForget) {
+                return {
+                    success: true,
+                    output: `Message sent to ${sessionKey} (fire-and-forget)`,
+                };
+            }
+            else {
+                return {
+                    success: true,
+                    output: `Response from ${sessionKey}: ${result.response}`,
+                    data: { response: result.response },
+                };
+            }
+        }
+        else {
+            return {
+                success: false,
+                error: result.error,
+            };
+        }
+    }
+    executeSessionsSpawn(args) {
+        const task = args.task;
+        if (!task) {
+            return { success: false, error: 'task is required' };
+        }
+        try {
+            const child = this.registry.spawnSession({
+                parentSessionId: this.currentSessionId,
+                task,
+                label: args.label,
+                agentId: args.agentId,
+                model: args.model,
+                allowedTools: args.allowedTools,
+                context: args.context,
+            });
+            return {
+                success: true,
+                output: `Spawned session ${child.key}`,
+                data: {
+                    sessionId: child.id,
+                    sessionKey: child.key,
+                },
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    formatRelativeTime(date) {
+        const seconds = Math.floor((Date.now() - date.getTime()) / 1000);
+        if (seconds < 60)
+            return `${seconds}s ago`;
+        if (seconds < 3600)
+            return `${Math.floor(seconds / 60)}m ago`;
+        if (seconds < 86400)
+            return `${Math.floor(seconds / 3600)}h ago`;
+        return `${Math.floor(seconds / 86400)}d ago`;
+    }
+}
+// ============================================================================
+// Singleton
+// ============================================================================
+let sessionToolExecutorInstance = null;
+export function getSessionToolExecutor(registry, currentSessionId) {
+    if (!sessionToolExecutorInstance) {
+        sessionToolExecutorInstance = new SessionToolExecutor(registry, currentSessionId);
+    }
+    return sessionToolExecutorInstance;
+}
+export function resetSessionToolExecutor() {
+    sessionToolExecutorInstance = null;
+}
+export default SessionToolExecutor;
+//# sourceMappingURL=session-tools.js.map

package/dist/agent/multi-agent/session-tools.js.map

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

package/dist/agent/multi-agent/types.d.ts

@@ -0,0 +1,278 @@
+/**
+ * Multi-Agent System Types
+ *
+ * Defines the core types and interfaces for the multi-agent collaborative system.
+ * Based on research from:
+ * - ComplexAgents (EMNLP 2024)
+ * - Paper2Code (arXiv 2504.17192)
+ * - AgentCoder (Huang et al., 2023)
+ */
+import { CodeBuddyToolCall } from "../../codebuddy/client.js";
+import { ToolResult } from "../../types/index.js";
+/**
+ * Agent roles in the multi-agent system
+ */
+export type AgentRole = "orchestrator" | "coder" | "reviewer" | "tester" | "researcher" | "debugger" | "architect" | "documenter";
+/**
+ * Task status in the workflow
+ */
+export type TaskStatus = "pending" | "in_progress" | "completed" | "failed" | "blocked" | "review_required";
+/**
+ * Priority levels for tasks
+ */
+export type TaskPriority = "critical" | "high" | "medium" | "low";
+/**
+ * A single task in the multi-agent workflow
+ */
+export interface AgentTask {
+    id: string;
+    title: string;
+    description: string;
+    status: TaskStatus;
+    priority: TaskPriority;
+    assignedTo: AgentRole;
+    dependencies: string[];
+    subtasks: AgentTask[];
+    artifacts: TaskArtifact[];
+    metadata: Record<string, unknown>;
+    createdAt: Date;
+    updatedAt: Date;
+    completedAt?: Date;
+    error?: string;
+}
+/**
+ * An artifact produced by a task (code, document, etc.)
+ */
+export interface TaskArtifact {
+    id: string;
+    type: "code" | "document" | "test" | "diagram" | "analysis" | "diff";
+    name: string;
+    content: string;
+    filePath?: string;
+    language?: string;
+    metadata: Record<string, unknown>;
+}
+/**
+ * A plan created by the orchestrator
+ */
+export interface ExecutionPlan {
+    id: string;
+    goal: string;
+    summary: string;
+    phases: PlanPhase[];
+    estimatedComplexity: "simple" | "moderate" | "complex" | "very_complex";
+    requiredAgents: AgentRole[];
+    createdAt: Date;
+    status: "draft" | "approved" | "executing" | "completed" | "failed";
+}
+/**
+ * A phase within an execution plan
+ */
+export interface PlanPhase {
+    id: string;
+    name: string;
+    description: string;
+    tasks: AgentTask[];
+    parallelizable: boolean;
+    order: number;
+}
+/**
+ * Message passed between agents
+ */
+export interface AgentMessage {
+    id: string;
+    from: AgentRole;
+    to: AgentRole | "all";
+    type: "request" | "response" | "feedback" | "delegation" | "status_update";
+    content: string;
+    data?: unknown;
+    timestamp: Date;
+    inReplyTo?: string;
+}
+/**
+ * Feedback from one agent to another
+ */
+export interface AgentFeedback {
+    id: string;
+    from: AgentRole;
+    to: AgentRole;
+    taskId: string;
+    type: "approval" | "rejection" | "revision_request" | "suggestion";
+    severity: "critical" | "major" | "minor" | "info";
+    message: string;
+    suggestions: string[];
+    codeLocations?: CodeLocation[];
+}
+/**
+ * A location in code for feedback
+ */
+export interface CodeLocation {
+    file: string;
+    startLine: number;
+    endLine: number;
+    snippet?: string;
+}
+/**
+ * Configuration for an agent
+ */
+export interface AgentConfig {
+    role: AgentRole;
+    name: string;
+    description: string;
+    systemPrompt: string;
+    model?: string;
+    temperature?: number;
+    maxRounds?: number;
+    timeout?: number;
+    allowedTools?: string[];
+    capabilities: AgentCapability[];
+}
+/**
+ * Capabilities an agent can have
+ */
+export type AgentCapability = "code_generation" | "code_review" | "code_editing" | "testing" | "debugging" | "documentation" | "architecture" | "search" | "planning" | "file_operations" | "git_operations" | "web_search";
+/**
+ * Result from an agent's execution
+ */
+export interface AgentExecutionResult {
+    success: boolean;
+    role: AgentRole;
+    taskId: string;
+    output: string;
+    artifacts: TaskArtifact[];
+    toolsUsed: string[];
+    rounds: number;
+    duration: number;
+    feedback?: AgentFeedback[];
+    error?: string;
+}
+/**
+ * The overall result of a multi-agent workflow
+ */
+export interface WorkflowResult {
+    success: boolean;
+    plan: ExecutionPlan;
+    results: Map<string, AgentExecutionResult>;
+    artifacts: TaskArtifact[];
+    timeline: WorkflowEvent[];
+    totalDuration: number;
+    summary: string;
+    errors: string[];
+}
+/**
+ * An event in the workflow timeline
+ */
+export interface WorkflowEvent {
+    timestamp: Date;
+    type: "task_started" | "task_completed" | "task_failed" | "agent_message" | "phase_started" | "phase_completed";
+    agent?: AgentRole;
+    taskId?: string;
+    message: string;
+    data?: unknown;
+}
+/**
+ * Collaboration strategy for the multi-agent system
+ */
+export type CollaborationStrategy = "sequential" | "parallel" | "hierarchical" | "peer_review" | "iterative";
+/**
+ * Options for running a multi-agent workflow
+ */
+export interface WorkflowOptions {
+    strategy: CollaborationStrategy;
+    maxIterations?: number;
+    requireConsensus?: boolean;
+    parallelAgents?: number;
+    timeout?: number;
+    verbose?: boolean;
+    dryRun?: boolean;
+    autoApprove?: boolean;
+    onProgress?: (event: WorkflowEvent) => void;
+    onAgentMessage?: (message: AgentMessage) => void;
+}
+/**
+ * Context shared between agents
+ */
+export interface SharedContext {
+    goal: string;
+    codebaseInfo?: CodebaseInfo;
+    relevantFiles: string[];
+    conversationHistory: AgentMessage[];
+    artifacts: Map<string, TaskArtifact>;
+    decisions: Decision[];
+    constraints: string[];
+}
+/**
+ * Information about the codebase
+ */
+export interface CodebaseInfo {
+    rootPath: string;
+    language: string;
+    framework?: string;
+    structure: DirectoryNode;
+    dependencies: string[];
+    entryPoints: string[];
+}
+/**
+ * A node in the directory structure
+ */
+export interface DirectoryNode {
+    name: string;
+    type: "file" | "directory";
+    path: string;
+    children?: DirectoryNode[];
+    language?: string;
+    summary?: string;
+}
+/**
+ * A decision made during the workflow
+ */
+export interface Decision {
+    id: string;
+    description: string;
+    madeBy: AgentRole;
+    rationale: string;
+    alternatives: string[];
+    timestamp: Date;
+}
+/**
+ * Tool executor function type
+ */
+export type ToolExecutor = (toolCall: CodeBuddyToolCall) => Promise<ToolResult>;
+/**
+ * Event emitter types for the multi-agent system
+ */
+export interface MultiAgentEvents {
+    "workflow:start": {
+        plan: ExecutionPlan;
+    };
+    "workflow:complete": {
+        result: WorkflowResult;
+    };
+    "workflow:error": {
+        error: Error;
+        plan: ExecutionPlan;
+    };
+    "phase:start": {
+        phase: PlanPhase;
+    };
+    "phase:complete": {
+        phase: PlanPhase;
+    };
+    "task:start": {
+        task: AgentTask;
+    };
+    "task:complete": {
+        task: AgentTask;
+        result: AgentExecutionResult;
+    };
+    "task:failed": {
+        task: AgentTask;
+        error: string;
+    };
+    "agent:message": {
+        message: AgentMessage;
+    };
+    "agent:feedback": {
+        feedback: AgentFeedback;
+    };
+}

package/dist/agent/multi-agent/types.js

@@ -0,0 +1,11 @@
+/**
+ * Multi-Agent System Types
+ *
+ * Defines the core types and interfaces for the multi-agent collaborative system.
+ * Based on research from:
+ * - ComplexAgents (EMNLP 2024)
+ * - Paper2Code (arXiv 2504.17192)
+ * - AgentCoder (Huang et al., 2023)
+ */
+export {};
+//# sourceMappingURL=types.js.map