@tryarcanist/cli 0.1.99 → 0.1.101

package/README.md

@@ -34,7 +34,7 @@ arcanist auth login
 
 Token config is stored at `~/.arcanist/config.json`. Multiple active tokens per user are supported; revoke tokens independently when a device or workflow no longer needs access.
 
-Use a read-scoped token for inspection and debugging. Use a write-scoped token only when you need to create sessions, send prompts, or stop runs.
+Use a read-scoped token for inspection and debugging; use a write-scoped token only to create sessions, send prompts, or stop runs.
 
 You can also pipe the token via stdin:
 
@@ -55,7 +55,7 @@ export ARCANIST_TOKEN=arc_...
 export ARCANIST_API_URL=https://app.tryarcanist.com
 ```
 
-`--token` and `--api-url` are available for one-off invocations. Prefer `ARCANIST_TOKEN` over `--token` for persistent use because CLI flags can appear in shell history and process lists.
+`--token` and `--api-url` are available for one-off invocations. Prefer `ARCANIST_TOKEN` over `--token` for persistent use; CLI flags can appear in shell history and process lists.
 
 Non-local API URLs must use HTTPS and must not embed credentials.
 
@@ -128,17 +128,17 @@ arcanist sessions create your-org/your-repo "verify the deployed change" --cold
 arcanist sessions create your-org/your-repo "retry-safe create" --idempotency-key 1f0e6f1a-...
 ```
 
-Use `--backend` to pick the agent runtime backend: `codex` (default) or `claude_code`. The `--model` must be valid for the chosen backend — codex runs OpenAI models (`gpt-5.5` default, `gpt-5.4`), `claude_code` runs Anthropic models (`claude-opus-4-8` default, `claude-sonnet-4-6`) — and the CLI rejects a mismatch before any network call. `claude_code` sessions require an Anthropic API key configured in Settings.
+`--backend` picks the agent runtime backend: `codex` (default) or `claude_code`. `--model` must be valid for the chosen backend — codex runs OpenAI models (`gpt-5.5` default, `gpt-5.4`), `claude_code` runs Anthropic models (`claude-opus-4-8` default, `claude-sonnet-4-6`) — and the CLI rejects a mismatch before any network call. `claude_code` sessions require an Anthropic API key configured in Settings.
 
-Use `--wait` to block until the created prompt finishes. The command exits non-zero if the prompt finishes with `status: failed`, which makes it suitable for cron or other schedulers that alert on command failure. Use `--poll-interval <ms>` to tune how often the CLI checks for completion.
+`--wait` blocks until the created prompt finishes and exits non-zero if the prompt finishes with `status: failed`, making it suitable for cron or other schedulers that alert on command failure. `--poll-interval <ms>` tunes the completion check frequency.
 
-Use repeatable `--uploaded-file <path>` flags to attach local UTF-8 text files to the prompt. Uploaded file names come from the local basename; directory components are not sent.
+Repeatable `--uploaded-file <path>` flags attach local UTF-8 text files to the prompt. Uploaded file names come from the local basename; directory components are not sent.
 
-Use `--cold` to force a fresh sandbox and skip the warm pool. This is useful for verifying freshly deployed code when a pre-warmed sandbox may predate the deploy.
+`--cold` forces a fresh sandbox and skips the warm pool — useful for verifying freshly deployed code when a pre-warmed sandbox may predate the deploy.
 
-Use `--idempotency-key <uuid>` when manually retrying a create request that may have reached the server. The CLI derives separate session and prompt idempotency keys from the provided value.
+`--idempotency-key <uuid>` is for manually retrying a create request that may have reached the server. The CLI derives separate session and prompt idempotency keys from the provided value.
 
-JSON mode returns `{sessionId, sessionUrl?, repoUrl, model?, agentRuntimeBackend?, reasoningEffort?, promptId?}`. `sessionUrl` is emitted only when the server returns it; `agentRuntimeBackend` is emitted only when `--backend` is passed.
+JSON mode returns `{sessionId, sessionUrl?, repoUrl, model?, agentRuntimeBackend?, reasoningEffort?, promptId?}`. `sessionUrl` is emitted only when the server returns it; `agentRuntimeBackend` only when `--backend` is passed.
 
 ### `arcanist sessions send <session-id> [prompt]`
 
@@ -155,7 +155,7 @@ JSON mode returns `{sessionId, promptId?}`.
 
 ### `arcanist sessions stop <session-id>`
 
-Stops the active run for a session. Stop is idempotent: if no sandbox is active, the server returns `already_stopped`.
+Stops the active run for a session. Idempotent: if no sandbox is active, the server returns `already_stopped`.
 
 ```bash
 arcanist sessions stop abc123
@@ -190,7 +190,7 @@ arcanist sessions search "mcp debugging" --repo your-org/your-repo --json
 arcanist sessions search "repo access" --status idle --scope business --limit 20 --cursor <cursor>
 ```
 
-Search uses the same metadata-only index and filters as `sessions list`: `--status`, `--scope`, `--repo`, `--limit`, and `--cursor`.
+Uses the same metadata-only index and filters as `sessions list`: `--status`, `--scope`, `--repo`, `--limit`, and `--cursor`.
 
 ### `arcanist sessions events <session-id>`
 

package/dist/index.js

