@nextblock-cms/cortex 0.20.1 → 0.21.0

package/lib/ai-seo-metadata.es.js

@@ -1,193 +1,151 @@
-import { generateText as p } from "ai";
-import { buildCortexAiRoutingPolicy as T, runWithCortexAiModelFallback as h, omitUnsupportedCortexAiModelOptions as S, getHttpStatusCode as y, isOpenRouterRecoverableRoutingError as E } from "./ai-model-registry.es.js";
-import "./zod-config.es.js";
-import { z as l } from "zod";
-const b = "Cortex AI SEO metadata generation can only be imported from server-side code.";
-function O() {
-  if (!(typeof window > "u"))
-    throw new Error(b);
+import { buildCortexAiRoutingPolicy as e, getHttpStatusCode as t, isOpenRouterRecoverableRoutingError as n, omitUnsupportedCortexAiModelOptions as r, runWithCortexAiModelFallback as i } from "./ai-model-registry.es.js";
+import { z as a } from "./zod-config.es.js";
+import { generateText as o } from "ai";
+//#region libs/cortex/src/lib/ai-seo-metadata.ts
+var s = "Cortex AI SEO metadata generation can only be imported from server-side code.";
+function c() {
+	if (typeof window < "u") throw Error(s);
 }
-const w = l.strictObject({
-  metaDescription: l.string().trim().min(1),
-  metaTitle: l.string().trim().min(1),
-  ogDescription: l.string().trim().min(1),
-  ogTitle: l.string().trim().min(1)
-}), c = {
-  metaDescription: 160,
-  metaTitle: 60,
-  ogDescription: 200,
-  ogTitle: 88
-}, A = 6e3, D = 6e4, v = /[\s.,;:!?‐-―\-/\\|&+*_"'([{·•]+$/;
-function d(e, t) {
-  const n = e.trim();
-  if (t <= 0)
-    return "";
-  if (n.length <= t)
-    return n;
-  const o = n.slice(0, t), i = o.search(/\s\S*$/);
-  return (i > 0 ? o.slice(0, i) : o).replace(v, "").trim();
+var l = a.strictObject({
+	metaDescription: a.string().trim().min(1),
+	metaTitle: a.string().trim().min(1),
+	ogDescription: a.string().trim().min(1),
+	ogTitle: a.string().trim().min(1)
+}), u = {
+	metaDescription: 160,
+	metaTitle: 60,
+	ogDescription: 200,
+	ogTitle: 88
+}, d = 6e3, f = 6e4, p = /[\s.,;:!?‐-―\-/\\|&+*_"'([{·•]+$/;
+function m(e, t) {
+	let n = e.trim();
+	if (t <= 0) return "";
+	if (n.length <= t) return n;
+	let r = n.slice(0, t), i = r.search(/\s\S*$/);
+	return (i > 0 ? r.slice(0, i) : r).replace(p, "").trim();
 }
-function x(e) {
-  const t = e.replace(/```[a-zA-Z0-9]*/g, ""), n = t.indexOf("{");
-  if (n === -1)
-    return null;
-  let o = 0, i = !1, r = !1;
-  for (let s = n; s < t.length; s++) {
-    const a = t[s];
-    if (i) {
-      r ? r = !1 : a === "\\" ? r = !0 : a === '"' && (i = !1);
-      continue;
-    }
-    if (a === '"') {
-      i = !0;
-      continue;
-    }
-    if (a === "{") {
-      o++;
-      continue;
-    }
-    if (a === "}" && (o--, o === 0))
-      return t.slice(n, s + 1);
-  }
-  return null;
+function h(e) {
+	let t = e.replace(/```[a-zA-Z0-9]*/g, ""), n = t.indexOf("{");
+	if (n === -1) return null;
+	let r = 0, i = !1, a = !1;
+	for (let e = n; e < t.length; e++) {
+		let o = t[e];
+		if (i) {
+			a ? a = !1 : o === "\\" ? a = !0 : o === "\"" && (i = !1);
+			continue;
+		}
+		if (o === "\"") {
+			i = !0;
+			continue;
+		}
+		if (o === "{") {
+			r++;
+			continue;
+		}
+		if (o === "}" && (r--, r === 0)) return t.slice(n, e + 1);
+	}
+	return null;
 }
-function _() {
-  const e = c;
-  return [
-    "You are NextBlock Cortex AI, an SEO metadata writer for a content management system.",
-    "Return ONLY a single JSON object. No markdown fences, no commentary, no explanation, no trailing prose.",
-    'The object must have exactly these four keys, all strings, all non-empty: "metaDescription", "metaTitle", "ogDescription", "ogTitle".',
-    "Do not add any other key.",
-    `metaTitle must be at most ${e.metaTitle} characters and read as a search-result headline for this specific page.`,
-    `metaDescription must be at most ${e.metaDescription} characters, summarise what the page actually delivers, and end as a complete thought.`,
-    `ogTitle must be at most ${e.ogTitle} characters and may be slightly more conversational than metaTitle, because it is read on a social card rather than in a results list.`,
-    `ogDescription must be at most ${e.ogDescription} characters and should invite a click without over-promising.`,
-    "Write plain text. No emoji, no surrounding quotation marks, no HTML, no markdown.",
-    "Describe only what the supplied content actually contains. Never invent statistics, prices, dates, awards, or claims that are not in the content.",
-    "Never keyword-stuff, never repeat the focus keyword more than twice across all four fields, and never pad a field to reach its character budget."
-  ].join(" ");
+function g() {
+	let e = u;
+	return [
+		"You are NextBlock Cortex AI, an SEO metadata writer for a content management system.",
+		"Return ONLY a single JSON object. No markdown fences, no commentary, no explanation, no trailing prose.",
+		"The object must have exactly these four keys, all strings, all non-empty: \"metaDescription\", \"metaTitle\", \"ogDescription\", \"ogTitle\".",
+		"Do not add any other key.",
+		`metaTitle must be at most ${e.metaTitle} characters and read as a search-result headline for this specific page.`,
+		`metaDescription must be at most ${e.metaDescription} characters, summarise what the page actually delivers, and end as a complete thought.`,
+		`ogTitle must be at most ${e.ogTitle} characters and may be slightly more conversational than metaTitle, because it is read on a social card rather than in a results list.`,
+		`ogDescription must be at most ${e.ogDescription} characters and should invite a click without over-promising.`,
+		"Write plain text. No emoji, no surrounding quotation marks, no HTML, no markdown.",
+		"Describe only what the supplied content actually contains. Never invent statistics, prices, dates, awards, or claims that are not in the content.",
+		"Never keyword-stuff, never repeat the focus keyword more than twice across all four fields, and never pad a field to reach its character budget."
+	].join(" ");
 }
-function C(e) {
-  return [
-    "Write SEO metadata for the following page.",
-    e.title ? `Page title: ${e.title}` : null,
-    e.siteTitle ? `Site name: ${e.siteTitle}. Do not append the site name to metaTitle; the site appends it separately.` : null,
-    e.focusKeyword ? `Focus keyword: ${e.focusKeyword}. Use it naturally in metaTitle and metaDescription, at most once each.` : null,
-    e.locale ? `Write every field in this locale: ${e.locale}. Match its conventions for capitalisation and punctuation.` : null,
-    `Page content:
-${e.content}`
-  ].filter(Boolean).join(`
-
-`);
+function _(e) {
+	return [
+		"Write SEO metadata for the following page.",
+		e.title ? `Page title: ${e.title}` : null,
+		e.siteTitle ? `Site name: ${e.siteTitle}. Do not append the site name to metaTitle; the site appends it separately.` : null,
+		e.focusKeyword ? `Focus keyword: ${e.focusKeyword}. Use it naturally in metaTitle and metaDescription, at most once each.` : null,
+		e.locale ? `Write every field in this locale: ${e.locale}. Match its conventions for capitalisation and punctuation.` : null,
+		`Page content:\n${e.content}`
+	].filter(Boolean).join("\n\n");
 }
-function I(e) {
-  const t = x(e);
-  if (!t)
-    throw new Error("Cortex AI returned no JSON object for the SEO metadata request.");
-  let n;
-  try {
-    n = JSON.parse(t);
-  } catch (i) {
-    throw new Error(
-      `Cortex AI returned invalid JSON for the SEO metadata request: ${i instanceof Error ? i.message : String(i)}`
-    );
-  }
-  const o = w.parse(n);
-  return {
-    metaDescription: d(
-      o.metaDescription,
-      c.metaDescription
-    ),
-    metaTitle: d(
-      o.metaTitle,
-      c.metaTitle
-    ),
-    ogDescription: d(
-      o.ogDescription,
-      c.ogDescription
-    ),
-    ogTitle: d(
-      o.ogTitle,
-      c.ogTitle
-    )
-  };
+function v(e) {
+	let t = h(e);
+	if (!t) throw Error("Cortex AI returned no JSON object for the SEO metadata request.");
+	let n;
+	try {
+		n = JSON.parse(t);
+	} catch (e) {
+		throw Error(`Cortex AI returned invalid JSON for the SEO metadata request: ${e instanceof Error ? e.message : String(e)}`);
+	}
+	let r = l.parse(n);
+	return {
+		metaDescription: m(r.metaDescription, u.metaDescription),
+		metaTitle: m(r.metaTitle, u.metaTitle),
+		ogDescription: m(r.ogDescription, u.ogDescription),
+		ogTitle: m(r.ogTitle, u.ogTitle)
+	};
 }
-function R(e) {
-  const t = y(e);
-  if (t === 401 || t === 402 || t === 403)
-    return !1;
-  if (E(e) || t && t >= 500)
-    return !0;
-  const n = e instanceof Error ? e.message : String(e);
-  return /NoContentGenerated|No content generated|Provider returned error|no JSON object|invalid JSON|invalid_type|too_small|unrecognized_keys|Invalid input|aborted|abort|timeout|timed out/i.test(
-    n
-  );
+function y(e) {
+	let r = t(e);
+	if (r === 401 || r === 402 || r === 403) return !1;
+	if (n(e) || r && r >= 500) return !0;
+	let i = e instanceof Error ? e.message : String(e);
+	return /NoContentGenerated|No content generated|Provider returned error|no JSON object|invalid JSON|invalid_type|too_small|unrecognized_keys|Invalid input|aborted|abort|timeout|timed out/i.test(i);
 }
-async function j(e) {
-  O();
-  const t = d(e.content, A);
-  if (!t)
-    throw new Error("Cortex AI SEO metadata generation requires non-empty page content.");
-  const { createCortexAiOpenRouterClient: n } = await import("./ai-client.es.js"), o = await n({
-    apiKey: e.apiKey || void 0
-  }), i = T({
-    credentialSource: o.credentialSource,
-    requestedModelId: e.modelId,
-    selectedModel: o.modelSelection
-  }), r = await h({
-    modelIds: i.modelIds,
-    shouldRetry: R,
-    execute: async (s) => {
-      const a = new AbortController(), m = setTimeout(
-        () => a.abort(),
-        D
-      ), u = () => a.abort();
-      e.abortSignal?.addEventListener("abort", u, { once: !0 }), e.abortSignal?.aborted && a.abort();
-      try {
-        const g = S(
-          {
-            abortSignal: a.signal,
-            maxOutputTokens: 700,
-            maxRetries: 0,
-            prompt: C({
-              content: t,
-              focusKeyword: e.focusKeyword?.trim() || null,
-              locale: e.locale?.trim() || null,
-              siteTitle: e.siteTitle?.trim() || null,
-              title: e.title?.trim() || null
-            }),
-            system: _(),
-            temperature: 0.3
-          },
-          {
-            modelId: s,
-            modelSelection: i.modelSelection
-          }
-        ), f = await p({
-          ...g,
-          model: o.model(s)
-        });
-        return I(f.text);
-      } finally {
-        clearTimeout(m), e.abortSignal?.removeEventListener("abort", u);
-      }
-    }
-  });
-  return {
-    attempts: r.attempts.length,
-    credentialSource: o.credentialSource,
-    metaDescription: r.result.metaDescription,
-    metaTitle: r.result.metaTitle,
-    modelId: r.modelId,
-    ogDescription: r.result.ogDescription,
-    ogTitle: r.result.ogTitle
-  };
+async function b(t) {
+	c();
+	let n = m(t.content, d);
+	if (!n) throw Error("Cortex AI SEO metadata generation requires non-empty page content.");
+	let { createCortexAiOpenRouterClient: a } = await import("./ai-client.es.js"), s = await a({ apiKey: t.apiKey || void 0 }), l = e({
+		credentialSource: s.credentialSource,
+		requestedModelId: t.modelId,
+		selectedModel: s.modelSelection
+	}), u = await i({
+		modelIds: l.modelIds,
+		shouldRetry: y,
+		execute: async (e) => {
+			let i = new AbortController(), a = setTimeout(() => i.abort(), f), c = () => i.abort();
+			t.abortSignal?.addEventListener("abort", c, { once: !0 }), t.abortSignal?.aborted && i.abort();
+			try {
+				let a = r({
+					abortSignal: i.signal,
+					maxOutputTokens: 700,
+					maxRetries: 0,
+					prompt: _({
+						content: n,
+						focusKeyword: t.focusKeyword?.trim() || null,
+						locale: t.locale?.trim() || null,
+						siteTitle: t.siteTitle?.trim() || null,
+						title: t.title?.trim() || null
+					}),
+					instructions: g(),
+					temperature: .3
+				}, {
+					modelId: e,
+					modelSelection: l.modelSelection
+				});
+				return v((await o({
+					...a,
+					model: s.model(e)
+				})).text);
+			} finally {
+				clearTimeout(a), t.abortSignal?.removeEventListener("abort", c);
+			}
+		}
+	});
+	return {
+		attempts: u.attempts.length,
+		credentialSource: s.credentialSource,
+		metaDescription: u.result.metaDescription,
+		metaTitle: u.result.metaTitle,
+		modelId: u.modelId,
+		ogDescription: u.result.ogDescription,
+		ogTitle: u.result.ogTitle
+	};
 }
-export {
-  A as CORTEX_AI_SEO_METADATA_CONTENT_BUDGET,
-  c as CORTEX_AI_SEO_METADATA_LENGTH_BUDGETS,
-  w as cortexAiSeoMetadataOutputSchema,
-  x as extractJsonObject,
-  j as generateCortexAiSeoMetadata,
-  d as truncateOnWordBoundary
-};
+//#endregion
+export { d as CORTEX_AI_SEO_METADATA_CONTENT_BUDGET, u as CORTEX_AI_SEO_METADATA_LENGTH_BUDGETS, l as cortexAiSeoMetadataOutputSchema, h as extractJsonObject, b as generateCortexAiSeoMetadata, m as truncateOnWordBoundary };

package/lib/ai-vision.cjs.js

@@ -1,3 +1,3 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const C=require("ai"),l=require("./ai-model-registry.cjs.js"),R=require("./ai-seo-metadata.cjs.js"),S="Cortex AI vision generation can only be imported from server-side code.";function L(){if(!(typeof window>"u"))throw new Error(S)}const d=["google/gemma-4-31b-it:free","google/gemma-4-26b-a4b-it:free","google/gemini-2.5-flash-lite","qwen/qwen3-vl-32b-instruct","openai/gpt-4o-mini","google/gemini-2.5-flash"],O=[/(?:^|\/)[^/]*-vl(?:[-:]|$)/i,/vision/i,/(?:^|\/)gemini-/i,/(?:^|\/)gemma-[3-9]/i,/(?:^|\/)gpt-(?:4o|4\.1|5)/i,/(?:^|\/)claude-/i,/(?:^|\/)llama-4/i,/(?:^|\/)pixtral/i,/(?:^|\/)mistral-(?:small|medium|large)-3/i,/(?:^|\/)nova-(?:lite|pro|premier)/i],u=125,p={max:1e3,min:20},M=6e4,T=new Set(['"',"'","«","»","‘","’","‚","“","”","„","`"]),v=/^(?:here(?:'s|’s| is)\s+)?(?:the\s+)?alt(?:[-\s]?text)?\s*[:–—-]\s*/i,N=/^(?:this\s+is\s+)?(?:an?|the)?\s*(?:image|photo|photograph|picture|pic|graphic|illustration|rendering|render)\s+(?:of|showing|depicting|that\s+shows)\s+/i;function X(e){const o=new Set,t=[];for(const n of e){const r=n?.trim();!r||o.has(r)||(o.add(r),t.push(r))}return t}function A(e){const o=e?.trim();return o?d.includes(o)?!0:O.some(t=>t.test(o)):!1}function _(e){const o=e.requestedModelId?.trim()||null,t=e.selectedModel?.modelId?.trim()||null,n=e.credentialSource!=="env"&&t&&A(t)?t:null;return{modelIds:X([o,n,...d])}}function f(e){let o=e.trim();for(;o.length>=2&&T.has(o[0])&&T.has(o[o.length-1]);)o=o.slice(1,-1).trim();return o}function U(e){return!e.endsWith(".")||e.endsWith("...")||e.endsWith("…")?e:(e.match(/[.!?](?=\s|$)/g)||[]).length===1?e.slice(0,-1).trimEnd():e}function b(e,o=u){let t=e.replace(/\s+/g," ").trim(),n=!1;for(let r=0;r<2;r++){t=f(t);const a=t.replace(v,"");a!==t&&(t=a.trim(),n=!0),t=f(t);const i=t.replace(N,"");i!==t&&(t=i.trim(),n=!0)}return n&&t&&(t=t.charAt(0).toUpperCase()+t.slice(1)),R.truncateOnWordBoundary(U(t),o)}function q(e){const o=e.trim();if(!o)throw new Error("Cortex AI alt text generation requires an image URL.");let t;try{t=new URL(o)}catch{throw new Error(`Cortex AI alt text generation requires an absolute http(s) image URL, received "${o}". A storage key or site-relative path must be resolved to a publicly fetchable URL first, because the model provider downloads the image server-side.`)}if(t.protocol!=="http:"&&t.protocol!=="https:")throw new Error(`Cortex AI alt text generation requires an http(s) image URL, received the "${t.protocol}" scheme.`);return t}function P(e){return["You are NextBlock Cortex AI, writing the alt attribute for an image on a website.","You are writing for a person using a screen reader who cannot see the image at all.","Describe only what is visibly present in the image: subjects, their appearance, what they are doing, the setting, and any text that appears in the image.","Never state or guess anything you cannot see — no names, no locations, no dates, no brands, no emotions, and no backstory unless they are legible in the image itself.",`Write one short factual description of at most ${e} characters.`,'Do not begin with "image of", "photo of", "picture of", "graphic of", or any similar phrase; the screen reader already announces that this is an image.','Do not add a label such as "Alt text:" and do not wrap the description in quotation marks.',"Do not keyword-stuff, do not list search terms, and do not repeat a word for emphasis.","Return plain text only: one line, no markdown, no HTML, no JSON, no commentary, no alternatives to choose between.","If surrounding page context is supplied, use it ONLY to disambiguate what you can already see — for example to choose the right word for an object or to know which product is pictured. Never use it to add detail that is not visible in the image."].join(" ")}function D(e){return[`Write the alt attribute for this image, at most ${e.maxLength} characters.`,e.context?`Surrounding page context, for disambiguation only: ${e.context}`:null].filter(Boolean).join(`
+const e=require("./ai-model-registry.cjs.js"),t=require("./ai-seo-metadata.cjs.js");let n=require("ai");var r=`Cortex AI vision generation can only be imported from server-side code.`;function i(){if(typeof window<`u`)throw Error(r)}var a=[`google/gemma-4-31b-it:free`,`google/gemma-4-26b-a4b-it:free`,`google/gemini-2.5-flash-lite`,`qwen/qwen3-vl-32b-instruct`,`openai/gpt-4o-mini`,`google/gemini-2.5-flash`],o=[/(?:^|\/)[^/]*-vl(?:[-:]|$)/i,/vision/i,/(?:^|\/)gemini-/i,/(?:^|\/)gemma-[3-9]/i,/(?:^|\/)gpt-(?:4o|4\.1|5)/i,/(?:^|\/)claude-/i,/(?:^|\/)llama-4/i,/(?:^|\/)pixtral/i,/(?:^|\/)mistral-(?:small|medium|large)-3/i,/(?:^|\/)nova-(?:lite|pro|premier)/i],s=125,c={max:1e3,min:20},l=6e4,u=new Set([`"`,`'`,`«`,`»`,`‘`,`’`,`‚`,`“`,`”`,`„`,"`"]),d=/^(?:here(?:'s|’s| is)\s+)?(?:the\s+)?alt(?:[-\s]?text)?\s*[:–—-]\s*/i,f=/^(?:this\s+is\s+)?(?:an?|the)?\s*(?:image|photo|photograph|picture|pic|graphic|illustration|rendering|render)\s+(?:of|showing|depicting|that\s+shows)\s+/i;function p(e){let t=new Set,n=[];for(let r of e){let e=r?.trim();e&&!t.has(e)&&(t.add(e),n.push(e))}return n}function m(e){let t=e?.trim();return t?a.includes(t)?!0:o.some(e=>e.test(t)):!1}function h(e){let t=e.requestedModelId?.trim()||null,n=e.selectedModel?.modelId?.trim()||null;return{modelIds:p([t,e.credentialSource!==`env`&&n&&m(n)?n:null,...a])}}function g(e){let t=e.trim();for(;t.length>=2&&u.has(t[0])&&u.has(t[t.length-1]);)t=t.slice(1,-1).trim();return t}function _(e){return!e.endsWith(`.`)||e.endsWith(`...`)||e.endsWith(`…`)?e:(e.match(/[.!?](?=\s|$)/g)||[]).length===1?e.slice(0,-1).trimEnd():e}function v(e,n=125){let r=e.replace(/\s+/g,` `).trim(),i=!1;for(let e=0;e<2;e++){r=g(r);let e=r.replace(d,``);e!==r&&(r=e.trim(),i=!0),r=g(r);let t=r.replace(f,``);t!==r&&(r=t.trim(),i=!0)}return i&&r&&(r=r.charAt(0).toUpperCase()+r.slice(1)),t.truncateOnWordBoundary(_(r),n)}function y(e){let t=e.trim();if(!t)throw Error(`Cortex AI alt text generation requires an image URL.`);let n;try{n=new URL(t)}catch{throw Error(`Cortex AI alt text generation requires an absolute http(s) image URL, received "${t}". A storage key or site-relative path must be resolved to a publicly fetchable URL first, because the model provider downloads the image server-side.`)}if(n.protocol!==`http:`&&n.protocol!==`https:`)throw Error(`Cortex AI alt text generation requires an http(s) image URL, received the "${n.protocol}" scheme.`);return n}function b(e){return[`You are NextBlock Cortex AI, writing the alt attribute for an image on a website.`,`You are writing for a person using a screen reader who cannot see the image at all.`,`Describe only what is visibly present in the image: subjects, their appearance, what they are doing, the setting, and any text that appears in the image.`,`Never state or guess anything you cannot see — no names, no locations, no dates, no brands, no emotions, and no backstory unless they are legible in the image itself.`,`Write one short factual description of at most ${e} characters.`,`Do not begin with "image of", "photo of", "picture of", "graphic of", or any similar phrase; the screen reader already announces that this is an image.`,`Do not add a label such as "Alt text:" and do not wrap the description in quotation marks.`,`Do not keyword-stuff, do not list search terms, and do not repeat a word for emphasis.`,`Return plain text only: one line, no markdown, no HTML, no JSON, no commentary, no alternatives to choose between.`,`If surrounding page context is supplied, use it ONLY to disambiguate what you can already see — for example to choose the right word for an object or to know which product is pictured. Never use it to add detail that is not visible in the image.`].join(` `)}function x(e){return[`Write the alt attribute for this image, at most ${e.maxLength} characters.`,e.context?`Surrounding page context, for disambiguation only: ${e.context}`:null].filter(Boolean).join(`
 
-`)}function V(e){const o=l.getHttpStatusCode(e);if(o===401||o===402||o===403)return!1;if(l.isOpenRouterRecoverableRoutingError(e)||o&&o>=500)return!0;const t=e instanceof Error?e.message:String(e);return/NoContentGenerated|No content generated|Provider returned error|empty alt text|image|modality|multimodal|not support|unsupported|aborted|abort|timeout|timed out/i.test(t)}async function k(e){L();const o=q(e.imageUrl),t=Number.isFinite(e.maxLength)?Math.round(e.maxLength):u,n=Math.min(p.max,Math.max(p.min,t)),r=e.context?.replace(/\s+/g," ").trim()||null,{createCortexAiOpenRouterClient:a}=await Promise.resolve().then(()=>require("./ai-client.cjs.js")),i=await a({apiKey:e.apiKey||void 0}),x=_({credentialSource:i.credentialSource,requestedModelId:e.modelId,selectedModel:i.modelSelection}),E=[{content:[{text:D({context:r,maxLength:n}),type:"text"},{image:o,type:"image"}],role:"user"}],c=await l.runWithCortexAiModelFallback({modelIds:x.modelIds,shouldRetry:V,execute:async m=>{const s=new AbortController,I=setTimeout(()=>s.abort(),M),g=()=>s.abort();e.abortSignal?.addEventListener("abort",g,{once:!0}),e.abortSignal?.aborted&&s.abort();try{const w=l.omitUnsupportedCortexAiModelOptions({abortSignal:s.signal,maxOutputTokens:400,maxRetries:0,messages:E,system:P(n),temperature:.2},{modelId:m,modelSelection:i.modelSelection}),y=await C.generateText({...w,model:i.model(m)}),h=b(y.text,n);if(!h)throw new Error("Cortex AI returned empty alt text.");return h}finally{clearTimeout(I),e.abortSignal?.removeEventListener("abort",g)}}});return{altText:c.result,attempts:c.attempts.length,credentialSource:i.credentialSource,modelId:c.modelId}}exports.CORTEX_AI_DEFAULT_ALT_TEXT_MAX_LENGTH=u;exports.CORTEX_AI_VISION_MODEL_FALLBACK_REGISTRY=d;exports.buildCortexAiVisionRoutingPolicy=_;exports.generateCortexAiAltText=k;exports.isKnownVisionCapableCortexAiModelId=A;exports.normalizeGeneratedAltText=b;
+`)}function S(t){let n=e.getHttpStatusCode(t);if(n===401||n===402||n===403)return!1;if(e.isOpenRouterRecoverableRoutingError(t)||n&&n>=500)return!0;let r=t instanceof Error?t.message:String(t);return/NoContentGenerated|No content generated|Provider returned error|empty alt text|image|modality|multimodal|not support|unsupported|aborted|abort|timeout|timed out/i.test(r)}async function C(t){i();let r=y(t.imageUrl),a=Number.isFinite(t.maxLength)?Math.round(t.maxLength):125,o=Math.min(c.max,Math.max(c.min,a)),s=t.context?.replace(/\s+/g,` `).trim()||null,{createCortexAiOpenRouterClient:u}=await Promise.resolve().then(()=>require("./ai-client.cjs.js")),d=await u({apiKey:t.apiKey||void 0}),f=h({credentialSource:d.credentialSource,requestedModelId:t.modelId,selectedModel:d.modelSelection}),{downloadCortexVisionImage:p}=await Promise.resolve().then(()=>require("./vision-image-download.cjs.js")),m=await p(r,{abortSignal:t.abortSignal}),g=[{content:[{text:x({context:s,maxLength:o}),type:`text`},{data:m.data,mediaType:m.mediaType,type:`file`}],role:`user`}],_=await e.runWithCortexAiModelFallback({modelIds:f.modelIds,shouldRetry:S,execute:async r=>{let i=new AbortController,a=setTimeout(()=>i.abort(),l),s=()=>i.abort();t.abortSignal?.addEventListener(`abort`,s,{once:!0}),t.abortSignal?.aborted&&i.abort();try{let t=e.omitUnsupportedCortexAiModelOptions({abortSignal:i.signal,maxOutputTokens:400,maxRetries:0,messages:g,instructions:b(o),temperature:.2},{modelId:r,modelSelection:d.modelSelection}),a=v((await(0,n.generateText)({...t,model:d.model(r)})).text,o);if(!a)throw Error(`Cortex AI returned empty alt text.`);return a}finally{clearTimeout(a),t.abortSignal?.removeEventListener(`abort`,s)}}});return{altText:_.result,attempts:_.attempts.length,credentialSource:d.credentialSource,modelId:_.modelId}}exports.CORTEX_AI_DEFAULT_ALT_TEXT_MAX_LENGTH=s,exports.CORTEX_AI_VISION_MODEL_FALLBACK_REGISTRY=a,exports.buildCortexAiVisionRoutingPolicy=h,exports.generateCortexAiAltText=C,exports.isKnownVisionCapableCortexAiModelId=m,exports.normalizeGeneratedAltText=v;

package/lib/ai-vision.d.ts

@@ -122,12 +122,12 @@ export interface GenerateAltTextResult {
 /**
  * Generate an `alt` attribute for an image by actually looking at it.
  *
- * The image is attached as an AI SDK v6 image content part inside a user message.
- * Two consequences of that are worth knowing at the call site: the URL must be
- * publicly fetchable from the server (the SDK downloads it and inlines base64
- * rather than forwarding the link, because the provider is created without
- * `supportedUrls`), and a very large source image inflates the request body on
- * every attempt in the fallback chain. Passing a resized or CDN-transformed URL is
+ * The image is downloaded once by `downloadCortexVisionImage` (DNS-pinned, private
+ * addresses refused, capped at CORTEX_AI_VISION_MAX_IMAGE_BYTES) and attached as an AI SDK
+ * file part with its bytes inside a user message. Two consequences are worth knowing at the
+ * call site: the URL must be publicly fetchable from the server, and a very large source
+ * image inflates the request body on every attempt in the fallback chain, because the
+ * provider receives it inline as base64. Passing a resized or CDN-transformed URL is
  * therefore materially cheaper than passing the original upload.
  */
 export declare function generateCortexAiAltText(params: GenerateAltTextParams): Promise<GenerateAltTextResult>;