init claude-code

tools/TaskListTool/TaskListTool.ts

@@ -0,0 +1,116 @@
+import { z } from 'zod/v4'
+import { buildTool, type ToolDef } from '../../Tool.js'
+import { lazySchema } from '../../utils/lazySchema.js'
+import {
+  getTaskListId,
+  isTodoV2Enabled,
+  listTasks,
+  TaskStatusSchema,
+} from '../../utils/tasks.js'
+import { TASK_LIST_TOOL_NAME } from './constants.js'
+import { DESCRIPTION, getPrompt } from './prompt.js'
+
+const inputSchema = lazySchema(() => z.strictObject({}))
+type InputSchema = ReturnType<typeof inputSchema>
+
+const outputSchema = lazySchema(() =>
+  z.object({
+    tasks: z.array(
+      z.object({
+        id: z.string(),
+        subject: z.string(),
+        status: TaskStatusSchema(),
+        owner: z.string().optional(),
+        blockedBy: z.array(z.string()),
+      }),
+    ),
+  }),
+)
+type OutputSchema = ReturnType<typeof outputSchema>
+
+export type Output = z.infer<OutputSchema>
+
+export const TaskListTool = buildTool({
+  name: TASK_LIST_TOOL_NAME,
+  searchHint: 'list all tasks',
+  maxResultSizeChars: 100_000,
+  async description() {
+    return DESCRIPTION
+  },
+  async prompt() {
+    return getPrompt()
+  },
+  get inputSchema(): InputSchema {
+    return inputSchema()
+  },
+  get outputSchema(): OutputSchema {
+    return outputSchema()
+  },
+  userFacingName() {
+    return 'TaskList'
+  },
+  shouldDefer: true,
+  isEnabled() {
+    return isTodoV2Enabled()
+  },
+  isConcurrencySafe() {
+    return true
+  },
+  isReadOnly() {
+    return true
+  },
+  renderToolUseMessage() {
+    return null
+  },
+  async call() {
+    const taskListId = getTaskListId()
+
+    const allTasks = (await listTasks(taskListId)).filter(
+      t => !t.metadata?._internal,
+    )
+
+    // Build a set of resolved task IDs for filtering
+    const resolvedTaskIds = new Set(
+      allTasks.filter(t => t.status === 'completed').map(t => t.id),
+    )
+
+    const tasks = allTasks.map(task => ({
+      id: task.id,
+      subject: task.subject,
+      status: task.status,
+      owner: task.owner,
+      blockedBy: task.blockedBy.filter(id => !resolvedTaskIds.has(id)),
+    }))
+
+    return {
+      data: {
+        tasks,
+      },
+    }
+  },
+  mapToolResultToToolResultBlockParam(content, toolUseID) {
+    const { tasks } = content as Output
+    if (tasks.length === 0) {
+      return {
+        tool_use_id: toolUseID,
+        type: 'tool_result',
+        content: 'No tasks found',
+      }
+    }
+
+    const lines = tasks.map(task => {
+      const owner = task.owner ? ` (${task.owner})` : ''
+      const blocked =
+        task.blockedBy.length > 0
+          ? ` [blocked by ${task.blockedBy.map(id => `#${id}`).join(', ')}]`
+          : ''
+      return `#${task.id} [${task.status}] ${task.subject}${owner}${blocked}`
+    })
+
+    return {
+      tool_use_id: toolUseID,
+      type: 'tool_result',
+      content: lines.join('\n'),
+    }
+  },
+} satisfies ToolDef<InputSchema, Output>)

tools/TaskListTool/constants.ts

@@ -0,0 +1 @@
+export const TASK_LIST_TOOL_NAME = 'TaskList'

tools/TaskListTool/prompt.ts

@@ -0,0 +1,49 @@
+import { isAgentSwarmsEnabled } from '../../utils/agentSwarmsEnabled.js'
+
+export const DESCRIPTION = 'List all tasks in the task list'
+
+export function getPrompt(): string {
+  const teammateUseCase = isAgentSwarmsEnabled()
+    ? `- Before assigning tasks to teammates, to see what's available
+`
+    : ''
+
+  const idDescription = isAgentSwarmsEnabled()
+    ? '- **id**: Task identifier (use with TaskGet, TaskUpdate)'
+    : '- **id**: Task identifier (use with TaskGet, TaskUpdate)'
+
+  const teammateWorkflow = isAgentSwarmsEnabled()
+    ? `
+## Teammate Workflow
+
+When working as a teammate:
+1. After completing your current task, call TaskList to find available work
+2. Look for tasks with status 'pending', no owner, and empty blockedBy
+3. **Prefer tasks in ID order** (lowest ID first) when multiple tasks are available, as earlier tasks often set up context for later ones
+4. Claim an available task using TaskUpdate (set \`owner\` to your name), or wait for leader assignment
+5. If blocked, focus on unblocking tasks or notify the team lead
+`
+    : ''
+
+  return `Use this tool to list all tasks in the task list.
+
+## When to Use This Tool
+
+- To see what tasks are available to work on (status: 'pending', no owner, not blocked)
+- To check overall progress on the project
+- To find tasks that are blocked and need dependencies resolved
+${teammateUseCase}- After completing a task, to check for newly unblocked work or claim the next available task
+- **Prefer working on tasks in ID order** (lowest ID first) when multiple tasks are available, as earlier tasks often set up context for later ones
+
+## Output
+
+Returns a summary of each task:
+${idDescription}
+- **subject**: Brief description of the task
+- **status**: 'pending', 'in_progress', or 'completed'
+- **owner**: Agent ID if assigned, empty if available
+- **blockedBy**: List of open task IDs that must be resolved first (tasks with blockedBy cannot be claimed until dependencies resolve)
+
+Use TaskGet with a specific task ID to view full details including description and comments.
+${teammateWorkflow}`
+}