unbrowse 6.4.0 → 6.5.0-preview.5

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.4.0", BUILD_GIT_SHA = "5445eb4fd89e", BUILD_CODE_HASH = "5d9ebf619c61", BUILD_RELEASE_MANIFEST_BASE64 = "eyJzY2hlbWFfdmVyc2lvbiI6MSwicmVsZWFzZV92ZXJzaW9uIjoiNi40LjAiLCJnaXRfc2hhIjoiNTQ0NWViNGZkODllIiwiY29kZV9oYXNoIjoiNWQ5ZWJmNjE5YzYxIiwidHJhY2VfdmVyc2lvbiI6IjVkOWViZjYxOWM2MUA1NDQ1ZWI0ZmQ4OWUiLCJpc3N1ZWRfYXQiOiIyMDI2LTA1LTAxVDA5OjQ5OjE0LjcyMFoifQ", BUILD_RELEASE_MANIFEST_SIGNATURE = "3l8L_1jJ1G9weeuFgVBrYwcglXLwH_AnfmsnXqdPigg", BUILD_DEFAULT_BACKEND_URL = "https://beta-api.unbrowse.ai";
+var BUILD_RELEASE_VERSION = "6.5.0-preview.5", BUILD_GIT_SHA = "764b78e2d7f4", BUILD_CODE_HASH = "5d9ebf619c61", BUILD_RELEASE_MANIFEST_BASE64 = "eyJzY2hlbWFfdmVyc2lvbiI6MSwicmVsZWFzZV92ZXJzaW9uIjoiNi41LjAtcHJldmlldy41IiwiZ2l0X3NoYSI6Ijc2NGI3OGUyZDdmNCIsImNvZGVfaGFzaCI6IjVkOWViZjYxOWM2MSIsInRyYWNlX3ZlcnNpb24iOiI1ZDllYmY2MTljNjFANzY0Yjc4ZTJkN2Y0IiwiaXNzdWVkX2F0IjoiMjAyNi0wNS0wM1QwNzo0NDozOS41MzZaIn0", BUILD_RELEASE_MANIFEST_SIGNATURE = "3QFhQrBBJLGFXH5FxGlgs6hJtyMTYy7GCXeJoovWc5s", BUILD_DEFAULT_BACKEND_URL = "https://beta-api.unbrowse.ai", BUILD_DEFAULT_PROFILE = "";
 
 // ../../src/version.ts
 import { createHash } from "crypto";
@@ -132,13 +132,14 @@ function getPackageVersion() {
     return packageVersion;
   return getEmbeddedReleaseVersion() ?? "unknown";
 }
