@sorenllm/opencode-forge 0.3.3 → 0.3.4

package/README.md

@@ -130,7 +130,7 @@ What this plugin touches, exhaustively:
 | `<tmp>/opencode-forge/jobs/ledger.jsonl` | job registry ledger (bounded: 1 MB reset, 200 entries) | runtime debris — delete freely, also after uninstall |
 | `<tmp>/opencode-forge/jobs/registry.json` | persistent survivor registry (bounded: 100 entries) | runtime debris — after uninstall, kill any still-running `survive` jobs yourself first |
 | `<tmp>/opencode-forge/watchdog/log.jsonl` | watchdog interventions ledger (bounded: 200 entries, oldest rotated) | runtime debris — delete freely, also after uninstall |
-| `<tmp>/opencode-forge/dispatch/ledger.jsonl` | dispatch ledger: resolved identity/depth, outcomes, tokens/cost, timeouts, lost-on-exit, crew summaries (bounded, capped rotation) | runtime debris — delete freely, also after uninstall |
+| `<tmp>/opencode-forge/dispatch/ledger.jsonl` | dispatch ledger: resolved identity/depth, outcomes, tokens/cost, timeouts, transport interruptions, lost-on-exit, crew summaries (bounded, capped rotation) | runtime debris — delete freely, also after uninstall |
 | `<project>/.opencode/forge.json`, `~/.config/opencode/forge.json` | your dispatch agent definitions (JSONC). **User data — the plugin only reads it, never writes or migrates it** | yours — version the project one, keep the global one out of sync tools if it holds machine-specific models |
 | `~/.cache/opencode/packages/...` | installed package copy | written by the `opencode plugin` installer, not the plugin |
 | `~/.config/opencode/opencode.json` | `plugin` array entry | written by the installer |
@@ -420,6 +420,18 @@ stops polling, suppresses the brief, and ledgers `killed`. On host exit,
 in-flight dispatches are ledgered `lost-on-exit` — sessions are host memory
 objects, there are no orphan processes and no survive semantics.
 
+**Transport-interruption recovery**: the child's prompt is delivered by a
+turn-synchronous HTTP POST that stays open for the whole first turn. If that
+POST dies at the transport layer (fetch abort / network failure — anything
+that is not an HTTP error response), the dispatch does **not** fail: the
+engine ledgers `transport-interrupted` (with the child sessionID) and falls
+back to completion polling under the same deadline — the child session is a
+host-side object and usually keeps running, so its result is still collected
+and delivered normally. The message is never re-POSTed (the prompt may
+already be delivering); a message that never arrived polls as waiting and
+ends in the honest deadline `timeout`. Terminal reports and terminal ledger
+rows carry the child sessionID, dispatchId, parentSessionID, and durationMs.
+
 ### Crew workflow (`/crew`)
 
 `/crew <objective>` registers a crew: decompose the objective into
@@ -447,9 +459,11 @@ ends it honestly and the ledger keeps the history.
   live TUI sessions; prefer sync under `opencode run`.
 - **Host tool ceiling (~262s observed on 1.18.32)**: the host may kill a
   sync tool call that exceeds roughly 262 seconds even though the plugin's
-  own deadline is higher. Keep `timeoutMs` at or below ~240000 for
-  sync-heavy workflows; a killed call still leaves the child session
-  reclaimable via `forge_dispatch_list` / the host API.
+  own deadline is higher. A same-family transport abort (~281s observed,
+  2026-09-27 incident) can also kill the background dispatch's turn POST.
+  Transport-interruption recovery (above) absorbs both: the dispatch falls
+  back to polling and still delivers the child's result; keep `timeoutMs`
+  modest anyway for sync-heavy workflows.
 - **Child permission asks**: a worker that hits a permission ask surfaces the
   ask on the CHILD's session in the TUI. An unanswered ask stalls the child
   until the dispatch deadline — scope worker prompts to avoid permission

package/dist/index.js

