@agimon-ai/po-task 0.0.0-alpha.27 → 0.0.0-alpha.29

package/README.md

@@ -63,6 +63,16 @@ The reducer enforces lifecycle transitions and rejects dependency cycles. A grap
 non-deleted tasks by default; updates still apply when full, but new tasks are rejected until space
 is freed.
 
+## Tasks in code mode
+
+When code mode is loaded, the `tasks` namespace covers every task action and the direct `task` tool is
+withdrawn from the model for that session. `await tasks.snapshot()` returns a detached `TaskDocument`,
+including deleted tasks, and never locks, writes, increments `rev`, or replaces the store cache. A
+missing file returns an empty document; other read failures reject. `upsert`, `delete`, `clear`,
+`assign` and `cancel` write through the same store and reducer as the tool and resolve to
+`{ message, document }`; a refused change rejects. Without code mode, and on remote MCP, the `task`
+tool stays available. The `po-use-task` skill carries the usage rules.
+
 ## Presentation
 
 The browser owns the task view and renderer. Terminal task shortcuts and overlays are retired; the native `task` tool remains available.

package/dist/extensions/mcp.cjs

@@ -1059,6 +1059,34 @@ async function assignmentBatch(manager, assignments, signal) {
 	}
 	return result;
 }
+/** One task action against the session store, shared by the `task` tool and the `tasks` code-mode namespace. */
+async function runTaskAction(store, manager, maxTasks, rawParams, signal, onUpdate) {
+	if (!(0, typebox_value.Check)(TaskParamsSchema, rawParams)) return failure("Invalid task parameters.");
+	const params = rawParams;
+	try {
+		if ((params.action === "assign" || params.action === "cancel") && !manager) throw new Error("Delegation is not available on this connection.");
+		if (params.action === "assign") {
+			if (!params.assignments?.length) throw new Error("assign requires a non-empty assignments[] array");
+			onUpdate?.(output(`Delegating ${params.assignments.length} task${params.assignments.length === 1 ? "" : "s"}...`));
+			const items = await assignmentBatch(manager, params.assignments, signal);
+			const assigned = items.filter((item) => item.ok).map((item) => item.id);
+			const text = formatAssignmentResults(items);
+			if (assigned.length === 0) throw new Error(text);
+			return buildAssignmentResult(params, store.snapshot, text, {
+				assigned,
+				failed: items.length - assigned.length
+			});
+		}
+		if (params.action === "cancel") {
+			const outcome = await manager.cancel(params.id ?? NaN);
+			if (!outcome.ok) throw new Error(outcome.message);
+			return buildTextResult("cancel", params, store.snapshot, outcome.message);
+		}
+		return reducerAction(store, params.action, params, maxTasks);
+	} catch (error) {
+		return failure(error);
+	}
+}
 function createHeadlessTaskTool(store, manager, maxTasks) {
 	return {
 		name: "task",
@@ -1067,33 +1095,7 @@ function createHeadlessTaskTool(store, manager, maxTasks) {
 		parameters: TaskParamsSchema,
 		promptSnippet: "Track complex work persistently and delegate ready tasks",
 		executionMode: "serial",
-		async execute(_toolCallId, rawParams, signal, onUpdate) {
-			if (!(0, typebox_value.Check)(TaskParamsSchema, rawParams)) return failure("Invalid task parameters.");
-			const params = rawParams;
-			try {
-				if ((params.action === "assign" || params.action === "cancel") && !manager) throw new Error("Delegation is not available on this connection.");
-				if (params.action === "assign") {
-					if (!params.assignments?.length) throw new Error("assign requires a non-empty assignments[] array");
-					onUpdate?.(output(`Delegating ${params.assignments.length} task${params.assignments.length === 1 ? "" : "s"}...`));
-					const items = await assignmentBatch(manager, params.assignments, signal);
-					const assigned = items.filter((item) => item.ok).map((item) => item.id);
-					const text = formatAssignmentResults(items);
-					if (assigned.length === 0) throw new Error(text);
-					return buildAssignmentResult(params, store.snapshot, text, {
-						assigned,
-						failed: items.length - assigned.length
-					});
-				}
-				if (params.action === "cancel") {
-					const outcome = await manager.cancel(params.id ?? NaN);
-					if (!outcome.ok) throw new Error(outcome.message);
-					return buildTextResult("cancel", params, store.snapshot, outcome.message);
-				}
-				return reducerAction(store, params.action, params, maxTasks);
-			} catch (error) {
-				return failure(error);
-			}
-		}
+		execute: (_toolCallId, rawParams, signal, onUpdate) => runTaskAction(store, manager, maxTasks, rawParams, signal, onUpdate)
 	};
 }
 //#endregion