@lambdacurry/arbor 0.24.30 → 0.24.32

package/dist/arbor.js

@@ -66,6 +66,9 @@ function parseErrorDetails(value) {
     details.limit = raw.limit;
   if (typeof raw.retryable === "boolean")
     details.retryable = raw.retryable;
+  if (typeof raw.retryAfterMs === "number" && Number.isFinite(raw.retryAfterMs) && raw.retryAfterMs >= 0) {
+    details.retryAfterMs = raw.retryAfterMs;
+  }
   if (typeof raw.phase === "string")
     details.phase = raw.phase;
   if (raw.provider && typeof raw.provider === "object" && !Array.isArray(raw.provider)) {
@@ -81,6 +84,19 @@ function parseErrorDetails(value) {
       };
     }
   }
+  if (typeof raw.providerCode === "string")
+    details.providerCode = raw.providerCode;
+  if (raw.providerDetails && typeof raw.providerDetails === "object" && !Array.isArray(raw.providerDetails)) {
+    const scalars = Object.entries(raw.providerDetails).filter((entry) => typeof entry[1] === "string" || typeof entry[1] === "number" || typeof entry[1] === "boolean");
+    if (scalars.length > 0)
+      details.providerDetails = Object.fromEntries(scalars);
+  }
+  if (typeof raw.runStartId === "string")
+    details.runStartId = raw.runStartId;
+  if (typeof raw.runCreated === "boolean")
+    details.runCreated = raw.runCreated;
+  if (typeof raw.computerSessionId === "string")
+    details.computerSessionId = raw.computerSessionId;
   if (typeof raw.runId === "string")
     details.runId = raw.runId;
   if (typeof raw.operationId === "string")
@@ -12241,7 +12257,9 @@ function buildOutputSchemas() {
           runId: id,
           runCreated: literal(false),
           status: literal("provisioning"),
-          phase: literal("run.admission")
+          phase: literal("run.admission"),
+          idempotencyKey: string2(),
+          nextAction: literal("computer_run_start").describe("No Run exists yet (still provisioning, or stopped before one existed): retry computer_run_start with the same inputs and this idempotencyKey; it replays or resumes this start, never a second Run.")
         })
       ])
     }),
@@ -16749,7 +16767,7 @@ var ACTIONS = ACTION_DEFINITIONS.map((action) => {
 });
 
 // ../actions/src/retention-entry.ts
-var ARBOR_VERSION = "0.24.30";
+var ARBOR_VERSION = "0.24.32";
 var historyPolicySchema = _enum(["full", "checkpoint"]).optional().describe("text Artifacts: future history retention policy; full retains every source snapshot, checkpoint keeps metadata for every revision and source only when explicitly retained");
 var retainSourceSchema = boolean2().optional().describe("edit: in checkpoint mode, retain this newly minted content revision's source");
 var checkpointSchema = boolean2().optional().describe("edit: retain the exact current version source without incrementing content version");
