@triplef/agent 0.1.17 → 0.1.18

package/dist/prompts/index.mjs

@@ -1,9 +1,4 @@
 import { z } from 'zod';
-import '@triplef/helpers/object-io';
-import 'ai';
-import '@mozilla/readability';
-import 'linkedom';
-import 'turndown';
 import { limitText } from '@triplef/helpers/limit-text';
 
 // src/prompts/shared/multimodal-policy.prompt.ts
@@ -162,877 +157,9 @@ function buildLocalizationRule(language) {
 - Do not translate internal markers, tool arguments, or your reasoning.`;
 }
 
-// src/schemas/constants/embeddable-video-providers.constant.ts
-var EMBEDDABLE_VIDEO_PROVIDER_LABELS = "YouTube, Vimeo, Dailymotion, Loom, Wistia";
-var EMBEDDABLE_VIDEO_PROVIDER_CLAUSE = `Only return URLs from supported embeddable providers: ${EMBEDDABLE_VIDEO_PROVIDER_LABELS}, or direct video files. Reject Instagram, Facebook, TikTok, Twitch, X/Twitter, and other unreliable platforms.`;
-
-// src/schemas/constants/media-counts.constant.ts
-var DEFAULT_MEDIA_COUNT = 6;
-var MORE_MEDIA_COUNT = 12;
-
-// src/schemas/constants/url-trust.constants.ts
-var BLOCKED_URL_HOSTS = /* @__PURE__ */ new Set([
-  // Google thumbnail / static asset proxies
-  "encrypted-tbn0.gstatic.com",
-  "encrypted-tbn1.gstatic.com",
-  "encrypted-tbn2.gstatic.com",
-  "encrypted-tbn3.gstatic.com",
-  "t0.gstatic.com",
-  "t1.gstatic.com",
-  "t2.gstatic.com",
-  "t3.gstatic.com",
-  "t4.gstatic.com",
-  "t5.gstatic.com",
-  "t6.gstatic.com",
-  "t7.gstatic.com",
-  "t8.gstatic.com",
-  "t9.gstatic.com",
-  "t10.gstatic.com",
-  "news.gstatic.com",
-  "books.gstatic.com",
-  "maps.gstatic.com",
-  "lh1.googleusercontent.com",
-  "lh2.googleusercontent.com",
-  "lh3.googleusercontent.com",
-  "lh4.googleusercontent.com",
-  "lh5.googleusercontent.com",
-  "lh6.googleusercontent.com"
-]);
-var NON_PAGE_EXTENSIONS = /\.(js|css|json|xml|svg|png|jpg|jpeg|gif|webp|ico|mp4|webm|ogg|mov|mkv|avi|flv|m3u8|mpd|pdf|zip|tar|gz|rar|exe|dmg|pkg|deb|rpm|woff|woff2|ttf|otf|eot)(\?.*)?$/i;
-var EncyclopediaClassifySchema = z.object({
-  /**
-   * One broad lowercase PLURAL family label for the document (e.g. `games`,
-   * `work`, `health`) — the constellation's cluster tier. Never a specific
-   * entity, product, company, or title.
-   */
-  category: z.string(),
-  /**
-   * The narrow topic the document is about (e.g. `wuthering waves`,
-   * `q3 budget`) — the constellation's cluster tier. A short, specific,
-   * reusable label, not a sentence and not a URL.
-   */
-  topic: z.string()
-});
-
-// src/schemas/helpers/tools/tool-registry.constants.ts
-var VARIANT_NAMES = ["grayscale", "denoised", "sharpened", "clahe"];
-var TOOL_DESCRIPTIONS = {
-  brightDataWebSearch: "Search the web using Bright Data SERP API (Google). Returns organic results with titles, snippets, and links. Supports an optional recency window (day/week/month/year) for fresh results.",
-  brightDataImageSearch: "Search for images using Bright Data SERP API (Google Images). Returns image URLs, source pages, and dimensions. Enforces a minimum of 1280\xD7720 (720p).",
-  brightDataNewsSearch: "Search latest news using Bright Data SERP API. Returns headlines, sources, dates, and snippets. Supports an optional recency window (day/week/month/year).",
-  brightDataPlacesSearch: "Search places and businesses using Bright Data SERP API (Google Maps). Returns addresses, phone numbers, ratings, review counts, and coordinates. Query with a business name or business type plus location.",
-  brightDataShoppingSearch: "Search for products using Bright Data SERP API (Google Shopping). Returns prices, sellers, images, and ratings. Query with the bare product name and model number.",
-  brightDataVideoSearch: `Search for videos using Bright Data SERP API. Returns titles, links, channel names, duration, and publish dates. Supports an optional recency window (day/week/month/year) for fresh results. ${EMBEDDABLE_VIDEO_PROVIDER_CLAUSE}`,
-  brightDataWebpageScrape: "Fetch and render a full webpage using Bright Data Web Unlocker API. Returns clean Markdown text. Use for pages behind anti-bot protection that plain fetch cannot reach.",
-  serperWebSearch: "Search the web using Serper.dev (Google). Returns organic results with titles, snippets, and links. Supports an optional recency window (day/week/month/year) for fresh results.",
-  serperImageSearch: "Search for images using Serper.dev (Google Images). Prefers 2560\xD71440 (1440p) images and enforces a minimum of 1280\xD7720 (720p) via the Google Images tbs size filter and a client-side dimension filter. Supports an optional recency window (day/week/month/year).",
-  serperNewsSearch: "Search latest news using Serper.dev. Returns headlines, sources, dates, and snippets. Supports an optional recency window (day/week/month/year).",
-  serperPlacesSearch: "Search places and businesses using Serper.dev (Google Maps). Returns addresses, phone numbers, ratings, review counts, and coordinates. Query with a business name or business type plus location.",
-  serperShoppingSearch: "Search for products using Serper.dev (Google Shopping). Returns prices, sellers, delivery info, images, and per-offer ratings. Query with the bare product name and model number.",
-  serperBusinessReviewsSearch: "Fetch Google Maps reviews for a specific business or place using Serper.dev. Returns reviewer snippets with author names, star ratings, and dates. Use for seller/business reputation, not editorial product reviews.",
-  serperVideoSearch: `Search for videos using Serper.dev. Returns titles, links, channel names, duration, and publish dates. Supports an optional recency window (day/week/month/year) for fresh results. ${EMBEDDABLE_VIDEO_PROVIDER_CLAUSE}`,
-  serperWebpageScrape: "Fetch and render a full webpage using Serper.dev scrape API. Returns clean rendered text with its title.",
-  youtubeVideoSearch: "Search YouTube using the official YouTube Data API. Returns titles, links, channel names, durations, view counts, upload dates, and direct thumbnails. All results are embeddable YouTube videos.",
-  eodhdSearch: 'Resolve a company, ETF, or index name to an EODHD ticker code (e.g. "Nvidia" \u2192 NVDA.US). Use before fetching quotes, history, technicals, or news for a named entity.',
-  eodhdQuote: "Fetch the current (delayed) quote for one or more EODHD tickers \u2014 last price, change, change %, open/high/low, volume, previous close.",
-  eodhdHistory: "Fetch end-of-day OHLCV price history for an EODHD ticker. Returns a compact summary plus the full time series as chartData for the client chart. Use for the time-value chart and buy/sell pressure (volume).",
-  eodhdTechnical: "Fetch a technical indicator series (RSI, MACD, ADX, SMA, EMA, BBANDS, ATR, \u2026) for an EODHD ticker. Use to gauge buy/sell pressure and momentum.",
-  eodhdIntraday: "Fetch intraday OHLCV bars for an EODHD ticker and return a per-day, per-price-band volume profile as chartData for the client heatmap. Use to render a volume heatmap across fixed price bands.",
-  eodhdNews: "Fetch recent financial news for an EODHD ticker \u2014 headlines, links, sources, publish dates. Use to ground a stock-market answer in what is happening around a company.",
-  eodhdFundamentals: "Fetch company fundamentals for an EODHD ticker \u2014 general info, valuation, and key financial highlights (sector, market cap, P/E, revenue, margins).",
-  webFetch: "Fetch the full content of a specific URL (e.g. a search result page) as clean Markdown. Prefer fetching the most relevant search results to ground the answer in full source text rather than relying on snippets alone.",
-  browser_navigate: "Control a real browser: navigate to a URL. Use for interactive browsing \u2014 JS-heavy pages, content behind clicks, tabs, scrolling, or forms \u2014 that static search/fetch cannot reach. Follow up with browser_snapshot to read the page before acting on it.",
-  browser_navigate_back: "Go back to the previous page in the browser history.",
-  browser_snapshot: "Read the current browser page as an accessibility snapshot (structured text with element refs). The primary way to see page content and obtain the refs that browser_click/browser_type need.",
-  browser_click: "Click an element in the browser, referenced by a ref from browser_snapshot.",
-  browser_type: "Type text into an editable browser element, referenced by a ref from browser_snapshot, optionally submitting with Enter.",
-  browser_fill_form: "Fill multiple form fields in the browser in one call.",
-  browser_select_option: "Select an option in a dropdown in the browser.",
-  browser_press_key: "Press a keyboard key in the browser (Enter, Tab, arrows).",
-  browser_wait_for: "Wait for text to appear or disappear, or for a time period, in the browser.",
-  browser_take_screenshot: "Take a screenshot of the current browser page or a specific element.",
-  browser_tabs: "List, create, close, or switch browser tabs.",
-  browser_console_messages: "Get console messages from the browser. Use to diagnose JavaScript errors on a page (e.g. when testing a web app).",
-  browser_network_requests: "List network requests the browser made since page load. Use to diagnose failed or slow requests (e.g. when testing a web app).",
-  browser_verify_element_visible: "Assert that an element is visible on the current browser page.",
-  browser_verify_text_visible: "Assert that text is visible on the current browser page.",
-  requestGrayscale: "Request a grayscale version of the images. Use when color noise or color information is irrelevant, for example when reading text or analyzing shapes.",
-  requestDenoised: "Request a denoised (blurred) version of the images. Use when the original has noise, grain, or artifacts that hide details.",
-  requestSharpened: "Request a sharpened version of the images. Use when edges or fine details are blurry.",
-  requestClahe: "Request a CLAHE (contrast-enhanced) version of the images. Use when details are hidden in shadows or highlights.",
-  "memory-partition-remember": `Store into the user's fact partition (memory-partition): notable facts about subjects they care about (favorites, interests, projects, followed stocks, people, past topics), preferences and durable details they state, and anything they explicitly ask you to remember. Storing gathered knowledge and noticed preferences is expected \u2014 do not wait for an explicit "remember" instruction.`,
-  "memory-partition-recall": "Retrieve from the user's fact partition (memory-partition) \u2014 things they told you in past conversations or asked you to remember. These are trusted user statements, not public facts; attribute them to the user and prefer them over web results for anything personal. Check this tool whenever a request touches a subject this user has cared about before.",
-  "memory-partition-delete": "Delete one exact fact record from the user's fact partition (memory-partition), quoted verbatim from a memory-partition-recall result. Never delete on a guess: recall first, delete the verbatim statement. Needs memory-partition-recall alongside it.",
-  "memory-cognition-remember": "Store one derived insight into your cognition space (memory-cognition) \u2014 your own understanding of the user (inferred traits, standing interests, working nuances, connections between facts). Use for what you LEARN about the user, not what they stated; stated facts belong in memory-partition-remember.",
-  "memory-cognition-forget": "Wipe your entire cognition space (memory-cognition) of the user \u2014 the structured profile AND every derived insight \u2014 only when the user asks you to forget your learned understanding of them or to start over. Fact records in the partition are untouched."
-};
-var BROWSER_TOOL_NAMES = [
-  "browser_navigate",
-  "browser_navigate_back",
-  "browser_snapshot",
-  "browser_click",
-  "browser_type",
-  "browser_fill_form",
-  "browser_select_option",
-  "browser_press_key",
-  "browser_wait_for",
-  "browser_take_screenshot",
-  "browser_tabs",
-  "browser_console_messages",
-  "browser_network_requests",
-  "browser_verify_element_visible",
-  "browser_verify_text_visible"
-];
-var TOOL_NAMES = [
-  "webFetch",
-  "brightDataWebSearch",
-  "brightDataImageSearch",
-  "brightDataNewsSearch",
-  "brightDataPlacesSearch",
-  "brightDataShoppingSearch",
-  "brightDataVideoSearch",
-  "brightDataWebpageScrape",
-  "serperWebSearch",
-  "serperImageSearch",
-  "serperNewsSearch",
-  "serperPlacesSearch",
-  "serperShoppingSearch",
-  "serperBusinessReviewsSearch",
-  "serperVideoSearch",
-  "serperWebpageScrape",
-  "youtubeVideoSearch",
-  "eodhdSearch",
-  "eodhdQuote",
-  "eodhdHistory",
-  "eodhdTechnical",
-  "eodhdIntraday",
-  "eodhdNews",
-  "eodhdFundamentals",
-  "requestGrayscale",
-  "requestDenoised",
-  "requestSharpened",
-  "requestClahe",
-  "memory-partition-remember",
-  "memory-partition-recall",
-  "memory-partition-delete",
-  "memory-cognition-remember",
-  "memory-cognition-forget",
-  ...BROWSER_TOOL_NAMES
-];
-
-// src/schemas/helpers/url-trust/is-private-or-localhost.helper.ts
-function isPrivateOrLocalhost(hostname) {
-  const lower = hostname.toLowerCase();
-  if (lower === "localhost" || lower.endsWith(".localhost")) return true;
-  if (lower === "127.0.0.1" || lower === "0.0.0.0") return true;
-  if (lower.startsWith("10.")) return true;
-  if (/^172\.(1[6-9]|2\d|3[0-1])\./.test(lower)) return true;
-  if (lower.startsWith("192.168.")) return true;
-  if (lower.startsWith("169.254.")) return true;
-  return false;
-}
-
-// src/schemas/helpers/url-trust/is-trusted-url.helper.ts
-function isYouTubeNonVideoPath(hostname, pathname) {
-  const lowerHost = hostname.toLowerCase();
-  if (lowerHost !== "youtube.com" && lowerHost !== "www.youtube.com" && lowerHost !== "m.youtube.com") {
-    return false;
-  }
-  const lowerPath = pathname.toLowerCase();
-  if (lowerPath.startsWith("/s/") || lowerPath.startsWith("/static/") || lowerPath.startsWith("/js/") || lowerPath.startsWith("/css/") || lowerPath.startsWith("/fonts/") || lowerPath.startsWith("/yts/") || lowerPath.startsWith("/iframe_api") || lowerPath.startsWith("/sw.js") || lowerPath.startsWith("/embed_config") || lowerPath.startsWith("/get_video_info") || lowerPath.startsWith("/api/")) {
-    return true;
-  }
-  return false;
-}
-function isTrustedUrl(url, options = {}) {
-  if (!url) return false;
-  let parsed;
-  try {
-    parsed = new URL(url);
-  } catch {
-    return false;
-  }
-  if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
-    return false;
-  }
-  const hostname = parsed.hostname.toLowerCase();
-  const pathname = parsed.pathname;
-  if (BLOCKED_URL_HOSTS.has(hostname)) {
-    return false;
-  }
-  if (isYouTubeNonVideoPath(hostname, pathname)) {
-    return false;
-  }
-  if (NON_PAGE_EXTENSIONS.test(pathname)) {
-    return false;
-  }
-  if (!options.allowPrivate && isPrivateOrLocalhost(hostname)) {
-    return false;
-  }
-  return true;
-}
-function safeUrl(message = "must be a safe URL") {
-  const text = typeof message === "string" ? message : message.message;
-  return z.string().url({ message: "must be a valid URL" }).refine((value) => isTrustedUrl(value, { allowPrivate: false }), {
-    message: text
-  });
-}
-var LOCAL_STORAGE_URL_PATTERN = /^\/api\/v1\/storage\/[A-Za-z0-9_-]+\/[A-Za-z0-9_-]+\/[A-Za-z0-9]+$/;
-function isAbsoluteHttpUrl(value) {
-  try {
-    const protocol = new URL(value).protocol;
-    return protocol === "http:" || protocol === "https:";
-  } catch {
-    return false;
-  }
-}
-function safeVideoUrl(message = "must be a safe video URL") {
-  const text = typeof message === "string" ? message : message.message;
-  return z.string().refine(isAbsoluteHttpUrl, { message: text });
-}
-function safeVideoUrlOrEmpty(message = "must be a safe video URL") {
-  return safeVideoUrl(message).optional().or(z.literal(""));
-}
-function safeMediaUrl(message = "must be a safe media URL") {
-  const text = typeof message === "string" ? message : message.message;
-  return z.string().refine((value) => LOCAL_STORAGE_URL_PATTERN.test(value) || isAbsoluteHttpUrl(value), { message: text });
-}
-function safeMediaUrlOrEmpty(message = "must be a safe media URL") {
-  return safeMediaUrl(message).optional().or(z.literal(""));
-}
-var INDENT = "  ";
-function formatZodShape(schema, options = {}) {
-  const jsonSchema = z.toJSONSchema(schema);
-  return renderNode(jsonSchema, 0, options);
-}
-function renderNode(node, depth, options) {
-  if (node.type === "object" && node.properties) return renderObject(node, depth, options);
-  if (node.type === "object" && node.additionalProperties) {
-    return `{ [key]: ${renderNode(node.additionalProperties, depth, options)} }`;
-  }
-  if (node.type === "array" && node.items) return `[${renderNode(node.items, depth, options)}]`;
-  const anyOfBranches = node.anyOf?.filter((branch) => branch.type !== "null");
-  if (anyOfBranches?.length) return anyOfBranches.map((branch) => renderNode(branch, depth, options)).join(" | ");
-  if (node.enum) return node.enum.map((value) => JSON.stringify(value)).join(" | ");
-  if (node.type === "integer" || node.type === "number") return "number";
-  if (node.type === "boolean") return "boolean";
-  if (node.type === "string") return "string";
-  if (node.type === "null") return "null";
-  return "unknown";
-}
-function renderObject(node, depth, options) {
-  const properties = node.properties ?? {};
-  const required = new Set(node.required ?? []);
-  const entries = Object.entries(properties);
-  if (entries.length === 0) return "{}";
-  const pad = INDENT.repeat(depth);
-  const innerPad = INDENT.repeat(depth + 1);
-  const lines = entries.map(([key, value]) => {
-    const optional = required.has(key) ? "" : "?";
-    const hint = options.overrides?.[key] ?? renderNode(value, depth + 1, options);
-    return `${innerPad}${JSON.stringify(key)}${optional}: ${hint}`;
-  });
-  return `{
-${lines.join(",\n")}
-${pad}}`;
-}
-var DEFAULT_VARIANT_ID = "default";
-var TEMPLATES = [
-  "article",
-  "news",
-  "describe",
-  "compare",
-  "ocr",
-  "summary",
-  "evaluation",
-  "product",
-  "shoplist",
-  "imagelist",
-  "videolist",
-  "stockmarketitem",
-  "stockmarketlist",
-  "merge",
-  "text"
-];
-var ImagePlanSchema = z.object({
-  resize: z.boolean().default(true).describe(
-    "Whether to resize the original images before sending them to the response model. Default true when images are present."
-  ),
-  variants: z.array(z.enum(VARIANT_NAMES)).default([]).describe(
-    "Optional preprocessing variants to generate for the images (grayscale, denoised, sharpened, clahe). Only use when they would materially improve analysis."
-  )
-});
-var IntentSchema = z.object({
-  template: z.enum(TEMPLATES).describe(
-    'Template name: "article" (in-depth research/report \u2014 extensive long-form composed from available snippets), "news" (current events \u2014 a compact brief composed from available snippets), "describe" (single/multi image description), "compare" (compare uploaded images only \u2014 information comparisons use "evaluation"), "ocr" (extract text from images), "summary" (recap prior conversation or topic without new images), "evaluation" (critique/assess something from the conversation), "product" (product details with shop offers and prices), "shoplist" (compact product/shop list for follow-up shopping questions about an already-introduced product), "imagelist" (a pure collection of images about a topic, no article), "videolist" (a pure list/playlist of videos about a topic, no article), "stockmarketitem" (a single stock/ETF/index with price chart, technicals, news, and a recommendation), "stockmarketlist" (a selection of stocks/indices with a market overview), "text" (free chat).'
-  ),
-  prompt: z.string().default(DEFAULT_VARIANT_ID).describe(
-    'Selected prompt variant for the template. Use "default" unless the user explicitly asks for a specific style.'
-  ),
-  tools: z.array(z.enum(TOOL_NAMES)).describe("List of tool names the model decided to invoke."),
-  getDate: z.boolean().default(true).describe(
-    'Whether search queries should be anchored on the current date so results bias toward recent information. Default true. Set to false ONLY for timeless general-knowledge, historical, or conceptual requests where recency does not matter (e.g. "how does photosynthesis work", "history of the Roman Empire", "explain quantum entanglement", creative writing).'
-  ),
-  imageCount: z.preprocess((val) => val === null ? 0 : val, z.number().int().min(0).max(50).default(0)).describe(
-    `Number of images to retrieve when an imageSearch tool is selected. Only set when the user explicitly requests a specific number; otherwise omit or set to 0 and the system will default to ${DEFAULT_MEDIA_COUNT}.`
-  ),
-  videoCount: z.preprocess((val) => val === null ? 0 : val, z.number().int().min(0).max(50).default(0)).describe(
-    `Number of videos to retrieve when a videoSearch tool is selected. Only set when the user explicitly requests a specific number; otherwise omit or set to 0 and the system will default to ${DEFAULT_MEDIA_COUNT}.`
-  ),
-  reasoning: z.string().describe("Short explanation of why this template, prompt, and these tools were chosen."),
-  contextSummary: z.string().default("").describe(
-    "Query-focused extraction of the prior conversation context that the latest user message references or depends on: established topics/entities, key facts from prior answers the follow-up builds on, user constraints, and \u2014 for imagelist/videolist follow-ups \u2014 the previously shown image/video URLs verbatim. Empty if there is no relevant prior context."
-  ),
-  needsClarification: z.boolean().default(false).describe("When true, the request is too ambiguous to classify \u2014 set this instead of picking template/tools."),
-  clarificationQuestion: z.string().nullable().optional().describe(
-    "Concise, human-friendly question to ask the user when needsClarification is true. Ask what the user might have meant and offer the most likely interpretations as options. Do not hardcode wording; adapt tone and language to the user."
-  ),
-  language: z.string().nullable().optional().describe(
-    "Two-letter ISO language code of the latest user message (e.g. 'en', 'de', 'ja', 'es'). Detect from the user's text."
-  ),
-  plan: z.object({
-    images: ImagePlanSchema.optional().describe("Image processing plan. Only present when images are attached.")
-  }).default({}).describe("Execution plan for the response step.")
-});
-var MemoryClusterSummarySchema = z.object({
-  title: z.string().describe('A short noun-phrase label for the cluster (2\u20136 words), e.g. "gaming preferences" or "work projects".'),
-  summary: z.string().describe(
-    "One or two sentences summarizing what this cluster of memories is about \u2014 the shared theme, the key facts, and how they relate."
-  )
-});
-var ConsolidationVerdictSchema = z.object({
-  verdict: z.enum(["keep", "redundant", "merge"]).describe(
-    "keep = the new fact adds information not covered by the candidates; redundant = fully covered already (same claim, no new detail, same polarity); merge = it refines/corrects/completes a candidate and mergedText carries the fuller statement."
-  ),
-  mergedText: z.string().optional().describe("Required with verdict=merge: one fuller self-contained statement (full restatement, never a diff).")
-});
-var MemoryEnrichmentSchema = z.object({
-  /**
-   * 2–6 stable, reusable lowercase topic labels for the record — the existing
-   * tags kept plus any missing labels that would help topic-filtered recall.
-   */
-  tags: z.array(z.string())
-});
-var FACT_KINDS = [
-  "preference",
-  "decision",
-  "state",
-  "contact",
-  "project",
-  "possession",
-  "relationship",
-  "fact"
-];
-var FACT_STABILITIES = ["durable", "volatile"];
-var ExtractedFactSchema = z.object({
-  /**
-   * The self-contained durable statement — third person, subject up front,
-   * no "this"/"that" references.
-   */
-  text: z.string(),
-  /**
-   * The lowercase entity the fact is about (default `user`; a person,
-   * product, or project name). Maintenance adjudication only ever compares
-   * facts about the SAME subject.
-   */
-  subject: z.string().optional(),
-  /**
-   * One broad lowercase PLURAL family label for THIS fact (e.g. `stocks`,
-   * `pets`, `games`) — inherits the turn-side category when omitted. Never
-   * a specific entity, product, company, or game title.
-   */
-  category: z.string().optional(),
-  /** What kind of durable thing this is (see FACT_KINDS). */
-  kind: z.enum(FACT_KINDS),
-  /** Whether a newer statement is expected to replace this one (see FACT_STABILITIES). */
-  stability: z.enum(FACT_STABILITIES)
-});
-var ExtractionSchema = z.object({
-  /**
-   * Durable, self-contained facts worth remembering in a later, unrelated
-   * conversation (preferences, decisions, contact details, project facts),
-   * each carrying its maintenance metadata (subject, category, kind,
-   * stability). Empty when nothing in the text is worth remembering.
-   */
-  facts: z.array(ExtractedFactSchema),
-  /**
-   * 2–6 stable, reusable lowercase topic labels describing the text; the open
-   * vocabulary that powers topic-filtered recall. Tags are NARROW and
-   * specific — entity names, product names, game titles (e.g. `amd`,
-   * `stellar blade`, `stellar blade blood rain`).
-   */
-  tags: z.array(z.string()),
-  /**
-   * One broad lowercase PLURAL family label for the whole turn-side (e.g.
-   * `stocks`, `pets`, `games`) — groups the narrow tags into one topic family
-   * for the constellation's community tier and the relink job's per-category
-   * passes, and backstops facts that omit their own `category`. Never a
-   * specific entity, product, company, or game title: `amd` belongs under
-   * `stocks`; `stellar blade` belongs under `games`. Optional: a turn with
-   * nothing durable may omit it.
-   */
-  category: z.string().optional()
-});
-var nullishText = z.string().nullish();
-var nullishTopics = z.array(z.string()).nullish();
-var memoryCognitionProfileSchema = z.object({
-  /** The user's name or preferred handle, when known. */
-  name: nullishText,
-  /** Primary conversation language (BCP-47-ish, e.g. "en", "de"). */
-  language: nullishText,
-  /** Coarse location the user works from (IANA name or city), when known. */
-  timezone: nullishText,
-  /** Demonstrated skills and domains (e.g. ["TypeScript", "NestJS"]). */
-  expertise: nullishTopics,
-  /** Active goals and aspirations — the most durable cognition there is. */
-  goals: nullishTopics,
-  /** How the user wants to be answered. */
-  communication: z.object({
-    style: nullishText,
-    detailLevel: nullishText,
-    formality: nullishText
-  }).nullish(),
-  /** Tooling / environment / format preferences (free-form key-value). */
-  preferences: z.record(z.string(), z.string()).nullish(),
-  likes: nullishTopics,
-  dislikes: nullishTopics,
-  /** Topics the user keeps returning to. */
-  interests: nullishTopics,
-  /**
-   * Durable CONVICTIONS the AI synthesized about the user's world — the
-   * routing-map topics of its conviction records (depth lives in the
-   * conviction points at paths `convictions.<slug>`). Convictions are the
-   * AI's own derived conclusions, never statements the user made.
-   */
-  convictions: nullishTopics,
-  /** The AI's own identity as the user has shaped it (name, role, voice). */
-  persona: z.object({
-    /** The name the user gave the AI. */
-    name: nullishText,
-    /** The role the user assigned the AI (e.g. "coding assistant"). */
-    role: nullishText,
-    /** Short character description the user gave the AI. */
-    personality: nullishText,
-    /** How the AI introduces itself, when the user set one. */
-    greeting: nullishText,
-    /** How the AI should speak. */
-    voice: z.object({
-      tone: nullishText,
-      formality: nullishText
-    }).nullish()
-  }).nullish(),
-  /**
-   * Learned corrections — behavioral rules the user taught the AI after it
-   * got something wrong. Keyed by a short slug (a stable handle for
-   * update/remove); the value is the imperative directive ("always …" /
-   * "never …"), optionally with a brief why. Deep-merged like preferences.
-   */
-  corrections: z.record(z.string(), z.string()).nullish()
-});
-var memoryProfileInsightSchema = z.object({
-  text: z.string(),
-  path: z.string().optional()
-});
-var memoryProfileResponseSchema = z.preprocess(
-  (value) => {
-    if (value === null || typeof value !== "object" || Array.isArray(value)) return value;
-    const record = value;
-    if (record.insights == null) record.insights = [];
-    else if (Array.isArray(record.insights)) {
-      record.insights = record.insights.map((item) => typeof item === "string" ? { text: item } : item);
-    }
-    return record;
-  },
-  z.object({
-    profile: memoryCognitionProfileSchema.nullish(),
-    insights: z.array(memoryProfileInsightSchema).max(8),
-    /**
-     * One sentence recording what THIS turn was about — the short-term
-     * conversation memory (episode), recalled later by recency-blended probe.
-     * Omitted (or null) when the turn had no substance.
-     */
-    episode: z.string().nullish()
-  })
-);
-var cardSchema = z.object(
-  {
-    url: safeUrl({ message: "cards entries must have a valid url" }),
-    title: z.string().optional(),
-    description: z.string().optional(),
-    linkLabel: z.string().optional()
-  },
-  { message: "cards entries must be objects with url" }
-);
-var referenceLineSchema = z.object(
-  {
-    value: z.number(),
-    label: z.string().optional(),
-    /** A theme token name, e.g. "accent-primary" or "status-error". */
-    color: z.string().optional()
-  },
-  { message: "referenceLines entries must be objects with a numeric value" }
-);
-var markerSchema = z.object(
-  {
-    time: z.string().min(1, { message: "markers entries must have a time" }),
-    position: z.enum(["aboveBar", "belowBar"]),
-    /** A theme token name, e.g. "harmony-3" or "status-error". */
-    color: z.string().optional(),
-    shape: z.enum(["circle", "arrowUp", "arrowDown", "square"]),
-    text: z.string().optional()
-  },
-  {
-    message: "markers entries must be objects with time, position, and shape"
-  }
-);
-var discardedReferenceSchema = z.discriminatedUnion("type", [
-  z.object({
-    type: z.literal("image"),
-    imageUrl: z.string().min(1),
-    title: z.string(),
-    reason: z.string().min(1, { message: "reason must not be empty" })
-  }),
-  z.object({
-    type: z.literal("link"),
-    url: z.string().min(1),
-    title: z.string(),
-    reason: z.string().min(1, { message: "reason must not be empty" })
-  })
-]);
-var internationalCoverageSchema = z.array(
-  z.object(
-    {
-      title: z.string().optional(),
-      url: safeUrl({
-        message: "internationalCoverage entries must have a valid url"
-      }),
-      sourceName: z.string().optional(),
-      language: z.string().optional(),
-      summary: z.string().optional()
-    },
-    { message: "internationalCoverage entries must be objects" }
-  )
-);
-var referenceGalleryItemSchema = z.object(
-  {
-    imageUrl: z.string(),
-    imageAlt: z.string().optional(),
-    title: z.string().optional(),
-    caption: z.string().optional()
-  },
-  { message: "galleryItems entries must be objects with imageUrl" }
-);
-var sourceSchema = z.object(
-  {
-    url: safeUrl({ message: "sources entries must have a valid url" }),
-    title: z.string().optional(),
-    sourceName: z.string().optional(),
-    date: z.string().optional(),
-    snippet: z.string().optional()
-  },
-  { message: "sources entries must be objects with url" }
-);
-function createTextItemSchema(fieldName) {
-  return z.object(
-    {
-      text: z.string().min(1, {
-        message: `${fieldName} entries must have a non-empty text field`
-      })
-    },
-    { message: `${fieldName} entries must be objects with text` }
-  );
-}
-var videoGalleryItemSchema = z.object(
-  {
-    videoUrl: safeVideoUrl({
-      message: "videoGalleryItems.videoUrl must be a valid URL"
-    }),
-    title: z.string().min(1, {
-      message: "videoGalleryItems.title must not be empty"
-    }),
-    caption: z.string().min(1, {
-      message: "videoGalleryItems.caption must not be empty"
-    }),
-    duration: z.string().optional(),
-    channel: z.string().optional(),
-    date: z.string().optional(),
-    views: z.number().int().min(0).optional(),
-    thumbnailUrl: safeMediaUrlOrEmpty({
-      message: "videoGalleryItems.thumbnailUrl must be a valid URL"
-    }),
-    description: z.string().optional()
-  },
-  { message: "videoGalleryItems entries must be objects with videoUrl" }
-);
-function heroVideoHasTitle(data) {
-  return !data.heroVideoUrl?.trim() || Boolean(data.heroVideoTitle?.trim());
-}
-var HERO_VIDEO_TITLE_ISSUE = {
-  message: "heroVideoTitle must not be empty when heroVideoUrl is set",
-  path: ["heroVideoTitle"]
-};
-
-// src/schemas/response/compare-json.schema.ts
-var keyFindingSchema = createTextItemSchema("keyFindings");
-z.object({
-  category: z.string(),
-  title: z.string().min(1, { message: "title must not be empty" }),
-  subtitle: z.string(),
-  sectionContent: z.string(),
-  galleryTitle: z.string().optional(),
-  galleryItems: z.array(referenceGalleryItemSchema).optional(),
-  videoGalleryTitle: z.string().optional(),
-  videoGalleryItems: z.array(videoGalleryItemSchema).optional(),
-  keyFindings: z.array(keyFindingSchema).optional(),
-  sources: z.array(sourceSchema).optional(),
-  discardedReferences: z.array(discardedReferenceSchema).optional(),
-  note: z.string().optional(),
-  internationalCoverage: internationalCoverageSchema.optional()
-});
-var keyFindingSchema2 = createTextItemSchema("keyFindings");
-z.object({
-  category: z.string(),
-  title: z.string().min(1, { message: "title must not be empty" }),
-  subtitle: z.string(),
-  sectionContent: z.string(),
-  galleryTitle: z.string().optional(),
-  galleryItems: z.array(referenceGalleryItemSchema).optional(),
-  videoGalleryTitle: z.string().optional(),
-  videoGalleryItems: z.array(videoGalleryItemSchema).optional(),
-  keyFindings: z.array(keyFindingSchema2).optional(),
-  sources: z.array(sourceSchema).optional(),
-  discardedReferences: z.array(discardedReferenceSchema).optional(),
-  note: z.string().optional(),
-  internationalCoverage: internationalCoverageSchema.optional()
-});
-var galleryItemSchema = z.object(
-  {
-    imageUrl: safeMediaUrl({
-      message: "galleryItems.imageUrl must be a valid URL"
-    }),
-    imageAlt: z.string().min(1, {
-      message: "galleryItems.imageAlt must not be empty"
-    }),
-    title: z.string().min(1, {
-      message: "galleryItems.title must not be empty"
-    }),
-    caption: z.string().optional()
-  },
-  { message: "galleryItems entries must be objects with imageUrl" }
-);
-var imagelistGalleryItemSchema = galleryItemSchema.extend({
-  width: z.number().int().positive().optional(),
-  height: z.number().int().positive().optional(),
-  source: z.string().optional()
-});
-z.object({
-  category: z.string(),
-  title: z.string().min(1, { message: "title must not be empty" }),
-  subtitle: z.string(),
-  galleryItems: z.array(imagelistGalleryItemSchema),
-  sources: z.array(sourceSchema).optional(),
-  internationalCoverage: internationalCoverageSchema.optional()
-});
-var keyFindingSchema3 = createTextItemSchema("keyFindings");
-z.object({
-  category: z.string(),
-  title: z.string().min(1, { message: "title must not be empty" }),
-  subtitle: z.string(),
-  sectionContent: z.string(),
-  keyFindings: z.array(keyFindingSchema3).optional(),
-  // Reference material, only when the model researched visible clues online
-  galleryTitle: z.string().optional(),
-  galleryItems: z.array(referenceGalleryItemSchema).optional(),
-  videoGalleryTitle: z.string().optional(),
-  videoGalleryItems: z.array(videoGalleryItemSchema).optional(),
-  sources: z.array(sourceSchema).optional(),
-  discardedReferences: z.array(discardedReferenceSchema).optional(),
-  internationalCoverage: internationalCoverageSchema.optional()
-});
-var shopOfferSchema = z.object(
-  {
-    title: z.string().optional(),
-    price: z.string().optional(),
-    source: z.string().optional(),
-    link: safeUrl({ message: "shopOffers entries must have a valid link" }),
-    imageUrl: z.string().url().optional().or(z.literal("")),
-    delivery: z.string().optional(),
-    rating: z.number().optional(),
-    ratingCount: z.number().optional()
-  },
-  { message: "shopOffers entries must be objects with a link" }
-);
-var statHighlightSchema = z.object(
-  {
-    label: z.string().min(1, { message: "statHighlights entries must have a label" }),
-    value: z.string().min(1, { message: "statHighlights entries must have a value" })
-  },
-  { message: "statHighlights entries must be objects with label and value" }
-);
-z.object({
-  category: z.string(),
-  title: z.string().min(1, { message: "title must not be empty" }),
-  subtitle: z.string(),
-  shortDescription: z.string(),
-  // Purchase-decision fields
-  aggregateRating: z.number().min(0).max(5).optional(),
-  aggregateRatingCount: z.number().int().min(0).optional(),
-  aggregateRatingLabel: z.string().optional(),
-  statHighlights: z.array(statHighlightSchema).optional(),
-  keyPoints: z.array(createTextItemSchema("keyPoints")).optional(),
-  pros: z.array(createTextItemSchema("pros")).optional(),
-  cons: z.array(createTextItemSchema("cons")).optional(),
-  shopOffers: z.array(shopOfferSchema).optional(),
-  // Media — the product banner is image-only, there is no hero video
-  heroImageUrl: safeMediaUrlOrEmpty(),
-  heroImageAlt: z.string().optional(),
-  heroCaption: z.string().optional(),
-  galleryTitle: z.string().optional(),
-  galleryItems: z.array(galleryItemSchema).optional(),
-  videoGalleryTitle: z.string().optional(),
-  videoGalleryItems: z.array(videoGalleryItemSchema).optional(),
-  // Attribution
-  sources: z.array(sourceSchema).optional(),
-  internationalCoverage: internationalCoverageSchema.optional()
-});
-var relatedStorySchema = z.object(
-  {
-    title: z.string().min(1, { message: "relatedStories entries must have a title" }),
-    url: safeUrl({ message: "relatedStories entries must have a valid url" }),
-    sourceName: z.string().optional(),
-    imageUrl: safeMediaUrl({
-      message: "relatedStories entries must have a valid imageUrl"
-    }),
-    date: z.string().optional()
-  },
-  { message: "relatedStories entries must have title, url, and imageUrl" }
-);
-var shopOfferSchema2 = z.object(
-  {
-    title: z.string().optional(),
-    price: z.string().optional(),
-    source: z.string().optional(),
-    link: safeUrl({ message: "shopOffers entries must have a valid link" }),
-    imageUrl: safeMediaUrlOrEmpty("shopOffers.imageUrl must be a valid URL"),
-    delivery: z.string().optional(),
-    rating: z.number().optional(),
-    ratingCount: z.number().optional()
-  },
-  { message: "shopOffers entries must be objects with a link" }
-);
-z.object({
-  category: z.string(),
-  title: z.string().min(1, { message: "title must not be empty" }),
-  subtitle: z.string(),
-  shortDescription: z.string().optional(),
-  shopOffers: z.array(shopOfferSchema2).optional(),
-  sources: z.array(sourceSchema).optional(),
-  internationalCoverage: internationalCoverageSchema.optional()
-});
-var newsItemSchema = z.object(
-  {
-    title: z.string().min(1, {
-      message: "news entries must have a non-empty title"
-    }),
-    url: safeUrl({ message: "news entries must have a valid url" }),
-    source: z.string().optional(),
-    date: z.string().optional(),
-    snippet: z.string().optional()
-  },
-  { message: "news entries must be objects with title and url" }
-);
-var fundamentalsSchema = z.object({
-  name: z.string().optional(),
-  sector: z.string().optional(),
-  industry: z.string().optional(),
-  marketCap: z.union([z.number(), z.string()]).optional(),
-  peRatio: z.union([z.number(), z.string()]).optional(),
-  revenue: z.union([z.number(), z.string()]).optional(),
-  profitMargin: z.union([z.number(), z.string()]).optional()
-});
-z.object({
-  category: z.string(),
-  title: z.string().min(1, { message: "title must not be empty" }),
-  subtitle: z.string(),
-  shortDescription: z.string(),
-  // Quote
-  currentPrice: z.number().optional(),
-  change: z.number().optional(),
-  changeP: z.number().optional(),
-  // Recommendation
-  recommendation: z.string().optional(),
-  recommendationReasoning: z.string().optional(),
-  // Stats / context
-  keyPoints: z.array(createTextItemSchema("keyPoints")).optional(),
-  fundamentals: fundamentalsSchema.optional(),
-  // News + attribution
-  news: z.array(newsItemSchema).optional(),
-  sources: z.array(sourceSchema).optional(),
-  internationalCoverage: internationalCoverageSchema.optional(),
-  // Chart overlays
-  referenceLines: z.array(referenceLineSchema).optional(),
-  markers: z.array(markerSchema).optional(),
-  // Videos
-  videoGalleryTitle: z.string().optional(),
-  videoGalleryItems: z.array(videoGalleryItemSchema).optional()
-});
-var listItemSchema = z.object(
-  {
-    name: z.string().min(1, {
-      message: "items entries must have a non-empty name"
-    }),
-    ticker: z.string().min(1, {
-      message: "items entries must have a non-empty ticker"
-    }),
-    price: z.number().optional(),
-    change: z.number().optional(),
-    changeP: z.number().optional()
-  },
-  { message: "items entries must be objects with name and ticker" }
-);
-z.object({
-  category: z.string(),
-  title: z.string().min(1, { message: "title must not be empty" }),
-  subtitle: z.string(),
-  summary: z.string(),
-  items: z.array(listItemSchema).optional(),
-  sources: z.array(sourceSchema).optional(),
-  internationalCoverage: internationalCoverageSchema.optional(),
-  // Chart overlays
-  referenceLines: z.array(referenceLineSchema).optional(),
-  markers: z.array(markerSchema).optional(),
-  // Videos
-  videoGalleryTitle: z.string().optional(),
-  videoGalleryItems: z.array(videoGalleryItemSchema).optional()
-});
-var keyFindingSchema4 = createTextItemSchema("keyFindings");
-z.object({
-  category: z.string(),
-  title: z.string().min(1, { message: "title must not be empty" }),
-  subtitle: z.string(),
-  summary: z.string(),
-  keyFindings: z.array(keyFindingSchema4).optional(),
-  sources: z.array(sourceSchema).optional(),
-  // Media from online research
-  heroImageUrl: safeMediaUrlOrEmpty(),
-  heroImageAlt: z.string().optional(),
-  heroCaption: z.string().optional(),
-  heroVideoUrl: safeVideoUrlOrEmpty(),
-  heroVideoTitle: z.string().optional(),
-  heroVideoCaption: z.string().optional(),
-  galleryTitle: z.string().optional(),
-  galleryItems: z.array(galleryItemSchema).optional(),
-  videoGalleryTitle: z.string().optional(),
-  videoGalleryItems: z.array(videoGalleryItemSchema).optional(),
-  internationalCoverage: internationalCoverageSchema.optional()
-}).refine(heroVideoHasTitle, HERO_VIDEO_TITLE_ISSUE);
-z.object({
-  category: z.string(),
-  title: z.string().min(1, { message: "title must not be empty" }),
-  subtitle: z.string(),
-  videoGalleryItems: z.array(videoGalleryItemSchema),
-  internationalCoverage: internationalCoverageSchema.optional()
-});
+// src/schemas/constants/media-counts.constant.ts
+var DEFAULT_MEDIA_COUNT = 6;
+var MORE_MEDIA_COUNT = 12;
 
 // src/prompts/shared/media-counts.prompt.ts
 var MEDIA_COUNTS = `MEDIA COUNTS
@@ -1042,6 +169,10 @@ var MEDIA_COUNTS = `MEDIA COUNTS
 - hero media counts toward the total.
 - Never exceed available URLs.`;
 
+// src/schemas/constants/embeddable-video-providers.constant.ts
+var EMBEDDABLE_VIDEO_PROVIDER_LABELS = "YouTube, Vimeo, Dailymotion, Loom, Wistia";
+var EMBEDDABLE_VIDEO_PROVIDER_CLAUSE = `Only return URLs from supported embeddable providers: ${EMBEDDABLE_VIDEO_PROVIDER_LABELS}, or direct video files. Reject Instagram, Facebook, TikTok, Twitch, X/Twitter, and other unreliable platforms.`;
+
 // src/prompts/shared/media-rules.prompt.ts
 var MEDIA_RULES = `MEDIA RULES
 - Media-list templates (imagelist, videolist, shoplist) have NO hero media, and product has an image-only banner with NO hero video \u2014 their mode rules override every hero-related rule below.
