@bybrawe/opencode-loop 0.5.35 → 0.5.36

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.5.36
+
+Empty-turn fail-safe release.
+
+- Distinguish a completed assistant message from a meaningful completed Loop turn instead of treating a timestamp-only blank reply as success.
+- Count non-empty assistant text and tool/file/patch/artifact activity anywhere in the logical run as meaningful work, including tool-only runs with a blank final assistant tail.
+- Refund a completed-but-empty logical run so it does not consume `runCount`, `--max-runs`, or normal success finalization/checkpoint behavior.
+- Persist consecutive empty-turn state across reloads, retry one empty completion with bounded delay, then pause safely after the second consecutive empty turn with a visible warning instead of injecting prompts forever.
+- Recover stale host `busy` state for already-completed empty turns so the fail-safe can finalize them rather than leaving the Loop stuck between busy and due states.
+- Keep release metadata automation compatible with the README's `Current stable release` marker so future release prep does not fail on the documented format.
+- Add focused regressions for blank/whitespace replies, tool activity, max-run refund/re-enable, bounded retry, fail-safe pause, successful streak reset, and generated-bundle parity; full Ubuntu/Windows CI, real-host, Goal coexistence, lifecycle, and single-file bundle gates are green on the feature head.
+
 ## 0.5.35
 
 - Treat OpenCode `session.status=retry` as authoritative provider ownership: retry and unreadable status can no longer age into idle and cause an overlapping Loop turn; a genuinely completed current assistant message can still release stale retry safely.

package/README.md

@@ -4,7 +4,7 @@
 
 OpenCode Loop adds `/loop`, scheduled prompt/command/shell jobs, compact scheduling, verification/checkpoints, and the `opencode-loopd` background daemon.
 
-> **Current stable release: `0.5.35`.**
+> **Current stable release: `0.5.36`.**
 
 ## Install or update
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bybrawe/opencode-loop",
-  "version": "0.5.35",
+  "version": "0.5.36",
   "description": "Claude Code/Codex style /loop and experimental goal mode for OpenCode: heartbeat scheduler, idle-safe loops, scheduled commands, compact scheduling, verification, checkpoints, and persistent coding goals.",
   "type": "module",
   "main": "src/index.js",
@@ -21,8 +21,8 @@
     "build:plugin": "bun build src/source/v1.js --outfile=src/index.js --target=bun --format=esm --external=@opencode-ai/plugin/tool",
     "build:plugin:npm": "npm run build:plugin",
     "prepack": "node --check src/index.js",
-    "check": "node --check src/source/v1.js && node --check src/source/core/args.js && node --check src/source/core/continuation.js && node --check src/source/core/schedule-syntax.js && node --check src/source/core/state.js && node --check src/source/core/jobs.js && node --check src/source/core/process.js && node --check src/source/opencode/sdk.js && node --check src/source/opencode/session-context.js && node --check src/source/opencode/command-router.js && node --check src/source/opencode/goal-commands.js && node --check src/source/opencode/loop-commands.js && node --check src/source/opencode/loop-registration.js && node --check src/source/runtime/session-activity.js && node --check src/source/runtime/session-status.js && node --check src/source/runtime/schedule-policy.js && node --check src/source/runtime/scheduler-diagnostics.js && node --check src/source/runtime/companion-goal.js && node --check src/source/runtime/loop-diagnostics.js && node --check src/source/runtime/compaction.js && node --check src/source/runtime/action-dispatch.js && node --check src/source/runtime/network-recovery.js && node --check src/source/runtime/terminal-guard.js && node --check src/source/runtime/run-finalization.js && node --check src/source/runtime/run-admission.js && node --check src/source/runtime/executor.js && node --check src/source/runtime/scheduler.js && node --check src/source/runtime/goal-prompt.js && node --check src/source/runtime/goal-report.js && node --check src/source/runtime/goal-evidence.js && node --check src/source/runtime/goal-runtime.js && node --check src/source/runtime/goal-policy.js && node --check src/source/runtime/goal-steering.js && node --check src/source/runtime/job-workspace.js && node --check src/source/opencode2/prompt-runtime.js && node --check src/source/opencode2/diagnostics.js && node --check src/source/opencode2/logging.js && node --check src/source/legacy-v1.js && node --check src/index.js && node --check scripts/install-node.mjs && node --check scripts/install-with-goals.mjs && node --check scripts/loopd.mjs && node --check scripts/install-test.mjs && node --check scripts/goal-companion-test.mjs && node --check scripts/loopd-test.mjs && node --check scripts/smoke-test.mjs && node --check scripts/host-adapter-contract-test.mjs && node --check scripts/command-router-test.mjs && node --check scripts/goal-command-handlers-test.mjs && node --check scripts/loop-command-handlers-test.mjs && node --check scripts/loop-registration-test.mjs && node --check scripts/schedule-syntax-test.mjs && node --check scripts/schedule-policy-test.mjs && node --check scripts/session-activity-test.mjs && node --check scripts/session-status-test.mjs && node --check scripts/session-status-idle-recovery-test.mjs && node --check scripts/network-recovery-test.mjs && node --check scripts/compaction-runtime-test.mjs && node --check scripts/executor-runtime-test.mjs && node --check scripts/scheduler-runtime-test.mjs && node --check scripts/goal-runtime-test.mjs && node --check scripts/goal-policy-test.mjs && node --check scripts/goal-steering-test.mjs && node --check scripts/job-workspace-test.mjs && node --check scripts/v2-prompt-runtime-test.mjs && node --check scripts/v2-prompt-interval-test.mjs && node --check scripts/v2-command-runtime-test.mjs && node --check scripts/v2-command-adapter-test.mjs && node --check scripts/v2-diagnostics-test.mjs && node --check scripts/v2-logging-test.mjs && node --check scripts/comprehensive-watchdog.mjs && node --check scripts/comprehensive-test.mjs && node --check scripts/host-loop-canary.mjs && node --check scripts/host-goal-steering-canary.mjs && node --check scripts/publish-workflow-test.mjs",
-    "test": "node scripts/publish-workflow-test.mjs && node scripts/command-router-test.mjs && node scripts/goal-command-handlers-test.mjs && node scripts/loop-command-handlers-test.mjs && node scripts/loop-registration-test.mjs && node scripts/schedule-syntax-test.mjs && node scripts/schedule-policy-test.mjs && node scripts/session-activity-test.mjs && node scripts/session-status-test.mjs && node scripts/session-status-idle-recovery-test.mjs && node scripts/network-recovery-test.mjs && node scripts/compaction-runtime-test.mjs && node scripts/action-dispatch-test.mjs && node scripts/run-finalization-test.mjs && node scripts/run-admission-test.mjs && node scripts/executor-runtime-test.mjs && node scripts/scheduler-runtime-test.mjs && node scripts/goal-runtime-test.mjs && node scripts/goal-policy-test.mjs && node scripts/goal-steering-test.mjs && node scripts/job-workspace-test.mjs && node scripts/v2-prompt-runtime-test.mjs && node scripts/v2-prompt-interval-test.mjs && node scripts/v2-command-runtime-test.mjs && node scripts/v2-command-adapter-test.mjs && node scripts/v2-diagnostics-test.mjs && node scripts/v2-logging-test.mjs && node scripts/install-test.mjs && node scripts/goal-companion-test.mjs && node scripts/loopd-test.mjs && node scripts/smoke-test.mjs && node scripts/host-adapter-contract-test.mjs && node scripts/comprehensive-watchdog.mjs",
+    "check": "node --check src/source/v1.js && node --check src/source/core/args.js && node --check src/source/core/continuation.js && node --check src/source/core/schedule-syntax.js && node --check src/source/core/state.js && node --check src/source/core/jobs.js && node --check src/source/core/process.js && node --check src/source/opencode/sdk.js && node --check src/source/opencode/session-context.js && node --check src/source/opencode/command-router.js && node --check src/source/opencode/goal-commands.js && node --check src/source/opencode/loop-commands.js && node --check src/source/opencode/loop-registration.js && node --check src/source/runtime/session-activity.js && node --check src/source/runtime/session-status.js && node --check src/source/runtime/schedule-policy.js && node --check src/source/runtime/scheduler-diagnostics.js && node --check src/source/runtime/companion-goal.js && node --check src/source/runtime/loop-diagnostics.js && node --check src/source/runtime/compaction.js && node --check src/source/runtime/action-dispatch.js && node --check src/source/runtime/network-recovery.js && node --check src/source/runtime/empty-turn.js && node --check src/source/runtime/terminal-guard.js && node --check src/source/runtime/run-finalization.js && node --check src/source/runtime/run-admission.js && node --check src/source/runtime/executor.js && node --check src/source/runtime/scheduler.js && node --check src/source/runtime/goal-prompt.js && node --check src/source/runtime/goal-report.js && node --check src/source/runtime/goal-evidence.js && node --check src/source/runtime/goal-runtime.js && node --check src/source/runtime/goal-policy.js && node --check src/source/runtime/goal-steering.js && node --check src/source/runtime/job-workspace.js && node --check src/source/opencode2/prompt-runtime.js && node --check src/source/opencode2/diagnostics.js && node --check src/source/opencode2/logging.js && node --check src/source/legacy-v1.js && node --check src/index.js && node --check scripts/install-node.mjs && node --check scripts/install-with-goals.mjs && node --check scripts/loopd.mjs && node --check scripts/install-test.mjs && node --check scripts/goal-companion-test.mjs && node --check scripts/loopd-test.mjs && node --check scripts/smoke-test.mjs && node --check scripts/host-adapter-contract-test.mjs && node --check scripts/command-router-test.mjs && node --check scripts/goal-command-handlers-test.mjs && node --check scripts/loop-command-handlers-test.mjs && node --check scripts/loop-registration-test.mjs && node --check scripts/schedule-syntax-test.mjs && node --check scripts/schedule-policy-test.mjs && node --check scripts/session-activity-test.mjs && node --check scripts/session-status-test.mjs && node --check scripts/session-status-idle-recovery-test.mjs && node --check scripts/empty-turn-recovery-test.mjs && node --check scripts/network-recovery-test.mjs && node --check scripts/compaction-runtime-test.mjs && node --check scripts/executor-runtime-test.mjs && node --check scripts/scheduler-runtime-test.mjs && node --check scripts/goal-runtime-test.mjs && node --check scripts/goal-policy-test.mjs && node --check scripts/goal-steering-test.mjs && node --check scripts/job-workspace-test.mjs && node --check scripts/v2-prompt-runtime-test.mjs && node --check scripts/v2-prompt-interval-test.mjs && node --check scripts/v2-command-runtime-test.mjs && node --check scripts/v2-command-adapter-test.mjs && node --check scripts/v2-diagnostics-test.mjs && node --check scripts/v2-logging-test.mjs && node --check scripts/comprehensive-watchdog.mjs && node --check scripts/comprehensive-test.mjs && node --check scripts/host-loop-canary.mjs && node --check scripts/host-goal-steering-canary.mjs && node --check scripts/publish-workflow-test.mjs",
+    "test": "node scripts/publish-workflow-test.mjs && node scripts/command-router-test.mjs && node scripts/goal-command-handlers-test.mjs && node scripts/loop-command-handlers-test.mjs && node scripts/loop-registration-test.mjs && node scripts/schedule-syntax-test.mjs && node scripts/schedule-policy-test.mjs && node scripts/session-activity-test.mjs && node scripts/session-status-test.mjs && node scripts/session-status-idle-recovery-test.mjs && node scripts/empty-turn-recovery-test.mjs && node scripts/network-recovery-test.mjs && node scripts/compaction-runtime-test.mjs && node scripts/action-dispatch-test.mjs && node scripts/run-finalization-test.mjs && node scripts/run-admission-test.mjs && node scripts/executor-runtime-test.mjs && node scripts/scheduler-runtime-test.mjs && node scripts/goal-runtime-test.mjs && node scripts/goal-policy-test.mjs && node scripts/goal-steering-test.mjs && node scripts/job-workspace-test.mjs && node scripts/v2-prompt-runtime-test.mjs && node scripts/v2-prompt-interval-test.mjs && node scripts/v2-command-runtime-test.mjs && node scripts/v2-command-adapter-test.mjs && node scripts/v2-diagnostics-test.mjs && node scripts/v2-logging-test.mjs && node scripts/install-test.mjs && node scripts/goal-companion-test.mjs && node scripts/loopd-test.mjs && node scripts/smoke-test.mjs && node scripts/host-adapter-contract-test.mjs && node scripts/comprehensive-watchdog.mjs",
     "canary:host": "node scripts/host-loop-canary.mjs && node scripts/host-goal-steering-canary.mjs",
     "install:global": "node scripts/install-with-goals.mjs",
     "pack:zip": "node scripts/make-zip.mjs"

