unbrowse 3.1.0-experiments.5e7a7bb → 3.1.0-experiments.656e467

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 = "3.1.0-experiments.5e7a7bb", BUILD_GIT_SHA = "5e7a7bb949c1", BUILD_CODE_HASH = "1488fc1d92b7", BUILD_RELEASE_MANIFEST_BASE64 = "eyJzY2hlbWFfdmVyc2lvbiI6MSwicmVsZWFzZV92ZXJzaW9uIjoiMy4xLjAtZXhwZXJpbWVudHMuNWU3YTdiYiIsImdpdF9zaGEiOiI1ZTdhN2JiOTQ5YzEiLCJjb2RlX2hhc2giOiIxNDg4ZmMxZDkyYjciLCJ0cmFjZV92ZXJzaW9uIjoiMTQ4OGZjMWQ5MmI3QDVlN2E3YmI5NDljMSIsImlzc3VlZF9hdCI6IjIwMjYtMDQtMDVUMTQ6NTY6MjkuNjY2WiJ9", BUILD_RELEASE_MANIFEST_SIGNATURE = "OuZD9NeemoStAyT3-MgMS3V3eeatbRMKkVY_J4_6nsM", BUILD_DEFAULT_BACKEND_URL = "https://unbrowse-backend-experiments.lewis-6d8.workers.dev";
+var BUILD_RELEASE_VERSION = "3.1.0-experiments.656e467", BUILD_GIT_SHA = "656e4673f3e2", BUILD_CODE_HASH = "1488fc1d92b7", BUILD_RELEASE_MANIFEST_BASE64 = "eyJzY2hlbWFfdmVyc2lvbiI6MSwicmVsZWFzZV92ZXJzaW9uIjoiMy4xLjAtZXhwZXJpbWVudHMuNjU2ZTQ2NyIsImdpdF9zaGEiOiI2NTZlNDY3M2YzZTIiLCJjb2RlX2hhc2giOiIxNDg4ZmMxZDkyYjciLCJ0cmFjZV92ZXJzaW9uIjoiMTQ4OGZjMWQ5MmI3QDY1NmU0NjczZjNlMiIsImlzc3VlZF9hdCI6IjIwMjYtMDQtMDZUMDQ6MjY6NTguMzQyWiJ9", BUILD_RELEASE_MANIFEST_SIGNATURE = "kwDKwzNOcAobsIw-q_61ygkHZ4ujT2YO3rUi4nXbnH4", BUILD_DEFAULT_BACKEND_URL = "https://unbrowse-backend-experiments.lewis-6d8.workers.dev";
 
 // ../../src/version.ts
 import { createHash } from "crypto";
