opendevbrowser 0.0.27 → 0.0.28

package/dist/{chunk-V5DJUSPV.js → chunk-T3VVHJTK.js}

@@ -3595,7 +3595,7 @@ var readFallbackRecord = (details, key) => {
 };
 var readFallbackString = (output, key) => {
   const value = output?.[key];
-  return typeof value === "string" && value.length > 0 ? value : void 0;
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
 };
 var fallbackDispositionMessage = (fallback, url) => {
   if (typeof fallback.details?.message === "string" && fallback.details.message.trim().length > 0) {
@@ -3610,32 +3610,67 @@ var fallbackDispositionMessage = (fallback, url) => {
       return `Browser fallback failed for ${url}`;
   }
 };
+var fallbackErrorDetails = (args) => ({
+  url: args.url,
+  disposition: args.fallback.disposition,
+  ...args.fallback.mode ? { browserFallbackMode: args.fallback.mode } : {},
+  ...args.fallback.challenge ? { challenge: toJsonRecord(args.fallback.challenge) } : {},
+  ...args.fallback.preservedSessionId ? { preservedSessionId: args.fallback.preservedSessionId } : {},
+  ...args.fallback.preservedTargetId ? { preservedTargetId: args.fallback.preservedTargetId } : {},
+  ...toJsonRecord(args.fallback.details ?? {}),
+  ...args.extra ?? {}
+});
+var addProviderIssueGuidance = (args) => {
+  const hint = readProviderIssueHint({
+    reasonCode: args.reasonCode,
+    details: args.details
+  });
+  const guidanceDetails = args.includeCompleted ? { ...args.details, disposition: "failed" } : args.details;
+  const guidance = hint ? buildProviderIssueGuidance({ provider: args.provider, hint, details: guidanceDetails }) : void 0;
+  return guidance ? { ...args.details, guidance } : args.details;
+};
 var toProviderFallbackError = (args) => {
   const { fallback } = args;
   const reasonCode = fallback.reasonCode;
-  const details = {
+  const details = fallbackErrorDetails({ url: args.url, fallback });
+  return new ProviderRuntimeError(
+    providerErrorCodeFromReasonCode(reasonCode),
+    fallbackDispositionMessage(fallback, args.url),
+    {
+      provider: args.provider,
+      source: args.source,
+      retryable: reasonCode === "rate_limited",
+      reasonCode,
+      details: addProviderIssueGuidance({
+        provider: args.provider,
+        reasonCode,
+        details
+      })
+    }
+  );
+};
+var toCompletedFallbackOutputError = (args) => {
+  const { fallback } = args;
+  const reasonCode = fallback.reasonCode;
+  const details = fallbackErrorDetails({
     url: args.url,
-    disposition: fallback.disposition,
-    ...fallback.mode ? { browserFallbackMode: fallback.mode } : {},
-    ...fallback.challenge ? { challenge: toJsonRecord(fallback.challenge) } : {},
-    ...fallback.preservedSessionId ? { preservedSessionId: fallback.preservedSessionId } : {},
-    ...fallback.preservedTargetId ? { preservedTargetId: fallback.preservedTargetId } : {},
-    ...toJsonRecord(fallback.details ?? {})
-  };
-  const hint = readProviderIssueHint({
-    reasonCode,
-    details
+    fallback,
+    extra: { fallbackOutputReason: args.outputReason }
   });
-  const guidance = hint ? buildProviderIssueGuidance({ provider: args.provider, hint, details }) : void 0;
   return new ProviderRuntimeError(
     providerErrorCodeFromReasonCode(reasonCode),
-    fallbackDispositionMessage(fallback, args.url),
+    `Browser fallback completed for ${args.url} without usable HTML content.`,
     {
       provider: args.provider,
       source: args.source,
       retryable: reasonCode === "rate_limited",
       reasonCode,
-      details: guidance ? { ...details, guidance } : details
+      details: addProviderIssueGuidance({
+        provider: args.provider,
+        reasonCode,
+        details,
+        includeCompleted: true
+      })
     }
   );
 };
@@ -5070,6 +5105,10 @@ var toPositiveInt = (value, fallback) => {
   if (typeof value !== "number" || Number.isNaN(value)) return fallback;
   return Math.max(1, Math.floor(value));
 };
+var toNonNegativeInt = (value, fallback) => {
+  if (typeof value !== "number" || Number.isNaN(value)) return fallback;
+  return Math.max(0, Math.floor(value));
+};
 var isHttpUrl2 = (value) => {
   try {
     const protocol = new URL(value).protocol;
@@ -5115,11 +5154,11 @@ var mergedTraversal = (options, input) => {
       asNumber(filters.pageLimit) ?? options.defaultTraversal?.pageLimit,
       DEFAULT_TRAVERSAL.pageLimit
     ),
-    hopLimit: toPositiveInt(
+    hopLimit: toNonNegativeInt(
       asNumber(filters.hopLimit) ?? options.defaultTraversal?.hopLimit,
       DEFAULT_TRAVERSAL.hopLimit
     ),
-    expansionPerRecord: toPositiveInt(
+    expansionPerRecord: toNonNegativeInt(
       asNumber(filters.expansionPerRecord) ?? options.defaultTraversal?.expansionPerRecord,
       DEFAULT_TRAVERSAL.expansionPerRecord
     ),
@@ -5428,7 +5467,7 @@ var createCommunityProvider = (options = {}) => {
 };
 
 // src/providers/social/search-quality.ts
-var TARGETED_PLATFORMS = /* @__PURE__ */ new Set(["x", "bluesky", "reddit", "facebook"]);
+var TARGETED_PLATFORMS = /* @__PURE__ */ new Set(["x", "bluesky", "reddit", "facebook", "threads"]);
 var SOCIAL_JS_REQUIRED_RE = /\b(?:javascript (?:is not available|required|is disabled(?: in this browser)?)|you need to enable javascript|please enable javascript)\b/i;
 var BLUESKY_LOGGED_OUT_SEARCH_RE = /\bsearch is currently unavailable when logged out\b/i;
 var BLUESKY_EMPTY_SEARCH_SHELL_RE = /\b(?:follow 10 people to get started|find people to follow)\b/i;
@@ -5496,6 +5535,10 @@ var isPrimaryFacebookHost = (host) => {
   const normalized = host.toLowerCase();
   return normalized === "www.facebook.com" || normalized === "facebook.com" || normalized === "m.facebook.com";
 };
+var isPrimaryThreadsHost = (host) => {
+  const normalized = host.toLowerCase();
+  return normalized === "www.threads.net" || normalized === "threads.net";
+};
 var isFacebookSearchLikePath = (pathname) => pathname === "/watch/search" || pathname === "/watch/search/" || pathname.startsWith("/watch/explore/") || pathname.startsWith("/search/") || pathname.startsWith("/public/") || pathname.startsWith("/hashtag/");
 var isBlockedFacebookNonContentUrl = (parsed, options) => {
   if (!isPrimaryFacebookHost(parsed.hostname)) {
@@ -5522,7 +5565,7 @@ var isBlockedRedditNonContentUrl = (parsed, options) => {
     return false;
   }
   const pathname = parsed.pathname.toLowerCase();
-  if (pathname === "/" || pathname === "/login" || options.includeSearchRoute && pathname === "/search") {
+  if (pathname === "/" || pathname === "/login" || pathname === "/login/" || options.includeSearchRoute && (pathname === "/search" || pathname === "/search/")) {
     return true;
   }
   const pathSegment = firstPathSegment(pathname);
@@ -5540,6 +5583,8 @@ var isRootShellUrl = (platform, parsed) => {
       return isBlockedRedditNonContentUrl(parsed, { includeSearchRoute: false });
     case "facebook":
       return isBlockedFacebookNonContentUrl(parsed, { includeSearchRoute: false });
+    case "threads":
+      return isPrimaryThreadsHost(host) && (pathname === "/" || pathname === "/login" || pathname === "/login/");
     default:
       return false;
   }
@@ -5556,6 +5601,8 @@ var isBlockedExpansionPath = (platform, parsed) => {
       return isBlockedRedditNonContentUrl(parsed, { includeSearchRoute: true });
     case "facebook":
       return isBlockedFacebookNonContentUrl(parsed, { includeSearchRoute: true });
+    case "threads":
+      return isPrimaryThreadsHost(host) && (pathname === "/" || pathname === "/login" || pathname === "/search" || pathname === "/search/" || isStaticMetadataPath(pathname));
     default:
       return false;
   }
@@ -5569,9 +5616,11 @@ var isFirstPartySearchRoute = (platform, parsed) => {
     case "bluesky":
       return host === "bsky.app" && pathname === "/search";
     case "reddit":
-      return isPrimaryRedditHost(host) && pathname === "/search";
+      return isPrimaryRedditHost(host) && (pathname === "/search" || pathname === "/search/");
     case "facebook":
       return isPrimaryFacebookHost(host) && isFacebookSearchLikePath(pathname);
+    case "threads":
+      return isPrimaryThreadsHost(host) && (pathname === "/search" || pathname === "/search/");
     default:
       return false;
   }
@@ -5648,6 +5697,10 @@ var isUsableFacebookSearchEvidenceUrl = (url) => {
   }
   return /^\/reel\/[^/]+\/?$/.test(pathname) || /^\/groups\/[^/]+\/posts\/[^/]+\/?$/.test(pathname) || /^\/[^/]+\/videos\/[^/]+\/?$/.test(pathname) || /^\/share\/v\/[^/]+\/?$/.test(pathname) || (pathname === "/permalink.php" || pathname === "/story.php") && parsed.searchParams.has("story_fbid") || pathname === "/photo/" && parsed.searchParams.has("fbid");
 };
+var isUsableThreadsSearchEvidenceUrl = (url) => {
+  const parsed = parseUrl(url);
+  return parsed !== null && isPrimaryThreadsHost(parsed.hostname) && /^\/@[^/]+\/post\/[^/]+\/?$/.test(parsed.pathname.toLowerCase());
+};
 var isRetainableFacebookSearchSupportUrl = (url) => {
   const parsed = parseUrl(url);
   if (parsed === null || !isPrimaryFacebookHost(parsed.hostname)) {
@@ -5670,17 +5723,18 @@ var hasFacebookSearchResultSignals = (input) => {
   const hasSearchHeading = FACEBOOK_SEARCH_RESULTS_HEADING_RE.test(combined);
   const markerCount = FACEBOOK_SEARCH_RESULT_MARKERS.filter((pattern) => pattern.test(combined)).length;
   const evidence = collectSocialSearchLinkEvidence("facebook", parsed.toString(), Array.isArray(input.links) ? input.links : []);
+  const hasContentEvidence = evidence.usableContentLinks.length > 0;
   const supportLinkCount = evidence.usableLinks.filter(isRetainableFacebookSearchSupportUrl).length;
-  if (markerCount >= 2) {
+  if (markerCount >= 2 && hasContentEvidence) {
     return true;
   }
   if (!hasSearchHeading) {
     return false;
   }
-  if (markerCount >= 1) {
+  if (markerCount >= 1 && hasContentEvidence) {
     return true;
   }
-  return supportLinkCount >= 2;
+  return supportLinkCount >= 2 && hasContentEvidence;
 };
 var isUsableSocialSearchContentUrl = (platform, url) => {
   switch (platform) {
@@ -5692,6 +5746,8 @@ var isUsableSocialSearchContentUrl = (platform, url) => {
       return isUsableRedditSearchEvidenceUrl(url);
     case "facebook":
       return isUsableFacebookSearchEvidenceUrl(url);
+    case "threads":
+      return isUsableThreadsSearchEvidenceUrl(url);
     default:
       return false;
   }
@@ -5865,6 +5921,10 @@ var toPositiveInt2 = (value, fallback) => {
   if (typeof value !== "number" || Number.isNaN(value)) return fallback;
   return Math.max(1, Math.floor(value));
 };
+var toNonNegativeInt2 = (value, fallback) => {
+  if (typeof value !== "number" || Number.isNaN(value)) return fallback;
+  return Math.max(0, Math.floor(value));
+};
 var isHttpUrl3 = (value) => {
   try {
     const protocol = new URL(value).protocol;
@@ -5954,11 +6014,11 @@ var mergedTraversal2 = (input, options) => {
       asNumber2(filters.pageLimit) ?? options.defaultTraversal?.pageLimit,
       DEFAULT_TRAVERSAL2.pageLimit
     ),
-    hopLimit: toPositiveInt2(
+    hopLimit: toNonNegativeInt2(
       asNumber2(filters.hopLimit) ?? options.defaultTraversal?.hopLimit,
       DEFAULT_TRAVERSAL2.hopLimit
     ),
-    expansionPerRecord: toPositiveInt2(
+    expansionPerRecord: toNonNegativeInt2(
       asNumber2(filters.expansionPerRecord) ?? options.defaultTraversal?.expansionPerRecord,
       DEFAULT_TRAVERSAL2.expansionPerRecord
     ),
@@ -7412,6 +7472,47 @@ var normalizeYouTubeVideoLink = (url) => {
   }
 };
 var YOUTUBE_SEARCH_SHELL_RE = /\b(?:about press copyright contact us creators advertise developers terms privacy policy|google for developers skip to main content youtube)\b/i;
+var YOUTUBE_FALLBACK_MIN_TEXT_CHARS = 40;
+var YOUTUBE_CONTENT_MARKER_RE = /"videoId"\s*:|"captionTracks"\s*:|itemprop="author"|itemprop="datePublished"|"viewCount"\s*:/i;
+var hasYouTubeFallbackEvidence = (html, url) => {
+  if (YOUTUBE_CONTENT_MARKER_RE.test(html)) return true;
+  return extractStructuredContent(html, url).links.some((link) => normalizeYouTubeVideoLink(link) !== null);
+};
+var reviewedFallback = (fallback, reasonCode) => ({
+  ...fallback,
+  reasonCode: reasonCode ?? fallback.reasonCode
+});
+var assertUsableYouTubeFallbackPage = (url, fallback, html) => {
+  const extracted = extractStructuredContent(html, url);
+  const text = extracted.text.trim();
+  const blocker = classifyBlockerSignal({
+    source: "runtime_fetch",
+    url,
+    message: text,
+    status: 200,
+    providerErrorCode: "unavailable",
+    retryable: true
+  });
+  if (blocker && blocker.type !== "unknown") {
+    throw toCompletedFallbackOutputError({
+      provider: "social/youtube",
+      source: "social",
+      url,
+      fallback: reviewedFallback(fallback, blocker.reasonCode),
+      outputReason: blocker.type
+    });
+  }
+  if (hasYouTubeFallbackEvidence(html, url)) return;
+  if (text.length < YOUTUBE_FALLBACK_MIN_TEXT_CHARS || YOUTUBE_SEARCH_SHELL_RE.test(text)) {
+    throw toCompletedFallbackOutputError({
+      provider: "social/youtube",
+      source: "social",
+      url,
+      fallback,
+      outputReason: "youtube_shell_or_metadata"
+    });
+  }
+};
 var extractSearchResultSegment = (html, videoId) => {
   const marker = new RegExp(`"videoId"\\s*:\\s*"${escapeRegExp(videoId)}"`);
   const match = marker.exec(html);
@@ -7514,7 +7615,7 @@ var summarizeTranscript = (transcript) => {
   const lines = transcript.split(/\n+/).map((line) => line.trim()).filter(Boolean);
   return lines.slice(0, 8).join(" ").slice(0, 800);
 };
-var fetchPage = async (url, context) => {
+var fetchPageDirect = async (url, context) => {
   let response;
   try {
     response = await fetch(url, {
@@ -7567,6 +7668,108 @@ var fetchPage = async (url, context) => {
     html: await response.text()
   };
 };
+var forcedFallbackReasonCode = (context) => {
+  const policy = context.runtimePolicy;
+  if (policy?.cookies.policy === "required") return "auth_required";
+  return "env_limited";
+};
+var fallbackReasonCodeForPageError = (error, context) => {
+  if (!isProviderRuntimeError(error)) return "env_limited";
+  if (error.code === "auth") {
+    return context.runtimePolicy?.cookies.policy === "required" ? "auth_required" : "token_required";
+  }
+  if (error.code === "rate_limited") return "rate_limited";
+  if (error.code === "network" || error.code === "timeout") return "env_limited";
+  if (error.code === "upstream") return "ip_blocked";
+  if (error.reasonCode === "ip_blocked" || error.reasonCode === "challenge_detected") return error.reasonCode;
+  return null;
+};
+var fallbackDetailsForError = (error) => {
+  if (!isProviderRuntimeError(error)) return {};
+  return {
+    errorCode: error.code,
+    message: error.message,
+    ...error.details ?? {}
+  };
+};
+var pageFromFallback = (url, fallback) => {
+  const html = readFallbackString(fallback.output, "html");
+  if (!html) {
+    throw toCompletedFallbackOutputError({
+      provider: "social/youtube",
+      source: "social",
+      url,
+      fallback,
+      outputReason: "missing_or_empty_html"
+    });
+  }
+  assertUsableYouTubeFallbackPage(url, fallback, html);
+  return {
+    status: 200,
+    url: readFallbackString(fallback.output, "url") ?? url,
+    html,
+    browserFallback: toBrowserFallbackObservation(fallback)
+  };
+};
+var resolveFallbackPage = async (args) => {
+  const fallback = await resolveProviderBrowserFallback({
+    browserFallbackPort: args.context.browserFallbackPort ?? args.options.browserFallbackPort,
+    provider: "social/youtube",
+    source: "social",
+    operation: args.operation,
+    reasonCode: args.reasonCode,
+    url: args.url,
+    context: args.context,
+    details: args.details,
+    recoveryHints: args.options.recoveryHints?.()
+  });
+  if (!fallback) return null;
+  if (fallback.disposition !== "completed") {
+    throw toProviderFallbackError({
+      provider: "social/youtube",
+      source: "social",
+      url: args.url,
+      fallback
+    });
+  }
+  return pageFromFallback(args.url, fallback);
+};
+var fetchPage = async (url, context, options, operation) => {
+  if (context.runtimePolicy?.browser.forceTransport) {
+    const page = await resolveFallbackPage({
+      url,
+      context,
+      options,
+      operation,
+      reasonCode: forcedFallbackReasonCode(context),
+      details: { message: "Direct browser transport was selected for this YouTube provider run." }
+    });
+    if (page) return page;
+    throw new ProviderRuntimeError(providerErrorCodeFromReasonCode(forcedFallbackReasonCode(context)), "Direct browser transport is required for this YouTube provider run, but no browser transport is available.", {
+      provider: "social/youtube",
+      source: "social",
+      retryable: false,
+      reasonCode: forcedFallbackReasonCode(context),
+      details: { browserTransportRequired: true }
+    });
+  }
+  try {
+    return await fetchPageDirect(url, context);
+  } catch (error) {
+    const reasonCode = fallbackReasonCodeForPageError(error, context);
+    if (!reasonCode) throw error;
+    const page = await resolveFallbackPage({
+      url,
+      context,
+      options,
+      operation,
+      reasonCode,
+      details: fallbackDetailsForError(error)
+    });
+    if (page) return page;
+    throw error;
+  }
+};
 var parseBooleanFilter = (value, fallback = false) => {
   if (typeof value === "boolean") return value;
   if (typeof value === "string") {
@@ -7609,7 +7812,7 @@ var resolveTranscriptStrategyDetail = (transcript) => {
   return transcript.attemptChain.at(-1)?.strategy;
 };
 var buildSearch = (options) => {
-  if (options) return options;
+  if (options.search) return options.search;
   return async (input, context) => {
     assertYouTubeLegalReviewChecklist();
     const query = input.query.trim();
@@ -7622,7 +7825,7 @@ var buildSearch = (options) => {
     }
     const lookupUrl = isHttpUrl4(query) ? query : `https://www.youtube.com/results?search_query=${encodeURIComponent(query)}`;
     const directUrlQuery = isHttpUrl4(query);
-    const page = await fetchPage(lookupUrl, context);
+    const page = await fetchPage(lookupUrl, context, options, "search");
     const extracted = extractStructuredContent(page.html, page.url);
     const extractedVideoLinks = [...new Set(
       extracted.links.map((link) => normalizeYouTubeVideoLink(link)).filter((link) => typeof link === "string" && link.length > 0)
@@ -7668,7 +7871,8 @@ var buildSearch = (options) => {
         retrievalPath: isHttpUrl4(query) ? "social:youtube:search:url" : "social:youtube:search:index",
         video_id: resolvedVideoId,
         ...primaryResult?.channel ? { channel: primaryResult.channel } : {},
-        links: extractedVideoLinks.slice(0, 20)
+        links: extractedVideoLinks.slice(0, 20),
+        ...browserFallbackObservationAttributes(page.browserFallback)
       }
     }];
   };
@@ -7677,7 +7881,7 @@ var buildFetch = (options) => {
   if (options.fetch) return options.fetch;
   return async (input, context) => {
     assertYouTubeLegalReviewChecklist();
-    const page = await fetchPage(input.url, context);
+    const page = await fetchPage(input.url, context, options, "fetch");
     const extracted = extractStructuredContent(page.html, page.url);
     const includeFullTranscript = parseBooleanFilter(input.filters?.include_full_transcript, false);
     const requireTranscript = parseBooleanFilter(input.filters?.requireTranscript, false);
@@ -7692,7 +7896,7 @@ var buildFetch = (options) => {
       legalChecklist: YOUTUBE_LEGAL_REVIEW_CHECKLIST,
       config: transcriptConfig,
       mode: requestedMode,
-      browserFallbackPort: options.browserFallbackPort,
+      browserFallbackPort: context.browserFallbackPort ?? options.browserFallbackPort,
       recoveryHints,
       allowBrowserFallbackEscalation: options.antiBotPolicy?.allowBrowserEscalation ?? true,
       asrTranscribe: options.asrTranscribe
@@ -7747,6 +7951,7 @@ var buildFetch = (options) => {
         transcript_mode: transcript.mode,
         translation_applied: translationApplied,
         transcript_summary: transcriptSummary,
+        ...browserFallbackObservationAttributes(page.browserFallback),
         ...includeFullTranscript ? { transcript_full: transcriptContent } : {},
         ...transcriptStrategyDetail ? { transcript_strategy_detail: transcriptStrategyDetail } : {},
         ...transcript.ok ? {
@@ -7789,7 +7994,7 @@ var withDefaultYouTubeOptions = (options = {}) => {
   };
   return {
     ...resolvedOptions,
-    search: buildSearch(resolvedOptions.search),
+    search: buildSearch(resolvedOptions),
     fetch: buildFetch(resolvedOptions)
   };
 };
@@ -7989,6 +8194,73 @@ var getShoppingRegionSupportDiagnostics = (providerIds, region) => {
   });
 };
 var hasValues2 = (values) => values.some((value) => value.trim().length > 0);
+var FALLBACK_HEAD_RE = /<head\b[^>]*>[\s\S]*?<\/head>/i;
+var FALLBACK_BODY_RE = /<body\b[^>]*>([\s\S]*?)<\/body>/i;
+var SHOPPING_FALLBACK_EVIDENCE_LIMIT = 1;
+var extractShoppingFallbackBodyText = (html) => {
+  const body = FALLBACK_BODY_RE.exec(html)?.[1];
+  return extractText(body ?? html.replace(FALLBACK_HEAD_RE, " "));
+};
+var hasShoppingMetadataEvidence = (extracted) => {
+  return extracted.metadata.price !== void 0;
+};
+var hasShoppingOfferTextEvidence = (text) => {
+  const price = parsePrice(text);
+  if (price.amount <= 0) return false;
+  return parseRating(text) > 0 || parseReviews(text) > 0 || parseAvailability(text) !== "unknown" || /\b(?:add to cart|buy now|shipping|pickup|deal|save)\b/i.test(text);
+};
+var hasShoppingBlockingPageEvidence = (url, extracted) => {
+  const blocker = classifyBlockerSignal({
+    source: "runtime_fetch",
+    url,
+    finalUrl: url,
+    title: typeof extracted.metadata.title === "string" ? extracted.metadata.title : void 0,
+    message: extracted.text,
+    status: 200,
+    providerErrorCode: "unavailable",
+    retryable: true
+  });
+  return blocker?.type === "auth_required" || blocker?.type === "anti_bot_challenge";
+};
+var hasShoppingFallbackEvidence = (args) => {
+  return args.extracted.links.some((link) => isLikelyProductUrl(canonicalizeUrl(link), args.profile)) || extractSearchCandidates(args.html, args.url, args.profile, SHOPPING_FALLBACK_EVIDENCE_LIMIT).length > 0 || hasShoppingMetadataEvidence(args.extracted) || hasShoppingOfferTextEvidence(extractShoppingFallbackBodyText(args.html)) || hasShoppingBlockingPageEvidence(args.url, args.extracted);
+};
+var toFallbackShellIssueError = (args) => {
+  const issue = classifyProviderIssue({
+    url: args.url,
+    title: args.requirement.title,
+    message: args.requirement.message,
+    providerShell: args.requirement.reason,
+    browserRequired: true,
+    status: 200
+  });
+  const reasonCode = issue?.reasonCode ?? "env_limited";
+  const extracted = extractStructuredContent(args.html, args.url);
+  return new ProviderRuntimeError(
+    providerErrorCodeFromReasonCode(reasonCode),
+    reasonCode === "challenge_detected" ? `Detected anti-bot challenge while retrieving ${args.url}` : `Browser assistance required for ${args.url}`,
+    {
+      provider: args.provider,
+      source: SHOPPING_SOURCE,
+      retryable: reasonCode === "env_limited",
+      reasonCode,
+      details: {
+        ...applyProviderIssueHint({
+          status: 200,
+          url: args.url,
+          ...args.requirement.title ? { title: args.requirement.title } : {},
+          ...args.requirement.message ? { message: args.requirement.message } : {},
+          providerShell: args.requirement.reason,
+          browserRequired: true,
+          extractionFocus: args.profile.extractionFocus,
+          extractedTextLength: extracted.text.length,
+          extractedLinkCount: extracted.links.length
+        }, issue),
+        ...browserFallbackObservationDetails(toBrowserFallbackObservation(args.fallback))
+      }
+    }
+  );
+};
 var parseIsoDate2 = (value) => {
   const parsed = Date.parse(value);
   return Number.isNaN(parsed) ? NaN : parsed;
@@ -8120,11 +8392,47 @@ var resolveBrowserFallback = async (args) => {
     };
   }
   const resolvedUrl = canonicalizeUrl(readFallbackString(fallback.output, "url") ?? args.url);
+  const html = readFallbackString(fallback.output, "html");
+  if (!html) {
+    throw toCompletedFallbackOutputError({
+      provider: args.provider,
+      source: SHOPPING_SOURCE,
+      url: resolvedUrl,
+      fallback,
+      outputReason: "missing_or_empty_html"
+    });
+  }
+  const extracted = extractStructuredContent(html, resolvedUrl);
+  const browserRequirement = requiresBrowserAssistance(args.profile, resolvedUrl, html);
+  if (browserRequirement) {
+    throw toFallbackShellIssueError({
+      provider: args.provider,
+      url: resolvedUrl,
+      html,
+      fallback,
+      profile: args.profile,
+      requirement: browserRequirement
+    });
+  }
+  if (!hasShoppingFallbackEvidence({
+    html,
+    url: resolvedUrl,
+    extracted,
+    profile: args.profile
+  })) {
+    throw toCompletedFallbackOutputError({
+      provider: args.provider,
+      source: SHOPPING_SOURCE,
+      url: resolvedUrl,
+      fallback,
+      outputReason: "empty_extracted_content"
+    });
+  }
   return {
     record: {
       status: 200,
       url: resolvedUrl,
-      html: readFallbackString(fallback.output, "html") ?? "",
+      html,
       browserFallback: toBrowserFallbackObservation(fallback)
     }
   };
@@ -8237,6 +8545,7 @@ var defaultFetcher = async ({ url, signal, provider, operation, context }) => {
       error,
       url,
       provider: providerId,
+      profile,
       operation,
       recoveryHints,
       context
@@ -8644,8 +8953,7 @@ var requiresBrowserAssistance = (profile, responseUrl, html) => {
   }
   return null;
 };
-var classifySearchPageIssue = (profile, fetched, extracted, content) => {
-  const providerShell = requiresBrowserAssistance(profile, fetched.url, fetched.html);
+var classifySearchPageIssue = (profile, fetched, extracted, content, providerShell = requiresBrowserAssistance(profile, fetched.url, fetched.html)) => {
   return classifyProviderIssue({
     url: fetched.url,
     title: providerShell?.title ?? (typeof extracted.metadata.title === "string" ? extracted.metadata.title : void 0),
@@ -8657,6 +8965,51 @@ var classifySearchPageIssue = (profile, fetched, extracted, content) => {
     retryable: true
   });
 };
+var toExplicitProviderShellIssue = (providerShell, content) => ({
+  reasonCode: "env_limited",
+  blockerType: "env_limited",
+  constraint: {
+    kind: "render_required",
+    evidenceCode: providerShell.reason,
+    providerShell: providerShell.reason,
+    ...content ? { message: content } : {}
+  }
+});
+var ensureProviderShellIssue = (issue, providerShell, content) => {
+  if (!issue || issue.reasonCode === "env_limited" && !issue.constraint) {
+    return toExplicitProviderShellIssue(providerShell, content);
+  }
+  return issue;
+};
+var toShoppingPageIssueMessage = (reasonCode, url) => {
+  if (reasonCode === "token_required") return `Authentication required for ${url}`;
+  if (reasonCode === "env_limited") return `Browser assistance required for ${url}`;
+  return `Detected anti-bot challenge while retrieving ${url}`;
+};
+var throwShoppingPageIssue = (args) => {
+  const reasonCode = args.pageIssue.reasonCode;
+  throw new ProviderRuntimeError(
+    providerErrorCodeFromReasonCode(reasonCode),
+    toShoppingPageIssueMessage(reasonCode, args.fetched.url),
+    {
+      provider: args.providerId,
+      source: SHOPPING_SOURCE,
+      retryable: reasonCode === "env_limited",
+      reasonCode,
+      details: {
+        ...applyProviderIssueHint({
+          status: args.fetched.status,
+          url: args.fetched.url,
+          ...typeof args.extracted.metadata.title === "string" ? { title: args.extracted.metadata.title } : {},
+          ...args.content ? { message: args.content } : {},
+          ...args.providerShell?.reason ? { providerShell: args.providerShell.reason } : {}
+        }, args.pageIssue),
+        ...args.providerShell?.reason ? { browserRequired: true } : {},
+        ...browserFallbackObservationDetails(args.fetched.browserFallback)
+      }
+    }
+  );
+};
 var unwrapTrackingUrl = (url, profile) => {
   const normalizedUrl = decodeHrefValue(url);
   try {
@@ -9054,6 +9407,7 @@ var createDefaultSearch = (profile, providerId, fetcher) => async (input, contex
     context
   });
   const extracted = extractStructuredContent(fetched.html, fetched.url);
+  const providerShell = requiresBrowserAssistance(profile, fetched.url, fetched.html);
   const limit = Math.max(1, Math.min(input.limit ?? 10, 20));
   const links = dedupeLinks(
     extracted.links.filter((link) => isLikelyProductUrl(canonicalizeUrl(link), profile)),
@@ -9061,7 +9415,17 @@ var createDefaultSearch = (profile, providerId, fetcher) => async (input, contex
   );
   const content = toSnippet(extracted.text, 2e3);
   const candidates = extractSearchCandidates(fetched.html, fetched.url, profile, limit);
-  const pageIssue = candidates.length === 0 ? classifySearchPageIssue(profile, fetched, extracted, content) : null;
+  const pageIssue = providerShell ? classifySearchPageIssue(profile, fetched, extracted, content, providerShell) : candidates.length === 0 ? classifySearchPageIssue(profile, fetched, extracted, content, providerShell) : null;
+  if (providerShell) {
+    throwShoppingPageIssue({
+      providerId,
+      fetched,
+      extracted,
+      content,
+      pageIssue: ensureProviderShellIssue(pageIssue, providerShell, content),
+      providerShell
+    });
+  }
   if (candidates.length > 0) {
     return candidates.map((candidate, index) => ({
       url: candidate.url,
@@ -9096,28 +9460,7 @@ var createDefaultSearch = (profile, providerId, fetcher) => async (input, contex
     }));
   }
   if (pageIssue && (pageIssue.reasonCode !== "env_limited" || pageIssue.constraint)) {
-    const reasonCode = pageIssue.reasonCode;
-    const providerShell = requiresBrowserAssistance(profile, fetched.url, fetched.html);
-    throw new ProviderRuntimeError(
-      providerErrorCodeFromReasonCode(reasonCode),
-      reasonCode === "token_required" ? `Authentication required for ${fetched.url}` : `Detected anti-bot challenge while retrieving ${fetched.url}`,
-      {
-        provider: providerId,
-        source: SHOPPING_SOURCE,
-        retryable: reasonCode === "env_limited",
-        reasonCode,
-        details: {
-          ...applyProviderIssueHint({
-            status: fetched.status,
-            url: fetched.url,
-            ...typeof extracted.metadata.title === "string" ? { title: extracted.metadata.title } : {},
-            ...content ? { message: content } : {},
-            ...providerShell?.reason ? { providerShell: providerShell.reason } : {}
-          }, pageIssue),
-          ...browserFallbackObservationDetails(fetched.browserFallback)
-        }
-      }
-    );
+    throwShoppingPageIssue({ providerId, fetched, extracted, content, pageIssue, providerShell });
   }
   const rows = [
     {
@@ -10023,7 +10366,13 @@ var design_contract_v1_default = {
       "section reveal",
       "primary CTA feedback"
     ],
-    parallaxPolicy: "off unless explicitly justified"
+    parallaxPolicy: "off unless explicitly justified",
+    advancedMotionAdvisory: [
+      "Advisory shader-like gradient depth: describe intent only; implement with approved runtime primitives unless a separate runtime change authorizes more.",
+      "Advisory WebGL-style spatial reveal: document depth and hierarchy without implying WebGL runtime support.",
+      "Advisory Spline-style product orbit: document scene posture and static fallback without approving custom 3D runtime dependencies.",
+      "Runtime boundary: libraryPolicy.motion and libraryPolicy.threeD stay empty unless separately approved."
+    ]
   },
   performanceModel: {
     renderHotspots: [
@@ -10116,6 +10465,14 @@ var design_contract_v1_default = {
         "spinner-stacking",
         "scan-surface-jank"
       ]
+    },
+    designVectors: {
+      advancedMotionAdvisory: [
+        "Advisory shader-like gradient depth",
+        "Advisory WebGL-style spatial reveal",
+        "Advisory Spline-style product orbit",
+        "Runtime support: none. Library policy authorization: none."
+      ]
     }
   }
 };
@@ -10159,6 +10516,172 @@ var INSPIREDESIGN_HANDOFF_GUIDANCE = {
   prepareCanvasPlanRequest: `Fill canvasSessionId, leaseId, and documentId in ${INSPIREDESIGN_HANDOFF_FILES.canvasPlanRequest} before running ${INSPIREDESIGN_HANDOFF_COMMANDS.continueInCanvas}.`,
   deepCaptureRecommendation: "Any inspiredesign run with reference URLs already uses captureMode=deep. Rerun with the same URLs only when you need refreshed DOM/layout evidence, restored session state, or capture-specific debugging."
 };
+var INSPIREDESIGN_ARTIFACT_GUIDE = {
+  [INSPIREDESIGN_HANDOFF_FILES.advancedBrief]: {
+    purpose: "Authoritative reference-first brief for the downstream design agent.",
+    expectedContents: ["Selected prompt format", "reference pattern board", "route guardrails"],
+    howToUse: ["Read first", "treat captured evidence as creative priority", "use guardrails to avoid route drift"],
+    mustNot: ["Do not treat defaults as stronger than captured references"]
+  },
+  [INSPIREDESIGN_HANDOFF_FILES.designMarkdown]: {
+    purpose: "Human-readable design specification and implementation narrative.",
+    expectedContents: ["inspiration analysis", "unified direction", "governance summary", "deliverables"],
+    howToUse: ["Use as the readable project brief", "cross-check implementation choices against its sections"],
+    mustNot: ["Do not use prose as a substitute for the JSON contract when patching Canvas"]
+  },
+  [INSPIREDESIGN_HANDOFF_FILES.designContract]: {
+    purpose: "Narrowed Canvas governance contract for design decisions.",
+    expectedContents: ["emitted governance blocks", "motion system", "library policy", "runtime budgets"],
+    howToUse: ["Patch only emitted governance blocks", "compare implementation against this contract before shipping"],
+    mustNot: ["Do not add navigation, async, or performance context as Canvas governance patches"]
+  },
+  [INSPIREDESIGN_HANDOFF_FILES.canvasPlanRequest]: {
+    purpose: "Ready-to-fill request payload for `canvas.plan.set`.",
+    expectedContents: ["request ids", "Canvas session ids", "mutation-safe generationPlan"],
+    howToUse: ["Fill canvasSessionId, leaseId, and documentId", "submit with the provided canvas.plan.set command"],
+    mustNot: ["Do not add handoff-only fields or reference-only analysis to generationPlan"]
+  },
+  [INSPIREDESIGN_HANDOFF_FILES.designAgentHandoff]: {
+    purpose: "Downstream index for artifact usage, skills, commands, and omitted implementation context.",
+    expectedContents: ["skills", "commands", "contract scope", "implementation context", "artifact and section guides"],
+    howToUse: ["Use as the navigation map for the bundle", "load recommended skills before implementation"],
+    mustNot: ["Do not treat handoff context as runtime Canvas schema"]
+  },
+  [INSPIREDESIGN_HANDOFF_FILES.generationPlan]: {
+    purpose: "Full generated plan for reasoning about design intent.",
+    expectedContents: ["Canvas plan fields", "design vectors", "reference analysis when available"],
+    howToUse: ["Use for agent reasoning and audit traceability", "compare with canvas-plan.request.json for runtime subset"],
+    mustNot: ["Do not submit this file directly to Canvas when it contains non-request context"]
+  },
+  [INSPIREDESIGN_HANDOFF_FILES.implementationPlanMarkdown]: {
+    purpose: "Human-readable engineering sequence for the first implementation pass.",
+    expectedContents: ["build sequence", "component plan", "token strategy", "QA and risk checks"],
+    howToUse: ["Convert sections into implementation tasks", "keep tests and browser validation aligned to the plan"],
+    mustNot: ["Do not implement sections unsupported by brief or reference evidence"]
+  },
+  [INSPIREDESIGN_HANDOFF_FILES.implementationPlan]: {
+    purpose: "Machine-readable implementation plan matching the Markdown plan.",
+    expectedContents: ["architecture steps", "component inventory", "state and validation tasks"],
+    howToUse: ["Use for structured task extraction", "keep it synchronized with implementation-plan.md"],
+    mustNot: ["Do not treat it as a Canvas document patch payload"]
+  },
+  [INSPIREDESIGN_HANDOFF_FILES.evidence]: {
+    purpose: "Evidence digest for brief, reference, capture, and design-vector provenance.",
+    expectedContents: ["brief expansion", "reference outcomes", "capture attempts", "design vectors"],
+    howToUse: ["Audit why choices were made", "prefer evidence over generic template defaults"],
+    mustNot: ["Do not ignore failed or skipped capture statuses when judging confidence"]
+  },
+  [INSPIREDESIGN_HANDOFF_FILES.prototypeGuidance]: {
+    purpose: "Optional first prototype guidance when the workflow requests prototype output.",
+    expectedContents: ["prototype structure", "design-vector guidance", "browser proof checklist"],
+    howToUse: ["Use only for the first prototype pass", "promote proven ideas back into contract-aligned work"],
+    mustNot: ["Do not treat prototype guidance as final implementation authority"]
+  }
+};
+var INSPIREDESIGN_CONTRACT_SECTION_GUIDE = {
+  intent: {
+    purpose: "Define why the design exists and what success means.",
+    expectedContents: ["audience", "task", "success criteria", "trust posture"],
+    howToUse: ["Validate the primary user job before styling", "reject sections that do not serve the task"],
+    mustNot: ["Do not start visual polish before the audience and task are clear"]
+  },
+  generationPlan: {
+    purpose: "Mutation-safe subset accepted by Canvas planning.",
+    expectedContents: ["target outcome", "visual, layout, content, component, motion, responsive, accessibility posture"],
+    howToUse: ["Submit only through canvas-plan.request.json", "repair generationPlanIssues before mutation"],
+    mustNot: ["Do not add handoff-only guide fields to the Canvas generation plan"]
+  },
+  designLanguage: {
+    purpose: "Name the coherent visual direction and token ownership.",
+    expectedContents: ["direction", "style axes", "semantic token source", "approved libraries"],
+    howToUse: ["Keep one design language per task", "align repeated components to semantic tokens"],
+    mustNot: ["Do not mix unrelated visual families inside one surface"]
+  },
+  contentModel: {
+    purpose: "Define real content, message hierarchy, and UI states.",
+    expectedContents: ["primary message", "supporting messages", "states", "loading, empty, and error behavior"],
+    howToUse: ["Use real content first", "plan non-happy-path states before polish"],
+    mustNot: ["Do not ship placeholder copy as product content"]
+  },
+  layoutSystem: {
+    purpose: "Describe page architecture and section rhythm.",
+    expectedContents: ["grid", "containers", "spacing rhythm", "alignment rules"],
+    howToUse: ["Use to place sections and scan units consistently", "verify desktop and mobile structure"],
+    mustNot: ["Do not invent one-off layout rules for repeated sections"]
+  },
+  typographySystem: {
+    purpose: "Define type families, scale, measure, and loading behavior.",
+    expectedContents: ["families", "scale", "measure", "fallback policy", "loading strategy"],
+    howToUse: ["Apply type hierarchy consistently", "avoid layout shift from font loading"],
+    mustNot: ["Do not default to unapproved system stacks for a distinctive design"]
+  },
+  colorSystem: {
+    purpose: "Define semantic color roles and theme behavior.",
+    expectedContents: ["primary roles", "surface roles", "text roles", "state colors"],
+    howToUse: ["Map repeated UI to semantic tokens", "validate contrast in every required theme"],
+    mustNot: ["Do not scatter raw color values across leaf components"]
+  },
+  surfaceSystem: {
+    purpose: "Define material, depth, borders, and background behavior.",
+    expectedContents: ["surface hierarchy", "border rules", "shadow rules", "material effects"],
+    howToUse: ["Use depth only to clarify hierarchy", "align material effects with design vectors"],
+    mustNot: ["Do not turn every content group into a card by default"]
+  },
+  iconSystem: {
+    purpose: "Define icon usage and decorative asset boundaries.",
+    expectedContents: ["icon family", "stroke policy", "labeling rules", "decorative rules"],
+    howToUse: ["Use icons to clarify actions", "keep accessible names on icon-only controls"],
+    mustNot: ["Do not rely on icons as the only explanation for critical actions"]
+  },
+  motionSystem: {
+    purpose: "Define motion that supports comprehension.",
+    expectedContents: ["timing", "interaction moments", "reduced-motion posture", "advanced motion advisory"],
+    howToUse: ["Keep shader, WebGL, and Spline cues advisory", "provide reduced-motion replacements"],
+    mustNot: ["Do not use motion cues to authorize new runtime libraries"]
+  },
+  responsiveSystem: {
+    purpose: "Define authored behavior across desktop, tablet, and mobile.",
+    expectedContents: ["breakpoints", "adaptation rules", "touch policy", "overflow policy"],
+    howToUse: ["Validate the primary action at every viewport", "collapse structure before copy becomes cramped"],
+    mustNot: ["Do not assume desktop layouts naturally scale down"]
+  },
+  accessibilityPolicy: {
+    purpose: "Set accessibility requirements before implementation.",
+    expectedContents: ["WCAG target", "keyboard requirements", "focus policy", "semantic requirements"],
+    howToUse: ["Block release on contrast or keyboard regressions", "validate focus on every interactive state"],
+    mustNot: ["Do not defer accessibility until after visual implementation"]
+  },
+  libraryPolicy: {
+    purpose: "Declare approved implementation libraries and runtime boundaries.",
+    expectedContents: ["components", "icons", "styling", "motion", "threeD"],
+    howToUse: ["Use as the dependency authorization boundary", "keep motion and threeD empty unless separately approved"],
+    mustNot: ["Do not infer WebGL, shader, Spline, or 3D runtime support from advisory motion"]
+  },
+  runtimeBudgets: {
+    purpose: "Set practical limits for sections, actions, interaction latency, and preview cost.",
+    expectedContents: ["section budgets", "action budgets", "latency budgets", "preview notes"],
+    howToUse: ["Use as a constraint during implementation", "validate slow or animation-heavy surfaces against it"],
+    mustNot: ["Do not add decorative weight that violates the budget"]
+  },
+  navigationModel: {
+    purpose: "Implementation-only context for route, tab, overlay, and deep-link ownership.",
+    expectedContents: ["route owner", "deep-link policy", "invalid route fallback", "overlay entry points"],
+    howToUse: ["Use from design-agent-handoff.json when wiring implementation state"],
+    mustNot: ["Do not patch this omitted block into Canvas governance"]
+  },
+  asyncModel: {
+    purpose: "Implementation-only context for loading, restart, cancellation, and URL-owned query state.",
+    expectedContents: ["owner", "load trigger", "restart triggers", "cancellation policy"],
+    howToUse: ["Use when wiring fetch/search state and stale-request handling"],
+    mustNot: ["Do not let components invent independent async ownership"]
+  },
+  performanceModel: {
+    purpose: "Implementation-only context for render hotspots and measurement posture.",
+    expectedContents: ["render hotspots", "stable identity policy", "list strategy", "measurement plan"],
+    howToUse: ["Use before building scan-heavy or motion-heavy surfaces"],
+    mustNot: ["Do not ship heavy interaction surfaces without measurement evidence"]
+  }
+};
 var buildInspiredesignFollowthroughSummary = () => `Read ${INSPIREDESIGN_HANDOFF_FILES.advancedBrief} first, then continue in OpenDevBrowser Canvas with ${INSPIREDESIGN_HANDOFF_FILES.canvasPlanRequest} and ${INSPIREDESIGN_HANDOFF_FILES.designAgentHandoff}, load ${INSPIREDESIGN_HANDOFF_RECOMMENDED_SKILLS[0]} plus ${INSPIREDESIGN_HANDOFF_RECOMMENDED_SKILLS[1]} before implementation, and note that any supplied reference URL already uses captureMode=deep.`;
 var buildInspiredesignNextStep = () => `Read ${INSPIREDESIGN_HANDOFF_FILES.advancedBrief} first. ${INSPIREDESIGN_HANDOFF_GUIDANCE.prepareCanvasPlanRequest} Then run ${INSPIREDESIGN_HANDOFF_COMMANDS.continueInCanvas}, confirm planStatus=accepted, then patch only the governance blocks listed in ${INSPIREDESIGN_HANDOFF_FILES.designAgentHandoff}.`;
 
@@ -10169,11 +10692,14 @@ var inspiredesign_advanced_brief_v1_default = {
   commonRules: [
     "Preserve only the product, brand, audience, platform, and tone cues that are explicitly present in the source brief.",
     "Treat missing details as open constraints instead of inventing brand facts or user needs.",
-    "Use inspiration references to extract transferable design logic rather than copying a single layout, visual treatment, or narrative beat literally."
+    "Use inspiration references to extract transferable design logic rather than copying a single layout, visual treatment, or narrative beat literally.",
+    "Treat shader, WebGL, Spline-style, and 3D motion ideas as advisory design cues only, not as runtime support or dependency approval.",
+    "Carry accepted advanced motion cues in designVectors and motionSystem as intent, and keep libraryPolicy authorization separate."
   ],
   outputRequirements: [
     "Return a reusable design contract that can drive design.md, implementation-plan artifacts, and a Canvas-ready prototype path.",
-    "Keep the direction premium, specific, and implementable instead of generic or template-driven."
+    "Keep the direction premium, specific, and implementable instead of generic or template-driven.",
+    "Keep libraryPolicy.motion and libraryPolicy.threeD empty in generated samples unless a separate runtime change explicitly approves those libraries."
   ],
   formats: [
     {
@@ -11765,6 +12291,13 @@ var expandInspiredesignBrief = (brief, preferredFormatId) => {
 var SIGNAL_LIMIT = 5;
 var SIGNAL_CLIP = 180;
 var PATTERN_LIMIT = 6;
+var ADVANCED_MOTION_FIELDS = [
+  "Advisory shader-style gradients: specify effect type, uniforms, static fallback, and reduced-motion replacement as design language only.",
+  "Advisory WebGL-style depth cues: describe layered depth, camera-like parallax, and spatial hierarchy without requiring WebGL runtime.",
+  "Advisory Spline-style staging: describe object-like hero composition, scene count, camera posture, depth model, asset source, and spatial sequencing as implementation guidance only.",
+  "Advanced motion performance policy: define frame budget, lazy loading, offscreen pause behavior, and vestibular risk before implementation.",
+  "Runtime boundary: implement with approved CSS and Canvas-safe primitives unless explicit source-owned runtime support is added later."
+];
 var trimText = (value) => value.trim().replace(/\s+/g, " ");
 var clipText = (value, maxLength) => {
   if (value.length <= maxLength) return value;
@@ -12125,6 +12658,7 @@ var buildInspiredesignDesignVectors = (format, board) => {
     interactionDensity: buildInteractionDensity(format, board),
     interactionMoments: buildInteractionMoments(format, board),
     materialEffects: buildMaterialEffects(board),
+    advancedMotionAdvisory: [...ADVANCED_MOTION_FIELDS],
     referenceInfluence: influence,
     patternsToBorrow: board.references.flatMap((entry) => entry.patternsToBorrow).slice(0, 8),
     patternsToReject: board.references.flatMap((entry) => entry.patternsToReject).slice(0, 8),
@@ -12512,7 +13046,8 @@ var renderReferenceFirstAdvancedBrief = (briefExpansion, board, vectors, referen
       `motionPosture: ${vectors.motionPosture.join(" ")}`,
       `sectionArchitecture: ${vectors.sectionArchitecture.join(" ")}`,
       `interactionMoments: ${vectors.interactionMoments.join(" ")}`,
-      `materialEffects: ${vectors.materialEffects.join(" ")}`
+      `materialEffects: ${vectors.materialEffects.join(" ")}`,
+      `advancedMotionAdvisory: ${vectors.advancedMotionAdvisory.join(" ")}`
     ]),
     "",
     "Fixed format guardrails:",
@@ -12598,7 +13133,8 @@ var summarizeDesignVectors = (designVectors) => [
   `sections: ${designVectors.sectionArchitecture.join(" ")}`,
   `motion: ${designVectors.motionPosture.slice(0, 1).join(" ")}`,
   `interactions: ${designVectors.interactionMoments.slice(0, 1).join(" ")}`,
-  `materials: ${designVectors.materialEffects.slice(0, 1).join(" ")}`
+  `materials: ${designVectors.materialEffects.slice(0, 1).join(" ")}`,
+  `advancedMotion: ${designVectors.advancedMotionAdvisory.slice(0, 1).join(" ")}`
 ].join(" ");
 var isReferenceFirstPublicLanding = (designVectors) => {
   return designVectors.sourcePriority === "reference-evidence-first" && designVectors.surfaceIntent.toLowerCase().includes("public landing page");
@@ -12620,20 +13156,244 @@ var buildEvidenceDerivedFormat = (format, designVectors) => {
     }
   };
 };
-var buildGenerationPlan = ({
+var TARGET_KIND_ORDER = ["page", "component", "asset"];
+var TARGET_CONFIDENCE = {
+  defaultPage: 0.55,
+  pageIntentStep: 0.05,
+  nonPageBase: 0.55,
+  intentStep: 0.08,
+  supportingStep: 0.05,
+  maxPage: 0.7,
+  maxNonPage: 0.95
+};
+var TARGET_SIGNAL_PROFILES = {
+  page: {
+    intent: ["page", "landing page", "website", "homepage", "dashboard", "workspace", "screen", "flow", "surface", "microsite"],
+    supporting: ["section", "sections", "navigation", "footer", "hero section", "conversion flow"],
+    incidental: ["card", "cards", "button", "buttons", "image", "images", "media", "hero", "cta", "background"]
+  },
+  component: {
+    intent: ["component", "component family", "reusable component", "component prototype", "hero component", "card component", "storybook"],
+    supporting: ["prop", "props", "slot", "slots", "variant", "variants", "state matrix", "hover", "focus", "disabled", "loading", "error", "fixture", "fixtures", "arg", "args"],
+    incidental: ["card", "cards", "button", "buttons", "form", "modal", "drawer", "navbar", "hero", "input", "tabs", "cta"]
+  },
+  asset: {
+    intent: ["asset", "asset pack", "visual asset", "icon pack", "logo pack", "illustration set", "artwork set"],
+    supporting: ["responsive variant", "responsive variants", "responsive artwork", "provenance", "usage rules", "alt text", "replacement rules", "tokenized usage", "source asset", "source assets"],
+    incidental: ["icon", "icons", "illustration", "illustrations", "logo", "logos", "media", "image", "images", "background", "texture", "sprite", "artwork"]
+  }
+};
+var buildTargetCorpus = (brief, references, synthesis) => [
   brief,
-  format,
-  synthesis,
-  referencePatternBoard,
-  designVectors
-}) => {
-  const plan = cloneTemplate(BASE_GENERATION_PLAN);
-  const profile = format.route.profile;
-  const vectorSummary = summarizeDesignVectors(designVectors);
-  plan.targetOutcome.summary = clipText2(
-    `${summarizeBrief(brief)} Reference cues: ${synthesis.summary} ${vectorSummary}`,
-    GENERATION_PLAN_REFERENCE_CLIP_LENGTH
-  );
+  synthesis.lines.join(" "),
+  ...references.filter(hasInspiredesignUsableReferenceEvidence).flatMap((reference) => getInspiredesignReferenceSignals(reference))
+].join(" ").toLowerCase();
+var escapeRegex = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+var matchesTargetSignal = (corpus, signal) => {
+  const pattern = escapeRegex(signal.toLowerCase()).replace(/\s+/g, "\\s+");
+  return new RegExp(`(^|[^a-z0-9])${pattern}([^a-z0-9]|$)`).test(corpus);
+};
+var findTargetSignalIndex = (corpus, signal) => {
+  const pattern = escapeRegex(signal.toLowerCase()).replace(/\s+/g, "\\s+");
+  return new RegExp(`(^|[^a-z0-9])${pattern}([^a-z0-9]|$)`).exec(corpus)?.index ?? null;
+};
+var findFirstBriefTargetKind = (brief) => {
+  const corpus = brief.toLowerCase();
+  const hits = TARGET_KIND_ORDER.flatMap((kind) => TARGET_SIGNAL_PROFILES[kind].intent.map((signal) => findTargetSignalIndex(corpus, signal)).filter((index) => index !== null).map((index) => ({ kind, index })));
+  return hits.sort((left, right) => left.index - right.index)[0]?.kind ?? null;
+};
+var collectTargetSignals = (corpus) => {
+  const collect = (kind) => {
+    const profile = TARGET_SIGNAL_PROFILES[kind];
+    return {
+      intent: profile.intent.filter((signal) => matchesTargetSignal(corpus, signal)),
+      supporting: profile.supporting.filter((signal) => matchesTargetSignal(corpus, signal)),
+      incidental: profile.incidental.filter((signal) => matchesTargetSignal(corpus, signal))
+    };
+  };
+  return {
+    page: collect("page"),
+    component: collect("component"),
+    asset: collect("asset")
+  };
+};
+var clampTargetConfidence = (value, max) => Math.min(max, Number(value.toFixed(2)));
+var buildPageConfidence = (signals) => {
+  return clampTargetConfidence(
+    TARGET_CONFIDENCE.defaultPage + signals.intent.length * TARGET_CONFIDENCE.pageIntentStep,
+    TARGET_CONFIDENCE.maxPage
+  );
+};
+var buildTargetEligibility = (kind, briefSignals, supportSignals) => {
+  const eligible = briefSignals.intent.length > 0 && supportSignals.supporting.length > 0;
+  const confidence = eligible ? clampTargetConfidence(
+    TARGET_CONFIDENCE.nonPageBase + briefSignals.intent.length * TARGET_CONFIDENCE.intentStep + supportSignals.supporting.length * TARGET_CONFIDENCE.supportingStep,
+    TARGET_CONFIDENCE.maxNonPage
+  ) : 0;
+  return {
+    kind,
+    eligible,
+    confidence,
+    triggeringSignals: [
+      ...briefSignals.intent.map((signal) => `${kind} intent: ${signal}`),
+      ...supportSignals.supporting.map((signal) => `${kind} support: ${signal}`)
+    ]
+  };
+};
+var choosePrimaryTargetKind = (pageConfidence, pageSignals, firstBriefTargetKind, component, asset) => {
+  const eligibleTargets = [component, asset].filter((target) => target.eligible);
+  if (eligibleTargets.length === 0) return { primaryKind: "page", reason: "no_non_page_gate" };
+  if (firstBriefTargetKind === "page" && pageSignals.intent.length > 0) {
+    return { primaryKind: "page", reason: "page_first_brief_target" };
+  }
+  const [first, second] = eligibleTargets.sort((left, right) => right.confidence - left.confidence);
+  if (!first || first.confidence <= pageConfidence) {
+    return { primaryKind: "page", reason: "non_page_did_not_beat_page" };
+  }
+  if (second && first.confidence === second.confidence && pageSignals.intent.length > 0) {
+    return { primaryKind: "page", reason: "page_tie_break" };
+  }
+  return { primaryKind: first.kind, reason: "non_page_selected" };
+};
+var chooseTargetKinds = (primaryKind, component, asset) => {
+  if (primaryKind === "page") return ["page"];
+  const eligible = new Set([component, asset].filter((target) => target.eligible).map((target) => target.kind));
+  const secondaryKinds = TARGET_KIND_ORDER.filter((kind) => kind !== primaryKind && eligible.has(kind));
+  return [primaryKind, ...secondaryKinds];
+};
+var buildTriggeringSignals = (decision, signals, component, asset) => {
+  const pageSignals = signals.page.intent.map((signal) => `page intent: ${signal}`);
+  const eligibleTargets = [component, asset].filter((target) => target.eligible);
+  const targetIntents = eligibleTargets.flatMap((target) => target.triggeringSignals.filter((signal) => signal.includes(" intent: ")));
+  const targetSupport = eligibleTargets.flatMap((target) => target.triggeringSignals.filter((signal) => signal.includes(" support: ")));
+  const defaultSignal = decision.primaryKind === "page" ? [buildPageDecisionSignal(decision.reason)] : [];
+  return [...pageSignals, ...targetIntents, ...targetSupport, ...defaultSignal].slice(0, 12);
+};
+var buildPageDecisionSignal = (reason) => {
+  if (reason === "no_non_page_gate") return "page default: non-page targets did not clear brief intent plus support gates";
+  if (reason === "non_page_did_not_beat_page") return "page default: non-page targets did not beat page confidence";
+  if (reason === "page_first_brief_target") return "page default: page was the first explicit target in the brief";
+  if (reason === "page_tie_break") return "page default: page intent won a tied non-page confidence score";
+  return "page default: page selected";
+};
+var getTargetConfidence = (primaryKind, pageConfidence, component, asset) => {
+  if (primaryKind === "component") return component.confidence;
+  if (primaryKind === "asset") return asset.confidence;
+  return pageConfidence;
+};
+var buildTargetEvidenceBuckets = (primaryKind, format, designVectors) => ({
+  anatomy: [`Map ${primaryKind} anatomy before styling: root, content hierarchy, interaction zones, and supporting regions.`],
+  propsSlots: [`Define props/slots from ${format.componentGrammar}; separate data props, content slots, and visual variant controls.`],
+  stateMatrix: ["Cover default, hover, focus, active, disabled, loading, empty, error, success, and selected where relevant."],
+  tokens: [`Resolve typography, color, spacing, radius, shadow, motion, and z-index through semantic tokens for ${format.paletteIntent}.`],
+  assets: [`Inventory source assets, derived assets, usage rights, responsive variants, and replacement notes for ${primaryKind} prototypes.`],
+  accessibility: ["Validate keyboard order, visible focus, accessible names, ARIA pattern fit, contrast, and WCAG 2.2 states."],
+  motion: [`Use ${format.motionGrammar}; include reduced-motion alternatives for ${designVectors.motionPosture.join(" ") || "all transitions"}.`],
+  previewFixtures: [`Build isolated preview fixtures for ${primaryKind} default, responsive, reduced-motion, and failure states.`]
+});
+var buildComponentTargetAnalysis = (briefHash, format) => ({
+  canvasType: "CanvasComponentInventoryItem",
+  inventoryItems: [{
+    id: `component_${briefHash}`,
+    name: `${format.label} Component`,
+    componentName: `${format.route.profile.replace(/-/g, "")}PrototypeComponent`,
+    description: `Reusable component prototype derived from ${format.componentGrammar}.`,
+    sourceFamily: "framework_component",
+    origin: "code_sync",
+    variants: [{
+      id: "default",
+      name: "Default",
+      selector: { interaction: "default" },
+      description: "Default preview fixture.",
+      metadata: {}
+    }],
+    props: [
+      { name: "variant", type: "string", required: false, description: "Visual variant key.", metadata: {} },
+      { name: "state", type: "string", required: false, description: "Interaction state fixture.", metadata: {} }
+    ],
+    slots: [
+      { name: "media", description: "Optional visual or icon slot.", allowedKinds: ["asset", "image", "icon"], metadata: {} },
+      { name: "content", description: "Primary text or rich content slot.", allowedKinds: ["text", "rich-text"], metadata: {} }
+    ],
+    events: [{ name: "onPrimaryAction", description: "Primary interaction callback.", payloadShape: {}, metadata: {} }],
+    content: { acceptsText: true, acceptsRichText: true, slotNames: ["media", "content"], metadata: {} },
+    metadata: { targetKind: "component" }
+  }],
+  prototypeGuidance: [
+    "Component prototype target: document anatomy, props/slots, variant rules, and interaction state fixtures before page composition.",
+    "Use Storybook-style args and interaction checks when converting this guidance into executable component previews."
+  ]
+});
+var buildAssetTargetAnalysis = (briefHash) => ({
+  canvasType: "CanvasAsset",
+  assets: [{
+    id: `asset_${briefHash}`,
+    sourceType: "page-derived",
+    kind: "visual-asset",
+    url: null,
+    status: "needs-production-source",
+    provenanceNotes: ["Derived from brief/reference evidence; recreate rather than copy proprietary source assets."],
+    usageNotes: ["Define responsive variants, token usage, alt text, and replacement rules before implementation."],
+    metadata: { targetKind: "asset" }
+  }],
+  prototypeGuidance: [
+    "Asset prototype target: catalog provenance, variants, token usage, responsive behavior, and replacement rules.",
+    "Pair each visual asset with preview fixtures for default, high contrast, and reduced-motion contexts when relevant."
+  ]
+});
+var buildPageTargetAnalysis = (format, designVectors) => ({
+  canvasType: "CanvasPage",
+  assemblyFocus: [
+    format.layoutArchetype,
+    ...designVectors.sectionArchitecture
+  ],
+  implementationNotes: [
+    "Page prototype target: validate section order, navigation model, CTA visibility, responsive collapse, and reduced-motion behavior.",
+    "Use component primitives before page-specific wrappers."
+  ]
+});
+var buildTargetAnalysis = (brief, format, references, synthesis, designVectors) => {
+  const briefSignals = collectTargetSignals(brief.toLowerCase());
+  const supportSignals = collectTargetSignals(buildTargetCorpus(brief, references, synthesis));
+  const pageConfidence = buildPageConfidence(briefSignals.page);
+  const component = buildTargetEligibility("component", briefSignals.component, supportSignals.component);
+  const asset = buildTargetEligibility("asset", briefSignals.asset, supportSignals.asset);
+  const decision = choosePrimaryTargetKind(
+    pageConfidence,
+    briefSignals.page,
+    findFirstBriefTargetKind(brief),
+    component,
+    asset
+  );
+  const primaryKind = decision.primaryKind;
+  const kinds = chooseTargetKinds(primaryKind, component, asset);
+  const briefHash = referenceFingerprint(brief);
+  return {
+    primaryKind,
+    kinds,
+    confidence: getTargetConfidence(primaryKind, pageConfidence, component, asset),
+    triggeringSignals: buildTriggeringSignals(decision, briefSignals, component, asset),
+    evidenceBuckets: buildTargetEvidenceBuckets(primaryKind, format, designVectors),
+    ...kinds.includes("page") ? { page: buildPageTargetAnalysis(format, designVectors) } : {},
+    ...kinds.includes("component") ? { component: buildComponentTargetAnalysis(briefHash, format) } : {},
+    ...kinds.includes("asset") ? { asset: buildAssetTargetAnalysis(briefHash) } : {}
+  };
+};
+var buildGenerationPlan = ({
+  brief,
+  format,
+  synthesis,
+  referencePatternBoard,
+  designVectors,
+  targetAnalysis
+}) => {
+  const plan = cloneTemplate(BASE_GENERATION_PLAN);
+  const profile = format.route.profile;
+  const vectorSummary = summarizeDesignVectors(designVectors);
+  plan.targetOutcome.summary = clipText2(
+    `${summarizeBrief(brief)} Reference cues: ${synthesis.summary} ${vectorSummary}`,
+    GENERATION_PLAN_REFERENCE_CLIP_LENGTH
+  );
   plan.visualDirection.profile = profile;
   plan.visualDirection.themeStrategy = format.route.themeStrategy;
   plan.layoutStrategy.approach = format.route.layoutApproach;
@@ -12652,6 +13412,7 @@ var buildGenerationPlan = ({
     ...plan,
     referencePatternBoard,
     designVectors,
+    targetAnalysis,
     interactionMoments: [...designVectors.interactionMoments],
     materialEffects: [...designVectors.materialEffects]
   };
@@ -12770,6 +13531,8 @@ var buildMotionSystemBlock = (format, designVectors) => {
     posture: [...designVectors.motionPosture],
     interactionMoments: [...designVectors.interactionMoments],
     materialEffects: [...designVectors.materialEffects],
+    advancedMotionAdvisory: [...designVectors.advancedMotionAdvisory],
+    advancedMotionRuntimePolicy: "Advanced motion fields are advisory contract metadata only and do not authorize shader, WebGL, Spline, R3F, Pixi, Babylon, or GLSL runtime support.",
     parallaxPolicy: "Use parallax only as a restrained hierarchy cue and remove transform-based depth for reduced-motion users.",
     hoverPolicy: "Hover effects must clarify clickability without becoming the only visible affordance.",
     cursorPolicy: "Cursor effects are allowed only on premium hero or CTA moments and must not interfere with reading or form controls.",
@@ -12803,7 +13566,7 @@ var buildLibraryPolicyBlock = () => ({
   components: ["shadcn"],
   icons: ["tabler"],
   styling: ["tailwindcss"],
-  motion: ["css"],
+  motion: [],
   threeD: []
 });
 var buildRuntimeBudgetsBlock = (plan) => ({
@@ -12893,10 +13656,13 @@ var buildFollowthrough = ({
   synthesis,
   includePrototypeGuidance,
   referencePatternBoard,
-  designVectors
+  designVectors,
+  targetAnalysis
 }) => ({
   summary: buildInspiredesignFollowthroughSummary(),
   nextStep: buildInspiredesignNextStep(),
+  artifactGuide: INSPIREDESIGN_ARTIFACT_GUIDE,
+  contractSectionGuide: INSPIREDESIGN_CONTRACT_SECTION_GUIDE,
   briefExpansion: buildBriefExpansionMetadata(briefExpansion),
   recommendedSkills: [...INSPIREDESIGN_HANDOFF_RECOMMENDED_SKILLS],
   commandExamples: { ...INSPIREDESIGN_HANDOFF_COMMANDS },
@@ -12911,7 +13677,8 @@ var buildFollowthrough = ({
       cues: synthesis.lines
     },
     referencePatternBoard,
-    designVectors
+    designVectors,
+    targetAnalysis
   }
 });
 var buildDesignContract = ({
@@ -13015,6 +13782,7 @@ var buildImplementationPlan = ({
     ...designVectors.motionPosture,
     ...designVectors.interactionMoments,
     ...designVectors.materialEffects,
+    ...designVectors.advancedMotionAdvisory,
     "Implement hero entrance reveal, section scroll reveal, and CTA/focus feedback as the minimum motion system for landing pages.",
     "Use @media (prefers-reduced-motion: reduce) to preserve hierarchy without motion.",
     "Preserve layout during loading and keep transient confirmations out of the main flow.",
@@ -13237,7 +14005,32 @@ var renderImplementationMarkdown = (implementationPlan) => {
     implementationPlan.buildSequence.map((step, index) => `${index + 1}. ${step}`).join("\n")
   ].join("\n");
 };
-var renderPrototypeGuidance = (profile, synthesis, designVectors) => {
+var renderTargetAnalysisGuidance = (targetAnalysis) => {
+  const targetGuidance = [
+    ...targetAnalysis.page?.implementationNotes ?? [],
+    ...targetAnalysis.component?.prototypeGuidance ?? [],
+    ...targetAnalysis.asset?.prototypeGuidance ?? []
+  ];
+  return [
+    "## 6.3 Target Analysis",
+    formatBulletList2([
+      `primary target: ${targetAnalysis.primaryKind}`,
+      `target kinds: ${targetAnalysis.kinds.join(", ")}`,
+      `confidence: ${targetAnalysis.confidence.toFixed(2)}`,
+      `triggering signals: ${targetAnalysis.triggeringSignals.join("; ")}`,
+      ...targetGuidance,
+      `anatomy: ${targetAnalysis.evidenceBuckets.anatomy.join(" ")}`,
+      `props/slots: ${targetAnalysis.evidenceBuckets.propsSlots.join(" ")}`,
+      `state matrix: ${targetAnalysis.evidenceBuckets.stateMatrix.join(" ")}`,
+      `tokens: ${targetAnalysis.evidenceBuckets.tokens.join(" ")}`,
+      `assets: ${targetAnalysis.evidenceBuckets.assets.join(" ")}`,
+      `accessibility: ${targetAnalysis.evidenceBuckets.accessibility.join(" ")}`,
+      `motion: ${targetAnalysis.evidenceBuckets.motion.join(" ")}`,
+      `preview fixtures: ${targetAnalysis.evidenceBuckets.previewFixtures.join(" ")}`
+    ])
+  ].join("\n");
+};
+var renderPrototypeGuidance = (profile, synthesis, designVectors, targetAnalysis) => {
   return [
     "# 6. Optional Prototype Plan",
     "",
@@ -13252,6 +14045,10 @@ var renderPrototypeGuidance = (profile, synthesis, designVectors) => {
     `- interaction expectations: ${designVectors.interactionMoments.join(" ")}`,
     `- motion expectations: ${designVectors.motionPosture.join(" ")}`,
     `- material and depth expectations: ${designVectors.materialEffects.join(" ")}`,
+    `- advisory advanced motion: ${designVectors.advancedMotionAdvisory.join(" ")}`,
+    "",
+    renderTargetAnalysisGuidance(targetAnalysis),
+    "",
     "- browser proof: capture desktop and mobile browser screenshots, verify reduced-motion behavior, inspect focus states, and confirm the primary CTA remains visible without overlap.",
     "- HTML skeleton guidance: start with one main landmark, one primary CTA group, and semantic sections that follow the design vector section architecture instead of fixed industry-specific defaults.",
     "- styling approach: define CSS variables for timing, easing, elevation, translucency, backdrop blur, cursor effects, hover effects, and parallax distance before mapping components to semantic tokens.",
@@ -13280,7 +14077,8 @@ var buildEvidencePayload = ({
   urls,
   references,
   referencePatternBoard,
-  designVectors
+  designVectors,
+  targetAnalysis
 }) => ({
   brief,
   briefHash: referenceFingerprint(brief),
@@ -13294,7 +14092,8 @@ var buildEvidencePayload = ({
   referenceCount: references.length,
   references: references.map((reference) => toReferenceEvidenceJson(reference)),
   referencePatternBoard,
-  designVectors
+  designVectors,
+  targetAnalysis
 });
 var toCaptureEvidenceJson = (reference) => {
   const normalized = normalizeInspiredesignCaptureEvidence(reference.capture);
@@ -13336,6 +14135,13 @@ var buildInspiredesignPacket = (input) => {
   );
   const designVectors = buildInspiredesignDesignVectors(selectedFormat, referencePatternBoard);
   const effectiveFormat = buildEvidenceDerivedFormat(selectedFormat, designVectors);
+  const targetAnalysis = buildTargetAnalysis(
+    brief,
+    effectiveFormat,
+    references,
+    synthesis,
+    designVectors
+  );
   const effectiveBriefExpansion = {
     ...input.briefExpansion,
     advancedBrief: isReferenceFirstPublicLanding(designVectors) ? renderEvidenceDerivedAdvancedBrief(input.briefExpansion, effectiveFormat) : input.briefExpansion.advancedBrief,
@@ -13352,7 +14158,8 @@ var buildInspiredesignPacket = (input) => {
     format: effectiveFormat,
     synthesis,
     referencePatternBoard,
-    designVectors
+    designVectors,
+    targetAnalysis
   });
   const profile = generationPlan.visualDirection.profile;
   const canvasPlanRequest = buildCanvasPlanRequest(brief, generationPlan);
@@ -13369,7 +14176,8 @@ var buildInspiredesignPacket = (input) => {
     synthesis,
     includePrototypeGuidance,
     referencePatternBoard,
-    designVectors
+    designVectors,
+    targetAnalysis
   });
   const implementationPlan = buildImplementationPlan({
     profile,
@@ -13380,7 +14188,7 @@ var buildInspiredesignPacket = (input) => {
   });
   const governanceMarkdown = renderGovernanceMarkdown(designContract, implementationPlan, effectiveFormat);
   const implementationPlanMarkdown = renderImplementationMarkdown(implementationPlan);
-  const prototypeGuidanceMarkdown = includePrototypeGuidance ? renderPrototypeGuidance(profile, synthesis, designVectors) : null;
+  const prototypeGuidanceMarkdown = includePrototypeGuidance ? renderPrototypeGuidance(profile, synthesis, designVectors, targetAnalysis) : null;
   const designMarkdown = [
     "# 1. Executive Summary",
     "",
@@ -13416,7 +14224,8 @@ var buildInspiredesignPacket = (input) => {
       `motion posture: ${designVectors.motionPosture.join(" ")}`,
       `section architecture: ${designVectors.sectionArchitecture.join(" ")}`,
       `interaction moments: ${designVectors.interactionMoments.join(" ")}`,
-      `material effects: ${designVectors.materialEffects.join(" ")}`
+      `material effects: ${designVectors.materialEffects.join(" ")}`,
+      `advanced motion advisory: ${designVectors.advancedMotionAdvisory.join(" ")}`
     ]),
     "",
     "## 3.4 System Direction",
@@ -13462,11 +14271,167 @@ var buildInspiredesignPacket = (input) => {
       urls,
       references,
       referencePatternBoard,
-      designVectors
+      designVectors,
+      targetAnalysis
     })
   };
 };
 
+// src/providers/workflow-handoff.ts
+var PRODUCT_VIDEO_BRIEF_HELPER_PATH = "./skills/opendevbrowser-product-presentation-asset/scripts/render-video-brief.sh";
+var PRODUCT_VIDEO_BRIEF_HELPER_COMMAND = `${PRODUCT_VIDEO_BRIEF_HELPER_PATH} <pack>/manifest.json`;
+var createSuccessHandoff = (followthroughSummary, suggestedNextAction, suggestedSteps) => ({
+  followthroughSummary,
+  suggestedNextAction,
+  suggestedSteps
+});
+var cliExample = (command, args = "") => `npx opendevbrowser ${command}${args ? ` ${args}` : ""}`;
+var quoteCliValue = (value) => JSON.stringify(value);
+var buildResearchRerunCommand = (input) => cliExample(
+  "research run",
+  `--topic ${quoteCliValue(input.topic)} --days 14 --source-selection auto --sources web,community --browser-mode ${input.browserMode ?? "managed"} --mode json --output-format json`
+);
+var buildShoppingRerunCommand = (input) => {
+  const providers = input.providers?.length ? ` --providers ${input.providers.join(",")}` : " --providers shopping/bestbuy,shopping/ebay";
+  const budget = typeof input.budget === "number" ? ` --budget ${input.budget}` : "";
+  const region = input.region ? ` --region ${quoteCliValue(input.region)}` : "";
+  const browserMode = ` --browser-mode ${input.browserMode ?? "managed"}`;
+  const sort = input.sort ? ` --sort ${input.sort}` : "";
+  return cliExample(
+    "shopping run",
+    `--query ${quoteCliValue(input.query)}${providers}${budget}${region}${browserMode}${sort} --use-cookies --challenge-automation-mode browser_with_helper --mode json --output-format json`
+  );
+};
+var buildProductVideoRerunCommand = (input = {}) => {
+  const target = input.productUrl ? `--product-url ${quoteCliValue(input.productUrl)}` : `--product-name ${quoteCliValue(input.productName ?? "<product-name>")}`;
+  const providerHint = input.providerHint ? ` --provider-hint ${input.providerHint}` : "";
+  const screenshots = input.includeScreenshots ? " --include-screenshots" : "";
+  const allImages = input.includeAllImages ? " --include-all-images" : "";
+  const includeCopy = input.includeCopy ? " --include-copy" : "";
+  const browserMode = ` --browser-mode ${input.browserMode ?? "managed"}`;
+  return cliExample(
+    "product-video run",
+    `${target}${providerHint}${screenshots}${allImages}${includeCopy}${browserMode} --use-cookies --challenge-automation-mode browser_with_helper --output-format json`
+  );
+};
+var buildMacroResolveArgs = (input, options) => {
+  const defaultProvider = input.defaultProvider ? ` --default-provider ${input.defaultProvider}` : "";
+  const execute = options?.execute ? " --execute" : "";
+  const browserMode = options?.browserMode ? ` --browser-mode ${options.browserMode}` : "";
+  const challenge = options?.challengeAutomationMode ? ` --challenge-automation-mode ${options.challengeAutomationMode}` : "";
+  const outputFormat = options?.includeOutputFormat === false ? "" : " --output-format json";
+  return `--expression ${quoteCliValue(input.expression)}${defaultProvider}${execute}${browserMode}${challenge}${outputFormat}`;
+};
+var buildMacroPreviewCommand = (input) => cliExample("macro-resolve", buildMacroResolveArgs(input));
+var buildMacroExecuteCommand = (input, challengeAutomationMode, browserMode) => cliExample("macro-resolve", buildMacroResolveArgs(input, {
+  execute: true,
+  browserMode,
+  challengeAutomationMode
+}));
+var buildResearchSuccessHandoff = (input) => {
+  const rerunCommand = buildResearchRerunCommand(input);
+  return createSuccessHandoff(
+    "Review the ranked records and artifact bundle before turning the result into a publishable claim.",
+    `Open the returned artifact path, inspect the supporting records, and rerun ${rerunCommand} if you need a tighter evidence set.`,
+    [
+      { reason: "Check which records actually support the final claim." },
+      {
+        reason: "Rerun with explicit sources and a narrower timebox if the evidence set is still too broad.",
+        command: rerunCommand
+      }
+    ]
+  );
+};
+var buildShoppingSuccessHandoff = (input) => {
+  const rerunCommand = buildShoppingRerunCommand(input);
+  return createSuccessHandoff(
+    "Review the offer set and diagnostics before calling any result a strong deal.",
+    `Inspect the offers and meta.offerFilterDiagnostics, then rerun ${rerunCommand} if you need a tighter comparison.`,
+    [
+      { reason: "Check which offers survived the workflow filters and why." },
+      {
+        reason: "Rerun with explicit providers or updated budget and region inputs if the comparison is still noisy.",
+        command: rerunCommand
+      }
+    ]
+  );
+};
+var buildProductVideoSuccessHandoff = (input = {}) => {
+  const rerunCommand = buildProductVideoRerunCommand(input);
+  return createSuccessHandoff(
+    "Review the generated asset pack to confirm whether it is visual-ready or metadata-first before briefing production.",
+    "Open the returned pack path, inspect manifest.json plus copy and features, then run the product-video brief helper with that manifest path to generate production briefs and sourcing notes.",
+    [
+      { reason: "Confirm whether the pack already includes enough images or screenshots for production." },
+      {
+        reason: "Run the product-presentation-asset brief helper on manifest.json to generate the production brief files.",
+        command: PRODUCT_VIDEO_BRIEF_HELPER_COMMAND
+      },
+      {
+        reason: "Rerun the asset workflow with adjusted provider or media flags when the current pack is too thin.",
+        command: rerunCommand
+      },
+      { reason: "Source or capture visuals before final handoff if the pack is metadata-first." }
+    ]
+  );
+};
+var buildMacroResolveSuccessHandoff = (input) => {
+  const previewCommand = buildMacroPreviewCommand(input);
+  const executeCommand = buildMacroExecuteCommand(input);
+  const browserRetryCommand = buildMacroExecuteCommand(input, "browser_with_helper", "extension");
+  if (!input.execute) {
+    return createSuccessHandoff(
+      "Review the resolved provider action and provenance before executing the macro.",
+      `Run ${executeCommand} when the resolved action looks correct.`,
+      [
+        { reason: "Inspect resolution.action and resolution.provenance to confirm provider and query shaping." },
+        { reason: "Execute the resolved macro once the plan looks correct.", command: executeCommand },
+        { reason: "Add --default-provider only when you need to force a different provider lane.", command: previewCommand }
+      ]
+    );
+  }
+  if (input.blocked) {
+    return createSuccessHandoff(
+      "Review execution.meta.blocker and failures before retrying the macro.",
+      `Run ${browserRetryCommand} after checking execution.meta.blocker and the current recovery path.`,
+      [
+        { reason: "Inspect execution.meta.blocker and execution.failures before retrying." },
+        { reason: "Retry with browser-scoped challenge automation when the blocker requires live follow-up.", command: browserRetryCommand },
+        { reason: "Preview the resolved action again if you need to switch providers before another execute attempt.", command: previewCommand }
+      ]
+    );
+  }
+  return createSuccessHandoff(
+    "Review execution.records and trace metadata before widening the macro or changing providers.",
+    `Inspect execution.records and execution.meta, then rerun ${previewCommand} if you need a narrower plan.`,
+    [
+      { reason: "Inspect execution.records and execution.meta to confirm the resolved action hit the expected lane." },
+      { reason: "Preview the macro again before changing providers or expression scope.", command: previewCommand },
+      { reason: "Re-execute with browser-scoped challenge automation when the target requires live browser recovery.", command: browserRetryCommand }
+    ]
+  );
+};
+var buildInspiredesignSuccessHandoff = (input) => createSuccessHandoff(
+  input.summary,
+  input.nextStep,
+  [
+    { reason: INSPIREDESIGN_HANDOFF_GUIDANCE.reviewAdvancedBrief },
+    {
+      reason: "Load the baseline workflow runbook before implementation.",
+      command: input.commandExamples.loadBestPractices
+    },
+    {
+      reason: "Load the Canvas contract lane before patching.",
+      command: input.commandExamples.loadDesignAgent
+    },
+    {
+      reason: INSPIREDESIGN_HANDOFF_GUIDANCE.prepareCanvasPlanRequest,
+      command: input.commandExamples.continueInCanvas
+    },
+    { reason: input.deepCaptureRecommendation }
+  ]
+);
+
 // src/providers/renderer.ts
 var toCurrency = (value) => `$${value.toFixed(2)}`;
 var primaryConstraintSummaryFromMeta = (meta) => {
@@ -13730,26 +14695,12 @@ var renderInspiredesign = (args) => {
     evidence: args.evidence,
     meta: args.meta
   };
-  const suggestedSteps = [
-    {
-      reason: INSPIREDESIGN_HANDOFF_GUIDANCE.reviewAdvancedBrief
-    },
-    {
-      reason: "Load the baseline workflow runbook before implementation.",
-      command: args.designAgentHandoff.commandExamples.loadBestPractices
-    },
-    {
-      reason: "Load the Canvas contract lane before patching.",
-      command: args.designAgentHandoff.commandExamples.loadDesignAgent
-    },
-    {
-      reason: INSPIREDESIGN_HANDOFF_GUIDANCE.prepareCanvasPlanRequest,
-      command: args.designAgentHandoff.commandExamples.continueInCanvas
-    },
-    {
-      reason: args.designAgentHandoff.deepCaptureRecommendation
-    }
-  ];
+  const handoff = buildInspiredesignSuccessHandoff({
+    summary: followthroughSummary,
+    nextStep: args.designAgentHandoff.nextStep,
+    commandExamples: args.designAgentHandoff.commandExamples,
+    deepCaptureRecommendation: args.designAgentHandoff.deepCaptureRecommendation
+  });
   const files = [
     { path: INSPIREDESIGN_HANDOFF_FILES.designMarkdown, content: args.designMarkdown },
     { path: INSPIREDESIGN_HANDOFF_FILES.advancedBrief, content: args.advancedBriefMarkdown },
@@ -13773,9 +14724,7 @@ var renderInspiredesign = (args) => {
       response: {
         mode: args.mode,
         summary,
-        followthroughSummary,
-        suggestedNextAction: args.designAgentHandoff.nextStep,
-        suggestedSteps,
+        ...handoff,
         ...captureAttemptFields,
         meta: args.meta
       },
@@ -13796,9 +14745,7 @@ var renderInspiredesign = (args) => {
         implementationPlan: args.implementationPlan,
         prototypeGuidanceMarkdown: args.prototypeGuidanceMarkdown,
         evidence: args.evidence,
-        followthroughSummary,
-        suggestedNextAction: args.designAgentHandoff.nextStep,
-        suggestedSteps,
+        ...handoff,
         ...captureAttemptFields,
         meta: args.meta
       },
@@ -13812,9 +14759,7 @@ var renderInspiredesign = (args) => {
         markdown: args.designMarkdown,
         implementationPlanMarkdown: args.implementationPlanMarkdown,
         prototypeGuidanceMarkdown: args.prototypeGuidanceMarkdown,
-        followthroughSummary,
-        suggestedNextAction: args.designAgentHandoff.nextStep,
-        suggestedSteps,
+        ...handoff,
         ...captureAttemptFields,
         meta: args.meta
       },
@@ -13826,9 +14771,7 @@ var renderInspiredesign = (args) => {
       response: {
         mode: args.mode,
         context: contextPayload,
-        followthroughSummary,
-        suggestedNextAction: args.designAgentHandoff.nextStep,
-        suggestedSteps,
+        ...handoff,
         ...captureAttemptFields,
         meta: args.meta
       },
@@ -13838,9 +14781,7 @@ var renderInspiredesign = (args) => {
   return {
     response: {
       mode: "path",
-      followthroughSummary,
-      suggestedNextAction: args.designAgentHandoff.nextStep,
-      suggestedSteps,
+      ...handoff,
       ...captureAttemptFields,
       meta: args.meta
     },
@@ -13975,138 +14916,6 @@ var CANVAS_VALIDATION_TARGET_BLOCK_ON_CODES = [
 ];
 var CANVAS_PUBLIC_WARNING_CLASSES = CANVAS_VALIDATION_TARGET_BLOCK_ON_CODES;
 
-// src/providers/workflow-handoff.ts
-var PRODUCT_VIDEO_BRIEF_HELPER_PATH = "./skills/opendevbrowser-product-presentation-asset/scripts/render-video-brief.sh";
-var PRODUCT_VIDEO_BRIEF_HELPER_COMMAND = `${PRODUCT_VIDEO_BRIEF_HELPER_PATH} <pack>/manifest.json`;
-var createSuccessHandoff = (followthroughSummary, suggestedNextAction, suggestedSteps) => ({
-  followthroughSummary,
-  suggestedNextAction,
-  suggestedSteps
-});
-var cliExample = (command, args = "") => `npx opendevbrowser ${command}${args ? ` ${args}` : ""}`;
-var quoteCliValue = (value) => JSON.stringify(value);
-var buildResearchRerunCommand = (topic) => cliExample(
-  "research run",
-  `--topic ${quoteCliValue(topic)} --days 14 --source-selection auto --sources web,community --mode json --output-format json`
-);
-var buildShoppingRerunCommand = (input) => {
-  const providers = input.providers?.length ? ` --providers ${input.providers.join(",")}` : " --providers shopping/bestbuy,shopping/ebay";
-  const budget = typeof input.budget === "number" ? ` --budget ${input.budget}` : "";
-  const region = input.region ? ` --region ${quoteCliValue(input.region)}` : "";
-  const browserMode = ` --browser-mode ${input.browserMode ?? "managed"}`;
-  const sort = input.sort ? ` --sort ${input.sort}` : "";
-  return cliExample(
-    "shopping run",
-    `--query ${quoteCliValue(input.query)}${providers}${budget}${region}${browserMode}${sort} --mode json --output-format json`
-  );
-};
-var buildProductVideoRerunCommand = (input = {}) => {
-  const target = input.productUrl ? `--product-url ${quoteCliValue(input.productUrl)}` : `--product-name ${quoteCliValue(input.productName ?? "<product-name>")}`;
-  const providerHint = input.providerHint ? ` --provider-hint ${input.providerHint}` : "";
-  const screenshots = input.includeScreenshots ? " --include-screenshots" : "";
-  const allImages = input.includeAllImages ? " --include-all-images" : "";
-  const includeCopy = input.includeCopy ? " --include-copy" : "";
-  return cliExample(
-    "product-video run",
-    `${target}${providerHint}${screenshots}${allImages}${includeCopy} --output-format json`
-  );
-};
-var buildMacroResolveArgs = (input, options) => {
-  const defaultProvider = input.defaultProvider ? ` --default-provider ${input.defaultProvider}` : "";
-  const execute = options?.execute ? " --execute" : "";
-  const challenge = options?.challengeAutomationMode ? ` --challenge-automation-mode ${options.challengeAutomationMode}` : "";
-  const outputFormat = options?.includeOutputFormat === false ? "" : " --output-format json";
-  return `--expression ${quoteCliValue(input.expression)}${defaultProvider}${execute}${challenge}${outputFormat}`;
-};
-var buildMacroPreviewCommand = (input) => cliExample("macro-resolve", buildMacroResolveArgs(input));
-var buildMacroExecuteCommand = (input, challengeAutomationMode) => cliExample("macro-resolve", buildMacroResolveArgs(input, {
-  execute: true,
-  challengeAutomationMode
-}));
-var buildResearchSuccessHandoff = (topic) => {
-  const rerunCommand = buildResearchRerunCommand(topic);
-  return createSuccessHandoff(
-    "Review the ranked records and artifact bundle before turning the result into a publishable claim.",
-    `Open the returned artifact path, inspect the supporting records, and rerun ${rerunCommand} if you need a tighter evidence set.`,
-    [
-      { reason: "Check which records actually support the final claim." },
-      {
-        reason: "Rerun with explicit sources and a narrower timebox if the evidence set is still too broad.",
-        command: rerunCommand
-      }
-    ]
-  );
-};
-var buildShoppingSuccessHandoff = (input) => {
-  const rerunCommand = buildShoppingRerunCommand(input);
-  return createSuccessHandoff(
-    "Review the offer set and diagnostics before calling any result a strong deal.",
-    `Inspect the offers and meta.offerFilterDiagnostics, then rerun ${rerunCommand} if you need a tighter comparison.`,
-    [
-      { reason: "Check which offers survived the workflow filters and why." },
-      {
-        reason: "Rerun with explicit providers or updated budget and region inputs if the comparison is still noisy.",
-        command: rerunCommand
-      }
-    ]
-  );
-};
-var buildProductVideoSuccessHandoff = (input = {}) => {
-  const rerunCommand = buildProductVideoRerunCommand(input);
-  return createSuccessHandoff(
-    "Review the generated asset pack to confirm whether it is visual-ready or metadata-first before briefing production.",
-    `Open the returned pack path, inspect manifest.json plus copy and features, then run ${PRODUCT_VIDEO_BRIEF_HELPER_COMMAND} to generate production briefs and sourcing notes.`,
-    [
-      { reason: "Confirm whether the pack already includes enough images or screenshots for production." },
-      {
-        reason: "Run the product-presentation-asset brief helper on manifest.json to generate the production brief files.",
-        command: PRODUCT_VIDEO_BRIEF_HELPER_COMMAND
-      },
-      {
-        reason: "Rerun the asset workflow with adjusted provider or media flags when the current pack is too thin.",
-        command: rerunCommand
-      },
-      { reason: "Source or capture visuals before final handoff if the pack is metadata-first." }
-    ]
-  );
-};
-var buildMacroResolveSuccessHandoff = (input) => {
-  const previewCommand = buildMacroPreviewCommand(input);
-  const executeCommand = buildMacroExecuteCommand(input);
-  const browserRetryCommand = buildMacroExecuteCommand(input, "browser");
-  if (!input.execute) {
-    return createSuccessHandoff(
-      "Review the resolved provider action and provenance before executing the macro.",
-      `Run ${executeCommand} when the resolved action looks correct.`,
-      [
-        { reason: "Inspect resolution.action and resolution.provenance to confirm provider and query shaping." },
-        { reason: "Execute the resolved macro once the plan looks correct.", command: executeCommand },
-        { reason: "Add --default-provider only when you need to force a different provider lane.", command: previewCommand }
-      ]
-    );
-  }
-  if (input.blocked) {
-    return createSuccessHandoff(
-      "Review execution.meta.blocker and failures before retrying the macro.",
-      `Run ${browserRetryCommand} after checking execution.meta.blocker and the current recovery path.`,
-      [
-        { reason: "Inspect execution.meta.blocker and execution.failures before retrying." },
-        { reason: "Retry with browser-scoped challenge automation when the blocker requires live follow-up.", command: browserRetryCommand },
-        { reason: "Preview the resolved action again if you need to switch providers before another execute attempt.", command: previewCommand }
-      ]
-    );
-  }
-  return createSuccessHandoff(
-    "Review execution.records and trace metadata before widening the macro or changing providers.",
-    `Inspect execution.records and execution.meta, then rerun ${previewCommand} if you need a narrower plan.`,
-    [
-      { reason: "Inspect execution.records and execution.meta to confirm the resolved action hit the expected lane." },
-      { reason: "Preview the macro again before changing providers or expression scope.", command: previewCommand },
-      { reason: "Re-execute with browser-scoped challenge automation when the target requires live browser recovery.", command: browserRetryCommand }
-    ]
-  );
-};
-
 // src/providers/shopping-postprocess.ts
 import { createHash as createHash4 } from "crypto";
 var LOOKS_LIKE_URL_RE = /^https?:\/\/\S+$/i;
@@ -15413,6 +16222,16 @@ var resolveResearchAutoExcludedProviders = (sourceSelection, resolvedSources, de
     return source !== null && sourceSet.has(source);
   }).sort((left, right) => left.localeCompare(right));
 };
+var buildResearchSearchFilters = (source, args) => ({
+  include_engagement: args.includeEngagement ?? false,
+  timebox_from: args.timebox.from,
+  timebox_to: args.timebox.to,
+  ...source === "community" || source === "social" ? {
+    pageLimit: 1,
+    hopLimit: 0,
+    expansionPerRecord: 0
+  } : {}
+});
 var compileResearchExecutionPlan = (args) => {
   const topic = args.input.topic?.trim();
   if (!topic) {
@@ -15449,11 +16268,10 @@ var compileResearchExecutionPlan = (args) => {
       source,
       query: topic,
       limit: searchLimit,
-      filters: {
-        include_engagement: args.input.includeEngagement ?? false,
-        timebox_from: timebox.from,
-        timebox_to: timebox.to
-      }
+      filters: buildResearchSearchFilters(source, {
+        includeEngagement: args.input.includeEngagement,
+        timebox
+      })
     }
   }));
   return {
@@ -16261,6 +17079,7 @@ var workflowTestUtils = {
   buildWorkflowResumePayload: (kind, input) => buildWorkflowResumePayload(kind, input)
 };
 var PRODUCT_ASSET_FETCH_TIMEOUT_MS = 15e3;
+var RESEARCH_PROVIDER_STEP_TIMEOUT_MS = 3e4;
 var resolveAuxiliaryFetchTimeoutMs = (timeoutMs) => {
   if (typeof timeoutMs !== "number" || !Number.isFinite(timeoutMs) || timeoutMs <= 0) {
     return PRODUCT_ASSET_FETCH_TIMEOUT_MS;
@@ -16444,9 +17263,16 @@ var createRemainingTimeoutResolver = (timeoutMs) => {
     return Math.max(1, timeoutMs - Math.max(0, Date.now() - startedAtMs));
   };
 };
+var resolveResearchProviderStepTimeoutMs = (timeoutMs) => {
+  if (typeof timeoutMs !== "number" || !Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+    return void 0;
+  }
+  return Math.max(1, Math.min(timeoutMs, RESEARCH_PROVIDER_STEP_TIMEOUT_MS));
+};
 var INSPIREDESIGN_RENDER_MODES = /* @__PURE__ */ new Set(["compact", "json", "md", "context", "path"]);
 var INSPIREDESIGN_CAPTURE_MODES = /* @__PURE__ */ new Set(["off", "deep"]);
 var INSPIREDESIGN_COOKIE_POLICIES = /* @__PURE__ */ new Set(["off", "auto", "required"]);
+var WORKFLOW_BROWSER_MODES = /* @__PURE__ */ new Set(["auto", "extension", "managed"]);
 var isJsonRecord6 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 var INSPIREDESIGN_CAPTURE_UNAVAILABLE_FAILURE = "Deep capture requested, but browser capture is unavailable in this execution lane.";
 var isCanvasVisualDirectionProfile = (value) => {
@@ -16469,6 +17295,7 @@ var serializeInspiredesignRunInput = (input) => ({
   ...typeof input.timeoutMs === "number" ? { timeoutMs: input.timeoutMs } : {},
   ...input.outputDir ? { outputDir: input.outputDir } : {},
   ...typeof input.ttlHours === "number" ? { ttlHours: input.ttlHours } : {},
+  ...input.browserMode ? { browserMode: input.browserMode } : {},
   ...typeof input.useCookies === "boolean" ? { useCookies: input.useCookies } : {},
   ...input.challengeAutomationMode ? { challengeAutomationMode: input.challengeAutomationMode } : {},
   ...input.cookiePolicyOverride ? { cookiePolicyOverride: input.cookiePolicyOverride } : {}
@@ -16543,6 +17370,7 @@ var parseInspiredesignEnvelopeInput = (input) => {
     ...typeof input.timeoutMs === "number" ? { timeoutMs: input.timeoutMs } : {},
     ...typeof input.outputDir === "string" && input.outputDir.length > 0 ? { outputDir: input.outputDir } : {},
     ...typeof input.ttlHours === "number" ? { ttlHours: input.ttlHours } : {},
+    ...typeof input.browserMode === "string" && WORKFLOW_BROWSER_MODES.has(input.browserMode) ? { browserMode: input.browserMode } : {},
     ...typeof input.useCookies === "boolean" ? { useCookies: input.useCookies } : {},
     ...isChallengeAutomationMode(input.challengeAutomationMode) ? { challengeAutomationMode: input.challengeAutomationMode } : {},
     ...typeof input.cookiePolicyOverride === "string" && INSPIREDESIGN_COOKIE_POLICIES.has(input.cookiePolicyOverride) ? { cookiePolicyOverride: input.cookiePolicyOverride } : {}
@@ -16636,10 +17464,13 @@ var buildInspiredesignStepEnvelope = (workflowInput, trace, stepIndex, url) => b
   }
 );
 var buildInspiredesignFetchOptions = (workflowInput, envelope, timeoutMs) => withWorkflowResumeEnvelopeIntent(
-  withChallengeAutomationOverride(
-    withCookieOverrides({
-      ...typeof timeoutMs === "number" ? { timeoutMs } : {}
-    }, workflowInput),
+  withBrowserModeOverride(
+    withChallengeAutomationOverride(
+      withCookieOverrides({
+        ...typeof timeoutMs === "number" ? { timeoutMs } : {}
+      }, workflowInput),
+      workflowInput
+    ),
     workflowInput
   ),
   "workflow.inspiredesign",
@@ -16880,6 +17711,7 @@ var buildInspiredesignMeta = (runtime, workflowInput, references, failures, foll
     selection: {
       urls: workflowInput.urls,
       capture_mode: workflowInput.captureMode,
+      ...workflowInput.browserMode ? { requested_browser_mode: workflowInput.browserMode } : {},
       include_prototype_guidance: Boolean(workflowInput.includePrototypeGuidance)
     },
     metrics: {
@@ -17434,10 +18266,17 @@ var runResearchWorkflow = async (runtime, input) => {
     }
   ];
   const buildResearchStepOptions = (step, stepEnvelope) => {
-    const stepOptions = withChallengeAutomationOverride(withCookieOverrides({
-      source: step.input.source,
-      ...typeof workflowInput.timeoutMs === "number" ? { timeoutMs: workflowInput.timeoutMs } : {}
-    }, workflowInput), workflowInput);
+    const timeoutMs = resolveResearchProviderStepTimeoutMs(workflowInput.timeoutMs);
+    const stepOptions = withBrowserModeOverride(
+      withChallengeAutomationOverride(
+        withCookieOverrides({
+          source: step.input.source,
+          ...typeof timeoutMs === "number" ? { timeoutMs } : {}
+        }, workflowInput),
+        workflowInput
+      ),
+      workflowInput
+    );
     return withWorkflowResumeEnvelopeIntent(
       stepOptions,
       "workflow.research",
@@ -17500,7 +18339,8 @@ var runResearchWorkflow = async (runtime, input) => {
     timebox: resolvedTimebox,
     selection: withExcludedProviders({
       source_selection: plan.compiled.sourceSelection,
-      resolved_sources: plan.compiled.resolvedSources
+      resolved_sources: plan.compiled.resolvedSources,
+      ...workflowInput.browserMode ? { requested_browser_mode: workflowInput.browserMode } : {}
     }, plan.compiled.autoExcludedProviders),
     metrics: {
       total_records: mergedRecords.length,
@@ -17527,7 +18367,10 @@ var runResearchWorkflow = async (runtime, input) => {
     failures: mergedFailures,
     alerts: buildWorkflowAlerts(runtime, mergedFailures)
   }, primaryConstraintFailures);
-  const handoff = buildResearchSuccessHandoff(plan.compiled.topic);
+  const handoff = buildResearchSuccessHandoff({
+    topic: plan.compiled.topic,
+    browserMode: workflowInput.browserMode
+  });
   const responseMeta = withFollowthroughMeta(meta, handoff);
   const rendered = renderResearch({
     mode: workflowInput.mode,
@@ -17962,6 +18805,7 @@ var runProductVideoWorkflow = async (runtime, input, options = {}) => {
         providers: providerHint ? [providerHint] : void 0,
         mode: "json",
         ...timeoutOptions,
+        browserMode: workflowInput.browserMode,
         useCookies: workflowInput.useCookies,
         challengeAutomationMode: workflowInput.challengeAutomationMode,
         cookiePolicyOverride: workflowInput.cookiePolicyOverride
@@ -18040,12 +18884,15 @@ var runProductVideoWorkflow = async (runtime, input, options = {}) => {
     details = await runtime.fetch(
       { url: productUrl },
       withWorkflowResumeEnvelopeIntent(
-        withChallengeAutomationOverride(
-          withCookieOverrides({
-            source,
-            providerIds: shoppingProviderId ? [shoppingProviderId] : void 0,
-            ...timeoutOptions
-          }, workflowInput),
+        withBrowserModeOverride(
+          withChallengeAutomationOverride(
+            withCookieOverrides({
+              source,
+              providerIds: shoppingProviderId ? [shoppingProviderId] : void 0,
+              ...timeoutOptions
+            }, workflowInput),
+            workflowInput
+          ),
           workflowInput
         ),
         "workflow.product_video",
@@ -18195,14 +19042,16 @@ var runProductVideoWorkflow = async (runtime, input, options = {}) => {
     productUrl,
     productName: workflowInput.product_name,
     providerHint,
+    browserMode: workflowInput.browserMode,
     includeScreenshots: workflowInput.include_screenshots,
     includeAllImages: workflowInput.include_all_images,
     includeCopy: workflowInput.include_copy
   });
   const meta = withFollowthroughMeta({
+    ...workflowInput.browserMode ? { selection: { requested_browser_mode: workflowInput.browserMode } } : {},
     alerts: buildWorkflowAlerts(runtime, details.failures),
     failures: details.failures,
-    ...primaryIssue ? { primaryConstraintSummary: primaryIssue.summary } : {},
+    ...primaryIssue ? { primaryConstraint: primaryIssue, primaryConstraintSummary: primaryIssue.summary } : {},
     reasonCodeDistribution,
     transcript_strategy_failures: transcriptStrategyFailures,
     transcriptStrategyFailures,
@@ -18243,11 +19092,11 @@ var WORKFLOW_KIND_BY_SUSPENDED_INTENT_KIND2 = {
   "workflow.inspiredesign": "inspiredesign",
   "workflow.product_video": "product_video"
 };
-var EXTENSION_FIRST_SOCIAL_FALLBACK_PLATFORMS = /* @__PURE__ */ new Set(["x", "reddit", "bluesky", "facebook", "linkedin"]);
+var EXTENSION_FIRST_SOCIAL_FALLBACK_PLATFORMS = /* @__PURE__ */ new Set(["x", "reddit", "bluesky", "facebook", "linkedin", "threads"]);
 var EXTENSION_MINIMAL_TRAVERSAL_SOCIAL_PLATFORMS = /* @__PURE__ */ new Set(["linkedin"]);
 var EXTENSION_FIRST_FALLBACK_MODES = ["extension", "managed_headed"];
 var SOCIAL_BROWSER_RECOVERY_REASON_CODES = /* @__PURE__ */ new Set(["challenge_detected"]);
-var SEARCH_RENDER_RECOVERY_SOCIAL_PLATFORMS = /* @__PURE__ */ new Set(["x", "bluesky", "reddit", "facebook"]);
+var SEARCH_RENDER_RECOVERY_SOCIAL_PLATFORMS = /* @__PURE__ */ new Set(["x", "bluesky", "reddit", "facebook", "threads"]);
 var withPrioritizedFallbackModes = (prioritized, existing) => [.../* @__PURE__ */ new Set([...prioritized, ...existing ?? []])];
 var buildSocialRecoveryHints = (platform, options) => {
   const existing = options?.recoveryHints?.();
@@ -18406,6 +19255,154 @@ var SOCIAL_SEARCH_ENDPOINTS = {
   threads: (query, page) => `https://www.threads.net/search?q=${encodeURIComponent(query)}&page=${page}`,
   youtube: (query, page) => `https://www.youtube.com/results?search_query=${encodeURIComponent(query)}&page=${page}`
 };
+var FALLBACK_SHELL_LINK_SEGMENTS = /* @__PURE__ */ new Set([
+  "account",
+  "auth",
+  "about",
+  "cart",
+  "categories",
+  "category",
+  "collections",
+  "contact",
+  "explore",
+  "help",
+  "home",
+  "legal",
+  "login",
+  "policies",
+  "product",
+  "products",
+  "privacy",
+  "search",
+  "settings",
+  "shop",
+  "signin",
+  "sign-in",
+  "sitemap",
+  "store",
+  "submit",
+  "support",
+  "terms"
+]);
+var FALLBACK_SHELL_TEXT_TOKENS = /* @__PURE__ */ new Set([
+  "account",
+  "ad",
+  "ads",
+  "about",
+  "cart",
+  "contact",
+  "explore",
+  "help",
+  "home",
+  "in",
+  "legal",
+  "log",
+  "login",
+  "policies",
+  "product",
+  "products",
+  "privacy",
+  "search",
+  "settings",
+  "sign",
+  "signin",
+  "submit",
+  "support",
+  "terms"
+]);
+var FALLBACK_HEAD_RE2 = /<head\b[^>]*>[\s\S]*?<\/head>/i;
+var FALLBACK_BODY_RE2 = /<body\b[^>]*>([\s\S]*?)<\/body>/i;
+var FALLBACK_MIN_MEANINGFUL_TEXT_CHARS = 20;
+var FALLBACK_MIN_MEANINGFUL_TOKENS = 3;
+var FALLBACK_SHELL_PHRASES_RE = /\b(?:search results?|please enable javascript|enable javascript|continue|welcome|accept cookies?|privacy policy|terms of service)\b/i;
+var extractFallbackBodyHtml = (html) => {
+  const body = FALLBACK_BODY_RE2.exec(html)?.[1];
+  return body ?? html.replace(FALLBACK_HEAD_RE2, " ");
+};
+var extractFallbackBodyText = (html) => {
+  return extractText(extractFallbackBodyHtml(html));
+};
+var hasUsableFallbackText = (html) => {
+  const text = extractFallbackBodyText(html);
+  const blocker = classifyBlockerSignal({
+    source: "runtime_fetch",
+    message: text,
+    status: 200,
+    providerErrorCode: "unavailable",
+    retryable: true
+  });
+  if (blocker && blocker.type !== "unknown") return false;
+  if (text.length < FALLBACK_MIN_MEANINGFUL_TEXT_CHARS || FALLBACK_SHELL_PHRASES_RE.test(text)) {
+    return false;
+  }
+  const tokens = text.toLowerCase().match(/[a-z0-9]+/g) ?? [];
+  const meaningfulTokens = tokens.filter((token) => !FALLBACK_SHELL_TEXT_TOKENS.has(token));
+  return meaningfulTokens.length >= FALLBACK_MIN_MEANINGFUL_TOKENS;
+};
+var isUsableFallbackLink = (link, documentUrl) => {
+  try {
+    const parsed = new URL(link);
+    const source = new URL(documentUrl);
+    const segments = parsed.pathname.toLowerCase().split("/").filter(Boolean);
+    const firstSegment = segments[0];
+    if (parsed.origin === source.origin && parsed.pathname === source.pathname) {
+      return false;
+    }
+    if (segments.length === 0 && parsed.search.length === 0) {
+      return false;
+    }
+    return firstSegment === void 0 || !FALLBACK_SHELL_LINK_SEGMENTS.has(firstSegment);
+  } catch {
+    return false;
+  }
+};
+var hasUsableFallbackBodyLink = (documentUrl, html) => extractStructuredContent(extractFallbackBodyHtml(html), documentUrl).links.some((link) => isUsableFallbackLink(link, documentUrl));
+var hasUsableFallbackContent = (documentUrl, html) => hasUsableFallbackText(html) || hasUsableFallbackBodyLink(documentUrl, html);
+var isBlockedRedditFallbackLink = (link) => {
+  try {
+    const hostname = new URL(link).hostname.toLowerCase();
+    const isReddit = hostname === "reddit.com" || hostname.endsWith(".reddit.com");
+    return isReddit && !isAllowedSocialSearchExpansionUrl("reddit", link);
+  } catch {
+    return false;
+  }
+};
+var shouldOwnerReviewCommunityRedditSearchFallback = (input) => input.providerId === "community/default" && input.source === "community" && input.operation === "search" && isFirstPartySocialSearchRoute("reddit", input.url) && input.extracted.links.length > 0 && input.extracted.links.every(isBlockedRedditFallbackLink);
+var shouldReturnCompletedFallbackForOwnerReview = (args) => args.document.browserFallback !== void 0 && args.ownerReview?.({
+  providerId: args.providerId,
+  source: args.source,
+  operation: args.operation,
+  url: args.document.url,
+  html: args.document.html,
+  extracted: extractStructuredContent(args.document.html, args.document.url)
+}) === true;
+var toCompletedFallbackDocument = (args) => {
+  const resolvedUrl = canonicalizeUrl(readFallbackString(args.fallback.output, "url") ?? args.url);
+  const html = readFallbackString(args.fallback.output, "html");
+  if (!html) {
+    throw toCompletedFallbackOutputError({ ...args, provider: args.providerId, url: resolvedUrl, outputReason: "missing_or_empty_html" });
+  }
+  const extracted = extractStructuredContent(html, resolvedUrl);
+  const reviewInput = {
+    providerId: args.providerId,
+    source: args.source,
+    operation: args.operation,
+    url: resolvedUrl,
+    html,
+    extracted
+  };
+  if (!hasUsableFallbackContent(resolvedUrl, html) && !args.ownerReview?.(reviewInput)) {
+    throw toCompletedFallbackOutputError({ ...args, provider: args.providerId, url: resolvedUrl, outputReason: "empty_extracted_content" });
+  }
+  return {
+    url: resolvedUrl,
+    status: 200,
+    html,
+    text: extracted.text,
+    links: extracted.links,
+    browserFallback: toBrowserFallbackObservation(args.fallback)
+  };
+};
 var describeDefaultFetchedIssue = (document) => {
   const extracted = extractStructuredContent(document.html, document.url);
   const title = typeof extracted.metadata.title === "string" ? extracted.metadata.title : void 0;
@@ -18467,6 +19464,9 @@ var resolveDefaultFallbackDocumentIfNeeded = async (args) => {
   if (!initialIssue) {
     return { document: currentDocument, ...described };
   }
+  if (shouldReturnCompletedFallbackForOwnerReview({ ...args, document: currentDocument })) {
+    return { document: currentDocument, ...described };
+  }
   if (initialIssue.reasonCode === "env_limited" && !initialIssue.constraint) {
     return { document: currentDocument, ...described };
   }
@@ -18497,18 +19497,18 @@ var resolveDefaultFallbackDocumentIfNeeded = async (args) => {
         fallback
       });
     }
-    const resolvedUrl = canonicalizeUrl(readFallbackString(fallback.output, "url") ?? currentDocument.url);
-    const html = readFallbackString(fallback.output, "html") ?? "";
-    const extracted = extractStructuredContent(html, resolvedUrl);
-    currentDocument = {
-      url: resolvedUrl,
-      status: 200,
-      html,
-      text: extracted.text,
-      links: extracted.links,
-      browserFallback: toBrowserFallbackObservation(fallback)
-    };
+    currentDocument = toCompletedFallbackDocument({
+      providerId: args.providerId,
+      source: args.source,
+      operation: args.operation,
+      url: currentDocument.url,
+      fallback,
+      ownerReview: args.ownerReview
+    });
     described = describeDefaultFetchedIssue(currentDocument);
+    if (shouldReturnCompletedFallbackForOwnerReview({ ...args, document: currentDocument })) {
+      return { document: currentDocument, ...described };
+    }
     if (!described.issue || described.issue.reasonCode === "env_limited" && !described.issue.constraint) {
       return { document: currentDocument, ...described };
     }
@@ -18785,6 +19785,57 @@ var readResponseTextWithAbort = async (response, args) => {
   }
 };
 var fetchRuntimeDocumentWithFallback = async (args) => {
+  const fallbackPort = args.context?.browserFallbackPort ?? args.browserFallbackPort;
+  const runtimePolicy = args.context?.runtimePolicy;
+  const forcedBrowserTransport = runtimePolicy?.browser.forceTransport === true;
+  const forcedReasonCode = runtimePolicy?.cookies.policy === "required" ? "auth_required" : "env_limited";
+  if (forcedBrowserTransport) {
+    const fallback = await resolveProviderBrowserFallback({
+      browserFallbackPort: fallbackPort,
+      provider: args.provider,
+      source: args.source,
+      operation: args.operation,
+      reasonCode: forcedReasonCode,
+      url: args.url,
+      context: args.context,
+      details: {
+        message: "Direct browser transport was selected for this provider run."
+      },
+      recoveryHints: args.recoveryHints
+    });
+    if (!fallback) {
+      throw new ProviderRuntimeError(
+        providerErrorCodeFromReasonCode(forcedReasonCode),
+        "Direct browser transport is required for this provider run, but no browser transport is available.",
+        {
+          provider: args.provider,
+          source: args.source,
+          retryable: false,
+          reasonCode: forcedReasonCode,
+          details: {
+            reasonCode: forcedReasonCode,
+            browserTransportRequired: true
+          }
+        }
+      );
+    }
+    if (fallback.disposition !== "completed") {
+      throw toProviderFallbackError({
+        provider: args.provider,
+        source: args.source,
+        url: args.url,
+        fallback
+      });
+    }
+    return toCompletedFallbackDocument({
+      providerId: args.provider,
+      source: args.source,
+      operation: args.operation,
+      url: args.url,
+      fallback,
+      ownerReview: args.ownerReview
+    });
+  }
   try {
     return await fetchRuntimeDocument({
       url: args.url,
@@ -18797,7 +19848,9 @@ var fetchRuntimeDocumentWithFallback = async (args) => {
       provider: args.provider,
       source: args.source
     });
-    const fallbackPort = args.context?.browserFallbackPort ?? args.browserFallbackPort;
+    if (args.recoverRuntimeErrors === false) {
+      throw error;
+    }
     if (!fallbackPort) {
       throw error;
     }
@@ -18831,17 +19884,14 @@ var fetchRuntimeDocumentWithFallback = async (args) => {
         fallback
       });
     }
-    const resolvedUrl = canonicalizeUrl(readFallbackString(fallback.output, "url") ?? args.url);
-    const html = readFallbackString(fallback.output, "html") ?? "";
-    const extracted = extractStructuredContent(html, resolvedUrl);
-    return {
-      url: resolvedUrl,
-      status: 200,
-      html,
-      text: extracted.text,
-      links: extracted.links,
-      browserFallback: toBrowserFallbackObservation(fallback)
-    };
+    return toCompletedFallbackDocument({
+      providerId: args.provider,
+      source: args.source,
+      operation: args.operation,
+      url: args.url,
+      fallback,
+      ownerReview: args.ownerReview
+    });
   }
 };
 var ProviderRuntime = class {
@@ -19997,7 +21047,8 @@ var withDefaultCommunityOptions = (options, browserFallbackPort) => {
         operation: "search",
         signal: context.signal,
         context,
-        browserFallbackPort
+        browserFallbackPort,
+        ownerReview: shouldOwnerReviewCommunityRedditSearchFallback
       });
       const { document: resolvedDocument, pageMessage } = await resolveDefaultFallbackDocumentIfNeeded({
         providerId,
@@ -20005,7 +21056,8 @@ var withDefaultCommunityOptions = (options, browserFallbackPort) => {
         operation: "search",
         document,
         context,
-        browserFallbackPort
+        browserFallbackPort,
+        ownerReview: shouldOwnerReviewCommunityRedditSearchFallback
       });
       const links = resolveCommunitySearchLinks(resolvedDocument, limit);
       if (shouldRejectBlockedCommunityFallback(resolvedDocument, links)) {
@@ -20117,6 +21169,12 @@ var withDefaultSocialPlatformOptions = (platform, options, browserFallbackPort)
       }
     );
   };
+  const shouldOwnerReviewSocialFallback = (input) => input.source === "social" && input.operation === "search" && detectSocialSearchShell(platform, {
+    url: input.url,
+    title: typeof input.extracted.metadata.title === "string" ? input.extracted.metadata.title : void 0,
+    content: toSnippet(stripUrls(input.extracted.text), 1600),
+    links: input.extracted.links
+  })?.browserRequired === true;
   const resolveFallbackDocumentIfNeeded = async (operation, document, context) => {
     let currentDocument = document;
     let described = describeDocumentIssue(operation, currentDocument);
@@ -20151,23 +21209,24 @@ var withDefaultSocialPlatformOptions = (platform, options, browserFallbackPort)
         });
       }
       const requestedUrl = currentDocument.url;
-      const resolvedUrl = canonicalizeUrl(readFallbackString(fallback.output, "url") ?? currentDocument.url);
-      const html = readFallbackString(fallback.output, "html") ?? "";
-      const extracted = extractStructuredContent(html, resolvedUrl);
+      const fallbackDocument = toCompletedFallbackDocument({
+        providerId,
+        source: "social",
+        operation,
+        url: currentDocument.url,
+        fallback,
+        ownerReview: shouldOwnerReviewSocialFallback
+      });
       const effectiveUrl = resolveRecoveredSocialSearchDocumentUrl({
         platform,
         operation,
         requestedUrl,
-        recoveredUrl: resolvedUrl,
-        recoveredLinks: extracted.links
+        recoveredUrl: fallbackDocument.url,
+        recoveredLinks: fallbackDocument.links
       });
       currentDocument = {
-        url: effectiveUrl,
-        status: 200,
-        html,
-        text: extracted.text,
-        links: extracted.links,
-        browserFallback: toBrowserFallbackObservation(fallback)
+        ...fallbackDocument,
+        url: effectiveUrl
       };
       described = describeDocumentIssue(operation, currentDocument);
       if (!described.issue || described.issue.reasonCode === "env_limited" && !described.issue.constraint) {
@@ -20191,7 +21250,9 @@ var withDefaultSocialPlatformOptions = (platform, options, browserFallbackPort)
         signal: context.signal,
         context,
         browserFallbackPort,
-        recoveryHints: extensionFirstRecoveryHints
+        recoveryHints: extensionFirstRecoveryHints,
+        recoverRuntimeErrors: EXTENSION_FIRST_SOCIAL_FALLBACK_PLATFORMS.has(platform),
+        ownerReview: shouldOwnerReviewSocialFallback
       });
       const { document: resolvedDocument, extracted, pageMessage } = await resolveFallbackDocumentIfNeeded("search", document, context);
       const links = dedupeLinks2(
@@ -20224,7 +21285,9 @@ var withDefaultSocialPlatformOptions = (platform, options, browserFallbackPort)
         signal: context.signal,
         context,
         browserFallbackPort,
-        recoveryHints: extensionFirstRecoveryHints
+        recoveryHints: extensionFirstRecoveryHints,
+        recoverRuntimeErrors: EXTENSION_FIRST_SOCIAL_FALLBACK_PLATFORMS.has(platform),
+        ownerReview: shouldOwnerReviewSocialFallback
       });
       const { document: resolvedDocument, extracted } = await resolveFallbackDocumentIfNeeded("fetch", document, context);
       const links = dedupeLinks2(resolvedDocument.links, resolvedDocument.url, 20);
@@ -20387,10 +21450,10 @@ export {
   enrichResearchRecords,
   INSPIREDESIGN_HANDOFF_COMMANDS,
   INSPIREDESIGN_HANDOFF_GUIDANCE,
+  buildMacroResolveSuccessHandoff,
   renderResearch,
   renderShopping,
   renderInspiredesign,
-  buildMacroResolveSuccessHandoff,
   resolveInspiredesignCaptureMode,
   workflowTestUtils,
   runResearchWorkflow,
@@ -20402,4 +21465,4 @@ export {
   createProviderRuntime,
   createDefaultRuntime
 };
-//# sourceMappingURL=chunk-V5DJUSPV.js.map
+//# sourceMappingURL=chunk-T3VVHJTK.js.map