@evident-ai/cli 3.1.1-dev.0d8ac46 → 3.1.1-dev.10bc663

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.js CHANGED
@@ -532,6 +532,353 @@ async function whoami() {
532
532
  blank();
533
533
  }
534
534
 
535
+ // src/lib/auth.ts
536
+ async function getAuthCredentials() {
537
+ const runnerKey = process.env.EVIDENT_RUNNER_KEY;
538
+ const agentKey = process.env.EVIDENT_AGENT_KEY;
539
+ if (runnerKey) {
540
+ return {
541
+ token: runnerKey,
542
+ authType: "agent_key",
543
+ keySource: "runner_key",
544
+ notice: agentKey ? "Both EVIDENT_RUNNER_KEY and EVIDENT_AGENT_KEY are set; using EVIDENT_RUNNER_KEY." : void 0
545
+ };
546
+ }
547
+ if (agentKey) {
548
+ return { token: agentKey, authType: "agent_key", keySource: "agent_key" };
549
+ }
550
+ const userToken = process.env.EVIDENT_TOKEN;
551
+ if (userToken) {
552
+ return { token: userToken, authType: "bearer" };
553
+ }
554
+ const keychainCreds = await getToken();
555
+ if (keychainCreds) {
556
+ return {
557
+ token: keychainCreds.token,
558
+ authType: "bearer",
559
+ user: keychainCreds.user
560
+ };
561
+ }
562
+ return null;
563
+ }
564
+ function getAuthHeader(credentials2) {
565
+ if (credentials2.authType === "agent_key") {
566
+ return `SandboxKey ${credentials2.token}`;
567
+ }
568
+ return `Bearer ${credentials2.token}`;
569
+ }
570
+ function isInteractive(jsonOutput) {
571
+ if (jsonOutput) return false;
572
+ if (process.env.CI) return false;
573
+ if (process.env.GITHUB_ACTIONS) return false;
574
+ if (!process.stdin.isTTY) return false;
575
+ return true;
576
+ }
577
+
578
+ // src/commands/agent-lookup.ts
579
+ async function readErrorMessage(response) {
580
+ const text = await response.text().catch(() => "");
581
+ if (!text) return response.statusText || void 0;
582
+ try {
583
+ const data = JSON.parse(text);
584
+ const message = data.message ?? data.error;
585
+ if (typeof message === "string" && message.trim()) {
586
+ return message;
587
+ }
588
+ } catch {
589
+ }
590
+ return text.trim() || response.statusText || void 0;
591
+ }
592
+ function authFailureHint(apiUrl, serverMessage) {
593
+ const reason = serverMessage ? `: ${serverMessage}` : "";
594
+ return `Authentication failed${reason}. Your credentials were rejected by ${apiUrl}. This usually means you logged in against a different environment, or your session expired \u2014 log in again pointing at this endpoint and retry.`;
595
+ }
596
+ async function resolveAgentIdFromKey(authHeader) {
597
+ const apiUrl = getApiUrlConfig();
598
+ try {
599
+ const response = await fetch(`${apiUrl}/me`, {
600
+ headers: { Authorization: authHeader }
601
+ });
602
+ if (response.status === 401) {
603
+ const serverMessage = await readErrorMessage(response);
604
+ return { error: authFailureHint(apiUrl, serverMessage), authFailed: true };
605
+ }
606
+ if (!response.ok) {
607
+ const serverMessage = await readErrorMessage(response);
608
+ return {
609
+ error: `Failed to resolve runner from key (HTTP ${response.status})${serverMessage ? `: ${serverMessage}` : ""}`
610
+ };
611
+ }
612
+ const data = await response.json();
613
+ if (data.auth_type === "agent_key" && data.agent_id) {
614
+ return { agent_id: data.agent_id };
615
+ }
616
+ return {
617
+ error: "Cannot resolve runner ID: auth type is not agent_key. Please provide --runner explicitly."
618
+ };
619
+ } catch (error2) {
620
+ const message = error2 instanceof Error ? error2.message : "Unknown error";
621
+ return { error: `Failed to resolve runner from key: ${message}` };
622
+ }
623
+ }
624
+ var BEST_EFFORT_NOTIFY_TIMEOUT_MS = 2e3;
625
+ async function notifyAgentDisconnected(agentId, authHeader) {
626
+ const apiUrl = getApiUrlConfig();
627
+ try {
628
+ const response = await fetch(`${apiUrl}/runners/${agentId}/disconnect`, {
629
+ method: "POST",
630
+ headers: { Authorization: authHeader },
631
+ signal: AbortSignal.timeout(BEST_EFFORT_NOTIFY_TIMEOUT_MS)
632
+ });
633
+ if (!response.ok) {
634
+ const serverMessage = await readErrorMessage(response);
635
+ return {
636
+ ok: false,
637
+ error: `HTTP ${response.status}${serverMessage ? `: ${serverMessage}` : ""}`
638
+ };
639
+ }
640
+ return { ok: true };
641
+ } catch (error2) {
642
+ return { ok: false, error: describeBestEffortError(error2) };
643
+ }
644
+ }
645
+ function describeBestEffortError(error2) {
646
+ const name = error2?.name;
647
+ if (name === "TimeoutError" || name === "AbortError") {
648
+ return `timed out after ${BEST_EFFORT_NOTIFY_TIMEOUT_MS}ms`;
649
+ }
650
+ return error2 instanceof Error ? error2.message : String(error2);
651
+ }
652
+ async function reportMicrovmId(agentId, authHeader, microvmId) {
653
+ try {
654
+ const apiUrl = getApiUrlConfig();
655
+ const response = await fetch(`${apiUrl}/runners/${agentId}/microvm`, {
656
+ method: "POST",
657
+ headers: { Authorization: authHeader, "Content-Type": "application/json" },
658
+ body: JSON.stringify({ microvm_id: microvmId }),
659
+ signal: AbortSignal.timeout(BEST_EFFORT_NOTIFY_TIMEOUT_MS)
660
+ });
661
+ if (!response.ok) {
662
+ const serverMessage = await readErrorMessage(response);
663
+ return {
664
+ ok: false,
665
+ error: `HTTP ${response.status}${serverMessage ? `: ${serverMessage}` : ""}`
666
+ };
667
+ }
668
+ return { ok: true };
669
+ } catch (error2) {
670
+ return { ok: false, error: describeBestEffortError(error2) };
671
+ }
672
+ }
673
+ function toReportedWindow(window) {
674
+ if (!window) return null;
675
+ return { utilization: window.utilization, resets_at: window.resetsAt };
676
+ }
677
+ async function reportClaudeUsage(agentId, authHeader, snapshot) {
678
+ try {
679
+ const apiUrl = getApiUrlConfig();
680
+ const response = await fetch(`${apiUrl}/runners/${agentId}/claude-usage`, {
681
+ method: "POST",
682
+ headers: { Authorization: authHeader, "Content-Type": "application/json" },
683
+ body: JSON.stringify({
684
+ five_hour: toReportedWindow(snapshot.fiveHour),
685
+ seven_day: toReportedWindow(snapshot.sevenDay)
686
+ }),
687
+ signal: AbortSignal.timeout(BEST_EFFORT_NOTIFY_TIMEOUT_MS)
688
+ });
689
+ if (!response.ok) {
690
+ const serverMessage = await readErrorMessage(response);
691
+ return {
692
+ ok: false,
693
+ error: `HTTP ${response.status}${serverMessage ? `: ${serverMessage}` : ""}`
694
+ };
695
+ }
696
+ return { ok: true };
697
+ } catch (error2) {
698
+ return { ok: false, error: describeBestEffortError(error2) };
699
+ }
700
+ }
701
+ async function getAgentInfo(agentId, authHeader) {
702
+ const apiUrl = getApiUrlConfig();
703
+ try {
704
+ const response = await fetch(`${apiUrl}/runners/${agentId}`, {
705
+ headers: { Authorization: authHeader }
706
+ });
707
+ if (response.status === 401) {
708
+ const serverMessage = await readErrorMessage(response);
709
+ return { valid: false, error: authFailureHint(apiUrl, serverMessage), authFailed: true };
710
+ }
711
+ if (response.status === 403) {
712
+ const serverMessage = await readErrorMessage(response);
713
+ return {
714
+ valid: false,
715
+ error: serverMessage ?? "You do not have access to this runner (it may belong to a different team or organization)."
716
+ };
717
+ }
718
+ if (response.status === 404) {
719
+ const serverMessage = await readErrorMessage(response);
720
+ return { valid: false, error: serverMessage ?? `Runner ${agentId} not found` };
721
+ }
722
+ if (!response.ok) {
723
+ const serverMessage = await readErrorMessage(response);
724
+ return {
725
+ valid: false,
726
+ error: `API error (HTTP ${response.status})${serverMessage ? `: ${serverMessage}` : ""}`
727
+ };
728
+ }
729
+ const agent = await response.json();
730
+ if (agent.agent_type !== "local") {
731
+ return {
732
+ valid: false,
733
+ error: `Runner is type '${agent.agent_type}', must be 'local' for CLI connection`
734
+ };
735
+ }
736
+ return { valid: true, agent };
737
+ } catch (error2) {
738
+ const message = error2 instanceof Error ? error2.message : "Unknown error";
739
+ return { valid: false, error: `Failed to validate runner: ${message}` };
740
+ }
741
+ }
742
+
743
+ // src/commands/status.ts
744
+ var STATUS_TIMEOUT_MS = 1e4;
745
+ function authLabelFor(credentials2) {
746
+ if (credentials2.authType === "agent_key") {
747
+ return credentials2.keySource === "agent_key" ? "runner key (EVIDENT_AGENT_KEY)" : "runner key (EVIDENT_RUNNER_KEY)";
748
+ }
749
+ return "user token";
750
+ }
751
+ function describeFetchError(error2) {
752
+ const name = error2?.name;
753
+ if (name === "TimeoutError" || name === "AbortError") {
754
+ return `timed out after ${STATUS_TIMEOUT_MS}ms waiting for a response`;
755
+ }
756
+ return error2 instanceof Error ? error2.message : String(error2);
757
+ }
758
+ async function checkStatus(jsonMode) {
759
+ const apiUrl = getApiUrlConfig();
760
+ const credentials2 = await getAuthCredentials();
761
+ if (!credentials2) {
762
+ return {
763
+ ok: false,
764
+ endpoint: apiUrl,
765
+ reason: "no_credentials",
766
+ error: "No credentials configured. Set EVIDENT_RUNNER_KEY (or EVIDENT_AGENT_KEY), or EVIDENT_TOKEN, or run `evident login`.",
767
+ exitCode: 1
768
+ };
769
+ }
770
+ if (credentials2.notice && !jsonMode) {
771
+ printWarning(credentials2.notice);
772
+ }
773
+ let response;
774
+ try {
775
+ response = await fetch(`${apiUrl}/me`, {
776
+ headers: { Authorization: getAuthHeader(credentials2) },
777
+ signal: AbortSignal.timeout(STATUS_TIMEOUT_MS)
778
+ });
779
+ } catch (error2) {
780
+ return {
781
+ ok: false,
782
+ endpoint: apiUrl,
783
+ authLabel: authLabelFor(credentials2),
784
+ reason: "unreachable",
785
+ error: `Could not reach ${apiUrl}: ${describeFetchError(error2)}. The credentials were NOT validated.`,
786
+ exitCode: 75
787
+ };
788
+ }
789
+ if (response.status === 401) {
790
+ const serverMessage = await readErrorMessage(response);
791
+ return {
792
+ ok: false,
793
+ endpoint: apiUrl,
794
+ authLabel: authLabelFor(credentials2),
795
+ reason: "unauthorized",
796
+ error: authFailureHint(apiUrl, serverMessage),
797
+ exitCode: 1
798
+ };
799
+ }
800
+ if (response.status === 404) {
801
+ return {
802
+ ok: false,
803
+ endpoint: apiUrl,
804
+ authLabel: authLabelFor(credentials2),
805
+ reason: "endpoint_not_found",
806
+ error: `${apiUrl}/me returned HTTP 404 \u2014 that endpoint has no /me route, so it is probably missing the /v1 prefix. The credentials were NOT validated.`,
807
+ exitCode: 75
808
+ };
809
+ }
810
+ if (response.status >= 500) {
811
+ const serverMessage = await readErrorMessage(response);
812
+ return {
813
+ ok: false,
814
+ endpoint: apiUrl,
815
+ authLabel: authLabelFor(credentials2),
816
+ reason: "unreachable",
817
+ error: `${apiUrl} returned HTTP ${response.status}${serverMessage ? `: ${serverMessage}` : ""}. The credentials were NOT validated.`,
818
+ exitCode: 75
819
+ };
820
+ }
821
+ if (!response.ok) {
822
+ const serverMessage = await readErrorMessage(response);
823
+ return {
824
+ ok: false,
825
+ endpoint: apiUrl,
826
+ authLabel: authLabelFor(credentials2),
827
+ reason: "http_error",
828
+ error: `HTTP ${response.status}${serverMessage ? `: ${serverMessage}` : ""}`,
829
+ exitCode: 1
830
+ };
831
+ }
832
+ const data = await response.json();
833
+ return {
834
+ ok: true,
835
+ endpoint: apiUrl,
836
+ authType: data.auth_type,
837
+ authLabel: authLabelFor(credentials2),
838
+ runnerId: data.auth_type === "agent_key" ? data.agent_id : void 0,
839
+ reason: "ok",
840
+ exitCode: 0
841
+ };
842
+ }
843
+ function printJson(result) {
844
+ const payload = {
845
+ ok: result.ok,
846
+ endpoint: result.endpoint
847
+ };
848
+ if (result.authType) payload.auth_type = result.authType;
849
+ if (result.runnerId) payload.runner_id = result.runnerId;
850
+ if (result.reason) payload.reason = result.reason;
851
+ if (result.error) payload.error = result.error;
852
+ console.log(JSON.stringify(payload));
853
+ }
854
+ function printHuman(result) {
855
+ blank();
856
+ console.log(keyValue("Endpoint", result.endpoint));
857
+ if (result.ok) {
858
+ console.log(keyValue("Auth", result.authLabel ?? "\u2014"));
859
+ if (result.runnerId) {
860
+ console.log(keyValue("Runner", result.runnerId));
861
+ }
862
+ console.log(keyValue("Status", "OK \u2014 credentials accepted"));
863
+ blank();
864
+ return;
865
+ }
866
+ if (result.authLabel) {
867
+ console.log(keyValue("Auth", result.authLabel));
868
+ }
869
+ blank();
870
+ printError(result.error ?? "Unknown error");
871
+ }
872
+ async function status(options = {}) {
873
+ const result = await checkStatus(Boolean(options.json));
874
+ if (options.json) {
875
+ printJson(result);
876
+ } else {
877
+ printHuman(result);
878
+ }
879
+ process.exit(result.exitCode);
880
+ }
881
+
535
882
  // src/lib/claude-usage.ts
