@evident-ai/cli 3.1.1-dev.0ff9c93 → 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
@@ -38,11 +38,6 @@ function getApiUrl() {
38
38
  function getTunnelUrl() {
39
39
  return tunnelOverride ?? process.env.EVIDENT_TUNNEL_URL ?? defaults.tunnelUrl;
40
40
  }
41
- var config = new Conf({
42
- projectName: "evident",
43
- projectSuffix: "",
44
- defaults
45
- });
46
41
  var credentials = new Conf({
47
42
  projectName: "evident",
48
43
  projectSuffix: "",
@@ -537,6 +532,353 @@ async function whoami() {
537
532
  blank();
538
533
  }
539
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
+
540
882
  // src/lib/claude-usage.ts
541
883
  import { execFileSync } from "child_process";
542
884
  import { readFileSync } from "fs";
@@ -587,6 +929,10 @@ var ClaudeUsageError = class extends Error {
587
929
  function isLocalCredentialProblem(err) {
588
930
  return err instanceof ClaudeUsageError && (err.reason === "no_credentials" || err.reason === "credentials_expired");
589
931
  }
932
+ function normalizeResetsAt(value) {
933
+ const ms = Date.parse(value);
934
+ return Number.isNaN(ms) ? null : new Date(ms).toISOString();
935
+ }
590
936
  function toWindow(value) {
591
937
  if (!value || typeof value !== "object") {
592
938
  return null;
@@ -595,7 +941,11 @@ function toWindow(value) {
595
941
  if (typeof window.utilization !== "number" || typeof window.resets_at !== "string") {
596
942
  return null;
597
943
  }
598
- 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 };
599
949
  }
600
950
  async function getClaudeUsage() {
601
951
  const credentials2 = readClaudeCliCredentials();
@@ -657,6 +1007,9 @@ import { homedir as homedir3 } from "os";
657
1007
  import { isAbsolute as isAbsolute2, join as join3, parse, resolve as resolvePath } from "path";
658
1008
  import chalk6 from "chalk";
659
1009
 
1010
+ // ../../packages/types/src/agents/index.ts
1011
+ var MICROVM_MAX_LIFETIME_MS = 8 * 60 * 6e4;
1012
+
660
1013
  // ../../packages/types/src/telemetry/index.ts
661
1014
  var TelemetryEventTypes = {
662
1015
  // Agent activity events (shown in web UI activity log)
@@ -939,49 +1292,6 @@ function forwardRunnerActivity(entry, context) {
939
1292
  }
940
1293
  }
941
1294
 
942
- // src/lib/auth.ts
943
- async function getAuthCredentials() {
944
- const runnerKey = process.env.EVIDENT_RUNNER_KEY;
945
- const agentKey = process.env.EVIDENT_AGENT_KEY;
946
- if (runnerKey) {
947
- return {
948
- token: runnerKey,
949
- authType: "agent_key",
950
- keySource: "runner_key",
951
- notice: agentKey ? "Both EVIDENT_RUNNER_KEY and EVIDENT_AGENT_KEY are set; using EVIDENT_RUNNER_KEY." : void 0
952
- };
953
- }
954
- if (agentKey) {
955
- return { token: agentKey, authType: "agent_key", keySource: "agent_key" };
956
- }
957
- const userToken = process.env.EVIDENT_TOKEN;
958
- if (userToken) {
959
- return { token: userToken, authType: "bearer" };
960
- }
961
- const keychainCreds = await getToken();
962
- if (keychainCreds) {
963
- return {
964
- token: keychainCreds.token,
965
- authType: "bearer",
966
- user: keychainCreds.user
967
- };
968
- }
969
- return null;
970
- }
971
- function getAuthHeader(credentials2) {
972
- if (credentials2.authType === "agent_key") {
973
- return `SandboxKey ${credentials2.token}`;
974
- }
975
- return `Bearer ${credentials2.token}`;
976
- }
977
- function isInteractive(jsonOutput) {
978
- if (jsonOutput) return false;
979
- if (process.env.CI) return false;
980
- if (process.env.GITHUB_ACTIONS) return false;
981
- if (!process.stdin.isTTY) return false;
982
- return true;
983
- }
984
-
985
1295
  // src/lib/opencode/health.ts
986
1296
  async function checkOpenCodeHealth(port) {
987
1297
  try {
@@ -1789,6 +2099,21 @@ function messageError(messages, userMessageId) {
1789
2099
  }
1790
2100
  return "The agent run failed.";
1791
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
+ }
1792
2117
  function messageFailure(messages, userMessageId) {
1793
2118
  const reply = findLastAssistantReplyFor(messages, userMessageId);
1794
2119
  const error2 = errorOf(reply);
@@ -2391,6 +2716,10 @@ function nextReportDelayMs(random = Math.random) {
2391
2716
  return BASE_REPORT_DELAY_MS - jitterRangeMs + random() * (2 * jitterRangeMs);
2392
2717
  }
2393
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
+ }
2394
2723
 
2395
2724
  // src/lib/channels/driver.ts
2396
2725
  import { homedir as homedir2 } from "os";
@@ -2713,8 +3042,8 @@ async function applyOne(options, file) {
2713
3042
  await ack(options, file, "applied");
2714
3043
  return true;
2715
3044
  }
2716
- function durableDownloadCode(status) {
2717
- return status === 413 ? "file_too_large" : "write_failed";
3045
+ function durableDownloadCode(status2) {
3046
+ return status2 === 413 ? "file_too_large" : "write_failed";
2718
3047
  }
2719
3048
  async function downloadContent(options, file, label) {
2720
3049
  try {
@@ -2747,8 +3076,8 @@ async function downloadContent(options, file, label) {
2747
3076
  return { ok: false, terminal: false };
2748
3077
  }
2749
3078
  }
2750
- async function ack(options, file, status, reason) {
2751
- const outcome = `${status}${reason ? ` (${reason})` : ""}`;
3079
+ async function ack(options, file, status2, reason) {
3080
+ const outcome = `${status2}${reason ? ` (${reason})` : ""}`;
2752
3081
  try {
2753
3082
  const res = await options.fetchImpl(
2754
3083
  `${options.apiUrl}/runners/${options.agentId}/files/${file.id}/ack`,
@@ -2758,7 +3087,7 @@ async function ack(options, file, status, reason) {
2758
3087
  Authorization: options.getAuthHeader(),
2759
3088
  "Content-Type": "application/json"
2760
3089
  },
2761
- body: JSON.stringify(reason ? { status, reason } : { status })
3090
+ body: JSON.stringify(reason ? { status: status2, reason } : { status: status2 })
2762
3091
  }
2763
3092
  );
2764
3093
  if (!res.ok) {
@@ -2822,6 +3151,7 @@ var B2_ABANDONMENT_MIN_PINNED_MS = 3 * 6e4;
2822
3151
  var B2_ABANDONMENT_RECHECK_MS = HEARTBEAT_MS;
2823
3152
  var POLL_MISS_GRACE_MS = HEARTBEAT_MS;
2824
3153
  var MAX_SUPERSEDED_CONVERSATIONS = 256;
3154
+ var MAX_IDENTICAL_REDRIVE_POLL_FAILURES = 5;
2825
3155
  var ChannelAuthError = class extends Error {
2826
3156
  constructor(message) {
2827
3157
  super(message);
@@ -2830,10 +3160,10 @@ var ChannelAuthError = class extends Error {
2830
3160
  };
2831
3161
  var ChannelTerminalError = class extends Error {
2832
3162
  status;
2833
- constructor(message, status) {
3163
+ constructor(message, status2) {
2834
3164
  super(message);
2835
3165
  this.name = "ChannelTerminalError";
2836
- this.status = status;
3166
+ this.status = status2;
2837
3167
  }
2838
3168
  };
2839
3169
  function backoffDelay(attempt, policy) {
@@ -2841,8 +3171,12 @@ function backoffDelay(attempt, policy) {
2841
3171
  const capped = Math.min(policy.maxDelayMs, exp);
2842
3172
  return Math.floor(Math.random() * capped);
2843
3173
  }
2844
- function isRetryableStatus(status) {
2845
- 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);
2846
3180
  }
2847
3181
  var ChannelDriver = class _ChannelDriver {
2848
3182
  agentId;
@@ -2957,6 +3291,84 @@ var ChannelDriver = class _ChannelDriver {
2957
3291
  * processing list, exactly like `dontRedispatch`/`doneUndeliverable`.
2958
3292
  */
2959
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();
2960
3372
  /**
2961
3373
  * "A null-id re-adopt re-dispatch is in flight, awaiting its read-back" (WI-5
2962
3374
  * Task 5.4, High-2). Since we no longer send a caller-supplied id, a re-dispatch
@@ -3045,23 +3457,23 @@ var ChannelDriver = class _ChannelDriver {
3045
3457
  * and stops opencode.
3046
3458
  */
3047
3459
  stopped = false;
3048
- constructor(config2) {
3049
- this.agentId = config2.agentId;
3050
- this.port = config2.port;
3051
- this.apiUrl = config2.apiUrl.replace(/\/$/, "");
3052
- this.getAuthHeader = config2.getAuthHeader;
3053
- this.conversationFilter = config2.conversationFilter ?? null;
3054
- this.retry = { ...DEFAULT_RETRY_POLICY, ...config2.retry };
3055
- this.log = config2.log ?? (() => {
3460
+ constructor(config) {
3461
+ this.agentId = config.agentId;
3462
+ this.port = config.port;
3463
+ this.apiUrl = config.apiUrl.replace(/\/$/, "");
3464
+ this.getAuthHeader = config.getAuthHeader;
3465
+ this.conversationFilter = config.conversationFilter ?? null;
3466
+ this.retry = { ...DEFAULT_RETRY_POLICY, ...config.retry };
3467
+ this.log = config.log ?? (() => {
3056
3468
  });
3057
- this.fetchImpl = config2.fetchImpl ?? fetch;
3058
- this.sleep = config2.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
3059
- this.pausedPollIntervalMs = config2.pausedPollIntervalMs ?? DEFAULT_PAUSED_POLL_INTERVAL_MS;
3060
- this.pausedMaxWaitMs = config2.pausedMaxWaitMs ?? DEFAULT_PAUSED_MAX_WAIT_MS;
3061
- this.stuckQueuedMs = config2.stuckQueuedMs ?? DEFAULT_STUCK_QUEUED_MS;
3062
- this.now = config2.now ?? (() => Date.now());
3063
- this.fileSyncDirectories = config2.fileSyncDirectories ?? [];
3064
- this.homeDir = config2.homeDir ?? homedir2();
3469
+ this.fetchImpl = config.fetchImpl ?? fetch;
3470
+ this.sleep = config.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
3471
+ this.pausedPollIntervalMs = config.pausedPollIntervalMs ?? DEFAULT_PAUSED_POLL_INTERVAL_MS;
3472
+ this.pausedMaxWaitMs = config.pausedMaxWaitMs ?? DEFAULT_PAUSED_MAX_WAIT_MS;
3473
+ this.stuckQueuedMs = config.stuckQueuedMs ?? DEFAULT_STUCK_QUEUED_MS;
3474
+ this.now = config.now ?? (() => Date.now());
3475
+ this.fileSyncDirectories = config.fileSyncDirectories ?? [];
3476
+ this.homeDir = config.homeDir ?? homedir2();
3065
3477
  }
3066
3478
  /** The IPv4-loopback base URL for the local `opencode serve`. */
3067
3479
  get opencodeBase() {
@@ -3281,7 +3693,7 @@ var ChannelDriver = class _ChannelDriver {
3281
3693
  * @returns the count of messages NEWLY dispatched (not already in-flight).
3282
3694
  */
3283
3695
  async processConversation(conv) {
3284
- const { sessionId, refusedSessionId } = await this.ensureSession(conv);
3696
+ const { sessionId, refusedSessionId, created: sessionCreated } = await this.ensureSession(conv);
3285
3697
  const messages = await this.getPendingMessages(conv.id);
3286
3698
  let dispatched = 0;
3287
3699
  let skippedAlreadyDispatched = 0;
@@ -3296,6 +3708,15 @@ var ChannelDriver = class _ChannelDriver {
3296
3708
  skippedAlreadyDispatched += 1;
3297
3709
  continue;
3298
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
+ }
3299
3720
  const options = {
3300
3721
  agent: message.opencode_agent ?? void 0,
3301
3722
  model: message.opencode_model ?? void 0
@@ -3325,6 +3746,7 @@ var ChannelDriver = class _ChannelDriver {
3325
3746
  conversation_id: conv.id,
3326
3747
  message_id: message.id
3327
3748
  });
3749
+ this.signalDispatchNotStarted(conv, message, "session_deleted_race");
3328
3750
  break;
3329
3751
  }
3330
3752
  if (exists === null) {
@@ -3334,6 +3756,7 @@ var ChannelDriver = class _ChannelDriver {
3334
3756
  conversation_id: conv.id,
3335
3757
  message_id: message.id
3336
3758
  });
3759
+ this.signalDispatchNotStarted(conv, message, "session_existence_unknown");
3337
3760
  break;
3338
3761
  }
3339
3762
  const errorMessage = err instanceof Error ? err.message : String(err);
@@ -3352,6 +3775,7 @@ var ChannelDriver = class _ChannelDriver {
3352
3775
  conversation_id: conv.id,
3353
3776
  message_id: message.id
3354
3777
  });
3778
+ this.signalDispatchNotStarted(conv, message, "failure_unreported");
3355
3779
  });
3356
3780
  this.log({
3357
3781
  level: "error",
@@ -3362,14 +3786,40 @@ var ChannelDriver = class _ChannelDriver {
3362
3786
  break;
3363
3787
  }
3364
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.`;
3365
3804
  this.log({
3366
- level: "warn",
3367
- 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,
3368
3807
  conversation_id: conv.id,
3369
3808
  message_id: message.id
3370
3809
  });
3371
- 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;
3372
3820
  }
3821
+ this.unconfirmedDispatchFailures.delete(message.id);
3822
+ this.dispatchNotStartedSignalled.delete(message.id);
3373
3823
  this.dispatched.add(message.id);
3374
3824
  this.registerInFlight(conv, sessionId, message, opencodeMessageId);
3375
3825
  dispatched += 1;
@@ -3378,12 +3828,458 @@ var ChannelDriver = class _ChannelDriver {
3378
3828
  if (messages.length > 0 && dispatched === 0 && skippedAlreadyDispatched === messages.length) {
3379
3829
  this.log({
3380
3830
  level: "warn",
3381
- 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).`,
3382
- 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
3383
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";
3384
4236
  }
3385
- this.ensureWatcherRunning(sessionId);
3386
- 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;
3387
4283
  }
3388
4284
  /**
3389
4285
  * Record that `sessionId` is no longer a valid binding for `conversationId`
@@ -3409,6 +4305,13 @@ var ChannelDriver = class _ChannelDriver {
3409
4305
  * `refusedSessionId` is set when the #553 guard fired — i.e. the persisted
3410
4306
  * binding was an id this runner had abandoned, so a resurrection genuinely
3411
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.
3412
4315
  */
3413
4316
  async ensureSession(conv) {
3414
4317
  const bound = this.sessions.get(conv.id) ?? conv.opencode_session_id ?? null;
@@ -3419,7 +4322,11 @@ var ChannelDriver = class _ChannelDriver {
3419
4322
  conversation_id: conv.id
3420
4323
  });
3421
4324
  this.sessions.delete(conv.id);
3422
- 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
+ };
3423
4330
  }
3424
4331
  if (bound) {
3425
4332
  const exists = await sessionExists(this.port, bound);
@@ -3430,12 +4337,12 @@ var ChannelDriver = class _ChannelDriver {
3430
4337
  conversation_id: conv.id
3431
4338
  });
3432
4339
  this.sessions.delete(conv.id);
3433
- return { sessionId: await this.createAndBindSession(conv.id) };
4340
+ return { sessionId: await this.createAndBindSession(conv.id), created: true };
3434
4341
  }
3435
4342
  this.sessions.set(conv.id, bound);
3436
- return { sessionId: bound };
4343
+ return { sessionId: bound, created: false };
3437
4344
  }
3438
- return { sessionId: await this.createAndBindSession(conv.id) };
4345
+ return { sessionId: await this.createAndBindSession(conv.id), created: true };
3439
4346
  }
3440
4347
  /**
3441
4348
  * Create a fresh OpenCode session for a conversation, cache the binding, and
@@ -3668,9 +4575,10 @@ var ChannelDriver = class _ChannelDriver {
3668
4575
  * opencode reports ACTIVELY `running` is watched to completion (its liveness
3669
4576
  * heartbeat keeps the cron off its row), while a re-adopted turn that is paused
3670
4577
  * awaiting a human — or queued/unreachable — is still bounded by `deadline` and
3671
- * handed to the cron. The old "the `deadline` must settle before the ~15-min
3672
- * cron or they double-drive" reasoning is superseded: liveness now settles the
3673
- * 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`
3674
4582
  * (only the appear-guard uses it).
3675
4583
  *
3676
4584
  * `evidentMessageId` addresses the SERVER row (for markProcessing/markDone);
@@ -4230,7 +5138,10 @@ var ChannelDriver = class _ChannelDriver {
4230
5138
  * re-dispatched (at most once, see `forceReadoptRun`):
4231
5139
  * - `done` → `markDone` now (guarded like the watcher's done branch);
4232
5140
  * - `failed` → `markFailed` with the surfaced error (issue #182), so an
4233
- * 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);
4234
5145
  * - `running`/`queued` → re-attach a watcher via `registerReadopted` (no re-dispatch),
4235
5146
  * tracking the stored id so the reply correlates by it;
4236
5147
  * - `unknown`/null id → re-dispatch (opencode assigns a fresh id) + attach a watcher.
@@ -4294,7 +5205,16 @@ var ChannelDriver = class _ChannelDriver {
4294
5205
  void this.postSignal(row.conversation_id, row.id, "readopt_done");
4295
5206
  return;
4296
5207
  }
4297
- 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) {
4298
5218
  const error2 = messageError(messages, ocId ?? "") ?? void 0;
4299
5219
  const usage = messageUsage(messages, ocId ?? "");
4300
5220
  const failure = await this.classifyModelAuthFailure(messages, ocId ?? "");
@@ -4508,15 +5428,39 @@ var ChannelDriver = class _ChannelDriver {
4508
5428
  }
4509
5429
  if (ocId === null) {
4510
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
+ }
4511
5454
  this.log({
4512
5455
  level: "warn",
4513
- 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`,
4514
5457
  conversation_id: row.conversation_id,
4515
5458
  message_id: row.id
4516
5459
  });
4517
5460
  void this.postSignal(row.conversation_id, row.id, "readopt_orphan_unsent");
4518
5461
  return;
4519
5462
  }
5463
+ this.unconfirmedDispatchFailures.delete(row.id);
4520
5464
  this.registerReadopted(readoptConv, sessionId, readoptMessage, ocId, this.processedAtMs(row));
4521
5465
  this.dispatched.add(row.id);
4522
5466
  this.readopted.add(row.id);
@@ -4572,7 +5516,8 @@ var ChannelDriver = class _ChannelDriver {
4572
5516
  opencode_model: row.opencode_model,
4573
5517
  source_message_id: row.source_message_id,
4574
5518
  slack_user_id: row.slack_user_id,
4575
- attachments: row.attachments ?? null
5519
+ attachments: row.attachments ?? null,
5520
+ opencode_message_id: row.opencode_message_id
4576
5521
  };
4577
5522
  }
4578
5523
  /**
@@ -5164,11 +6109,11 @@ var ChannelDriver = class _ChannelDriver {
5164
6109
  * `ensureSession` guard, not this suppression, is what makes the self-heal
5165
6110
  * stick.
5166
6111
  */
5167
- sessionIdBody(sessionId, conversationId, messageId, status) {
6112
+ sessionIdBody(sessionId, conversationId, messageId, status2) {
5168
6113
  if (!this.isSuperseded(conversationId, sessionId)) return { opencode_session_id: sessionId };
5169
6114
  this.log({
5170
6115
  level: "debug",
5171
- 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)}`,
5172
6117
  conversation_id: conversationId,
5173
6118
  message_id: messageId
5174
6119
  });
@@ -5182,11 +6127,12 @@ var ChannelDriver = class _ChannelDriver {
5182
6127
  *
5183
6128
  * Return/throw contract (consumed by the watcher's swap-to-running guard):
5184
6129
  * - returns `true` → the server transitioned the row to processing;
5185
- * - returns `false` → the server gave a DEFINITIVE "already-processing"
5186
- * answer (a non-retryable, non-auth status e.g. a
5187
- * conflict because a duplicate already transitioned it),
5188
- * so the caller treats it as already-started and does NOT
5189
- * 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`;
5190
6136
  * - throws `ChannelAuthError` on 401/403 (terminal auth failure);
5191
6137
  * - throws on a TRANSIENT failure (retryable 5xx/429 status, or a
5192
6138
  * network-level error from `fetch`) — i.e. NO definitive server response —
@@ -5614,171 +6560,6 @@ Port ${port} is already in use.`));
5614
6560
  return { port, process: null, version: null, notReadyReason: "you chose to continue without it" };
5615
6561
  }
5616
6562
 
5617
- // src/commands/agent-lookup.ts
5618
- async function readErrorMessage(response) {
5619
- const text = await response.text().catch(() => "");
5620
- if (!text) return response.statusText || void 0;
5621
- try {
5622
- const data = JSON.parse(text);
5623
- const message = data.message ?? data.error;
5624
- if (typeof message === "string" && message.trim()) {
5625
- return message;
5626
- }
5627
- } catch {
5628
- }
5629
- return text.trim() || response.statusText || void 0;
5630
- }
5631
- function authFailureHint(apiUrl, serverMessage) {
5632
- const reason = serverMessage ? `: ${serverMessage}` : "";
5633
- 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.`;
5634
- }
5635
- async function resolveAgentIdFromKey(authHeader) {
5636
- const apiUrl = getApiUrlConfig();
5637
- try {
5638
- const response = await fetch(`${apiUrl}/me`, {
5639
- headers: { Authorization: authHeader }
5640
- });
5641
- if (response.status === 401) {
5642
- const serverMessage = await readErrorMessage(response);
5643
- return { error: authFailureHint(apiUrl, serverMessage), authFailed: true };
5644
- }
5645
- if (!response.ok) {
5646
- const serverMessage = await readErrorMessage(response);
5647
- return {
5648
- error: `Failed to resolve runner from key (HTTP ${response.status})${serverMessage ? `: ${serverMessage}` : ""}`
5649
- };
5650
- }
5651
- const data = await response.json();
5652
- if (data.auth_type === "agent_key" && data.agent_id) {
5653
- return { agent_id: data.agent_id };
5654
- }
5655
- return {
5656
- error: "Cannot resolve runner ID: auth type is not agent_key. Please provide --runner explicitly."
5657
- };
5658
- } catch (error2) {
5659
- const message = error2 instanceof Error ? error2.message : "Unknown error";
5660
- return { error: `Failed to resolve runner from key: ${message}` };
5661
- }
5662
- }
5663
- var BEST_EFFORT_NOTIFY_TIMEOUT_MS = 2e3;
5664
- async function notifyAgentDisconnected(agentId, authHeader) {
5665
- const apiUrl = getApiUrlConfig();
5666
- try {
5667
- const response = await fetch(`${apiUrl}/runners/${agentId}/disconnect`, {
5668
- method: "POST",
5669
- headers: { Authorization: authHeader },
5670
- signal: AbortSignal.timeout(BEST_EFFORT_NOTIFY_TIMEOUT_MS)
5671
- });
5672
- if (!response.ok) {
5673
- const serverMessage = await readErrorMessage(response);
5674
- return {
5675
- ok: false,
5676
- error: `HTTP ${response.status}${serverMessage ? `: ${serverMessage}` : ""}`
5677
- };
5678
- }
5679
- return { ok: true };
5680
- } catch (error2) {
5681
- return { ok: false, error: describeBestEffortError(error2) };
5682
- }
5683
- }
5684
- function describeBestEffortError(error2) {
5685
- const name = error2?.name;
5686
- if (name === "TimeoutError" || name === "AbortError") {
5687
- return `timed out after ${BEST_EFFORT_NOTIFY_TIMEOUT_MS}ms`;
5688
- }
5689
- return error2 instanceof Error ? error2.message : String(error2);
5690
- }
5691
- async function reportMicrovmId(agentId, authHeader, microvmId) {
5692
- try {
5693
- const apiUrl = getApiUrlConfig();
5694
- const response = await fetch(`${apiUrl}/runners/${agentId}/microvm`, {
5695
- method: "POST",
5696
- headers: { Authorization: authHeader, "Content-Type": "application/json" },
5697
- body: JSON.stringify({ microvm_id: microvmId }),
5698
- signal: AbortSignal.timeout(BEST_EFFORT_NOTIFY_TIMEOUT_MS)
5699
- });
5700
- if (!response.ok) {
5701
- const serverMessage = await readErrorMessage(response);
5702
- return {
5703
- ok: false,
5704
- error: `HTTP ${response.status}${serverMessage ? `: ${serverMessage}` : ""}`
5705
- };
5706
- }
5707
- return { ok: true };
5708
- } catch (error2) {
5709
- return { ok: false, error: describeBestEffortError(error2) };
5710
- }
5711
- }
5712
- function toReportedWindow(window) {
5713
- if (!window) return null;
5714
- return { utilization: window.utilization, resets_at: window.resetsAt };
5715
- }
5716
- async function reportClaudeUsage(agentId, authHeader, snapshot) {
5717
- try {
5718
- const apiUrl = getApiUrlConfig();
5719
- const response = await fetch(`${apiUrl}/runners/${agentId}/claude-usage`, {
5720
- method: "POST",
5721
- headers: { Authorization: authHeader, "Content-Type": "application/json" },
5722
- body: JSON.stringify({
5723
- five_hour: toReportedWindow(snapshot.fiveHour),
5724
- seven_day: toReportedWindow(snapshot.sevenDay)
5725
- }),
5726
- signal: AbortSignal.timeout(BEST_EFFORT_NOTIFY_TIMEOUT_MS)
5727
- });
5728
- if (!response.ok) {
5729
- const serverMessage = await readErrorMessage(response);
5730
- return {
5731
- ok: false,
5732
- error: `HTTP ${response.status}${serverMessage ? `: ${serverMessage}` : ""}`
5733
- };
5734
- }
5735
- return { ok: true };
5736
- } catch (error2) {
5737
- return { ok: false, error: describeBestEffortError(error2) };
5738
- }
5739
- }
5740
- async function getAgentInfo(agentId, authHeader) {
5741
- const apiUrl = getApiUrlConfig();
5742
- try {
5743
- const response = await fetch(`${apiUrl}/runners/${agentId}`, {
5744
- headers: { Authorization: authHeader }
5745
- });
5746
- if (response.status === 401) {
5747
- const serverMessage = await readErrorMessage(response);
5748
- return { valid: false, error: authFailureHint(apiUrl, serverMessage), authFailed: true };
5749
- }
5750
- if (response.status === 403) {
5751
- const serverMessage = await readErrorMessage(response);
5752
- return {
5753
- valid: false,
5754
- error: serverMessage ?? "You do not have access to this runner (it may belong to a different team or organization)."
5755
- };
5756
- }
5757
- if (response.status === 404) {
5758
- const serverMessage = await readErrorMessage(response);
5759
- return { valid: false, error: serverMessage ?? `Runner ${agentId} not found` };
5760
- }
5761
- if (!response.ok) {
5762
- const serverMessage = await readErrorMessage(response);
5763
- return {
5764
- valid: false,
5765
- error: `API error (HTTP ${response.status})${serverMessage ? `: ${serverMessage}` : ""}`
5766
- };
5767
- }
5768
- const agent = await response.json();
5769
- if (agent.agent_type !== "local") {
5770
- return {
5771
- valid: false,
5772
- error: `Runner is type '${agent.agent_type}', must be 'local' for CLI connection`
5773
- };
5774
- }
5775
- return { valid: true, agent };
5776
- } catch (error2) {
5777
- const message = error2 instanceof Error ? error2.message : "Unknown error";
5778
- return { valid: false, error: `Failed to validate runner: ${message}` };
5779
- }
5780
- }
5781
-
5782
6563
  // src/commands/run.ts
5783
6564
  var MAX_ACTIVITY_LOG_ENTRIES = 10;
5784
6565
  var CHANNEL_POLL_INTERVAL_MS = Number(process.env.EVIDENT_CHANNEL_POLL_INTERVAL_MS) || 2e3;
@@ -5989,9 +6770,15 @@ async function handleAuthError(state, error2) {
5989
6770
  }
5990
6771
  async function driveChannels(state, driver) {
5991
6772
  let idlePolls = 0;
6773
+ let idleMs = 0;
6774
+ let consecutiveDrainFailures = 0;
6775
+ let unreachableMs = 0;
5992
6776
  let lastSeenProxiedActivityAt = state.lastProxiedActivityAt;
5993
6777
  let lastSeenAppliedFiles = driver.fileSyncActivity().appliedFiles;
5994
6778
  while (state.running) {
6779
+ const cycleStartedAtMs = performance.now();
6780
+ let idleThisCycle = false;
6781
+ let unreachableThisCycle = false;
5995
6782
  if (state.connection?.reconnecting && state.connection.reconnectPromise) {
5996
6783
  logActivity(state, { type: "info", message: "Waiting for tunnel reconnection..." });
5997
6784
  if (state.interactive) displayStatus(state);
@@ -6006,17 +6793,23 @@ async function driveChannels(state, driver) {
6006
6793
  );
6007
6794
  try {
6008
6795
  const processed = await driver.drainPending();
6796
+ consecutiveDrainFailures = 0;
6797
+ unreachableMs = 0;
6009
6798
  state.messageCount += processed;
6010
6799
  const proxiedActivity = state.lastProxiedActivityAt !== lastSeenProxiedActivityAt;
6011
6800
  lastSeenProxiedActivityAt = state.lastProxiedActivityAt;
6012
6801
  const appliedFiles = driver.fileSyncActivity().appliedFiles;
6013
- const fileActivity = carriedOverFileSync || appliedFiles !== lastSeenAppliedFiles;
6802
+ const filesApplied = appliedFiles !== lastSeenAppliedFiles;
6803
+ const fileActivity = carriedOverFileSync || filesApplied;
6014
6804
  lastSeenAppliedFiles = appliedFiles;
6805
+ if (filesApplied) state.claudeUsageRearm?.();
6015
6806
  if (processed > 0 || driver.hasInFlightWatchers() || proxiedActivity || fileActivity) {
6016
6807
  idlePolls = 0;
6808
+ idleMs = 0;
6017
6809
  if (processed > 0 && state.interactive) displayStatus(state);
6018
6810
  } else if (state.idleTimeout !== null) {
6019
6811
  idlePolls++;
6812
+ idleThisCycle = true;
6020
6813
  if (idlePolls === 1) {
6021
6814
  logActivity(state, {
6022
6815
  type: "info",
@@ -6040,21 +6833,44 @@ async function driveChannels(state, driver) {
6040
6833
  const errorMessage = error2 instanceof Error ? error2.message : String(error2);
6041
6834
  logActivity(state, { type: "error", error: `Channel processing error: ${errorMessage}` });
6042
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
+ }
6043
6850
  }
6044
6851
  await new Promise((resolve3) => setTimeout(resolve3, CHANNEL_POLL_INTERVAL_MS));
6045
- if (state.idleTimeout !== null && idlePolls >= 2) {
6046
- const idleMs = idlePolls * CHANNEL_POLL_INTERVAL_MS;
6047
- if (idleMs > state.idleTimeout * 1e3) {
6048
- logActivity(state, { type: "info", message: "Idle timeout reached" });
6049
- if (state.interactive) displayStatus(state);
6050
- break;
6051
- }
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;
6052
6868
  }
6053
6869
  }
6054
6870
  }
6055
6871
  var SESSION_CLEANUP_FIRST_SWEEP_MS = 1e4;
6056
- async function runSweep(state, driver, config2) {
6057
- const mode = `age=${config2.maxAgeMs ?? "\u2014"} count=${config2.maxCount ?? "\u2014"}`;
6872
+ async function runSweep(state, driver, config) {
6873
+ const mode = `age=${config.maxAgeMs ?? "\u2014"} count=${config.maxCount ?? "\u2014"}`;
6058
6874
  try {
6059
6875
  const sessions = await listSessions(state.port);
6060
6876
  if (sessions === null) {
@@ -6067,8 +6883,8 @@ async function runSweep(state, driver, config2) {
6067
6883
  const toDelete = selectSessionsToDelete(
6068
6884
  sessions.map((s) => ({ id: s.id, lastActivityMs: sessionLastActivityMs(s) })),
6069
6885
  {
6070
- maxAgeMs: config2.maxAgeMs,
6071
- maxCount: config2.maxCount,
6886
+ maxAgeMs: config.maxAgeMs,
6887
+ maxCount: config.maxCount,
6072
6888
  nowMs: Date.now(),
6073
6889
  protectedIds: driver.protectedSessionIds()
6074
6890
  }
@@ -6104,7 +6920,7 @@ async function runSweep(state, driver, config2) {
6104
6920
  }
6105
6921
  }
6106
6922
  function scheduleSessionCleanup(state, driver, options) {
6107
- const config2 = resolveSessionCleanupConfig(
6923
+ const config = resolveSessionCleanupConfig(
6108
6924
  {
6109
6925
  maxAge: options.sessionCleanupMaxAge,
6110
6926
  maxCount: options.sessionCleanupMaxCount,
@@ -6112,21 +6928,24 @@ function scheduleSessionCleanup(state, driver, options) {
6112
6928
  },
6113
6929
  process.env
6114
6930
  );
6115
- for (const warning2 of config2.warnings) {
6931
+ for (const warning2 of config.warnings) {
6116
6932
  logActivity(state, { type: "info", level: "warn", message: `Session cleanup: ${warning2}` });
6117
6933
  }
6118
- if (!config2.enabled) return;
6934
+ if (!config.enabled) return;
6119
6935
  logActivity(state, {
6120
6936
  type: "info",
6121
- message: `Session cleanup enabled (age=${config2.maxAgeMs ?? "\u2014"}, count=${config2.maxCount ?? "\u2014"}, interval=${config2.intervalMs}ms)`
6937
+ message: `Session cleanup enabled (age=${config.maxAgeMs ?? "\u2014"}, count=${config.maxCount ?? "\u2014"}, interval=${config.intervalMs}ms)`
6122
6938
  });
6123
- const interval = setInterval(() => void runSweep(state, driver, config2), config2.intervalMs);
6939
+ const interval = setInterval(() => void runSweep(state, driver, config), config.intervalMs);
6124
6940
  const firstSweep = setTimeout(
6125
- () => void runSweep(state, driver, config2),
6941
+ () => void runSweep(state, driver, config),
6126
6942
  SESSION_CLEANUP_FIRST_SWEEP_MS
6127
6943
  );
6128
6944
  state.sessionCleanupTimers.push(interval, firstSweep);
6129
6945
  }
6946
+ function claudeUsageFailureStreakSuffix(consecutiveFailures) {
6947
+ return consecutiveFailures > 1 ? ` (${consecutiveFailures} consecutive failures)` : "";
6948
+ }
6130
6949
  function scheduleClaudeUsageReporting(state, options) {
6131
6950
  const { mode, warnings } = resolveClaudeUsageReportingMode(
6132
6951
  options.claudeUsageReporting,
@@ -6145,13 +6964,26 @@ function scheduleClaudeUsageReporting(state, options) {
6145
6964
  level: "debug",
6146
6965
  message: "Claude usage reporting is off (--claude-usage-reporting off)"
6147
6966
  });
6148
- return;
6967
+ return null;
6149
6968
  }
6150
6969
  let consecutiveFailures = 0;
6970
+ let armed = false;
6971
+ let rearmRequested = false;
6151
6972
  const scheduleNextTick = () => {
6973
+ armed = true;
6974
+ rearmRequested = false;
6152
6975
  state.claudeUsageTimer = setTimeout(() => void tick(false), nextReportDelayMs());
6153
6976
  };
6154
- 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) => {
6155
6987
  try {
6156
6988
  const usage = await getClaudeUsage();
6157
6989
  const result = await reportClaudeUsage(state.agentId, state.authHeader, usage);
@@ -6173,8 +7005,8 @@ function scheduleClaudeUsageReporting(state, options) {
6173
7005
  consecutiveFailures++;
6174
7006
  logActivity(state, {
6175
7007
  type: "info",
6176
- level: consecutiveFailures === 1 ? "warn" : "debug",
6177
- message: `Failed to report Claude usage: ${result.error}`
7008
+ level: claudeUsageFailureLogLevel(consecutiveFailures),
7009
+ message: `Failed to report Claude usage: ${result.error}${claudeUsageFailureStreakSuffix(consecutiveFailures)}`
6178
7010
  });
6179
7011
  }
6180
7012
  scheduleNextTick();
@@ -6187,12 +7019,14 @@ function scheduleClaudeUsageReporting(state, options) {
6187
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"
6188
7020
  });
6189
7021
  scheduleNextTick();
6190
- } else if (isFirst) {
7022
+ } else if (isProbe) {
6191
7023
  logActivity(state, {
6192
7024
  type: "info",
6193
7025
  level: "debug",
6194
7026
  message: `Claude usage reporting: ${error2.message}`
6195
7027
  });
7028
+ armed = false;
7029
+ if (rearmRequested) rearm();
6196
7030
  } else {
6197
7031
  logActivity(state, {
6198
7032
  type: "info",
@@ -6206,14 +7040,16 @@ function scheduleClaudeUsageReporting(state, options) {
6206
7040
  const message = error2 instanceof Error ? error2.message : String(error2);
6207
7041
  logActivity(state, {
6208
7042
  type: "info",
6209
- level: consecutiveFailures === 1 ? "warn" : "debug",
6210
- message: `Claude usage reporting failed: ${message}`
7043
+ level: claudeUsageFailureLogLevel(consecutiveFailures),
7044
+ message: `Claude usage reporting failed: ${message}${claudeUsageFailureStreakSuffix(consecutiveFailures)}`
6211
7045
  });
6212
7046
  scheduleNextTick();
6213
7047
  }
6214
7048
  }
6215
7049
  };
7050
+ armed = true;
6216
7051
  state.claudeUsageTimer = setTimeout(() => void tick(true), FIRST_REPORT_DELAY_MS);
7052
+ return rearm;
6217
7053
  }
6218
7054
  async function notifyOffline(state) {
6219
7055
  if (!state.agentId || !state.authHeader) return;
@@ -6254,6 +7090,7 @@ async function cleanup(state, opts = {}) {
6254
7090
  clearTimeout(state.claudeUsageTimer);
6255
7091
  state.claudeUsageTimer = null;
6256
7092
  }
7093
+ state.claudeUsageRearm = null;
6257
7094
  if (opts.graceful && state.channelDriver) {
6258
7095
  state.channelDriver.stop();
6259
7096
  log2(state, "Draining in-flight channel work before shutdown...");
@@ -6335,6 +7172,7 @@ async function run(options) {
6335
7172
  lastProxiedActivityAt: null,
6336
7173
  sessionCleanupTimers: [],
6337
7174
  claudeUsageTimer: null,
7175
+ claudeUsageRearm: null,
6338
7176
  authHeader: ""
6339
7177
  };
6340
7178
  setTelemetryAuthProvider(() => ({ authHeader: state.authHeader, agentId: state.agentId }));
@@ -6414,6 +7252,7 @@ async function run(options) {
6414
7252
  console.log(chalk6.dim("Or run `evident login` for interactive authentication"));
6415
7253
  blank();
6416
7254
  process.exit(1);
7255
+ return;
6417
7256
  }
6418
7257
  blank();
6419
7258
  console.log(chalk6.yellow("You are not logged in to Evident."));
@@ -6458,6 +7297,7 @@ async function run(options) {
6458
7297
  } else {
6459
7298
  printError(resolved.error || "Failed to resolve runner ID from key");
6460
7299
  process.exit(1);
7300
+ return;
6461
7301
  }
6462
7302
  } else {
6463
7303
  printError(
@@ -6471,6 +7311,7 @@ async function run(options) {
6471
7311
  );
6472
7312
  blank();
6473
7313
  process.exit(1);
7314
+ return;
6474
7315
  }
6475
7316
  }
6476
7317
  telemetry.info(
@@ -6718,7 +7559,7 @@ async function run(options) {
6718
7559
  throw error2;
6719
7560
  }
6720
7561
  scheduleSessionCleanup(state, channelDriver, options);
6721
- scheduleClaudeUsageReporting(state, options);
7562
+ state.claudeUsageRearm = scheduleClaudeUsageReporting(state, options);
6722
7563
  if (!interactive || state.json) {
6723
7564
  log2(state, "Driving channel messages...");
6724
7565
  }
@@ -6773,6 +7614,7 @@ program.name("evident").description("Run OpenCode locally and connect it to Evid
6773
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);
6774
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 }));
6775
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 }));
6776
7618
  program.command("claude-usage").description("[spike] Show Claude subscription usage (requires a local `claude login`)").action(claudeUsage);
6777
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(
6778
7620
  "-a, --agent [id]",
@@ -6802,7 +7644,7 @@ program.command("run").description("Connect to Evident and process messages").op
6802
7644
  []
6803
7645
  ).option(
6804
7646
  "--tunnel-ready-file <path>",
6805
- "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)"
6806
7648
  ).action(
6807
7649
  (options) => {
6808
7650
  run({