package/scripts/empty-turn-recovery-test.mjs

@@ -0,0 +1,150 @@
+import assert from "node:assert/strict"
+import { activeRunCompletionFromMessages, assistantMessageHasMeaningfulActivity } from "../src/source/opencode/host.js"
+import { createSessionStatusRuntime } from "../src/source/runtime/session-status.js"
+import { createLoopExecutor } from "../src/source/runtime/executor.js"
+import { refundEmptyAssistantTurn, clearEmptyAssistantTurnStreak } from "../src/source/runtime/empty-turn.js"
+import { clearSessionActivity } from "../src/source/runtime/session-activity.js"
+
+const blank = { info: { role: "assistant", time: { created: 120, completed: 130 } }, parts: [] }
+const whitespace = { info: { role: "assistant", time: { created: 120, completed: 130 } }, parts: [{ type: "text", text: "   \n" }] }
+const text = { info: { role: "assistant", time: { created: 120, completed: 130 } }, parts: [{ type: "text", text: "done" }] }
+const tool = { info: { role: "assistant", time: { created: 120, completed: 130 } }, parts: [{ type: "tool", callID: "call-1", state: { status: "completed" } }] }
+assert.equal(assistantMessageHasMeaningfulActivity(blank), false)
+assert.equal(assistantMessageHasMeaningfulActivity(whitespace), false)
+assert.equal(assistantMessageHasMeaningfulActivity(text), true)
+assert.equal(assistantMessageHasMeaningfulActivity(tool), true)
+
+let hostMessages = [blank]
+const hostClient = { session: { messages: async () => ({ data: hostMessages }) } }
+assert.equal(await activeRunCompletionFromMessages("/repo", hostClient, "host-empty", { startedAt: 100 }), "empty")
+hostMessages = [tool, { info: { role: "assistant", time: { created: 140, completed: 150 } }, parts: [] }]
+assert.equal(await activeRunCompletionFromMessages("/repo", hostClient, "host-tool-then-blank", { startedAt: 100 }), "completed", "tool activity earlier in the same logical run must prevent a false empty classification")
+hostMessages = [text]
+assert.equal(await activeRunCompletionFromMessages("/repo", hostClient, "host-text", { startedAt: 100 }), "completed")
+
+const pureJob = { id: "pure", enabled: false, paused: false, runCount: 1, maxRuns: 1, lastRunAt: 50 }
+let pure = refundEmptyAssistantTurn(pureJob, { job: { runCount: 1 }, previousLastRunAt: 10, disabledByMaxRuns: true }, 200)
+assert.equal(pure.job.runCount, 0)
+assert.equal(pure.job.enabled, true)
+assert.equal(pure.job.lastRunAt, 10)
+assert.equal(pure.job.runNowRequestedAt, 200)
+assert.equal(pure.job.emptyTurnCount, 1)
+assert.equal(pure.paused, false)
+pure = refundEmptyAssistantTurn(pure.job, { job: { runCount: 1 }, previousLastRunAt: 10, disabledByMaxRuns: true }, 300)
+assert.equal(pure.paused, true)
+assert.equal(pure.job.paused, true)
+assert.equal(pure.job.runNowRequestedAt, undefined)
+clearEmptyAssistantTurnStreak(pure.job)
+assert.equal(pure.job.emptyTurnCount, 0)
+assert.equal(pure.job.lastFailureReason, undefined)
+
+const statusLogs = []
+const statusActive = new Map([["status-empty", { jobId: "j", job: { id: "j" }, startedAt: 100 }]])
+const statusRuntime = createSessionStatusRuntime({
+  activeRuns: statusActive,
+  now: () => 10_000,
+  sessionStatusCacheMs: 0,
+  activeRunCompletionFromMessages: async () => "empty",
+  appendLoopLog: async (...args) => statusLogs.push(args),
+})
+const statusClient = { session: { status: async () => ({ data: { "status-empty": { type: "busy" } } }) } }
+assert.equal(await statusRuntime.sessionStatusType(statusClient, "status-empty", "/repo"), "idle", "a host-busy tail that is already an empty completed assistant turn must settle so the empty-turn guard can run")
+assert.ok(statusLogs.some((entry) => entry[1] === "status-message-empty-recovery"))
+clearSessionActivity("status-empty")
+
+let clock = 1_000
+let outcome = "empty"
+const states = new Map()
+const schedules = []
+const toasts = []
+const notifications = []
+const checkpoints = []
+const key = (directory, sessionID) => String(directory) + ":" + String(sessionID)
+const clone = (value) => JSON.parse(JSON.stringify(value))
+const workspace = {
+  buildPrompt: async () => "continue",
+  ensureBranch: async (_directory, job) => job,
+  watchChanged: async () => false,
+  untilReached: async () => false,
+  createCheckpoint: async (...args) => checkpoints.push(args),
+}
+const goalPolicy = {
+  runGoalChecks: async (_directory, _sessionID, job) => job,
+  applyGoalNoProgressGuard: async (_directory, _client, _sessionID, job) => job,
+}
+const scheduler = {
+  rememberSession: () => {},
+  scheduleDueWork: async (...args) => schedules.push(args),
+}
+const executor = createLoopExecutor({
+  workspace,
+  goalPolicy,
+  scheduler,
+  now: () => clock,
+  readState: async (directory, sessionID) => clone(states.get(key(directory, sessionID)) || { jobs: [] }),
+  writeState: async (directory, sessionID, state) => states.set(key(directory, sessionID), clone(state)),
+  appendLoopLog: async () => {},
+  runShellCommand: async () => ({ code: 0, stdout: "", stderr: "" }),
+  notifyJob: async (...args) => notifications.push(args),
+  toast: async (...args) => toasts.push(args),
+  fireSdk: () => Promise.resolve({}),
+  compactSession: async () => true,
+  activeRunCompletionFromMessages: async () => outcome,
+  busyRetryMs: 5_000,
+})
+const client = { session: { status: async () => ({ data: {} }), prompt: async () => ({ data: {} }), abort: async () => ({ data: {} }) } }
+const directory = "/repo"
+const sessionID = "empty-run"
+states.set(key(directory, sessionID), { jobs: [{
+  id: "job", name: "job", action: "devam et", enabled: true, paused: false, intervalMs: 0, runCount: 0, maxRuns: 1, maxRuntimeMs: 0, timeoutMs: 0,
+}] })
+
+await executor.maybeRunDueJobs(directory, client, sessionID)
+assert.equal(states.get(key(directory, sessionID)).jobs[0].runCount, 1)
+assert.equal(states.get(key(directory, sessionID)).jobs[0].enabled, false, "max-runs is provisionally consumed at dispatch")
+clock += 100
+assert.equal(await executor.finalizeActiveRun(directory, client, sessionID), true)
+let persisted = states.get(key(directory, sessionID)).jobs[0]
+assert.equal(persisted.runCount, 0, "empty completed turn must refund runCount")
+assert.equal(persisted.enabled, true, "empty max-runs attempt must be re-enabled")
+assert.equal(persisted.emptyTurnCount, 1)
+assert.equal(persisted.paused, false)
+assert.equal(checkpoints.length, 0, "empty turn must not run successful finalization/checkpoint work")
+assert.ok(schedules.some((entry) => entry[2] === sessionID && entry[3] === 5_000), "first empty turn retries with bounded delay")
+
+executor.markSessionStatus(sessionID, "idle", clock)
+await executor.maybeRunDueJobs(directory, client, sessionID)
+clock += 100
+assert.equal(await executor.finalizeActiveRun(directory, client, sessionID), true)
+persisted = states.get(key(directory, sessionID)).jobs[0]
+assert.equal(persisted.runCount, 0)
+assert.equal(persisted.emptyTurnCount, 2)
+assert.equal(persisted.paused, true, "second consecutive empty completed turn must fail safe instead of looping forever")
+assert.ok(notifications.some((entry) => entry[1]?.id === "job" && entry[2] === "empty_turn"))
+assert.ok(toasts.some((entry) => /paused after 2 consecutive completed assistant turns/i.test(String(entry[1]))))
+
+const recoverySession = "empty-then-success"
+outcome = "empty"
+states.set(key(directory, recoverySession), { jobs: [{
+  id: "recover", name: "recover", action: "continue", enabled: true, paused: false, intervalMs: 0, runCount: 0, maxRuns: 0, maxRuntimeMs: 0, timeoutMs: 0,
+}] })
+await executor.maybeRunDueJobs(directory, client, recoverySession)
+clock += 100
+await executor.finalizeActiveRun(directory, client, recoverySession)
+assert.equal(states.get(key(directory, recoverySession)).jobs[0].emptyTurnCount, 1)
+executor.markSessionStatus(recoverySession, "idle", clock)
+outcome = "completed"
+await executor.maybeRunDueJobs(directory, client, recoverySession)
+clock += 100
+await executor.finalizeActiveRun(directory, client, recoverySession)
+const recovered = states.get(key(directory, recoverySession)).jobs[0]
+assert.equal(recovered.emptyTurnCount, 0, "a meaningful completed turn resets the consecutive empty streak")
+assert.equal(recovered.lastFailureReason, undefined)
+assert.equal(recovered.runCount, 1)
+assert.ok(checkpoints.some((entry) => entry[2]?.id === "recover"), "meaningful completion still follows normal finalization")
+
+executor.disposeSession(sessionID)
+executor.disposeSession(recoverySession)
+clearSessionActivity(sessionID)
+clearSessionActivity(recoverySession)
+console.log("empty-turn recovery tests passed")