@@ -586,7 +586,7 @@ var init_logger = __esm(() => {
 
 // ../../src/kuri/client.ts
 import { execFileSync as execFileSync2, spawn as spawn2 } from "node:child_process";
-import { existsSync as existsSync8 } from "node:fs";
+import { existsSync as existsSync9 } from "node:fs";
 import path5 from "node:path";
 function createBrokerState(port = KURI_DEFAULT_PORT) {
   return {
@@ -661,7 +661,7 @@ function findKuriBinary() {
   if (process.env.KURI_BIN)
     return process.env.KURI_BIN;
   const candidates = getKuriBinaryCandidates();
-  return candidates.find((candidate) => existsSync8(candidate)) ?? candidates[0] ?? kuriBinaryName();
+  return candidates.find((candidate) => existsSync9(candidate)) ?? candidates[0] ?? kuriBinaryName();
 }
 var KURI_DEFAULT_PORT = 7700, defaultBrokerState, brokerClients;
 var init_client2 = __esm(() => {
@@ -796,6 +796,15 @@ var init_bundle_scanner = __esm(() => {
   init_logger();
 });
 
+// ../../src/reverse-engineer/token-sources.ts
+var init_token_sources = () => {};
+
+// ../../src/execution/token-resolver.ts
+var init_token_resolver = __esm(() => {
+  init_token_sources();
+  init_client2();
+});
+
 // ../../src/vault/index.ts
 import { join as join7 } from "path";
 import { homedir as homedir5 } from "os";
@@ -899,18 +908,6 @@ var init_extraction = __esm(() => {
   CHROME_TAGS = new Set(["nav", "footer", "header"]);
 });
 
-// ../../src/graph/agent-augment.ts
-var DEFAULT_MODEL, ENABLED, AUGMENT_TIMEOUT_MS, MAX_AUGMENT_ENDPOINTS, MAX_AUGMENT_PAYLOAD_CHARS, GENERIC_SEMANTIC_TYPES;
-var init_agent_augment = __esm(() => {
-  init_graph();
-  DEFAULT_MODEL = process.env.UNBROWSE_AGENT_SEMANTIC_MODEL ?? process.env.UNBROWSE_AGENT_JUDGE_MODEL ?? "gpt-4.1-mini";
-  ENABLED = process.env.UNBROWSE_AGENT_SEMANTIC_AUGMENT !== "0";
-  AUGMENT_TIMEOUT_MS = Number(process.env.UNBROWSE_AGENT_SEMANTIC_TIMEOUT_MS ?? 8000);
-  MAX_AUGMENT_ENDPOINTS = Math.max(1, Number(process.env.UNBROWSE_AGENT_SEMANTIC_MAX_ENDPOINTS ?? 6));
-  MAX_AUGMENT_PAYLOAD_CHARS = Math.max(4000, Number(process.env.UNBROWSE_AGENT_SEMANTIC_MAX_PAYLOAD_CHARS ?? 24000));
-  GENERIC_SEMANTIC_TYPES = new Set(["identifier", "input", "resource", "entity", "item"]);
-});
-
 // ../../src/execution/search-forms.ts
 var SEARCH_FIELD_NAMES, LOGIN_FIELD_NAMES, SUPPORTED_INPUT_TYPES;
 var init_search_forms = __esm(() => {
@@ -1026,6 +1023,7 @@ var init_execution = __esm(async () => {
   init_capture();
   init_reverse_engineer();
   init_bundle_scanner();
+  init_token_resolver();
   init_marketplace();
   init_runtime();
   init_transform();
@@ -1036,7 +1034,6 @@ var init_execution = __esm(async () => {
   init_domain();
   init_extraction();
   init_graph();
-  init_agent_augment();
   init_logger();
   init_version();
   init_search_forms();
@@ -1165,7 +1162,7 @@ var init_routing_telemetry = __esm(() => {
 });
 // ../../src/orchestrator/index.ts
 import { nanoid as nanoid9 } from "nanoid";
-import { existsSync as existsSync9, writeFileSync as writeFileSync3, readFileSync as readFileSync6, mkdirSync as mkdirSync5, readdirSync as readdirSync3 } from "node:fs";
+import { existsSync as existsSync10, writeFileSync as writeFileSync3, readFileSync as readFileSync6, mkdirSync as mkdirSync5, readdirSync as readdirSync3 } from "node:fs";
 import { dirname as dirname3, join as join9 } from "node:path";
 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 init_orchestrator = __esm(async () => {
@@ -1201,7 +1198,7 @@ var init_orchestrator = __esm(async () => {
   domainSkillCache = new Map;
   DOMAIN_CACHE_FILE = join9(process.env.HOME ?? "/tmp", ".unbrowse", "domain-skill-cache.json");
   try {
-    if (existsSync9(DOMAIN_CACHE_FILE)) {
+    if (existsSync10(DOMAIN_CACHE_FILE)) {
       const data = JSON.parse(readFileSync6(DOMAIN_CACHE_FILE, "utf-8"));
       for (const [k, v] of Object.entries(data)) {
         const entry = v;
@@ -1218,7 +1215,7 @@ var init_orchestrator = __esm(async () => {
     _routeCacheDirty = false;
     try {
       const dir = dirname3(ROUTE_CACHE_FILE);
-      if (!existsSync9(dir))
+      if (!existsSync10(dir))
         mkdirSync5(dir, { recursive: true });
       const entries = Object.fromEntries(skillRouteCache);
       writeFileSync3(ROUTE_CACHE_FILE, JSON.stringify(entries), "utf-8");
@@ -1226,7 +1223,7 @@ var init_orchestrator = __esm(async () => {
   }, 5000);
   routeCacheFlushTimer.unref?.();
   try {
-    if (existsSync9(ROUTE_CACHE_FILE)) {
+    if (existsSync10(ROUTE_CACHE_FILE)) {
       const data = JSON.parse(readFileSync6(ROUTE_CACHE_FILE, "utf-8"));
       for (const [k, v] of Object.entries(data)) {
         const entry = v;
@@ -1323,7 +1320,7 @@ __export(exports_wallet, {
   getWalletContext: () => getWalletContext2,
   checkWalletConfigured: () => checkWalletConfigured2
 });
-import { existsSync as existsSync13, readFileSync as readFileSync9 } from "node:fs";
+import { existsSync as existsSync14, readFileSync as readFileSync9 } from "node:fs";
 import { homedir as homedir6 } from "node:os";
 import { join as join11 } from "node:path";
 function asNonEmptyString2(value) {
@@ -1331,7 +1328,7 @@ function asNonEmptyString2(value) {
 }
 function getLobsterWalletFromLocalConfig2() {
   const agentsPath = join11(process.env.HOME || homedir6(), ".lobster", "agents.json");
-  if (!existsSync13(agentsPath))
+  if (!existsSync14(agentsPath))
     return;
   try {
     const raw = JSON.parse(readFileSync9(agentsPath, "utf8"));
@@ -1382,7 +1379,7 @@ init_wallet();
 init_telemetry_attribution();
 import { readFileSync as readFileSync3, writeFileSync, existsSync as existsSync4, mkdirSync, readdirSync as readdirSync2 } from "fs";
 import { join as join4 } from "path";
-import { homedir as homedir3, hostname } from "os";
+import { homedir as homedir3, hostname, release as osRelease } from "os";
 import { randomBytes, createHash as createHash2 } from "crypto";
 import { createInterface } from "readline";
 var API_URL = process.env.UNBROWSE_BACKEND_URL || DEFAULT_BACKEND_URL;
@@ -1575,9 +1572,19 @@ async function recordInstallTelemetryEvent(source, options) {
     skill_version: options?.skillVersion,
     status: options?.status ?? "installed",
     created_at: createdAt,
-    properties: mergeTelemetryProperties(options?.properties, getTelemetryAttribution())
+    properties: mergeTelemetryProperties({ ...getRuntimeContext(), ...options?.properties }, getTelemetryAttribution())
   });
 }
+function getRuntimeContext() {
+  return {
+    cli_version: PACKAGE_VERSION,
+    code_hash: CODE_HASH,
+    node_version: process.version,
+    platform: process.platform,
+    arch: process.arch,
+    os_release: osRelease()
+  };
+}
 async function recordFunnelTelemetryEvent(name, options) {
   const createdAt = options?.createdAt ?? new Date().toISOString();
   const landingToken = getLandingToken();
@@ -1589,7 +1596,7 @@ async function recordFunnelTelemetryEvent(name, options) {
     source: options?.source ?? "cli",
     host_type: options?.hostType ?? detectTelemetryHostType(),
     created_at: createdAt,
-    properties: mergeTelemetryProperties(options?.properties, getTelemetryAttribution())
+    properties: mergeTelemetryProperties({ ...getRuntimeContext(), ...options?.properties }, getTelemetryAttribution())
   });
 }
 var EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/i;
@@ -2300,7 +2307,7 @@ function buildDepsMetadata(pack, taskName) {
 init_paths();
 init_supervisor();
 init_version();
-import { openSync, readFileSync as readFileSync5, unlinkSync as unlinkSync2, writeFileSync as writeFileSync2 } from "node:fs";
+import { existsSync as existsSync7, openSync, readFileSync as readFileSync5, unlinkSync as unlinkSync2, writeFileSync as writeFileSync2 } from "node:fs";
 import path2 from "node:path";
 import { spawn } from "node:child_process";
 function isServerVersionMismatch(runningVersion, installedVersion, runningCodeHash, installedCodeHash) {
@@ -2366,6 +2373,10 @@ function getServerSpawnSpec(metaUrl, entrypoint = resolveSiblingEntrypoint(metaU
       recordedEntrypoint: `${process.execPath} serve`
     };
   }
+  const serverJs = path2.join(path2.dirname(entrypoint), "server.js");
+  if (existsSync7(serverJs) && path2.basename(entrypoint) !== "server.js") {
+    entrypoint = serverJs;
+  }
   return {
     command: process.execPath,
     args: runtimeArgsForEntrypoint(metaUrl, entrypoint),
@@ -2511,7 +2522,7 @@ async function restartServer(baseUrl, metaUrl) {
 }
 
 // ../../src/runtime/paths.ts
-import { existsSync as existsSync7, mkdirSync as mkdirSync4, realpathSync as realpathSync2 } from "node:fs";
+import { existsSync as existsSync8, mkdirSync as mkdirSync4, realpathSync as realpathSync2 } from "node:fs";
 import path3 from "node:path";
 import { createRequire as createRequire3 } from "node:module";
 import { fileURLToPath as fileURLToPath3, pathToFileURL as pathToFileURL2 } from "node:url";
@@ -2531,7 +2542,7 @@ function runtimeArgsForEntrypoint2(metaUrl, entrypoint) {
     const req = createRequire3(metaUrl);
     const tsxPkg = req.resolve("tsx/package.json");
     const tsxLoader = path3.join(path3.dirname(tsxPkg), "dist", "loader.mjs");
-    if (existsSync7(tsxLoader))
+    if (existsSync8(tsxLoader))
       return ["--import", pathToFileURL2(tsxLoader).href, entrypoint];
   } catch {}
   return ["--import", "tsx", entrypoint];
@@ -2600,13 +2611,13 @@ init_client2();
 init_logger();
 init_wallet();
 import { execFileSync as execFileSync3 } from "node:child_process";
-import { existsSync as existsSync11, mkdirSync as mkdirSync7, writeFileSync as writeFileSync5 } from "node:fs";
+import { existsSync as existsSync12, mkdirSync as mkdirSync7, writeFileSync as writeFileSync5 } from "node:fs";
 import os4 from "node:os";
 import path7 from "node:path";
 
 // ../../src/runtime/update-hints.ts
 init_paths();
-import { existsSync as existsSync10, mkdirSync as mkdirSync6, readFileSync as readFileSync7, writeFileSync as writeFileSync4 } from "node:fs";
+import { existsSync as existsSync11, mkdirSync as mkdirSync6, readFileSync as readFileSync7, writeFileSync as writeFileSync4 } from "node:fs";
 import os3 from "node:os";
 import path6 from "node:path";
 var DEFAULT_INTERVAL_MS = 12 * 60 * 60 * 1000;
@@ -2620,7 +2631,7 @@ function getConfigDir2() {
   return path6.join(getHomeDir(), ".unbrowse");
 }
 function ensureDir3(dir) {
-  if (!existsSync10(dir))
+  if (!existsSync11(dir))
     mkdirSync6(dir, { recursive: true });
   return dir;
 }
@@ -2643,7 +2654,7 @@ function detectRepoRoot(start2) {
   let dir = path6.resolve(start2);
   const root = path6.parse(dir).root;
   while (dir !== root) {
-    if (existsSync10(path6.join(dir, ".git")))
+    if (existsSync11(path6.join(dir, ".git")))
       return dir;
     dir = path6.dirname(dir);
   }
@@ -2722,12 +2733,12 @@ codex_hooks = true
 }
 function writeCodexHook(metaUrl) {
   const configPath = getCodexConfigPath();
-  if (!existsSync10(path6.dirname(configPath))) {
+  if (!existsSync11(path6.dirname(configPath))) {
     return { host: "codex", action: "not-detected", config_file: configPath };
   }
   try {
     const hookScript = getHookScriptPath(metaUrl).replace(/\\/g, "/");
-    const fileExistsBefore = existsSync10(configPath);
+    const fileExistsBefore = existsSync11(configPath);
     let content = fileExistsBefore ? readFileSync7(configPath, "utf8") : "";
     const previous = content;
     content = ensureCodexHooksFeature(content);
@@ -2762,13 +2773,13 @@ command = ${JSON.stringify(command)}
 }
 function writeClaudeHook(metaUrl) {
   const settingsPath = getClaudeSettingsPath();
-  if (!existsSync10(path6.dirname(settingsPath))) {
+  if (!existsSync11(path6.dirname(settingsPath))) {
     return { host: "claude", action: "not-detected", config_file: settingsPath };
   }
   try {
     const hookScript = getHookScriptPath(metaUrl).replace(/\\/g, "/");
     const command = `node "${hookScript}"`;
-    const fileExistsBefore = existsSync10(settingsPath);
+    const fileExistsBefore = existsSync11(settingsPath);
     const settings = readJsonFile(settingsPath) ?? {};
     settings.hooks ??= {};
     settings.hooks.SessionStart ??= [];
@@ -2833,7 +2844,7 @@ function getOpenCodeProjectCommandsDir(cwd) {
   return path7.join(cwd, ".opencode", "commands");
 }
 function detectOpenCode(cwd) {
-  return hasBinary("opencode") || existsSync11(path7.join(resolveConfigHome(), "opencode")) || existsSync11(path7.join(cwd, ".opencode"));
+  return hasBinary("opencode") || existsSync12(path7.join(resolveConfigHome(), "opencode")) || existsSync12(path7.join(cwd, ".opencode"));
 }
 function renderOpenCodeCommand() {
   return `---
@@ -2861,11 +2872,11 @@ function writeOpenCodeCommand(scope, cwd) {
   if (scope === "auto" && !detected) {
     return { detected: false, action: "not-detected", scope: "off" };
   }
-  const resolvedScope = scope === "project" ? "project" : scope === "global" ? "global" : existsSync11(path7.join(cwd, ".opencode")) ? "project" : "global";
+  const resolvedScope = scope === "project" ? "project" : scope === "global" ? "global" : existsSync12(path7.join(cwd, ".opencode")) ? "project" : "global";
   const commandsDir = resolvedScope === "project" ? getOpenCodeProjectCommandsDir(cwd) : getOpenCodeGlobalCommandsDir();
   const commandFile = path7.join(ensureDir2(commandsDir), "unbrowse.md");
   const content = renderOpenCodeCommand();
-  const action2 = existsSync11(commandFile) ? "updated" : "installed";
+  const action2 = existsSync12(commandFile) ? "updated" : "installed";
   mkdirSync7(path7.dirname(commandFile), { recursive: true });
   writeFileSync5(commandFile, content);
   return {
@@ -2877,10 +2888,10 @@ function writeOpenCodeCommand(scope, cwd) {
 }
 async function ensureBrowserEngineInstalled() {
   const binary = findKuriBinary();
-  if (existsSync11(binary)) {
+  if (existsSync12(binary)) {
     return { installed: true, action: "already-installed" };
   }
-  const sourceDir = getKuriSourceCandidates().find((candidate) => existsSync11(path7.join(candidate, "build.zig")));
+  const sourceDir = getKuriSourceCandidates().find((candidate) => existsSync12(path7.join(candidate, "build.zig")));
   if (!sourceDir) {
     return {
       installed: false,
@@ -2902,7 +2913,7 @@ async function ensureBrowserEngineInstalled() {
       timeout: 300000
     });
     const builtBinary = findKuriBinary();
-    if (existsSync11(builtBinary)) {
+    if (existsSync12(builtBinary)) {
       return {
         installed: true,
         action: "installed",
@@ -2927,7 +2938,7 @@ async function runSetup(options) {
   const browser = options?.installBrowser === false ? { installed: false, action: "skipped" } : await ensureBrowserEngineInstalled();
   const walletCheck = checkWalletConfigured();
   const skipWalletSetup = process.env.UNBROWSE_SKIP_WALLET_SETUP === "1";
-  const lobsterInstalled = hasBinary("lobstercash") || existsSync11(path7.join(os4.homedir(), ".agents", "skills", "lobstercash", "SKILL.md"));
+  const lobsterInstalled = hasBinary("lobstercash") || existsSync12(path7.join(os4.homedir(), ".agents", "skills", "lobstercash", "SKILL.md"));
   if (!skipWalletSetup && !walletCheck.configured && lobsterInstalled) {
     console.log("[unbrowse] Crossmint lobster.cash detected but wallet not configured — running wallet setup...");
     try {
@@ -2967,7 +2978,7 @@ async function runSetup(options) {
 
 // ../../src/runtime/update-hints.ts
 init_paths();
-import { existsSync as existsSync12, mkdirSync as mkdirSync8, readFileSync as readFileSync8, writeFileSync as writeFileSync6 } from "node:fs";
+import { existsSync as existsSync13, mkdirSync as mkdirSync8, readFileSync as readFileSync8, writeFileSync as writeFileSync6 } from "node:fs";
 import os5 from "node:os";
 import path8 from "node:path";
 var INSTALL_SCRIPT_URL = "https://unbrowse.ai/install.sh";
@@ -2981,7 +2992,7 @@ function getConfigDir3() {
   return path8.join(getHomeDir2(), ".unbrowse");
 }
 function ensureDir4(dir) {
-  if (!existsSync12(dir))
+  if (!existsSync13(dir))
     mkdirSync8(dir, { recursive: true });
   return dir;
 }
@@ -3007,7 +3018,7 @@ function detectRepoRoot2(start2) {
   let dir = path8.resolve(start2);
   const root = path8.parse(dir).root;
   while (dir !== root) {
-    if (existsSync12(path8.join(dir, ".git")))
+    if (existsSync13(path8.join(dir, ".git")))
       return dir;
     dir = path8.dirname(dir);
   }
@@ -3730,6 +3741,25 @@ async function cmdFeedback(flags) {
     body.diagnostics = JSON.parse(flags.diagnostics);
   output(await api2("POST", "/v1/feedback", body), !!flags.pretty);
 }
+async function cmdAnnotate(flags) {
+  const skillId = flags.skill;
+  const endpointId = flags.endpoint;
+  if (!skillId || !endpointId)
+    die("--skill and --endpoint are required");
+  const body = {};
+  if (flags.text) {
+    body.annotations = [{ text: flags.text }];
+  }
+  if (flags.constraint) {
+    const parts = flags.constraint.split(":");
+    if (parts.length >= 3) {
+      body.constraints = [{ param: parts[0], rule: parts[1], message: parts.slice(2).join(":") }];
+    }
+  }
+  if (!body.annotations && !body.constraints)
+    die("--text or --constraint required");
+  output(await api2("POST", `/v1/skills/${skillId}/endpoints/${endpointId}/annotate`, body), !!flags.pretty);
+}
 async function cmdReview(flags) {
   const skillId = flags.skill;
   if (!skillId)
@@ -3944,6 +3974,7 @@ var CLI_REFERENCE = {
     { name: "resolve", usage: '--intent "..." [--domain "..."] [--url "..."] [opts]', desc: "Search cached indexed/published routes and optionally execute the top trusted endpoint" },
     { name: "execute", usage: "--skill ID --endpoint ID [opts]", desc: "Execute a specific endpoint" },
     { name: "feedback", usage: "--skill ID --endpoint ID --rating N", desc: "Submit feedback (mandatory after resolve)" },
+    { name: "annotate", usage: "--skill ID --endpoint ID --text 'tip' [--constraint 'param:rule:message']", desc: "Contribute best practices or constraints for an endpoint" },
     { name: "review", usage: "--skill ID --endpoints '[...]'", desc: "Push reviewed descriptions/schema metadata back to a captured skill before publish" },
     { name: "index", usage: "--skill ID", desc: "Recompute local graph/contracts/export from cached skill state only" },
     { name: "publish", usage: "--skill ID [--confirm-publish] [--endpoints '[...]']", desc: "Re-index locally, inspect publish-review metadata, then publish/share from cached skill state" },
@@ -4570,6 +4601,7 @@ async function main() {
     "exec",
     "feedback",
     "fb",
+    "annotate",
     "review",
     "index",
     "publish",
@@ -4641,6 +4673,8 @@ async function main() {
     case "feedback":
     case "fb":
       return cmdFeedback(flags);
+    case "annotate":
+      return cmdAnnotate(flags);
     case "review":
       return cmdReview(flags);
     case "index":

package/dist/index.js

@@ -1,16 +1,12 @@
 #!/usr/bin/env node
 import { spawn } from "node:child_process";
-import { createRequire } from "node:module";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 
 const packageRoot = path.dirname(path.dirname(fileURLToPath(import.meta.url)));
-const serverEntrypoint = path.join(packageRoot, "runtime-src", "index.ts");
-const req = createRequire(import.meta.url);
-const tsxPkg = req.resolve("tsx/package.json");
-const tsxLoader = path.join(path.dirname(tsxPkg), "dist", "loader.mjs");
+const serverEntrypoint = path.join(packageRoot, "dist", "server.js");
 
-const child = spawn(process.execPath, ["--import", tsxLoader, serverEntrypoint, ...process.argv.slice(2)], {
+const child = spawn(process.execPath, [serverEntrypoint, ...process.argv.slice(2)], {
   stdio: "inherit",
   cwd: process.cwd(),
   env: {

package/dist/mcp.js

@@ -20,7 +20,7 @@ __export(exports_lobster_pay, {
   isLobsterAvailable: () => isLobsterAvailable
 });
 import { execFile, execFileSync } from "node:child_process";
-import { existsSync as existsSync5 } from "node:fs";
+import { existsSync as existsSync6 } from "node:fs";
 import { homedir as homedir3 } from "node:os";
 import { join as join4 } from "node:path";
 function getLobsterCommand() {
@@ -31,7 +31,7 @@ function getLobsterCommand() {
   try {
     const npmPrefix = execFileSync("npm", ["config", "get", "prefix"], { encoding: "utf8", timeout: 5000 }).trim();
     const lobsterPath = join4(npmPrefix, "bin", "lobstercash");
-    if (existsSync5(lobsterPath)) {
+    if (existsSync6(lobsterPath)) {
       execFileSync(lobsterPath, ["--version"], { stdio: "ignore", timeout: 3000 });
       return { cmd: lobsterPath, prefix: [] };
     }
@@ -45,7 +45,7 @@ function lobsterCmd() {
 }
 function isLobsterAvailable() {
   const agentsPath = join4(process.env.HOME || homedir3(), ".lobster", "agents.json");
-  return existsSync5(agentsPath);
+  return existsSync6(agentsPath);
 }
 function lobsterX402Fetch(url, options) {
   return new Promise((resolve) => {
@@ -121,12 +121,12 @@ var init_lobster_pay = () => {};
 // ../../src/mcp.ts
 import { config as loadEnv } from "dotenv";
 import { createInterface } from "readline";
-import { existsSync as existsSync7, readFileSync as readFileSync6 } from "fs";
+import { existsSync as existsSync8, readFileSync as readFileSync6 } from "fs";
 import path4 from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 
 // ../../src/runtime/local-server.ts
-import { openSync, readFileSync as readFileSync2, unlinkSync, writeFileSync } from "node:fs";
+import { existsSync as existsSync3, openSync, readFileSync as readFileSync2, unlinkSync, writeFileSync } from "node:fs";
 import path2 from "node:path";
 import { spawn } from "node:child_process";
 
@@ -225,11 +225,11 @@ import { dirname, join, parse } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 
 // ../../src/build-info.generated.ts
-var BUILD_RELEASE_VERSION = "3.1.0-experiments.5e7a7bb";
-var BUILD_GIT_SHA = "5e7a7bb949c1";
+var BUILD_RELEASE_VERSION = "3.1.0-experiments.656e467";
+var BUILD_GIT_SHA = "656e4673f3e2";
 var BUILD_CODE_HASH = "1488fc1d92b7";
-var BUILD_RELEASE_MANIFEST_BASE64 = "eyJzY2hlbWFfdmVyc2lvbiI6MSwicmVsZWFzZV92ZXJzaW9uIjoiMy4xLjAtZXhwZXJpbWVudHMuNWU3YTdiYiIsImdpdF9zaGEiOiI1ZTdhN2JiOTQ5YzEiLCJjb2RlX2hhc2giOiIxNDg4ZmMxZDkyYjciLCJ0cmFjZV92ZXJzaW9uIjoiMTQ4OGZjMWQ5MmI3QDVlN2E3YmI5NDljMSIsImlzc3VlZF9hdCI6IjIwMjYtMDQtMDVUMTQ6NTY6MjkuNjY2WiJ9";
-var BUILD_RELEASE_MANIFEST_SIGNATURE = "OuZD9NeemoStAyT3-MgMS3V3eeatbRMKkVY_J4_6nsM";
+var BUILD_RELEASE_MANIFEST_BASE64 = "eyJzY2hlbWFfdmVyc2lvbiI6MSwicmVsZWFzZV92ZXJzaW9uIjoiMy4xLjAtZXhwZXJpbWVudHMuNjU2ZTQ2NyIsImdpdF9zaGEiOiI2NTZlNDY3M2YzZTIiLCJjb2RlX2hhc2giOiIxNDg4ZmMxZDkyYjciLCJ0cmFjZV92ZXJzaW9uIjoiMTQ4OGZjMWQ5MmI3QDY1NmU0NjczZjNlMiIsImlzc3VlZF9hdCI6IjIwMjYtMDQtMDZUMDQ6MjY6NTguMzQyWiJ9";
+var BUILD_RELEASE_MANIFEST_SIGNATURE = "kwDKwzNOcAobsIw-q_61ygkHZ4ujT2YO3rUi4nXbnH4";
 var BUILD_DEFAULT_BACKEND_URL = "https://unbrowse-backend-experiments.lewis-6d8.workers.dev";
 
 // ../../src/version.ts
@@ -400,6 +400,10 @@ function getServerSpawnSpec(metaUrl, entrypoint = resolveSiblingEntrypoint(metaU
       recordedEntrypoint: `${process.execPath} serve`
     };
   }
+  const serverJs = path2.join(path2.dirname(entrypoint), "server.js");
+  if (existsSync3(serverJs) && path2.basename(entrypoint) !== "server.js") {
+    entrypoint = serverJs;
+  }
   return {
     command: process.execPath,
     args: runtimeArgsForEntrypoint(metaUrl, entrypoint),
@@ -540,7 +544,7 @@ function stopServer(baseUrl) {
 }
 
 // ../../src/workflow/publish.ts
-import { existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync3, readdirSync as readdirSync2, writeFileSync as writeFileSync2 } from "node:fs";
+import { existsSync as existsSync4, mkdirSync as mkdirSync2, readFileSync as readFileSync3, readdirSync as readdirSync2, writeFileSync as writeFileSync2 } from "node:fs";
 import { homedir } from "node:os";
 import { join as join2 } from "node:path";
 
@@ -567,7 +571,7 @@ function workflowPublishArtifactPathForSkill(skillId) {
 }
 function readWorkflowPublishArtifact(skillId) {
   const target = workflowPublishArtifactPathForSkill(skillId);
-  if (!existsSync3(target))
+  if (!existsSync4(target))
     return null;
   try {
     return JSON.parse(readFileSync3(target, "utf-8"));
@@ -577,13 +581,13 @@ function readWorkflowPublishArtifact(skillId) {
 }
 function listWorkflowPublishArtifacts() {
   const dir = getWorkflowExportDir();
-  if (!existsSync3(dir))
+  if (!existsSync4(dir))
     return [];
   return readdirSync2(dir).filter((entry) => entry.endsWith(".json")).map((entry) => join2(dir, entry));
 }
 
 // ../../src/impact-log.ts
-import { existsSync as existsSync4, mkdirSync as mkdirSync3, appendFileSync, statSync, readFileSync as readFileSync4, renameSync, unlinkSync as unlinkSync2 } from "node:fs";
+import { existsSync as existsSync5, mkdirSync as mkdirSync3, appendFileSync, statSync, readFileSync as readFileSync4, renameSync, unlinkSync as unlinkSync2 } from "node:fs";
 import { homedir as homedir2 } from "node:os";
 import { dirname as dirname2, join as join3 } from "node:path";
 var MAX_LOG_BYTES = 5 * 1024 * 1024;
@@ -599,19 +603,19 @@ function getImpactLogPath() {
 }
 function ensureDir2(path4) {
   const dir = dirname2(path4);
-  if (!existsSync4(dir))
+  if (!existsSync5(dir))
     mkdirSync3(dir, { recursive: true });
 }
 function rotateIfNeeded(path4) {
   try {
-    if (!existsSync4(path4))
+    if (!existsSync5(path4))
       return;
     const size = statSync(path4).size;
     if (size < MAX_LOG_BYTES)
       return;
     for (let i = MAX_ROTATIONS;i >= 1; i--) {
       const older = `${path4}.${i}`;
-      if (!existsSync4(older))
+      if (!existsSync5(older))
         continue;
       if (i === MAX_ROTATIONS) {
         try {
@@ -681,10 +685,10 @@ function readImpactSummary() {
   const files = [];
   for (let i = MAX_ROTATIONS;i >= 1; i--) {
     const rotated = `${path4}.${i}`;
-    if (existsSync4(rotated))
+    if (existsSync5(rotated))
       files.push(rotated);
   }
-  if (existsSync4(path4))
+  if (existsSync5(path4))
     files.push(path4);
   if (files.length === 0)
     return summary;
@@ -741,9 +745,9 @@ function readImpactSummary() {
 }
 
 // ../../src/client/index.ts
-import { readFileSync as readFileSync5, writeFileSync as writeFileSync3, existsSync as existsSync6, mkdirSync as mkdirSync4, readdirSync as readdirSync3 } from "fs";
+import { readFileSync as readFileSync5, writeFileSync as writeFileSync3, existsSync as existsSync7, mkdirSync as mkdirSync4, readdirSync as readdirSync3 } from "fs";
 import { join as join5 } from "path";
-import { homedir as homedir4, hostname } from "os";
+import { homedir as homedir4, hostname, release as osRelease } from "os";
 
 // ../../src/payments/cascade.ts
 import bs58 from "bs58";
@@ -792,7 +796,7 @@ function sanitizeProfileName2(value) {
 function loadConfig() {
   try {
     const configPath = getConfigPath();
-    if (existsSync6(configPath)) {
+    if (existsSync7(configPath)) {
       return JSON.parse(readFileSync5(configPath, "utf-8"));
     }
   } catch {}
@@ -1312,7 +1316,7 @@ function getPackageRoot2() {
   let dir = path4.dirname(fileURLToPath3(import.meta.url));
   const root = path4.parse(dir).root;
   while (dir !== root) {
-    if (path4.basename(dir) === "src" && existsSync7(path4.join(path4.dirname(dir), "package.json"))) {
+    if (path4.basename(dir) === "src" && existsSync8(path4.join(path4.dirname(dir), "package.json"))) {
       return path4.dirname(dir);
     }
     try {
@@ -1406,12 +1410,23 @@ function addExecuteNextStepHints(result, args) {
     hints.feedback_skill = skillId;
   if (endpointId)
     hints.feedback_endpoint = endpointId;
+  const constraints = isPlainObject(nested) && Array.isArray(nested.constraints) ? nested.constraints : undefined;
+  if (constraints?.length) {
+    hints.known_constraints = constraints;
+  }
+  const annotations = isPlainObject(nested) && Array.isArray(nested.annotations) ? nested.annotations : undefined;
+  if (annotations?.length) {
+    hints.community_notes = annotations;
+  }
   const desc = isPlainObject(nested) && typeof nested.description === "string" ? nested.description : "";
   const looksGeneric = !desc || desc.startsWith("Captured ") || desc.startsWith("Returns results");
   if (looksGeneric) {
     hints.first_use_review_needed = true;
     hints.review_step = "After feedback, call unbrowse_review to write proper endpoint descriptions, then unbrowse_publish to share to marketplace.";
   }
+  if (skillId && endpointId) {
+    hints.contribute = "If you learned something about this endpoint (required params, gotchas, best practices), call unbrowse_annotate to share it with other agents.";
+  }
   return { ...result, _workflow_hints: hints };
 }
 function addCaptureNextStepHints(result, _args) {
@@ -2448,6 +2463,42 @@ var tools = [
       const withHints = addCaptureNextStepHints(result, args);
       return successResult(withHints, "Browse session closed. See _workflow_hints for required next steps: call unbrowse_review then unbrowse_publish.");
     }
+  },
+  {
+    name: "unbrowse_annotate",
+    description: "Contribute constraints or best practices for an endpoint. Call this after executing an endpoint to share what you learned (required params, gotchas, tips) with other agents.",
+    parameters: {
+      type: "object",
+      properties: {
+        skill: { type: "string", description: "Skill ID" },
+        endpoint: { type: "string", description: "Endpoint ID" },
+        constraints: {
+          type: "array",
+          description: "Learned constraints (required params, deprecated fields, format rules)",
+          items: { type: "object", properties: { param: { type: "string" }, rule: { type: "string" }, message: { type: "string" } }, required: ["param", "rule", "message"] }
+        },
+        annotations: {
+          type: "array",
+          description: "Free-text best practices, tips, or gotchas",
+          items: { type: "object", properties: { text: { type: "string" } }, required: ["text"] }
+        }
+      },
+      required: ["skill", "endpoint"]
+    },
+    handler: async (args) => {
+      await ensureServerReady();
+      const skillId = args.skill;
+      const endpointId = args.endpoint;
+      const body = {};
+      if (Array.isArray(args.constraints))
+        body.constraints = args.constraints;
+      if (Array.isArray(args.annotations))
+        body.annotations = args.annotations;
+      if (!body.constraints && !body.annotations)
+        return errorResult("Provide constraints and/or annotations");
+      const result = await api2("POST", `/v1/skills/${skillId}/endpoints/${endpointId}/annotate`, body);
+      return successResult(result, "Annotation saved. Other agents will see your contribution when using this endpoint.");
+    }
   }
 ];
 var toolMap = new Map(tools.map((tool) => [tool.name, tool]));