unbrowse 9.6.0 → 9.6.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "unbrowse",
-  "version": "9.6.0",
+  "version": "9.6.2",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/unbrowse-ai/unbrowse.git"

package/runtime/cli.js

@@ -1730,6 +1730,133 @@ var init_cached_resolution = __esm(() => {
   init_principal_scope();
 });
 
+// .tmp-runtime-src/values/cardinality.ts
+function isListLikeIntent(intent) {
+  return LIST_INTENT_RE.test(intent ?? "");
+}
+function valueLooksLikeSingleItem(value) {
+  if (value == null || Array.isArray(value) || typeof value !== "object")
+    return false;
+  const obj = value;
+  for (const key of COLLECTION_KEYS) {
+    if (Array.isArray(obj[key]))
+      return false;
+  }
+  for (const v of Object.values(obj)) {
+    if (Array.isArray(v) && v.some((x) => x !== null && typeof x === "object"))
+      return false;
+  }
+  const atType = typeof obj["@type"] === "string" ? obj["@type"].toLowerCase() : "";
+  const isItemType = ITEM_SCHEMA_TYPES.has(atType);
+  const hasName = "name" in obj || "title" in obj || "headline" in obj;
+  const hasPriceish = "offers" in obj || "price" in obj || "sku" in obj;
+  return isItemType || hasName && hasPriceish;
+}
+function schemaLooksLikeSingleItem(rs) {
+  if (!rs || typeof rs !== "object")
+    return false;
+  const schema = rs;
+  if (schema.type === "array")
+    return false;
+  const props = schema.properties ?? {};
+  for (const key of COLLECTION_KEYS) {
+    if (key in props)
+      return false;
+  }
+  for (const value of Object.values(props)) {
+    if (value && typeof value === "object" && value.type === "array" && value.items?.type === "object") {
+      return false;
+    }
+  }
+  if (schema.type !== "object")
+    return false;
+  const hasType = "@type" in props;
+  const hasName = "name" in props || "title" in props;
+  const hasPriceish = "offers" in props || "price" in props || "sku" in props;
+  return hasType || hasName && hasPriceish;
+}
+function routeLooksLikeSingleItem(route) {
+  const tmpl = route.url_template ?? "";
+  let pathAndQuery = tmpl;
+  try {
+    const u = new URL(tmpl);
+    pathAndQuery = `${u.pathname}${u.search}`;
+  } catch {}
+  const lower = pathAndQuery.toLowerCase();
+  if (/\/(?:search|q|categories?|browse|results?|listings|explore|discover|feed|catalog(?:ue)?|collections?|shop|all)\b/.test(lower) || /[?&](?:q|query|keyword|keywords|search|term|category|cat|page)=/.test(lower)) {
+    return false;
+  }
+  if (/\/(?:p|product|products|item|items|listing|detail|details|dp|pd|sku)\/[^/]+/.test(lower))
+    return true;
+  const lastSeg = lower.split("?")[0].replace(/\/+$/, "").split("/").pop() ?? "";
+  if (/-\d{3,}$/.test(lastSeg) || /^\d{3,}$/.test(lastSeg))
+    return true;
+  if (/\{[^}]+\}/.test(lower))
+    return false;
+  return schemaLooksLikeSingleItem(route.response_schema);
+}
+function urlPathLooksListLike(contextUrl) {
+  if (!contextUrl)
+    return false;
+  try {
+    const pathname = new URL(contextUrl).pathname.toLowerCase();
+    return /\/(?:search|basic-search|result-page|results?|discover|browse|categories?|q|listings|feed|catalog(?:ue)?)\b/.test(pathname);
+  } catch {
+    return false;
+  }
+}
+function cardinalityMatches(intent, subject, opts) {
+  const wantsMany = isListLikeIntent(intent) || urlPathLooksListLike(opts?.contextUrl);
+  if (!wantsMany)
+    return true;
+  switch (subject.kind) {
+    case "value":
+      return !valueLooksLikeSingleItem(subject.value);
+    case "schema":
+      return !schemaLooksLikeSingleItem(subject.schema);
+    case "route":
+      return !routeLooksLikeSingleItem(subject.route);
+  }
+}
+function resolutionCardinalityMatches(intent, data) {
+  return cardinalityMatches(intent, { kind: "value", value: data });
+}
+var LIST_INTENT_RE, ITEM_SCHEMA_TYPES, COLLECTION_KEYS;
+var init_cardinality = __esm(() => {
+  LIST_INTENT_RE = /\b(search|find|lookup|browse|discover|list(?:ings?)?|feed|catalog(?:ue)?)\b/i;
+  ITEM_SCHEMA_TYPES = new Set([
+    "product",
+    "offer",
+    "article",
+    "newsarticle",
+    "blogposting",
+    "recipe",
+    "event",
+    "place",
+    "localbusiness",
+    "jobposting",
+    "book",
+    "movie",
+    "creativework",
+    "person",
+    "organization"
+  ]);
+  COLLECTION_KEYS = [
+    "itemListElement",
+    "items",
+    "results",
+    "products",
+    "listings",
+    "data",
+    "edges",
+    "hits",
+    "records",
+    "entries",
+    "rows",
+    "nodes"
+  ];
+});
+
 // .tmp-runtime-src/values/cache-key.ts
 function requestCacheKey(parts) {
   const method = (parts.method ?? "GET").toUpperCase();
@@ -2223,7 +2350,7 @@ var init_telemetry = __esm(() => {
 });
 
 // .tmp-runtime-src/build-info.generated.ts
-var BUILD_RELEASE_VERSION = "9.6.0", BUILD_GIT_SHA = "5b6b9dc9e8e1", BUILD_CODE_HASH = "5d9ebf619c61", BUILD_RELEASE_MANIFEST_BASE64 = "eyJzY2hlbWFfdmVyc2lvbiI6MSwicmVsZWFzZV92ZXJzaW9uIjoiOS42LjAiLCJnaXRfc2hhIjoiNWI2YjlkYzllOGUxIiwiY29kZV9oYXNoIjoiNWQ5ZWJmNjE5YzYxIiwidHJhY2VfdmVyc2lvbiI6IjVkOWViZjYxOWM2MUA1YjZiOWRjOWU4ZTEiLCJpc3N1ZWRfYXQiOiIyMDI2LTA2LTE3VDIyOjAyOjQ0LjA3MVoifQ", BUILD_RELEASE_MANIFEST_SIGNATURE = "MqIyb1B_GA8W5Nv_Jictwt1jVCCTgxxdIjUFJqLoeAU", BUILD_DEFAULT_BACKEND_URL = "https://beta-api.unbrowse.ai", BUILD_DEFAULT_PROFILE = "";
+var BUILD_RELEASE_VERSION = "9.6.2", BUILD_GIT_SHA = "d2d14a6629a0", BUILD_CODE_HASH = "5d9ebf619c61", BUILD_RELEASE_MANIFEST_BASE64 = "eyJzY2hlbWFfdmVyc2lvbiI6MSwicmVsZWFzZV92ZXJzaW9uIjoiOS42LjIiLCJnaXRfc2hhIjoiZDJkMTRhNjYyOWEwIiwiY29kZV9oYXNoIjoiNWQ5ZWJmNjE5YzYxIiwidHJhY2VfdmVyc2lvbiI6IjVkOWViZjYxOWM2MUBkMmQxNGE2NjI5YTAiLCJpc3N1ZWRfYXQiOiIyMDI2LTA2LTE4VDA0OjE3OjAzLjg1M1oifQ", BUILD_RELEASE_MANIFEST_SIGNATURE = "OefvyW2iLVVPQ-0HMg9Mz-bciCmP8LE5u7fVEss_98E", BUILD_DEFAULT_BACKEND_URL = "https://beta-api.unbrowse.ai", BUILD_DEFAULT_PROFILE = "";
 
 // .tmp-runtime-src/version.ts
 import { createHash as createHash7 } from "crypto";
@@ -45920,6 +46047,130 @@ var init_header_classify = __esm(() => {
   SENSITIVE_HEADER_PATTERN = /token|key|secret|credential|password|session/i;
 });
 
+// .tmp-runtime-src/values/cardinality.ts
+function isListLikeIntent2(intent) {
+  return LIST_INTENT_RE2.test(intent ?? "");
+}
+function valueLooksLikeSingleItem2(value) {
+  if (value == null || Array.isArray(value) || typeof value !== "object")
+    return false;
+  const obj = value;
+  for (const key of COLLECTION_KEYS2) {
+    if (Array.isArray(obj[key]))
+      return false;
+  }
+  for (const v of Object.values(obj)) {
+    if (Array.isArray(v) && v.some((x) => x !== null && typeof x === "object"))
+      return false;
+  }
+  const atType = typeof obj["@type"] === "string" ? obj["@type"].toLowerCase() : "";
+  const isItemType = ITEM_SCHEMA_TYPES2.has(atType);
+  const hasName = "name" in obj || "title" in obj || "headline" in obj;
+  const hasPriceish = "offers" in obj || "price" in obj || "sku" in obj;
+  return isItemType || hasName && hasPriceish;
+}
+function schemaLooksLikeSingleItem2(rs) {
+  if (!rs || typeof rs !== "object")
+    return false;
+  const schema = rs;
+  if (schema.type === "array")
+    return false;
+  const props = schema.properties ?? {};
+  for (const key of COLLECTION_KEYS2) {
+    if (key in props)
+      return false;
+  }
+  for (const value of Object.values(props)) {
+    if (value && typeof value === "object" && value.type === "array" && value.items?.type === "object") {
+      return false;
+    }
+  }
+  if (schema.type !== "object")
+    return false;
+  const hasType = "@type" in props;
+  const hasName = "name" in props || "title" in props;
+  const hasPriceish = "offers" in props || "price" in props || "sku" in props;
+  return hasType || hasName && hasPriceish;
+}
+function routeLooksLikeSingleItem2(route) {
+  const tmpl = route.url_template ?? "";
+  let pathAndQuery = tmpl;
+  try {
+    const u = new URL(tmpl);
+    pathAndQuery = `${u.pathname}${u.search}`;
+  } catch {}
+  const lower = pathAndQuery.toLowerCase();
+  if (/\/(?:search|q|categories?|browse|results?|listings|explore|discover|feed|catalog(?:ue)?|collections?|shop|all)\b/.test(lower) || /[?&](?:q|query|keyword|keywords|search|term|category|cat|page)=/.test(lower)) {
+    return false;
+  }
+  if (/\/(?:p|product|products|item|items|listing|detail|details|dp|pd|sku)\/[^/]+/.test(lower))
+    return true;
+  const lastSeg = lower.split("?")[0].replace(/\/+$/, "").split("/").pop() ?? "";
+  if (/-\d{3,}$/.test(lastSeg) || /^\d{3,}$/.test(lastSeg))
+    return true;
+  if (/\{[^}]+\}/.test(lower))
+    return false;
+  return schemaLooksLikeSingleItem2(route.response_schema);
+}
+function urlPathLooksListLike2(contextUrl) {
+  if (!contextUrl)
+    return false;
+  try {
+    const pathname = new URL(contextUrl).pathname.toLowerCase();
+    return /\/(?:search|basic-search|result-page|results?|discover|browse|categories?|q|listings|feed|catalog(?:ue)?)\b/.test(pathname);
+  } catch {
+    return false;
+  }
+}
+function cardinalityMatches2(intent, subject, opts) {
+  const wantsMany = isListLikeIntent2(intent) || urlPathLooksListLike2(opts?.contextUrl);
+  if (!wantsMany)
+    return true;
+  switch (subject.kind) {
+    case "value":
+      return !valueLooksLikeSingleItem2(subject.value);
+    case "schema":
+      return !schemaLooksLikeSingleItem2(subject.schema);
+    case "route":
+      return !routeLooksLikeSingleItem2(subject.route);
+  }
+}
+var LIST_INTENT_RE2, ITEM_SCHEMA_TYPES2, COLLECTION_KEYS2;
+var init_cardinality2 = __esm(() => {
+  LIST_INTENT_RE2 = /\b(search|find|lookup|browse|discover|list(?:ings?)?|feed|catalog(?:ue)?)\b/i;
+  ITEM_SCHEMA_TYPES2 = new Set([
+    "product",
+    "offer",
+    "article",
+    "newsarticle",
+    "blogposting",
+    "recipe",
+    "event",
+    "place",
+    "localbusiness",
+    "jobposting",
+    "book",
+    "movie",
+    "creativework",
+    "person",
+    "organization"
+  ]);
+  COLLECTION_KEYS2 = [
+    "itemListElement",
+    "items",
+    "results",
+    "products",
+    "listings",
+    "data",
+    "edges",
+    "hits",
+    "records",
+    "entries",
+    "rows",
+    "nodes"
+  ];
+});
+
 // node_modules/.bun/nanoid@5.1.11/node_modules/nanoid/url-alphabet/index.js
 var urlAlphabet = "useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict";
 
