@sahan-sac/ai-core 0.2.0 → 0.3.1

package/dist/chunk-ZIHRZXPE.js

@@ -0,0 +1,109 @@
+// src/env.ts
+import { z } from "zod";
+var text = z.string().optional().transform((value) => {
+  const trimmed = value?.trim();
+  return trimmed ? trimmed : void 0;
+});
+var ON = ["1", "true", "yes", "on"];
+var flag = z.string().optional().transform((value) => ON.includes((value ?? "").trim().toLowerCase()));
+var flagDefaultOn = z.string().optional().transform((value) => {
+  const normalized = (value ?? "").trim().toLowerCase();
+  return normalized === "" || ON.includes(normalized);
+});
+var privateKey = text.transform((value) => value?.replace(/\\n/g, "\n"));
+var DEFAULT_GOOGLE_TOKEN_URI = "https://oauth2.googleapis.com/token";
+var aiEnvSchema = z.object({
+  // Paid providers (Vertex text and images, Gemini images) join the chains
+  // only with AI_ALLOW_PAID; off by default, so AI costs $0.
+  AI_ALLOW_PAID: flag,
+  // Feature switches. The blog assistant is off until turned on; the chatbot
+  // is on unless turned off. Each also needs a text provider key.
+  ENABLE_BLOG_AI: flag,
+  ENABLE_CHATBOT: flagDefaultOn,
+  OPENROUTER_BASE_URL: text,
+  OPENROUTER_API_KEY: text,
+  OPENROUTER_API_KEY_2: text,
+  OPENROUTER_ALLOW_PAID_MODELS: flag,
+  GEMINI_API_KEY: text,
+  NVIDIA_API_KEY: text,
+  // Model overrides, all optional (models.ts): purpose variable, then the
+  // provider-wide *_MODEL, then a verified free default.
+  OPENROUTER_MODEL: text,
+  GEMINI_MODEL: text,
+  NVIDIA_MODEL: text,
+  VERTEX_MODEL: text,
+  IMAGEN_MODEL: text,
+  BLOG_GEMINI_MODEL: text,
+  BLOG_OPENROUTER_MODEL: text,
+  BLOG_NVIDIA_MODEL: text,
+  BLOG_VERTEX_MODEL: text,
+  CHAT_GEMINI_MODEL: text,
+  CHAT_OPENROUTER_MODEL: text,
+  CHAT_NVIDIA_MODEL: text,
+  CHAT_VERTEX_MODEL: text,
+  IMAGE_NVIDIA_MODEL: text,
+  IMAGE_GEMINI_MODEL: text,
+  IMAGE_VERTEX_MODEL: text,
+  // Provider order (./adapters). Comma-separated adapter ids; only the listed
+  // ones run, in that order. Per purpose first, then the global one; unset =
+  // the built-in order (free tiers first, paid last).
+  AI_PROVIDER_ORDER: text,
+  AI_PROVIDER_ORDER_BLOG: text,
+  AI_PROVIDER_ORDER_CHAT: text,
+  // Paid OpenAI-compatible and Anthropic providers: each joins a chain only
+  // with its key set and AI_ALLOW_PAID on. Models: purpose variable, then the
+  // provider-wide one, then the default in ./adapters.
+  OPENAI_API_KEY: text,
+  OPENAI_BASE_URL: text,
+  OPENAI_MODEL: text,
+  BLOG_OPENAI_MODEL: text,
+  CHAT_OPENAI_MODEL: text,
+  ANTHROPIC_API_KEY: text,
+  ANTHROPIC_BASE_URL: text,
+  ANTHROPIC_MODEL: text,
+  BLOG_ANTHROPIC_MODEL: text,
+  CHAT_ANTHROPIC_MODEL: text,
+  DEEPSEEK_API_KEY: text,
+  DEEPSEEK_MODEL: text,
+  BLOG_DEEPSEEK_MODEL: text,
+  CHAT_DEEPSEEK_MODEL: text,
+  XAI_API_KEY: text,
+  XAI_MODEL: text,
+  BLOG_XAI_MODEL: text,
+  CHAT_XAI_MODEL: text,
+  PERPLEXITY_API_KEY: text,
+  PERPLEXITY_MODEL: text,
+  BLOG_PERPLEXITY_MODEL: text,
+  CHAT_PERPLEXITY_MODEL: text,
+  // One custom OpenAI-compatible endpoint (a gateway, vLLM, Ollama, LiteLLM).
+  // Treated as paid unless AI_CUSTOM_FREE is on; the key is optional for a
+  // local server.
+  AI_CUSTOM_BASE_URL: text,
+  AI_CUSTOM_API_KEY: text,
+  AI_CUSTOM_MODEL: text,
+  AI_CUSTOM_NAME: text,
+  AI_CUSTOM_FREE: flag,
+  // Google Vertex service account (paid).
+  GOOGLE_CLIENT_EMAIL: text,
+  GOOGLE_PRIVATE_KEY: privateKey,
+  GOOGLE_CLOUD_PROJECT: text,
+  GOOGLE_TOKEN_URI: text.transform((value) => value ?? DEFAULT_GOOGLE_TOKEN_URI)
+});
+function parseAiEnv(source) {
+  const result = aiEnvSchema.safeParse(source);
+  if (!result.success) {
+    const names = [...new Set(result.error.issues.map((issue) => String(issue.path[0] ?? "?")))];
+    throw new Error(`Invalid AI environment variables: ${names.join(", ")}`);
+  }
+  return result.data;
+}
+function aiEnvFromProcess() {
+  return parseAiEnv(process.env);
+}
+
+export {
+  DEFAULT_GOOGLE_TOKEN_URI,
+  aiEnvSchema,
+  parseAiEnv,
+  aiEnvFromProcess
+};

