opendevbrowser 0.0.28 → 0.0.30

package/dist/{chunk-T3VVHJTK.js → chunk-4BEJVZRK.js}

@@ -1,3 +1,28 @@
+import {
+  createArtifactBundle
+} from "./chunk-S5KZQJJI.js";
+import {
+  INSPIREDESIGN_ARTIFACT_GUIDE,
+  INSPIREDESIGN_CONTRACT_SECTION_GUIDE,
+  INSPIREDESIGN_HANDOFF_COMMANDS,
+  INSPIREDESIGN_HANDOFF_FILES,
+  INSPIREDESIGN_HANDOFF_GUIDANCE,
+  INSPIREDESIGN_HANDOFF_RECOMMENDED_SKILLS,
+  buildInspiredesignFollowthroughSummary,
+  buildInspiredesignNextStep
+} from "./chunk-KZ2IXVQT.js";
+import {
+  applyPromptGuard,
+  applyProviderIssueHint,
+  buildProviderIssueGuidance,
+  classifyBlockerSignal,
+  classifyProviderIssue,
+  createLogger,
+  readProviderIssueHint,
+  readProviderIssueHintFromRecord,
+  redactSensitive,
+  summarizePrimaryProviderIssue
+} from "./chunk-WHQZBUNY.js";
 import {
   ProviderRuntimeError,
   createProviderError,
@@ -8,935 +33,11 @@ import {
   toProviderError
 } from "./chunk-FUSXMW3G.js";
 
-// src/core/logging.ts
-import { randomUUID } from "crypto";
-var SECRET_KEY_PATTERN = /(token|secret|password|authorization|cookie|api[-_]?key|session)/i;
-var SECRET_VALUE_PATTERN = /(bearer\s+[a-z0-9._-]+|sk_[a-z0-9_-]+|pk_[a-z0-9_-]+|eyJ[a-z0-9_-]+\.[a-z0-9_-]+\.[a-z0-9_-]+)/gi;
-function redactString(value) {
-  return value.replace(SECRET_VALUE_PATTERN, "[REDACTED]");
-}
-function redactSensitive(value, seen = /* @__PURE__ */ new WeakSet()) {
-  if (typeof value === "string") {
-    return redactString(value);
-  }
-  if (typeof value !== "object" || value === null) {
-    return value;
-  }
-  if (seen.has(value)) {
-    return "[Circular]";
-  }
-  seen.add(value);
-  if (Array.isArray(value)) {
-    return value.map((item) => redactSensitive(item, seen));
-  }
-  const output = {};
-  for (const [key, entry] of Object.entries(value)) {
-    if (SECRET_KEY_PATTERN.test(key)) {
-      output[key] = "[REDACTED]";
-      continue;
-    }
-    output[key] = redactSensitive(entry, seen);
-  }
-  return output;
-}
-function createRequestId() {
-  return randomUUID();
-}
-var defaultSink = (entry) => {
-  const payload = JSON.stringify(entry);
-  if (entry.level === "error") {
-    console.error(payload);
-    return;
-  }
-  if (entry.level === "warn") {
-    console.warn(payload);
-    return;
-  }
-  console.log(payload);
-};
-var stderrSink = (entry) => {
-  process.stderr.write(`${JSON.stringify(entry)}
-`);
-};
-var configuredDefaultSink = defaultSink;
-function setDefaultLogSink(sink) {
-  configuredDefaultSink = sink ?? defaultSink;
-}
-function createLogger(moduleName, sink) {
-  const emit = (level, event, fields = {}) => {
-    const entry = {
-      ts: (/* @__PURE__ */ new Date()).toISOString(),
-      level,
-      module: moduleName,
-      event,
-      requestId: fields.requestId ?? createRequestId(),
-      ...fields.sessionId ? { sessionId: fields.sessionId } : {},
-      ...fields.traceId ? { traceId: fields.traceId } : {},
-      ...typeof fields.data === "undefined" ? {} : { data: redactSensitive(fields.data) }
-    };
-    (sink ?? configuredDefaultSink)(entry);
-    return entry;
-  };
-  return {
-    debug: (event, fields) => emit("debug", event, fields),
-    info: (event, fields) => emit("info", event, fields),
-    warn: (event, fields) => emit("warn", event, fields),
-    error: (event, fields) => emit("error", event, fields),
-    audit: (event, fields) => emit("audit", event, fields)
-  };
-}
-
-// src/providers/safety/prompt-guard.ts
-var MAX_EXCERPT_LENGTH = 120;
-var RULES = [
-  {
-    id: "reveal_system_prompt",
-    regex: /\b(reveal|show|print|dump|expose|leak)\b[^.!?\n]{0,80}\b(system prompt|hidden prompt|internal prompt)\b/gi,
-    severity: "high",
-    action: "quarantine"
-  },
-  {
-    id: "tool_abuse_directive",
-    regex: /\buse (?:the )?tool(?:ing)?\b[^.!?\n]{0,120}\b(delete|remove|drop|wipe|exfiltrat|override|bypass)\w*/gi,
-    severity: "high",
-    action: "quarantine"
-  },
-  {
-    id: "ignore_previous_instructions",
-    regex: /\bignore (?:all )?previous instructions?\b/gi,
-    severity: "medium",
-    action: "strip"
-  },
-  {
-    id: "reveal_hidden_data",
-    regex: /\breveal (?:hidden|secret|confidential) (?:data|information)\b/gi,
-    severity: "high",
-    action: "quarantine"
-  }
-];
-var sanitizeExcerpt = (value) => {
-  const compact = value.replace(/\s+/g, " ").trim();
-  if (compact.length <= MAX_EXCERPT_LENGTH) return compact;
-  return `${compact.slice(0, MAX_EXCERPT_LENGTH - 3)}...`;
-};
-var isJsonObject = (value) => {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-};
-var withSecurityAttributes = (record, enabled, guardEntries, quarantinedSegments) => {
-  const existingSecurity = isJsonObject(record.attributes.security) ? record.attributes.security : {};
-  return {
-    ...record.attributes,
-    security: {
-      ...existingSecurity,
-      untrustedContent: true,
-      dataOnlyContext: true,
-      promptGuardEnabled: enabled,
-      guardEntries,
-      quarantinedSegments
-    }
-  };
-};
-function sanitizePromptGuardText(text, enabled) {
-  if (!enabled || !text) {
-    return {
-      text,
-      diagnostics: { entries: 0, quarantinedSegments: 0 },
-      entries: []
-    };
-  }
-  let output = text;
-  const entries = [];
-  for (const rule of RULES) {
-    rule.regex.lastIndex = 0;
-    output = output.replace(rule.regex, (match) => {
-      entries.push({
-        pattern: rule.id,
-        action: rule.action,
-        severity: rule.severity,
-        excerpt: sanitizeExcerpt(match)
-      });
-      return rule.action === "quarantine" ? "[QUARANTINED]" : " ";
-    });
-  }
-  const normalized = output.replace(/\s{2,}/g, " ").trim();
-  const quarantinedSegments = entries.reduce((count, entry) => {
-    return entry.action === "quarantine" ? count + 1 : count;
-  }, 0);
-  return {
-    text: normalized,
-    diagnostics: {
-      entries: entries.length,
-      quarantinedSegments
-    },
-    entries
-  };
-}
-function applyPromptGuard(records, enabled) {
-  const auditEntries = [];
-  let totalQuarantinedSegments = 0;
-  const guardedRecords = records.map((record) => {
-    if (!enabled) {
-      return {
-        ...record,
-        attributes: withSecurityAttributes(record, false, 0, 0)
-      };
-    }
-    let title = record.title;
-    let content = record.content;
-    let recordEntries = 0;
-    let recordQuarantinedSegments = 0;
-    if (typeof record.title === "string") {
-      const sanitizedTitle = sanitizePromptGuardText(record.title, true);
-      title = sanitizedTitle.text;
-      recordEntries += sanitizedTitle.diagnostics.entries;
-      recordQuarantinedSegments += sanitizedTitle.diagnostics.quarantinedSegments;
-      for (const entry of sanitizedTitle.entries) {
-        auditEntries.push({
-          ...entry,
-          recordId: record.id,
-          field: "title"
-        });
-      }
-    }
-    if (typeof record.content === "string") {
-      const sanitizedContent = sanitizePromptGuardText(record.content, true);
-      content = sanitizedContent.text;
-      recordEntries += sanitizedContent.diagnostics.entries;
-      recordQuarantinedSegments += sanitizedContent.diagnostics.quarantinedSegments;
-      for (const entry of sanitizedContent.entries) {
-        auditEntries.push({
-          ...entry,
-          recordId: record.id,
-          field: "content"
-        });
-      }
-    }
-    totalQuarantinedSegments += recordQuarantinedSegments;
-    return {
-      ...record,
-      ...typeof title === "string" ? { title } : {},
-      ...typeof content === "string" ? { content } : {},
-      attributes: withSecurityAttributes(record, true, recordEntries, recordQuarantinedSegments)
-    };
-  });
-  return {
-    records: guardedRecords,
-    audit: {
-      enabled,
-      quarantinedSegments: enabled ? totalQuarantinedSegments : 0,
-      entries: enabled ? auditEntries : []
-    }
-  };
-}
-
-// src/providers/blocker.ts
-var AUTH_URL_PATTERNS = [
-  { id: "redirect_login_flow", regex: /\/i\/flow\/login/i, confidence: 0.97 },
-  { id: "auth_login_path", regex: /\/(login|signin|sign-in|auth)(?:[./?]|$)/i, confidence: 0.9 }
-];
-var AUTH_TITLE_PATTERNS = [
-  { id: "title_login", regex: /\b(log ?in|sign ?in|login|signin)\b/i, confidence: 0.92 },
-  { id: "title_auth_required", regex: /authentication required/i, confidence: 0.9 }
-];
-var CHALLENGE_PATTERNS = [
-  { id: "challenge_keyword", regex: /\b(challenge|captcha|verify|interstitial|cf_chl|bot)\b/i, confidence: 0.88 },
-  { id: "prove_humanity", regex: /prove your humanity/i, confidence: 0.96 },
-  { id: "robot_or_human", regex: /robot or human/i, confidence: 0.98 },
-  { id: "confirm_human", regex: /confirm that you(?:'|’)re human/i, confidence: 0.96 },
-  { id: "click_and_hold", regex: /\b(?:click|press|tap|activate)\s+(?:and\s+)?hold\b/i, confidence: 0.95 },
-  { id: "press_and_hold", regex: /activate and hold the button/i, confidence: 0.95 },
-  { id: "drag_slider", regex: /\b(?:drag|slide|move)(?:\s+the)?\s+(?:slider|puzzle(?:\s+piece)?|piece|button)\b/i, confidence: 0.95 },
-  { id: "pardon_interruption", regex: /pardon our interruption/i, confidence: 0.97 },
-  { id: "checking_browser_gate", regex: /checking your browser before you access/i, confidence: 0.97 }
-];
-var RECAPTCHA_HOST_PATTERNS = [/recaptcha/i, /hcaptcha/i, /challenges\.cloudflare\.com/i];
-var STATIC_BLOCK_HOST_PATTERNS = [/redditstatic\.com$/i, /abs\.twimg\.com$/i, /twimg\.com$/i];
-var ENV_LIMITED_PATTERNS = [
-  /extension not connected/i,
-  /connect the extension/i,
-  /manual interaction/i,
-  /timed out/i,
-  /not available in this environment/i
-];
-var RESTRICTED_TARGET_PATTERNS = [/^chrome:\/\//i, /^chrome-extension:\/\//i, /^about:blank$/i, /^devtools:\/\//i];
-var DEFAULT_BLOCKER_ARTIFACT_CAPS = {
-  maxNetworkEvents: 20,
-  maxConsoleEvents: 20,
-  maxExceptionEvents: 10,
-  maxHosts: 10,
-  maxTextLength: 512
-};
-var toLower = (value) => value.trim().toLowerCase();
-var clampNumber = (value, min, max) => {
-  if (!Number.isFinite(value)) return min;
-  if (value < min) return min;
-  if (value > max) return max;
-  return value;
-};
-var clampBlockerConfidence = (value) => {
-  return clampNumber(value, 0, 1);
-};
-var clampThreshold = (value) => {
-  if (typeof value !== "number") return 0.7;
-  return clampNumber(value, 0, 1);
-};
-var clampText = (value, maxLength) => {
-  if (typeof value !== "string") return void 0;
-  if (maxLength <= 0) return "";
-  return value.length <= maxLength ? value : `${value.slice(0, Math.max(0, maxLength - 3))}...`;
-};
-var boundedUniqueList = (values, maxLength) => {
-  if (!values || values.length === 0 || maxLength <= 0) return [];
-  const seen = /* @__PURE__ */ new Set();
-  const list = [];
-  for (const value of values) {
-    if (typeof value !== "string") continue;
-    const normalized = value.trim();
-    if (!normalized) continue;
-    const key = normalized.toLowerCase();
-    if (seen.has(key)) continue;
-    seen.add(key);
-    list.push(normalized);
-    if (list.length >= maxLength) break;
-  }
-  return list;
-};
-var extractHost = (value) => {
-  if (!value) return null;
-  try {
-    return toLower(new URL(value).hostname);
-  } catch {
-    return null;
-  }
-};
-var scorePatternMatches = (text, patterns) => {
-  const matched = [];
-  let confidence = 0;
-  for (const pattern of patterns) {
-    if (!pattern.regex.test(text)) continue;
-    matched.push(pattern.id);
-    confidence = Math.max(confidence, pattern.confidence);
-  }
-  return { matched, confidence };
-};
-var hasAnyPattern = (value, patterns) => {
-  return patterns.some((pattern) => pattern.test(value));
-};
-var isLoopbackHost = (value) => {
-  const normalized = toLower(value).replace(/^\[|\]$/g, "");
-  if (!normalized) return false;
-  if (normalized === "localhost" || normalized === "::1") return true;
-  if (normalized === "127.0.0.1" || normalized.startsWith("127.")) return true;
-  return /^::ffff:127\.\d+\.\d+\.\d+$/.test(normalized);
-};
-var buildHints = (type) => {
-  switch (type) {
-    case "auth_required":
-      return [
-        { id: "manual_login", reason: "Authentication flow requires interactive login.", priority: 1 },
-        { id: "switch_managed_headed", reason: "Headed mode can complete login and persist session state.", priority: 2 },
-        { id: "switch_extension_mode", reason: "Extension mode can reuse an already logged-in browser profile.", priority: 3 }
-      ];
-    case "anti_bot_challenge":
-      return [
-        { id: "manual_challenge", reason: "Challenge page requires manual completion.", priority: 1 },
-        { id: "switch_managed_headed", reason: "Headed mode improves challenge completion reliability.", priority: 2 },
-        { id: "collect_debug_trace", reason: "Collect trace artifacts to compare challenge indicators before and after manual action.", priority: 3 }
-      ];
-    case "rate_limited":
-      return [
-        { id: "retry_after_backoff", reason: "Rate-limited responses should be retried after a bounded delay.", priority: 1 },
-        { id: "collect_debug_trace", reason: "Trace data can confirm cooldown and request pacing behavior.", priority: 2 }
-      ];
-    case "upstream_block":
-      return [
-        { id: "retry_after_backoff", reason: "Upstream blocks may clear after network or host recovery.", priority: 1 },
-        { id: "switch_managed_headed", reason: "Browser-assisted retrieval may bypass runtime fetch limitations.", priority: 2 },
-        { id: "collect_debug_trace", reason: "Trace host evidence helps confirm blocked upstream dependencies.", priority: 3 }
-      ];
-    case "restricted_target":
-      return [
-        { id: "switch_managed_headed", reason: "Restricted internal targets require navigation to a normal http(s) tab.", priority: 1 },
-        { id: "collect_debug_trace", reason: "Trace confirms blocked scheme or tab restriction source.", priority: 2 }
-      ];
-    case "env_limited":
-      return [
-        { id: "switch_extension_mode", reason: "Extension relay availability is required for this operation.", priority: 1 },
-        { id: "switch_managed_headed", reason: "Managed headed mode is a deterministic fallback when extension is unavailable.", priority: 2 },
-        { id: "collect_debug_trace", reason: "Diagnostics can confirm environment capability gaps.", priority: 3 }
-      ];
-    case "unknown":
-      return [{ id: "collect_debug_trace", reason: "Additional trace evidence is required for reliable classification.", priority: 1 }];
-  }
-};
-var classifyFromInputs = (input, normalizedHosts, matchedPatterns) => {
-  const status = input.status;
-  const code = toLower(input.providerErrorCode ?? "");
-  const url = input.url ?? "";
-  const finalUrl = input.finalUrl ?? "";
-  const title = input.title ?? "";
-  const message = input.message ?? "";
-  const challengeText = `${title} ${message}`;
-  const urlSignals = `${url} ${finalUrl}`;
-  const isUpstreamCode = code === "upstream" || code === "network" || code === "unavailable";
-  const hasStaticBlockHost = normalizedHosts.some((host) => hasAnyPattern(host, STATIC_BLOCK_HOST_PATTERNS));
-  const isLoopbackContext = [
-    extractHost(url),
-    extractHost(finalUrl),
-    ...normalizedHosts
-  ].some((host) => typeof host === "string" && isLoopbackHost(host));
-  const authMatches = [];
-  let authConfidence = 0;
-  if (status === 401 || status === 403) {
-    authMatches.push(`status:${status}`);
-    authConfidence = Math.max(authConfidence, status === 401 ? 0.94 : 0.9);
-  }
-  if (code === "auth") {
-    authMatches.push("provider_code:auth");
-    authConfidence = Math.max(authConfidence, 0.9);
-  }
-  const authPathMatches = scorePatternMatches(`${url} ${finalUrl}`, AUTH_URL_PATTERNS);
-  authMatches.push(...authPathMatches.matched);
-  authConfidence = Math.max(authConfidence, authPathMatches.confidence);
-  const authTitleMatches = scorePatternMatches(title, AUTH_TITLE_PATTERNS);
-  authMatches.push(...authTitleMatches.matched);
-  authConfidence = Math.max(authConfidence, authTitleMatches.confidence);
-  if (authConfidence > 0) {
-    return {
-      type: "auth_required",
-      reasonCode: "token_required",
-      confidence: authConfidence,
-      retryable: false,
-      matches: boundedUniqueList([...matchedPatterns, ...authMatches], 16)
-    };
-  }
-  if (!isLoopbackContext) {
-    const challengeMatches = [];
-    let challengeConfidence = 0;
-    const challengePatternMatches = scorePatternMatches(challengeText, CHALLENGE_PATTERNS);
-    challengeMatches.push(...challengePatternMatches.matched);
-    challengeConfidence = Math.max(challengeConfidence, challengePatternMatches.confidence);
-    if (/(captcha|cf_chl|hcaptcha|recaptcha|interstitial)/i.test(urlSignals)) {
-      challengeMatches.push("url:challenge_token");
-      challengeConfidence = Math.max(challengeConfidence, 0.9);
-    }
-    if (hasAnyPattern(title, CHALLENGE_PATTERNS.map((entry) => entry.regex)) && status === 200) {
-      challengeMatches.push("status:200_challenge_title");
-      challengeConfidence = Math.max(challengeConfidence, 0.92);
-    }
-    if (normalizedHosts.some((host) => hasAnyPattern(host, RECAPTCHA_HOST_PATTERNS))) {
-      challengeMatches.push("network:challenge_host");
-      challengeConfidence = Math.max(challengeConfidence, 0.96);
-    }
-    if (challengeConfidence > 0) {
-      return {
-        type: "anti_bot_challenge",
-        reasonCode: "challenge_detected",
-        confidence: challengeConfidence,
-        retryable: false,
-        matches: boundedUniqueList([...matchedPatterns, ...challengeMatches], 16)
-      };
-    }
-  }
-  if (status === 429 || code === "rate_limited") {
-    return {
-      type: "rate_limited",
-      reasonCode: "rate_limited",
-      confidence: 0.95,
-      retryable: true,
-      matches: boundedUniqueList([...matchedPatterns, status === 429 ? "status:429" : "provider_code:rate_limited"], 16)
-    };
-  }
-  if (isUpstreamCode && (hasStaticBlockHost || /retrieval failed/i.test(message) || typeof status === "number" && status >= 500)) {
-    return {
-      type: "upstream_block",
-      reasonCode: "ip_blocked",
-      confidence: hasStaticBlockHost ? 0.9 : 0.8,
-      retryable: input.retryable ?? true,
-      matches: boundedUniqueList(
-        [
-          ...matchedPatterns,
-          `provider_code:${code}`,
-          ...hasStaticBlockHost ? ["network:blocked_static_host"] : []
-        ],
-        16
-      )
-    };
-  }
-  if (input.restrictedTarget || RESTRICTED_TARGET_PATTERNS.some((pattern) => pattern.test(url)) || RESTRICTED_TARGET_PATTERNS.some((pattern) => pattern.test(finalUrl))) {
-    return {
-      type: "restricted_target",
-      confidence: 0.92,
-      retryable: false,
-      matches: boundedUniqueList([...matchedPatterns, "restricted_target"], 16)
-    };
-  }
-  if (input.envLimited || code === "unavailable" && ENV_LIMITED_PATTERNS.some((pattern) => pattern.test(message))) {
-    return {
-      type: "env_limited",
-      reasonCode: "env_limited",
-      confidence: input.envLimited ? 0.9 : 0.78,
-      retryable: true,
-      matches: boundedUniqueList([...matchedPatterns, "env_limited"], 16)
-    };
-  }
-  if (status || code || title || message || normalizedHosts.length > 0) {
-    return {
-      type: "unknown",
-      confidence: 0.5,
-      retryable: input.retryable ?? false,
-      matches: boundedUniqueList(matchedPatterns, 16)
-    };
-  }
-  return null;
-};
-var coerceJsonValue = (value, maxTextLength, promptGuardEnabled, diagnostics, seen) => {
-  if (value === null || typeof value === "number" || typeof value === "boolean") {
-    return value;
-  }
-  if (typeof value === "string") {
-    const sanitized = sanitizePromptGuardText(value, promptGuardEnabled);
-    diagnostics.entries += sanitized.diagnostics.entries;
-    diagnostics.quarantinedSegments += sanitized.diagnostics.quarantinedSegments;
-    const redacted = redactSensitive(sanitized.text);
-    const asString = typeof redacted === "string" ? redacted : String(redacted);
-    return clampText(asString, maxTextLength) ?? "";
-  }
-  if (Array.isArray(value)) {
-    return value.slice(0, 20).map((entry) => coerceJsonValue(entry, maxTextLength, promptGuardEnabled, diagnostics, seen));
-  }
-  if (typeof value !== "object") {
-    return String(value);
-  }
-  if (seen.has(value)) {
-    return "[Circular]";
-  }
-  seen.add(value);
-  const objectValue = value;
-  const entries = Object.entries(objectValue).slice(0, 30);
-  const output = {};
-  for (const [key, entryValue] of entries) {
-    output[key] = coerceJsonValue(entryValue, maxTextLength, promptGuardEnabled, diagnostics, seen);
-  }
-  return output;
-};
-var coerceEventList = (values, maxItems, maxTextLength, promptGuardEnabled, diagnostics) => {
-  if (!Array.isArray(values) || maxItems <= 0) return [];
-  return values.slice(-maxItems).map((entry) => {
-    const sanitized = coerceJsonValue(
-      redactSensitive(entry),
-      maxTextLength,
-      promptGuardEnabled,
-      diagnostics,
-      /* @__PURE__ */ new WeakSet()
-    );
-    if (!sanitized || typeof sanitized !== "object" || Array.isArray(sanitized)) {
-      return { value: sanitized };
-    }
-    return sanitized;
-  });
-};
-var resolveBlockerArtifactCaps = (partial) => {
-  return {
-    maxNetworkEvents: clampNumber(partial?.maxNetworkEvents ?? DEFAULT_BLOCKER_ARTIFACT_CAPS.maxNetworkEvents, 1, 500),
-    maxConsoleEvents: clampNumber(partial?.maxConsoleEvents ?? DEFAULT_BLOCKER_ARTIFACT_CAPS.maxConsoleEvents, 1, 500),
-    maxExceptionEvents: clampNumber(partial?.maxExceptionEvents ?? DEFAULT_BLOCKER_ARTIFACT_CAPS.maxExceptionEvents, 1, 200),
-    maxHosts: clampNumber(partial?.maxHosts ?? DEFAULT_BLOCKER_ARTIFACT_CAPS.maxHosts, 1, 200),
-    maxTextLength: clampNumber(partial?.maxTextLength ?? DEFAULT_BLOCKER_ARTIFACT_CAPS.maxTextLength, 32, 4096)
-  };
-};
-var classifyBlockerSignal = (input) => {
-  const promptGuardEnabled = input.promptGuardEnabled ?? true;
-  const titleSanitized = sanitizePromptGuardText(input.title ?? "", promptGuardEnabled);
-  const messageSanitized = sanitizePromptGuardText(input.message ?? "", promptGuardEnabled);
-  const matchedPatterns = boundedUniqueList(input.matchedPatterns, 16);
-  const normalizedHosts = boundedUniqueList(input.networkHosts?.map(toLower), 20);
-  const classification = classifyFromInputs({
-    ...input,
-    title: titleSanitized.text,
-    message: messageSanitized.text
-  }, normalizedHosts, matchedPatterns);
-  if (!classification) {
-    return null;
-  }
-  const threshold = clampThreshold(input.threshold);
-  const confidence = clampBlockerConfidence(classification.confidence);
-  if (confidence < threshold) {
-    return null;
-  }
-  const evidence = {
-    ...input.url ? { url: clampText(input.url, 512) } : {},
-    ...input.finalUrl ? { finalUrl: clampText(input.finalUrl, 512) } : {},
-    ...titleSanitized.text ? { title: clampText(titleSanitized.text, 512) } : {},
-    ...typeof input.status === "number" ? { status: input.status } : {},
-    ...input.providerErrorCode ? { providerErrorCode: input.providerErrorCode } : {},
-    matchedPatterns: boundedUniqueList(classification.matches, 16),
-    networkHosts: boundedUniqueList(normalizedHosts, 10),
-    ...input.traceRequestId ? { traceRequestId: input.traceRequestId } : {}
-  };
-  const sanitationEntries = titleSanitized.diagnostics.entries + messageSanitized.diagnostics.entries;
-  const sanitationQuarantined = titleSanitized.diagnostics.quarantinedSegments + messageSanitized.diagnostics.quarantinedSegments;
-  return {
-    schemaVersion: "1.0",
-    type: classification.type,
-    source: input.source,
-    ...classification.reasonCode ? { reasonCode: classification.reasonCode } : {},
-    confidence,
-    retryable: classification.retryable,
-    detectedAt: input.detectedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
-    evidence,
-    actionHints: buildHints(classification.type),
-    ...sanitationEntries > 0 || sanitationQuarantined > 0 ? {
-      sanitation: {
-        entries: sanitationEntries,
-        quarantinedSegments: sanitationQuarantined
-      }
-    } : {}
-  };
-};
-var buildBlockerArtifacts = (input) => {
-  const caps = resolveBlockerArtifactCaps(input.caps);
-  const promptGuardEnabled = input.promptGuardEnabled ?? true;
-  const diagnostics = {
-    entries: 0,
-    quarantinedSegments: 0
-  };
-  const network = coerceEventList(
-    input.networkEvents,
-    caps.maxNetworkEvents,
-    caps.maxTextLength,
-    promptGuardEnabled,
-    diagnostics
-  );
-  const console2 = coerceEventList(
-    input.consoleEvents,
-    caps.maxConsoleEvents,
-    caps.maxTextLength,
-    promptGuardEnabled,
-    diagnostics
-  );
-  const exception = coerceEventList(
-    input.exceptionEvents,
-    caps.maxExceptionEvents,
-    caps.maxTextLength,
-    promptGuardEnabled,
-    diagnostics
-  );
-  const hosts = boundedUniqueList(
-    network.map((event) => typeof event.url === "string" ? extractHost(event.url) : null).filter((host) => typeof host === "string"),
-    caps.maxHosts
-  );
-  return {
-    schemaVersion: "1.0",
-    network,
-    console: console2,
-    exception,
-    hosts,
-    sanitation: diagnostics
-  };
-};
-var __test__ = {
-  classifyFromInputs,
-  extractHost,
-  hasAnyPattern,
-  clampThreshold,
-  isLoopbackHost
-};
-
-// src/providers/constraint.ts
-var BLOCKER_TYPES = /* @__PURE__ */ new Set([
-  "auth_required",
-  "anti_bot_challenge",
-  "rate_limited",
-  "upstream_block",
-  "restricted_target",
-  "env_limited",
-  "unknown"
-]);
-var CONSTRAINT_KINDS = /* @__PURE__ */ new Set([
-  "session_required",
-  "render_required"
-]);
-var RENDER_REQUIRED_SHELLS = /* @__PURE__ */ new Set([
-  "bestbuy_international_gate",
-  "duckduckgo_non_js_redirect",
-  "macys_access_denied_shell",
-  "social_first_party_help_shell",
-  "social_js_required_shell",
-  "social_render_shell",
-  "target_shell_page",
-  "temu_empty_shell"
-]);
-var CHALLENGE_SHELLS = /* @__PURE__ */ new Set(["social_verification_wall", "temu_challenge_shell"]);
-var toNonEmptyString = (value) => {
-  return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
-};
-var normalizeBlockerType = (value) => {
-  return typeof value === "string" && BLOCKER_TYPES.has(value) ? value : void 0;
-};
-var buildConstraint = (kind, evidenceCode, providerShell, message) => ({
-  kind,
-  evidenceCode,
-  ...providerShell ? { providerShell } : {},
-  ...message ? { message } : {}
-});
-var isProviderConstraint = (value) => {
-  if (!value || typeof value !== "object" || Array.isArray(value)) {
-    return false;
-  }
-  const candidate = value;
-  return CONSTRAINT_KINDS.has(candidate.kind) && typeof candidate.evidenceCode === "string" && candidate.evidenceCode.trim().length > 0 && (candidate.providerShell === void 0 || typeof candidate.providerShell === "string") && (candidate.message === void 0 || typeof candidate.message === "string");
-};
-var classifyProviderIssue = (input) => {
-  const providerShell = toNonEmptyString(input.providerShell);
-  const message = toNonEmptyString(input.message);
-  if (providerShell && CHALLENGE_SHELLS.has(providerShell)) {
-    return {
-      reasonCode: "challenge_detected",
-      blockerType: "anti_bot_challenge"
-    };
-  }
-  if (providerShell && RENDER_REQUIRED_SHELLS.has(providerShell)) {
-    return {
-      reasonCode: "env_limited",
-      blockerType: "env_limited",
-      constraint: buildConstraint("render_required", providerShell, providerShell, message)
-    };
-  }
-  const blocker = classifyBlockerSignal({
-    source: input.source ?? "runtime_fetch",
-    ...input.url ? { url: input.url, finalUrl: input.url } : {},
-    ...input.title ? { title: input.title } : {},
-    ...message ? { message } : {},
-    ...typeof input.status === "number" ? { status: input.status } : {},
-    ...input.providerErrorCode ? { providerErrorCode: input.providerErrorCode } : {},
-    ...typeof input.retryable === "boolean" ? { retryable: input.retryable } : {},
-    envLimited: input.browserRequired === true
-  });
-  if (blocker?.type === "auth_required") {
-    return {
-      /* c8 ignore next -- classifyBlockerSignal always supplies token_required for auth_required blockers */
-      reasonCode: blocker.reasonCode ?? "token_required",
-      blockerType: blocker.type,
-      constraint: buildConstraint("session_required", providerShell ?? "auth_required", providerShell, message)
-    };
-  }
-  if (blocker?.type === "anti_bot_challenge") {
-    return {
-      /* c8 ignore next -- classifyBlockerSignal always supplies challenge_detected for anti-bot blockers */
-      reasonCode: blocker.reasonCode ?? "challenge_detected",
-      blockerType: blocker.type
-    };
-  }
-  if (input.browserRequired === true) {
-    return {
-      /* c8 ignore next -- browserRequired inputs always classify to a blocker payload in the shared classifier */
-      reasonCode: blocker?.reasonCode ?? "env_limited",
-      /* c8 ignore next -- browserRequired fallbacks only normalize unknown blocker types */
-      blockerType: blocker?.type === "unknown" ? "env_limited" : blocker?.type,
-      /* c8 ignore next -- providerShell or blocker type always survives before the defensive browser_required fallback */
-      constraint: buildConstraint("render_required", providerShell ?? blocker?.type ?? "browser_required", providerShell, message)
-    };
-  }
-  if (blocker?.type === "env_limited") {
-    return {
-      /* c8 ignore next -- classifyBlockerSignal always supplies env_limited for env_limited blockers */
-      reasonCode: blocker.reasonCode ?? "env_limited",
-      blockerType: blocker.type
-    };
-  }
-  return null;
-};
-var readProviderIssueHint = (args) => {
-  const details = args.details;
-  const reasonCode = isProviderReasonCode(args.reasonCode) ? args.reasonCode : isProviderReasonCode(details?.reasonCode) ? details.reasonCode : void 0;
-  const blockerType = normalizeBlockerType(args.blockerType ?? details?.blockerType);
-  const constraint = isProviderConstraint(details?.constraint) ? details.constraint : void 0;
-  if (reasonCode || blockerType || constraint) {
-    return {
-      reasonCode: reasonCode ?? (constraint?.kind === "session_required" ? "token_required" : "env_limited"),
-      ...blockerType ? { blockerType } : {},
-      ...constraint ? { constraint } : {}
-    };
-  }
-  return classifyProviderIssue({
-    url: toNonEmptyString(details?.url),
-    title: toNonEmptyString(details?.title),
-    message: toNonEmptyString(details?.message ?? args.message),
-    providerShell: toNonEmptyString(details?.providerShell),
-    browserRequired: details?.browserRequired === true,
-    providerErrorCode: toNonEmptyString(args.code),
-    source: "runtime_fetch"
-  });
-};
-var readProviderIssueHintFromRecord = (record) => {
-  const details = record.attributes;
-  return readProviderIssueHint({
-    reasonCode: details.reasonCode,
-    blockerType: details.blockerType,
-    message: record.content,
-    details: {
-      url: record.url,
-      title: record.title,
-      message: record.content,
-      providerShell: details.providerShell,
-      browserRequired: details.browserRequired,
-      constraint: details.constraint
-    }
-  });
-};
-var applyProviderIssueHint = (details, hint) => {
-  if (!hint) return details;
-  const next = {
-    ...details ?? {},
-    reasonCode: hint.reasonCode
-  };
-  if (hint.blockerType && typeof next.blockerType !== "string") {
-    next.blockerType = hint.blockerType;
-  }
-  if (hint.constraint && !isProviderConstraint(next.constraint)) {
-    next.constraint = hint.constraint;
-  }
-  if (typeof next.guidance === "undefined") {
-    const guidance = buildProviderIssueGuidance({ hint, details: next });
-    if (guidance) {
-      next.guidance = guidance;
-    }
-  }
-  return next;
-};
-var providerLabel = (provider) => {
-  const normalized = toNonEmptyString(provider);
-  if (!normalized) return "Provider";
-  const separator = normalized.lastIndexOf("/");
-  const tail = separator >= 0 ? normalized.slice(separator + 1) : normalized;
-  return tail.charAt(0).toUpperCase() + tail.slice(1);
-};
-var hasPreservedBrowserState = (details) => {
-  return typeof details?.preservedSessionId === "string" || typeof details?.preservedTargetId === "string";
-};
-var buildGuidance = (reason, recommendedNextCommands) => ({
-  reason,
-  recommendedNextCommands
-});
-var buildAuthGuidance = (subject, preservedBrowserState) => {
-  return preservedBrowserState ? buildGuidance(
-    `${subject} preserved browser state that can finish authentication.`,
-    [
-      "Complete the login or account checkpoint in the preserved browser session.",
-      "Rerun the same provider or workflow after the session is fully authenticated."
-    ]
-  ) : buildGuidance(
-    `${subject} needs an authenticated session before retrying.`,
-    [
-      "Reuse an authenticated browser session, import logged-in cookies, or use the provider sign-in flow.",
-      "Rerun the same provider or workflow once the session is active."
-    ]
-  );
-};
-var buildChallengeGuidance = (subject, preservedBrowserState) => {
-  return preservedBrowserState ? buildGuidance(
-    `${subject} preserved browser state that can complete the current challenge.`,
-    [
-      "Finish the login or anti-bot challenge in the preserved browser session.",
-      "Rerun the same provider or workflow after the page unlocks."
-    ]
-  ) : buildGuidance(
-    `${subject} hit a challenge that still needs browser-assisted follow-up.`,
-    [
-      "Retry with browser assistance so the challenge can be completed interactively.",
-      "Only ask for manual credentials if browser-assisted recovery still cannot unlock the page."
-    ]
-  );
-};
-var buildRenderGuidance = (subject, preservedBrowserState) => {
-  return preservedBrowserState ? buildGuidance(
-    `${subject} still needs a live browser-rendered page, but browser state is already preserved.`,
-    [
-      "Inspect the preserved browser session until usable content is visible.",
-      "Rerun the same provider or workflow after the rendered page is ready."
-    ]
-  ) : buildGuidance(
-    `${subject} needs a live browser-rendered page before retrying.`,
-    [
-      "Retry with browser assistance or a headed browser session.",
-      "Rerun the same provider or workflow after the rendered page is ready."
-    ]
-  );
-};
-var buildProviderIssueGuidance = (args) => {
-  const subject = providerLabel(args.provider);
-  const preservedBrowserState = hasPreservedBrowserState(args.details);
-  const disposition = toNonEmptyString(args.details?.disposition);
-  if (disposition === "completed") return void 0;
-  if (disposition === "challenge_preserved") {
-    return buildChallengeGuidance(subject, true);
-  }
-  if (args.hint.reasonCode === "token_required" || args.hint.reasonCode === "auth_required") {
-    return buildAuthGuidance(subject, preservedBrowserState);
-  }
-  if (args.hint.reasonCode === "challenge_detected") {
-    return buildChallengeGuidance(subject, preservedBrowserState);
-  }
-  if (args.hint.constraint?.kind === "render_required" || args.hint.reasonCode === "env_limited") {
-    return buildRenderGuidance(subject, preservedBrowserState);
-  }
-  return void 0;
-};
-var summaryPriority = (hint) => {
-  if (hint.reasonCode === "token_required" || hint.reasonCode === "auth_required") return 3;
-  if (hint.reasonCode === "challenge_detected") return 2;
-  if (hint.constraint?.kind === "render_required") return 1;
-  return 0;
-};
-var summarizeProviderIssue = (args) => {
-  const subject = providerLabel(args.provider);
-  if (args.hint.reasonCode === "token_required" || args.hint.reasonCode === "auth_required") {
-    return `${subject} requires login or an existing session.`;
-  }
-  if (args.hint.reasonCode === "challenge_detected") {
-    return `${subject} hit an anti-bot challenge that requires manual completion.`;
-  }
-  if (args.hint.constraint?.kind === "render_required") {
-    return `${subject} requires a live browser-rendered page.`;
-  }
-  return `${subject} requires manual browser follow-up; this run did not determine whether login or page rendering is required.`;
-};
-var summarizePrimaryProviderIssue = (failures) => {
-  if (!Array.isArray(failures) || failures.length === 0) return null;
-  let best = null;
-  for (const failure of failures) {
-    const hint = readProviderIssueHint({
-      reasonCode: failure.error?.reasonCode,
-      code: failure.error?.code,
-      message: failure.error?.message,
-      details: failure.error?.details
-    });
-    if (!hint) continue;
-    const summary = summarizeProviderIssue({ provider: failure.provider, hint });
-    const guidance = buildProviderIssueGuidance({
-      provider: failure.provider,
-      hint,
-      details: failure.error?.details
-    });
-    const candidate = {
-      provider: failure.provider,
-      summary,
-      ...hint,
-      ...guidance ? { guidance } : {}
-    };
-    if (!best || summaryPriority(candidate) > summaryPriority(best)) {
-      best = candidate;
-    }
-  }
-  return best;
-};
-
 // src/providers/normalize.ts
-import { createHash, randomUUID as randomUUID2 } from "crypto";
+import { createHash, randomUUID } from "crypto";
 var createTraceContext = (seed = {}, provider) => {
   return {
-    requestId: seed.requestId ?? randomUUID2(),
+    requestId: seed.requestId ?? randomUUID(),
     ...seed.sessionId ? { sessionId: seed.sessionId } : {},
     ...seed.targetId ? { targetId: seed.targetId } : {},
     ...provider ?? seed.provider ? { provider: provider ?? seed.provider } : {},
@@ -1648,9 +749,9 @@ var HUMAN_VERIFICATION_RE = /\b(captcha|verify (?:that )?you(?:'re| are) human|s
 var NON_SECRET_FIELD_RE = /\b(email|e-mail|username|first name|last name|full name|company|phone|city|state|country|linkedin|portfolio|resume|cv)\b/i;
 var CHECKPOINT_RE = /\b(next|continue|resume|verify|submit|approve|allow)\b/i;
 var LOGIN_PAGE_RE = /\/(login|signin|sign-in|auth|session)(?:[/?#]|$)/i;
-var GOOGLE_AUTH_RE = /\b(?:continue with google|sign in with google|log in with google|google sign(?: |-)?in|google)\b/i;
-var GITHUB_AUTH_RE = /\b(?:continue with github|sign in with github|log in with github|github)\b/i;
-var APPLE_AUTH_RE = /\b(?:continue with apple|sign in with apple|log in with apple|apple)\b/i;
+var GOOGLE_AUTH_RE = /\b(?:continue with google|sign in with google|log in with google|google sign(?: |-)?in)\b/i;
+var GITHUB_AUTH_RE = /\b(?:continue with github|sign in with github|log in with github|github sign(?: |-)?in)\b/i;
+var APPLE_AUTH_RE = /\b(?:continue with apple|sign in with apple|log in with apple|apple sign(?: |-)?in)\b/i;
 var ACCOUNT_CHOOSER_NOISE_RE = /\b(?:help|privacy|terms|learn more|english|afrikaans|espa[ñn]ol)\b/i;
 var CLICK_ACTION_RE = /\b(click|tap|select|choose|continue|allow|dismiss|close|not now|got it|delivery|pickup|ship(?:ping)? here)\b/i;
 var HOLD_ACTION_RE = /\b(?:click|press|tap|activate)\s+(?:and\s+)?hold\b|\bhold (?:the )?(?:button|slider)\b/i;
@@ -2867,7 +1968,7 @@ var executeStep = async (args) => {
       });
       await args.handle.pointerMove(args.sessionId, point.x, point.y, args.targetId, 12);
       await args.handle.pointerDown(args.sessionId, point.x, point.y, args.targetId, "left", 1);
-      await new Promise((resolve2) => setTimeout(resolve2, Math.max(250, args.step.holdMs ?? DEFAULT_HOLD_MS2)));
+      await new Promise((resolve) => setTimeout(resolve, Math.max(250, args.step.holdMs ?? DEFAULT_HOLD_MS2)));
       await args.handle.pointerUp(args.sessionId, point.x, point.y, args.targetId, "left", 1);
       return;
     }
@@ -3948,6 +3049,14 @@ var assertPostPolicy = async (context, hooks = []) => {
 
 // src/providers/shared/traversal-url.ts
 var STATIC_HOST_PATTERNS = [
+  /(^|\.)analytics\.google\.com$/i,
+  /(^|\.)fonts\.googleapis\.com$/i,
+  /(^|\.)google-analytics\.com$/i,
+  /(^|\.)googleadservices\.com$/i,
+  /(^|\.)googletagmanager\.com$/i,
+  /(^|\.)googlesyndication\.com$/i,
+  /(^|\.)gstatic\.com$/i,
+  /(^|\.)doubleclick\.net$/i,
   /(^|\.)redditstatic\.com$/i,
   /(^|\.)twimg\.com$/i,
   /(^|\.)static\.licdn\.com$/i,
@@ -3956,6 +3065,49 @@ var STATIC_HOST_PATTERNS = [
   /(^|\.)cdninstagram\.com$/i
 ];
 var STATIC_PATH_EXT_RE = /\.(?:avif|bmp|css|csv|gif|ico|jpe?g|js|json|map|mjs|mp3|mp4|ogg|pdf|png|svg|txt|wav|webm|webp|woff2?|xml|zip)$/i;
+var RESEARCH_DEAD_END_LOGIN_SEGMENTS = /* @__PURE__ */ new Set([
+  "account",
+  "accounts",
+  "login",
+  "sign-in",
+  "signin",
+  "submit"
+]);
+var RESEARCH_DEAD_END_PRIVACY_ROOT_SEGMENTS = /* @__PURE__ */ new Set([
+  "choice",
+  "choices",
+  "consent",
+  "cookie",
+  "cookie-policy",
+  "cookie-preferences",
+  "cookies",
+  "legal",
+  "policies",
+  "policy",
+  "privacy",
+  "privacy-policy",
+  "prefs",
+  "preferences",
+  "terms",
+  "terms-of-service"
+]);
+var RESEARCH_DEAD_END_SEARCH_ROOT_SEGMENTS = /* @__PURE__ */ new Set(["find", "results", "search"]);
+var RESEARCH_DEAD_END_OTHER_ROOT_SEGMENTS = /* @__PURE__ */ new Set(["settings", "verification"]);
+var RESEARCH_DEAD_END_PATHS = /* @__PURE__ */ new Set([
+  "/legal/privacy",
+  "/policies",
+  "/privacy",
+  "/privacy-policy",
+  "/privacy/choices",
+  "/privacychoices",
+  "/privacychoices/"
+]);
+var isPrivacyDeadEndPath = (segments) => {
+  const [first, second] = segments;
+  if (!first || !RESEARCH_DEAD_END_PRIVACY_ROOT_SEGMENTS.has(first)) return false;
+  if (segments.length === 1) return true;
+  return first === "consent" && second === "manage" || first === "privacy" && second === "choices" || first === "prefs" && second === "privacy" || first === "preferences" && second === "privacy" || first === "legal" && (second === "privacy" || second === "terms") || first === "policies" && second === "privacy-policy";
+};
 var isLikelyDocumentUrl = (value) => {
   try {
     const parsed = new URL(value);
@@ -3969,6 +3121,22 @@ var isLikelyDocumentUrl = (value) => {
     return false;
   }
 };
+var isLikelyResearchDestinationUrl = (value) => {
+  return classifyResearchDestinationRejection(value) === null;
+};
+var classifyResearchDestinationRejection = (value) => {
+  if (!isLikelyDocumentUrl(value)) return "research_dead_end_shell";
+  const parsed = new URL(value);
+  const pathname = parsed.pathname.toLowerCase().replace(/\/+$/, "") || "/";
+  if (RESEARCH_DEAD_END_PATHS.has(pathname)) return "privacy_preference_shell";
+  const segments = pathname.split("/").filter(Boolean);
+  const firstSegment = segments[0] ?? "";
+  if (segments.some((segment) => RESEARCH_DEAD_END_LOGIN_SEGMENTS.has(segment))) return "login_shell";
+  if (RESEARCH_DEAD_END_SEARCH_ROOT_SEGMENTS.has(firstSegment)) return "search_results_shell";
+  if (RESEARCH_DEAD_END_OTHER_ROOT_SEGMENTS.has(firstSegment)) return "research_dead_end_shell";
+  if (isPrivacyDeadEndPath(segments)) return "privacy_preference_shell";
+  return null;
+};
 
 // src/providers/web/policy.ts
 var normalizeDomain = (value) => value.trim().toLowerCase();
@@ -4517,8 +3685,8 @@ var CrawlWorkerPool = class {
     }
     const taskId = this.nextTaskId;
     this.nextTaskId += 1;
-    return new Promise((resolve2, reject) => {
-      this.queue.push({ id: taskId, input, resolve: resolve2, reject });
+    return new Promise((resolve, reject) => {
+      this.queue.push({ id: taskId, input, resolve, reject });
       this.dispatch();
     });
   }
@@ -5122,7 +4290,7 @@ var coerceStringArray = (value) => {
   return value.filter((entry) => typeof entry === "string");
 };
 var extractLinks2 = (row, fallbackUrl) => {
-  const attributeLinks = [
+  const attributeLinks2 = [
     ...coerceStringArray(row.attributes?.links),
     ...coerceStringArray(row.attributes?.threadLinks),
     ...coerceStringArray(row.attributes?.replyLinks),
@@ -5130,7 +4298,7 @@ var extractLinks2 = (row, fallbackUrl) => {
   ];
   const contentLinks = [...row.content?.match(LINK_RE) ?? []];
   const deduped = /* @__PURE__ */ new Set();
-  for (const candidate of [...attributeLinks, ...contentLinks]) {
+  for (const candidate of [...attributeLinks2, ...contentLinks]) {
     const canonical = canonicalizeUrl(candidate);
     if (!isHttpUrl2(canonical) || canonical === fallbackUrl || !isLikelyDocumentUrl(canonical)) continue;
     deduped.add(canonical);
@@ -5206,13 +4374,21 @@ var createCommunityProvider = (options = {}) => {
     const pending = [];
     const rows = [];
     for (let page = 1; page <= traversal.pageLimit && rows.length < traversal.maxRecords; page += 1) {
-      const pageRows = await options.search({
-        ...input,
-        filters: {
-          ...input.filters ?? {},
-          page
+      let pageRows;
+      try {
+        pageRows = await options.search({
+          ...input,
+          filters: {
+            ...input.filters ?? {},
+            page
+          }
+        }, context);
+      } catch (error) {
+        if (rows.length > 0 && shouldSkipExpansionError(error)) {
+          break;
         }
-      }, context);
+        throw error;
+      }
       for (const row of sortRows(pageRows)) {
         const canonical = canonicalizeUrl(row.url);
         if (!isHttpUrl2(canonical) || seen.has(canonical)) continue;
@@ -5469,6 +4645,7 @@ var createCommunityProvider = (options = {}) => {
 // src/providers/social/search-quality.ts
 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 SOCIAL_JS_REQUIRED_SHELL_CONTEXT_RE = /\b(?:supported browsers?|help center|something went wrong|try again|privacy policy|cookie policy|ads info)\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;
 var REDDIT_VERIFICATION_WALL_RE = /\b(?:please wait for verification|verify (?:you(?:'re| are) human|that you(?:'re| are) human)|security check)\b/i;
@@ -5585,8 +4762,6 @@ var isRootShellUrl = (platform, parsed) => {
       return isBlockedFacebookNonContentUrl(parsed, { includeSearchRoute: false });
     case "threads":
       return isPrimaryThreadsHost(host) && (pathname === "/" || pathname === "/login" || pathname === "/login/");
-    default:
-      return false;
   }
 };
 var isBlockedExpansionPath = (platform, parsed) => {
@@ -5603,8 +4778,6 @@ var isBlockedExpansionPath = (platform, parsed) => {
       return isBlockedFacebookNonContentUrl(parsed, { includeSearchRoute: true });
     case "threads":
       return isPrimaryThreadsHost(host) && (pathname === "/" || pathname === "/login" || pathname === "/search" || pathname === "/search/" || isStaticMetadataPath(pathname));
-    default:
-      return false;
   }
 };
 var isFirstPartySearchRoute = (platform, parsed) => {
@@ -5621,8 +4794,6 @@ var isFirstPartySearchRoute = (platform, parsed) => {
       return isPrimaryFacebookHost(host) && isFacebookSearchLikePath(pathname);
     case "threads":
       return isPrimaryThreadsHost(host) && (pathname === "/search" || pathname === "/search/");
-    default:
-      return false;
   }
 };
 var collectSocialSearchLinkEvidence = (platform, baseUrl, links) => {
@@ -5662,16 +4833,13 @@ var collectSocialSearchLinkEvidence = (platform, baseUrl, links) => {
 };
 var isUsableFirstPartySearchResultUrl = (platform, url) => {
   const parsed = parseUrl(url);
-  if (!parsed) {
+  if (parsed === null) {
     return false;
   }
   const host = parsed.hostname.toLowerCase();
   if (platform === "x" && host !== "x.com" || platform === "bluesky" && host !== "bsky.app") {
     return false;
   }
-  if (isFirstPartyHelpHost(platform, host)) {
-    return false;
-  }
   return !isBlockedExpansionPath(platform, parsed);
 };
 var isUsableBlueskySearchEvidenceUrl = (url) => {
@@ -5706,19 +4874,9 @@ var isRetainableFacebookSearchSupportUrl = (url) => {
   if (parsed === null || !isPrimaryFacebookHost(parsed.hostname)) {
     return false;
   }
-  if (isBlockedFacebookNonContentUrl(parsed, { includeSearchRoute: true })) {
-    return false;
-  }
-  if (isFirstPartySearchRoute("facebook", parsed)) {
-    return false;
-  }
   return !isUsableFacebookSearchEvidenceUrl(url);
 };
-var hasFacebookSearchResultSignals = (input) => {
-  const parsed = parseUrl(input.url);
-  if (parsed === null || !isFirstPartySearchRoute("facebook", parsed)) {
-    return false;
-  }
+var hasFacebookSearchResultSignals = (parsed, input) => {
   const combined = `${normalizeText2(input.title)} ${normalizeText2(input.content)}`.trim();
   const hasSearchHeading = FACEBOOK_SEARCH_RESULTS_HEADING_RE.test(combined);
   const markerCount = FACEBOOK_SEARCH_RESULT_MARKERS.filter((pattern) => pattern.test(combined)).length;
@@ -5748,14 +4906,12 @@ var isUsableSocialSearchContentUrl = (platform, url) => {
       return isUsableFacebookSearchEvidenceUrl(url);
     case "threads":
       return isUsableThreadsSearchEvidenceUrl(url);
-    default:
-      return false;
   }
 };
 var hasUsableFirstPartySearchEvidence = (platform, parsed, links) => parsed !== null && isFirstPartySearchRoute(platform, parsed) && collectSocialSearchLinkEvidence(platform, parsed.toString(), links).usableContentLinks.length > 0;
 var isFirstPartySocialSearchRoute = (platform, url) => {
   const parsed = parseUrl(url);
-  return parsed !== null && isFirstPartySearchRoute(platform, parsed);
+  return parsed !== null && isTargetedPlatform(platform) && isFirstPartySearchRoute(platform, parsed);
 };
 var detectSocialSearchShell = (platform, input) => {
   if (!isTargetedPlatform(platform)) {
@@ -5770,13 +4926,19 @@ var detectSocialSearchShell = (platform, input) => {
       browserRequired: true
     };
   }
+  if ((platform === "x" || platform === "bluesky") && parsed && SOCIAL_JS_REQUIRED_RE.test(combined) && SOCIAL_JS_REQUIRED_SHELL_CONTEXT_RE.test(combined) && !hasUsableFirstPartySearchEvidence(platform, parsed, links)) {
+    return {
+      providerShell: "social_js_required_shell",
+      browserRequired: true
+    };
+  }
   if (platform === "reddit" && REDDIT_VERIFICATION_WALL_RE.test(combined)) {
     return {
       providerShell: "social_verification_wall",
       browserRequired: true
     };
   }
-  if (platform === "bluesky" && parsed && isFirstPartySearchRoute(platform, parsed) && BLUESKY_LOGGED_OUT_SEARCH_RE.test(combined)) {
+  if (platform === "bluesky" && parsed && isFirstPartySearchRoute(platform, parsed) && BLUESKY_LOGGED_OUT_SEARCH_RE.test(combined) && !hasUsableFirstPartySearchEvidence(platform, parsed, links)) {
     return {
       providerShell: "social_js_required_shell",
       browserRequired: true
@@ -5800,7 +4962,7 @@ var detectSocialSearchShell = (platform, input) => {
       browserRequired: true
     };
   }
-  if (parsed && isFirstPartySearchRoute(platform, parsed) && platform === "facebook" && hasFacebookSearchResultSignals(input)) {
+  if (parsed && isFirstPartySearchRoute(platform, parsed) && platform === "facebook" && hasFacebookSearchResultSignals(parsed, input)) {
     return null;
   }
   if (parsed && isFirstPartySearchRoute(platform, parsed) && !hasUsableFirstPartySearchEvidence(platform, parsed, links)) {
@@ -5958,7 +5120,7 @@ var hasBrowserFallbackMode = (attributes) => typeof attributes?.browser_fallback
 var hasVisibleSearchContent = (row) => typeof row.title === "string" && row.title.trim().length > 0 || typeof row.content === "string" && row.content.trim().length > 0;
 var shouldKeepRecoveredFacebookSearchRow = (platform, row) => platform === "facebook" && hasBrowserFallbackMode(row.attributes) && hasVisibleSearchContent(row);
 var extractLinks3 = (platform, row, fallbackUrl) => {
-  const attributeLinks = [
+  const attributeLinks2 = [
     ...coerceStringArray2(row.attributes?.links),
     ...coerceStringArray2(row.attributes?.threadLinks),
     ...coerceStringArray2(row.attributes?.replyLinks),
@@ -5966,7 +5128,7 @@ var extractLinks3 = (platform, row, fallbackUrl) => {
   ];
   const contentLinks = [...row.content?.match(LINK_RE2) ?? []];
   const deduped = /* @__PURE__ */ new Set();
-  for (const candidate of [...attributeLinks, ...contentLinks]) {
+  for (const candidate of [...attributeLinks2, ...contentLinks]) {
     const canonical = canonicalizeUrl(candidate);
     if (!isHttpUrl3(canonical) || canonical === fallbackUrl || !isLikelyDocumentUrl(canonical) || !isAllowedSocialSearchExpansionUrl(platform, canonical)) {
       continue;
@@ -8678,7 +7840,7 @@ var PROVIDER_PRODUCT_URL_HINT_RE = {
   bestbuy: /\/site\/[^?#]*\/\d+\.p(?:[?#]|$)/i,
   ebay: /\/itm(?:\/|$)/i,
   costco: /(?:\/|\.)(?:product|warehouse)\.[^?#]+\.html(?:[?#]|$)|[?&](?:prodid|itemnumber)=/i,
-  macys: /\/shop\/product\/|[?&]id=\d+/i,
+  macys: /\/shop\/product\/[^?#]+(?:[?#]|$)/i,
   aliexpress: /\/(?:item|i)\/[^?#]+/i,
   temu: /\/(?:goods\.html|g-[^/?#]+\.html)(?:[?#]|$)/i,
   others: /(?:\/ip(?:\/|$)|\/itm(?:\/|$)|\/product(?:s)?\/|\/sku\/|\/site\/[^?#]*\/\d+\.p(?:[?#]|$)|(?:\/|\.)(?:product|warehouse)\.[^?#]+\.html(?:[?#]|$))/i
@@ -8902,6 +8064,14 @@ var requiresBrowserAssistance = (profile, responseUrl, html) => {
         ...text ? { message: toSnippet(text, 400) } : {}
       };
     }
+    const hasPdpErrorShell = textLower.includes("something went wrong") && (textLower.includes("use our search bar") || textLower.includes("pick a category below") || textLower.includes("typed in a url"));
+    if (hasPdpErrorShell) {
+      return {
+        reason: "bestbuy_pdp_error_shell",
+        ...title ? { title } : {},
+        ...text ? { message: toSnippet(text, 400) } : {}
+      };
+    }
   }
   if (profile.name === "target") {
     const isShellPage = /:\s*target$/i.test(title) && textLower.includes("skip to main content") && textLower.includes("skip to footer");
@@ -9496,6 +8666,19 @@ var createDefaultFetch = (profile, providerId, fetcher) => async (input, context
     context
   });
   const extracted = extractStructuredContent(fetched.html, fetched.url);
+  const content = toSnippet(extracted.text, 2e3);
+  const providerShell = requiresBrowserAssistance(profile, fetched.url, fetched.html);
+  if (providerShell) {
+    const pageIssue = classifySearchPageIssue(profile, fetched, extracted, content, providerShell);
+    throwShoppingPageIssue({
+      providerId,
+      fetched,
+      extracted,
+      content,
+      pageIssue: ensureProviderShellIssue(pageIssue, providerShell, content),
+      providerShell
+    });
+  }
   const title = toSnippet(extracted.text, 120) || fetched.url;
   const extractedPrice = extracted.metadata.price ? {
     amount: extracted.metadata.price.amount,
@@ -9856,6 +9039,37 @@ var createWebProvider = (options = {}) => {
   };
 };
 
+// src/providers/bounded-map.ts
+var resolveWorkerCount = (itemCount, limit) => {
+  if (itemCount <= 0) return 0;
+  const finiteLimit = Number.isFinite(limit) ? Math.floor(limit) : 1;
+  return Math.min(Math.max(1, finiteLimit), itemCount);
+};
+var mapBounded = async (items, limit, task) => {
+  const results = new Array(items.length);
+  let cursor = 0;
+  let firstError = null;
+  const workers = Array.from({ length: resolveWorkerCount(items.length, limit) }, async () => {
+    for (; ; ) {
+      if (firstError) return;
+      const index = cursor;
+      cursor += 1;
+      if (index >= items.length) return;
+      try {
+        results[index] = await task(items[index], index);
+      } catch (error) {
+        if (!firstError) {
+          firstError = error instanceof Error ? error : new Error(String(error));
+        }
+        return;
+      }
+    }
+  });
+  await Promise.all(workers);
+  if (firstError) throw firstError;
+  return results;
+};
+
 // src/providers/workflow-contracts.ts
 var isJsonRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 var isWorkflowStage = (value) => value === "compile" || value === "execute" || value === "postprocess" || value === "resume";
@@ -9874,121 +9088,17 @@ var isWorkflowResumePayload = (value) => isJsonRecord(value) && isWorkflowResume
 // src/providers/workflows.ts
 import { createHash as createHash7 } from "crypto";
 
-// src/providers/artifacts.ts
-import { mkdir, readdir as readdir2, readFile, rm as rm2, stat, writeFile } from "fs/promises";
-import { dirname, join as join2, resolve } from "path";
-import { randomUUID as randomUUID3 } from "crypto";
-import { tmpdir as tmpdir2 } from "os";
-var DEFAULT_ARTIFACT_TTL_HOURS = 72;
-var MAX_ARTIFACT_TTL_HOURS = 168;
-var clampTtlHours = (value) => {
-  if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
-    return DEFAULT_ARTIFACT_TTL_HOURS;
-  }
-  return Math.min(MAX_ARTIFACT_TTL_HOURS, Math.floor(value));
-};
-var serializeContent = (content) => {
-  if (typeof content === "string" || Buffer.isBuffer(content)) {
-    return content;
-  }
-  return `${JSON.stringify(content, null, 2)}
-`;
-};
-var createArtifactBundle = async (args) => {
-  const runId = randomUUID3();
-  const now = args.now ?? /* @__PURE__ */ new Date();
-  const ttlHours = clampTtlHours(args.ttlHours);
-  const manifestFileName = args.manifestFileName ?? "bundle-manifest.json";
-  const expiresAt = new Date(now.getTime() + ttlHours * 60 * 60 * 1e3);
-  const root = args.outputDir ? resolve(args.outputDir) : join2(tmpdir2(), "opendevbrowser");
-  const basePath = join2(root, args.namespace, runId);
-  await mkdir(basePath, { recursive: true, mode: 448 });
-  const writtenFiles = [];
-  for (const file of args.files) {
-    const filePath = join2(basePath, file.path);
-    const directory = dirname(filePath);
-    if (directory && directory !== basePath) {
-      await mkdir(directory, { recursive: true, mode: 448 });
-    }
-    await writeFile(filePath, serializeContent(file.content), { mode: 384 });
-    writtenFiles.push(file.path);
-  }
-  const manifest = {
-    run_id: runId,
-    created_at: now.toISOString(),
-    ttl_hours: ttlHours,
-    expires_at: expiresAt.toISOString(),
-    files: [...writtenFiles, manifestFileName]
-  };
-  await writeFile(join2(basePath, manifestFileName), `${JSON.stringify(manifest, null, 2)}
-`, { mode: 384 });
-  return {
-    runId,
-    basePath,
-    manifest,
-    manifestFileName
-  };
-};
-var isExpired = (manifest, now) => {
-  const expiry = new Date(manifest.expires_at);
-  if (Number.isNaN(expiry.getTime())) return false;
-  return expiry.getTime() <= now.getTime();
-};
-var cleanupExpiredArtifacts = async (rootDir, now = /* @__PURE__ */ new Date()) => {
-  const removed = [];
-  const skipped = [];
-  let namespaces = [];
-  try {
-    namespaces = await readdir2(rootDir);
-  } catch {
-    return { removed, skipped };
+// src/providers/workflow-output-root.ts
+import { join as join2 } from "path";
+var WORKFLOW_ARTIFACT_DIRECTORY = ".opendevbrowser";
+var resolveWorkflowArtifactRoot = (outputDir, options = {}) => {
+  if (outputDir === void 0) {
+    return join2(options.workspaceRoot ?? process.cwd(), WORKFLOW_ARTIFACT_DIRECTORY);
   }
-  for (const namespace of namespaces) {
-    const namespacePath = join2(rootDir, namespace);
-    let runs = [];
-    try {
-      runs = await readdir2(namespacePath);
-    } catch {
-      continue;
-    }
-    for (const run of runs) {
-      const runPath = join2(namespacePath, run);
-      const manifestCandidates = [join2(runPath, "bundle-manifest.json"), join2(runPath, "manifest.json")];
-      try {
-        let manifestPath = null;
-        for (const candidate of manifestCandidates) {
-          try {
-            const candidateMetadata = await stat(candidate);
-            if (candidateMetadata.isFile()) {
-              manifestPath = candidate;
-              break;
-            }
-          } catch {
-          }
-        }
-        if (!manifestPath) {
-          skipped.push(runPath);
-          continue;
-        }
-        const metadata = await stat(manifestPath);
-        if (!metadata.isFile()) {
-          skipped.push(runPath);
-          continue;
-        }
-        const manifestRaw = await readFile(manifestPath, "utf8");
-        const manifest = JSON.parse(manifestRaw);
-        if (isExpired(manifest, now)) {
-          await rm2(runPath, { recursive: true, force: true });
-          removed.push(runPath);
-        } else {
-          skipped.push(runPath);
-        }
-      } catch {
-        skipped.push(runPath);
-      }
-    }
+  if (outputDir.trim() === "") {
+    throw new Error("outputDir cannot be empty");
   }
-  return { removed, skipped };
+  return outputDir;
 };
 
 // src/providers/timebox.ts
@@ -10455,235 +9565,27 @@ var design_contract_v1_default = {
     validationTargets: {
       blockOn: [
         "contrast-failure",
-        "keyboard-regression",
-        "stale-search-results",
-        "invalid-route-recovery-failure"
-      ],
-      warnOn: [
-        "responsive-mismatch",
-        "layout-shift",
-        "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."
-      ]
-    }
-  }
-};
-
-// src/inspiredesign/handoff.ts
-var INSPIREDESIGN_HANDOFF_FILES = {
-  designMarkdown: "design.md",
-  advancedBrief: "advanced-brief.md",
-  designContract: "design-contract.json",
-  canvasPlanRequest: "canvas-plan.request.json",
-  designAgentHandoff: "design-agent-handoff.json",
-  generationPlan: "generation-plan.json",
-  implementationPlanMarkdown: "implementation-plan.md",
-  implementationPlan: "implementation-plan.json",
-  evidence: "evidence.json",
-  prototypeGuidance: "prototype-guidance.md"
-};
-var INSPIREDESIGN_HANDOFF_SKILLS = {
-  bestPractices: {
-    name: "opendevbrowser-best-practices",
-    topic: "quick start"
-  },
-  designAgent: {
-    name: "opendevbrowser-design-agent",
-    topic: "canvas-contract"
-  }
-};
-var formatSkillReference = (skill) => `${skill.name} "${skill.topic}"`;
-var formatSkillLoadCommand = (skill) => `opendevbrowser_skill_load ${skill.name} "${skill.topic}"`;
-var INSPIREDESIGN_HANDOFF_COMMANDS = {
-  loadBestPractices: formatSkillLoadCommand(INSPIREDESIGN_HANDOFF_SKILLS.bestPractices),
-  loadDesignAgent: formatSkillLoadCommand(INSPIREDESIGN_HANDOFF_SKILLS.designAgent),
-  continueInCanvas: `opendevbrowser canvas --command canvas.plan.set --params-file ./${INSPIREDESIGN_HANDOFF_FILES.canvasPlanRequest}`
-};
-var INSPIREDESIGN_HANDOFF_RECOMMENDED_SKILLS = [
-  formatSkillReference(INSPIREDESIGN_HANDOFF_SKILLS.bestPractices),
-  formatSkillReference(INSPIREDESIGN_HANDOFF_SKILLS.designAgent)
-];
-var INSPIREDESIGN_HANDOFF_GUIDANCE = {
-  reviewAdvancedBrief: `${INSPIREDESIGN_HANDOFF_FILES.advancedBrief} is the authoritative reference-first brief. When URL references exist, captured evidence leads the creative direction; selected format, profile defaults, layout posture, motion grammar, and anti-patterns are route guardrails only. Read it before touching Canvas or implementation files.`,
-  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"]
+        "keyboard-regression",
+        "stale-search-results",
+        "invalid-route-recovery-failure"
+      ],
+      warnOn: [
+        "responsive-mismatch",
+        "layout-shift",
+        "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."
+      ]
+    }
   }
 };
-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}.`;
 
 // skills/opendevbrowser-design-agent/assets/templates/inspiredesign-advanced-brief.v1.json
 var inspiredesign_advanced_brief_v1_default = {
@@ -14287,10 +13189,111 @@ var createSuccessHandoff = (followthroughSummary, suggestedNextAction, suggested
 });
 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 GATED_PROVIDER_REASON_CODES = /* @__PURE__ */ new Set([
+  "auth_required",
+  "token_required",
+  "challenge_detected"
+]);
+var buildResearchRerunCommand = (input, options = {}) => {
+  const browserMode = options.browserMode ?? input.browserMode ?? "managed";
+  const useCookies = options.useCookies ? " --use-cookies" : "";
+  const challengeMode = options.challengeAutomationMode ? ` --challenge-automation-mode ${options.challengeAutomationMode}` : "";
+  return cliExample(
+    "research run",
+    `--topic ${quoteCliValue(input.topic)} --days 14 --sources web,community --browser-mode ${browserMode}${useCookies}${challengeMode} --mode json --output-format json`
+  );
+};
+var isJsonRecord3 = (value) => Boolean(value) && typeof value === "object" && !Array.isArray(value);
+var readFailureReasonCode = (failure) => {
+  return failure.error.reasonCode ?? normalizeProviderReasonCode({
+    code: failure.error.code,
+    message: failure.error.message,
+    details: failure.error.details
+  }) ?? null;
+};
+var readDiagnosticReasonCode = (diagnostic) => {
+  const reasonCode = diagnostic.reasonCode ?? diagnostic.browserFallbackReasonCode;
+  return isProviderReasonCode(reasonCode) && GATED_PROVIDER_REASON_CODES.has(reasonCode) ? reasonCode : null;
+};
+var cookieDiagnosticShowsAvailableCookies = (diagnostic) => {
+  return diagnostic.available === true || typeof diagnostic.loaded === "number" && diagnostic.loaded > 0 || typeof diagnostic.injected === "number" && diagnostic.injected > 0 || typeof diagnostic.verifiedCount === "number" && diagnostic.verifiedCount > 0;
+};
+var addProviderSignal = (signal, provider, reasonCode) => {
+  if (provider) signal.providers.push(provider);
+  if (reasonCode) signal.reasonCodes.push(reasonCode);
+};
+var readFailureCookieDiagnostics = (failure) => {
+  const candidate = failure.error.details?.cookieDiagnostics;
+  return isJsonRecord3(candidate) ? candidate : null;
+};
+var emptyResearchGatedProviderSignal = () => ({
+  providers: [],
+  reasonCodes: [],
+  useCookies: false
+});
+var normalizeResearchGatedProviderSignal = (signal) => {
+  return signal.providers.length > 0 || signal.reasonCodes.length > 0 ? {
+    providers: [...new Set(signal.providers)].sort(),
+    reasonCodes: [...new Set(signal.reasonCodes)].sort(),
+    useCookies: signal.useCookies
+  } : null;
+};
+var mergeResearchGatedProviderSignals = (signals) => {
+  const merged = emptyResearchGatedProviderSignal();
+  for (const signal of signals) {
+    merged.providers.push(...signal.providers);
+    merged.reasonCodes.push(...signal.reasonCodes);
+    merged.useCookies = merged.useCookies || signal.useCookies;
+  }
+  return merged;
+};
+var detectResearchFailureSignals = (failures) => {
+  const signal = emptyResearchGatedProviderSignal();
+  for (const failure of failures) {
+    const reasonCode = readFailureReasonCode(failure);
+    const isGatedFailure = Boolean(reasonCode && GATED_PROVIDER_REASON_CODES.has(reasonCode));
+    if (isGatedFailure) {
+      addProviderSignal(signal, failure.provider, reasonCode);
+      const diagnostic = readFailureCookieDiagnostics(failure);
+      signal.useCookies = signal.useCookies || Boolean(diagnostic && cookieDiagnosticShowsAvailableCookies(diagnostic));
+    }
+  }
+  return signal;
+};
+var detectResearchCookieSignals = (diagnostics) => {
+  const signal = emptyResearchGatedProviderSignal();
+  for (const diagnostic of diagnostics) {
+    const reasonCode = readDiagnosticReasonCode(diagnostic);
+    const isGatedDiagnostic = Boolean(reasonCode || diagnostic.policy === "required");
+    if (isGatedDiagnostic) {
+      addProviderSignal(signal, typeof diagnostic.provider === "string" ? diagnostic.provider : void 0, reasonCode);
+      signal.useCookies = signal.useCookies || cookieDiagnosticShowsAvailableCookies(diagnostic);
+    }
+  }
+  return signal;
+};
+var detectResearchChallengeSignals = (diagnostics) => {
+  const signal = emptyResearchGatedProviderSignal();
+  for (const diagnostic of diagnostics) {
+    const reasonCode = readDiagnosticReasonCode(diagnostic);
+    if (reasonCode || diagnostic.blockerType === "auth_required" || diagnostic.blockerType === "anti_bot_challenge") {
+      addProviderSignal(signal, typeof diagnostic.provider === "string" ? diagnostic.provider : void 0, reasonCode);
+    }
+  }
+  return signal;
+};
+var detectResearchGatedProviderSignal = (input) => {
+  return normalizeResearchGatedProviderSignal(mergeResearchGatedProviderSignals([
+    detectResearchFailureSignals(input.failures ?? []),
+    detectResearchCookieSignals(input.cookieDiagnostics ?? []),
+    detectResearchChallengeSignals(input.challengeOrchestration ?? [])
+  ]));
+};
+var buildResearchRecoveryRerunCommand = (input, signal) => buildResearchRerunCommand(input, {
+  browserMode: "extension",
+  useCookies: signal.useCookies,
+  challengeAutomationMode: "browser_with_helper"
+});
 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}` : "";
@@ -14318,23 +13321,43 @@ 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 useCookies = options?.useCookies ? " --use-cookies" : "";
   const challenge = options?.challengeAutomationMode ? ` --challenge-automation-mode ${options.challengeAutomationMode}` : "";
+  const cookiePolicy = options?.cookiePolicyOverride ? ` --cookie-policy ${options.cookiePolicyOverride}` : "";
   const outputFormat = options?.includeOutputFormat === false ? "" : " --output-format json";
-  return `--expression ${quoteCliValue(input.expression)}${defaultProvider}${execute}${browserMode}${challenge}${outputFormat}`;
+  return `--expression ${quoteCliValue(input.expression)}${defaultProvider}${execute}${browserMode}${useCookies}${cookiePolicy}${challenge}${outputFormat}`;
 };
 var buildMacroPreviewCommand = (input) => cliExample("macro-resolve", buildMacroResolveArgs(input));
 var buildMacroExecuteCommand = (input, challengeAutomationMode, browserMode) => cliExample("macro-resolve", buildMacroResolveArgs(input, {
   execute: true,
   browserMode,
+  ...browserMode === "extension" ? { useCookies: true, cookiePolicyOverride: "required" } : {},
   challengeAutomationMode
 }));
-var buildResearchSuccessHandoff = (input) => {
+var buildResearchGatedSuccessHandoff = (input, signal) => {
+  const recoveryCommand = buildResearchRecoveryRerunCommand(input, signal);
+  const providers = signal.providers.length > 0 ? signal.providers.join(", ") : "gated providers";
+  const cookieNote = signal.useCookies ? " The command includes --use-cookies because cookie diagnostics show available cookies." : " Add --use-cookies only when legitimate provider cookies are available.";
+  return createSuccessHandoff(
+    `Review ranked records, artifact metadata, and gated-provider diagnostics for ${providers} before publishing claims.`,
+    `Open the returned artifact path, inspect records.json, context.json, meta.json, and report.md, then rerun ${recoveryCommand} only with a user-authorized signed-in relay session.${cookieNote}`,
+    [
+      { reason: "Check records.json, context.json, meta.json, failures, and cookie diagnostics before using the result as evidence." },
+      {
+        reason: "Rerun with an existing signed-in extension session and browser-scoped challenge assistance when gated providers blocked useful evidence.",
+        command: recoveryCommand
+      },
+      { reason: "Keep SERPs discovery-only and publish only claims supported by destination records that passed review." }
+    ]
+  );
+};
+var buildResearchDefaultSuccessHandoff = (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.`,
+    "Review ranked records, artifact metadata, and source support before turning the result into a publishable claim.",
+    `Open the returned artifact path, inspect records.json, context.json, meta.json, and report.md, then rerun ${rerunCommand} if you need a tighter evidence set.`,
     [
-      { reason: "Check which records actually support the final claim." },
+      { reason: "Check which ranked records and artifact metadata actually support the final claim." },
       {
         reason: "Rerun with explicit sources and a narrower timebox if the evidence set is still too broad.",
         command: rerunCommand
@@ -14342,6 +13365,10 @@ var buildResearchSuccessHandoff = (input) => {
     ]
   );
 };
+var buildResearchSuccessHandoff = (input) => {
+  const signal = detectResearchGatedProviderSignal(input);
+  return signal ? buildResearchGatedSuccessHandoff(input, signal) : buildResearchDefaultSuccessHandoff(input);
+};
 var buildShoppingSuccessHandoff = (input) => {
   const rerunCommand = buildShoppingRerunCommand(input);
   return createSuccessHandoff(
@@ -14485,19 +13512,304 @@ var compactResearchLines = (records, meta) => {
   if (records.length === 0) {
     const summary = primaryConstraintSummaryFromMeta(meta);
     return summary ? [
-      "No records matched the requested timebox.",
+      "No usable research findings were available.",
       `Primary constraint: ${summary}`
-    ] : ["No records matched the requested timebox."];
+    ] : ["No usable research findings were available."];
   }
   return records.slice(0, 10).map((record, index) => {
     const title = record.title ?? record.url ?? record.provider;
     const engagement = record.engagement.likes + record.engagement.comments + record.engagement.upvotes;
-    return `${index + 1}. ${title} (${record.source}/${record.provider}) score=${record.confidence.toFixed(2)} engagement=${engagement}`;
+    return `${index + 1}. ${title} (${record.source}; ${record.provider}) score=${record.confidence.toFixed(2)} engagement=${engagement}`;
+  });
+};
+var RESEARCH_REPORT_LIMITS = {
+  findings: 10,
+  sources: 20,
+  failures: 10,
+  excerptCharacters: 240,
+  failureMessageCharacters: 240
+};
+var RESEARCH_REPORT_FILE_NAMES = [
+  "summary.md",
+  "report.md",
+  "records.json",
+  "context.json",
+  "meta.json",
+  "bundle-manifest.json"
+];
+var plainObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value) ? value : {};
+var researchTitle = (record) => record.title ?? record.url ?? record.provider;
+var normalizedInlineText = (content) => content?.replace(/\s+/g, " ").trim() ?? "";
+var boundedInlineText = (args) => {
+  const normalized = normalizedInlineText(args.content);
+  if (!normalized) {
+    return args.fallback;
+  }
+  if (normalized.length <= args.limit) {
+    return normalized;
+  }
+  return `${normalized.slice(0, args.limit)} [truncated; see ${args.target}]`;
+};
+var researchExcerpt = (content) => boundedInlineText({
+  content,
+  fallback: "No content excerpt was available.",
+  limit: RESEARCH_REPORT_LIMITS.excerptCharacters,
+  target: "records.json for full content"
+});
+var researchFailureMessage = (content) => boundedInlineText({
+  content,
+  fallback: "provider failure",
+  limit: RESEARCH_REPORT_LIMITS.failureMessageCharacters,
+  target: "meta.json"
+});
+var limitedCount = (total, limit) => Math.min(total, limit);
+var omissionLine = (args) => {
+  const omitted = args.total - limitedCount(args.total, args.limit);
+  if (omitted <= 0) {
+    return [];
+  }
+  const noun = omitted === 1 ? args.singular : args.plural;
+  return [`- ${omitted} more ${noun} omitted from this report; see ${args.target} for the complete dataset.`];
+};
+var researchFindingsLines = (records) => records.length === 0 ? ["- No usable findings were available."] : [
+  ...records.slice(0, RESEARCH_REPORT_LIMITS.findings).flatMap((record, index) => [
+    `### ${index + 1}. ${researchTitle(record)}`,
+    `- Source: ${record.source}`,
+    `- Provider: ${record.provider}`,
+    `- URL: ${record.url ?? "not provided"}`,
+    `- Published: ${record.timestamp}`,
+    `- Confidence: ${record.confidence.toFixed(2)}`,
+    `- Evidence: ${researchExcerpt(record.content)}`
+  ]),
+  ...omissionLine({
+    total: records.length,
+    limit: RESEARCH_REPORT_LIMITS.findings,
+    singular: "finding",
+    plural: "findings",
+    target: "records.json"
+  })
+];
+var researchSourcesLines = (records) => records.length === 0 ? ["- No sources available."] : [
+  ...records.slice(0, RESEARCH_REPORT_LIMITS.sources).map((record) => `- ${researchTitle(record)}: ${record.url ?? "URL not provided"}`),
+  ...omissionLine({
+    total: records.length,
+    limit: RESEARCH_REPORT_LIMITS.sources,
+    singular: "source",
+    plural: "sources",
+    target: "records.json"
+  })
+];
+var researchReasonLine = (metrics) => {
+  const reasons = Object.entries(plainObject(metrics.sanitized_reason_distribution)).map(([reason, count]) => `${reason}: ${String(count)}`);
+  return reasons.length === 0 ? [] : [`- Sanitized record reasons: ${reasons.join(", ")}`];
+};
+var deadEndSearchFailures = (failures) => {
+  if (!Array.isArray(failures)) return [];
+  return failures.filter((failure) => {
+    const record = plainObject(failure);
+    const error = plainObject(record.error);
+    const details = plainObject(error.details);
+    return details.fallbackOutputReason === "research_dead_end_shell";
   });
 };
+var deadEndSearchFailureCount = (meta) => deadEndSearchFailures(meta.failures).length;
+var rejectedCandidatesFromMeta = (meta) => Array.isArray(meta.rejected_candidates) ? meta.rejected_candidates.map(plainObject).filter((candidate) => Object.keys(candidate).length > 0) : [];
+var rejectedCandidateCount = (meta) => {
+  const metrics = plainObject(meta.metrics);
+  if (typeof metrics.rejected_candidate_count === "number") {
+    return metrics.rejected_candidate_count;
+  }
+  const sanitized = typeof metrics.sanitized_records === "number" ? metrics.sanitized_records : 0;
+  return sanitized + deadEndSearchFailureCount(meta);
+};
+var deadEndSearchFailureLines = (meta) => {
+  const failures = deadEndSearchFailures(meta.failures);
+  if (failures.length === 0) return [];
+  return [`- Dead-end search failures: ${failures.length}`];
+};
+var researchRejectedCandidateSummary = (candidate) => {
+  const reason = typeof candidate.reason === "string" ? candidate.reason : "unknown_reason";
+  const provider = typeof candidate.provider === "string" ? candidate.provider : "unknown_provider";
+  const source = typeof candidate.source === "string" ? candidate.source : "unknown_source";
+  const status = typeof candidate.replacement_status === "string" ? candidate.replacement_status : "not_recorded";
+  const retrievalPath = typeof candidate.retrievalPath === "string" ? `; path=${candidate.retrievalPath}` : "";
+  const url = typeof candidate.url === "string" ? candidate.url : "URL not recorded";
+  return `${reason} from ${provider} (${source}; ${status}${retrievalPath}): ${url}`;
+};
+var researchFailureSummary = (failure) => {
+  const record = plainObject(failure);
+  const error = plainObject(record.error);
+  const provider = typeof record.provider === "string" ? record.provider : "unknown";
+  const source = typeof record.source === "string" ? record.source : "unknown";
+  const reason = typeof error.reasonCode === "string" ? `${error.reasonCode}: ` : "";
+  const message = researchFailureMessage(typeof error.message === "string" ? error.message : void 0);
+  return `${provider} (${source}): ${reason}${message}`;
+};
+var researchFailureLines = (failures) => {
+  if (!Array.isArray(failures) || failures.length === 0) {
+    return [];
+  }
+  const summaries = failures.slice(0, RESEARCH_REPORT_LIMITS.failures).map(researchFailureSummary);
+  const omitted = failures.length - summaries.length;
+  const noun = omitted === 1 ? "failure" : "failures";
+  const suffix = omitted > 0 ? `; ${omitted} more provider ${noun} omitted from this report; see meta.json` : "";
+  return [`- Provider failures: ${summaries.join("; ")}${suffix}`];
+};
+var researchGapLines = (meta) => {
+  const metrics = plainObject(meta.metrics);
+  const details = [
+    typeof metrics.final_records === "number" ? `- Final records reported by workflow: ${metrics.final_records}` : "",
+    typeof metrics.sanitized_records === "number" ? `- Sanitized records excluded: ${metrics.sanitized_records}` : "",
+    ...researchReasonLine(metrics),
+    ...researchFailureLines(meta.failures)
+  ].filter(Boolean);
+  const constraint = primaryConstraintSummaryFromMeta(meta);
+  const fallback = "- No provider limitations or sanitization gaps were reported.";
+  const gapDetails = details.length > 0 || constraint ? details : [fallback];
+  return [
+    "## Confidence and Gaps",
+    ...constraint ? [`- Primary constraint: ${constraint}`] : [],
+    ...gapDetails
+  ];
+};
+var researchSearchDirectionLines = (meta) => {
+  const selection = plainObject(meta.selection);
+  const sources = Array.isArray(selection.resolved_sources) ? selection.resolved_sources.map(String).join(", ") : "not recorded";
+  return [
+    "## Search Direction",
+    `- Source families searched: ${sources}`,
+    "- Direction: Follow accepted destination pages from provider/search output before synthesis."
+  ];
+};
+var researchSourceFamilies = (meta) => {
+  const sources = plainObject(meta.selection).resolved_sources;
+  return Array.isArray(sources) ? sources.map(String) : [];
+};
+var researchCandidateTriageSchema = () => ({
+  url: "",
+  rank: 0,
+  engine: "",
+  query: "",
+  source_family: "",
+  title: "",
+  status: "pending|accepted|rejected",
+  blocker_notes: "",
+  rejection_reason: "",
+  replacement_url: "",
+  retrieval_notes: "",
+  extraction_status: "pending|fetched|blocked|shell|stale|irrelevant"
+});
+var researchCandidateTriageLines = (records, meta) => {
+  const rejected = rejectedCandidateCount(meta);
+  return [
+    "## Candidate Triage",
+    `- Accepted destination records: ${records.length}`,
+    `- Rejected shell or dead-end candidates: ${rejected}`,
+    "- Rejection policy: search pages, login/account pages, privacy/cookie pages, JavaScript shells, not-found pages, and unsupported shells are not final evidence."
+  ];
+};
+var researchRejectedCandidateLines = (meta) => {
+  const rejectedCandidates = rejectedCandidatesFromMeta(meta);
+  const rejectionLines = [
+    ...researchReasonLine(plainObject(meta.metrics)),
+    ...rejectedCandidates.slice(0, RESEARCH_REPORT_LIMITS.failures).map((candidate) => `- Rejected candidate: ${researchRejectedCandidateSummary(candidate)}`),
+    ...deadEndSearchFailureLines(meta)
+  ];
+  return [
+    "## Rejected Candidates",
+    ...rejectionLines,
+    ...rejectionLines.length === 0 ? ["- No rejected candidate distribution was reported."] : []
+  ];
+};
+var researchDeepDiveLines = (records) => [
+  "## Deep Dives",
+  ...records.length === 0 ? ["- No destination pages passed the evidence gate."] : records.slice(0, RESEARCH_REPORT_LIMITS.sources).map((record) => {
+    const retrievalPath = typeof record.attributes.retrievalPath === "string" ? record.attributes.retrievalPath : "";
+    const prefix = retrievalPath.includes(":fetch:") ? "Opened destination evidence" : "Accepted evidence record";
+    return `- ${prefix}: ${record.url ?? researchTitle(record)}`;
+  })
+];
+var researchSynthesisFeedbackText = (records, meta) => {
+  const rejected = rejectedCandidateCount(meta);
+  return records.length === 0 || rejected > records.length ? "Continue with remaining public destination candidates or narrow the query; use auth/cookies only when a selected evidence page itself requires authorized access." : "Synthesize only the accepted destination evidence and cite records.json for full source text.";
+};
+var researchSynthesisFeedbackLines = (records, meta) => {
+  return ["## Synthesis Feedback", `- Next step: ${researchSynthesisFeedbackText(records, meta)}`];
+};
+var researchContextPayload = (args) => ({
+  topic: args.topic,
+  timebox: plainObject(args.meta.timebox),
+  source_families: researchSourceFamilies(args.meta),
+  evidence_gate: {
+    status: "pending_review",
+    reviewed_artifacts: []
+  },
+  artifact_files: RESEARCH_REPORT_FILE_NAMES,
+  source_ledger: args.records.map((record) => ({
+    title: researchTitle(record),
+    url: record.url,
+    source_family: record.source,
+    provider: record.provider
+  })),
+  search_direction_notes: researchSearchDirectionLines(args.meta),
+  candidate_triage_schema: researchCandidateTriageSchema(),
+  highlights: args.lines,
+  records: args.records,
+  candidate_triage: {
+    accepted_destination_records: args.records.length,
+    rejected_shell_or_dead_end_candidates: rejectedCandidateCount(args.meta)
+  },
+  rejected_candidates: rejectedCandidatesFromMeta(args.meta),
+  deep_dive_pages: args.records.map((record) => ({
+    title: researchTitle(record),
+    url: record.url,
+    provider: record.provider,
+    source: record.source,
+    retrievalPath: record.attributes.retrievalPath
+  })),
+  iteration_log: researchSearchDirectionLines(args.meta),
+  synthesis_feedback: researchSynthesisFeedbackText(args.records, args.meta),
+  meta: args.meta
+});
+var researchArtifactFileLines = () => [
+  "## Report Files",
+  ...RESEARCH_REPORT_FILE_NAMES.map((fileName) => `- ${fileName}`)
+];
+var buildResearchReport = (args) => [
+  "# Research Report",
+  "",
+  "## Executive Summary",
+  `- Topic: ${args.topic}`,
+  `- Usable findings: ${args.records.length}`,
+  `- Findings shown in report: ${limitedCount(args.records.length, RESEARCH_REPORT_LIMITS.findings)}`,
+  `- Sources shown in report: ${limitedCount(args.records.length, RESEARCH_REPORT_LIMITS.sources)}`,
+  "- Final output: Usable records are persisted in records.json.",
+  "- Diagnostics: Run metadata, failures, and constraints are persisted in meta.json; this report summarizes the bounded inline subset.",
+  "",
+  ...researchArtifactFileLines(),
+  "",
+  ...researchSearchDirectionLines(args.meta),
+  "",
+  ...researchCandidateTriageLines(args.records, args.meta),
+  "",
+  ...researchRejectedCandidateLines(args.meta),
+  "",
+  ...researchDeepDiveLines(args.records),
+  "",
+  ...researchSynthesisFeedbackLines(args.records, args.meta),
+  "",
+  "## Findings",
+  ...researchFindingsLines(args.records),
+  "",
+  ...researchGapLines(args.meta),
+  "",
+  "## Sources",
+  ...researchSourcesLines(args.records)
+].join("\n");
 var renderResearch = (args) => {
   const lines = compactResearchLines(args.records, args.meta);
   const summary = lines.join("\n");
+  const report = buildResearchReport(args);
   const markdown = [
     `# Research: ${args.topic}`,
     "",
@@ -14508,14 +13820,15 @@ var renderResearch = (args) => {
     JSON.stringify(args.meta, null, 2),
     "```"
   ].join("\n");
-  const contextPayload = {
+  const contextPayload = researchContextPayload({
     topic: args.topic,
-    highlights: lines,
+    lines,
     records: args.records,
     meta: args.meta
-  };
+  });
   const files = [
     { path: "summary.md", content: markdown },
+    { path: "report.md", content: report },
     { path: "records.json", content: { records: args.records } },
     { path: "context.json", content: contextPayload },
     { path: "meta.json", content: args.meta }
@@ -15636,14 +14949,14 @@ import { createHash as createHash5 } from "crypto";
 var DEFAULT_SHOPPING_SEARCH_LIMIT = 8;
 var SHOPPING_FETCH_RECOVERY_LIMIT = 2;
 var SEARCH_INDEX_RETRIEVAL_PATHS = /* @__PURE__ */ new Set(["shopping:search:index", "shopping:search:link"]);
-var isJsonRecord3 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var isJsonRecord4 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 var isFiniteNumber = (value) => typeof value === "number" && Number.isFinite(value);
 var isProviderSource = (value) => value === "web" || value === "community" || value === "social" || value === "shopping";
-var isTraceContext = (value) => isJsonRecord3(value) && typeof value.requestId === "string" && typeof value.ts === "string" && (value.sessionId === void 0 || typeof value.sessionId === "string") && (value.targetId === void 0 || typeof value.targetId === "string") && (value.provider === void 0 || typeof value.provider === "string");
-var isProviderError2 = (value) => isJsonRecord3(value) && typeof value.code === "string" && typeof value.message === "string" && typeof value.retryable === "boolean" && (value.reasonCode === void 0 || typeof value.reasonCode === "string") && (value.provider === void 0 || typeof value.provider === "string") && (value.source === void 0 || isProviderSource(value.source)) && (value.details === void 0 || isJsonRecord3(value.details));
-var isNormalizedRecord = (value) => isJsonRecord3(value) && typeof value.id === "string" && isProviderSource(value.source) && typeof value.provider === "string" && (value.url === void 0 || typeof value.url === "string") && (value.title === void 0 || typeof value.title === "string") && (value.content === void 0 || typeof value.content === "string") && typeof value.timestamp === "string" && isFiniteNumber(value.confidence) && isJsonRecord3(value.attributes);
-var isProviderFailureEntry = (value) => isJsonRecord3(value) && typeof value.provider === "string" && isProviderSource(value.source) && isProviderError2(value.error);
-var isProviderAggregateResult = (value) => isJsonRecord3(value) && typeof value.ok === "boolean" && Array.isArray(value.records) && value.records.every((entry) => isNormalizedRecord(entry)) && isTraceContext(value.trace) && typeof value.partial === "boolean" && Array.isArray(value.failures) && value.failures.every((entry) => isProviderFailureEntry(entry)) && isJsonRecord3(value.metrics) && isFiniteNumber(value.metrics.attempted) && isFiniteNumber(value.metrics.succeeded) && isFiniteNumber(value.metrics.failed) && isFiniteNumber(value.metrics.retries) && isFiniteNumber(value.metrics.latencyMs) && typeof value.sourceSelection === "string" && Array.isArray(value.providerOrder) && value.providerOrder.every((entry) => typeof entry === "string") && (value.meta === void 0 || isJsonRecord3(value.meta)) && (value.diagnostics === void 0 || isJsonRecord3(value.diagnostics)) && (value.error === void 0 || isProviderError2(value.error));
+var isTraceContext = (value) => isJsonRecord4(value) && typeof value.requestId === "string" && typeof value.ts === "string" && (value.sessionId === void 0 || typeof value.sessionId === "string") && (value.targetId === void 0 || typeof value.targetId === "string") && (value.provider === void 0 || typeof value.provider === "string");
+var isProviderError2 = (value) => isJsonRecord4(value) && typeof value.code === "string" && typeof value.message === "string" && typeof value.retryable === "boolean" && (value.reasonCode === void 0 || typeof value.reasonCode === "string") && (value.provider === void 0 || typeof value.provider === "string") && (value.source === void 0 || isProviderSource(value.source)) && (value.details === void 0 || isJsonRecord4(value.details));
+var isNormalizedRecord = (value) => isJsonRecord4(value) && typeof value.id === "string" && isProviderSource(value.source) && typeof value.provider === "string" && (value.url === void 0 || typeof value.url === "string") && (value.title === void 0 || typeof value.title === "string") && (value.content === void 0 || typeof value.content === "string") && typeof value.timestamp === "string" && isFiniteNumber(value.confidence) && isJsonRecord4(value.attributes);
+var isProviderFailureEntry = (value) => isJsonRecord4(value) && typeof value.provider === "string" && isProviderSource(value.source) && isProviderError2(value.error);
+var isProviderAggregateResult = (value) => isJsonRecord4(value) && typeof value.ok === "boolean" && Array.isArray(value.records) && value.records.every((entry) => isNormalizedRecord(entry)) && isTraceContext(value.trace) && typeof value.partial === "boolean" && Array.isArray(value.failures) && value.failures.every((entry) => isProviderFailureEntry(entry)) && isJsonRecord4(value.metrics) && isFiniteNumber(value.metrics.attempted) && isFiniteNumber(value.metrics.succeeded) && isFiniteNumber(value.metrics.failed) && isFiniteNumber(value.metrics.retries) && isFiniteNumber(value.metrics.latencyMs) && typeof value.sourceSelection === "string" && Array.isArray(value.providerOrder) && value.providerOrder.every((entry) => typeof entry === "string") && (value.meta === void 0 || isJsonRecord4(value.meta)) && (value.diagnostics === void 0 || isJsonRecord4(value.diagnostics)) && (value.error === void 0 || isProviderError2(value.error));
 var emptyCheckpointState = () => ({
   completed_step_ids: [],
   step_results_by_id: {}
@@ -15659,7 +14972,7 @@ var readShoppingCheckpointState = (checkpoint) => {
   if (state === void 0 || state === null) {
     return emptyCheckpointState();
   }
-  if (!isJsonRecord3(state)) {
+  if (!isJsonRecord4(state)) {
     throw new Error("Shopping workflow checkpoint state must be a record.");
   }
   const completedStepIds = state.completed_step_ids;
@@ -15667,7 +14980,7 @@ var readShoppingCheckpointState = (checkpoint) => {
     throw new Error("Shopping workflow checkpoint state is missing valid completed_step_ids.");
   }
   const rawResults = state.step_results_by_id;
-  if (!isJsonRecord3(rawResults)) {
+  if (!isJsonRecord4(rawResults)) {
     throw new Error("Shopping workflow checkpoint state is missing valid step_results_by_id.");
   }
   const stepResultsById = {};
@@ -15978,14 +15291,14 @@ var PRODUCT_VIDEO_STEP_IDS = {
   extractProductData: "product_video:extract_product_data",
   assembleArtifacts: "product_video:assemble_artifacts"
 };
-var isJsonRecord4 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var isJsonRecord5 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 var isFiniteNumber2 = (value) => typeof value === "number" && Number.isFinite(value);
 var isProviderSource2 = (value) => value === "web" || value === "community" || value === "social" || value === "shopping";
-var isTraceContext2 = (value) => isJsonRecord4(value) && typeof value.requestId === "string" && typeof value.ts === "string" && (value.sessionId === void 0 || typeof value.sessionId === "string") && (value.targetId === void 0 || typeof value.targetId === "string") && (value.provider === void 0 || typeof value.provider === "string");
-var isProviderError3 = (value) => isJsonRecord4(value) && typeof value.code === "string" && typeof value.message === "string" && typeof value.retryable === "boolean" && (value.reasonCode === void 0 || typeof value.reasonCode === "string") && (value.provider === void 0 || typeof value.provider === "string") && (value.source === void 0 || isProviderSource2(value.source)) && (value.details === void 0 || isJsonRecord4(value.details));
-var isNormalizedRecord2 = (value) => isJsonRecord4(value) && typeof value.id === "string" && isProviderSource2(value.source) && typeof value.provider === "string" && (value.url === void 0 || typeof value.url === "string") && (value.title === void 0 || typeof value.title === "string") && (value.content === void 0 || typeof value.content === "string") && typeof value.timestamp === "string" && isFiniteNumber2(value.confidence) && isJsonRecord4(value.attributes);
-var isProviderFailureEntry2 = (value) => isJsonRecord4(value) && typeof value.provider === "string" && isProviderSource2(value.source) && isProviderError3(value.error);
-var isProviderAggregateResult2 = (value) => isJsonRecord4(value) && typeof value.ok === "boolean" && Array.isArray(value.records) && value.records.every((entry) => isNormalizedRecord2(entry)) && isTraceContext2(value.trace) && typeof value.partial === "boolean" && Array.isArray(value.failures) && value.failures.every((entry) => isProviderFailureEntry2(entry)) && isJsonRecord4(value.metrics) && isFiniteNumber2(value.metrics.attempted) && isFiniteNumber2(value.metrics.succeeded) && isFiniteNumber2(value.metrics.failed) && isFiniteNumber2(value.metrics.retries) && isFiniteNumber2(value.metrics.latencyMs) && typeof value.sourceSelection === "string" && Array.isArray(value.providerOrder) && value.providerOrder.every((entry) => typeof entry === "string") && (value.meta === void 0 || isJsonRecord4(value.meta)) && (value.diagnostics === void 0 || isJsonRecord4(value.diagnostics)) && (value.error === void 0 || isProviderError3(value.error));
+var isTraceContext2 = (value) => isJsonRecord5(value) && typeof value.requestId === "string" && typeof value.ts === "string" && (value.sessionId === void 0 || typeof value.sessionId === "string") && (value.targetId === void 0 || typeof value.targetId === "string") && (value.provider === void 0 || typeof value.provider === "string");
+var isProviderError3 = (value) => isJsonRecord5(value) && typeof value.code === "string" && typeof value.message === "string" && typeof value.retryable === "boolean" && (value.reasonCode === void 0 || typeof value.reasonCode === "string") && (value.provider === void 0 || typeof value.provider === "string") && (value.source === void 0 || isProviderSource2(value.source)) && (value.details === void 0 || isJsonRecord5(value.details));
+var isNormalizedRecord2 = (value) => isJsonRecord5(value) && typeof value.id === "string" && isProviderSource2(value.source) && typeof value.provider === "string" && (value.url === void 0 || typeof value.url === "string") && (value.title === void 0 || typeof value.title === "string") && (value.content === void 0 || typeof value.content === "string") && typeof value.timestamp === "string" && isFiniteNumber2(value.confidence) && isJsonRecord5(value.attributes);
+var isProviderFailureEntry2 = (value) => isJsonRecord5(value) && typeof value.provider === "string" && isProviderSource2(value.source) && isProviderError3(value.error);
+var isProviderAggregateResult2 = (value) => isJsonRecord5(value) && typeof value.ok === "boolean" && Array.isArray(value.records) && value.records.every((entry) => isNormalizedRecord2(entry)) && isTraceContext2(value.trace) && typeof value.partial === "boolean" && Array.isArray(value.failures) && value.failures.every((entry) => isProviderFailureEntry2(entry)) && isJsonRecord5(value.metrics) && isFiniteNumber2(value.metrics.attempted) && isFiniteNumber2(value.metrics.succeeded) && isFiniteNumber2(value.metrics.failed) && isFiniteNumber2(value.metrics.retries) && isFiniteNumber2(value.metrics.latencyMs) && typeof value.sourceSelection === "string" && Array.isArray(value.providerOrder) && value.providerOrder.every((entry) => typeof entry === "string") && (value.meta === void 0 || isJsonRecord5(value.meta)) && (value.diagnostics === void 0 || isJsonRecord5(value.diagnostics)) && (value.error === void 0 || isProviderError3(value.error));
 var emptyCheckpointState2 = () => ({
   completed_step_ids: []
 });
@@ -16028,7 +15341,7 @@ var readProductVideoCheckpointState = (checkpoint) => {
   if (state === void 0 || state === null) {
     return emptyCheckpointState2();
   }
-  if (!isJsonRecord4(state)) {
+  if (!isJsonRecord5(state)) {
     throw new Error("Product-video workflow checkpoint state must be a record.");
   }
   const completedStepIds = state.completed_step_ids;
@@ -16139,15 +15452,16 @@ import { createHash as createHash6 } from "crypto";
 var RESEARCH_AUTO_SOURCES = ["web", "community", "social"];
 var RESEARCH_ALL_SOURCES = [...RESEARCH_AUTO_SOURCES];
 var DEFAULT_RESEARCH_SEARCH_LIMIT = 10;
-var RESEARCH_WEB_SEARCH_FETCH_LIMIT = 3;
-var isJsonRecord5 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var RESEARCH_WEB_SEARCH_FETCH_LIMIT = 5;
+var RESEARCH_COMMUNITY_EXPANSION_PER_RECORD = 2;
+var isJsonRecord6 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 var isFiniteNumber3 = (value) => typeof value === "number" && Number.isFinite(value);
 var isProviderSource3 = (value) => value === "web" || value === "community" || value === "social" || value === "shopping";
-var isTraceContext3 = (value) => isJsonRecord5(value) && typeof value.requestId === "string" && typeof value.ts === "string" && (value.sessionId === void 0 || typeof value.sessionId === "string") && (value.targetId === void 0 || typeof value.targetId === "string") && (value.provider === void 0 || typeof value.provider === "string");
-var isProviderError4 = (value) => isJsonRecord5(value) && typeof value.code === "string" && typeof value.message === "string" && typeof value.retryable === "boolean" && (value.reasonCode === void 0 || typeof value.reasonCode === "string") && (value.provider === void 0 || typeof value.provider === "string") && (value.source === void 0 || isProviderSource3(value.source)) && (value.details === void 0 || isJsonRecord5(value.details));
-var isNormalizedRecord3 = (value) => isJsonRecord5(value) && typeof value.id === "string" && isProviderSource3(value.source) && typeof value.provider === "string" && (value.url === void 0 || typeof value.url === "string") && (value.title === void 0 || typeof value.title === "string") && (value.content === void 0 || typeof value.content === "string") && typeof value.timestamp === "string" && isFiniteNumber3(value.confidence) && isJsonRecord5(value.attributes);
-var isProviderFailureEntry3 = (value) => isJsonRecord5(value) && typeof value.provider === "string" && isProviderSource3(value.source) && isProviderError4(value.error);
-var isProviderAggregateResult3 = (value) => isJsonRecord5(value) && typeof value.ok === "boolean" && Array.isArray(value.records) && value.records.every((entry) => isNormalizedRecord3(entry)) && isTraceContext3(value.trace) && typeof value.partial === "boolean" && Array.isArray(value.failures) && value.failures.every((entry) => isProviderFailureEntry3(entry)) && isJsonRecord5(value.metrics) && isFiniteNumber3(value.metrics.attempted) && isFiniteNumber3(value.metrics.succeeded) && isFiniteNumber3(value.metrics.failed) && isFiniteNumber3(value.metrics.retries) && isFiniteNumber3(value.metrics.latencyMs) && typeof value.sourceSelection === "string" && Array.isArray(value.providerOrder) && value.providerOrder.every((entry) => typeof entry === "string") && (value.meta === void 0 || isJsonRecord5(value.meta)) && (value.diagnostics === void 0 || isJsonRecord5(value.diagnostics)) && (value.error === void 0 || isProviderError4(value.error));
+var isTraceContext3 = (value) => isJsonRecord6(value) && typeof value.requestId === "string" && typeof value.ts === "string" && (value.sessionId === void 0 || typeof value.sessionId === "string") && (value.targetId === void 0 || typeof value.targetId === "string") && (value.provider === void 0 || typeof value.provider === "string");
+var isProviderError4 = (value) => isJsonRecord6(value) && typeof value.code === "string" && typeof value.message === "string" && typeof value.retryable === "boolean" && (value.reasonCode === void 0 || typeof value.reasonCode === "string") && (value.provider === void 0 || typeof value.provider === "string") && (value.source === void 0 || isProviderSource3(value.source)) && (value.details === void 0 || isJsonRecord6(value.details));
+var isNormalizedRecord3 = (value) => isJsonRecord6(value) && typeof value.id === "string" && isProviderSource3(value.source) && typeof value.provider === "string" && (value.url === void 0 || typeof value.url === "string") && (value.title === void 0 || typeof value.title === "string") && (value.content === void 0 || typeof value.content === "string") && typeof value.timestamp === "string" && isFiniteNumber3(value.confidence) && isJsonRecord6(value.attributes);
+var isProviderFailureEntry3 = (value) => isJsonRecord6(value) && typeof value.provider === "string" && isProviderSource3(value.source) && isProviderError4(value.error);
+var isProviderAggregateResult3 = (value) => isJsonRecord6(value) && typeof value.ok === "boolean" && Array.isArray(value.records) && value.records.every((entry) => isNormalizedRecord3(entry)) && isTraceContext3(value.trace) && typeof value.partial === "boolean" && Array.isArray(value.failures) && value.failures.every((entry) => isProviderFailureEntry3(entry)) && isJsonRecord6(value.metrics) && isFiniteNumber3(value.metrics.attempted) && isFiniteNumber3(value.metrics.succeeded) && isFiniteNumber3(value.metrics.failed) && isFiniteNumber3(value.metrics.retries) && isFiniteNumber3(value.metrics.latencyMs) && typeof value.sourceSelection === "string" && Array.isArray(value.providerOrder) && value.providerOrder.every((entry) => typeof entry === "string") && (value.meta === void 0 || isJsonRecord6(value.meta)) && (value.diagnostics === void 0 || isJsonRecord6(value.diagnostics)) && (value.error === void 0 || isProviderError4(value.error));
 var emptyCheckpointState3 = () => ({
   completed_step_ids: [],
   step_results_by_id: {}
@@ -16170,7 +15484,7 @@ var readResearchCheckpointState = (checkpoint) => {
   if (state === void 0 || state === null) {
     return emptyCheckpointState3();
   }
-  if (!isJsonRecord5(state)) {
+  if (!isJsonRecord6(state)) {
     throw new Error("Research workflow checkpoint state must be a record.");
   }
   const completedStepIds = state.completed_step_ids;
@@ -16178,7 +15492,7 @@ var readResearchCheckpointState = (checkpoint) => {
     throw new Error("Research workflow checkpoint state is missing valid completed_step_ids.");
   }
   const rawResults = state.step_results_by_id;
-  if (!isJsonRecord5(rawResults)) {
+  if (!isJsonRecord6(rawResults)) {
     throw new Error("Research workflow checkpoint state is missing valid step_results_by_id.");
   }
   const stepResultsById = {};
@@ -16228,8 +15542,8 @@ var buildResearchSearchFilters = (source, args) => ({
   timebox_to: args.timebox.to,
   ...source === "community" || source === "social" ? {
     pageLimit: 1,
-    hopLimit: 0,
-    expansionPerRecord: 0
+    hopLimit: source === "community" ? 1 : 0,
+    expansionPerRecord: source === "community" ? RESEARCH_COMMUNITY_EXPANSION_PER_RECORD : 0
   } : {}
 });
 var compileResearchExecutionPlan = (args) => {
@@ -16296,7 +15610,12 @@ var compileResearchExecutionPlan = (args) => {
 
 // src/providers/research-executor.ts
 var RESEARCH_WEB_SEARCH_FETCH_PATHS = /* @__PURE__ */ new Set([
+  "community:search:index",
+  "community:search:url",
   "web:search:index",
+  "web:search:url",
+  "social:youtube:search:url",
+  "social:search:url",
   "social:search:index"
 ]);
 var appendTrace2 = (trace, stage, event, details) => [
@@ -16337,6 +15656,15 @@ var isValidHttpUrl2 = (url) => {
     return false;
   }
 };
+var attributeLinks = (record) => {
+  const links = record.attributes.links;
+  if (!Array.isArray(links)) return [];
+  return links.filter((link) => typeof link === "string");
+};
+var researchCandidateUrls = (record) => [
+  ...typeof record.url === "string" ? [record.url] : [],
+  ...attributeLinks(record)
+];
 var resolveResearchWebFetchCandidates = (records, limit) => {
   const candidates = [];
   const seen = /* @__PURE__ */ new Set();
@@ -16345,27 +15673,30 @@ var resolveResearchWebFetchCandidates = (records, limit) => {
     if (!RESEARCH_WEB_SEARCH_FETCH_PATHS.has(retrievalPath)) {
       continue;
     }
-    const rawUrl = typeof record.url === "string" ? canonicalizeUrl(record.url) : "";
-    if (!rawUrl) {
-      continue;
-    }
-    let resolvedUrl = rawUrl;
-    try {
-      const parsed = new URL(rawUrl);
-      if (/duckduckgo\.com$/i.test(parsed.hostname) && parsed.pathname === "/l") {
-        const redirect = parsed.searchParams.get("uddg");
-        if (typeof redirect === "string" && redirect.length > 0) {
-          resolvedUrl = canonicalizeUrl(redirect);
+    for (const candidateUrl of researchCandidateUrls(record)) {
+      const rawUrl = canonicalizeUrl(candidateUrl);
+      if (!rawUrl) continue;
+      let resolvedUrl = rawUrl;
+      try {
+        const parsed = new URL(rawUrl);
+        if (/duckduckgo\.com$/i.test(parsed.hostname) && (parsed.pathname === "/l" || parsed.pathname === "/l/")) {
+          const redirect = parsed.searchParams.get("uddg");
+          if (typeof redirect === "string" && redirect.length > 0) {
+            resolvedUrl = canonicalizeUrl(redirect);
+          }
         }
+      } catch {
+        continue;
+      }
+      if (!resolvedUrl || !isValidHttpUrl2(resolvedUrl) || !isLikelyResearchDestinationUrl(resolvedUrl) || /duckduckgo\.com/i.test(resolvedUrl) || seen.has(resolvedUrl)) {
+        continue;
+      }
+      seen.add(resolvedUrl);
+      candidates.push(resolvedUrl);
+      if (candidates.length >= limit) {
+        break;
       }
-    } catch {
-      continue;
-    }
-    if (!resolvedUrl || !isValidHttpUrl2(resolvedUrl) || /duckduckgo\.com/i.test(resolvedUrl) || seen.has(resolvedUrl)) {
-      continue;
     }
-    seen.add(resolvedUrl);
-    candidates.push(resolvedUrl);
     if (candidates.length >= limit) {
       break;
     }
@@ -17131,7 +16462,11 @@ var rankResearchRecords = (records) => {
 var hash2 = (value) => createHash7("sha1").update(value).digest("hex").slice(0, 16);
 var RESEARCH_ALWAYS_SANITIZED_PATHS = /* @__PURE__ */ new Set([
   "community:search:index",
-  "social:search:index"
+  "community:search:url",
+  "social:search:index",
+  "social:search:url",
+  "social:youtube:search:url",
+  "web:search:url"
 ]);
 var RESEARCH_CONDITIONAL_SANITIZED_PATHS = /* @__PURE__ */ new Set([
   "community:fetch:url",
@@ -17139,9 +16474,13 @@ var RESEARCH_CONDITIONAL_SANITIZED_PATHS = /* @__PURE__ */ new Set([
   "web:search:index"
 ]);
 var RESEARCH_LOGIN_SHELL_RE = /\b(?:log in|login|sign in|sign-in|please log in|continue with google|continue with apple)\b/i;
+var RESEARCH_LOGIN_SHELL_MAX_CONTENT_CHARS = 600;
+var RESEARCH_LOGIN_REQUIRED_RE = /\b(?:log in to continue|sign in to continue|authentication required|please log in|continue with google|continue with apple)\b/i;
 var RESEARCH_JS_REQUIRED_RE = /\b(?:enable javascript|javascript required|javascript is not available|javascript is disabled|you need to enable javascript)\b/i;
 var RESEARCH_GENERIC_SHELL_RE = /\b(?:skip to main content|the heart of the internet|open navigation|get the app|view in app|please wait for verification|verify you are human|security check)\b/i;
 var RESEARCH_NOT_FOUND_SHELL_RE = /\b(?:error 404|page not found|not found|can['’]t seem to find the page)\b/i;
+var RESEARCH_PRIVACY_PREFERENCE_SHELL_RE = /\b(?:select your cookie preferences|customize cookie preferences|unable to save cookie preferences|your privacy choices|manage consent preferences|privacy opt[- ]out|do not sell or share my personal information)\b/i;
+var RESEARCH_PRIVACY_RECOVERED_CONTENT_RE = /\b(?:blogs? home|permalink|comments|article)\b/i;
 var RESEARCH_SEARCH_SHELL_RE = /\b(?:duckduckgo|search results|all posts|communities|comments|try another search|no relevant content found|unable to load answer|search page)\b/i;
 var isDuckDuckGoResearchShellUrl = (url) => {
   try {
@@ -17154,6 +16493,7 @@ var isDuckDuckGoResearchShellUrl = (url) => {
   }
 };
 var PRODUCT_TARGET_NOT_FOUND_RE = /\b(?:error 404|page not found|not found|we can['’]t seem to find the page|can['’]t seem to find the page|return to homepage)\b/i;
+var BESTBUY_PDP_ERROR_SHELL_RE = /\b(?:something went wrong|use our search bar|pick a category below|typed in a url|check it for errors)\b/i;
 var resolveShoppingProviderIdForUrl = (url) => {
   try {
     const host = new URL(url).hostname.toLowerCase();
@@ -17208,6 +16548,48 @@ var WALMART_TITLE_CHROME_RE = /\b(?:Walmart\.com|Skip to Main Content|Pickup or
 var WALMART_BRAND_COLOR_RE = /\bColor\s+[A-Z0-9][A-Za-z0-9 /-]*(?=\s+(?:View full specifications|Current price is|Skip to Main Content|Pickup or delivery\?|How do you want your item\?|Sold and shipped by|Seller Rating|Free shipping|Arrives\b|Shipping\b|Delivery\b|Pickup\b|Departments Services|More details|Add to cart)|$)/i;
 var WALMART_BRAND_CHROME_TAIL_RE = /\b(?:View full specifications|Current price is|Skip to Main Content|Pickup or delivery\?|How do you want your item\?|Sold and shipped by|Seller Rating|Free shipping|Arrives\b|Shipping\b|Delivery\b|Pickup\b|Departments Services|More details|Add to cart)\b.*$/i;
 var WALMART_BRAND_CHROME_RE = /\b(?:Walmart\.com|Skip to Main Content|Pickup or delivery\?|How do you want your item\?|Sold and shipped by|Seller Rating|View full specifications|Current price is|Free shipping|Departments Services)\b/i;
+var EBAY_TITLE_BRAND_PREFIX_RE = /^(?:new|used|pre-owned|preowned|open box|refurbished|renewed|genuine|authentic)\s+/i;
+var EBAY_KNOWN_MULTI_TOKEN_BRANDS = [
+  "3M",
+  "Bang & Olufsen",
+  "Bowers & Wilkins",
+  "Hewlett-Packard",
+  "iRobot",
+  "New Balance"
+];
+var EBAY_KNOWN_SINGLE_TOKEN_BRANDS = /* @__PURE__ */ new Map([
+  ["apple", "Apple"],
+  ["bose", "Bose"],
+  ["canon", "Canon"],
+  ["dell", "Dell"],
+  ["dyson", "Dyson"],
+  ["google", "Google"],
+  ["jbl", "JBL"],
+  ["lenovo", "Lenovo"],
+  ["lg", "LG"],
+  ["microsoft", "Microsoft"],
+  ["nikon", "Nikon"],
+  ["nintendo", "Nintendo"],
+  ["panasonic", "Panasonic"],
+  ["philips", "Philips"],
+  ["samsung", "Samsung"],
+  ["sony", "Sony"]
+]);
+var EBAY_TITLE_BRAND_STOP_WORDS = /* @__PURE__ */ new Set([
+  "bluetooth",
+  "case",
+  "ergonomic",
+  "gaming",
+  "headphones",
+  "keyboard",
+  "leather",
+  "noise",
+  "portable",
+  "rechargeable",
+  "speaker",
+  "vertical",
+  "wireless"
+]);
 var PRODUCT_FEATURE_SECTION_MARKERS = [
   "about this item",
   "key item features",
@@ -17273,7 +16655,7 @@ var INSPIREDESIGN_RENDER_MODES = /* @__PURE__ */ new Set(["compact", "json", "md
 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 isJsonRecord7 = (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) => {
   return CANVAS_VISUAL_DIRECTION_PROFILES.includes(value);
@@ -17302,7 +16684,7 @@ var serializeInspiredesignRunInput = (input) => ({
 });
 var isStringArray2 = (value) => Array.isArray(value) && value.every((entry) => typeof entry === "string");
 var parseInspiredesignBriefFormatRoute = (value) => {
-  if (!isJsonRecord6(value)) return void 0;
+  if (!isJsonRecord7(value)) return void 0;
   const profile = typeof value.profile === "string" && isCanvasVisualDirectionProfile(value.profile) ? value.profile : void 0;
   const themeStrategy = typeof value.themeStrategy === "string" && isCanvasThemeStrategy(value.themeStrategy) ? value.themeStrategy : void 0;
   const navigationModel = typeof value.navigationModel === "string" && isCanvasNavigationModel(value.navigationModel) ? value.navigationModel : void 0;
@@ -17317,7 +16699,7 @@ var parseInspiredesignBriefFormatRoute = (value) => {
   };
 };
 var parseInspiredesignBriefFormat = (value) => {
-  if (!isJsonRecord6(value)) return void 0;
+  if (!isJsonRecord7(value)) return void 0;
   const route = parseInspiredesignBriefFormatRoute(value.route);
   if (typeof value.id !== "string" || typeof value.label !== "string" || !isStringArray2(value.bestFor) || !isStringArray2(value.businessFocus) || !isStringArray2(value.keywords) || typeof value.archetype !== "string" || typeof value.layoutArchetype !== "string" || typeof value.typographySystem !== "string" || typeof value.surfaceTreatment !== "string" || typeof value.shapeLanguage !== "string" || typeof value.componentGrammar !== "string" || typeof value.motionGrammar !== "string" || typeof value.paletteIntent !== "string" || typeof value.visualDensity !== "string" || typeof value.designVariance !== "string" || !isStringArray2(value.responsiveCollapseRules) || !isStringArray2(value.guardrails) || !isStringArray2(value.antiPatterns) || !isStringArray2(value.deliverables) || !route) {
     return void 0;
@@ -17346,7 +16728,7 @@ var parseInspiredesignBriefFormat = (value) => {
   };
 };
 var parseInspiredesignBriefExpansion = (value) => {
-  if (!isJsonRecord6(value)) return void 0;
+  if (!isJsonRecord7(value)) return void 0;
   const format = parseInspiredesignBriefFormat(value.format);
   if (typeof value.sourceBrief !== "string" || typeof value.advancedBrief !== "string" || typeof value.templateVersion !== "string" || !format) {
     return void 0;
@@ -17368,7 +16750,7 @@ var parseInspiredesignEnvelopeInput = (input) => {
     ...typeof input.captureMode === "string" && INSPIREDESIGN_CAPTURE_MODES.has(input.captureMode) ? { captureMode: input.captureMode } : {},
     ...typeof input.includePrototypeGuidance === "boolean" ? { includePrototypeGuidance: input.includePrototypeGuidance } : {},
     ...typeof input.timeoutMs === "number" ? { timeoutMs: input.timeoutMs } : {},
-    ...typeof input.outputDir === "string" && input.outputDir.length > 0 ? { outputDir: input.outputDir } : {},
+    ...typeof input.outputDir === "string" ? { 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 } : {},
@@ -17764,9 +17146,10 @@ var buildInspiredesignMeta = (runtime, workflowInput, references, failures, foll
     contractScope: followthrough.contractScope
   };
 };
-var inferBrandFromContent = (content) => {
+var inferBrandFromContent = (content, productUrl) => {
   const normalized = normalizePlainText(content);
   if (!normalized) return void 0;
+  const isEbayProduct = productUrl ? resolveShoppingProviderIdForUrl(productUrl) === "shopping/ebay" : false;
   const bestBuyTitle = inferBestBuyTitleFromContent(normalized);
   const bestBuyBrand = inferBestBuyBrandFromTitle(bestBuyTitle) ?? extractBrandFromTitle(bestBuyTitle);
   if (bestBuyBrand) {
@@ -17784,6 +17167,14 @@ var inferBrandFromContent = (content) => {
   if (productIdentifiersBrandMatch?.[1]) {
     return productIdentifiersBrandMatch[1].trim();
   }
+  const ebayTitle = inferEbayTitleFromContent(normalized);
+  const ebayBrand = inferEbayBrandFromTitle(ebayTitle);
+  if (ebayBrand) {
+    return ebayBrand;
+  }
+  if (isEbayProduct) {
+    return void 0;
+  }
   const brandMatch = /\bBrand ([A-Z][A-Za-z0-9&+' -]{1,60})\b/i.exec(normalized);
   if (brandMatch?.[1]) {
     return brandMatch[1].trim();
@@ -17803,13 +17194,69 @@ var inferBestBuyTitleFromContent = (normalized) => {
   }
   return candidate;
 };
-var inferTitleFromContent = (content) => {
+var inferEbayTitleFromContent = (normalized) => {
+  const patterns = [
+    /\bExpand Cart Loading\.\.\.\s+(.+?)(?:\s+for sale online\s*\|\s*eBay)?\s+Condition:/i,
+    /\bBuy It Now\s+(.+?)\s+Sign in to check out\b/i
+  ];
+  for (const pattern of patterns) {
+    const candidate = stripMarketplaceTitleFraming(normalizePlainText(pattern.exec(normalized)?.[1]), "https://www.ebay.com");
+    if (candidate && candidate.length >= 20 && candidate.length <= 180 && !candidate.endsWith("...") && !LOOKS_LIKE_URL_RE.test(candidate)) {
+      return candidate;
+    }
+  }
+  return void 0;
+};
+var inferKnownEbayBrandFromTitle = (title) => {
+  const normalized = title.toLowerCase();
+  return EBAY_KNOWN_MULTI_TOKEN_BRANDS.find((brand) => {
+    const candidate = brand.toLowerCase();
+    return normalized === candidate || normalized.startsWith(`${candidate} `);
+  });
+};
+var inferKnownSingleEbayBrandFromTitle = (title) => {
+  const firstToken = /^([A-Za-z][A-Za-z0-9&+']{1,30})(?:\s|$)/.exec(title)?.[1];
+  return firstToken ? EBAY_KNOWN_SINGLE_TOKEN_BRANDS.get(firstToken.toLowerCase()) : void 0;
+};
+var inferEbayBrandFromTitle = (title) => {
+  const framed = normalizePlainText(title).replace(/\s+[-|]\s+[^-|]+$/i, "").trim();
+  const knownBrand = inferKnownEbayBrandFromTitle(framed);
+  if (knownBrand) return knownBrand;
+  const cleaned = framed.replace(EBAY_TITLE_BRAND_PREFIX_RE, "");
+  const prefixedBrand = inferKnownEbayBrandFromTitle(cleaned);
+  if (prefixedBrand) return prefixedBrand;
+  const singleTokenBrand = inferKnownSingleEbayBrandFromTitle(cleaned);
+  if (singleTokenBrand) return singleTokenBrand;
+  const exactBrand = /^([A-Z][A-Za-z0-9&+']{1,30})$/.exec(cleaned)?.[1];
+  if (exactBrand && EBAY_KNOWN_SINGLE_TOKEN_BRANDS.has(exactBrand.toLowerCase())) {
+    return exactBrand;
+  }
+  const match = /^([A-Z][A-Za-z0-9&+']{1,30})\s+([A-Z0-9][A-Za-z0-9&+'().-]+|AirPods)\b/.exec(cleaned);
+  const brand = match?.[1]?.trim();
+  if (!brand || EBAY_TITLE_BRAND_STOP_WORDS.has(brand.toLowerCase())) {
+    return void 0;
+  }
+  if (EBAY_KNOWN_SINGLE_TOKEN_BRANDS.has(brand.toLowerCase())) {
+    return EBAY_KNOWN_SINGLE_TOKEN_BRANDS.get(brand.toLowerCase());
+  }
+  if (!/[\d-]/.test(match?.[2] ?? "")) {
+    return void 0;
+  }
+  return brand;
+};
+var inferTitleFromContent = (content, productUrl) => {
   const normalized = normalizePlainText(content);
   if (!normalized) return void 0;
   const bestBuyTitle = inferBestBuyTitleFromContent(normalized);
   if (bestBuyTitle) {
     return bestBuyTitle;
   }
+  if (productUrl && resolveShoppingProviderIdForUrl(productUrl) === "shopping/ebay") {
+    const ebayTitle = inferEbayTitleFromContent(normalized);
+    if (ebayTitle) {
+      return ebayTitle;
+    }
+  }
   const storeMatch = /\bVisit the [A-Z][A-Za-z0-9&+' -]{1,60} Store\s+(.+?)(?=\s+(?:Brand [A-Z]|About this item|Key item features|Current price is|Actual Color|[0-9]+(?:\.[0-9]+)? stars out of|Best seller\b))/i.exec(normalized);
   const candidate = normalizePlainText(storeMatch?.[1]);
   if (!candidate || candidate.length < 20 || LOOKS_LIKE_URL_RE.test(candidate)) {
@@ -17822,6 +17269,11 @@ var sanitizeProductBrandCandidate = (candidate, productUrl) => {
   if (!normalized) return void 0;
   try {
     const host = new URL(productUrl).hostname.toLowerCase();
+    const hostBrand = normalizePlainText(inferBrandFromUrl(productUrl)).replace(/\.com\b/gi, "").toLowerCase();
+    const candidateBrand = normalized.replace(/\.com\b/gi, "").toLowerCase();
+    if (host.includes("ebay.") && hostBrand && candidateBrand === hostBrand) {
+      return void 0;
+    }
     if (!host.includes("walmart.")) {
       return normalized;
     }
@@ -17966,6 +17418,17 @@ var inferHostDefaultCurrency = (productUrl) => {
     return void 0;
   }
 };
+var extractProductBrandFromTitle = (title, productUrl) => {
+  try {
+    const host = new URL(productUrl).hostname.toLowerCase();
+    if (host.includes("ebay.")) {
+      return inferEbayBrandFromTitle(title);
+    }
+  } catch {
+    return extractBrandFromTitle(title);
+  }
+  return extractBrandFromTitle(title);
+};
 var shouldSuppressMarketplacePrice = (record, productUrl, price) => {
   if (price.amount <= 0) return false;
   const expectedCurrency = inferHostDefaultCurrency(productUrl);
@@ -18090,12 +17553,12 @@ var resolveProductBrand = (record, productUrl, refreshedBrand) => {
   const nestedProvider = nested && typeof nested === "object" && !Array.isArray(nested) ? nested.provider : void 0;
   const providerBrand = typeof nestedProvider === "string" ? SHOPPING_PROVIDER_PROFILES.find((entry) => entry.id === nestedProvider)?.displayName : void 0;
   const candidates = [
-    inferBrandFromContent(record.content),
+    inferBrandFromContent(record.content, productUrl),
     rejectRetailerBrand(refreshedBrand),
     rejectRetailerBrand(typeof record.attributes.brand === "string" ? record.attributes.brand : void 0),
     rejectRetailerBrand(typeof record.attributes.site_name === "string" ? record.attributes.site_name : void 0),
     rejectRetailerBrand(providerBrand && providerBrand !== "Others" ? providerBrand : void 0),
-    extractBrandFromTitle(record.title),
+    extractProductBrandFromTitle(record.title, productUrl),
     inferBrandFromUrl(productUrl)
   ].map((entry) => sanitizeProductBrandCandidate(entry, productUrl)).filter(Boolean);
   return candidates[0] || "unknown";
@@ -18105,7 +17568,7 @@ var resolveProductTitle = (record, productUrl, brand, refreshedTitle) => {
   const nestedTitle = nested && typeof nested === "object" && !Array.isArray(nested) ? nested.title : void 0;
   const candidates = [
     refreshedTitle,
-    inferTitleFromContent(record.content),
+    inferTitleFromContent(record.content, productUrl),
     record.title,
     typeof nestedTitle === "string" ? nestedTitle : void 0,
     typeof record.attributes.description === "string" ? record.attributes.description.split(/(?<=[.!?])\s+/)[0] : void 0,
@@ -18154,13 +17617,31 @@ var resolveShoppingSourceForUrl = (url) => {
     return "web";
   }
 };
+var RESEARCH_REJECTED_CANDIDATE_LIMIT = 25;
+var isResearchPrivacyPreferenceShell = (content) => {
+  const matchIndex = content.slice(0, 400).search(RESEARCH_PRIVACY_PREFERENCE_SHELL_RE);
+  return matchIndex >= 0 && matchIndex <= 80 && !RESEARCH_PRIVACY_RECOVERED_CONTENT_RE.test(content);
+};
+var classifyResearchDeadEndUrl = (value) => {
+  if (!value) return null;
+  return classifyResearchDestinationRejection(value);
+};
+var isResearchLoginShellRecord = (args) => {
+  if (args.url.includes("/login")) {
+    return true;
+  }
+  if (!RESEARCH_LOGIN_SHELL_RE.test(args.combined)) {
+    return false;
+  }
+  return args.content.length <= RESEARCH_LOGIN_SHELL_MAX_CONTENT_CHARS || RESEARCH_LOGIN_REQUIRED_RE.test(args.combined);
+};
 var classifyResearchShellRecord = (record) => {
   const retrievalPath = typeof record.attributes.retrievalPath === "string" ? record.attributes.retrievalPath : "";
   const url = typeof record.url === "string" ? record.url.trim().toLowerCase() : "";
   const title = normalizePlainText(record.title).toLowerCase();
   const content = normalizePlainText(record.content).toLowerCase();
   const combined = `${title} ${content}`.trim();
-  if (RESEARCH_LOGIN_SHELL_RE.test(combined) || url.includes("/login")) {
+  if (isResearchLoginShellRecord({ url, combined, content })) {
     return "login_shell";
   }
   if (RESEARCH_JS_REQUIRED_RE.test(combined)) {
@@ -18169,6 +17650,13 @@ var classifyResearchShellRecord = (record) => {
   if (RESEARCH_NOT_FOUND_SHELL_RE.test(combined)) {
     return "not_found_shell";
   }
+  if (isResearchPrivacyPreferenceShell(content)) {
+    return "privacy_preference_shell";
+  }
+  const deadEndUrlReason = classifyResearchDeadEndUrl(url);
+  if (deadEndUrlReason) {
+    return deadEndUrlReason;
+  }
   if (!retrievalPath) {
     return null;
   }
@@ -18191,18 +17679,47 @@ var classifyResearchShellRecord = (record) => {
 };
 var sanitizeResearchRecords = (records) => {
   const reasonDistribution = {};
+  const rejectedCandidates = [];
   const sanitizedRecords = records.filter((record) => {
     const reason = classifyResearchShellRecord(record);
     if (!reason) return true;
     reasonDistribution[reason] = (reasonDistribution[reason] ?? 0) + 1;
+    if (rejectedCandidates.length < RESEARCH_REJECTED_CANDIDATE_LIMIT) {
+      const retrievalPath = typeof record.attributes.retrievalPath === "string" ? record.attributes.retrievalPath : void 0;
+      rejectedCandidates.push({
+        provider: record.provider,
+        source: record.source,
+        reason,
+        replacement_status: "rejected_before_synthesis",
+        ...retrievalPath ? { retrievalPath } : {},
+        ...record.title ? { title: record.title } : {},
+        ...record.url ? { url: record.url } : {}
+      });
+    }
     return false;
   });
   return {
     records: sanitizedRecords,
     sanitizedCount: records.length - sanitizedRecords.length,
-    reasonDistribution
+    reasonDistribution,
+    rejectedCandidates
+  };
+};
+var rejectedCandidateFromFailure = (failure) => {
+  const details = failure.error.details ?? {};
+  if (details.fallbackOutputReason !== "research_dead_end_shell") return null;
+  const retrievalPath = typeof details.retrievalPath === "string" ? details.retrievalPath : void 0;
+  const url = typeof details.url === "string" ? details.url : void 0;
+  return {
+    provider: failure.provider,
+    source: failure.source,
+    reason: "research_dead_end_shell",
+    replacement_status: "rejected_before_synthesis",
+    ...retrievalPath ? { retrievalPath } : {},
+    ...url ? { url } : {}
   };
 };
+var rejectedCandidatesFromFailures = (failures) => failures.map(rejectedCandidateFromFailure).filter((candidate) => candidate !== null);
 var isValidHttpUrl3 = (url) => {
   try {
     const parsed = new URL(url.trim());
@@ -18228,6 +17745,13 @@ var classifyInvalidProductTarget = (record) => {
       message: "Product target appears to be a not-found page"
     };
   }
+  const providerId = resolveShoppingProviderIdForUrl(record.url ?? "");
+  if (providerId === "shopping/bestbuy" && combined.toLowerCase().includes("something went wrong") && BESTBUY_PDP_ERROR_SHELL_RE.test(combined)) {
+    return {
+      reason: "provider_error_shell",
+      message: "Best Buy product target returned a generic error shell"
+    };
+  }
   return null;
 };
 var runResearchWorkflow = async (runtime, input) => {
@@ -18235,7 +17759,9 @@ var runResearchWorkflow = async (runtime, input) => {
   if (envelope.kind !== "research") {
     throw new Error(`Research workflow envelope kind mismatch. Expected research but received ${envelope.kind}.`);
   }
-  const workflowInput = envelope.input;
+  const rawWorkflowInput = envelope.input;
+  const artifactRoot = resolveWorkflowArtifactRoot(rawWorkflowInput.outputDir);
+  const workflowInput = { ...rawWorkflowInput, outputDir: artifactRoot };
   let trace = [
     ...envelope.trace ?? [],
     {
@@ -18291,21 +17817,23 @@ var runResearchWorkflow = async (runtime, input) => {
     }
   });
   const excludedProviderSet = new Set(plan.compiled.autoExcludedProviders);
-  const mergedRecords = removeExcludedProviders(
-    [
-      ...execution.searchRuns.flatMap((run) => run.result.records),
-      ...execution.followUpRuns.flatMap((run) => run.result.records)
-    ],
-    excludedProviderSet
-  );
+  const rawRecords = [
+    ...execution.searchRuns.flatMap((run) => run.result.records),
+    ...execution.followUpRuns.flatMap((run) => run.result.records)
+  ];
+  const rawFailures = [
+    ...execution.searchRuns.flatMap((run) => run.result.failures),
+    ...execution.followUpRuns.flatMap((run) => run.result.failures)
+  ];
+  const mergedRecords = removeExcludedProviders(rawRecords, excludedProviderSet);
   const sanitizedRecords = sanitizeResearchRecords(mergedRecords);
-  const mergedFailures = removeExcludedProviders(
-    [
-      ...execution.searchRuns.flatMap((run) => run.result.failures),
-      ...execution.followUpRuns.flatMap((run) => run.result.failures)
-    ],
-    excludedProviderSet
-  );
+  const mergedFailures = removeExcludedProviders(rawFailures, excludedProviderSet);
+  const rejectedFailureCandidates = rejectedCandidatesFromFailures(mergedFailures);
+  const rejectedCandidates = [
+    ...sanitizedRecords.rejectedCandidates,
+    ...rejectedFailureCandidates
+  ].slice(0, RESEARCH_REJECTED_CANDIDATE_LIMIT);
+  const rejectedCandidateCount2 = sanitizedRecords.sanitizedCount + rejectedFailureCandidates.length;
   const reasonCodeDistribution = summarizeReasonCodeDistribution(mergedFailures);
   const transcriptStrategyFailures = summarizeTranscriptStrategyFailures(mergedFailures);
   const evaluationNow = /* @__PURE__ */ new Date();
@@ -18313,8 +17841,8 @@ var runResearchWorkflow = async (runtime, input) => {
   const enriched = enrichResearchRecords(withinTimebox, plan.compiled.timebox, evaluationNow);
   const deduped = dedupeResearchRecords(enriched);
   const ranked = rankResearchRecords(deduped);
-  const noUsableResearchRecords = mergedRecords.length > 0 && mergedFailures.length === 0 && ranked.length === 0;
   const cookieDiagnostics = summarizeCookieDiagnostics(mergedFailures, mergedRecords);
+  const challengeOrchestration = summarizeChallengeOrchestration(mergedFailures, mergedRecords);
   const transcriptStrategyDetailDistribution = summarizeTranscriptStrategyDetailDistribution(ranked);
   const transcriptDurability = summarizeTranscriptDurability(ranked, mergedFailures);
   const antiBotPressure = summarizeAntiBotPressure(mergedFailures);
@@ -18322,16 +17850,16 @@ var runResearchWorkflow = async (runtime, input) => {
     ...plan.compiled.timebox,
     to: new Date(Math.max(new Date(plan.compiled.timebox.to).getTime(), evaluationNow.getTime())).toISOString()
   } : plan.compiled.timebox;
-  if (noUsableResearchRecords && sanitizedRecords.records.length === 0) {
+  if (mergedRecords.length > 0 && sanitizedRecords.records.length === 0) {
     const sanitizedReasons = Object.entries(sanitizedRecords.reasonDistribution).map(([reason, count]) => `${reason}:${count}`).join(",");
     throw new Error(
       `Research workflow produced only shell records and no usable results (${sanitizedReasons || "sanitized"}).`
     );
   }
-  if (noUsableResearchRecords && sanitizedRecords.records.length > 0 && withinTimebox.length === 0) {
+  if (sanitizedRecords.records.length > 0 && withinTimebox.length === 0) {
     throw new Error("Research workflow produced no usable in-timebox results after sanitization.");
   }
-  if (noUsableResearchRecords) {
+  if (ranked.length === 0) {
     throw new Error("Research workflow produced no usable results after post-processing.");
   }
   const primaryConstraintFailures = selectResearchPrimaryConstraintFailures(mergedFailures);
@@ -18345,8 +17873,10 @@ var runResearchWorkflow = async (runtime, input) => {
     metrics: {
       total_records: mergedRecords.length,
       sanitized_records: sanitizedRecords.sanitizedCount,
+      rejected_candidate_count: rejectedCandidateCount2,
       sanitized_reason_distribution: sanitizedRecords.reasonDistribution,
       sanitizedReasonDistribution: sanitizedRecords.reasonDistribution,
+      rejected_candidate_sample_size: rejectedCandidates.length,
       within_timebox: withinTimebox.length,
       final_records: ranked.length,
       failed_sources: execution.searchRuns.filter((run) => !run.result.ok).map((run) => run.source),
@@ -18361,15 +17891,22 @@ var runResearchWorkflow = async (runtime, input) => {
       transcriptDurability,
       cookie_diagnostics: cookieDiagnostics,
       cookieDiagnostics,
+      challenge_orchestration: challengeOrchestration,
+      challengeOrchestration,
       anti_bot_pressure: antiBotPressure,
       antiBotPressure
     },
     failures: mergedFailures,
+    rejected_candidates: rejectedCandidates,
+    rejectedCandidates,
     alerts: buildWorkflowAlerts(runtime, mergedFailures)
   }, primaryConstraintFailures);
   const handoff = buildResearchSuccessHandoff({
     topic: plan.compiled.topic,
-    browserMode: workflowInput.browserMode
+    browserMode: workflowInput.browserMode,
+    failures: mergedFailures,
+    cookieDiagnostics,
+    challengeOrchestration
   });
   const responseMeta = withFollowthroughMeta(meta, handoff);
   const rendered = renderResearch({
@@ -18380,7 +17917,7 @@ var runResearchWorkflow = async (runtime, input) => {
   });
   const bundle = await createArtifactBundle({
     namespace: "research",
-    outputDir: workflowInput.outputDir,
+    outputDir: artifactRoot,
     ttlHours: workflowInput.ttlHours,
     files: rendered.files
   });
@@ -18388,7 +17925,7 @@ var runResearchWorkflow = async (runtime, input) => {
     return {
       ...rendered.response,
       ...handoff,
-      path: bundle.basePath,
+      artifact_path: bundle.basePath,
       records: ranked,
       meta: {
         ...responseMeta,
@@ -18412,7 +17949,9 @@ var runShoppingWorkflow = async (runtime, input) => {
   if (envelope.kind !== "shopping") {
     throw new Error(`Shopping workflow envelope kind mismatch. Expected shopping but received ${envelope.kind}.`);
   }
-  const workflowInput = envelope.input;
+  const rawWorkflowInput = envelope.input;
+  const artifactRoot = resolveWorkflowArtifactRoot(rawWorkflowInput.outputDir);
+  const workflowInput = { ...rawWorkflowInput, outputDir: artifactRoot };
   const remainingTimeoutMs = createRemainingTimeoutResolver(workflowInput.timeoutMs);
   let trace = [
     ...envelope.trace ?? [],
@@ -18566,7 +18105,7 @@ var runShoppingWorkflow = async (runtime, input) => {
   });
   const bundle = await createArtifactBundle({
     namespace: "shopping",
-    outputDir: workflowInput.outputDir,
+    outputDir: artifactRoot,
     ttlHours: workflowInput.ttlHours,
     files: rendered.files
   });
@@ -18574,7 +18113,7 @@ var runShoppingWorkflow = async (runtime, input) => {
     return {
       ...rendered.response,
       ...handoff,
-      path: bundle.basePath,
+      artifact_path: bundle.basePath,
       offers,
       meta: {
         ...responseMeta,
@@ -18594,7 +18133,9 @@ var runShoppingWorkflow = async (runtime, input) => {
   };
 };
 var runInspiredesignWorkflow = async (runtime, input, options = {}) => {
-  const { envelope, workflowInput } = buildInspiredesignEnvelope(input);
+  const { envelope, workflowInput: rawWorkflowInput } = buildInspiredesignEnvelope(input);
+  const artifactRoot = resolveWorkflowArtifactRoot(rawWorkflowInput.outputDir);
+  const workflowInput = { ...rawWorkflowInput, outputDir: artifactRoot };
   const remainingTimeoutMs = createRemainingTimeoutResolver(workflowInput.timeoutMs);
   let trace = appendWorkflowTrace(envelope.trace ?? [], "compile", "compile_started", {
     kind: "inspiredesign"
@@ -18668,14 +18209,14 @@ var runInspiredesignWorkflow = async (runtime, input, options = {}) => {
   });
   const bundle = await createArtifactBundle({
     namespace: "inspiredesign",
-    outputDir: workflowInput.outputDir,
+    outputDir: artifactRoot,
     ttlHours: workflowInput.ttlHours,
     files: rendered.files
   });
   if (workflowInput.mode === "path") {
     return {
       ...rendered.response,
-      path: bundle.basePath,
+      artifact_path: bundle.basePath,
       meta: {
         ...meta,
         artifact_manifest: bundle.manifest
@@ -18724,7 +18265,9 @@ var runProductVideoWorkflow = async (runtime, input, options = {}) => {
       }
     }
   ];
-  const workflowInput = plan.input;
+  const rawWorkflowInput = plan.input;
+  const productVideoArtifactRoot = resolveWorkflowArtifactRoot(rawWorkflowInput.output_dir);
+  const workflowInput = { ...rawWorkflowInput, output_dir: productVideoArtifactRoot };
   const includeScreenshots = plan.compiled.includeScreenshots;
   const includeAllImages = plan.compiled.includeAllImages;
   const includeCopy = plan.compiled.includeCopy;
@@ -18804,6 +18347,8 @@ var runProductVideoWorkflow = async (runtime, input, options = {}) => {
         query: resolveStep.input.product_name,
         providers: providerHint ? [providerHint] : void 0,
         mode: "json",
+        outputDir: productVideoArtifactRoot,
+        ttlHours: workflowInput.ttl_hours,
         ...timeoutOptions,
         browserMode: workflowInput.browserMode,
         useCookies: workflowInput.useCookies,
@@ -19025,11 +18570,10 @@ var runProductVideoWorkflow = async (runtime, input, options = {}) => {
     files: files.length
   });
   const bundle = await createArtifactBundle({
-    namespace: "product-assets",
-    outputDir: workflowInput.output_dir,
+    namespace: "product-video",
+    outputDir: productVideoArtifactRoot,
     ttlHours: workflowInput.ttl_hours,
-    files,
-    manifestFileName: "bundle-manifest.json"
+    files
   });
   const reasonCodeDistribution = summarizeReasonCodeDistribution(details.failures);
   const transcriptStrategyFailures = summarizeTranscriptStrategyFailures(details.failures);
@@ -19069,7 +18613,7 @@ var runProductVideoWorkflow = async (runtime, input, options = {}) => {
   }, handoff);
   return {
     ...handoff,
-    path: bundle.basePath,
+    artifact_path: bundle.basePath,
     manifest: manifestPayload,
     product: productPayload,
     pricing,
@@ -19123,7 +18667,10 @@ var buildSocialDefaultTraversal = (platform, options) => {
     ...existing ?? {}
   };
 };
-var shouldRecoverSocialDocumentIssue = (platform, operation, issue) => {
+var shouldRecoverSocialDocumentIssue = (platform, operation, issue, context) => {
+  if (isResearchSearchDiscoveryRun(operation, context)) {
+    return false;
+  }
   if (SOCIAL_BROWSER_RECOVERY_REASON_CODES.has(issue.reasonCode)) {
     return true;
   }
@@ -19132,7 +18679,7 @@ var shouldRecoverSocialDocumentIssue = (platform, operation, issue) => {
   }
   return operation === "search" && SEARCH_RENDER_RECOVERY_SOCIAL_PLATFORMS.has(platform) && issue.reasonCode === "env_limited" && issue.constraint?.kind === "render_required";
 };
-var isJsonRecord7 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var isJsonRecord8 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 var unwrapWorkflowResumeEnvelope = (kind, input) => {
   if (!isWorkflowResumePayload(input)) {
     throw new ProviderRuntimeError(
@@ -19185,10 +18732,10 @@ var Semaphore = class {
       this.active += 1;
       return;
     }
-    await new Promise((resolve2) => {
+    await new Promise((resolve) => {
       this.queue.push(() => {
         this.active += 1;
-        resolve2();
+        resolve();
       });
     });
   }
@@ -19367,7 +18914,7 @@ var isBlockedRedditFallbackLink = (link) => {
     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 shouldOwnerReviewCommunityRedditSearchFallback = (input) => input.providerId === "community/default" && input.source === "community" && input.operation === "search" && isFirstPartySocialSearchRoute("reddit", input.url) && (hasUsableCommunityFallbackSearchContent(input.extracted.text) || 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,
@@ -19440,6 +18987,8 @@ var describeDefaultFetchedIssue = (document) => {
   };
 };
 var shouldRecoverDefaultFetchedIssue = (issue) => issue.reasonCode === "challenge_detected" || issue.reasonCode === "token_required" || issue.reasonCode === "env_limited" && !!issue.constraint;
+var isUsableCommunityRedditSearchFallback = (args) => args.source === "community" && args.operation === "search" && args.document.browserFallback !== void 0 && isFirstPartySocialSearchRoute("reddit", args.document.url) && hasUsableCommunityFallbackSearchContent(args.pageMessage);
+var isResearchSearchDiscoveryRun = (operation, context) => operation === "search" && context.suspendedIntent?.kind === "workflow.research";
 var toDefaultFetchedIssueError = (args) => {
   const reasonCode = args.issueDetails.issue?.reasonCode ?? "env_limited";
   return new ProviderRuntimeError(
@@ -19464,6 +19013,14 @@ var resolveDefaultFallbackDocumentIfNeeded = async (args) => {
   if (!initialIssue) {
     return { document: currentDocument, ...described };
   }
+  if (isUsableCommunityRedditSearchFallback({
+    source: args.source,
+    operation: args.operation,
+    document: currentDocument,
+    pageMessage: described.pageMessage
+  })) {
+    return { document: currentDocument, ...described, issue: null };
+  }
   if (shouldReturnCompletedFallbackForOwnerReview({ ...args, document: currentDocument })) {
     return { document: currentDocument, ...described };
   }
@@ -19506,6 +19063,14 @@ var resolveDefaultFallbackDocumentIfNeeded = async (args) => {
       ownerReview: args.ownerReview
     });
     described = describeDefaultFetchedIssue(currentDocument);
+    if (isUsableCommunityRedditSearchFallback({
+      source: args.source,
+      operation: args.operation,
+      document: currentDocument,
+      pageMessage: described.pageMessage
+    })) {
+      return { document: currentDocument, ...described, issue: null };
+    }
     if (shouldReturnCompletedFallbackForOwnerReview({ ...args, document: currentDocument })) {
       return { document: currentDocument, ...described };
     }
@@ -19522,16 +19087,32 @@ var resolveDefaultFallbackDocumentIfNeeded = async (args) => {
 };
 var COMMUNITY_SEARCH_LINK_SCAN_MULTIPLIER = 4;
 var MIN_COMMUNITY_SEARCH_LINK_SCAN = 12;
-var resolveCommunitySearchLinks = (document, limit) => {
+var resolveCommunitySearchLinks = (document, limit, researchContext) => {
   const scanLimit = Math.max(limit * COMMUNITY_SEARCH_LINK_SCAN_MULTIPLIER, MIN_COMMUNITY_SEARCH_LINK_SCAN);
   const links = prioritizeSocialSearchLinks(
     "reddit",
     document.url,
     dedupeLinks2(document.links, document.url, scanLimit)
   );
-  return links.filter((url) => isAllowedSocialSearchExpansionUrl("reddit", url)).slice(0, limit);
+  return links.filter((url) => researchContext ? isLikelyResearchDestinationUrl(url) : isLikelyDocumentUrl(url)).filter((url) => isAllowedSocialSearchExpansionUrl("reddit", url)).slice(0, limit);
+};
+var shouldRejectBlockedCommunityFallback = (document, links, pageMessage) => document.browserFallback !== void 0 && isFirstPartySocialSearchRoute("reddit", document.url) && links.length === 0 && !hasUsableCommunityFallbackSearchContent(pageMessage);
+var COMMUNITY_FALLBACK_SEARCH_MIN_CHARS = 120;
+var COMMUNITY_FALLBACK_SEARCH_EVIDENCE_RE = [
+  /\bshowing results for\b/i,
+  /\bsearch for\b/i,
+  /\banswers?\b/i,
+  /\bsources?:\s+/i,
+  /\br\/[a-z0-9_]+\b/i
+];
+var hasUsableCommunityFallbackSearchContent = (pageMessage) => {
+  const trimmed = pageMessage.trim();
+  if (trimmed.length < COMMUNITY_FALLBACK_SEARCH_MIN_CHARS) {
+    return false;
+  }
+  const evidenceCount = COMMUNITY_FALLBACK_SEARCH_EVIDENCE_RE.filter((pattern) => pattern.test(trimmed)).length;
+  return evidenceCount >= 2;
 };
-var shouldRejectBlockedCommunityFallback = (document, links) => document.browserFallback !== void 0 && isFirstPartySocialSearchRoute("reddit", document.url) && links.length === 0;
 var toCommunityFallbackSearchError = (args) => {
   const reasonCode = args.document.browserFallback?.reasonCode ?? "env_limited";
   return new ProviderRuntimeError(
@@ -19646,6 +19227,36 @@ var dedupeLinks2 = (links, baseUrl, limit) => {
   }
   return deduped;
 };
+var isUsableWebSearchResultUrl = (url, researchContext) => !isDuckDuckGoSearchShellUrl(url) && (researchContext ? isLikelyResearchDestinationUrl(url) : isLikelyDocumentUrl(url));
+var isResearchWorkflowContext = (context) => context.suspendedIntent?.kind === "workflow.research";
+var resolveWebSearchResultLinks = (document, limit, researchContext, includeDocumentUrl) => {
+  const links = dedupeLinks2(document.links, document.url, limit * 2);
+  const candidates = includeDocumentUrl ? [document.url, ...links] : links;
+  const seen = /* @__PURE__ */ new Set();
+  return candidates.filter((url) => {
+    const keep = isUsableWebSearchResultUrl(url, researchContext) && !seen.has(url);
+    if (keep) seen.add(url);
+    return keep;
+  }).slice(0, limit);
+};
+var toResearchDeadEndSearchError = (args) => new ProviderRuntimeError(
+  "unavailable",
+  `Research search resolved only dead-end pages for ${args.document.url}`,
+  {
+    provider: args.providerId,
+    source: args.source,
+    retryable: false,
+    reasonCode: "policy_blocked",
+    details: {
+      status: args.document.status,
+      url: args.document.url,
+      ...args.document.browserFallback?.reasonCode ? { browserFallbackReasonCode: args.document.browserFallback.reasonCode } : {},
+      retrievalPath: args.retrievalPath,
+      fallbackOutputReason: "research_dead_end_shell",
+      ...browserFallbackObservationDetails(args.document.browserFallback)
+    }
+  }
+);
 var RUNTIME_FALLBACK_ERROR_CODES = /* @__PURE__ */ new Set([
   "auth",
   "rate_limited",
@@ -19785,6 +19396,7 @@ var readResponseTextWithAbort = async (response, args) => {
   }
 };
 var fetchRuntimeDocumentWithFallback = async (args) => {
+  const researchSearchDiscovery = args.context !== void 0 && isResearchSearchDiscoveryRun(args.operation, args.context);
   const fallbackPort = args.context?.browserFallbackPort ?? args.browserFallbackPort;
   const runtimePolicy = args.context?.runtimePolicy;
   const forcedBrowserTransport = runtimePolicy?.browser.forceTransport === true;
@@ -19851,6 +19463,9 @@ var fetchRuntimeDocumentWithFallback = async (args) => {
     if (args.recoverRuntimeErrors === false) {
       throw error;
     }
+    if (researchSearchDiscovery) {
+      throw error;
+    }
     if (!fallbackPort) {
       throw error;
     }
@@ -20216,8 +19831,9 @@ var ProviderRuntime = class {
     };
   }
   async executeAll(providers, operation, input, trace, timeoutMs, selection, startedAt, tierMetadata, providerIds, runOptions = {}) {
-    const results = await Promise.all(
-      providers.map((provider) => this.invokeProvider(provider, operation, input, trace, timeoutMs, tierMetadata, runOptions))
+    const results = await this.mapProvidersBounded(
+      providers,
+      (provider) => this.invokeProvider(provider, operation, input, trace, timeoutMs, tierMetadata, runOptions)
     );
     const records = [];
     const failures = [];
@@ -20260,8 +19876,9 @@ var ProviderRuntime = class {
           }
         });
       }
-      const fallbackResults = await Promise.all(
-        fallbackProviders.map((provider) => this.invokeProvider(provider, operation, input, trace, timeoutMs, fallbackTier, runOptions))
+      const fallbackResults = await this.mapProvidersBounded(
+        fallbackProviders,
+        (provider) => this.invokeProvider(provider, operation, input, trace, timeoutMs, fallbackTier, runOptions)
       );
       for (const result of fallbackResults) {
         attempted += 1;
@@ -20308,6 +19925,9 @@ var ProviderRuntime = class {
       ...!ok && failures[0] ? { error: failures[0].error } : {}
     };
   }
+  async mapProvidersBounded(providers, task) {
+    return mapBounded(providers, this.budgets.concurrency.global, task);
+  }
   async invokeProvider(provider, operation, input, trace, timeoutMs, tierMetadata, runOptions) {
     const startedAt = Date.now();
     const scopeKey = this.resolveScopeKey(provider.id, operation, input);
@@ -20691,7 +20311,7 @@ var ProviderRuntime = class {
   }
   async resumeSuspendedIntent(intent, options) {
     const input = intent.input;
-    if (!isJsonRecord7(input)) {
+    if (!isJsonRecord8(input)) {
       throw new ProviderRuntimeError("invalid_input", "Suspended intent input is missing or malformed.", {
         retryable: false
       });
@@ -20779,7 +20399,7 @@ var ProviderRuntime = class {
     return providers.some((provider) => provider.source !== "web");
   }
   resolveScopeKey(providerId, operation, input) {
-    const extractHost2 = (value) => {
+    const extractHost = (value) => {
       if (!value) return null;
       try {
         return new URL(value).hostname.toLowerCase();
@@ -20788,14 +20408,14 @@ var ProviderRuntime = class {
       }
     };
     if (operation === "fetch") {
-      return extractHost2(input.url) ?? providerId;
+      return extractHost(input.url) ?? providerId;
     }
     if (operation === "crawl") {
       const first = input.seedUrls[0];
-      return extractHost2(first) ?? providerId;
+      return extractHost(first) ?? providerId;
     }
     if (operation === "search") {
-      return extractHost2(input.query) ?? providerId;
+      return extractHost(input.query) ?? providerId;
     }
     return providerId;
   }
@@ -20973,9 +20593,18 @@ var withDefaultWebOptions = (options, browserFallbackPort) => {
         browserFallbackPort
       });
       const limit = Math.max(1, Math.min(input.limit ?? 5, 10));
-      const links = dedupeLinks2(document.links, document.url, limit * 2).filter((url) => !isDuckDuckGoSearchShellUrl(url)).slice(0, limit);
+      const researchContext = isResearchWorkflowContext(context);
+      const links = resolveWebSearchResultLinks(document, limit, researchContext, researchContext || isHttpUrl7(query));
       const searchPath = isHttpUrl7(query) ? "web:search:url" : "web:search:index";
       if (links.length === 0) {
+        if (researchContext && !isUsableWebSearchResultUrl(document.url, true)) {
+          throw toResearchDeadEndSearchError({
+            providerId,
+            source: "web",
+            document,
+            retrievalPath: searchPath
+          });
+        }
         return [{
           url: document.url,
           title: document.url,
@@ -21018,6 +20647,14 @@ var withDefaultCommunityOptions = (options, browserFallbackPort) => {
       ...browserFallbackObservationAttributes(args.document.browserFallback)
     };
     if (args.links.length === 0) {
+      if (isResearchWorkflowContext(args.context) && !isLikelyResearchDestinationUrl(args.document.url)) {
+        throw toResearchDeadEndSearchError({
+          providerId,
+          source: "community",
+          document: args.document,
+          retrievalPath: searchPath
+        });
+      }
       return [{
         url: args.document.url,
         title: isHttpUrl7(args.query) ? args.document.url : `Community search: ${args.query}`,
@@ -21059,8 +20696,8 @@ var withDefaultCommunityOptions = (options, browserFallbackPort) => {
         browserFallbackPort,
         ownerReview: shouldOwnerReviewCommunityRedditSearchFallback
       });
-      const links = resolveCommunitySearchLinks(resolvedDocument, limit);
-      if (shouldRejectBlockedCommunityFallback(resolvedDocument, links)) {
+      const links = resolveCommunitySearchLinks(resolvedDocument, limit, isResearchWorkflowContext(context));
+      if (shouldRejectBlockedCommunityFallback(resolvedDocument, links, pageMessage)) {
         throw toCommunityFallbackSearchError({
           providerId,
           document: resolvedDocument,
@@ -21072,7 +20709,8 @@ var withDefaultCommunityOptions = (options, browserFallbackPort) => {
         page,
         document: resolvedDocument,
         pageMessage,
-        links
+        links,
+        context
       });
     }),
     fetch: options?.fetch ?? (async (input, context) => {
@@ -21185,7 +20823,7 @@ var withDefaultSocialPlatformOptions = (platform, options, browserFallbackPort)
     if (initialIssue.reasonCode === "env_limited" && !initialIssue.constraint) {
       return { document: currentDocument, ...described };
     }
-    if (!shouldRecoverSocialDocumentIssue(platform, operation, initialIssue)) {
+    if (!shouldRecoverSocialDocumentIssue(platform, operation, initialIssue, context)) {
       throw toIssueError(currentDocument, described);
     }
     const fallback = await resolveProviderBrowserFallback({
@@ -21374,19 +21012,6 @@ var mergeBudgets = (base, partial) => {
 };
 
 export {
-  redactSensitive,
-  createRequestId,
-  stderrSink,
-  setDefaultLogSink,
-  createLogger,
-  DEFAULT_BLOCKER_ARTIFACT_CAPS,
-  clampBlockerConfidence,
-  clampText,
-  boundedUniqueList,
-  resolveBlockerArtifactCaps,
-  classifyBlockerSignal,
-  buildBlockerArtifacts,
-  __test__,
   CHALLENGE_AUTOMATION_MODES,
   isChallengeAutomationMode,
   resolveChallengeAutomationPolicy,
@@ -21411,7 +21036,6 @@ export {
   CANVAS_BROWSER_VALIDATION_MODES,
   CANVAS_VALIDATION_TARGET_BLOCK_ON_CODES,
   CANVAS_PUBLIC_WARNING_CLASSES,
-  summarizePrimaryProviderIssue,
   createTraceContext,
   clampConfidence,
   createStableRecordId,
@@ -21439,17 +21063,13 @@ export {
   createShoppingProviders,
   createShoppingProviderById,
   createWebProvider,
-  DEFAULT_ARTIFACT_TTL_HOURS,
-  MAX_ARTIFACT_TTL_HOURS,
-  createArtifactBundle,
-  cleanupExpiredArtifacts,
+  WORKFLOW_ARTIFACT_DIRECTORY,
+  resolveWorkflowArtifactRoot,
   resolveTimebox,
   isWithinTimebox,
   filterByTimebox,
   toResearchRecord,
   enrichResearchRecords,
-  INSPIREDESIGN_HANDOFF_COMMANDS,
-  INSPIREDESIGN_HANDOFF_GUIDANCE,
   buildMacroResolveSuccessHandoff,
   renderResearch,
   renderShopping,
@@ -21465,4 +21085,4 @@ export {
   createProviderRuntime,
   createDefaultRuntime
 };
-//# sourceMappingURL=chunk-T3VVHJTK.js.map
+//# sourceMappingURL=chunk-4BEJVZRK.js.map