package/scripts/host-adapter-contract-test.mjs

@@ -61,7 +61,7 @@ assert.equal(compactTuiCommandName("other"), undefined)
     "/tmp", messagesClient([{ info: { role: "assistant", time: { created: 50, completed: 90 } } }]), "old", { startedAt: 100 },
   ), "incomplete")
   assert.equal(await activeRunCompletionFromMessages(
-    "/tmp", messagesClient([{ info: { role: "assistant", time: { created: 110, completed: 120 } } }]), "done", { startedAt: 100 },
+    "/tmp", messagesClient([{ info: { role: "assistant", text: "done", time: { created: 110, completed: 120 } } }]), "done", { startedAt: 100 },
   ), "completed")
 }
 
@@ -118,7 +118,7 @@ assert.equal(compactTuiCommandName("other"), undefined)
     session: {
       messages: async (args) => {
         calls.push(["messages", args])
-        return { data: [{ info: { role: "assistant", time: { created: 10, completed: 20 } } }] }
+        return { data: [{ info: { role: "assistant", text: "adapter completed", time: { created: 10, completed: 20 } } }] }
       },
     },
   }

package/scripts/host-goal-coexistence-canary.mjs

@@ -0,0 +1,419 @@
+import assert from "node:assert/strict"
+import { existsSync } from "node:fs"
+import { createServer } from "node:http"
+import net from "node:net"
+import { spawn } from "node:child_process"
+import { mkdir, mkdtemp, readFile, readdir, rm, writeFile } from "node:fs/promises"
+import os from "node:os"
+import path from "node:path"
+import { fileURLToPath, pathToFileURL } from "node:url"
+
+const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..")
+const isWindows = process.platform === "win32"
+const GOAL_OBJECTIVE = "prove dedicated Goal owns continuation over Loop"
+const GOAL_PROMPT_MARKER = "Continue working toward the active OpenCode goal."
+const LOOP_PROMPT_MARKER = "AUTONOMOUS OPENCODE LOOP ITERATION"
+
+function resolveOpenCodeBinary() {
+  if (!isWindows) return path.join(repoRoot, "node_modules", ".bin", "opencode")
+  const candidates = [
+    path.join(repoRoot, "node_modules", "opencode-windows-x64", "bin", "opencode.exe"),
+    path.join(repoRoot, "node_modules", "opencode-windows-x64-baseline", "bin", "opencode.exe"),
+    path.join(repoRoot, "node_modules", "opencode-windows-arm64", "bin", "opencode.exe"),
+  ]
+  const found = candidates.find((candidate) => existsSync(candidate))
+  if (!found) throw new Error(`OpenCode native Windows binary was not installed. Checked: ${candidates.join(", ")}`)
+  return found
+}
+
+const opencodeBin = resolveOpenCodeBinary()
+
+function appendLog(current, chunk, limit = 80_000) {
+  return (current + String(chunk)).slice(-limit)
+}
+
+async function seedConfigDependencies(dir) {
+  await mkdir(path.join(dir, "node_modules"), { recursive: true })
+  const dependencies = { "@opencode-ai/plugin": "*" }
+  await writeFile(path.join(dir, "package.json"), `${JSON.stringify({ private: true, dependencies }, null, 2)}\n`)
+  await writeFile(
+    path.join(dir, "package-lock.json"),
+    `${JSON.stringify({
+      name: "opencode-loop-goal-coexistence-config",
+      lockfileVersion: 3,
+      requires: true,
+      packages: { "": { dependencies } },
+    }, null, 2)}\n`,
+  )
+  await writeFile(path.join(dir, ".gitignore"), "node_modules\npackage.json\npackage-lock.json\nbun.lock\n.gitignore\n")
+}
+
+async function reservePort() {
+  return await new Promise((resolve, reject) => {
+    const server = net.createServer()
+    server.once("error", reject)
+    server.listen(0, "127.0.0.1", () => {
+      const address = server.address()
+      if (!address || typeof address === "string") return reject(new Error("failed to reserve TCP port"))
+      server.close((error) => error ? reject(error) : resolve(address.port))
+    })
+  })
+}
+
+async function waitForTcp(port, child, logs, timeoutMs = 30_000) {
+  const deadline = Date.now() + timeoutMs
+  while (Date.now() < deadline) {
+    if (child.exitCode !== null) throw new Error(`OpenCode server exited before ready.\n${logs()}`)
+    const connected = await new Promise((resolve) => {
+      const socket = net.createConnection({ host: "127.0.0.1", port })
+      socket.once("connect", () => { socket.destroy(); resolve(true) })
+      socket.once("error", () => resolve(false))
+      socket.setTimeout(500, () => { socket.destroy(); resolve(false) })
+    })
+    if (connected) return
+    await new Promise((resolve) => setTimeout(resolve, 100))
+  }
+  throw new Error(`timed out waiting for OpenCode server on ${port}\n${logs()}`)
+}
+
+async function stopProcess(child, timeoutMs = 2_000) {
+  if (!child || child.exitCode !== null) return
+  child.kill()
+  await new Promise((resolve) => {
+    if (child.exitCode !== null) return resolve()
+    const timer = setTimeout(resolve, timeoutMs)
+    child.once("close", () => { clearTimeout(timer); resolve() })
+  })
+}
+
+function spawnOpenCode(args, options = {}) {
+  return spawn(opencodeBin, args, { ...options, windowsHide: true })
+}
+
+async function runOpenCode(args, { cwd, env, timeoutMs = 60_000 }) {
+  return await new Promise((resolve, reject) => {
+    const child = spawnOpenCode(args, { cwd, env })
+    let stdout = ""
+    let stderr = ""
+    let settled = false
+    child.stdout?.on("data", (chunk) => { stdout = appendLog(stdout, chunk) })
+    child.stderr?.on("data", (chunk) => { stderr = appendLog(stderr, chunk) })
+    const finish = (fn, value) => {
+      if (settled) return
+      settled = true
+      clearTimeout(timer)
+      fn(value)
+    }
+    const timer = setTimeout(() => {
+      void stopProcess(child)
+      finish(reject, new Error(`OpenCode command timed out: ${args.join(" ")}\nstdout:\n${stdout}\nstderr:\n${stderr}`))
+    }, timeoutMs)
+    child.once("error", (error) => finish(reject, error))
+    child.once("close", (code) => {
+      if (code !== 0) return finish(reject, new Error(`OpenCode command exited ${code}: ${args.join(" ")}\nstdout:\n${stdout}\nstderr:\n${stderr}`))
+      finish(resolve, { stdout, stderr })
+    })
+  })
+}
+
+function contentText(content) {
+  if (typeof content === "string") return content
+  if (!Array.isArray(content)) return ""
+  return content.map((part) => typeof part?.text === "string" ? part.text : typeof part?.content === "string" ? part.content : "").join("\n")
+}
+
+function lastUserMessageText(body) {
+  const messages = Array.isArray(body?.messages) ? body.messages : []
+  for (let index = messages.length - 1; index >= 0; index -= 1) {
+    if (messages[index]?.role === "user") return contentText(messages[index]?.content)
+  }
+  return contentText(messages.at(-1)?.content)
+}
+
+function streamText(res, content, sequence) {
+  const id = `chatcmpl-loop-goal-coexistence-${sequence}`
+  const created = Math.floor(Date.now() / 1000)
+  res.writeHead(200, {
+    "content-type": "text/event-stream; charset=utf-8",
+    "cache-control": "no-cache",
+    connection: "keep-alive",
+  })
+  const send = (value) => res.write(`data: ${JSON.stringify(value)}\n\n`)
+  send({
+    id,
+    object: "chat.completion.chunk",
+    created,
+    model: "canary",
+    choices: [{ index: 0, delta: { role: "assistant", content }, finish_reason: null }],
+  })
+  send({
+    id,
+    object: "chat.completion.chunk",
+    created,
+    model: "canary",
+    choices: [{ index: 0, delta: {}, finish_reason: "stop" }],
+    usage: { prompt_tokens: 40, completion_tokens: 4, total_tokens: 44 },
+  })
+  res.end("data: [DONE]\n\n")
+}
+
+function startProvider() {
+  let releaseGoal
+  const goalRelease = new Promise((resolve) => { releaseGoal = resolve })
+  const stats = { chatRequests: 0, goalRequests: 0, loopRequests: 0, otherRequests: 0, paths: [] }
+  const server = createServer(async (req, res) => {
+    const url = new URL(req.url ?? "/", "http://127.0.0.1")
+    stats.paths.push(`${req.method} ${url.pathname}`)
+    if (req.method === "GET" && url.pathname.endsWith("/models")) {
+      res.writeHead(200, { "content-type": "application/json" })
+      res.end(JSON.stringify({ object: "list", data: [{ id: "canary", object: "model", owned_by: "canary" }] }))
+      return
+    }
+    if (req.method !== "POST" || !url.pathname.endsWith("/chat/completions")) {
+      res.writeHead(404, { "content-type": "application/json" })
+      res.end(JSON.stringify({ error: { message: `unexpected endpoint: ${req.method} ${url.pathname}` } }))
+      return
+    }
+
+    let raw = ""
+    for await (const chunk of req) raw += String(chunk)
+    const body = raw ? JSON.parse(raw) : {}
+    const text = lastUserMessageText(body)
+    stats.chatRequests += 1
+    const sequence = stats.chatRequests
+
+    if (text.includes(GOAL_PROMPT_MARKER) && text.includes(GOAL_OBJECTIVE)) {
+      stats.goalRequests += 1
+      if (stats.goalRequests === 1) await goalRelease
+      streamText(res, `GOAL_TURN_${stats.goalRequests}`, sequence)
+      return
+    }
+    if (text.includes(LOOP_PROMPT_MARKER)) {
+      stats.loopRequests += 1
+      streamText(res, `UNEXPECTED_LOOP_TURN_${stats.loopRequests}`, sequence)
+      return
+    }
+
+    stats.otherRequests += 1
+    streamText(res, `OTHER_TURN_${stats.otherRequests}`, sequence)
+  })
+
+  return {
+    stats,
+    releaseGoal() { releaseGoal() },
+    async listen() {
+      await new Promise((resolve, reject) => {
+        server.once("error", reject)
+        server.listen(0, "127.0.0.1", resolve)
+      })
+      const address = server.address()
+      if (!address || typeof address === "string") throw new Error("failed to start deterministic coexistence provider")
+      return address.port
+    },
+    async close() {
+      releaseGoal()
+      await new Promise((resolve) => server.close(() => resolve()))
+    },
+  }
+}
+
+async function waitFor(predicate, description, diagnostics, timeoutMs = 45_000) {
+  const deadline = Date.now() + timeoutMs
+  while (Date.now() < deadline) {
+    if (await predicate()) return
+    await new Promise((resolve) => setTimeout(resolve, 50))
+  }
+  const detail = typeof diagnostics === "function" ? await diagnostics() : diagnostics
+  throw new Error(`timed out waiting for ${description}\n${detail}`)
+}
+
+async function readActiveGoal(workspace, sessionID) {
+  const dir = path.join(workspace, ".opencode", "goals")
+  try {
+    for (const name of await readdir(dir)) {
+      if (!name.endsWith(".json")) continue
+      try {
+        const value = JSON.parse(await readFile(path.join(dir, name), "utf8"))
+        if (value?.sessionID === sessionID) return value
+      } catch {}
+    }
+  } catch {}
+  return undefined
+}
+
+async function main() {
+  const goalPackageRoot = path.join(repoRoot, "node_modules", "@bybrawe", "opencode-goal")
+  const goalPackageJson = path.join(goalPackageRoot, "package.json")
+  assert.ok(existsSync(goalPackageJson), "@bybrawe/opencode-goal must be installed before the coexistence canary")
+  const goalPackage = JSON.parse(await readFile(goalPackageJson, "utf8"))
+
+  const workspace = await mkdtemp(path.join(os.tmpdir(), "opencode-loop-goal-coexistence-"))
+  const home = path.join(workspace, ".home")
+  const projectConfig = path.join(workspace, ".opencode")
+  const globalConfig = path.join(home, ".config", "opencode")
+  const pluginDir = path.join(projectConfig, "plugins")
+  const commandDir = path.join(projectConfig, "commands")
+  const agentDir = path.join(projectConfig, "agents")
+  const provider = startProvider()
+  const providerPort = await provider.listen()
+  let server
+  let serverLog = ""
+  let goalCommandError = null
+  let loopCommandError = null
+
+  await mkdir(pluginDir, { recursive: true })
+  await mkdir(commandDir, { recursive: true })
+  await mkdir(agentDir, { recursive: true })
+  await seedConfigDependencies(projectConfig)
+  await seedConfigDependencies(globalConfig)
+
+  const loopPluginEntry = pathToFileURL(path.join(repoRoot, "src", "index.js")).href
+  const goalPackageSpec = pathToFileURL(goalPackageRoot).href
+  await writeFile(path.join(pluginDir, "opencode-loop.js"), `export { default as OpenCodeLoopPlugin } from ${JSON.stringify(loopPluginEntry)}\n`)
+  await writeFile(path.join(commandDir, "loop.md"), `---\ndescription: Start a coexistence Loop\nagent: opencode-loop-local\n---\n\nOpenCode Loop local command handled. Reply exactly: OK.\n`)
+  await writeFile(path.join(agentDir, "opencode-loop-local.md"), `---\ndescription: Local Loop coexistence acknowledgement\nmode: primary\npermission:\n  "*": deny\n---\n\nReply exactly: OK\n`)
+  await writeFile(path.join(workspace, "opencode.json"), `${JSON.stringify({
+    $schema: "https://opencode.ai/config.json",
+    plugin: [goalPackageSpec],
+    model: "canary/canary",
+    small_model: "canary/canary",
+    provider: {
+      canary: {
+        npm: "@ai-sdk/openai-compatible",
+        name: "Deterministic Loop Goal Coexistence Canary",
+        options: { baseURL: `http://127.0.0.1:${providerPort}/v1`, apiKey: "canary-key" },
+        models: { canary: { name: "Deterministic Loop Goal Coexistence Canary", limit: { context: 100000, output: 4096 } } },
+      },
+    },
+  }, null, 2)}\n`)
+
+  const env = {
+    ...process.env,
+    HOME: home,
+    USERPROFILE: home,
+    XDG_CONFIG_HOME: path.join(home, ".config"),
+    XDG_DATA_HOME: path.join(home, ".local", "share"),
+    XDG_CACHE_HOME: path.join(home, ".cache"),
+    OPENCODE_DISABLE_AUTOUPDATE: "true",
+    OPENCODE_DB: ":memory:",
+    OPENCODE_DISABLE_LSP_DOWNLOAD: "true",
+    CI: "true",
+  }
+
+  try {
+    const prewarm = await runOpenCode(["debug", "config"], { cwd: workspace, env, timeoutMs: 60_000 })
+    assert.match(prewarm.stdout, /\{[\s\S]*\}/, `OpenCode config prewarm returned no JSON\n${prewarm.stdout}\n${prewarm.stderr}`)
+
+    const port = await reservePort()
+    server = spawnOpenCode(["serve", "--hostname", "127.0.0.1", "--port", String(port)], { cwd: workspace, env })
+    server.stdout?.on("data", (chunk) => { serverLog = appendLog(serverLog, chunk) })
+    server.stderr?.on("data", (chunk) => { serverLog = appendLog(serverLog, chunk) })
+    await waitForTcp(port, server, () => serverLog)
+
+    const baseURL = `http://127.0.0.1:${port}`
+    const directoryQuery = `directory=${encodeURIComponent(workspace)}`
+    const api = async (pathname, init = {}) => {
+      const separator = pathname.includes("?") ? "&" : "?"
+      const response = await fetch(`${baseURL}${pathname}${separator}${directoryQuery}`, {
+        ...init,
+        headers: { "content-type": "application/json", ...(init.headers ?? {}) },
+        signal: init.signal ?? AbortSignal.timeout(30_000),
+      })
+      const text = await response.text()
+      if (!response.ok) throw new Error(`HTTP ${response.status}: ${text}`)
+      if (!text) return null
+      try { return JSON.parse(text) } catch { return text }
+    }
+
+    const sessionsPayload = await api("/session", { method: "GET" })
+    assert.ok(Array.isArray(sessionsPayload?.data ?? sessionsPayload), "GET /session bootstrap did not return an array")
+    const createdPayload = await api("/session", { method: "POST", body: JSON.stringify({ title: "Loop + Goal ownership canary" }) })
+    const session = createdPayload?.data ?? createdPayload
+    const sessionID = String(session?.id ?? "")
+    assert.ok(sessionID, `OpenCode did not create a session: ${JSON.stringify(createdPayload)}`)
+
+    const commandPath = `/session/${encodeURIComponent(sessionID)}/command`
+    const sendCommand = async (name, argumentsText, signal) => await api(commandPath, {
+      method: "POST",
+      body: JSON.stringify({ agent: "build", model: "canary/canary", command: name, arguments: argumentsText }),
+      signal: signal ?? AbortSignal.timeout(90_000),
+    })
+
+    const goalController = new AbortController()
+    const goalCommand = sendCommand("goal", `${GOAL_OBJECTIVE} --max-turns 5`, goalController.signal).catch((error) => {
+      goalCommandError = error
+      return null
+    })
+
+    const loopStateFile = path.join(workspace, ".opencode", "opencode-loop", `${sessionID}.json`)
+    const loopLogFile = path.join(workspace, ".opencode", "opencode-loop", "loop.log")
+    const diagnostics = async () => {
+      let goal = "missing"
+      let loopState = "missing"
+      let loopLog = "missing"
+      try { goal = JSON.stringify(await readActiveGoal(workspace, sessionID), null, 2) } catch {}
+      try { loopState = await readFile(loopStateFile, "utf8") } catch {}
+      try { loopLog = await readFile(loopLogFile, "utf8") } catch {}
+      return `goal package=${goalPackage.version}\nprovider=${JSON.stringify(provider.stats)}\ngoalCommandError=${String(goalCommandError ?? "none")}\nloopCommandError=${String(loopCommandError ?? "none")}\ngoal=${goal}\nloopState=${loopState}\nloopLog=${loopLog}\nserver log:\n${serverLog}`
+    }
+
+    await waitFor(() => provider.stats.goalRequests === 1, "the first dedicated Goal provider turn to be held open", diagnostics)
+    await waitFor(async () => {
+      const goal = await readActiveGoal(workspace, sessionID)
+      return goal?.status === "active" && goal?.objective === GOAL_OBJECTIVE
+    }, "released Goal package to persist an active same-session Goal", diagnostics)
+
+    const loopController = new AbortController()
+    const loopCommand = sendCommand("loop", "devam et", loopController.signal).catch((error) => {
+      loopCommandError = error
+      return null
+    })
+
+    await waitFor(async () => {
+      try {
+        return (await readFile(loopLogFile, "utf8")).includes("goal-overlap-blocked")
+      } catch {
+        return false
+      }
+    }, "Loop to reject prompt ownership while the dedicated Goal is active", diagnostics, 20_000)
+
+    await new Promise((resolve) => setTimeout(resolve, 500))
+    assert.equal(provider.stats.goalRequests, 1, `Goal provider turn should remain the only autonomous request while overlap is rejected\n${await diagnostics()}`)
+    assert.equal(provider.stats.loopRequests, 0, `Loop must not dispatch while dedicated Goal owns continuation\n${await diagnostics()}`)
+    assert.equal(provider.stats.otherRequests, 0, `command bridge must not leak to the model during ownership rejection\n${await diagnostics()}`)
+
+    try {
+      const loopState = JSON.parse(await readFile(loopStateFile, "utf8"))
+      assert.equal(Array.isArray(loopState.jobs) ? loopState.jobs.length : 0, 0, `blocked prompt Loop must not persist a job: ${JSON.stringify(loopState)}`)
+    } catch (error) {
+      if (error?.code !== "ENOENT") throw error
+    }
+
+    const activeGoal = await readActiveGoal(workspace, sessionID)
+    assert.equal(activeGoal?.status, "active", `Goal must remain active after Loop overlap rejection\n${await diagnostics()}`)
+
+    loopController.abort()
+    goalController.abort()
+    await Promise.allSettled([loopCommand, goalCommand])
+
+    console.log(JSON.stringify({
+      ok: true,
+      platform: process.platform,
+      sessionID,
+      goalPackageVersion: goalPackage.version,
+      provider: provider.stats,
+      dedicatedGoal: { id: activeGoal?.id, status: activeGoal?.status },
+      loop: { blocked: true, persistedJobs: 0 },
+    }, null, 2))
+  } finally {
+    provider.releaseGoal()
+    await stopProcess(server)
+    await provider.close().catch(() => undefined)
+    await rm(workspace, { recursive: true, force: true }).catch(() => undefined)
+  }
+}
+
+main().catch((error) => {
+  console.error(error?.stack || error)
+  process.exitCode = 1
+})