@@ -1177,6 +308,150 @@ function composeSnippetKeys(preset) {
   const optionalKeys = preset.snippets.flatMap((snippet) => Object.keys(snippet.fields)).filter((key) => !required.has(key));
   return { requiredKeys, optionalKeys };
 }
+
+// src/schemas/constants/url-trust.constants.ts
+var BLOCKED_URL_HOSTS = /* @__PURE__ */ new Set([
+  // Google thumbnail / static asset proxies
+  "encrypted-tbn0.gstatic.com",
+  "encrypted-tbn1.gstatic.com",
+  "encrypted-tbn2.gstatic.com",
+  "encrypted-tbn3.gstatic.com",
+  "t0.gstatic.com",
+  "t1.gstatic.com",
+  "t2.gstatic.com",
+  "t3.gstatic.com",
+  "t4.gstatic.com",
+  "t5.gstatic.com",
+  "t6.gstatic.com",
+  "t7.gstatic.com",
+  "t8.gstatic.com",
+  "t9.gstatic.com",
+  "t10.gstatic.com",
+  "news.gstatic.com",
+  "books.gstatic.com",
+  "maps.gstatic.com",
+  "lh1.googleusercontent.com",
+  "lh2.googleusercontent.com",
+  "lh3.googleusercontent.com",
+  "lh4.googleusercontent.com",
+  "lh5.googleusercontent.com",
+  "lh6.googleusercontent.com"
+]);
+var NON_PAGE_EXTENSIONS = /\.(js|css|json|xml|svg|png|jpg|jpeg|gif|webp|ico|mp4|webm|ogg|mov|mkv|avi|flv|m3u8|mpd|pdf|zip|tar|gz|rar|exe|dmg|pkg|deb|rpm|woff|woff2|ttf|otf|eot)(\?.*)?$/i;
+
+// src/schemas/helpers/url-trust/is-private-or-localhost.helper.ts
+function isPrivateOrLocalhost(hostname) {
+  const lower = hostname.toLowerCase();
+  if (lower === "localhost" || lower.endsWith(".localhost")) return true;
+  if (lower === "127.0.0.1" || lower === "0.0.0.0") return true;
+  if (lower.startsWith("10.")) return true;
+  if (/^172\.(1[6-9]|2\d|3[0-1])\./.test(lower)) return true;
+  if (lower.startsWith("192.168.")) return true;
+  if (lower.startsWith("169.254.")) return true;
+  return false;
+}
+
+// src/schemas/helpers/url-trust/is-trusted-url.helper.ts
+function isYouTubeNonVideoPath(hostname, pathname) {
+  const lowerHost = hostname.toLowerCase();
+  if (lowerHost !== "youtube.com" && lowerHost !== "www.youtube.com" && lowerHost !== "m.youtube.com") {
+    return false;
+  }
+  const lowerPath = pathname.toLowerCase();
+  if (lowerPath.startsWith("/s/") || lowerPath.startsWith("/static/") || lowerPath.startsWith("/js/") || lowerPath.startsWith("/css/") || lowerPath.startsWith("/fonts/") || lowerPath.startsWith("/yts/") || lowerPath.startsWith("/iframe_api") || lowerPath.startsWith("/sw.js") || lowerPath.startsWith("/embed_config") || lowerPath.startsWith("/get_video_info") || lowerPath.startsWith("/api/")) {
+    return true;
+  }
+  return false;
+}
+function isTrustedUrl(url, options = {}) {
+  if (!url) return false;
+  let parsed;
+  try {
+    parsed = new URL(url);
+  } catch {
+    return false;
+  }
+  if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+    return false;
+  }
+  const hostname = parsed.hostname.toLowerCase();
+  const pathname = parsed.pathname;
+  if (BLOCKED_URL_HOSTS.has(hostname)) {
+    return false;
+  }
+  if (isYouTubeNonVideoPath(hostname, pathname)) {
+    return false;
+  }
+  if (NON_PAGE_EXTENSIONS.test(pathname)) {
+    return false;
+  }
+  if (!options.allowPrivate && isPrivateOrLocalhost(hostname)) {
+    return false;
+  }
+  return true;
+}
+
+// src/schemas/helpers/url-trust/url-schema.helper.ts
+function safeUrl(message = "must be a safe URL") {
+  const text = typeof message === "string" ? message : message.message;
+  return z.string().url({ message: "must be a valid URL" }).refine((value) => isTrustedUrl(value, { allowPrivate: false }), {
+    message: text
+  });
+}
+var LOCAL_STORAGE_URL_PATTERN = /^\/api\/v1\/storage\/[A-Za-z0-9_-]+\/[A-Za-z0-9_-]+\/[A-Za-z0-9]+$/;
+function isAbsoluteHttpUrl(value) {
+  try {
+    const protocol = new URL(value).protocol;
+    return protocol === "http:" || protocol === "https:";
+  } catch {
+    return false;
+  }
+}
+function safeVideoUrl(message = "must be a safe video URL") {
+  const text = typeof message === "string" ? message : message.message;
+  return z.string().refine(isAbsoluteHttpUrl, { message: text });
+}
+function safeVideoUrlOrEmpty(message = "must be a safe video URL") {
+  return safeVideoUrl(message).optional().or(z.literal(""));
+}
+function safeMediaUrl(message = "must be a safe media URL") {
+  const text = typeof message === "string" ? message : message.message;
+  return z.string().refine((value) => LOCAL_STORAGE_URL_PATTERN.test(value) || isAbsoluteHttpUrl(value), { message: text });
+}
+function safeMediaUrlOrEmpty(message = "must be a safe media URL") {
+  return safeMediaUrl(message).optional().or(z.literal(""));
+}
+
+// src/schemas/response/video-gallery-item-json.schema.ts
+var videoGalleryItemSchema = z.object(
+  {
+    videoUrl: safeVideoUrl({
+      message: "videoGalleryItems.videoUrl must be a valid URL"
+    }),
+    title: z.string().min(1, {
+      message: "videoGalleryItems.title must not be empty"
+    }),
+    caption: z.string().min(1, {
+      message: "videoGalleryItems.caption must not be empty"
+    }),
+    duration: z.string().optional(),
+    channel: z.string().optional(),
+    date: z.string().optional(),
+    views: z.number().int().min(0).optional(),
+    thumbnailUrl: safeMediaUrlOrEmpty({
+      message: "videoGalleryItems.thumbnailUrl must be a valid URL"
+    }),
+    description: z.string().optional()
+  },
+  { message: "videoGalleryItems entries must be objects with videoUrl" }
+);
+function heroVideoHasTitle(data) {
+  return !data.heroVideoUrl?.trim() || Boolean(data.heroVideoTitle?.trim());
+}
+var HERO_VIDEO_TITLE_ISSUE = {
+  message: "heroVideoTitle must not be empty when heroVideoUrl is set",
+  path: ["heroVideoTitle"]
+};
 var RESPONSE_LAYOUTS = ["classic", "editorial", "split", "mosaic"];
 var responseLayoutSchema = z.enum(RESPONSE_LAYOUTS);
 
