@mediagato/modelreins-channel 4.12.5 → 4.12.6

package/modelreins-channel.mjs

@@ -96,7 +96,7 @@
  * Required:
  *   MODELREINS_URL    — Dashboard URL. Examples:
  *                       https://app.modelreins.com        (hosted)
- *                       http://192.168.0.246:8484         (self-hosted LAN)
+ *                       http://your-server:8484           (self-hosted)
  *                       http://localhost:8484             (local dev)
  *
  *   MODELREINS_TOKEN  — Worker auth token. Find it in the dashboard under
@@ -1262,14 +1262,37 @@ await mcp.connect(new StdioServerTransport());
  * full worker context without a separate lookup.
  */
 async function heartbeat() {
+    // An outbound-only session must NOT advertise itself as available work.
+    // It used to report 'active' with details 'idle, polling' while pollJobs()
+    // had never started -- both false. Cost: a job dispatched to such a seat
+    // sat "pending" for 6.4 hours while the dashboard showed the worker
+    // "active" the whole time, and nothing anywhere could tell the difference
+    // (2026-09-03). The control that proved it was a real finding: the same
+    // dispatch to a consuming worker was claimed and completed in 18 seconds.
+    //
+    // Worse than the manual case: app.py's routing selects
+    // `status NOT IN ('offline','maintenance')`, so an outbound-only worker
+    // reporting 'active' is a valid auto-route target -- `assigned_to: "auto"`
+    // could silently park a job on a seat that will never claim it.
+    //
+    // 'offline' is the correct report and the only safe one here: it is in the
+    // routing exclusion list, and unlike 'maintenance' and 'retired' it is NOT
+    // sticky server-side (app.py:4104,4107), so flipping MODELREINS_RECEIVE_JOBS
+    // back to true restores 'active' on the very next heartbeat with no manual
+    // unpark call. The heartbeat itself keeps flowing either way, so
+    // last_heartbeat still proves the process is alive.
+    const idleStatus = RECEIVE_JOBS ? 'active' : 'offline';
+    const idleDetails = RECEIVE_JOBS
+        ? 'idle, polling'
+        : 'outbound-only (MODELREINS_RECEIVE_JOBS=false) — never claims dispatched jobs';
     await api('PUT', '/presence', {
         instance: WORKER_NAME,
-        status: currentJobId ? 'busy' : 'active',
+        status: currentJobId ? 'busy' : idleStatus,
         project: 'channel',
         worker_type: 'channel',
         model: WORKER_MODEL,
         tags: WORKER_TAGS,
-        details: currentJobId ? `working on job #${currentJobId}` : 'idle, polling',
+        details: currentJobId ? `working on job #${currentJobId}` : idleDetails,
     });
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mediagato/modelreins-channel",
-  "version": "4.12.5",
+  "version": "4.12.6",
   "description": "ModelReins MCP Channel — turn any Claude Code session into a ModelReins worker",
   "type": "module",
   "main": "modelreins-channel.mjs",