unbrowse 6.5.0-preview.9 → 6.5.0

package/dist/cli.js

@@ -31,7 +31,7 @@ var __promiseAll = (args) => Promise.all(args);
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // ../../src/build-info.generated.ts
-var BUILD_RELEASE_VERSION = "6.5.0-preview.9", BUILD_GIT_SHA = "8ee8dcabdd1a", BUILD_CODE_HASH = "5d9ebf619c61", BUILD_RELEASE_MANIFEST_BASE64 = "eyJzY2hlbWFfdmVyc2lvbiI6MSwicmVsZWFzZV92ZXJzaW9uIjoiNi41LjAtcHJldmlldy45IiwiZ2l0X3NoYSI6IjhlZThkY2FiZGQxYSIsImNvZGVfaGFzaCI6IjVkOWViZjYxOWM2MSIsInRyYWNlX3ZlcnNpb24iOiI1ZDllYmY2MTljNjFAOGVlOGRjYWJkZDFhIiwiaXNzdWVkX2F0IjoiMjAyNi0wNS0wM1QxMjoyNTo1Mi45MDJaIn0", BUILD_RELEASE_MANIFEST_SIGNATURE = "lq476Pn3w-FPdKDYAr8Z8fONcXUmnNIGPR6Zgxd2Njg", BUILD_DEFAULT_BACKEND_URL = "https://beta-api.unbrowse.ai", BUILD_DEFAULT_PROFILE = "";
+var BUILD_RELEASE_VERSION = "6.5.0", BUILD_GIT_SHA = "a0a05eb03b07", BUILD_CODE_HASH = "5d9ebf619c61", BUILD_RELEASE_MANIFEST_BASE64 = "eyJzY2hlbWFfdmVyc2lvbiI6MSwicmVsZWFzZV92ZXJzaW9uIjoiNi41LjAiLCJnaXRfc2hhIjoiYTBhMDVlYjAzYjA3IiwiY29kZV9oYXNoIjoiNWQ5ZWJmNjE5YzYxIiwidHJhY2VfdmVyc2lvbiI6IjVkOWViZjYxOWM2MUBhMGEwNWViMDNiMDciLCJpc3N1ZWRfYXQiOiIyMDI2LTA1LTAzVDE3OjA4OjI2Ljg3OVoifQ", BUILD_RELEASE_MANIFEST_SIGNATURE = "QG8diudmY_8OEQowkwHoR3Wac09OBJjDifA_xd9kmr0", BUILD_DEFAULT_BACKEND_URL = "https://beta-api.unbrowse.ai", BUILD_DEFAULT_PROFILE = "";
 
 // ../../src/version.ts
 import { createHash } from "crypto";
@@ -2949,6 +2949,17 @@ function loadConfig() {
   } catch {}
   return null;
 }
