unbrowse 9.6.1 → 9.6.2

package/package.json

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

package/runtime/cli.js

@@ -1752,10 +1752,74 @@ function valueLooksLikeSingleItem(value) {
   const hasPriceish = "offers" in obj || "price" in obj || "sku" in obj;
   return isItemType || hasName && hasPriceish;
 }
-function resolutionCardinalityMatches(intent, data) {
-  if (!isListLikeIntent(intent))
+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;
-  return !valueLooksLikeSingleItem(data);
+  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(() => {
@@ -2286,7 +2350,7 @@ var init_telemetry = __esm(() => {
 });
 
 // .tmp-runtime-src/build-info.generated.ts
-var BUILD_RELEASE_VERSION = "9.6.1", BUILD_GIT_SHA = "7c8049ccfb77", BUILD_CODE_HASH = "5d9ebf619c61", BUILD_RELEASE_MANIFEST_BASE64 = "eyJzY2hlbWFfdmVyc2lvbiI6MSwicmVsZWFzZV92ZXJzaW9uIjoiOS42LjEiLCJnaXRfc2hhIjoiN2M4MDQ5Y2NmYjc3IiwiY29kZV9oYXNoIjoiNWQ5ZWJmNjE5YzYxIiwidHJhY2VfdmVyc2lvbiI6IjVkOWViZjYxOWM2MUA3YzgwNDljY2ZiNzciLCJpc3N1ZWRfYXQiOiIyMDI2LTA2LTE4VDAzOjA1OjI0LjExOVoifQ", BUILD_RELEASE_MANIFEST_SIGNATURE = "EvwEtBNSpI-heDzj2LEUfGnS7PdM_EEZif1VhvQBaz8", 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";
@@ -45983,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";
 
@@ -117291,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 {
@@ -117323,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());
@@ -119647,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 };
@@ -119800,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 });
     }
@@ -119811,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");
@@ -120427,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;
@@ -129952,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();
@@ -129999,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();
@@ -130551,69 +130753,6 @@ function bindingGraphFromOperationGraph(og) {
   return { endpoints, edges };
 }
 
-// .tmp-runtime-src/values/cardinality.ts
-function isListLikeIntent2(intent) {
-  return LIST_INTENT_RE2.test(intent ?? "");
-}
-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 key2 of COLLECTION_KEYS2) {
-    if (key2 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;
-}
-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"
-  ];
-});
-
 // .tmp-runtime-src/values/yield-safety.ts
 function tokenizeKey(key2) {
   return key2.replace(/([a-z0-9])([A-Z])/g, "$1 $2").split(/[_\-.\s]+/).map((s) => s.toLowerCase()).filter(Boolean);
@@ -132745,26 +132884,6 @@ function endpointTargetsMismatchedLocalReplayHost(endpoint, contextUrl) {
 function endpointHasNegativeTag(endpoint, tag) {
   return (endpoint.semantic?.negative_tags ?? []).some((candidate) => candidate.trim().toLowerCase() === tag.trim().toLowerCase());
 }
-function looksLikeSingleItemRoute(endpoint) {
-  const tmpl = endpoint.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(endpoint.response_schema);
-}
 function isResolveUsableEndpointForIntent(endpoint, intent, contextUrl) {
   if (endpointTargetsMismatchedLocalReplayHost(endpoint, contextUrl))
     return false;
@@ -132774,7 +132893,7 @@ function isResolveUsableEndpointForIntent(endpoint, intent, contextUrl) {
   if (isFeedTimelineIntent(intent, contextUrl) && endpointHasNegativeTag(endpoint, "helper")) {
     return false;
   }
-  if (isSearchLikeIntent(intent, contextUrl) && looksLikeSingleItemRoute(endpoint)) {
+  if (!cardinalityMatches2(intent, { kind: "route", route: endpoint }, { contextUrl })) {
     return false;
   }
   return true;
@@ -133791,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)
@@ -144132,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) {
@@ -145362,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();
@@ -150755,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 {
@@ -150787,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());
@@ -153111,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 };
@@ -153264,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 });
     }
@@ -153275,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");
@@ -153891,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;
@@ -240035,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",

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.1", BUILD_GIT_SHA = "7c8049ccfb77", BUILD_CODE_HASH = "5d9ebf619c61", BUILD_RELEASE_MANIFEST_BASE64 = "eyJzY2hlbWFfdmVyc2lvbiI6MSwicmVsZWFzZV92ZXJzaW9uIjoiOS42LjEiLCJnaXRfc2hhIjoiN2M4MDQ5Y2NmYjc3IiwiY29kZV9oYXNoIjoiNWQ5ZWJmNjE5YzYxIiwidHJhY2VfdmVyc2lvbiI6IjVkOWViZjYxOWM2MUA3YzgwNDljY2ZiNzciLCJpc3N1ZWRfYXQiOiIyMDI2LTA2LTE4VDAzOjA1OjI0LjExOVoifQ", BUILD_RELEASE_MANIFEST_SIGNATURE = "EvwEtBNSpI-heDzj2LEUfGnS7PdM_EEZif1VhvQBaz8", 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();
@@ -128876,92 +129017,6 @@ function bindingGraphFromOperationGraph(og) {
   return { endpoints, edges };
 }
 