@@ -17157,7 +17175,7 @@ function dispositionFilename(value) {
 // package.json
 var package_default = {
   name: "@lambdacurry/arbor",
-  version: "0.24.30",
+  version: "0.24.32",
   description: "The Arbor CLI — a shared workspace for people and agents. The human + headless-agent write path over Arbor's guarded operation surface.",
   keywords: [
     "agents",
@@ -17593,6 +17611,35 @@ async function waitForComputerExec(executor, input, value, ctx) {
   return withContinuation(latest);
 }
 
+// src/computer-run-start-wait.ts
+init_errors();
+var DEFAULT_SETUP_RETRY_AFTER_MS = 30000;
+function isSetupPendingRefusal(details) {
+  return details?.retryable === true && details.suggestedAction === "computer_run_start" && details.phase === "computer.open";
+}
+function sleep2(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function startComputerRunWithWait(action, executor, input, waitMs, ctx) {
+  const deadline = Date.now() + waitMs;
+  for (;; ) {
+    try {
+      return await action.run(executor, input);
+    } catch (err) {
+      const details = detailsForError(err);
+      if (!isSetupPendingRefusal(details))
+        throw err;
+      const delay = typeof details?.retryAfterMs === "number" && details.retryAfterMs > 0 ? details.retryAfterMs : DEFAULT_SETUP_RETRY_AFTER_MS;
+      const remaining = deadline - Date.now();
+      if (delay > remaining)
+        throw err;
+      advise(`Computer setup is still running; retrying computer_run_start with the same idempotencyKey in ${Math.round(delay / 1000)}s (${Math.round(remaining / 1000)}s of --wait-ms left).
+`, ctx);
+      await sleep2(delay);
+    }
+  }
+}
+
 // src/commands.ts
 init_errors();
 
@@ -18163,7 +18210,7 @@ Aliases: ${aliases.map((alias) => `\`arbor ${alias}\``).join(", ")} (tool-name f
   const heading = `${commandWords(action)}${aliases.length === 1 ? ` (alias: ${aliases[0]})` : aliases.length > 1 ? ` (aliases: ${aliases.join(", ")})` : ""}`;
   const waitLines = action.name === "computer_exec" ? [
     "  --no-wait [<boolean>]  [optional] — return a running processId immediately instead of polling computer_process_read (implied by --background); mutually exclusive with --wait-for-terminal-ms"
-  ] : [];
+  ] : action.name === "computer_run_start" ? [`  --wait-ms <number>  [optional] — ${WAIT_MS_DESCRIPTION}`] : [];
   const notes = action.cliHelpNotes ? `
 
 ${action.cliHelpNotes}` : "";
@@ -18176,9 +18223,10 @@ ${lines.join(`
 `)}${primaryNote}${explicitNote}${aliasNote}${notes}
 `;
   }
+  const waitUsage = action.name === "computer_exec" ? " [--no-wait]" : action.name === "computer_run_start" ? " [--wait-ms <number>]" : "";
   return `${heading} — ${action.description}
 
-${usage}${waitLines.length > 0 ? " [--no-wait]" : ""}
+${usage}${waitUsage}
 
 ${[...lines, ...waitLines].join(`
 `)}${primaryNote}${explicitNote}${aliasNote}${notes}
@@ -18205,6 +18253,15 @@ function commandCatalog(actions = CLI_ACTIONS) {
           acceptsFile: false,
           description: "return a running processId immediately instead of polling computer_process_read; mutually exclusive with --wait-for-terminal-ms"
         }
+      ] : [],
+      ...action.name === "computer_run_start" ? [
+        {
+          flag: "wait-ms",
+          kind: "number",
+          required: false,
+          acceptsFile: false,
+          description: WAIT_MS_DESCRIPTION
+        }
       ] : []
     ]
   }));
@@ -18248,6 +18305,20 @@ function resolveCommand(positionals, flags) {
   const bareFeedbackTree = normalized.length === 1 && normalized[0] === "feedback" && !explicitFeedbackInput;
   return bareFeedbackTree ? { action: CLI_ACTIONS.find((action) => action.name === "feedback_tree"), words: 1 } : matchCommand(positionals);
 }
