@triplef/agent 0.1.0

package/dist/schemas/index.mjs

@@ -0,0 +1,1052 @@
+import { z } from 'zod';
+import { merge, omit } from '@triplef/helpers/object-io';
+
+// src/schemas/constants/blocked-image-hosts.ts
+var BLOCKED_IMAGE_HOSTS = /* @__PURE__ */ new Set([
+  // Google thumbnail proxies (low-res, frequently 404 when hot-linked)
+  "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",
+  // Google user-content thumbnails
+  "lh1.googleusercontent.com",
+  "lh2.googleusercontent.com",
+  "lh3.googleusercontent.com",
+  "lh4.googleusercontent.com",
+  "lh5.googleusercontent.com",
+  "lh6.googleusercontent.com"
+]);
+
+// 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/tools/categorize-tools.helper.ts
+function categorizeTools(toolNames) {
+  const cats = {
+    imageSearch: [],
+    newsSearch: [],
+    videoSearch: [],
+    pageFetch: [],
+    browser: [],
+    imageVariants: [],
+    specialized: []
+  };
+  for (const t of toolNames) {
+    if (t.startsWith("browser_")) cats.browser.push(t);
+    else if (t.endsWith("ImageSearch")) cats.imageSearch.push(t);
+    else if (t.endsWith("NewsSearch")) cats.newsSearch.push(t);
+    else if (t.endsWith("VideoSearch")) cats.videoSearch.push(t);
+    else if (t.includes("Fetch") || t.includes("fetch") || t.includes("Scrape")) cats.pageFetch.push(t);
+    else if (t.startsWith("request")) cats.imageVariants.push(t);
+    else cats.specialized.push(t);
+  }
+  return cats;
+}
+
+// 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). Only return URLs from supported embeddable providers: YouTube, Vimeo, Dailymotion, Loom, Wistia, or direct video files. Reject Instagram, Facebook, TikTok, Twitch, X/Twitter, and other unreliable platforms.",
+  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). Only return URLs from supported embeddable providers: YouTube, Vimeo, Dailymotion, Loom, Wistia, or direct video files. Reject Instagram, Facebook, TikTok, Twitch, X/Twitter, and other unreliable platforms.",
+  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. Use only when search snippets are insufficient.",
+  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.",
+  memoryRemember: 'Store into YOUR long-term memory of this user: 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.',
+  memoryRecall: "Retrieve from YOUR long-term memory of this user \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.",
+  memoryDelete: "Delete from YOUR long-term memory of this user: one exact fact record quoted verbatim from a memoryRecall result, or \u2014 only when the user asks \u2014 your whole learned cognition profile of them. Never delete on a guess: recall first, delete the verbatim statement. Needs memoryRecall alongside it."
+};
+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 MEMORY_TOOL_NAMES = ["memoryRemember", "memoryRecall", "memoryDelete"];
+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",
+  "memoryRemember",
+  "memoryRecall",
+  "memoryDelete",
+  ...BROWSER_TOOL_NAMES
+];
+
+// src/schemas/helpers/url-trust/has-blocked-image-host.helper.ts
+function hasBlockedImageHost(url) {
+  if (!url || url.startsWith("/") || url.startsWith("data:image/")) return false;
+  let parsed;
+  try {
+    parsed = new URL(url);
+  } catch {
+    return false;
+  }
+  if (parsed.protocol !== "http:" && parsed.protocol !== "https:") return false;
+  return BLOCKED_IMAGE_HOSTS.has(parsed.hostname.toLowerCase());
+}
+
+// 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-image-url.helper.ts
+var TRUSTED_IMAGE_HOSTS = /* @__PURE__ */ new Set([
+  "i.imgur.com",
+  "i.redd.it",
+  "preview.redd.it",
+  "upload.wikimedia.org",
+  "commons.wikimedia.org",
+  "images.unsplash.com",
+  "images.pexels.com",
+  "cdn.pixabay.com",
+  "live.staticflickr.com",
+  "farm1.staticflickr.com",
+  "farm2.staticflickr.com",
+  "farm3.staticflickr.com",
+  "farm4.staticflickr.com",
+  "farm5.staticflickr.com",
+  "farm6.staticflickr.com",
+  "farm7.staticflickr.com",
+  "farm8.staticflickr.com",
+  "farm9.staticflickr.com",
+  "i.pinimg.com",
+  "media.istockphoto.com",
+  "assets.istockphoto.com",
+  "media.gettyimages.com",
+  "embed.gettyimages.com",
+  // Social image CDNs (images are generally embeddable, unlike videos)
+  "pbs.twimg.com",
+  "cdninstagram.com",
+  "scontent.cdninstagram.com",
+  "scontent-iad3-1.cdninstagram.com",
+  "graph.facebook.com",
+  "scontent-iad3-1.xx.fbcdn.net",
+  "scontent.xx.fbcdn.net",
+  "static.xx.fbcdn.net",
+  // Cloud/CDNs
+  "res.cloudinary.com",
+  "images.ctfassets.net",
+  "cdn.shopify.com",
+  "imgix.net",
+  "wpmedia.roomsketcher.com",
+  // Bing image CDN
+  "tse1.mm.bing.net",
+  "tse2.mm.bing.net",
+  "tse3.mm.bing.net",
+  "tse4.mm.bing.net"
+]);
+var DIRECT_IMAGE_EXTENSION = /\.(jpg|jpeg|png|gif|webp|bmp|tiff|tif|avif|svg|ico)(\?.*)?$/i;
+function isTrustedImageUrl(url) {
+  if (!url) return false;
+  if (url.startsWith("/") || url.startsWith("data:image/")) return true;
+  let parsed;
+  try {
+    parsed = new URL(url);
+  } catch {
+    return false;
+  }
+  if (parsed.protocol !== "http:" && parsed.protocol !== "https:") return false;
+  const hostname = parsed.hostname.toLowerCase();
+  if (BLOCKED_IMAGE_HOSTS.has(hostname)) return false;
+  if (TRUSTED_IMAGE_HOSTS.has(hostname)) return true;
+  if (DIRECT_IMAGE_EXTENSION.test(parsed.pathname)) 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(""));
+}
+function deriveSchemaKeys(schema) {
+  const jsonSchema = z.toJSONSchema(schema);
+  const properties = jsonSchema.properties ?? {};
+  const required = new Set(jsonSchema.required ?? []);
+  const requiredKeys = [];
+  const optionalKeys = [];
+  for (const key of Object.keys(properties)) {
+    if (required.has(key)) requiredKeys.push(key);
+    else optionalKeys.push(key);
+  }
+  return { required: requiredKeys, optional: optionalKeys };
+}
+
+// src/schemas/helpers/zod/format-zod-issues.helper.ts
+function formatZodIssues(issues) {
+  return issues.map((issue) => {
+    const path = issue.path.length > 0 ? issue.path.join(".") : "root";
+    return `${path}: ${issue.message}`;
+  }).join("; ");
+}
+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 6."
+  ),
+  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 6."
+  ),
+  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 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 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: z.array(z.string())
+});
+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,
+  /** 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()
+});
+function normalizeCognitionProfile(profile) {
+  if (!profile) return void 0;
+  const cleaned = {};
+  for (const [key, value] of Object.entries(profile)) {
+    const kept = cleanProfileValue(value);
+    if (kept !== void 0) cleaned[key] = kept;
+  }
+  return Object.keys(cleaned).length > 0 ? cleaned : void 0;
+}
+function cleanProfileValue(value) {
+  if (value === null || value === void 0) return void 0;
+  if (typeof value === "string") return value.trim() || void 0;
+  if (Array.isArray(value)) {
+    const items = value.map((entry) => typeof entry === "string" ? entry.trim() : entry).filter(Boolean);
+    return items.length > 0 ? items : void 0;
+  }
+  if (typeof value !== "object") return void 0;
+  const inner = Object.fromEntries(
+    Object.entries(value).map(([k, v]) => [k, cleanProfileValue(v)]).filter(([, v]) => v !== void 0)
+  );
+  return Object.keys(inner).length > 0 ? inner : void 0;
+}
+function mergeCognitionProfiles(current, patch) {
+  const patchRecord = patch;
+  const removals = Object.keys(patchRecord).filter(
+    (key) => patchRecord[key] === null || patchRecord[key] === void 0
+  );
+  const base = current ?? {};
+  const merged = merge(
+    omit(base, removals),
+    omit(patch, removals),
+    true
+  );
+  const profile = normalizeCognitionProfile(merged) ?? {};
+  const before = normalizeCognitionProfile(base) ?? {};
+  const changed = JSON.stringify(profile) !== JSON.stringify(before);
+  return { profile: changed ? profile : void 0, removals };
+}
+function isAllFieldsNullWipe(current, patch) {
+  if (!current) return false;
+  const currentKeys = Object.keys(current);
+  if (currentKeys.length === 0) return false;
+  const patchRecord = patch;
+  const presentKeys = Object.keys(patchRecord);
+  if (presentKeys.length === 0) return false;
+  const nullKeys = presentKeys.filter((key) => patchRecord[key] === null || patchRecord[key] === void 0);
+  return nullKeys.length === presentKeys.length && currentKeys.every((key) => nullKeys.includes(key));
+}
+function parseStoredProfile(text) {
+  if (!text?.trim()) return {};
+  try {
+    const parsed = JSON.parse(text);
+    return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
+  } catch {
+    return {};
+  }
+}
+var memoryProfileInsightSchema = z.object({
+  text: z.string(),
+  path: z.string().optional()
+});
+function normalizePathSegment(segment) {
+  return segment.trim().toLowerCase().replace(/\s+/g, "-");
+}
+function normalizeInsightPath(path) {
+  const trimmed = path?.trim();
+  if (!trimmed) return void 0;
+  const dot = trimmed.indexOf(".");
+  if (dot <= 0) return void 0;
+  const field = normalizePathSegment(trimmed.slice(0, dot));
+  const keyword = normalizePathSegment(trimmed.slice(dot + 1));
+  if (!field || !keyword) return void 0;
+  return `${field}.${keyword}`;
+}
+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 INSIGHT_TAGS = ["cognition", "insight"];
+var EPISODE_TAGS = ["cognition", "episode"];
+var COGNITION_LIMIT_DEFAULT = 5e3;
+var COGNITION_LIMIT_MIN = 500;
+var COGNITION_LIMIT_MAX = 32e3;
+var INSIGHT_TEXT_LIMIT = 500;
+var EPISODE_TEXT_LIMIT = 500;
+var INSIGHTS_MAX_PER_TURN = 8;
+var COGNITION_PURGE_BATCH = 500;
+function clampCognitionLimit(value) {
+  if (!Number.isFinite(value)) return COGNITION_LIMIT_DEFAULT;
+  return Math.min(COGNITION_LIMIT_MAX, Math.max(COGNITION_LIMIT_MIN, Math.trunc(value)));
+}
+var EPISODE_RECENCY_WEIGHT_DEFAULT = 0.3;
+var EPISODE_RECENCY_SCALE_SECONDS_DEFAULT = 7 * 24 * 60 * 60;
+var EPISODE_RECENCY_MIDPOINT_DEFAULT = 0.5;
+var EPISODE_PROBE_LIMIT_DEFAULT = 3;
+var EPISODE_SCORE_THRESHOLD_DEFAULT = 0.1;
+var EPISODE_RECENCY_WEIGHT_MIN = 0;
+var EPISODE_RECENCY_WEIGHT_MAX = 1;
+var EPISODE_RECENCY_SCALE_SECONDS_MIN = 60;
+var EPISODE_RECENCY_SCALE_SECONDS_MAX = 31536e3;
+var EPISODE_RECENCY_MIDPOINT_MIN = 0.01;
+var EPISODE_RECENCY_MIDPOINT_MAX = 0.99;
+var EPISODE_PROBE_LIMIT_MIN = 1;
+var EPISODE_PROBE_LIMIT_MAX = 10;
+var EPISODE_SCORE_THRESHOLD_MIN = 0;
+var EPISODE_SCORE_THRESHOLD_MAX = 1;
+function clampEpisodeRecencyWeight(value) {
+  if (!Number.isFinite(value)) return EPISODE_RECENCY_WEIGHT_DEFAULT;
+  return Math.min(EPISODE_RECENCY_WEIGHT_MAX, Math.max(EPISODE_RECENCY_WEIGHT_MIN, value));
+}
+function clampEpisodeRecencyScaleSeconds(value) {
+  if (!Number.isFinite(value)) return EPISODE_RECENCY_SCALE_SECONDS_DEFAULT;
+  return Math.min(EPISODE_RECENCY_SCALE_SECONDS_MAX, Math.max(EPISODE_RECENCY_SCALE_SECONDS_MIN, Math.trunc(value)));
+}
+function clampEpisodeRecencyMidpoint(value) {
+  if (!Number.isFinite(value)) return EPISODE_RECENCY_MIDPOINT_DEFAULT;
+  return Math.min(EPISODE_RECENCY_MIDPOINT_MAX, Math.max(EPISODE_RECENCY_MIDPOINT_MIN, value));
+}
+function clampEpisodeProbeLimit(value) {
+  if (!Number.isFinite(value)) return EPISODE_PROBE_LIMIT_DEFAULT;
+  return Math.min(EPISODE_PROBE_LIMIT_MAX, Math.max(EPISODE_PROBE_LIMIT_MIN, Math.trunc(value)));
+}
+function clampEpisodeScoreThreshold(value) {
+  if (!Number.isFinite(value)) return EPISODE_SCORE_THRESHOLD_DEFAULT;
+  return Math.min(EPISODE_SCORE_THRESHOLD_MAX, Math.max(EPISODE_SCORE_THRESHOLD_MIN, value));
+}
+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");
+var compareSchema = 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");
+var describeSchema = 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()
+});
+var imagelistSchema = 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");
+var ocrSchema = 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" }
+);
+var productSchema = 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" }
+);
+var shoplistSchema = 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()
+});
+var stockmarketItemSchema = 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" }
+);
+var stockmarketListSchema = 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");
+var summarySchema = 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);
+var videolistSchema = 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()
+});
+
+export { BLOCKED_IMAGE_HOSTS, BLOCKED_URL_HOSTS, BROWSER_TOOL_NAMES, COGNITION_LIMIT_DEFAULT, COGNITION_LIMIT_MAX, COGNITION_LIMIT_MIN, COGNITION_PURGE_BATCH, ConsolidationVerdictSchema, DEFAULT_VARIANT_ID, EPISODE_PROBE_LIMIT_DEFAULT, EPISODE_PROBE_LIMIT_MAX, EPISODE_PROBE_LIMIT_MIN, EPISODE_RECENCY_MIDPOINT_DEFAULT, EPISODE_RECENCY_MIDPOINT_MAX, EPISODE_RECENCY_MIDPOINT_MIN, EPISODE_RECENCY_SCALE_SECONDS_DEFAULT, EPISODE_RECENCY_SCALE_SECONDS_MAX, EPISODE_RECENCY_SCALE_SECONDS_MIN, EPISODE_RECENCY_WEIGHT_DEFAULT, EPISODE_RECENCY_WEIGHT_MAX, EPISODE_RECENCY_WEIGHT_MIN, EPISODE_SCORE_THRESHOLD_DEFAULT, EPISODE_SCORE_THRESHOLD_MAX, EPISODE_SCORE_THRESHOLD_MIN, EPISODE_TAGS, EPISODE_TEXT_LIMIT, ExtractionSchema, HERO_VIDEO_TITLE_ISSUE, INSIGHTS_MAX_PER_TURN, INSIGHT_TAGS, INSIGHT_TEXT_LIMIT, IntentSchema, MEMORY_TOOL_NAMES, NON_PAGE_EXTENSIONS, TOOL_DESCRIPTIONS, TOOL_NAMES, VARIANT_NAMES, cardSchema, categorizeTools, clampCognitionLimit, clampEpisodeProbeLimit, clampEpisodeRecencyMidpoint, clampEpisodeRecencyScaleSeconds, clampEpisodeRecencyWeight, clampEpisodeScoreThreshold, compareSchema, createTextItemSchema, deriveSchemaKeys, describeSchema, discardedReferenceSchema, formatZodIssues, formatZodShape, galleryItemSchema, hasBlockedImageHost, heroVideoHasTitle, imagelistSchema, internationalCoverageSchema, isAllFieldsNullWipe, isPrivateOrLocalhost, isTrustedImageUrl, isTrustedUrl, markerSchema, memoryProfileResponseSchema, mergeCognitionProfiles, normalizeInsightPath, ocrSchema, parseStoredProfile, productSchema, referenceGalleryItemSchema, referenceLineSchema, relatedStorySchema, safeMediaUrl, safeMediaUrlOrEmpty, safeUrl, safeVideoUrl, safeVideoUrlOrEmpty, shoplistSchema, sourceSchema, stockmarketItemSchema, stockmarketListSchema, summarySchema, videoGalleryItemSchema, videolistSchema };