import type { BackgroundManager } from "../../features/background-agent" import { clearInbox, ensureInbox, sendPlainInboxMessage } from "./inbox-store" import { assignNextColor, getTeamMember, removeTeammate, updateTeamConfig, upsertTeammate } from "./team-config-store" import type { TeamTeammateMember, TeamToolContext } from "./types" function parseModel(model: string | undefined): { providerID: string; modelID: string } | undefined { if (!model) { return undefined } const [providerID, modelID] = model.split("/", 2) if (!providerID || !modelID) { throw new Error("invalid_model_override_format") } return { providerID, modelID } } function delay(ms: number): Promise { return new Promise((resolve) => setTimeout(resolve, ms)) } function resolveLaunchFailureMessage(status: string | undefined, error: string | undefined): string { if (status === "error") { return error ? `teammate_launch_failed:${error}` : "teammate_launch_failed" } if (status === "cancelled") { return "teammate_launch_cancelled" } return "teammate_launch_timeout" } function buildLaunchPrompt(teamName: string, teammateName: string, userPrompt: string): string { return [ `You are teammate "${teammateName}" in team "${teamName}".`, `When you need updates, call read_inbox with team_name="${teamName}" and agent_name="${teammateName}".`, "Initial assignment:", userPrompt, ].join("\n\n") } function buildDeliveryPrompt(teamName: string, teammateName: string, summary: string, content: string): string { return [ `New team message for "${teammateName}" in team "${teamName}".`, `Summary: ${summary}`, "Content:", content, ].join("\n\n") } export interface SpawnTeammateParams { teamName: string name: string prompt: string subagentType: string model?: string planModeRequired: boolean context: TeamToolContext manager: BackgroundManager } export async function spawnTeammate(params: SpawnTeammateParams): Promise { let teammate: TeamTeammateMember | undefined let launchedTaskID: string | undefined updateTeamConfig(params.teamName, (current) => { if (getTeamMember(current, params.name)) { throw new Error("teammate_already_exists") } teammate = { agentId: `${params.name}@${params.teamName}`, name: params.name, agentType: params.subagentType, model: params.model ?? "native", prompt: params.prompt, color: assignNextColor(current), planModeRequired: params.planModeRequired, joinedAt: Date.now(), cwd: process.cwd(), subscriptions: [], backendType: "native", isActive: false, } return upsertTeammate(current, teammate) }) if (!teammate) { throw new Error("teammate_create_failed") } ensureInbox(params.teamName, params.name) sendPlainInboxMessage(params.teamName, "team-lead", params.name, params.prompt, "initial_prompt", teammate.color) try { const resolvedModel = parseModel(params.model) const launched = await params.manager.launch({ description: `[team:${params.teamName}] ${params.name}`, prompt: buildLaunchPrompt(params.teamName, params.name, params.prompt), agent: params.subagentType, parentSessionID: params.context.sessionID, parentMessageID: params.context.messageID, ...(resolvedModel ? { model: resolvedModel } : {}), parentAgent: params.context.agent, }) launchedTaskID = launched.id const start = Date.now() let sessionID = launched.sessionID let latestStatus: string | undefined let latestError: string | undefined while (!sessionID && Date.now() - start < 30_000) { await delay(50) const task = params.manager.getTask(launched.id) latestStatus = task?.status latestError = task?.error if (task?.status === "error" || task?.status === "cancelled") { throw new Error(resolveLaunchFailureMessage(task.status, task.error)) } sessionID = task?.sessionID } if (!sessionID) { throw new Error(resolveLaunchFailureMessage(latestStatus, latestError)) } const nextMember: TeamTeammateMember = { ...teammate, isActive: true, backgroundTaskID: launched.id, sessionID, } updateTeamConfig(params.teamName, (current) => upsertTeammate(current, nextMember)) return nextMember } catch (error) { if (launchedTaskID) { await params.manager .cancelTask(launchedTaskID, { source: "team_launch_failed", abortSession: true, skipNotification: true, }) .catch(() => undefined) } updateTeamConfig(params.teamName, (current) => removeTeammate(current, params.name)) clearInbox(params.teamName, params.name) throw error } } export async function resumeTeammateWithMessage( manager: BackgroundManager, context: TeamToolContext, teamName: string, teammate: TeamTeammateMember, summary: string, content: string, ): Promise { if (!teammate.sessionID) { return } try { await manager.resume({ sessionId: teammate.sessionID, prompt: buildDeliveryPrompt(teamName, teammate.name, summary, content), parentSessionID: context.sessionID, parentMessageID: context.messageID, parentAgent: context.agent, }) } catch { return } } export async function cancelTeammateRun(manager: BackgroundManager, teammate: TeamTeammateMember): Promise { if (!teammate.backgroundTaskID) { return } await manager.cancelTask(teammate.backgroundTaskID, { source: "team_force_kill", abortSession: true, skipNotification: true, }) }