@agentistics/mcp 2.97.0 → 2.99.0

package/dist/agentistics-mcp.js

@@ -754,6 +754,13 @@ var AGENT_TOOL_POLICY = {
     routes: ["DELETE /api/tasks/statuses/:id", "POST /api/tasks/statuses/:id", "POST /api/tasks/statuses"],
     reason: "status vocabulary is configuration; the server refuses to remove a protected status (§3.5)"
   },
+  agentistics_task_types: { ...TASKS, risk: "R", routes: ["GET /api/tasks/types"], reason: "reads the type vocabulary" },
+  agentistics_task_type_edit: {
+    ...TASKS,
+    risk: "W",
+    routes: ["DELETE /api/tasks/types/:id", "POST /api/tasks/types/:id", "POST /api/tasks/types"],
+    reason: "type vocabulary is configuration; the server refuses to remove a type still in use"
+  },
   agentistics_task_comment: { ...TASKS, risk: "W", routes: ["POST /api/tasks/:ref/comments"], reason: "appends a note; additive, destroys nothing" },
   agentistics_task_subtask: { ...TASKS, risk: "W", routes: ["POST /api/tasks/:ref/subtasks"], reason: "adds or edits a subtask; reversible by another edit" },
   agentistics_task_link: { ...TASKS, risk: "W", routes: ["POST /api/tasks/:ref/links"], reason: "adds or removes a link; reversible by the inverse call" },
@@ -787,6 +794,12 @@ var AGENT_TOOL_POLICY = {
     ],
     reason: "folders are labels: deleting one ungroups its sessions and touches no session (§5 defect 3: W, not D)"
   },
+  agentistics_session_notify: {
+    ...GROUPS,
+    risk: "W",
+    routes: ["POST /api/session-notify"],
+    reason: "a per-session on/off switch for delivery; reversible, and the session state is untouched"
+  },
   agentistics_summary: { ...DATA, risk: "R", routes: ["GET /api/data"], reason: "reads computed metrics" },
   agentistics_harnesses: { ...DATA, risk: "R", routes: ["GET /api/data"], reason: "reads computed metrics per harness" },
   agentistics_projects: { ...DATA, risk: "R", routes: ["GET /api/data"], reason: "reads computed metrics per project" },
@@ -1092,6 +1105,21 @@ function createAgentAuditSink(opts = {}) {
   };
 }
 
+// task-comment-args.ts
+function taskCommentRequest(args) {
+  const a = args ?? {};
+  const subtaskId = typeof a.subtaskId === "string" && a.subtaskId.trim() ? a.subtaskId.trim() : undefined;
+  return {
+    path: `/api/tasks/${encodeURIComponent(String(a.ref))}/comments`,
+    payload: {
+      body: typeof a.body === "string" ? a.body : "",
+      author: typeof a.author === "string" && a.author ? a.author : "assistant",
+      ...subtaskId ? { subtaskId } : {},
+      ...Array.isArray(a.attachments) && a.attachments.length > 0 ? { attachments: a.attachments } : {}
+    }
+  };
+}
+
 // agentistics-mcp.ts
 var API = process.env.AGENTISTICS_API ?? "http://localhost:47291";
 var HARNESS_PARAM = harnessParam();
