@evident-ai/cli 3.1.1-dev.a98a2ef → 3.1.1-dev.aa1c58a

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,343 @@ 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 >= 500) {
801
+ const serverMessage = await readErrorMessage(response);
802
+ return {
803
+ ok: false,
804
+ endpoint: apiUrl,
805
+ authLabel: authLabelFor(credentials2),
806
+ reason: "unreachable",
807
+ error: `${apiUrl} returned HTTP ${response.status}${serverMessage ? `: ${serverMessage}` : ""}. The credentials were NOT validated.`,
808
+ exitCode: 75
809
+ };
810
+ }
811
+ if (!response.ok) {
812
+ const serverMessage = await readErrorMessage(response);
813
+ return {
814
+ ok: false,
815
+ endpoint: apiUrl,
816
+ authLabel: authLabelFor(credentials2),
817
+ reason: "http_error",
818
+ error: `HTTP ${response.status}${serverMessage ? `: ${serverMessage}` : ""}`,
819
+ exitCode: 1
820
+ };
821
+ }
822
+ const data = await response.json();
823
+ return {
824
+ ok: true,
825
+ endpoint: apiUrl,
826
+ authType: data.auth_type,
827
+ authLabel: authLabelFor(credentials2),
828
+ runnerId: data.auth_type === "agent_key" ? data.agent_id : void 0,
829
+ reason: "ok",
830
+ exitCode: 0
831
+ };
832
+ }
833
+ function printJson(result) {
834
+ const payload = {
835
+ ok: result.ok,
836
+ endpoint: result.endpoint
837
+ };
838
+ if (result.authType) payload.auth_type = result.authType;
839
+ if (result.runnerId) payload.runner_id = result.runnerId;
840
+ if (result.reason) payload.reason = result.reason;
841
+ if (result.error) payload.error = result.error;
842
+ console.log(JSON.stringify(payload));
843
+ }
844
+ function printHuman(result) {
845
+ blank();
846
+ console.log(keyValue("Endpoint", result.endpoint));
847
+ if (result.ok) {
848
+ console.log(keyValue("Auth", result.authLabel ?? "\u2014"));
849
+ if (result.runnerId) {
850
+ console.log(keyValue("Runner", result.runnerId));
851
+ }
852
+ console.log(keyValue("Status", "OK \u2014 credentials accepted"));
853
+ blank();
854
+ return;
855
+ }
856
+ if (result.authLabel) {
857
+ console.log(keyValue("Auth", result.authLabel));
858
+ }
859
+ blank();
860
+ printError(result.error ?? "Unknown error");
861
+ }
862
+ async function status(options = {}) {
863
+ const result = await checkStatus(Boolean(options.json));
864
+ if (options.json) {
865
+ printJson(result);
866
+ } else {
867
+ printHuman(result);
868
+ }
869
+ process.exit(result.exitCode);
870
+ }
871
+
540
872
  // src/lib/claude-usage.ts
541
873
  import { execFileSync } from "child_process";
542
874
  import { readFileSync } from "fs";