@@ -1210,6 +485,17 @@ var bodyExtensiveSnippet = {
 - sectionContent: the main body text as one plain-text string of 4-8 paragraphs: context, quotes, reactions, and background. This is the article's core \u2014 write it in full.
 - sectionTitle: a heading for the main body section; omit only when the article needs none.`
 };
+var cardSchema = z.object(
+  {
+    url: safeUrl({ message: "cards entries must have a valid url" }),
+    title: z.string().optional(),
+    description: z.string().optional(),
+    linkLabel: z.string().optional()
+  },
+  { message: "cards entries must be objects with url" }
+);
+
+// src/prompts/snippets/cards.snippet.ts
 var cardsSnippet = {
   fields: {
     cardsTitle: z.string().optional(),
@@ -1228,6 +514,23 @@ var conclusionSnippet = {
   instruction: `SNIPPET conclusion (client closing section):
 - conclusion: a brief closing summary (1-3 sentences); omit when the article already lands cleanly.`
 };
+var galleryItemSchema = z.object(
+  {
+    imageUrl: safeMediaUrl({
+      message: "galleryItems.imageUrl must be a valid URL"
+    }),
+    imageAlt: z.string().min(1, {
+      message: "galleryItems.imageAlt must not be empty"
+    }),
+    title: z.string().min(1, {
+      message: "galleryItems.title must not be empty"
+    }),
+    caption: z.string().optional()
+  },
+  { message: "galleryItems entries must be objects with imageUrl" }
+);
+
+// src/prompts/snippets/gallery.snippet.ts
 var gallerySnippet = {
   fields: {
     galleryTitle: z.string().optional(),
@@ -1265,6 +568,20 @@ var heroMediaSnippet = {
 - heroImageUrl set \u21D2 heroImageAlt MUST be a non-empty descriptive label; heroCaption stays optional.
 - Leave empty ONLY when the pools hold no usable media \u2014 never invent URLs.`
 };