+var WAIT_MS_DESCRIPTION = "CLI-only: while Arbor answers that Computer setup is still running (retryable, suggestedAction computer_run_start), wait each retryAfterMs and repeat this exact start with the same idempotencyKey for up to this many milliseconds; a terminal setup failure or any other error returns at once. Omit for one attempt";
+function parseWaitMs(value) {
+  const raw = stringFlag(value, "wait-ms");
+  if (raw === undefined)
+    return;
+  const ms = Number(raw);
+  if (!Number.isInteger(ms) || ms < 0) {
+    throw new UsageError(`--wait-ms expects a non-negative whole number of milliseconds, got "${raw}"`, {
+      reason: "validation.invalid_value",
+      field: "waitMs"
+    });
+  }
+  return ms;
+}
 async function runObjectVerb(positionals, flags, ctx) {
   const match = resolveCommand(positionals, flags);
   if (!match) {
@@ -18258,6 +18329,8 @@ async function runObjectVerb(positionals, flags, ctx) {
   const action = { ...match.action, inputSchema: canonicalInputShape(match.action) };
   applyPositionals(action, positionals.slice(words), flags);
   const accepted = acceptedFlags(action.inputSchema);
+  if (action.name === "computer_run_start")
+    accepted.add("wait-ms");
   const unknown = Object.keys(flags).filter((f) => !accepted.has(f) && !RESERVED_FLAGS.has(f));
   if (unknown.length > 0) {
     const hints = unknown.map((f) => listFileHint(action, f)).filter(Boolean);
@@ -18287,6 +18360,7 @@ async function runObjectVerb(positionals, flags, ctx) {
       field: "waitForTerminalMs"
     });
   }
+  const waitMs = action.name === "computer_run_start" ? parseWaitMs(flags["wait-ms"]) : undefined;
   if (action.name === "app_request" && input.json !== undefined) {
     if (input.body !== undefined) {
       throw new UsageError("--json and --body are mutually exclusive", {
@@ -18307,7 +18381,7 @@ async function runObjectVerb(positionals, flags, ctx) {
     advise(`Agent registered. Save its apiKey now — it is shown only once:
 `, ctx);
   }
-  let value = action.name === "attachment_upload" ? await uploadLocalAttachments(httpExecutor, input) : await action.run(httpExecutor, input);
+  let value = action.name === "attachment_upload" ? await uploadLocalAttachments(httpExecutor, input) : waitMs !== undefined ? await startComputerRunWithWait(action, httpExecutor, input, waitMs, ctx) : await action.run(httpExecutor, input);
   if (action.name === "computer_exec" && !truthyFlag(flags["no-wait"]) && input.waitForTerminalMs === undefined && input.background !== true) {
     value = await waitForComputerExec(httpExecutor, input, value, ctx);
   }
@@ -18320,7 +18394,7 @@ init_config();
 // src/connect.ts
 init_config();
 var DEFAULT_POLL_INTERVAL_MS = 2000;
-var sleep2 = (ms) => new Promise((r) => globalThis.setTimeout(r, ms));
+var sleep3 = (ms) => new Promise((r) => globalThis.setTimeout(r, ms));
 function bareConnectUrl(apiUrl, returnedUrl) {
   const fallback = `${apiUrl.replace(/\/$/, "")}/connect`;
   if (!returnedUrl)
@@ -18378,7 +18452,7 @@ async function connect2(opts) {
       if (typeof globalThis.setTimeout !== "function") {
         throw new Error("approval pending — approve it, then rerun the same `arbor connect` command to finish saving this agent's credential");
       }
-      await sleep2(pollIntervalMs);
+      await sleep3(pollIntervalMs);
       continue;
     }
     if (tok.status === "expired")
@@ -18398,7 +18472,7 @@ init_errors();
 init_config();
 var CLIENT_ID = "arbor-cli";
 var GRANT_TYPE = "urn:ietf:params:oauth:grant-type:device_code";
-var sleep3 = (ms) => new Promise((r) => setTimeout(r, ms));
+var sleep4 = (ms) => new Promise((r) => setTimeout(r, ms));
 async function login(opts) {
   const apiUrl = opts.url ?? loadConfig().apiUrl;
   const codeRes = await fetch(`${apiUrl}/api/auth/device/code`, {
@@ -18423,7 +18497,7 @@ async function login(opts) {
   for (;; ) {
     if (Date.now() > deadline)
       throw new Error("login timed out — run `arbor login` again");
-    await sleep3(interval);
+    await sleep4(interval);
     const tokRes = await fetch(`${apiUrl}/api/auth/device/token`, {
       method: "POST",
       headers: { "content-type": "application/json" },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lambdacurry/arbor",
-  "version": "0.24.30",
+  "version": "0.24.32",
   "description": "The Arbor CLI — a shared workspace for people and agents. The human + headless-agent write path over Arbor's guarded operation surface.",
   "keywords": [
     "agents",