unbrowse 2.8.4 → 2.8.6

package/dist/cli.js

@@ -624,14 +624,6 @@ async function executeInPageFetch(tabId, url, method, headers, body) {
     return { status: 0, data: result };
   }
 }
-async function health() {
-  try {
-    const result = await kuriGet("/health");
-    return { ok: result?.ok === true || result?.status === "ok", tabs: result?.tabs };
-  } catch {
-    return { ok: false };
-  }
-}
 async function action(tabId, actionType, ref, value) {
   const params = { tab_id: tabId, action: actionType, ref };
   if (value !== undefined)
@@ -5289,7 +5281,6 @@ var init_marketplace = __esm(() => {
 import { createHash as createHash3 } from "crypto";
 import { readFileSync as readFileSync3, readdirSync as readdirSync3 } from "fs";
 import { dirname, join as join4 } from "path";
-import { execSync } from "child_process";
 import { fileURLToPath as fileURLToPath2 } from "url";
 function collectTsFiles(dir) {
   const results = [];
@@ -5318,11 +5309,7 @@ function computeCodeHash() {
   }
 }
 function getGitSha() {
-  try {
-    return execSync("git rev-parse --short HEAD", { encoding: "utf-8", cwd: MODULE_DIR }).trim();
-  } catch {
-    return "unknown";
-  }
+  return "unknown";
 }
 var MODULE_DIR, CODE_HASH, GIT_SHA, TRACE_VERSION;
 var init_version = __esm(() => {
@@ -6342,259 +6329,6 @@ var init_drift = __esm(() => {
   init_transform();
 });
 
-// ../../src/transform/schema-hints.ts
-function buildIntentProfile(intent) {
-  const text = intent?.toLowerCase() ?? "";
-  const profile = {
-    preferredPaths: [],
-    discouragedPaths: [],
-    preferredFields: [],
-    discouragedFields: [],
-    wantsStructuredRecords: /\b(search|list|find|get|fetch|timeline|feed|trending)\b/.test(text)
-  };
-  if (/\b(repo|repos|repository|repositories|code|projects?)\b/.test(text)) {
-    profile.preferredPaths.push("repositories", "repos", "results", "items", "data");
-    profile.preferredFields.push("full_name", "name", "description", "stargazers_count", "stars", "language", "owner", "url");
-    profile.discouragedPaths.push("accounts", "users", "hashtags", "topics");
-  }
-  if (/\b(post|posts|tweet|tweets|status|statuses|timeline|feed|thread|threads)\b/.test(text)) {
-    profile.preferredPaths.push("statuses", "posts", "tweets", "timeline", "entries", "results");
-    profile.preferredFields.push("content", "text", "body", "created_at", "url", "account", "username", "replies_count", "reblogs_count", "favourites_count");
-    profile.discouragedPaths.push("accounts", "users", "people", "profiles", "hashtags");
-  }
-  if (/\b(person|people|user|users|profile|profiles|member|members|account|accounts)\b/.test(text)) {
-    profile.preferredPaths.push("people", "users", "accounts", "profiles", "included", "elements");
-    profile.preferredFields.push("name", "headline", "title", "public_identifier", "username", "handle", "url");
-    profile.discouragedPaths.push("hashtags", "statuses", "posts");
-  }
-  if (/\b(trend|trending|topic|topics)\b/.test(text)) {
-    profile.preferredPaths.push("trends", "topics", "timeline", "entries", "results", "data");
-    profile.preferredFields.push("name", "query", "topic", "post_count", "tweet_volume", "url");
-    profile.discouragedPaths.push("accounts", "users");
-  }
-  return profile;
-}
-function findArrayCandidates(schema, path5, depth, results) {
-  if (schema.type === "array" && schema.items) {
-    const items = schema.items;
-    if (items.type === "object" && items.properties) {
-      const fieldCount = Object.keys(items.properties).length;
-      results.push({ path: path5 ? `${path5}[]` : "[]", itemSchema: items, fieldCount, depth });
-      for (const [key, prop] of Object.entries(items.properties)) {
-        const childPath = path5 ? `${path5}[].${key}` : `[].${key}`;
-        findArrayCandidates(prop, childPath, depth + 1, results);
-      }
-      return;
-    }
-    if (items.type === "array") {
-      findArrayCandidates(items, path5 ? `${path5}[]` : "[]", depth + 1, results);
-    }
-    return;
-  }
-  if (schema.type === "object" && schema.properties) {
-    for (const [key, prop] of Object.entries(schema.properties)) {
-      const childPath = path5 ? `${path5}.${key}` : key;
-      findArrayCandidates(prop, childPath, depth + 1, results);
-    }
-  }
-}
-function scoreField(name, schema) {
-  let score = 0;
-  const lower = name.toLowerCase();
-  if (/^(id|name|title|label|slug)$/i.test(name))
-    score += 10;
-  if (/^(url|link|href|uri)$/i.test(name))
-    score += 8;
-  if (/^(description|text|content|body|summary|bio)$/i.test(name))
-    score += 7;
-  if (/^(email|username|handle|screen.?name)$/i.test(name))
-    score += 7;
-  if (/date|time|created|updated|start|end/i.test(lower))
-    score += 5;
-  if (/count|total|price|amount|score|rating|likes|views|followers/i.test(lower))
-    score += 5;
-  if (/status|state|type|category|kind|tag/i.test(lower))
-    score += 4;
-  if (/city|address|location|lat|lng|geo|place|venue/i.test(lower))
-    score += 4;
-  if (/image|photo|avatar|thumbnail|cover|logo|icon/i.test(lower))
-    score += 3;
-  if (schema.type === "string" || schema.type === "integer" || schema.type === "number" || schema.type === "boolean") {
-    score += 2;
-  }
-  if (/urn|tracking|internal|hash|token|cursor|pagination|__/i.test(lower))
-    score -= 5;
-  if (name.startsWith("$") || name.startsWith("_"))
-    score -= 3;
-  return score;
-}
-function selectBestArray(candidates, intent) {
-  if (candidates.length === 0)
-    return null;
-  const profile = buildIntentProfile(intent);
-  const scored = candidates.map((c) => {
-    let score = c.fieldCount * 2;
-    if (c.depth >= 1 && c.depth <= 3)
-      score += 5;
-    if (c.depth === 0)
-      score += 2;
-    const pathLower = c.path.toLowerCase();
-    if (/data|results|items|entries|elements|records|list|feed|posts|events|users/i.test(pathLower)) {
-      score += 8;
-    }
-    if (/included|nodes|edges/i.test(pathLower))
-      score += 6;
-    for (const token of profile.preferredPaths) {
-      if (pathLower.includes(token))
-        score += 14;
-    }
-    for (const token of profile.discouragedPaths) {
-      if (pathLower.includes(token))
-        score -= 18;
-    }
-    const fieldNames = Object.keys(c.itemSchema.properties ?? {}).map((name) => name.toLowerCase());
-    for (const token of profile.preferredFields) {
-      if (fieldNames.includes(token.toLowerCase()))
-        score += 7;
-    }
-    for (const token of profile.discouragedFields) {
-      if (fieldNames.includes(token.toLowerCase()))
-        score -= 8;
-    }
-    if (profile.wantsStructuredRecords && c.fieldCount < 3)
-      score -= 12;
-    if (fieldNames.length > 0 && fieldNames.every((name) => /^(link|title|label|text|value)$/i.test(name))) {
-      score -= 16;
-    }
-    if (c.fieldCount < 3)
-      score -= 5;
-    return { candidate: c, score };
-  });
-  scored.sort((a, b) => b.score - a.score);
-  return scored[0]?.candidate ?? null;
-}
-function schemaToTree(schema, maxDepth = 3) {
-  const tree = {};
-  function walk(s, path5, depth) {
-    if (depth > maxDepth)
-      return;
-    if (s.type === "object" && s.properties) {
-      for (const [key, prop] of Object.entries(s.properties)) {
-        const childPath = path5 ? `${path5}.${key}` : key;
-        if (prop.type === "array" && prop.items) {
-          if (prop.items.type === "object" && prop.items.properties) {
-            const count = Object.keys(prop.items.properties).length;
-            tree[`${childPath}[]`] = `array<object> (${count} fields)`;
-            walk(prop.items, `${childPath}[]`, depth + 1);
-          } else {
-            tree[`${childPath}[]`] = `array<${prop.items.type}>`;
-          }
-        } else if (prop.type === "object" && prop.properties) {
-          const count = Object.keys(prop.properties).length;
-          tree[childPath] = `object (${count} fields)`;
-          walk(prop, childPath, depth + 1);
-        } else {
-          tree[childPath] = prop.type;
-        }
-      }
-    }
-  }
-  if (schema.type === "array" && schema.items) {
-    tree["[]"] = `array<${schema.items.type}>`;
-    if (schema.items.type === "object") {
-      walk(schema.items, "[]", 1);
-    }
-  } else {
-    walk(schema, "", 0);
-  }
-  return tree;
-}
-function generateExtractionHints(schema, intent) {
-  if (schema.type !== "object" && schema.type !== "array")
-    return null;
-  const profile = buildIntentProfile(intent);
-  if (schema.type === "object" && schema.properties) {
-    for (const token of profile.preferredPaths) {
-      const prop = schema.properties[token];
-      if (prop?.type === "array" && (!prop.items || prop.items.type !== "object")) {
-        return finalize({
-          path: `${token}[]`,
-          fields: [],
-          item_field_count: 0,
-          confidence: "medium"
-        }, schema);
-      }
-    }
-  }
-  const candidates = [];
-  findArrayCandidates(schema, "", 0, candidates);
-  if (candidates.length === 0) {
-    if (schema.type === "object" && schema.properties) {
-      const propCount = Object.keys(schema.properties).length;
-      if (propCount <= 5)
-        return null;
-    }
-    if (schema.type === "object" && schema.properties) {
-      const fields = Object.entries(schema.properties).map(([name, prop]) => ({ name, score: scoreField(name, prop) })).filter((f) => f.score > 0).sort((a, b) => b.score - a.score).slice(0, 8).map((f) => f.name);
-      if (fields.length >= 2) {
-        return finalize({ path: "", fields, item_field_count: Object.keys(schema.properties).length, confidence: "low" }, schema);
-      }
-    }
-    return null;
-  }
-  const best = selectBestArray(candidates, intent);
-  if (!best)
-    return null;
-  const itemProps = best.itemSchema.properties ?? {};
-  const scoredFields = Object.entries(itemProps).map(([name, prop]) => ({ name, score: scoreField(name, prop), type: prop.type })).sort((a, b) => b.score - a.score);
-  const topFields = scoredFields.filter((f) => f.score > 0).slice(0, 10).map((f) => f.name);
-  if (intent) {
-    const intentWords = intent.toLowerCase().split(/\s+/);
-    for (const field of scoredFields) {
-      if (topFields.includes(field.name))
-        continue;
-      const fieldLower = field.name.toLowerCase();
-      if (intentWords.some((w) => fieldLower.includes(w) || w.includes(fieldLower))) {
-        topFields.push(field.name);
-      }
-    }
-  }
-  if (topFields.length < 2) {
-    const primitiveFields = scoredFields.filter((f) => f.type === "string" || f.type === "integer" || f.type === "number").slice(0, 5).map((f) => f.name);
-    if (primitiveFields.length < 2)
-      return null;
-    return finalize({
-      path: best.path,
-      fields: primitiveFields,
-      item_field_count: best.fieldCount,
-      confidence: "low"
-    }, schema);
-  }
-  const confidence = best.fieldCount >= 5 ? "high" : best.fieldCount >= 3 ? "medium" : "low";
-  return finalize({
-    path: best.path,
-    fields: topFields,
-    item_field_count: best.fieldCount,
-    confidence
-  }, schema);
-}
-function finalize(hint, schema) {
-  hint.cli_args = hintsToCliArgs(hint);
-  hint.schema_tree = schemaToTree(schema, 2);
-  return hint;
-}
-function hintsToCliArgs(hints) {
-  const parts = [];
-  if (hints.path) {
-    parts.push(`--path "${hints.path}"`);
-  }
-  if (hints.fields.length > 0) {
-    parts.push(`--extract "${hints.fields.join(",")}"`);
-  }
-  parts.push("--limit 10");
-  return parts.join(" ");
-}
-
 // ../../src/execution/retry.ts
 async function withRetry(fn, isRetryable, opts) {
   const maxRetries = opts?.maxRetries ?? MAX_RETRIES;
@@ -9760,7 +9494,7 @@ function sanitizeNavigationQueryParams(url) {
   return out;
 }
 function restoreTemplatePlaceholderEncoding(url) {
-  return url.replace(/%7B/gi, "{").replace(/%7D/gi, "}");
+  return url.replace(/%7B(\w+)%7D/gi, "{$1}");
 }
 function compactSchemaSample(value, depth = 0) {
   if (depth >= 4)
@@ -10807,6 +10541,15 @@ async function tryHttpFetch(url, authHeaders, cookies) {
     return null;
   }
 }
+function flattenExtracted(data) {
+  if (!Array.isArray(data))
+    return data;
+  const first = data[0];
+  if (first && typeof first === "object" && "type" in first && "data" in first && "relevance_score" in first) {
+    return data.reduce((best, cur) => (cur.relevance_score ?? 0) > (best.relevance_score ?? 0) ? cur : best).data;
+  }
+  return data;
+}
 async function executeDomExtractionEndpoint(endpoint, url, intent, authHeaders, cookies) {
   const ssrResult = await tryHttpFetch(url, authHeaders, cookies);
   if (ssrResult) {
@@ -10818,16 +10561,7 @@ async function executeDomExtractionEndpoint(endpoint, url, intent, authHeaders,
         if (ssrSemantic.verdict !== "fail") {
           console.log(`[ssr-fast] hit — extracted via HTTP fetch`);
           return {
-            data: {
-              data: ssrExtracted.data,
-              _extraction: {
-                method: ssrExtracted.extraction_method,
-                confidence: ssrExtracted.confidence,
-                source: "ssr-fast",
-                final_url: ssrResult.final_url,
-                ...ssrExtracted.selector ? { selector: ssrExtracted.selector } : {}
-              }
-            },
+            data: flattenExtracted(ssrExtracted.data),
             status: 200,
             trace_id: nanoid5()
           };
@@ -10865,16 +10599,7 @@ async function executeDomExtractionEndpoint(endpoint, url, intent, authHeaders,
       };
     }
     return {
-      data: {
-        data: extracted.data,
-        _extraction: {
-          method: extracted.extraction_method,
-          confidence: extracted.confidence,
-          source: "rendered-dom",
-          final_url: captured.final_url,
-          ...extracted.selector ? { selector: extracted.selector } : {}
-        }
-      },
+      data: flattenExtracted(extracted.data),
       status: 200,
       trace_id: nanoid5()
     };
@@ -10933,9 +10658,7 @@ async function executeEndpoint(skill, endpoint, params = {}, projection, options
       }
       return {
         trace: trace2,
-        result: resultData2,
-        ...endpoint.response_schema ? { response_schema: endpoint.response_schema } : {},
-        ...endpoint.response_schema ? { extraction_hints: generateExtractionHints(endpoint.response_schema, skill.intent_signature) ?? undefined } : {}
+        result: resultData2
       };
     } catch (err) {
       const trace2 = stampTrace({
@@ -11183,6 +10906,7 @@ async function executeEndpoint(skill, endpoint, params = {}, projection, options
     let last = { data: null, status: 0 };
     for (const replayUrl of replayUrls) {
       const replayHeaders = buildStructuredReplayHeaders(url, replayUrl, headers);
+      log("exec", `server-fetch: ${endpoint.method} ${replayUrl.substring(0, 80)} csrf=${replayHeaders["x-csrf-token"]?.substring(0, 10)}... cookies=${replayHeaders["cookie"]?.length ?? 0}chars`);
       const res = await fetch(replayUrl, {
         method: endpoint.method,
         headers: replayHeaders,
@@ -11260,7 +10984,8 @@ async function executeEndpoint(skill, endpoint, params = {}, projection, options
       try {
         result = await serverFetch();
         if (result.status >= 200 && result.status < 400) {
-          if (shouldFallbackToBrowserReplay(result.data, endpoint, options?.intent ?? skill.intent_signature, options?.contextUrl)) {
+          const isApiEndpoint = /\/(api|graphql)\b/i.test(endpoint.url_template) || /\.(json)(\?|$)/.test(endpoint.url_template);
+          if (!isApiEndpoint && shouldFallbackToBrowserReplay(result.data, endpoint, options?.intent ?? skill.intent_signature, options?.contextUrl)) {
             result = await withRetry(browserCall, (r) => isRetryableStatus(r.status));
             strategy = "browser";
           } else {
@@ -11453,12 +11178,9 @@ async function executeEndpoint(skill, endpoint, params = {}, projection, options
   } else if (trace.success) {
     resultData = projectResultForIntent(data, effectiveIntent);
   }
-  const rawResultShape = resultData === data;
   return {
     trace,
-    result: resultData,
-    ...endpoint.response_schema && rawResultShape ? { response_schema: endpoint.response_schema } : {},
-    ...endpoint.response_schema && rawResultShape ? { extraction_hints: generateExtractionHints(endpoint.response_schema, effectiveIntent) ?? undefined } : {}
+    result: resultData
   };
 }
 function templatizeQueryParams(url) {
@@ -13012,15 +12734,84 @@ import { nanoid as nanoid7 } from "nanoid";
 import { existsSync as existsSync9, writeFileSync as writeFileSync7, readFileSync as readFileSync6, mkdirSync as mkdirSync8, readdirSync as readdirSync5 } from "node:fs";
 import { dirname as dirname2, join as join9 } from "node:path";
 import { createHash as createHash6 } from "node:crypto";
-function summarizeSchema(schema) {
-  if (schema.properties) {
-    return Object.fromEntries(Object.entries(schema.properties).map(([k, v]) => [k, v.type]));
-  }
-  if (schema.type === "array" && schema.items?.properties) {
-    return Object.fromEntries(Object.entries(schema.items.properties).map(([k, v]) => [k, v.type]));
+function summarizeSchema(schema, maxDepth = 3) {
+  function walk(s, depth) {
+    if (depth <= 0)
+      return s.type;
+    if (s.type === "array" && s.items) {
+      const inner = walk(s.items, depth - 1);
+      return inner && typeof inner === "object" ? [inner] : [`${s.items.type ?? "unknown"}`];
+    }
+    if (s.properties) {
+      const out = {};
+      for (const [k, v] of Object.entries(s.properties)) {
+        out[k] = walk(v, depth - 1);
+      }
+      return out;
+    }
+    return s.type;
   }
+  if (schema.properties)
+    return walk(schema, maxDepth);
+  if (schema.type === "array" && schema.items)
+    return { "[]": walk(schema.items, maxDepth - 1) };
   return null;
 }
+function extractSampleValues(sample, maxLeaves = 12) {
+  if (sample == null)
+    return null;
+  const SKIP_KEYS = new Set([
+    "__typename",
+    "entryType",
+    "itemType",
+    "clientEventInfo",
+    "feedbackInfo",
+    "controllerData",
+    "injectionType",
+    "sortIndex",
+    "cursor",
+    "cursorType",
+    "displayTreatment",
+    "socialContext",
+    "promotedMetadata",
+    "feedbackKeys",
+    "tweetDisplayType",
+    "element",
+    "component",
+    "details"
+  ]);
+  const out = {};
+  let count = 0;
+  function walk(obj, path5, depth) {
+    if (count >= maxLeaves || depth > 10)
+      return;
+    if (obj == null)
+      return;
+    if (Array.isArray(obj)) {
+      if (obj.length > 0)
+        walk(obj[0], path5 + "[]", depth + 1);
+      return;
+    }
+    if (typeof obj === "object") {
+      for (const [k, v] of Object.entries(obj)) {
+        if (count >= maxLeaves)
+          break;
+        if (SKIP_KEYS.has(k))
+          continue;
+        const p = path5 ? `${path5}.${k}` : k;
+        if (v != null && typeof v === "object") {
+          walk(v, p, depth + 1);
+        } else if (v != null && v !== "" && v !== 0 && v !== false) {
+          out[p] = typeof v === "string" && v.length > 80 ? v.slice(0, 77) + "..." : v;
+          count++;
+        }
+      }
+      return;
+    }
+  }
+  walk(sample, "", 0);
+  return count > 0 ? out : null;
+}
 function persistDomainCache() {
   try {
     const dir = dirname2(DOMAIN_CACHE_FILE);
@@ -13274,14 +13065,12 @@ function cacheResolvedSkill(cacheKey, skill, endpointId) {
   });
   persistRouteCache();
 }
-function promoteResultSnapshot(cacheKey, skill, endpointId, result, trace, response_schema, extraction_hints) {
+function promoteResultSnapshot(cacheKey, skill, endpointId, result, trace) {
   routeResultCache.set(cacheKey, {
     skill,
     endpointId,
     result,
     trace,
-    response_schema,
-    extraction_hints,
     expires: Date.now() + ROUTE_CACHE_TTL
   });
 }
@@ -13299,9 +13088,7 @@ function buildCachedResultResponse(cached, source, timing) {
     },
     source,
     skill: cached.skill,
-    timing,
-    response_schema: cached.response_schema,
-    extraction_hints: cached.extraction_hints
+    timing
   };
 }
 function invalidateResolveCacheEntries(cacheKeys, domainKeys = []) {
@@ -14349,7 +14136,7 @@ async function resolveAndExecute(intent, params = {}, context, projection, optio
         routeResultCache.delete(k);
     }
   }
-  function finalize2(source, result2, skillId, skill, trace2) {
+  function finalize(source, result2, skillId, skill, trace2) {
     timing.total_ms = Date.now() - t0;
     timing.source = source;
     timing.skill_id = skillId;
@@ -14497,6 +14284,15 @@ async function resolveAndExecute(intent, params = {}, context, projection, optio
           url: r.endpoint.url_template.length > 120 ? r.endpoint.url_template.slice(0, 120) + "..." : r.endpoint.url_template,
           score: Math.round(r.score * 10) / 10,
           schema_summary: r.endpoint.response_schema ? summarizeSchema(r.endpoint.response_schema) : null,
+          input_params: r.endpoint.semantic?.requires?.map((b) => ({
+            key: b.key,
+            type: b.type ?? b.semantic_type,
+            required: b.required ?? false,
+            example: b.example_value
+          })) ?? [],
+          description_in: r.endpoint.semantic?.description_in,
+          example_fields: r.endpoint.semantic?.example_fields?.slice(0, 12),
+          sample_values: extractSampleValues(r.endpoint.semantic?.example_response_compact),
           dom_extraction: !!r.endpoint.dom_extraction,
           trigger_url: r.endpoint.trigger_url
         })),
@@ -14505,7 +14301,7 @@ async function resolveAndExecute(intent, params = {}, context, projection, optio
       trace: deferTrace,
       source,
       skill: resolvedSkill,
-      timing: finalize2(source, null, resolvedSkill.skill_id, resolvedSkill, deferTrace)
+      timing: finalize(source, null, resolvedSkill.skill_id, resolvedSkill, deferTrace)
     };
   }
   function missingTemplateParams(endpoint, boundParams) {
@@ -14835,7 +14631,7 @@ async function resolveAndExecute(intent, params = {}, context, projection, optio
             skill_id: skill.skill_id,
             selected_endpoint_id: candidate.endpoint.endpoint_id
           });
-          promoteResultSnapshot(cacheKey, skill, candidate.endpoint.endpoint_id, execOut.result, execOut.trace, execOut.response_schema, execOut.extraction_hints);
+          promoteResultSnapshot(cacheKey, skill, candidate.endpoint.endpoint_id, execOut.result, execOut.trace);
           try {
             const endpointSeq = decisionTrace.autoexec_attempts.map((a) => a.endpoint_id);
             storeExecutionTrace({
@@ -14892,7 +14688,7 @@ async function resolveAndExecute(intent, params = {}, context, projection, optio
                     trace: execOut.trace,
                     source,
                     skill,
-                    timing: finalize2(source, null, skill.skill_id, skill, execOut.trace)
+                    timing: finalize(source, null, skill.skill_id, skill, execOut.trace)
                   };
                 }
               }
@@ -14913,9 +14709,7 @@ async function resolveAndExecute(intent, params = {}, context, projection, optio
             trace: execOut.trace,
             source,
             skill,
-            timing: finalize2(source, execOut.result, skill.skill_id, skill, execOut.trace),
-            response_schema: execOut.response_schema,
-            extraction_hints: execOut.extraction_hints
+            timing: finalize(source, execOut.result, skill.skill_id, skill, execOut.trace)
           };
         }
         decisionTrace.autoexec_attempts.push({
@@ -14979,7 +14773,7 @@ async function resolveAndExecute(intent, params = {}, context, projection, optio
           skill_id: cachedResult.skill.skill_id,
           selected_endpoint_id: cachedResult.endpointId ?? cachedResult.trace.endpoint_id
         });
-        return buildCachedResultResponse(cachedResult, "marketplace", finalize2("route-cache", cachedResult.result, cachedResult.skill.skill_id, cachedResult.skill, cachedResult.trace));
+        return buildCachedResultResponse(cachedResult, "marketplace", finalize("route-cache", cachedResult.result, cachedResult.skill.skill_id, cachedResult.skill, cachedResult.trace));
       }
     }
   }
@@ -15093,15 +14887,13 @@ async function resolveAndExecute(intent, params = {}, context, projection, optio
           timing.execute_ms = Date.now() - te02;
           if (execOut.trace.success && isAcceptableIntentResult(execOut.result, queryIntent)) {
             timing.cache_hit = true;
-            promoteResultSnapshot(cacheKey, skill, params.endpoint_id ?? cached.entry.endpointId, execOut.result, execOut.trace, execOut.response_schema, execOut.extraction_hints);
+            promoteResultSnapshot(cacheKey, skill, params.endpoint_id ?? cached.entry.endpointId, execOut.result, execOut.trace);
             return {
               result: execOut.result,
               trace: execOut.trace,
               source: "marketplace",
               skill,
-              timing: finalize2("route-cache", execOut.result, cached.entry.skillId, skill, execOut.trace),
-              response_schema: execOut.response_schema,
-              extraction_hints: execOut.extraction_hints
+              timing: finalize("route-cache", execOut.result, cached.entry.skillId, skill, execOut.trace)
             };
           }
         } catch {
@@ -15208,15 +15000,13 @@ async function resolveAndExecute(intent, params = {}, context, projection, optio
           ])));
           timing.execute_ms = Date.now() - te02;
           cacheResolvedSkill(cacheKey, winner.candidate.skill, winner.trace.endpoint_id);
-          promoteResultSnapshot(cacheKey, winner.candidate.skill, winner.trace.endpoint_id, winner.result, winner.trace, winner.response_schema, winner.extraction_hints);
+          promoteResultSnapshot(cacheKey, winner.candidate.skill, winner.trace.endpoint_id, winner.result, winner.trace);
           return {
             result: winner.result,
             trace: winner.trace,
             source: "marketplace",
             skill: winner.candidate.skill,
-            timing: finalize2("marketplace", winner.result, winner.candidate.skill.skill_id, winner.candidate.skill, winner.trace),
-            response_schema: winner.response_schema,
-            extraction_hints: winner.extraction_hints
+            timing: finalize("marketplace", winner.result, winner.candidate.skill.skill_id, winner.candidate.skill, winner.trace)
           };
         } catch (err) {
           console.log(`[race] all candidates failed after ${Date.now() - te02}ms: ${err.message}`);
@@ -15253,7 +15043,7 @@ async function resolveAndExecute(intent, params = {}, context, projection, optio
           completed_at: new Date().toISOString(),
           success: true
         };
-        const t = finalize2("direct-fetch", data, "direct-fetch", undefined, trace2);
+        const t = finalize("direct-fetch", data, "direct-fetch", undefined, trace2);
         console.log(`[direct-fetch] ${context.url} returned JSON directly — skipping browser`);
         return {
           result: data,
@@ -15285,7 +15075,7 @@ async function resolveAndExecute(intent, params = {}, context, projection, optio
         success: true,
         network_events: firstPassResult.interceptedEntries
       };
-      const t = finalize2("first-pass", firstPassResult.result, firstPassResult.miniSkill.skill_id, firstPassResult.miniSkill, trace2);
+      const t = finalize("first-pass", firstPassResult.result, firstPassResult.miniSkill.skill_id, firstPassResult.miniSkill, trace2);
       return {
         result: firstPassResult.result,
         trace: trace2,
@@ -15321,7 +15111,7 @@ async function resolveAndExecute(intent, params = {}, context, projection, optio
         completed_at: fpNow,
         success: true
       };
-      const t = finalize2("browse-session", null, "browse-session", undefined, trace2);
+      const t = finalize("browse-session", null, "browse-session", undefined, trace2);
       return {
         result: {
           status: "browse_session_open",
@@ -15359,15 +15149,13 @@ async function resolveAndExecute(intent, params = {}, context, projection, optio
       if (agentChoseEndpoint) {
         const execOut = await executeSkill(domainHit.skill, { ...params, endpoint_id: params.endpoint_id ?? domainHit.endpointId, ...queryIntent !== intent ? { intent: queryIntent } : {} }, projection, { ...options, intent: queryIntent, contextUrl: context?.url });
         if (execOut.trace.success && isAcceptableIntentResult(execOut.result, queryIntent)) {
-          promoteResultSnapshot(cacheKey, domainHit.skill, params.endpoint_id ?? domainHit.endpointId, execOut.result, execOut.trace, execOut.response_schema, execOut.extraction_hints);
+          promoteResultSnapshot(cacheKey, domainHit.skill, params.endpoint_id ?? domainHit.endpointId, execOut.result, execOut.trace);
           return {
             result: execOut.result,
             trace: execOut.trace,
             source: "marketplace",
             skill: domainHit.skill,
-            timing: finalize2("marketplace", execOut.result, domainHit.skill.skill_id, domainHit.skill, execOut.trace),
-            response_schema: execOut.response_schema,
-            extraction_hints: execOut.extraction_hints
+            timing: finalize("marketplace", execOut.result, domainHit.skill.skill_id, domainHit.skill, execOut.trace)
           };
         }
         invalidateResolveCacheEntries([cacheKey], requestedDomainCacheKey ? [requestedDomainCacheKey] : []);
@@ -15403,7 +15191,7 @@ async function resolveAndExecute(intent, params = {}, context, projection, optio
           trace,
           source: "live-capture",
           skill: await getOrCreateBrowserCaptureSkill(),
-          timing: finalize2("live-capture", result, undefined, undefined, trace)
+          timing: finalize("live-capture", result, undefined, undefined, trace)
         };
       }
       if (learned_skill) {
@@ -15422,7 +15210,7 @@ async function resolveAndExecute(intent, params = {}, context, projection, optio
         trace,
         source: "live-capture",
         skill: await getOrCreateBrowserCaptureSkill(),
-        timing: finalize2("live-capture", result, undefined, undefined, trace)
+        timing: finalize("live-capture", result, undefined, undefined, trace)
       };
     }
   }
@@ -15512,7 +15300,7 @@ async function resolveAndExecute(intent, params = {}, context, projection, optio
       trace: rejectedTrace,
       source: "live-capture",
       skill: captureSkill,
-      timing: finalize2("live-capture", result, undefined, undefined, rejectedTrace)
+      timing: finalize("live-capture", result, undefined, undefined, rejectedTrace)
     };
   }
   if (learned_skill && learnedSkillUsable) {
@@ -15546,7 +15334,7 @@ async function resolveAndExecute(intent, params = {}, context, projection, optio
       trace,
       source: "live-capture",
       skill: captureSkill,
-      timing: finalize2("live-capture", result, undefined, undefined, trace)
+      timing: finalize("live-capture", result, undefined, undefined, trace)
     };
   }
   const hasNonDomApiEndpoints = !!learned_skill?.endpoints?.some((ep) => !ep.dom_extraction && ep.method !== "WS");
@@ -15560,7 +15348,7 @@ async function resolveAndExecute(intent, params = {}, context, projection, optio
         trace,
         source: directExtractionSource === "html-embedded" ? "live-capture" : "dom-fallback",
         skill: learned_skill,
-        timing: finalize2(directExtractionSource === "html-embedded" ? "live-capture" : "dom-fallback", result, learned_skill.skill_id, learned_skill, trace)
+        timing: finalize(directExtractionSource === "html-embedded" ? "live-capture" : "dom-fallback", result, learned_skill.skill_id, learned_skill, trace)
       };
       queuePassivePublishIfExecuted(learned_skill, direct, parityBaseline);
       return direct;
@@ -15570,7 +15358,7 @@ async function resolveAndExecute(intent, params = {}, context, projection, optio
       trace,
       source: "dom-fallback",
       skill: captureSkill,
-      timing: finalize2("dom-fallback", result, undefined, undefined, trace)
+      timing: finalize("dom-fallback", result, undefined, undefined, trace)
     };
   }
   if (!learned_skill) {
@@ -15579,7 +15367,7 @@ async function resolveAndExecute(intent, params = {}, context, projection, optio
       trace,
       source: "live-capture",
       skill: captureSkill,
-      timing: finalize2("live-capture", result, undefined, undefined, trace)
+      timing: finalize("live-capture", result, undefined, undefined, trace)
     };
   }
   if (agentChoseEndpoint && learned_skill) {
@@ -15598,22 +15386,18 @@ async function resolveAndExecute(intent, params = {}, context, projection, optio
         trace: execOut.trace,
         source: "live-capture",
         skill: learned_skill,
-        timing: finalize2("live-capture", execOut.result, learned_skill.skill_id, learned_skill, execOut.trace),
-        response_schema: execOut.response_schema,
-        extraction_hints: execOut.extraction_hints
+        timing: finalize("live-capture", execOut.result, learned_skill.skill_id, learned_skill, execOut.trace)
       }, parityBaseline);
     }
     if (execOut.trace.success && isAcceptableIntentResult(execOut.result, queryIntent)) {
-      promoteResultSnapshot(cacheKey, learned_skill, execOut.trace.endpoint_id, execOut.result, execOut.trace, execOut.response_schema, execOut.extraction_hints);
+      promoteResultSnapshot(cacheKey, learned_skill, execOut.trace.endpoint_id, execOut.result, execOut.trace);
     }
     return {
       result: execOut.result,
       trace: execOut.trace,
       source: "live-capture",
       skill: learned_skill,
-      timing: finalize2("live-capture", execOut.result, learned_skill.skill_id, learned_skill, execOut.trace),
-      response_schema: execOut.response_schema,
-      extraction_hints: execOut.extraction_hints
+      timing: finalize("live-capture", execOut.result, learned_skill.skill_id, learned_skill, execOut.trace)
     };
   }
   const deferred = await buildDeferralWithAutoExec(learned_skill, "live-capture", authRecommended ? {
@@ -16699,7 +16483,19 @@ async function registerRoutes(app) {
   app.get("/v1/skills/:skill_id", async (req, reply) => {
     const clientScope = clientScopeFor(req);
     const { skill_id } = req.params;
-    const skill = getRecentLocalSkill(skill_id, clientScope) ?? await getSkill2(skill_id, clientScope);
+    let skill = getRecentLocalSkill(skill_id, clientScope);
+    if (!skill) {
+      for (const [, entry] of domainSkillCache) {
+        if (entry.skillId === skill_id && entry.localSkillPath) {
+          try {
+            skill = JSON.parse(__require("fs").readFileSync(entry.localSkillPath, "utf-8"));
+          } catch {}
+          break;
+        }
+      }
+    }
+    if (!skill)
+      skill = await getSkill2(skill_id, clientScope);
     if (!skill)
       return reply.code(404).send({ error: "Skill not found" });
     return reply.send(skill);
@@ -16710,18 +16506,46 @@ async function registerRoutes(app) {
     const { endpoints: reviews } = req.body;
     if (!reviews?.length)
       return reply.code(400).send({ error: "endpoints[] required" });
-    const skill = getRecentLocalSkill(skill_id, clientScope) ?? await getSkill2(skill_id, clientScope);
+    let skill = getRecentLocalSkill(skill_id, clientScope);
+    if (!skill) {
+      for (const [, entry] of domainSkillCache) {
+        if (entry.skillId === skill_id && entry.localSkillPath) {
+          try {
+            skill = JSON.parse(__require("fs").readFileSync(entry.localSkillPath, "utf-8"));
+          } catch {}
+          break;
+        }
+      }
+    }
+    if (!skill)
+      skill = await getSkill2(skill_id, clientScope);
     if (!skill)
       return reply.code(404).send({ error: "Skill not found" });
     const updated = mergeAgentReview(skill.endpoints, reviews);
     skill.endpoints = updated;
     skill.updated_at = new Date().toISOString();
     try {
-      await publishSkill2(skill);
-      return reply.send({ ok: true, endpoints_updated: reviews.length });
-    } catch (err) {
-      return reply.code(500).send({ error: err.message });
+      cachePublishedSkill(skill);
+    } catch {}
+    const domain = skill.domain;
+    if (domain) {
+      const revCacheKey = buildResolveCacheKey(domain, skill.intent_signature ?? `browse ${domain}`, undefined);
+      const revScopedKey = scopedCacheKey(clientScope, revCacheKey);
+      writeSkillSnapshot(revScopedKey, skill);
+      const revDomainKey = getDomainReuseKey(domain);
+      if (revDomainKey) {
+        domainSkillCache.set(revDomainKey, {
+          skillId: skill.skill_id,
+          localSkillPath: snapshotPathForCacheKey(revScopedKey),
+          ts: Date.now()
+        });
+        persistDomainCache();
+      }
     }
+    try {
+      await publishSkill2(skill);
+    } catch {}
+    return reply.send({ ok: true, endpoints_updated: reviews.length });
   });
   app.post("/v1/skills/:skill_id/chunk", async (req, reply) => {
     const clientScope = clientScopeFor(req);
@@ -17229,7 +17053,7 @@ __export(exports_server, {
   startUnbrowseServer: () => startUnbrowseServer,
   installServerExitCleanup: () => installServerExitCleanup
 });
-import { execSync as execSync3 } from "node:child_process";
+import { execSync as execSync2 } from "node:child_process";
 import { mkdirSync as mkdirSync10, unlinkSync, writeFileSync as writeFileSync9 } from "node:fs";
 import path5 from "node:path";
 import Fastify from "fastify";
@@ -17259,15 +17083,8 @@ async function startUnbrowseServer(options = {}) {
   const pidFile = options.pidFile ?? process.env.UNBROWSE_PID_FILE;
   updatePidFile(pidFile, host, port);
   try {
-    execSync3("pkill -f chrome-headless-shell", { stdio: "ignore" });
+    execSync2("pkill -f chrome-headless-shell", { stdio: "ignore" });
   } catch {}
-  try {
-    await start();
-    const h = await health();
-    console.log(`[startup] Kuri ready — ${h.tabs ?? 0} tabs`);
-  } catch (err) {
-    console.warn(`[startup] WARNING: Kuri not available. Capture will start it on demand. ${err instanceof Error ? err.message : err}`);
-  }
   await ensureRegistered2();
   const app = Fastify({ logger: options.logger ?? true });
   await app.register(cors, { origin: true });
@@ -17298,7 +17115,6 @@ var init_server = __esm(async () => {
   init_verification();
   init_client2();
   init_capture();
-  init_client();
   await init_routes();
 });
 
@@ -18294,184 +18110,6 @@ function normalizeSetupScope(value) {
     return normalized;
   return "auto";
 }
-function buildEntityIndex(items) {
-  const index = new Map;
-  for (const item of items) {
-    if (item != null && typeof item === "object") {
-      const urn = item.entityUrn;
-      if (typeof urn === "string")
-        index.set(urn, item);
-    }
-  }
-  return index;
-}
-function detectEntityIndex(data) {
-  if (data == null || typeof data !== "object")
-    return null;
-  let best = null;
-  const check = (arr) => {
-    if (arr.length < 2)
-      return;
-    const sample = arr.slice(0, 10);
-    const withUrn = sample.filter((i) => i != null && typeof i === "object" && typeof i.entityUrn === "string").length;
-    if (withUrn >= sample.length * 0.5 && (!best || arr.length > best.length)) {
-      best = arr;
-    }
-  };
-  const obj = data;
-  for (const val of Object.values(obj)) {
-    if (Array.isArray(val)) {
-      check(val);
-    } else if (val != null && typeof val === "object" && !Array.isArray(val)) {
-      for (const nested of Object.values(val)) {
-        if (Array.isArray(nested))
-          check(nested);
-      }
-    }
-  }
-  return best ? buildEntityIndex(best) : null;
-}
-function resolvePath2(obj, path9, entityIndex) {
-  if (!path9 || obj == null)
-    return obj;
-  const segments = path9.split(".");
-  let cur = obj;
-  for (let i = 0;i < segments.length; i++) {
-    if (cur == null)
-      return;
-    const seg = segments[i];
-    if (seg.endsWith("[]")) {
-      const key = seg.slice(0, -2);
-      const arr = key ? cur[key] : cur;
-      if (!Array.isArray(arr))
-        return;
-      const remaining = segments.slice(i + 1).join(".");
-      if (!remaining)
-        return arr;
-      return arr.flatMap((item) => {
-        const v = resolvePath2(item, remaining, entityIndex);
-        return v === undefined ? [] : Array.isArray(v) ? v : [v];
-      });
-    }
-    const indexMatch = seg.match(/^(.+?)\[(\d+)\]$/);
-    if (indexMatch) {
-      const key = indexMatch[1];
-      const idx = parseInt(indexMatch[2], 10);
-      const arr = key ? cur[key] : cur;
-      if (!Array.isArray(arr) || idx >= arr.length)
-        return;
-      cur = arr[idx];
-      continue;
-    }
-    const rec = cur;
-    let val = rec[seg];
-    if (val == null && entityIndex) {
-      const ref = rec[`*${seg}`];
-      if (typeof ref === "string") {
-        val = entityIndex.get(ref);
-      }
-    }
-    cur = val;
-  }
-  return cur;
-}
-function extractFields(data, fields, entityIndex) {
-  if (data == null)
-    return data;
-  function mapItem(item) {
-    const out = {};
-    for (const f of fields) {
-      const colonIdx = f.indexOf(":");
-      const alias = colonIdx >= 0 ? f.slice(0, colonIdx) : f.split(".").pop();
-      const path9 = colonIdx >= 0 ? f.slice(colonIdx + 1) : f;
-      const resolved = resolvePath2(item, path9, entityIndex ?? undefined) ?? [];
-      out[alias] = Array.isArray(resolved) ? resolved.length === 0 ? null : resolved.length === 1 ? resolved[0] : resolved : resolved;
-    }
-    return out;
-  }
-  function hasValue(v) {
-    if (v == null)
-      return false;
-    if (Array.isArray(v))
-      return v.length > 0;
-    return true;
-  }
-  if (Array.isArray(data)) {
-    return data.map(mapItem).filter((row) => Object.values(row).some(hasValue));
-  }
-  return mapItem(data);
-}
-function hasMeaningfulValue(value) {
-  if (value == null)
-    return false;
-  if (typeof value === "string")
-    return value.trim().length > 0;
-  if (typeof value === "number" || typeof value === "boolean")
-    return true;
-  if (Array.isArray(value))
-    return value.some((item) => hasMeaningfulValue(item));
-  if (typeof value === "object")
-    return Object.values(value).some((item) => hasMeaningfulValue(item));
-  return false;
-}
-function isPlainRecord(value) {
-  return value != null && typeof value === "object" && !Array.isArray(value);
-}
-function isScalarLike(value) {
-  if (value == null)
-    return false;
-  if (typeof value === "string")
-    return value.trim().length > 0;
-  if (typeof value === "number" || typeof value === "boolean")
-    return true;
-  if (Array.isArray(value)) {
-    return value.length > 0 && value.every((item) => item == null || typeof item === "string" || typeof item === "number" || typeof item === "boolean");
-  }
-  return false;
-}
-function looksStructuredForDirectOutput(value) {
-  if (Array.isArray(value)) {
-    const sample = value.filter(isPlainRecord).slice(0, 3);
-    if (sample.length === 0)
-      return false;
-    const simpleRows = sample.filter((row) => {
-      const keys2 = Object.keys(row);
-      const scalarFields2 = Object.values(row).filter(isScalarLike).length;
-      return keys2.length > 0 && keys2.length <= 20 && scalarFields2 >= 2;
-    });
-    return simpleRows.length >= Math.ceil(sample.length / 2);
-  }
-  if (!isPlainRecord(value))
-    return false;
-  const keys = Object.keys(value);
-  if (keys.length === 0 || keys.length > 20)
-    return false;
-  const scalarFields = Object.values(value).filter(isScalarLike).length;
-  return scalarFields >= 2;
-}
-function applyTransforms(result, flags) {
-  let data = result;
-  const entityIndex = detectEntityIndex(result);
-  const pathFlag = flags.path;
-  if (pathFlag) {
-    data = resolvePath2(data, pathFlag, entityIndex);
-    if (data === undefined) {
-      process.stderr.write(`[unbrowse] warning: --path "${pathFlag}" resolved to undefined. Check path against response structure.
-`);
-      return [];
-    }
-  }
-  const extractFlag = flags.extract;
-  if (extractFlag) {
-    const fields = extractFlag.split(",").map((f) => f.trim());
-    data = extractFields(data, fields, entityIndex);
-  }
-  const limitFlag = flags.limit;
-  if (limitFlag && Array.isArray(data)) {
-    data = data.slice(0, Number(limitFlag));
-  }
-  return data;
-}
 function slimTrace(obj) {
   const trace = obj.trace;
   const out = {
@@ -18487,67 +18125,14 @@ function slimTrace(obj) {
   };
   if ("result" in obj)
     out.result = obj.result;
+  if (obj.available_endpoints)
+    out.available_endpoints = obj.available_endpoints;
+  if (obj.source)
+    out.source = obj.source;
+  if (obj.skill)
+    out.skill = obj.skill;
   return out;
 }
-function wrapWithHints(obj) {
-  const hints = obj.extraction_hints;
-  if (!hints)
-    return obj;
-  const resultStr = JSON.stringify(obj.result ?? "");
-  if (resultStr.length < 2000)
-    return obj;
-  const trace = obj.trace;
-  return {
-    trace: trace ? {
-      trace_id: trace.trace_id,
-      skill_id: trace.skill_id,
-      endpoint_id: trace.endpoint_id,
-      success: trace.success,
-      status_code: trace.status_code
-    } : undefined,
-    _response_too_large: `${resultStr.length} bytes \u2014 use extraction flags below to get structured data`,
-    extraction_hints: hints
-  };
-}
-function schemaOnly(obj) {
-  const trace = obj.trace;
-  return {
-    trace: trace ? { trace_id: trace.trace_id, skill_id: trace.skill_id, endpoint_id: trace.endpoint_id, success: trace.success } : undefined,
-    extraction_hints: obj.extraction_hints ?? null,
-    response_schema: obj.response_schema ?? null
-  };
-}
-function autoExtractOrWrap(obj) {
-  const hints = obj.extraction_hints;
-  const resultStr = JSON.stringify(obj.result ?? "");
-  if (resultStr.length < 2000)
-    return obj;
-  if (looksStructuredForDirectOutput(obj.result)) {
-    return slimTrace({ ...obj, extraction_hints: undefined, response_schema: undefined });
-  }
-  if (!hints)
-    return obj;
-  if (hints.confidence === "high") {
-    const syntheticFlags = {};
-    if (hints.path)
-      syntheticFlags.path = hints.path;
-    if (hints.fields.length > 0)
-      syntheticFlags.extract = hints.fields.join(",");
-    syntheticFlags.limit = "20";
-    const extracted = applyTransforms(obj.result, syntheticFlags);
-    if (!hasMeaningfulValue(extracted))
-      return wrapWithHints(obj);
-    const slimmed = slimTrace({ ...obj, result: extracted });
-    slimmed._auto_extracted = {
-      applied: hints.cli_args,
-      confidence: hints.confidence,
-      all_fields: hints.schema_tree,
-      note: "Auto-extracted using response_schema. Add/remove fields with --extract, change array with --path, or use --raw for full response."
-    };
-    return slimmed;
-  }
-  return wrapWithHints(obj);
-}
 async function cmdHealth(flags) {
   output(await api3("GET", "/health"), !!flags.pretty);
 }
@@ -18559,6 +18144,8 @@ async function cmdResolve(flags) {
   const url = flags.url;
   const domain = flags.domain;
   const explicitEndpointId = flags["endpoint-id"];
+  const autoExecute = !!flags.execute;
+  const extraParams = flags.params ? JSON.parse(flags.params) : {};
   if (url) {
     body.params = { url };
     body.context = { url };
@@ -18570,14 +18157,19 @@ async function cmdResolve(flags) {
     body.params = { ...body.params ?? {}, endpoint_id: explicitEndpointId };
   }
   if (flags.params) {
-    body.params = { ...body.params ?? {}, ...JSON.parse(flags.params) };
+    body.params = { ...body.params ?? {}, ...extraParams };
   }
   if (flags["dry-run"])
     body.dry_run = true;
   if (flags["force-capture"])
     body.force_capture = true;
-  const hasTransforms = !!(flags.path || flags.extract);
   body.projection = { raw: true };
+  function execBody(endpointId) {
+    return { params: { endpoint_id: endpointId, ...extraParams }, intent, projection: { raw: true } };
+  }
+  function resolveSkillId() {
+    return result.skill?.skill_id ?? result.skill_id;
+  }
   const startedAt = Date.now();
   let result = await withPendingNotice(api3("POST", "/v1/intent/resolve", body), "Still working. First-time capture/indexing for a site can take 20-80s. Waiting is usually better than falling back.");
   const resultError = result.result?.error ?? result.error;
@@ -18595,14 +18187,18 @@ async function cmdResolve(flags) {
     }
   }
   if (explicitEndpointId && result.available_endpoints) {
-    const skillId = result.skill?.skill_id ?? result.skill_id;
+    const skillId = resolveSkillId();
     if (skillId) {
-      const execBody = {
-        params: { endpoint_id: explicitEndpointId, ...flags.params ? JSON.parse(flags.params) : {} },
-        intent,
-        projection: { raw: true }
-      };
-      result = await withPendingNotice(api3("POST", `/v1/skills/${skillId}/execute`, execBody), "Executing selected endpoint...");
+      result = await withPendingNotice(api3("POST", `/v1/skills/${skillId}/execute`, execBody(explicitEndpointId)), "Executing selected endpoint...");
+    }
+  }
+  if (autoExecute && result.available_endpoints && !result.result) {
+    const endpoints = result.available_endpoints;
+    const skillId = resolveSkillId();
+    if (skillId && endpoints.length > 0) {
+      const bestEndpoint = endpoints[0];
+      info(`Auto-executing endpoint: ${bestEndpoint.description ?? bestEndpoint.endpoint_id}`);
+      result = await withPendingNotice(api3("POST", `/v1/skills/${skillId}/execute`, execBody(bestEndpoint.endpoint_id)), "Executing best endpoint...");
     }
   }
   const resultObj = result.result;
@@ -18619,13 +18215,7 @@ async function cmdResolve(flags) {
   if (Date.now() - startedAt > 3000 && result.source === "live-capture") {
     info("Live capture finished. Future runs against this site should be much faster.");
   }
-  if (flags.schema) {
-    output(schemaOnly(result), !!flags.pretty);
-    return;
-  }
-  if (hasTransforms && result.result != null) {
-    result = slimTrace({ ...result, result: applyTransforms(result.result, flags) });
-  }
+  result = slimTrace(result);
   const skill = result.skill;
   const trace = result.trace;
   if (skill?.skill_id && trace) {
@@ -18633,6 +18223,81 @@ async function cmdResolve(flags) {
   }
   output(result, !!flags.pretty);
 }
+function drillPath(data, path9) {
+  const segments = path9.split(/\./).flatMap((s) => {
+    const m = s.match(/^(.+)\[\]$/);
+    return m ? [m[1], "[]"] : [s];
+  });
+  let values = [data];
+  for (const seg of segments) {
+    if (values.length === 0)
+      return [];
+    if (seg === "[]") {
+      values = values.flatMap((v) => Array.isArray(v) ? v : [v]);
+      continue;
+    }
+    values = values.flatMap((v) => {
+      if (v == null)
+        return [];
+      if (Array.isArray(v)) {
+        return v.map((item) => item?.[seg]).filter((x) => x !== undefined);
+      }
+      if (typeof v === "object") {
+        const val = v[seg];
+        return val !== undefined ? [val] : [];
+      }
+      return [];
+    });
+  }
+  return values;
+}
+function resolveDotPath(obj, path9) {
+  let cur = obj;
+  for (const key of path9.split(".")) {
+    if (cur == null || typeof cur !== "object")
+      return;
+    cur = cur[key];
+  }
+  return cur;
+}
+function applyExtract(items, extractSpec) {
+  const fields = extractSpec.split(",").map((f) => {
+    const colon = f.indexOf(":");
+    if (colon > 0)
+      return { alias: f.slice(0, colon), path: f.slice(colon + 1) };
+    return { alias: f, path: f };
+  });
+  return items.map((item) => {
+    const row = {};
+    let hasValue = false;
+    for (const { alias, path: path9 } of fields) {
+      const val = resolveDotPath(item, path9);
+      row[alias] = val ?? null;
+      if (val != null)
+        hasValue = true;
+    }
+    return hasValue ? row : null;
+  }).filter((row) => row !== null);
+}
+function schemaOf(value, depth = 4) {
+  if (value == null)
+    return "null";
+  if (Array.isArray(value)) {
+    if (value.length === 0)
+      return ["unknown"];
+    return [schemaOf(value[0], depth - 1)];
+  }
+  if (typeof value === "object") {
+    if (depth <= 0)
+      return "object";
+    const out = {};
+    for (const [k, v] of Object.entries(value)) {
+      out[k] = schemaOf(v, depth - 1);
+    }
+    return out;
+  }
+  return typeof value;
+}
 async function cmdExecute(flags) {
   const skillId = flags.skill;
   if (!skillId)
@@ -18654,15 +18319,41 @@ async function cmdExecute(flags) {
     body.dry_run = true;
   if (flags["confirm-unsafe"])
     body.confirm_unsafe = true;
-  const hasTransforms = !!(flags.path || flags.extract);
   body.projection = { raw: true };
   let result = await withPendingNotice(api3("POST", `/v1/skills/${skillId}/execute`, body), "Still working. This endpoint may require browser replay or first-time auth/capture setup.");
-  if (flags.schema) {
-    output(schemaOnly(result), !!flags.pretty);
+  result = slimTrace(result);
+  const pathFlag = flags.path;
+  const extractFlag = flags.extract;
+  const limitFlag = flags.limit ? Number(flags.limit) : undefined;
+  const schemaFlag = !!flags.schema;
+  const rawFlag = !!flags.raw;
+  if (schemaFlag && !rawFlag) {
+    const data = result.result;
+    output({ trace: result.trace, schema: schemaOf(data) }, !!flags.pretty);
     return;
   }
-  if (hasTransforms && result.result != null) {
-    result = slimTrace({ ...result, result: applyTransforms(result.result, flags) });
+  if (!rawFlag && (pathFlag || extractFlag || limitFlag)) {
+    let data = pathFlag ? drillPath(result.result, pathFlag) : result.result;
+    const items = Array.isArray(data) ? data : data != null ? [data] : [];
+    const extracted = extractFlag ? applyExtract(items, extractFlag) : items;
+    const limited = limitFlag ? extracted.slice(0, limitFlag) : extracted;
+    output({ trace: result.trace, data: limited, count: limited.length }, !!flags.pretty);
+    return;
+  }
+  if (!rawFlag && !pathFlag && !extractFlag && !schemaFlag) {
+    const raw = JSON.stringify(result.result);
+    if (raw && raw.length > 2048) {
+      const schema = schemaOf(result.result);
+      output({
+        trace: result.trace,
+        extraction_hints: {
+          message: "Response is large. Use --path/--extract/--limit to filter, or --schema to see structure, or --raw for full response.",
+          schema_tree: schema,
+          response_bytes: raw.length
+        }
+      }, !!flags.pretty);
+      return;
+    }
   }
   output(result, !!flags.pretty);
 }
@@ -18683,6 +18374,18 @@ async function cmdFeedback(flags) {
     body.diagnostics = JSON.parse(flags.diagnostics);
   output(await api3("POST", "/v1/feedback", body), !!flags.pretty);
 }
+async function cmdReview(flags) {
+  const skillId = flags.skill;
+  if (!skillId)
+    die("--skill is required");
+  const endpointsJson = flags.endpoints;
+  if (!endpointsJson)
+    die("--endpoints is required (JSON array of {endpoint_id, description?, action_kind?, resource_kind?})");
+  const endpoints = JSON.parse(endpointsJson);
+  if (!Array.isArray(endpoints) || endpoints.length === 0)
+    die("--endpoints must be a non-empty JSON array");
+  output(await api3("POST", `/v1/skills/${skillId}/review`, { endpoints }), !!flags.pretty);
+}
 async function cmdLogin(flags) {
   const url = flags.url;
   if (!url)
@@ -18761,6 +18464,7 @@ var CLI_REFERENCE = {
     { name: "resolve", usage: '--intent "..." --url "..." [opts]', desc: "Resolve intent \u2192 search/capture/execute" },
     { 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: "review", usage: "--skill ID --endpoints '[...]'", desc: "Push reviewed descriptions/metadata back to skill" },
     { name: "login", usage: '--url "..."', desc: "Interactive browser login" },
     { name: "skills", usage: "", desc: "List all skills" },
     { name: "skill", usage: "<id>", desc: "Get skill details" },
@@ -18802,11 +18506,13 @@ var CLI_REFERENCE = {
   ],
   examples: [
     "unbrowse setup",
+    'unbrowse resolve --intent "top stories" --url "https://news.ycombinator.com" --execute',
     'unbrowse resolve --intent "get timeline" --url "https://x.com"',
     "unbrowse execute --skill abc --endpoint def --pretty",
-    'unbrowse execute --skill abc --endpoint def --extract "user,text,likes" --limit 10',
-    'unbrowse execute --skill abc --endpoint def --path "data.included[]" --extract "name:actor.name,text:commentary.text" --limit 20',
-    "unbrowse feedback --skill abc --endpoint def --rating 5"
+    "unbrowse execute --skill abc --endpoint def --schema --pretty",
+    'unbrowse execute --skill abc --endpoint def --path "data.items[]" --extract "name,url" --limit 10 --pretty',
+    "unbrowse feedback --skill abc --endpoint def --rating 5",
+    `unbrowse review --skill abc --endpoints '[{"endpoint_id":"def","description":"..."}]'`
   ]
 };
 function printHelp() {
@@ -18860,9 +18566,9 @@ function cmdStop(flags) {
 }
 async function cmdUpgrade(flags) {
   info("Checking for updates...");
-  const { execSync: execSync4 } = await import("child_process");
+  const { execSync: execSync3 } = await import("child_process");
   try {
-    const result = execSync4("npm view unbrowse version", { encoding: "utf-8", timeout: 1e4 }).trim();
+    const result = execSync3("npm view unbrowse version", { encoding: "utf-8", timeout: 1e4 }).trim();
     const versionInfo = checkServerVersion(BASE_URL, import.meta.url);
     const installed = versionInfo?.installed ?? "unknown";
     if (result === installed) {
@@ -18926,9 +18632,7 @@ async function cmdSiteTask(pack, taskName, flags) {
     body.dry_run = true;
   if (flags["force-capture"])
     body.force_capture = true;
-  const hasTransforms = !!(flags.path || flags.extract);
-  if (flags.raw || hasTransforms)
-    body.projection = { raw: true };
+  body.projection = { raw: true };
   const startedAt = Date.now();
   let result = await withPendingNotice(api3("POST", "/v1/intent/resolve", body), "Still working. First-time capture/indexing for a site can take 20-80s.");
   if (result && typeof result === "object" && result.error === "auth_required") {
@@ -18937,15 +18641,7 @@ async function cmdSiteTask(pack, taskName, flags) {
     output({ ...result, _deps: { ...deps2, requires: ["login"] }, _next: [`unbrowse ${pack.site} login`] }, !!flags.pretty);
     process.exit(2);
   }
-  if (flags.schema) {
-    output(schemaOnly(result), !!flags.pretty);
-    return;
-  }
-  if (hasTransforms && result.result != null) {
-    result = slimTrace({ ...result, result: applyTransforms(result.result, flags) });
-  } else if (!flags.raw && result.result != null) {
-    result = autoExtractOrWrap(result);
-  }
+  result = slimTrace(result);
   const deps = buildDepsMetadata(pack, taskName);
   result._deps = deps;
   result._shortcut = `${pack.site} ${taskName}`;
@@ -18977,14 +18673,9 @@ async function cmdSiteBatch(pack, batchArg, flags) {
       };
       if (flags["force-capture"])
         body.force_capture = true;
-      const hasTransforms = !!(flags.path || flags.extract);
-      if (flags.raw || hasTransforms)
-        body.projection = { raw: true };
-      let res = await api3("POST", "/v1/intent/resolve", body);
-      if (!flags.raw && res.result != null) {
-        res = autoExtractOrWrap(res);
-      }
-      return { task, result: res };
+      body.projection = { raw: true };
+      const res = await api3("POST", "/v1/intent/resolve", body);
+      return { task, result: slimTrace(res) };
     });
     const waveResult = await Promise.all(promises);
     waveResults.push({
@@ -19085,6 +18776,54 @@ async function cmdForward() {
 async function cmdClose() {
   output(await api3("POST", "/v1/browse/close"), false);
 }
+async function cmdConnectChrome() {
+  const { execSync: execSync3, spawn: spawnProc } = __require("child_process");
+  try {
+    const res = await fetch("http://127.0.0.1:9222/json/version", { signal: AbortSignal.timeout(1000) });
+    if (res.ok) {
+      const data = await res.json();
+      if (!data["User-Agent"]?.includes("Headless")) {
+        console.log("Your Chrome is already connected with CDP on port 9222.");
+        console.log("Browse commands will use your real browser with all your sessions.");
+        return;
+      }
+    }
+  } catch {}
+  try {
+    execSync3("pkill -f kuri/chrome-profile", { stdio: "ignore" });
+  } catch {}
+  console.log("Quitting Chrome to relaunch with remote debugging...");
+  if (process.platform === "darwin") {
+    try {
+      execSync3('osascript -e "quit app \\"Google Chrome\\""', { stdio: "ignore", timeout: 5000 });
+    } catch {}
+  } else {
+    try {
+      execSync3("pkill -f chrome", { stdio: "ignore" });
+    } catch {}
+  }
+  await new Promise((r) => setTimeout(r, 2000));
+  console.log("Launching Chrome with remote debugging on port 9222...");
+  if (process.platform === "darwin") {
+    spawnProc("/Applications/Google Chrome.app/Contents/MacOS/Google Chrome", ["--remote-debugging-port=9222", "--no-first-run", "--no-default-browser-check"], { stdio: "ignore", detached: true }).unref();
+  } else {
+    spawnProc("google-chrome", ["--remote-debugging-port=9222"], { stdio: "ignore", detached: true }).unref();
+  }
+  const deadline = Date.now() + 15000;
+  while (Date.now() < deadline) {
+    try {
+      const res = await fetch("http://127.0.0.1:9222/json/version", { signal: AbortSignal.timeout(500) });
+      if (res.ok) {
+        console.log("Connected. Your real Chrome is now available for browse commands.");
+        console.log("All your logged-in sessions (LinkedIn, X, etc.) will work.");
+        console.log('Run: unbrowse go "https://linkedin.com/feed/"');
+        return;
+      }
+    } catch {}
+    await new Promise((r) => setTimeout(r, 500));
+  }
+  console.error("Could not connect to Chrome. Make sure all Chrome windows are closed and try again.");
+}
 async function main() {
   const { command, args, flags } = parseArgs(process.argv);
   const noAutoStart = !!flags["no-auto-start"];
@@ -19106,6 +18845,8 @@ async function main() {
     return cmdRestart(flags);
   if (command === "upgrade" || command === "update")
     return cmdUpgrade(flags);
+  if (command === "connect-chrome")
+    return cmdConnectChrome();
   const KNOWN_COMMANDS = new Set([
     "health",
     "setup",
@@ -19114,6 +18855,7 @@ async function main() {
     "exec",
     "feedback",
     "fb",
+    "review",
     "login",
     "skills",
     "skill",
@@ -19139,7 +18881,8 @@ async function main() {
     "eval",
     "back",
     "forward",
-    "close"
+    "close",
+    "connect-chrome"
   ]);
   if (!KNOWN_COMMANDS.has(command)) {
     const pack = findSitePack(command);
@@ -19173,6 +18916,8 @@ async function main() {
     case "feedback":
     case "fb":
       return cmdFeedback(flags);
+    case "review":
+      return cmdReview(flags);
     case "login":
       return cmdLogin(flags);
     case "skills":
@@ -19215,6 +18960,8 @@ async function main() {
       return cmdForward();
     case "close":
       return cmdClose();
+    case "connect-chrome":
+      return cmdConnectChrome();
     default:
       info(`Unknown command: ${command}`);
       printHelp();