+var internationalCoverageSchema = z.array(
+  z.object(
+    {
+      title: z.string().optional(),
+      url: safeUrl({
+        message: "internationalCoverage entries must have a valid url"
+      }),
+      sourceName: z.string().optional(),
+      language: z.string().optional(),
+      summary: z.string().optional()
+    },
+    { message: "internationalCoverage entries must be objects" }
+  )
+);
 
 // src/prompts/instructions/international-coverage.instruction.ts
 var INTERNATIONAL_COVERAGE_INSTRUCTIONS = `INTERNATIONAL COVERAGE ASIDE:
@@ -1284,6 +601,18 @@ var internationalCoverageSnippet = {
   },
   instruction: INTERNATIONAL_COVERAGE_INSTRUCTIONS
 };
+function createTextItemSchema(fieldName) {
+  return z.object(
+    {
+      text: z.string().min(1, {
+        message: `${fieldName} entries must have a non-empty text field`
+      })
+    },
+    { message: `${fieldName} entries must be objects with text` }
+  );
+}
+
+// src/prompts/snippets/key-findings.snippet.ts
 var keyFindingsSnippet = {
   fields: {
     keyFindings: z.array(createTextItemSchema("keyFindings")).optional()
@@ -1300,6 +629,18 @@ var quoteSnippet = {
 - Needs: a quote that exists verbatim in the retrieved results.
 - quote: one notable quote from the sources; omit when none exists.`
 };
