agent-relay-server 0.125.0 → 0.127.0

package/public/index.html

@@ -12,36 +12,36 @@
   <link rel="icon" type="image/svg+xml" href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'%3E%3Crect width='32' height='32' rx='6' fill='%2309090b'/%3E%3Ccircle cx='16' cy='16' r='4.5' fill='%2358a6ff'/%3E%3Ccircle cx='6' cy='8' r='2.5' fill='%233fb950'/%3E%3Ccircle cx='26' cy='8' r='2.5' fill='%233fb950'/%3E%3Ccircle cx='6' cy='24' r='2.5' fill='%233fb950'/%3E%3Ccircle cx='26' cy='24' r='2.5' fill='%233fb950'/%3E%3Cline x1='8' y1='9.5' x2='13' y2='14' stroke='%2330363d' stroke-width='1.5'/%3E%3Cline x1='24' y1='9.5' x2='19' y2='14' stroke='%2330363d' stroke-width='1.5'/%3E%3Cline x1='8' y1='22.5' x2='13' y2='18' stroke='%2330363d' stroke-width='1.5'/%3E%3Cline x1='24' y1='22.5' x2='19' y2='18' stroke='%2330363d' stroke-width='1.5'/%3E%3C/svg%3E">
   <link rel="manifest" href="manifest.webmanifest">
   <link rel="apple-touch-icon" href="icons/agent-relay-192.png">
-  <script type="module" crossorigin src="./assets/index-De1tR7J4.js"></script>
+  <script type="module" crossorigin src="./assets/index-Bhy_jnX4.js"></script>
   <link rel="modulepreload" crossorigin href="./assets/chunk-CilyBKbf.js">
   <link rel="modulepreload" crossorigin href="./assets/preload-helper-C_JMBXql.js">
-  <link rel="modulepreload" crossorigin href="./assets/lucide-react-CoU_Xts2.js">
-  <link rel="modulepreload" crossorigin href="./assets/dist-C5z05Vkz.js">
-  <link rel="modulepreload" crossorigin href="./assets/dist-B8tD9ZcR.js">
-  <link rel="modulepreload" crossorigin href="./assets/react-dom-BQICbUuF.js">
-  <link rel="modulepreload" crossorigin href="./assets/dist-V3wu3BHw.js">
-  <link rel="modulepreload" crossorigin href="./assets/dist-CFtFIhu3.js">
-  <link rel="modulepreload" crossorigin href="./assets/dist-CGaHpxnN.js">
-  <link rel="modulepreload" crossorigin href="./assets/dist-DKmTXfpP.js">
+  <link rel="modulepreload" crossorigin href="./assets/lucide-react-NXHPIMsX.js">
+  <link rel="modulepreload" crossorigin href="./assets/dist-BFDfbfNC.js">
+  <link rel="modulepreload" crossorigin href="./assets/dist-BNB3fTO-.js">
+  <link rel="modulepreload" crossorigin href="./assets/react-dom-8yaD9iJG.js">
+  <link rel="modulepreload" crossorigin href="./assets/dist-BD4Xc13v.js">
+  <link rel="modulepreload" crossorigin href="./assets/dist-CHKra2JV.js">
+  <link rel="modulepreload" crossorigin href="./assets/dist-D5w04z0l.js">
+  <link rel="modulepreload" crossorigin href="./assets/dist-C_VOBSaK.js">
   <link rel="modulepreload" crossorigin href="./assets/dist-BiLuYU6G.js">
-  <link rel="modulepreload" crossorigin href="./assets/dist-BJaV2BD4.js">
-  <link rel="modulepreload" crossorigin href="./assets/dist-CjyfQThq.js">
-  <link rel="modulepreload" crossorigin href="./assets/es2015-5DTJe35n.js">
-  <link rel="modulepreload" crossorigin href="./assets/dist-r8wyUTkK.js">
-  <link rel="modulepreload" crossorigin href="./assets/dist-4VwhnLtj.js">
-  <link rel="modulepreload" crossorigin href="./assets/dist-CrUl2aQp.js">
+  <link rel="modulepreload" crossorigin href="./assets/dist-f6MW74eX.js">
+  <link rel="modulepreload" crossorigin href="./assets/dist-BJKxqIQd.js">
+  <link rel="modulepreload" crossorigin href="./assets/es2015-a6fysEVz.js">
+  <link rel="modulepreload" crossorigin href="./assets/dist-CQMQ5iku.js">
+  <link rel="modulepreload" crossorigin href="./assets/dist-DG75bvPp.js">
+  <link rel="modulepreload" crossorigin href="./assets/dist-G8YBD-wp.js">
   <link rel="modulepreload" crossorigin href="./assets/types-BqeSkWrv.js">
   <link rel="modulepreload" crossorigin href="./assets/display-aTnwsqQh.js">