+function resetLocalRegistration() {
+  const configPath = getConfigPath();
+  try {
+    if (!existsSync4(configPath))
+      return { removed: false, config_path: configPath };
+    unlinkSync(configPath);
+    return { removed: true, config_path: configPath };
+  } catch {
+    return { removed: false, config_path: configPath };
+  }
+}
 function saveConfig(config) {
   const configDir = getConfigDir();
   const configPath = getConfigPath();
@@ -3144,9 +3155,13 @@ function getLocalWalletContext() {
 function getApiKey() {
   if (LOCAL_ONLY)
     return "local-only";
+  const config = loadConfig();
+  if (config?.ignore_env_api_key && config.api_key) {
+    process.env.UNBROWSE_API_KEY = config.api_key;
+    return config.api_key;
+  }
   if (process.env.UNBROWSE_API_KEY)
     return process.env.UNBROWSE_API_KEY;
-  const config = loadConfig();
   if (config?.api_key) {
     process.env.UNBROWSE_API_KEY = config.api_key;
     return config.api_key;
@@ -3459,7 +3474,19 @@ async function ensureRegistered(options) {
   try {
     const wallet = getLocalWalletContext();
     const attribution = parseInstallAttribution();
-    const { agent_id, api_key } = await api("POST", "/v1/agents/register", { name, tos_version: tosInfo.version, ...wallet, ...attribution });
+    let registeredWallet = wallet;
+    let registration;
+    try {
+      registration = await api("POST", "/v1/agents/register", { name, tos_version: tosInfo.version, ...wallet, ...attribution });
+    } catch (err) {
+      const msg = err.message ?? "";
+      if (!wallet.wallet_address || !msg.includes("wallet_already_claimed"))
+        throw err;
+      console.warn("[unbrowse] Wallet is already claimed by another agent. Registering this CLI without a payout wallet; sign in by email or run `unbrowse register --email ... --reset` to recover that account.");
+      registeredWallet = {};
+      registration = await api("POST", "/v1/agents/register", { name, tos_version: tosInfo.version, ...attribution });
+    }
+    const { agent_id, api_key } = registration;
     process.env.UNBROWSE_API_KEY = api_key;
     saveConfig({
       api_key,
@@ -3468,7 +3495,8 @@ async function ensureRegistered(options) {
       registered_at: new Date().toISOString(),
       tos_accepted_version: tosInfo.version,
       tos_accepted_at: new Date().toISOString(),
-      ...wallet
+      ...process.env.UNBROWSE_IGNORE_ENV_API_KEY === "1" ? { ignore_env_api_key: true } : {},
+      ...registeredWallet
     });
     await recordFunnelTelemetryEvent("registration_succeeded", {
       source: "cli",
@@ -5641,6 +5669,7 @@ async function cmdExecute(flags) {
     const limitFlag = flags.limit ? Number(flags.limit) : undefined;
     const schemaFlag = !!flags.schema;
     const rawFlag = !!flags.raw;
+    const resultError = resolveResultError(result);
     if (schemaFlag && !rawFlag) {
       const data = result.result;
       output({
@@ -5651,7 +5680,7 @@ async function cmdExecute(flags) {
       }, !!flags.pretty);
       return;
     }
-    if (!rawFlag && (pathFlag || extractFlag || limitFlag)) {
+    if (!rawFlag && !resultError && (pathFlag || extractFlag || limitFlag)) {
       const data = pathFlag ? drillPath(result.result, pathFlag) : result.result;
       const items = Array.isArray(data) ? data : data != null ? [data] : [];
       const extracted = extractFlag ? applyExtract(items, extractFlag) : items;
@@ -6115,6 +6144,14 @@ async function refreshContributionPreferenceFromServer(verbose = false) {
   }
 }
 async function cmdAccount(flags) {
+  if (flags["reset-key"]) {
+    await cmdRegister({
+      reset: true,
+      email: typeof flags.email === "string" ? flags.email : undefined,
+      "no-prompt": flags["no-prompt"]
+    });
+    return;
+  }
   await refreshContributionPreferenceFromServer(false);
   const cfg = loadConfig();
   const contribution = getContributionConfig2();
@@ -6290,8 +6327,8 @@ var CLI_REFERENCE = {
     { name: "earnings", usage: "[--json]", desc: "Show your credit balance, earnings from indexing, and spending" },
     { name: "corpus-test", usage: "--url <url> [--id <id>] [--retries N]", desc: "Capture a single URL with retry logic; keeps best result across N attempts" },
     { name: "corpus-run", usage: "--corpus <file> --out <file> [--retries N]", desc: "Run corpus-test over all cases in a corpus JSON file and write a comparable snapshot" },
-    { name: "register", usage: "[--email lewis@example.com] [--no-prompt]", desc: "Register an API key. With --email, sends a magic link via Resend; otherwise creates an anonymous key." },
-    { name: "account", usage: "[--json] [--pretty]", desc: "Show local account, dashboard link, wallet, and contribution mode" },
+    { name: "register", usage: "[--email lewis@example.com] [--reset] [--no-prompt]", desc: "Register an API key. With --reset, discard the local cached key first; with --email, mint an account-bound key." },
+    { name: "account", usage: "[--json] [--pretty] [--reset-key] [--email lewis@example.com]", desc: "Show local account, dashboard link, wallet, and contribution mode; --reset-key forces local key reset." },
     { name: "dashboard", usage: "[--no-open] [--pretty]", desc: "Open the website dashboard and pair it to this CLI install through localhost" },
     { name: "mode", usage: "", desc: "Re-prompt for contribution mode (private / share / share + earn)" },
     { name: "capture", usage: "--url <url> --intent <intent>", desc: "Live-browser capture for a single URL \u2014 discovers + indexes API endpoints. Marketplace publish gated by `unbrowse mode`." },
@@ -6890,9 +6927,35 @@ async function cmdClose(flags) {
   output(await api2("POST", "/v1/browse/close", typeof flags.session === "string" ? { session_id: flags.session } : undefined), false);
 }
 async function cmdRegister(flags) {
+  const reset = flags.reset === true || flags.force === true || flags["reset-key"] === true;
+  const previousConfig = reset ? loadConfig() : null;
+  let ignoredEnvApiKey = false;
+  const stopServerAfterReset = () => {
+    if (!reset)
+      return;
+    if (stopServer(BASE_URL)) {
+      info("Stopped local server so the next command starts with the fresh key.");
+    }
+  };
+  if (reset) {
+    const envKey = process.env.UNBROWSE_API_KEY?.trim();
+    const result = resetLocalRegistration();
+    delete process.env.UNBROWSE_API_KEY;
+    if (envKey) {
+      ignoredEnvApiKey = true;
+      process.env.UNBROWSE_IGNORE_ENV_API_KEY = "1";
+    }
+    info(`${result.removed ? "Removed" : "No"} local API key cache at ${result.config_path}.`);
+    if (envKey) {
+      info("Ignoring UNBROWSE_API_KEY for this reset run. Future Unbrowse commands will prefer the fresh saved key; still remove or update that env var in your shell.");
+    }
+    if (typeof flags.email !== "string" && previousConfig?.email) {
+      flags.email = previousConfig.email;
+    }
+  }
   if (typeof flags.email === "string" && flags.email.length > 0) {
     const email = flags.email;
-    if (getApiKey()) {
+    if (!reset && getApiKey()) {
       info("Already registered. Re-running with --email will mint a new key and overwrite ~/.unbrowse/config.json.");
     }
     info(`Sending magic link to ${email}\u2026`);
@@ -6914,7 +6977,8 @@ async function cmdRegister(flags) {
       tos_accepted_version: null,
       tos_accepted_at: null,
       email: result.email,
-      user_id: result.user_id
+      user_id: result.user_id,
+      ...ignoredEnvApiKey ? { ignore_env_api_key: true } : {}
     });
     process.env.UNBROWSE_API_KEY = result.api_key;
     info(`Signed in as ${result.email}. API key saved to ~/.unbrowse/config.json.`);
@@ -6929,15 +6993,17 @@ async function cmdRegister(flags) {
         info(`Auto-publish to marketplace: ${serverPrefs.share_pointers ? "ON" : "off"} (synced from your account).`);
       }
     } catch {}
+    stopServerAfterReset();
     return;
   }
-  if (getApiKey()) {
+  if (!reset && getApiKey()) {
     info("Already registered. API key loaded from env or ~/.unbrowse/config.json");
     return;
   }
   await ensureRegistered({ promptForEmail: !flags["no-prompt"], exitOnFailure: false });
   if (getApiKey()) {
     info("Registration complete. You can now publish skills and check earnings.");
+    stopServerAfterReset();
   } else {
     info("Registration skipped or failed. Unbrowse still works locally \u2014 publish/earnings are disabled.");
   }

package/dist/mcp.js

@@ -226,11 +226,11 @@ import { dirname, join, parse } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 
 // ../../src/build-info.generated.ts
-var BUILD_RELEASE_VERSION = "6.5.0-preview.9";
-var BUILD_GIT_SHA = "8ee8dcabdd1a";
+var BUILD_RELEASE_VERSION = "6.5.0";
+var BUILD_GIT_SHA = "a0a05eb03b07";
 var BUILD_CODE_HASH = "5d9ebf619c61";
-var BUILD_RELEASE_MANIFEST_BASE64 = "eyJzY2hlbWFfdmVyc2lvbiI6MSwicmVsZWFzZV92ZXJzaW9uIjoiNi41LjAtcHJldmlldy45IiwiZ2l0X3NoYSI6IjhlZThkY2FiZGQxYSIsImNvZGVfaGFzaCI6IjVkOWViZjYxOWM2MSIsInRyYWNlX3ZlcnNpb24iOiI1ZDllYmY2MTljNjFAOGVlOGRjYWJkZDFhIiwiaXNzdWVkX2F0IjoiMjAyNi0wNS0wM1QxMjoyNTo1Mi45MDJaIn0";
-var BUILD_RELEASE_MANIFEST_SIGNATURE = "lq476Pn3w-FPdKDYAr8Z8fONcXUmnNIGPR6Zgxd2Njg";
+var BUILD_RELEASE_MANIFEST_BASE64 = "eyJzY2hlbWFfdmVyc2lvbiI6MSwicmVsZWFzZV92ZXJzaW9uIjoiNi41LjAiLCJnaXRfc2hhIjoiYTBhMDVlYjAzYjA3IiwiY29kZV9oYXNoIjoiNWQ5ZWJmNjE5YzYxIiwidHJhY2VfdmVyc2lvbiI6IjVkOWViZjYxOWM2MUBhMGEwNWViMDNiMDciLCJpc3N1ZWRfYXQiOiIyMDI2LTA1LTAzVDE3OjA4OjI2Ljg3OVoifQ";
+var BUILD_RELEASE_MANIFEST_SIGNATURE = "QG8diudmY_8OEQowkwHoR3Wac09OBJjDifA_xd9kmr0";
 var BUILD_DEFAULT_BACKEND_URL = "https://beta-api.unbrowse.ai";
 var BUILD_DEFAULT_PROFILE = "";
 
@@ -809,9 +809,13 @@ function loadConfig() {
 function getApiKey() {
   if (LOCAL_ONLY)
     return "local-only";
+  const config = loadConfig();
+  if (config?.ignore_env_api_key && config.api_key) {
+    process.env.UNBROWSE_API_KEY = config.api_key;
+    return config.api_key;
+  }
   if (process.env.UNBROWSE_API_KEY)
     return process.env.UNBROWSE_API_KEY;
-  const config = loadConfig();
   if (config?.api_key) {
     process.env.UNBROWSE_API_KEY = config.api_key;
     return config.api_key;

package/dist/server.js

@@ -7344,7 +7344,7 @@ var init_capture = __esm(async () => {
 });
 
 // ../../src/build-info.generated.ts
-var BUILD_RELEASE_VERSION = "6.5.0-preview.9", BUILD_GIT_SHA = "8ee8dcabdd1a", BUILD_CODE_HASH = "5d9ebf619c61", BUILD_RELEASE_MANIFEST_BASE64 = "eyJzY2hlbWFfdmVyc2lvbiI6MSwicmVsZWFzZV92ZXJzaW9uIjoiNi41LjAtcHJldmlldy45IiwiZ2l0X3NoYSI6IjhlZThkY2FiZGQxYSIsImNvZGVfaGFzaCI6IjVkOWViZjYxOWM2MSIsInRyYWNlX3ZlcnNpb24iOiI1ZDllYmY2MTljNjFAOGVlOGRjYWJkZDFhIiwiaXNzdWVkX2F0IjoiMjAyNi0wNS0wM1QxMjoyNTo1Mi45MDJaIn0", BUILD_RELEASE_MANIFEST_SIGNATURE = "lq476Pn3w-FPdKDYAr8Z8fONcXUmnNIGPR6Zgxd2Njg", BUILD_DEFAULT_BACKEND_URL = "https://beta-api.unbrowse.ai", BUILD_DEFAULT_PROFILE = "";
+var BUILD_RELEASE_VERSION = "6.5.0", BUILD_GIT_SHA = "a0a05eb03b07", BUILD_CODE_HASH = "5d9ebf619c61", BUILD_RELEASE_MANIFEST_BASE64 = "eyJzY2hlbWFfdmVyc2lvbiI6MSwicmVsZWFzZV92ZXJzaW9uIjoiNi41LjAiLCJnaXRfc2hhIjoiYTBhMDVlYjAzYjA3IiwiY29kZV9oYXNoIjoiNWQ5ZWJmNjE5YzYxIiwidHJhY2VfdmVyc2lvbiI6IjVkOWViZjYxOWM2MUBhMGEwNWViMDNiMDciLCJpc3N1ZWRfYXQiOiIyMDI2LTA1LTAzVDE3OjA4OjI2Ljg3OVoifQ", BUILD_RELEASE_MANIFEST_SIGNATURE = "QG8diudmY_8OEQowkwHoR3Wac09OBJjDifA_xd9kmr0", BUILD_DEFAULT_BACKEND_URL = "https://beta-api.unbrowse.ai", BUILD_DEFAULT_PROFILE = "";
 
 // ../../src/version.ts
 import { createHash as createHash2 } from "crypto";
@@ -7815,6 +7815,7 @@ __export(exports_client2, {
   searchIntent: () => searchIntent,
   saveConfig: () => saveConfig,
   resolveAgentName: () => resolveAgentName,
+  resetLocalRegistration: () => resetLocalRegistration,
   registerAgent: () => registerAgent,
   recordTransaction: () => recordTransaction,
   recordRoutingTelemetry: () => recordRoutingTelemetry,
@@ -7956,6 +7957,17 @@ function loadConfig() {
   } catch {}
   return null;
 }
+function resetLocalRegistration() {
+  const configPath = getConfigPath();
+  try {
+    if (!existsSync7(configPath))
+      return { removed: false, config_path: configPath };
+    unlinkSync(configPath);
+    return { removed: true, config_path: configPath };
+  } catch {
+    return { removed: false, config_path: configPath };
+  }
+}
 function saveConfig(config) {
   const configDir = getConfigDir();
   const configPath = getConfigPath();
@@ -8178,9 +8190,13 @@ function getLocalWalletContext() {
 function getApiKey() {
   if (LOCAL_ONLY)
     return "local-only";
+  const config = loadConfig();
+  if (config?.ignore_env_api_key && config.api_key) {
+    process.env.UNBROWSE_API_KEY = config.api_key;
+    return config.api_key;
+  }
   if (process.env.UNBROWSE_API_KEY)
     return process.env.UNBROWSE_API_KEY;
-  const config = loadConfig();
   if (config?.api_key) {
     process.env.UNBROWSE_API_KEY = config.api_key;
     return config.api_key;
@@ -8496,7 +8512,19 @@ async function ensureRegistered(options) {
   try {
     const wallet = getLocalWalletContext();
     const attribution = parseInstallAttribution();
-    const { agent_id, api_key } = await api("POST", "/v1/agents/register", { name, tos_version: tosInfo.version, ...wallet, ...attribution });
+    let registeredWallet = wallet;
+    let registration;
+    try {
+      registration = await api("POST", "/v1/agents/register", { name, tos_version: tosInfo.version, ...wallet, ...attribution });
+    } catch (err) {
+      const msg = err.message ?? "";
+      if (!wallet.wallet_address || !msg.includes("wallet_already_claimed"))
+        throw err;
+      console.warn("[unbrowse] Wallet is already claimed by another agent. Registering this CLI without a payout wallet; sign in by email or run `unbrowse register --email ... --reset` to recover that account.");
+      registeredWallet = {};
+      registration = await api("POST", "/v1/agents/register", { name, tos_version: tosInfo.version, ...attribution });
+    }
+    const { agent_id, api_key } = registration;
     process.env.UNBROWSE_API_KEY = api_key;
     saveConfig({
       api_key,
@@ -8505,7 +8533,8 @@ async function ensureRegistered(options) {
       registered_at: new Date().toISOString(),
       tos_accepted_version: tosInfo.version,
       tos_accepted_at: new Date().toISOString(),
-      ...wallet
+      ...process.env.UNBROWSE_IGNORE_ENV_API_KEY === "1" ? { ignore_env_api_key: true } : {},
+      ...registeredWallet
     });
     await recordFunnelTelemetryEvent("registration_succeeded", {
       source: "cli",
@@ -16086,6 +16115,27 @@ function stampTrace(trace) {
   trace.trace_version = TRACE_VERSION;
   return trace;
 }
+function buildBrowserFallbackCommands(contextUrl, skill) {
+  const target = contextUrl || `https://${skill.domain}`;
+  return [
+    `unbrowse go "${target}"`,
+    "unbrowse snap --filter interactive",
+    "unbrowse text",
+    "unbrowse close"
+  ];
+}
+function staleEndpointResult(status, skill, endpoint, contextUrl, message) {
+  const target = contextUrl || endpoint.trigger_url || `https://${skill.domain}`;
+  return {
+    error: "stale_endpoint",
+    status_code: status,
+    skill_id: skill.skill_id,
+    endpoint_id: endpoint.endpoint_id,
+    message: message ?? `Endpoint ${endpoint.endpoint_id} returned HTTP ${status} after replay recovery. Treat this marketplace route as stale and use browser capture for this task.`,
+    next_step: `Use browser fallback: unbrowse go "${target}", inspect with snap/text, then close to checkpoint and publish a fresh route.`,
+    commands: buildBrowserFallbackCommands(target, skill)
+  };
+}
 function serializeReplayBody(body, headers) {
   if (body == null)
     return;
@@ -17896,9 +17946,9 @@ async function executeEndpoint(skill, endpoint, params = {}, projection, options
       }
     }
   }
-  const { status, trace_id } = result;
+  let { status, trace_id } = result;
   let data = result.data;
-  const trace = stampTrace({
+  let trace = stampTrace({
     trace_id,
     skill_id: skill.skill_id,
     endpoint_id: endpoint.endpoint_id,
@@ -17926,7 +17976,7 @@ async function executeEndpoint(skill, endpoint, params = {}, projection, options
     try {
       const sessionRefreshed = await authRuntime.refreshSession(epDomain);
       if (sessionRefreshed) {
-        log("auth", `session refreshed via authRuntime for ${epDomain} — retry should succeed`);
+        log("auth", `session refreshed via authRuntime for ${epDomain} — retrying replay once`);
         authRecovered = true;
       }
       if (!authRecovered) {
@@ -17944,20 +17994,51 @@ async function executeEndpoint(skill, endpoint, params = {}, projection, options
         }
       }
       if (authRecovered) {
-        trace.error = `${trace.error} (credentials refreshed — retry should succeed)`;
+        await reloadExecutionAuthState(skill, epDomain, authHeaders, cookies);
+        const retry = await serverFetch(workflowBindings?.extraHeaders, workflowBindings?.bodyOverride);
+        decisionTrace.push({ step: "auth_recovery_retry", status: retry.status });
+        result = retry;
+        status = retry.status;
+        trace_id = retry.trace_id;
+        data = retry.data;
+        trace = stampTrace({
+          trace_id,
+          skill_id: skill.skill_id,
+          endpoint_id: endpoint.endpoint_id,
+          started_at: startedAt,
+          completed_at: new Date().toISOString(),
+          success: status >= 200 && status < 300,
+          status_code: status
+        });
+        trace.decision_trace = decisionTrace;
+        if (trace.success) {
+          trace.result = data;
+        } else {
+          trace.error = `HTTP ${status}`;
+          data = staleEndpointResult(status, skill, endpoint, options?.contextUrl, `Credentials were refreshed, but endpoint ${endpoint.endpoint_id} still returned HTTP ${status}. Treat this marketplace route as stale and use browser capture for this task.`);
+          trace.result = data;
+        }
       } else {
         if (skill.auth_profile_ref) {
           await deleteCredential(skill.auth_profile_ref);
         }
         trace.error = `${trace.error} (stale credentials — re-authenticate via /v1/auth/login)`;
+        data = staleEndpointResult(status, skill, endpoint, options?.contextUrl, `Endpoint ${endpoint.endpoint_id} returned HTTP ${status}, and credential recovery did not produce a usable session.`);
+        trace.result = data;
       }
     } catch {
       if (skill.auth_profile_ref) {
         await deleteCredential(skill.auth_profile_ref);
       }
       trace.error = `${trace.error} (stale credential deleted)`;
+      data = staleEndpointResult(status, skill, endpoint, options?.contextUrl, `Endpoint ${endpoint.endpoint_id} returned HTTP ${status}; credential recovery failed and stale credentials were cleared.`);
+      trace.result = data;
     }
   }
+  if (!trace.success && (status === 404 || status === 429 || status >= 500)) {
+    data = staleEndpointResult(status, skill, endpoint, options?.contextUrl);
+    trace.result = data;
+  }
   if (trace.success && endpoint.response_schema && data != null) {
     const drift = detectSchemaDrift(endpoint.response_schema, data);
     if (drift.drifted) {
@@ -25545,14 +25626,29 @@ async function createBrowseSession(sessions, client, injectInterceptor2, session
   });
 }
 async function isBrowseSessionLive(session, client) {
-  if (!session.tabId)
+  const dbg = (reason, extra = {}) => {
+    if (!process.env.UNBROWSE_BROWSE_LIVENESS_DEBUG)
+      return;
+    console.warn("[browse-liveness] not live", JSON.stringify({
+      session_id: session.sessionId,
+      tab_id: session.tabId,
+      url: session.url,
+      reason,
+      ...extra
+    }));
+  };
+  if (!session.tabId) {
+    dbg("no_tab_id");
     return false;
+  }
   const sessionClient = resolveSessionClient(session, client);
   try {
     await sessionClient.start();
   } catch (error) {
-    if (isRecoverableBrowseFailure(error))
+    if (isRecoverableBrowseFailure(error)) {
+      dbg("session_client_start_recoverable", { error: String(error?.message ?? error) });
       return false;
+    }
     throw error;
   }
   for (let attempt = 0;attempt < LIVE_CHECK_RETRIES; attempt += 1) {
@@ -25564,6 +25660,11 @@ async function isBrowseSessionLive(session, client) {
           await sleep(LIVE_CHECK_RETRY_DELAY_MS);
           continue;
         }
+        dbg("tab_not_in_discover", {
+          attempt,
+          discovered_tab_ids: tabs.map((t) => t.id),
+          discovered_tab_count: tabs.length
+        });
         return false;
       }
       session.brokerPort = sessionClient.getPort?.() ?? session.brokerPort;
@@ -25589,8 +25690,10 @@ async function isBrowseSessionLive(session, client) {
           return true;
         }
       } catch (error) {
-        if (!isRecoverableBrowseFailure(error))
+        if (!isRecoverableBrowseFailure(error)) {
+          dbg("get_current_url_unrecoverable", { error: String(error?.message ?? error) });
           return false;
+        }
       }
       if (hasMeaningfulBrowseUrl(session.url) || hasMeaningfulBrowseUrl(exactTab.url)) {
         if (hasMeaningfulBrowseUrl(exactTab.url)) {
@@ -25600,12 +25703,15 @@ async function isBrowseSessionLive(session, client) {
         return true;
       }
     } catch (error) {
-      if (!isRecoverableBrowseFailure(error))
+      if (!isRecoverableBrowseFailure(error)) {
+        dbg("loop_unrecoverable", { error: String(error?.message ?? error) });
         return false;
+      }
     }
     if (attempt < LIVE_CHECK_RETRIES - 1)
       await sleep(LIVE_CHECK_RETRY_DELAY_MS);
   }
+  dbg("retries_exhausted_url_check_failed");
   return false;
 }
 async function listLiveBrowseSessions(sessions, client) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "unbrowse",
-  "version": "6.5.0-preview.9",
+  "version": "6.5.0",
   "description": "Reverse-engineer any website into reusable API skills. Zero-dep single binary with embedded browser engine.",
   "type": "module",
   "bin": {