@tryarcanist/cli 0.1.147 → 0.1.149

package/README.md

@@ -119,6 +119,7 @@ Creates a new session and sends the initial prompt.
 ```bash
 arcanist sessions create https://github.com/your-org/your-repo "fix the login bug"
 arcanist sessions create your-org/your-repo "continue this work" --start-branch wip/resume-me
+arcanist sessions create your-org/your-repo "finish this PR" --continue-pr https://github.com/your-org/your-repo/pull/123
 printf "add tests" | arcanist sessions create your-org/your-repo --prompt-stdin --json
 printf "add tests" | arcanist sessions create your-org/your-repo --prompt-stdin --wait
 arcanist sessions create your-org/your-repo - --model gpt-5.5
@@ -138,6 +139,8 @@ Use `--base-branch <branch>` to target a non-default base branch. The CLI only v
 
 Use `--start-branch <branch>` to resume an existing branch with its history instead of forking a fresh branch off base; the control plane verifies the branch exists on the remote and fails closed if it does not.
 
+Use `--continue-pr <url>` to continue an open same-repo pull request. The control plane checks out the PR head branch before the prompt runs. `--continue-mode update-pr` updates the referenced PR; `--continue-mode new-pr` starts from that PR head but leaves publish free to open a fresh PR. `auto` is the default and currently resolves to same-PR update for supported open same-repo PRs.
+
 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.
 
 `--cold` is a deprecated no-op retained for backward compatibility. Sessions always start from a fresh sandbox (the warm sandbox pool was removed), so the flag has no effect.
@@ -146,7 +149,7 @@ Repeatable `--uploaded-file <path>` flags attach local UTF-8 text files to the p
 
 `--onboarding` creates an onboarding session: the agent authors the repo's `.arcanist.json`, `.arcanist/` runtime files, `ARCANIST.md`, and conditionally `.arcanist/sandbox.yaml` + `.arcanist/sandbox.layer.Dockerfile` (when the base sandbox lacks a needed toolchain), proves what it can inside its sandbox, and opens the setup PR ready for review. The onboarding behavior is driven by the bridge's canonical onboarding playbook, not the prompt, so `--onboarding` needs no prompt: `arcanist sessions create <repo> --onboarding --wait`. Any prompt supplied alongside `--onboarding` is ignored. Team use; not part of the external API surface.
 
-JSON mode returns `{sessionId, sessionUrl?, repoUrl, model?, agentRuntimeBackend?, reasoningEffort?, baseBranch?, startBranch?, onboarding?, promptId?}`. `sessionUrl` is emitted only when the server returns it; `agentRuntimeBackend` only when `--backend` is passed. With `--wait`, JSON mode also includes best-effort result fields when available: `prUrl?`, `publishedBranch?`, and `lastBranch?`.
+JSON mode returns `{sessionId, sessionUrl?, repoUrl, model?, agentRuntimeBackend?, reasoningEffort?, baseBranch?, startBranch?, continuePrUrl?, continueMode?, onboarding?, promptId?}`. `sessionUrl` is emitted only when the server returns it; `agentRuntimeBackend` only when `--backend` is passed. With `--wait`, JSON mode also includes best-effort result fields when available: `prUrl?`, `publishedBranch?`, and `lastBranch?`.
 
 ### `arcanist sessions send <session-id> [prompt]`
 

package/dist/index.js

@@ -568,6 +568,7 @@ var OpenAIModel = {
   GPT54Pro: "gpt-5.4-pro",
   GPT54Mini: "gpt-5.4-mini",
   GPT54Nano: "gpt-5.4-nano",
+  GPT53CodexSpark: "gpt-5.3-codex-spark",
   GPT53Codex: "gpt-5.3-codex",
   GPT52: "gpt-5.2",
   GPT52ChatLatest: "gpt-5.2-chat-latest",
@@ -585,17 +586,6 @@ var MODEL_PROVIDERS_SET = /* @__PURE__ */ new Set([
   "anthropic",
   "baseten"
 ]);
-var SESSION_START_MODEL_IDS_BY_BACKEND = {
-  [CODEX_AGENT_RUNTIME_BACKEND]: [OpenAIModel.GPT55, OpenAIModel.GPT54, OpenAIModel.GPT54Nano],
-  [CLAUDE_CODE_AGENT_RUNTIME_BACKEND]: [AnthropicModel.Opus48, AnthropicModel.Sonnet46],
-  [OPENCODE_AGENT_RUNTIME_BACKEND]: [BasetenModel.GptOss120B]
-};
-var DEFAULT_SESSION_START_MODEL_ID_BY_BACKEND = {
-  [CODEX_AGENT_RUNTIME_BACKEND]: OpenAIModel.GPT54,
-  [CLAUDE_CODE_AGENT_RUNTIME_BACKEND]: AnthropicModel.Opus48,
-  [OPENCODE_AGENT_RUNTIME_BACKEND]: BasetenModel.GptOss120B
-};
-var DEFAULT_SESSION_START_MODEL_ID = DEFAULT_SESSION_START_MODEL_ID_BY_BACKEND[CODEX_AGENT_RUNTIME_BACKEND];
 var MODEL_REGISTRY = [
   {
     id: OpenAIModel.GPT54,
@@ -616,7 +606,8 @@ var MODEL_REGISTRY = [
         outputPerMillion: 22.5,
         cacheReadPerMillion: 0.5
       }
-    }
+    },
+    sessionStart: { eligible: true, isDefault: true }
   },
   {
     id: OpenAIModel.GPT55,
@@ -635,7 +626,8 @@ var MODEL_REGISTRY = [
         outputPerMillion: 45,
         cacheReadPerMillion: 1
       }
-    }
+    },
+    sessionStart: { eligible: true }
   },
   {
     id: OpenAIModel.GPT54Mini,
@@ -662,7 +654,20 @@ var MODEL_REGISTRY = [
     backends: [CODEX_AGENT_RUNTIME_BACKEND],
     contextWindow: 4e5,
     reasoning: { efforts: ["none", "low", "medium", "high", "xhigh"], default: void 0 },
-    pricing: { inputPerMillion: 0.2, outputPerMillion: 1.25, cacheReadPerMillion: 0.02 }
+    pricing: { inputPerMillion: 0.2, outputPerMillion: 1.25, cacheReadPerMillion: 0.02 },
+    sessionStart: { eligible: true }
+  },
+  {
+    id: OpenAIModel.GPT53CodexSpark,
+    name: "GPT-5.3 Codex Spark",
+    provider: "openai",
+    backends: [CODEX_AGENT_RUNTIME_BACKEND],
+    contextWindow: 128e3,
+    reasoning: { efforts: ["low", "medium", "high", "xhigh"], default: "high" },
+    costTracked: false,
+    requiresCodexSubscriptionAuth: true,
+    sessionStart: { eligible: true },
+    visibility: "internal_probe"
   },
   {
     id: OpenAIModel.GPT53Codex,
@@ -713,7 +718,8 @@ var MODEL_REGISTRY = [
     // Bridge cost-ESTIMATE only; NOT authoritative for control-plane Anthropic
     // billing. `anthropic/cost.ts` ANTHROPIC_MESSAGES_MODEL_PRICING owns that
     // and is intentionally ~3x divergent until Phase 5.
-    pricing: { inputPerMillion: 5, outputPerMillion: 25, cacheReadPerMillion: 0.5, cacheWritePerMillion: 6.25 }
+    pricing: { inputPerMillion: 5, outputPerMillion: 25, cacheReadPerMillion: 0.5, cacheWritePerMillion: 6.25 },
+    sessionStart: { eligible: true, isDefault: true }
   },
   {
     id: AnthropicModel.Sonnet46,
@@ -727,7 +733,8 @@ var MODEL_REGISTRY = [
     // Bridge cost-ESTIMATE only; NOT authoritative for control-plane Anthropic
     // billing. `anthropic/cost.ts` ANTHROPIC_MESSAGES_MODEL_PRICING owns that
     // and is intentionally ~3x divergent until Phase 5.
-    pricing: { inputPerMillion: 3, outputPerMillion: 15, cacheReadPerMillion: 0.3, cacheWritePerMillion: 3.75 }
+    pricing: { inputPerMillion: 3, outputPerMillion: 15, cacheReadPerMillion: 0.3, cacheWritePerMillion: 3.75 },
+    sessionStart: { eligible: true }
   },
   {
     id: BasetenModel.GptOss120B,
@@ -741,7 +748,8 @@ var MODEL_REGISTRY = [
     // Internal cold-spawn bridge ESTIMATE, NOT authoritative Baseten API
     // billing. `baseten/cost.ts` BASETEN_MODEL_API_PRICING (wire-id keyed)
     // owns real billing.
-    pricing: { inputPerMillion: 0, outputPerMillion: 0 }
+    pricing: { inputPerMillion: 0, outputPerMillion: 0 },
+    sessionStart: { eligible: true, isDefault: true }
   }
 ];
 var MODEL_PROVIDER_NAMES = {
@@ -749,6 +757,32 @@ var MODEL_PROVIDER_NAMES = {
   anthropic: "Anthropic",
   baseten: "Baseten"
 };
+function buildSessionStartModelIdsByBackend() {
+  const byBackend = Object.fromEntries(AGENT_RUNTIME_BACKENDS.map((backend) => [backend, []]));
+  for (const model of MODEL_REGISTRY) {
+    if (!model.sessionStart?.eligible) continue;
+    for (const backend of model.backends) {
+      byBackend[backend].push(model.id);
+    }
+  }
+  return byBackend;
+}
+function buildDefaultSessionStartModelIdByBackend() {
+  const defaults = {};
+  for (const backend of AGENT_RUNTIME_BACKENDS) {
+    const backendDefaults = MODEL_REGISTRY.filter(
+      (model) => model.sessionStart?.eligible && model.sessionStart.isDefault === true && model.backends.includes(backend)
+    );
+    if (backendDefaults.length !== 1) {
+      throw new Error(`Expected exactly one default session-start model for ${backend}, got ${backendDefaults.length}`);
+    }
+    defaults[backend] = backendDefaults[0].id;
+  }
+  return defaults;
+}
+var SESSION_START_MODEL_IDS_BY_BACKEND = buildSessionStartModelIdsByBackend();
+var DEFAULT_SESSION_START_MODEL_ID_BY_BACKEND = buildDefaultSessionStartModelIdByBackend();
+var DEFAULT_SESSION_START_MODEL_ID = DEFAULT_SESSION_START_MODEL_ID_BY_BACKEND[CODEX_AGENT_RUNTIME_BACKEND];
 var VALID_MODEL_IDS = new Set(MODEL_REGISTRY.map((model) => model.id));
 var VALID_SESSION_START_MODEL_IDS_BY_BACKEND = {
   [CODEX_AGENT_RUNTIME_BACKEND]: new Set(SESSION_START_MODEL_IDS_BY_BACKEND[CODEX_AGENT_RUNTIME_BACKEND]),
@@ -813,21 +847,6 @@ function getSessionStartModelIdsForBackend(backend) {
 function isSessionStartModelAllowedForBackend(modelId, backend) {
   return VALID_SESSION_START_MODEL_IDS_BY_BACKEND[backend].has(modelId);
 }
-var MODEL_TIER_BY_ID = {
-  [OpenAIModel.GPT55]: "frontier",
-  [OpenAIModel.GPT54]: "mid",
-  [OpenAIModel.GPT54Nano]: "mid",
-  [AnthropicModel.Opus48]: "frontier",
-  [AnthropicModel.Sonnet46]: "mid",
-  [BasetenModel.GptOss120B]: "mid"
-};
-var CODEX_MODEL_ID_BY_TIER = {
-  // Single source of truth: the frontier codex model follows the codex default,
-  // so changing the default propagates here automatically. Only used for
-  // non-codex (e.g. claude) parents — codex parents verify on their own model.
-  frontier: DEFAULT_SESSION_START_MODEL_ID_BY_BACKEND[CODEX_AGENT_RUNTIME_BACKEND],
-  mid: OpenAIModel.GPT54
-};
 function getProviderForModel(modelId) {
   return MODEL_PROVIDERS[modelId] ?? "openai";
 }
@@ -884,6 +903,11 @@ var PUBLIC_SESSION_START_MODEL_PROVIDER_GROUPS = buildModelProviderGroups(
     (model) => SESSION_START_MODEL_ID_SET_ANY_BACKEND.has(model.id) && model.visibility !== "internal_probe"
   )
 );
+var CODEX_SUBSCRIPTION_SESSION_START_MODEL_PROVIDER_GROUPS = buildModelProviderGroups(
+  MODEL_REGISTRY.filter(
+    (model) => SESSION_START_MODEL_ID_SET_ANY_BACKEND.has(model.id) && (model.visibility !== "internal_probe" || model.requiresCodexSubscriptionAuth === true)
+  )
+);
 
 // ../../shared/utils/timing.ts
 function sleep(ms) {
@@ -897,6 +921,7 @@ function isRepoSession(sessionKind) {
 }
 var TERMINAL_PHASES_ARRAY = [
   "completed",
+  "superseded",
   "blocked",
   "failed",
   "stopped",
@@ -2045,7 +2070,9 @@ var VALID_PHASES = /* @__PURE__ */ new Set([
   "running",
   "waiting_for_input",
   "finalizing",
+  "review_listening",
   "completed",
+  "superseded",
   "blocked",
   "failed",
   "stopped",
@@ -2598,6 +2625,7 @@ function validateRepoUrl(url) {
 }
 var PROMPT_TERMINAL_STATUSES = /* @__PURE__ */ new Set(["completed", "failed"]);
 var RESULT_FETCH_ATTEMPTS = 5;
+var SESSION_CREATE_PROMPT_PREVIEW_MAX_CHARS = 4e3;
 var ONBOARDING_PROMPT = "Onboard this repository onto Arcanist.";
 function selectCreatedPrompt(prompts, promptId) {
   if (prompts.length === 0) return null;
@@ -2613,6 +2641,11 @@ function buildPromptFailureError(sessionId, prompt, sessionUrl) {
     hint: `Inspect with: arcanist sessions transcript ${sessionId}`
   });
 }
+function buildSessionCreatePromptPreview(prompt) {
+  const trimmed = prompt.trim();
+  if (!trimmed) return void 0;
+  return trimmed.length > SESSION_CREATE_PROMPT_PREVIEW_MAX_CHARS ? trimmed.slice(0, SESSION_CREATE_PROMPT_PREVIEW_MAX_CHARS).trimEnd() : trimmed;
+}
 async function fetchCreatedPromptStatus(config, sessionId, promptId) {
   const promptList = await apiFetch(config, `/api/sessions/${sessionId}/prompts`);
   return selectCreatedPrompt(promptList.prompts, promptId);
@@ -2716,6 +2749,14 @@ async function createCommand(repoUrl, promptArg, options, command) {
   if (options.startBranch !== void 0 && !startBranch) {
     throw new CliError("user", "--start-branch must not be empty.");
   }
+  const continuePr = options.continuePr?.trim();
+  if (options.continuePr !== void 0 && !continuePr) {
+    throw new CliError("user", "--continue-pr must not be empty.");
+  }
+  const continueMode = options.continueMode?.trim();
+  if (options.continueMode !== void 0 && !continueMode) {
+    throw new CliError("user", "--continue-mode must not be empty.");
+  }
   const uploadedFiles = await resolveUploadedFileOptions(options.uploadedFile);
   const idempotencyKey = options.idempotencyKey ?? randomIdempotencyKey();
   const sessionIdempotencyKey = `${idempotencyKey}:session`;
@@ -2724,8 +2765,12 @@ async function createCommand(repoUrl, promptArg, options, command) {
   if (options.model) body.model = options.model;
   if (options.backend) body.agentRuntimeBackend = agentRuntimeBackend;
   if (options.reasoningEffort) body.reasoningEffort = options.reasoningEffort;
+  const promptPreview = buildSessionCreatePromptPreview(prompt);
+  if (promptPreview) body.prompt = promptPreview;
   if (baseBranch) body.baseBranch = baseBranch;
   if (startBranch) body.startBranch = startBranch;
+  if (continuePr) body.continuePrUrl = continuePr;
+  if (continueMode) body.continueMode = continueMode;
   if (options.cold) body.cold = true;
   if (options.onboarding) body.onboarding = true;
   const sessionData = await apiFetch(config, "/api/sessions", {
@@ -2789,6 +2834,8 @@ async function createCommand(repoUrl, promptArg, options, command) {
     if (options.reasoningEffort) output.reasoningEffort = options.reasoningEffort;
     if (baseBranch) output.baseBranch = baseBranch;
     if (startBranch) output.startBranch = startBranch;
+    if (continuePr) output.continuePrUrl = continuePr;
+    if (continueMode) output.continueMode = continueMode;
     if (options.onboarding) output.onboarding = true;
     if (promptId) output.promptId = promptId;
     Object.assign(output, waitResultFields);
@@ -4467,7 +4514,7 @@ function addCreateOptions(cmd) {
   return cmd.argument("<repo-url>", "Repository URL").argument("[prompt]", "Prompt to send, or '-' to read stdin").option("--model <model>", "Model to use").option("--backend <backend>", "Agent runtime backend: codex (default), claude_code, or opencode").option("--reasoning-effort <effort>", "Reasoning effort to use for models that support it").option("--base-branch <branch>", "Base branch to create the session against (defaults to the repo default branch)").option(
     "--start-branch <branch>",
     "Resume an existing branch with its history instead of forking a new one off base"
-  ).option("--prompt-stdin", "Read prompt from stdin").option(
+  ).option("--continue-pr <url>", "Continue from an existing same-repo pull request").option("--continue-mode <mode>", "Continuation mode: auto (default), update-pr, or new-pr").option("--prompt-stdin", "Read prompt from stdin").option(
     "--uploaded-file <path>",
     "Attach a local text file to the prompt as uploadedFiles; repeat for multiple files",
     collectUploadedFileOption
@@ -4480,13 +4527,14 @@ function addCreateOptions(cmd) {
     `
 Examples:
   arcanist sessions create https://github.com/org/repo "fix bug"
+  arcanist sessions create https://github.com/org/repo "finish this PR" --continue-pr https://github.com/org/repo/pull/123
   arcanist sessions create https://github.com/org/repo "review this trace" --uploaded-file trace.txt
   printf "fix bug" | arcanist sessions create https://github.com/org/repo --prompt-stdin --json
   printf "fix bug" | arcanist sessions create https://github.com/org/repo --prompt-stdin --wait
   arcanist sessions create https://github.com/org/repo - --json | jq -r .sessionId | xargs -I{} arcanist sessions events {} --follow --json
 
 JSON:
-JSON mode returns {sessionId, sessionUrl?, repoUrl, model?, agentRuntimeBackend?, reasoningEffort?, baseBranch?, startBranch?, onboarding?, promptId?}
+JSON mode returns {sessionId, sessionUrl?, repoUrl, model?, agentRuntimeBackend?, reasoningEffort?, baseBranch?, startBranch?, continuePrUrl?, continueMode?, onboarding?, promptId?}
 --wait --json also includes best-effort result fields when available: prUrl?, publishedBranch?, lastBranch?
   Follow async progress with: arcanist sessions events <session-id> --follow --json
 `

package/package.json

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