@gobing-ai/knowledge-kit 0.0.23 → 0.0.24

package/plugins/generations/image-gen/dist/index.js

@@ -14642,6 +14642,72 @@ var init_zod = __esm(() => {
   init_external();
 });
 
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.11/node_modules/@gobing-ai/ts-utils/dist/errors.js
+var ErrorCode;
+var init_errors3 = __esm(() => {
+  ErrorCode = {
+    NotFound: "NOT_FOUND",
+    Validation: "VALIDATION",
+    Conflict: "CONFLICT",
+    Internal: "INTERNAL"
+  };
+});
+
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.11/node_modules/@gobing-ai/ts-utils/dist/api-response.js
+var API_ERROR_CODES, ERROR_CODE_TO_HTTP, CLIENT_SAFE_CODES;
+var init_api_response = __esm(() => {
+  init_errors3();
+  API_ERROR_CODES = {
+    SUCCESS: 0,
+    NOT_FOUND: 404,
+    VALIDATION_ERROR: 422,
+    BAD_REQUEST: 400,
+    UNAUTHORIZED: 401,
+    FORBIDDEN: 403,
+    CONFLICT: 409,
+    INTERNAL_ERROR: 500
+  };
+  ERROR_CODE_TO_HTTP = {
+    [ErrorCode.NotFound]: API_ERROR_CODES.NOT_FOUND,
+    [ErrorCode.Validation]: API_ERROR_CODES.VALIDATION_ERROR,
+    [ErrorCode.Conflict]: API_ERROR_CODES.CONFLICT,
+    [ErrorCode.Internal]: API_ERROR_CODES.INTERNAL_ERROR
+  };
+  CLIENT_SAFE_CODES = new Set([ErrorCode.NotFound, ErrorCode.Validation, ErrorCode.Conflict]);
+});
+
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.11/node_modules/@gobing-ai/ts-utils/dist/cursor.js
+var init_cursor = () => {};
+
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.11/node_modules/@gobing-ai/ts-utils/dist/event-severity.js
+var init_event_severity = () => {};
+
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.11/node_modules/@gobing-ai/ts-utils/dist/output.js
+function processStream(name) {
+  const proc = globalThis.process;
+  const stream = proc?.[name];
+  if (stream === undefined) {
+    throw new Error(`No ${name} target available: set one via setDefaultOutputTargets or pass an explicit target`);
+  }
+  return stream;
+}
+function writeLine(message, target) {
+  target.write(`${message}
+`);
+}
+function echoError(message, target = defaultStderrTarget ?? processStream("stderr")) {
+  writeLine(message, target);
+}
+var defaultStderrTarget;
+
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.11/node_modules/@gobing-ai/ts-utils/dist/index.js
+var init_dist = __esm(() => {
+  init_api_response();
+  init_cursor();
+  init_errors3();
+  init_event_severity();
+});
+
 // ../../node_modules/.bun/yaml@2.9.0/node_modules/yaml/dist/nodes/identity.js
 var require_identity = __commonJS((exports) => {
   var ALIAS = Symbol.for("yaml.alias");
@@ -17546,15 +17612,15 @@ var require_timestamp = __commonJS((exports) => {
         throw new Error("!!timestamp expects a date, starting with yyyy-mm-dd");
       const [, year, month, day, hour, minute, second] = match.map(Number);
       const millisec = match[7] ? Number((match[7] + "00").substr(1, 3)) : 0;
-      let date5 = Date.UTC(year, month - 1, day, hour || 0, minute || 0, second || 0, millisec);
+      let date6 = Date.UTC(year, month - 1, day, hour || 0, minute || 0, second || 0, millisec);
       const tz = match[8];
       if (tz && tz !== "Z") {
         let d = parseSexagesimal(tz, false);
         if (Math.abs(d) < 30)
           d *= 60;
-        date5 -= 60000 * d;
+        date6 -= 60000 * d;
       }
-      return new Date(date5);
+      return new Date(date6);
     },
     stringify: ({ value }) => value?.toISOString().replace(/(T00:00:00)?\.000Z$/, "") ?? ""
   };
@@ -19414,7 +19480,7 @@ var require_composer = __commonJS((exports) => {
   var node_process = __require("process");
   var directives = require_directives();
   var Document = require_Document();
-  var errors3 = require_errors();
+  var errors4 = require_errors();
   var identity = require_identity();
   var composeDoc = require_compose_doc();
   var resolveEnd = require_resolve_end();
@@ -19465,9 +19531,9 @@ var require_composer = __commonJS((exports) => {
       this.onError = (source, code, message, warning) => {
         const pos = getErrorPos(source);
         if (warning)
-          this.warnings.push(new errors3.YAMLWarning(pos, code, message));
+          this.warnings.push(new errors4.YAMLWarning(pos, code, message));
         else
-          this.errors.push(new errors3.YAMLParseError(pos, code, message));
+          this.errors.push(new errors4.YAMLParseError(pos, code, message));
       };
       this.directives = new directives.Directives({ version: options.version || "1.2" });
       this.options = options;
@@ -19553,7 +19619,7 @@ ${cb}` : comment;
           break;
         case "error": {
           const msg = token.source ? `${token.message}: ${JSON.stringify(token.source)}` : token.message;
-          const error51 = new errors3.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg);
+          const error51 = new errors4.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg);
           if (this.atDirectives || !this.doc)
             this.errors.push(error51);
           else
@@ -19563,7 +19629,7 @@ ${cb}` : comment;
         case "doc-end": {
           if (!this.doc) {
             const msg = "Unexpected doc-end without preceding document";
-            this.errors.push(new errors3.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg));
+            this.errors.push(new errors4.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg));
             break;
           }
           this.doc.directives.docEnd = true;
@@ -19578,7 +19644,7 @@ ${end.comment}` : end.comment;
           break;
         }
         default:
-          this.errors.push(new errors3.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", `Unsupported token ${token.type}`));
+          this.errors.push(new errors4.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", `Unsupported token ${token.type}`));
       }
     }
     *end(forceDoc = false, endOffset = -1) {
@@ -19604,7 +19670,7 @@ ${end.comment}` : end.comment;
 var require_cst_scalar = __commonJS((exports) => {
   var resolveBlockScalar = require_resolve_block_scalar();
   var resolveFlowScalar = require_resolve_flow_scalar();
-  var errors3 = require_errors();
+  var errors4 = require_errors();
   var stringifyString = require_stringifyString();
   function resolveAsScalar(token, strict = true, onError) {
     if (token) {
@@ -19613,7 +19679,7 @@ var require_cst_scalar = __commonJS((exports) => {
         if (onError)
           onError(offset, code, message);
         else
-          throw new errors3.YAMLParseError([offset, offset + 1], code, message);
+          throw new errors4.YAMLParseError([offset, offset + 1], code, message);
       };
       switch (token.type) {
         case "scalar":
@@ -21493,7 +21559,7 @@ var require_parser = __commonJS((exports) => {
 var require_public_api = __commonJS((exports) => {
   var composer = require_composer();
   var Document = require_Document();
-  var errors3 = require_errors();
+  var errors4 = require_errors();
   var log = require_log();
   var identity = require_identity();
   var lineCounter = require_line_counter();
@@ -21510,8 +21576,8 @@ var require_public_api = __commonJS((exports) => {
     const docs = Array.from(composer$1.compose(parser$1.parse(source)));
     if (prettyErrors && lineCounter2)
       for (const doc2 of docs) {
-        doc2.errors.forEach(errors3.prettifyError(source, lineCounter2));
-        doc2.warnings.forEach(errors3.prettifyError(source, lineCounter2));
+        doc2.errors.forEach(errors4.prettifyError(source, lineCounter2));
+        doc2.warnings.forEach(errors4.prettifyError(source, lineCounter2));
       }
     if (docs.length > 0)
       return docs;
@@ -21526,13 +21592,13 @@ var require_public_api = __commonJS((exports) => {
       if (!doc2)
         doc2 = _doc;
       else if (doc2.options.logLevel !== "silent") {
-        doc2.errors.push(new errors3.YAMLParseError(_doc.range.slice(0, 2), "MULTIPLE_DOCS", "Source contains multiple documents; please use YAML.parseAllDocuments()"));
+        doc2.errors.push(new errors4.YAMLParseError(_doc.range.slice(0, 2), "MULTIPLE_DOCS", "Source contains multiple documents; please use YAML.parseAllDocuments()"));
         break;
       }
     }
     if (prettyErrors && lineCounter2) {
-      doc2.errors.forEach(errors3.prettifyError(source, lineCounter2));
-      doc2.warnings.forEach(errors3.prettifyError(source, lineCounter2));
+      doc2.errors.forEach(errors4.prettifyError(source, lineCounter2));
+      doc2.warnings.forEach(errors4.prettifyError(source, lineCounter2));
     }
     return doc2;
   }
@@ -21584,12 +21650,12 @@ var require_public_api = __commonJS((exports) => {
 });
 
 // ../../node_modules/.bun/yaml@2.9.0/node_modules/yaml/dist/index.js
-var composer, Document, Schema, errors3, Alias, identity, Pair, Scalar, YAMLMap, YAMLSeq, cst, lexer, lineCounter, parser, publicApi, visit, $Composer, $Document, $Schema, $YAMLError, $YAMLParseError, $YAMLWarning, $Alias, $isAlias, $isCollection, $isDocument, $isMap, $isNode, $isPair, $isScalar, $isSeq, $Pair, $Scalar, $YAMLMap, $YAMLSeq, $Lexer, $LineCounter, $Parser, $parse, $parseAllDocuments, $parseDocument, $stringify, $visit, $visitAsync;
-var init_dist = __esm(() => {
+var composer, Document, Schema, errors4, Alias, identity, Pair, Scalar, YAMLMap, YAMLSeq, cst, lexer, lineCounter, parser, publicApi, visit, $Composer, $Document, $Schema, $YAMLError, $YAMLParseError, $YAMLWarning, $Alias, $isAlias, $isCollection, $isDocument, $isMap, $isNode, $isPair, $isScalar, $isSeq, $Pair, $Scalar, $YAMLMap, $YAMLSeq, $Lexer, $LineCounter, $Parser, $parse, $parseAllDocuments, $parseDocument, $stringify, $visit, $visitAsync;
+var init_dist2 = __esm(() => {
   composer = require_composer();
   Document = require_Document();
   Schema = require_Schema();
-  errors3 = require_errors();
+  errors4 = require_errors();
   Alias = require_Alias();
   identity = require_identity();
   Pair = require_Pair();
@@ -21605,9 +21671,9 @@ var init_dist = __esm(() => {
   $Composer = composer.Composer;
   $Document = Document.Document;
   $Schema = Schema.Schema;
-  $YAMLError = errors3.YAMLError;
-  $YAMLParseError = errors3.YAMLParseError;
-  $YAMLWarning = errors3.YAMLWarning;
+  $YAMLError = errors4.YAMLError;
+  $YAMLParseError = errors4.YAMLParseError;
+  $YAMLWarning = errors4.YAMLWarning;
   $Alias = Alias.Alias;
   $isAlias = identity.isAlias;
   $isCollection = identity.isCollection;
@@ -21632,10 +21698,10 @@ var init_dist = __esm(() => {
   $visitAsync = visit.visitAsync;
 });
 
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.4.39/node_modules/@gobing-ai/ts-runtime/dist/config.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.11/node_modules/@gobing-ai/ts-runtime/dist/config.js
 var configSchema;
 var init_config = __esm(() => {
-  init_dist();
+  init_dist2();
   init_zod();
   configSchema = exports_external.object({
     app: exports_external.object({
@@ -21656,7 +21722,7 @@ var init_config = __esm(() => {
   });
 });
 
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.4.39/node_modules/@gobing-ai/ts-runtime/dist/file-system-node.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.11/node_modules/@gobing-ai/ts-runtime/dist/file-system-node.js
 import { appendFileSync, cpSync, createReadStream, createWriteStream, existsSync, mkdirSync, readdirSync, readFileSync, realpathSync, renameSync, rmSync, statSync, writeFileSync } from "fs";
 import { dirname, resolve as resolvePath } from "path";
 function createNodeFileSystem(root, paths) {
@@ -21834,30 +21900,15 @@ var PluginManifestSchema = exports_external.looseObject({
   description: exports_external.string().optional(),
   operations: exports_external.record(exports_external.string(), PluginOperationSchema).optional()
 });
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.4.39/node_modules/@gobing-ai/ts-runtime/dist/index.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.11/node_modules/@gobing-ai/ts-runtime/dist/index.js
 init_file_system_node();
 init_config();
 
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.4.67/node_modules/@gobing-ai/ts-utils/dist/output.js
-var defaultStderrTarget;
-function processStream(name) {
-  const proc = globalThis.process;
-  const stream = proc?.[name];
-  if (stream === undefined) {
-    throw new Error(`No ${name} target available: set one via setDefaultOutputTargets or pass an explicit target`);
-  }
-  return stream;
-}
-function writeLine(message, target) {
-  target.write(`${message}
-`);
-}
-function echoError(message, target = defaultStderrTarget ?? processStream("stderr")) {
-  writeLine(message, target);
-}
-
 // ../../packages/kk-core/src/render-md.ts
 if (false) {}
+// ../../plugins/generations/image-gen/src/index.ts
+init_dist();
+
 // ../../plugins/generations/image-gen/src/bytes.ts
 import { readFile, writeFile } from "fs/promises";
 async function writeBytes(path2, bytes) {
@@ -21877,6 +21928,7 @@ var ImageJobSpecSchema = exports_external.strictObject({
   vars: exports_external.record(exports_external.string(), exports_external.string()).optional(),
   extra: exports_external.string().optional(),
   provider: exports_external.string().optional(),
+  fallback: exports_external.union([exports_external.literal(true), exports_external.array(exports_external.string().min(1)).min(1)]).optional(),
   model: exports_external.string().optional(),
   referenceImages: exports_external.array(exports_external.string()).optional(),
   count: exports_external.number().int().positive().optional(),
@@ -22011,22 +22063,22 @@ function resolvePlaceholder(expr, vars, formatName) {
 }
 function renderTemplate(template, vars, formatName) {
   let rendered = "";
-  let cursor = 0;
-  while (cursor < template.length) {
-    const start = template.indexOf("{{", cursor);
+  let cursor2 = 0;
+  while (cursor2 < template.length) {
+    const start = template.indexOf("{{", cursor2);
     if (start === -1) {
-      rendered += template.slice(cursor);
+      rendered += template.slice(cursor2);
       break;
     }
     const match = matchPlaceholder(template, start);
     if (match === undefined) {
-      rendered += template.slice(cursor, start + 2);
-      cursor = start + 2;
+      rendered += template.slice(cursor2, start + 2);
+      cursor2 = start + 2;
       continue;
     }
-    rendered += template.slice(cursor, start);
+    rendered += template.slice(cursor2, start);
     rendered += resolvePlaceholder(match.expr, vars, formatName);
-    cursor = match.end;
+    cursor2 = match.end;
   }
   return rendered;
 }
@@ -22151,8 +22203,8 @@ function extensionFromUrl(url2) {
 var createSeedream = (options) => {
   const fetchFn = options?.fetch ?? fetch;
   const timeoutMs = options?.timeoutMs ?? PROVIDER_REQUEST_TIMEOUT_MS;
-  const env = options?.env ?? process.env;
-  const readEnv = (key) => env[key] ?? "";
+  const env2 = options?.env ?? process.env;
+  const readEnv = (key) => env2[key] ?? "";
   const supportsRef = (model) => REF_MODEL_FRAGMENTS.some((fragment) => model.includes(fragment));
   return {
     name: "seedream",
@@ -22288,8 +22340,8 @@ async function extractImageFromResponse(result, fetchFn = fetch, timeoutMs = PRO
 var createAgnes = (options) => {
   const fetchFn = options?.fetch ?? fetch;
   const timeoutMs = options?.timeoutMs ?? PROVIDER_REQUEST_TIMEOUT_MS;
-  const env = options?.env ?? process.env;
-  const readEnv = (key) => env[key] ?? "";
+  const env2 = options?.env ?? process.env;
+  const readEnv = (key) => env2[key] ?? "";
   return {
     name: "agnes",
     defaultModel: () => DEFAULT_MODEL2,
@@ -22524,8 +22576,8 @@ async function extractImageFromResponse2(result, fetchFn = fetch, timeoutMs = PR
 var createOpenai = (options) => {
   const fetchFn = options?.fetch ?? fetch;
   const timeoutMs = options?.timeoutMs ?? PROVIDER_REQUEST_TIMEOUT_MS;
-  const env = options?.env ?? process.env;
-  const readEnv = (key) => env[key] ?? "";
+  const env2 = options?.env ?? process.env;
+  const readEnv = (key) => env2[key] ?? "";
   const supportsRef = (model) => model.includes("gpt-image");
   return {
     name: "openai",
@@ -22633,22 +22685,22 @@ function parseAzureBaseURL(url2) {
   parsed.pathname = trimmedPath.endsWith("/openai") ? trimmedPath : `${trimmedPath}/openai`;
   return { resourceBaseURL: parsed.toString().replace(/\/+$/, ""), deployment: null };
 }
-function azureEndpoint(env) {
-  const url2 = env.AZURE_OPENAI_BASE_URL ?? "";
+function azureEndpoint(env2) {
+  const url2 = env2.AZURE_OPENAI_BASE_URL ?? "";
   if (url2 === "") {
     throw new Error("AZURE_OPENAI_BASE_URL is required. Set it to your Azure resource or deployment endpoint, e.g.: https://your-resource.openai.azure.com or https://your-resource.openai.azure.com/openai/deployments/your-deployment");
   }
   return parseAzureBaseURL(url2);
 }
-function getApiKey(env) {
-  const key = env.AZURE_OPENAI_API_KEY ?? "";
+function getApiKey(env2) {
+  const key = env2.AZURE_OPENAI_API_KEY ?? "";
   if (key === "") {
     throw new Error("AZURE_OPENAI_API_KEY is required. Get it from Azure Portal \u2192 your OpenAI resource \u2192 Keys and Endpoint.");
   }
   return key;
 }
-function buildURL(endpoint, deployment, pathSuffix, env) {
-  const apiVersion = env.AZURE_API_VERSION ?? DEFAULT_AZURE_API_VERSION;
+function buildURL(endpoint, deployment, pathSuffix, env2) {
+  const apiVersion = env2.AZURE_API_VERSION ?? DEFAULT_AZURE_API_VERSION;
   return `${endpoint.resourceBaseURL}/deployments/${encodeURIComponent(deployment)}${pathSuffix}?api-version=${apiVersion}`;
 }
 function getAzureQuality(quality) {
@@ -22664,12 +22716,12 @@ function validateReferenceImages(referenceImages) {
 var createAzure = (options) => {
   const fetchFn = options?.fetch ?? fetch;
   const timeoutMs = options?.timeoutMs ?? PROVIDER_REQUEST_TIMEOUT_MS;
-  const env = options?.env ?? process.env;
+  const env2 = options?.env ?? process.env;
   function defaultModel() {
-    const explicit = env.AZURE_OPENAI_DEPLOYMENT?.trim();
+    const explicit = env2.AZURE_OPENAI_DEPLOYMENT?.trim();
     if (explicit !== undefined && explicit !== "")
       return explicit;
-    const baseURL = env.AZURE_OPENAI_BASE_URL;
+    const baseURL = env2.AZURE_OPENAI_BASE_URL;
     if (baseURL !== undefined) {
       try {
         const { deployment } = parseAzureBaseURL(baseURL);
@@ -22683,14 +22735,14 @@ var createAzure = (options) => {
   return {
     name: "azure",
     defaultModel,
-    isAvailable: () => (env.AZURE_OPENAI_API_KEY ?? "") !== "",
+    isAvailable: () => (env2.AZURE_OPENAI_API_KEY ?? "") !== "",
     supportsReferenceImages: supportsRef,
     validate(req) {
       validateReferenceImages(req.referenceImages ?? []);
     },
     async generate(req) {
-      const apiKey = getApiKey(env);
-      const endpoint = azureEndpoint(env);
+      const apiKey = getApiKey(env2);
+      const endpoint = azureEndpoint(env2);
       const deployment = req.model.trim();
       if (deployment === "") {
         throw new Error("Azure deployment name is required. Use --model <deployment>, AZURE_OPENAI_DEPLOYMENT, AZURE_OPENAI_IMAGE_MODEL, or embed the deployment in AZURE_OPENAI_BASE_URL.");
@@ -22710,7 +22762,7 @@ var createAzure = (options) => {
             const mimeType = extname3(filename).toLowerCase() === ".png" ? "image/png" : "image/jpeg";
             form.append("image[]", new Blob([fileBytes], { type: mimeType }), filename);
           }
-          const res2 = await fetchFn(buildURL(endpoint, deployment, "/images/edits", env), {
+          const res2 = await fetchFn(buildURL(endpoint, deployment, "/images/edits", env2), {
             method: "POST",
             headers: { "api-key": apiKey },
             body: form,
@@ -22720,7 +22772,7 @@ var createAzure = (options) => {
             throw new Error(`Azure OpenAI edits API error: ${await res2.text()}`);
           return extractImageFromResponse2(await res2.json(), fetchFn, timeoutMs);
         }
-        const res = await fetchFn(buildURL(endpoint, deployment, "/images/generations", env), {
+        const res = await fetchFn(buildURL(endpoint, deployment, "/images/generations", env2), {
           method: "POST",
           headers: { "content-type": "application/json", "api-key": apiKey },
           body: JSON.stringify({ prompt: req.prompt, size, n: 1, quality: getAzureQuality(req.quality) }),
@@ -22738,13 +22790,13 @@ var createAzure = (options) => {
 // ../../plugins/generations/image-gen/src/providers/codex-cli.ts
 import { spawn } from "child_process";
 import { randomBytes } from "crypto";
-import { access, mkdir, rm, writeFile as writeFile2 } from "fs/promises";
+import { access as access2, mkdir, rm, writeFile as writeFile2 } from "fs/promises";
 import { tmpdir } from "os";
 import { resolve as resolve2 } from "path";
 var DEFAULT_MODEL4 = "codex-image-gen";
 async function exists(filePath) {
   try {
-    await access(filePath);
+    await access2(filePath);
     return true;
   } catch {
     return false;
@@ -22797,8 +22849,8 @@ function parsePositiveInt(value) {
   return Number.isFinite(parsed) && parsed > 0 ? parsed : null;
 }
 var createCodexCli = (options) => {
-  const env = options?.env ?? process.env;
-  const readEnv = (key) => env[key] ?? "";
+  const env2 = options?.env ?? process.env;
+  const readEnv = (key) => env2[key] ?? "";
   return {
     name: "codex-cli",
     defaultModel: () => DEFAULT_MODEL4,
@@ -22859,6 +22911,7 @@ var createCodexCli = (options) => {
 };
 
 // ../../plugins/generations/image-gen/src/providers/dashscope.ts
+init_dist();
 import { Buffer as Buffer5 } from "buffer";
 var DEFAULT_MODEL5 = "qwen-image-2.0-pro";
 var MIN_QWEN_2_TOTAL_PIXELS = 512 * 512;
@@ -23190,8 +23243,8 @@ async function extractImageFromResponse3(result, fetchFn, timeoutMs = PROVIDER_R
 var createDashscope = (options) => {
   const fetchFn = options?.fetch ?? fetch;
   const timeoutMs = options?.timeoutMs ?? PROVIDER_REQUEST_TIMEOUT_MS;
-  const env = options?.env ?? process.env;
-  const readEnv = (key) => env[key] ?? "";
+  const env2 = options?.env ?? process.env;
+  const readEnv = (key) => env2[key] ?? "";
   const supportsRef = (model) => model.includes("wan2.7");
   return {
     name: "dashscope",
@@ -23343,8 +23396,8 @@ function proxyPassword(proxy) {
 var createGoogle = (options) => {
   const fetchFn = options?.fetch ?? fetch;
   const timeoutMs = options?.timeoutMs ?? PROVIDER_REQUEST_TIMEOUT_MS;
-  const env = options?.env ?? process.env;
-  const readEnv = (key) => env[key] ?? "";
+  const env2 = options?.env ?? process.env;
+  const readEnv = (key) => env2[key] ?? "";
   const refModels = [
     "gemini-3-pro-image",
     "gemini-3.1-flash-image",
@@ -23490,8 +23543,8 @@ var buildPayload = (req) => ({
 var createHuggingface = (options) => {
   const fetchFn = options?.fetch ?? fetch;
   const timeoutMs = options?.timeoutMs ?? PROVIDER_REQUEST_TIMEOUT_MS;
-  const env = options?.env ?? process.env;
-  const readEnv = (key) => env[key] ?? "";
+  const env2 = options?.env ?? process.env;
+  const readEnv = (key) => env2[key] ?? "";
   return {
     name: "huggingface",
     defaultModel: () => readEnv("HUGGINGFACE_MODEL") || DEFAULT_MODEL7,
@@ -23619,8 +23672,8 @@ function timestampHeader() {
 var createJimeng = (options) => {
   const fetchFn = options?.fetch ?? fetch;
   const timeoutMs = options?.timeoutMs ?? PROVIDER_REQUEST_TIMEOUT_MS;
-  const env = options?.env ?? process.env;
-  const readEnv = (key) => env[key] ?? "";
+  const env2 = options?.env ?? process.env;
+  const readEnv = (key) => env2[key] ?? "";
   async function signedPost(query, body, accessKey, secretKey, region) {
     const base = readEnv("JIMENG_BASE_URL") || "https://visual.volcengineapi.com";
     const endpoint = resolveEndpoint(base, query);
@@ -23791,8 +23844,8 @@ async function extractImageFromResponse4(result, fetchFn = fetch, timeoutMs = PR
 var createMinimax = (options) => {
   const fetchFn = options?.fetch ?? fetch;
   const timeoutMs = options?.timeoutMs ?? PROVIDER_REQUEST_TIMEOUT_MS;
-  const env = options?.env ?? process.env;
-  const readEnv = (key) => env[key] ?? "";
+  const env2 = options?.env ?? process.env;
+  const readEnv = (key) => env2[key] ?? "";
   return {
     name: "minimax",
     defaultModel: () => DEFAULT_MODEL9,
@@ -24003,8 +24056,8 @@ function buildRequestBody2(prompt, model, req, referenceImages) {
 var createOpenrouter = (options) => {
   const fetchFn = options?.fetch ?? fetch;
   const timeoutMs = options?.timeoutMs ?? PROVIDER_REQUEST_TIMEOUT_MS;
-  const env = options?.env ?? process.env;
-  const readEnv = (key) => env[key] ?? "";
+  const env2 = options?.env ?? process.env;
+  const readEnv = (key) => env2[key] ?? "";
   return {
     name: "openrouter",
     defaultModel: () => DEFAULT_MODEL10,
@@ -24191,29 +24244,29 @@ function buildInput(req) {
   return { prompt: req.prompt };
 }
 function extractOutputUrl(prediction) {
-  const output = prediction.output;
-  if (typeof output === "string")
-    return output;
-  if (Array.isArray(output)) {
-    if (output.length !== 1) {
-      throw new Error(`Replicate returned ${output.length} outputs, but kk image-gen currently supports saving exactly one image per request.`);
-    }
-    const first = output[0];
+  const output2 = prediction.output;
+  if (typeof output2 === "string")
+    return output2;
+  if (Array.isArray(output2)) {
+    if (output2.length !== 1) {
+      throw new Error(`Replicate returned ${output2.length} outputs, but kk image-gen currently supports saving exactly one image per request.`);
+    }
+    const first = output2[0];
     if (typeof first === "string")
       return first;
   }
-  if (output !== null && typeof output === "object" && "url" in output) {
-    const url2 = output.url;
+  if (output2 !== null && typeof output2 === "object" && "url" in output2) {
+    const url2 = output2.url;
     if (typeof url2 === "string")
       return url2;
   }
-  throw new Error(`Unexpected Replicate output format: ${JSON.stringify(output)}`);
+  throw new Error(`Unexpected Replicate output format: ${JSON.stringify(output2)}`);
 }
 var createReplicate = (options) => {
   const fetchFn = options?.fetch ?? fetch;
-  const env = options?.env ?? process.env;
+  const env2 = options?.env ?? process.env;
   const timeoutMs = options?.timeoutMs ?? PROVIDER_REQUEST_TIMEOUT_MS;
-  const readEnv = (key) => env[key] ?? "";
+  const readEnv = (key) => env2[key] ?? "";
   async function downloadImage2(url2) {
     const res = await fetchFn(url2, { signal: AbortSignal.timeout(timeoutMs) });
     if (!res.ok)
@@ -24430,8 +24483,8 @@ function resolveSizeForModel2(model, args) {
 var createZai = (options) => {
   const fetchFn = options?.fetch ?? fetch;
   const timeoutMs = options?.timeoutMs ?? PROVIDER_REQUEST_TIMEOUT_MS;
-  const env = options?.env ?? process.env;
-  const readEnv = (key) => env[key] ?? "";
+  const env2 = options?.env ?? process.env;
+  const readEnv = (key) => env2[key] ?? "";
   return {
     name: "zai",
     defaultModel: () => DEFAULT_MODEL12,
@@ -24485,6 +24538,48 @@ var createZai = (options) => {
   };
 };
 
+// ../../plugins/generations/image-gen/src/providers/errors.ts
+var POLICY_RE = /content[_ -]?policy|moderation|safety|sensitive|inappropriate|violat|blocked/i;
+var AUTH_RE = /api[_ -]?key|unauthori[sz]ed|authenticat|forbidden|requires [A-Z_]+|is required/i;
+var QUOTA_RE = /quota|rate[_ -]?limit|insufficient|balance|billing|exceeded|too many requests/i;
+var TRANSIENT_RE = /timed? ?out|ECONNRESET|ETIMEDOUT|ECONNREFUSED|fetch failed|socket|model loading/i;
+var TRANSIENT_NAMES = new Set(["TimeoutError", "AbortError"]);
+function statusesIn(message) {
+  const statuses = [];
+  for (const match of message.matchAll(/\((\d{3})\)|HTTP\s+(\d{3})\b|:\s*(\d{3})\s*$/gi)) {
+    const status = match[1] ?? match[2] ?? match[3];
+    if (status !== undefined)
+      statuses.push(Number(status));
+  }
+  return statuses;
+}
+function partsOf(err) {
+  if (typeof err !== "object" || err === null)
+    return { name: "", message: "" };
+  const candidate = err;
+  return {
+    name: typeof candidate.name === "string" ? candidate.name : "",
+    message: typeof candidate.message === "string" ? candidate.message : ""
+  };
+}
+function classifyProviderError(err) {
+  const parts = partsOf(err);
+  const statuses = statusesIn(parts.message);
+  if (POLICY_RE.test(parts.message))
+    return "policy";
+  if (statuses.some((status) => status === 401 || status === 403) || AUTH_RE.test(parts.message))
+    return "auth";
+  if (statuses.some((status) => status === 402 || status === 429) || QUOTA_RE.test(parts.message))
+    return "quota";
+  if (TRANSIENT_NAMES.has(parts.name) || statuses.some((status) => status === 408 || status >= 500 && status <= 599) || TRANSIENT_RE.test(parts.message)) {
+    return "transient";
+  }
+  return "unknown";
+}
+function isFallbackEligible(cls) {
+  return cls !== "policy";
+}
+
 // ../../plugins/generations/image-gen/src/providers/types.ts
 var IMAGE_GEN_PROVIDER_ENV = "IMAGE_GEN_PROVIDER";
 var NEVER_AUTO = new Set(["codex-cli"]);
@@ -24613,13 +24708,13 @@ function notConfiguredMessage(reg) {
   return `Provider '${reg.name}' is not configured: missing ${envSummary(reg)} (set it in plugins.generations.image-gen.env or process.env)`;
 }
 function selectProvider(requested, options) {
-  const env = options?.env ?? process.env;
+  const env2 = options?.env ?? process.env;
   const available = options?.isAvailable ?? ((name) => {
     const reg = PROVIDERS[name];
-    return reg?.create({ env }).isAvailable() ?? false;
+    return reg?.create({ env: env2 }).isAvailable() ?? false;
   });
   const names = Object.keys(PROVIDERS).sort();
-  const explicit = requested ?? env[IMAGE_GEN_PROVIDER_ENV];
+  const explicit = requested ?? env2[IMAGE_GEN_PROVIDER_ENV];
   if (explicit !== undefined && explicit !== "") {
     const reg = PROVIDERS[explicit];
     if (reg === undefined) {
@@ -24641,6 +24736,40 @@ function selectProvider(requested, options) {
   }).join("; ");
   throw new Error(`No image provider is configured. Credentials wanted \u2014 ${wanted}`);
 }
+function resolveFallbackOrder(requested, fallback, options) {
+  if (fallback === undefined) {
+    return { order: [requested], skipped: [] };
+  }
+  let candidates;
+  if (fallback === true) {
+    candidates = AUTO_ORDER.filter((name) => !NEVER_AUTO.has(name) && name !== requested);
+  } else {
+    const names = Object.keys(PROVIDERS).sort();
+    const seen = new Set([requested]);
+    const listed = [];
+    for (const name of fallback) {
+      if (PROVIDERS[name] === undefined) {
+        throw new Error(`Unknown fallback provider '${name}'. Valid providers: ${names.join(", ")}`);
+      }
+      if (!seen.has(name)) {
+        seen.add(name);
+        listed.push(name);
+      }
+    }
+    candidates = listed;
+  }
+  const order = [requested];
+  const skipped = [];
+  for (const name of candidates) {
+    const reason = options?.skipReason?.(name);
+    if (reason === undefined) {
+      order.push(name);
+    } else {
+      skipped.push({ provider: name, reason });
+    }
+  }
+  return { order, skipped };
+}
 
 // ../../plugins/generations/image-gen/src/index.ts
 var EMPTY_CONTENT = {
@@ -24659,6 +24788,13 @@ function defaultProviderResolver(spec) {
   }
   return registration.create();
 }
+function registeredProvider(name) {
+  const registration = PROVIDERS[name];
+  if (registration === undefined) {
+    throw new Error(`Provider '${name}' was selected but is missing from the registry`);
+  }
+  return registration.create();
+}
 function resolveMaxImages(spec) {
   if (spec.maxImages !== undefined) {
     return spec.maxImages;
@@ -24705,6 +24841,28 @@ function composePrompts(spec, format, style, doc2, positions) {
   const vars = spec.job === "free" ? { subject: doc2?.body ?? "", ...spec.vars ?? {} } : spec.vars ?? {};
   return [composePrompt(format, style, vars, spec.extra)];
 }
+function assertAnchorPlan(body, positions, count) {
+  const ranges = [];
+  for (let index = 0;index < count; index++) {
+    const anchor = positions?.[index];
+    if (anchor === undefined) {
+      throw new Error("Illustration anchor missing from metadata.positions");
+    }
+    const found = anchor === "" ? 0 : body.split(anchor).length - 1;
+    if (found !== 1) {
+      throw new Error(`Illustration anchor must occur exactly once in the source body, found ${found}: '${anchor.slice(0, 50)}'`);
+    }
+    const start = body.indexOf(anchor);
+    ranges.push({ anchor, start, end: start + anchor.length });
+  }
+  for (const [i, a] of ranges.entries()) {
+    for (const b of ranges.slice(i + 1)) {
+      if (a.start < b.end && b.start < a.end) {
+        throw new Error(`Illustration anchors overlap in the source body: '${a.anchor.slice(0, 50)}' and '${b.anchor.slice(0, 50)}'`);
+      }
+    }
+  }
+}
 async function processGeneratorIO(inputPath, outputPath, options = {}) {
   const fs2 = createNodeFileSystem();
   await fs2.deleteFile(outputPath);
@@ -24731,8 +24889,34 @@ async function processGeneratorIO(inputPath, outputPath, options = {}) {
     if (prompts.length > cap) {
       throw new Error(`Image count ${prompts.length} exceeds the budget cap ${cap} (raise ImageJobSpec.maxImages or KK_IMAGE_MAX_IMAGES)`);
     }
+    if (spec.job === "illustration")
+      assertAnchorPlan(doc2?.body ?? "", positions, prompts.length);
     const resolveProvider = options.providerResolver ?? defaultProviderResolver;
-    const provider = resolveProvider(spec);
+    const primary = resolveProvider(spec);
+    const built = new Map;
+    const createCandidate = (name) => {
+      const cached2 = built.get(name);
+      if (cached2 !== undefined) {
+        return cached2;
+      }
+      const created = options.createProvider !== undefined ? options.createProvider(name) : registeredProvider(name);
+      built.set(name, created);
+      return created;
+    };
+    const skipReason = (name) => {
+      const prospect = createCandidate(name);
+      if (!prospect.isAvailable()) {
+        return "not configured";
+      }
+      if (spec.referenceImages !== undefined && spec.referenceImages.length > 0 && !prospect.supportsReferenceImages(prospect.defaultModel())) {
+        return "no reference-image support";
+      }
+      return;
+    };
+    const { order, skipped } = resolveFallbackOrder(primary.name, spec.fallback, { skipReason });
+    for (const skip of skipped) {
+      echoError(`WARN image-gen: skipping fallback ${skip.provider} (${skip.reason})`);
+    }
     if (process.env.KK_IMAGE_DRY_RUN === "1") {
       const metadata2 = {
         generator: "kk:image-gen",
@@ -24760,16 +24944,49 @@ async function processGeneratorIO(inputPath, outputPath, options = {}) {
     const stem = outStemFor(outputPath, spec.outputStem);
     const artifacts = [];
     const captions = [];
+    const attempts = [];
+    let at = 0;
+    const generateWithFallback = async (image, prompt) => {
+      const start = attempts.length;
+      for (;; ) {
+        const name = order[at];
+        if (name === undefined) {
+          throw new Error(`image-gen: fallback order exhausted before image ${image} was decided`);
+        }
+        const provider = at === 0 ? primary : createCandidate(name);
+        const model = at === 0 ? spec.model ?? provider.defaultModel() : provider.defaultModel();
+        const request = {
+          prompt,
+          model,
+          aspectRatio: format.aspectRatio,
+          ...spec.referenceImages !== undefined && spec.referenceImages.length > 0 ? { referenceImages: spec.referenceImages } : {}
+        };
+        try {
+          provider.validate?.(request);
+          return await provider.generate(request);
+        } catch (err) {
+          if (spec.fallback === undefined) {
+            throw err;
+          }
+          const cls = classifyProviderError(err);
+          const message = err instanceof Error ? err.message : String(err);
+          if (!isFallbackEligible(cls)) {
+            throw new Error(`image-gen: ${provider.name} rejected the prompt (policy): ${message}; fallback does not apply`);
+          }
+          attempts.push({ image, provider: provider.name, model, errorClass: cls, message });
+          const next = order[at + 1];
+          if (next === undefined) {
+            const detail = attempts.slice(start).map((attempt) => `${attempt.provider} (${attempt.errorClass})`).join(", ");
+            throw new Error(`image-gen: all providers failed for image ${image}: ${detail}; ${message}`);
+          }
+          echoError(`WARN image-gen: ${provider.name} failed (${cls}): ${message}; falling back to ${next}`);
+          at += 1;
+        }
+      }
+    };
     let body = doc2?.body ?? "";
     for (const [index, prompt] of prompts.entries()) {
-      const request = {
-        prompt,
-        model: spec.model ?? provider.defaultModel(),
-        aspectRatio: format.aspectRatio,
-        ...spec.referenceImages && spec.referenceImages.length > 0 ? { referenceImages: spec.referenceImages } : {}
-      };
-      provider.validate?.(request);
-      const result = await provider.generate(request);
+      const result = await generateWithFallback(index + 1, prompt);
       let anchor;
       if (spec.job === "illustration") {
         anchor = positions?.[index];
@@ -24818,7 +25035,8 @@ async function processGeneratorIO(inputPath, outputPath, options = {}) {
       job: spec.job,
       images: artifacts,
       ...spec.job !== "free" && doc2?.id !== undefined ? { sourceDocId: doc2.id } : {},
-      ...captions.length > 0 ? { captions } : {}
+      ...captions.length > 0 ? { captions } : {},
+      ...attempts.length > 0 ? { attempts } : {}
     };
     const content = ContentSchema.parse({
       body: spec.job === "illustration" ? body : prompts.join(`
@@ -24867,6 +25085,7 @@ export {
   selectProvider,
   resolvePresetRoots,
   resolveMaxImages,
+  resolveFallbackOrder,
   renderTemplate,
   readPositions,
   processGeneratorIO,
@@ -24875,7 +25094,9 @@ export {
   mergeVars,
   main2 as main,
   loadPresets,
+  isFallbackEligible,
   composePrompt,
+  classifyProviderError,
   artifactPath,
   StylePresetSchema,
   PROVIDER_REQUEST_TIMEOUT_MS,