opendevbrowser 0.0.21 → 0.0.23

package/dist/chunk-3ILXPKSJ.js

@@ -0,0 +1,86 @@
+// src/utils/package-assets.ts
+import * as fs from "fs";
+import * as path from "path";
+import { fileURLToPath } from "url";
+var PACKAGE_NAME = "opendevbrowser";
+var SKILLS_DIR_NAME = "skills";
+var cachedPackageRoot = null;
+function findPackageRoot(startDir) {
+  let current = startDir;
+  while (true) {
+    const pkgPath = path.join(current, "package.json");
+    if (fs.existsSync(pkgPath)) {
+      try {
+        const parsed = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+        if (parsed.name === PACKAGE_NAME) {
+          return current;
+        }
+      } catch {
+      }
+    }
+    const parent = path.dirname(current);
+    if (parent === current) {
+      break;
+    }
+    current = parent;
+  }
+  return null;
+}
+function getPackageRoot() {
+  if (cachedPackageRoot) {
+    return cachedPackageRoot;
+  }
+  const moduleDir = path.dirname(fileURLToPath(import.meta.url));
+  const packageRoot = findPackageRoot(moduleDir);
+  if (!packageRoot) {
+    throw new Error(`Unable to locate ${PACKAGE_NAME} package root.`);
+  }
+  cachedPackageRoot = packageRoot;
+  return cachedPackageRoot;
+}
+function findBundledSkillsDir() {
+  try {
+    const skillsDir = path.join(getPackageRoot(), SKILLS_DIR_NAME);
+    return fs.existsSync(skillsDir) ? skillsDir : null;
+  } catch {
+    return null;
+  }
+}
+function getBundledSkillsDir() {
+  const skillsDir = findBundledSkillsDir();
+  if (!skillsDir) {
+    throw new Error(`Bundled skills directory not found in ${PACKAGE_NAME} package.`);
+  }
+  return skillsDir;
+}
+
+// src/skills/bundled-skill-directories.ts
+var bundledSkillDirectories = [
+  { name: "opendevbrowser-best-practices" },
+  { name: "opendevbrowser-continuity-ledger" },
+  { name: "opendevbrowser-data-extraction" },
+  { name: "opendevbrowser-design-agent" },
+  { name: "opendevbrowser-form-testing" },
+  { name: "opendevbrowser-login-automation" },
+  { name: "opendevbrowser-product-presentation-asset" },
+  { name: "opendevbrowser-research" },
+  { name: "opendevbrowser-shopping" }
+];
+var bundledSkillDirectoryByName = new Map(
+  bundledSkillDirectories.map((entry) => [entry.name, entry])
+);
+function listBundledSkillDirectories() {
+  return [...bundledSkillDirectories];
+}
+function isBundledSkillName(name) {
+  return bundledSkillDirectoryByName.has(name);
+}
+
+export {
+  getPackageRoot,
+  findBundledSkillsDir,
+  getBundledSkillsDir,
+  listBundledSkillDirectories,
+  isBundledSkillName
+};
+//# sourceMappingURL=chunk-3ILXPKSJ.js.map