-// .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 key2 of COLLECTION_KEYS) {
-    if (Array.isArray(obj[key2]))
-      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 key2 of COLLECTION_KEYS) {
-    if (key2 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 resolutionCardinalityMatches(intent, data2) {
-  if (!isListLikeIntent(intent))
-    return true;
-  return !valueLooksLikeSingleItem(data2);
-}
-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/yield-safety.ts
 function tokenizeKey(key2) {
   return key2.replace(/([a-z0-9])([A-Z])/g, "$1 $2").split(/[_\-.\s]+/).map((s) => s.toLowerCase()).filter(Boolean);
@@ -131117,26 +131172,6 @@ function endpointTargetsMismatchedLocalReplayHost(endpoint, contextUrl) {
 function endpointHasNegativeTag(endpoint, tag) {
   return (endpoint.semantic?.negative_tags ?? []).some((candidate) => candidate.trim().toLowerCase() === tag.trim().toLowerCase());
 }
-function looksLikeSingleItemRoute(endpoint) {
-  const tmpl = endpoint.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(endpoint.response_schema);
-}
 function isResolveUsableEndpointForIntent(endpoint, intent, contextUrl) {
   if (endpointTargetsMismatchedLocalReplayHost(endpoint, contextUrl))
     return false;
@@ -131146,7 +131181,7 @@ function isResolveUsableEndpointForIntent(endpoint, intent, contextUrl) {
   if (isFeedTimelineIntent(intent, contextUrl) && endpointHasNegativeTag(endpoint, "helper")) {
     return false;
   }
-  if (isSearchLikeIntent(intent, contextUrl) && looksLikeSingleItemRoute(endpoint)) {
+  if (!cardinalityMatches(intent, { kind: "route", route: endpoint }, { contextUrl })) {
     return false;
   }
   return true;
@@ -132163,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)
@@ -142761,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) {
@@ -143991,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();
@@ -233199,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",
@@ -236336,7 +236406,7 @@ __export(exports_orchestrator, {
   pickPreferredSkillSnapshot: () => pickPreferredSkillSnapshot2,
   persistDomainCache: () => persistDomainCache2,
   marketplaceSkillMatchesContext: () => marketplaceSkillMatchesContext2,
-  looksLikeSingleItemRoute: () => looksLikeSingleItemRoute2,
+  looksLikeSingleItemRoute: () => looksLikeSingleItemRoute,
   isRouteCacheEntryStale: () => isRouteCacheEntryStale2,
   isResolveUsableEndpointForIntent: () => isResolveUsableEndpointForIntent2,
   isCachedSkillRelevantForIntent: () => isCachedSkillRelevantForIntent2,
@@ -236857,25 +236927,8 @@ function endpointTargetsMismatchedLocalReplayHost2(endpoint, contextUrl) {
 function endpointHasNegativeTag2(endpoint, tag) {
   return (endpoint.semantic?.negative_tags ?? []).some((candidate) => candidate.trim().toLowerCase() === tag.trim().toLowerCase());
 }
-function looksLikeSingleItemRoute2(endpoint) {
-  const tmpl = endpoint.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(endpoint.response_schema);
+function looksLikeSingleItemRoute(endpoint) {
+  return routeLooksLikeSingleItem(endpoint);
 }
 function isResolveUsableEndpointForIntent2(endpoint, intent, contextUrl) {
   if (endpointTargetsMismatchedLocalReplayHost2(endpoint, contextUrl))
@@ -236886,7 +236939,7 @@ function isResolveUsableEndpointForIntent2(endpoint, intent, contextUrl) {
   if (isFeedTimelineIntent2(intent, contextUrl) && endpointHasNegativeTag2(endpoint, "helper")) {
     return false;
   }
-  if (isSearchLikeIntent2(intent, contextUrl) && looksLikeSingleItemRoute2(endpoint)) {
+  if (!cardinalityMatches(intent, { kind: "route", route: endpoint }, { contextUrl })) {
     return false;
   }
   return true;
@@ -237908,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)

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-18T02:47:19.984Z",
+  "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": "ae7633e7140f4d98633aa28f3bcff33e1398f3caf709a530c6cd2b36c251d113"
+      "sha256": "e73aecfbf07001ba0be5032118790eb253ad5d8d12caca6a1dd5ad3ccab44b9e"
     },
     "win-x64": {
       "zig_target": "x86_64-windows-gnu",
-      "sha256": "54a2d73ab37bd056e5e469c9c8aeb5c992645962aee10465f1452a33fab447db",
+      "sha256": "9ecbc82be646e755e4664051cf345d54dde3c6610e457d763deff67895047963",
       "source": "pre-staged"
     }
   },
@@ -33,22 +33,22 @@
     "darwin-arm64": {
       "zig_target": "aarch64-macos",
       "lib": "libkuri_ffi.dylib",
-      "sha256": "774ff424fb6a4abb2634b7a891b10fa9760474851e2e7d25ebd6701917d959db"
+      "sha256": "6c72cf383df4fa3f870b745da43d64eae8f67e58c6f971214ac29602fb649939"
     },
     "darwin-x64": {
       "zig_target": "x86_64-macos",
       "lib": "libkuri_ffi.dylib",
-      "sha256": "116afae77447b5036978d883541d264edbe3a2413788e904cf77b9123c0b79c3"
+      "sha256": "82480772ddc8e44c8e34e70b80d7dc0969004942f77276587af450b62d3d2750"
     },
     "linux-arm64": {
       "zig_target": "aarch64-linux",
       "lib": "libkuri_ffi.so",
-      "sha256": "4558df5a2057910dd646491a9de9d1e8b81e958e0d830f1b33a1d30d0d91e95f"
+      "sha256": "ef8dfa2b634f04294f93a94472d9856ba777681afaab2d4213f0e29821882e07"
     },
     "linux-x64": {
       "zig_target": "x86_64-linux",
       "lib": "libkuri_ffi.so",
-      "sha256": "b9bbb67c58aadfacbdf5304cdc7c1cea9014c6c3bb83dda7eb8661277f6c8b36"
+      "sha256": "fb29ad2b71186d176306321d17e88074a67fea139991faef9aa4862333942c9e"
     }
   }
 }