+var sourceSchema = z.object(
+  {
+    url: safeUrl({ message: "sources entries must have a valid url" }),
+    title: z.string().optional(),
+    sourceName: z.string().optional(),
+    date: z.string().optional(),
+    snippet: z.string().optional()
+  },
+  { message: "sources entries must be objects with url" }
+);
+
+// src/prompts/snippets/sources.snippet.ts
 var sourcesSnippet = {
   fields: {
     sources: z.array(sourceSchema).optional()
@@ -1639,6 +980,20 @@ var leadSnippet = {
 - Needs: the core facts from the retrieved results.
 - lead: 2-4 sentences answering who, what, when, where, why and how, strongest facts first (inverted pyramid). REQUIRED, non-empty.`
 };
+var relatedStorySchema = z.object(
+  {
+    title: z.string().min(1, { message: "relatedStories entries must have a title" }),
+    url: safeUrl({ message: "relatedStories entries must have a valid url" }),
+    sourceName: z.string().optional(),
+    imageUrl: safeMediaUrl({
+      message: "relatedStories entries must have a valid imageUrl"
+    }),
+    date: z.string().optional()
+  },
+  { message: "relatedStories entries must have title, url, and imageUrl" }
+);
+
+// src/prompts/snippets/related-stories.snippet.ts
 var relatedStoriesSnippet = {
   fields: {
     relatedStories: z.array(relatedStorySchema).optional()
@@ -1757,46 +1112,6 @@ ${params.instructions}`);
   return sections.filter(Boolean).join("\n\n");
 }
 
-// src/tools/constants/recency.constants.ts
-var RECENCY_DESCRIPTION = "Restrict results to the given past period (day=24 hours, week=7 days, month=1 month, year=1 year). Use for fresh content such as news, recent releases, or trending topics; leave unset for evergreen, historical, or general queries.";
-
-// src/tools/constants/standalone-query.constants.ts
-var STANDALONE_QUERY_DESCRIPTION = 'A standalone, self-contained search query that explicitly names the subject (title, entity, brand, person, place, or topic). Never copy the user message verbatim: rewrite short follow-ups (e.g. "what do the reviews say?") into a full query that names the established subject from the conversation (e.g. "Neverness to Everness NTE reviews").';
-
-// src/tools/bright-data/image-search.schema.ts
-z.object({
-  query: z.string().describe(`${STANDALONE_QUERY_DESCRIPTION} Add short visual qualifiers describing the subject.`),
-  count: z.number().optional().describe("Number of results (max 100)"),
-  minWidth: z.number().optional().describe("Minimum image width in pixels (floor 1280 / 720p)."),
-  minHeight: z.number().optional().describe("Minimum image height in pixels (floor 720 / 720p)."),
-  lang: z.string().optional().describe("Two-letter ISO language code for result preference (e.g. en, de, ja)"),
-  recency: z.enum(["day", "week", "month", "year"]).optional().describe(RECENCY_DESCRIPTION)
-});
-z.object({
-  query: z.string().describe(`${STANDALONE_QUERY_DESCRIPTION} Include the newsworthy angle (announcement, release, event, update).`),
-  count: z.number().optional().describe("Number of results (max 100)"),
-  recency: z.enum(["day", "week", "month", "year"]).optional().describe(RECENCY_DESCRIPTION),
-  lang: z.string().optional().describe("Two-letter ISO language code for result preference (e.g. en, de, ja)")
-});
-z.object({
-  query: z.string().describe(
-    'A standalone places search query that explicitly names the business or business type plus location (e.g. "MediaMarkt Berlin", "coffee shops in Munich").'
-  ),
-  count: z.number().optional().describe("Number of results (max 100)"),
-  lang: z.string().optional().describe("Two-letter ISO language code for result preference (e.g. en, de, ja)")
-});
-z.object({
-  query: z.string().describe("The exact product name with model number, kept short and standalone."),
-  count: z.number().optional().describe("Number of results (max 100)"),
-  lang: z.string().optional().describe("Two-letter ISO language code for result preference (e.g. en, de, ja)")
-});
-z.object({
-  query: z.string().describe(`${STANDALONE_QUERY_DESCRIPTION} Add the video type (e.g. review, trailer, tutorial, gameplay).`),
-  count: z.number().optional().describe("Number of results (max 100)"),
-  recency: z.enum(["day", "week", "month", "year"]).optional().describe(RECENCY_DESCRIPTION),
-  lang: z.string().optional().describe("Two-letter ISO language code for result preference (e.g. en, de, ja)")
-});
-
 // src/tools/helpers/localized-query-suffix.helper.ts
 function localizedQuerySuffix(lang) {
   if (!lang) return "";
@@ -1814,111 +1129,6 @@ function localizedQuerySuffix(lang) {
     return "";
   }
 }
-z.object({
-  query: z.string().describe(STANDALONE_QUERY_DESCRIPTION),
-  recency: z.enum(["day", "week", "month", "year"]).optional().describe(RECENCY_DESCRIPTION),
-  lang: z.string().optional().describe("Two-letter ISO language code for result preference (e.g. en, de, ja)")
-});
-z.object({
-  url: z.string().describe("The URL to fetch and render")
-});
-z.object({});
-z.object({});
-z.object({
-  text: z.string().min(1).max(2e3).describe(
-    'The derived insight to store, as one self-contained third-person sentence, e.g. "The user prefers single-line if statements".'
-  ),
-  path: z.string().min(1).max(200).optional().describe(
-    'Optional profile facet this insight deepens, e.g. "likes.cars" \u2014 only when it deepens a stored profile value.'
-  )
-});
-z.object({
-  text: z.string().min(3).max(2e3).describe(
-    "The exact stored statement to delete, quoted verbatim from a memory-partition-recall result. Record texts are the record identity \u2014 no ids needed. Never paraphrase: recall first, then delete the exact text."
-  )
-});
-z.object({
-  query: z.string().min(1).max(1e3).describe('What to recall as a natural-language question, e.g. "What is Sams phone number?"'),
-  tags: z.array(z.string().min(1).max(40)).max(8).optional().describe('Restrict to records tagged with ANY of these topics, e.g. ["work"].'),
-  contains: z.string().max(200).optional().describe('Restrict to records whose text contains this exact phrase, e.g. "phone number".'),
-  topK: z.number().int().min(1).max(10).optional().describe("Maximum number of results to return (default 5).")
-});
-z.object({
-  text: z.string().min(1).max(2e3).describe('The fact to remember, as a self-contained statement, e.g. "Sams phone number is 555-1234".'),
-  category: z.string().min(1).max(40).optional().describe(
-    'One broad lowercase PLURAL category the fact belongs to, e.g. "stocks", "games", "pets", "work" \u2014 a family noun, never a specific entity/product/company/game name ("amd" \u2192 "stocks"; "stellar blade" \u2192 "games"). Always include it.'
-  ),
-  tags: z.array(z.string().min(1).max(40)).max(8).optional().describe(
-    'Optional topic labels (lowercase, reusable, NARROW \u2014 entity/product/game names) so future recall can filter by topic, e.g. ["contacts", "sam"], ["amd"], ["stellar blade"].'
-  )
-});
-z.object({
-  query: z.string().optional().describe(
-    "The exact business or place name, ideally with its location, named explicitly and resolved from the conversation. Used when neither placeId nor cid is known."
-  ),
-  placeId: z.string().optional().describe("Google Place ID of the business. Most precise identifier \u2014 prefer it when available."),
-  cid: z.string().optional().describe("Google CID of the business, e.g. from a places search result."),
-  lang: z.string().optional().describe("Two-letter ISO language code for result preference (e.g. en, de, ja)")
-});
-z.object({
-  query: z.string().describe(`${STANDALONE_QUERY_DESCRIPTION} Add short visual qualifiers describing the subject.`),
-  count: z.number().optional().describe("Number of results (max 100)"),
-  minWidth: z.number().optional().describe(
-    "Minimum image width in pixels. Use 1920 when the user wants 1080p-quality images, 2560 for 1440p, 3840 for 4K. The tool always enforces a floor of 1280 (720p)."
-  ),
-  minHeight: z.number().optional().describe(
-    "Minimum image height in pixels. Use 1080 when the user wants 1080p-quality images, 1440 for 1440p, 2160 for 4K. The tool always enforces a floor of 720 (720p)."
-  ),
-  lang: z.string().optional().describe("Two-letter ISO language code for result preference (e.g. en, de, ja)"),
-  recency: z.enum(["day", "week", "month", "year"]).optional().describe(RECENCY_DESCRIPTION)
-});
-z.object({
-  query: z.string().describe(`${STANDALONE_QUERY_DESCRIPTION} Include the newsworthy angle (announcement, release, event, update).`),
-  count: z.number().optional().describe("Number of results (max 100)"),
-  recency: z.enum(["day", "week", "month", "year"]).optional().describe(RECENCY_DESCRIPTION),
-  lang: z.string().optional().describe("Two-letter ISO language code for result preference (e.g. en, de, ja)")
-});
-z.object({
-  query: z.string().describe(
-    'A standalone places search query that explicitly names the business or business type plus location (e.g. "MediaMarkt Berlin", "coffee shops in Munich") \u2014 resolve the subject from the conversation; never copy the user message verbatim.'
-  ),
-  count: z.number().optional().describe("Number of results (max 100)"),
-  lang: z.string().optional().describe("Two-letter ISO language code for result preference (e.g. en, de, ja)")
-});
-z.object({
-  query: z.string().describe(
-    'The exact product name with model number, kept short and standalone \u2014 resolve product references from the conversation (e.g. "the headphones we discussed" becomes "Sony WH-1000XM5"). No extra words like "buy", "price", or "review".'
-  ),
-  count: z.number().optional().describe("Number of results (max 100)"),
-  lang: z.string().optional().describe("Two-letter ISO language code for result preference (e.g. en, de, ja)")
-});
-z.object({
-  query: z.string().describe(
-    `${STANDALONE_QUERY_DESCRIPTION} Add the video type (e.g. review, trailer, tutorial, gameplay). When the conversation language is not English, phrase the descriptive words in that language and append the language's own name (e.g. "Review Deutsch") to pull localized results.`
-  ),
-  count: z.number().optional().describe("Number of results (max 100)"),
-  recency: z.enum(["day", "week", "month", "year"]).optional().describe(RECENCY_DESCRIPTION),
-  lang: z.string().optional().describe("Two-letter ISO language code for result preference (e.g. en, de, ja)")
-});
-z.object({
-  query: z.string().describe(STANDALONE_QUERY_DESCRIPTION),
-  recency: z.enum(["day", "week", "month", "year"]).optional().describe(RECENCY_DESCRIPTION),
-  lang: z.string().optional().describe("Two-letter ISO language code for result preference (e.g. en, de, ja)")
-});
-z.object({
-  url: z.string().describe("The URL to fetch and render")
-});
-z.object({
-  url: z.string().describe("The URL to fetch content from")
-});
-z.object({
-  query: z.string().describe(`${STANDALONE_QUERY_DESCRIPTION} Add the video type (e.g. review, trailer, tutorial, gameplay).`),
-  count: z.number().optional().describe("Number of results (max 50)"),
-  recency: z.enum(["day", "week", "month", "year"]).optional().describe(
-    "Restrict results to the given past period (day=24 hours, week=7 days, month=1 month, year=1 year). Use for fresh content such as news, recent releases, or trending topics; leave unset for evergreen, historical, or general queries."
-  ),
-  lang: z.string().optional().describe("Two-letter ISO language code for result preference (e.g. en, de, ja)")
-});
 
 // src/prompts/harness/execute/execute-language.helper.ts
 function buildExecuteLanguageInstruction(language, options) {
@@ -2057,6 +1267,112 @@ FINAL REMINDER:
 - Every query names its subject explicitly; never pass the user message verbatim as a query.`;
 }
 
+// src/schemas/helpers/tools/tool-registry.constants.ts
+var VARIANT_NAMES = ["grayscale", "denoised", "sharpened", "clahe"];
+var TOOL_DESCRIPTIONS = {
+  brightDataWebSearch: "Search the web using Bright Data SERP API (Google). Returns organic results with titles, snippets, and links. Supports an optional recency window (day/week/month/year) for fresh results.",
+  brightDataImageSearch: "Search for images using Bright Data SERP API (Google Images). Returns image URLs, source pages, and dimensions. Enforces a minimum of 1280\xD7720 (720p).",
+  brightDataNewsSearch: "Search latest news using Bright Data SERP API. Returns headlines, sources, dates, and snippets. Supports an optional recency window (day/week/month/year).",
+  brightDataPlacesSearch: "Search places and businesses using Bright Data SERP API (Google Maps). Returns addresses, phone numbers, ratings, review counts, and coordinates. Query with a business name or business type plus location.",
+  brightDataShoppingSearch: "Search for products using Bright Data SERP API (Google Shopping). Returns prices, sellers, images, and ratings. Query with the bare product name and model number.",
+  brightDataVideoSearch: `Search for videos using Bright Data SERP API. Returns titles, links, channel names, duration, and publish dates. Supports an optional recency window (day/week/month/year) for fresh results. ${EMBEDDABLE_VIDEO_PROVIDER_CLAUSE}`,
+  brightDataWebpageScrape: "Fetch and render a full webpage using Bright Data Web Unlocker API. Returns clean Markdown text. Use for pages behind anti-bot protection that plain fetch cannot reach.",
+  serperWebSearch: "Search the web using Serper.dev (Google). Returns organic results with titles, snippets, and links. Supports an optional recency window (day/week/month/year) for fresh results.",
+  serperImageSearch: "Search for images using Serper.dev (Google Images). Prefers 2560\xD71440 (1440p) images and enforces a minimum of 1280\xD7720 (720p) via the Google Images tbs size filter and a client-side dimension filter. Supports an optional recency window (day/week/month/year).",
+  serperNewsSearch: "Search latest news using Serper.dev. Returns headlines, sources, dates, and snippets. Supports an optional recency window (day/week/month/year).",
+  serperPlacesSearch: "Search places and businesses using Serper.dev (Google Maps). Returns addresses, phone numbers, ratings, review counts, and coordinates. Query with a business name or business type plus location.",
+  serperShoppingSearch: "Search for products using Serper.dev (Google Shopping). Returns prices, sellers, delivery info, images, and per-offer ratings. Query with the bare product name and model number.",
+  serperBusinessReviewsSearch: "Fetch Google Maps reviews for a specific business or place using Serper.dev. Returns reviewer snippets with author names, star ratings, and dates. Use for seller/business reputation, not editorial product reviews.",
+  serperVideoSearch: `Search for videos using Serper.dev. Returns titles, links, channel names, duration, and publish dates. Supports an optional recency window (day/week/month/year) for fresh results. ${EMBEDDABLE_VIDEO_PROVIDER_CLAUSE}`,
+  serperWebpageScrape: "Fetch and render a full webpage using Serper.dev scrape API. Returns clean rendered text with its title.",
+  youtubeVideoSearch: "Search YouTube using the official YouTube Data API. Returns titles, links, channel names, durations, view counts, upload dates, and direct thumbnails. All results are embeddable YouTube videos.",
+  eodhdSearch: 'Resolve a company, ETF, or index name to an EODHD ticker code (e.g. "Nvidia" \u2192 NVDA.US). Use before fetching quotes, history, technicals, or news for a named entity.',
+  eodhdQuote: "Fetch the current (delayed) quote for one or more EODHD tickers \u2014 last price, change, change %, open/high/low, volume, previous close.",
+  eodhdHistory: "Fetch end-of-day OHLCV price history for an EODHD ticker. Returns a compact summary plus the full time series as chartData for the client chart. Use for the time-value chart and buy/sell pressure (volume).",
+  eodhdTechnical: "Fetch a technical indicator series (RSI, MACD, ADX, SMA, EMA, BBANDS, ATR, \u2026) for an EODHD ticker. Use to gauge buy/sell pressure and momentum.",
+  eodhdIntraday: "Fetch intraday OHLCV bars for an EODHD ticker and return a per-day, per-price-band volume profile as chartData for the client heatmap. Use to render a volume heatmap across fixed price bands.",
+  eodhdNews: "Fetch recent financial news for an EODHD ticker \u2014 headlines, links, sources, publish dates. Use to ground a stock-market answer in what is happening around a company.",
+  eodhdFundamentals: "Fetch company fundamentals for an EODHD ticker \u2014 general info, valuation, and key financial highlights (sector, market cap, P/E, revenue, margins).",
+  webFetch: "Fetch the full content of a specific URL (e.g. a search result page) as clean Markdown. Prefer fetching the most relevant search results to ground the answer in full source text rather than relying on snippets alone.",
+  browser_navigate: "Control a real browser: navigate to a URL. Use for interactive browsing \u2014 JS-heavy pages, content behind clicks, tabs, scrolling, or forms \u2014 that static search/fetch cannot reach. Follow up with browser_snapshot to read the page before acting on it.",
+  browser_navigate_back: "Go back to the previous page in the browser history.",
+  browser_snapshot: "Read the current browser page as an accessibility snapshot (structured text with element refs). The primary way to see page content and obtain the refs that browser_click/browser_type need.",
+  browser_click: "Click an element in the browser, referenced by a ref from browser_snapshot.",
+  browser_type: "Type text into an editable browser element, referenced by a ref from browser_snapshot, optionally submitting with Enter.",
+  browser_fill_form: "Fill multiple form fields in the browser in one call.",
+  browser_select_option: "Select an option in a dropdown in the browser.",
+  browser_press_key: "Press a keyboard key in the browser (Enter, Tab, arrows).",
+  browser_wait_for: "Wait for text to appear or disappear, or for a time period, in the browser.",
+  browser_take_screenshot: "Take a screenshot of the current browser page or a specific element.",
+  browser_tabs: "List, create, close, or switch browser tabs.",
+  browser_console_messages: "Get console messages from the browser. Use to diagnose JavaScript errors on a page (e.g. when testing a web app).",
+  browser_network_requests: "List network requests the browser made since page load. Use to diagnose failed or slow requests (e.g. when testing a web app).",
+  browser_verify_element_visible: "Assert that an element is visible on the current browser page.",
+  browser_verify_text_visible: "Assert that text is visible on the current browser page.",
+  requestGrayscale: "Request a grayscale version of the images. Use when color noise or color information is irrelevant, for example when reading text or analyzing shapes.",
+  requestDenoised: "Request a denoised (blurred) version of the images. Use when the original has noise, grain, or artifacts that hide details.",
+  requestSharpened: "Request a sharpened version of the images. Use when edges or fine details are blurry.",
+  requestClahe: "Request a CLAHE (contrast-enhanced) version of the images. Use when details are hidden in shadows or highlights.",
+  "memory-partition-remember": `Store into the user's fact partition (memory-partition): notable facts about subjects they care about (favorites, interests, projects, followed stocks, people, past topics), preferences and durable details they state, and anything they explicitly ask you to remember. Storing gathered knowledge and noticed preferences is expected \u2014 do not wait for an explicit "remember" instruction.`,
+  "memory-partition-recall": "Retrieve from the user's fact partition (memory-partition) \u2014 things they told you in past conversations or asked you to remember. These are trusted user statements, not public facts; attribute them to the user and prefer them over web results for anything personal. Check this tool whenever a request touches a subject this user has cared about before.",
+  "memory-partition-delete": "Delete one exact fact record from the user's fact partition (memory-partition), quoted verbatim from a memory-partition-recall result. Never delete on a guess: recall first, delete the verbatim statement. Needs memory-partition-recall alongside it.",
+  "memory-cognition-remember": "Store one derived insight into your cognition space (memory-cognition) \u2014 your own understanding of the user (inferred traits, standing interests, working nuances, connections between facts). Use for what you LEARN about the user, not what they stated; stated facts belong in memory-partition-remember.",
+  "memory-cognition-forget": "Wipe your entire cognition space (memory-cognition) of the user \u2014 the structured profile AND every derived insight \u2014 only when the user asks you to forget your learned understanding of them or to start over. Fact records in the partition are untouched."
+};
+var BROWSER_TOOL_NAMES = [
+  "browser_navigate",
+  "browser_navigate_back",
+  "browser_snapshot",
+  "browser_click",
+  "browser_type",
+  "browser_fill_form",
+  "browser_select_option",
+  "browser_press_key",
+  "browser_wait_for",
+  "browser_take_screenshot",
+  "browser_tabs",
+  "browser_console_messages",
+  "browser_network_requests",
+  "browser_verify_element_visible",
+  "browser_verify_text_visible"
+];
+var TOOL_NAMES = [
+  "webFetch",
+  "brightDataWebSearch",
+  "brightDataImageSearch",
+  "brightDataNewsSearch",
+  "brightDataPlacesSearch",
+  "brightDataShoppingSearch",
+  "brightDataVideoSearch",
+  "brightDataWebpageScrape",
+  "serperWebSearch",
+  "serperImageSearch",
+  "serperNewsSearch",
+  "serperPlacesSearch",
+  "serperShoppingSearch",
+  "serperBusinessReviewsSearch",
+  "serperVideoSearch",
+  "serperWebpageScrape",
+  "youtubeVideoSearch",
+  "eodhdSearch",
+  "eodhdQuote",
+  "eodhdHistory",
+  "eodhdTechnical",
+  "eodhdIntraday",
+  "eodhdNews",
+  "eodhdFundamentals",
+  "requestGrayscale",
+  "requestDenoised",
+  "requestSharpened",
+  "requestClahe",
+  "memory-partition-remember",
+  "memory-partition-recall",
+  "memory-partition-delete",
+  "memory-cognition-remember",
+  "memory-cognition-forget",
+  ...BROWSER_TOOL_NAMES
+];
+
 // src/prompts/harness/helpers/tool-catalog.helper.ts
 function formatToolAvailabilityCatalog(enabledToolNames) {
   const enabledSet = new Set(enabledToolNames);
@@ -2068,6 +1384,64 @@ function formatToolAvailabilityCatalog(enabledToolNames) {
   }
   return lines;
 }
+var DEFAULT_VARIANT_ID = "default";
+var TEMPLATES = [
+  "article",
+  "news",
+  "describe",
+  "compare",
+  "ocr",
+  "summary",
+  "evaluation",
+  "product",
+  "shoplist",
+  "imagelist",
+  "videolist",
+  "stockmarketitem",
+  "stockmarketlist",
+  "merge",
+  "text"
+];
+var ImagePlanSchema = z.object({
+  resize: z.boolean().default(true).describe(
+    "Whether to resize the original images before sending them to the response model. Default true when images are present."
+  ),
+  variants: z.array(z.enum(VARIANT_NAMES)).default([]).describe(
+    "Optional preprocessing variants to generate for the images (grayscale, denoised, sharpened, clahe). Only use when they would materially improve analysis."
+  )
+});
+var IntentSchema = z.object({
+  template: z.enum(TEMPLATES).describe(
+    'Template name: "article" (in-depth research/report \u2014 extensive long-form composed from available snippets), "news" (current events \u2014 a compact brief composed from available snippets), "describe" (single/multi image description), "compare" (compare uploaded images only \u2014 information comparisons use "evaluation"), "ocr" (extract text from images), "summary" (recap prior conversation or topic without new images), "evaluation" (critique/assess something from the conversation), "product" (product details with shop offers and prices), "shoplist" (compact product/shop list for follow-up shopping questions about an already-introduced product), "imagelist" (a pure collection of images about a topic, no article), "videolist" (a pure list/playlist of videos about a topic, no article), "stockmarketitem" (a single stock/ETF/index with price chart, technicals, news, and a recommendation), "stockmarketlist" (a selection of stocks/indices with a market overview), "text" (free chat).'
+  ),
+  prompt: z.string().default(DEFAULT_VARIANT_ID).describe(
+    'Selected prompt variant for the template. Use "default" unless the user explicitly asks for a specific style.'
+  ),
+  tools: z.array(z.enum(TOOL_NAMES)).describe("List of tool names the model decided to invoke."),
+  getDate: z.boolean().default(true).describe(
+    'Whether search queries should be anchored on the current date so results bias toward recent information. Default true. Set to false ONLY for timeless general-knowledge, historical, or conceptual requests where recency does not matter (e.g. "how does photosynthesis work", "history of the Roman Empire", "explain quantum entanglement", creative writing).'
+  ),
+  imageCount: z.preprocess((val) => val === null ? 0 : val, z.number().int().min(0).max(50).default(0)).describe(
+    `Number of images to retrieve when an imageSearch tool is selected. Only set when the user explicitly requests a specific number; otherwise omit or set to 0 and the system will default to ${DEFAULT_MEDIA_COUNT}.`
+  ),
+  videoCount: z.preprocess((val) => val === null ? 0 : val, z.number().int().min(0).max(50).default(0)).describe(
+    `Number of videos to retrieve when a videoSearch tool is selected. Only set when the user explicitly requests a specific number; otherwise omit or set to 0 and the system will default to ${DEFAULT_MEDIA_COUNT}.`
+  ),
+  reasoning: z.string().describe("Short explanation of why this template, prompt, and these tools were chosen."),
+  contextSummary: z.string().default("").describe(
+    "Query-focused extraction of the prior conversation context that the latest user message references or depends on: established topics/entities, key facts from prior answers the follow-up builds on, user constraints, and \u2014 for imagelist/videolist follow-ups \u2014 the previously shown image/video URLs verbatim. Empty if there is no relevant prior context."
+  ),
+  needsClarification: z.boolean().default(false).describe("When true, the request is too ambiguous to classify \u2014 set this instead of picking template/tools."),
+  clarificationQuestion: z.string().nullable().optional().describe(
+    "Concise, human-friendly question to ask the user when needsClarification is true. Ask what the user might have meant and offer the most likely interpretations as options. Do not hardcode wording; adapt tone and language to the user."
+  ),
+  language: z.string().nullable().optional().describe(
+    "Two-letter ISO language code of the latest user message (e.g. 'en', 'de', 'ja', 'es'). Detect from the user's text."
+  ),
+  plan: z.object({
+    images: ImagePlanSchema.optional().describe("Image processing plan. Only present when images are attached.")
+  }).default({}).describe("Execution plan for the response step.")
+});
 
 // src/prompts/instructions/compare.instruction.ts
 var COMPARE_VERIFICATION_RULE = `When imageSearch tools ran, availableImages holds cloud reference candidates as search-result DATA (titles, snippets, page sources) \u2014 their pixels are never attached to you. Pick a candidate ONLY when its search result corroborates the subject you identified in the uploaded image(s) (a named entity, visible text, a brand, a character, an authoritative source). galleryItems MUST contain ONLY the picked candidates \u2014 NEVER the uploaded user image(s), which are already visible to the user as attachments; every unpicked candidate belongs in discardedReferences with { "type": "image", imageUrl, title, reason } and a one-line reason (e.g. "result covers a different game"). Retrieved links that failed to corroborate the match MAY be listed with { "type": "link", url, title, reason }.`;
@@ -3447,6 +2821,42 @@ FINAL REMINDER:
 function buildCorrectionPrompt(error, template, options) {
   return correctionTemplate(error, template, options?.finalAttempt);
 }
+var INDENT = "  ";
+function formatZodShape(schema, options = {}) {
+  const jsonSchema = z.toJSONSchema(schema);
+  return renderNode(jsonSchema, 0, options);
+}
+function renderNode(node, depth, options) {
+  if (node.type === "object" && node.properties) return renderObject(node, depth, options);
+  if (node.type === "object" && node.additionalProperties) {
+    return `{ [key]: ${renderNode(node.additionalProperties, depth, options)} }`;
+  }
+  if (node.type === "array" && node.items) return `[${renderNode(node.items, depth, options)}]`;
+  const anyOfBranches = node.anyOf?.filter((branch) => branch.type !== "null");
+  if (anyOfBranches?.length) return anyOfBranches.map((branch) => renderNode(branch, depth, options)).join(" | ");
+  if (node.enum) return node.enum.map((value) => JSON.stringify(value)).join(" | ");
+  if (node.type === "integer" || node.type === "number") return "number";
+  if (node.type === "boolean") return "boolean";
+  if (node.type === "string") return "string";
+  if (node.type === "null") return "null";
+  return "unknown";
+}
+function renderObject(node, depth, options) {
+  const properties = node.properties ?? {};
+  const required = new Set(node.required ?? []);
+  const entries = Object.entries(properties);
+  if (entries.length === 0) return "{}";
+  const pad = INDENT.repeat(depth);
+  const innerPad = INDENT.repeat(depth + 1);
+  const lines = entries.map(([key, value]) => {
+    const optional = required.has(key) ? "" : "?";
+    const hint = options.overrides?.[key] ?? renderNode(value, depth + 1, options);
+    return `${innerPad}${JSON.stringify(key)}${optional}: ${hint}`;
+  });
+  return `{
+${lines.join(",\n")}
+${pad}}`;
+}
 
 // src/prompts/helpers/build-structured-prompt.helper.ts
 function buildStructuredPrompt(schema, template, options) {
@@ -3565,6 +2975,20 @@ function buildConvictionSynthesisPrompt(evidence) {
   }
   return lines.join("\n");
 }
+var EncyclopediaClassifySchema = z.object({
+  /**
+   * One broad lowercase PLURAL family label for the document (e.g. `games`,
+   * `work`, `health`) — the constellation's cluster tier. Never a specific
+   * entity, product, company, or title.
+   */
+  category: z.string(),
+  /**
+   * The narrow topic the document is about (e.g. `wuthering waves`,
+   * `q3 budget`) — the constellation's cluster tier. A short, specific,
+   * reusable label, not a sentence and not a URL.
+   */
+  topic: z.string()
+});
 
 // src/prompts/memory/vocabulary-section.helper.ts
 function buildVocabularySection(knownCategories = [], knownTags = []) {
@@ -3656,6 +3080,14 @@ function buildFrictionPrompt(input) {
   }
   return lines.join("\n");
 }
+var MemoryClusterSummarySchema = z.object({
+  title: z.string().describe('A short noun-phrase label for the cluster (2\u20136 words), e.g. "gaming preferences" or "work projects".'),
+  summary: z.string().describe(
+    "One or two sentences summarizing what this cluster of memories is about \u2014 the shared theme, the key facts, and how they relate."
+  )
+});
+
+// src/prompts/memory/memory-cluster-prompt.constant.ts
 var MEMORY_CLUSTER_INSTRUCTIONS = buildStructuredPrompt(MemoryClusterSummarySchema, {
   before: `MEMORY CLUSTER SUMMARY \u2014 one purpose: write a short title + summary for ONE cluster of related memory records, so the cluster can be recalled as a whole without reading every member.
 
@@ -3681,6 +3113,12 @@ ${limitText(members, params.maxPayloadChars)}`,
     "Write the title + summary JSON object now."
   ].join("\n\n");
 }
+var ConsolidationVerdictSchema = z.object({
+  verdict: z.enum(["keep", "redundant", "merge"]).describe(
+    "keep = the new fact adds information not covered by the candidates; redundant = fully covered already (same claim, no new detail, same polarity); merge = it refines/corrects/completes a candidate and mergedText carries the fuller statement."
+  ),
+  mergedText: z.string().optional().describe("Required with verdict=merge: one fuller self-contained statement (full restatement, never a diff).")
+});
 
 // src/prompts/memory/memory-consolidate-prompt.constant.ts
 var MEMORY_CONSOLIDATE_INSTRUCTIONS = buildStructuredPrompt(ConsolidationVerdictSchema, {
@@ -3716,6 +3154,13 @@ ${candidates}`,
     "Decide exactly one verdict (keep / redundant / merge) and output ONLY the JSON object."
   ].join("\n\n");
 }
+var MemoryEnrichmentSchema = z.object({
+  /**
+   * 2–6 stable, reusable lowercase topic labels for the record — the existing
+   * tags kept plus any missing labels that would help topic-filtered recall.
+   */
+  tags: z.array(z.string())
+});
 
 // src/prompts/memory/memory-enrich-prompt.constant.ts
 function buildEnrichPrompt() {
@@ -3737,6 +3182,89 @@ FINAL REMINDER:
 - Output ONLY valid JSON matching the exact schema above. No markdown code fences, no explanations, preamble, or postscript.`
   });
 }