@@ -862,6 +862,22 @@ function noChangeOutcomeCopy(reason) {
   }
 }
 
+// ../../shared/session/transient-disconnect.ts
+var TRANSIENT_DISCONNECT_VISIBILITY_MS = 15e3;
+function nextDisconnectMask(mask, previous, current, now) {
+  if (!current || current.sandboxSubstate !== "reconnecting") return null;
+  if (mask) return mask;
+  if (!previous || previous.sandboxSubstate === "reconnecting") return null;
+  return { since: now, heldPhase: previous.phase, heldSubstate: previous.sandboxSubstate ?? "none" };
+}
+function isDisconnectMaskActive(mask, now) {
+  return mask !== null && now - mask.since < TRANSIENT_DISCONNECT_VISIBILITY_MS;
+}
+function applyDisconnectMask(view, mask, now) {
+  if (!isDisconnectMaskActive(mask, now)) return view;
+  return { ...view, phase: mask.heldPhase, sandboxSubstate: mask.heldSubstate };
+}
+
 // ../../shared/transcript/malformed-search.ts
 var MALFORMED_SEARCH_BLOCKED_TRANSCRIPT_PREFIX = "Arcanist blocked this malformed search command before execution.";
 var BASH_UNMATCHED_QUOTE_EOF_RE = /\/bin\/bash:\s+-c:\s+line\s+\d+:\s+unexpected EOF while looking for matching [`'"][`'"]?/i;
@@ -1244,6 +1260,24 @@ function projectRetryStatus(data, index) {
     ...typeof data?.retryAfterMs === "number" ? { retryAfterMs: data.retryAfterMs } : {}
   };
 }
+function projectPromptRetrying(data, index) {
+  const attempt = typeof data?.attempt === "number" ? data.attempt : Number(data?.attempt ?? 0);
+  const cap = typeof data?.cap === "number" ? data.cap : void 0;
+  const retryPromptId = typeof data?.retryPromptId === "string" ? data.retryPromptId : resolvePromptId(data);
+  return {
+    type: "retry_status",
+    // Key off retryPromptId (always present in the emitted payload, unique per
+    // retry) rather than the index, so the id is stable across replays. The
+    // event's `timestamp` lives at the top level, not inside `data`.
+    id: `pr-retry-${retryPromptId ?? index}`,
+    ...retryPromptId ? { promptId: retryPromptId } : {},
+    attempt,
+    message: "Sandbox dropped mid-task; retrying on a fresh sandbox",
+    scope: "sandbox_disconnect",
+    ...cap !== void 0 ? { maxAttempts: cap } : {},
+    ...typeof data?.reason === "string" ? { reason: data.reason } : {}
+  };
+}
 function projectBranchChanged(data, index) {
   return {
     type: "branch_changed",
@@ -1515,6 +1549,9 @@ function flattenSessionEvents(raw) {
       case "retry_status":
         pushEvent(state, projectRetryStatus(data, state.merged.length));
         break;
+      case "prompt_retrying":
+        pushEvent(state, projectPromptRetrying(data, state.merged.length));
+        break;
       case "branch_changed":
         pushEvent(state, projectBranchChanged(data, state.merged.length));
         break;
@@ -2139,6 +2176,12 @@ function formatStatusLine(status) {
   if (status.spawnDurationMs != null) details.push(`spawn ${(status.spawnDurationMs / 1e3).toFixed(1)}s`);
   return details.length > 0 ? `[status] ${phaseLabel} | ${details.join(" | ")}` : `[status] ${phaseLabel}`;
 }
+function advanceStatusDisconnectMask(status, mask, lastView, now) {
+  const view = status.phase ? { phase: status.phase, sandboxSubstate: status.sandboxSubstate } : null;
+  const nextMask = nextDisconnectMask(mask, lastView, view, now);
+  const displayStatus = view ? { ...status, ...applyDisconnectMask(view, nextMask, now) } : status;
+  return { displayStatus, mask: nextMask, view };
+}
 async function printNoChangeOutcome(config, sessionId) {
   try {
     const data = await apiFetch(
@@ -2197,6 +2240,8 @@ async function watchCommand(sessionId, options, command) {
   let afterSequence = initialAfterSequence;
   let lastStatusLine = null;
   let textOpen = false;
+  let disconnectMask = null;
+  let lastStatusView = null;
   if (!json) console.log(`Watching session ${sessionId}...`);
   try {
     while (true) {
@@ -2208,7 +2253,10 @@ async function watchCommand(sessionId, options, command) {
       const parsed = parseSsePayload(payload);
       const receivedFullPage = parsed.events.length >= pageSize;
       if (!json && parsed.status) {
-        const nextStatusLine = formatStatusLine(parsed.status);
+        const advanced = advanceStatusDisconnectMask(parsed.status, disconnectMask, lastStatusView, Date.now());
+        disconnectMask = advanced.mask;
+        lastStatusView = advanced.view;
+        const nextStatusLine = formatStatusLine(advanced.displayStatus);
         if (nextStatusLine !== lastStatusLine) {
           if (textOpen) {
             process.stdout.write("\n");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tryarcanist/cli",
-  "version": "0.1.99",
+  "version": "0.1.101",
   "description": "CLI for Arcanist — create and manage coding agent sessions",
   "type": "module",
   "bin": {