@@ -15331,23 +15331,41 @@ Vocabulary: ${r.error.vocabulary.join(", ") || "(none)"}`, r.error.code);
         parts: [{ type: "text", text: composeWorkerPrompt({ prompt: req.prompt, agent: req.agent, shape: r.shape, ...r.role ? { role: r.role } : {} }) }]
       })
     });
-    await Promise.race([turnPost, deadlinePromise]);
-    if (deadlineHit && deps.now() - t0 >= timeoutMs) {
-      const elapsed = deps.now() - t0;
+    turnPost.catch(() => {});
+    try {
+      await Promise.race([turnPost, deadlinePromise]);
+      if (deadlineHit && deps.now() - t0 >= timeoutMs) {
+        const elapsed = deps.now() - t0;
+        deps.sink({
+          ts: new Date().toISOString(),
+          event: "timeout",
+          tier: req.agent,
+          agent: req.agent,
+          identity: r.model,
+          depth: r.depth,
+          sessionID: childID,
+          durationMs: elapsed,
+          ...dispatchId !== undefined ? { dispatchId, parentSessionID: parentSessionID ?? "" } : {}
+        });
+        throw new DispatchError(`forge_dispatch timed out after ${elapsed}ms (deadline ${timeoutMs}ms). Partial state: child session ${childID} is left for the host to reclaim; its transcript remains queryable via the host API.`, "timeout");
+      }
+      await turnPost;
+    } catch (e) {
+      if (e instanceof DispatchError)
+        throw e;
       deps.sink({
         ts: new Date().toISOString(),
-        event: "timeout",
+        event: "transport-interrupted",
         tier: req.agent,
         agent: req.agent,
         identity: r.model,
         depth: r.depth,
         sessionID: childID,
-        durationMs: elapsed,
+        durationMs: deps.now() - t0,
+        note: e instanceof Error ? e.message : String(e),
         ...dispatchId !== undefined ? { dispatchId, parentSessionID: parentSessionID ?? "" } : {}
       });
-      throw new DispatchError(`forge_dispatch timed out after ${elapsed}ms (deadline ${timeoutMs}ms). Partial state: child session ${childID} is left for the host to reclaim; its transcript remains queryable via the host API.`, "timeout");
     }
-    await turnPost;
     let poll = null;
     let messages = [];
     for (;; ) {
@@ -15424,24 +15442,44 @@ Vocabulary: ${r.error.vocabulary.join(", ") || "(none)"}`, r.error.code);
     return result;
   }
   function bgTerminal(reg, dispatchId, identity, req, t0, e) {
+    let entrySessionID = "";
+    let parentSessionID = "";
+    try {
+      const entry = reg.get(dispatchId);
+      entrySessionID = entry.sessionID;
+      parentSessionID = entry.parentSessionID;
+    } catch {}
+    const durationMs = deps.now() - t0;
     const report = {
       agent: req.agent,
       requested: { agent: req.agent, depth: req.depth },
       actual: { model: identity, depth: null },
-      sessionID: "",
+      sessionID: entrySessionID,
       outcome: "error",
-      durationMs: deps.now() - t0,
+      durationMs,
       error: e instanceof Error ? e.message : String(e)
     };
     if (e instanceof DispatchError && e.code === "timeout") {
       report.outcome = "timeout";
       reg.markTimeout(dispatchId, report);
-      deps.onTerminal?.(reg.get(dispatchId).parentSessionID);
+      deps.onTerminal?.(parentSessionID);
       return;
     }
-    deps.sink({ ts: new Date().toISOString(), event: "error", tier: req.agent, identity, outcome: "error", note: report.error });
+    deps.sink({
+      ts: new Date().toISOString(),
+      event: "error",
+      tier: req.agent,
+      agent: req.agent,
+      identity,
+      outcome: "error",
+      sessionID: entrySessionID,
+      durationMs,
+      note: report.error,
+      dispatchId,
+      parentSessionID
+    });
     reg.markError(dispatchId, report);
-    deps.onTerminal?.(reg.get(dispatchId).parentSessionID);
+    deps.onTerminal?.(parentSessionID);
   }
   async function dispatch(req, parentSessionID, opts) {
     const t0 = deps.now();
@@ -15736,7 +15774,7 @@ function validateCrewReport(report, ledgerRows, crew) {
       continue;
     if (row.ts < crew.startedAt)
       continue;
-    if (row.event === "validation" || row.event === "resolve-error" || row.event === "refused-cap" || row.event === "models-dev-degraded" || row.event === "retry-excluded" || row.event === "lost-on-exit" || row.event === "kill-late-completion")
+    if (row.event === "validation" || row.event === "resolve-error" || row.event === "refused-cap" || row.event === "models-dev-degraded" || row.event === "retry-excluded" || row.event === "lost-on-exit" || row.event === "kill-late-completion" || row.event === "transport-interrupted")
       continue;
     if (CREW_DISPATCH_EVENTS.has(row.event) && row.dispatchId)
       rowById.set(row.dispatchId, row);

package/package.json

@@ -1,61 +1,61 @@
-{
-  "name": "@sorenllm/opencode-forge",
-  "version": "0.3.3",
-  "description": "Single general-purpose forge agent for opencode with two orthogonal harnesses and two hang backstops: a plan harness (file-backed plans in .opencode/plan/, approve/close confirmation gates, tick discipline, hard write-ban while planning), a goal harness (autonomous, host-verified objectives in .opencode/goal/), a job supervisor (forge_shell with exit-bound completion — immune to stdio-EOF hangs — idle/success early return, background jobs with poll/log/kill/handoff, exit wakes on session idle), and a builtin-shell hang watchdog (marked timing across all sessions, graded tree-kill with dry-run/off modes, auditable ledger).",
-  "type": "module",
-  "main": "./dist/index.js",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js"
-    },
-    "./server": {
-      "import": "./dist/index.js"
-    }
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "scripts": {
-    "bundle": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && bun build ./plugin.ts --outfile ./dist/index.js --target node --format esm",
-    "test": "node --test tests/*.test.mjs",
-    "typecheck": "tsc --noEmit"
-  },
-  "keywords": [
-    "opencode",
-    "opencode-plugin",
-    "plan",
-    "planning",
-    "workflow",
-    "single-agent",
-    "goal",
-    "background-jobs",
-    "shell",
-    "watchdog"
-  ],
-  "license": "MIT",
-  "author": "chengsongren",
-  "homepage": "https://github.com/ChengZiiii/opencode-forge#readme",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/ChengZiiii/opencode-forge.git"
-  },
-  "bugs": {
-    "url": "https://github.com/ChengZiiii/opencode-forge/issues"
-  },
-  "peerDependencies": {
-    "@opencode-ai/plugin": "^1.18.0"
-  },
-  "devDependencies": {
-    "@opencode-ai/plugin": "^1.18.0",
-    "@types/node": "^22.13.9",
-    "typescript": "^5.8.2"
-  },
-  "engines": {
-    "opencode": "^1.18.0"
-  },
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
-  }
-}
+{
+  "name": "@sorenllm/opencode-forge",
+  "version": "0.3.4",
+  "description": "Single general-purpose forge agent for opencode with two orthogonal harnesses and two hang backstops: a plan harness (file-backed plans in .opencode/plan/, approve/close confirmation gates, tick discipline, hard write-ban while planning), a goal harness (autonomous, host-verified objectives in .opencode/goal/), a job supervisor (forge_shell with exit-bound completion — immune to stdio-EOF hangs — idle/success early return, background jobs with poll/log/kill/handoff, exit wakes on session idle), and a builtin-shell hang watchdog (marked timing across all sessions, graded tree-kill with dry-run/off modes, auditable ledger).",
+  "type": "module",
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js"
+    },
+    "./server": {
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "bundle": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && bun build ./plugin.ts --outfile ./dist/index.js --target node --format esm",
+    "test": "node --test tests/*.test.mjs",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "plan",
+    "planning",
+    "workflow",
+    "single-agent",
+    "goal",
+    "background-jobs",
+    "shell",
+    "watchdog"
+  ],
+  "license": "MIT",
+  "author": "chengsongren",
+  "homepage": "https://github.com/ChengZiiii/opencode-forge#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ChengZiiii/opencode-forge.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ChengZiiii/opencode-forge/issues"
+  },
+  "peerDependencies": {
+    "@opencode-ai/plugin": "^1.18.0"
+  },
+  "devDependencies": {
+    "@opencode-ai/plugin": "^1.18.0",
+    "@types/node": "^22.13.9",
+    "typescript": "^5.8.2"
+  },
+  "engines": {
+    "opencode": "^1.18.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}