agent-relay-runner 0.86.0 → 0.88.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-relay-runner",
-  "version": "0.86.0",
+  "version": "0.88.0",
   "description": "Unified provider lifecycle runner for Agent Relay",
   "type": "module",
   "bin": {

package/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.86.0",
+  "version": "0.88.0",
   "agentRelayContracts": {
     "providerPluginProtocol": 1
   }

package/src/runner-core.ts

@@ -28,6 +28,7 @@ import { publishCapturedResponse } from "./response-capture-report";
 import { runnerLaunchInjectionSessionEvents, type RunnerRelayInjectionEvent } from "./relay-injection-events";
 import { providerTerminalSession, providerTerminalSocket } from "./process-meta";
 import { capsFromEnv, logLevelFromEnv, mcpProxyEnabledFromEnv, orchestratorBaseDirFromEnv, orchestratorUrlFromEnv, registrationTimeoutMsFromEnv, runnerInfoFileFromEnv, runnerLogFileFromEnv, runnerOutboxDirWithInfoFallback, sessionDebugEnabled, tagsFromEnv, workspaceModeFromEnv } from "./config";
+import { boundaryReasonForCommand, PRE_DESTROY_TIMEOUT_MS, reasonExitsRunner, type LifecycleAction, type SessionDestroyReason } from "./session-destroy";
 import {
   appliedAgentProfileMetadata,
   commandTimeoutMs,
@@ -55,48 +56,13 @@ import {
   type ProbeModelInfo,
 } from "./runner-helpers";
 
-// A destructive session transition. The runner runs end-of-session work (Insights
-// capture, #183/#184) before the invasive operation and, during that window, presents a
-// distinct non-addressable lifecycle state. Bus commands and provider hooks (Claude
-// PreCompact / SessionEnd) both normalize to one of these.
-type SessionDestroyReason = "compact" | "clear" | "restart" | "shutdown" | "kill" | "crash";
-
-// Reasons after which the runner process won't survive to drain the durable outbox (and the
-// per-agent outbox is never reopened once the agent is gone). For these, pre-destroy must
-// block on delivery of the just-captured Insights datapoint, not just enqueue it (#183).
-// `restart` (bus command) deliberately excluded: the runner stays alive and drains normally.
-function reasonExitsRunner(reason: SessionDestroyReason): boolean {
-  return reason === "shutdown" || reason === "kill" || reason === "crash";
-}
-
-// `finalizing-<reason>` is the transient pre-destroy window; the others are the executing
-// teardown states the dashboard already renders.
-type LifecycleAction =
-  | "shutting-down" | "killing" | "restarting"
-  | `finalizing-${SessionDestroyReason}`;
-
 // Pre-destroy work is best-effort and must never hang teardown. Capping it keeps a slow
 // transcript read or a wedged provider from stalling a shutdown the operator asked for.
-const PRE_DESTROY_TIMEOUT_MS = 4_000;
-
 // Bounded window to deliver the durable outbox before an exit-bound teardown (#183). Kept
 // 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;
 
-// Map a lifecycle bus command to its destructive boundary reason, or undefined for
-// non-destructive commands (interrupt, inject, reconnect, permission decisions).
-function boundaryReasonForCommand(type: string): SessionDestroyReason | undefined {
-  switch (type) {
-    case "agent.compact": return "compact";
-    case "agent.clearContext": return "clear";
-    case "agent.restart": return "restart";
-    case "agent.shutdown": return "shutdown";
-    case "agent.kill": return "kill";
-    default: return undefined;
-  }
-}
-
 interface RunnerOptions {
   provider: string;
   model?: string;
@@ -258,6 +224,7 @@ export class AgentRunner {
   private readonly pendingMessages = new Map<number, Message>();
   private readonly activeTaskClaims = new Map<number, ActiveTaskClaim>();
   private pendingTimelineEvent?: RunnerTimelineEvent;
+  private lastProviderEventAt?: number;
   private pendingPromptMessageId?: number;
   // #329: a spawn-time initial prompt whose first delivery timed out before the TUI was
   // ready. Held (not dropped) for a ready-signal-driven re-attempt; cleared on success.
@@ -1167,6 +1134,7 @@ export class AgentRunner {
 
   private setProviderStatus(update: ProviderStatusUpdate): void {
     const status = typeof update === "string" ? update : update.status;
+    this.lastProviderEventAt = Date.now();
     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";
@@ -1856,6 +1824,7 @@ export class AgentRunner {
         activeWork,
         activeSubagents,
         activeSubagentCount: activeSubagents.length,
+        ...(this.lastProviderEventAt !== undefined ? { lastProviderEventAt: this.lastProviderEventAt } : {}),
         providerState,
         auth: {
           profileId: this.currentTokenProfileId ?? null,

package/src/runner-insights.ts

@@ -1,12 +1,11 @@
 import type { WorkspaceMetadata } from "agent-relay-sdk";
 import type { ManagedProcess, ProviderAdapter } from "./adapter";
 import type { Outbox } from "./outbox";
+import type { SessionDestroyReason } from "./session-destroy";
 import { resolveProjectName } from "./config";
 import { computeContextRatio } from "./session-insights";
 import { boundContinuationArchiveSegment } from "./continuation-archive";
 
-type SessionDestroyReason = "compact" | "clear" | "restart" | "shutdown" | "kill" | "crash";
-
 interface RunnerInsightsDeps {
   agentId: string;
   cwd: string;

package/src/session-destroy.ts

@@ -0,0 +1,22 @@
+export type SessionDestroyReason = "compact" | "clear" | "restart" | "shutdown" | "kill" | "crash";
+
+export type LifecycleAction =
+  | "shutting-down" | "killing" | "restarting"
+  | `finalizing-${SessionDestroyReason}`;
+
+export const PRE_DESTROY_TIMEOUT_MS = 4_000;
+
+export function reasonExitsRunner(reason: SessionDestroyReason): boolean {
+  return reason === "shutdown" || reason === "kill" || reason === "crash";
+}
+
+export function boundaryReasonForCommand(type: string): SessionDestroyReason | undefined {
+  switch (type) {
+    case "agent.compact": return "compact";
+    case "agent.clearContext": return "clear";
+    case "agent.restart": return "restart";
+    case "agent.shutdown": return "shutdown";
+    case "agent.kill": return "kill";
+    default: return undefined;
+  }
+}