package/dist/env.d.ts

@@ -27,6 +27,36 @@ declare const aiEnvSchema: z.ZodObject<{
     IMAGE_NVIDIA_MODEL: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
     IMAGE_GEMINI_MODEL: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
     IMAGE_VERTEX_MODEL: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
+    AI_PROVIDER_ORDER: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
+    AI_PROVIDER_ORDER_BLOG: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
+    AI_PROVIDER_ORDER_CHAT: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
+    OPENAI_API_KEY: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
+    OPENAI_BASE_URL: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
+    OPENAI_MODEL: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
+    BLOG_OPENAI_MODEL: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
+    CHAT_OPENAI_MODEL: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
+    ANTHROPIC_API_KEY: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
+    ANTHROPIC_BASE_URL: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
+    ANTHROPIC_MODEL: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
+    BLOG_ANTHROPIC_MODEL: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
+    CHAT_ANTHROPIC_MODEL: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
+    DEEPSEEK_API_KEY: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
+    DEEPSEEK_MODEL: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
+    BLOG_DEEPSEEK_MODEL: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
+    CHAT_DEEPSEEK_MODEL: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
+    XAI_API_KEY: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
+    XAI_MODEL: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
+    BLOG_XAI_MODEL: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
+    CHAT_XAI_MODEL: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
+    PERPLEXITY_API_KEY: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
+    PERPLEXITY_MODEL: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
+    BLOG_PERPLEXITY_MODEL: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
+    CHAT_PERPLEXITY_MODEL: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
+    AI_CUSTOM_BASE_URL: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
+    AI_CUSTOM_API_KEY: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
+    AI_CUSTOM_MODEL: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
+    AI_CUSTOM_NAME: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
+    AI_CUSTOM_FREE: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<boolean, string | undefined>>;
     GOOGLE_CLIENT_EMAIL: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
     GOOGLE_PRIVATE_KEY: z.ZodPipe<z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>, z.ZodTransform<string | undefined, string | undefined>>;
     GOOGLE_CLOUD_PROJECT: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;

package/dist/env.js

@@ -1,66 +1,9 @@
-// src/env.ts
-import { z } from "zod";
-var text = z.string().optional().transform((value) => {
-  const trimmed = value?.trim();
-  return trimmed ? trimmed : void 0;
-});
-var ON = ["1", "true", "yes", "on"];
-var flag = z.string().optional().transform((value) => ON.includes((value ?? "").trim().toLowerCase()));
-var flagDefaultOn = z.string().optional().transform((value) => {
-  const normalized = (value ?? "").trim().toLowerCase();
-  return normalized === "" || ON.includes(normalized);
-});
-var privateKey = text.transform((value) => value?.replace(/\\n/g, "\n"));
-var DEFAULT_GOOGLE_TOKEN_URI = "https://oauth2.googleapis.com/token";
-var aiEnvSchema = z.object({
-  // Paid providers (Vertex text and images, Gemini images) join the chains
-  // only with AI_ALLOW_PAID; off by default, so AI costs $0.
-  AI_ALLOW_PAID: flag,
-  // Feature switches. The blog assistant is off until turned on; the chatbot
-  // is on unless turned off. Each also needs a text provider key.
-  ENABLE_BLOG_AI: flag,
-  ENABLE_CHATBOT: flagDefaultOn,
-  OPENROUTER_BASE_URL: text,
-  OPENROUTER_API_KEY: text,
-  OPENROUTER_API_KEY_2: text,
-  OPENROUTER_ALLOW_PAID_MODELS: flag,
-  GEMINI_API_KEY: text,
-  NVIDIA_API_KEY: text,
-  // Model overrides, all optional (models.ts): purpose variable, then the
-  // provider-wide *_MODEL, then a verified free default.
-  OPENROUTER_MODEL: text,
-  GEMINI_MODEL: text,
-  NVIDIA_MODEL: text,
-  VERTEX_MODEL: text,
-  IMAGEN_MODEL: text,
-  BLOG_GEMINI_MODEL: text,
-  BLOG_OPENROUTER_MODEL: text,
-  BLOG_NVIDIA_MODEL: text,
-  BLOG_VERTEX_MODEL: text,
-  CHAT_GEMINI_MODEL: text,
-  CHAT_OPENROUTER_MODEL: text,
-  CHAT_NVIDIA_MODEL: text,
-  CHAT_VERTEX_MODEL: text,
-  IMAGE_NVIDIA_MODEL: text,
-  IMAGE_GEMINI_MODEL: text,
-  IMAGE_VERTEX_MODEL: text,
-  // Google Vertex service account (paid).
-  GOOGLE_CLIENT_EMAIL: text,
-  GOOGLE_PRIVATE_KEY: privateKey,
-  GOOGLE_CLOUD_PROJECT: text,
-  GOOGLE_TOKEN_URI: text.transform((value) => value ?? DEFAULT_GOOGLE_TOKEN_URI)
-});
-function parseAiEnv(source) {
-  const result = aiEnvSchema.safeParse(source);
-  if (!result.success) {
-    const names = [...new Set(result.error.issues.map((issue) => String(issue.path[0] ?? "?")))];
-    throw new Error(`Invalid AI environment variables: ${names.join(", ")}`);
-  }
-  return result.data;
-}
-function aiEnvFromProcess() {
-  return parseAiEnv(process.env);
-}
+import {
+  DEFAULT_GOOGLE_TOKEN_URI,
+  aiEnvFromProcess,
+  aiEnvSchema,
+  parseAiEnv
+} from "./chunk-ZIHRZXPE.js";
 export {
   DEFAULT_GOOGLE_TOKEN_URI,
   aiEnvFromProcess,

package/dist/guard.d.ts

@@ -1,8 +1,20 @@
 declare const DATA_START = "<<<SAHAN_USER_DATA_START>>>";
 declare const DATA_END = "<<<SAHAN_USER_DATA_END>>>";
-/** Strips control characters, caps length, and neutralizes any attempt to
+/** Strips control characters, caps length (4000 by default), and neutralizes any attempt to
  * forge the delimiter markers themselves before fencing the text as data. */
-declare function wrapUserData(text: string): string;
+declare function wrapUserData(text: string, maxLength?: number): string;
+/** Longest owner guidance (per scope, after merging) that reaches a prompt. */
+declare const MAX_GUIDANCE_LENGTH = 6000;
+/**
+ * Standing guidance the site owner wrote in the admin settings (tone, facts,
+ * do and don't), appended to a system prompt. Unlike visitor or editor data
+ * it is meant to steer the model, so it is not fenced; it is still capped,
+ * stripped of control characters and forged fence markers, and placed after
+ * the fixed rules with a note that those rules win. Empty input gives "".
+ */
+declare function guidanceSection(guidance: string | null | undefined): string;
+/** Joins owner guidance from broad to specific (global, then a feature's own), skipping empty parts. */
+declare function mergeGuidance(...parts: Array<string | null | undefined>): string;
 interface ModelPrompt {
     system: string;
     user: string;
@@ -15,4 +27,4 @@ interface ModelPrompt {
  */
 declare function looksLikeLeak(text: string): boolean;
 
-export { DATA_END, DATA_START, type ModelPrompt, looksLikeLeak, wrapUserData };
+export { DATA_END, DATA_START, MAX_GUIDANCE_LENGTH, type ModelPrompt, guidanceSection, looksLikeLeak, mergeGuidance, wrapUserData };

package/dist/image.js

@@ -1,240 +1,18 @@
-// src/image.ts
-import "server-only";
-
-// src/models.ts
-var DEFAULT_IMAGE_MODELS = {
-  nvidia: "black-forest-labs/flux.1-dev",
-  gemini: "gemini-3.1-flash-image",
-  vertex: "gemini-3.1-flash-image"
-};
-var pick = (...values) => values.find((value) => value && value.trim()).trim();
-function imageModels(env) {
-  return {
-    nvidia: pick(env.IMAGE_NVIDIA_MODEL, DEFAULT_IMAGE_MODELS.nvidia),
-    gemini: pick(env.IMAGE_GEMINI_MODEL, DEFAULT_IMAGE_MODELS.gemini),
-    vertex: pick(env.IMAGE_VERTEX_MODEL, env.IMAGEN_MODEL, DEFAULT_IMAGE_MODELS.vertex)
-  };
-}
-var paidAllowed = (env) => env.AI_ALLOW_PAID === true;
-function vertexConfigured(env) {
-  return Boolean(env.GOOGLE_CLIENT_EMAIL && env.GOOGLE_PRIVATE_KEY && env.GOOGLE_CLOUD_PROJECT);
-}
-
-// src/vertex.ts
-import "server-only";
-var cachedToken = null;
-function base64UrlEncode(input) {
-  return Buffer.from(input).toString("base64url");
-}
-async function getVertexAccessToken(account, fetchImpl = fetch) {
-  const now = Date.now();
-  if (cachedToken && cachedToken.expiresAt - 6e4 > now) return cachedToken.accessToken;
-  const { createSign } = await import("crypto");
-  const issuedAt = Math.floor(now / 1e3);
-  const expiresIn = 3600;
-  const header = base64UrlEncode(JSON.stringify({ alg: "RS256", typ: "JWT" }));
-  const claims = base64UrlEncode(
-    JSON.stringify({
-      iss: account.clientEmail,
-      scope: "https://www.googleapis.com/auth/cloud-platform",
-      aud: account.tokenUri,
-      iat: issuedAt,
-      exp: issuedAt + expiresIn
-    })
-  );
-  const signingInput = `${header}.${claims}`;
-  const signature = createSign("RSA-SHA256").update(signingInput).sign(account.privateKey);
-  const jwt = `${signingInput}.${base64UrlEncode(signature)}`;
-  const response = await fetchImpl(account.tokenUri, {
-    method: "POST",
-    headers: { "content-type": "application/x-www-form-urlencoded" },
-    body: new URLSearchParams({
-      grant_type: "urn:ietf:params:oauth:grant-type:jwt-bearer",
-      assertion: jwt
-    })
-  });
-  if (!response.ok) {
-    throw new Error(`Vertex token exchange failed: HTTP ${response.status}`);
-  }
-  const data = await response.json();
-  cachedToken = { accessToken: data.access_token, expiresAt: now + data.expires_in * 1e3 };
-  return data.access_token;
-}
-
-// src/image.ts
-var DEFAULT_IMAGE_MODELS2 = [
-  { model: "gemini-3.1-flash-image", location: "global" },
-  { model: "gemini-2.5-flash-image", location: "us-central1" }
-];
-function defaultLocation(model) {
-  return /^gemini-3/.test(model) ? "global" : "us-central1";
-}
-function imageModelChain(config) {
-  const chain = config.model ? [{ model: config.model, location: config.location ?? defaultLocation(config.model) }] : [];
-  for (const candidate of DEFAULT_IMAGE_MODELS2) {
-    if (!chain.some((entry) => entry.model === candidate.model)) chain.push(candidate);
-  }
-  return chain;
-}
-function endpoint(project, target, method) {
-  const host = target.location === "global" ? "aiplatform.googleapis.com" : `${target.location}-aiplatform.googleapis.com`;
-  return `https://${host}/v1/projects/${project}/locations/${target.location}/publishers/google/models/${target.model}:${method}`;
-}
-function requestFor(target, prompt, aspectRatio) {
-  if (target.model.startsWith("imagen-")) {
-    return {
-      method: "predict",
-      body: {
-        instances: [{ prompt }],
-        parameters: { sampleCount: 1, aspectRatio, safetySetting: "block_medium_and_above", personGeneration: "allow_adult" }
-      }
-    };
-  }
-  return {
-    method: "generateContent",
-    body: {
-      contents: [{ role: "user", parts: [{ text: prompt }] }],
-      generationConfig: { responseModalities: ["IMAGE"], imageConfig: { aspectRatio } }
-    }
-  };
-}
-function extractImage(data) {
-  const prediction = data?.predictions?.[0];
-  if (prediction?.bytesBase64Encoded) return { base64: prediction.bytesBase64Encoded, mimeType: prediction.mimeType || "image/png" };
-  const parts = data?.candidates?.[0]?.content?.parts;
-  const inline = parts?.find((part) => part.inlineData?.data)?.inlineData;
-  return inline?.data ? { base64: inline.data, mimeType: inline.mimeType || "image/png" } : null;
-}
-async function generateImageVertex(prompt, config, options = {}) {
-  const fetchImpl = options.fetchImpl ?? fetch;
-  const aspectRatio = options.aspectRatio ?? "16:9";
-  let accessToken;
-  try {
-    accessToken = await getVertexAccessToken(
-      { clientEmail: config.clientEmail, privateKey: config.privateKey, tokenUri: config.tokenUri },
-      fetchImpl
-    );
-  } catch (error) {
-    return { ok: false, error: `Image generation failed: ${error instanceof Error ? error.message : "authentication error"}` };
-  }
-  const failures = [];
-  for (const target of imageModelChain(config)) {
-    if (options.signal?.aborted) return { ok: false, error: "Image generation timed out." };
-    const { method, body } = requestFor(target, prompt, aspectRatio);
-    try {
-      const response = await fetchImpl(endpoint(config.project, target, method), {
-        method: "POST",
-        headers: { "content-type": "application/json", authorization: `Bearer ${accessToken}` },
-        signal: options.signal,
-        body: JSON.stringify(body)
-      });
-      if (!response.ok) {
-        failures.push(`${target.model}: HTTP ${response.status}`);
-        continue;
-      }
-      const image = extractImage(await response.json());
-      if (image) return { ok: true, ...image };
-      failures.push(`${target.model}: no image data`);
-    } catch (error) {
-      if (options.signal?.aborted) return { ok: false, error: "Image generation timed out." };
-      failures.push(`${target.model}: ${error instanceof Error ? error.message : "transport error"}`);
-    }
-  }
-  return { ok: false, error: `Image generation failed (${failures.join("; ")}).` };
-}
-function vertexImageAvailable(env) {
-  return vertexConfigured(env);
-}
-var FLUX_SIZE = {
-  "16:9": { width: 1344, height: 768 },
-  "4:3": { width: 1024, height: 768 },
-  "1:1": { width: 1024, height: 1024 }
-};
-function nvidiaImageRequest(model, prompt, aspectRatio, seed) {
-  const size = FLUX_SIZE[aspectRatio];
-  if (/schnell/.test(model)) return { prompt, ...size, steps: 4, seed };
-  return { prompt, ...size, steps: 30, cfg_scale: 3.5, mode: "base", seed };
-}
-function extractNvidiaImage(data) {
-  const artifact = data?.artifacts?.[0];
-  if (!artifact?.base64 || artifact.finishReason && artifact.finishReason !== "SUCCESS") return null;
-  const mimeType = artifact.base64.startsWith("/9j/") ? "image/jpeg" : artifact.base64.startsWith("UklG") ? "image/webp" : "image/png";
-  return { base64: artifact.base64, mimeType };
-}
-async function postForImage(model, url, init, extract, options) {
-  try {
-    const response = await (options.fetchImpl ?? fetch)(url, {
-      method: "POST",
-      headers: { "content-type": "application/json", ...init.headers },
-      signal: options.signal,
-      body: JSON.stringify(init.body)
-    });
-    if (!response.ok) return { ok: false, error: `${model}: HTTP ${response.status}` };
-    const image = extract(await response.json());
-    return image ? { ok: true, ...image } : { ok: false, error: `${model}: no image (filtered or empty)` };
-  } catch (error) {
-    if (options.signal?.aborted) return { ok: false, error: "Image generation timed out." };
-    return { ok: false, error: `${model}: ${error instanceof Error ? error.message : "transport error"}` };
-  }
-}
-function generateImageNvidia(prompt, config, aspectRatio, options) {
-  return postForImage(
-    config.model,
-    `https://ai.api.nvidia.com/v1/genai/${config.model}`,
-    {
-      headers: { authorization: `Bearer ${config.apiKey}`, accept: "application/json" },
-      body: nvidiaImageRequest(config.model, prompt, aspectRatio, Math.floor(Math.random() * 2 ** 31))
-    },
-    extractNvidiaImage,
-    options
-  );
-}
-function generateImageGemini(prompt, config, aspectRatio, options) {
-  return postForImage(
-    config.model,
-    `https://generativelanguage.googleapis.com/v1beta/models/${config.model}:generateContent`,
-    {
-      headers: { "x-goog-api-key": config.apiKey },
-      body: { contents: [{ role: "user", parts: [{ text: prompt }] }], generationConfig: { responseModalities: ["IMAGE"], imageConfig: { aspectRatio } } }
-    },
-    extractImage,
-    options
-  );
-}
-function imageConfigFromEnv(env) {
-  const models = imageModels(env);
-  const paid = paidAllowed(env);
-  const config = {};
-  if (env.NVIDIA_API_KEY) config.nvidia = { apiKey: env.NVIDIA_API_KEY, model: models.nvidia };
-  if (paid && env.GEMINI_API_KEY) config.gemini = { apiKey: env.GEMINI_API_KEY, model: models.gemini };
-  if (paid && vertexImageAvailable(env)) {
-    config.vertex = {
-      clientEmail: env.GOOGLE_CLIENT_EMAIL,
-      privateKey: env.GOOGLE_PRIVATE_KEY,
-      tokenUri: env.GOOGLE_TOKEN_URI,
-      project: env.GOOGLE_CLOUD_PROJECT,
-      model: models.vertex
-    };
-  }
-  return config.nvidia || config.gemini || config.vertex ? config : null;
-}
-async function generateImage(prompt, config, options = {}) {
-  const aspectRatio = options.aspectRatio ?? "16:9";
-  const attempts = [];
-  if (config.nvidia) attempts.push(() => generateImageNvidia(prompt, config.nvidia, aspectRatio, options));
-  if (config.gemini) attempts.push(() => generateImageGemini(prompt, config.gemini, aspectRatio, options));
-  if (config.vertex) attempts.push(() => generateImageVertex(prompt, config.vertex, options));
-  const failures = [];
-  for (const run of attempts) {
-    if (options.signal?.aborted) return { ok: false, error: "Image generation timed out." };
-    const outcome = await run();
-    if (outcome.ok) return outcome;
-    failures.push(outcome.error);
-  }
-  return { ok: false, error: failures.length ? `Image generation failed (${failures.join("; ")}).` : "No image provider is configured." };
-}
+import {
+  DEFAULT_IMAGE_MODELS,
+  extractImage,
+  extractNvidiaImage,
+  generateImage,
+  generateImageVertex,
+  imageConfigFromEnv,
+  imageModelChain,
+  nvidiaImageRequest,
+  vertexImageAvailable
+} from "./chunk-MRNQPHWI.js";
+import "./chunk-BL4J2JNX.js";
+import "./chunk-RBSLNDFW.js";
 export {
-  DEFAULT_IMAGE_MODELS2 as DEFAULT_IMAGE_MODELS,
+  DEFAULT_IMAGE_MODELS,
   extractImage,
   extractNvidiaImage,
   generateImage,

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { AiEnv, aiEnvFromProcess, aiEnvSchema, parseAiEnv } from './env.js';
 export { ImageModels, TextModels, TextPurpose } from './models.js';
-export { AiHealth, AiProvider, AiResult } from './providers.js';
+export { a as AdapterState, b as AdapterStatus, AiHealth, AiProvider, AiResult, c as ProviderAdapter } from './providers.js';
 export { ModelPrompt } from './guard.js';
 export { AiLogger } from './log.js';
 import 'zod';

package/dist/index.js

@@ -1,66 +1,8 @@
-// src/env.ts
-import { z } from "zod";
-var text = z.string().optional().transform((value) => {
-  const trimmed = value?.trim();
-  return trimmed ? trimmed : void 0;
-});
-var ON = ["1", "true", "yes", "on"];
-var flag = z.string().optional().transform((value) => ON.includes((value ?? "").trim().toLowerCase()));
-var flagDefaultOn = z.string().optional().transform((value) => {
-  const normalized = (value ?? "").trim().toLowerCase();
-  return normalized === "" || ON.includes(normalized);
-});
-var privateKey = text.transform((value) => value?.replace(/\\n/g, "\n"));
-var DEFAULT_GOOGLE_TOKEN_URI = "https://oauth2.googleapis.com/token";
-var aiEnvSchema = z.object({
-  // Paid providers (Vertex text and images, Gemini images) join the chains
-  // only with AI_ALLOW_PAID; off by default, so AI costs $0.
-  AI_ALLOW_PAID: flag,
-  // Feature switches. The blog assistant is off until turned on; the chatbot
-  // is on unless turned off. Each also needs a text provider key.
-  ENABLE_BLOG_AI: flag,
-  ENABLE_CHATBOT: flagDefaultOn,
-  OPENROUTER_BASE_URL: text,
-  OPENROUTER_API_KEY: text,
-  OPENROUTER_API_KEY_2: text,
-  OPENROUTER_ALLOW_PAID_MODELS: flag,
-  GEMINI_API_KEY: text,
-  NVIDIA_API_KEY: text,
-  // Model overrides, all optional (models.ts): purpose variable, then the
-  // provider-wide *_MODEL, then a verified free default.
-  OPENROUTER_MODEL: text,
-  GEMINI_MODEL: text,
-  NVIDIA_MODEL: text,
-  VERTEX_MODEL: text,
-  IMAGEN_MODEL: text,
-  BLOG_GEMINI_MODEL: text,
-  BLOG_OPENROUTER_MODEL: text,
-  BLOG_NVIDIA_MODEL: text,
-  BLOG_VERTEX_MODEL: text,
-  CHAT_GEMINI_MODEL: text,
-  CHAT_OPENROUTER_MODEL: text,
-  CHAT_NVIDIA_MODEL: text,
-  CHAT_VERTEX_MODEL: text,
-  IMAGE_NVIDIA_MODEL: text,
-  IMAGE_GEMINI_MODEL: text,
-  IMAGE_VERTEX_MODEL: text,
-  // Google Vertex service account (paid).
-  GOOGLE_CLIENT_EMAIL: text,
-  GOOGLE_PRIVATE_KEY: privateKey,
-  GOOGLE_CLOUD_PROJECT: text,
-  GOOGLE_TOKEN_URI: text.transform((value) => value ?? DEFAULT_GOOGLE_TOKEN_URI)
-});
-function parseAiEnv(source) {
-  const result = aiEnvSchema.safeParse(source);
-  if (!result.success) {
-    const names = [...new Set(result.error.issues.map((issue) => String(issue.path[0] ?? "?")))];
-    throw new Error(`Invalid AI environment variables: ${names.join(", ")}`);
-  }
-  return result.data;
-}
-function aiEnvFromProcess() {
-  return parseAiEnv(process.env);
-}
+import {
+  aiEnvFromProcess,
+  aiEnvSchema,
+  parseAiEnv
+} from "./chunk-ZIHRZXPE.js";
 export {
   aiEnvFromProcess,
   aiEnvSchema,

package/dist/log.js

@@ -1,9 +1,6 @@
-// src/log.ts
-var consoleAiLogger = {
-  warn(message, meta) {
-    console.warn(JSON.stringify({ level: "warn", message, ...meta }));
-  }
-};
+import {
+  consoleAiLogger
+} from "./chunk-PMC3UWQ2.js";
 export {
   consoleAiLogger
 };

package/dist/models.js

@@ -1,54 +1,12 @@
-// src/models.ts
-var DEFAULT_TEXT_MODELS = {
-  // Long structured JSON: a full flash model, not lite.
-  blog: {
-    gemini: "gemini-2.5-flash",
-    openrouter: "nvidia/nemotron-3-super-120b-a12b:free",
-    nvidia: "nvidia/nemotron-3-super-120b-a12b",
-    vertex: "gemini-2.5-flash"
-  },
-  // Short, latency-sensitive replies: the fastest free model first.
-  chat: {
-    gemini: "gemini-3.1-flash-lite",
-    openrouter: "nvidia/nemotron-3-super-120b-a12b:free",
-    nvidia: "nvidia/nemotron-3-super-120b-a12b",
-    vertex: "gemini-2.5-flash"
-  }
-};
-var DEFAULT_IMAGE_MODELS = {
-  nvidia: "black-forest-labs/flux.1-dev",
-  gemini: "gemini-3.1-flash-image",
-  vertex: "gemini-3.1-flash-image"
-};
-var pick = (...values) => values.find((value) => value && value.trim()).trim();
-function textModels(env, purpose) {
-  const defaults = DEFAULT_TEXT_MODELS[purpose];
-  const own = purpose === "blog" ? { gemini: env.BLOG_GEMINI_MODEL, openrouter: env.BLOG_OPENROUTER_MODEL, nvidia: env.BLOG_NVIDIA_MODEL, vertex: env.BLOG_VERTEX_MODEL } : { gemini: env.CHAT_GEMINI_MODEL, openrouter: env.CHAT_OPENROUTER_MODEL, nvidia: env.CHAT_NVIDIA_MODEL, vertex: env.CHAT_VERTEX_MODEL };
-  return {
-    gemini: pick(own.gemini, env.GEMINI_MODEL, defaults.gemini),
-    openrouter: pick(own.openrouter, env.OPENROUTER_MODEL, defaults.openrouter),
-    nvidia: pick(own.nvidia, env.NVIDIA_MODEL, defaults.nvidia),
-    vertex: pick(own.vertex, env.VERTEX_MODEL, defaults.vertex)
-  };
-}
-function imageModels(env) {
-  return {
-    nvidia: pick(env.IMAGE_NVIDIA_MODEL, DEFAULT_IMAGE_MODELS.nvidia),
-    gemini: pick(env.IMAGE_GEMINI_MODEL, DEFAULT_IMAGE_MODELS.gemini),
-    vertex: pick(env.IMAGE_VERTEX_MODEL, env.IMAGEN_MODEL, DEFAULT_IMAGE_MODELS.vertex)
-  };
-}
-var paidAllowed = (env) => env.AI_ALLOW_PAID === true;
-function vertexConfigured(env) {
-  return Boolean(env.GOOGLE_CLIENT_EMAIL && env.GOOGLE_PRIVATE_KEY && env.GOOGLE_CLOUD_PROJECT);
-}
-function thinkingConfigFor(model, maxOutputTokens) {
-  const long = maxOutputTokens >= 2e3;
-  if (/^gemini-[3-9]/.test(model)) {
-    return { thinkingLevel: long ? "low" : /flash/.test(model) ? "minimal" : "low" };
-  }
-  return { thinkingBudget: long ? Math.min(800, Math.floor(maxOutputTokens / 5)) : 0 };
-}
+import {
+  DEFAULT_IMAGE_MODELS,
+  DEFAULT_TEXT_MODELS,
+  imageModels,
+  paidAllowed,
+  textModels,
+  thinkingConfigFor,
+  vertexConfigured
+} from "./chunk-RBSLNDFW.js";
 export {
   DEFAULT_IMAGE_MODELS,
   DEFAULT_TEXT_MODELS,