+var nullishText = z.string().nullish();
+var nullishTopics = z.array(z.string()).nullish();
+var memoryCognitionProfileSchema = z.object({
+  /** The user's name or preferred handle, when known. */
+  name: nullishText,
+  /** Primary conversation language (BCP-47-ish, e.g. "en", "de"). */
+  language: nullishText,
+  /** Coarse location the user works from (IANA name or city), when known. */
+  timezone: nullishText,
+  /** Demonstrated skills and domains (e.g. ["TypeScript", "NestJS"]). */
+  expertise: nullishTopics,
+  /** Active goals and aspirations — the most durable cognition there is. */
+  goals: nullishTopics,
+  /** How the user wants to be answered. */
+  communication: z.object({
+    style: nullishText,
+    detailLevel: nullishText,
+    formality: nullishText
+  }).nullish(),
+  /** Tooling / environment / format preferences (free-form key-value). */
+  preferences: z.record(z.string(), z.string()).nullish(),
+  likes: nullishTopics,
+  dislikes: nullishTopics,
+  /** Topics the user keeps returning to. */
+  interests: nullishTopics,
+  /**
+   * Durable CONVICTIONS the AI synthesized about the user's world — the
+   * routing-map topics of its conviction records (depth lives in the
+   * conviction points at paths `convictions.<slug>`). Convictions are the
+   * AI's own derived conclusions, never statements the user made.
+   */
+  convictions: nullishTopics,
+  /** The AI's own identity as the user has shaped it (name, role, voice). */
+  persona: z.object({
+    /** The name the user gave the AI. */
+    name: nullishText,
+    /** The role the user assigned the AI (e.g. "coding assistant"). */
+    role: nullishText,
+    /** Short character description the user gave the AI. */
+    personality: nullishText,
+    /** How the AI introduces itself, when the user set one. */
+    greeting: nullishText,
+    /** How the AI should speak. */
+    voice: z.object({
+      tone: nullishText,
+      formality: nullishText
+    }).nullish()
+  }).nullish(),
+  /**
+   * Learned corrections — behavioral rules the user taught the AI after it
+   * got something wrong. Keyed by a short slug (a stable handle for
+   * update/remove); the value is the imperative directive ("always …" /
+   * "never …"), optionally with a brief why. Deep-merged like preferences.
+   */
+  corrections: z.record(z.string(), z.string()).nullish()
+});
+var memoryProfileInsightSchema = z.object({
+  text: z.string(),
+  path: z.string().optional()
+});
+var memoryProfileResponseSchema = z.preprocess(
+  (value) => {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) return value;
+    const record = value;
+    if (record.insights == null) record.insights = [];
+    else if (Array.isArray(record.insights)) {
+      record.insights = record.insights.map((item) => typeof item === "string" ? { text: item } : item);
+    }
+    return record;
+  },
+  z.object({
+    profile: memoryCognitionProfileSchema.nullish(),
+    insights: z.array(memoryProfileInsightSchema).max(8),
+    /**
+     * One sentence recording what THIS turn was about — the short-term
+     * conversation memory (episode), recalled later by recency-blended probe.
+     * Omitted (or null) when the turn had no substance.
+     */
+    episode: z.string().nullish()
+  })
+);
+
+// src/prompts/memory/memory-profile-prompt.constant.ts
 var MEMORY_PROFILE_INSTRUCTIONS = buildStructuredPrompt(memoryProfileResponseSchema, {
   before: `COGNITION JOB \u2014 maintain YOUR evolving understanding of THIS user.
 
@@ -3860,6 +3388,66 @@ function buildMemoryWritePrompt(params) {
   ].filter(Boolean).join("\n\n");
 }
 var MEMORY_WRITE_VERDICT = 'Decide: store each durable user-specific fact with one memory-partition-remember call, each derived understanding with one memory-cognition-remember call, or answer "none" if the turn surfaced nothing durable about this user.';
+var FACT_KINDS = [
+  "preference",
+  "decision",
+  "state",
+  "contact",
+  "project",
+  "possession",
+  "relationship",
+  "fact"
+];
+var FACT_STABILITIES = ["durable", "volatile"];
+var ExtractedFactSchema = z.object({
+  /**
+   * The self-contained durable statement — third person, subject up front,
+   * no "this"/"that" references.
+   */
+  text: z.string(),
+  /**
+   * The lowercase entity the fact is about (default `user`; a person,
+   * product, or project name). Maintenance adjudication only ever compares
+   * facts about the SAME subject.
+   */
+  subject: z.string().optional(),
+  /**
+   * One broad lowercase PLURAL family label for THIS fact (e.g. `stocks`,
+   * `pets`, `games`) — inherits the turn-side category when omitted. Never
+   * a specific entity, product, company, or game title.
+   */
+  category: z.string().optional(),
+  /** What kind of durable thing this is (see FACT_KINDS). */
+  kind: z.enum(FACT_KINDS),
+  /** Whether a newer statement is expected to replace this one (see FACT_STABILITIES). */
+  stability: z.enum(FACT_STABILITIES)
+});
+var ExtractionSchema = z.object({
+  /**
+   * Durable, self-contained facts worth remembering in a later, unrelated
+   * conversation (preferences, decisions, contact details, project facts),
+   * each carrying its maintenance metadata (subject, category, kind,
+   * stability). Empty when nothing in the text is worth remembering.
+   */
+  facts: z.array(ExtractedFactSchema),
+  /**
+   * 2–6 stable, reusable lowercase topic labels describing the text; the open
+   * vocabulary that powers topic-filtered recall. Tags are NARROW and
+   * specific — entity names, product names, game titles (e.g. `amd`,
+   * `stellar blade`, `stellar blade blood rain`).
+   */
+  tags: z.array(z.string()),
+  /**
+   * One broad lowercase PLURAL family label for the whole turn-side (e.g.
+   * `stocks`, `pets`, `games`) — groups the narrow tags into one topic family
+   * for the constellation's community tier and the relink job's per-category
+   * passes, and backstops facts that omit their own `category`. Never a
+   * specific entity, product, company, or game title: `amd` belongs under
+   * `stocks`; `stellar blade` belongs under `games`. Optional: a turn with
+   * nothing durable may omit it.
+   */
+  category: z.string().optional()
+});
 
 // src/prompts/memory/vectorize-prompt.constant.ts
 function buildExtractionPrompt(knownCategories = [], knownTags = []) {