agent-relay-runner 0.127.4 → 0.127.6

package/src/runner-helpers.ts

@@ -12,6 +12,7 @@ import { assembleLaunch } from "./launch-assembly";
 const MAX_TIMER_DELAY_MS = 2_147_483_647;
 const LOG_TAIL_BYTES = 128 * 1024;
 const RUNNER_CLAIMED_GUIDANCE_RE = /\s*Claim this task before working it, then update task status when finished\.\s*$/;
+const PROVIDER_DISPLAY_NAMES: Record<string, string> = { claude: "Claude", codex: "Codex" };
 
 interface RuntimeProviderOptions {
   provider: string;
@@ -234,6 +235,40 @@ export function providerExitDiagnostics(input: {
   };
 }
 
+export function providerExitResumeId(diagnostics: Record<string, unknown>): string | undefined {
+  const value = diagnostics.claudeResumeId;
+  return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+
+export function providerManualRecoveryReason(diagnostics: Record<string, unknown>): string {
+  return providerExitResumeId(diagnostics)
+    ? "claude-exit-manual-resume-available"
+    : "claude-exit-manual-intervention-required";
+}
+
+export function providerDisplayName(provider: string): string {
+  return PROVIDER_DISPLAY_NAMES[provider] ?? provider;
+}
+
+export function providerMonitorUnavailableMessage(provider: string): string {
+  return `no ${providerDisplayName(provider)} monitor connected`;
+}
+
+export function providerManualRecoveryMessage(provider: string, diagnostics: Record<string, unknown>): string {
+  const displayName = providerDisplayName(provider);
+  return providerExitResumeId(diagnostics)
+    ? `${displayName} exited; runner will not auto-resume. Resume id captured for manual recovery.`
+    : `${displayName} exited; runner will not restart automatically.`;
+}
+
+export function providerExitLastError(provider: string, marker: Record<string, unknown>): string {
+  const resumeId = providerExitResumeId(marker);
+  const displayName = providerDisplayName(provider);
+  return resumeId
+    ? `${displayName} provider exited; resume id ${resumeId} captured for manual recovery`
+    : `${displayName} provider exited; manual intervention required`;
+}
+
 export function commandTimeoutMs(params: Record<string, unknown>, fallback = 10_000): number {
   const raw = params.timeoutMs;
   if (typeof raw !== "number" || !Number.isSafeInteger(raw) || raw <= 0) return fallback;
@@ -242,7 +277,7 @@ export function commandTimeoutMs(params: Record<string, unknown>, fallback = 10_
 
 export function shouldLogDeliveryFailure(error: unknown): boolean {
   const message = errMessage(error);
-  return message !== "no Claude monitor connected";
+  return message !== providerMonitorUnavailableMessage("claude");
 }
 
 export function runtimeTokenRenewDelayMs(expiresAtSeconds: number, nowMs = Date.now()): number | undefined {