@finityno/claude-code-acp 0.15.0 → 0.17.0

package/dist/acp-agent.d.ts

@@ -3,6 +3,7 @@ import { SettingsManager } from "./settings.js";
 import { CanUseTool, Options, PermissionMode, Query, SDKPartialAssistantMessage, SDKUserMessage } from "@anthropic-ai/claude-agent-sdk";
 import { Pushable } from "./utils.js";
 import { SubagentTracker } from "./subagent-tracker.js";
+import { TaskStore } from "./task-store.js";
 import { ContentBlockParam } from "@anthropic-ai/sdk/resources";
 import { BetaContentBlock, BetaRawContentBlockDelta } from "@anthropic-ai/sdk/resources/beta.mjs";
 export declare const CLAUDE_CONFIG_DIR: string;
@@ -83,6 +84,8 @@ export declare class ClaudeAcpAgent implements Agent {
     clientCapabilities?: ClientCapabilities;
     logger: Logger;
     subagentTracker: SubagentTracker;
+    taskStore: TaskStore;
+    taskListId: string;
     constructor(client: AgentSideConnection, logger?: Logger);
     initialize(request: InitializeRequest): Promise<InitializeResponse>;
     newSession(params: NewSessionRequest): Promise<NewSessionResponse>;

package/dist/acp-agent.d.ts.map

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

package/dist/acp-agent.js

@@ -9,6 +9,7 @@ import { createMcpServer } from "./mcp-server.js";
 import { EDIT_TOOL_NAMES, acpToolNames } from "./tools.js";
 import { toolInfoFromToolUse, planEntries, toolUpdateFromToolResult, registerHookCallback, createPostToolUseHook, createPreToolUseHook, } from "./tools.js";
 import { SubagentTracker, isTaskToolInput, } from "./subagent-tracker.js";
+import { TaskStore } from "./task-store.js";
 import packageJson from "../package.json" with { type: "json" };
 import { randomUUID } from "node:crypto";
 export const CLAUDE_CONFIG_DIR = process.env.CLAUDE ?? path.join(os.homedir(), ".claude");
@@ -23,6 +24,37 @@ export class ClaudeAcpAgent {
         this.toolUseCache = {};
         this.logger = logger ?? console;
         this.subagentTracker = new SubagentTracker(client, this.logger);
+        // Initialize TaskStore (use provided task list ID or auto-generate one)
+        const taskListId = process.env.CLAUDE_CODE_TASK_LIST_ID || crypto.randomUUID();
+        this.taskListId = taskListId;
+        this.taskStore = new TaskStore({
+            taskListId,
+            logger: this.logger,
+            onChange: (tasks) => {
+                // Broadcast task updates to all sessions
+                for (const sessionId of Object.keys(this.sessions)) {
+                    this.client.sessionUpdate({
+                        sessionId,
+                        update: {
+                            sessionUpdate: "tool_call_update",
+                            toolCallId: "task-list-update",
+                            _meta: {
+                                claudeCode: {
+                                    taskListUpdate: {
+                                        taskListId,
+                                        tasks,
+                                    },
+                                },
+                            },
+                        },
+                    });
+                }
+            },
+        });
+        // Initialize and start watching for changes
+        this.taskStore.init().then(() => {
+            this.taskStore.watch();
+        });
     }
     async initialize(request) {
         this.clientCapabilities = request.clientCapabilities;
@@ -583,7 +615,7 @@ export class ClaudeAcpAgent {
         }
         // Only add the acp MCP server if built-in tools are not disabled
         if (!params._meta?.disableBuiltInTools) {
-            const server = createMcpServer(this, sessionId, this.clientCapabilities);
+            const server = createMcpServer(this, sessionId, this.clientCapabilities, this.taskStore);
             mcpServers["acp"] = {
                 type: "sdk",
                 name: "acp",
@@ -614,12 +646,21 @@ export class ClaudeAcpAgent {
         const maxThinkingTokens = process.env.MAX_THINKING_TOKENS
             ? parseInt(process.env.MAX_THINKING_TOKENS, 10)
             : undefined;
+        // Build env with task list ID if configured
+        const sdkEnv = {
+            ...userProvidedOptions?.env,
+        };
+        if (this.taskListId) {
+            sdkEnv.CLAUDE_CODE_TASK_LIST_ID = this.taskListId;
+        }
         const options = {
             systemPrompt,
             settingSources: ["user", "project", "local"],
             stderr: (err) => this.logger.error(err),
             ...(maxThinkingTokens !== undefined && { maxThinkingTokens }),
             ...userProvidedOptions,
+            // Pass task list ID to SDK so Claude's internal tools share our task list
+            ...(Object.keys(sdkEnv).length > 0 && { env: sdkEnv }),
             // Override certain fields that must be controlled by ACP
             cwd: params.cwd,
             includePartialMessages: true,

package/dist/lib.d.ts

@@ -6,5 +6,7 @@ export { SettingsManager, type ClaudeCodeSettings, type PermissionSettings, type
 export { SubagentTracker, isTaskToolInput, extractSubagentMeta, type TrackedSubagent, type SubagentStatus, type SubagentType, type SubagentEventType, type SubagentUpdateMeta, type SubagentEventListener, type SubagentStats, type TaskToolInput, type SerializedTrackerState, type SerializedTask, type SDKTaskNotification, } from "./subagent-tracker.js";
 export { TaskManager, type TaskManagerOptions, type TaskFilter, } from "./task-manager.js";
 export { registerTaskMcpTools, type TaskMcpToolsOptions } from "./task-mcp-tools.js";
+export { TaskStore, type Task, type TaskStatus, type TaskCreateInput, type TaskUpdateInput, type TaskStoreOptions, } from "./task-store.js";
+export { registerWorkItemMcpTools, type WorkItemMcpToolsOptions, } from "./work-item-mcp-tools.js";
 export type { ClaudePlanEntry } from "./tools.js";
 //# sourceMappingURL=lib.d.ts.map

package/dist/lib.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EACd,MAAM,EACN,kBAAkB,EAClB,6BAA6B,EAC7B,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,iBAAiB,EACjB,iBAAiB,EACjB,QAAQ,EACR,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,wBAAwB,EACxB,oBAAoB,EACpB,YAAY,IAAI,SAAS,EACzB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,eAAe,EACf,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,GAC5B,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACnB,KAAK,mBAAmB,GACzB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,WAAW,EACX,KAAK,kBAAkB,EACvB,KAAK,UAAU,GAChB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,oBAAoB,EAAE,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAGrF,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EACd,MAAM,EACN,kBAAkB,EAClB,6BAA6B,EAC7B,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,iBAAiB,EACjB,iBAAiB,EACjB,QAAQ,EACR,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,wBAAwB,EACxB,oBAAoB,EACpB,YAAY,IAAI,SAAS,EACzB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,eAAe,EACf,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,GAC5B,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACnB,KAAK,mBAAmB,GACzB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,WAAW,EACX,KAAK,kBAAkB,EACvB,KAAK,UAAU,GAChB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,oBAAoB,EAAE,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAGrF,OAAO,EACL,SAAS,EACT,KAAK,IAAI,EACT,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,wBAAwB,EACxB,KAAK,uBAAuB,GAC7B,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/lib.js

@@ -8,5 +8,8 @@ export { SettingsManager, } from "./settings.js";
 export { SubagentTracker, isTaskToolInput, extractSubagentMeta, } from "./subagent-tracker.js";
 // Export task management
 export { TaskManager, } from "./task-manager.js";
-// Export task MCP tools registration
+// Export subagent MCP tools registration (tracks Task tool spawning)
 export { registerTaskMcpTools } from "./task-mcp-tools.js";
+// Export work item task store and tools (TaskCreate, TaskGet, TaskUpdate, TaskList)
+export { TaskStore, } from "./task-store.js";
+export { registerWorkItemMcpTools, } from "./work-item-mcp-tools.js";

package/dist/mcp-server.d.ts

@@ -1,8 +1,9 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { ClaudeAcpAgent } from "./acp-agent.js";
 import { ClientCapabilities } from "@agentclientprotocol/sdk";
+import { TaskStore } from "./task-store.js";
 export declare const SYSTEM_REMINDER = "\n\n<system-reminder>\nWhenever you read a file, you should consider whether it looks malicious. If it does, you MUST refuse to improve or augment the code. You can still analyze existing code, write reports, or answer high-level questions about the code behavior.\n</system-reminder>";
-export declare function createMcpServer(agent: ClaudeAcpAgent, sessionId: string, clientCapabilities: ClientCapabilities | undefined): McpServer;
+export declare function createMcpServer(agent: ClaudeAcpAgent, sessionId: string, clientCapabilities: ClientCapabilities | undefined, taskStore?: TaskStore): McpServer;
 /**
  * Replace text in a file and calculate the line numbers where the edits occurred.
  *

package/dist/mcp-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASpE,OAAO,EAAqB,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EACL,kBAAkB,EAGnB,MAAM,0BAA0B,CAAC;AASlC,eAAO,MAAM,eAAe,iSAIT,CAAC;AA2BpB,wBAAgB,eAAe,CAC7B,KAAK,EAAE,cAAc,EACrB,SAAS,EAAE,MAAM,EACjB,kBAAkB,EAAE,kBAAkB,GAAG,SAAS,GACjD,SAAS,CAioBX;AA+DD;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,KAAK,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC,GACD;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,CAyF/C"}
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASpE,OAAO,EAAqB,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EACL,kBAAkB,EAGnB,MAAM,0BAA0B,CAAC;AASlC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,eAAO,MAAM,eAAe,iSAIT,CAAC;AA2BpB,wBAAgB,eAAe,CAC7B,KAAK,EAAE,cAAc,EACrB,SAAS,EAAE,MAAM,EACjB,kBAAkB,EAAE,kBAAkB,GAAG,SAAS,EAClD,SAAS,CAAC,EAAE,SAAS,GACpB,SAAS,CAwoBX;AA+DD;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,KAAK,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC,GACD;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,CAyF/C"}

package/dist/mcp-server.js

@@ -58,6 +58,7 @@ import * as path from "node:path";
 import * as fs from "node:fs/promises";
 import { sleep, unreachable, extractLinesWithByteLimit } from "./utils.js";
 import { registerTaskMcpTools } from "./task-mcp-tools.js";
+import { registerWorkItemMcpTools } from "./work-item-mcp-tools.js";
 import { acpToolNames } from "./tools.js";
 export const SYSTEM_REMINDER = `
 
@@ -87,7 +88,7 @@ const unqualifiedToolNames = {
     killShell: "KillShell",
     bashOutput: "BashOutput",
 };
-export function createMcpServer(agent, sessionId, clientCapabilities) {
+export function createMcpServer(agent, sessionId, clientCapabilities, taskStore) {
     /**
      * This checks if a given path is related to internal agent persistence and if the agent should be allowed to read/write from here.
      * We let the agent do normal fs operations on these paths so that it can persist its state.
@@ -650,11 +651,17 @@ In sessions with ${acpToolNames.killShell} always use it instead of KillShell.`,
             }
         });
     }
-    // Register task management tools
+    // Register subagent tracking tools (for Task tool spawning)
     registerTaskMcpTools(server, {
         tracker: agent.subagentTracker,
         sessionId,
     });
+    // Register work item task tools (TaskCreate, TaskGet, TaskUpdate, TaskList)
+    if (taskStore) {
+        registerWorkItemMcpTools(server, {
+            taskStore,
+        });
+    }
     return server;
 }
 function stripCommonPrefix(a, b) {

package/dist/task-store.d.ts

@@ -0,0 +1,123 @@
+import { Logger } from "./acp-agent.js";
+/**
+ * Task status matching Claude Code's internal system
+ */
+export type TaskStatus = "pending" | "in_progress" | "completed";
+/**
+ * Task structure matching Claude Code's ~/.claude/tasks/ format
+ */
+export interface Task {
+    id: string;
+    subject: string;
+    description: string;
+    activeForm: string;
+    status: TaskStatus;
+    owner?: string;
+    blocks: string[];
+    blockedBy: string[];
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Input for creating a new task
+ */
+export interface TaskCreateInput {
+    subject: string;
+    description: string;
+    activeForm?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Input for updating a task
+ */
+export interface TaskUpdateInput {
+    status?: TaskStatus;
+    subject?: string;
+    description?: string;
+    activeForm?: string;
+    owner?: string;
+    addBlocks?: string[];
+    addBlockedBy?: string[];
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Options for TaskStore
+ */
+export interface TaskStoreOptions {
+    /** Task list ID (UUID or custom ID) */
+    taskListId: string;
+    /** Base path for task storage (default: ~/.claude/tasks) */
+    basePath?: string;
+    /** Logger instance */
+    logger?: Logger;
+    /** Callback when tasks change (from file watcher) */
+    onChange?: (tasks: Task[]) => void;
+}
+/**
+ * TaskStore manages reading/writing tasks to ~/.claude/tasks/
+ * Compatible with Claude Code's internal task system
+ */
+export declare class TaskStore {
+    private taskListId;
+    private basePath;
+    private logger;
+    private onChange?;
+    private watcher;
+    private nextId;
+    private initialized;
+    constructor(options: TaskStoreOptions);
+    /**
+     * Get the directory path for this task list
+     */
+    get taskListPath(): string;
+    /**
+     * Initialize the task store (create directory, determine next ID)
+     */
+    init(): Promise<void>;
+    /**
+     * Create a new task
+     */
+    create(input: TaskCreateInput): Promise<Task>;
+    /**
+     * Get a task by ID
+     */
+    get(taskId: string): Promise<Task | null>;
+    /**
+     * Update a task
+     */
+    update(taskId: string, input: TaskUpdateInput): Promise<Task>;
+    /**
+     * List all tasks
+     */
+    list(): Promise<Task[]>;
+    /**
+     * Delete a task
+     */
+    delete(taskId: string): Promise<boolean>;
+    /**
+     * Start watching for changes from other sessions
+     */
+    watch(): Promise<void>;
+    /**
+     * Stop watching for changes
+     */
+    close(): void;
+    /**
+     * Get task statistics
+     */
+    getStats(): Promise<{
+        total: number;
+        pending: number;
+        inProgress: number;
+        completed: number;
+        blocked: number;
+    }>;
+    private getTaskFilePath;
+    private saveTask;
+    /**
+     * Generate activeForm from subject (convert to present participle)
+     * "Fix bug" -> "Fixing bug"
+     * "Add feature" -> "Adding feature"
+     */
+    private generateActiveForm;
+}
+//# sourceMappingURL=task-store.d.ts.map

package/dist/task-store.d.ts.map

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

package/dist/task-store.js

@@ -0,0 +1,292 @@
+import { mkdir, readFile, writeFile, readdir, rm } from "fs/promises";
+import { join } from "path";
+import { homedir } from "os";
+/**
+ * TaskStore manages reading/writing tasks to ~/.claude/tasks/
+ * Compatible with Claude Code's internal task system
+ */
+export class TaskStore {
+    constructor(options) {
+        this.watcher = null;
+        this.nextId = 1;
+        this.initialized = false;
+        this.taskListId = options.taskListId;
+        this.basePath = options.basePath ?? join(homedir(), ".claude", "tasks");
+        this.logger = options.logger ?? console;
+        this.onChange = options.onChange;
+    }
+    /**
+     * Get the directory path for this task list
+     */
+    get taskListPath() {
+        return join(this.basePath, this.taskListId);
+    }
+    /**
+     * Initialize the task store (create directory, determine next ID)
+     */
+    async init() {
+        if (this.initialized)
+            return;
+        try {
+            await mkdir(this.taskListPath, { recursive: true });
+            // Determine next ID from existing tasks
+            const tasks = await this.list();
+            if (tasks.length > 0) {
+                const maxId = Math.max(...tasks.map((t) => parseInt(t.id, 10) || 0));
+                this.nextId = maxId + 1;
+            }
+            this.initialized = true;
+            this.logger.log(`[TaskStore] Initialized at ${this.taskListPath}, next ID: ${this.nextId}`);
+        }
+        catch (err) {
+            this.logger.error(`[TaskStore] Failed to initialize:`, err);
+            throw err;
+        }
+    }
+    /**
+     * Create a new task
+     */
+    async create(input) {
+        await this.init();
+        const task = {
+            id: String(this.nextId++),
+            subject: input.subject,
+            description: input.description,
+            activeForm: input.activeForm ?? this.generateActiveForm(input.subject),
+            status: "pending",
+            blocks: [],
+            blockedBy: [],
+            metadata: input.metadata,
+        };
+        await this.saveTask(task);
+        this.logger.log(`[TaskStore] Created task ${task.id}: ${task.subject}`);
+        return task;
+    }
+    /**
+     * Get a task by ID
+     */
+    async get(taskId) {
+        await this.init();
+        const filePath = this.getTaskFilePath(taskId);
+        try {
+            const content = await readFile(filePath, "utf8");
+            return JSON.parse(content);
+        }
+        catch (err) {
+            if (err.code === "ENOENT") {
+                return null;
+            }
+            throw err;
+        }
+    }
+    /**
+     * Update a task
+     */
+    async update(taskId, input) {
+        await this.init();
+        const task = await this.get(taskId);
+        if (!task) {
+            throw new Error(`Task not found: ${taskId}`);
+        }
+        // Apply updates
+        if (input.status !== undefined)
+            task.status = input.status;
+        if (input.subject !== undefined)
+            task.subject = input.subject;
+        if (input.description !== undefined)
+            task.description = input.description;
+        if (input.activeForm !== undefined)
+            task.activeForm = input.activeForm;
+        if (input.owner !== undefined)
+            task.owner = input.owner;
+        // Handle blocks/blockedBy additions
+        if (input.addBlocks) {
+            for (const blockId of input.addBlocks) {
+                if (!task.blocks.includes(blockId)) {
+                    task.blocks.push(blockId);
+                }
+                // Also update the blocked task's blockedBy
+                const blockedTask = await this.get(blockId);
+                if (blockedTask && !blockedTask.blockedBy.includes(taskId)) {
+                    blockedTask.blockedBy.push(taskId);
+                    await this.saveTask(blockedTask);
+                }
+            }
+        }
+        if (input.addBlockedBy) {
+            for (const blockerId of input.addBlockedBy) {
+                if (!task.blockedBy.includes(blockerId)) {
+                    task.blockedBy.push(blockerId);
+                }
+                // Also update the blocking task's blocks
+                const blockerTask = await this.get(blockerId);
+                if (blockerTask && !blockerTask.blocks.includes(taskId)) {
+                    blockerTask.blocks.push(taskId);
+                    await this.saveTask(blockerTask);
+                }
+            }
+        }
+        // Merge metadata
+        if (input.metadata) {
+            task.metadata = { ...task.metadata, ...input.metadata };
+            // Remove null values (deletion)
+            for (const [key, value] of Object.entries(input.metadata)) {
+                if (value === null && task.metadata) {
+                    delete task.metadata[key];
+                }
+            }
+        }
+        // When completing a task, update blockedBy for tasks it blocks
+        if (input.status === "completed") {
+            for (const blockedId of task.blocks) {
+                const blockedTask = await this.get(blockedId);
+                if (blockedTask) {
+                    blockedTask.blockedBy = blockedTask.blockedBy.filter((id) => id !== taskId);
+                    await this.saveTask(blockedTask);
+                }
+            }
+        }
+        await this.saveTask(task);
+        this.logger.log(`[TaskStore] Updated task ${taskId}: ${task.subject} -> ${task.status}`);
+        return task;
+    }
+    /**
+     * List all tasks
+     */
+    async list() {
+        await this.init();
+        try {
+            const files = await readdir(this.taskListPath);
+            const tasks = [];
+            for (const file of files) {
+                if (!file.endsWith(".json"))
+                    continue;
+                const taskId = file.replace(".json", "");
+                const task = await this.get(taskId);
+                if (task)
+                    tasks.push(task);
+            }
+            // Sort by ID (numeric)
+            return tasks.sort((a, b) => parseInt(a.id, 10) - parseInt(b.id, 10));
+        }
+        catch (err) {
+            if (err.code === "ENOENT") {
+                return [];
+            }
+            throw err;
+        }
+    }
+    /**
+     * Delete a task
+     */
+    async delete(taskId) {
+        await this.init();
+        const task = await this.get(taskId);
+        if (!task)
+            return false;
+        // Remove from blocks/blockedBy of other tasks
+        for (const blockedId of task.blocks) {
+            const blockedTask = await this.get(blockedId);
+            if (blockedTask) {
+                blockedTask.blockedBy = blockedTask.blockedBy.filter((id) => id !== taskId);
+                await this.saveTask(blockedTask);
+            }
+        }
+        for (const blockerId of task.blockedBy) {
+            const blockerTask = await this.get(blockerId);
+            if (blockerTask) {
+                blockerTask.blocks = blockerTask.blocks.filter((id) => id !== taskId);
+                await this.saveTask(blockerTask);
+            }
+        }
+        try {
+            await rm(this.getTaskFilePath(taskId));
+            this.logger.log(`[TaskStore] Deleted task ${taskId}`);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Start watching for changes from other sessions
+     */
+    async watch() {
+        if (this.watcher)
+            return;
+        await this.init();
+        try {
+            const fsWatch = await import("fs");
+            this.watcher = fsWatch.watch(this.taskListPath, async (eventType, filename) => {
+                if (!filename?.endsWith(".json"))
+                    return;
+                this.logger.log(`[TaskStore] File change detected: ${eventType} ${filename}`);
+                if (this.onChange) {
+                    const tasks = await this.list();
+                    this.onChange(tasks);
+                }
+            });
+            this.logger.log(`[TaskStore] Watching for changes at ${this.taskListPath}`);
+        }
+        catch (err) {
+            this.logger.error(`[TaskStore] Failed to start watcher:`, err);
+        }
+    }
+    /**
+     * Stop watching for changes
+     */
+    close() {
+        if (this.watcher) {
+            this.watcher.close();
+            this.watcher = null;
+            this.logger.log(`[TaskStore] Stopped watching`);
+        }
+    }
+    /**
+     * Get task statistics
+     */
+    async getStats() {
+        const tasks = await this.list();
+        return {
+            total: tasks.length,
+            pending: tasks.filter((t) => t.status === "pending").length,
+            inProgress: tasks.filter((t) => t.status === "in_progress").length,
+            completed: tasks.filter((t) => t.status === "completed").length,
+            blocked: tasks.filter((t) => t.blockedBy.length > 0 && t.status !== "completed").length,
+        };
+    }
+    // Private helpers
+    getTaskFilePath(taskId) {
+        return join(this.taskListPath, `${taskId}.json`);
+    }
+    async saveTask(task) {
+        const filePath = this.getTaskFilePath(task.id);
+        await writeFile(filePath, JSON.stringify(task, null, 2), "utf8");
+    }
+    /**
+     * Generate activeForm from subject (convert to present participle)
+     * "Fix bug" -> "Fixing bug"
+     * "Add feature" -> "Adding feature"
+     */
+    generateActiveForm(subject) {
+        const words = subject.split(" ");
+        if (words.length === 0)
+            return subject;
+        const verb = words[0].toLowerCase();
+        let participle;
+        // Handle common verb endings
+        if (verb.endsWith("e")) {
+            participle = verb.slice(0, -1) + "ing";
+        }
+        else if (verb.match(/[aeiou][^aeiou]$/)) {
+            // Double consonant for short vowel + consonant
+            participle = verb + verb.slice(-1) + "ing";
+        }
+        else {
+            participle = verb + "ing";
+        }
+        // Capitalize first letter
+        participle = participle.charAt(0).toUpperCase() + participle.slice(1);
+        return [participle, ...words.slice(1)].join(" ");
+    }
+}

package/dist/work-item-mcp-tools.d.ts

@@ -0,0 +1,12 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { TaskStore } from "./task-store.js";
+export interface WorkItemMcpToolsOptions {
+    /** The TaskStore instance for managing work item tasks */
+    taskStore: TaskStore;
+}
+/**
+ * Register MCP tools for work item task management (TaskCreate, TaskGet, TaskUpdate, TaskList)
+ * These match Claude Code's internal task system stored in ~/.claude/tasks/
+ */
+export declare function registerWorkItemMcpTools(server: McpServer, options: WorkItemMcpToolsOptions): void;
+//# sourceMappingURL=work-item-mcp-tools.d.ts.map

package/dist/work-item-mcp-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-item-mcp-tools.d.ts","sourceRoot":"","sources":["../src/work-item-mcp-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,SAAS,EAAoB,MAAM,iBAAiB,CAAC;AAE9D,MAAM,WAAW,uBAAuB;IACtC,0DAA0D;IAC1D,SAAS,EAAE,SAAS,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,uBAAuB,GAC/B,IAAI,CAgUN"}

package/dist/work-item-mcp-tools.js

@@ -0,0 +1,296 @@
+import { z } from "zod";
+/**
+ * Register MCP tools for work item task management (TaskCreate, TaskGet, TaskUpdate, TaskList)
+ * These match Claude Code's internal task system stored in ~/.claude/tasks/
+ */
+export function registerWorkItemMcpTools(server, options) {
+    const { taskStore } = options;
+    // TaskCreate - Create a new task
+    server.registerTool("TaskCreate", {
+        title: "Create Task",
+        description: `Use this tool to create a structured task list for your current coding session. This helps you track progress, organize complex tasks, and demonstrate thoroughness to the user.
+It also helps the user understand the progress of the task and overall progress of their requests.
+
+## When to Use This Tool
+
+Use this tool proactively in these scenarios:
+
+- Complex multi-step tasks - When a task requires 3 or more distinct steps or actions
+- Non-trivial and complex tasks - Tasks that require careful planning or multiple operations
+- User explicitly requests todo list - When the user directly asks you to use the todo list
+- User provides multiple tasks - When users provide a list of things to be done
+- After receiving new instructions - Immediately capture user requirements as tasks
+- When you start working on a task - Mark it as in_progress BEFORE beginning work
+- After completing a task - Mark it as completed
+
+## Task Fields
+
+- **subject**: A brief, actionable title in imperative form (e.g., "Fix authentication bug in login flow")
+- **description**: Detailed description of what needs to be done, including context and acceptance criteria
+- **activeForm**: Present continuous form shown in spinner when task is in_progress (e.g., "Fixing authentication bug")
+
+**IMPORTANT**: Always provide activeForm when creating tasks. The subject should be imperative ("Run tests") while activeForm should be present continuous ("Running tests").`,
+        inputSchema: {
+            subject: z.string().describe("A brief title for the task in imperative form"),
+            description: z.string().describe("A detailed description of what needs to be done"),
+            activeForm: z
+                .string()
+                .optional()
+                .describe('Present continuous form shown in spinner when in_progress (e.g., "Running tests")'),
+            metadata: z
+                .record(z.string(), z.unknown())
+                .optional()
+                .describe("Arbitrary metadata to attach to the task"),
+        },
+        annotations: {
+            title: "Create task",
+            readOnlyHint: false,
+        },
+    }, async (input) => {
+        try {
+            const task = await taskStore.create({
+                subject: input.subject,
+                description: input.description,
+                activeForm: input.activeForm,
+                metadata: input.metadata,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Created task ${task.id}: "${task.subject}"`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `Failed to create task: ${err}` }],
+            };
+        }
+    });
+    // TaskGet - Get a task by ID
+    server.registerTool("TaskGet", {
+        title: "Get Task",
+        description: `Use this tool to retrieve a task by its ID from the task list.
+
+## When to Use This Tool
+
+- When you need the full description and context before starting work on a task
+- To understand task dependencies (what it blocks, what blocks it)
+- After being assigned a task, to get complete requirements
+
+## Output
+
+Returns full task details:
+- **subject**: Task title
+- **description**: Detailed requirements and context
+- **status**: 'pending', 'in_progress', or 'completed'
+- **blocks**: Tasks waiting on this one to complete
+- **blockedBy**: Tasks that must complete before this one can start
+
+## Tips
+
+- After fetching a task, verify its blockedBy list is empty before beginning work.
+- Use TaskList to see all tasks in summary form.`,
+        inputSchema: {
+            taskId: z.string().describe("The ID of the task to retrieve"),
+        },
+        annotations: {
+            title: "Get task",
+            readOnlyHint: true,
+        },
+    }, async (input) => {
+        try {
+            const task = await taskStore.get(input.taskId);
+            if (!task) {
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: `Task not found: ${input.taskId}` }],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(task, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `Failed to get task: ${err}` }],
+            };
+        }
+    });
+    // TaskUpdate - Update a task
+    server.registerTool("TaskUpdate", {
+        title: "Update Task",
+        description: `Use this tool to update a task in the task list.
+
+## When to Use This Tool
+
+**Mark tasks as resolved:**
+- When you have completed the work described in a task
+- When a task is no longer needed or has been superseded
+- IMPORTANT: Always mark your assigned tasks as resolved when you finish them
+- After resolving, call TaskList to find your next task
+
+**Update task details:**
+- When requirements change or become clearer
+- When establishing dependencies between tasks
+
+## Fields You Can Update
+
+- **status**: The task status ('pending', 'in_progress', 'completed')
+- **subject**: Change the task title (imperative form, e.g., "Run tests")
+- **description**: Change the task description
+- **activeForm**: Present continuous form shown when in_progress
+- **owner**: Change the task owner (agent name)
+- **metadata**: Merge metadata keys into the task (set a key to null to delete it)
+- **addBlocks**: Mark tasks that cannot start until this one completes
+- **addBlockedBy**: Mark tasks that must complete before this one can start
+
+## Status Workflow
+
+Status progresses: \`pending\` → \`in_progress\` → \`completed\`
+
+## Examples
+
+Mark task as in progress when starting work:
+\`\`\`json
+{"taskId": "1", "status": "in_progress"}
+\`\`\`
+
+Mark task as completed after finishing work:
+\`\`\`json
+{"taskId": "1", "status": "completed"}
+\`\`\`
+
+Set up task dependencies:
+\`\`\`json
+{"taskId": "2", "addBlockedBy": ["1"]}
+\`\`\``,
+        inputSchema: {
+            taskId: z.string().describe("The ID of the task to update"),
+            status: z
+                .enum(["pending", "in_progress", "completed"])
+                .optional()
+                .describe("New status for the task"),
+            subject: z.string().optional().describe("New subject for the task"),
+            description: z.string().optional().describe("New description for the task"),
+            activeForm: z
+                .string()
+                .optional()
+                .describe('Present continuous form shown in spinner when in_progress (e.g., "Running tests")'),
+            owner: z.string().optional().describe("New owner for the task"),
+            addBlocks: z
+                .array(z.string())
+                .optional()
+                .describe("Task IDs that this task blocks"),
+            addBlockedBy: z
+                .array(z.string())
+                .optional()
+                .describe("Task IDs that block this task"),
+            metadata: z
+                .record(z.string(), z.unknown())
+                .optional()
+                .describe("Metadata keys to merge into the task. Set a key to null to delete it."),
+        },
+        annotations: {
+            title: "Update task",
+            readOnlyHint: false,
+        },
+    }, async (input) => {
+        try {
+            const task = await taskStore.update(input.taskId, {
+                status: input.status,
+                subject: input.subject,
+                description: input.description,
+                activeForm: input.activeForm,
+                owner: input.owner,
+                addBlocks: input.addBlocks,
+                addBlockedBy: input.addBlockedBy,
+                metadata: input.metadata,
+            });
+            let message = `Updated task ${task.id}: "${task.subject}" (${task.status})`;
+            if (task.status === "completed") {
+                message +=
+                    "\n\nTask completed. Call TaskList now to find your next available task or see if your work unblocked others.";
+            }
+            return {
+                content: [{ type: "text", text: message }],
+            };
+        }
+        catch (err) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `Failed to update task: ${err}` }],
+            };
+        }
+    });
+    // TaskList - List all tasks
+    server.registerTool("TaskList", {
+        title: "List Tasks",
+        description: `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
+- Before assigning tasks to teammates, to see what's available
+- After completing a task, to check for newly unblocked work or claim the next available task
+
+## Output
+
+Returns a summary of each task:
+- **id**: Task identifier (use with TaskGet, TaskUpdate)
+- **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
+
+Use TaskGet with a specific task ID to view full details including description.`,
+        inputSchema: {},
+        annotations: {
+            title: "List tasks",
+            readOnlyHint: true,
+        },
+    }, async () => {
+        try {
+            const tasks = await taskStore.list();
+            const stats = await taskStore.getStats();
+            const summary = tasks.map((t) => ({
+                id: t.id,
+                subject: t.subject,
+                status: t.status,
+                owner: t.owner,
+                blockedBy: t.blockedBy.filter((id) => {
+                    const blocker = tasks.find((task) => task.id === id);
+                    return blocker && blocker.status !== "completed";
+                }),
+            }));
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            stats,
+                            tasks: summary,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `Failed to list tasks: ${err}` }],
+            };
+        }
+    });
+}

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.15.0",
+  "version": "0.17.0",
   "description": "An ACP-compatible coding agent powered by the Claude Code SDK (TypeScript)",
   "main": "dist/lib.js",
   "types": "dist/lib.d.ts",