@triplef/agent 0.1.16 → 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,841 +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 ExtractionSchema = z.object({
-  /**
-   * Durable, self-contained facts worth remembering in a later, unrelated
-   * conversation (preferences, decisions, contact details, project facts).
-   * Empty when nothing in the text is worth remembering.
-   */
-  facts: z.array(z.string()),
-  /**
-   * 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. 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
@@ -1006,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.
@@ -1134,13 +301,157 @@ var TOOL_RESULTS_RULES = `TOOL RESULTS
 - If a tool returns nothing, leave the corresponding fields empty.
 - Never invent missing information.`;
 
-// src/prompts/snippets/helpers/compose-snippet-keys.helper.ts
-function composeSnippetKeys(preset) {
-  const requiredKeys = ["layout", ...preset.spineKeys];
-  const required = new Set(requiredKeys);
-  const optionalKeys = preset.snippets.flatMap((snippet) => Object.keys(snippet.fields)).filter((key) => !required.has(key));
-  return { requiredKeys, optionalKeys };
+// src/prompts/snippets/helpers/compose-snippet-keys.helper.ts
+function composeSnippetKeys(preset) {
+  const requiredKeys = ["layout", ...preset.spineKeys];
+  const required = new Set(requiredKeys);
+  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);
 
@@ -1174,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(),
@@ -1192,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(),
@@ -1229,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:
@@ -1248,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()
@@ -1264,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()
@@ -1603,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()
@@ -1721,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 "";
@@ -1778,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) {
@@ -2021,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);
@@ -2032,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 }.`;
@@ -3411,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) {
@@ -3478,42 +2924,71 @@ Ensure the "language" field is present and has the correct value.
 FINAL REMINDER:
 - Return ONLY a single valid JSON object with all required keys, including "language". No markdown code fences, no explanations, no extra text.`;
 
-// src/prompts/memory/belief-synthesis-prompt.constant.ts
-var BELIEF_INSTRUCTIONS = `You synthesize higher-level beliefs from a user's memory facts.
+// src/prompts/memory/format-fact-metadata.helper.ts
+function formatFactMetadata(fact) {
+  const parts = [
+    fact.subject ? `subject: ${fact.subject}` : "",
+    fact.category ? `category: ${fact.category}` : "",
+    fact.kind ? `kind: ${fact.kind}` : "",
+    fact.stability ? `stability: ${fact.stability}` : ""
+  ].filter(Boolean);
+  return parts.length ? ` (${parts.join("; ")})` : "";
+}
+
+// src/prompts/memory/conviction-synthesis-prompt.constant.ts
+var CONVICTION_INSTRUCTIONS = `You synthesize higher-level convictions and bridges from a user's memory facts.
 
-Given a numbered list of EVIDENCE (facts the user stated or asked to remember), synthesize durable, higher-level beliefs \u2014 conclusions that are true of the evidence but not merely restated from it. Every belief picks its lane ("target"), and the choice is PURPOSE-based, never cosmetic:
+Given a numbered list of EVIDENCE (facts the user stated or asked to remember), synthesize durable, higher-level statements \u2014 conclusions that are true of the evidence but not merely restated from it. Every statement picks its lane ("target"), and the choice is PURPOSE-based, never cosmetic:
 
 - "conviction" \u2014 a durable conclusion about THE USER (or your own working relationship with them): a pattern in their behavior, a standing judgment the facts support, a trait or tendency you now hold true. Convictions deepen your understanding of the user and yourself; they are YOURS, never statements the user made. ("the user bought a dog" + "the user keeps comparing dog food brands" + "the user researches every purchase for days" \u2192 conviction: "the user is a deliberate, research-first buyer")
 - "bridge" \u2014 a synthesized claim that CLOSES A GAP between facts: without it, two stored facts look unrelated; with it, they form one coherent story about the user's world. Bridges are the connective tissue of the fact graph. ("the user bought dog food X" + "the user's dog refuses to eat" \u2192 bridge: "the dog refuses the brand-X food the user bought")
 
-A belief is a synthesis, not a restatement:
+A synthesized statement is a synthesis, not a restatement:
 - combine multiple facts into one conclusion ("learning Rust" + "rewriting the payments service" \u2192 "the user is migrating the payments service to Rust")
-- a belief MUST cite the evidence indices that support it (the [n] numbers)
+- every statement MUST cite the evidence indices that support it (the [n] numbers)
 - never invent facts not present in the evidence
-- never restate a single evidence item verbatim as a belief \u2014 that is not synthesis
-- a belief with no supporting evidence is invalid \u2014 omit it
-- when neither a conviction nor a bridge clearly fits, emit nothing for it \u2014 a forced target blurs the lanes and is worse than no belief
+- never restate a single evidence item verbatim \u2014 that is not synthesis
+- a statement with no supporting evidence is invalid \u2014 omit it
+- when neither a conviction nor a bridge clearly fits, emit nothing for it \u2014 a forced target blurs the lanes and is worse than no statement
+
+EVIDENCE METADATA \u2014 each line may show "(subject: \u2026; category: \u2026; kind: \u2026; stability: \u2026)":
+- subject groups the evidence lines about one entity \u2014 convictions about a subject cite that subject's lines
+- durable evidence carries more weight for a conviction; a volatile state alone rarely supports a durable conclusion
+- kind sharpens conclusions: a pattern of "preference" evidence supports a taste conclusion; "decision" evidence supports a commitment conclusion
 
 Respond with JSON only:
 {
-  "beliefs": [
+  "convictions": [
     { "text": "one self-contained sentence", "target": "conviction", "evidence": [0, 2, 5] }
   ]
 }
 
 Rules:
-- target is exactly "conviction" or "bridge" \u2014 every belief carries one
+- target is exactly "conviction" or "bridge" \u2014 every statement carries one
 - evidence indices are the [n] numbers from the EVIDENCE list \u2014 never invent an index
-- return an empty beliefs array when the evidence is too thin to synthesize anything
-- keep each belief to one sentence`;
-function buildBeliefSynthesisPrompt(evidence) {
+- return an empty convictions array when the evidence is too thin to synthesize anything
+- keep each statement to one sentence`;
+function buildConvictionSynthesisPrompt(evidence) {
   const lines = ["EVIDENCE (each item is a fact the user stated or asked to remember):"];
   for (const [index, item] of evidence.entries()) {
-    const category = item.category ? ` (category: ${item.category})` : "";
-    lines.push(`[${index}] ${item.text}${category}`);
+    lines.push(`[${index}] ${item.text}${formatFactMetadata(item)}`);
   }
   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 = []) {
@@ -3531,15 +3006,16 @@ function buildVocabularySection(knownCategories = [], knownTags = []) {
 }
 
 // src/prompts/memory/encyclopedia-classify-prompt.constant.ts
-function buildEncyclopediaClassifyPrompt(knownCategories = []) {
+function buildEncyclopediaClassifyPrompt(knownCategories = [], knownTopics = []) {
   return buildStructuredPrompt(EncyclopediaClassifySchema, {
     before: "OUTPUT FORMAT \u2014 output ONLY valid JSON matching this exact schema:",
     after: `
 YOUR TASK \u2014 label one stored source document with its broad category and the topic it is about:
 - The document may be a fetched web page, an uploaded file, or a search-result snippet. Classify by its CONTENT, never by its source shape \u2014 a file has no domain, and that must not matter.
 - category: ONE broad lowercase PLURAL family noun (e.g. "games", "work", "health", "finance") that groups the topic into a family. Never a specific entity, product, company, or title.
-- topic: the narrow subject the document is about (e.g. "wuthering waves", "q3 budget", "rust borrow checker"). A short, specific, reusable label \u2014 not a sentence, not a URL, not a filename.
-${buildVocabularySection(knownCategories)}
+- topic: the narrow subject the document is about (e.g. "wuthering waves", "q3 budget", "rust borrow checker"). A short, specific, reusable label \u2014 not a sentence, not a URL, not a filename, never a domain or a site name.
+- When the document is about a KNOWN TOPIC, output that label VERBATIM \u2014 prefer "neverness to everness" over minting a variant like "nte".
+${buildVocabularySection(knownCategories, knownTopics)}
 RULES:
 - Return ONLY a single valid JSON object matching the exact schema above.
 - No markdown code fences, no explanations, preamble, or postscript.
@@ -3565,6 +3041,12 @@ NOT a contradiction:
 - different subjects or unrelated facts
 - a more specific statement that does not actually conflict with a general one
 
+METADATA \u2014 each record may show "(subject: \u2026; category: \u2026; kind: \u2026; stability: \u2026)":
+- subject: a contradiction requires the SAME subject. Candidates about a different subject are never conflicts, however similar they read.
+- stability: "volatile" records describe a current state \u2014 a NEWER volatile statement supersedes the older one (name the newer as winner). "durable" statements rarely supersede each other: when neither side is clearly right, omit winnerId so the conflict stays open.
+- kind: polarity flips are the expected contradiction for "preference" and "relationship" records. For "fact", "project", "contact" and "possession" records a conflict means one statement is outdated or wrong \u2014 prefer the newer statement when the dates say which is current.
+- category: conflicts almost always live inside one category family; treat a candidate from a clearly different family skeptically, but never dismiss it on category alone.
+
 Respond with JSON only:
 {
   "contradicts": boolean,
@@ -3578,7 +3060,7 @@ Rules:
 - Never invent a conflictingId or winnerId that is not in the input.`;
 function buildFrictionPrompt(input) {
   const lines = [];
-  lines.push(`RECORD (id: ${input.record.id}):`);
+  lines.push(`RECORD (id: ${input.record.id})${formatFactMetadata(input.record)}:`);
   lines.push(input.record.text);
   if (input.record.createdAt) {
     lines.push(`(created: ${input.record.createdAt})`);
@@ -3589,7 +3071,7 @@ function buildFrictionPrompt(input) {
     lines.push("(none)");
   } else {
     for (const candidate of input.candidates) {
-      lines.push(`- id: ${candidate.id}`);
+      lines.push(`- id: ${candidate.id}${formatFactMetadata(candidate)}`);
       lines.push(`  text: ${candidate.text}`);
       if (candidate.createdAt) {
         lines.push(`  created: ${candidate.createdAt}`);
@@ -3598,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.
 
@@ -3623,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, {
@@ -3640,19 +3136,31 @@ Decide exactly one verdict:
 POLARITY RULE (ABSOLUTE): a flip or addition of negation ("allergic" vs "not allergic", "likes" vs "dislikes") is NEW information \u2014 it is never "redundant"; if it corrects a stored statement, merge with the corrected statement.
 PROVENANCE RULE (ABSOLUTE): a statement the user made outweighs assistant-derived wording \u2014 mergedText preserves the user's claim; when candidate origins conflict on facts, the user's version wins.
 
+METADATA \u2014 each record may show "(subject: \u2026; category: \u2026; kind: \u2026; stability: \u2026)":
+- subject: merge requires the SAME subject; facts about different subjects are always "keep".
+- kind: two "contact" or "state" records about the same subject usually merge into the fuller one. Two "decision" or "preference" records with different content are different facts \u2014 keep both.
+- stability: a newer "volatile" state normally replaces the older record via merge.
+
 OUTPUT FORMAT \u2014 output ONLY valid JSON:`,
   after: 'No markdown fences, no explanations. mergedText is required with verdict "merge" and omitted otherwise.'
 });
 function buildConsolidatePrompt(params) {
-  const candidates = params.candidates.length ? params.candidates.map((c) => `- ${formatProvenanceLine(c)}`).join("\n") : "(none)";
+  const candidates = params.candidates.length ? params.candidates.map((c) => `- ${formatProvenanceLine(c)}${formatFactMetadata(c)}`).join("\n") : "(none)";
   return [
     `NEW FACT:
-- ${formatProvenanceLine(params.newFact)}`,
+- ${formatProvenanceLine(params.newFact)}${formatFactMetadata(params.newFact)}`,
     `EXISTING CANDIDATES:
 ${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() {
@@ -3674,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.
 
@@ -3797,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 = []) {
@@ -3809,6 +3460,21 @@ YOUR TASK \u2014 decide what is worth remembering:
 - Facts must be self-contained \u2014 no "this"/"that" references; write them as third-person statements.
 - Storage mechanics: each fact is embedded as a whole and matched sentence-by-sentence at recall time (multi-variant retrieval). One dense sentence is fine \u2014 put the subject up front ("User prefers single-line if statements", not "They prefer that style").
 - Skip transient content: greetings, small talk, one-off instructions, filler \u2014 anything with no future recall value. When in doubt about whether a detail is durable, keep it: a durable detail is cheaper to store than to lose.
+
+FACT METADATA \u2014 every fact object carries the fields the maintenance passes (consolidate/reflect/conviction) interpret:
+- text: the statement itself.
+- subject (optional): the lowercase entity the fact is about \u2014 "user" by default, or a person, product, or project name ("sam", "stellar blade", "payments service"). Maintenance only ever compares facts about the SAME subject, so name it whenever the fact is about a specific entity.
+- category (optional): ONE broad lowercase PLURAL family label for this fact, reusing the known vocabulary \u2014 inherits the turn-side category when omitted.
+- kind (required): what kind of durable thing it is:
+  - preference \u2014 likes, dislikes, wants, style choices
+  - decision \u2014 a choice that was made (adoptions, migrations, purchases committed to)
+  - state \u2014 the CURRENT, changeable situation (lives in X, uses version Y, runs Z) \u2014 newer statements supersede these
+  - contact \u2014 contact details of a person (phone, email, address)
+  - project \u2014 facts about ongoing work or projects
+  - possession \u2014 things owned
+  - relationship \u2014 how people relate ("sam is the user's brother")
+  - fact \u2014 any other durable fact
+- stability (required): "durable" \u2014 a long-term truth that should survive until contradicted (decisions, traits, history) \u2014 or "volatile" \u2014 a current state a newer statement is EXPECTED to replace (location, tooling, versions). When in doubt, choose durable.
 - Tags: 2 to 6 stable, reusable, lowercase topic labels describing what the text is about (e.g. "work", "rust", "contacts", "amd", "stellar blade"). Tags are NARROW and specific \u2014 entity names, product names, game titles. They are the vocabulary for topic-filtered recall later.
 - Category: ONE broad lowercase PLURAL family noun for the whole text (e.g. "stocks", "pets", "games", "health") that groups the narrow tags into one topic family. A category is NEVER a specific entity, product, company, or game title: "amd" belongs under "stocks"; "stellar blade" and "stellar blade blood rain" belong under "games". Always include it when facts are emitted; omit it when nothing durable is found.
 - If nothing durable is found, return an empty facts array; tags may still label the topic when useful.
@@ -3833,8 +3499,8 @@ function buildExtractionCorrectionPrompt(error) {
 Error: ${error}
 
 Return ONLY a single valid JSON object matching the extraction schema exactly:
-{"facts": [string, ...], "tags": [string, ...], "category": "string"}
-All object keys must be quoted with double quotes.
+{"facts": [{"text": "string", "subject": "string", "category": "string", "kind": "preference|decision|state|contact|project|possession|relationship|fact", "stability": "durable|volatile"}, ...], "tags": [string, ...], "category": "string"}
+All object keys must be quoted with double quotes. "subject" and the per-fact "category" are optional; "kind" and "stability" are required on every fact.
 Do not add markdown code fences, explanations, or extra text.
 
 FINAL REMINDER:
@@ -3868,4 +3534,4 @@ Compose the response from the snippets below. Include every snippet you can subs
 ${parts.join("\n\n")}`;
 }
 
-export { BELIEF_INSTRUCTIONS, COMMONMARK_FORMAT, COMPARE_INSTRUCTIONS, COMPARE_VISUAL_INSTRUCTIONS, DEFAULT_VARIANT_ID, DESCRIBE_CONCISE_INSTRUCTIONS, DESCRIBE_DETAILED_INSTRUCTIONS, DESCRIBE_INSTRUCTIONS, FINAL_REMINDER, FRICTION_INSTRUCTIONS, HISTORY_URLS_RULES, IMAGELIST_INSTRUCTIONS, IMAGE_TASK_RULE, INTERNATIONAL_COVERAGE_INSTRUCTIONS, ITEM_SHAPES, JSON_RULES, MEDIA_COUNTS, MEDIA_RULES, MEMORY_CLUSTER_INSTRUCTIONS, MEMORY_CONSOLIDATE_INSTRUCTIONS, MEMORY_PROFILE_INSTRUCTIONS, MEMORY_WRITE_INSTRUCTIONS, MERGE_MEDIA_RULES, MERGE_TOPIC_RULE, MULTIMODAL_POLICY, NOISE_RULES, OCR_INSTRUCTIONS, OCR_VERBATIM_INSTRUCTIONS, PRECEDENCE_RULES, PRODUCT_INSTRUCTIONS, RESPONSE_LAYOUTS, SECURITY_RULES, SHOPLIST_INSTRUCTIONS, SNIPPET_TEMPLATE_PRESETS, SOURCE_TRUTH_RULES, SOURCE_VOICE_RULES, STOCKMARKET_ITEM_INSTRUCTIONS, STOCKMARKET_LIST_INSTRUCTIONS, SUMMARY_INSTRUCTIONS, TEMPLATE_VARIANTS, TEXT_CODING_INSTRUCTIONS, TEXT_FAMILIARITY_INSTRUCTIONS, TEXT_INSTRUCTIONS, TOOL_RESULTS_RULES, VIDEOLIST_INSTRUCTIONS, articlePreset, assessmentListsSnippet, authorMetaSnippet, bodyBriefSnippet, bodyExtensiveSnippet, buildBaseSystemPrompt, buildBeliefSynthesisPrompt, buildClarificationTranslationSystemPrompt, buildClarificationTranslationUserPrompt, buildClassifyTranscript, buildClusterSummaryPrompt, buildConsolidatePrompt, buildContentSystemPrompt, buildContextSummarySection, buildCorrectionPrompt, buildEncyclopediaClassifyPrompt, buildEnrichPrompt, buildExecuteLanguageInstruction, buildExtractionCorrectionPrompt, buildExtractionPrompt, buildFrictionPrompt, buildImageExecutePrompt, buildIntentCorrectionPrompt, buildIntentSelectionPrompt, buildLanguageRule, buildLayoutInstruction, buildLocalizationRule, buildMemoryProbeSection, buildMemoryProfilePrompt, buildMemoryWritePrompt, buildMergeDirective, buildMissingToolsPrompt, buildOutputContract, buildSnippetInstruction, buildSourcePolicyPrompt, buildStockmarketNote, buildStructuredJsonPrompt, buildStructuredPrompt, buildToolExecutePrompt, buildVocabularySection, bylineDatelineSnippet, cardsSnippet, comparisonSchema, comparisonSnippet, composeSnippetKeys, composeSnippetSchema, conclusionSnippet, evaluationPreset, formatCurrentTimestamp, formatProvenanceLine, formatToolAvailabilityCatalog, formatVariantCatalog, gallerySnippet, getSnippetTemplateKeys, getSnippetTemplateSchema, headerArticleSnippet, headerNewsSnippet, heroMediaSnippet, internationalCoverageSnippet, introductionSnippet, isSnippetTemplate, keyFindingsSnippet, languageCorrectionPrompt, leadSnippet, mergePreset, mergedEvaluationsSnippet, newsKeyFindingsSnippet, newsPreset, quoteSnippet, reasoningSnippet, relatedStoriesSnippet, resolveLanguageName, resolveVariantInstructions, responseLayoutSchema, sourcesSnippet, subjectSchema, subjectsSnippet, summarySnippet, verdictSpineSnippet, videoGallerySnippet };
+export { COMMONMARK_FORMAT, COMPARE_INSTRUCTIONS, COMPARE_VISUAL_INSTRUCTIONS, CONVICTION_INSTRUCTIONS, DEFAULT_VARIANT_ID, DESCRIBE_CONCISE_INSTRUCTIONS, DESCRIBE_DETAILED_INSTRUCTIONS, DESCRIBE_INSTRUCTIONS, FINAL_REMINDER, FRICTION_INSTRUCTIONS, HISTORY_URLS_RULES, IMAGELIST_INSTRUCTIONS, IMAGE_TASK_RULE, INTERNATIONAL_COVERAGE_INSTRUCTIONS, ITEM_SHAPES, JSON_RULES, MEDIA_COUNTS, MEDIA_RULES, MEMORY_CLUSTER_INSTRUCTIONS, MEMORY_CONSOLIDATE_INSTRUCTIONS, MEMORY_PROFILE_INSTRUCTIONS, MEMORY_WRITE_INSTRUCTIONS, MERGE_MEDIA_RULES, MERGE_TOPIC_RULE, MULTIMODAL_POLICY, NOISE_RULES, OCR_INSTRUCTIONS, OCR_VERBATIM_INSTRUCTIONS, PRECEDENCE_RULES, PRODUCT_INSTRUCTIONS, RESPONSE_LAYOUTS, SECURITY_RULES, SHOPLIST_INSTRUCTIONS, SNIPPET_TEMPLATE_PRESETS, SOURCE_TRUTH_RULES, SOURCE_VOICE_RULES, STOCKMARKET_ITEM_INSTRUCTIONS, STOCKMARKET_LIST_INSTRUCTIONS, SUMMARY_INSTRUCTIONS, TEMPLATE_VARIANTS, TEXT_CODING_INSTRUCTIONS, TEXT_FAMILIARITY_INSTRUCTIONS, TEXT_INSTRUCTIONS, TOOL_RESULTS_RULES, VIDEOLIST_INSTRUCTIONS, articlePreset, assessmentListsSnippet, authorMetaSnippet, bodyBriefSnippet, bodyExtensiveSnippet, buildBaseSystemPrompt, buildClarificationTranslationSystemPrompt, buildClarificationTranslationUserPrompt, buildClassifyTranscript, buildClusterSummaryPrompt, buildConsolidatePrompt, buildContentSystemPrompt, buildContextSummarySection, buildConvictionSynthesisPrompt, buildCorrectionPrompt, buildEncyclopediaClassifyPrompt, buildEnrichPrompt, buildExecuteLanguageInstruction, buildExtractionCorrectionPrompt, buildExtractionPrompt, buildFrictionPrompt, buildImageExecutePrompt, buildIntentCorrectionPrompt, buildIntentSelectionPrompt, buildLanguageRule, buildLayoutInstruction, buildLocalizationRule, buildMemoryProbeSection, buildMemoryProfilePrompt, buildMemoryWritePrompt, buildMergeDirective, buildMissingToolsPrompt, buildOutputContract, buildSnippetInstruction, buildSourcePolicyPrompt, buildStockmarketNote, buildStructuredJsonPrompt, buildStructuredPrompt, buildToolExecutePrompt, buildVocabularySection, bylineDatelineSnippet, cardsSnippet, comparisonSchema, comparisonSnippet, composeSnippetKeys, composeSnippetSchema, conclusionSnippet, evaluationPreset, formatCurrentTimestamp, formatProvenanceLine, formatToolAvailabilityCatalog, formatVariantCatalog, gallerySnippet, getSnippetTemplateKeys, getSnippetTemplateSchema, headerArticleSnippet, headerNewsSnippet, heroMediaSnippet, internationalCoverageSnippet, introductionSnippet, isSnippetTemplate, keyFindingsSnippet, languageCorrectionPrompt, leadSnippet, mergePreset, mergedEvaluationsSnippet, newsKeyFindingsSnippet, newsPreset, quoteSnippet, reasoningSnippet, relatedStoriesSnippet, resolveLanguageName, resolveVariantInstructions, responseLayoutSchema, sourcesSnippet, subjectSchema, subjectsSnippet, summarySnippet, verdictSpineSnippet, videoGallerySnippet };