@agentistics/mcp 2.163.1 → 2.164.0

package/dist/agentistics-mcp.js

@@ -1,60 +1,5 @@
 #!/usr/bin/env node
 
-// session-role-args.ts
-function sessionRoleBody(a, session) {
-  const retire = typeof a?.retirePredecessor === "string" ? a.retirePredecessor.trim() : "";
-  return {
-    ...a?.ref ? { ref: a.ref } : {},
-    ...a?.role !== undefined ? { role: a.role } : {},
-    ...retire ? { retirePredecessor: retire } : {},
-    session: session ?? null
-  };
-}
-
-// orphan-guard.ts
-function installOrphanGuard(d) {
-  const initial = d.getPpid();
-  let done = false;
-  const bye = () => {
-    if (done)
-      return;
-    done = true;
-    d.exit(0);
-  };
-  for (const ev of ["end", "close", "error"])
-    d.stdin.on(ev, bye);
-  d.stdout.on("error", bye);
-  for (const sig of ["SIGHUP", "SIGPIPE"])
-    d.proc.on(sig, bye);
-  const handle = d.setInterval(() => {
-    if (d.getPpid() !== initial)
-      bye();
-  }, d.intervalMs ?? 500);
-  handle?.unref?.();
-  return () => d.clearInterval(handle);
-}
-
-// orphan-guard-boot.ts
-if (process.env.AGENTISTICS_MCP_NO_ORPHAN_GUARD !== "1") {
-  installOrphanGuard({
-    stdin: process.stdin,
-    stdout: process.stdout,
-    proc: process,
-    getPpid: () => process.ppid,
-    exit: (c) => process.exit(c),
-    setInterval: (f, ms) => setInterval(f, ms),
-    clearInterval: (h) => clearInterval(h)
-  });
-}
-
-// agentistics-mcp.ts
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import {
-  CallToolRequestSchema,
-  ListToolsRequestSchema
-} from "@modelcontextprotocol/sdk/types.js";
-
 // ../core/src/local-models.ts
 var LOCAL_RUNTIME_PREFIXES = [
   "ollama",
@@ -1073,7 +1018,9 @@ var AGENT_TOOL_POLICY = {
   agentistics_build_layout: { ...PREFS, risk: "W", routes: ["GET /api/preferences", "PUT /api/preferences"], reason: "writes a layout; reversible by another build or delete" },
   agentistics_export_pdf: { ...DATA, risk: "R", routes: [], reason: "composes a local dashboard URL; calls nothing and exports nothing itself" },
   agentistics_tags: { ...DATA, risk: "R", routes: ["GET /api/tags"], reason: "reads aggregate-only tag cards" },
-  agentistics_tag_detail: { ...DATA, risk: "R", routes: ["GET /api/tags", "GET /api/tags/:id"], reason: "reads one tag aggregate (counts and sums only)" }
+  agentistics_tag_detail: { ...DATA, risk: "R", routes: ["GET /api/tags", "GET /api/tags/:id"], reason: "reads one tag aggregate (counts and sums only)" },
+  agentistics_flow_run: { ...DATA, capability: "localShell", host: true, risk: "R", routes: ["POST /api/flows/run"], reason: "runs only the built-in deterministic flow gates; it deletes nothing" },
+  agentistics_flow_status: { ...DATA, capability: "localShell", host: true, risk: "R", routes: ["GET /api/flows/status/:runId"], reason: "reads a durable deterministic flow run" }
 };
 // ../core/src/dataPatch.ts
 var blocked = new Set(["__proto__", "constructor", "prototype"]);
@@ -1185,6 +1132,72 @@ function routeRecommendation(budgets, kind, authorHarness) {
 }
 var NEW_PERIOD_MS = 5 * 60000;
 var DISCONTINUITY_RESET_MS = 60 * 60000;
+// ../core/src/flowRunId.ts
+function isFlowRunId(id) {
+  return /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/.test(id);
+}
+// flow-status.ts
+function flowStatusRunId(runId) {
+  if (!isFlowRunId(runId))
+    throw new Error("invalid flow run id");
+  return runId;
+}
+
+// session-role-args.ts
+function sessionRoleBody(a, session) {
+  const retire = typeof a?.retirePredecessor === "string" ? a.retirePredecessor.trim() : "";
+  return {
+    ...a?.ref ? { ref: a.ref } : {},
+    ...a?.role !== undefined ? { role: a.role } : {},
+    ...retire ? { retirePredecessor: retire } : {},
+    session: session ?? null
+  };
+}
+
+// orphan-guard.ts
+function installOrphanGuard(d) {
+  const initial = d.getPpid();
+  let done = false;
+  const bye = () => {
+    if (done)
+      return;
+    done = true;
+    d.exit(0);
+  };
+  for (const ev of ["end", "close", "error"])
+    d.stdin.on(ev, bye);
+  d.stdout.on("error", bye);
+  for (const sig of ["SIGHUP", "SIGPIPE"])
+    d.proc.on(sig, bye);
+  const handle = d.setInterval(() => {
+    if (d.getPpid() !== initial)
+      bye();
+  }, d.intervalMs ?? 500);
+  handle?.unref?.();
+  return () => d.clearInterval(handle);
+}
+
+// orphan-guard-boot.ts
+if (process.env.AGENTISTICS_MCP_NO_ORPHAN_GUARD !== "1") {
+  installOrphanGuard({
+    stdin: process.stdin,
+    stdout: process.stdout,
+    proc: process,
+    getPpid: () => process.ppid,
+    exit: (c) => process.exit(c),
+    setInterval: (f, ms) => setInterval(f, ms),
+    clearInterval: (h) => clearInterval(h)
+  });
+}
+
+// agentistics-mcp.ts
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema
+} from "@modelcontextprotocol/sdk/types.js";
+
 // session-tokens.ts
 function sessionHarness(s) {
   return s.harness ?? "claude";
@@ -1945,6 +1958,17 @@ async function nativeVisibleNow() {
     return false;
   }
 }
