@agentistics/mcp 2.135.1 → 2.136.0

package/dist/agentistics-mcp.js

@@ -1028,7 +1028,7 @@ var AGENT_TOOL_POLICY = {
     reason: "reads or switches away mode (what newly started sessions are told about the owner being out) and lets a leader raise a notice in the owner's bell; reversible by switching it off; the server accepts writes only from a verified LEADER session"
   },
   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_harnesses: { ...DATA, capability: "localTranscripts", host: true, risk: "R", routes: ["GET /api/data", "GET /api/runtime/metrics", "GET /api/plan-limits"], reason: "reads computed metrics per harness and whether each can be spawned" },
   agentistics_plan_limits: { ...DATA, capability: "localTranscripts", host: true, risk: "R", routes: ["GET /api/plan-limits"], reason: "reads subscription windows and routing guidance; does not start work" },
   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, capability: "localShell", host: true, risk: "R", routes: ["GET /api/data", "GET /api/fleet"], reason: "reads session metadata (first_prompt is untrusted text, §4.8)" },
@@ -1071,7 +1071,7 @@ var ROUTE_PREFERENCES = {
 };
 function routeRecommendation(budgets, kind, authorHarness) {
   const allowTight = kind === "lead";
-  const eligible = budgets.filter((b) => b.plan !== "unregistered" && b.status !== "hold" && (allowTight || b.status !== "tight") && b.harness !== (kind === "qa" ? authorHarness : undefined));
+  const eligible = budgets.filter((b) => b.spawnable !== false && b.plan !== "unregistered" && b.status !== "hold" && (allowTight || b.status !== "tight") && b.harness !== (kind === "qa" ? authorHarness : undefined));
   const ordered = [...eligible].sort((a, b) => {
     const ap = a.paceStatus === "under" ? 0 : 1;
     const bp = b.paceStatus === "under" ? 0 : 1;
@@ -1085,6 +1085,9 @@ function routeRecommendation(budgets, kind, authorHarness) {
   const chosen = ordered.find((b) => preference.some(([h]) => h === b.harness));
   const pick = chosen ?? ordered[0];
   if (!pick) {
+    if (budgets.length && budgets.every((b) => b.spawnable === false)) {
+      return { harness: null, reason: "No harness can start a new session.", alternatives: [], cadence: { parallel: 0, note: "Install or repair a harness before opening workers." } };
+    }
     const earliest = budgets.filter((b) => b.status === "hold").sort((a, b) => a.weekResetsAt - b.weekResetsAt)[0];
     const reset = earliest ? new Date(earliest.weekResetsAt).toISOString() : "the next reset";
     return { harness: null, reason: `all plans on hold until ${reset}`, alternatives: [], cadence: { parallel: 0, note: "Wait for a plan to renew." } };
@@ -1493,6 +1496,7 @@ function planLimitsTool(args, body) {
   const recommendation = args?.kind ? routeRecommendation(budgets, args.kind, args.authorHarness) : undefined;
   return {
     budgets,
+    harnesses: body.harnesses ?? {},
     freeSlots: body.freeSlots ?? (budgets.length ? Math.max(...budgets.map((b) => b.freeSlots ?? 0)) : 0),
     freeSlotsByHarness: body.freeSlotsByHarness ?? Object.fromEntries(budgets.map((b) => [b.harness, b.freeSlots ?? 0])),
     liveSessions: body.liveSessions ?? budgets.flatMap((b) => b.liveSessions ?? []).filter((s, i, all) => all.findIndex((x) => x.id === s.id) === i),
@@ -1502,6 +1506,13 @@ function planLimitsTool(args, body) {
   };
 }
 
+// harnesses-tool.ts
+function harnessesTool(rows, body) {
+  if (!Array.isArray(rows))
+    return rows;
+  return rows.map((row) => ({ ...row, ...body.harnesses?.[row.harness] }));
+}
+
 // legacy-analytics.ts
 function legacySummary(data, harness) {
   const unified = !harness || harness === "all";
@@ -2856,10 +2867,11 @@ async function callTool(req) {
         }));
       }
       case "agentistics_harnesses": {
-        return text(await analytics("agentistics_harnesses", undefined, {
+        const [rows, availability] = await Promise.all([analytics("agentistics_harnesses", undefined, {
           legacy: () => apiGet("/api/data"),
           metrics: (q) => fetch(`${API}/api/runtime/metrics?${q}`)
-        }));
+        }), apiGet("/api/plan-limits")]);
+        return text(harnessesTool(rows, availability));
       }
       case "agentistics_plan_limits": {
         return text(planLimitsTool(args ?? {}, await apiGet("/api/plan-limits")));

package/package.json

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