@@ -1205,7 +1233,7 @@ var TOOLS = [
   },
   {
     name: "agentistics_task",
-    description: "BETA — Agentask (the task board) is new and still changing; its shapes may move between releases. Open ONE task: its attempts (one per configuration tried), the sessions filed under it with their live state, its comments, subtasks, files, links and full metrics (models, harnesses, agent runs, tokens, delivery time). `ref` is the task id or its exact title.",
+    description: "BETA — Agentask (the task board) is new and still changing; its shapes may move between releases. Open ONE task: its attempts (one per configuration tried), the sessions filed under it with their live state, its comments, subtasks, files, links and full metrics (models, harnesses, agent runs, tokens, delivery time). Comments come twice: `comments` (flat, oldest first, each with `subtaskId` when it was left on a subtask or group) and `commentThreads` — the same comments grouped by their OWN target (`target: {kind: 'task'|'group'|'subtask', id, title}`; the task first, empty targets omitted). `ref` is the task id or its exact title.",
     inputSchema: {
       type: "object",
       properties: { ref: { type: "string", description: "Task id or exact title." } },
@@ -1251,6 +1279,25 @@ var TOOLS = [
     description: "BETA — Agentask (the task board) is new and still changing; its shapes may move between releases. List every status this board currently has (id, label, color, and whether it is protected — todo/in_progress/blocked/done can never be deleted or have their id changed, but their label and color can). Call this before agentistics_task_status if you are not sure a status you want to move a task to actually exists.",
     inputSchema: { type: "object", properties: {} }
   },
+  {
+    name: "agentistics_task_types",
+    description: "BETA — Agentask (the task board) is new and still changing. List the task TYPE vocabulary (id, label, color, order, usageCount). A type is a second classification beside the status (e.g. CORE); a task may carry one or none. Call this before setting `type` through agentistics_task_edit.",
+    inputSchema: { type: "object", properties: {} }
+  },
+  {
+    name: "agentistics_task_type_edit",
+    description: "BETA — Agentask (the task board) is new and still changing. Add, rename/recolor, or delete a task type. Pass `label` (and optional `color`, a `#rrggbb` hex string) alone to CREATE a type — its id is derived from the label. Pass `id` with `label` and/or `color` to EDIT. Pass `id` with `remove: true` to DELETE: refused (422, `in_use`, with `usageCount`) while any task still carries it.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: { type: "string", description: "Required to edit or delete; omit to create." },
+        label: { type: "string" },
+        color: { type: "string", description: "#rrggbb" },
+        remove: { type: "boolean" }
+      },
+      required: []
+    }
+  },
   {
     name: "agentistics_task_status_edit",
     description: "BETA — Agentask (the task board) is new and still changing; its shapes may move between releases. Add, rename/recolor, or delete a status. Pass `label` (and optional `color`, a `#rrggbb` hex string) alone to CREATE a new, non-protected status — its id is derived from the label and returned. Pass `id` with `label` and/or `color` to EDIT an existing status's label/color — works on a protected one too, only its id can never change. Pass `id` with `remove: true` to DELETE it: refused (422, `protected`) for todo/in_progress/blocked/done regardless of usage, and refused (422, `in_use`, with `usageCount`) for any other status still referenced by at least one task or subtask.",
@@ -1266,11 +1313,24 @@ var TOOLS = [
   },
   {
     name: "agentistics_task_comment",
-    description: "BETA — Agentask (the task board) is new and still changing; its shapes may move between releases. Leave a comment on a task. Use it to tell the person and the other assistants what you did, what you found, or what you are blocked on. `author` is free text — say who you are (e.g. 'claude:3f5f').",
+    description: "BETA — Agentask (the task board) is new and still changing; its shapes may move between releases. Leave a comment on a task — or on ONE of its subtasks or subtask GROUPS by passing `subtaskId` (a group's own id is allowed; omit it to comment on the task itself). `body` may be empty when `attachments` is given. Comments carry attachments as REFERENCES into the chat's own attachment store (`{name, path}`; agentistics_task returns them on each comment with a `url` that serves the file) — there is no second store. Use it to tell the person and the other assistants what you did, what you found, or what you are blocked on; comment where the work is (the subtask you are on) rather than on the whole task. An unknown, deleted or other task's `subtaskId` is REFUSED with a sentence (422, `no_such_subtask` / `wrong_delivery`) — never silently filed on the task. Threads read downward: a subtask's thread is its own comments, a group's thread is its own plus its members', the task's is everything. The activity log names the target. `author` is free text — say who you are (e.g. 'claude:3f5f').",
     inputSchema: {
       type: "object",
-      properties: { ref: { type: "string" }, body: { type: "string" }, author: { type: "string" } },
-      required: ["ref", "body"]
+      properties: {
+        ref: { type: "string" },
+        body: { type: "string" },
+        author: { type: "string" },
+        subtaskId: {
+          type: "string",
+          description: "Optional target: a subtask or subtask GROUP id of this task (from agentistics_task's `subtasks`). Omit for the task itself."
+        },
+        attachments: {
+          type: "array",
+          description: "Optional files left with the comment, as {name, path} references to files already in agentop's attachments directory (the path the chat upload returns). Paths outside it are dropped. At most 10.",
+          items: { type: "object", properties: { name: { type: "string" }, path: { type: "string" } }, required: ["path"] }
+        }
+      },
+      required: ["ref"]
     }
   },
   {
@@ -1374,14 +1434,15 @@ var TOOLS = [
   },
   {
     name: "agentistics_task_edit",
-    description: "BETA — Agentask (the task board) is new and still changing; its shapes may move between releases. Set a task's fields: `title`, `detail`, `priority` (urgent | high | medium | low | none), `dueDate` / `startDate` (yyyy-mm-dd), `labels`. An absent field is left alone; an EMPTY STRING clears it. `priority` defaults to `none`, which means 'nobody has said' and is not the same as `low`. `startedAt`/`deliveredAt` are system-stamped facts and are never set through this tool. Pass `actor` so the change is recorded against you in the activity log.",
+    description: "BETA — Agentask (the task board) is new and still changing; its shapes may move between releases. Set a task's fields: `title`, `detail`, `priority` (urgent | high | medium | low), `type` (an id from agentistics_task_types; empty string clears it), `dueDate` / `startDate` (yyyy-mm-dd), `labels`. An absent field is left alone; an EMPTY STRING clears it. `priority` defaults to `low`; a legacy `none` is stored as `low`. `startedAt`/`deliveredAt` are system-stamped facts and are never set through this tool. Pass `actor` so the change is recorded against you in the activity log.",
     inputSchema: {
       type: "object",
       properties: {
         ref: { type: "string" },
         title: { type: "string" },
         detail: { type: "string" },
-        priority: { type: "string", enum: ["urgent", "high", "medium", "low", "none"] },
+        priority: { type: "string", enum: ["urgent", "high", "medium", "low"] },
+        type: { type: "string", description: "A task type id (see agentistics_task_types); empty string clears it." },
         dueDate: { type: "string" },
         startDate: { type: "string" },
         labels: { type: "array", items: { type: "string" } },
@@ -1458,6 +1519,18 @@ var TOOLS = [
       required: ["action"]
     }
   },
+  {
+    name: "agentistics_session_notify",
+    description: "Switch a session's notifications on or off, or read the switch. `ref` is a managed id, a conversation id, an exact title or a unique id prefix. With `notify` ('on' | 'off') it sets the switch; with `ref` alone it reads it. Muting removes the INTERRUPTION only (bell, Nay card, sound, desktop toast, peer message): the session still shows as waiting and its events are still recorded in the inbox. The mute follows the conversation, so it survives a reopen. 404 for a ref that matches nothing, 409 for an ambiguous one.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ref: { type: "string", description: "A session reference." },
+        notify: { type: "string", enum: ["on", "off"], description: "Set the switch. Omit to read it." }
+      },
+      required: ["ref"]
+    }
+  },
   {
     name: "agentistics_summary",
     description: "Get an overview of AI coding usage metrics (across all tracked harnesses — Claude Code, Codex, Gemini, Copilot, Antigravity — or scoped to one): total tokens, estimated cost, sessions, streak, most used model, and top project. Good starting point for any metrics question.",
@@ -1717,6 +1790,24 @@ async function callTool(req) {
         const body = await apiGet("/api/tasks/statuses");
         return { content: [{ type: "text", text: JSON.stringify(body, null, 2) }] };
       }
+      case "agentistics_task_types": {
+        const body = await apiGet("/api/tasks/types");
+        return { content: [{ type: "text", text: JSON.stringify(body, null, 2) }] };
+      }
+      case "agentistics_task_type_edit": {
+        const a = args;
+        const id = typeof a?.id === "string" && a.id ? a.id : null;
+        if (id && a?.remove === true) {
+          const body = await apiSend("DELETE", `/api/tasks/types/${encodeURIComponent(id)}`);
+          return { content: [{ type: "text", text: JSON.stringify(body, null, 2) }] };
+        }
+        const payload = {
+          ...typeof a?.label === "string" ? { label: a.label } : {},
+          ...typeof a?.color === "string" ? { color: a.color } : {}
+        };
+        const body = id ? await apiSend("POST", `/api/tasks/types/${encodeURIComponent(id)}`, payload) : await apiSend("POST", "/api/tasks/types", payload);
+        return { content: [{ type: "text", text: JSON.stringify(body, null, 2) }] };
+      }
       case "agentistics_task_status_edit": {
         const a = args;
         const id = typeof a?.id === "string" && a.id ? a.id : null;
@@ -1732,11 +1823,7 @@ async function callTool(req) {
         return { content: [{ type: "text", text: JSON.stringify(body, null, 2) }] };
       }
       case "agentistics_task_comment": {
-        const a = args;
-        const body = await apiSend("POST", `/api/tasks/${encodeURIComponent(String(a?.ref))}/comments`, {
-          body: a?.body,
-          author: a?.author ?? "assistant"
-        });
+        const body = await apiSend("POST", `/api/tasks/${encodeURIComponent(String(args?.ref))}/comments`, taskCommentRequest(args).payload);
         return { content: [{ type: "text", text: JSON.stringify(body, null, 2) }] };
       }
       case "agentistics_task_subtask": {
@@ -1799,7 +1886,7 @@ async function callTool(req) {
         const a = args;
         const ref = encodeURIComponent(String(a?.ref ?? ""));
         const patch = {};
-        for (const f of ["title", "detail", "priority", "dueDate", "startDate", "actor"]) {
+        for (const f of ["title", "detail", "priority", "type", "dueDate", "startDate", "actor"]) {
           if (typeof a?.[f] === "string")
             patch[f] = a[f];
         }
@@ -1864,6 +1951,14 @@ async function callTool(req) {
         }
         return { content: [{ type: "text", text: JSON.stringify(body, null, 2) }] };
       }
+      case "agentistics_session_notify": {
+        const a = args;
+        const body = await apiSend("POST", "/api/session-notify", {
+          ref: a?.ref,
+          ...a?.notify !== undefined ? { notify: a.notify } : {}
+        });
+        return { content: [{ type: "text", text: JSON.stringify(body, null, 2) }] };
+      }
       case "agentistics_summary": {
         const harness = args?.harness;
         const unified = !harness || harness === "all";

package/package.json

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