@compass-ai/nova 1.0.72 → 1.0.74

package/dist/tools/swarm-tools.js

@@ -0,0 +1,422 @@
+/**
+ * Swarm/Agent Teams tools
+ *
+ * Tools for spawning coordinated agent teams, reading team messages,
+ * managing shared state, and monitoring team progress.
+ */
+import { ActionType } from '../services/action-logger.js';
+import { logger } from '../utils/logger.js';
+export async function registerSwarmTools(registry) {
+    // ============================================================
+    // SPAWN_TEAM - Spawn a coordinated team of agents
+    // ============================================================
+    registry.registerTool('spawn_team', `Spawns a coordinated team of agents (swarm) that work together on a complex goal.
+
+## When to Use
+
+Use spawn_team instead of multiple spawn_task calls when:
+- Tasks are interdependent and agents need to see each other's results
+- You want automatic dependency-based execution ordering
+- Multiple agents need to collaborate toward a shared goal
+- A reviewer needs to validate work done by other agents
+
+## How It Works
+
+1. Define team members with roles, agent types, tasks, and dependencies
+2. Members are executed in **waves** based on their dependency graph:
+   - Wave 1: All members with no dependencies (run in parallel)
+   - Wave 2: Members whose dependencies are in Wave 1 (run in parallel)
+   - etc.
+3. Each subsequent wave's members automatically receive the results from their dependencies in their context
+4. A shared message queue allows tracking all inter-agent communication
+5. A shared state store holds key findings accessible by all members
+
+## Roles
+
+- **lead**: Coordinates the team. Usually spawned last with dependencies on all workers. Synthesizes final output.
+- **worker**: Executes an assigned sub-task. Reports results back.
+- **reviewer**: Reviews other agents' work. Typically depends on workers.
+
+## Example: Research + Implement + Review
+
+\`\`\`json
+{
+  "goal": "Add input validation to the user registration form",
+  "members": [
+    {
+      "agent_type": "explore",
+      "role": "worker",
+      "task": "Find the user registration form component and identify all input fields that need validation"
+    },
+    {
+      "agent_type": "explore",
+      "role": "worker",
+      "task": "Search for existing validation utilities and patterns used in this codebase"
+    },
+    {
+      "agent_type": "default",
+      "role": "worker",
+      "task": "Implement input validation for all registration form fields using the codebase's existing patterns",
+      "depends_on": ["member-0", "member-1"]
+    },
+    {
+      "agent_type": "code-reviewer",
+      "role": "reviewer",
+      "task": "Review the validation implementation for security issues and completeness",
+      "depends_on": ["member-2"]
+    }
+  ]
+}
+\`\`\`
+
+## Tips
+
+- Keep teams small (2-5 members) for efficiency
+- Use **explore** agents for initial research — they're fast and cheap
+- Put heavy work in **worker** roles with **default** or **debugger** agents
+- Add a **reviewer** at the end to catch issues
+- Dependencies reference member indices as "member-0", "member-1", etc.`, {
+        type: 'object',
+        properties: {
+            goal: {
+                type: 'string',
+                description: 'The team\'s shared objective — what should be accomplished overall',
+            },
+            members: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    properties: {
+                        agent_type: {
+                            type: 'string',
+                            enum: ['explore', 'code-reviewer', 'debugger', 'planner', 'default'],
+                            description: 'Type of agent to spawn for this member',
+                        },
+                        role: {
+                            type: 'string',
+                            enum: ['lead', 'worker', 'reviewer'],
+                            description: 'Role within the team',
+                        },
+                        task: {
+                            type: 'string',
+                            description: 'Specific task for this team member',
+                        },
+                        context: {
+                            type: 'string',
+                            description: 'Additional context for this member (code snippets, file paths, etc.)',
+                        },
+                        depends_on: {
+                            type: 'array',
+                            items: { type: 'string' },
+                            description: 'Member indices this agent depends on (e.g., ["member-0", "member-1"]). Agent will wait for these to complete and receive their results.',
+                        },
+                        max_turns: {
+                            type: 'number',
+                            description: 'Maximum turns for this member (overrides agent default)',
+                        },
+                        max_tokens: {
+                            type: 'number',
+                            description: 'Maximum tokens for this member (overrides agent default)',
+                        },
+                    },
+                    required: ['agent_type', 'role', 'task'],
+                },
+                description: 'Array of team members to spawn',
+            },
+        },
+        required: ['goal', 'members'],
+    }, async (input, context) => {
+        const { getTeamContextStore } = await import('../services/team-context-store.js');
+        const store = getTeamContextStore();
+        try {
+            const membersInput = input.members;
+            if (!membersInput || membersInput.length === 0) {
+                return { success: false, error: 'At least one team member is required' };
+            }
+            if (membersInput.length > 10) {
+                return { success: false, error: 'Maximum 10 team members allowed' };
+            }
+            // Resolve depends_on references (member-0, member-1, etc.)
+            // We'll resolve these to actual processIds during execution
+            // For now, store the member indices — the store resolves them internally
+            const members = membersInput.map((m, _idx) => ({
+                agentType: m.agent_type,
+                role: (m.role || 'worker'),
+                task: m.task,
+                context: m.context,
+                dependsOn: m.depends_on, // Will be resolved after spawning
+                budget: (m.max_turns || m.max_tokens) ? {
+                    strategy: 'fixed',
+                    maxTurns: m.max_turns,
+                    maxTokens: m.max_tokens,
+                } : undefined,
+            }));
+            const team = await store.spawnTeam({
+                goal: input.goal,
+                members,
+                projectRoot: context.projectRoot,
+                parentToolCallId: context.toolCallId,
+            });
+            // Wait for team to complete
+            const finalTeam = await store.waitForTeam(team.teamId);
+            return {
+                success: finalTeam.status === 'completed',
+                teamId: finalTeam.teamId,
+                status: finalTeam.status,
+                goal: finalTeam.goal,
+                memberCount: finalTeam.members.length,
+                results: finalTeam.results.map((r) => ({
+                    agentType: r.agentType,
+                    role: r.role,
+                    success: r.success,
+                    content: r.content,
+                    error: r.error,
+                    tokensUsed: r.tokensUsed,
+                    turnsUsed: r.turnsUsed,
+                    durationMs: r.durationMs,
+                })),
+                totalTokensUsed: finalTeam.results.reduce((sum, r) => sum + r.tokensUsed, 0),
+                totalDurationMs: finalTeam.results.reduce((sum, r) => sum + r.durationMs, 0),
+                messageCount: finalTeam.messages.length,
+            };
+        }
+        catch (err) {
+            const errorMessage = err instanceof Error ? err.message : 'Unknown error';
+            logger.error('spawn_team failed', err);
+            return {
+                success: false,
+                error: errorMessage,
+            };
+        }
+    }, {
+        actionType: ActionType.COMMAND_EXEC,
+        requiresApproval: false,
+        category: 'workflow',
+        tags: ['swarm', 'team', 'multi-agent', 'parallel', 'coordinate'],
+        displayName: 'Swarm',
+    });
+    // ============================================================
+    // GET_TEAM_STATUS - Check team status and results
+    // ============================================================
+    registry.registerTool('get_team_status', `Gets the current status of a team/swarm, including member statuses, results, and messages.
+
+Use this to:
+- Check progress of a running team
+- Retrieve all results after team completion
+- Read the team's message queue`, {
+        type: 'object',
+        properties: {
+            team_id: {
+                type: 'string',
+                description: 'The teamId returned from spawn_team',
+            },
+            include_messages: {
+                type: 'boolean',
+                description: 'Whether to include the team message queue (default: false)',
+            },
+            include_shared_state: {
+                type: 'boolean',
+                description: 'Whether to include the shared state store (default: false)',
+            },
+        },
+        required: ['team_id'],
+    }, async (input) => {
+        const { getTeamContextStore } = await import('../services/team-context-store.js');
+        const store = getTeamContextStore();
+        try {
+            const teamId = input.team_id;
+            const team = store.getTeam(teamId);
+            if (!team) {
+                return { success: false, error: `Team ${teamId} not found` };
+            }
+            const response = {
+                success: true,
+                teamId: team.teamId,
+                goal: team.goal,
+                status: team.status,
+                memberCount: team.members.length,
+                members: team.members.map((m) => ({
+                    agentType: m.agentType,
+                    role: m.role,
+                    status: m.status ?? 'pending',
+                    processId: m.processId,
+                    task: m.task.substring(0, 200) + (m.task.length > 200 ? '...' : ''),
+                })),
+                results: team.results.map((r) => ({
+                    agentType: r.agentType,
+                    role: r.role,
+                    success: r.success,
+                    content: r.content.substring(0, 500) + (r.content.length > 500 ? '...' : ''),
+                    error: r.error,
+                    tokensUsed: r.tokensUsed,
+                    durationMs: r.durationMs,
+                })),
+                createdAt: team.createdAt,
+                completedAt: team.completedAt,
+            };
+            if (input.include_messages) {
+                response.messages = team.messages.map((m) => ({
+                    from: m.fromAgentName,
+                    type: m.type,
+                    content: m.content.substring(0, 300),
+                    timestamp: m.timestamp,
+                }));
+            }
+            if (input.include_shared_state) {
+                response.sharedState = store.getAllSharedState(teamId);
+            }
+            return response;
+        }
+        catch (err) {
+            const errorMessage = err instanceof Error ? err.message : 'Unknown error';
+            return { success: false, error: errorMessage };
+        }
+    }, {
+        actionType: ActionType.FILE_READ,
+        requiresApproval: false,
+        category: 'workflow',
+        tags: ['swarm', 'team', 'status', 'check'],
+        displayName: 'Team Status',
+    });
+    // ============================================================
+    // LIST_TEAMS - List all teams
+    // ============================================================
+    registry.registerTool('list_teams', `Lists all agent teams/swarms and their current status.
+
+Use this to see active and completed teams.`, {
+        type: 'object',
+        properties: {
+            status: {
+                type: 'string',
+                enum: ['pending', 'running', 'completed', 'partial', 'failed', 'cancelled'],
+                description: 'Optional: filter by team status',
+            },
+        },
+    }, async (input) => {
+        const { getTeamContextStore } = await import('../services/team-context-store.js');
+        const store = getTeamContextStore();
+        try {
+            const filter = input.status ? { status: input.status } : undefined;
+            const teams = store.listTeams(filter);
+            return {
+                success: true,
+                count: teams.length,
+                teams: teams.map((t) => ({
+                    teamId: t.teamId,
+                    goal: t.goal.substring(0, 100) + (t.goal.length > 100 ? '...' : ''),
+                    status: t.status,
+                    memberCount: t.members.length,
+                    completedMembers: t.results.length,
+                    successfulMembers: t.results.filter((r) => r.success).length,
+                    createdAt: t.createdAt,
+                    completedAt: t.completedAt,
+                })),
+            };
+        }
+        catch (err) {
+            const errorMessage = err instanceof Error ? err.message : 'Unknown error';
+            return { success: false, error: errorMessage };
+        }
+    }, {
+        actionType: ActionType.FILE_READ,
+        requiresApproval: false,
+        category: 'workflow',
+        tags: ['swarm', 'team', 'list'],
+        displayName: 'List Teams',
+    });
+    // ============================================================
+    // CANCEL_TEAM - Cancel a running team
+    // ============================================================
+    registry.registerTool('cancel_team', `Cancels a running team/swarm and all its active member agents.
+
+Use this to stop a team that is no longer needed.`, {
+        type: 'object',
+        properties: {
+            team_id: {
+                type: 'string',
+                description: 'The teamId of the team to cancel',
+            },
+        },
+        required: ['team_id'],
+    }, async (input) => {
+        const { getTeamContextStore } = await import('../services/team-context-store.js');
+        const store = getTeamContextStore();
+        try {
+            const teamId = input.team_id;
+            await store.cancelTeam(teamId);
+            return {
+                success: true,
+                teamId,
+                message: `Team ${teamId} and all active members have been cancelled`,
+            };
+        }
+        catch (err) {
+            const errorMessage = err instanceof Error ? err.message : 'Unknown error';
+            return { success: false, error: errorMessage };
+        }
+    }, {
+        actionType: ActionType.COMMAND_EXEC,
+        requiresApproval: false,
+        category: 'workflow',
+        tags: ['swarm', 'team', 'cancel'],
+        displayName: 'Cancel Team',
+    });
+    // ============================================================
+    // TEAM_MESSAGE - Post a message to a team's queue
+    // ============================================================
+    registry.registerTool('team_message', `Posts a message to a team's shared message queue.
+
+Use this to inject information, instructions, or findings into a running team's communication channel.
+All team members in subsequent waves will see this message in their context.`, {
+        type: 'object',
+        properties: {
+            team_id: {
+                type: 'string',
+                description: 'The teamId to post the message to',
+            },
+            message: {
+                type: 'string',
+                description: 'The message content',
+            },
+            type: {
+                type: 'string',
+                enum: ['finding', 'request', 'status'],
+                description: 'Message type (default: "finding")',
+            },
+        },
+        required: ['team_id', 'message'],
+    }, async (input) => {
+        const { getTeamContextStore } = await import('../services/team-context-store.js');
+        const store = getTeamContextStore();
+        try {
+            const teamId = input.team_id;
+            const team = store.getTeam(teamId);
+            if (!team) {
+                return { success: false, error: `Team ${teamId} not found` };
+            }
+            const msg = store.postMessage(teamId, {
+                fromProcessId: 'parent',
+                fromAgentName: 'orchestrator',
+                toProcessId: '*',
+                type: input.type || 'finding',
+                content: input.message,
+            });
+            return {
+                success: true,
+                messageId: msg?.id,
+                teamId,
+            };
+        }
+        catch (err) {
+            const errorMessage = err instanceof Error ? err.message : 'Unknown error';
+            return { success: false, error: errorMessage };
+        }
+    }, {
+        actionType: ActionType.FILE_READ,
+        requiresApproval: false,
+        category: 'workflow',
+        tags: ['swarm', 'team', 'message', 'communicate'],
+        displayName: 'Team Message',
+    });
+}
+//# sourceMappingURL=swarm-tools.js.map

package/dist/tools/swarm-tools.js.map

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

package/dist/tools/user-tools.d.ts

@@ -0,0 +1,13 @@
+/**
+ * User interaction tools
+ *
+ * Tools for interacting with the user during task execution,
+ * including asking questions, gathering preferences, and
+ * clarifying requirements mid-execution.
+ */
+import type { ToolRegistry } from '../services/tool-registry.js';
+/**
+ * Registers user interaction tools with the tool registry
+ */
+export declare function registerUserTools(registry: ToolRegistry): void;
+//# sourceMappingURL=user-tools.d.ts.map

package/dist/tools/user-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-tools.d.ts","sourceRoot":"","sources":["../../src/tools/user-tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAkGjE;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAwK9D"}