package/dist/chunk-3ILXPKSJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/package-assets.ts","../src/skills/bundled-skill-directories.ts"],"sourcesContent":["import * as fs from \"fs\";\nimport * as path from \"path\";\nimport { fileURLToPath } from \"url\";\n\nconst PACKAGE_NAME = \"opendevbrowser\";\nconst SKILLS_DIR_NAME = \"skills\";\n\nlet cachedPackageRoot: string | null = null;\n\nfunction findPackageRoot(startDir: string): string | null {\n  let current = startDir;\n\n  while (true) {\n    const pkgPath = path.join(current, \"package.json\");\n    if (fs.existsSync(pkgPath)) {\n      try {\n        const parsed = JSON.parse(fs.readFileSync(pkgPath, \"utf-8\")) as { name?: string };\n        if (parsed.name === PACKAGE_NAME) {\n          return current;\n        }\n      } catch {\n        void 0;\n      }\n    }\n\n    const parent = path.dirname(current);\n    if (parent === current) {\n      break;\n    }\n    current = parent;\n  }\n\n  return null;\n}\n\nexport function getPackageRoot(): string {\n  if (cachedPackageRoot) {\n    return cachedPackageRoot;\n  }\n  const moduleDir = path.dirname(fileURLToPath(import.meta.url));\n  const packageRoot = findPackageRoot(moduleDir);\n  if (!packageRoot) {\n    throw new Error(`Unable to locate ${PACKAGE_NAME} package root.`);\n  }\n  cachedPackageRoot = packageRoot;\n  return cachedPackageRoot;\n}\n\nexport function findBundledSkillsDir(): string | null {\n  try {\n    const skillsDir = path.join(getPackageRoot(), SKILLS_DIR_NAME);\n    return fs.existsSync(skillsDir) ? skillsDir : null;\n  } catch {\n    return null;\n  }\n}\n\nexport function getBundledSkillsDir(): string {\n  const skillsDir = findBundledSkillsDir();\n  if (!skillsDir) {\n    throw new Error(`Bundled skills directory not found in ${PACKAGE_NAME} package.`);\n  }\n  return skillsDir;\n}\n","export interface BundledSkillDirectory {\n  name: string;\n}\n\nexport const bundledSkillDirectories: BundledSkillDirectory[] = [\n  { name: \"opendevbrowser-best-practices\" },\n  { name: \"opendevbrowser-continuity-ledger\" },\n  { name: \"opendevbrowser-data-extraction\" },\n  { name: \"opendevbrowser-design-agent\" },\n  { name: \"opendevbrowser-form-testing\" },\n  { name: \"opendevbrowser-login-automation\" },\n  { name: \"opendevbrowser-product-presentation-asset\" },\n  { name: \"opendevbrowser-research\" },\n  { name: \"opendevbrowser-shopping\" }\n];\n\nconst bundledSkillDirectoryByName = new Map(\n  bundledSkillDirectories.map((entry) => [entry.name, entry] as const)\n);\n\nexport function listBundledSkillDirectories(): BundledSkillDirectory[] {\n  return [...bundledSkillDirectories];\n}\n\nexport function getBundledSkillDirectory(name: string): BundledSkillDirectory | null {\n  return bundledSkillDirectoryByName.get(name) ?? null;\n}\n\nexport function isBundledSkillName(name: string): boolean {\n  return bundledSkillDirectoryByName.has(name);\n}\n"],"mappings":";AAAA,YAAY,QAAQ;AACpB,YAAY,UAAU;AACtB,SAAS,qBAAqB;AAE9B,IAAM,eAAe;AACrB,IAAM,kBAAkB;AAExB,IAAI,oBAAmC;AAEvC,SAAS,gBAAgB,UAAiC;AACxD,MAAI,UAAU;AAEd,SAAO,MAAM;AACX,UAAM,UAAe,UAAK,SAAS,cAAc;AACjD,QAAO,cAAW,OAAO,GAAG;AAC1B,UAAI;AACF,cAAM,SAAS,KAAK,MAAS,gBAAa,SAAS,OAAO,CAAC;AAC3D,YAAI,OAAO,SAAS,cAAc;AAChC,iBAAO;AAAA,QACT;AAAA,MACF,QAAQ;AAAA,MAER;AAAA,IACF;AAEA,UAAM,SAAc,aAAQ,OAAO;AACnC,QAAI,WAAW,SAAS;AACtB;AAAA,IACF;AACA,cAAU;AAAA,EACZ;AAEA,SAAO;AACT;AAEO,SAAS,iBAAyB;AACvC,MAAI,mBAAmB;AACrB,WAAO;AAAA,EACT;AACA,QAAM,YAAiB,aAAQ,cAAc,YAAY,GAAG,CAAC;AAC7D,QAAM,cAAc,gBAAgB,SAAS;AAC7C,MAAI,CAAC,aAAa;AAChB,UAAM,IAAI,MAAM,oBAAoB,YAAY,gBAAgB;AAAA,EAClE;AACA,sBAAoB;AACpB,SAAO;AACT;AAEO,SAAS,uBAAsC;AACpD,MAAI;AACF,UAAM,YAAiB,UAAK,eAAe,GAAG,eAAe;AAC7D,WAAU,cAAW,SAAS,IAAI,YAAY;AAAA,EAChD,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEO,SAAS,sBAA8B;AAC5C,QAAM,YAAY,qBAAqB;AACvC,MAAI,CAAC,WAAW;AACd,UAAM,IAAI,MAAM,yCAAyC,YAAY,WAAW;AAAA,EAClF;AACA,SAAO;AACT;;;AC3DO,IAAM,0BAAmD;AAAA,EAC9D,EAAE,MAAM,gCAAgC;AAAA,EACxC,EAAE,MAAM,mCAAmC;AAAA,EAC3C,EAAE,MAAM,iCAAiC;AAAA,EACzC,EAAE,MAAM,8BAA8B;AAAA,EACtC,EAAE,MAAM,8BAA8B;AAAA,EACtC,EAAE,MAAM,kCAAkC;AAAA,EAC1C,EAAE,MAAM,4CAA4C;AAAA,EACpD,EAAE,MAAM,0BAA0B;AAAA,EAClC,EAAE,MAAM,0BAA0B;AACpC;AAEA,IAAM,8BAA8B,IAAI;AAAA,EACtC,wBAAwB,IAAI,CAAC,UAAU,CAAC,MAAM,MAAM,KAAK,CAAU;AACrE;AAEO,SAAS,8BAAuD;AACrE,SAAO,CAAC,GAAG,uBAAuB;AACpC;AAMO,SAAS,mBAAmB,MAAuB;AACxD,SAAO,4BAA4B,IAAI,IAAI;AAC7C;","names":[]}