-  <link rel="modulepreload" crossorigin href="./assets/store-Dl9Z8YUS.js">
-  <link rel="modulepreload" crossorigin href="./assets/agent-type-icon-B3i0rndK.js">
-  <link rel="modulepreload" crossorigin href="./assets/button-C3CQSr4p.js">
-  <link rel="modulepreload" crossorigin href="./assets/copy-button-Bil2CjzT.js">
-  <link rel="modulepreload" crossorigin href="./assets/formatted-body-BuLfVMeD.js">
-  <link rel="modulepreload" crossorigin href="./assets/task-chip-BHM-e3I8.js">
-  <link rel="modulepreload" crossorigin href="./assets/badge-XEru6wto.js">
-  <link rel="modulepreload" crossorigin href="./assets/input-CXMbJ848.js">
+  <link rel="modulepreload" crossorigin href="./assets/store-D-Frk_EC.js">
+  <link rel="modulepreload" crossorigin href="./assets/agent-type-icon-BmBR-9CH.js">
+  <link rel="modulepreload" crossorigin href="./assets/button-DyHjsHY3.js">
+  <link rel="modulepreload" crossorigin href="./assets/copy-button-C67FUG3E.js">
+  <link rel="modulepreload" crossorigin href="./assets/formatted-body-Rv9RDPsQ.js">
+  <link rel="modulepreload" crossorigin href="./assets/task-chip-CeujtXYT.js">
+  <link rel="modulepreload" crossorigin href="./assets/badge-BCvp7LK3.js">
+  <link rel="modulepreload" crossorigin href="./assets/input-Rc4oWv4q.js">
   <link rel="modulepreload" crossorigin href="./assets/themes-DjSwmAZN.js">
-  <link rel="stylesheet" crossorigin href="./assets/index-C9X_0QBt.css">
+  <link rel="stylesheet" crossorigin href="./assets/index-DHzXsQot.css">
 </head>
 <body class="bg-background text-foreground antialiased">
   <div id="root"></div>

package/runner/plugins/claude/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "agent-relay-runner",
   "description": "Thin Agent Relay runner bridge for Claude Code",
-  "version": "0.125.0",
+  "version": "0.127.0",
   "agentRelayContracts": {
     "providerPluginProtocol": 1
   }

package/runner/plugins/claude/monitors/relay-monitor.provisioned.mjs

