@mediagato/modelreins-channel 4.10.0 → 4.11.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Steve Kingsley / MEDiAGATO LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/modelreins-channel.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 /**
  * @module modelreins-channel
- * @version 4.5.0
+ * @version 4.6.0
  *
  * ModelReins MCP Channel
  * ======================
@@ -273,7 +273,7 @@ const STUCK_JOB_MS = 30 * 60 * 1000;  // 30 min — generous Claude completion w
 // without user interaction.
 
 const mcp = new Server(
-    { name: 'modelreins', version: '4.5.0' },
+    { name: 'modelreins', version: '4.6.0' },
     {
         capabilities: {
             // Enable the Claude-specific channel notification method.
@@ -463,6 +463,40 @@ mcp.setRequestHandler(ListToolsRequestSchema, async () => ({
             },
         },
 
+        // ── modelreins_plan ───────────────────────────────────────────────────
+        {
+            name: 'modelreins_plan',
+            description: [
+                'Turn a free-form goal into a multi-step plan and, by default, run it across the fleet.',
+                '',
+                'This is the Director: it plans a sequence of skills (dispatch_inference, web_search,',
+                'worker_list, worker_load_model, etc — see GET /director/skills on the API) from your',
+                'request, then executes each step in order and returns the results. Reach for this instead',
+                'of modelreins_dispatch when a goal needs more than one action, or you want the fleet',
+                'itself to decide the steps rather than picking a single worker by hand.',
+                '',
+                'Set auto_execute: false to preview the plan without running it, so you can inspect the',
+                'proposed steps before committing the fleet to them.',
+                '',
+                'Caveat: the web_search skill is currently a stub (returns no results) pending the',
+                'Neutron-as-worker integration — a plan that includes it will run but find nothing yet.',
+            ].join('\n'),
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    request: {
+                        type: 'string',
+                        description: 'The goal, in plain language. The planner only sees this text — be as specific as a good dispatch prompt.',
+                    },
+                    auto_execute: {
+                        type: 'boolean',
+                        description: 'Execute the plan immediately after planning it. Default true. Set false to preview only.',
+                    },
+                },
+                required: ['request'],
+            },
+        },
+
     ],
 }));
 
@@ -531,11 +565,74 @@ mcp.setRequestHandler(CallToolRequestSchema, async (req) => {
         };
     }
 
+    // ── modelreins_plan ────────────────────────────────────────────────────────
+
+    if (name === 'modelreins_plan') {
+        const { request, auto_execute } = args;
+        const shouldExecute = auto_execute !== false;
+
+        const planRes = await api('POST', '/director/plan', {
+            request,
+            auto_execute: shouldExecute,
+        });
+
+        if (!planRes.data?.success) {
+            return {
+                content: [{
+                    type: 'text',
+                    text: `Planning failed (HTTP ${planRes.status}): ${JSON.stringify(planRes.data)}`,
+                }],
+            };
+        }
+
+        const { plan_id, plan } = planRes.data;
+        const lines = [`## Director Plan #${plan_id}`, ''];
+        lines.push(`Rationale: ${plan.rationale}`);
+        lines.push(`Risk tier: ${plan.risk_tier}`);
+        lines.push(`Steps (${plan.step_count}):`);
+        plan.steps.forEach((s, i) => {
+            lines.push(`  ${i + 1}. ${s.tool_name} ${JSON.stringify(s.arguments)}`);
+            if (s.rationale) lines.push(`     -> ${s.rationale}`);
+        });
+
+        if (!shouldExecute) {
+            lines.push('', 'Not executed (auto_execute=false). Call modelreins_plan again with auto_execute:true to run it.');
+            return { content: [{ type: 'text', text: lines.join('\n') }] };
+        }
+
+        const execRes = await api('POST', '/director/execute', { plan_id });
+
+        // api() always returns a truthy data object (even on network failure),
+        // so failure must be detected via the HTTP status / success flag.
+        if (execRes.status < 200 || execRes.status >= 300 || execRes.data.success === false) {
+            lines.push('', `## Execution FAILED (HTTP ${execRes.status})`);
+            lines.push(`Error: ${execRes.data.error || execRes.data.detail || JSON.stringify(execRes.data)}`);
+            lines.push(`Plan #${plan_id} was created but not executed. Call modelreins_plan again (or POST /director/execute with this plan_id) to run it.`);
+            return { content: [{ type: 'text', text: lines.join('\n') }] };
+        }
+
+        const { status: finalStatus, results } = execRes.data;
+        lines.push('', `## Execution — ${finalStatus || 'unknown'}`);
+        for (const r of (results || [])) {
+            const mark = r.status === 'done' ? 'done' : r.status === 'failed' ? 'FAILED' : (r.status || 'unknown');
+            lines.push(`  [${r.step_index + 1}] ${r.tool_name.padEnd(20)} ${mark}`);
+            if (r.status === 'done' && r.result !== undefined) {
+                const preview = typeof r.result === 'string' ? r.result : JSON.stringify(r.result);
+                lines.push(`      ${preview.slice(0, 400)}`);
+            }
+            if (r.status === 'failed' && r.error) {
+                lines.push(`      error: ${r.error}`);
+            }
+        }
+
+        return { content: [{ type: 'text', text: lines.join('\n') }] };
+    }
+
     // ── modelreins_status ─────────────────────────────────────────────────────
 
     if (name === 'modelreins_status') {
         const [workers, jobs, schedules] = await Promise.all([
-            api('GET', '/workers'),
+            api('GET', '/fleet/workers'),
             api('GET', '/jobs?limit=5'),
             api('GET', '/schedules'),
         ]);
@@ -544,8 +641,15 @@ mcp.setRequestHandler(CallToolRequestSchema, async (req) => {
 
         // Workers
         const wList = workers.data?.workers || [];
-        lines.push(`### Workers (${wList.length} known)`);
-        if (wList.length === 0) {
+        // An empty list and a failed request are NOT the same finding -- collapsing
+        // them into "No workers registered" is what let 12 live workers read as
+        // zero for as long as that line existed (see 71be396). Say which happened.
+        const wFailed = workers.status !== 200;
+        lines.push(`### Workers (${wFailed ? 'unreadable' : `${wList.length} known`})`);
+        if (wFailed) {
+            lines.push(`  COULD NOT READ /fleet/workers — HTTP ${workers.status}${workers.data?.error ? ` (${workers.data.error})` : ''}.`);
+            lines.push('  This is a failed check, not an empty fleet.');
+        } else if (wList.length === 0) {
             lines.push('  No workers registered.');
         }
         for (const w of wList) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mediagato/modelreins-channel",
-  "version": "4.10.0",
+  "version": "4.11.0",
   "description": "ModelReins MCP Channel — turn any Claude Code session into a ModelReins worker",
   "type": "module",
   "main": "modelreins-channel.mjs",
@@ -17,6 +17,6 @@
     "channel",
     "ai-orchestration"
   ],
-  "license": "BSL-1.1",
+  "license": "MIT",
   "homepage": "https://modelreins.com"
 }