package/dist/{chunk-ZE2E7ZGH.js → chunk-K2TEHJCV.js}

@@ -5428,11 +5428,17 @@ var createCommunityProvider = (options = {}) => {
 };
 
 // src/providers/social/search-quality.ts
-var TARGETED_PLATFORMS = /* @__PURE__ */ new Set(["x", "bluesky", "reddit"]);
+var TARGETED_PLATFORMS = /* @__PURE__ */ new Set(["x", "bluesky", "reddit", "facebook"]);
 var SOCIAL_JS_REQUIRED_RE = /\b(?:javascript (?:is not available|required|is disabled(?: in this browser)?)|you need to enable javascript|please enable javascript)\b/i;
 var BLUESKY_LOGGED_OUT_SEARCH_RE = /\bsearch is currently unavailable when logged out\b/i;
 var BLUESKY_EMPTY_SEARCH_SHELL_RE = /\b(?:follow 10 people to get started|find people to follow)\b/i;
 var REDDIT_VERIFICATION_WALL_RE = /\b(?:please wait for verification|verify (?:you(?:'re| are) human|that you(?:'re| are) human)|security check)\b/i;
+var FACEBOOK_SEARCH_RESULTS_HEADING_RE = /\bsearch results\b/i;
+var FACEBOOK_SEARCH_RESULT_MARKERS = [
+  /\bshared with public\b/i,
+  /\bopen reel in reels viewer\b/i,
+  /\bcomment as\b/i
+];
 var REDDIT_BLOCKED_EXPANSION_HOSTS = ["accounts.google.com", "ads.reddit.com"];
 var REDDIT_BLOCKED_FIRST_SEGMENTS = /* @__PURE__ */ new Set(["account", "ads", "notifications", "submit", "verification"]);
 var FIRST_PARTY_HELP_HOSTS = {
@@ -5486,6 +5492,27 @@ var isPrimaryRedditHost = (host) => {
   const normalized = host.toLowerCase();
   return normalized === "www.reddit.com" || normalized === "reddit.com" || normalized === "old.reddit.com";
 };
+var isPrimaryFacebookHost = (host) => {
+  const normalized = host.toLowerCase();
+  return normalized === "www.facebook.com" || normalized === "facebook.com" || normalized === "m.facebook.com";
+};
+var isFacebookSearchLikePath = (pathname) => pathname === "/watch/search" || pathname === "/watch/search/" || pathname.startsWith("/watch/explore/") || pathname.startsWith("/search/") || pathname.startsWith("/public/") || pathname.startsWith("/hashtag/");
+var isBlockedFacebookNonContentUrl = (parsed, options) => {
+  if (!isPrimaryFacebookHost(parsed.hostname)) {
+    return false;
+  }
+  const pathname = parsed.pathname.toLowerCase();
+  if (pathname === "/" || pathname === "/login" || pathname === "/login/" || pathname === "/reg" || pathname === "/reg/" || pathname.startsWith("/recover/")) {
+    return true;
+  }
+  if ((pathname === "/watch" || pathname === "/watch/") && !parsed.searchParams.get("v")) {
+    return true;
+  }
+  if (isStaticMetadataPath(pathname)) {
+    return true;
+  }
+  return options.includeSearchRoute && isFacebookSearchLikePath(pathname);
+};
 var isBlockedRedditNonContentUrl = (parsed, options) => {
   const host = parsed.hostname.toLowerCase();
   if (matchesHost(host, REDDIT_BLOCKED_EXPANSION_HOSTS)) {
@@ -5511,6 +5538,8 @@ var isRootShellUrl = (platform, parsed) => {
       return host === "bsky.app" && (pathname === "/" || pathname === "/login");
     case "reddit":
       return isBlockedRedditNonContentUrl(parsed, { includeSearchRoute: false });
+    case "facebook":
+      return isBlockedFacebookNonContentUrl(parsed, { includeSearchRoute: false });
     default:
       return false;
   }
@@ -5525,6 +5554,8 @@ var isBlockedExpansionPath = (platform, parsed) => {
       return host === "bsky.app" && (pathname === "/" || pathname === "/login" || pathname === "/search" || isStaticMetadataPath(pathname) || /^\/profile\/[^/]+\/feed\/[^/]+$/.test(pathname));
     case "reddit":
       return isBlockedRedditNonContentUrl(parsed, { includeSearchRoute: true });
+    case "facebook":
+      return isBlockedFacebookNonContentUrl(parsed, { includeSearchRoute: true });
     default:
       return false;
   }
@@ -5539,6 +5570,8 @@ var isFirstPartySearchRoute = (platform, parsed) => {
       return host === "bsky.app" && pathname === "/search";
     case "reddit":
       return isPrimaryRedditHost(host) && pathname === "/search";
+    case "facebook":
+      return isPrimaryFacebookHost(host) && isFacebookSearchLikePath(pathname);
     default:
       return false;
   }
@@ -5604,6 +5637,51 @@ var isUsableRedditSearchEvidenceUrl = (url) => {
   const parsed = parseUrl(url);
   return parsed !== null && isPrimaryRedditHost(parsed.hostname) && /^\/r\/[^/]+\/comments\/[^/]+(?:\/|$)/.test(parsed.pathname.toLowerCase());
 };
+var isUsableFacebookSearchEvidenceUrl = (url) => {
+  const parsed = parseUrl(url);
+  if (parsed === null || !isPrimaryFacebookHost(parsed.hostname)) {
+    return false;
+  }
+  const pathname = parsed.pathname.toLowerCase();
+  if ((pathname === "/watch" || pathname === "/watch/") && parsed.searchParams.get("v")) {
+    return true;
+  }
+  return /^\/reel\/[^/]+\/?$/.test(pathname) || /^\/groups\/[^/]+\/posts\/[^/]+\/?$/.test(pathname) || /^\/[^/]+\/videos\/[^/]+\/?$/.test(pathname) || /^\/share\/v\/[^/]+\/?$/.test(pathname) || (pathname === "/permalink.php" || pathname === "/story.php") && parsed.searchParams.has("story_fbid") || pathname === "/photo/" && parsed.searchParams.has("fbid");
+};
+var isRetainableFacebookSearchSupportUrl = (url) => {
+  const parsed = parseUrl(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;
+  }
+  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;
+  const evidence = collectSocialSearchLinkEvidence("facebook", parsed.toString(), Array.isArray(input.links) ? input.links : []);
+  const supportLinkCount = evidence.usableLinks.filter(isRetainableFacebookSearchSupportUrl).length;
+  if (markerCount >= 2) {
+    return true;
+  }
+  if (!hasSearchHeading) {
+    return false;
+  }
+  if (markerCount >= 1) {
+    return true;
+  }
+  return supportLinkCount >= 2;
+};
 var isUsableSocialSearchContentUrl = (platform, url) => {
   switch (platform) {
     case "x":
@@ -5612,6 +5690,8 @@ var isUsableSocialSearchContentUrl = (platform, url) => {
       return isUsableBlueskySearchEvidenceUrl(url);
     case "reddit":
       return isUsableRedditSearchEvidenceUrl(url);
+    case "facebook":
+      return isUsableFacebookSearchEvidenceUrl(url);
     default:
       return false;
   }
@@ -5664,6 +5744,9 @@ var detectSocialSearchShell = (platform, input) => {
       browserRequired: true
     };
   }
+  if (parsed && isFirstPartySearchRoute(platform, parsed) && platform === "facebook" && hasFacebookSearchResultSignals(input)) {
+    return null;
+  }
   if (parsed && isFirstPartySearchRoute(platform, parsed) && !hasUsableFirstPartySearchEvidence(platform, parsed, links)) {
     return {
       providerShell: "social_render_shell",
@@ -5811,6 +5894,9 @@ var pickCarryForwardSocialSearchAttributes = (attributes) => {
   }, {});
   return Object.keys(carried).length > 0 ? carried : void 0;
 };
+var hasBrowserFallbackMode = (attributes) => typeof attributes?.browser_fallback_mode === "string" && attributes.browser_fallback_mode.length > 0;
+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 = [
     ...coerceStringArray2(row.attributes?.links),
@@ -5929,7 +6015,8 @@ var createSocialPlatformProvider = (profile, options = {}) => {
         if (!isHttpUrl3(canonical) || seen.has(canonical)) continue;
         seen.add(canonical);
         const links = extractLinks3(profile.platform, row, canonical).slice(0, traversal.expansionPerRecord);
-        const keepRow = !isFirstPartySocialSearchRoute(profile.platform, canonical);
+        const keepFirstPartySearchRow = shouldKeepRecoveredFacebookSearchRow(profile.platform, row) || profile.platform === "facebook" && links.length === 0;
+        const keepRow = !isFirstPartySocialSearchRoute(profile.platform, canonical) || keepFirstPartySearchRow;
         const carryForwardAttributes = keepRow ? void 0 : pickCarryForwardSocialSearchAttributes(row.attributes);
         if (keepRow) {
           rows.push({
@@ -7684,23 +7771,28 @@ var createYouTubeProvider = (options = {}) => {
     supportsThreads: false
   }, options);
 };
-var withDefaultYouTubeOptions = (options = {}) => ({
-  ...options,
-  recoveryHints: options.recoveryHints ?? (() => ({
-    preferredFallbackModes: ["managed_headed"],
-    challengeProne: true,
-    settleTimeoutMs: 5e3,
-    captureDelayMs: 500
-  })),
-  defaultTraversal: {
-    pageLimit: options.defaultTraversal?.pageLimit ?? 1,
-    hopLimit: options.defaultTraversal?.hopLimit ?? 0,
-    expansionPerRecord: options.defaultTraversal?.expansionPerRecord ?? 1,
-    maxRecords: options.defaultTraversal?.maxRecords ?? 8
-  },
-  search: buildSearch(options.search),
-  fetch: buildFetch(options)
-});
+var withDefaultYouTubeOptions = (options = {}) => {
+  const resolvedOptions = {
+    ...options,
+    recoveryHints: options.recoveryHints ?? (() => ({
+      preferredFallbackModes: ["extension", "managed_headed"],
+      challengeProne: true,
+      settleTimeoutMs: 5e3,
+      captureDelayMs: 500
+    })),
+    defaultTraversal: {
+      pageLimit: options.defaultTraversal?.pageLimit ?? 1,
+      hopLimit: options.defaultTraversal?.hopLimit ?? 0,
+      expansionPerRecord: options.defaultTraversal?.expansionPerRecord ?? 1,
+      maxRecords: options.defaultTraversal?.maxRecords ?? 8
+    }
+  };
+  return {
+    ...resolvedOptions,
+    search: buildSearch(resolvedOptions.search),
+    fetch: buildFetch(resolvedOptions)
+  };
+};
 
 // src/providers/social/index.ts
 var createSocialProviders = (options = {}) => {
@@ -11252,27 +11344,76 @@ var createSuccessHandoff = (followthroughSummary, suggestedNextAction, suggested
   suggestedNextAction,
   suggestedSteps
 });
-var buildResearchSuccessHandoff = () => {
+var cliExample = (command, args = "") => `npx opendevbrowser ${command}${args ? ` ${args}` : ""}`;
+var quoteCliValue = (value) => JSON.stringify(value);
+var buildResearchRerunCommand = (topic) => cliExample(
+  "research run",
+  `--topic ${quoteCliValue(topic)} --days 14 --source-selection auto --sources web,community --mode json --output-format json`
+);
+var buildShoppingRerunCommand = (input) => {
+  const providers = input.providers?.length ? ` --providers ${input.providers.join(",")}` : " --providers shopping/bestbuy,shopping/ebay";
+  const budget = typeof input.budget === "number" ? ` --budget ${input.budget}` : "";
+  const region = input.region ? ` --region ${quoteCliValue(input.region)}` : "";
+  const browserMode = ` --browser-mode ${input.browserMode ?? "managed"}`;
+  const sort = input.sort ? ` --sort ${input.sort}` : "";
+  return cliExample(
+    "shopping run",
+    `--query ${quoteCliValue(input.query)}${providers}${budget}${region}${browserMode}${sort} --mode json --output-format json`
+  );
+};
+var buildProductVideoRerunCommand = (input = {}) => {
+  const target = input.productUrl ? `--product-url ${quoteCliValue(input.productUrl)}` : `--product-name ${quoteCliValue(input.productName ?? "<product-name>")}`;
+  const providerHint = input.providerHint ? ` --provider-hint ${input.providerHint}` : "";
+  const screenshots = input.includeScreenshots ? " --include-screenshots" : "";
+  const allImages = input.includeAllImages ? " --include-all-images" : "";
+  const includeCopy = input.includeCopy ? " --include-copy" : "";
+  return cliExample(
+    "product-video run",
+    `${target}${providerHint}${screenshots}${allImages}${includeCopy} --output-format json`
+  );
+};
+var buildMacroResolveArgs = (input, options) => {
+  const defaultProvider = input.defaultProvider ? ` --default-provider ${input.defaultProvider}` : "";
+  const execute = options?.execute ? " --execute" : "";
+  const challenge = options?.challengeAutomationMode ? ` --challenge-automation-mode ${options.challengeAutomationMode}` : "";
+  const outputFormat = options?.includeOutputFormat === false ? "" : " --output-format json";
+  return `--expression ${quoteCliValue(input.expression)}${defaultProvider}${execute}${challenge}${outputFormat}`;
+};
+var buildMacroPreviewCommand = (input) => cliExample("macro-resolve", buildMacroResolveArgs(input));
+var buildMacroExecuteCommand = (input, challengeAutomationMode) => cliExample("macro-resolve", buildMacroResolveArgs(input, {
+  execute: true,
+  challengeAutomationMode
+}));
+var buildResearchSuccessHandoff = (topic) => {
+  const rerunCommand = buildResearchRerunCommand(topic);
   return createSuccessHandoff(
     "Review the ranked records and artifact bundle before turning the result into a publishable claim.",
-    "Open the returned artifact path, inspect the supporting records, and rerun with explicit --sources or a tighter timebox if you need stronger evidence.",
+    `Open the returned artifact path, inspect the supporting records, and rerun ${rerunCommand} if you need a tighter evidence set.`,
     [
       { reason: "Check which records actually support the final claim." },
-      { reason: "Rerun with explicit sources or a narrower timebox if the evidence set is still too broad." }
+      {
+        reason: "Rerun with explicit sources and a narrower timebox if the evidence set is still too broad.",
+        command: rerunCommand
+      }
     ]
   );
 };
-var buildShoppingSuccessHandoff = () => {
+var buildShoppingSuccessHandoff = (input) => {
+  const rerunCommand = buildShoppingRerunCommand(input);
   return createSuccessHandoff(
     "Review the offer set and diagnostics before calling any result a strong deal.",
-    "Inspect the offers and meta.offerFilterDiagnostics, then rerun with explicit providers or budget and region adjustments if you need a tighter comparison.",
+    `Inspect the offers and meta.offerFilterDiagnostics, then rerun ${rerunCommand} if you need a tighter comparison.`,
     [
       { reason: "Check which offers survived the workflow filters and why." },
-      { reason: "Rerun with explicit providers or updated budget and region inputs if the comparison is still noisy." }
+      {
+        reason: "Rerun with explicit providers or updated budget and region inputs if the comparison is still noisy.",
+        command: rerunCommand
+      }
     ]
   );
 };
-var buildProductVideoSuccessHandoff = () => {
+var buildProductVideoSuccessHandoff = (input = {}) => {
+  const rerunCommand = buildProductVideoRerunCommand(input);
   return createSuccessHandoff(
     "Review the generated asset pack to confirm whether it is visual-ready or metadata-first before briefing production.",
     `Open the returned pack path, inspect manifest.json plus copy and features, then run ${PRODUCT_VIDEO_BRIEF_HELPER_COMMAND} to generate production briefs and sourcing notes.`,
@@ -11282,10 +11423,50 @@ var buildProductVideoSuccessHandoff = () => {
         reason: "Run the product-presentation-asset brief helper on manifest.json to generate the production brief files.",
         command: PRODUCT_VIDEO_BRIEF_HELPER_COMMAND
       },
+      {
+        reason: "Rerun the asset workflow with adjusted provider or media flags when the current pack is too thin.",
+        command: rerunCommand
+      },
       { reason: "Source or capture visuals before final handoff if the pack is metadata-first." }
     ]
   );
 };
+var buildMacroResolveSuccessHandoff = (input) => {
+  const previewCommand = buildMacroPreviewCommand(input);
+  const executeCommand = buildMacroExecuteCommand(input);
+  const browserRetryCommand = buildMacroExecuteCommand(input, "browser");
+  if (!input.execute) {
+    return createSuccessHandoff(
+      "Review the resolved provider action and provenance before executing the macro.",
+      `Run ${executeCommand} when the resolved action looks correct.`,
+      [
+        { reason: "Inspect resolution.action and resolution.provenance to confirm provider and query shaping." },
+        { reason: "Execute the resolved macro once the plan looks correct.", command: executeCommand },
+        { reason: "Add --default-provider only when you need to force a different provider lane.", command: previewCommand }
+      ]
+    );
+  }
+  if (input.blocked) {
+    return createSuccessHandoff(
+      "Review execution.meta.blocker and failures before retrying the macro.",
+      `Run ${browserRetryCommand} after checking execution.meta.blocker and the current recovery path.`,
+      [
+        { reason: "Inspect execution.meta.blocker and execution.failures before retrying." },
+        { reason: "Retry with browser-scoped challenge automation when the blocker requires live follow-up.", command: browserRetryCommand },
+        { reason: "Preview the resolved action again if you need to switch providers before another execute attempt.", command: previewCommand }
+      ]
+    );
+  }
+  return createSuccessHandoff(
+    "Review execution.records and trace metadata before widening the macro or changing providers.",
+    `Inspect execution.records and execution.meta, then rerun ${previewCommand} if you need a narrower plan.`,
+    [
+      { reason: "Inspect execution.records and execution.meta to confirm the resolved action hit the expected lane." },
+      { reason: "Preview the macro again before changing providers or expression scope.", command: previewCommand },
+      { reason: "Re-execute with browser-scoped challenge automation when the target requires live browser recovery.", command: browserRetryCommand }
+    ]
+  );
+};
 
 // src/providers/shopping-postprocess.ts
 import { createHash as createHash4 } from "crypto";
@@ -13419,6 +13600,7 @@ var workflowTestUtils = {
   redactRawCapture: (record) => redactRawCapture(record),
   toProviderSource: (providerId) => toProviderSource2(providerId),
   resolveShoppingProviderIdForUrl: (url) => resolveShoppingProviderIdForUrl(url),
+  normalizeProductVideoProviderHint: (productUrl, providerHint, fallbackProvider) => normalizeProductVideoProviderHint(productUrl, providerHint, fallbackProvider),
   hasTranscriptSuccess: (record) => hasTranscriptSuccess(record),
   sanitizeFeatureList: (values) => sanitizeFeatureList(values),
   parsePriceFromContent: (content) => parsePriceFromContent(content),
@@ -13519,6 +13701,15 @@ var resolveShoppingProviderIdForUrl = (url) => {
     return null;
   }
 };
+var normalizeProductVideoProviderHint = (productUrl, providerHint, fallbackProvider) => {
+  if (fallbackProvider?.includes("/")) return fallbackProvider;
+  if (providerHint?.includes("/")) return providerHint;
+  const shoppingProviderId = resolveShoppingProviderIdForUrl(productUrl);
+  if (shoppingProviderId) {
+    return providerHint ? `shopping/${providerHint}` : fallbackProvider ?? shoppingProviderId;
+  }
+  return fallbackProvider ?? providerHint;
+};
 var IMAGE_ASSET_RE = /\.(?:png|jpg|jpeg|webp|gif)(?:[?#].*)?$/i;
 var isHttpAssetUrl = (value) => {
   try {
@@ -14423,7 +14614,7 @@ var runResearchWorkflow = async (runtime, input) => {
     failures: mergedFailures,
     alerts: buildWorkflowAlerts(runtime, mergedFailures)
   }, primaryConstraintFailures);
-  const handoff = buildResearchSuccessHandoff();
+  const handoff = buildResearchSuccessHandoff(plan.compiled.topic);
   const responseMeta = withFollowthroughMeta(meta, handoff);
   const rendered = renderResearch({
     mode: workflowInput.mode,
@@ -14602,7 +14793,14 @@ var runShoppingWorkflow = async (runtime, input) => {
   if (typeof filterConstraintSummary === "string") {
     meta = withPrimaryConstraintSummaryOverride(meta, filterConstraintSummary);
   }
-  const handoff = buildShoppingSuccessHandoff();
+  const handoff = buildShoppingSuccessHandoff({
+    query: plan.compiled.query,
+    providers: plan.compiled.providerIds,
+    budget: plan.compiled.budget,
+    region: workflowInput.region,
+    browserMode: workflowInput.browserMode,
+    sort: workflowInput.sort
+  });
   const responseMeta = withFollowthroughMeta(meta, handoff);
   const rendered = renderShopping({
     mode: workflowInput.mode,
@@ -14966,6 +15164,7 @@ var runProductVideoWorkflow = async (runtime, input, options = {}) => {
   const refreshedMetadata = needsProductMetadataRefresh(primary, productUrl) ? await refreshProductMetadata(productUrl, remainingTimeoutMs()) : null;
   const primaryOffer = extractShoppingOffer(primary, /* @__PURE__ */ new Date());
   const preferredPrice = resolvePreferredProductPrice(primary, productUrl, refreshedMetadata?.price, primaryOffer);
+  providerHint = normalizeProductVideoProviderHint(productUrl, providerHint, primary.provider);
   const resolvedBrand = resolveProductBrand(primary, productUrl, refreshedMetadata?.brand);
   const resolvedTitle = resolveProductTitle(primary, productUrl, resolvedBrand, refreshedMetadata?.title);
   const resolvedPrice = resolveProductPrice(primary, productUrl, refreshedMetadata?.price, primaryOffer);
@@ -15073,7 +15272,14 @@ var runProductVideoWorkflow = async (runtime, input, options = {}) => {
   const cookieDiagnostics = summarizeCookieDiagnostics(details.failures, details.records);
   const antiBotPressure = summarizeAntiBotPressure(details.failures);
   const primaryIssue = summarizePrimaryProviderIssue(details.failures);
-  const handoff = buildProductVideoSuccessHandoff();
+  const handoff = buildProductVideoSuccessHandoff({
+    productUrl,
+    productName: workflowInput.product_name,
+    providerHint,
+    includeScreenshots: workflowInput.include_screenshots,
+    includeAllImages: workflowInput.include_all_images,
+    includeCopy: workflowInput.include_copy
+  });
   const meta = withFollowthroughMeta({
     alerts: buildWorkflowAlerts(runtime, details.failures),
     failures: details.failures,
@@ -15118,11 +15324,11 @@ var WORKFLOW_KIND_BY_SUSPENDED_INTENT_KIND2 = {
   "workflow.inspiredesign": "inspiredesign",
   "workflow.product_video": "product_video"
 };
-var EXTENSION_FIRST_SOCIAL_FALLBACK_PLATFORMS = /* @__PURE__ */ new Set(["x", "reddit", "bluesky", "linkedin"]);
+var EXTENSION_FIRST_SOCIAL_FALLBACK_PLATFORMS = /* @__PURE__ */ new Set(["x", "reddit", "bluesky", "facebook", "linkedin"]);
 var EXTENSION_MINIMAL_TRAVERSAL_SOCIAL_PLATFORMS = /* @__PURE__ */ new Set(["linkedin"]);
 var EXTENSION_FIRST_FALLBACK_MODES = ["extension", "managed_headed"];
 var SOCIAL_BROWSER_RECOVERY_REASON_CODES = /* @__PURE__ */ new Set(["challenge_detected"]);
-var SEARCH_RENDER_RECOVERY_SOCIAL_PLATFORMS = /* @__PURE__ */ new Set(["x", "bluesky", "reddit"]);
+var SEARCH_RENDER_RECOVERY_SOCIAL_PLATFORMS = /* @__PURE__ */ new Set(["x", "bluesky", "reddit", "facebook"]);
 var withPrioritizedFallbackModes = (prioritized, existing) => [.../* @__PURE__ */ new Set([...prioritized, ...existing ?? []])];
 var buildSocialRecoveryHints = (platform, options) => {
   const existing = options?.recoveryHints?.();
@@ -15274,7 +15480,7 @@ var SOCIAL_SEARCH_ENDPOINTS = {
   x: (query, page) => `https://x.com/search?q=${encodeURIComponent(query)}&f=live&page=${page}`,
   reddit: (query, page) => `https://www.reddit.com/search/?q=${encodeURIComponent(query)}&sort=relevance&t=all&page=${page}`,
   bluesky: (query, page) => `https://bsky.app/search?q=${encodeURIComponent(query)}&page=${page}`,
-  facebook: (query, page) => `https://www.facebook.com/search/top?q=${encodeURIComponent(query)}&page=${page}`,
+  facebook: (query, page) => `https://www.facebook.com/watch/search/?q=${encodeURIComponent(query)}&page=${page}`,
   linkedin: (query, page) => `https://www.linkedin.com/search/results/content/?keywords=${encodeURIComponent(query)}&page=${page}`,
   instagram: (query, page) => `https://www.instagram.com/explore/search/keyword/?q=${encodeURIComponent(query)}&page=${page}`,
   tiktok: (query, page) => `https://www.tiktok.com/search?q=${encodeURIComponent(query)}&page=${page}`,
@@ -17246,6 +17452,7 @@ export {
   renderResearch,
   renderShopping,
   renderInspiredesign,
+  buildMacroResolveSuccessHandoff,
   workflowTestUtils,
   runResearchWorkflow,
   runShoppingWorkflow,
@@ -17256,4 +17463,4 @@ export {
   createProviderRuntime,
   createDefaultRuntime
 };
-//# sourceMappingURL=chunk-ZE2E7ZGH.js.map
+//# sourceMappingURL=chunk-K2TEHJCV.js.map