@@ -587,6 +919,10 @@ var ClaudeUsageError = class extends Error {
587
919
  function isLocalCredentialProblem(err) {
588
920
  return err instanceof ClaudeUsageError && (err.reason === "no_credentials" || err.reason === "credentials_expired");
589
921
  }
922
+ function normalizeResetsAt(value) {
923
+ const ms = Date.parse(value);
924
+ return Number.isNaN(ms) ? null : new Date(ms).toISOString();
925
+ }
590
926
  function toWindow(value) {
591
927
  if (!value || typeof value !== "object") {
592
928
  return null;
@@ -595,7 +931,11 @@ function toWindow(value) {
595
931
  if (typeof window.utilization !== "number" || typeof window.resets_at !== "string") {
596
932
  return null;
597
933
  }
598
- return { utilization: window.utilization, resetsAt: window.resets_at };
934
+ const resetsAt = normalizeResetsAt(window.resets_at);
935
+ if (resetsAt === null) {
936
+ return null;
937
+ }
938
+ return { utilization: window.utilization, resetsAt };
599
939
  }
600
940
  async function getClaudeUsage() {
601
941
  const credentials2 = readClaudeCliCredentials();
@@ -657,6 +997,9 @@ import { homedir as homedir3 } from "os";
657
997
  import { isAbsolute as isAbsolute2, join as join3, parse, resolve as resolvePath } from "path";
658
998
  import chalk6 from "chalk";
659
999
 
1000
+ // ../../packages/types/src/agents/index.ts
1001
+ var MICROVM_MAX_LIFETIME_MS = 8 * 60 * 6e4;
1002
+
660
1003
  // ../../packages/types/src/telemetry/index.ts
661
1004
  var TelemetryEventTypes = {
662
1005
  // Agent activity events (shown in web UI activity log)
@@ -939,49 +1282,6 @@ function forwardRunnerActivity(entry, context) {
939
1282
  }
940
1283
  }
941
1284
 
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
1285
  // src/lib/opencode/health.ts
986
1286
  async function checkOpenCodeHealth(port) {
987
1287
  try {
@@ -2391,6 +2691,10 @@ function nextReportDelayMs(random = Math.random) {
2391
2691
  return BASE_REPORT_DELAY_MS - jitterRangeMs + random() * (2 * jitterRangeMs);
2392
2692
  }
2393
2693
  var FIRST_REPORT_DELAY_MS = 5e3 + Math.random() * 1e4;
2694
+ var CLAUDE_USAGE_FAILURE_REESCALATION_TICKS = 6;
2695
+ function claudeUsageFailureLogLevel(consecutiveFailures) {
2696
+ return consecutiveFailures === 1 || consecutiveFailures % CLAUDE_USAGE_FAILURE_REESCALATION_TICKS === 0 ? "warn" : "debug";
2697
+ }
2394
2698
 
2395
2699
  // src/lib/channels/driver.ts
2396
2700
  import { homedir as homedir2 } from "os";
@@ -2713,8 +3017,8 @@ async function applyOne(options, file) {
2713
3017
  await ack(options, file, "applied");
2714
3018
  return true;
2715
3019
  }
2716
- function durableDownloadCode(status) {
2717
- return status === 413 ? "file_too_large" : "write_failed";
3020
+ function durableDownloadCode(status2) {
3021
+ return status2 === 413 ? "file_too_large" : "write_failed";
2718
3022
  }
2719
3023
  async function downloadContent(options, file, label) {
2720
3024
  try {
@@ -2747,8 +3051,8 @@ async function downloadContent(options, file, label) {
2747
3051
  return { ok: false, terminal: false };
2748
3052
  }
2749
3053
  }
2750
- async function ack(options, file, status, reason) {
2751
- const outcome = `${status}${reason ? ` (${reason})` : ""}`;
3054
+ async function ack(options, file, status2, reason) {
3055
+ const outcome = `${status2}${reason ? ` (${reason})` : ""}`;
2752
3056
  try {
2753
3057
  const res = await options.fetchImpl(
2754
3058
  `${options.apiUrl}/runners/${options.agentId}/files/${file.id}/ack`,
@@ -2758,7 +3062,7 @@ async function ack(options, file, status, reason) {
2758
3062
  Authorization: options.getAuthHeader(),
2759
3063
  "Content-Type": "application/json"
2760
3064
  },
2761
- body: JSON.stringify(reason ? { status, reason } : { status })
3065
+ body: JSON.stringify(reason ? { status: status2, reason } : { status: status2 })
2762
3066
  }
2763
3067
  );
2764
3068
  if (!res.ok) {
@@ -2830,10 +3134,10 @@ var ChannelAuthError = class extends Error {
2830
3134
  };
2831
3135
  var ChannelTerminalError = class extends Error {
2832
3136
  status;
2833
- constructor(message, status) {
3137
+ constructor(message, status2) {
2834
3138
  super(message);
2835
3139
  this.name = "ChannelTerminalError";
2836
- this.status = status;
3140
+ this.status = status2;
2837
3141
  }
2838
3142
  };
2839
3143
  function backoffDelay(attempt, policy) {
@@ -2841,8 +3145,8 @@ function backoffDelay(attempt, policy) {
2841
3145
  const capped = Math.min(policy.maxDelayMs, exp);
2842
3146
  return Math.floor(Math.random() * capped);
2843
3147
  }
2844
- function isRetryableStatus(status) {
2845
- return status === 429 || status >= 500 && status <= 599;
3148
+ function isRetryableStatus(status2) {
3149
+ return status2 === 429 || status2 >= 500 && status2 <= 599;
2846
3150
  }
2847
3151
  var ChannelDriver = class _ChannelDriver {
2848
3152
  agentId;
@@ -2957,6 +3261,24 @@ var ChannelDriver = class _ChannelDriver {
2957
3261
  * processing list, exactly like `dontRedispatch`/`doneUndeliverable`.
2958
3262
  */
2959
3263
  readoptPollUnresolvedSignalled = /* @__PURE__ */ new Set();
3264
+ /**
3265
+ * "Already emitted `redrive_unresolved` for this row" (#965). Mirrors
3266
+ * `readoptPollUnresolvedSignalled`: `resolveRedrive`'s `unresolved` leaf recurs
3267
+ * every ~2s drain until opencode's status becomes readable, but the
3268
+ * server-visible signal is an OUTCOME, so it fires at most once per row. Cleared
3269
+ * on any non-`unresolved` outcome so the set cannot grow beyond the currently
3270
+ * unresolvable rows.
3271
+ */
3272
+ redriveUnresolvedSignalled = /* @__PURE__ */ new Set();
3273
+ /**
3274
+ * First `now()` a `pending` row's re-drive was observed `unresolved` (#965). A
3275
+ * `pending` row is invisible to every cron arm (all require `status =
3276
+ * 'processing'`), so an indefinitely-`unresolved` row would be stranded with
3277
+ * nothing driving it. Once `now - since >= pausedMaxWaitMs`, `resolveRedrive`
3278
+ * takes `dispatch` instead of `unresolved` (reusing the existing knob — see
3279
+ * ADR-0047's own "unreachable ⇒ bounded" rule). Cleared on any other outcome.
3280
+ */
3281
+ redriveUnresolvedSince = /* @__PURE__ */ new Map();
2960
3282
  /**
2961
3283
  * "A null-id re-adopt re-dispatch is in flight, awaiting its read-back" (WI-5
2962
3284
  * Task 5.4, High-2). Since we no longer send a caller-supplied id, a re-dispatch
@@ -3045,23 +3367,23 @@ var ChannelDriver = class _ChannelDriver {
3045
3367
  * and stops opencode.
3046
3368
  */
3047
3369
  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 ?? (() => {
3370
+ constructor(config) {
3371
+ this.agentId = config.agentId;
3372
+ this.port = config.port;
3373
+ this.apiUrl = config.apiUrl.replace(/\/$/, "");
3374
+ this.getAuthHeader = config.getAuthHeader;
3375
+ this.conversationFilter = config.conversationFilter ?? null;
3376
+ this.retry = { ...DEFAULT_RETRY_POLICY, ...config.retry };
3377
+ this.log = config.log ?? (() => {
3056
3378
  });
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();
3379
+ this.fetchImpl = config.fetchImpl ?? fetch;
3380
+ this.sleep = config.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
3381
+ this.pausedPollIntervalMs = config.pausedPollIntervalMs ?? DEFAULT_PAUSED_POLL_INTERVAL_MS;
3382
+ this.pausedMaxWaitMs = config.pausedMaxWaitMs ?? DEFAULT_PAUSED_MAX_WAIT_MS;
3383
+ this.stuckQueuedMs = config.stuckQueuedMs ?? DEFAULT_STUCK_QUEUED_MS;
3384
+ this.now = config.now ?? (() => Date.now());
3385
+ this.fileSyncDirectories = config.fileSyncDirectories ?? [];
3386
+ this.homeDir = config.homeDir ?? homedir2();
3065
3387
  }
3066
3388
  /** The IPv4-loopback base URL for the local `opencode serve`. */
3067
3389
  get opencodeBase() {
@@ -3296,6 +3618,12 @@ var ChannelDriver = class _ChannelDriver {
3296
3618
  skippedAlreadyDispatched += 1;
3297
3619
  continue;
3298
3620
  }
3621
+ if (message.opencode_message_id) {
3622
+ const outcome = await this.resolveRedrive(conv, sessionId, message, refusedSessionId);
3623
+ if (outcome !== "dispatch") {
3624
+ break;
3625
+ }
3626
+ }
3299
3627
  const options = {
3300
3628
  agent: message.opencode_agent ?? void 0,
3301
3629
  model: message.opencode_model ?? void 0
@@ -3340,50 +3668,262 @@ var ChannelDriver = class _ChannelDriver {
3340
3668
  this.sessions.delete(conv.id);
3341
3669
  this.supersede(conv.id, sessionId);
3342
3670
  this.log({
3343
- level: "warn",
3344
- message: `Abandoning OpenCode session ${sessionId.slice(0, 8)} as the binding for conversation ${conv.id.slice(0, 8)} (it exists but failed to run a turn) \u2014 a fresh session is created on the next tick, whatever the persisted binding says by then.`,
3671
+ level: "warn",
3672
+ message: `Abandoning OpenCode session ${sessionId.slice(0, 8)} as the binding for conversation ${conv.id.slice(0, 8)} (it exists but failed to run a turn) \u2014 a fresh session is created on the next tick, whatever the persisted binding says by then.`,
3673
+ conversation_id: conv.id,
3674
+ message_id: message.id
3675
+ });
3676
+ await this.markFailed(conv.id, message.id, null, errorMessage).catch((markErr) => {
3677
+ this.log({
3678
+ level: "warn",
3679
+ 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)}`,
3680
+ conversation_id: conv.id,
3681
+ message_id: message.id
3682
+ });
3683
+ });
3684
+ this.log({
3685
+ level: "error",
3686
+ message: `Message ${message.id.slice(0, 8)} dispatch failed: ${errorMessage}`,
3687
+ conversation_id: conv.id,
3688
+ message_id: message.id
3689
+ });
3690
+ break;
3691
+ }
3692
+ if (opencodeMessageId === null) {
3693
+ this.log({
3694
+ level: "warn",
3695
+ 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`,
3696
+ conversation_id: conv.id,
3697
+ message_id: message.id
3698
+ });
3699
+ continue;
3700
+ }
3701
+ this.dispatched.add(message.id);
3702
+ this.registerInFlight(conv, sessionId, message, opencodeMessageId);
3703
+ dispatched += 1;
3704
+ void this.postSignal(conv.id, message.id, "dispatched");
3705
+ }
3706
+ if (messages.length > 0 && dispatched === 0 && skippedAlreadyDispatched === messages.length) {
3707
+ this.log({
3708
+ level: "warn",
3709
+ 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).`,
3710
+ conversation_id: conv.id
3711
+ });
3712
+ }
3713
+ this.ensureWatcherRunning(sessionId);
3714
+ return dispatched;
3715
+ }
3716
+ /**
3717
+ * Poll a session's message list for the re-drive fence (#965), via the
3718
+ * INJECTED `fetchImpl` — NOT the imported `getSessionMessages` helper, which
3719
+ * hits the global `fetch` and would bypass the same override every other
3720
+ * opencode poll in this file respects. Mirrors `readoptProcessing`'s own
3721
+ * snapshot fetch (`:3081-3111`). `null` = unreadable (non-OK response,
3722
+ * non-array body, or a network exception) — treated as "can't observe",
3723
+ * never as "confirmed gone".
3724
+ */
3725
+ async pollSessionMessagesForRedrive(conv, message, sessionId) {
3726
+ try {
3727
+ const res = await this.fetchImpl(`${this.opencodeBase}/session/${sessionId}/message`);
3728
+ if (!res.ok) {
3729
+ this.log({
3730
+ level: "warn",
3731
+ message: `Re-drive: polling session ${sessionId.slice(0, 8)} for message ${message.id.slice(0, 8)} returned HTTP ${res.status} \u2014 treating as unreadable this tick`,
3732
+ conversation_id: conv.id,
3733
+ message_id: message.id
3734
+ });
3735
+ return null;
3736
+ }
3737
+ const body = await res.json();
3738
+ if (!Array.isArray(body)) {
3739
+ this.log({
3740
+ level: "warn",
3741
+ 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`,
3742
+ conversation_id: conv.id,
3743
+ message_id: message.id
3744
+ });
3745
+ return null;
3746
+ }
3747
+ return body;
3748
+ } catch (err) {
3749
+ this.log({
3750
+ level: "warn",
3751
+ 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)}`,
3752
+ conversation_id: conv.id,
3753
+ message_id: message.id
3754
+ });
3755
+ return null;
3756
+ }
3757
+ }
3758
+ /**
3759
+ * The re-drive fence for a `pending` row that already carries a stored
3760
+ * `opencode_message_id` (#965) — i.e. it has already been handed to opencode at
3761
+ * least once (see the invariant at `QueuedMessage.opencode_message_id`'s doc).
3762
+ * The lifecycle cron can falsely reclaim a `processing` row back to `pending`
3763
+ * mid-turn (a 5-minute liveness-staleness check racing a still-running turn);
3764
+ * without this fence the drain loop would re-`prompt_async` the SAME turn a
3765
+ * second time against live GitHub state. Mirrors `readoptOne`'s job for the
3766
+ * `processing` re-adopt path, but simpler: no b1/b2 preamble cross-check is
3767
+ * needed here because `refusedSessionId` already handles the one case
3768
+ * (#553 abandoned session) that path exists for.
3769
+ *
3770
+ * Only `ChannelAuthError` propagates; every other failure resolves to
3771
+ * `unresolved` and is retried whole on the next ~2s drain tick.
3772
+ */
3773
+ async resolveRedrive(conv, sessionId, message, refusedSessionId) {
3774
+ const ocId = message.opencode_message_id ?? null;
3775
+ if (refusedSessionId) {
3776
+ this.clearRedriveUnresolved(message.id);
3777
+ void this.postSignal(conv.id, message.id, "redrive_redispatched");
3778
+ return "dispatch";
3779
+ }
3780
+ const messages = await this.pollSessionMessagesForRedrive(conv, message, sessionId);
3781
+ if (messages == null || messages.length === 0) {
3782
+ return this.resolveRedriveUnresolved(conv, message);
3783
+ }
3784
+ const state = messageRunState(messages, ocId ?? "");
3785
+ if (state === "done" || state === "failed") {
3786
+ return this.settleRedrive(conv, sessionId, message, ocId, messages, state);
3787
+ }
3788
+ if (state === "running" || state === "queued") {
3789
+ const ongoing = await isSessionOngoing(this.port, sessionId);
3790
+ if (ongoing === true) {
3791
+ return this.reattachRedrive(conv, sessionId, message, ocId);
3792
+ }
3793
+ if (ongoing === false) {
3794
+ this.clearRedriveUnresolved(message.id);
3795
+ void this.postSignal(conv.id, message.id, "redrive_redispatched");
3796
+ return "dispatch";
3797
+ }
3798
+ return this.resolveRedriveUnresolved(conv, message);
3799
+ }
3800
+ this.clearRedriveUnresolved(message.id);
3801
+ void this.postSignal(conv.id, message.id, "redrive_redispatched");
3802
+ return "dispatch";
3803
+ }
3804
+ /**
3805
+ * The `reattached` outcome (Task 3.3): the prior turn is STILL ONGOING per
3806
+ * opencode's own status map — undo the false reclaim instead of starting a
3807
+ * second turn.
3808
+ */
3809
+ async reattachRedrive(conv, sessionId, message, ocId) {
3810
+ let anchorMs;
3811
+ const parsed = message.processing_started_at ? Date.parse(message.processing_started_at) : NaN;
3812
+ if (!Number.isNaN(parsed)) {
3813
+ anchorMs = parsed;
3814
+ } else {
3815
+ anchorMs = this.now();
3816
+ this.log({
3817
+ level: "error",
3818
+ 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)`,
3819
+ conversation_id: conv.id,
3820
+ message_id: message.id
3821
+ });
3822
+ }
3823
+ const title = await this.resolveSessionTitle(sessionId, conv.id);
3824
+ try {
3825
+ await this.markProcessing(conv.id, message.id, sessionId, ocId, title);
3826
+ } catch (err) {
3827
+ if (err instanceof ChannelAuthError) throw err;
3828
+ this.log({
3829
+ level: "warn",
3830
+ 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)}`,
3831
+ conversation_id: conv.id,
3832
+ message_id: message.id
3833
+ });
3834
+ return "unresolved";
3835
+ }
3836
+ this.clearRedriveUnresolved(message.id);
3837
+ this.registerReadopted(conv, sessionId, message, ocId ?? "", anchorMs);
3838
+ this.dispatched.add(message.id);
3839
+ this.readopted.add(message.id);
3840
+ this.ensureWatcherRunning(sessionId);
3841
+ const watchedForMs = this.now() - anchorMs;
3842
+ void this.postSignal(conv.id, message.id, "redrive_reattached", {
3843
+ watched_for_ms: watchedForMs
3844
+ });
3845
+ this.log({
3846
+ level: "warn",
3847
+ 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`,
3848
+ conversation_id: conv.id,
3849
+ message_id: message.id
3850
+ });
3851
+ return "reattached";
3852
+ }
3853
+ /**
3854
+ * The `settled` outcome (Task 3.2): the prior turn already finished (or
3855
+ * errored) while nobody was watching — deliver/report it instead of re-running.
3856
+ * Mirrors `readoptOne`'s `done`/`failed` branches' error discipline, simplified
3857
+ * (no `doneUndeliverable` park: a terminal PATCH failure here just retries next
3858
+ * drain, same as any other non-auth failure).
3859
+ */
3860
+ async settleRedrive(conv, sessionId, message, ocId, messages, state) {
3861
+ try {
3862
+ if (state === "done") {
3863
+ const title = await this.resolveSessionTitle(sessionId, conv.id);
3864
+ const usage = messageUsage(messages, ocId ?? "");
3865
+ this.log({
3866
+ level: "info",
3867
+ 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`,
3345
3868
  conversation_id: conv.id,
3346
3869
  message_id: message.id
3347
3870
  });
3348
- await this.markFailed(conv.id, message.id, null, errorMessage).catch((markErr) => {
3349
- this.log({
3350
- level: "warn",
3351
- 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)}`,
3352
- conversation_id: conv.id,
3353
- message_id: message.id
3354
- });
3355
- });
3871
+ await this.markDone(conv.id, message.id, sessionId, ocId, title, usage);
3872
+ } else {
3873
+ const error2 = messageError(messages, ocId ?? "") ?? void 0;
3874
+ const usage = messageUsage(messages, ocId ?? "");
3875
+ const failure = await this.classifyModelAuthFailure(messages, ocId ?? "");
3356
3876
  this.log({
3357
3877
  level: "error",
3358
- message: `Message ${message.id.slice(0, 8)} dispatch failed: ${errorMessage}`,
3359
- conversation_id: conv.id,
3360
- message_id: message.id
3361
- });
3362
- break;
3363
- }
3364
- if (opencodeMessageId === null) {
3365
- 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`,
3878
+ 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)"}`,
3368
3879
  conversation_id: conv.id,
3369
3880
  message_id: message.id
3370
3881
  });
3371
- continue;
3882
+ await this.markFailed(conv.id, message.id, sessionId, error2, usage, failure);
3372
3883
  }
3373
- this.dispatched.add(message.id);
3374
- this.registerInFlight(conv, sessionId, message, opencodeMessageId);
3375
- dispatched += 1;
3376
- void this.postSignal(conv.id, message.id, "dispatched");
3377
- }
3378
- if (messages.length > 0 && dispatched === 0 && skippedAlreadyDispatched === messages.length) {
3884
+ } catch (err) {
3885
+ if (err instanceof ChannelAuthError) throw err;
3379
3886
  this.log({
3380
3887
  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
3888
+ message: `Re-drive: failed to report message ${message.id.slice(0, 8)} ${state} (will retry next drain): ${err instanceof Error ? err.message : String(err)}`,
3889
+ conversation_id: conv.id,
3890
+ message_id: message.id
3383
3891
  });
3892
+ return "unresolved";
3384
3893
  }
3385
- this.ensureWatcherRunning(sessionId);
3386
- return dispatched;
3894
+ this.clearRedriveUnresolved(message.id);
3895
+ void this.postSignal(conv.id, message.id, "redrive_settled");
3896
+ return "settled";
3897
+ }
3898
+ /**
3899
+ * The bounded `unresolved` outcome (Task 3.4): opencode's state could not be
3900
+ * observed (snapshot unreadable/empty, or `isSessionOngoing` returned `null`).
3901
+ * A `pending` row is invisible to every cron arm (all require `status =
3902
+ * 'processing'`), so an indefinitely-`unresolved` row would be stranded with
3903
+ * nothing driving it — bound it to the existing `pausedMaxWaitMs` window
3904
+ * (reusing the knob, not a new constant) and take `dispatch` once elapsed.
3905
+ */
3906
+ resolveRedriveUnresolved(conv, message) {
3907
+ const now = this.now();
3908
+ const since = this.redriveUnresolvedSince.get(message.id);
3909
+ if (since !== void 0 && now - since >= this.pausedMaxWaitMs) {
3910
+ this.clearRedriveUnresolved(message.id);
3911
+ void this.postSignal(conv.id, message.id, "redrive_redispatched");
3912
+ return "dispatch";
3913
+ }
3914
+ if (since === void 0) {
3915
+ this.redriveUnresolvedSince.set(message.id, now);
3916
+ }
3917
+ if (!this.redriveUnresolvedSignalled.has(message.id)) {
3918
+ this.redriveUnresolvedSignalled.add(message.id);
3919
+ void this.postSignal(conv.id, message.id, "redrive_unresolved");
3920
+ }
3921
+ return "unresolved";
3922
+ }
3923
+ /** Clear both `unresolved`-bound trackers for a row (any non-`unresolved` outcome). */
3924
+ clearRedriveUnresolved(messageId) {
3925
+ this.redriveUnresolvedSince.delete(messageId);
3926
+ this.redriveUnresolvedSignalled.delete(messageId);
3387
3927
  }
3388
3928
  /**
3389
3929
  * Record that `sessionId` is no longer a valid binding for `conversationId`
@@ -3668,9 +4208,10 @@ var ChannelDriver = class _ChannelDriver {
3668
4208
  * opencode reports ACTIVELY `running` is watched to completion (its liveness
3669
4209
  * heartbeat keeps the cron off its row), while a re-adopted turn that is paused
3670
4210
  * 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`
4211
+ * handed to the cron. Real invariant (#965): the cron MAY reclaim a row this
4212
+ * runner still holds; a reclaimed row that already ran is never re-dispatched
4213
+ * while opencode reports its turn ongoing (readopt's own gate here, and the
4214
+ * `pending`-row re-drive fence, `resolveRedrive`). `dispatchedAt` stays `now`
3674
4215
  * (only the appear-guard uses it).
3675
4216
  *
3676
4217
  * `evidentMessageId` addresses the SERVER row (for markProcessing/markDone);
@@ -4572,7 +5113,8 @@ var ChannelDriver = class _ChannelDriver {
4572
5113
  opencode_model: row.opencode_model,
4573
5114
  source_message_id: row.source_message_id,
4574
5115
  slack_user_id: row.slack_user_id,
4575
- attachments: row.attachments ?? null
5116
+ attachments: row.attachments ?? null,
5117
+ opencode_message_id: row.opencode_message_id
4576
5118
  };
4577
5119
  }
4578
5120
  /**
@@ -5164,11 +5706,11 @@ var ChannelDriver = class _ChannelDriver {
5164
5706
  * `ensureSession` guard, not this suppression, is what makes the self-heal
5165
5707
  * stick.
5166
5708
  */
5167
- sessionIdBody(sessionId, conversationId, messageId, status) {
5709
+ sessionIdBody(sessionId, conversationId, messageId, status2) {
5168
5710
  if (!this.isSuperseded(conversationId, sessionId)) return { opencode_session_id: sessionId };
5169
5711
  this.log({
5170
5712
  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)}`,
5713
+ 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
5714
  conversation_id: conversationId,
5173
5715
  message_id: messageId
5174
5716
  });
@@ -5614,171 +6156,6 @@ Port ${port} is already in use.`));
5614
6156
  return { port, process: null, version: null, notReadyReason: "you chose to continue without it" };
5615
6157
  }
5616
6158
 
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
6159
  // src/commands/run.ts
5783
6160
  var MAX_ACTIVITY_LOG_ENTRIES = 10;
5784
6161
  var CHANNEL_POLL_INTERVAL_MS = Number(process.env.EVIDENT_CHANNEL_POLL_INTERVAL_MS) || 2e3;
@@ -5989,9 +6366,15 @@ async function handleAuthError(state, error2) {
5989
6366
  }
5990
6367
  async function driveChannels(state, driver) {
5991
6368
  let idlePolls = 0;
6369
+ let idleMs = 0;
6370
+ let consecutiveDrainFailures = 0;
6371
+ let unreachableMs = 0;
5992
6372
  let lastSeenProxiedActivityAt = state.lastProxiedActivityAt;
5993
6373
  let lastSeenAppliedFiles = driver.fileSyncActivity().appliedFiles;
5994
6374
  while (state.running) {
6375
+ const cycleStartedAtMs = performance.now();
6376
+ let idleThisCycle = false;
6377
+ let unreachableThisCycle = false;
5995
6378
  if (state.connection?.reconnecting && state.connection.reconnectPromise) {
5996
6379
  logActivity(state, { type: "info", message: "Waiting for tunnel reconnection..." });
5997
6380
  if (state.interactive) displayStatus(state);
@@ -6006,17 +6389,23 @@ async function driveChannels(state, driver) {
6006
6389
  );
6007
6390
  try {
6008
6391
  const processed = await driver.drainPending();
6392
+ consecutiveDrainFailures = 0;
6393
+ unreachableMs = 0;
6009
6394
  state.messageCount += processed;
6010
6395
  const proxiedActivity = state.lastProxiedActivityAt !== lastSeenProxiedActivityAt;
6011
6396
  lastSeenProxiedActivityAt = state.lastProxiedActivityAt;
6012
6397
  const appliedFiles = driver.fileSyncActivity().appliedFiles;
6013
- const fileActivity = carriedOverFileSync || appliedFiles !== lastSeenAppliedFiles;
6398
+ const filesApplied = appliedFiles !== lastSeenAppliedFiles;
6399
+ const fileActivity = carriedOverFileSync || filesApplied;
6014
6400
  lastSeenAppliedFiles = appliedFiles;
6401
+ if (filesApplied) state.claudeUsageRearm?.();
6015
6402
  if (processed > 0 || driver.hasInFlightWatchers() || proxiedActivity || fileActivity) {
6016
6403
  idlePolls = 0;
6404
+ idleMs = 0;
6017
6405
  if (processed > 0 && state.interactive) displayStatus(state);
6018
6406
  } else if (state.idleTimeout !== null) {
6019
6407
  idlePolls++;
6408
+ idleThisCycle = true;
6020
6409
  if (idlePolls === 1) {
6021
6410
  logActivity(state, {
6022
6411
  type: "info",
@@ -6040,21 +6429,44 @@ async function driveChannels(state, driver) {
6040
6429
  const errorMessage = error2 instanceof Error ? error2.message : String(error2);
6041
6430
  logActivity(state, { type: "error", error: `Channel processing error: ${errorMessage}` });
6042
6431
  if (state.interactive) displayStatus(state);
6432
+ if (driver.hasInFlightWatchers()) {
6433
+ consecutiveDrainFailures = 0;
6434
+ unreachableMs = 0;
6435
+ } else if (state.idleTimeout !== null) {
6436
+ consecutiveDrainFailures++;
6437
+ unreachableThisCycle = true;
6438
+ if (consecutiveDrainFailures === 1) {
6439
+ logActivity(state, {
6440
+ type: "info",
6441
+ message: `Cannot reach Evident, will exit if this persists past the idle timeout (timeout: ${state.idleTimeout}s)...`
6442
+ });
6443
+ if (state.interactive) displayStatus(state);
6444
+ }
6445
+ }
6043
6446
  }
6044
6447
  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
- }
6448
+ const cycleMs = performance.now() - cycleStartedAtMs;
6449
+ if (idleThisCycle) idleMs += cycleMs;
6450
+ if (unreachableThisCycle) unreachableMs += cycleMs;
6451
+ if (state.idleTimeout !== null && consecutiveDrainFailures >= 2 && unreachableMs > state.idleTimeout * 1e3) {
6452
+ logActivity(state, {
6453
+ type: "info",
6454
+ level: "warn",
6455
+ message: `Exiting: could not reach Evident for ${consecutiveDrainFailures} consecutive polls (${Math.round(unreachableMs / 1e3)}s)`
6456
+ });
6457
+ if (state.interactive) displayStatus(state);
6458
+ break;
6459
+ }
6460
+ if (state.idleTimeout !== null && idlePolls >= 2 && idleMs > state.idleTimeout * 1e3) {
6461
+ logActivity(state, { type: "info", message: "Idle timeout reached" });
6462
+ if (state.interactive) displayStatus(state);
6463
+ break;
6052
6464
  }
6053
6465
  }
6054
6466
  }
6055
6467
  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"}`;
6468
+ async function runSweep(state, driver, config) {
6469
+ const mode = `age=${config.maxAgeMs ?? "\u2014"} count=${config.maxCount ?? "\u2014"}`;
6058
6470
  try {
6059
6471
  const sessions = await listSessions(state.port);
6060
6472
  if (sessions === null) {
@@ -6067,8 +6479,8 @@ async function runSweep(state, driver, config2) {
6067
6479
  const toDelete = selectSessionsToDelete(
6068
6480
  sessions.map((s) => ({ id: s.id, lastActivityMs: sessionLastActivityMs(s) })),
6069
6481
  {
6070
- maxAgeMs: config2.maxAgeMs,
6071
- maxCount: config2.maxCount,
6482
+ maxAgeMs: config.maxAgeMs,
6483
+ maxCount: config.maxCount,
6072
6484
  nowMs: Date.now(),
6073
6485
  protectedIds: driver.protectedSessionIds()
6074
6486
  }
@@ -6104,7 +6516,7 @@ async function runSweep(state, driver, config2) {
6104
6516
  }
6105
6517
  }
6106
6518
  function scheduleSessionCleanup(state, driver, options) {
6107
- const config2 = resolveSessionCleanupConfig(
6519
+ const config = resolveSessionCleanupConfig(
6108
6520
  {
6109
6521
  maxAge: options.sessionCleanupMaxAge,
6110
6522
  maxCount: options.sessionCleanupMaxCount,
@@ -6112,21 +6524,24 @@ function scheduleSessionCleanup(state, driver, options) {
6112
6524
  },
6113
6525
  process.env
6114
6526
  );
6115
- for (const warning2 of config2.warnings) {
6527
+ for (const warning2 of config.warnings) {
6116
6528
  logActivity(state, { type: "info", level: "warn", message: `Session cleanup: ${warning2}` });
6117
6529
  }
6118
- if (!config2.enabled) return;
6530
+ if (!config.enabled) return;
6119
6531
  logActivity(state, {
6120
6532
  type: "info",
6121
- message: `Session cleanup enabled (age=${config2.maxAgeMs ?? "\u2014"}, count=${config2.maxCount ?? "\u2014"}, interval=${config2.intervalMs}ms)`
6533
+ message: `Session cleanup enabled (age=${config.maxAgeMs ?? "\u2014"}, count=${config.maxCount ?? "\u2014"}, interval=${config.intervalMs}ms)`
6122
6534
  });
6123
- const interval = setInterval(() => void runSweep(state, driver, config2), config2.intervalMs);
6535
+ const interval = setInterval(() => void runSweep(state, driver, config), config.intervalMs);
6124
6536
  const firstSweep = setTimeout(
6125
- () => void runSweep(state, driver, config2),
6537
+ () => void runSweep(state, driver, config),
6126
6538
  SESSION_CLEANUP_FIRST_SWEEP_MS
6127
6539
  );
6128
6540
  state.sessionCleanupTimers.push(interval, firstSweep);
6129
6541
  }
6542
+ function claudeUsageFailureStreakSuffix(consecutiveFailures) {
6543
+ return consecutiveFailures > 1 ? ` (${consecutiveFailures} consecutive failures)` : "";
6544
+ }
6130
6545
  function scheduleClaudeUsageReporting(state, options) {
6131
6546
  const { mode, warnings } = resolveClaudeUsageReportingMode(
6132
6547
  options.claudeUsageReporting,
@@ -6145,13 +6560,26 @@ function scheduleClaudeUsageReporting(state, options) {
6145
6560
  level: "debug",
6146
6561
  message: "Claude usage reporting is off (--claude-usage-reporting off)"
6147
6562
  });
6148
- return;
6563
+ return null;
6149
6564
  }
6150
6565
  let consecutiveFailures = 0;
6566
+ let armed = false;
6567
+ let rearmRequested = false;
6151
6568
  const scheduleNextTick = () => {
6569
+ armed = true;
6570
+ rearmRequested = false;
6152
6571
  state.claudeUsageTimer = setTimeout(() => void tick(false), nextReportDelayMs());
6153
6572
  };
6154
- const tick = async (isFirst) => {
6573
+ const rearm = () => {
6574
+ if (armed) {
6575
+ rearmRequested = true;
6576
+ return;
6577
+ }
6578
+ rearmRequested = false;
6579
+ armed = true;
6580
+ state.claudeUsageTimer = setTimeout(() => void tick(true), FIRST_REPORT_DELAY_MS);
6581
+ };
6582
+ const tick = async (isProbe) => {
6155
6583
  try {
6156
6584
  const usage = await getClaudeUsage();
6157
6585
  const result = await reportClaudeUsage(state.agentId, state.authHeader, usage);
@@ -6173,8 +6601,8 @@ function scheduleClaudeUsageReporting(state, options) {
6173
6601
  consecutiveFailures++;
6174
6602
  logActivity(state, {
6175
6603
  type: "info",
6176
- level: consecutiveFailures === 1 ? "warn" : "debug",
6177
- message: `Failed to report Claude usage: ${result.error}`
6604
+ level: claudeUsageFailureLogLevel(consecutiveFailures),
6605
+ message: `Failed to report Claude usage: ${result.error}${claudeUsageFailureStreakSuffix(consecutiveFailures)}`
6178
6606
  });
6179
6607
  }
6180
6608
  scheduleNextTick();
@@ -6187,12 +6615,14 @@ function scheduleClaudeUsageReporting(state, options) {
6187
6615
  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
6616
  });
6189
6617
  scheduleNextTick();
6190
- } else if (isFirst) {
6618
+ } else if (isProbe) {
6191
6619
  logActivity(state, {
6192
6620
  type: "info",
6193
6621
  level: "debug",
6194
6622
  message: `Claude usage reporting: ${error2.message}`
6195
6623
  });
6624
+ armed = false;
6625
+ if (rearmRequested) rearm();
6196
6626
  } else {
6197
6627
  logActivity(state, {
6198
6628
  type: "info",
@@ -6206,14 +6636,16 @@ function scheduleClaudeUsageReporting(state, options) {
6206
6636
  const message = error2 instanceof Error ? error2.message : String(error2);
6207
6637
  logActivity(state, {
6208
6638
  type: "info",
6209
- level: consecutiveFailures === 1 ? "warn" : "debug",
6210
- message: `Claude usage reporting failed: ${message}`
6639
+ level: claudeUsageFailureLogLevel(consecutiveFailures),
6640
+ message: `Claude usage reporting failed: ${message}${claudeUsageFailureStreakSuffix(consecutiveFailures)}`
6211
6641
  });
6212
6642
  scheduleNextTick();
6213
6643
  }
6214
6644
  }
6215
6645
  };
6646
+ armed = true;
6216
6647
  state.claudeUsageTimer = setTimeout(() => void tick(true), FIRST_REPORT_DELAY_MS);
6648
+ return rearm;
6217
6649
  }
6218
6650
  async function notifyOffline(state) {
6219
6651
  if (!state.agentId || !state.authHeader) return;
@@ -6254,6 +6686,7 @@ async function cleanup(state, opts = {}) {
6254
6686
  clearTimeout(state.claudeUsageTimer);
6255
6687
  state.claudeUsageTimer = null;
6256
6688
  }
6689
+ state.claudeUsageRearm = null;
6257
6690
  if (opts.graceful && state.channelDriver) {
6258
6691
  state.channelDriver.stop();
6259
6692
  log2(state, "Draining in-flight channel work before shutdown...");
@@ -6335,6 +6768,7 @@ async function run(options) {
6335
6768
  lastProxiedActivityAt: null,
6336
6769
  sessionCleanupTimers: [],
6337
6770
  claudeUsageTimer: null,
6771
+ claudeUsageRearm: null,
6338
6772
  authHeader: ""
6339
6773
  };
6340
6774
  setTelemetryAuthProvider(() => ({ authHeader: state.authHeader, agentId: state.agentId }));
@@ -6414,6 +6848,7 @@ async function run(options) {
6414
6848
  console.log(chalk6.dim("Or run `evident login` for interactive authentication"));
6415
6849
  blank();
6416
6850
  process.exit(1);
6851
+ return;
6417
6852
  }
6418
6853
  blank();
6419
6854
  console.log(chalk6.yellow("You are not logged in to Evident."));
@@ -6458,6 +6893,7 @@ async function run(options) {
6458
6893
  } else {
6459
6894
  printError(resolved.error || "Failed to resolve runner ID from key");
6460
6895
  process.exit(1);
6896
+ return;
6461
6897
  }
6462
6898
  } else {
6463
6899
  printError(
@@ -6471,6 +6907,7 @@ async function run(options) {
6471
6907
  );
6472
6908
  blank();
6473
6909
  process.exit(1);
6910
+ return;
6474
6911
  }
6475
6912
  }
6476
6913
  telemetry.info(
@@ -6718,7 +7155,7 @@ async function run(options) {
6718
7155
  throw error2;
6719
7156
  }
6720
7157
  scheduleSessionCleanup(state, channelDriver, options);
6721
- scheduleClaudeUsageReporting(state, options);
7158
+ state.claudeUsageRearm = scheduleClaudeUsageReporting(state, options);
6722
7159
  if (!interactive || state.json) {
6723
7160
  log2(state, "Driving channel messages...");
6724
7161
  }
@@ -6773,6 +7210,7 @@ program.name("evident").description("Run OpenCode locally and connect it to Evid
6773
7210
  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
7211
  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
7212
  program.command("whoami").description("Show the currently logged in user").action(whoami);
7213
+ 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
7214
  program.command("claude-usage").description("[spike] Show Claude subscription usage (requires a local `claude login`)").action(claudeUsage);
6777
7215
  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
7216
  "-a, --agent [id]",
@@ -6802,7 +7240,7 @@ program.command("run").description("Connect to Evident and process messages").op
6802
7240
  []
6803
7241
  ).option(
6804
7242
  "--tunnel-ready-file <path>",
6805
- "Path to write once the tunnel is connected (set by the MicroVM hooks; unused on a developer machine)"
7243
+ "Path to write once the tunnel is connected (opt-in; unused unless an operator/image sets it)"
6806
7244
  ).action(
6807
7245
  (options) => {
6808
7246
  run({