@@ -117228,7 +117479,7 @@ __export(exports_extraction, {
   cleanDOM: () => cleanDOM,
   buildStructuredDataHeader: () => buildStructuredDataHeader
 });
-function extractHtmlMetadataFallback(html3) {
+function extractHtmlMetadataFallback(html3, intent) {
   if (!html3 || html3.length < 100)
     return null;
   try {
@@ -117260,8 +117511,9 @@ function extractHtmlMetadataFallback(html3) {
           jsonLdBlocks.push(parsed);
       } catch {}
     });
-    if (jsonLdBlocks.length > 0)
-      out.json_ld = jsonLdBlocks;
+    const usableJsonLd = isListLikeIntent2(intent) ? jsonLdBlocks.filter((b) => !valueLooksLikeSingleItem2(b)) : jsonLdBlocks;
+    if (usableJsonLd.length > 0)
+      out.json_ld = usableJsonLd;
     const headings = [];
     $2("h1, h2").each((_, el) => {
       const text3 = cleanText($2(el).text());
@@ -119584,6 +119836,16 @@ function scoreSiteMetaJsonLdDemotion(structure, intent) {
     return 0;
   return -200;
 }
+function isSingleItemStructureForList(structure, intent) {
+  if (!TINY_RESULT_LIST_INTENT.test(intent.toLowerCase()))
+    return false;
+  if (structure.type === "repeated-elements")
+    return false;
+  return valueLooksLikeSingleItem2(structure.data);
+}
+function scoreSingleItemListMismatch(structure, intent) {
+  return isSingleItemStructureForList(structure, intent) ? -200 : 0;
+}
 function looksLikeTinyContentReadResult(data2, intent) {
   if (data2 == null)
     return { tiny: false, bytes: 0, stringLeafChars: 0 };
@@ -119737,9 +119999,9 @@ function extractFromDOM(html3, intent, contextUrl) {
   const articleStructures = extractArticleBodySpecial(html3.length > 600000 ? html3.slice(0, 600000) : html3, intent);
   const allStructures = [...flashStructures, ...githubStructures, ...repeatedPersonStructures, ...packageSearchStructures, ...xProfileStructures, ...postStructures, ...repeatedArticleStructures, ...trendStructures, ...definitionStructures, ...packageDetailStructures, ...arxivAbstractStructures, ...courseStructures, ...articleStructures, ...spaStructures, ...parseStructured(cleaned)].map((structure) => normalizeStructureForIntent(structure, intent));
   const isListIntent = TINY_RESULT_LIST_INTENT.test(intent.toLowerCase());
-  const structures = allStructures.filter((s) => !(s.type === "repeated-elements" && looksLikeDegenerateRowArray(s.data)) && !looksLikeConfigShape(s.data) && !looksLikeEmptyContainer(s.data) && !(isListIntent && looksLikeSiteMetaJsonLd(s.data)));
+  const structures = allStructures.filter((s) => !(s.type === "repeated-elements" && looksLikeDegenerateRowArray(s.data)) && !looksLikeConfigShape(s.data) && !looksLikeEmptyContainer(s.data) && !(isListIntent && looksLikeSiteMetaJsonLd(s.data)) && !isSingleItemStructureForList(s, intent));
   if (structures.length === 0) {
-    const fallback2 = extractHtmlMetadataFallback(html3);
+    const fallback2 = extractHtmlMetadataFallback(html3, intent);
     if (fallback2) {
       return _finalize({ data: fallback2, extraction_method: "html_metadata_fallback", confidence: 0.4 });
     }
@@ -119748,7 +120010,7 @@ function extractFromDOM(html3, intent, contextUrl) {
   const intentWords = intent.toLowerCase().split(/\s+/).filter(Boolean);
   const scored = structures.map((s) => ({
     structure: s,
-    score: scoreRelevance(s, intentWords) + scoreSemanticFit(s, intent) + scoreSparseLinkList(s) + scoreFieldRichness(s) + scoreConfigShapeDemotion(s) + scoreDegenerateRowDemotion(s) + scoreDuplicateRowDemotion(s) + scoreEmptyContainerDemotion(s) + scoreSiteMetaJsonLdDemotion(s, intent) + scoreTableIntentOverlapDemotion(s, intent, contextUrl, structures)
+    score: scoreRelevance(s, intentWords) + scoreSemanticFit(s, intent) + scoreSparseLinkList(s) + scoreFieldRichness(s) + scoreConfigShapeDemotion(s) + scoreDegenerateRowDemotion(s) + scoreDuplicateRowDemotion(s) + scoreEmptyContainerDemotion(s) + scoreSiteMetaJsonLdDemotion(s, intent) + scoreSingleItemListMismatch(s, intent) + scoreTableIntentOverlapDemotion(s, intent, contextUrl, structures)
   }));
   scored.sort((a, b) => b.score - a.score);
   const passing = scored.filter((candidate) => assessIntentResult(candidate.structure.data, intent).verdict === "pass");
@@ -120364,6 +120626,7 @@ function sanitizeExtractionToJson(data2, depth = 0) {
 var STRIP_TAGS, CHROME_TAGS, AD_PATTERNS, HIDDEN_ATTRS, CONTENT_SELECTORS, CARD_SELECTORS, CONFIG_TOP_LEVEL_KEYS, CONFIG_CHUNK_VALUE_KEYS, INTENT_OVERLAP_STOPWORDS, SITE_META_LD_TYPES, TINY_RESULT_LIST_INTENT, TINY_RESULT_DETAIL_INTENT, STRUCTURED_DATA_HIGHLIGHT_TYPES, HTML_TAG_RE, TABLE_RE;
 var init_extraction = __esm(() => {
   init_esm11();
+  init_cardinality2();
   STRIP_TAGS = new Set(["script", "style", "noscript", "svg", "iframe"]);
   CHROME_TAGS = new Set(["nav", "footer", "header"]);
   AD_PATTERNS = /\b(ad|ads|advert|advertisement|tracking|tracker|cookie-banner|cookie-consent|cookie-notice|popup|modal-overlay|gdpr|consent|banner-promo)\b/i;
@@ -129889,7 +130152,8 @@ function selectBestEndpoint(endpoints, intent, skillDomain, contextUrl) {
   const ranked = rankEndpoints(endpoints, intent, skillDomain, contextUrl);
   if (ranked.length === 0)
     throw new Error("All endpoints are disabled");
-  return ranked[0].endpoint;
+  const preferred = ranked.find((r) => cardinalityMatches2(intent, { kind: "route", route: r.endpoint }, { contextUrl }));
+  return (preferred ?? ranked[0]).endpoint;
 }
 function isHtml2(text3) {
   const trimmed = text3.trimStart().slice(0, 200).toLowerCase();
@@ -129936,6 +130200,7 @@ var init_execution = __esm(async () => {
   init_reveng_server_first();
   init_header_classify();
   init_storage_hole_bindings();
+  init_cardinality2();
   init_sealed_blob_store();
   init_signer();
   init_bundle_scanner();
@@ -132155,7 +132420,10 @@ function pickWalkTarget(requestedUrl, ranked, minScore = 0.8) {
       return false;
     }
   };
-  return eligible.find((c) => hasPath(c.url)) ?? eligible[0];
+  const reqReg = registrableHost(requestedUrl);
+  const sameDomain = reqReg ? eligible.filter((c) => registrableHost(c.url) === reqReg) : [];
+  const pool2 = sameDomain.length > 0 ? sameDomain : eligible;
+  return pool2.find((c) => hasPath(c.url)) ?? pool2[0];
 }
 function artifactResultWithShortlist(artifact, skillId, triggerUrl) {
   const ep = artifact.endpoint;
@@ -132625,6 +132893,9 @@ function isResolveUsableEndpointForIntent(endpoint, intent, contextUrl) {
   if (isFeedTimelineIntent(intent, contextUrl) && endpointHasNegativeTag(endpoint, "helper")) {
     return false;
   }
+  if (!cardinalityMatches2(intent, { kind: "route", route: endpoint }, { contextUrl })) {
+    return false;
+  }
   return true;
 }
 function normalizeRouteContext(url) {
@@ -132767,7 +133038,7 @@ function withContextReplayEndpoint(skill, _intent, _contextUrl) {
   return skill;
 }
 function isSearchLikeIntent(intent, contextUrl) {
-  if (/\b(search|find|lookup|browse|discover)\b/i.test(intent ?? ""))
+  if (isListLikeIntent2(intent))
     return true;
   try {
     const pathname = contextUrl ? new URL(contextUrl).pathname.toLowerCase() : "";
@@ -133639,7 +133910,20 @@ function inferPreferredEntityTokens(intent) {
   return [];
 }
 function isAcceptableIntentResult(result, intent) {
-  return assessIntentResult(result, intent).verdict !== "fail";
+  if (assessIntentResult(result, intent).verdict === "fail")
+    return false;
+  if (!cardinalityMatches2(intent, { kind: "value", value: unwrapResultPayload(result) }))
+    return false;
+  return true;
+}
+function unwrapResultPayload(result) {
+  if (result == null || typeof result !== "object" || Array.isArray(result))
+    return result;
+  const rec = { ...result };
+  for (const k of ["available_endpoints", "available_operations", "shortlist_for_judgment", "workflow_dag", "walked_from", "exa_candidates", "run_plan"]) {
+    delete rec[k];
+  }
+  return rec;
 }
 function candidateMatchesPreferredEntity(candidate, preferredTokens) {
   if (preferredTokens.length === 0)
@@ -137481,6 +137765,8 @@ var init_orchestrator = __esm(async () => {
   init_search_forms();
   init_ddg_search();
   init_cached_resolution2();
+  init_cardinality2();
+  init_cardinality2();
   init_principal_scope();
   init_yield_safety();
   init_trace_store();
@@ -143978,9 +144264,14 @@ async function registerRoutes(app) {
             recovered = true;
           } else if (errResult.available_endpoints?.length === 1) {
             const only = errResult.available_endpoints[0].endpoint_id;
-            console.log(`[exec] D7 single-endpoint skill: rewriting endpoint_id ${want} → ${only}`);
-            execParams.endpoint_id = only;
-            recovered = true;
+            const onlyEp = (skill.endpoints ?? []).find((e) => e.endpoint_id === only);
+            if (!onlyEp || cardinalityMatches2(intent, { kind: "route", route: onlyEp }, { contextUrl: context_url })) {
+              console.log(`[exec] D7 single-endpoint skill: rewriting endpoint_id ${want} → ${only}`);
+              execParams.endpoint_id = only;
+              recovered = true;
+            } else {
+              console.log(`[exec] D7 single-endpoint skill: only endpoint ${only} is a single-item route for a list intent — not forcing (cardinality gate)`);
+            }
           }
         }
         if (!recovered && (skill.endpoints?.length ?? 0) >= 2 && intent) {
@@ -145208,6 +145499,7 @@ var init_routes = __esm(async () => {
   init_client3();
   init_reveng_server_first();
   init_header_classify();
+  init_cardinality2();
   init_capture_spool();
   init_nanoid();
   init_marketplace();
@@ -150601,7 +150893,7 @@ __export(exports_extraction2, {
   cleanDOM: () => cleanDOM2,
   buildStructuredDataHeader: () => buildStructuredDataHeader2
 });
-function extractHtmlMetadataFallback2(html3) {
+function extractHtmlMetadataFallback2(html3, intent) {
   if (!html3 || html3.length < 100)
     return null;
   try {
@@ -150633,8 +150925,9 @@ function extractHtmlMetadataFallback2(html3) {
           jsonLdBlocks.push(parsed);
       } catch {}
     });
-    if (jsonLdBlocks.length > 0)
-      out.json_ld = jsonLdBlocks;
+    const usableJsonLd = isListLikeIntent2(intent) ? jsonLdBlocks.filter((b) => !valueLooksLikeSingleItem2(b)) : jsonLdBlocks;
+    if (usableJsonLd.length > 0)
+      out.json_ld = usableJsonLd;
     const headings = [];
     $2("h1, h2").each((_, el) => {
       const text3 = cleanText2($2(el).text());
@@ -152957,6 +153250,16 @@ function scoreSiteMetaJsonLdDemotion2(structure, intent) {
     return 0;
   return -200;
 }
+function isSingleItemStructureForList2(structure, intent) {
+  if (!TINY_RESULT_LIST_INTENT2.test(intent.toLowerCase()))
+    return false;
+  if (structure.type === "repeated-elements")
+    return false;
+  return valueLooksLikeSingleItem2(structure.data);
+}
+function scoreSingleItemListMismatch2(structure, intent) {
+  return isSingleItemStructureForList2(structure, intent) ? -200 : 0;
+}
 function looksLikeTinyContentReadResult2(data2, intent) {
   if (data2 == null)
     return { tiny: false, bytes: 0, stringLeafChars: 0 };
@@ -153110,9 +153413,9 @@ function extractFromDOM2(html3, intent, contextUrl) {
   const articleStructures = extractArticleBodySpecial2(html3.length > 600000 ? html3.slice(0, 600000) : html3, intent);
   const allStructures = [...flashStructures, ...githubStructures, ...repeatedPersonStructures, ...packageSearchStructures, ...xProfileStructures, ...postStructures, ...repeatedArticleStructures, ...trendStructures, ...definitionStructures, ...packageDetailStructures, ...arxivAbstractStructures, ...courseStructures, ...articleStructures, ...spaStructures, ...parseStructured2(cleaned)].map((structure) => normalizeStructureForIntent2(structure, intent));
   const isListIntent = TINY_RESULT_LIST_INTENT2.test(intent.toLowerCase());
-  const structures = allStructures.filter((s) => !(s.type === "repeated-elements" && looksLikeDegenerateRowArray2(s.data)) && !looksLikeConfigShape2(s.data) && !looksLikeEmptyContainer2(s.data) && !(isListIntent && looksLikeSiteMetaJsonLd2(s.data)));
+  const structures = allStructures.filter((s) => !(s.type === "repeated-elements" && looksLikeDegenerateRowArray2(s.data)) && !looksLikeConfigShape2(s.data) && !looksLikeEmptyContainer2(s.data) && !(isListIntent && looksLikeSiteMetaJsonLd2(s.data)) && !isSingleItemStructureForList2(s, intent));
   if (structures.length === 0) {
-    const fallback2 = extractHtmlMetadataFallback2(html3);
+    const fallback2 = extractHtmlMetadataFallback2(html3, intent);
     if (fallback2) {
       return _finalize({ data: fallback2, extraction_method: "html_metadata_fallback", confidence: 0.4 });
     }
@@ -153121,7 +153424,7 @@ function extractFromDOM2(html3, intent, contextUrl) {
   const intentWords = intent.toLowerCase().split(/\s+/).filter(Boolean);
   const scored = structures.map((s) => ({
     structure: s,
-    score: scoreRelevance2(s, intentWords) + scoreSemanticFit2(s, intent) + scoreSparseLinkList2(s) + scoreFieldRichness2(s) + scoreConfigShapeDemotion2(s) + scoreDegenerateRowDemotion2(s) + scoreDuplicateRowDemotion2(s) + scoreEmptyContainerDemotion2(s) + scoreSiteMetaJsonLdDemotion2(s, intent) + scoreTableIntentOverlapDemotion2(s, intent, contextUrl, structures)
+    score: scoreRelevance2(s, intentWords) + scoreSemanticFit2(s, intent) + scoreSparseLinkList2(s) + scoreFieldRichness2(s) + scoreConfigShapeDemotion2(s) + scoreDegenerateRowDemotion2(s) + scoreDuplicateRowDemotion2(s) + scoreEmptyContainerDemotion2(s) + scoreSiteMetaJsonLdDemotion2(s, intent) + scoreSingleItemListMismatch2(s, intent) + scoreTableIntentOverlapDemotion2(s, intent, contextUrl, structures)
   }));
   scored.sort((a, b) => b.score - a.score);
   const passing = scored.filter((candidate) => assessIntentResult(candidate.structure.data, intent).verdict === "pass");
@@ -153737,6 +154040,7 @@ function sanitizeExtractionToJson2(data2, depth = 0) {
 var STRIP_TAGS2, CHROME_TAGS2, AD_PATTERNS2, HIDDEN_ATTRS2, CONTENT_SELECTORS2, CARD_SELECTORS2, CONFIG_TOP_LEVEL_KEYS2, CONFIG_CHUNK_VALUE_KEYS2, INTENT_OVERLAP_STOPWORDS2, SITE_META_LD_TYPES2, TINY_RESULT_LIST_INTENT2, TINY_RESULT_DETAIL_INTENT2, STRUCTURED_DATA_HIGHLIGHT_TYPES2, HTML_TAG_RE2, TABLE_RE2;
 var init_extraction2 = __esm(() => {
   init_esm11();
+  init_cardinality2();
   STRIP_TAGS2 = new Set(["script", "style", "noscript", "svg", "iframe"]);
   CHROME_TAGS2 = new Set(["nav", "footer", "header"]);
   AD_PATTERNS2 = /\b(ad|ads|advert|advertisement|tracking|tracker|cookie-banner|cookie-consent|cookie-notice|popup|modal-overlay|gdpr|consent|banner-promo)\b/i;
@@ -239361,7 +239665,7 @@ async function cmdResolve(flags) {
   }
   if (resolveCacheSafe(flags)) {
     const cachedHit = peekResolution(resolveCacheKeyFor(flags, intent), resolveCacheTtlMs());
-    if (cachedHit) {
+    if (cachedHit && resolutionCardinalityMatches(intent, cachedHit.result ?? cachedHit.data)) {
       const replay = markResolveCacheReplay(cachedHit);
       const hostType2 = detectTelemetryHostType2();
       if (process.env.UNBROWSE_LANDING_TOKEN || process.env.UNBROWSE_ATTRIBUTION_B64) {
@@ -239581,7 +239885,7 @@ async function cmdResolve(flags) {
     if (skill?.skill_id && trace) {
       result._feedback = `unbrowse feedback --skill ${skill.skill_id} --endpoint ${trace.endpoint_id || "?"} --rating <1-5>`;
     }
-    if (resolveCacheSafe(flags) && isResolveSuccessResult(result)) {
+    if (resolveCacheSafe(flags) && isResolveSuccessResult(result) && resolutionCardinalityMatches(intent, result.result ?? result.data)) {
       storeResolution(resolveCacheKeyFor(flags, intent), result, resolveCacheTtlMs());
     }
     output(result, !!flags.pretty);
@@ -239881,14 +240185,30 @@ async function cmdRun(args, flags, verb = "run") {
       } else if (explicitEndpointId || !bestEndpoint || endpointIsSafeToAutoExecute(bestEndpoint)) {
         runPlan.push({ step: "execute", mode: "direct_api", status: "started", endpoint_id: endpointToExecute });
         const resolvedSource = typeof result.source === "string" ? result.source : undefined;
-        result = await withPendingNotice(api4("POST", `/v1/skills/${skillId}/execute`, execBody(endpointToExecute)), "Executing best endpoint...");
-        if (resolvedSource && typeof result.source !== "string")
-          result.source = resolvedSource;
-        runPlan[runPlan.length - 1] = {
-          ...runPlan[runPlan.length - 1],
-          status: isResolveSuccessResult(result) ? "complete" : "error",
-          error: resolveResultError(result) ?? null
-        };
+        const deferralResult = result;
+        const executed = await withPendingNotice(api4("POST", `/v1/skills/${skillId}/execute`, execBody(endpointToExecute)), "Executing best endpoint...");
+        if (!explicitEndpointId && isResolveSuccessResult(executed) && !resolutionCardinalityMatches(intent, executed.result ?? executed.data)) {
+          runPlan[runPlan.length - 1] = {
+            ...runPlan[runPlan.length - 1],
+            status: "skipped",
+            reason: "cardinality_mismatch_single_item"
+          };
+          deferralResult.next_action = {
+            title: "List intent returned a single item",
+            command: `unbrowse execute --skill ${skillId} --endpoint ${endpointToExecute}`,
+            why: "Auto-execute yielded a single item for a list/search intent; the page's listings are likely JS-rendered behind an internal API. Returning the route shortlist instead of one item."
+          };
+          result = deferralResult;
+        } else {
+          result = executed;
+          if (resolvedSource && typeof result.source !== "string")
+            result.source = resolvedSource;
+          runPlan[runPlan.length - 1] = {
+            ...runPlan[runPlan.length - 1],
+            status: isResolveSuccessResult(result) ? "complete" : "error",
+            error: resolveResultError(result) ?? null
+          };
+        }
       } else {
         runPlan.push({
           step: "execute",
@@ -241712,6 +242032,7 @@ var init_cli = __esm(async () => {
   init_extract_auth_header();
   init_kuri_proxy_bridge();
   init_cached_resolution();
+  init_cardinality();
   init_issue();
   init_client2();
   init_impact_log();

package/runtime/mcp.js

@@ -36310,7 +36310,7 @@ var init_cached_resolution = __esm(() => {
 });
 
 // .tmp-runtime-src/build-info.generated.ts
-var BUILD_RELEASE_VERSION = "9.6.0", BUILD_GIT_SHA = "5b6b9dc9e8e1", BUILD_CODE_HASH = "5d9ebf619c61", BUILD_RELEASE_MANIFEST_BASE64 = "eyJzY2hlbWFfdmVyc2lvbiI6MSwicmVsZWFzZV92ZXJzaW9uIjoiOS42LjAiLCJnaXRfc2hhIjoiNWI2YjlkYzllOGUxIiwiY29kZV9oYXNoIjoiNWQ5ZWJmNjE5YzYxIiwidHJhY2VfdmVyc2lvbiI6IjVkOWViZjYxOWM2MUA1YjZiOWRjOWU4ZTEiLCJpc3N1ZWRfYXQiOiIyMDI2LTA2LTE3VDIyOjAyOjQ0LjA3MVoifQ", BUILD_RELEASE_MANIFEST_SIGNATURE = "MqIyb1B_GA8W5Nv_Jictwt1jVCCTgxxdIjUFJqLoeAU", BUILD_DEFAULT_BACKEND_URL = "https://beta-api.unbrowse.ai", BUILD_DEFAULT_PROFILE = "";
+var BUILD_RELEASE_VERSION = "9.6.2", BUILD_GIT_SHA = "d2d14a6629a0", BUILD_CODE_HASH = "5d9ebf619c61", BUILD_RELEASE_MANIFEST_BASE64 = "eyJzY2hlbWFfdmVyc2lvbiI6MSwicmVsZWFzZV92ZXJzaW9uIjoiOS42LjIiLCJnaXRfc2hhIjoiZDJkMTRhNjYyOWEwIiwiY29kZV9oYXNoIjoiNWQ5ZWJmNjE5YzYxIiwidHJhY2VfdmVyc2lvbiI6IjVkOWViZjYxOWM2MUBkMmQxNGE2NjI5YTAiLCJpc3N1ZWRfYXQiOiIyMDI2LTA2LTE4VDA0OjE3OjAzLjg1M1oifQ", BUILD_RELEASE_MANIFEST_SIGNATURE = "OefvyW2iLVVPQ-0HMg9Mz-bciCmP8LE5u7fVEss_98E", BUILD_DEFAULT_BACKEND_URL = "https://beta-api.unbrowse.ai", BUILD_DEFAULT_PROFILE = "";
 
 // .tmp-runtime-src/version.ts
 import { createHash as createHash4 } from "crypto";
@@ -43177,6 +43177,133 @@ var init_header_classify = __esm(() => {
   SENSITIVE_HEADER_PATTERN = /token|key|secret|credential|password|session/i;
 });
 
+// .tmp-runtime-src/values/cardinality.ts
+function isListLikeIntent(intent) {
+  return LIST_INTENT_RE.test(intent ?? "");
+}
+function valueLooksLikeSingleItem(value) {
+  if (value == null || Array.isArray(value) || typeof value !== "object")
+    return false;
+  const obj = value;
+  for (const key of COLLECTION_KEYS) {
+    if (Array.isArray(obj[key]))
+      return false;
+  }
+  for (const v of Object.values(obj)) {
+    if (Array.isArray(v) && v.some((x) => x !== null && typeof x === "object"))
+      return false;
+  }
+  const atType = typeof obj["@type"] === "string" ? obj["@type"].toLowerCase() : "";
+  const isItemType = ITEM_SCHEMA_TYPES.has(atType);
+  const hasName = "name" in obj || "title" in obj || "headline" in obj;
+  const hasPriceish = "offers" in obj || "price" in obj || "sku" in obj;
+  return isItemType || hasName && hasPriceish;
+}
+function schemaLooksLikeSingleItem(rs) {
+  if (!rs || typeof rs !== "object")
+    return false;
+  const schema = rs;
+  if (schema.type === "array")
+    return false;
+  const props = schema.properties ?? {};
+  for (const key of COLLECTION_KEYS) {
+    if (key in props)
+      return false;
+  }
+  for (const value of Object.values(props)) {
+    if (value && typeof value === "object" && value.type === "array" && value.items?.type === "object") {
+      return false;
+    }
+  }
+  if (schema.type !== "object")
+    return false;
+  const hasType = "@type" in props;
+  const hasName = "name" in props || "title" in props;
+  const hasPriceish = "offers" in props || "price" in props || "sku" in props;
+  return hasType || hasName && hasPriceish;
+}
+function routeLooksLikeSingleItem(route) {
+  const tmpl = route.url_template ?? "";
+  let pathAndQuery = tmpl;
+  try {
+    const u = new URL(tmpl);
+    pathAndQuery = `${u.pathname}${u.search}`;
+  } catch {}
+  const lower = pathAndQuery.toLowerCase();
+  if (/\/(?:search|q|categories?|browse|results?|listings|explore|discover|feed|catalog(?:ue)?|collections?|shop|all)\b/.test(lower) || /[?&](?:q|query|keyword|keywords|search|term|category|cat|page)=/.test(lower)) {
+    return false;
+  }
+  if (/\/(?:p|product|products|item|items|listing|detail|details|dp|pd|sku)\/[^/]+/.test(lower))
+    return true;
+  const lastSeg = lower.split("?")[0].replace(/\/+$/, "").split("/").pop() ?? "";
+  if (/-\d{3,}$/.test(lastSeg) || /^\d{3,}$/.test(lastSeg))
+    return true;
+  if (/\{[^}]+\}/.test(lower))
+    return false;
+  return schemaLooksLikeSingleItem(route.response_schema);
+}
+function urlPathLooksListLike(contextUrl) {
+  if (!contextUrl)
+    return false;
+  try {
+    const pathname = new URL(contextUrl).pathname.toLowerCase();
+    return /\/(?:search|basic-search|result-page|results?|discover|browse|categories?|q|listings|feed|catalog(?:ue)?)\b/.test(pathname);
+  } catch {
+    return false;
+  }
+}
+function cardinalityMatches(intent, subject, opts) {
+  const wantsMany = isListLikeIntent(intent) || urlPathLooksListLike(opts?.contextUrl);
+  if (!wantsMany)
+    return true;
+  switch (subject.kind) {
+    case "value":
+      return !valueLooksLikeSingleItem(subject.value);
+    case "schema":
+      return !schemaLooksLikeSingleItem(subject.schema);
+    case "route":
+      return !routeLooksLikeSingleItem(subject.route);
+  }
+}
+function resolutionCardinalityMatches(intent, data) {
+  return cardinalityMatches(intent, { kind: "value", value: data });
+}
+var LIST_INTENT_RE, ITEM_SCHEMA_TYPES, COLLECTION_KEYS;
+var init_cardinality = __esm(() => {
+  LIST_INTENT_RE = /\b(search|find|lookup|browse|discover|list(?:ings?)?|feed|catalog(?:ue)?)\b/i;
+  ITEM_SCHEMA_TYPES = new Set([
+    "product",
+    "offer",
+    "article",
+    "newsarticle",
+    "blogposting",
+    "recipe",
+    "event",
+    "place",
+    "localbusiness",
+    "jobposting",
+    "book",
+    "movie",
+    "creativework",
+    "person",
+    "organization"
+  ]);
+  COLLECTION_KEYS = [
+    "itemListElement",
+    "items",
+    "results",
+    "products",
+    "listings",
+    "data",
+    "edges",
+    "hits",
+    "records",
+    "entries",
+    "rows",
+    "nodes"
+  ];
+});
+
 // node_modules/.bun/nanoid@5.1.11/node_modules/nanoid/url-alphabet/index.js
 var urlAlphabet = "useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict";
 
@@ -115440,7 +115567,7 @@ __export(exports_extraction, {
   cleanDOM: () => cleanDOM,
   buildStructuredDataHeader: () => buildStructuredDataHeader
 });
-function extractHtmlMetadataFallback(html3) {
+function extractHtmlMetadataFallback(html3, intent) {
   if (!html3 || html3.length < 100)
     return null;
   try {
@@ -115472,8 +115599,9 @@ function extractHtmlMetadataFallback(html3) {
           jsonLdBlocks.push(parsed);
       } catch {}
     });
-    if (jsonLdBlocks.length > 0)
-      out.json_ld = jsonLdBlocks;
+    const usableJsonLd = isListLikeIntent(intent) ? jsonLdBlocks.filter((b) => !valueLooksLikeSingleItem(b)) : jsonLdBlocks;
+    if (usableJsonLd.length > 0)
+      out.json_ld = usableJsonLd;
     const headings = [];
     $2("h1, h2").each((_, el) => {
       const text3 = cleanText($2(el).text());
@@ -117796,6 +117924,16 @@ function scoreSiteMetaJsonLdDemotion(structure, intent) {
     return 0;
   return -200;
 }
+function isSingleItemStructureForList(structure, intent) {
+  if (!TINY_RESULT_LIST_INTENT.test(intent.toLowerCase()))
+    return false;
+  if (structure.type === "repeated-elements")
+    return false;
+  return valueLooksLikeSingleItem(structure.data);
+}
+function scoreSingleItemListMismatch(structure, intent) {
+  return isSingleItemStructureForList(structure, intent) ? -200 : 0;
+}
 function looksLikeTinyContentReadResult(data2, intent) {
   if (data2 == null)
     return { tiny: false, bytes: 0, stringLeafChars: 0 };
@@ -117949,9 +118087,9 @@ function extractFromDOM(html3, intent, contextUrl) {
   const articleStructures = extractArticleBodySpecial(html3.length > 600000 ? html3.slice(0, 600000) : html3, intent);
   const allStructures = [...flashStructures, ...githubStructures, ...repeatedPersonStructures, ...packageSearchStructures, ...xProfileStructures, ...postStructures, ...repeatedArticleStructures, ...trendStructures, ...definitionStructures, ...packageDetailStructures, ...arxivAbstractStructures, ...courseStructures, ...articleStructures, ...spaStructures, ...parseStructured(cleaned)].map((structure) => normalizeStructureForIntent(structure, intent));
   const isListIntent = TINY_RESULT_LIST_INTENT.test(intent.toLowerCase());
-  const structures = allStructures.filter((s) => !(s.type === "repeated-elements" && looksLikeDegenerateRowArray(s.data)) && !looksLikeConfigShape(s.data) && !looksLikeEmptyContainer(s.data) && !(isListIntent && looksLikeSiteMetaJsonLd(s.data)));
+  const structures = allStructures.filter((s) => !(s.type === "repeated-elements" && looksLikeDegenerateRowArray(s.data)) && !looksLikeConfigShape(s.data) && !looksLikeEmptyContainer(s.data) && !(isListIntent && looksLikeSiteMetaJsonLd(s.data)) && !isSingleItemStructureForList(s, intent));
   if (structures.length === 0) {
-    const fallback2 = extractHtmlMetadataFallback(html3);
+    const fallback2 = extractHtmlMetadataFallback(html3, intent);
     if (fallback2) {
       return _finalize({ data: fallback2, extraction_method: "html_metadata_fallback", confidence: 0.4 });
     }
@@ -117960,7 +118098,7 @@ function extractFromDOM(html3, intent, contextUrl) {
   const intentWords = intent.toLowerCase().split(/\s+/).filter(Boolean);
   const scored = structures.map((s) => ({
     structure: s,
-    score: scoreRelevance(s, intentWords) + scoreSemanticFit(s, intent) + scoreSparseLinkList(s) + scoreFieldRichness(s) + scoreConfigShapeDemotion(s) + scoreDegenerateRowDemotion(s) + scoreDuplicateRowDemotion(s) + scoreEmptyContainerDemotion(s) + scoreSiteMetaJsonLdDemotion(s, intent) + scoreTableIntentOverlapDemotion(s, intent, contextUrl, structures)
+    score: scoreRelevance(s, intentWords) + scoreSemanticFit(s, intent) + scoreSparseLinkList(s) + scoreFieldRichness(s) + scoreConfigShapeDemotion(s) + scoreDegenerateRowDemotion(s) + scoreDuplicateRowDemotion(s) + scoreEmptyContainerDemotion(s) + scoreSiteMetaJsonLdDemotion(s, intent) + scoreSingleItemListMismatch(s, intent) + scoreTableIntentOverlapDemotion(s, intent, contextUrl, structures)
   }));
   scored.sort((a, b) => b.score - a.score);
   const passing = scored.filter((candidate) => assessIntentResult(candidate.structure.data, intent).verdict === "pass");
@@ -118576,6 +118714,7 @@ function sanitizeExtractionToJson(data2, depth = 0) {
 var STRIP_TAGS, CHROME_TAGS, AD_PATTERNS, HIDDEN_ATTRS, CONTENT_SELECTORS, CARD_SELECTORS, CONFIG_TOP_LEVEL_KEYS, CONFIG_CHUNK_VALUE_KEYS, INTENT_OVERLAP_STOPWORDS, SITE_META_LD_TYPES, TINY_RESULT_LIST_INTENT, TINY_RESULT_DETAIL_INTENT, STRUCTURED_DATA_HIGHLIGHT_TYPES, HTML_TAG_RE, TABLE_RE;
 var init_extraction = __esm(() => {
   init_esm11();
+  init_cardinality();
   STRIP_TAGS = new Set(["script", "style", "noscript", "svg", "iframe"]);
   CHROME_TAGS = new Set(["nav", "footer", "header"]);
   AD_PATTERNS = /\b(ad|ads|advert|advertisement|tracking|tracker|cookie-banner|cookie-consent|cookie-notice|popup|modal-overlay|gdpr|consent|banner-promo)\b/i;
@@ -128277,7 +128416,8 @@ function selectBestEndpoint(endpoints, intent, skillDomain, contextUrl) {
   const ranked = rankEndpoints(endpoints, intent, skillDomain, contextUrl);
   if (ranked.length === 0)
     throw new Error("All endpoints are disabled");
-  return ranked[0].endpoint;
+  const preferred = ranked.find((r) => cardinalityMatches(intent, { kind: "route", route: r.endpoint }, { contextUrl }));
+  return (preferred ?? ranked[0]).endpoint;
 }
 function isHtml2(text3) {
   const trimmed = text3.trimStart().slice(0, 200).toLowerCase();
@@ -128324,6 +128464,7 @@ var init_execution = __esm(async () => {
   init_reveng_server_first();
   init_header_classify();
   init_storage_hole_bindings();
+  init_cardinality();
   init_sealed_blob_store();
   init_signer();
   init_bundle_scanner();
@@ -130567,7 +130708,10 @@ function pickWalkTarget(requestedUrl, ranked, minScore = 0.8) {
       return false;
     }
   };
-  return eligible.find((c) => hasPath(c.url)) ?? eligible[0];
+  const reqReg = registrableHost(requestedUrl);
+  const sameDomain = reqReg ? eligible.filter((c) => registrableHost(c.url) === reqReg) : [];
+  const pool2 = sameDomain.length > 0 ? sameDomain : eligible;
+  return pool2.find((c) => hasPath(c.url)) ?? pool2[0];
 }
 function artifactResultWithShortlist(artifact, skillId, triggerUrl) {
   const ep = artifact.endpoint;
@@ -131037,6 +131181,9 @@ function isResolveUsableEndpointForIntent(endpoint, intent, contextUrl) {
   if (isFeedTimelineIntent(intent, contextUrl) && endpointHasNegativeTag(endpoint, "helper")) {
     return false;
   }
+  if (!cardinalityMatches(intent, { kind: "route", route: endpoint }, { contextUrl })) {
+    return false;
+  }
   return true;
 }
 function normalizeRouteContext(url) {
@@ -131179,7 +131326,7 @@ function withContextReplayEndpoint(skill, _intent, _contextUrl) {
   return skill;
 }
 function isSearchLikeIntent(intent, contextUrl) {
-  if (/\b(search|find|lookup|browse|discover)\b/i.test(intent ?? ""))
+  if (isListLikeIntent(intent))
     return true;
   try {
     const pathname = contextUrl ? new URL(contextUrl).pathname.toLowerCase() : "";
@@ -132051,7 +132198,20 @@ function inferPreferredEntityTokens(intent) {
   return [];
 }
 function isAcceptableIntentResult(result, intent) {
-  return assessIntentResult(result, intent).verdict !== "fail";
+  if (assessIntentResult(result, intent).verdict === "fail")
+    return false;
+  if (!cardinalityMatches(intent, { kind: "value", value: unwrapResultPayload(result) }))
+    return false;
+  return true;
+}
+function unwrapResultPayload(result) {
+  if (result == null || typeof result !== "object" || Array.isArray(result))
+    return result;
+  const rec = { ...result };
+  for (const k of ["available_endpoints", "available_operations", "shortlist_for_judgment", "workflow_dag", "walked_from", "exa_candidates", "run_plan"]) {
+    delete rec[k];
+  }
+  return rec;
 }
 function candidateMatchesPreferredEntity(candidate, preferredTokens) {
   if (preferredTokens.length === 0)
@@ -135893,6 +136053,8 @@ var init_orchestrator = __esm(async () => {
   init_search_forms();
   init_ddg_search();
   init_cached_resolution();
+  init_cardinality();
+  init_cardinality();
   init_principal_scope();
   init_yield_safety();
   init_trace_store();
@@ -142647,9 +142809,14 @@ async function registerRoutes(app) {
             recovered = true;
           } else if (errResult.available_endpoints?.length === 1) {
             const only = errResult.available_endpoints[0].endpoint_id;
-            console.log(`[exec] D7 single-endpoint skill: rewriting endpoint_id ${want} → ${only}`);
-            execParams.endpoint_id = only;
-            recovered = true;
+            const onlyEp = (skill.endpoints ?? []).find((e) => e.endpoint_id === only);
+            if (!onlyEp || cardinalityMatches(intent, { kind: "route", route: onlyEp }, { contextUrl: context_url })) {
+              console.log(`[exec] D7 single-endpoint skill: rewriting endpoint_id ${want} → ${only}`);
+              execParams.endpoint_id = only;
+              recovered = true;
+            } else {
+              console.log(`[exec] D7 single-endpoint skill: only endpoint ${only} is a single-item route for a list intent — not forcing (cardinality gate)`);
+            }
           }
         }
         if (!recovered && (skill.endpoints?.length ?? 0) >= 2 && intent) {
@@ -143877,6 +144044,7 @@ var init_routes = __esm(async () => {
   init_client();
   init_reveng_server_first();
   init_header_classify();
+  init_cardinality();
   init_capture_spool();
   init_nanoid();
   init_marketplace();
@@ -232579,7 +232747,7 @@ async function cmdResolve(flags) {
   }
   if (resolveCacheSafe(flags)) {
     const cachedHit = peekResolution(resolveCacheKeyFor(flags, intent), resolveCacheTtlMs());
-    if (cachedHit) {
+    if (cachedHit && resolutionCardinalityMatches(intent, cachedHit.result ?? cachedHit.data)) {
       const replay = markResolveCacheReplay(cachedHit);
       const hostType2 = detectTelemetryHostType();
       if (process.env.UNBROWSE_LANDING_TOKEN || process.env.UNBROWSE_ATTRIBUTION_B64) {
@@ -232799,7 +232967,7 @@ async function cmdResolve(flags) {
     if (skill?.skill_id && trace) {
       result._feedback = `unbrowse feedback --skill ${skill.skill_id} --endpoint ${trace.endpoint_id || "?"} --rating <1-5>`;
     }
-    if (resolveCacheSafe(flags) && isResolveSuccessResult(result)) {
+    if (resolveCacheSafe(flags) && isResolveSuccessResult(result) && resolutionCardinalityMatches(intent, result.result ?? result.data)) {
       storeResolution(resolveCacheKeyFor(flags, intent), result, resolveCacheTtlMs());
     }
     output(result, !!flags.pretty);
@@ -233085,14 +233253,30 @@ async function cmdRun(args, flags, verb = "run") {
       } else if (explicitEndpointId || !bestEndpoint || endpointIsSafeToAutoExecute(bestEndpoint)) {
         runPlan.push({ step: "execute", mode: "direct_api", status: "started", endpoint_id: endpointToExecute });
         const resolvedSource = typeof result.source === "string" ? result.source : undefined;
-        result = await withPendingNotice(api4("POST", `/v1/skills/${skillId}/execute`, execBody(endpointToExecute)), "Executing best endpoint...");
-        if (resolvedSource && typeof result.source !== "string")
-          result.source = resolvedSource;
-        runPlan[runPlan.length - 1] = {
-          ...runPlan[runPlan.length - 1],
-          status: isResolveSuccessResult(result) ? "complete" : "error",
-          error: resolveResultError(result) ?? null
-        };
+        const deferralResult = result;
+        const executed = await withPendingNotice(api4("POST", `/v1/skills/${skillId}/execute`, execBody(endpointToExecute)), "Executing best endpoint...");
+        if (!explicitEndpointId && isResolveSuccessResult(executed) && !resolutionCardinalityMatches(intent, executed.result ?? executed.data)) {
+          runPlan[runPlan.length - 1] = {
+            ...runPlan[runPlan.length - 1],
+            status: "skipped",
+            reason: "cardinality_mismatch_single_item"
+          };
+          deferralResult.next_action = {
+            title: "List intent returned a single item",
+            command: `unbrowse execute --skill ${skillId} --endpoint ${endpointToExecute}`,
+            why: "Auto-execute yielded a single item for a list/search intent; the page's listings are likely JS-rendered behind an internal API. Returning the route shortlist instead of one item."
+          };
+          result = deferralResult;
+        } else {
+          result = executed;
+          if (resolvedSource && typeof result.source !== "string")
+            result.source = resolvedSource;
+          runPlan[runPlan.length - 1] = {
+            ...runPlan[runPlan.length - 1],
+            status: isResolveSuccessResult(result) ? "complete" : "error",
+            error: resolveResultError(result) ?? null
+          };
+        }
       } else {
         runPlan.push({
           step: "execute",
@@ -234916,6 +235100,7 @@ var init_cli = __esm(async () => {
   init_extract_auth_header();
   init_kuri_proxy_bridge();
   init_cached_resolution();
+  init_cardinality();
   init_issue();
   init_client2();
   init_impact_log();
@@ -236206,6 +236391,7 @@ __export(exports_orchestrator, {
   selectSkillIdsToHydrate: () => selectSkillIdsToHydrate2,
   selectSearchTermsForExecution: () => selectSearchTermsForExecution2,
   scopedCacheKey: () => scopedCacheKey2,
+  schemaLooksLikeSingleItem: () => schemaLooksLikeSingleItem,
   resolveEndpointTemplateBindings: () => resolveEndpointTemplateBindings2,
   resolveAndExecute: () => resolveAndExecute2,
   registrableHost: () => registrableHost2,
@@ -236220,7 +236406,9 @@ __export(exports_orchestrator, {
   pickPreferredSkillSnapshot: () => pickPreferredSkillSnapshot2,
   persistDomainCache: () => persistDomainCache2,
   marketplaceSkillMatchesContext: () => marketplaceSkillMatchesContext2,
+  looksLikeSingleItemRoute: () => looksLikeSingleItemRoute,
   isRouteCacheEntryStale: () => isRouteCacheEntryStale2,
+  isResolveUsableEndpointForIntent: () => isResolveUsableEndpointForIntent2,
   isCachedSkillRelevantForIntent: () => isCachedSkillRelevantForIntent2,
   invalidateRouteCacheForDomain: () => invalidateRouteCacheForDomain3,
   inferSearchParamOverrides: () => inferSearchParamOverrides2,
@@ -236275,7 +236463,10 @@ function pickWalkTarget2(requestedUrl, ranked, minScore = 0.8) {
       return false;
     }
   };
-  return eligible.find((c) => hasPath(c.url)) ?? eligible[0];
+  const reqReg = registrableHost2(requestedUrl);
+  const sameDomain = reqReg ? eligible.filter((c) => registrableHost2(c.url) === reqReg) : [];
+  const pool2 = sameDomain.length > 0 ? sameDomain : eligible;
+  return pool2.find((c) => hasPath(c.url)) ?? pool2[0];
 }
 function artifactResultWithShortlist2(artifact, skillId, triggerUrl) {
   const ep = artifact.endpoint;
@@ -236736,6 +236927,9 @@ function endpointTargetsMismatchedLocalReplayHost2(endpoint, contextUrl) {
 function endpointHasNegativeTag2(endpoint, tag) {
   return (endpoint.semantic?.negative_tags ?? []).some((candidate) => candidate.trim().toLowerCase() === tag.trim().toLowerCase());
 }
+function looksLikeSingleItemRoute(endpoint) {
+  return routeLooksLikeSingleItem(endpoint);
+}
 function isResolveUsableEndpointForIntent2(endpoint, intent, contextUrl) {
   if (endpointTargetsMismatchedLocalReplayHost2(endpoint, contextUrl))
     return false;
@@ -236745,6 +236939,9 @@ function isResolveUsableEndpointForIntent2(endpoint, intent, contextUrl) {
   if (isFeedTimelineIntent2(intent, contextUrl) && endpointHasNegativeTag2(endpoint, "helper")) {
     return false;
   }
+  if (!cardinalityMatches(intent, { kind: "route", route: endpoint }, { contextUrl })) {
+    return false;
+  }
   return true;
 }
 function normalizeRouteContext2(url) {
@@ -236887,7 +237084,7 @@ function withContextReplayEndpoint2(skill, _intent, _contextUrl) {
   return skill;
 }
 function isSearchLikeIntent2(intent, contextUrl) {
-  if (/\b(search|find|lookup|browse|discover)\b/i.test(intent ?? ""))
+  if (isListLikeIntent(intent))
     return true;
   try {
     const pathname = contextUrl ? new URL(contextUrl).pathname.toLowerCase() : "";
@@ -237764,7 +237961,20 @@ function inferPreferredEntityTokens2(intent) {
   return [];
 }
 function isAcceptableIntentResult2(result, intent) {
-  return assessIntentResult(result, intent).verdict !== "fail";
+  if (assessIntentResult(result, intent).verdict === "fail")
+    return false;
+  if (!cardinalityMatches(intent, { kind: "value", value: unwrapResultPayload2(result) }))
+    return false;
+  return true;
+}
+function unwrapResultPayload2(result) {
+  if (result == null || typeof result !== "object" || Array.isArray(result))
+    return result;
+  const rec = { ...result };
+  for (const k of ["available_endpoints", "available_operations", "shortlist_for_judgment", "workflow_dag", "walked_from", "exa_candidates", "run_plan"]) {
+    delete rec[k];
+  }
+  return rec;
 }
 function candidateMatchesPreferredEntity2(candidate, preferredTokens) {
   if (preferredTokens.length === 0)
@@ -241606,6 +241816,8 @@ var init_orchestrator2 = __esm(async () => {
   init_search_forms();
   init_ddg_search();
   init_cached_resolution();
+  init_cardinality();
+  init_cardinality();
   init_principal_scope();
   init_yield_safety();
   init_trace_store();

package/vendor/kuri/manifest.json

@@ -2,7 +2,7 @@
   "repo_url": "https://github.com/justrach/kuri.git",
   "branch": "adding-extensions",
   "source_sha": "149881254046a20778f642b69f20f0c6468f6fb4",
-  "built_at": "2026-06-17T21:47:52.749Z",
+  "built_at": "2026-06-18T03:58:10.362Z",
   "binaries": {
     "darwin-arm64": {
       "zig_target": "aarch64-macos",
@@ -21,11 +21,11 @@
     },
     "linux-x64": {
       "zig_target": "x86_64-linux",
-      "sha256": "250b2dfafc912dfda669416984036cf745749a0f5322c85acf0f95d7902e2dff"
+      "sha256": "e73aecfbf07001ba0be5032118790eb253ad5d8d12caca6a1dd5ad3ccab44b9e"
     },
     "win-x64": {
       "zig_target": "x86_64-windows-gnu",
-      "sha256": "f920a3a3f95e38c3245c52af11989a046a0c8c87b4091d8b3c0a1638b44b6179",
+      "sha256": "9ecbc82be646e755e4664051cf345d54dde3c6610e457d763deff67895047963",
       "source": "pre-staged"
     }
   },
@@ -33,22 +33,22 @@
     "darwin-arm64": {
       "zig_target": "aarch64-macos",
       "lib": "libkuri_ffi.dylib",
-      "sha256": "898a9290964371d9814d98de79bc62678833a0b914c47f765d46d6080ee391d5"
+      "sha256": "6c72cf383df4fa3f870b745da43d64eae8f67e58c6f971214ac29602fb649939"
     },
     "darwin-x64": {
       "zig_target": "x86_64-macos",
       "lib": "libkuri_ffi.dylib",
-      "sha256": "730a09622d95ee3a5c9f5c41a7971d8ab93e7ca401be717c54c13bbbe498f604"
+      "sha256": "82480772ddc8e44c8e34e70b80d7dc0969004942f77276587af450b62d3d2750"
     },
     "linux-arm64": {
       "zig_target": "aarch64-linux",
       "lib": "libkuri_ffi.so",
-      "sha256": "ef27e02d48f90d159b0bbcbc35b07970354af2924653ba0b00a863d9153c0313"
+      "sha256": "ef8dfa2b634f04294f93a94472d9856ba777681afaab2d4213f0e29821882e07"
     },
     "linux-x64": {
       "zig_target": "x86_64-linux",
       "lib": "libkuri_ffi.so",
-      "sha256": "de4075e2444204d2f860d1293577d4389247c6fe55049c7505196d9e8eb5f4fb"
+      "sha256": "fb29ad2b71186d176306321d17e88074a67fea139991faef9aa4862333942c9e"
     }
   }
 }