package/src/index.js

@@ -801,11 +801,25 @@ function orderedSessionMessages(messages) {
     return { message, index, created: Number.isFinite(created) ? created : 0 };
   }).sort((a, b) => a.created - b.created || a.index - b.index).map((entry) => entry.message);
 }
+function assistantMessageHasMeaningfulActivity(message) {
+  const parts = Array.isArray(message?.parts) ? message.parts : [];
+  for (const part of parts) {
+    if (!part || typeof part !== "object")
+      continue;
+    if (part.type === "text" && typeof part.text === "string" && part.text.trim())
+      return true;
+    if (["tool", "file", "patch", "artifact"].includes(String(part.type || "")))
+      return true;
+  }
+  const info = message?.info || message || {};
+  return [info.text, info.content, info.summary].some((value) => typeof value === "string" && value.trim());
+}
 async function activeRunCompletionFromMessages(directory, client, sessionID, active) {
   const messages = await readRecentSessionMessages(client, sessionID, directory);
   if (!messages)
     return "unknown";
-  const tail = orderedSessionMessages(messages).at(-1);
+  const ordered = orderedSessionMessages(messages);
+  const tail = ordered.at(-1);
   const info = tail?.info || tail;
   if (!info || info.role !== "assistant")
     return "incomplete";
@@ -816,7 +830,17 @@ async function activeRunCompletionFromMessages(directory, client, sessionID, act
   const startedAt = Number(active?.startedAt || 0);
   if (startedAt > 0 && completed < startedAt && (!Number.isFinite(created) || created < startedAt))
     return "incomplete";
-  return "completed";
+  const relevant = ordered.filter((message) => {
+    const candidate = message?.info || message || {};
+    if (candidate.role !== "assistant")
+      return false;
+    if (startedAt <= 0)
+      return true;
+    const candidateCreated = Number(candidate?.time?.created || 0);
+    const candidateCompleted = Number(candidate?.time?.completed || 0);
+    return candidateCreated >= startedAt || candidateCompleted >= startedAt;
+  });
+  return relevant.some(assistantMessageHasMeaningfulActivity) ? "completed" : "empty";
 }
 async function resolveCompactionModel(directory, client, sessionID, preferredModel) {
   const preferred = normalizedModelRef(preferredModel);
@@ -2853,6 +2877,9 @@ function nonNegativeNumber(value, fallback) {
   const number = Number(value);
   return Number.isFinite(number) && number >= 0 ? number : fallback;
 }
+function settledAssistantCompletion(value) {
+  return value === "completed" || value === "empty";
+}
 function createSessionStatusRuntime(options = {}) {
   const activeRuns = options.activeRuns;
   if (!(activeRuns instanceof Map))
@@ -2947,7 +2974,7 @@ function createSessionStatusRuntime(options = {}) {
     if (!options2.requireIdle && !options2.forceStale)
       return true;
     const completion = options2.forceStale ? await activeRunCompletionFromMessages2(directory, client, sessionID, active) : undefined;
-    if (completion === "completed")
+    if (settledAssistantCompletion(completion))
       return true;
     if (!options2.requireIdle)
       return completion === "unknown" && staleActiveRun(sessionID);
@@ -2977,7 +3004,7 @@ function createSessionStatusRuntime(options = {}) {
     if (!seenAt || now2() - seenAt < sessionStatusCacheMs)
       return false;
     const completion = await activeRunCompletionFromMessages2(directory, client, sessionID, { startedAt: 0 });
-    if (completion !== "completed")
+    if (!settledAssistantCompletion(completion))
       return false;
     markSessionStatus(sessionID, "idle");
     await appendLoopLog2(directory, "status-message-idle-recovery", {
@@ -3012,7 +3039,7 @@ function createSessionStatusRuntime(options = {}) {
         const active = activeRuns.get(sessionID);
         if (active) {
           const completion = await activeRunCompletionFromMessages2(directory, client, sessionID, active);
-          if (completion === "completed" || live.type === "busy" && completion === "unknown" && staleActiveRun(sessionID)) {
+          if (settledAssistantCompletion(completion) || live.type === "busy" && completion === "unknown" && staleActiveRun(sessionID)) {
             markSessionStatus(sessionID, "idle");
             const logDetails = {
               sessionID,
@@ -3020,7 +3047,8 @@ function createSessionStatusRuntime(options = {}) {
               startedAt: active.startedAt,
               ...completion === "completed" ? {} : { staleStatus: live.type }
             };
-            await appendLoopLog2(directory, completion === "completed" ? "status-message-complete-recovery" : "status-stale-recovery", logDetails);
+            const recoveryEvent = completion === "empty" ? "status-message-empty-recovery" : completion === "completed" ? "status-message-complete-recovery" : "status-stale-recovery";
+            await appendLoopLog2(directory, recoveryEvent, logDetails);
             return "idle";
           }
         }
@@ -3042,6 +3070,7 @@ function createSessionStatusRuntime(options = {}) {
     staleActiveRun,
     canFinalizeActiveRun,
     readLiveSessionStatus,
+    activeRunCompletion: activeRunCompletionFromMessages2,
     sessionStatusType,
     sessionIsIdle
   };
@@ -3532,6 +3561,50 @@ function refundInfrastructureRun(job, snapshot = {}, input = {}) {
   return job;
 }
 
+// src/source/runtime/empty-turn.js
+var DEFAULT_MAX_EMPTY_TURNS = 2;
+function guardsEmptyAssistantTurn(job) {
+  const kind = actionKind(job?.action, job || {});
+  return kind === "prompt" || kind === "goal";
+}
+function emptyTurnLimit(job) {
+  const configured = Number(job?.maxEmptyTurns || 0);
+  if (Number.isFinite(configured) && configured > 0)
+    return Math.max(1, Math.floor(configured));
+  return DEFAULT_MAX_EMPTY_TURNS;
+}
+function refundEmptyAssistantTurn(job, active = {}, timestamp = Date.now()) {
+  const chargedCount = Number(active?.job?.runCount ?? job?.runCount ?? 0);
+  const currentCount = Number(job?.runCount || 0);
+  if (chargedCount > 0 && currentCount >= chargedCount)
+    job.runCount = Math.max(0, currentCount - 1);
+  if (Number.isFinite(Number(active?.previousLastRunAt)))
+    job.lastRunAt = Number(active.previousLastRunAt);
+  if (active?.disabledByMaxRuns && Number(job?.maxRuns || 0) > 0 && Number(job?.runCount || 0) < Number(job.maxRuns)) {
+    job.enabled = true;
+  }
+  job.emptyTurnCount = Number(job.emptyTurnCount || 0) + 1;
+  job.lastEmptyTurnAt = Number(timestamp) || Date.now();
+  job.lastFailureReason = "empty_turn";
+  const limit = emptyTurnLimit(job);
+  const paused = job.emptyTurnCount >= limit;
+  if (paused) {
+    job.paused = true;
+    delete job.runNowRequestedAt;
+  } else {
+    job.runNowRequestedAt = Math.max(1, Number(timestamp) || Date.now());
+  }
+  return { job, paused, count: job.emptyTurnCount, limit };
+}
+function clearEmptyAssistantTurnStreak(job) {
+  if (!job)
+    return job;
+  job.emptyTurnCount = 0;
+  if (job.lastFailureReason === "empty_turn")
+    delete job.lastFailureReason;
+  return job;
+}
+
 // src/source/runtime/executor.js
 var DEFAULT_ACTIVE_GUARD_MS = 45000;
 var DEFAULT_BUSY_RETRY_MS2 = 5000;
@@ -3585,6 +3658,7 @@ function createLoopExecutor(options = {}) {
     updateSessionStatusFromEvent,
     staleActiveRun,
     canFinalizeActiveRun,
+    activeRunCompletion,
     sessionStatusType,
     sessionIsIdle,
     markSessionStatus,
@@ -3760,6 +3834,7 @@ function createLoopExecutor(options = {}) {
       return;
     if (!await canFinalizeActiveRun(directory, client, sessionID, active, finalizeOptions))
       return false;
+    const completion = await activeRunCompletion(directory, client, sessionID, active);
     const recoveredStale = staleActiveRun(sessionID);
     if (active.compactionOnly) {
       const pending = compactionRuntime.getPending(sessionID);
@@ -3780,6 +3855,30 @@ function createLoopExecutor(options = {}) {
     if (!job)
       return;
     job.lastFinishedAt = now2();
+    if (completion === "empty" && guardsEmptyAssistantTurn(job)) {
+      const empty = refundEmptyAssistantTurn(job, active, now2());
+      state.jobs = (state.jobs || []).map((candidate) => candidate.id === job.id ? job : candidate);
+      await writeState2(directory, sessionID, state);
+      await appendLoopLog2(directory, "empty-assistant-turn", {
+        sessionID,
+        job: job.name || job.id,
+        count: empty.count,
+        limit: empty.limit,
+        paused: empty.paused,
+        refunded: true
+      });
+      if (empty.paused) {
+        await notifyJob2(directory, job, "empty_turn");
+        await toast2(client, "Loop paused after " + empty.count + " consecutive completed assistant turns with no visible output or tool activity. Resume after changing the model/prompt or use /loop-resume.", "warning");
+        await scheduleDueWork(directory, client, sessionID);
+      } else {
+        await toast2(client, "Loop received an empty completed assistant turn; the logical run was refunded and will retry once.", "warning");
+        await scheduleDueWork(directory, client, sessionID, busyRetryMs);
+      }
+      return true;
+    }
+    if (completion === "completed")
+      clearEmptyAssistantTurnStreak(job);
     if (recoveredStale) {
       await appendLoopLog2(directory, "active-stale-recovery", {
         sessionID,

package/src/source/opencode/host.js

@@ -54,10 +54,22 @@ export function orderedSessionMessages(messages) {
     .map((entry) => entry.message)
 }
 
+export function assistantMessageHasMeaningfulActivity(message) {
+  const parts = Array.isArray(message?.parts) ? message.parts : []
+  for (const part of parts) {
+    if (!part || typeof part !== "object") continue
+    if (part.type === "text" && typeof part.text === "string" && part.text.trim()) return true
+    if (["tool", "file", "patch", "artifact"].includes(String(part.type || ""))) return true
+  }
+  const info = message?.info || message || {}
+  return [info.text, info.content, info.summary].some((value) => typeof value === "string" && value.trim())
+}
+
 export async function activeRunCompletionFromMessages(directory, client, sessionID, active) {
   const messages = await readRecentSessionMessages(client, sessionID, directory)
   if (!messages) return "unknown"
-  const tail = orderedSessionMessages(messages).at(-1)
+  const ordered = orderedSessionMessages(messages)
+  const tail = ordered.at(-1)
   const info = tail?.info || tail
   if (!info || info.role !== "assistant") return "incomplete"
   const completed = Number(info?.time?.completed || 0)
@@ -65,7 +77,16 @@ export async function activeRunCompletionFromMessages(directory, client, session
   if (!Number.isFinite(completed) || completed <= 0) return "incomplete"
   const startedAt = Number(active?.startedAt || 0)
   if (startedAt > 0 && completed < startedAt && (!Number.isFinite(created) || created < startedAt)) return "incomplete"
-  return "completed"
+
+  const relevant = ordered.filter((message) => {
+    const candidate = message?.info || message || {}
+    if (candidate.role !== "assistant") return false
+    if (startedAt <= 0) return true
+    const candidateCreated = Number(candidate?.time?.created || 0)
+    const candidateCompleted = Number(candidate?.time?.completed || 0)
+    return candidateCreated >= startedAt || candidateCompleted >= startedAt
+  })
+  return relevant.some(assistantMessageHasMeaningfulActivity) ? "completed" : "empty"
 }
 
 export async function resolveCompactionModel(directory, client, sessionID, preferredModel) {

package/src/source/runtime/empty-turn.js

@@ -0,0 +1,46 @@
+import { actionKind } from "../core/jobs.js"
+
+export const DEFAULT_MAX_EMPTY_TURNS = 2
+
+export function guardsEmptyAssistantTurn(job) {
+  const kind = actionKind(job?.action, job || {})
+  return kind === "prompt" || kind === "goal"
+}
+
+export function emptyTurnLimit(job) {
+  const configured = Number(job?.maxEmptyTurns || 0)
+  if (Number.isFinite(configured) && configured > 0) return Math.max(1, Math.floor(configured))
+  return DEFAULT_MAX_EMPTY_TURNS
+}
+
+export function refundEmptyAssistantTurn(job, active = {}, timestamp = Date.now()) {
+  const chargedCount = Number(active?.job?.runCount ?? job?.runCount ?? 0)
+  const currentCount = Number(job?.runCount || 0)
+  if (chargedCount > 0 && currentCount >= chargedCount) job.runCount = Math.max(0, currentCount - 1)
+
+  if (Number.isFinite(Number(active?.previousLastRunAt))) job.lastRunAt = Number(active.previousLastRunAt)
+  if (active?.disabledByMaxRuns && Number(job?.maxRuns || 0) > 0 && Number(job?.runCount || 0) < Number(job.maxRuns)) {
+    job.enabled = true
+  }
+
+  job.emptyTurnCount = Number(job.emptyTurnCount || 0) + 1
+  job.lastEmptyTurnAt = Number(timestamp) || Date.now()
+  job.lastFailureReason = "empty_turn"
+
+  const limit = emptyTurnLimit(job)
+  const paused = job.emptyTurnCount >= limit
+  if (paused) {
+    job.paused = true
+    delete job.runNowRequestedAt
+  } else {
+    job.runNowRequestedAt = Math.max(1, Number(timestamp) || Date.now())
+  }
+  return { job, paused, count: job.emptyTurnCount, limit }
+}
+
+export function clearEmptyAssistantTurnStreak(job) {
+  if (!job) return job
+  job.emptyTurnCount = 0
+  if (job.lastFailureReason === "empty_turn") delete job.lastFailureReason
+  return job
+}

package/src/source/runtime/executor.js

@@ -11,6 +11,7 @@ import { createActionDispatcher } from "./action-dispatch.js"
 import { createRunFinalizationRuntime } from "./run-finalization.js"
 import { createRunAdmissionRuntime } from "./run-admission.js"
 import { isTransientNetworkError, networkRetryDelayMs, refundInfrastructureRun } from "./network-recovery.js"
+import { guardsEmptyAssistantTurn, refundEmptyAssistantTurn, clearEmptyAssistantTurnStreak } from "./empty-turn.js"
 
 const DEFAULT_ACTIVE_GUARD_MS = 45_000
 const DEFAULT_BUSY_RETRY_MS = 5_000
@@ -77,6 +78,7 @@ export function createLoopExecutor(options = {}) {
     updateSessionStatusFromEvent,
     staleActiveRun,
     canFinalizeActiveRun,
+    activeRunCompletion,
     sessionStatusType,
     sessionIsIdle,
     markSessionStatus,
@@ -267,6 +269,7 @@ export function createLoopExecutor(options = {}) {
     const active = activeRuns.get(sessionID)
     if (!active) return
     if (!await canFinalizeActiveRun(directory, client, sessionID, active, finalizeOptions)) return false
+    const completion = await activeRunCompletion(directory, client, sessionID, active)
     const recoveredStale = staleActiveRun(sessionID)
     if (active.compactionOnly) {
       const pending = compactionRuntime.getPending(sessionID)
@@ -287,6 +290,31 @@ export function createLoopExecutor(options = {}) {
     let job = (state.jobs || []).find((candidate) => candidate.id === active.jobId)
     if (!job) return
     job.lastFinishedAt = now()
+
+    if (completion === "empty" && guardsEmptyAssistantTurn(job)) {
+      const empty = refundEmptyAssistantTurn(job, active, now())
+      state.jobs = (state.jobs || []).map((candidate) => candidate.id === job.id ? job : candidate)
+      await writeState(directory, sessionID, state)
+      await appendLoopLog(directory, "empty-assistant-turn", {
+        sessionID,
+        job: job.name || job.id,
+        count: empty.count,
+        limit: empty.limit,
+        paused: empty.paused,
+        refunded: true,
+      })
+      if (empty.paused) {
+        await notifyJob(directory, job, "empty_turn")
+        await toast(client, "Loop paused after " + empty.count + " consecutive completed assistant turns with no visible output or tool activity. Resume after changing the model/prompt or use /loop-resume.", "warning")
+        await scheduleDueWork(directory, client, sessionID)
+      } else {
+        await toast(client, "Loop received an empty completed assistant turn; the logical run was refunded and will retry once.", "warning")
+        await scheduleDueWork(directory, client, sessionID, busyRetryMs)
+      }
+      return true
+    }
+
+    if (completion === "completed") clearEmptyAssistantTurnStreak(job)
     if (recoveredStale) {
       await appendLoopLog(directory, "active-stale-recovery", {
         sessionID,

package/src/source/runtime/session-status.js

@@ -24,6 +24,10 @@ function nonNegativeNumber(value, fallback) {
   return Number.isFinite(number) && number >= 0 ? number : fallback
 }
 
+function settledAssistantCompletion(value) {
+  return value === "completed" || value === "empty"
+}
+
 export function createSessionStatusRuntime(options = {}) {
   const activeRuns = options.activeRuns
   if (!(activeRuns instanceof Map)) throw new TypeError("createSessionStatusRuntime requires activeRuns Map")
@@ -114,7 +118,7 @@ export function createSessionStatusRuntime(options = {}) {
     const completion = options.forceStale
       ? await activeRunCompletionFromMessages(directory, client, sessionID, active)
       : undefined
-    if (completion === "completed") return true
+    if (settledAssistantCompletion(completion)) return true
     if (!options.requireIdle) return completion === "unknown" && staleActiveRun(sessionID)
 
     const cached = sessionStatuses.get(sessionID)
@@ -142,7 +146,7 @@ export function createSessionStatusRuntime(options = {}) {
     if (liveType !== "busy") return false
     if (!seenAt || now() - seenAt < sessionStatusCacheMs) return false
     const completion = await activeRunCompletionFromMessages(directory, client, sessionID, { startedAt: 0 })
-    if (completion !== "completed") return false
+    if (!settledAssistantCompletion(completion)) return false
     markSessionStatus(sessionID, "idle")
     await appendLoopLog(directory, "status-message-idle-recovery", {
       sessionID,
@@ -177,7 +181,7 @@ export function createSessionStatusRuntime(options = {}) {
         const active = activeRuns.get(sessionID)
         if (active) {
           const completion = await activeRunCompletionFromMessages(directory, client, sessionID, active)
-          if (completion === "completed" || (live.type === "busy" && completion === "unknown" && staleActiveRun(sessionID))) {
+          if (settledAssistantCompletion(completion) || (live.type === "busy" && completion === "unknown" && staleActiveRun(sessionID))) {
             markSessionStatus(sessionID, "idle")
             const logDetails = {
               sessionID,
@@ -185,11 +189,12 @@ export function createSessionStatusRuntime(options = {}) {
               startedAt: active.startedAt,
               ...(completion === "completed" ? {} : { staleStatus: live.type }),
             }
-            await appendLoopLog(
-              directory,
-              completion === "completed" ? "status-message-complete-recovery" : "status-stale-recovery",
-              logDetails,
-            )
+            const recoveryEvent = completion === "empty"
+              ? "status-message-empty-recovery"
+              : completion === "completed"
+                ? "status-message-complete-recovery"
+                : "status-stale-recovery"
+            await appendLoopLog(directory, recoveryEvent, logDetails)
             return "idle"
           }
         }
@@ -214,6 +219,7 @@ export function createSessionStatusRuntime(options = {}) {
     staleActiveRun,
     canFinalizeActiveRun,
     readLiveSessionStatus,
+    activeRunCompletion: activeRunCompletionFromMessages,
     sessionStatusType,
     sessionIsIdle,
   }