opendevbrowser 0.0.31 → 0.0.32

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

@@ -10,7 +10,7 @@ import {
   INSPIREDESIGN_HANDOFF_RECOMMENDED_SKILLS,
   buildInspiredesignFollowthroughSummary,
   buildInspiredesignNextStep
-} from "./chunk-KZ2IXVQT.js";
+} from "./chunk-2X4JFMKJ.js";
 import {
   applyPromptGuard,
   applyProviderIssueHint,
@@ -1968,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((resolve) => setTimeout(resolve, Math.max(250, args.step.holdMs ?? DEFAULT_HOLD_MS2)));
+      await new Promise((resolve2) => setTimeout(resolve2, Math.max(250, args.step.holdMs ?? DEFAULT_HOLD_MS2)));
       await args.handle.pointerUp(args.sessionId, point.x, point.y, args.targetId, "left", 1);
       return;
     }
@@ -3685,8 +3685,8 @@ var CrawlWorkerPool = class {
     }
     const taskId = this.nextTaskId;
     this.nextTaskId += 1;
-    return new Promise((resolve, reject) => {
-      this.queue.push({ id: taskId, input, resolve, reject });
+    return new Promise((resolve2, reject) => {
+      this.queue.push({ id: taskId, input, resolve: resolve2, reject });
       this.dispatch();
     });
   }
@@ -9086,7 +9086,10 @@ var isWorkflowResumeEnvelope = (value) => isJsonRecord(value) && isWorkflowKind(
 var isWorkflowResumePayload = (value) => isJsonRecord(value) && isWorkflowResumeEnvelope(value.workflow);
 
 // src/providers/workflows.ts
-import { createHash as createHash7 } from "crypto";
+import { createHash as createHash8 } from "crypto";
+import { mkdtemp as mkdtemp2, readFile, rm as rm2 } from "fs/promises";
+import { tmpdir as tmpdir2 } from "os";
+import { join as join3, resolve } from "path";
 
 // src/providers/workflow-output-root.ts
 import { join as join2 } from "path";
@@ -9282,7 +9285,7 @@ var enrichResearchRecords = (records, timebox, now = /* @__PURE__ */ new Date())
 };
 
 // src/inspiredesign/contract.ts
-import { createHash as createHash3 } from "crypto";
+import { createHash as createHash4 } from "crypto";
 
 // skills/opendevbrowser-design-agent/assets/templates/canvas-generation-plan.design.v1.json
 var canvas_generation_plan_design_v1_default = {
@@ -11193,6 +11196,15 @@ var expandInspiredesignBrief = (brief, preferredFormatId) => {
 var SIGNAL_LIMIT = 5;
 var SIGNAL_CLIP = 180;
 var PATTERN_LIMIT = 6;
+var SCORE_FETCH_CAPTURED = 20;
+var SCORE_CAPTURE_CAPTURED = 20;
+var SCORE_VISUAL_CAPTURED = 30;
+var SCORE_SNAPSHOT = 10;
+var SCORE_CLONE = 8;
+var SCORE_DOM = 8;
+var SCORE_PUBLIC_LANDING = 6;
+var SCORE_SIGNAL_CAP = 12;
+var MAX_REFERENCE_SCORE = 100;
 var ADVANCED_MOTION_FIELDS = [
   "Advisory shader-style gradients: specify effect type, uniforms, static fallback, and reduced-motion replacement as design language only.",
   "Advisory WebGL-style depth cues: describe layered depth, camera-like parallax, and spatial hierarchy without requiring WebGL runtime.",
@@ -11211,7 +11223,7 @@ var textFromHtml = (html) => {
 var stripActionRefs = (value) => value.replace(/\[r\d+\]\s+(?:link|button|combobox|textbox|option)\s+/gi, "").replace(/\[r\d+\]\s+/gi, "").replace(/\bvalue=/gi, "");
 var isCodeOrCssPreview = (value) => {
   const lower = value.toLowerCase();
-  return lower.includes("dangerouslysetinnerhtml") || lower.includes("opendevbrowser-root") || lower.includes("align-content:") || lower.startsWith("import ") || /^[.#][a-z0-9_-]+\s*\{/.test(lower) || lower.includes("{") && /[a-z-]+:\s*[^;]+;/.test(lower);
+  return lower.includes("dangerouslysetinnerhtml") || lower.includes("opendevbrowser-root") || lower.includes("--gestalt-") || lower.includes("align-content:") || lower.startsWith(":root") || lower.startsWith("import ") || /^[.#][a-z0-9_-]+\s*\{/.test(lower) || lower.includes("{") && /[a-z-]+:\s*[^;]+;/.test(lower);
 };
 var cleanEvidenceText = (value) => {
   return trimText(stripActionRefs(value).replace(/[{};]/g, " "));
@@ -11232,6 +11244,23 @@ var DIAGNOSTIC_TEXT_MARKERS = [
   "complete the verification",
   "blocked reference"
 ];
+var INTERFACE_CHROME_TEXT_MARKERS = [
+  "your profile",
+  "your boards",
+  "remove search input",
+  "settings & support",
+  "pin card",
+  "voice search",
+  "lens",
+  "back to home page",
+  "toggle mobile menu",
+  "facebook",
+  "instagram",
+  "updates",
+  "messages",
+  "when autocomplete results are available",
+  "touch device users"
+];
 var PUBLIC_LANDING_TEXT_MARKERS = [
   "church",
   "landing page",
@@ -11271,6 +11300,14 @@ var isDiagnosticText = (value) => {
   const lower = value.toLowerCase();
   return DIAGNOSTIC_TEXT_MARKERS.some((marker) => lower.includes(marker));
 };
+var isInterfaceChromeText = (value) => {
+  const lower = value.toLowerCase();
+  if (lower === "your profile" || lower === "adobe, inc." || lower === "dribbble: the community for graphic design" || /^https?:\/\/\S+$/.test(lower) || lower.includes("when autocomplete results are available") && lower.includes("touch device users") || lower.includes("get 20%") && lower.includes("dribbble: the community for graphic design") || lower.includes("our free wordpress themes are downloaded") && lower.includes("get them now")) {
+    return true;
+  }
+  const markerCount = INTERFACE_CHROME_TEXT_MARKERS.filter((marker) => lower.includes(marker)).length;
+  return markerCount >= 3 || lower.includes("pin card") && lower.includes("your profile");
+};
 var hasPublicLandingSignal = (value) => {
   const lower = value.toLowerCase();
   const strongCount = PUBLIC_LANDING_TEXT_MARKERS.filter((marker) => lower.includes(marker)).length;
@@ -11281,7 +11318,7 @@ var hasPublicLandingSignal = (value) => {
 var pushSignal = (signals, value) => {
   if (!value || isCodeOrCssPreview(value)) return;
   const text = cleanEvidenceText(value);
-  if (isCodeOrCssPreview(text) || isDiagnosticText(text)) return;
+  if (isCodeOrCssPreview(text) || isDiagnosticText(text) || isInterfaceChromeText(text)) return;
   if (text.length > 0 && !signals.includes(text)) {
     signals.push(text);
   }
@@ -11300,7 +11337,7 @@ var getInspiredesignReferenceSignals = (reference) => {
 var hasCleanSignal = (value) => {
   if (!value || isCodeOrCssPreview(value)) return false;
   const text = cleanEvidenceText(value);
-  return text.length > 0 && !isCodeOrCssPreview(text) && !isDiagnosticText(text);
+  return text.length > 0 && !isCodeOrCssPreview(text) && !isDiagnosticText(text) && !isInterfaceChromeText(text);
 };
 var hasUsableCloneCreativeEvidence = (reference) => hasCleanSignal(reference.capture?.clone?.componentPreview);
 var hasUsableCaptureEvidence = (reference) => hasCleanSignal(reference.capture?.snapshot?.content) || hasUsableCloneCreativeEvidence(reference) || hasCleanSignal(textFromHtml(reference.capture?.dom?.outerHTML));
@@ -11316,9 +11353,16 @@ var firstSignal = (reference) => {
     textFromHtml(reference.capture?.dom?.outerHTML),
     reference.excerpt,
     reference.title
-  ].map((value) => value ? cleanEvidenceText(value) : "").find((value) => value.length > 0 && !isCodeOrCssPreview(value) && !isDiagnosticText(value));
+  ].map((value) => value ? cleanEvidenceText(value) : "").find((value) => value.length > 0 && !isCodeOrCssPreview(value) && !isDiagnosticText(value) && !isInterfaceChromeText(value));
   return preferred ? clipText(preferred, SIGNAL_CLIP) : reference.url;
 };
+var displayNameForReference = (reference, primarySignal) => {
+  const title = reference.title ? cleanEvidenceText(reference.title) : "";
+  if (title && !isDiagnosticText(title) && !isInterfaceChromeText(title)) {
+    return clipText(title, SIGNAL_CLIP);
+  }
+  return primarySignal !== reference.url ? primarySignal : reference.url;
+};
 var REFERENCE_PATTERN_RULES = [
   {
     summary: "location-first church discovery with regional pathways",
@@ -11376,8 +11420,49 @@ var deriveCapturedVia = (reference) => {
     methods.push("clone");
   }
   if (reference.capture?.dom?.outerHTML.trim()) methods.push("dom");
+  if (reference.capture?.visual?.status === "captured") methods.push("visual");
   return methods;
 };
+var scoreReference = (reference, signals, isPublicLanding) => {
+  let score = 0;
+  if (reference.fetchStatus === "captured") score += SCORE_FETCH_CAPTURED;
+  if (reference.captureStatus === "captured") score += SCORE_CAPTURE_CAPTURED;
+  if (reference.capture?.visual?.status === "captured") score += SCORE_VISUAL_CAPTURED;
+  if (reference.capture?.snapshot?.content.trim()) score += SCORE_SNAPSHOT;
+  if (hasUsableCloneCreativeEvidence(reference)) score += SCORE_CLONE;
+  if (reference.capture?.dom?.outerHTML.trim()) score += SCORE_DOM;
+  if (isPublicLanding) score += SCORE_PUBLIC_LANDING;
+  score += Math.min(SCORE_SIGNAL_CAP, signals.length * 2);
+  return Math.min(MAX_REFERENCE_SCORE, score);
+};
+var confidenceFromScore = (score) => Number((score / MAX_REFERENCE_SCORE).toFixed(2));
+var deriveVisualStrengths = (reference, patterns) => {
+  const strengths = [
+    ...reference.capture?.visual?.status === "captured" ? ["Screenshot artifact is available for direct visual inspection."] : [],
+    ...reference.capture?.snapshot?.content.trim() ? ["Snapshot text confirms visible hierarchy and interaction targets."] : [],
+    ...hasUsableCloneCreativeEvidence(reference) ? ["Clone preview exposes reusable component and styling cues."] : [],
+    ...patterns.slice(0, 2).map((pattern) => `Reusable visual cue: ${pattern}.`)
+  ];
+  return strengths.slice(0, PATTERN_LIMIT);
+};
+var deriveVisualRisks = (reference) => {
+  const risks = [
+    ...reference.capture?.visual?.status !== "captured" ? ["No finalized screenshot artifact, so visual claims must stay conservative."] : [],
+    ...reference.capture?.visual?.status === "failed" && reference.capture.visual.failure ? [`Screenshot failure: ${reference.capture.visual.failure}.`] : [],
+    ...(reference.capture?.visual?.warnings ?? []).map((warning) => `Screenshot warning: ${warning}.`),
+    ...reference.fetchStatus !== "captured" ? ["Fetch evidence failed or was skipped, so use browser capture cautiously."] : []
+  ];
+  return risks.length > 0 ? risks.slice(0, PATTERN_LIMIT) : ["No major visual evidence risk detected in the captured reference."];
+};
+var selectionReasonForScore = (score, capturedVia) => {
+  if (capturedVia.includes("visual")) {
+    return `Ranked for screenshot-backed visual evidence plus ${capturedVia.join(", ")} capture.`;
+  }
+  if (score >= 50) {
+    return `Ranked for strong text and structural evidence from ${capturedVia.join(", ") || "reference metadata"}.`;
+  }
+  return "Ranked for limited but usable reference cues.";
+};
 var deriveComponentFamilies = (format, patterns, isPublicLanding) => {
   const base = isPublicLanding ? "hero composition, proof bands, narrative pathways, service or story sections, conversion CTA, and footer" : format.componentGrammar;
   return [base, ...patterns.slice(0, 3)];
@@ -11405,12 +11490,19 @@ var deriveReferenceEntry = (reference, format) => {
   const primarySignal = firstSignal(reference);
   const patterns = appendSourceDetail(derivePatternSummaries(signals, primarySignal), primarySignal);
   const isPublicLanding = signals.some(hasPublicLandingSignal);
+  const capturedVia = deriveCapturedVia(reference);
+  const score = scoreReference(reference, signals, isPublicLanding);
   return {
     id: reference.id,
-    name: reference.title ?? reference.url,
+    score,
+    confidence: confidenceFromScore(score),
+    name: displayNameForReference(reference, primarySignal),
     url: reference.url,
     surfaceType: isPublicLanding ? "public landing page" : format.archetype,
-    capturedVia: deriveCapturedVia(reference),
+    capturedVia,
+    selectionReason: selectionReasonForScore(score, capturedVia),
+    visualStrengths: deriveVisualStrengths(reference, patterns),
+    visualRisks: deriveVisualRisks(reference),
     layoutRecipe: patterns.join("; "),
     contentHierarchy: patterns.slice(0, 4),
     componentFamilies: deriveComponentFamilies(format, patterns, isPublicLanding),
@@ -11421,16 +11513,41 @@ var deriveReferenceEntry = (reference, format) => {
     whyItWorks: reference.captureStatus === "captured" ? "Captured reference evidence provides reusable hierarchy, rhythm, and component cues." : "Available reference text provides directional content and hierarchy cues."
   };
 };
+var sortReferenceEntries = (entries) => entries.slice().sort((left, right) => right.score - left.score || left.id.localeCompare(right.id) || left.url.localeCompare(right.url)).map((entry, index) => ({
+  rank: index + 1,
+  ...entry
+}));
+var rejectionReasonForReference = (reference) => {
+  if (reference.fetchStatus === "failed" && reference.captureStatus === "failed") {
+    return "Fetch and capture did not produce usable creative evidence.";
+  }
+  if (reference.captureStatus === "failed") {
+    return "Capture did not produce usable creative evidence.";
+  }
+  if (reference.fetchStatus === "failed") {
+    return "Fetch did not produce usable creative evidence.";
+  }
+  return "Reference evidence was diagnostic, empty, or too weak for creative synthesis.";
+};
+var buildRejectedReferences = (references) => references.filter((reference) => !hasInspiredesignUsableReferenceEvidence(reference)).map((reference) => ({
+  id: reference.id,
+  url: reference.url,
+  reason: rejectionReasonForReference(reference),
+  fetchStatus: reference.fetchStatus,
+  captureStatus: reference.captureStatus
+}));
 var buildInspiredesignReferencePatternBoard = (briefId, format, references) => {
   const entries = references.filter(hasInspiredesignUsableReferenceEvidence).map((reference) => deriveReferenceEntry(reference, format));
-  const sharedStrengths = entries.flatMap((entry) => entry.patternsToBorrow).slice(0, 6);
-  const targetSurface = entries.some((entry) => entry.surfaceType === "public landing page") ? "reference-led public landing page" : format.layoutArchetype;
+  const rankedEntries = sortReferenceEntries(entries);
+  const sharedStrengths = rankedEntries.flatMap((entry) => entry.patternsToBorrow).slice(0, 6);
+  const targetSurface = rankedEntries.some((entry) => entry.surfaceType === "public landing page") ? "reference-led public landing page" : format.layoutArchetype;
   return {
     briefId,
     targetSurface,
-    references: entries,
+    references: rankedEntries,
+    rejectedReferences: buildRejectedReferences(references),
     synthesis: {
-      dominantDirection: entries[0]?.layoutRecipe ?? format.archetype,
+      dominantDirection: rankedEntries[0]?.layoutRecipe ?? format.archetype,
       sharedStrengths,
       sharedFailuresToAvoid: [...format.antiPatterns],
       contractDeltas: [
@@ -11569,6 +11686,176 @@ var buildInspiredesignDesignVectors = (format, board) => {
   };
 };
 
+// src/inspiredesign/meta-prompt.ts
+var formatList = (items) => items.length > 0 ? items.map((item) => `- ${item}`).join("\n") : "- No evidence-backed item available.";
+var formatRankedReferences = (board) => {
+  if (board.references.length === 0) {
+    return "- No usable references were ranked. Work from the brief and note missing evidence.";
+  }
+  return board.references.map((reference) => [
+    `### Rank ${reference.rank}: ${reference.name}`,
+    `- URL: ${reference.url}`,
+    `- Score: ${reference.score}`,
+    `- Confidence: ${reference.confidence.toFixed(2)}`,
+    `- Selection reason: ${reference.selectionReason}`,
+    `- Borrow: ${reference.patternsToBorrow.join("; ")}`,
+    `- Reject: ${reference.patternsToReject.join("; ")}`,
+    `- Visual strengths: ${reference.visualStrengths.join("; ")}`,
+    `- Visual risks: ${reference.visualRisks.join("; ")}`
+  ].join("\n")).join("\n\n");
+};
+var formatRejectedReferences = (board) => {
+  if (board.rejectedReferences.length === 0) {
+    return "- No references were rejected from the creative synthesis.";
+  }
+  return board.rejectedReferences.map((reference) => `- ${reference.url}: ${reference.reason} (fetch=${reference.fetchStatus}, capture=${reference.captureStatus})`).join("\n");
+};
+var buildInspiredesignMetaPrompt = (input) => [
+  "# InspireDesign Meta Prompt",
+  "",
+  "Use this prompt to generate a fresh design direction from evidence without copying any reference brand, asset, layout, or proprietary expression.",
+  "",
+  "## Source Brief",
+  input.brief,
+  "",
+  "## Prompt Format",
+  `- Format: ${input.briefExpansion.format.label}`,
+  `- Target surface: ${input.referencePatternBoard.targetSurface}`,
+  `- Dominant direction: ${input.referencePatternBoard.synthesis.dominantDirection}`,
+  "",
+  "## Ranked References",
+  formatRankedReferences(input.referencePatternBoard),
+  "",
+  "## Rejected References",
+  formatRejectedReferences(input.referencePatternBoard),
+  "",
+  "## Borrow Guidance",
+  formatList(input.designVectors.patternsToBorrow),
+  "",
+  "## Reject Guidance",
+  formatList([
+    ...input.designVectors.patternsToReject,
+    "Do not copy logos, screenshots, protected brand assets, page structure, copy, or trade dress from references."
+  ]),
+  "",
+  "## Motion Posture",
+  formatList([
+    ...input.designVectors.motionPosture,
+    ...input.designVectors.interactionMoments,
+    ...input.designVectors.advancedMotionAdvisory
+  ]),
+  "",
+  "## Accessibility Constraints",
+  formatList([
+    "Keyboard navigation must reach every interactive element.",
+    "Focus states must be visible in every theme and viewport.",
+    "Respect prefers-reduced-motion with a static hierarchy-preserving alternative.",
+    "Validate contrast for text, controls, overlays, and disabled states."
+  ]),
+  "",
+  "## Validation Gates",
+  formatList([
+    "Read visual-evidence.json, screenshot-index.json, ranked-references.json, and evidence.json before implementation.",
+    "Confirm screenshot paths exist before making visual claims.",
+    "Verify desktop and mobile layouts with real browser screenshots.",
+    "Run reduced-motion, keyboard, focus, and contrast checks before shipping.",
+    "Keep production code generation outside the harvest output."
+  ])
+].join("\n");
+
+// src/inspiredesign/visual-evidence.ts
+import { createHash as createHash3 } from "crypto";
+var INSPIREDESIGN_VISUAL_EVIDENCE_MODES = ["off", "auto", "required"];
+var INSPIREDESIGN_VISUAL_EVIDENCE_KINDS = ["viewport", "full_page"];
+var SAFE_REFERENCE_ID_PATTERN = /[^a-z0-9._-]+/gi;
+var MAX_VISUAL_REFERENCE_ID_LENGTH = 96;
+var MAX_VISUAL_WARNING_LENGTH = 160;
+var MAX_VISUAL_FAILURE_LENGTH = 240;
+var UNSAFE_VISUAL_TEXT_PATTERN = /(?:\/(?:Users|private|tmp|var|Volumes)\/|[A-Za-z]:\\|\\|data:image|;base64|base64,|[A-Za-z0-9+/]{80,}={0,2})/i;
+var DOT_ONLY_PATH_SEGMENT_PATTERN = /^\.+$/;
+var SHA256_HEX_PATTERN = /^[a-f0-9]{64}$/i;
+var VISUAL_ARTIFACT_PATH_PATTERN = /^visual-evidence\/([A-Za-z0-9._-]+)\/(?:viewport|full_page)\.png$/;
+var FALLBACK_VISUAL_CAPTURED_AT = "1970-01-01T00:00:00.000Z";
+var isInspiredesignVisualEvidenceMode = (value) => typeof value === "string" && INSPIREDESIGN_VISUAL_EVIDENCE_MODES.includes(value);
+var isInspiredesignVisualEvidenceKind = (value) => typeof value === "string" && INSPIREDESIGN_VISUAL_EVIDENCE_KINDS.includes(value);
+var sanitizeInspiredesignVisualReferenceId = (referenceId) => {
+  const sanitized = referenceId.trim().replace(SAFE_REFERENCE_ID_PATTERN, "-").replace(/^-+|-+$/g, "");
+  if (!sanitized || DOT_ONLY_PATH_SEGMENT_PATTERN.test(sanitized)) return "reference";
+  const truncated = sanitized.slice(0, MAX_VISUAL_REFERENCE_ID_LENGTH);
+  return DOT_ONLY_PATH_SEGMENT_PATTERN.test(truncated) ? "reference" : truncated;
+};
+var buildVisualEvidenceArtifactPath = (referenceId, kind) => `visual-evidence/${sanitizeInspiredesignVisualReferenceId(referenceId)}/${kind}.png`;
+var hashVisualEvidenceBuffer = (buffer) => createHash3("sha256").update(buffer).digest("hex");
+var sanitizeVisualEvidenceText = (value, maxLength) => {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  if (!trimmed || UNSAFE_VISUAL_TEXT_PATTERN.test(trimmed)) return void 0;
+  return trimmed.slice(0, maxLength);
+};
+var sanitizeVisualEvidencePath = (value) => {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  const match = VISUAL_ARTIFACT_PATH_PATTERN.exec(trimmed);
+  const referenceSegment = match?.[1];
+  if (!referenceSegment || DOT_ONLY_PATH_SEGMENT_PATTERN.test(referenceSegment)) return void 0;
+  return trimmed;
+};
+var sanitizeVisualEvidenceSha256 = (value) => {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return SHA256_HEX_PATTERN.test(trimmed) ? trimmed.toLowerCase() : void 0;
+};
+var sanitizeVisualEvidenceBytes = (value) => typeof value === "number" && Number.isFinite(value) && Number.isInteger(value) && value >= 0 ? value : void 0;
+var sanitizeVisualEvidenceCapturedAt = (value) => {
+  if (typeof value !== "string") return FALLBACK_VISUAL_CAPTURED_AT;
+  const trimmed = value.trim();
+  if (!trimmed || UNSAFE_VISUAL_TEXT_PATTERN.test(trimmed)) return FALLBACK_VISUAL_CAPTURED_AT;
+  const timestamp = Date.parse(trimmed);
+  if (!Number.isFinite(timestamp)) return FALLBACK_VISUAL_CAPTURED_AT;
+  return new Date(timestamp).toISOString();
+};
+var normalizeVisualEvidenceViewport = (value) => {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) return void 0;
+  const record = value;
+  const viewport = {};
+  if (typeof record.width === "number" && Number.isFinite(record.width)) {
+    viewport.width = record.width;
+  }
+  if (typeof record.height === "number" && Number.isFinite(record.height)) {
+    viewport.height = record.height;
+  }
+  if (typeof record.deviceScaleFactor === "number" && Number.isFinite(record.deviceScaleFactor)) {
+    viewport.deviceScaleFactor = record.deviceScaleFactor;
+  }
+  return Object.keys(viewport).length > 0 ? viewport : void 0;
+};
+var normalizeVisualEvidenceWarnings = (value) => {
+  if (!Array.isArray(value)) return [];
+  return value.map((warning) => sanitizeVisualEvidenceText(warning, MAX_VISUAL_WARNING_LENGTH)).filter((warning) => Boolean(warning));
+};
+var persistInspiredesignVisualEvidence = (metadata, options = {}) => {
+  const runtimeMetadata = metadata;
+  const persistedMetadata = metadata;
+  const path2 = metadata.status === "captured" ? sanitizeVisualEvidencePath(options.artifactPath) ?? sanitizeVisualEvidencePath(persistedMetadata.path) ?? sanitizeVisualEvidencePath(runtimeMetadata.artifactPath) : void 0;
+  const sha256 = sanitizeVisualEvidenceSha256(options.sha256) ?? sanitizeVisualEvidenceSha256(persistedMetadata.sha256);
+  const bytes = sanitizeVisualEvidenceBytes(options.bytes) ?? sanitizeVisualEvidenceBytes(persistedMetadata.bytes);
+  const capturedAt = sanitizeVisualEvidenceCapturedAt(metadata.capturedAt);
+  const viewport = normalizeVisualEvidenceViewport(metadata.viewport);
+  const failure = sanitizeVisualEvidenceText(metadata.failure, MAX_VISUAL_FAILURE_LENGTH);
+  return {
+    status: metadata.status,
+    kind: isInspiredesignVisualEvidenceKind(metadata.kind) ? metadata.kind : "viewport",
+    fullPage: metadata.fullPage === true,
+    capturedAt,
+    ...path2 ? { path: path2 } : {},
+    ...sha256 ? { sha256 } : {},
+    ...bytes !== void 0 ? { bytes } : {},
+    ...viewport ? { viewport } : {},
+    warnings: normalizeVisualEvidenceWarnings(metadata.warnings),
+    ...failure ? { failure } : {}
+  };
+};
+
 // src/inspiredesign/contract.ts
 var INSPIREDESIGN_CAPTURE_ATTEMPT_KEYS = ["snapshot", "clone", "dom"];
 var MALFORMED_CAPTURE_ATTEMPT_DETAIL = "Capture attempt metadata missing or malformed.";
@@ -11662,7 +11949,8 @@ var normalizeInspiredesignCaptureEvidence = (capture) => {
     ...capture.title ? { title: capture.title } : {},
     ...hasUsableInspiredesignSnapshot(capture) && capture.snapshot ? { snapshot: capture.snapshot } : {},
     ...hasUsableInspiredesignDom(capture) && capture.dom ? { dom: capture.dom } : {},
-    ...hasUsableInspiredesignClone(capture) && capture.clone ? { clone: capture.clone } : {}
+    ...hasUsableInspiredesignClone(capture) && capture.clone ? { clone: capture.clone } : {},
+    ...capture.visual ? { visual: persistInspiredesignVisualEvidence(capture.visual) } : {}
   };
   const attempts = reconcileInspiredesignCaptureAttempts(
     normalizedBase,
@@ -12019,7 +12307,7 @@ var renderUnavailableReference = (reference) => {
 };
 var cloneTemplate = (value) => structuredClone(value);
 var referenceFingerprint = (value) => {
-  return createHash3("sha256").update(value).digest("hex").slice(0, 12);
+  return createHash4("sha256").update(value).digest("hex").slice(0, 12);
 };
 var summarizeBrief = (brief) => {
   const normalized = trimText2(brief);
@@ -12543,6 +12831,10 @@ var buildBriefExpansionMetadata = (briefExpansion) => ({
 var buildRequiredReferenceArtifacts = (includePrototypeGuidance) => {
   const files = [
     INSPIREDESIGN_HANDOFF_FILES.evidence,
+    INSPIREDESIGN_HANDOFF_FILES.visualEvidence,
+    INSPIREDESIGN_HANDOFF_FILES.screenshotIndex,
+    INSPIREDESIGN_HANDOFF_FILES.rankedReferences,
+    INSPIREDESIGN_HANDOFF_FILES.metaPrompt,
     INSPIREDESIGN_HANDOFF_FILES.advancedBrief,
     INSPIREDESIGN_HANDOFF_FILES.designMarkdown,
     INSPIREDESIGN_HANDOFF_FILES.generationPlan,
@@ -12994,9 +13286,30 @@ var buildEvidencePayload = ({
   referenceCount: references.length,
   references: references.map((reference) => toReferenceEvidenceJson(reference)),
   referencePatternBoard,
+  rankedReferences: referencePatternBoard.references,
   designVectors,
-  targetAnalysis
+  targetAnalysis,
+  visualEvidence: buildVisualEvidencePayload(references),
+  screenshotIndex: buildScreenshotIndex(references)
 });
+var buildVisualEvidencePayload = (references) => references.flatMap((reference) => {
+  const visual = normalizeInspiredesignCaptureEvidence(reference.capture)?.visual;
+  return visual ? [{
+    referenceId: reference.id,
+    url: reference.url,
+    visual: persistInspiredesignVisualEvidence(visual)
+  }] : [];
+});
+var buildScreenshotIndex = (references) => buildVisualEvidencePayload(references).filter((entry) => entry.visual.status === "captured" && typeof entry.visual.path === "string" && typeof entry.visual.sha256 === "string" && typeof entry.visual.bytes === "number").map((entry) => ({
+  referenceId: entry.referenceId,
+  url: entry.url,
+  path: entry.visual.path,
+  sha256: entry.visual.sha256,
+  bytes: entry.visual.bytes,
+  kind: entry.visual.kind,
+  fullPage: entry.visual.fullPage,
+  capturedAt: entry.visual.capturedAt
+}));
 var toCaptureEvidenceJson = (reference) => {
   const normalized = normalizeInspiredesignCaptureEvidence(reference.capture);
   if (!normalized) return null;
@@ -13004,6 +13317,7 @@ var toCaptureEvidenceJson = (reference) => {
   return {
     ...normalized.title ? { title: normalized.title } : {},
     ...signals.length > 0 ? { signals } : {},
+    ...normalized.visual ? { visual: normalized.visual } : {},
     ...normalized.attempts ? { attempts: normalized.attempts } : {}
   };
 };
@@ -13049,6 +13363,12 @@ var buildInspiredesignPacket = (input) => {
     advancedBrief: isReferenceFirstPublicLanding(designVectors) ? renderEvidenceDerivedAdvancedBrief(input.briefExpansion, effectiveFormat) : input.briefExpansion.advancedBrief,
     format: effectiveFormat
   };
+  const metaPromptMarkdown = buildInspiredesignMetaPrompt({
+    brief,
+    briefExpansion: effectiveBriefExpansion,
+    referencePatternBoard,
+    designVectors
+  });
   const advancedBriefMarkdown = renderReferenceFirstAdvancedBrief(
     effectiveBriefExpansion,
     referencePatternBoard,
@@ -13156,6 +13476,8 @@ var buildInspiredesignPacket = (input) => {
     "",
     renderDeliverablesSummary(Boolean(input.includePrototypeGuidance))
   ].join("\n");
+  const visualEvidence = buildVisualEvidencePayload(references);
+  const screenshotIndex = buildScreenshotIndex(references);
   return {
     advancedBriefMarkdown,
     designContract,
@@ -13166,6 +13488,10 @@ var buildInspiredesignPacket = (input) => {
     implementationPlan,
     implementationPlanMarkdown,
     prototypeGuidanceMarkdown,
+    visualEvidence,
+    screenshotIndex,
+    rankedReferences: referencePatternBoard.references,
+    metaPromptMarkdown,
     evidence: buildEvidencePayload({
       brief,
       briefExpansion: effectiveBriefExpansion,
@@ -13451,6 +13777,11 @@ var buildInspiredesignSuccessHandoff = (input) => createSuccessHandoff(
       reason: "Load the Canvas contract lane before patching.",
       command: input.commandExamples.loadDesignAgent
     },
+    {
+      reason: "Load the motion-design lane before translating visual evidence into animation, timing, or reduced-motion behavior.",
+      command: input.commandExamples.loadMotionDesign
+    },
+    { reason: INSPIREDESIGN_HANDOFF_GUIDANCE.visualArtifactRecommendation },
     {
       reason: INSPIREDESIGN_HANDOFF_GUIDANCE.prepareCanvasPlanRequest,
       command: input.commandExamples.continueInCanvas
@@ -13986,6 +14317,18 @@ var renderShopping = (args) => {
 var renderInspiredesign = (args) => {
   const captureAttemptReport = inspiredesignCaptureAttemptReportFromMeta(args.meta);
   const captureAttemptSummary = inspiredesignCaptureAttemptSummaryFromMeta(args.meta);
+  const visualEvidence = args.visualEvidence ?? [];
+  const screenshotIndex = args.screenshotIndex ?? [];
+  const rankedReferences = args.rankedReferences ?? [];
+  const rankedReferencesArtifact = args.referencePatternBoard ? {
+    references: args.referencePatternBoard.references,
+    rejectedReferences: args.referencePatternBoard.rejectedReferences,
+    synthesis: args.referencePatternBoard.synthesis
+  } : {
+    references: rankedReferences,
+    rejectedReferences: []
+  };
+  const metaPromptMarkdown = args.metaPromptMarkdown ?? "";
   const summary = buildInspiredesignSummary({
     brief: args.brief,
     referenceCount: args.urls.length,
@@ -14006,6 +14349,10 @@ var renderInspiredesign = (args) => {
     implementationPlanMarkdown: args.implementationPlanMarkdown,
     prototypeGuidanceMarkdown: args.prototypeGuidanceMarkdown,
     evidence: args.evidence,
+    visualEvidence,
+    screenshotIndex,
+    rankedReferences,
+    metaPromptMarkdown,
     meta: args.meta
   };
   const handoff = buildInspiredesignSuccessHandoff({
@@ -14023,7 +14370,11 @@ var renderInspiredesign = (args) => {
     { path: INSPIREDESIGN_HANDOFF_FILES.generationPlan, content: args.generationPlan },
     { path: INSPIREDESIGN_HANDOFF_FILES.implementationPlanMarkdown, content: args.implementationPlanMarkdown },
     { path: INSPIREDESIGN_HANDOFF_FILES.implementationPlan, content: args.implementationPlan },
-    { path: INSPIREDESIGN_HANDOFF_FILES.evidence, content: args.evidence }
+    { path: INSPIREDESIGN_HANDOFF_FILES.evidence, content: args.evidence },
+    { path: INSPIREDESIGN_HANDOFF_FILES.visualEvidence, content: { visualEvidence } },
+    { path: INSPIREDESIGN_HANDOFF_FILES.screenshotIndex, content: { screenshots: screenshotIndex } },
+    { path: INSPIREDESIGN_HANDOFF_FILES.rankedReferences, content: rankedReferencesArtifact },
+    { path: INSPIREDESIGN_HANDOFF_FILES.metaPrompt, content: metaPromptMarkdown }
   ];
   if (args.prototypeGuidanceMarkdown) {
     files.push({ path: INSPIREDESIGN_HANDOFF_FILES.prototypeGuidance, content: args.prototypeGuidanceMarkdown });
@@ -14058,6 +14409,10 @@ var renderInspiredesign = (args) => {
         implementationPlan: args.implementationPlan,
         prototypeGuidanceMarkdown: args.prototypeGuidanceMarkdown,
         evidence: args.evidence,
+        visualEvidence,
+        screenshotIndex,
+        rankedReferences,
+        metaPromptMarkdown,
         ...handoff,
         ...captureAttemptFields,
         meta: args.meta
@@ -14102,6 +14457,140 @@ var renderInspiredesign = (args) => {
   };
 };
 
+// src/inspiredesign/reference-discovery.ts
+var normalizeHttpUrl = (value) => {
+  try {
+    const url = new URL(value);
+    if (url.protocol !== "http:" && url.protocol !== "https:") return null;
+    url.hash = "";
+    if (url.pathname === "/" && !/^https?:\/\/[^/]+\/[^?#]/i.test(value)) {
+      return `${url.origin}${url.search}`;
+    }
+    return url.toString();
+  } catch (error) {
+    void error;
+    return null;
+  }
+};
+var extractInspiredesignDiscoveryUrl = (record) => {
+  if (typeof record.url !== "string") return null;
+  const trimmed = record.url.trim();
+  if (!trimmed) return null;
+  return normalizeHttpUrl(trimmed);
+};
+var normalizeInspiredesignDiscoveryRecords = (records) => {
+  const seen = /* @__PURE__ */ new Set();
+  const accepted = [];
+  const rejected = [];
+  records.forEach((record, index) => {
+    const rawUrl = typeof record.url === "string" ? record.url.trim() : void 0;
+    const url = extractInspiredesignDiscoveryUrl(record);
+    const base = {
+      ...record.title ? { title: record.title } : {},
+      source: record.source,
+      provider: record.provider,
+      rank: index + 1
+    };
+    if (!rawUrl) {
+      rejected.push({ ...base, status: "rejected", reason: "missing_url" });
+      return;
+    }
+    if (!url) {
+      rejected.push({ ...base, status: "rejected", reason: "invalid_url", rawUrl });
+      return;
+    }
+    if (seen.has(url)) {
+      rejected.push({ ...base, status: "rejected", reason: "duplicate_url", rawUrl });
+      return;
+    }
+    seen.add(url);
+    accepted.push({ ...base, status: "accepted", url });
+  });
+  return { accepted, rejected };
+};
+var mergeInspiredesignReferenceUrls = (explicitUrls, discoveredUrls, maxReferences) => {
+  const merged = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const url of [...explicitUrls, ...discoveredUrls]) {
+    const normalized = normalizeHttpUrl(url.trim());
+    if (!normalized || seen.has(normalized)) continue;
+    seen.add(normalized);
+    merged.push(normalized);
+    if (merged.length >= maxReferences) return merged;
+  }
+  return merged;
+};
+var normalizeInspiredesignProviders = (providers) => {
+  const normalized = (providers ?? []).map((provider) => provider.trim()).filter((provider) => provider.length > 0);
+  return [...new Set(normalized)];
+};
+
+// src/inspiredesign/visual-policy.ts
+var VISUAL_BLOCKER_REASONS = /* @__PURE__ */ new Set([
+  "policy_blocked",
+  "auth_required",
+  "challenge_detected",
+  "rate_limited"
+]);
+var toVisualPolicyReason = (reasonCode) => {
+  if (!VISUAL_BLOCKER_REASONS.has(reasonCode)) return null;
+  if (reasonCode === "policy_blocked" || reasonCode === "auth_required" || reasonCode === "challenge_detected" || reasonCode === "rate_limited") {
+    return reasonCode;
+  }
+  return null;
+};
+var blockerFromFailures = (failures) => {
+  for (const failure of failures ?? []) {
+    const reasonCode = failure.error.reasonCode;
+    if (!reasonCode) continue;
+    const blocker = toVisualPolicyReason(reasonCode);
+    if (blocker) return blocker;
+  }
+  return null;
+};
+var blockerFromTopLevelError = (error) => {
+  if (!error?.reasonCode) return null;
+  return toVisualPolicyReason(error.reasonCode);
+};
+var messageForBlocker = (reason) => {
+  switch (reason) {
+    case "policy_blocked":
+      return "Visual capture skipped because provider policy blocked the reference.";
+    case "auth_required":
+      return "Visual capture skipped because authenticated access is unresolved.";
+    case "challenge_detected":
+      return "Visual capture skipped because a challenge was detected.";
+    case "rate_limited":
+      return "Visual capture skipped because the provider is rate limited.";
+    case "visual_evidence_off":
+      return "Visual evidence is disabled for this run.";
+    case "visual_capture_allowed":
+      return "Visual capture is allowed for this reference.";
+  }
+};
+var decideInspiredesignVisualCapturePolicy = (input) => {
+  if (input.visualEvidence === "off") {
+    return {
+      status: "skipped",
+      reason: "visual_evidence_off",
+      message: messageForBlocker("visual_evidence_off")
+    };
+  }
+  const blocker = input.hasUsableRecords === true ? null : blockerFromFailures(input.failures) ?? blockerFromTopLevelError(input.topLevelError);
+  if (blocker) {
+    return {
+      status: "skipped",
+      reason: blocker,
+      message: messageForBlocker(blocker)
+    };
+  }
+  return {
+    status: "allowed",
+    reason: "visual_capture_allowed",
+    message: messageForBlocker("visual_capture_allowed")
+  };
+};
+
 // src/canvas/types.ts
 var CANVAS_SCHEMA_VERSION = "1.0.0";
 var CANVAS_SESSION_MODES = ["low-fi-wireframe", "high-fi-live-edit", "dual-track", "document-only"];
@@ -14230,7 +14719,7 @@ var CANVAS_VALIDATION_TARGET_BLOCK_ON_CODES = [
 var CANVAS_PUBLIC_WARNING_CLASSES = CANVAS_VALIDATION_TARGET_BLOCK_ON_CODES;
 
 // src/providers/shopping-postprocess.ts
-import { createHash as createHash4 } from "crypto";
+import { createHash as createHash5 } from "crypto";
 var LOOKS_LIKE_URL_RE = /^https?:\/\/\S+$/i;
 var PRICE_TOKEN_RE = /((?:US\$|CA\$|C\$|USD|CAD|EUR|GBP|[$€£]))\s*([0-9]{1,4}(?:[.,][0-9]{3})*(?:[.,][0-9]{1,2})?)/gi;
 var CONTEXTUAL_PRICE_TOKEN_RE = /(?:connect to any carrier later|starting at|starts at|starting from|from|buy now for|buy for)\s*((?:US\$|CA\$|C\$|USD|CAD|EUR|GBP|[$€£]))\s*([0-9]{1,4}(?:[.,][0-9]{3})*(?:[.,][0-9]{1,2})?)/gi;
@@ -14316,7 +14805,7 @@ var REGION_CURRENCY_BY_REGION = {
   uk: "GBP",
   eu: "EUR"
 };
-var hash = (value) => createHash4("sha1").update(value).digest("hex").slice(0, 16);
+var hash = (value) => createHash5("sha1").update(value).digest("hex").slice(0, 16);
 var normalizePlainText = (value) => {
   if (!value) return "";
   return extractText(value).replace(/[\u0000-\u001F\u007F-\u009F]+/g, " ").replace(/\s+/g, " ").trim();
@@ -14945,7 +15434,7 @@ var compileShoppingWorkflow = (input, options = {}) => {
 };
 
 // src/providers/shopping-compiler.ts
-import { createHash as createHash5 } from "crypto";
+import { createHash as createHash6 } 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"]);
@@ -14962,7 +15451,7 @@ var emptyCheckpointState = () => ({
   step_results_by_id: {}
 });
 var createShoppingSearchStepId = (providerId) => `search:${providerId}`;
-var createShoppingFetchStepId = (providerId, url) => `fetch:${providerId}:${createHash5("sha1").update(canonicalizeUrl(url)).digest("hex").slice(0, 16)}`;
+var createShoppingFetchStepId = (providerId, url) => `fetch:${providerId}:${createHash6("sha1").update(canonicalizeUrl(url)).digest("hex").slice(0, 16)}`;
 var serializeShoppingCheckpointState = (state) => ({
   completed_step_ids: [...state.completed_step_ids],
   step_results_by_id: state.step_results_by_id
@@ -15448,7 +15937,7 @@ var compileProductVideoExecutionPlan = (args) => {
 };
 
 // src/providers/research-compiler.ts
-import { createHash as createHash6 } from "crypto";
+import { createHash as createHash7 } from "crypto";
 var RESEARCH_AUTO_SOURCES = ["web", "community", "social"];
 var RESEARCH_ALL_SOURCES = [...RESEARCH_AUTO_SOURCES];
 var DEFAULT_RESEARCH_SEARCH_LIMIT = 10;
@@ -15474,7 +15963,7 @@ var toProviderSource = (providerId) => {
   return null;
 };
 var createResearchSearchStepId = (source) => `search:${source}`;
-var createResearchFetchStepId = (url) => `fetch:web:${createHash6("sha1").update(canonicalizeUrl(url)).digest("hex").slice(0, 16)}`;
+var createResearchFetchStepId = (url) => `fetch:web:${createHash7("sha1").update(canonicalizeUrl(url)).digest("hex").slice(0, 16)}`;
 var serializeResearchCheckpointState = (state) => ({
   completed_step_ids: [...state.completed_step_ids],
   step_results_by_id: state.step_results_by_id
@@ -16396,6 +16885,9 @@ var workflowTestUtils = {
   redactRawCapture: (record) => redactRawCapture(record),
   toProviderSource: (providerId) => toProviderSource2(providerId),
   resolveShoppingProviderIdForUrl: (url) => resolveShoppingProviderIdForUrl(url),
+  resolveShoppingSourceForUrl: (url) => resolveShoppingSourceForUrl(url),
+  resolveProductCopy: (record, productUrl, refreshedDescription, featureList) => resolveProductCopy(record, productUrl, refreshedDescription, featureList),
+  getRequiredProductVideoExecutionStep: (steps, stepId) => getRequiredProductVideoExecutionStep(steps, stepId),
   normalizeProductVideoProviderHint: (productUrl, providerHint, fallbackProvider) => normalizeProductVideoProviderHint(productUrl, providerHint, fallbackProvider),
   hasTranscriptSuccess: (record) => hasTranscriptSuccess(record),
   sanitizeFeatureList: (values) => sanitizeFeatureList(values),
@@ -16407,7 +16899,15 @@ var workflowTestUtils = {
   fetchBinary: (url, timeoutMs) => fetchBinary(url, timeoutMs),
   rankResearchRecords: (records) => rankResearchRecords(records),
   isValidHttpUrl: (url) => isValidHttpUrl3(url),
-  buildWorkflowResumePayload: (kind, input) => buildWorkflowResumePayload(kind, input)
+  buildWorkflowResumePayload: (kind, input) => buildWorkflowResumePayload(kind, input),
+  withPrimaryConstraintSummaryOverride: (meta, summary, guidance) => withPrimaryConstraintSummaryOverride(meta, summary, guidance),
+  withReasonCodeDistributionMeta: (meta, reasonCodeDistribution) => withReasonCodeDistributionMeta(meta, reasonCodeDistribution),
+  incrementReasonCodeDistribution: (reasonCodeDistribution, reasonCode, count) => incrementReasonCodeDistribution(reasonCodeDistribution, reasonCode, count),
+  summarizeShoppingOfferFilterConstraint: (args) => summarizeShoppingOfferFilterConstraint(args),
+  parseInspiredesignEnvelopeInput: (input) => parseInspiredesignEnvelopeInput(input),
+  failureFromInspiredesignDiscoveryError: (workflowInput, error) => failureFromInspiredesignDiscoveryError(workflowInput, error),
+  failureFromInspiredesignFetchError: (result) => failureFromInspiredesignFetchError(result),
+  extractProductBrandFromTitle: (title, productUrl) => extractProductBrandFromTitle(title, productUrl)
 };
 var PRODUCT_ASSET_FETCH_TIMEOUT_MS = 15e3;
 var RESEARCH_PROVIDER_STEP_TIMEOUT_MS = 3e4;
@@ -16459,7 +16959,7 @@ var rankResearchRecords = (records) => {
     return left.id.localeCompare(right.id);
   });
 };
-var hash2 = (value) => createHash7("sha1").update(value).digest("hex").slice(0, 16);
+var hash2 = (value) => createHash8("sha1").update(value).digest("hex").slice(0, 16);
 var RESEARCH_ALWAYS_SANITIZED_PATHS = /* @__PURE__ */ new Set([
   "community:search:index",
   "community:search:url",
@@ -16655,8 +17155,17 @@ 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 INSPIREDESIGN_DEFAULT_MAX_REFERENCES = 5;
+var INSPIREDESIGN_MAX_REFERENCES_LIMIT = 10;
 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 REQUIRED_VISUAL_EVIDENCE_MISSING_FAILURE = "Required visual evidence was not captured.";
+var INSPIREDESIGN_VISUAL_POLICY_BLOCKER_REASONS = /* @__PURE__ */ new Set([
+  "policy_blocked",
+  "auth_required",
+  "challenge_detected",
+  "rate_limited"
+]);
 var isCanvasVisualDirectionProfile = (value) => {
   return CANVAS_VISUAL_DIRECTION_PROFILES.includes(value);
 };
@@ -16670,6 +17179,11 @@ var serializeInspiredesignBriefExpansion = (expansion) => structuredClone(expans
 var serializeInspiredesignRunInput = (input) => ({
   brief: input.brief,
   briefExpansion: serializeInspiredesignBriefExpansion(input.briefExpansion),
+  ...input.harvest === true ? { harvest: true } : {},
+  ...input.query ? { query: input.query } : {},
+  ...input.providers.length > 0 ? { providers: input.providers } : {},
+  ...input.referenceLimit !== void 0 ? { maxReferences: input.maxReferences } : {},
+  visualEvidence: input.visualEvidence,
   urls: input.urls,
   captureMode: input.captureMode,
   mode: input.mode,
@@ -16745,6 +17259,11 @@ var parseInspiredesignEnvelopeInput = (input) => {
   return {
     brief: typeof input.brief === "string" ? input.brief : "",
     mode: typeof input.mode === "string" && INSPIREDESIGN_RENDER_MODES.has(input.mode) ? input.mode : "compact",
+    ...typeof input.harvest === "boolean" ? { harvest: input.harvest } : {},
+    ...typeof input.query === "string" && input.query.trim().length > 0 ? { query: input.query.trim() } : {},
+    ...Array.isArray(input.providers) ? { providers: input.providers.filter((provider) => typeof provider === "string") } : {},
+    ...typeof input.maxReferences === "number" ? { maxReferences: input.maxReferences } : {},
+    ...isInspiredesignVisualEvidenceMode(input.visualEvidence) ? { visualEvidence: input.visualEvidence } : {},
     ...briefExpansion ? { briefExpansion } : {},
     ...Array.isArray(input.urls) ? { urls: input.urls.filter((url) => typeof url === "string") } : {},
     ...typeof input.captureMode === "string" && INSPIREDESIGN_CAPTURE_MODES.has(input.captureMode) ? { captureMode: input.captureMode } : {},
@@ -16767,6 +17286,24 @@ var normalizeInspiredesignUrls = (urls) => {
   }
   return [...new Set(normalized.map((url) => canonicalizeUrl(url)))];
 };
+var normalizeInspiredesignMaxReferences = (value, fallbackCount) => {
+  if (typeof value === "undefined") {
+    return Math.max(1, Math.min(Math.max(fallbackCount, 1), INSPIREDESIGN_MAX_REFERENCES_LIMIT));
+  }
+  if (!Number.isInteger(value) || value < 1 || value > INSPIREDESIGN_MAX_REFERENCES_LIMIT) {
+    throw new Error("Inspiredesign workflow maxReferences must be an integer from 1 to 10.");
+  }
+  return value;
+};
+var normalizeInspiredesignVisualEvidenceMode = (value, harvest) => {
+  if (typeof value === "undefined") {
+    return harvest === true ? "required" : "off";
+  }
+  if (!isInspiredesignVisualEvidenceMode(value)) {
+    throw new Error("Inspiredesign workflow visualEvidence must be one of off, auto, or required.");
+  }
+  return value;
+};
 var hasValidInspiredesignBriefRoute = (route) => {
   return isCanvasVisualDirectionProfile(route.profile) && isCanvasThemeStrategy(route.themeStrategy) && isCanvasNavigationModel(route.navigationModel);
 };
@@ -16788,6 +17325,23 @@ var normalizeInspiredesignInput = (input) => {
     throw new Error("Inspiredesign workflow requires a non-empty brief.");
   }
   const urls = normalizeInspiredesignUrls(input.urls);
+  const query = typeof input.query === "string" && input.query.trim().length > 0 ? input.query.trim() : void 0;
+  const providers = normalizeInspiredesignProviders(input.providers);
+  const hasExplicitMaxReferences = typeof input.maxReferences !== "undefined";
+  if (query && input.harvest !== true) {
+    throw new Error("Inspiredesign workflow query is only supported when harvest is true.");
+  }
+  if (providers.length > 0 && !query) {
+    throw new Error("Inspiredesign workflow providers require query.");
+  }
+  if (input.harvest === true && !query && urls.length === 0) {
+    throw new Error("Inspiredesign harvest requires query or URL references.");
+  }
+  const visualEvidence = normalizeInspiredesignVisualEvidenceMode(
+    input.visualEvidence,
+    input.harvest
+  );
+  const maxReferencesFallback = query || input.harvest === true ? INSPIREDESIGN_DEFAULT_MAX_REFERENCES : urls.length;
   const normalizedBrief = normalizeInspiredesignBriefText(brief);
   const preferredFormatId = shouldReuseInspiredesignBriefExpansion(input.briefExpansion, normalizedBrief) ? input.briefExpansion.format.id : void 0;
   const briefExpansion = expandInspiredesignBrief(brief, preferredFormatId);
@@ -16795,9 +17349,14 @@ var normalizeInspiredesignInput = (input) => {
     ...input,
     brief,
     briefExpansion,
+    ...query ? { query } : {},
+    providers,
+    maxReferences: normalizeInspiredesignMaxReferences(input.maxReferences, maxReferencesFallback),
+    ...query || input.harvest === true || hasExplicitMaxReferences ? { referenceLimit: normalizeInspiredesignMaxReferences(input.maxReferences, maxReferencesFallback) } : {},
+    visualEvidence,
     urls,
     captureMode: resolveInspiredesignCaptureMode(input.captureMode, urls),
-    mode: input.mode ?? "compact"
+    mode: input.mode ?? (input.harvest === true ? "path" : "compact")
   };
 };
 var isInspiredesignWorkflowEnvelopeInput = (input) => {
@@ -16858,6 +17417,89 @@ var buildInspiredesignFetchOptions = (workflowInput, envelope, timeoutMs) => wit
   "workflow.inspiredesign",
   envelope
 );
+var emptyInspiredesignDiscoveryDiagnostics = (workflowInput, searchAvailable, failure) => ({
+  requested: Boolean(workflowInput.query),
+  searchAvailable,
+  ...workflowInput.query ? { query: workflowInput.query } : {},
+  providers: workflowInput.providers,
+  acceptedUrls: [],
+  rejected: [],
+  failures: [],
+  ...failure ? { failure } : {}
+});
+var providerFromInspiredesignDiscoveryFailure = (workflowInput, error) => {
+  const provider = error.provider ?? workflowInput.providers[0];
+  const source = error.source ?? (provider ? toProviderSource2(provider) : null);
+  return provider && source ? { provider, source } : void 0;
+};
+var failureFromInspiredesignDiscoveryError = (workflowInput, error) => {
+  if (!error) return [];
+  const provider = providerFromInspiredesignDiscoveryFailure(workflowInput, error);
+  if (!provider) return [];
+  return [{
+    provider: provider.provider,
+    source: provider.source,
+    error
+  }];
+};
+var providerFromInspiredesignFetchFailure = (result) => {
+  const provider = result.error?.provider ?? result.providerOrder[0];
+  const source = result.error?.source ?? (provider ? toProviderSource2(provider) : null);
+  return provider && source ? { provider, source } : void 0;
+};
+var failureFromInspiredesignFetchError = (result) => {
+  if (!result.error || result.failures.length > 0) return [];
+  const provider = providerFromInspiredesignFetchFailure(result);
+  if (!provider) return [];
+  return [{
+    provider: provider.provider,
+    source: provider.source,
+    error: result.error
+  }];
+};
+var discoverInspiredesignReferences = async (runtime, workflowInput, envelope, timeoutMs) => {
+  if (!workflowInput.query) {
+    return emptyInspiredesignDiscoveryDiagnostics(workflowInput, typeof runtime.search === "function");
+  }
+  if (typeof runtime.search !== "function") {
+    return emptyInspiredesignDiscoveryDiagnostics(
+      workflowInput,
+      false,
+      "Reference discovery requested, but provider search is unavailable in this execution lane."
+    );
+  }
+  let searchResult;
+  try {
+    searchResult = await runtime.search(
+      {
+        query: workflowInput.query,
+        limit: workflowInput.maxReferences
+      },
+      {
+        ...buildInspiredesignFetchOptions(workflowInput, envelope, timeoutMs),
+        ...workflowInput.providers.length > 0 ? { providerIds: workflowInput.providers } : {}
+      }
+    );
+  } catch (error) {
+    return emptyInspiredesignDiscoveryDiagnostics(
+      workflowInput,
+      true,
+      error instanceof Error ? error.message : "Reference discovery failed."
+    );
+  }
+  const discovery = normalizeInspiredesignDiscoveryRecords(searchResult.records);
+  const discoveryFailures = searchResult.failures.length > 0 ? searchResult.failures : failureFromInspiredesignDiscoveryError(workflowInput, searchResult.error);
+  return {
+    requested: true,
+    searchAvailable: true,
+    query: workflowInput.query,
+    providers: workflowInput.providers,
+    acceptedUrls: discovery.accepted.map((candidate) => candidate.url),
+    rejected: discovery.rejected,
+    failures: discoveryFailures,
+    ...searchResult.error?.message ? { failure: searchResult.error.message } : {}
+  };
+};
 var buildEmptyInspiredesignCaptureAttemptCounts = () => ({
   snapshot: { captured: 0, failed: 0, skipped: 0 },
   clone: { captured: 0, failed: 0, skipped: 0 },
@@ -16870,6 +17512,78 @@ var buildUnavailableInspiredesignCaptureEvidence = () => ({
     dom: { status: "skipped", detail: INSPIREDESIGN_CAPTURE_UNAVAILABLE_FAILURE }
   }
 });
+var getInspiredesignReferenceId = (url) => createHash8("sha256").update(url).digest("hex").slice(0, 12);
+var buildVisualPolicyMetadata = (decision) => {
+  if (decision.status === "allowed") return void 0;
+  return {
+    status: decision.status,
+    kind: "viewport",
+    fullPage: false,
+    capturedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    warnings: [`policy:${decision.reason}`],
+    failure: decision.message
+  };
+};
+var mergeCaptureVisualEvidence = (capture, visual) => {
+  if (!visual) return capture;
+  return {
+    ...capture ?? {},
+    visual
+  };
+};
+var isVisualPolicyBlockerDecision = (decision) => INSPIREDESIGN_VISUAL_POLICY_BLOCKER_REASONS.has(decision.reason);
+var buildMissingRequiredVisualEvidence = (failure, _visualPlan) => ({
+  status: "failed",
+  kind: "viewport",
+  fullPage: false,
+  capturedAt: (/* @__PURE__ */ new Date()).toISOString(),
+  warnings: ["required_visual_evidence_missing"],
+  failure
+});
+var getRequiredVisualEvidenceFailure = (workflowInput, visualPlan, capture) => {
+  if (workflowInput.visualEvidence !== "required" || visualPlan.policy.status !== "allowed") return void 0;
+  const visual = normalizeInspiredesignCaptureEvidence(capture)?.visual;
+  if (!visual) return REQUIRED_VISUAL_EVIDENCE_MISSING_FAILURE;
+  if (visual.status === "captured") return void 0;
+  return visual.failure ?? REQUIRED_VISUAL_EVIDENCE_MISSING_FAILURE;
+};
+var addRequiredVisualEvidenceFailure = (capture, visualPlan, failure) => {
+  const visual = normalizeInspiredesignCaptureEvidence(capture)?.visual;
+  if (visual) return capture;
+  return mergeCaptureVisualEvidence(capture, buildMissingRequiredVisualEvidence(failure, visualPlan));
+};
+var VISUAL_TEMP_PATH_MISMATCH_FAILURE = "Visual evidence temp path did not match the workflow capture plan.";
+var VISUAL_KIND_MISMATCH_FAILURE = "Visual evidence kind did not match the workflow capture contract.";
+var hasTrustedVisualTempPath = (visual, visualPlan) => {
+  if (visual.status === "captured" && !visual.tempPath) return false;
+  if (!visual.tempPath) return true;
+  if (!visualPlan.tempPath) return false;
+  return resolve(visual.tempPath) === resolve(visualPlan.tempPath);
+};
+var hasTrustedVisualKind = (visual) => isInspiredesignVisualEvidenceKind(visual.kind);
+var readRuntimeVisualWarnings = (visual) => {
+  const warnings = visual.warnings;
+  return Array.isArray(warnings) ? warnings.filter((warning) => typeof warning === "string") : [];
+};
+var failMismatchedVisualTempPath = (visual, failure = VISUAL_TEMP_PATH_MISMATCH_FAILURE, warning = "visual_temp_path_mismatch") => ({
+  status: "failed",
+  kind: hasTrustedVisualKind(visual) ? visual.kind : "viewport",
+  fullPage: visual.fullPage,
+  capturedAt: visual.capturedAt,
+  warnings: [...readRuntimeVisualWarnings(visual), warning],
+  failure
+});
+var trustRuntimeVisualEvidence = (visual, visualPlan) => {
+  if (!visual) return void 0;
+  if (!hasTrustedVisualKind(visual)) {
+    return failMismatchedVisualTempPath(
+      visual,
+      VISUAL_KIND_MISMATCH_FAILURE,
+      "visual_kind_mismatch"
+    );
+  }
+  return hasTrustedVisualTempPath(visual, visualPlan) ? visual : failMismatchedVisualTempPath(visual);
+};
 var PRE_ARTIFACT_CAPTURE_SKIP_MESSAGE = "Skipped after deep capture failed before artifact capture started.";
 var buildFailedInspiredesignCaptureEvidence = (detail) => ({
   attempts: {
@@ -16904,41 +17618,74 @@ var summarizeInspiredesignCaptureAttempts = (references) => {
     summary: formatInspiredesignCaptureAttemptSummary({ worked, didNotWork })
   };
 };
-var captureInspiredesignReference = async (url, captureMode, workflowInput, captureReference, timeoutMs) => {
+var captureInspiredesignReference = async (url, captureMode, workflowInput, captureReference, visualPlan, timeoutMs) => {
+  const visualPolicyMetadata = buildVisualPolicyMetadata(visualPlan.policy);
   if (captureMode === "off") {
-    return { captureStatus: "off" };
+    return visualPolicyMetadata ? { captureStatus: "off", capture: { visual: visualPolicyMetadata } } : { captureStatus: "off" };
+  }
+  if (visualPolicyMetadata && isVisualPolicyBlockerDecision(visualPlan.policy)) {
+    const captureStatus = visualPlan.policy.status === "failed" ? "failed" : "off";
+    return {
+      captureStatus,
+      ...captureStatus === "failed" ? { captureFailure: visualPlan.policy.message } : {},
+      capture: { visual: visualPolicyMetadata }
+    };
   }
   if (!captureReference) {
+    const visualFailureMetadata = visualPolicyMetadata ?? (workflowInput.visualEvidence === "required" && visualPlan.policy.status === "allowed" ? buildMissingRequiredVisualEvidence(INSPIREDESIGN_CAPTURE_UNAVAILABLE_FAILURE, visualPlan) : void 0);
     return {
       captureStatus: "failed",
       captureFailure: INSPIREDESIGN_CAPTURE_UNAVAILABLE_FAILURE,
-      capture: buildUnavailableInspiredesignCaptureEvidence()
+      capture: mergeCaptureVisualEvidence(
+        buildUnavailableInspiredesignCaptureEvidence(),
+        visualFailureMetadata
+      )
     };
   }
   try {
-    const capture = normalizeInspiredesignCaptureEvidence(await captureReference(url, {
+    const rawCapture = await captureReference(url, {
       timeoutMs,
       useCookies: workflowInput.useCookies,
       challengeAutomationMode: workflowInput.challengeAutomationMode,
-      cookiePolicyOverride: workflowInput.cookiePolicyOverride
-    }));
+      cookiePolicyOverride: workflowInput.cookiePolicyOverride,
+      visualEvidence: visualPlan.policy.status === "allowed" ? workflowInput.visualEvidence : "off",
+      visualEvidencePath: visualPlan.policy.status === "allowed" ? visualPlan.tempPath : void 0
+    });
+    const capture = normalizeInspiredesignCaptureEvidence(rawCapture);
+    const runtimeVisual = rawCapture?.visual;
+    const trustedRuntimeVisual = trustRuntimeVisualEvidence(runtimeVisual, visualPlan);
+    const captureWithRuntimeVisual = trustedRuntimeVisual ? mergeCaptureVisualEvidence(capture, trustedRuntimeVisual) : capture;
+    const captureWithVisualPolicy = trustedRuntimeVisual ? captureWithRuntimeVisual : mergeCaptureVisualEvidence(captureWithRuntimeVisual, visualPolicyMetadata);
+    const requiredVisualFailure = getRequiredVisualEvidenceFailure(workflowInput, visualPlan, captureWithVisualPolicy);
+    const captureWithRequiredVisual = requiredVisualFailure ? addRequiredVisualEvidenceFailure(captureWithVisualPolicy, visualPlan, requiredVisualFailure) : captureWithVisualPolicy;
     if (!hasInspiredesignCaptureArtifacts(capture)) {
       return {
         captureStatus: "failed",
         captureFailure: "Deep capture did not return usable snapshot, DOM, or clone evidence.",
-        ...capture ? { capture } : {}
+        ...captureWithRequiredVisual ? { capture: captureWithRequiredVisual } : {}
+      };
+    }
+    if (requiredVisualFailure) {
+      return {
+        captureStatus: "failed",
+        captureFailure: requiredVisualFailure,
+        ...captureWithRequiredVisual ? { capture: captureWithRequiredVisual } : {}
       };
     }
     return {
       captureStatus: "captured",
-      ...capture ? { capture } : {}
+      ...captureWithRequiredVisual ? { capture: captureWithRequiredVisual } : {}
     };
   } catch (error) {
     const captureFailure = error instanceof Error && error.message.trim() ? error.message : "Deep capture failed.";
+    const visualFailureMetadata = visualPolicyMetadata ?? (workflowInput.visualEvidence === "required" && visualPlan.policy.status === "allowed" ? buildMissingRequiredVisualEvidence(captureFailure, visualPlan) : void 0);
     return {
       captureStatus: "failed",
       captureFailure,
-      capture: buildFailedInspiredesignCaptureEvidence(captureFailure)
+      capture: mergeCaptureVisualEvidence(
+        buildFailedInspiredesignCaptureEvidence(captureFailure),
+        visualFailureMetadata
+      )
     };
   }
 };
@@ -16983,7 +17730,11 @@ var toInspiredesignIssueFailure = (record, hint) => {
 };
 var normalizeInspiredesignFetchResult = (result) => {
   if (result.records.length === 0) {
-    return result;
+    const synthesizedFailures = failureFromInspiredesignFetchError(result);
+    return synthesizedFailures.length > 0 ? {
+      ...result,
+      failures: synthesizedFailures
+    } : result;
   }
   const usableRecords = [];
   const unusableRecords = [];
@@ -17043,12 +17794,14 @@ var summarizeInspiredesignRecoveredFetches = (references) => references.filter(i
 }));
 var buildInspiredesignReference = (url, result, capture) => {
   const primary = getInspiredesignPrimaryRecord(result, url);
-  const normalizedCapture = normalizeInspiredesignCaptureEvidence(capture.capture);
+  const baseCapture = normalizeInspiredesignCaptureEvidence(capture.capture);
+  const runtimeVisual = capture.capture?.visual;
+  const normalizedCapture = runtimeVisual?.tempPath ? mergeCaptureVisualEvidence(baseCapture, runtimeVisual) : baseCapture;
   const title = normalizePlainText(primary?.title) || titleFromInspiredesignCapture(normalizedCapture);
   const excerpt = excerptFromInspiredesignRecord(primary) ?? excerptFromInspiredesignCapture(normalizedCapture);
   const fetchStatus = result.records.length > 0 ? "captured" : "failed";
   return {
-    id: createHash7("sha256").update(url).digest("hex").slice(0, 12),
+    id: getInspiredesignReferenceId(url),
     url,
     ...title ? { title } : {},
     ...excerpt ? { excerpt } : {},
@@ -17059,6 +17812,102 @@ var buildInspiredesignReference = (url, result, capture) => {
     ...normalizedCapture ? { capture: normalizedCapture } : {}
   };
 };
+var failReferenceForRequiredVisualEvidence = (reference, failure, visualEvidence, shouldFail = true) => {
+  if (visualEvidence !== "required" || !shouldFail) return reference;
+  return {
+    ...reference,
+    captureStatus: "failed",
+    captureFailure: reference.captureFailure ?? failure
+  };
+};
+var isPolicySkippedVisualEvidence = (visual) => visual.status === "skipped" && visual.warnings.some((warning) => warning.startsWith("policy:"));
+var finalizeInspiredesignReferenceVisual = async (reference, visualEvidence) => {
+  const visual = reference.capture?.visual;
+  if (!visual) {
+    return { reference };
+  }
+  const runtimeVisual = visual;
+  if (visual.status !== "captured" || !runtimeVisual.tempPath) {
+    const persisted = persistInspiredesignVisualEvidence(visual);
+    const referenceWithPersistedVisual = {
+      ...reference,
+      capture: mergeCaptureVisualEvidence(reference.capture, persisted)
+    };
+    return {
+      reference: failReferenceForRequiredVisualEvidence(
+        referenceWithPersistedVisual,
+        persisted.failure ?? REQUIRED_VISUAL_EVIDENCE_MISSING_FAILURE,
+        visualEvidence,
+        !isPolicySkippedVisualEvidence(persisted)
+      )
+    };
+  }
+  const artifactPath = buildVisualEvidenceArtifactPath(reference.id, visual.kind);
+  try {
+    const buffer = await readFile(runtimeVisual.tempPath);
+    if (buffer.byteLength === 0) {
+      throw new Error("Visual evidence screenshot file was empty.");
+    }
+    const persisted = persistInspiredesignVisualEvidence(visual, {
+      artifactPath,
+      sha256: hashVisualEvidenceBuffer(buffer),
+      bytes: buffer.byteLength
+    });
+    return {
+      reference: {
+        ...reference,
+        capture: mergeCaptureVisualEvidence(reference.capture, persisted)
+      },
+      file: {
+        path: artifactPath,
+        content: buffer
+      }
+    };
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message.trim() : "";
+    const failure = errorMessage === "Visual evidence screenshot file was empty." ? errorMessage : "Visual evidence screenshot file was unavailable.";
+    const persisted = persistInspiredesignVisualEvidence({
+      ...visual,
+      status: "failed",
+      warnings: [...readRuntimeVisualWarnings(runtimeVisual), "finalize_failed"],
+      failure
+    });
+    const referenceWithPersistedVisual = {
+      ...reference,
+      capture: mergeCaptureVisualEvidence(reference.capture, persisted)
+    };
+    return {
+      reference: failReferenceForRequiredVisualEvidence(referenceWithPersistedVisual, failure, visualEvidence)
+    };
+  }
+};
+var finalizeInspiredesignVisualArtifacts = async (references, visualEvidence) => {
+  const finalized = await Promise.all(
+    references.map((reference) => finalizeInspiredesignReferenceVisual(reference, visualEvidence))
+  );
+  return {
+    references: finalized.map((entry) => entry.reference),
+    files: finalized.map((entry) => entry.file).filter((file) => Boolean(file))
+  };
+};
+var buildInspiredesignVisualCapturePlan = (url, workflowInput, result, visualEvidenceTempDir) => {
+  const referenceId = getInspiredesignReferenceId(url);
+  const policy = decideInspiredesignVisualCapturePolicy({
+    visualEvidence: workflowInput.visualEvidence,
+    failures: result.failures,
+    topLevelError: result.error,
+    cookiePolicy: workflowInput.cookiePolicyOverride,
+    hasUsableRecords: result.records.length > 0
+  });
+  if (policy.status !== "allowed" || !visualEvidenceTempDir) {
+    return { policy, referenceId };
+  }
+  return {
+    policy,
+    referenceId,
+    tempPath: join3(visualEvidenceTempDir, `${referenceId}-viewport.png`)
+  };
+};
 var summarizeInspiredesignCaptureConstraint = (references) => {
   const failedReferences = references.filter((reference) => reference.captureStatus === "failed");
   if (failedReferences.length === 0) {
@@ -17084,14 +17933,26 @@ var summarizeInspiredesignCaptureConstraint = (references) => {
 var summarizeInspiredesignFetchConstraint = (references) => {
   return references.find((reference) => reference.fetchStatus === "failed" && !isInspiredesignFetchRecovered(reference) && typeof reference.fetchFailure === "string" && reference.fetchFailure.trim().length > 0)?.fetchFailure;
 };
-var buildInspiredesignMeta = (runtime, workflowInput, references, failures, followthrough) => {
+var hasSurvivingInspiredesignReference = (references) => references.some((reference) => reference.fetchStatus === "captured" || reference.captureStatus === "captured");
+var selectInspiredesignPrimaryConstraintFailures = (failures, references, discovery) => {
+  if (!hasSurvivingInspiredesignReference(references)) return failures;
+  if (discovery.failures.length === 0) return failures;
+  return failures.slice(discovery.failures.length);
+};
+var buildInspiredesignMeta = (runtime, workflowInput, references, failures, followthrough, discovery) => {
   const failedCaptures = references.filter((reference) => reference.captureStatus === "failed");
   const captureAttemptReport = summarizeInspiredesignCaptureAttempts(references);
   const recoveredFetches = summarizeInspiredesignRecoveredFetches(references);
+  const hasSurvivingReference = hasSurvivingInspiredesignReference(references);
+  const primaryConstraintFailures = selectInspiredesignPrimaryConstraintFailures(failures, references, discovery);
   let reasonCodeDistribution = summarizeReasonCodeDistribution(failures);
   let meta = withCamelCasePrimaryConstraintMeta(withReasonCodeDistributionMeta({
     selection: {
       urls: workflowInput.urls,
+      ...workflowInput.query ? { query: workflowInput.query } : {},
+      ...workflowInput.providers.length > 0 ? { providers: workflowInput.providers } : {},
+      ...workflowInput.referenceLimit !== void 0 ? { max_references: workflowInput.referenceLimit } : {},
+      ...workflowInput.visualEvidence !== "off" ? { visual_evidence: workflowInput.visualEvidence } : {},
       capture_mode: workflowInput.captureMode,
       ...workflowInput.browserMode ? { requested_browser_mode: workflowInput.browserMode } : {},
       include_prototype_guidance: Boolean(workflowInput.includePrototypeGuidance)
@@ -17109,7 +17970,7 @@ var buildInspiredesignMeta = (runtime, workflowInput, references, failures, foll
       ...captureAttemptReport ? { capture_attempts: captureAttemptReport.counts } : {}
     },
     alerts: buildWorkflowAlerts(runtime, failures)
-  }, reasonCodeDistribution), failures);
+  }, reasonCodeDistribution), primaryConstraintFailures);
   if (!meta.primaryConstraint) {
     const fetchConstraint = summarizeInspiredesignFetchConstraint(references);
     if (fetchConstraint) {
@@ -17119,6 +17980,16 @@ var buildInspiredesignMeta = (runtime, workflowInput, references, failures, foll
       };
     }
   }
+  if (!hasSurvivingReference && !meta.primaryConstraint && !meta.primaryConstraintSummary) {
+    const discoveryConstraint = summarizeInspiredesignDiscoveryConstraint(discovery);
+    if (discoveryConstraint) {
+      meta = withPrimaryConstraintSummaryOverride(
+        meta,
+        discoveryConstraint.summary,
+        discoveryConstraint.guidance
+      );
+    }
+  }
   if (!meta.primaryConstraint && !meta.primaryConstraintSummary) {
     const captureConstraint = summarizeInspiredesignCaptureConstraint(references);
     if (captureConstraint) {
@@ -17143,9 +18014,26 @@ var buildInspiredesignMeta = (runtime, workflowInput, references, failures, foll
     } : {},
     recommendedSkills: followthrough.recommendedSkills,
     deepCaptureRecommendation: followthrough.deepCaptureRecommendation,
+    discovery,
     contractScope: followthrough.contractScope
   };
 };
+var buildInspiredesignDiscoveryGuidance = (discovery) => ({
+  reason: discovery.failure ?? "Reference discovery did not produce usable design references.",
+  recommendedNextCommands: [
+    "Rerun inspiredesign harvest with explicit --url references from usable inspiration pages.",
+    "Retry provider discovery in a lane with provider search support and any required authenticated browser session."
+  ]
+});
+var summarizeInspiredesignDiscoveryConstraint = (discovery) => {
+  if (!discovery.requested || discovery.acceptedUrls.length > 0) return void 0;
+  const queryDetail = discovery.query ? ` for query "${discovery.query}"` : "";
+  const summary = discovery.failure ?? `Reference discovery returned no usable references${queryDetail}.`;
+  return {
+    summary,
+    guidance: buildInspiredesignDiscoveryGuidance(discovery)
+  };
+};
 var inferBrandFromContent = (content, productUrl) => {
   const normalized = normalizePlainText(content);
   if (!normalized) return void 0;
@@ -17617,6 +18505,15 @@ var resolveShoppingSourceForUrl = (url) => {
     return "web";
   }
 };
+var getRequiredProductVideoExecutionStep = (steps, stepId) => {
+  const step = steps.find(
+    (candidate) => candidate.id === stepId
+  );
+  if (!step) {
+    throw new Error(`Product-video workflow plan is missing required step ${stepId}.`);
+  }
+  return step;
+};
 var RESEARCH_REJECTED_CANDIDATE_LIMIT = 25;
 var isResearchPrivacyPreferenceShell = (content) => {
   const matchIndex = content.slice(0, 400).search(RESEARCH_PRIVACY_PREFERENCE_SHELL_RE);
@@ -17909,8 +18806,9 @@ var runResearchWorkflow = async (runtime, input) => {
     challengeOrchestration
   });
   const responseMeta = withFollowthroughMeta(meta, handoff);
+  const renderMode = workflowInput.mode ?? "compact";
   const rendered = renderResearch({
-    mode: workflowInput.mode,
+    mode: renderMode,
     topic: plan.compiled.topic,
     records: ranked,
     meta: responseMeta
@@ -17921,7 +18819,7 @@ var runResearchWorkflow = async (runtime, input) => {
     ttlHours: workflowInput.ttlHours,
     files: rendered.files
   });
-  if (workflowInput.mode === "path") {
+  if (renderMode === "path") {
     return {
       ...rendered.response,
       ...handoff,
@@ -18135,85 +19033,134 @@ var runShoppingWorkflow = async (runtime, input) => {
 var runInspiredesignWorkflow = async (runtime, input, options = {}) => {
   const { envelope, workflowInput: rawWorkflowInput } = buildInspiredesignEnvelope(input);
   const artifactRoot = resolveWorkflowArtifactRoot(rawWorkflowInput.outputDir);
-  const workflowInput = { ...rawWorkflowInput, outputDir: artifactRoot };
+  let workflowInput = { ...rawWorkflowInput, outputDir: artifactRoot };
   const remainingTimeoutMs = createRemainingTimeoutResolver(workflowInput.timeoutMs);
-  let trace = appendWorkflowTrace(envelope.trace ?? [], "compile", "compile_started", {
-    kind: "inspiredesign"
-  });
-  trace = appendWorkflowTrace(trace, "compile", "compile_completed", {
-    kind: "inspiredesign",
-    urlCount: workflowInput.urls.length,
-    captureMode: workflowInput.captureMode
-  });
-  const references = [];
-  const failures = [];
-  for (const [index, url] of workflowInput.urls.entries()) {
-    const stepTrace = appendWorkflowTrace(trace, "execute", "reference_started", {
-      stepIndex: index,
-      url
+  const visualEvidenceTempDir = workflowInput.visualEvidence !== "off" ? await mkdtemp2(join3(tmpdir2(), "inspiredesign-visual-")) : void 0;
+  try {
+    const discovery = await discoverInspiredesignReferences(
+      runtime,
+      workflowInput,
+      envelope,
+      workflowInput.query ? remainingTimeoutMs() : void 0
+    );
+    workflowInput = {
+      ...workflowInput,
+      urls: mergeInspiredesignReferenceUrls(
+        workflowInput.urls,
+        discovery.acceptedUrls,
+        workflowInput.referenceLimit ?? workflowInput.urls.length + discovery.acceptedUrls.length
+      ),
+      captureMode: resolveInspiredesignCaptureMode(workflowInput.captureMode, [
+        ...workflowInput.urls,
+        ...discovery.acceptedUrls
+      ])
+    };
+    let trace = appendWorkflowTrace(envelope.trace ?? [], "compile", "compile_started", {
+      kind: "inspiredesign"
     });
-    const fetchTimeoutMs = remainingTimeoutMs();
-    const fetchResult = await runtime.fetch(
-      { url },
-      buildInspiredesignFetchOptions(
+    trace = appendWorkflowTrace(trace, "compile", "compile_completed", {
+      kind: "inspiredesign",
+      urlCount: workflowInput.urls.length,
+      captureMode: workflowInput.captureMode
+    });
+    const references = [];
+    const failures = [...discovery.failures];
+    for (const [index, url] of workflowInput.urls.entries()) {
+      const stepTrace = appendWorkflowTrace(trace, "execute", "reference_started", {
+        stepIndex: index,
+        url
+      });
+      const fetchTimeoutMs = remainingTimeoutMs();
+      const fetchResult = await runtime.fetch(
+        { url },
+        buildInspiredesignFetchOptions(
+          workflowInput,
+          buildInspiredesignStepEnvelope(workflowInput, stepTrace, index, url),
+          fetchTimeoutMs
+        )
+      );
+      const result = normalizeInspiredesignFetchResult(fetchResult);
+      observeWorkflowSignals(runtime, result);
+      const captureTimeoutMs = remainingTimeoutMs();
+      const visualPlan = buildInspiredesignVisualCapturePlan(
+        url,
         workflowInput,
-        buildInspiredesignStepEnvelope(workflowInput, stepTrace, index, url),
-        fetchTimeoutMs
-      )
-    );
-    const result = normalizeInspiredesignFetchResult(fetchResult);
-    observeWorkflowSignals(runtime, result);
-    const captureTimeoutMs = remainingTimeoutMs();
-    const capture = await captureInspiredesignReference(
-      url,
-      workflowInput.captureMode,
+        result,
+        visualEvidenceTempDir
+      );
+      const capture = await captureInspiredesignReference(
+        url,
+        workflowInput.captureMode,
+        workflowInput,
+        options.captureReference,
+        visualPlan,
+        captureTimeoutMs
+      );
+      const reference = buildInspiredesignReference(url, result, capture);
+      references.push(reference);
+      if (reference.fetchStatus === "failed" && !isInspiredesignFetchRecovered(reference)) {
+        failures.push(...result.failures);
+      }
+      trace = appendWorkflowTrace(stepTrace, "execute", "reference_completed", {
+        stepIndex: index,
+        url,
+        fetchStatus: result.records.length > 0 ? "captured" : "failed",
+        captureStatus: capture.captureStatus
+      });
+    }
+    const visualCollation = await finalizeInspiredesignVisualArtifacts(references, workflowInput.visualEvidence);
+    const packet = buildInspiredesignPacket({
+      brief: workflowInput.brief,
+      briefExpansion: workflowInput.briefExpansion,
+      urls: workflowInput.urls,
+      references: visualCollation.references,
+      includePrototypeGuidance: workflowInput.includePrototypeGuidance
+    });
+    const meta = buildInspiredesignMeta(
+      runtime,
       workflowInput,
-      options.captureReference,
-      captureTimeoutMs
+      visualCollation.references,
+      failures,
+      packet.followthrough,
+      discovery
     );
-    const reference = buildInspiredesignReference(url, result, capture);
-    references.push(reference);
-    if (reference.fetchStatus === "failed" && !isInspiredesignFetchRecovered(reference)) {
-      failures.push(...result.failures);
-    }
-    trace = appendWorkflowTrace(stepTrace, "execute", "reference_completed", {
-      stepIndex: index,
-      url,
-      fetchStatus: result.records.length > 0 ? "captured" : "failed",
-      captureStatus: capture.captureStatus
+    const rendered = renderInspiredesign({
+      mode: workflowInput.mode,
+      brief: workflowInput.brief,
+      advancedBriefMarkdown: packet.advancedBriefMarkdown,
+      urls: workflowInput.urls,
+      designContract: packet.designContract,
+      canvasPlanRequest: packet.canvasPlanRequest,
+      designAgentHandoff: packet.followthrough,
+      generationPlan: packet.generationPlan,
+      implementationPlan: packet.implementationPlan,
+      designMarkdown: packet.designMarkdown,
+      implementationPlanMarkdown: packet.implementationPlanMarkdown,
+      prototypeGuidanceMarkdown: packet.prototypeGuidanceMarkdown,
+      evidence: packet.evidence,
+      visualEvidence: packet.visualEvidence,
+      screenshotIndex: packet.screenshotIndex,
+      rankedReferences: packet.rankedReferences,
+      referencePatternBoard: packet.generationPlan.referencePatternBoard,
+      metaPromptMarkdown: packet.metaPromptMarkdown,
+      meta
     });
-  }
-  const packet = buildInspiredesignPacket({
-    brief: workflowInput.brief,
-    briefExpansion: workflowInput.briefExpansion,
-    urls: workflowInput.urls,
-    references,
-    includePrototypeGuidance: workflowInput.includePrototypeGuidance
-  });
-  const meta = buildInspiredesignMeta(runtime, workflowInput, references, failures, packet.followthrough);
-  const rendered = renderInspiredesign({
-    mode: workflowInput.mode,
-    brief: workflowInput.brief,
-    advancedBriefMarkdown: packet.advancedBriefMarkdown,
-    urls: workflowInput.urls,
-    designContract: packet.designContract,
-    canvasPlanRequest: packet.canvasPlanRequest,
-    designAgentHandoff: packet.followthrough,
-    generationPlan: packet.generationPlan,
-    implementationPlan: packet.implementationPlan,
-    designMarkdown: packet.designMarkdown,
-    implementationPlanMarkdown: packet.implementationPlanMarkdown,
-    prototypeGuidanceMarkdown: packet.prototypeGuidanceMarkdown,
-    evidence: packet.evidence,
-    meta
-  });
-  const bundle = await createArtifactBundle({
-    namespace: "inspiredesign",
-    outputDir: artifactRoot,
-    ttlHours: workflowInput.ttlHours,
-    files: rendered.files
-  });
-  if (workflowInput.mode === "path") {
+    const bundle = await createArtifactBundle({
+      namespace: "inspiredesign",
+      outputDir: artifactRoot,
+      ttlHours: workflowInput.ttlHours,
+      files: [...rendered.files, ...visualCollation.files]
+    });
+    if (workflowInput.mode === "path") {
+      return {
+        ...rendered.response,
+        artifact_path: bundle.basePath,
+        meta: {
+          ...meta,
+          artifact_manifest: bundle.manifest
+        }
+      };
+    }
     return {
       ...rendered.response,
       artifact_path: bundle.basePath,
@@ -18222,15 +19169,11 @@ var runInspiredesignWorkflow = async (runtime, input, options = {}) => {
         artifact_manifest: bundle.manifest
       }
     };
-  }
-  return {
-    ...rendered.response,
-    artifact_path: bundle.basePath,
-    meta: {
-      ...meta,
-      artifact_manifest: bundle.manifest
+  } finally {
+    if (visualEvidenceTempDir) {
+      await rm2(visualEvidenceTempDir, { recursive: true, force: true }).catch(() => void 0);
     }
-  };
+  }
 };
 var runProductVideoWorkflow = async (runtime, input, options = {}) => {
   const envelope = isWorkflowResumeEnvelope(input) ? input : buildWorkflowResumeEnvelope("product_video", input);
@@ -18294,15 +19237,7 @@ var runProductVideoWorkflow = async (runtime, input, options = {}) => {
     ...updates,
     completed_step_ids: checkpointState2.completed_step_ids.includes(stepId) ? checkpointState2.completed_step_ids : [...checkpointState2.completed_step_ids, stepId]
   });
-  const getRequiredProductVideoStep = (stepId) => {
-    const step = plan.plan.steps.find(
-      (candidate) => candidate.id === stepId
-    );
-    if (!step) {
-      throw new Error(`Product-video workflow plan is missing required step ${stepId}.`);
-    }
-    return step;
-  };
+  const getRequiredProductVideoStep = (stepId) => getRequiredProductVideoExecutionStep(plan.plan.steps, stepId);
   let checkpointState = {
     ...plan.checkpointState,
     completed_step_ids: [...plan.checkpointState.completed_step_ids]
@@ -18732,10 +19667,10 @@ var Semaphore = class {
       this.active += 1;
       return;
     }
-    await new Promise((resolve) => {
+    await new Promise((resolve2) => {
       this.queue.push(() => {
         this.active += 1;
-        resolve();
+        resolve2();
       });
     });
   }
@@ -21085,4 +22020,4 @@ export {
   createProviderRuntime,
   createDefaultRuntime
 };
-//# sourceMappingURL=chunk-4BEJVZRK.js.map
+//# sourceMappingURL=chunk-RO3SMXF3.js.map