+async function flowsVisibleNow() {
+  try {
+    const res = await fetch(`${API}/api/engine`, { signal: AbortSignal.timeout(2000) });
+    if (!res.ok)
+      return false;
+    const body = await res.json();
+    return body.flowsExperimental === true && body.flows === true;
+  } catch {
+    return false;
+  }
+}
 var CATALOG = [
   { id: "kpi.messages", label: "Messages", category: "kpi", defaultW: 3, defaultH: 3, minW: 2, minH: 2, description: "Total message count in selected period" },
   { id: "kpi.sessions", label: "Sessions", category: "kpi", defaultW: 3, defaultH: 3, minW: 2, minH: 2, description: "Session count + avg msgs/session" },
@@ -2675,10 +2699,35 @@ var TOOLS = [
     name: "agentistics_repos",
     description: "List repositories, grouped by normalized git remote (independent of local path or which machine produced the session), with session/message/token/cost totals and last-active date. Sessions with no linked repository are grouped under 'unlinked'. Optionally scope to a single harness. Rows tagged source \"projections\" (read from the journal) carry personTurns (the person's turns); there `messages` is a deprecated alias of personTurns, and subagent spend is reported apart (subagentTokens, subagentCostUSD).",
     inputSchema: { type: "object", properties: { harness: HARNESS_PARAM }, required: [] }
+  },
+  {
+    name: "agentistics_flow_run",
+    description: "Run an official deterministic flow. Flows are experimental and read-only host operations; the server refuses when AGENTISTICS_FLOWS is off or the official engine is absent.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        name: { type: "string", description: "Built-in flow name, for example worker-checar or limpeza." },
+        inputs: { type: "object", description: "Optional flow inputs." }
+      },
+      required: ["name"]
+    }
+  },
+  {
+    name: "agentistics_flow_status",
+    description: "Read the durable status of an official deterministic flow run.",
+    inputSchema: {
+      type: "object",
+      properties: { runId: { type: "string", description: "Flow run id returned by agentistics_flow_run." } },
+      required: ["runId"]
+    }
   }
 ];
 var MCP_TOOL_NAMES = TOOLS.map((tool) => tool.name);
-server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: toolsForGate(TOOLS, await nativeVisibleNow()) }));
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  const tools = toolsForGate(TOOLS, await nativeVisibleNow());
+  const flowsOn = await flowsVisibleNow();
+  return { tools: flowsOn ? tools : tools.filter((tool) => !tool.name.startsWith("agentistics_flow_")) };
+});
 var audit = createAgentAuditSink();
 process.on("exit", () => audit.flush());
 for (const sig of ["SIGINT", "SIGTERM"]) {
@@ -2715,6 +2764,19 @@ async function callTool(req) {
         const body = await apiGet(`/api/tasks/${encodeURIComponent(ref)}`);
         return { content: [{ type: "text", text: JSON.stringify(body, null, 2) }] };
       }
+      case "agentistics_flow_run": {
+        const a = args;
+        const body = await apiSend("POST", "/api/flows/run", {
+          name: a?.name,
+          ...a?.inputs && typeof a.inputs === "object" ? { inputs: a.inputs } : {}
+        });
+        return text(body);
+      }
+      case "agentistics_flow_status": {
+        const runId = String(args?.runId ?? "");
+        const body = await apiGet(`/api/flows/status/${flowStatusRunId(runId)}`);
+        return text(body);
+      }
       case "agentistics_task_create": {
         const a = args;
         const body = await apiSend("POST", "/api/tasks", { title: a?.title, detail: a?.detail });

package/package.json

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