@@ -56,8 +56,8 @@ var RUNNER_PROMPT_TEMPLATE_DEFAULTS = [
     category: "runner",
     title: "Runner Workspace Lifecycle Note",
     description: "Lifecycle note injected by the runner for isolated workspaces.",
-    template: lines("[agent-relay] Isolated workspace: you are in a git worktree on branch {{branch}}, based on {{baseRef}} \u2014 NOT the main checkout. Other agents may work in parallel and land to {{baseRef}}, so {{baseRef}} will move under you. That is expected; don't fight it.", "Do NOT push this branch yourself \u2014 not with `git push`, not with `tl push` or any other push wrapper, and do not manually rebase or merge. A steward may be auto-rebasing this branch in the background; pushing concurrently races it and can leave the worktree mid-rebase. Just commit your work here. When the task is done, run `agent-relay workspace ready` \u2014 Relay rebases onto the latest {{baseRef}}, lands your work, and pushes for you. If the installed `agent-relay` binary is stale and says the workspace command is unknown, run the repo-local fallback: `bun src/index.ts workspace ready`.", "After `ready`, the status becomes `review_requested` \u2014 this is the NORMAL, healthy hand-off state, NOT an escalation or a stall. Relay auto-merges clean rebases roughly every 2 minutes; a steward agent is spawned (after a short delay) ONLY if it can't land deterministically, so seeing no steward means it's working, not stuck. Stop your turn after `ready` and go idle; do NOT wait or poll the steward queue. Relay wakes you with `landed-success` when your branch lands and refreshes, or `landed-failure` if landing fatally fails. On success you'll be on a fresh rebased branch whose name gains a `--N` suffix \u2014 expected, keep working there. Never `cd` into the main checkout, and never merge/push/resolve conflicts yourself \u2014 Relay and the steward own all of that. `agent-relay workspace status` anytime shows your current state and the exact next step."),
-    defaultTemplate: lines("[agent-relay] Isolated workspace: you are in a git worktree on branch {{branch}}, based on {{baseRef}} \u2014 NOT the main checkout. Other agents may work in parallel and land to {{baseRef}}, so {{baseRef}} will move under you. That is expected; don't fight it.", "Do NOT push this branch yourself \u2014 not with `git push`, not with `tl push` or any other push wrapper, and do not manually rebase or merge. A steward may be auto-rebasing this branch in the background; pushing concurrently races it and can leave the worktree mid-rebase. Just commit your work here. When the task is done, run `agent-relay workspace ready` \u2014 Relay rebases onto the latest {{baseRef}}, lands your work, and pushes for you. If the installed `agent-relay` binary is stale and says the workspace command is unknown, run the repo-local fallback: `bun src/index.ts workspace ready`.", "After `ready`, the status becomes `review_requested` \u2014 this is the NORMAL, healthy hand-off state, NOT an escalation or a stall. Relay auto-merges clean rebases roughly every 2 minutes; a steward agent is spawned (after a short delay) ONLY if it can't land deterministically, so seeing no steward means it's working, not stuck. Stop your turn after `ready` and go idle; do NOT wait or poll the steward queue. Relay wakes you with `landed-success` when your branch lands and refreshes, or `landed-failure` if landing fatally fails. On success you'll be on a fresh rebased branch whose name gains a `--N` suffix \u2014 expected, keep working there. Never `cd` into the main checkout, and never merge/push/resolve conflicts yourself \u2014 Relay and the steward own all of that. `agent-relay workspace status` anytime shows your current state and the exact next step."),
+    template: lines("[agent-relay] Isolated workspace: you are in a git worktree on branch {{branch}}, based on {{baseRef}} \u2014 NOT the main checkout. Other agents may work in parallel and land to {{baseRef}}, so {{baseRef}} will move under you. That is expected; don't fight it.", "Do NOT push this branch yourself \u2014 not with `git push`, not with `tl push` or any other push wrapper, and do not manually rebase or merge. A steward may be auto-rebasing this branch in the background; pushing concurrently races it and can leave the worktree mid-rebase. Just commit your work here. When the task is done, call `relay_task_deliver` with disposition `complete`, a summary, commits, and passing `typecheck` + `test` gates. Relay records the typed delivery on the Task, then rebases onto the latest {{baseRef}}, lands your work, and pushes for you.", "After `relay_task_deliver` accepts a complete delivery, the workspace status becomes `ready` \u2014 this is the NORMAL, healthy hand-off state, NOT an escalation or a stall. Relay auto-merges clean rebases roughly every 2 minutes; a steward agent is spawned (after a short delay) ONLY if it can't land deterministically, so seeing no steward means it's working, not stuck. Stop your turn after delivery and go idle; do NOT wait or poll the steward queue. Relay wakes you with `landed-success` when your branch lands and refreshes, or `landed-failure` if landing fatally fails. On success you'll be on a fresh rebased branch whose name gains a `--N` suffix \u2014 expected, keep working there. Never `cd` into the main checkout, and never merge/push/resolve conflicts yourself \u2014 Relay and the steward own all of that. `agent-relay workspace status` anytime shows your current state and the exact next step."),
+    defaultTemplate: lines("[agent-relay] Isolated workspace: you are in a git worktree on branch {{branch}}, based on {{baseRef}} \u2014 NOT the main checkout. Other agents may work in parallel and land to {{baseRef}}, so {{baseRef}} will move under you. That is expected; don't fight it.", "Do NOT push this branch yourself \u2014 not with `git push`, not with `tl push` or any other push wrapper, and do not manually rebase or merge. A steward may be auto-rebasing this branch in the background; pushing concurrently races it and can leave the worktree mid-rebase. Just commit your work here. When the task is done, call `relay_task_deliver` with disposition `complete`, a summary, commits, and passing `typecheck` + `test` gates. Relay records the typed delivery on the Task, then rebases onto the latest {{baseRef}}, lands your work, and pushes for you.", "After `relay_task_deliver` accepts a complete delivery, the workspace status becomes `ready` \u2014 this is the NORMAL, healthy hand-off state, NOT an escalation or a stall. Relay auto-merges clean rebases roughly every 2 minutes; a steward agent is spawned (after a short delay) ONLY if it can't land deterministically, so seeing no steward means it's working, not stuck. Stop your turn after delivery and go idle; do NOT wait or poll the steward queue. Relay wakes you with `landed-success` when your branch lands and refreshes, or `landed-failure` if landing fatally fails. On success you'll be on a fresh rebased branch whose name gains a `--N` suffix \u2014 expected, keep working there. Never `cd` into the main checkout, and never merge/push/resolve conflicts yourself \u2014 Relay and the steward own all of that. `agent-relay workspace status` anytime shows your current state and the exact next step."),
     variables: ["branch", "baseRef"]
   },
   {

package/runner/src/adapters/codex-agent-message-capture.ts

@@ -45,17 +45,16 @@ export class CodexAgentMessageCapture {
     this.currentSegment = [];
   }
 
-  // Deterministic turn-final response: the TRAILING agentMessage run only — all items after
-  // the LAST non-message item (tool call, file change, reasoning...) in the turn (design
-  // #1079 §3.2). Earlier agentMessage segments are mid-work narration, already mirrored live
-  // via `emit`, and must not be re-injected into the final (#1083 Finding 2). Codex's own
-  // phase:"commentary" tag (see completeItem above) still trims commentary items out of
-  // whichever segment they land in, but is not the sole guard against leading narration.
+  // Deterministic turn-final response: prefer the trailing structured report span, not a generic
+  // post-handoff coda. The original #1079/#1086 trailing-run rule correctly kept early narration
+  // out, but it over-trimmed Codex turns shaped "summary -> workspace ready -> Landed..." and made
+  // report-up deliver only the coda (#1136). We still drop leading narration; we just let structured
+  // report markers beat a terse final status line.
   finish(emit: EmitAgentMessage): string | undefined {
     this.closeSegment(emit);
-    const trailingSegment = this.segments.at(-1);
+    const trailingSegment = selectFinalResponseSegments(this.segments);
     this.segments = [];
-    const text = trailingSegment ? segmentBody(trailingSegment) : undefined;
+    const text = trailingSegment ? trailingSegment.map(segmentBody).join("\n\n").trim() : undefined;
     return truncateCapturedResponse(text);
   }
 
@@ -105,6 +104,37 @@ function segmentBody(segment: ResponseEntry[]): string {
   return segment.map((entry) => entry.body).join("\n\n").trim();
 }
 
+function selectFinalResponseSegments(segments: ResponseEntry[][]): ResponseEntry[][] | undefined {
+  const bodies = segments.map(segmentBody).filter(Boolean);
+  if (!bodies.length) return undefined;
+  let end = bodies.length - 1;
+  while (end > 0 && isGenericFinalCoda(bodies[end]!) && bodies.slice(0, end).some(isSubstantiveReportSegment)) end--;
+  const firstReport = bodies.slice(0, end + 1).findIndex(isReportBoundarySegment);
+  if (firstReport >= 0) return segments.slice(firstReport, end + 1);
+  for (let i = end; i >= 0; i--) {
+    if (isSubstantiveReportSegment(bodies[i]!)) return [segments[i]!];
+  }
+  return [segments[end]!];
+}
+
+const REPORT_BOUNDARY = /(^|\n)(#{1,6}\s|\*\*(summary|what changed|rca|fix|tests?|gates?|verification|risk)\b|(?:summary|what changed|rca|fix|tests?|gates?|verification|risk):)/i;
+const REPORT_STRUCTURE = /(^|\n)\s*[-*]\s+\S|`[^`]+`|\b(typecheck|bun test|tests? pass(?:ed)?|gates? green|rca|verified|implemented)\b/i;
+const GENERIC_FINAL_CODA = /^(?:done|landed(?: on main)?|committed|merged|ready|no further action|nothing further|all set)\b|(?:\bno further action needed\b|\bnothing further needed\b)$/i;
+
+function isReportBoundarySegment(body: string): boolean {
+  return REPORT_BOUNDARY.test(body.trim());
+}
+
+function isSubstantiveReportSegment(body: string): boolean {
+  const trimmed = body.trim();
+  return !isGenericFinalCoda(trimmed) && (trimmed.length >= 120 || isReportBoundarySegment(trimmed) || REPORT_STRUCTURE.test(trimmed));
+}
+
+function isGenericFinalCoda(body: string): boolean {
+  const trimmed = body.trim();
+  return trimmed.length <= 180 && GENERIC_FINAL_CODA.test(trimmed) && !isReportBoundarySegment(trimmed);
+}
+
 function truncateCapturedResponse(text: string | undefined): string | undefined {
   if (!text || text.length <= MAX_CAPTURED_RESPONSE_CHARS) return text;
   return `${text.slice(0, MAX_CAPTURED_RESPONSE_CHARS).trimEnd()}\n\n${TRUNCATION_MARKER_PREFIX} showing first ${MAX_CAPTURED_RESPONSE_CHARS} of ${text.length} chars]`;

package/runner/src/relay-mcp-proxy.ts

@@ -43,7 +43,7 @@ const SSE_KEEPALIVE_MS = 25_000;
 const DEFAULT_BUFFERABLE_TOOLS = new Set<string>([
   "relay_send_message",
   "relay_reply",
-  "relay_workspace_ready",
+  "relay_task_deliver",
 ]);
 
 // Tools surfaced ONLY to an agent that owns a live isolated worktree. For any other agent the
@@ -51,12 +51,10 @@ const DEFAULT_BUFFERABLE_TOOLS = new Set<string>([
 // would return them). This is the context the coarse token scope can't express (#214/#215).
 const WORKTREE_ONLY_TOOLS = new Set<string>([
   "relay_workspace_status",
-  "relay_workspace_ready",
   "relay_workspace_deps",
   "relay_workspace_list",
   "relay_workspace_claim",
   "relay_workspace_release",
-  "relay_workspace_land",
 ]);
 
 interface ProxyContext {

package/runner/src/runner-core.ts

@@ -51,7 +51,7 @@ import {
   runnerAgentStatus,
   runnerBusErrorAction,
   runnerMessageMatches,
-  runnerMessageShouldDirtyObligations,
+  runnerMessageShouldDirtyObligations, restartOptionsFromCommand,
   runnerShouldResolveProviderExit,
   runnerShouldRestartUnexpectedProviderExit,
   runtimeProviderCapabilities,
@@ -60,7 +60,7 @@ import {
   shouldLogDeliveryFailure,
   stripRunnerClaimedGuidance,
   taskIdFromMessage,
-  type ProbeModelInfo,
+  type ProbeModelInfo, type RestartProviderOptions,
 } from "./runner-helpers";
 
 // Pre-destroy work is best-effort and must never hang teardown. Capping it keeps a slow
@@ -69,6 +69,7 @@ import {
 // short so a wedged/down server can't stall an operator-requested shutdown for long; a
 // row that still can't land is logged, not silently dropped.
 const OUTBOX_FLUSH_TIMEOUT_MS = 3_000;
+const STALE_PROVIDER_TURN_BUSY_MS = 10 * 60_000;
 
 interface RunnerOptions {
   provider: string;
@@ -535,7 +536,7 @@ export class AgentRunner {
     return mode === "isolated";
   }
 
-  private async spawnProvider(opts: { resumeId?: string; suppressPrompt?: boolean } = {}): Promise<ManagedProcess> {
+  private async spawnProvider(opts: RestartProviderOptions = {}): Promise<ManagedProcess> {
     this.providerSessionId = crypto.randomUUID();
     this.lastTranscriptPath = undefined;
     const includeProviderGlobals = profileUsesProviderHostGlobals(this.options);
@@ -586,7 +587,7 @@ export class AgentRunner {
       ...(this.options.profile ? { profile: this.options.profile } : {}),
       ...(this.options.agentProfile ? { agentProfile: this.options.agentProfile } : {}),
       ...(this.options.prompt && !opts.resumeId && !opts.suppressPrompt ? { prompt: this.options.prompt } : {}),
-      ...(this.options.systemPromptAppend ? { systemPromptAppend: this.options.systemPromptAppend } : {}),
+      ...((opts.systemPromptAppend ?? this.options.systemPromptAppend) ? { systemPromptAppend: opts.systemPromptAppend ?? this.options.systemPromptAppend } : {}),
       ...(this.options.tmuxSession ? { tmuxSession: this.options.tmuxSession } : {}),
       providerArgs: opts.resumeId ? [...this.options.providerArgs, "--resume", opts.resumeId] : this.options.providerArgs,
       providerConfig: this.options.providerConfig,
@@ -604,7 +605,7 @@ export class AgentRunner {
     };
     const launchSeededPrompt = this.options.adapter.seedsInitialPromptAtLaunch && !opts.resumeId && !opts.suppressPrompt ? this.options.prompt?.trim() : ""; if (launchSeededPrompt) this.recordInjectedPrompt(launchSeededPrompt);
     const managedProcess = await this.options.adapter.spawn(config);
-    const injectionEvents = runnerLaunchInjectionSessionEvents({ carried: this.options.relayInjectionEvents, provider: this.options.provider, config, providerConfig: this.options.providerConfig, agentId: this.agentId, providerSessionId: this.providerSessionId });
+    const injectionEvents = runnerLaunchInjectionSessionEvents({ carried: opts.relayInjectionEvents ?? this.options.relayInjectionEvents, provider: this.options.provider, config, providerConfig: this.options.providerConfig, agentId: this.agentId, providerSessionId: this.providerSessionId });
     for (const event of injectionEvents) {
       this.publishSessionEvent(event);
     }
@@ -777,7 +778,7 @@ export class AgentRunner {
       else this.lifecycleAction = undefined;
       this.publishStatus();
       let providerResult: Record<string, unknown> | void = undefined;
-      if (type === "agent.restart") await this.restartProvider();
+      if (type === "agent.restart") await this.restartProvider(restartOptionsFromCommand(params));
       else if (type === "agent.reconnect") this.publishStatus();
       else if (type === "agent.compact") {
         if (!this.options.adapter.compact || !this.process) throw new Error("provider does not support compact");
@@ -927,7 +928,7 @@ export class AgentRunner {
     return attachmentText ? `${body}\n\n${attachmentText}` : body;
   }
 
-  private async restartProvider(opts: { resumeId?: string; suppressPrompt?: boolean } = {}): Promise<void> {
+  private async restartProvider(opts: RestartProviderOptions = {}): Promise<void> {
     this.restartInProgress = true;
     try {
       if (this.process) {
@@ -1204,7 +1205,7 @@ export class AgentRunner {
     const providerSessionId = typeof update === "string" ? undefined : update.providerSessionId;
     if (providerSessionId && providerSessionId !== this.providerSessionId) return;
     const reason = typeof update === "string" ? "provider-turn" : update.reason ?? "provider-turn";
-    const id = typeof update === "string" ? reason : update.id ?? reason;
+    let id = typeof update === "string" ? reason : update.id ?? reason;
     if (typeof update !== "string" && update.timeline) {
       this.pendingTimelineEvent = {
         status: update.timeline.status,
@@ -1300,8 +1301,10 @@ export class AgentRunner {
         this.compactionMidTurn = false;
         this.sessionLog(`turn started (turn ${this.currentTurnId})`);
       }
+      id = this.currentTurnId;
       this.busyReconciler.arm();
     } else if (status === "idle" && reason === "provider-turn") {
+      id = typeof update !== "string" && update.id ? update.id : this.currentTurnId ?? reason;
       if (this.currentTurnId) { this.completedProviderTurns += 1; this.sessionLog(`turn ended via provider idle (turn ${this.currentTurnId})`); }
       this.currentTurnId = undefined;
       this.currentTurnStartedAt = undefined;
@@ -1346,7 +1349,8 @@ export class AgentRunner {
       }
     } else if (status === "idle") {
       this.claims.clearTerminalStatus();
-      this.claims.finishWork(reason, id);
+      if (reason === "provider-turn") this.claims.clearWorkKind("provider-turn");
+      else this.claims.finishWork(reason, id);
       if (reason === "provider-turn") void this.completeObservedTaskClaims();
     }
     else if (status === "offline" || status === "error") this.claims.setTerminalStatus(status);
@@ -2007,15 +2011,25 @@ export class AgentRunner {
     });
   }
 
+  private isStaleProviderTurnOnlyBusy(
+    status: SemanticStatus,
+    activeWork: Array<{ kind: string }>,
+    busyReasons: string[],
+    liveness: { hasLiveWork: boolean; lastProgressAt: number },
+  ): boolean {
+    if (status !== "busy") return false;
+    if (activeWork.length === 0 || activeWork.some((work) => work.kind !== "provider-turn")) return false;
+    if (busyReasons.some((reason) => reason !== "provider-turn")) return false;
+    if (liveness.hasLiveWork || !liveness.lastProgressAt) return false;
+    return Date.now() - liveness.lastProgressAt >= STALE_PROVIDER_TURN_BUSY_MS;
+  }
+
   private publishStatus(): void {
     this.claims.expire();
     const status = this.claims.currentStatus();
-    const agentStatus = runnerAgentStatus(status);
     const activeWork = this.claims.activeWork();
     const activeSubagents = activeWork.filter((item) => item.kind === "subagent");
     const terminalFailure = this.terminalFailure;
-    const providerState = terminalFailure?.providerState ?? this.rateLimitHold ?? providerStateFromActiveWork(activeWork);
-    this.bus.setSemanticStatus(status === "offline" || status === "error" ? "idle" : status);
     const timelineEvent = this.pendingTimelineEvent;
     this.pendingTimelineEvent = undefined;
     // §4.1 Runner↔provider liveness contract (#725 / #746): fold the raw transport/timeline/
@@ -2031,6 +2045,12 @@ export class AgentRunner {
     const liveness = this.options.adapter.liveness
       ? this.options.adapter.liveness(livenessInputs)
       : computeLivenessSignal(livenessInputs);
+    const busyReasons = this.claims.reasons();
+    const staleProviderTurnBusy = this.isStaleProviderTurnOnlyBusy(status, activeWork, busyReasons, liveness);
+    const effectiveStatus = staleProviderTurnBusy ? "idle" : status;
+    const agentStatus = runnerAgentStatus(effectiveStatus);
+    const providerState = terminalFailure?.providerState ?? this.rateLimitHold ?? (staleProviderTurnBusy ? null : providerStateFromActiveWork(activeWork));
+    this.bus.setSemanticStatus(effectiveStatus === "offline" || effectiveStatus === "error" ? "idle" : effectiveStatus);
     this.bus.status({
       agentStatus,
       ready: agentStatus !== "offline" && !this.stopped,
@@ -2062,7 +2082,7 @@ export class AgentRunner {
             ? { lastError: `Claude provider exited; resume id ${this.terminalProviderExit.claudeResumeId} captured for manual recovery` }
             : { lastError: "Claude provider exited; manual intervention required" }),
         } : {}),
-        busyReasons: this.claims.reasons(),
+        busyReasons: staleProviderTurnBusy ? busyReasons.filter((reason) => reason !== "provider-turn") : busyReasons,
         completedProviderTurns: this.completedProviderTurns,
         activeWork,
         activeSubagents,

package/runner/src/runner-helpers.ts

@@ -5,6 +5,7 @@ import { getManifest } from "agent-relay-providers";
 import type { BooleanCapabilityDefault, ProviderCapabilityCondition } from "agent-relay-providers";
 import { targetMatchesAgentIdentity } from "agent-relay-sdk/agent-target";
 import type { ProviderAdapter, ProviderConfig, RunnerSpawnConfig, SemanticStatus } from "./adapter";
+import type { RunnerRelayInjectionEvent } from "./relay-injection-events";
 import { agentProfileProjectionReport } from "./profile-projection";
 import { assembleLaunch } from "./launch-assembly";
 
@@ -27,6 +28,13 @@ export interface ProbeModelInfo {
   effort?: string;
 }
 
+export interface RestartProviderOptions {
+  resumeId?: string;
+  suppressPrompt?: boolean;
+  systemPromptAppend?: string;
+  relayInjectionEvents?: RunnerRelayInjectionEvent[];
+}
+
 export function runnerMessageMatches(message: Pick<Message, "to" | "resolvedToAgent">, target: {
   agentId: string;
   label?: string;
@@ -62,6 +70,29 @@ export function stripRunnerClaimedGuidance(body: string): string {
   return body.replace(RUNNER_CLAIMED_GUIDANCE_RE, "");
 }
 
+const RELAY_INJECTION_CATEGORIES = new Set(["memory", "instructions", "tools", "comms", "knowledge", "context"]);
+
+function relayInjectionEventsFromParam(value: unknown): RunnerRelayInjectionEvent[] | undefined {
+  if (!Array.isArray(value)) return undefined;
+  const events = value.flatMap((item): RunnerRelayInjectionEvent[] => {
+    if (!item || typeof item !== "object" || Array.isArray(item)) return [];
+    const record = item as Record<string, unknown>;
+    const detail = record.detail;
+    if (typeof record.category !== "string" || !RELAY_INJECTION_CATEGORIES.has(record.category)) return [];
+    if (typeof record.summary !== "string" || !record.summary.trim()) return [];
+    if (!detail || typeof detail !== "object" || Array.isArray(detail)) return [];
+    return [{ category: record.category as RunnerRelayInjectionEvent["category"], summary: record.summary, detail: detail as Record<string, unknown> }];
+  });
+  return events.length ? events : undefined;
+}
+
+export function restartOptionsFromCommand(params: Record<string, unknown>): RestartProviderOptions {
+  return {
+    systemPromptAppend: typeof params.systemPromptAppend === "string" ? params.systemPromptAppend : undefined,
+    relayInjectionEvents: relayInjectionEventsFromParam(params.relayInjectionEvents),
+  };
+}
+
 // Bound a runner's INITIAL relay registration. `connect` resolves on the first `registered`
 // frame and otherwise loops forever, so a token the relay rejects (401 at the WS upgrade)
 // hangs here silently. Race it against `timeoutMs`; on timeout, surface a fatal reason, tear

package/src/db/index.ts

@@ -10,6 +10,7 @@ export * from "./agents.ts";
 export * from "./agent-search.ts";
 export * from "./tasks.ts";
 export * from "./task-entity.ts";
+export * from "./task-deliverables.ts";
 export * from "./task-memory.ts";
 export * from "./task-comment-through.ts";
 export * from "./integrations.ts";

package/src/db/messages.ts

@@ -479,7 +479,7 @@ export function flushWorkFinalReports(childId: string, source: MessageWorkFinali
   const recencyCutoff = markedAt - LINEAGE_FINAL_GROUP_RECENCY_MS;
   const forwarded: Array<{ message: Message; created: boolean }> = [];
   const finalizedOriginals: Message[] = [];
-  let groupOrder = 0;
+  const held: Array<{ original: Message; session: Record<string, unknown> }> = [];
   for (const messageId of queue) {
     const original = getMessage(messageId);
     if (!original) continue;
@@ -488,17 +488,53 @@ export function flushWorkFinalReports(childId: string, source: MessageWorkFinali
     if ((original.occurredAt ?? original.createdAt) < recencyCutoff) continue;
     const session = sessionMeta(original);
     if (!session) continue;
+    held.push({ original, session });
+  }
+  const selected = source === "edge-fallback" ? selectEdgeFallbackLineageReports(held) : held;
+  let groupOrder = 0;
+  for (const { original, session } of selected) {
     const finality: MessageWorkFinality = { windowId, source, groupOrder, markedAt };
     const result = forwardLineageStreamCapture(original, session, "responses", child, parent, finality);
     if (!result) continue;
     groupOrder++;
     forwarded.push(result);
-    const finalizedOriginal = setMessageWorkFinality(messageId, finality);
+    const finalizedOriginal = setMessageWorkFinality(original.id, finality);
     if (finalizedOriginal) finalizedOriginals.push(finalizedOriginal);
   }
   return { forwarded, finalizedOriginals };
 }
 
+function selectEdgeFallbackLineageReports<T extends { original: Message }>(held: T[]): T[] {
+  if (held.length <= 1) return held;
+  let bestIndex = -1;
+  let bestScore = -Infinity;
+  for (let i = 0; i < held.length; i++) {
+    const score = edgeFallbackReportScore(held[i]!.original.body);
+    if (score > bestScore || (score === bestScore && i > bestIndex)) {
+      bestScore = score;
+      bestIndex = i;
+    }
+  }
+  return bestScore > 0 && bestIndex >= 0 ? [held[bestIndex]!] : [held.at(-1)!];
+}
+
+const EDGE_FALLBACK_REPORT_BOUNDARY = /(^|\n)(#{1,6}\s|\*\*(summary|what changed|rca|fix|tests?|gates?|verification|risk)\b|(?:summary|what changed|rca|fix|tests?|gates?|verification|risk):)/i;
+const EDGE_FALLBACK_REPORT_STRUCTURE = /(^|\n)\s*[-*]\s+\S|`[^`]+`|\b(typecheck|bun test|tests? pass(?:ed)?|gates? green|rca|verified|implemented)\b/i;
+const EDGE_FALLBACK_GENERIC_CODA = /^(?:done|landed(?: on main)?|committed|merged|ready|no further action|nothing further|all set)\b|(?:\bno further action needed\b|\bnothing further needed\b)$/i;
+const EDGE_FALLBACK_NARRATION = /^(?:i(?:'|’)ll|i(?:'|’)m|let me|checking|running|reading|found\b|now\b)/i;
+
+function edgeFallbackReportScore(body: string): number {
+  const trimmed = body.trim();
+  if (!trimmed) return -10;
+  if (trimmed.length <= 180 && EDGE_FALLBACK_GENERIC_CODA.test(trimmed) && !EDGE_FALLBACK_REPORT_BOUNDARY.test(trimmed)) return -5;
+  let score = 0;
+  if (trimmed.length >= 120) score += 2;
+  if (EDGE_FALLBACK_REPORT_BOUNDARY.test(trimmed)) score += 6;
+  if (EDGE_FALLBACK_REPORT_STRUCTURE.test(trimmed)) score += 3;
+  if (EDGE_FALLBACK_NARRATION.test(trimmed)) score -= 3;
+  return score;
+}
+
 /**
  * #1040/#1041 — the persisted turn-final response captures needed to rebuild the in-memory held
  * group after a relay restart. Bounded by a recency window (a report is only ever held while its