536
883
  import { execFileSync } from "child_process";
537
884
  import { readFileSync } from "fs";
@@ -582,6 +929,10 @@ var ClaudeUsageError = class extends Error {
582
929
  function isLocalCredentialProblem(err) {
583
930
  return err instanceof ClaudeUsageError && (err.reason === "no_credentials" || err.reason === "credentials_expired");
584
931
  }
932
+ function normalizeResetsAt(value) {
933
+ const ms = Date.parse(value);
934
+ return Number.isNaN(ms) ? null : new Date(ms).toISOString();
935
+ }
585
936
  function toWindow(value) {
586
937
  if (!value || typeof value !== "object") {
587
938
  return null;
@@ -590,7 +941,11 @@ function toWindow(value) {
590
941
  if (typeof window.utilization !== "number" || typeof window.resets_at !== "string") {
591
942
  return null;
592
943
  }
593
- return { utilization: window.utilization, resetsAt: window.resets_at };
944
+ const resetsAt = normalizeResetsAt(window.resets_at);
945
+ if (resetsAt === null) {
946
+ return null;
947
+ }
948
+ return { utilization: window.utilization, resetsAt };
594
949
  }
595
950
  async function getClaudeUsage() {
596
951
  const credentials2 = readClaudeCliCredentials();
@@ -652,6 +1007,9 @@ import { homedir as homedir3 } from "os";
652
1007
  import { isAbsolute as isAbsolute2, join as join3, parse, resolve as resolvePath } from "path";
653
1008
  import chalk6 from "chalk";
654
1009
 
1010
+ // ../../packages/types/src/agents/index.ts
1011
+ var MICROVM_MAX_LIFETIME_MS = 8 * 60 * 6e4;
1012
+
655
1013
  // ../../packages/types/src/telemetry/index.ts
656
1014
  var TelemetryEventTypes = {
657
1015
  // Agent activity events (shown in web UI activity log)
@@ -934,49 +1292,6 @@ function forwardRunnerActivity(entry, context) {
934
1292
  }
935
1293
  }
936
1294
 
937
- // src/lib/auth.ts
938
- async function getAuthCredentials() {
939
- const runnerKey = process.env.EVIDENT_RUNNER_KEY;
940
- const agentKey = process.env.EVIDENT_AGENT_KEY;
941
- if (runnerKey) {
942
- return {
943
- token: runnerKey,
944
- authType: "agent_key",
945
- keySource: "runner_key",
946
- notice: agentKey ? "Both EVIDENT_RUNNER_KEY and EVIDENT_AGENT_KEY are set; using EVIDENT_RUNNER_KEY." : void 0
947
- };
948
- }
949
- if (agentKey) {
950
- return { token: agentKey, authType: "agent_key", keySource: "agent_key" };
951
- }
952
- const userToken = process.env.EVIDENT_TOKEN;
953
- if (userToken) {
954
- return { token: userToken, authType: "bearer" };
955
- }
956
- const keychainCreds = await getToken();
957
- if (keychainCreds) {
958
- return {
959
- token: keychainCreds.token,
960
- authType: "bearer",
961
- user: keychainCreds.user
962
- };
963
- }
964
- return null;
965
- }
966
- function getAuthHeader(credentials2) {
967
- if (credentials2.authType === "agent_key") {
968
- return `SandboxKey ${credentials2.token}`;
969
- }
970
- return `Bearer ${credentials2.token}`;
971
- }
972
- function isInteractive(jsonOutput) {
973
- if (jsonOutput) return false;
974
- if (process.env.CI) return false;
975
- if (process.env.GITHUB_ACTIONS) return false;
976
- if (!process.stdin.isTTY) return false;
977
- return true;
978
- }
979
-
980
1295
  // src/lib/opencode/health.ts
981
1296
  async function checkOpenCodeHealth(port) {
982
1297
  try {
@@ -1784,6 +2099,21 @@ function messageError(messages, userMessageId) {
1784
2099
  }
1785
2100
  return "The agent run failed.";
1786
2101
  }
2102
+ function isAbortedTerminalReply(messages, userMessageId) {
2103
+ const reply = findLastAssistantReplyFor(messages, userMessageId);
2104
+ const error2 = errorOf(reply);
2105
+ if (error2 == null) return false;
2106
+ if (typeof error2 === "string") return error2.trim() === "Aborted";
2107
+ if (typeof error2 === "object") {
2108
+ const e = error2;
2109
+ if (e.name === "MessageAbortedError") return true;
2110
+ if (e.name === "AbortError") return true;
2111
+ const dataMessage = e.data?.message;
2112
+ const rendered = typeof dataMessage === "string" ? dataMessage : typeof e.message === "string" ? e.message : null;
2113
+ return rendered != null && rendered.trim() === "Aborted";
2114
+ }
2115
+ return false;
2116
+ }
1787
2117
  function messageFailure(messages, userMessageId) {
1788
2118
  const reply = findLastAssistantReplyFor(messages, userMessageId);
1789
2119
  const error2 = errorOf(reply);
@@ -2386,6 +2716,10 @@ function nextReportDelayMs(random = Math.random) {
2386
2716
  return BASE_REPORT_DELAY_MS - jitterRangeMs + random() * (2 * jitterRangeMs);
2387
2717
  }
2388
2718
  var FIRST_REPORT_DELAY_MS = 5e3 + Math.random() * 1e4;
2719
+ var CLAUDE_USAGE_FAILURE_REESCALATION_TICKS = 6;
2720
+ function claudeUsageFailureLogLevel(consecutiveFailures) {
2721
+ return consecutiveFailures === 1 || consecutiveFailures % CLAUDE_USAGE_FAILURE_REESCALATION_TICKS === 0 ? "warn" : "debug";
2722
+ }
2389
2723
 
2390
2724
  // src/lib/channels/driver.ts
2391
2725
  import { homedir as homedir2 } from "os";
@@ -2708,8 +3042,8 @@ async function applyOne(options, file) {
2708
3042
  await ack(options, file, "applied");
2709
3043
  return true;
2710
3044
  }
2711
- function durableDownloadCode(status) {
2712
- return status === 413 ? "file_too_large" : "write_failed";
3045
+ function durableDownloadCode(status2) {
3046
+ return status2 === 413 ? "file_too_large" : "write_failed";
2713
3047
  }
2714
3048
  async function downloadContent(options, file, label) {
2715
3049
  try {
@@ -2742,8 +3076,8 @@ async function downloadContent(options, file, label) {
2742
3076
  return { ok: false, terminal: false };
2743
3077
  }
2744
3078
  }
2745
- async function ack(options, file, status, reason) {
2746
- const outcome = `${status}${reason ? ` (${reason})` : ""}`;
3079
+ async function ack(options, file, status2, reason) {
3080
+ const outcome = `${status2}${reason ? ` (${reason})` : ""}`;
2747
3081
  try {
2748
3082
  const res = await options.fetchImpl(
2749
3083
  `${options.apiUrl}/runners/${options.agentId}/files/${file.id}/ack`,
@@ -2753,7 +3087,7 @@ async function ack(options, file, status, reason) {
2753
3087
  Authorization: options.getAuthHeader(),
2754
3088
  "Content-Type": "application/json"
2755
3089
  },
2756
- body: JSON.stringify(reason ? { status, reason } : { status })
3090
+ body: JSON.stringify(reason ? { status: status2, reason } : { status: status2 })
2757
3091
  }
2758
3092
  );
2759
3093
  if (!res.ok) {
@@ -2817,6 +3151,7 @@ var B2_ABANDONMENT_MIN_PINNED_MS = 3 * 6e4;
2817
3151
  var B2_ABANDONMENT_RECHECK_MS = HEARTBEAT_MS;
2818
3152
  var POLL_MISS_GRACE_MS = HEARTBEAT_MS;
2819
3153
  var MAX_SUPERSEDED_CONVERSATIONS = 256;
3154
+ var MAX_IDENTICAL_REDRIVE_POLL_FAILURES = 5;
2820
3155
  var ChannelAuthError = class extends Error {
2821
3156
  constructor(message) {
2822
3157
  super(message);
@@ -2825,10 +3160,10 @@ var ChannelAuthError = class extends Error {
2825
3160
  };
2826
3161
  var ChannelTerminalError = class extends Error {
2827
3162
  status;
2828
- constructor(message, status) {
3163
+ constructor(message, status2) {
2829
3164
  super(message);
2830
3165
  this.name = "ChannelTerminalError";
2831
- this.status = status;
3166
+ this.status = status2;
2832
3167
  }
2833
3168
  };
2834
3169
  function backoffDelay(attempt, policy) {
@@ -2836,8 +3171,12 @@ function backoffDelay(attempt, policy) {
2836
3171
  const capped = Math.min(policy.maxDelayMs, exp);
2837
3172
  return Math.floor(Math.random() * capped);
2838
3173
  }
2839
- function isRetryableStatus(status) {
2840
- return status === 429 || status >= 500 && status <= 599;
3174
+ function isRetryableStatus(status2) {
3175
+ return status2 === 429 || status2 >= 500 && status2 <= 599;
3176
+ }
3177
+ var VOLATILE_BODY_FIELD_PATTERN = /("(?:ref|requestId|request_id|traceId|trace_id)"\s*:\s*)"[^"]*"/gi;
3178
+ function normalizeRedrivePollFailureBody(body) {
3179
+ return body.replace(VOLATILE_BODY_FIELD_PATTERN, '$1"<redacted>"').replace(/\s+/g, " ").trim().slice(0, 200);
2841
3180
  }
2842
3181
  var ChannelDriver = class _ChannelDriver {
2843
3182
  agentId;
@@ -2952,6 +3291,84 @@ var ChannelDriver = class _ChannelDriver {
2952
3291
  * processing list, exactly like `dontRedispatch`/`doneUndeliverable`.
2953
3292
  */
2954
3293
  readoptPollUnresolvedSignalled = /* @__PURE__ */ new Set();
3294
+ /**
3295
+ * "Already emitted `redrive_unresolved` for this row" (#965). Mirrors
3296
+ * `readoptPollUnresolvedSignalled`: `resolveRedrive`'s `unresolved` leaf recurs
3297
+ * every ~2s drain until opencode's status becomes readable, but the
3298
+ * server-visible signal is an OUTCOME, so it fires at most once per row. Cleared
3299
+ * on any non-`unresolved` outcome so the set cannot grow beyond the currently
3300
+ * unresolvable rows.
3301
+ */
3302
+ redriveUnresolvedSignalled = /* @__PURE__ */ new Set();
3303
+ /**
3304
+ * First `now()` a `pending` row's re-drive was observed `unresolved` (#965). A
3305
+ * `pending` row is invisible to every cron arm (all require `status =
3306
+ * 'processing'`), so an indefinitely-`unresolved` row would be stranded with
3307
+ * nothing driving it. Once `now - since >= pausedMaxWaitMs`, `resolveRedrive`
3308
+ * takes `dispatch` instead of `unresolved` (reusing the existing knob — see
3309
+ * ADR-0047's own "unreachable ⇒ bounded" rule). Cleared on any other outcome.
3310
+ */
3311
+ redriveUnresolvedSince = /* @__PURE__ */ new Map();
3312
+ /**
3313
+ * Consecutive-identical-poll-failure streak for the re-drive fence (#1348),
3314
+ * keyed by Evident **message id** (not session) so `clearRedriveUnresolved`
3315
+ * can drop it with the other two trackers and it cannot leak. `sessionId` is
3316
+ * carried inside the entry, not the key: a session change is a different
3317
+ * situation and resets the streak, which gives the `(sessionId, message.id)`
3318
+ * pairing #1348 asks for without a composite map key.
3319
+ */
3320
+ redrivePollFailures = /* @__PURE__ */ new Map();
3321
+ /**
3322
+ * "Already emitted `redrive_outcome_unreported` for THIS (message, outcome)
3323
+ * streak" (Class B, #1340: the runner DECIDED reattach/settle/fail_permanent
3324
+ * but its own PATCH to record it failed — distinct from Class A's
3325
+ * `redrive_poll_failed`, where opencode itself can't be observed). Keyed by
3326
+ * message id, valued by the outcome currently failing to report, so a
3327
+ * change of outcome starts a fresh signal. Cleared by
3328
+ * `clearRedriveUnresolved` the instant either PATCH succeeds.
3329
+ */
3330
+ redriveOutcomeUnreportedSignalled = /* @__PURE__ */ new Map();
3331
+ /**
3332
+ * First `now()` a Class B outcome PATCH (reattach/settle/fail_permanent) was
3333
+ * observed to fail for this message (#1366's failure-window trip arm,
3334
+ * `boundRedriveOutcome`). Duration, not a tick count — bounded by the
3335
+ * existing `pausedMaxWaitMs` window (reusing the knob, not a new constant).
3336
+ * Cleared by `clearRedriveUnresolved` the instant the original PATCH
3337
+ * succeeds.
3338
+ */
3339
+ redriveOutcomeFailingSince = /* @__PURE__ */ new Map();
3340
+ /**
3341
+ * "Already posted `redrive_outcome_abandoned` with `reported: false` for this
3342
+ * row" (#1366) — the bound tripped but the terminal `markFailed` fallback ALSO
3343
+ * failed (the route-level fault of G2), so every following tick re-attempts
3344
+ * the same terminal PATCH. Guards that quiet retry from re-signalling on
3345
+ * every tick. Cleared by `clearRedriveUnresolved`.
3346
+ */
3347
+ redriveOutcomeAbandonedSignalled = /* @__PURE__ */ new Set();
3348
+ /**
3349
+ * "Already emitted `dispatch_not_started` for THIS (message, branch) streak"
3350
+ * (#1340). Valued by the branch currently firing, so a row that moves between
3351
+ * exits re-signals — the move IS the finding. Cleared only on a CONFIRMED
3352
+ * dispatch, never on the fence's decision to dispatch: `clearRedriveUnresolved`
3353
+ * runs on that decision (`resolveRedriveUnresolved`), so clearing there would
3354
+ * re-signal on every one of the 15h of re-dispatch attempts #1110 made.
3355
+ */
3356
+ dispatchNotStartedSignalled = /* @__PURE__ */ new Map();
3357
+ /**
3358
+ * Consecutive-UNCONFIRMED-dispatch streak for a `pending` row with NO stored
3359
+ * `opencode_message_id` yet — i.e. one that has never even reached the
3360
+ * re-drive fence above. `sendPromptAsync`'s POST may 2xx, but its own
3361
+ * read-back retries can never confirm the assigned id when the session's
3362
+ * message list is PERMANENTLY unreadable (e.g. a corrupted local opencode
3363
+ * SQLite DB, #1345/#1348's exact fault, just hit BEFORE the row is ever
3364
+ * dispatched instead of after). Unlike an already-dispatched row, THIS row has
3365
+ * no other safety net at all: the lifecycle cron only reclaims `status =
3366
+ * 'processing'` rows, and a row stuck here never reaches `processing`. Keyed
3367
+ * by message id, carrying `sessionId` so a session change (a fresh one bound
3368
+ * after abandonment) starts a new streak rather than inheriting the old
3369
+ * session's count — same shape as `redrivePollFailures` above.
3370
+ */
3371
+ unconfirmedDispatchFailures = /* @__PURE__ */ new Map();
2955
3372
  /**
2956
3373
  * "A null-id re-adopt re-dispatch is in flight, awaiting its read-back" (WI-5
2957
3374
  * Task 5.4, High-2). Since we no longer send a caller-supplied id, a re-dispatch
@@ -3276,7 +3693,7 @@ var ChannelDriver = class _ChannelDriver {
3276
3693
  * @returns the count of messages NEWLY dispatched (not already in-flight).
3277
3694
  */
3278
3695
  async processConversation(conv) {
3279
- const { sessionId, refusedSessionId } = await this.ensureSession(conv);
3696
+ const { sessionId, refusedSessionId, created: sessionCreated } = await this.ensureSession(conv);
3280
3697
  const messages = await this.getPendingMessages(conv.id);
3281
3698
  let dispatched = 0;
3282
3699
  let skippedAlreadyDispatched = 0;
@@ -3291,6 +3708,15 @@ var ChannelDriver = class _ChannelDriver {
3291
3708
  skippedAlreadyDispatched += 1;
3292
3709
  continue;
3293
3710
  }
3711
+ if (message.opencode_message_id) {
3712
+ const outcome = await this.resolveRedrive(conv, sessionId, message, sessionCreated);
3713
+ if (outcome === "abandoned") {
3714
+ continue;
3715
+ }
3716
+ if (outcome !== "dispatch") {
3717
+ break;
3718
+ }
3719
+ }
3294
3720
  const options = {
3295
3721
  agent: message.opencode_agent ?? void 0,
3296
3722
  model: message.opencode_model ?? void 0
@@ -3320,6 +3746,7 @@ var ChannelDriver = class _ChannelDriver {
3320
3746
  conversation_id: conv.id,
3321
3747
  message_id: message.id
3322
3748
  });
3749
+ this.signalDispatchNotStarted(conv, message, "session_deleted_race");
3323
3750
  break;
3324
3751
  }
3325
3752
  if (exists === null) {
@@ -3329,6 +3756,7 @@ var ChannelDriver = class _ChannelDriver {
3329
3756
  conversation_id: conv.id,
3330
3757
  message_id: message.id
3331
3758
  });
3759
+ this.signalDispatchNotStarted(conv, message, "session_existence_unknown");
3332
3760
  break;
3333
3761
  }
3334
3762
  const errorMessage = err instanceof Error ? err.message : String(err);
@@ -3347,6 +3775,7 @@ var ChannelDriver = class _ChannelDriver {
3347
3775
  conversation_id: conv.id,
3348
3776
  message_id: message.id
3349
3777
  });
3778
+ this.signalDispatchNotStarted(conv, message, "failure_unreported");
3350
3779
  });
3351
3780
  this.log({
3352
3781
  level: "error",
@@ -3357,14 +3786,40 @@ var ChannelDriver = class _ChannelDriver {
3357
3786
  break;
3358
3787
  }
3359
3788
  if (opencodeMessageId === null) {
3789
+ const streak = this.recordUnconfirmedDispatch(message.id, sessionId);
3790
+ if (streak < MAX_IDENTICAL_REDRIVE_POLL_FAILURES) {
3791
+ this.log({
3792
+ level: "warn",
3793
+ message: `Message ${message.id.slice(0, 8)} dispatched but its opencode id could not be read back (${streak}/${MAX_IDENTICAL_REDRIVE_POLL_FAILURES}) \u2014 leaving un-tracked to retry next tick`,
3794
+ conversation_id: conv.id,
3795
+ message_id: message.id
3796
+ });
3797
+ this.signalDispatchNotStarted(conv, message, "readback_unconfirmed");
3798
+ continue;
3799
+ }
3800
+ this.unconfirmedDispatchFailures.delete(message.id);
3801
+ this.sessions.delete(conv.id);
3802
+ this.supersede(conv.id, sessionId);
3803
+ const errorMessage = `OpenCode accepted this message ${streak} times in a row but never confirmed its assigned id (session ${sessionId.slice(0, 8)}'s message list could not be read back) \u2014 the session was abandoned; a fresh one is used for further messages.`;
3360
3804
  this.log({
3361
- level: "warn",
3362
- message: `Message ${message.id.slice(0, 8)} dispatched but its opencode id could not be read back \u2014 leaving un-tracked to retry next tick`,
3805
+ level: "error",
3806
+ message: errorMessage,
3363
3807
  conversation_id: conv.id,
3364
3808
  message_id: message.id
3365
3809
  });
3366
- continue;
3810
+ await this.markFailed(conv.id, message.id, null, errorMessage).catch((markErr) => {
3811
+ this.log({
3812
+ level: "warn",
3813
+ message: `markFailed PATCH for message ${message.id.slice(0, 8)} (conversation ${conv.id.slice(0, 8)}) failed (best-effort, not retried): ${markErr instanceof Error ? markErr.message : String(markErr)}`,
3814
+ conversation_id: conv.id,
3815
+ message_id: message.id
3816
+ });
3817
+ this.signalDispatchNotStarted(conv, message, "abandon_unreported");
3818
+ });
3819
+ break;
3367
3820
  }
3821
+ this.unconfirmedDispatchFailures.delete(message.id);
3822
+ this.dispatchNotStartedSignalled.delete(message.id);
3368
3823
  this.dispatched.add(message.id);
3369
3824
  this.registerInFlight(conv, sessionId, message, opencodeMessageId);
3370
3825
  dispatched += 1;
@@ -3373,12 +3828,458 @@ var ChannelDriver = class _ChannelDriver {
3373
3828
  if (messages.length > 0 && dispatched === 0 && skippedAlreadyDispatched === messages.length) {
3374
3829
  this.log({
3375
3830
  level: "warn",
3376
- message: `Conversation ${conv.id.slice(0, 8)} has ${messages.length} pending message(s) but ALL are already marked dispatched locally (in-flight set: ${this.dispatched.size}) \u2014 none sent to OpenCode this tick. If this repeats, a message may be stuck acknowledged-but-never-dispatched (its watcher never settled).`,
3377
- conversation_id: conv.id
3831
+ message: `Conversation ${conv.id.slice(0, 8)} has ${messages.length} pending message(s) but ALL are already marked dispatched locally (in-flight set: ${this.dispatched.size}) \u2014 none sent to OpenCode this tick. If this repeats, a message may be stuck acknowledged-but-never-dispatched (its watcher never settled).`,
3832
+ conversation_id: conv.id
3833
+ });
3834
+ }
3835
+ this.ensureWatcherRunning(sessionId);
3836
+ return dispatched;
3837
+ }
3838
+ /**
3839
+ * Poll a session's message list for the re-drive fence (#965), via the
3840
+ * INJECTED `fetchImpl` — NOT the imported `getSessionMessages` helper, which
3841
+ * hits the global `fetch` and would bypass the same override every other
3842
+ * opencode poll in this file respects. Mirrors `readoptProcessing`'s own
3843
+ * snapshot fetch (`:3081-3111`).
3844
+ *
3845
+ * Returns `{ ok: true, messages }` on a readable snapshot, or
3846
+ * `{ ok: false, signature }` on failure — `signature` is a string that
3847
+ * repeats across attempts for the SAME underlying fault (used by the
3848
+ * consecutive-identical-failure bound, #1348), or `null` for a thrown
3849
+ * exception, which is NOT countable toward that bound (a network blip / an
3850
+ * opencode restart also throws identically every tick, and must keep
3851
+ * retrying unbounded rather than ever being treated as permanent).
3852
+ */
3853
+ async pollSessionMessagesForRedrive(conv, message, sessionId) {
3854
+ try {
3855
+ const res = await this.fetchImpl(`${this.opencodeBase}/session/${sessionId}/message`);
3856
+ if (!res.ok) {
3857
+ const rawBody = await res.text();
3858
+ const normalized = normalizeRedrivePollFailureBody(rawBody);
3859
+ this.log({
3860
+ level: "warn",
3861
+ message: `Re-drive: polling session ${sessionId.slice(0, 8)} for message ${message.id.slice(0, 8)} returned HTTP ${res.status}${normalized ? `: ${normalized}` : ""} \u2014 treating as unreadable this tick`,
3862
+ conversation_id: conv.id,
3863
+ message_id: message.id
3864
+ });
3865
+ return { ok: false, signature: `HTTP ${res.status}${normalized ? `: ${normalized}` : ""}` };
3866
+ }
3867
+ const body = await res.json();
3868
+ if (!Array.isArray(body)) {
3869
+ this.log({
3870
+ level: "warn",
3871
+ message: `Re-drive: polling session ${sessionId.slice(0, 8)} for message ${message.id.slice(0, 8)} returned a non-array message body \u2014 treating as unreadable this tick`,
3872
+ conversation_id: conv.id,
3873
+ message_id: message.id
3874
+ });
3875
+ return { ok: false, signature: "non-array message body" };
3876
+ }
3877
+ return { ok: true, messages: body };
3878
+ } catch (err) {
3879
+ this.log({
3880
+ level: "warn",
3881
+ message: `Re-drive: failed to poll session ${sessionId.slice(0, 8)} for message ${message.id.slice(0, 8)} (will retry next drain): ${err instanceof Error ? err.message : String(err)}`,
3882
+ conversation_id: conv.id,
3883
+ message_id: message.id
3884
+ });
3885
+ return { ok: false, signature: null };
3886
+ }
3887
+ }
3888
+ /**
3889
+ * The re-drive fence for a `pending` row that already carries a stored
3890
+ * `opencode_message_id` (#965) — i.e. it has already been handed to opencode at
3891
+ * least once (see the invariant at `QueuedMessage.opencode_message_id`'s doc).
3892
+ * The lifecycle cron can falsely reclaim a `processing` row back to `pending`
3893
+ * mid-turn (a 5-minute liveness-staleness check racing a still-running turn);
3894
+ * without this fence the drain loop would re-`prompt_async` the SAME turn a
3895
+ * second time against live GitHub state. Mirrors `readoptOne`'s job for the
3896
+ * `processing` re-adopt path, but simpler: no b1/b2 preamble cross-check is
3897
+ * needed here because `sessionCreated` already handles the cases (a #553
3898
+ * abandoned session, a #190 vanished one) that path exists for.
3899
+ *
3900
+ * Only `ChannelAuthError` propagates. A poll that fails identically
3901
+ * `MAX_IDENTICAL_REDRIVE_POLL_FAILURES` times in a row reports the message
3902
+ * failed instead of retrying it (#1348) — SEPARATE from, not a replacement
3903
+ * for, `resolveRedriveUnresolved`'s own `pausedMaxWaitMs` bound below. Every
3904
+ * other failure resolves to `unresolved` and is retried whole on the next
3905
+ * ~2s drain tick.
3906
+ */
3907
+ async resolveRedrive(conv, sessionId, message, sessionCreated) {
3908
+ const ocId = message.opencode_message_id ?? null;
3909
+ if (sessionCreated) {
3910
+ this.clearRedriveUnresolved(message.id);
3911
+ void this.postSignal(conv.id, message.id, "redrive_redispatched");
3912
+ return "dispatch";
3913
+ }
3914
+ const polled = await this.pollSessionMessagesForRedrive(conv, message, sessionId);
3915
+ if (!polled.ok) {
3916
+ const streak = this.recordRedrivePollFailure(message.id, sessionId, polled.signature);
3917
+ if (streak >= MAX_IDENTICAL_REDRIVE_POLL_FAILURES && polled.signature !== null) {
3918
+ return this.failRedrivePollPermanent(conv, sessionId, message, polled.signature, streak);
3919
+ }
3920
+ return this.resolveRedriveUnresolved(conv, message);
3921
+ }
3922
+ this.redrivePollFailures.delete(message.id);
3923
+ const messages = polled.messages;
3924
+ if (messages.length === 0) {
3925
+ return this.resolveRedriveUnresolved(conv, message);
3926
+ }
3927
+ const state = messageRunState(messages, ocId ?? "");
3928
+ if (state === "failed" && isAbortedTerminalReply(messages, ocId ?? "")) {
3929
+ const ongoing = await isSessionOngoing(this.port, sessionId);
3930
+ if (ongoing === false) {
3931
+ this.log({
3932
+ level: "info",
3933
+ message: `Re-drive: message ${message.id.slice(0, 8)} carries an abort-shaped terminal error and session ${sessionId.slice(0, 8)} is not-ongoing per GET /session/status \u2014 restart orphan, re-dispatching instead of marking it permanently failed`,
3934
+ conversation_id: conv.id,
3935
+ message_id: message.id
3936
+ });
3937
+ this.clearRedriveUnresolved(message.id);
3938
+ void this.postSignal(conv.id, message.id, "redrive_redispatched");
3939
+ return "dispatch";
3940
+ }
3941
+ }
3942
+ if (state === "done" || state === "failed") {
3943
+ return this.settleRedrive(conv, sessionId, message, ocId, messages, state);
3944
+ }
3945
+ if (state === "running" || state === "queued") {
3946
+ const ongoing = await isSessionOngoing(this.port, sessionId);
3947
+ if (ongoing === true) {
3948
+ return this.reattachRedrive(conv, sessionId, message, ocId);
3949
+ }
3950
+ if (ongoing === false) {
3951
+ this.clearRedriveUnresolved(message.id);
3952
+ void this.postSignal(conv.id, message.id, "redrive_redispatched");
3953
+ return "dispatch";
3954
+ }
3955
+ return this.resolveRedriveUnresolved(conv, message);
3956
+ }
3957
+ this.clearRedriveUnresolved(message.id);
3958
+ void this.postSignal(conv.id, message.id, "redrive_redispatched");
3959
+ return "dispatch";
3960
+ }
3961
+ /**
3962
+ * The `reattached` outcome (Task 3.3): the prior turn is STILL ONGOING per
3963
+ * opencode's own status map — undo the false reclaim instead of starting a
3964
+ * second turn.
3965
+ */
3966
+ async reattachRedrive(conv, sessionId, message, ocId) {
3967
+ let anchorMs;
3968
+ const parsed = message.processing_started_at ? Date.parse(message.processing_started_at) : NaN;
3969
+ if (!Number.isNaN(parsed)) {
3970
+ anchorMs = parsed;
3971
+ } else {
3972
+ anchorMs = this.now();
3973
+ this.log({
3974
+ level: "error",
3975
+ message: `Re-drive: message ${message.id.slice(0, 8)} has null/unparseable processing_started_at (${String(message.processing_started_at)}) \u2014 anchoring the watcher's absolute-age ceiling to now (defensive)`,
3976
+ conversation_id: conv.id,
3977
+ message_id: message.id
3978
+ });
3979
+ }
3980
+ const title = await this.resolveSessionTitle(sessionId, conv.id);
3981
+ try {
3982
+ const restored = await this.markProcessing(conv.id, message.id, sessionId, ocId, title);
3983
+ if (!restored) {
3984
+ this.log({
3985
+ level: "error",
3986
+ message: `Re-drive: the server definitively refused to restore message ${message.id.slice(0, 8)} to processing (non-retryable 4xx \u2014 the row is gone or the update was rejected); NOT reporting a re-attach`,
3987
+ conversation_id: conv.id,
3988
+ message_id: message.id
3989
+ });
3990
+ const bound = await this.boundRedriveOutcome(conv, message, "reattach");
3991
+ return bound === "abandoned" ? "abandoned" : "unresolved";
3992
+ }
3993
+ } catch (err) {
3994
+ if (err instanceof ChannelAuthError) throw err;
3995
+ this.log({
3996
+ level: "warn",
3997
+ message: `Re-drive: failed to restore message ${message.id.slice(0, 8)} to processing (will retry next drain): ${err instanceof Error ? err.message : String(err)}`,
3998
+ conversation_id: conv.id,
3999
+ message_id: message.id
4000
+ });
4001
+ const bound = await this.boundRedriveOutcome(conv, message, "reattach");
4002
+ return bound === "abandoned" ? "abandoned" : "unresolved";
4003
+ }
4004
+ this.clearRedriveUnresolved(message.id);
4005
+ this.registerReadopted(conv, sessionId, message, ocId ?? "", anchorMs);
4006
+ this.dispatched.add(message.id);
4007
+ this.readopted.add(message.id);
4008
+ this.ensureWatcherRunning(sessionId);
4009
+ const watchedForMs = this.now() - anchorMs;
4010
+ void this.postSignal(conv.id, message.id, "redrive_reattached", {
4011
+ watched_for_ms: watchedForMs
4012
+ });
4013
+ this.log({
4014
+ level: "warn",
4015
+ message: `Re-drive: message ${message.id.slice(0, 8)} (session ${sessionId.slice(0, 8)}) was wrongly reclaimed to pending while its turn was still running (watched ${watchedForMs}ms) \u2014 restored to processing instead of re-dispatching`,
4016
+ conversation_id: conv.id,
4017
+ message_id: message.id
4018
+ });
4019
+ return "reattached";
4020
+ }
4021
+ /**
4022
+ * The `settled` outcome (Task 3.2): the prior turn already finished (or
4023
+ * errored) while nobody was watching — deliver/report it instead of re-running.
4024
+ * Mirrors `readoptOne`'s `done`/`failed` branches' error discipline, simplified
4025
+ * (no `doneUndeliverable` park: a terminal PATCH failure here just retries next
4026
+ * drain, same as any other non-auth failure). The restart-abort carve-out that
4027
+ * keeps the two in step for `failed` lives in the caller (`resolveRedrive`, #1310),
4028
+ * so a row reaching this `failed` branch is a GENUINE failure.
4029
+ */
4030
+ async settleRedrive(conv, sessionId, message, ocId, messages, state) {
4031
+ try {
4032
+ if (state === "done") {
4033
+ const title = await this.resolveSessionTitle(sessionId, conv.id);
4034
+ const usage = messageUsage(messages, ocId ?? "");
4035
+ this.log({
4036
+ level: "info",
4037
+ message: `Re-drive: message ${message.id.slice(0, 8)} completed while its row was wrongly reclaimed to pending \u2014 marking done instead of re-dispatching`,
4038
+ conversation_id: conv.id,
4039
+ message_id: message.id
4040
+ });
4041
+ await this.markDone(conv.id, message.id, sessionId, ocId, title, usage);
4042
+ } else {
4043
+ const error2 = messageError(messages, ocId ?? "") ?? void 0;
4044
+ const usage = messageUsage(messages, ocId ?? "");
4045
+ const failure = await this.classifyModelAuthFailure(messages, ocId ?? "");
4046
+ this.log({
4047
+ level: "error",
4048
+ message: `Re-drive: message ${message.id.slice(0, 8)} errored while its row was wrongly reclaimed to pending \u2014 marking failed instead of re-dispatching: ${error2 ?? "(no error text)"}`,
4049
+ conversation_id: conv.id,
4050
+ message_id: message.id
4051
+ });
4052
+ await this.markFailed(conv.id, message.id, sessionId, error2, usage, failure);
4053
+ }
4054
+ } catch (err) {
4055
+ if (err instanceof ChannelAuthError) throw err;
4056
+ this.log({
4057
+ level: "warn",
4058
+ message: `Re-drive: failed to report message ${message.id.slice(0, 8)} ${state} (will retry next drain): ${err instanceof Error ? err.message : String(err)}`,
4059
+ conversation_id: conv.id,
4060
+ message_id: message.id
4061
+ });
4062
+ const bound = await this.boundRedriveOutcome(conv, message, "settle");
4063
+ return bound === "abandoned" ? "abandoned" : "unresolved";
4064
+ }
4065
+ this.clearRedriveUnresolved(message.id);
4066
+ void this.postSignal(conv.id, message.id, "redrive_settled");
4067
+ return "settled";
4068
+ }
4069
+ /**
4070
+ * The permanent-failure outcome (#1348): the fence's own poll of this session
4071
+ * failed with the SAME opencode-answered signature
4072
+ * `MAX_IDENTICAL_REDRIVE_POLL_FAILURES` times in a row — a transient blip
4073
+ * would have varied or eventually cleared (see `pollSessionMessagesForRedrive`
4074
+ * and `recordRedrivePollFailure`), so this is a durable fault (e.g. #1345's
4075
+ * corrupted opencode session) rather than something worth retrying forever.
4076
+ * Mirrors `settleRedrive`'s error discipline: no `usage`/`failure` args to
4077
+ * `markFailed` (no opencode snapshot to extract them from — this poll never
4078
+ * got a readable one).
4079
+ */
4080
+ async failRedrivePollPermanent(conv, sessionId, message, signature, streak) {
4081
+ this.log({
4082
+ level: "error",
4083
+ message: `Re-drive: message ${message.id.slice(0, 8)} (session ${sessionId.slice(0, 8)}) failed to poll with the identical signature "${signature}" ${streak} times in a row \u2014 reporting the message failed instead of retrying forever`,
4084
+ conversation_id: conv.id,
4085
+ message_id: message.id
4086
+ });
4087
+ try {
4088
+ await this.markFailed(
4089
+ conv.id,
4090
+ message.id,
4091
+ sessionId,
4092
+ `The runner could not read this conversation's state from OpenCode (${signature}). The same failure repeated ${streak} times in a row, so the message was not retried further.`
4093
+ );
4094
+ } catch (err) {
4095
+ if (err instanceof ChannelAuthError) throw err;
4096
+ this.log({
4097
+ level: "warn",
4098
+ message: `Re-drive: failed to report message ${message.id.slice(0, 8)} permanently failed (will retry next drain): ${err instanceof Error ? err.message : String(err)}`,
4099
+ conversation_id: conv.id,
4100
+ message_id: message.id
4101
+ });
4102
+ const bound = await this.boundRedriveOutcome(conv, message, "fail_permanent");
4103
+ return bound === "abandoned" ? "abandoned" : "unresolved";
4104
+ }
4105
+ this.clearRedriveUnresolved(message.id);
4106
+ void this.postSignal(conv.id, message.id, "redrive_poll_failed");
4107
+ return "settled";
4108
+ }
4109
+ /**
4110
+ * The bounded `unresolved` outcome (Task 3.4): opencode's state could not be
4111
+ * observed (snapshot unreadable/empty, or `isSessionOngoing` returned `null`).
4112
+ * A `pending` row is swept by the server's own `PENDING_MAX_AGE_MS` (24h,
4113
+ * #1368) cron arm, but that is a day-scale backstop — this local bound acts
4114
+ * in minutes so the row (and the conversation it starves, per the ordering
4115
+ * invariant below) isn't left stranded for that long. Bound to the existing
4116
+ * `pausedMaxWaitMs` window (reusing the knob, not a new constant); takes
4117
+ * `dispatch` once elapsed.
4118
+ */
4119
+ resolveRedriveUnresolved(conv, message) {
4120
+ const now = this.now();
4121
+ const since = this.redriveUnresolvedSince.get(message.id);
4122
+ if (since !== void 0 && now - since >= this.pausedMaxWaitMs) {
4123
+ this.clearRedriveUnresolved(message.id);
4124
+ void this.postSignal(conv.id, message.id, "redrive_redispatched");
4125
+ return "dispatch";
4126
+ }
4127
+ if (since === void 0) {
4128
+ this.redriveUnresolvedSince.set(message.id, now);
4129
+ }
4130
+ if (!this.redriveUnresolvedSignalled.has(message.id)) {
4131
+ this.redriveUnresolvedSignalled.add(message.id);
4132
+ void this.postSignal(conv.id, message.id, "redrive_unresolved");
4133
+ }
4134
+ return "unresolved";
4135
+ }
4136
+ /** Clear all `unresolved`/failure-streak trackers for a row (any non-`unresolved` outcome). */
4137
+ clearRedriveUnresolved(messageId) {
4138
+ this.redriveUnresolvedSince.delete(messageId);
4139
+ this.redriveUnresolvedSignalled.delete(messageId);
4140
+ this.redrivePollFailures.delete(messageId);
4141
+ this.redriveOutcomeUnreportedSignalled.delete(messageId);
4142
+ this.redriveOutcomeFailingSince.delete(messageId);
4143
+ this.redriveOutcomeAbandonedSignalled.delete(messageId);
4144
+ }
4145
+ /**
4146
+ * #1340: the dispatch loop reached a message and did NOT start a turn. Fires at
4147
+ * most once per (message, branch) streak — a wedged row is re-tried every tick,
4148
+ * and the per-tick count is already carried by the co-occurring
4149
+ * `redrive_unresolved`/`redrive_redispatched` signals.
4150
+ */
4151
+ signalDispatchNotStarted(conv, message, branch) {
4152
+ if (this.dispatchNotStartedSignalled.get(message.id) === branch) return;
4153
+ this.dispatchNotStartedSignalled.set(message.id, branch);
4154
+ void this.postSignal(conv.id, message.id, "dispatch_not_started", { branch });
4155
+ }
4156
+ /**
4157
+ * Class B (#1340): the runner DECIDED an outcome (reattach/settle/fail_permanent)
4158
+ * but its own PATCH to record it failed. Fires at most once per (message,
4159
+ * outcome) streak, and only while `boundRedriveOutcome` has not yet tripped —
4160
+ * once it trips, `redrive_outcome_abandoned` takes over reporting for the row
4161
+ * (#1366).
4162
+ */
4163
+ signalRedriveOutcomeUnreported(conv, message, outcome) {
4164
+ if (this.redriveOutcomeUnreportedSignalled.get(message.id) === outcome) return;
4165
+ this.redriveOutcomeUnreportedSignalled.set(message.id, outcome);
4166
+ void this.postSignal(conv.id, message.id, "redrive_outcome_unreported", {
4167
+ attempted_outcome: outcome
4168
+ });
4169
+ }
4170
+ /**
4171
+ * The runner-authored, honest error text for the terminal fallback a tripped
4172
+ * `boundRedriveOutcome` sends. Distinguishable per outcome and truthful about
4173
+ * what actually happened — the `settle`/done case must say the turn finished
4174
+ * but its result could not be recorded, never that the runner stopped
4175
+ * responding (that would be a lie for this shape, see #1366's "why this ships").
4176
+ */
4177
+ static REDRIVE_ABANDON_ERROR = {
4178
+ reattach: "your runner could not record that this message had started, so it was given up on",
4179
+ settle: "your runner finished this message but could not record the result, so the reply could not be delivered",
4180
+ fail_permanent: "the runner could not read this conversation's state from OpenCode, and could not record that failure either, so the message was given up on"
4181
+ };
4182
+ /**
4183
+ * Bound for Class B (#1340, #1366): the runner DECIDED an outcome but its own
4184
+ * PATCH to record it failed. Two independent trip arms (either sufficient):
4185
+ * (1) this failure streak has lasted `pausedMaxWaitMs` — DURATION, not a tick
4186
+ * count, reusing the knob `resolveRedriveUnresolved` already established; (2)
4187
+ * the turn's `processing_started_at` age has crossed
4188
+ * `ABSOLUTE_MAX_PROCESSING_MS` — durable and restart-surviving, since arm (1)'s
4189
+ * in-memory streak resets on a scale-to-zero restart.
4190
+ *
4191
+ * INVARIANT — a tripped bound never suppresses the original outcome attempt;
4192
+ * it only adds a fallback after that attempt has failed again. This is only
4193
+ * ever reached from inside the catch of the ORIGINAL outcome PATCH, which is
4194
+ * attempted first on every tick whether or not this bound tripped before —
4195
+ * there is no give-up latch that would short-circuit it. That is what lets a
4196
+ * route-level fault that heals later still deliver the turn's real
4197
+ * `done`/`failed` payload: once the original PATCH succeeds again, this
4198
+ * helper is never entered and the row settles with its real result.
4199
+ */
4200
+ async boundRedriveOutcome(conv, message, outcome) {
4201
+ const now = this.now();
4202
+ const since = this.redriveOutcomeFailingSince.get(message.id);
4203
+ if (since === void 0) this.redriveOutcomeFailingSince.set(message.id, now);
4204
+ const durationTripped = now - (since ?? now) >= this.pausedMaxWaitMs;
4205
+ const parsed = message.processing_started_at ? Date.parse(message.processing_started_at) : NaN;
4206
+ const absoluteAgeTripped = !Number.isNaN(parsed) && now - parsed >= ABSOLUTE_MAX_PROCESSING_MS;
4207
+ if (!durationTripped && !absoluteAgeTripped) {
4208
+ this.signalRedriveOutcomeUnreported(conv, message, outcome);
4209
+ return "retry";
4210
+ }
4211
+ const arm = durationTripped ? "failure_window" : "absolute_age";
4212
+ try {
4213
+ await this.markFailed(
4214
+ conv.id,
4215
+ message.id,
4216
+ void 0,
4217
+ _ChannelDriver.REDRIVE_ABANDON_ERROR[outcome]
4218
+ );
4219
+ } catch (err) {
4220
+ if (err instanceof ChannelAuthError) throw err;
4221
+ this.log({
4222
+ level: "warn",
4223
+ message: `Re-drive bound: fallback markFailed for message ${message.id.slice(0, 8)} also failed (arm ${arm}, will retry next drain): ${err instanceof Error ? err.message : String(err)}`,
4224
+ conversation_id: conv.id,
4225
+ message_id: message.id
3378
4226
  });
4227
+ if (!this.redriveOutcomeAbandonedSignalled.has(message.id)) {
4228
+ this.redriveOutcomeAbandonedSignalled.add(message.id);
4229
+ void this.postSignal(conv.id, message.id, "redrive_outcome_abandoned", {
4230
+ attempted_outcome: outcome,
4231
+ reported: false,
4232
+ arm
4233
+ });
4234
+ }
4235
+ return "retry";
3379
4236
  }
3380
- this.ensureWatcherRunning(sessionId);
3381
- return dispatched;
4237
+ this.clearRedriveUnresolved(message.id);
4238
+ void this.postSignal(conv.id, message.id, "redrive_outcome_abandoned", {
4239
+ attempted_outcome: outcome,
4240
+ reported: true,
4241
+ arm
4242
+ });
4243
+ return "abandoned";
4244
+ }
4245
+ /**
4246
+ * Record one poll outcome toward the re-drive fence's consecutive-identical-
4247
+ * failure streak (#1348) and return the resulting count. `signature === null`
4248
+ * (a thrown exception, H1) always clears the streak and returns `0` — it is
4249
+ * never countable. Otherwise the streak continues only when BOTH the session
4250
+ * and the signature match the previous failure; anything else (a different
4251
+ * session, or the same session failing a DIFFERENT way) starts a fresh streak
4252
+ * at `1`.
4253
+ */
4254
+ recordRedrivePollFailure(messageId, sessionId, signature) {
4255
+ if (signature === null) {
4256
+ this.redrivePollFailures.delete(messageId);
4257
+ return 0;
4258
+ }
4259
+ const existing = this.redrivePollFailures.get(messageId);
4260
+ if (existing && existing.sessionId === sessionId && existing.signature === signature) {
4261
+ existing.count += 1;
4262
+ return existing.count;
4263
+ }
4264
+ this.redrivePollFailures.set(messageId, { sessionId, signature, count: 1 });
4265
+ return 1;
4266
+ }
4267
+ /**
4268
+ * Record one UNCONFIRMED-dispatch outcome (a `pending` row with no stored
4269
+ * `opencode_message_id` whose `sendPromptAsync` returned `null`) toward the
4270
+ * bound in `processConversation`'s dispatch loop, and return the resulting
4271
+ * count. Mirrors `recordRedrivePollFailure`'s session-scoping: a session
4272
+ * change starts a fresh streak at `1` rather than inheriting the old one's
4273
+ * count, since a new session is a genuinely different attempt.
4274
+ */
4275
+ recordUnconfirmedDispatch(messageId, sessionId) {
4276
+ const existing = this.unconfirmedDispatchFailures.get(messageId);
4277
+ if (existing && existing.sessionId === sessionId) {
4278
+ existing.count += 1;
4279
+ return existing.count;
4280
+ }
4281
+ this.unconfirmedDispatchFailures.set(messageId, { sessionId, count: 1 });
4282
+ return 1;
3382
4283
  }
3383
4284
  /**
3384
4285
  * Record that `sessionId` is no longer a valid binding for `conversationId`
@@ -3404,6 +4305,13 @@ var ChannelDriver = class _ChannelDriver {
3404
4305
  * `refusedSessionId` is set when the #553 guard fired — i.e. the persisted
3405
4306
  * binding was an id this runner had abandoned, so a resurrection genuinely
3406
4307
  * happened and a fresh session was bound instead. The caller reports it.
4308
+ *
4309
+ * `created` says the returned session was made JUST NOW, so it provably holds
4310
+ * no prior turn. The re-drive fence needs that as CONTRARY evidence ("nothing
4311
+ * to reconcile against") — distinct from the ambiguous "I polled and saw an
4312
+ * empty transcript", which stays a deferral. Keep it separate from
4313
+ * `refusedSessionId`: only the latter means a #553 resurrection happened, and
4314
+ * only it may drive the `session_superseded` signal.
3407
4315
  */
3408
4316
  async ensureSession(conv) {
3409
4317
  const bound = this.sessions.get(conv.id) ?? conv.opencode_session_id ?? null;
@@ -3414,7 +4322,11 @@ var ChannelDriver = class _ChannelDriver {
3414
4322
  conversation_id: conv.id
3415
4323
  });
3416
4324
  this.sessions.delete(conv.id);
3417
- return { sessionId: await this.createAndBindSession(conv.id), refusedSessionId: bound };
4325
+ return {
4326
+ sessionId: await this.createAndBindSession(conv.id),
4327
+ refusedSessionId: bound,
4328
+ created: true
4329
+ };
3418
4330
  }
3419
4331
  if (bound) {
3420
4332
  const exists = await sessionExists(this.port, bound);
@@ -3425,12 +4337,12 @@ var ChannelDriver = class _ChannelDriver {
3425
4337
  conversation_id: conv.id
3426
4338
  });
3427
4339
  this.sessions.delete(conv.id);
3428
- return { sessionId: await this.createAndBindSession(conv.id) };
4340
+ return { sessionId: await this.createAndBindSession(conv.id), created: true };
3429
4341
  }
3430
4342
  this.sessions.set(conv.id, bound);
3431
- return { sessionId: bound };
4343
+ return { sessionId: bound, created: false };
3432
4344
  }
3433
- return { sessionId: await this.createAndBindSession(conv.id) };
4345
+ return { sessionId: await this.createAndBindSession(conv.id), created: true };
3434
4346
  }
3435
4347
  /**
3436
4348
  * Create a fresh OpenCode session for a conversation, cache the binding, and
@@ -3663,9 +4575,10 @@ var ChannelDriver = class _ChannelDriver {
3663
4575
  * opencode reports ACTIVELY `running` is watched to completion (its liveness
3664
4576
  * heartbeat keeps the cron off its row), while a re-adopted turn that is paused
3665
4577
  * awaiting a human — or queued/unreachable — is still bounded by `deadline` and
3666
- * handed to the cron. The old "the `deadline` must settle before the ~15-min
3667
- * cron or they double-drive" reasoning is superseded: liveness now settles the
3668
- * actively-running case; `deadline` settles the rest. `dispatchedAt` stays `now`
4578
+ * handed to the cron. Real invariant (#965): the cron MAY reclaim a row this
4579
+ * runner still holds; a reclaimed row that already ran is never re-dispatched
4580
+ * while opencode reports its turn ongoing (readopt's own gate here, and the
4581
+ * `pending`-row re-drive fence, `resolveRedrive`). `dispatchedAt` stays `now`
3669
4582
  * (only the appear-guard uses it).
3670
4583
  *
3671
4584
  * `evidentMessageId` addresses the SERVER row (for markProcessing/markDone);
@@ -4225,7 +5138,10 @@ var ChannelDriver = class _ChannelDriver {
4225
5138
  * re-dispatched (at most once, see `forceReadoptRun`):
4226
5139
  * - `done` → `markDone` now (guarded like the watcher's done branch);
4227
5140
  * - `failed` → `markFailed` with the surfaced error (issue #182), so an
4228
- * errored turn is reported failed on restart, NOT re-dispatched;
5141
+ * errored turn is reported failed on restart, NOT re-dispatched
5142
+ * EXCEPT a restart-ABORTED turn under a not-ongoing session,
5143
+ * which is a restart orphan wearing a terminal error and is
5144
+ * re-dispatched instead (issue #1310, see the branch below);
4229
5145
  * - `running`/`queued` → re-attach a watcher via `registerReadopted` (no re-dispatch),
4230
5146
  * tracking the stored id so the reply correlates by it;
4231
5147
  * - `unknown`/null id → re-dispatch (opencode assigns a fresh id) + attach a watcher.
@@ -4289,7 +5205,16 @@ var ChannelDriver = class _ChannelDriver {
4289
5205
  void this.postSignal(row.conversation_id, row.id, "readopt_done");
4290
5206
  return;
4291
5207
  }
4292
- if (state === "failed") {
5208
+ const restartAborted = state === "failed" && sessionOngoing === false && isAbortedTerminalReply(messages, ocId ?? "");
5209
+ if (restartAborted) {
5210
+ this.log({
5211
+ level: "info",
5212
+ message: `Re-adopt: message ${row.id.slice(0, 8)} carries an abort-shaped terminal error and session ${sessionId.slice(0, 8)} is not-ongoing per GET /session/status \u2014 restart orphan, re-dispatching instead of marking it permanently failed`,
5213
+ conversation_id: row.conversation_id,
5214
+ message_id: row.id
5215
+ });
5216
+ }
5217
+ if (state === "failed" && !restartAborted) {
4293
5218
  const error2 = messageError(messages, ocId ?? "") ?? void 0;
4294
5219
  const usage = messageUsage(messages, ocId ?? "");
4295
5220
  const failure = await this.classifyModelAuthFailure(messages, ocId ?? "");
@@ -4503,15 +5428,39 @@ var ChannelDriver = class _ChannelDriver {
4503
5428
  }
4504
5429
  if (ocId === null) {
4505
5430
  this.awaitingReadopt.delete(row.id);
5431
+ const streak = this.recordUnconfirmedDispatch(row.id, sessionId);
5432
+ if (streak >= MAX_IDENTICAL_REDRIVE_POLL_FAILURES) {
5433
+ this.unconfirmedDispatchFailures.delete(row.id);
5434
+ this.sessions.delete(readoptConv.id);
5435
+ this.supersede(readoptConv.id, sessionId);
5436
+ const errorMessage = `OpenCode accepted this re-dispatched message ${streak} times in a row but never confirmed its assigned id (session ${sessionId.slice(0, 8)}'s message list could not be read back) \u2014 the session was abandoned; a fresh one is used for further messages.`;
5437
+ this.log({
5438
+ level: "error",
5439
+ message: errorMessage,
5440
+ conversation_id: row.conversation_id,
5441
+ message_id: row.id
5442
+ });
5443
+ await this.markFailed(row.conversation_id, row.id, null, errorMessage).catch((markErr) => {
5444
+ this.log({
5445
+ level: "warn",
5446
+ message: `markFailed PATCH for message ${row.id.slice(0, 8)} (conversation ${row.conversation_id.slice(0, 8)}) failed (best-effort, not retried): ${markErr instanceof Error ? markErr.message : String(markErr)}`,
5447
+ conversation_id: row.conversation_id,
5448
+ message_id: row.id
5449
+ });
5450
+ });
5451
+ void this.postSignal(row.conversation_id, row.id, "readopt_orphan_unsent");
5452
+ return;
5453
+ }
4506
5454
  this.log({
4507
5455
  level: "warn",
4508
- message: `Re-adopt: message ${row.id.slice(0, 8)} re-dispatched but its opencode id could not be read back \u2014 leaving un-tracked to retry next drain`,
5456
+ message: `Re-adopt: message ${row.id.slice(0, 8)} re-dispatched but its opencode id could not be read back (${streak}/${MAX_IDENTICAL_REDRIVE_POLL_FAILURES}) \u2014 leaving un-tracked to retry next drain`,
4509
5457
  conversation_id: row.conversation_id,
4510
5458
  message_id: row.id
4511
5459
  });
4512
5460
  void this.postSignal(row.conversation_id, row.id, "readopt_orphan_unsent");
4513
5461
  return;
4514
5462
  }
5463
+ this.unconfirmedDispatchFailures.delete(row.id);
4515
5464
  this.registerReadopted(readoptConv, sessionId, readoptMessage, ocId, this.processedAtMs(row));
4516
5465
  this.dispatched.add(row.id);
4517
5466
  this.readopted.add(row.id);
@@ -4567,7 +5516,8 @@ var ChannelDriver = class _ChannelDriver {
4567
5516
  opencode_model: row.opencode_model,
4568
5517
  source_message_id: row.source_message_id,
4569
5518
  slack_user_id: row.slack_user_id,
4570
- attachments: row.attachments ?? null
5519
+ attachments: row.attachments ?? null,
5520
+ opencode_message_id: row.opencode_message_id
4571
5521
  };
4572
5522
  }
4573
5523
  /**
@@ -5159,11 +6109,11 @@ var ChannelDriver = class _ChannelDriver {
5159
6109
  * `ensureSession` guard, not this suppression, is what makes the self-heal
5160
6110
  * stick.
5161
6111
  */
5162
- sessionIdBody(sessionId, conversationId, messageId, status) {
6112
+ sessionIdBody(sessionId, conversationId, messageId, status2) {
5163
6113
  if (!this.isSuperseded(conversationId, sessionId)) return { opencode_session_id: sessionId };
5164
6114
  this.log({
5165
6115
  level: "debug",
5166
- message: `Omitting the abandoned OpenCode session ${sessionId.slice(0, 8)} from the '${status}' update for message ${messageId.slice(0, 8)} so it is not re-bound to conversation ${conversationId.slice(0, 8)}`,
6116
+ message: `Omitting the abandoned OpenCode session ${sessionId.slice(0, 8)} from the '${status2}' update for message ${messageId.slice(0, 8)} so it is not re-bound to conversation ${conversationId.slice(0, 8)}`,
5167
6117
  conversation_id: conversationId,
5168
6118
  message_id: messageId
5169
6119
  });
@@ -5177,11 +6127,12 @@ var ChannelDriver = class _ChannelDriver {
5177
6127
  *
5178
6128
  * Return/throw contract (consumed by the watcher's swap-to-running guard):
5179
6129
  * - returns `true` → the server transitioned the row to processing;
5180
- * - returns `false` → the server gave a DEFINITIVE "already-processing"
5181
- * answer (a non-retryable, non-auth status e.g. a
5182
- * conflict because a duplicate already transitioned it),
5183
- * so the caller treats it as already-started and does NOT
5184
- * retry;
6130
+ * - returns `false` → the server DEFINITIVELY refused to transition the row
6131
+ * (a non-retryable, non-auth status: 404 the row or its
6132
+ * conversation is gone, 400 the update was rejected).
6133
+ * Retrying cannot help. NOTE this is never an
6134
+ * "already-processing" answer — that case transitions
6135
+ * nothing but still returns 200, hence `true`;
5185
6136
  * - throws `ChannelAuthError` on 401/403 (terminal auth failure);
5186
6137
  * - throws on a TRANSIENT failure (retryable 5xx/429 status, or a
5187
6138
  * network-level error from `fetch`) — i.e. NO definitive server response —
@@ -5609,171 +6560,6 @@ Port ${port} is already in use.`));
5609
6560
  return { port, process: null, version: null, notReadyReason: "you chose to continue without it" };
5610
6561
  }
5611
6562
 
5612
- // src/commands/agent-lookup.ts
5613
- async function readErrorMessage(response) {
5614
- const text = await response.text().catch(() => "");
5615
- if (!text) return response.statusText || void 0;
5616
- try {
5617
- const data = JSON.parse(text);
5618
- const message = data.message ?? data.error;
5619
- if (typeof message === "string" && message.trim()) {
5620
- return message;
5621
- }
5622
- } catch {
5623
- }
5624
- return text.trim() || response.statusText || void 0;
5625
- }
5626
- function authFailureHint(apiUrl, serverMessage) {
5627
- const reason = serverMessage ? `: ${serverMessage}` : "";
5628
- return `Authentication failed${reason}. Your credentials were rejected by ${apiUrl}. This usually means you logged in against a different environment, or your session expired \u2014 log in again pointing at this endpoint and retry.`;
5629
- }
5630
- async function resolveAgentIdFromKey(authHeader) {
5631
- const apiUrl = getApiUrlConfig();
5632
- try {
5633
- const response = await fetch(`${apiUrl}/me`, {
5634
- headers: { Authorization: authHeader }
5635
- });
5636
- if (response.status === 401) {
5637
- const serverMessage = await readErrorMessage(response);
5638
- return { error: authFailureHint(apiUrl, serverMessage), authFailed: true };
5639
- }
5640
- if (!response.ok) {
5641
- const serverMessage = await readErrorMessage(response);
5642
- return {
5643
- error: `Failed to resolve runner from key (HTTP ${response.status})${serverMessage ? `: ${serverMessage}` : ""}`
5644
- };
5645
- }
5646
- const data = await response.json();
5647
- if (data.auth_type === "agent_key" && data.agent_id) {
5648
- return { agent_id: data.agent_id };
5649
- }
5650
- return {
5651
- error: "Cannot resolve runner ID: auth type is not agent_key. Please provide --runner explicitly."
5652
- };
5653
- } catch (error2) {
5654
- const message = error2 instanceof Error ? error2.message : "Unknown error";
5655
- return { error: `Failed to resolve runner from key: ${message}` };
5656
- }
5657
- }
5658
- var BEST_EFFORT_NOTIFY_TIMEOUT_MS = 2e3;
5659
- async function notifyAgentDisconnected(agentId, authHeader) {
5660
- const apiUrl = getApiUrlConfig();
5661
- try {
5662
- const response = await fetch(`${apiUrl}/runners/${agentId}/disconnect`, {
5663
- method: "POST",
5664
- headers: { Authorization: authHeader },
5665
- signal: AbortSignal.timeout(BEST_EFFORT_NOTIFY_TIMEOUT_MS)
5666
- });
5667
- if (!response.ok) {
5668
- const serverMessage = await readErrorMessage(response);
5669
- return {
5670
- ok: false,
5671
- error: `HTTP ${response.status}${serverMessage ? `: ${serverMessage}` : ""}`
5672
- };
5673
- }
5674
- return { ok: true };
5675
- } catch (error2) {
5676
- return { ok: false, error: describeBestEffortError(error2) };
5677
- }
5678
- }
5679
- function describeBestEffortError(error2) {
5680
- const name = error2?.name;
5681
- if (name === "TimeoutError" || name === "AbortError") {
5682
- return `timed out after ${BEST_EFFORT_NOTIFY_TIMEOUT_MS}ms`;
5683
- }
5684
- return error2 instanceof Error ? error2.message : String(error2);
5685
- }
5686
- async function reportMicrovmId(agentId, authHeader, microvmId) {
5687
- try {
5688
- const apiUrl = getApiUrlConfig();
5689
- const response = await fetch(`${apiUrl}/runners/${agentId}/microvm`, {
5690
- method: "POST",
5691
- headers: { Authorization: authHeader, "Content-Type": "application/json" },
5692
- body: JSON.stringify({ microvm_id: microvmId }),
5693
- signal: AbortSignal.timeout(BEST_EFFORT_NOTIFY_TIMEOUT_MS)
5694
- });
5695
- if (!response.ok) {
5696
- const serverMessage = await readErrorMessage(response);
5697
- return {
5698
- ok: false,
5699
- error: `HTTP ${response.status}${serverMessage ? `: ${serverMessage}` : ""}`
5700
- };
5701
- }
5702
- return { ok: true };
5703
- } catch (error2) {
5704
- return { ok: false, error: describeBestEffortError(error2) };
5705
- }
5706
- }
5707
- function toReportedWindow(window) {
5708
- if (!window) return null;
5709
- return { utilization: window.utilization, resets_at: window.resetsAt };
5710
- }
5711
- async function reportClaudeUsage(agentId, authHeader, snapshot) {
5712
- try {
5713
- const apiUrl = getApiUrlConfig();
5714
- const response = await fetch(`${apiUrl}/runners/${agentId}/claude-usage`, {
5715
- method: "POST",
5716
- headers: { Authorization: authHeader, "Content-Type": "application/json" },
5717
- body: JSON.stringify({
5718
- five_hour: toReportedWindow(snapshot.fiveHour),
5719
- seven_day: toReportedWindow(snapshot.sevenDay)
5720
- }),
5721
- signal: AbortSignal.timeout(BEST_EFFORT_NOTIFY_TIMEOUT_MS)
5722
- });
5723
- if (!response.ok) {
5724
- const serverMessage = await readErrorMessage(response);
5725
- return {
5726
- ok: false,
5727
- error: `HTTP ${response.status}${serverMessage ? `: ${serverMessage}` : ""}`
5728
- };
5729
- }
5730
- return { ok: true };
5731
- } catch (error2) {
5732
- return { ok: false, error: describeBestEffortError(error2) };
5733
- }
5734
- }
5735
- async function getAgentInfo(agentId, authHeader) {
5736
- const apiUrl = getApiUrlConfig();
5737
- try {
5738
- const response = await fetch(`${apiUrl}/runners/${agentId}`, {
5739
- headers: { Authorization: authHeader }
5740
- });
5741
- if (response.status === 401) {
5742
- const serverMessage = await readErrorMessage(response);
5743
- return { valid: false, error: authFailureHint(apiUrl, serverMessage), authFailed: true };
5744
- }
5745
- if (response.status === 403) {
5746
- const serverMessage = await readErrorMessage(response);
5747
- return {
5748
- valid: false,
5749
- error: serverMessage ?? "You do not have access to this runner (it may belong to a different team or organization)."
5750
- };
5751
- }
5752
- if (response.status === 404) {
5753
- const serverMessage = await readErrorMessage(response);
5754
- return { valid: false, error: serverMessage ?? `Runner ${agentId} not found` };
5755
- }
5756
- if (!response.ok) {
5757
- const serverMessage = await readErrorMessage(response);
5758
- return {
5759
- valid: false,
5760
- error: `API error (HTTP ${response.status})${serverMessage ? `: ${serverMessage}` : ""}`
5761
- };
5762
- }
5763
- const agent = await response.json();
5764
- if (agent.agent_type !== "local") {
5765
- return {
5766
- valid: false,
5767
- error: `Runner is type '${agent.agent_type}', must be 'local' for CLI connection`
5768
- };
5769
- }
5770
- return { valid: true, agent };
5771
- } catch (error2) {
5772
- const message = error2 instanceof Error ? error2.message : "Unknown error";
5773
- return { valid: false, error: `Failed to validate runner: ${message}` };
5774
- }
5775
- }
5776
-
5777
6563
  // src/commands/run.ts
5778
6564
  var MAX_ACTIVITY_LOG_ENTRIES = 10;
5779
6565
  var CHANNEL_POLL_INTERVAL_MS = Number(process.env.EVIDENT_CHANNEL_POLL_INTERVAL_MS) || 2e3;
@@ -5984,9 +6770,15 @@ async function handleAuthError(state, error2) {
5984
6770
  }
5985
6771
  async function driveChannels(state, driver) {
5986
6772
  let idlePolls = 0;
6773
+ let idleMs = 0;
6774
+ let consecutiveDrainFailures = 0;
6775
+ let unreachableMs = 0;
5987
6776
  let lastSeenProxiedActivityAt = state.lastProxiedActivityAt;
5988
6777
  let lastSeenAppliedFiles = driver.fileSyncActivity().appliedFiles;
5989
6778
  while (state.running) {
6779
+ const cycleStartedAtMs = performance.now();
6780
+ let idleThisCycle = false;
6781
+ let unreachableThisCycle = false;
5990
6782
  if (state.connection?.reconnecting && state.connection.reconnectPromise) {
5991
6783
  logActivity(state, { type: "info", message: "Waiting for tunnel reconnection..." });
5992
6784
  if (state.interactive) displayStatus(state);
@@ -6001,17 +6793,23 @@ async function driveChannels(state, driver) {
6001
6793
  );
6002
6794
  try {
6003
6795
  const processed = await driver.drainPending();
6796
+ consecutiveDrainFailures = 0;
6797
+ unreachableMs = 0;
6004
6798
  state.messageCount += processed;
6005
6799
  const proxiedActivity = state.lastProxiedActivityAt !== lastSeenProxiedActivityAt;
6006
6800
  lastSeenProxiedActivityAt = state.lastProxiedActivityAt;
6007
6801
  const appliedFiles = driver.fileSyncActivity().appliedFiles;
6008
- const fileActivity = carriedOverFileSync || appliedFiles !== lastSeenAppliedFiles;
6802
+ const filesApplied = appliedFiles !== lastSeenAppliedFiles;
6803
+ const fileActivity = carriedOverFileSync || filesApplied;
6009
6804
  lastSeenAppliedFiles = appliedFiles;
6805
+ if (filesApplied) state.claudeUsageRearm?.();
6010
6806
  if (processed > 0 || driver.hasInFlightWatchers() || proxiedActivity || fileActivity) {
6011
6807
  idlePolls = 0;
6808
+ idleMs = 0;
6012
6809
  if (processed > 0 && state.interactive) displayStatus(state);
6013
6810
  } else if (state.idleTimeout !== null) {
6014
6811
  idlePolls++;
6812
+ idleThisCycle = true;
6015
6813
  if (idlePolls === 1) {
6016
6814
  logActivity(state, {
6017
6815
  type: "info",
@@ -6035,15 +6833,38 @@ async function driveChannels(state, driver) {
6035
6833
  const errorMessage = error2 instanceof Error ? error2.message : String(error2);
6036
6834
  logActivity(state, { type: "error", error: `Channel processing error: ${errorMessage}` });
6037
6835
  if (state.interactive) displayStatus(state);
6836
+ if (driver.hasInFlightWatchers()) {
6837
+ consecutiveDrainFailures = 0;
6838
+ unreachableMs = 0;
6839
+ } else if (state.idleTimeout !== null) {
6840
+ consecutiveDrainFailures++;
6841
+ unreachableThisCycle = true;
6842
+ if (consecutiveDrainFailures === 1) {
6843
+ logActivity(state, {
6844
+ type: "info",
6845
+ message: `Cannot reach Evident, will exit if this persists past the idle timeout (timeout: ${state.idleTimeout}s)...`
6846
+ });
6847
+ if (state.interactive) displayStatus(state);
6848
+ }
6849
+ }
6038
6850
  }
6039
6851
  await new Promise((resolve3) => setTimeout(resolve3, CHANNEL_POLL_INTERVAL_MS));
6040
- if (state.idleTimeout !== null && idlePolls >= 2) {
6041
- const idleMs = idlePolls * CHANNEL_POLL_INTERVAL_MS;
6042
- if (idleMs > state.idleTimeout * 1e3) {
6043
- logActivity(state, { type: "info", message: "Idle timeout reached" });
6044
- if (state.interactive) displayStatus(state);
6045
- break;
6046
- }
6852
+ const cycleMs = performance.now() - cycleStartedAtMs;
6853
+ if (idleThisCycle) idleMs += cycleMs;
6854
+ if (unreachableThisCycle) unreachableMs += cycleMs;
6855
+ if (state.idleTimeout !== null && consecutiveDrainFailures >= 2 && unreachableMs > state.idleTimeout * 1e3) {
6856
+ logActivity(state, {
6857
+ type: "info",
6858
+ level: "warn",
6859
+ message: `Exiting: could not reach Evident for ${consecutiveDrainFailures} consecutive polls (${Math.round(unreachableMs / 1e3)}s)`
6860
+ });
6861
+ if (state.interactive) displayStatus(state);
6862
+ break;
6863
+ }
6864
+ if (state.idleTimeout !== null && idlePolls >= 2 && idleMs > state.idleTimeout * 1e3) {
6865
+ logActivity(state, { type: "info", message: "Idle timeout reached" });
6866
+ if (state.interactive) displayStatus(state);
6867
+ break;
6047
6868
  }
6048
6869
  }
6049
6870
  }
@@ -6122,6 +6943,9 @@ function scheduleSessionCleanup(state, driver, options) {
6122
6943
  );
6123
6944
  state.sessionCleanupTimers.push(interval, firstSweep);
6124
6945
  }
6946
+ function claudeUsageFailureStreakSuffix(consecutiveFailures) {
6947
+ return consecutiveFailures > 1 ? ` (${consecutiveFailures} consecutive failures)` : "";
6948
+ }
6125
6949
  function scheduleClaudeUsageReporting(state, options) {
6126
6950
  const { mode, warnings } = resolveClaudeUsageReportingMode(
6127
6951
  options.claudeUsageReporting,
@@ -6140,13 +6964,26 @@ function scheduleClaudeUsageReporting(state, options) {
6140
6964
  level: "debug",
6141
6965
  message: "Claude usage reporting is off (--claude-usage-reporting off)"
6142
6966
  });
6143
- return;
6967
+ return null;
6144
6968
  }
6145
6969
  let consecutiveFailures = 0;
6970
+ let armed = false;
6971
+ let rearmRequested = false;
6146
6972
  const scheduleNextTick = () => {
6973
+ armed = true;
6974
+ rearmRequested = false;
6147
6975
  state.claudeUsageTimer = setTimeout(() => void tick(false), nextReportDelayMs());
6148
6976
  };
6149
- const tick = async (isFirst) => {
6977
+ const rearm = () => {
6978
+ if (armed) {
6979
+ rearmRequested = true;
6980
+ return;
6981
+ }
6982
+ rearmRequested = false;
6983
+ armed = true;
6984
+ state.claudeUsageTimer = setTimeout(() => void tick(true), FIRST_REPORT_DELAY_MS);
6985
+ };
6986
+ const tick = async (isProbe) => {
6150
6987
  try {
6151
6988
  const usage = await getClaudeUsage();
6152
6989
  const result = await reportClaudeUsage(state.agentId, state.authHeader, usage);
@@ -6168,8 +7005,8 @@ function scheduleClaudeUsageReporting(state, options) {
6168
7005
  consecutiveFailures++;
6169
7006
  logActivity(state, {
6170
7007
  type: "info",
6171
- level: consecutiveFailures === 1 ? "warn" : "debug",
6172
- message: `Failed to report Claude usage: ${result.error}`
7008
+ level: claudeUsageFailureLogLevel(consecutiveFailures),
7009
+ message: `Failed to report Claude usage: ${result.error}${claudeUsageFailureStreakSuffix(consecutiveFailures)}`
6173
7010
  });
6174
7011
  }
6175
7012
  scheduleNextTick();
@@ -6182,12 +7019,14 @@ function scheduleClaudeUsageReporting(state, options) {
6182
7019
  message: "Claude usage reporting is forced on but no usable Claude Code login was found \u2014 run `claude` to sign in; reporting will keep retrying"
6183
7020
  });
6184
7021
  scheduleNextTick();
6185
- } else if (isFirst) {
7022
+ } else if (isProbe) {
6186
7023
  logActivity(state, {
6187
7024
  type: "info",
6188
7025
  level: "debug",
6189
7026
  message: `Claude usage reporting: ${error2.message}`
6190
7027
  });
7028
+ armed = false;
7029
+ if (rearmRequested) rearm();
6191
7030
  } else {
6192
7031
  logActivity(state, {
6193
7032
  type: "info",
@@ -6201,14 +7040,16 @@ function scheduleClaudeUsageReporting(state, options) {
6201
7040
  const message = error2 instanceof Error ? error2.message : String(error2);
6202
7041
  logActivity(state, {
6203
7042
  type: "info",
6204
- level: consecutiveFailures === 1 ? "warn" : "debug",
6205
- message: `Claude usage reporting failed: ${message}`
7043
+ level: claudeUsageFailureLogLevel(consecutiveFailures),
7044
+ message: `Claude usage reporting failed: ${message}${claudeUsageFailureStreakSuffix(consecutiveFailures)}`
6206
7045
  });
6207
7046
  scheduleNextTick();
6208
7047
  }
6209
7048
  }
6210
7049
  };
7050
+ armed = true;
6211
7051
  state.claudeUsageTimer = setTimeout(() => void tick(true), FIRST_REPORT_DELAY_MS);
7052
+ return rearm;
6212
7053
  }
6213
7054
  async function notifyOffline(state) {
6214
7055
  if (!state.agentId || !state.authHeader) return;
@@ -6249,6 +7090,7 @@ async function cleanup(state, opts = {}) {
6249
7090
  clearTimeout(state.claudeUsageTimer);
6250
7091
  state.claudeUsageTimer = null;
6251
7092
  }
7093
+ state.claudeUsageRearm = null;
6252
7094
  if (opts.graceful && state.channelDriver) {
6253
7095
  state.channelDriver.stop();
6254
7096
  log2(state, "Draining in-flight channel work before shutdown...");
@@ -6330,6 +7172,7 @@ async function run(options) {
6330
7172
  lastProxiedActivityAt: null,
6331
7173
  sessionCleanupTimers: [],
6332
7174
  claudeUsageTimer: null,
7175
+ claudeUsageRearm: null,
6333
7176
  authHeader: ""
6334
7177
  };
6335
7178
  setTelemetryAuthProvider(() => ({ authHeader: state.authHeader, agentId: state.agentId }));
@@ -6409,6 +7252,7 @@ async function run(options) {
6409
7252
  console.log(chalk6.dim("Or run `evident login` for interactive authentication"));
6410
7253
  blank();
6411
7254
  process.exit(1);
7255
+ return;
6412
7256
  }
6413
7257
  blank();
6414
7258
  console.log(chalk6.yellow("You are not logged in to Evident."));
@@ -6453,6 +7297,7 @@ async function run(options) {
6453
7297
  } else {
6454
7298
  printError(resolved.error || "Failed to resolve runner ID from key");
6455
7299
  process.exit(1);
7300
+ return;
6456
7301
  }
6457
7302
  } else {
6458
7303
  printError(
@@ -6466,6 +7311,7 @@ async function run(options) {
6466
7311
  );
6467
7312
  blank();
6468
7313
  process.exit(1);
7314
+ return;
6469
7315
  }
6470
7316
  }
6471
7317
  telemetry.info(
@@ -6713,7 +7559,7 @@ async function run(options) {
6713
7559
  throw error2;
6714
7560
  }
6715
7561
  scheduleSessionCleanup(state, channelDriver, options);
6716
- scheduleClaudeUsageReporting(state, options);
7562
+ state.claudeUsageRearm = scheduleClaudeUsageReporting(state, options);
6717
7563
  if (!interactive || state.json) {
6718
7564
  log2(state, "Driving channel messages...");
6719
7565
  }
@@ -6768,6 +7614,7 @@ program.name("evident").description("Run OpenCode locally and connect it to Evid
6768
7614
  program.command("login").description("Authenticate with Evident").option("--token", "Use token-based authentication (for CI/CD)").option("--no-browser", "Do not open the browser automatically").action(login);
6769
7615
  program.command("logout").description("Remove stored credentials for the current endpoint").option("--all", "Remove stored credentials for all endpoints").action((options) => logout({ all: options.all }));
6770
7616
  program.command("whoami").description("Show the currently logged in user").action(whoami);
7617
+ program.command("status").description("Check whether the configured credentials can reach Evident").option("--json", "Output in JSON format").action((options) => status({ json: options.json }));
6771
7618
  program.command("claude-usage").description("[spike] Show Claude subscription usage (requires a local `claude login`)").action(claudeUsage);
6772
7619
  program.command("run").description("Connect to Evident and process messages").option("--runner [id]", "Runner ID to connect to (optional when EVIDENT_RUNNER_KEY is set)").option(
6773
7620
  "-a, --agent [id]",
@@ -6797,7 +7644,7 @@ program.command("run").description("Connect to Evident and process messages").op
6797
7644
  []
6798
7645
  ).option(
6799
7646
  "--tunnel-ready-file <path>",
6800
- "Path to write once the tunnel is connected (set by the MicroVM hooks; unused on a developer machine)"
7647
+ "Path to write once the tunnel is connected (opt-in; unused unless an operator/image sets it)"
6801
7648
  ).action(
6802
7649
  (options) => {
6803
7650
  run({