-var MODULE_DIR, CODE_HASH, GIT_SHA, PACKAGE_VERSION, DEFAULT_BACKEND_URL, TRACE_VERSION, RELEASE_MANIFEST_BASE64, RELEASE_MANIFEST_SIGNATURE;
+var MODULE_DIR, CODE_HASH, GIT_SHA, PACKAGE_VERSION, DEFAULT_BACKEND_URL, DEFAULT_PROFILE, TRACE_VERSION, RELEASE_MANIFEST_BASE64, RELEASE_MANIFEST_SIGNATURE;
 var init_version = __esm(() => {
   MODULE_DIR = dirname(fileURLToPath(import.meta.url));
   CODE_HASH = BUILD_CODE_HASH?.trim() || computeCodeHash();
   GIT_SHA = getGitSha();
   PACKAGE_VERSION = getPackageVersion();
   DEFAULT_BACKEND_URL = BUILD_DEFAULT_BACKEND_URL?.trim() || "https://beta-api.unbrowse.ai";
+  DEFAULT_PROFILE = BUILD_DEFAULT_PROFILE?.trim() || "";
   TRACE_VERSION = `${CODE_HASH}@${GIT_SHA}`;
   RELEASE_MANIFEST_BASE64 = BUILD_RELEASE_MANIFEST_BASE64?.trim() || "";
   RELEASE_MANIFEST_SIGNATURE = BUILD_RELEASE_MANIFEST_SIGNATURE?.trim() || "";
@@ -180,9 +181,11 @@ function getWalletContext() {
       wallet_provider: asNonEmptyString(process.env.AGENT_WALLET_PROVIDER)
     };
   }
-  const localLobsterWallet = getLobsterWalletFromLocalConfig();
-  if (localLobsterWallet) {
-    return { wallet_address: localLobsterWallet, wallet_provider: "lobster.cash" };
+  if (process.env.UNBROWSE_DISABLE_LOCAL_WALLET !== "1") {
+    const localLobsterWallet = getLobsterWalletFromLocalConfig();
+    if (localLobsterWallet) {
+      return { wallet_address: localLobsterWallet, wallet_provider: "lobster.cash" };
+    }
   }
   return {};
 }
@@ -426,7 +429,7 @@ function resolveSiblingEntrypoint(metaUrl, basename) {
 }
 function runtimeArgsForEntrypoint(metaUrl, entrypoint) {
   if (path.extname(entrypoint) !== ".ts") {
-    return [pathToFileURL(entrypoint).href];
+    return process.platform === "win32" ? [pathToFileURL(entrypoint).href] : [entrypoint];
   }
   if (process.versions.bun)
     return [entrypoint];
@@ -506,7 +509,7 @@ var init_client = __esm(() => {
   init_wallet();
   init_telemetry_attribution();
   API_URL2 = process.env.UNBROWSE_BACKEND_URL || DEFAULT_BACKEND_URL;
-  PROFILE_NAME2 = sanitizeProfileName2(process.env.UNBROWSE_PROFILE ?? "");
+  PROFILE_NAME2 = sanitizeProfileName2(process.env.UNBROWSE_PROFILE ?? DEFAULT_PROFILE ?? "");
   recentLocalSkills2 = new Map;
   LOCAL_ONLY2 = process.env.UNBROWSE_LOCAL_ONLY === "1";
   API_TIMEOUT_MS2 = parseInt(process.env.UNBROWSE_API_TIMEOUT ?? "8000", 10);
@@ -1324,6 +1327,20 @@ function extractBrowserCookies(domain, opts) {
   }
   const chrome = extractFromChrome(domain, { profile: opts?.chromeProfile });
   chrome.warnings.push(...ff.warnings);
+  if (chrome.cookies.length > 0)
+    return chrome;
+  const sessions = scanAllBrowserSessions(domain);
+  const best = sessions.filter((s) => s.browser !== "Firefox" && s.browser !== "Chrome").sort((a, b) => b.sessionCookies - a.sessionCookies)[0];
+  if (best) {
+    return {
+      cookies: best.cookies,
+      source: best.source,
+      warnings: [
+        ...chrome.warnings,
+        `Chrome had no cookies for ${domain}; using ${best.browser} (${best.sessionCookies} session cookies)`
+      ]
+    };
+  }
   return chrome;
 }
 function scanAllBrowserSessions(domain) {
@@ -1490,22 +1507,25 @@ class LocalAuthRuntime {
     if (session && session.expires > Date.now()) {
       return { authenticated: true, session_token: session.token, method: "cached" };
     }
-    try {
-      const cookies = await getStoredAuth(dep.domain);
-      if (cookies && cookies.length > 0) {
-        log("auth-runtime", `found ${cookies.length} stored cookies for ${dep.domain}`);
-        this.setSession(dep.domain, "vault-cookies", 3600000);
-        return { authenticated: true, method: "cookies" };
-      }
-    } catch {}
-    try {
-      const result = await extractBrowserAuth(dep.domain);
-      if (result.success && result.cookies_stored > 0) {
-        log("auth-runtime", `extracted ${result.cookies_stored} browser cookies for ${dep.domain}`);
-        this.setSession(dep.domain, "browser-cookies", 3600000);
-        return { authenticated: true, method: "cookies" };
-      }
-    } catch {}
+    const skipFallback = process.env.UNBROWSE_DISABLE_AUTH_FALLBACK === "1";
+    if (!skipFallback) {
+      try {
+        const cookies = await getStoredAuth(dep.domain);
+        if (cookies && cookies.length > 0) {
+          log("auth-runtime", `found ${cookies.length} stored cookies for ${dep.domain}`);
+          this.setSession(dep.domain, "vault-cookies", 3600000);
+          return { authenticated: true, method: "cookies" };
+        }
+      } catch {}
+      try {
+        const result = await extractBrowserAuth(dep.domain);
+        if (result.success && result.cookies_stored > 0) {
+          log("auth-runtime", `extracted ${result.cookies_stored} browser cookies for ${dep.domain}`);
+          this.setSession(dep.domain, "browser-cookies", 3600000);
+          return { authenticated: true, method: "cookies" };
+        }
+      } catch {}
+    }
     if (dep.strategy === "refresh_session" && session) {
       const refreshed = await this.refreshSession(dep.domain);
       if (refreshed) {
@@ -1828,6 +1848,7 @@ var init_compile = () => {};
 import { nanoid as nanoid6 } from "nanoid";
 var VALID_VERIFICATION_STATUSES, STOPWORDS;
 var init_execution = __esm(async () => {
+  init_client2();
   init_reverse_engineer();
   init_bundle_scanner();
   init_token_resolver();
@@ -1983,6 +2004,10 @@ import { nanoid as nanoid9 } from "nanoid";
 import { existsSync as existsSync12, writeFileSync as writeFileSync4, readFileSync as readFileSync7, mkdirSync as mkdirSync6, readdirSync as readdirSync4 } from "node:fs";
 import { dirname as dirname3, join as join10 } from "node:path";
 function _writeRouteCacheToDisk() {
+  if (!LOCAL_CACHES_ENABLED) {
+    _routeCacheDirty = false;
+    return;
+  }
   try {
     const dir = dirname3(ROUTE_CACHE_FILE);
     if (!existsSync12(dir))
@@ -1992,7 +2017,7 @@ function _writeRouteCacheToDisk() {
   } catch {}
   _routeCacheDirty = false;
 }
-var LIVE_CAPTURE_TIMEOUT_MS, capturedDomainCache, captureInFlight, captureDomainLocks, skillRouteCache, ROUTE_CACHE_FILE, SKILL_SNAPSHOT_DIR2, domainSkillCache, DOMAIN_CACHE_FILE, _routeCacheDirty = false, routeCacheFlushTimer, routeResultCache, ROUTE_CACHE_TTL, MARKETPLACE_HYDRATE_LIMIT, MARKETPLACE_GET_SKILL_TIMEOUT_MS, MARKETPLACE_DOMAIN_SEARCH_K, MARKETPLACE_GLOBAL_SEARCH_K, SEARCH_INTENT_STOPWORDS;
+var LIVE_CAPTURE_TIMEOUT_MS, capturedDomainCache, captureInFlight, captureDomainLocks, skillRouteCache, ROUTE_CACHE_FILE, SKILL_SNAPSHOT_DIR2, domainSkillCache, DOMAIN_CACHE_FILE, LOCAL_CACHES_ENABLED, _routeCacheDirty = false, routeCacheFlushTimer, routeResultCache, ROUTE_CACHE_TTL, MARKETPLACE_HYDRATE_LIMIT, MARKETPLACE_GET_SKILL_TIMEOUT_MS, MARKETPLACE_DOMAIN_SEARCH_K, MARKETPLACE_GLOBAL_SEARCH_K, SEARCH_INTENT_STOPWORDS;
 var init_orchestrator = __esm(async () => {
   init_client();
   init_client2();
@@ -2026,36 +2051,41 @@ var init_orchestrator = __esm(async () => {
   SKILL_SNAPSHOT_DIR2 = process.env.UNBROWSE_SKILL_SNAPSHOT_DIR ?? join10(process.env.HOME ?? "/tmp", ".unbrowse", "skill-snapshots");
   domainSkillCache = new Map;
   DOMAIN_CACHE_FILE = join10(process.env.HOME ?? "/tmp", ".unbrowse", "domain-skill-cache.json");
-  try {
-    if (existsSync12(DOMAIN_CACHE_FILE)) {
-      const data = JSON.parse(readFileSync7(DOMAIN_CACHE_FILE, "utf-8"));
-      for (const [k, v] of Object.entries(data)) {
-        const entry = v;
-        if (Date.now() - entry.ts < 7 * 24 * 60 * 60000) {
-          domainSkillCache.set(k, entry);
+  LOCAL_CACHES_ENABLED = process.env.UNBROWSE_LOCAL_CACHES === "1";
+  if (LOCAL_CACHES_ENABLED) {
+    try {
+      if (existsSync12(DOMAIN_CACHE_FILE)) {
+        const data = JSON.parse(readFileSync7(DOMAIN_CACHE_FILE, "utf-8"));
+        for (const [k, v] of Object.entries(data)) {
+          const entry = v;
+          if (Date.now() - entry.ts < 7 * 24 * 60 * 60000) {
+            domainSkillCache.set(k, entry);
+          }
         }
+        console.error(`[domain-cache] loaded ${domainSkillCache.size} entries from disk`);
       }
-      console.error(`[domain-cache] loaded ${domainSkillCache.size} entries from disk`);
-    }
-  } catch {}
+    } catch {}
+  }
   routeCacheFlushTimer = setInterval(() => {
     if (!_routeCacheDirty)
       return;
     _writeRouteCacheToDisk();
   }, 5000);
   routeCacheFlushTimer.unref?.();
-  try {
-    if (existsSync12(ROUTE_CACHE_FILE)) {
-      const data = JSON.parse(readFileSync7(ROUTE_CACHE_FILE, "utf-8"));
-      for (const [k, v] of Object.entries(data)) {
-        const entry = v;
-        if (Date.now() - entry.ts < 24 * 60 * 60000) {
-          skillRouteCache.set(k, entry);
+  if (LOCAL_CACHES_ENABLED) {
+    try {
+      if (existsSync12(ROUTE_CACHE_FILE)) {
+        const data = JSON.parse(readFileSync7(ROUTE_CACHE_FILE, "utf-8"));
+        for (const [k, v] of Object.entries(data)) {
+          const entry = v;
+          if (Date.now() - entry.ts < 24 * 60 * 60000) {
+            skillRouteCache.set(k, entry);
+          }
         }
+        console.error(`[route-cache] loaded ${skillRouteCache.size} entries from disk`);
       }
-      console.error(`[route-cache] loaded ${skillRouteCache.size} entries from disk`);
-    }
-  } catch {}
+    } catch {}
+  }
   routeResultCache = new Map;
   ROUTE_CACHE_TTL = 24 * 60 * 60000;
   MARKETPLACE_HYDRATE_LIMIT = Math.max(1, Number(process.env.UNBROWSE_MARKETPLACE_HYDRATE_LIMIT ?? 4));
@@ -2173,9 +2203,11 @@ function getWalletContext2() {
       wallet_provider: asNonEmptyString2(process.env.AGENT_WALLET_PROVIDER)
     };
   }
-  const localLobsterWallet = getLobsterWalletFromLocalConfig2();
-  if (localLobsterWallet) {
-    return { wallet_address: localLobsterWallet, wallet_provider: "lobster.cash" };
+  if (process.env.UNBROWSE_DISABLE_LOCAL_WALLET !== "1") {
+    const localLobsterWallet = getLobsterWalletFromLocalConfig2();
+    if (localLobsterWallet) {
+      return { wallet_address: localLobsterWallet, wallet_provider: "lobster.cash" };
+    }
   }
   return {};
 }
@@ -2190,6 +2222,100 @@ function checkWalletConfigured2() {
 }
 var init_wallet2 = () => {};
 
+// ../../src/telemetry-attribution.ts
+var exports_telemetry_attribution = {};
+__export(exports_telemetry_attribution, {
+  sanitizeTelemetryAttribution: () => sanitizeTelemetryAttribution2,
+  sanitizeAttributionValue: () => sanitizeAttributionValue2,
+  mergeTelemetryProperties: () => mergeTelemetryProperties2,
+  mergeTelemetryAttribution: () => mergeTelemetryAttribution2,
+  hasTelemetryAttribution: () => hasTelemetryAttribution2,
+  decodeTelemetryAttribution: () => decodeTelemetryAttribution2,
+  TELEMETRY_ATTRIBUTION_KEYS: () => TELEMETRY_ATTRIBUTION_KEYS2
+});
+function sanitizeAttributionValue2(value) {
+  if (typeof value !== "string")
+    return;
+  const trimmed = value.trim();
+  if (!trimmed)
+    return;
+  return trimmed.slice(0, MAX_ATTRIBUTION_VALUE_LENGTH2);
+}
+function hasTelemetryAttribution2(value) {
+  if (!value)
+    return false;
+  return TELEMETRY_ATTRIBUTION_KEYS2.some((key) => Boolean(sanitizeAttributionValue2(value[key])));
+}
+function sanitizeTelemetryAttribution2(raw) {
+  if (!raw)
+    return;
+  const cleaned = {};
+  for (const key of TELEMETRY_ATTRIBUTION_KEYS2) {
+    const value = sanitizeAttributionValue2(raw[key]);
+    if (value)
+      cleaned[key] = value;
+  }
+  return hasTelemetryAttribution2(cleaned) ? cleaned : undefined;
+}
+function mergeTelemetryAttribution2(base, incoming) {
+  const merged = sanitizeTelemetryAttribution2({
+    ...base ?? {},
+    ...incoming ?? {}
+  });
+  return merged;
+}
+function mergeTelemetryProperties2(properties, attribution) {
+  const cleanedAttribution = sanitizeTelemetryAttribution2(attribution);
+  if (!cleanedAttribution)
+    return properties;
+  return {
+    ...cleanedAttribution,
+    ...properties ?? {}
+  };
+}
+function decodeTelemetryAttribution2(value) {
+  if (!value)
+    return;
+  try {
+    const decoded = Buffer.from(value, "base64").toString("utf8");
+    return sanitizeTelemetryAttribution2(JSON.parse(decoded));
+  } catch {
+    return;
+  }
+}
+var TELEMETRY_ATTRIBUTION_KEYS2, MAX_ATTRIBUTION_VALUE_LENGTH2 = 160;
+var init_telemetry_attribution2 = __esm(() => {
+  TELEMETRY_ATTRIBUTION_KEYS2 = [
+    "utm_source",
+    "utm_medium",
+    "utm_campaign",
+    "utm_content",
+    "utm_term",
+    "utm_id",
+    "gclid",
+    "wbraid",
+    "gbraid",
+    "fbclid",
+    "twclid",
+    "ttclid",
+    "msclkid",
+    "li_fat_id",
+    "referrer_host",
+    "channel",
+    "campaign_id",
+    "campaign_name",
+    "content_id",
+    "content_type",
+    "creative_id",
+    "ad_id",
+    "adset_id",
+    "inferred_icp",
+    "variant_id",
+    "experiment_id",
+    "icp"
+  ];
+});
+
 // ../../src/version.ts
 var exports_version = {};
 __export(exports_version, {
@@ -2202,6 +2328,7 @@ __export(exports_version, {
   RELEASE_MANIFEST_BASE64: () => RELEASE_MANIFEST_BASE642,
   PACKAGE_VERSION: () => PACKAGE_VERSION2,
   GIT_SHA: () => GIT_SHA2,
+  DEFAULT_PROFILE: () => DEFAULT_PROFILE2,
   DEFAULT_BACKEND_URL: () => DEFAULT_BACKEND_URL2,
   CODE_HASH: () => CODE_HASH2
 });
@@ -2303,13 +2430,14 @@ function getPackageVersion2() {
     return packageVersion;
   return getEmbeddedReleaseVersion2() ?? "unknown";
 }
-var MODULE_DIR2, CODE_HASH2, GIT_SHA2, PACKAGE_VERSION2, DEFAULT_BACKEND_URL2, TRACE_VERSION2, RELEASE_MANIFEST_BASE642, RELEASE_MANIFEST_SIGNATURE2;
+var MODULE_DIR2, CODE_HASH2, GIT_SHA2, PACKAGE_VERSION2, DEFAULT_BACKEND_URL2, DEFAULT_PROFILE2, TRACE_VERSION2, RELEASE_MANIFEST_BASE642, RELEASE_MANIFEST_SIGNATURE2;
 var init_version2 = __esm(() => {
   MODULE_DIR2 = dirname4(fileURLToPath4(import.meta.url));
   CODE_HASH2 = BUILD_CODE_HASH?.trim() || computeCodeHash2();
   GIT_SHA2 = getGitSha2();
   PACKAGE_VERSION2 = getPackageVersion2();
   DEFAULT_BACKEND_URL2 = BUILD_DEFAULT_BACKEND_URL?.trim() || "https://beta-api.unbrowse.ai";
+  DEFAULT_PROFILE2 = BUILD_DEFAULT_PROFILE?.trim() || "";
   TRACE_VERSION2 = `${CODE_HASH2}@${GIT_SHA2}`;
   RELEASE_MANIFEST_BASE642 = BUILD_RELEASE_MANIFEST_BASE64?.trim() || "";
   RELEASE_MANIFEST_SIGNATURE2 = BUILD_RELEASE_MANIFEST_SIGNATURE?.trim() || "";
@@ -2399,9 +2527,9 @@ function getChromiumKeychainServiceName2(opts) {
 }
 function getChromiumDecryptionKey2(opts) {
   const service = getChromiumKeychainServiceName2(opts);
-  const cached2 = _chromiumKeyCache2.get(service);
-  if (cached2)
-    return cached2;
+  const cached3 = _chromiumKeyCache2.get(service);
+  if (cached3)
+    return cached3;
   if (platform2() !== "darwin")
     return null;
   try {
@@ -2620,6 +2748,20 @@ function extractBrowserCookies2(domain, opts) {
   }
   const chrome = extractFromChrome2(domain, { profile: opts?.chromeProfile });
   chrome.warnings.push(...ff.warnings);
+  if (chrome.cookies.length > 0)
+    return chrome;
+  const sessions = scanAllBrowserSessions2(domain);
+  const best = sessions.filter((s) => s.browser !== "Firefox" && s.browser !== "Chrome").sort((a, b) => b.sessionCookies - a.sessionCookies)[0];
+  if (best) {
+    return {
+      cookies: best.cookies,
+      source: best.source,
+      warnings: [
+        ...chrome.warnings,
+        `Chrome had no cookies for ${domain}; using ${best.browser} (${best.sessionCookies} session cookies)`
+      ]
+    };
+  }
   return chrome;
 }
 function scanAllBrowserSessions2(domain) {
@@ -2697,7 +2839,7 @@ import { randomBytes, createHash as createHash2 } from "crypto";
 import { createInterface } from "readline";
 import { execSync } from "child_process";
 var API_URL = process.env.UNBROWSE_BACKEND_URL || DEFAULT_BACKEND_URL;
-var PROFILE_NAME = sanitizeProfileName(process.env.UNBROWSE_PROFILE ?? "");
+var PROFILE_NAME = sanitizeProfileName(process.env.UNBROWSE_PROFILE ?? DEFAULT_PROFILE ?? "");
 var recentLocalSkills = new Map;
 var LOCAL_ONLY = process.env.UNBROWSE_LOCAL_ONLY === "1";
 function buildReleaseAttestationHeaders(manifestBase64, signature) {
@@ -3295,9 +3437,99 @@ You have $2.00 in free credits — start resolving to use them.`);
       process.exit(1);
   }
 }
+async function magicRegister(opts) {
+  const timeoutMs = opts.timeoutMs ?? 300000;
+  const pollMs = opts.pollMs ?? 1500;
+  const startRes = await fetch(`${API_URL}/v1/auth/email/start`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "Accept-Encoding": "gzip, deflate"
+    },
+    body: JSON.stringify({ email: opts.email, return_url: opts.returnUrl })
+  });
+  if (startRes.status === 503) {
+    throw new Error("Backend RESEND_API_KEY not set — magic-link signup unavailable. Use anon `unbrowse register` (no --email).");
+  }
+  let startData;
+  try {
+    startData = await startRes.json();
+  } catch {
+    throw new Error(`Magic-link start failed: HTTP ${startRes.status}`);
+  }
+  if (startRes.status === 400) {
+    throw new Error(startData.error ?? "invalid_email");
+  }
+  if (!startRes.ok || !startData.token) {
+    const msg = startData.error ?? `HTTP ${startRes.status}`;
+    throw new Error(`Magic-link start failed: ${msg}`);
+  }
+  const token = startData.token;
+  const verifyUrl = `${API_URL}/v1/auth/email/verify?token=${encodeURIComponent(token)}`;
+  if (opts.openBrowser) {
+    try {
+      await opts.openBrowser(verifyUrl);
+    } catch {}
+  } else {
+    try {
+      const cmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
+      execSync(`${cmd} ${JSON.stringify(verifyUrl)}`, { stdio: "ignore", timeout: 5000 });
+    } catch {}
+  }
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    await new Promise((r) => setTimeout(r, pollMs));
+    const pollRes = await fetch(`${API_URL}/v1/auth/email/poll?token=${encodeURIComponent(token)}`, {
+      method: "GET",
+      headers: { "Accept-Encoding": "gzip, deflate" }
+    });
+    let pollData;
+    try {
+      pollData = await pollRes.json();
+    } catch {
+      throw new Error(`Magic-link poll failed: HTTP ${pollRes.status}`);
+    }
+    if (pollData.status === "verified") {
+      if (!pollData.api_key || !pollData.user_id || !pollData.email) {
+        throw new Error("Magic-link poll returned verified without api_key/user_id/email.");
+      }
+      return {
+        api_key: pollData.api_key,
+        agent_id: pollData.user_id,
+        email: pollData.email,
+        user_id: pollData.user_id
+      };
+    }
+    if (pollData.status === "expired" || pollRes.status === 410) {
+      throw new Error("Magic link expired. Re-run `unbrowse register --email …`.");
+    }
+    if (pollData.status === "pending")
+      continue;
+    if (!pollRes.ok) {
+      throw new Error(`Magic-link poll failed: HTTP ${pollRes.status}`);
+    }
+  }
+  throw new Error(`Magic-link timed out after ${Math.round(timeoutMs / 1000)}s. Check your inbox and re-run.`);
+}
 async function getMyProfile() {
   return api("GET", "/v1/agents/me", undefined);
 }
+async function fetchAccountPreferences() {
+  try {
+    const data = await api("GET", "/v1/account/preferences", undefined);
+    return { share_pointers: !!data?.share_pointers };
+  } catch (err) {
+    const msg = err.message ?? "";
+    if (msg.includes("account_required") || msg.includes("HTTP 403") || msg.includes("HTTP 404")) {
+      return null;
+    }
+    throw err;
+  }
+}
+async function pushAccountPreferences(patch) {
+  const data = await api("PATCH", "/v1/account/preferences", patch);
+  return { share_pointers: !!data?.share_pointers };
+}
 async function syncAgentWallet(wallet = getLocalWalletContext()) {
   if (!wallet.wallet_address)
     return;
@@ -3902,7 +4134,7 @@ function isBundledVirtualEntrypoint(entrypoint) {
 }
 function runtimeArgsForEntrypoint2(metaUrl, entrypoint) {
   if (path3.extname(entrypoint) !== ".ts") {
-    return [pathToFileURL2(entrypoint).href];
+    return process.platform === "win32" ? [pathToFileURL2(entrypoint).href] : [entrypoint];
   }
   if (process.versions.bun)
     return [entrypoint];
@@ -4610,6 +4842,94 @@ function maybeShowContributionNotice() {
   return true;
 }
 
+// ../../src/config/contribution.ts
+import fs3 from "node:fs";
+import path10 from "node:path";
+import os7 from "node:os";
+function configPath2() {
+  return process.env.UNBROWSE_CONFIG_PATH || path10.join(os7.homedir(), ".unbrowse", "config.json");
+}
+var DEFAULT2 = {
+  contribution: { share_pointers: false, set_via: "default" },
+  rev_share: { opted_in: false },
+  notice_shown_count: 0
+};
+function freshDefault2() {
+  return {
+    contribution: { ...DEFAULT2.contribution },
+    rev_share: { ...DEFAULT2.rev_share },
+    notice_shown_count: 0
+  };
+}
+var cached2 = null;
+function getContributionConfig2() {
+  if (cached2)
+    return cached2;
+  const p = configPath2();
+  let fileExisted = false;
+  let raw = null;
+  try {
+    const content = fs3.readFileSync(p, "utf-8");
+    fileExisted = true;
+    if (content.trim().length > 0) {
+      raw = JSON.parse(content);
+    }
+  } catch {}
+  if (!raw) {
+    cached2 = freshDefault2();
+    return cached2;
+  }
+  const contributionRaw = raw.contribution ?? null;
+  const revShareRaw = raw.rev_share ?? null;
+  const isExistingUserMigration = fileExisted && !contributionRaw;
+  cached2 = {
+    contribution: {
+      share_pointers: !!(contributionRaw?.share_pointers ?? DEFAULT2.contribution.share_pointers),
+      set_via: contributionRaw?.set_via ?? DEFAULT2.contribution.set_via,
+      ...contributionRaw?.set_at ? { set_at: String(contributionRaw.set_at) } : {}
+    },
+    rev_share: {
+      opted_in: !!(revShareRaw?.opted_in ?? DEFAULT2.rev_share.opted_in),
+      ...revShareRaw?.wallet_address ? { wallet_address: String(revShareRaw.wallet_address) } : {}
+    },
+    notice_shown_count: typeof raw.notice_shown_count === "number" ? raw.notice_shown_count : isExistingUserMigration ? 5 : 0
+  };
+  if (isExistingUserMigration) {
+    try {
+      const merged = { ...raw, ...cached2 };
+      fs3.mkdirSync(path10.dirname(p), { recursive: true });
+      fs3.writeFileSync(p, JSON.stringify(merged, null, 2));
+    } catch {}
+  }
+  return cached2;
+}
+function setContributionConfig2(updates) {
+  const current = getContributionConfig2();
+  const next = {
+    contribution: {
+      ...current.contribution,
+      ...updates.contribution ?? {},
+      set_at: new Date().toISOString()
+    },
+    rev_share: {
+      ...current.rev_share,
+      ...updates.rev_share ?? {}
+    },
+    notice_shown_count: updates.notice_shown_count ?? current.notice_shown_count ?? 0
+  };
+  const p = configPath2();
+  let existing = {};
+  try {
+    const content = fs3.readFileSync(p, "utf-8");
+    if (content.trim())
+      existing = JSON.parse(content);
+  } catch {}
+  const merged = { ...existing, ...next };
+  fs3.mkdirSync(path10.dirname(p), { recursive: true });
+  fs3.writeFileSync(p, JSON.stringify(merged, null, 2));
+  cached2 = next;
+}
+
 // ../../src/cli.ts
 loadEnv({ quiet: true });
 loadEnv({ path: ".env.runtime", quiet: true });
@@ -4641,8 +4961,12 @@ function parseArgs(argv) {
       if (valueExpectedFlags.has(key)) {
         if (next === undefined)
           die(`--${key} requires a value`);
-        flags[key] = next;
-        i++;
+        if (next === "-p" || next === "--param" || next.startsWith("--")) {
+          flags[key] = true;
+        } else {
+          flags[key] = next;
+          i++;
+        }
       } else if (!next || next.startsWith("--") || next === "-p" || next === "--param") {
         flags[key] = true;
       } else {
@@ -4655,8 +4979,8 @@ function parseArgs(argv) {
   }
   return { command, args: positional, flags, params };
 }
-async function api2(method, path10, body) {
-  let target = `${BASE_URL}${path10}`;
+async function api2(method, path11, body, opts) {
+  let target = `${BASE_URL}${path11}`;
   let requestBody = body;
   if (method === "GET" && body && typeof body === "object") {
     const params = new URLSearchParams;
@@ -4670,14 +4994,34 @@ async function api2(method, path10, body) {
       target += `${target.includes("?") ? "&" : "?"}${query}`;
     requestBody = undefined;
   }
-  const res = await fetch(target, {
-    method,
-    headers: {
-      ...requestBody ? { "Content-Type": "application/json" } : {},
-      "x-unbrowse-client-id": CLI_CLIENT_ID
-    },
-    body: requestBody ? JSON.stringify(requestBody) : undefined
-  });
+  const ctrl = new AbortController;
+  const timeoutMs = opts?.timeoutMs;
+  const timer = typeof timeoutMs === "number" && timeoutMs > 0 ? setTimeout(() => ctrl.abort(), timeoutMs) : null;
+  let res;
+  try {
+    res = await fetch(target, {
+      method,
+      headers: {
+        ...requestBody ? { "Content-Type": "application/json" } : {},
+        "x-unbrowse-client-id": CLI_CLIENT_ID
+      },
+      body: requestBody ? JSON.stringify(requestBody) : undefined,
+      signal: ctrl.signal
+    });
+  } catch (err) {
+    if (timer)
+      clearTimeout(timer);
+    if (err?.name === "AbortError") {
+      return {
+        error: "cli_timeout",
+        message: `CLI gave up waiting on local server after ${timeoutMs}ms. Try: pkill -9 -f 'unbrowse|kuri'`
+      };
+    }
+    throw err;
+  } finally {
+    if (timer)
+      clearTimeout(timer);
+  }
   if (!res.ok && res.headers.get("content-type")?.includes("json")) {
     return res.json();
   }
@@ -4971,7 +5315,8 @@ async function cmdResolve(flags) {
     body.projection = { raw: true };
     const startedAt = Date.now();
     async function resolveOnce(message = "Still working. Searching cached routes...") {
-      return withPendingNotice(api2("POST", "/v1/intent/resolve", body), message);
+      const cliTimeoutMs = (typeof body.budget_ms === "number" ? body.budget_ms : 8000) + 30000;
+      return withPendingNotice(api2("POST", "/v1/intent/resolve", body, { timeoutMs: cliTimeoutMs }), message);
     }
     let result = await resolveOnce();
     const resultError = resolveResultError(result);
@@ -4991,8 +5336,13 @@ async function cmdResolve(flags) {
       const skillId = resolveSkillId();
       if (skillId && endpoints.length > 0) {
         const bestEndpoint = endpoints[0];
-        info(`Auto-executing endpoint: ${bestEndpoint.description ?? bestEndpoint.endpoint_id}`);
-        result = await withPendingNotice(api2("POST", `/v1/skills/${skillId}/execute`, execBody(bestEndpoint.endpoint_id)), "Executing best endpoint...");
+        if (endpointNeedsThirdPartyTermsConfirmation(bestEndpoint) && !flags["confirm-third-party-terms"]) {
+          process.stderr.write(`Skipping auto-execute: endpoint ${bestEndpoint.endpoint_id ?? "?"} ` + `requires explicit third-party terms confirmation. ` + `Re-run with --confirm-third-party-terms to proceed.
+`);
+        } else {
+          info(`Auto-executing endpoint: ${bestEndpoint.description ?? bestEndpoint.endpoint_id}`);
+          result = await withPendingNotice(api2("POST", `/v1/skills/${skillId}/execute`, execBody(bestEndpoint.endpoint_id)), "Executing best endpoint...");
+        }
       }
     }
     if (Date.now() - startedAt > 3000 && result.source === "live-capture") {
@@ -5054,8 +5404,8 @@ async function cmdResolve(flags) {
     throw error;
   }
 }
-function drillPath(data, path10) {
-  const segments = path10.split(/\./).flatMap((s) => {
+function drillPath(data, path11) {
+  const segments = path11.split(/\./).flatMap((s) => {
     const m = s.match(/^(.+)\[\]$/);
     return m ? [m[1], "[]"] : [s];
   });
@@ -5082,9 +5432,9 @@ function drillPath(data, path10) {
   }
   return values;
 }
-function resolveDotPath(obj, path10) {
+function resolveDotPath(obj, path11) {
   let cur = obj;
-  for (const key of path10.split(".")) {
+  for (const key of path11.split(".")) {
     if (cur == null || typeof cur !== "object")
       return;
     cur = cur[key];
@@ -5101,8 +5451,8 @@ function applyExtract(items, extractSpec) {
   return items.map((item) => {
     const row = {};
     let hasValue = false;
-    for (const { alias, path: path10 } of fields) {
-      const val = resolveDotPath(item, path10);
+    for (const { alias, path: path11 } of fields) {
+      const val = resolveDotPath(item, path11);
       row[alias] = val ?? null;
       if (val != null)
         hasValue = true;
@@ -5419,7 +5769,67 @@ async function cmdCleanupStale(flags) {
   output(await withPendingNotice(api2("POST", "/v1/stale/cleanup", body), "Cleaning stale endpoints..."), !!flags.pretty);
 }
 async function cmdSearch(flags) {
-  await cmdResolve(flags);
+  const intent = flags.intent;
+  const hostType = detectTelemetryHostType();
+  const { decodeTelemetryAttribution: decodeTelemetryAttribution3 } = await Promise.resolve().then(() => (init_telemetry_attribution2(), exports_telemetry_attribution));
+  const attr = decodeTelemetryAttribution3(process.env.UNBROWSE_ATTRIBUTION_B64) ?? {};
+  const attrProps = {};
+  for (const k of ["channel", "campaign_id", "content_id", "variant_id"]) {
+    const v = attr[k];
+    if (v != null)
+      attrProps[k] = v;
+  }
+  const domain = telemetryDomainFromInput(flags.domain, flags.url);
+  if (intent) {
+    await recordFunnelTelemetryEvent("search_started", {
+      source: "cli",
+      hostType,
+      properties: {
+        command: "search",
+        intent,
+        domain,
+        url: typeof flags.url === "string" ? flags.url : null,
+        ...attrProps
+      }
+    });
+  }
+  let resultCount = 0;
+  try {
+    if (intent && domain) {
+      try {
+        const searchRes = await api2("GET", `/v1/search/domain?intent=${encodeURIComponent(intent)}&domain=${encodeURIComponent(domain)}`);
+        resultCount = Array.isArray(searchRes?.results) ? searchRes.results.length : 0;
+      } catch {}
+    }
+    await cmdResolve(flags);
+    if (intent) {
+      await recordFunnelTelemetryEvent("search_completed", {
+        source: "cli",
+        hostType,
+        properties: {
+          command: "search",
+          intent,
+          domain,
+          result_count: resultCount,
+          ...attrProps
+        }
+      });
+    }
+  } catch (err) {
+    if (intent) {
+      await recordFunnelTelemetryEvent("search_failed", {
+        source: "cli",
+        hostType,
+        properties: {
+          command: "search",
+          intent,
+          error: err instanceof Error ? err.message : String(err),
+          ...attrProps
+        }
+      });
+    }
+    throw err;
+  }
 }
 async function cmdSessions(flags) {
   const domain = flags.domain;
@@ -5577,6 +5987,22 @@ async function cmdSetup(flags) {
 }
 async function cmdMode(_flags) {
   await promptContributionMode({ force: true });
+  await syncContributionPreferenceToServer();
+}
+async function syncContributionPreferenceToServer() {
+  const cfg = loadConfig();
+  if (!cfg?.api_key)
+    return;
+  const share_pointers = !!getContributionConfig2().contribution.share_pointers;
+  try {
+    await pushAccountPreferences({ share_pointers });
+    info("Synced preference to your account.");
+  } catch (err) {
+    const msg = err.message ?? "";
+    if (msg.includes("account_required") || msg.includes("HTTP 403"))
+      return;
+    info(`Local mode set, but server sync failed: ${msg}`);
+  }
 }
 async function runPostSetupContributionPrompt() {
   try {
@@ -5594,16 +6020,68 @@ async function cmdCapture(flags) {
   const endpoints = Array.isArray(result.endpoints) ? result.endpoints : Array.isArray(result.available_endpoints) ? result.available_endpoints : [];
   const skill = result.skill ?? null;
   const skillId = result.skill_id ?? skill?.skill_id ?? (typeof result.learned_skill_id === "string" ? result.learned_skill_id : undefined);
+  const isThinDocumentOnly = endpoints.length === 1 && (() => {
+    const e0 = endpoints[0];
+    if (!e0 || e0.method !== "GET")
+      return false;
+    const tmpl = (e0.url_template ?? "").split("?")[0].replace(/\/$/, "");
+    const target = url.split("?")[0].replace(/\/$/, "");
+    return tmpl === target;
+  })();
+  const escapedIntent = intent.replace(/"/g, "\\\"");
+  const escapedUrl = url.replace(/"/g, "\\\"");
   const envelope = {
     skill_id: skillId,
     endpoints_discovered: typeof result.endpoints_discovered === "number" ? result.endpoints_discovered : endpoints.length,
     marketplace_published: !!result.marketplace_published,
     ms: typeof result.ms === "number" ? result.ms : Date.now() - t0,
-    next_step: endpoints.length > 0 ? `unbrowse resolve --intent "${intent.replace(/"/g, "\\\"")}" --url "${url.replace(/"/g, "\\\"")}"` : "no endpoints discovered; site may need authentication or different intent",
-    ...result.error ? { error: result.error } : {}
+    next_step: endpoints.length === 0 ? "no endpoints discovered; site may need authentication or different intent" : `unbrowse resolve --intent "${escapedIntent}" --url "${escapedUrl}"`,
+    ...isThinDocumentOnly ? { capture_pattern: "doc_only", capture_observation: "only the input URL was captured (1 GET, no XHR fired during the auto-capture window)" } : {},
+    ...result.error ? { error: result.error } : {},
+    ...result.captured_meta ? { captured_meta: result.captured_meta } : {},
+    ...typeof result.capture_path === "string" ? { capture_path: result.capture_path } : {},
+    ...result.prior_domain_note ? { prior_domain_note: result.prior_domain_note } : {},
+    ...result.note_evidence ? { note_evidence: result.note_evidence } : {}
   };
   output(envelope, !!flags.pretty);
 }
+async function cmdNote(flags, args) {
+  const subRaw = args?.[0] ?? flags.action;
+  const sub = (typeof subRaw === "string" ? subRaw : "").toLowerCase();
+  if (!sub || !["read", "write", "list"].includes(sub)) {
+    die('usage: unbrowse note <read|write|list> --domain <domain> [--body "..."]');
+  }
+  if (sub === "list") {
+    const { homedir: homedir9 } = await import("os");
+    const { join: join15 } = await import("path");
+    const { readdirSync: readdirSync7, existsSync: existsSync19 } = await import("fs");
+    const profile = process.env.UNBROWSE_PROFILE ?? "";
+    const dir = process.env.UNBROWSE_DOMAIN_NOTES_DIR ?? (profile ? join15(homedir9(), ".unbrowse", "profiles", profile, "domain-notes") : join15(homedir9(), ".unbrowse", "domain-notes"));
+    if (!existsSync19(dir)) {
+      output({ notes: [], dir }, !!flags.pretty);
+      return;
+    }
+    const files = readdirSync7(dir).filter((f) => f.endsWith(".md"));
+    output({ dir, notes: files.map((f) => f.replace(/\.md$/, "")) }, !!flags.pretty);
+    return;
+  }
+  const domain = flags.domain;
+  if (!domain)
+    die("--domain required");
+  if (sub === "read") {
+    const res2 = await api2("GET", `/v1/domain-notes/${encodeURIComponent(domain)}`).catch((err) => ({
+      error: err.message
+    }));
+    output(res2, !!flags.pretty);
+    return;
+  }
+  const body = flags.body;
+  if (typeof body !== "string" || body.trim().length === 0) {
+    die("--body required (non-empty markdown string)");
+  }
+  const res = await api2("POST", `/v1/domain-notes/${encodeURIComponent(domain)}`, { body });
+  output(res, !!flags.pretty);
+}
 var CLI_REFERENCE = {
   commands: [
     { name: "health", usage: "", desc: "Server health check" },
@@ -5648,9 +6126,10 @@ 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: "[--no-prompt]", desc: "Optional: register an API key to publish skills, check earnings, and access backend analytics" },
+    { 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: "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`." }
+    { 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`." },
+    { name: "note", usage: '<read|write|list> --domain <domain> [--body "..."]', desc: "Read/write per-domain LLM-prose notes consumed by augment on next capture. Agent populates after reading capture's note_evidence." }
   ],
   globalFlags: [
     { flag: "--pretty", desc: "Indented JSON output" },
@@ -6245,6 +6724,43 @@ 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) {
+  if (typeof flags.email === "string" && flags.email.length > 0) {
+    const email = flags.email;
+    if (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`);
+    const result = await magicRegister({
+      email,
+      openBrowser: (url) => {
+        info(`Opening browser: ${url}`);
+        try {
+          const cmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
+          spawn3(cmd, [url], { detached: true, stdio: "ignore" }).unref();
+        } catch {}
+      }
+    });
+    saveConfig({
+      api_key: result.api_key,
+      agent_id: result.agent_id,
+      agent_name: result.email,
+      registered_at: new Date().toISOString(),
+      tos_accepted_version: null,
+      tos_accepted_at: null
+    });
+    process.env.UNBROWSE_API_KEY = result.api_key;
+    info(`Signed in as ${result.email}. API key saved to ~/.unbrowse/config.json.`);
+    try {
+      const serverPrefs = await fetchAccountPreferences();
+      if (serverPrefs) {
+        setContributionConfig2({
+          contribution: { share_pointers: serverPrefs.share_pointers, set_via: "mode-command" }
+        });
+        info(`Auto-publish to marketplace: ${serverPrefs.share_pointers ? "ON" : "off"} (synced from your account).`);
+      }
+    } catch {}
+    return;
+  }
   if (getApiKey()) {
     info("Already registered. API key loaded from env or ~/.unbrowse/config.json");
     return;
@@ -6737,6 +7253,8 @@ async function main() {
       return cmdMode(flags);
     case "capture":
       return cmdCapture(flags);
+    case "note":
+      return cmdNote(flags, args);
     default:
       info(`Unknown command: ${command}`);
       printHelp();