@agentistics/mcp 2.111.2 → 2.112.0

package/dist/agentistics-mcp.js

@@ -1000,10 +1000,16 @@ var AGENT_TOOL_POLICY = {
     routes: ["POST /api/session-notify"],
     reason: "a per-session on/off switch for delivery; reversible, and the session state is untouched"
   },
+  agentistics_session_message: {
+    ...GROUPS,
+    risk: "W",
+    routes: ["POST /api/session-message"],
+    reason: "types a message into another session through the composer path; additive, rate-limited, sender verified"
+  },
   agentistics_summary: { ...DATA, capability: "localTranscripts", host: true, risk: "R", routes: ["GET /api/data", "GET /api/runtime/metrics"], reason: "reads computed metrics" },
   agentistics_harnesses: { ...DATA, capability: "localTranscripts", host: true, risk: "R", routes: ["GET /api/data", "GET /api/runtime/metrics"], reason: "reads computed metrics per harness" },
   agentistics_projects: { ...DATA, capability: "localTranscripts", host: true, risk: "R", routes: ["GET /api/data", "GET /api/runtime/metrics"], reason: "reads computed metrics per project" },
-  agentistics_sessions: { ...DATA, risk: "R", routes: ["GET /api/data"], reason: "reads session metadata (first_prompt is untrusted text, §4.8)" },
+  agentistics_sessions: { ...DATA, capability: "localShell", host: true, risk: "R", routes: ["GET /api/data", "GET /api/fleet"], reason: "reads session metadata (first_prompt is untrusted text, §4.8)" },
   agentistics_costs: { ...DATA, capability: "localTranscripts", host: true, risk: "R", routes: ["GET /api/data", "GET /api/runtime/metrics"], reason: "reads computed costs" },
   agentistics_repos: { ...DATA, capability: "localTranscripts", host: true, risk: "R", routes: ["GET /api/data", "GET /api/runtime/metrics"], reason: "reads computed metrics per repository" },
   agentistics_component_catalog: { ...DATA, risk: "R", routes: [], reason: "returns a static list; calls nothing" },
@@ -1096,6 +1102,19 @@ function toolsForGate(tools, nativeVisible) {
     return { ...t, inputSchema: { ...t.inputSchema, properties: { ...props, harness: param } } };
   });
 }
+function startedByIndex(rows) {
+  const out = new Map;
+  for (const r of rows) {
+    if (!r.parentSessionId)
+      continue;
+    const parent = (r.parentConversationId ? rows.find((p) => p.conversationId === r.parentConversationId) : undefined) ?? rows.find((p) => p.id === r.parentSessionId || p.conversationId === r.parentSessionId);
+    const who = { id: parent?.id ?? r.parentSessionId, ...parent?.title ? { title: parent.title } : {} };
+    out.set(r.id, who);
+    if (r.conversationId)
+      out.set(r.conversationId, who);
+  }
+  return out;
+}
 
 // agent-audit.ts
 import { createHash } from "node:crypto";
@@ -2143,6 +2162,19 @@ var TOOLS = [
       required: ["ref"]
     }
   },
+  {
+    name: "agentistics_session_message",
+    description: "Send a message to ANOTHER agentistics session — the standard channel between a session and the one that started it (or the ones it started). `to` is a session reference (managed id, conversation id, exact title or unique id prefix); `kind` is handback (work finished/committed), block (you cannot continue) or question (you need a decision); `body` is the text. It is typed into the target's own conversation through the same path its composer uses, headed `[from session <id> · <kind>]`, and — when YOUR session is filed on a task or subtask — also recorded there as a comment of that kind. Use it to report to the session that started you instead of asking the user; a parent may message its children the same way. Refused for a session that does not exist, for yourself, from a process that is not a verified agentop session, and more than once per 2 seconds to the same session.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        to: { type: "string", description: "The target session reference." },
+        kind: { type: "string", enum: ["handback", "block", "question"] },
+        body: { type: "string", description: "The message." }
+      },
+      required: ["to", "kind", "body"]
+    }
+  },
   {
     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.",
@@ -2571,6 +2603,16 @@ async function callTool(req) {
         });
         return { content: [{ type: "text", text: JSON.stringify(body, null, 2) }] };
       }
+      case "agentistics_session_message": {
+        const a = args;
+        const body = await apiSend("POST", "/api/session-message", {
+          to: a?.to,
+          kind: a?.kind,
+          body: a?.body,
+          session: sessionProof(process.env)
+        });
+        return { content: [{ type: "text", text: JSON.stringify(body, null, 2) }] };
+      }
       case "agentistics_summary": {
         const harness = args?.harness;
         return text(await analytics("agentistics_summary", harness, {
@@ -2595,6 +2637,7 @@ async function callTool(req) {
         const limit = Math.min(args?.limit ?? 20, 50);
         const harness = args?.harness;
         const data = await apiGet("/api/data");
+        const startedBy = await apiGet("/api/fleet").then((f) => startedByIndex(f?.rows ?? [])).catch(() => new Map);
         const rows = filterSessions(data.sessions ?? [], harness).slice(0, limit).map((s) => {
           const { input, output, cacheRead, cacheWrite, cost, unpriced } = sessionTokens2(s);
           return {
@@ -2611,7 +2654,8 @@ async function callTool(req) {
             totalTokens: input + output + cacheRead + cacheWrite,
             estimatedCostUSD: unpriced > 0 && unpriced === input + output + cacheRead + cacheWrite ? null : Math.round(cost * 1e4) / 1e4,
             ...unpriced > 0 ? { unpricedTokens: unpriced } : {},
-            model: s.model ?? null
+            model: s.model ?? null,
+            ...startedBy.get(s.session_id) ? { startedBy: startedBy.get(s.session_id) } : {}
           };
         });
         return { content: [{ type: "text", text: JSON.stringify(rows, null, 2) }] };

package/package.json

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