refactor(background-agent): split manager.ts into focused modules

Extract 30+ single-responsibility modules from manager.ts (1556 LOC): - task lifecycle: task-starter, task-completer, task-canceller, task-resumer - task queries: task-queries, task-poller, task-queue-processor - notifications: notification-builder, notification-tracker, parent-session-notifier - session handling: session-validator, session-output-validator, session-todo-checker - spawner: spawner/ directory with focused spawn modules - utilities: duration-formatter, error-classifier, message-storage-locator - result handling: result-handler-context, background-task-completer - shutdown: background-manager-shutdown, process-signal
2026-02-08 16:20:52 +09:00
parent 3ec0a4f5a4
commit fdcee08460
43 changed files with 2753 additions and 2071 deletions
@@ -0,0 +1,97 @@
+import { log } from "../../shared"
+import { subagentSessions } from "../claude-code-session-state"
+
+import type { BackgroundTask } from "./types"
+import type { ConcurrencyManager } from "./concurrency"
+
+export async function trackExternalTask(args: {
+  input: {
+    taskId: string
+    sessionID: string
+    parentSessionID: string
+    description: string
+    agent?: string
+    parentAgent?: string
+    concurrencyKey?: string
+  }
+  tasks: Map<string, BackgroundTask>
+  pendingByParent: Map<string, Set<string>>
+  concurrencyManager: ConcurrencyManager
+  startPolling: () => void
+  cleanupPendingByParent: (task: BackgroundTask) => void
+}): Promise<BackgroundTask> {
+  const { input, tasks, pendingByParent, concurrencyManager, startPolling, cleanupPendingByParent } = args
+
+  const existingTask = tasks.get(input.taskId)
+  if (existingTask) {
+    const parentChanged = input.parentSessionID !== existingTask.parentSessionID
+    if (parentChanged) {
+      cleanupPendingByParent(existingTask)
+      existingTask.parentSessionID = input.parentSessionID
+    }
+    if (input.parentAgent !== undefined) {
+      existingTask.parentAgent = input.parentAgent
+    }
+    if (!existingTask.concurrencyGroup) {
+      existingTask.concurrencyGroup = input.concurrencyKey ?? existingTask.agent
+    }
+
+    if (existingTask.sessionID) {
+      subagentSessions.add(existingTask.sessionID)
+    }
+    startPolling()
+
+    if (existingTask.status === "pending" || existingTask.status === "running") {
+      const pending = pendingByParent.get(input.parentSessionID) ?? new Set<string>()
+      pending.add(existingTask.id)
+      pendingByParent.set(input.parentSessionID, pending)
+    } else if (!parentChanged) {
+      cleanupPendingByParent(existingTask)
+    }
+
+    log("[background-agent] External task already registered:", {
+      taskId: existingTask.id,
+      sessionID: existingTask.sessionID,
+      status: existingTask.status,
+    })
+
+    return existingTask
+  }
+
+  const concurrencyGroup = input.concurrencyKey ?? input.agent ?? "task"
+  if (input.concurrencyKey) {
+    await concurrencyManager.acquire(input.concurrencyKey)
+  }
+
+  const task: BackgroundTask = {
+    id: input.taskId,
+    sessionID: input.sessionID,
+    parentSessionID: input.parentSessionID,
+    parentMessageID: "",
+    description: input.description,
+    prompt: "",
+    agent: input.agent || "task",
+    status: "running",
+    startedAt: new Date(),
+    progress: {
+      toolCalls: 0,
+      lastUpdate: new Date(),
+    },
+    parentAgent: input.parentAgent,
+    concurrencyKey: input.concurrencyKey,
+    concurrencyGroup,
+  }
+
+  tasks.set(task.id, task)
+  subagentSessions.add(input.sessionID)
+  startPolling()
+
+  if (input.parentSessionID) {
+    const pending = pendingByParent.get(input.parentSessionID) ?? new Set<string>()
+    pending.add(task.id)
+    pendingByParent.set(input.parentSessionID, pending)
+  }
+
+  log("[background-agent] Registered external task:", { taskId: task.id, sessionID: input.sessionID })
+  return task
+}