@agentistics/mcp 2.25.1 → 2.26.0

package/dist/agentistics-mcp.js

@@ -684,7 +684,7 @@ var TOOLS = [
   },
   {
     name: "agentistics_task_session",
-    description: "BETA — the task board is new and still changing; its shapes may move between releases. File a SESSION under a SUBTASK of a task, which is what makes the task measurable: its cost, tokens, rounds and harness all come from the sessions filed under its parts. **A session is NEVER filed under a task directly — always name a `subtaskId`.** A task is the unit of DELIVERY and a subtask is the unit of WORK; filing at both levels made 'does this cost include the subtasks' unanswerable, so the server refuses it. Use agentistics_task to read the subtasks, or agentistics_task_subtask to create one, then pass `ref` + `sessionId` (a managed session id or conversation id) + `subtaskId`. Pass `detach` with a session id to unfile one. The task inherits the session's repository when it has none.",
+    description: "BETA — the task board is new and still changing; its shapes may move between releases. File a SESSION under a task, which is what makes the task measurable: its cost, tokens, rounds and harness all come from the sessions filed under it. Pass `subtaskId` to file it under one of the task's subtasks (the unit of WORK, for a task broken into steps); omit it to file the session directly on the task itself (the unit of DELIVERY, for a task simple enough not to need subtasks). Both can be used on the same task — some sessions direct, some under subtasks — and each subtask's own rollup plus the directly-filed sessions' own rollup are both readable via agentistics_task's `subtaskRollups` (keyed by subtask id, with `id: null` for the direct ones), so the breakdown never disappears. Use agentistics_task to read the subtasks, or agentistics_task_subtask to create one, then pass `ref` + `sessionId` (a managed session id or conversation id) + optionally `subtaskId`. Pass `detach` with a session id to unfile one. The task inherits the session's repository when it has none.",
     inputSchema: {
       type: "object",
       properties: {
@@ -692,7 +692,7 @@ var TOOLS = [
         sessionId: { type: "string" },
         subtaskId: {
           type: "string",
-          description: "The subtask to file it under. REQUIRED to file — a task does not take sessions itself."
+          description: "The subtask to file it under. Optional — omit to file the session directly on the task itself."
         },
         detach: { type: "string" }
       },
@@ -1020,18 +1020,9 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
           return { content: [{ type: "text", text: JSON.stringify(body, null, 2) }] };
         }
         const ref = encodeURIComponent(String(a?.ref ?? ""));
-        if (!a?.subtaskId) {
-          return {
-            content: [{
-              type: "text",
-              text: "A session is filed under a SUBTASK, never under the delivery itself — a task is the " + "unit of delivery, a subtask the unit of work. Read the parts with agentistics_task, or " + "create one with agentistics_task_subtask, then call this again with `subtaskId`."
-            }],
-            isError: true
-          };
-        }
         const body = await apiSend("POST", `/api/tasks/${ref}/sessions`, {
           sessionId: a?.sessionId,
-          subtaskId: a.subtaskId
+          ...a?.subtaskId ? { subtaskId: a.subtaskId } : {}
         });
         return { content: [{ type: "text", text: JSON.stringify(body, null, 2) }] };
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentistics/mcp",
-  "version": "2.25.1",
+  "version": "2.26.0",
   "description": "Agentistics MCP server — Claude Code analytics for Claude Desktop and Claude Code",
   "type": "module",
   "main": "./dist/agentistics-mcp.js",