@code-yeongyu/senpi 2026.9.9-2 → 2026.9.10-2

package/node_modules/@earendil-works/pi-ai/dist/api/openai-images-edit.d.ts

@@ -1,4 +1,4 @@
 import type { ImageContent } from "../types.ts";
 import type { OpenAIImageParams } from "./openai-images-params.ts";
-export declare function buildEditParams(params: OpenAIImageParams, images: ImageContent[]): Promise<OpenAIImageParams>;
+export declare function buildEditParams(params: OpenAIImageParams, images: ImageContent[], mask?: ImageContent): Promise<OpenAIImageParams>;
 //# sourceMappingURL=openai-images-edit.d.ts.map

package/node_modules/@earendil-works/pi-ai/dist/api/openai-images-edit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openai-images-edit.d.ts","sourceRoot":"","sources":["../../src/api/openai-images-edit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,wBAAsB,eAAe,CAAC,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CASnH"}
+{"version":3,"file":"openai-images-edit.d.ts","sourceRoot":"","sources":["../../src/api/openai-images-edit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAQnE,wBAAsB,eAAe,CACpC,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,YAAY,EAAE,EACtB,IAAI,CAAC,EAAE,YAAY,GACjB,OAAO,CAAC,iBAAiB,CAAC,CAK5B"}

package/node_modules/@earendil-works/pi-ai/dist/api/openai-images-edit.js

@@ -1,11 +1,15 @@
 import { toFile } from "openai";
-export async function buildEditParams(params, images) {
+function upload(image, name) {
+    return toFile(Buffer.from(image.data, "base64"), `${name}.${image.mimeType.split("/")[1]}`, {
+        type: image.mimeType,
+    });
+}
+export async function buildEditParams(params, images, mask) {
     if (images.length > 16)
         throw new Error("OpenAI image edits accept at most 16 reference images");
-    const image = await Promise.all(images.map(({ data, mimeType }, i) => {
-        const ext = mimeType.split("/")[1];
-        return toFile(Buffer.from(data, "base64"), `reference-${i}.${ext}`, { type: mimeType });
-    }));
-    return { ...params, image };
+    const image = await Promise.all(images.map((reference, i) => upload(reference, `reference-${i}`)));
+    if (mask === undefined)
+        return { ...params, image };
+    return { ...params, image, mask: await upload(mask, "mask") };
 }
 //# sourceMappingURL=openai-images-edit.js.map

package/node_modules/@earendil-works/pi-ai/dist/api/openai-images-edit.js.map

@@ -1 +1 @@
-{"version":3,"file":"openai-images-edit.js","sourceRoot":"","sources":["../../src/api/openai-images-edit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAyB,EAAE,MAAsB;IACtF,IAAI,MAAM,CAAC,MAAM,GAAG,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IACjG,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE;QACpC,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACnC,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,aAAa,CAAC,IAAI,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IACzF,CAAC,CAAC,CACF,CAAC;IACF,OAAO,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC","sourcesContent":["import { toFile } from \"openai\";\nimport type { ImageContent } from \"../types.ts\";\nimport type { OpenAIImageParams } from \"./openai-images-params.ts\";\n\nexport async function buildEditParams(params: OpenAIImageParams, images: ImageContent[]): Promise<OpenAIImageParams> {\n\tif (images.length > 16) throw new Error(\"OpenAI image edits accept at most 16 reference images\");\n\tconst image = await Promise.all(\n\t\timages.map(({ data, mimeType }, i) => {\n\t\t\tconst ext = mimeType.split(\"/\")[1];\n\t\t\treturn toFile(Buffer.from(data, \"base64\"), `reference-${i}.${ext}`, { type: mimeType });\n\t\t}),\n\t);\n\treturn { ...params, image };\n}\n"]}
+{"version":3,"file":"openai-images-edit.js","sourceRoot":"","sources":["../../src/api/openai-images-edit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,SAAS,MAAM,CAAC,KAAmB,EAAE,IAAY;IAChD,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,GAAG,IAAI,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE;QAC3F,IAAI,EAAE,KAAK,CAAC,QAAQ;KACpB,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACpC,MAAyB,EACzB,MAAsB,EACtB,IAAmB;IAEnB,IAAI,MAAM,CAAC,MAAM,GAAG,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IACjG,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACnG,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC;IACpD,OAAO,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;AAC/D,CAAC","sourcesContent":["import { toFile } from \"openai\";\nimport type { ImageContent } from \"../types.ts\";\nimport type { OpenAIImageParams } from \"./openai-images-params.ts\";\n\nfunction upload(image: ImageContent, name: string) {\n\treturn toFile(Buffer.from(image.data, \"base64\"), `${name}.${image.mimeType.split(\"/\")[1]}`, {\n\t\ttype: image.mimeType,\n\t});\n}\n\nexport async function buildEditParams(\n\tparams: OpenAIImageParams,\n\timages: ImageContent[],\n\tmask?: ImageContent,\n): Promise<OpenAIImageParams> {\n\tif (images.length > 16) throw new Error(\"OpenAI image edits accept at most 16 reference images\");\n\tconst image = await Promise.all(images.map((reference, i) => upload(reference, `reference-${i}`)));\n\tif (mask === undefined) return { ...params, image };\n\treturn { ...params, image, mask: await upload(mask, \"mask\") };\n}\n"]}

package/node_modules/@earendil-works/pi-ai/dist/api/openai-images-params.d.ts

@@ -1,17 +1,30 @@
 import type { Uploadable } from "openai";
 import type { ImageGenerateParamsNonStreaming } from "openai/resources/images.js";
-import type { ImagesContext, ImagesModel, ImagesOptions } from "../types.ts";
+import type { ImageContent, ImagesContext, ImagesModel, ImagesOptions } from "../types.ts";
 export type OpenAIImageQuality = "auto" | "low" | "medium" | "high" | "xhigh" | "max";
 export type OpenAIImageSize = "auto" | "1024x1024" | "1536x1024" | "1024x1536" | `${number}x${number}`;
+export type OpenAIImageBackground = "auto" | "transparent" | "opaque";
+export type OpenAIImageOutputFormat = "png" | "jpeg" | "webp";
+export type OpenAIImageModeration = "auto" | "low";
 export interface OpenAIImagesOptions extends ImagesOptions {
     size?: OpenAIImageSize;
     quality?: OpenAIImageQuality;
     n?: number;
+    /** Output transparency. `transparent` requires `outputFormat` png or webp. */
+    background?: OpenAIImageBackground;
+    /** Container of the returned bytes. Default png. */
+    outputFormat?: OpenAIImageOutputFormat;
+    /** 0-100 compression for jpeg/webp output only. */
+    outputCompression?: number;
+    moderation?: OpenAIImageModeration;
+    /** Inpainting mask applied to the first input image; requires at least one image input. */
+    mask?: ImageContent;
 }
 export type OpenAIImageParams = Omit<ImageGenerateParamsNonStreaming, "size" | "quality"> & {
     size?: OpenAIImageSize;
     quality?: OpenAIImageQuality;
     image?: Uploadable[];
+    mask?: Uploadable;
 };
 export declare function parseOpenAIImageSize(size: string): {
     ok: true;
@@ -20,6 +33,28 @@ export declare function parseOpenAIImageSize(size: string): {
     ok: false;
     error: string;
 };
+export interface OpenAIImageOutputOptionsInput {
+    background?: OpenAIImageBackground | undefined;
+    outputFormat?: OpenAIImageOutputFormat | undefined;
+    outputCompression?: number | undefined;
+    /** Whether an inpainting mask accompanies the request. */
+    hasMask: boolean;
+    /** Number of image inputs (references or edit targets) in the request. */
+    imageCount: number;
+}
+export type OpenAIImageOutputOptions = {
+    ok: true;
+    outputFormat: OpenAIImageOutputFormat;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Validates the output-shaping options before any request leaves the process.
+ * Mirrors the Images API contract: transparency needs an alpha-capable container,
+ * compression is a jpeg/webp-only integer percentage, and a mask edits an image.
+ */
+export declare function parseOpenAIImageOutputOptions(input: OpenAIImageOutputOptionsInput): OpenAIImageOutputOptions;
 export declare function buildParams(model: ImagesModel<"openai-images">, context: ImagesContext, options?: OpenAIImagesOptions): OpenAIImageParams;
 export declare function isImageParams(value: unknown): value is OpenAIImageParams;
 //# sourceMappingURL=openai-images-params.d.ts.map

package/node_modules/@earendil-works/pi-ai/dist/api/openai-images-params.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openai-images-params.d.ts","sourceRoot":"","sources":["../../src/api/openai-images-params.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,4BAA4B,CAAC;AAClF,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAK7E,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AACtF,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;AAEvG,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACzD,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,CAAC,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,+BAA+B,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG;IAC3F,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;CACrB,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAqB5G;AAED,wBAAgB,WAAW,CAC1B,KAAK,EAAE,WAAW,CAAC,eAAe,CAAC,EACnC,OAAO,EAAE,aAAa,EACtB,OAAO,CAAC,EAAE,mBAAmB,GAC3B,iBAAiB,CAwBnB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAExE"}
+{"version":3,"file":"openai-images-params.d.ts","sourceRoot":"","sources":["../../src/api/openai-images-params.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,4BAA4B,CAAC;AAClF,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAK3F,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AACtF,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;AACvG,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,aAAa,GAAG,QAAQ,CAAC;AACtE,MAAM,MAAM,uBAAuB,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAC9D,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,KAAK,CAAC;AAEnD,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACzD,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,8EAA8E;IAC9E,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,oDAAoD;IACpD,YAAY,CAAC,EAAE,uBAAuB,CAAC;IACvC,mDAAmD;IACnD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,2FAA2F;IAC3F,IAAI,CAAC,EAAE,YAAY,CAAC;CACpB;AAED,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,+BAA+B,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG;IAC3F,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,IAAI,CAAC,EAAE,UAAU,CAAC;CAClB,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAqB5G;AAED,MAAM,WAAW,6BAA6B;IAC7C,UAAU,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAC;IAC/C,YAAY,CAAC,EAAE,uBAAuB,GAAG,SAAS,CAAC;IACnD,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,0DAA0D;IAC1D,OAAO,EAAE,OAAO,CAAC;IACjB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,wBAAwB,GACjC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,YAAY,EAAE,uBAAuB,CAAA;CAAE,GACnD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhC;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,6BAA6B,GAAG,wBAAwB,CAiB5G;AAED,wBAAgB,WAAW,CAC1B,KAAK,EAAE,WAAW,CAAC,eAAe,CAAC,EACnC,OAAO,EAAE,aAAa,EACtB,OAAO,CAAC,EAAE,mBAAmB,GAC3B,iBAAiB,CAmCnB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAExE"}

package/node_modules/@earendil-works/pi-ai/dist/api/openai-images-params.js

@@ -23,6 +23,29 @@ export function parseOpenAIImageSize(size) {
     }
     return { ok: true, size };
 }
+/**
+ * Validates the output-shaping options before any request leaves the process.
+ * Mirrors the Images API contract: transparency needs an alpha-capable container,
+ * compression is a jpeg/webp-only integer percentage, and a mask edits an image.
+ */
+export function parseOpenAIImageOutputOptions(input) {
+    const outputFormat = input.outputFormat ?? "png";
+    if (input.background === "transparent" && outputFormat === "jpeg") {
+        return { ok: false, error: "OpenAI image background transparent requires output_format png or webp" };
+    }
+    if (input.outputCompression !== undefined) {
+        if (outputFormat === "png") {
+            return { ok: false, error: "OpenAI image output_compression requires output_format jpeg or webp" };
+        }
+        if (!Number.isInteger(input.outputCompression) || input.outputCompression < 0 || input.outputCompression > 100) {
+            return { ok: false, error: "OpenAI image output_compression must be an integer between 0 and 100" };
+        }
+    }
+    if (input.hasMask && input.imageCount === 0) {
+        return { ok: false, error: "OpenAI image mask requires at least one input image" };
+    }
+    return { ok: true, outputFormat };
+}
 export function buildParams(model, context, options) {
     const promptParts = [];
     for (const item of context.input) {
@@ -42,14 +65,26 @@ export function buildParams(model, context, options) {
     const parsedSize = parseOpenAIImageSize(size);
     if (!parsedSize.ok)
         throw new Error(parsedSize.error);
+    const output = parseOpenAIImageOutputOptions({
+        background: options?.background,
+        outputFormat: options?.outputFormat,
+        outputCompression: options?.outputCompression,
+        hasMask: options?.mask !== undefined,
+        imageCount: context.input.filter((item) => item.type === "image").length,
+    });
+    if (!output.ok)
+        throw new Error(output.error);
     return {
         model: model.id,
         prompt,
         size,
         quality: options?.quality ?? "auto",
         n: options?.n ?? 1,
-        output_format: "png",
+        output_format: output.outputFormat,
         stream: false,
+        ...(options?.background === undefined ? {} : { background: options.background }),
+        ...(options?.outputCompression === undefined ? {} : { output_compression: options.outputCompression }),
+        ...(options?.moderation === undefined ? {} : { moderation: options.moderation }),
     };
 }
 export function isImageParams(value) {

package/node_modules/@earendil-works/pi-ai/dist/api/openai-images-params.js.map

@@ -1 +1 @@
-{"version":3,"file":"openai-images-params.js","sourceRoot":"","sources":["../../src/api/openai-images-params.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Uploadable } from \"openai\";\nimport type { ImageGenerateParamsNonStreaming } from \"openai/resources/images.js\";\nimport type { ImagesContext, ImagesModel, ImagesOptions } from \"../types.ts\";\nimport { sanitizeSurrogates } from \"../utils/sanitize-unicode.ts\";\n\nconst MAX_PROMPT_CHARS = 32_000;\n\nexport type OpenAIImageQuality = \"auto\" | \"low\" | \"medium\" | \"high\" | \"xhigh\" | \"max\";\nexport type OpenAIImageSize = \"auto\" | \"1024x1024\" | \"1536x1024\" | \"1024x1536\" | `${number}x${number}`;\n\nexport interface OpenAIImagesOptions extends ImagesOptions {\n\tsize?: OpenAIImageSize;\n\tquality?: OpenAIImageQuality;\n\tn?: number;\n}\n\nexport type OpenAIImageParams = Omit<ImageGenerateParamsNonStreaming, \"size\" | \"quality\"> & {\n\tsize?: OpenAIImageSize;\n\tquality?: OpenAIImageQuality;\n\timage?: Uploadable[];\n};\n\nexport function parseOpenAIImageSize(size: string): { ok: true; size: string } | { ok: false; error: string } {\n\tif ([\"auto\", \"1024x1024\", \"1536x1024\", \"1024x1536\"].includes(size)) return { ok: true, size };\n\tconst match = /^\\d+x\\d+$/.exec(size);\n\tif (!match || match[0] !== size) {\n\t\treturn { ok: false, error: \"OpenAI image size must be auto or WIDTHxHEIGHT with integer dimensions\" };\n\t}\n\tconst [width, height] = size.split(\"x\").map(Number);\n\tif (width > 3840 || height > 3840) {\n\t\treturn { ok: false, error: \"OpenAI image size edges must be at most 3840 pixels\" };\n\t}\n\tif (width % 16 !== 0 || height % 16 !== 0) {\n\t\treturn { ok: false, error: \"OpenAI image size width and height must be divisible by 16\" };\n\t}\n\tif (width > height * 3 || height > width * 3) {\n\t\treturn { ok: false, error: \"OpenAI image size aspect ratio must be between 1:3 and 3:1 inclusive\" };\n\t}\n\tconst pixels = width * height;\n\tif (pixels < 655360 || pixels > 8294400) {\n\t\treturn { ok: false, error: \"OpenAI image size must contain between 655360 and 8294400 pixels inclusive\" };\n\t}\n\treturn { ok: true, size };\n}\n\nexport function buildParams(\n\tmodel: ImagesModel<\"openai-images\">,\n\tcontext: ImagesContext,\n\toptions?: OpenAIImagesOptions,\n): OpenAIImageParams {\n\tconst promptParts: string[] = [];\n\tfor (const item of context.input) {\n\t\tif (item.type !== \"text\") continue;\n\t\tconst text = sanitizeSurrogates(item.text);\n\t\tif (text.trim()) promptParts.push(text);\n\t}\n\tconst prompt = promptParts.join(\"\\n\\n\");\n\tif (!prompt.trim()) throw new Error(\"Image generation requires a non-empty text prompt\");\n\tif (prompt.length > MAX_PROMPT_CHARS) {\n\t\tthrow new Error(`Image generation prompt exceeds ${MAX_PROMPT_CHARS} characters`);\n\t}\n\tconst size = options?.size ?? \"auto\";\n\tconst parsedSize = parseOpenAIImageSize(size);\n\tif (!parsedSize.ok) throw new Error(parsedSize.error);\n\treturn {\n\t\tmodel: model.id,\n\t\tprompt,\n\t\tsize,\n\t\tquality: options?.quality ?? \"auto\",\n\t\tn: options?.n ?? 1,\n\t\toutput_format: \"png\",\n\t\tstream: false,\n\t};\n}\n\nexport function isImageParams(value: unknown): value is OpenAIImageParams {\n\treturn typeof value === \"object\" && value !== null && \"prompt\" in value && typeof value.prompt === \"string\";\n}\n"]}
+{"version":3,"file":"openai-images-params.js","sourceRoot":"","sources":["../../src/api/openai-images-params.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Uploadable } from \"openai\";\nimport type { ImageGenerateParamsNonStreaming } from \"openai/resources/images.js\";\nimport type { ImageContent, ImagesContext, ImagesModel, ImagesOptions } from \"../types.ts\";\nimport { sanitizeSurrogates } from \"../utils/sanitize-unicode.ts\";\n\nconst MAX_PROMPT_CHARS = 32_000;\n\nexport type OpenAIImageQuality = \"auto\" | \"low\" | \"medium\" | \"high\" | \"xhigh\" | \"max\";\nexport type OpenAIImageSize = \"auto\" | \"1024x1024\" | \"1536x1024\" | \"1024x1536\" | `${number}x${number}`;\nexport type OpenAIImageBackground = \"auto\" | \"transparent\" | \"opaque\";\nexport type OpenAIImageOutputFormat = \"png\" | \"jpeg\" | \"webp\";\nexport type OpenAIImageModeration = \"auto\" | \"low\";\n\nexport interface OpenAIImagesOptions extends ImagesOptions {\n\tsize?: OpenAIImageSize;\n\tquality?: OpenAIImageQuality;\n\tn?: number;\n\t/** Output transparency. `transparent` requires `outputFormat` png or webp. */\n\tbackground?: OpenAIImageBackground;\n\t/** Container of the returned bytes. Default png. */\n\toutputFormat?: OpenAIImageOutputFormat;\n\t/** 0-100 compression for jpeg/webp output only. */\n\toutputCompression?: number;\n\tmoderation?: OpenAIImageModeration;\n\t/** Inpainting mask applied to the first input image; requires at least one image input. */\n\tmask?: ImageContent;\n}\n\nexport type OpenAIImageParams = Omit<ImageGenerateParamsNonStreaming, \"size\" | \"quality\"> & {\n\tsize?: OpenAIImageSize;\n\tquality?: OpenAIImageQuality;\n\timage?: Uploadable[];\n\tmask?: Uploadable;\n};\n\nexport function parseOpenAIImageSize(size: string): { ok: true; size: string } | { ok: false; error: string } {\n\tif ([\"auto\", \"1024x1024\", \"1536x1024\", \"1024x1536\"].includes(size)) return { ok: true, size };\n\tconst match = /^\\d+x\\d+$/.exec(size);\n\tif (!match || match[0] !== size) {\n\t\treturn { ok: false, error: \"OpenAI image size must be auto or WIDTHxHEIGHT with integer dimensions\" };\n\t}\n\tconst [width, height] = size.split(\"x\").map(Number);\n\tif (width > 3840 || height > 3840) {\n\t\treturn { ok: false, error: \"OpenAI image size edges must be at most 3840 pixels\" };\n\t}\n\tif (width % 16 !== 0 || height % 16 !== 0) {\n\t\treturn { ok: false, error: \"OpenAI image size width and height must be divisible by 16\" };\n\t}\n\tif (width > height * 3 || height > width * 3) {\n\t\treturn { ok: false, error: \"OpenAI image size aspect ratio must be between 1:3 and 3:1 inclusive\" };\n\t}\n\tconst pixels = width * height;\n\tif (pixels < 655360 || pixels > 8294400) {\n\t\treturn { ok: false, error: \"OpenAI image size must contain between 655360 and 8294400 pixels inclusive\" };\n\t}\n\treturn { ok: true, size };\n}\n\nexport interface OpenAIImageOutputOptionsInput {\n\tbackground?: OpenAIImageBackground | undefined;\n\toutputFormat?: OpenAIImageOutputFormat | undefined;\n\toutputCompression?: number | undefined;\n\t/** Whether an inpainting mask accompanies the request. */\n\thasMask: boolean;\n\t/** Number of image inputs (references or edit targets) in the request. */\n\timageCount: number;\n}\n\nexport type OpenAIImageOutputOptions =\n\t| { ok: true; outputFormat: OpenAIImageOutputFormat }\n\t| { ok: false; error: string };\n\n/**\n * Validates the output-shaping options before any request leaves the process.\n * Mirrors the Images API contract: transparency needs an alpha-capable container,\n * compression is a jpeg/webp-only integer percentage, and a mask edits an image.\n */\nexport function parseOpenAIImageOutputOptions(input: OpenAIImageOutputOptionsInput): OpenAIImageOutputOptions {\n\tconst outputFormat = input.outputFormat ?? \"png\";\n\tif (input.background === \"transparent\" && outputFormat === \"jpeg\") {\n\t\treturn { ok: false, error: \"OpenAI image background transparent requires output_format png or webp\" };\n\t}\n\tif (input.outputCompression !== undefined) {\n\t\tif (outputFormat === \"png\") {\n\t\t\treturn { ok: false, error: \"OpenAI image output_compression requires output_format jpeg or webp\" };\n\t\t}\n\t\tif (!Number.isInteger(input.outputCompression) || input.outputCompression < 0 || input.outputCompression > 100) {\n\t\t\treturn { ok: false, error: \"OpenAI image output_compression must be an integer between 0 and 100\" };\n\t\t}\n\t}\n\tif (input.hasMask && input.imageCount === 0) {\n\t\treturn { ok: false, error: \"OpenAI image mask requires at least one input image\" };\n\t}\n\treturn { ok: true, outputFormat };\n}\n\nexport function buildParams(\n\tmodel: ImagesModel<\"openai-images\">,\n\tcontext: ImagesContext,\n\toptions?: OpenAIImagesOptions,\n): OpenAIImageParams {\n\tconst promptParts: string[] = [];\n\tfor (const item of context.input) {\n\t\tif (item.type !== \"text\") continue;\n\t\tconst text = sanitizeSurrogates(item.text);\n\t\tif (text.trim()) promptParts.push(text);\n\t}\n\tconst prompt = promptParts.join(\"\\n\\n\");\n\tif (!prompt.trim()) throw new Error(\"Image generation requires a non-empty text prompt\");\n\tif (prompt.length > MAX_PROMPT_CHARS) {\n\t\tthrow new Error(`Image generation prompt exceeds ${MAX_PROMPT_CHARS} characters`);\n\t}\n\tconst size = options?.size ?? \"auto\";\n\tconst parsedSize = parseOpenAIImageSize(size);\n\tif (!parsedSize.ok) throw new Error(parsedSize.error);\n\tconst output = parseOpenAIImageOutputOptions({\n\t\tbackground: options?.background,\n\t\toutputFormat: options?.outputFormat,\n\t\toutputCompression: options?.outputCompression,\n\t\thasMask: options?.mask !== undefined,\n\t\timageCount: context.input.filter((item) => item.type === \"image\").length,\n\t});\n\tif (!output.ok) throw new Error(output.error);\n\treturn {\n\t\tmodel: model.id,\n\t\tprompt,\n\t\tsize,\n\t\tquality: options?.quality ?? \"auto\",\n\t\tn: options?.n ?? 1,\n\t\toutput_format: output.outputFormat,\n\t\tstream: false,\n\t\t...(options?.background === undefined ? {} : { background: options.background }),\n\t\t...(options?.outputCompression === undefined ? {} : { output_compression: options.outputCompression }),\n\t\t...(options?.moderation === undefined ? {} : { moderation: options.moderation }),\n\t};\n}\n\nexport function isImageParams(value: unknown): value is OpenAIImageParams {\n\treturn typeof value === \"object\" && value !== null && \"prompt\" in value && typeof value.prompt === \"string\";\n}\n"]}

package/node_modules/@earendil-works/pi-ai/dist/api/openai-images-result.d.ts

@@ -0,0 +1,12 @@
+import type { Image } from "openai/resources/images.js";
+import type { ImageContent } from "../types.ts";
+import type { OpenAIImageOutputFormat, OpenAIImagesOptions } from "./openai-images-params.ts";
+/** The container the request asked for; a replaced payload without one falls back to the API default. */
+export declare function requestedOutputFormat(value: unknown): OpenAIImageOutputFormat;
+/**
+ * Decodes one response datum. Inline base64 is labeled by its magic bytes, falling back to
+ * the requested container only when the header is unrecognizable: gateways can ignore
+ * `output_format` and return png, and a wrong label would follow the file to disk.
+ */
+export declare function resolveImage(datum: Image, outputFormat: OpenAIImageOutputFormat, options?: OpenAIImagesOptions): Promise<ImageContent>;
+//# sourceMappingURL=openai-images-result.d.ts.map

package/node_modules/@earendil-works/pi-ai/dist/api/openai-images-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-images-result.d.ts","sourceRoot":"","sources":["../../src/api/openai-images-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAS9F,yGAAyG;AACzG,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,uBAAuB,CAE7E;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CACjC,KAAK,EAAE,KAAK,EACZ,YAAY,EAAE,uBAAuB,EACrC,OAAO,CAAC,EAAE,mBAAmB,GAC3B,OAAO,CAAC,YAAY,CAAC,CAUvB"}

package/node_modules/@earendil-works/pi-ai/dist/api/openai-images-result.js

@@ -0,0 +1,96 @@
+const MAX_IMAGE_BYTES = 24 * 1024 * 1024;
+const PNG_MAGIC = [0x89, 0x50, 0x4e, 0x47];
+const JPEG_MAGIC = [0xff, 0xd8, 0xff];
+const WEBP_MAGIC = [0x52, 0x49, 0x46, 0x46, 0x57, 0x45, 0x42, 0x50];
+/** The container the request asked for; a replaced payload without one falls back to the API default. */
+export function requestedOutputFormat(value) {
+    return value === "jpeg" || value === "webp" ? value : "png";
+}
+/**
+ * Decodes one response datum. Inline base64 is labeled by its magic bytes, falling back to
+ * the requested container only when the header is unrecognizable: gateways can ignore
+ * `output_format` and return png, and a wrong label would follow the file to disk.
+ */
+export async function resolveImage(datum, outputFormat, options) {
+    const b64 = datum.b64_json?.trim();
+    if (b64) {
+        const detected = detectMime(Buffer.from(b64.slice(0, 24), "base64"));
+        return { type: "image", mimeType: detected ?? `image/${outputFormat}`, data: b64 };
+    }
+    const url = datum.url?.trim();
+    if (!url)
+        throw new Error("OpenAI images response datum contained no image data");
+    if (url.startsWith("data:"))
+        return parseDataUrl(url);
+    return hydrateImageUrl(url, options);
+}
+function parseDataUrl(url) {
+    const match = /^data:([^;,]+);base64,(.+)$/i.exec(url);
+    if (!match?.[1] || !match[2])
+        throw new Error("OpenAI images response contained an invalid data URL");
+    const mimeType = supportedMime(match[1]);
+    if (!mimeType)
+        throw new Error(`OpenAI images response used unsupported MIME type: ${match[1]}`);
+    return { type: "image", mimeType, data: match[2] };
+}
+async function hydrateImageUrl(url, options) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        throw new Error("OpenAI images response URL must be absolute");
+    }
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+        throw new Error("OpenAI images response URL must use HTTP or HTTPS");
+    }
+    const response = await (options?.fetch ?? globalThis.fetch)(url, options?.signal ? { signal: options.signal } : {});
+    if (!response.ok)
+        throw new Error(`OpenAI image hydration failed with HTTP ${response.status}`);
+    const declaredLength = response.headers.get("content-length");
+    if (declaredLength && Number(declaredLength) > MAX_IMAGE_BYTES)
+        throw oversizedImageError();
+    const bytes = new Uint8Array(await response.arrayBuffer());
+    if (bytes.byteLength === 0)
+        throw new Error("OpenAI image hydration returned an empty body");
+    if (bytes.byteLength > MAX_IMAGE_BYTES)
+        throw oversizedImageError();
+    const declaredMime = supportedMime(response.headers.get("content-type")?.split(";", 1)[0]);
+    const detectedMime = detectMime(bytes);
+    if (declaredMime && detectedMime && declaredMime !== detectedMime) {
+        throw new Error(`OpenAI image MIME mismatch: declared ${declaredMime}, detected ${detectedMime}`);
+    }
+    const mimeType = detectedMime ?? declaredMime;
+    if (!mimeType)
+        throw new Error("OpenAI image hydration returned unsupported image content");
+    return { type: "image", mimeType, data: bytesToBase64(bytes) };
+}
+function supportedMime(value) {
+    const normalized = value?.trim().toLowerCase();
+    if (normalized === "image/png" || normalized === "image/jpeg" || normalized === "image/webp")
+        return normalized;
+    return undefined;
+}
+function detectMime(bytes) {
+    if (hasMagic(bytes, PNG_MAGIC))
+        return "image/png";
+    if (hasMagic(bytes, JPEG_MAGIC))
+        return "image/jpeg";
+    if (hasMagic(bytes, WEBP_MAGIC.slice(0, 4)) && hasMagic(bytes, WEBP_MAGIC.slice(4), 8))
+        return "image/webp";
+    return undefined;
+}
+function hasMagic(bytes, magic, offset = 0) {
+    return magic.every((value, index) => bytes[offset + index] === value);
+}
+function bytesToBase64(bytes) {
+    let binary = "";
+    for (let offset = 0; offset < bytes.length; offset += 0x8000) {
+        binary += String.fromCharCode(...bytes.subarray(offset, offset + 0x8000));
+    }
+    return btoa(binary);
+}
+function oversizedImageError() {
+    return new Error("OpenAI image hydration exceeded the 24 MiB limit");
+}
+//# sourceMappingURL=openai-images-result.js.map

package/node_modules/@earendil-works/pi-ai/dist/api/openai-images-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-images-result.js","sourceRoot":"","sources":["../../src/api/openai-images-result.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Image } from \"openai/resources/images.js\";\nimport type { ImageContent } from \"../types.ts\";\nimport type { OpenAIImageOutputFormat, OpenAIImagesOptions } from \"./openai-images-params.ts\";\n\nconst MAX_IMAGE_BYTES = 24 * 1024 * 1024;\nconst PNG_MAGIC = [0x89, 0x50, 0x4e, 0x47] as const;\nconst JPEG_MAGIC = [0xff, 0xd8, 0xff] as const;\nconst WEBP_MAGIC = [0x52, 0x49, 0x46, 0x46, 0x57, 0x45, 0x42, 0x50] as const;\n\ntype SupportedImageMime = \"image/png\" | \"image/jpeg\" | \"image/webp\";\n\n/** The container the request asked for; a replaced payload without one falls back to the API default. */\nexport function requestedOutputFormat(value: unknown): OpenAIImageOutputFormat {\n\treturn value === \"jpeg\" || value === \"webp\" ? value : \"png\";\n}\n\n/**\n * Decodes one response datum. Inline base64 is labeled by its magic bytes, falling back to\n * the requested container only when the header is unrecognizable: gateways can ignore\n * `output_format` and return png, and a wrong label would follow the file to disk.\n */\nexport async function resolveImage(\n\tdatum: Image,\n\toutputFormat: OpenAIImageOutputFormat,\n\toptions?: OpenAIImagesOptions,\n): Promise<ImageContent> {\n\tconst b64 = datum.b64_json?.trim();\n\tif (b64) {\n\t\tconst detected = detectMime(Buffer.from(b64.slice(0, 24), \"base64\"));\n\t\treturn { type: \"image\", mimeType: detected ?? `image/${outputFormat}`, data: b64 };\n\t}\n\tconst url = datum.url?.trim();\n\tif (!url) throw new Error(\"OpenAI images response datum contained no image data\");\n\tif (url.startsWith(\"data:\")) return parseDataUrl(url);\n\treturn hydrateImageUrl(url, options);\n}\n\nfunction parseDataUrl(url: string): ImageContent {\n\tconst match = /^data:([^;,]+);base64,(.+)$/i.exec(url);\n\tif (!match?.[1] || !match[2]) throw new Error(\"OpenAI images response contained an invalid data URL\");\n\tconst mimeType = supportedMime(match[1]);\n\tif (!mimeType) throw new Error(`OpenAI images response used unsupported MIME type: ${match[1]}`);\n\treturn { type: \"image\", mimeType, data: match[2] };\n}\n\nasync function hydrateImageUrl(url: string, options?: OpenAIImagesOptions): Promise<ImageContent> {\n\tlet parsed: URL;\n\ttry {\n\t\tparsed = new URL(url);\n\t} catch {\n\t\tthrow new Error(\"OpenAI images response URL must be absolute\");\n\t}\n\tif (parsed.protocol !== \"http:\" && parsed.protocol !== \"https:\") {\n\t\tthrow new Error(\"OpenAI images response URL must use HTTP or HTTPS\");\n\t}\n\tconst response = await (options?.fetch ?? globalThis.fetch)(url, options?.signal ? { signal: options.signal } : {});\n\tif (!response.ok) throw new Error(`OpenAI image hydration failed with HTTP ${response.status}`);\n\tconst declaredLength = response.headers.get(\"content-length\");\n\tif (declaredLength && Number(declaredLength) > MAX_IMAGE_BYTES) throw oversizedImageError();\n\tconst bytes = new Uint8Array(await response.arrayBuffer());\n\tif (bytes.byteLength === 0) throw new Error(\"OpenAI image hydration returned an empty body\");\n\tif (bytes.byteLength > MAX_IMAGE_BYTES) throw oversizedImageError();\n\tconst declaredMime = supportedMime(response.headers.get(\"content-type\")?.split(\";\", 1)[0]);\n\tconst detectedMime = detectMime(bytes);\n\tif (declaredMime && detectedMime && declaredMime !== detectedMime) {\n\t\tthrow new Error(`OpenAI image MIME mismatch: declared ${declaredMime}, detected ${detectedMime}`);\n\t}\n\tconst mimeType = detectedMime ?? declaredMime;\n\tif (!mimeType) throw new Error(\"OpenAI image hydration returned unsupported image content\");\n\treturn { type: \"image\", mimeType, data: bytesToBase64(bytes) };\n}\n\nfunction supportedMime(value: string | undefined): SupportedImageMime | undefined {\n\tconst normalized = value?.trim().toLowerCase();\n\tif (normalized === \"image/png\" || normalized === \"image/jpeg\" || normalized === \"image/webp\") return normalized;\n\treturn undefined;\n}\n\nfunction detectMime(bytes: Uint8Array): SupportedImageMime | undefined {\n\tif (hasMagic(bytes, PNG_MAGIC)) return \"image/png\";\n\tif (hasMagic(bytes, JPEG_MAGIC)) return \"image/jpeg\";\n\tif (hasMagic(bytes, WEBP_MAGIC.slice(0, 4)) && hasMagic(bytes, WEBP_MAGIC.slice(4), 8)) return \"image/webp\";\n\treturn undefined;\n}\n\nfunction hasMagic(bytes: Uint8Array, magic: readonly number[], offset = 0): boolean {\n\treturn magic.every((value, index) => bytes[offset + index] === value);\n}\n\nfunction bytesToBase64(bytes: Uint8Array): string {\n\tlet binary = \"\";\n\tfor (let offset = 0; offset < bytes.length; offset += 0x8000) {\n\t\tbinary += String.fromCharCode(...bytes.subarray(offset, offset + 0x8000));\n\t}\n\treturn btoa(binary);\n}\n\nfunction oversizedImageError(): Error {\n\treturn new Error(\"OpenAI image hydration exceeded the 24 MiB limit\");\n}\n"]}

package/node_modules/@earendil-works/pi-ai/dist/api/openai-images.d.ts

@@ -1,5 +1,5 @@
 import type { ImagesFunction } from "../types.ts";
 import { type OpenAIImagesOptions } from "./openai-images-params.ts";
-export { type OpenAIImageQuality, type OpenAIImageSize, type OpenAIImagesOptions, parseOpenAIImageSize, } from "./openai-images-params.ts";
+export { type OpenAIImageBackground, type OpenAIImageModeration, type OpenAIImageOutputFormat, type OpenAIImageQuality, type OpenAIImageSize, type OpenAIImagesOptions, parseOpenAIImageOutputOptions, parseOpenAIImageSize, } from "./openai-images-params.ts";
 export declare const generateImages: ImagesFunction<"openai-images", OpenAIImagesOptions>;
 //# sourceMappingURL=openai-images.d.ts.map

package/node_modules/@earendil-works/pi-ai/dist/api/openai-images.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openai-images.d.ts","sourceRoot":"","sources":["../../src/api/openai-images.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAIX,cAAc,EAId,MAAM,aAAa,CAAC;AAMrB,OAAO,EAA8B,KAAK,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEjG,OAAO,EACN,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,oBAAoB,GACpB,MAAM,2BAA2B,CAAC;AAUnC,eAAO,MAAM,cAAc,EAAE,cAAc,CAAC,eAAe,EAAE,mBAAmB,CA0E/E,CAAC"}
+{"version":3,"file":"openai-images.d.ts","sourceRoot":"","sources":["../../src/api/openai-images.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAIX,cAAc,EAId,MAAM,aAAa,CAAC;AAMrB,OAAO,EAA8B,KAAK,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAGjG,OAAO,EACN,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,6BAA6B,EAC7B,oBAAoB,GACpB,MAAM,2BAA2B,CAAC;AAInC,eAAO,MAAM,cAAc,EAAE,cAAc,CAAC,eAAe,EAAE,mBAAmB,CA8E/E,CAAC"}

package/node_modules/@earendil-works/pi-ai/dist/api/openai-images.js

@@ -5,12 +5,9 @@ import { retryProviderRequest } from "../utils/provider-retry.js";
 import { resolveOpenAIClientAuth } from "./openai-client-auth.js";
 import { buildEditParams } from "./openai-images-edit.js";
 import { buildParams, isImageParams } from "./openai-images-params.js";
-export { parseOpenAIImageSize, } from "./openai-images-params.js";
-const MAX_IMAGE_BYTES = 24 * 1024 * 1024;
+import { requestedOutputFormat, resolveImage } from "./openai-images-result.js";
+export { parseOpenAIImageOutputOptions, parseOpenAIImageSize, } from "./openai-images-params.js";
 const ENDPOINT_SUFFIXES = ["/chat/completions", "/responses", "/models"];
-const PNG_MAGIC = [0x89, 0x50, 0x4e, 0x47];
-const JPEG_MAGIC = [0xff, 0xd8, 0xff];
-const WEBP_MAGIC = [0x52, 0x49, 0x46, 0x46, 0x57, 0x45, 0x42, 0x50];
 export const generateImages = async (model, context, options) => {
     const output = {
         api: model.api,
@@ -25,7 +22,7 @@ export const generateImages = async (model, context, options) => {
         const images = context.input.filter((item) => item.type === "image");
         const method = images.length > 0 ? "edit" : "generate";
         if (method === "edit")
-            params = await buildEditParams(params, images);
+            params = await buildEditParams(params, images, options?.mask);
         const nextParams = await options?.onPayload?.(params, model);
         if (nextParams !== undefined) {
             if (!isImageParams(nextParams))
@@ -60,10 +57,14 @@ export const generateImages = async (model, context, options) => {
         await options?.onResponse?.({ status: rawResponse.status, headers: headersToRecord(rawResponse.headers) }, model);
         if (response.usage)
             output.usage = parseUsage(response.usage, model);
+        if (response.background === "transparent" || response.background === "opaque") {
+            output.background = response.background;
+        }
         if (!response.data || response.data.length === 0)
             throw new Error("OpenAI images response contained no image data");
+        const outputFormat = requestedOutputFormat(params.output_format);
         for (const datum of response.data) {
-            const image = await resolveImage(datum, options);
+            const image = await resolveImage(datum, outputFormat, options);
             if (datum.revised_prompt?.trim()) {
                 output.output.push({ type: "text", text: datum.revised_prompt });
             }
@@ -101,89 +102,13 @@ function normalizeBaseUrl(baseUrl) {
     url.pathname = pathname.endsWith("/v1") ? pathname : `${pathname}/v1`;
     return url.toString();
 }
-async function resolveImage(datum, options) {
-    const b64 = datum.b64_json?.trim();
-    if (b64)
-        return { type: "image", mimeType: "image/png", data: b64 };
-    const url = datum.url?.trim();
-    if (!url)
-        throw new Error("OpenAI images response datum contained no image data");
-    if (url.startsWith("data:"))
-        return parseDataUrl(url);
-    return hydrateImageUrl(url, options);
-}
-function parseDataUrl(url) {
-    const match = /^data:([^;,]+);base64,(.+)$/i.exec(url);
-    if (!match?.[1] || !match[2])
-        throw new Error("OpenAI images response contained an invalid data URL");
-    const mimeType = supportedMime(match[1]);
-    if (!mimeType)
-        throw new Error(`OpenAI images response used unsupported MIME type: ${match[1]}`);
-    return { type: "image", mimeType, data: match[2] };
-}
-async function hydrateImageUrl(url, options) {
-    let parsed;
-    try {
-        parsed = new URL(url);
-    }
-    catch {
-        throw new Error("OpenAI images response URL must be absolute");
-    }
-    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
-        throw new Error("OpenAI images response URL must use HTTP or HTTPS");
-    }
-    const response = await (options?.fetch ?? globalThis.fetch)(url, options?.signal ? { signal: options.signal } : {});
-    if (!response.ok)
-        throw new Error(`OpenAI image hydration failed with HTTP ${response.status}`);
-    const declaredLength = response.headers.get("content-length");
-    if (declaredLength && Number(declaredLength) > MAX_IMAGE_BYTES)
-        throw oversizedImageError();
-    const bytes = new Uint8Array(await response.arrayBuffer());
-    if (bytes.byteLength === 0)
-        throw new Error("OpenAI image hydration returned an empty body");
-    if (bytes.byteLength > MAX_IMAGE_BYTES)
-        throw oversizedImageError();
-    const declaredMime = supportedMime(response.headers.get("content-type")?.split(";", 1)[0]);
-    const detectedMime = detectMime(bytes);
-    if (declaredMime && detectedMime && declaredMime !== detectedMime) {
-        throw new Error(`OpenAI image MIME mismatch: declared ${declaredMime}, detected ${detectedMime}`);
-    }
-    const mimeType = detectedMime ?? declaredMime;
-    if (!mimeType)
-        throw new Error("OpenAI image hydration returned unsupported image content");
-    return { type: "image", mimeType, data: bytesToBase64(bytes) };
-}
-function supportedMime(value) {
-    const normalized = value?.trim().toLowerCase();
-    if (normalized === "image/png" || normalized === "image/jpeg" || normalized === "image/webp")
-        return normalized;
-    return undefined;
-}
-function detectMime(bytes) {
-    if (hasMagic(bytes, PNG_MAGIC))
-        return "image/png";
-    if (hasMagic(bytes, JPEG_MAGIC))
-        return "image/jpeg";
-    if (hasMagic(bytes, WEBP_MAGIC.slice(0, 4)) && hasMagic(bytes, WEBP_MAGIC.slice(4), 8))
-        return "image/webp";
-    return undefined;
-}
-function hasMagic(bytes, magic, offset = 0) {
-    return magic.every((value, index) => bytes[offset + index] === value);
-}
-function bytesToBase64(bytes) {
-    let binary = "";
-    for (let offset = 0; offset < bytes.length; offset += 0x8000) {
-        binary += String.fromCharCode(...bytes.subarray(offset, offset + 0x8000));
-    }
-    return btoa(binary);
-}
-function oversizedImageError() {
-    return new Error("OpenAI image hydration exceeded the 24 MiB limit");
-}
+/** Image input tokens carry their own rate; without a breakdown every input token is text. */
 function parseUsage(rawUsage, model) {
     const input = rawUsage.input_tokens ?? 0;
     const output = rawUsage.output_tokens ?? 0;
+    const imageTokens = rawUsage.input_tokens_details?.image_tokens ?? 0;
+    const textTokens = rawUsage.input_tokens_details?.text_tokens ?? Math.max(0, input - imageTokens);
+    const imageRate = model.cost.imageInput ?? model.cost.input;
     const usage = {
         input,
         output,
@@ -191,7 +116,7 @@ function parseUsage(rawUsage, model) {
         cacheWrite: 0,
         totalTokens: rawUsage.total_tokens ?? input + output,
         cost: {
-            input: (model.cost.input / 1_000_000) * input,
+            input: (model.cost.input * textTokens + imageRate * imageTokens) / 1_000_000,
             output: (model.cost.output / 1_000_000) * output,
             cacheRead: 0,
             cacheWrite: 0,

package/node_modules/@earendil-works/pi-ai/dist/api/openai-images.js.map

@@ -1 +1 @@
-{"version":3,"file":"openai-images.js","sourceRoot":"","sources":["../../src/api/openai-images.ts"],"names":[],"mappings":"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","sourcesContent":["import OpenAI from \"openai\";\nimport type { Image, ImageEditParamsNonStreaming, ImageGenerateParamsNonStreaming } from \"openai/resources/images.js\";\nimport type {\n\tAssistantImages,\n\tImageContent,\n\tImagesContext,\n\tImagesFunction,\n\tImagesModel,\n\tProviderHeaders,\n\tTextContent,\n} from \"../types.ts\";\nimport { formatProviderError, normalizeProviderError } from \"../utils/error-body.ts\";\nimport { headersToRecord } from \"../utils/headers.ts\";\nimport { retryProviderRequest } from \"../utils/provider-retry.ts\";\nimport { resolveOpenAIClientAuth } from \"./openai-client-auth.ts\";\nimport { buildEditParams } from \"./openai-images-edit.ts\";\nimport { buildParams, isImageParams, type OpenAIImagesOptions } from \"./openai-images-params.ts\";\n\nexport {\n\ttype OpenAIImageQuality,\n\ttype OpenAIImageSize,\n\ttype OpenAIImagesOptions,\n\tparseOpenAIImageSize,\n} from \"./openai-images-params.ts\";\n\nconst MAX_IMAGE_BYTES = 24 * 1024 * 1024;\nconst ENDPOINT_SUFFIXES = [\"/chat/completions\", \"/responses\", \"/models\"] as const;\nconst PNG_MAGIC = [0x89, 0x50, 0x4e, 0x47] as const;\nconst JPEG_MAGIC = [0xff, 0xd8, 0xff] as const;\nconst WEBP_MAGIC = [0x52, 0x49, 0x46, 0x46, 0x57, 0x45, 0x42, 0x50] as const;\n\ntype SupportedImageMime = \"image/png\" | \"image/jpeg\" | \"image/webp\";\n\nexport const generateImages: ImagesFunction<\"openai-images\", OpenAIImagesOptions> = async (\n\tmodel: ImagesModel<\"openai-images\">,\n\tcontext: ImagesContext,\n\toptions?: OpenAIImagesOptions,\n) => {\n\tconst output: AssistantImages = {\n\t\tapi: model.api,\n\t\tprovider: model.provider,\n\t\tmodel: model.id,\n\t\toutput: [],\n\t\tstopReason: \"stop\",\n\t\ttimestamp: Date.now(),\n\t};\n\n\ttry {\n\t\tlet params = buildParams(model, context, options);\n\t\tconst images = context.input.filter((item): item is ImageContent => item.type === \"image\");\n\t\tconst method = images.length > 0 ? \"edit\" : \"generate\";\n\t\tif (method === \"edit\") params = await buildEditParams(params, images);\n\t\tconst nextParams = await options?.onPayload?.(params, model);\n\t\tif (nextParams !== undefined) {\n\t\t\tif (!isImageParams(nextParams)) throw new Error(\"onPayload returned an invalid image generation payload\");\n\t\t\tparams = nextParams;\n\t\t}\n\n\t\tconst headers: ProviderHeaders = { ...model.headers, ...options?.headers };\n\t\tconst auth = resolveOpenAIClientAuth(model.provider, options?.apiKey, headers);\n\t\tconst client = new OpenAI({\n\t\t\tapiKey: auth.apiKey,\n\t\t\tbaseURL: normalizeBaseUrl(model.baseUrl),\n\t\t\tdangerouslyAllowBrowser: true,\n\t\t\tfetch: options?.fetch,\n\t\t\tdefaultHeaders: auth.headers,\n\t\t});\n\t\tconst requestOptions = {\n\t\t\t...(options?.signal ? { signal: options.signal } : {}),\n\t\t\t...(options?.timeoutMs !== undefined ? { timeout: options.timeoutMs } : {}),\n\t\t\tmaxRetries: 0,\n\t\t};\n\t\tconst { data: response, response: rawResponse } = await retryProviderRequest(\n\t\t\t() => {\n\t\t\t\t// openai SDK pinned at 6.26.0 predates gpt-image-2.5 quality tiers\n\t\t\t\tconst sdkParams = params as ImageGenerateParamsNonStreaming & ImageEditParamsNonStreaming;\n\t\t\t\treturn (\n\t\t\t\t\tmethod === \"edit\"\n\t\t\t\t\t\t? client.images.edit(sdkParams, requestOptions)\n\t\t\t\t\t\t: client.images.generate(sdkParams, requestOptions)\n\t\t\t\t).withResponse();\n\t\t\t},\n\t\t\t{\n\t\t\t\tmaxRetries: options?.maxRetries,\n\t\t\t\tmaxRetryDelayMs: options?.maxRetryDelayMs,\n\t\t\t\tsignal: options?.signal,\n\t\t\t},\n\t\t);\n\t\tawait options?.onResponse?.({ status: rawResponse.status, headers: headersToRecord(rawResponse.headers) }, model);\n\n\t\tif (response.usage) output.usage = parseUsage(response.usage, model);\n\t\tif (!response.data || response.data.length === 0)\n\t\t\tthrow new Error(\"OpenAI images response contained no image data\");\n\n\t\tfor (const datum of response.data) {\n\t\t\tconst image = await resolveImage(datum, options);\n\t\t\tif (datum.revised_prompt?.trim()) {\n\t\t\t\toutput.output.push({ type: \"text\", text: datum.revised_prompt } satisfies TextContent);\n\t\t\t}\n\t\t\toutput.output.push(image);\n\t\t}\n\t\treturn output;\n\t} catch (error) {\n\t\toutput.stopReason = options?.signal?.aborted ? \"aborted\" : \"error\";\n\t\toutput.errorMessage = formatProviderError(normalizeProviderError(error));\n\t\treturn output;\n\t}\n};\n\nfunction normalizeBaseUrl(baseUrl: string): string {\n\tlet url: URL;\n\ttry {\n\t\turl = new URL(baseUrl);\n\t} catch {\n\t\tthrow new Error(`Invalid OpenAI images base URL: ${baseUrl}`);\n\t}\n\tif (url.protocol !== \"http:\" && url.protocol !== \"https:\") {\n\t\tthrow new Error(\"OpenAI images base URL must use HTTP or HTTPS\");\n\t}\n\tif (url.search || url.hash) throw new Error(\"OpenAI images base URL must not include a query or fragment\");\n\tconst pathname = url.pathname.replace(/\\/+$/, \"\");\n\tconst normalizedPathname = pathname.toLowerCase();\n\tif (normalizedPathname.includes(\"/images\")) {\n\t\tthrow new Error(\"OpenAI images base URL must not include an images endpoint\");\n\t}\n\tif (ENDPOINT_SUFFIXES.some((suffix) => normalizedPathname.endsWith(suffix))) {\n\t\tthrow new Error(\"OpenAI images base URL must not include a known API endpoint\");\n\t}\n\turl.pathname = pathname.endsWith(\"/v1\") ? pathname : `${pathname}/v1`;\n\treturn url.toString();\n}\n\nasync function resolveImage(datum: Image, options?: OpenAIImagesOptions): Promise<ImageContent> {\n\tconst b64 = datum.b64_json?.trim();\n\tif (b64) return { type: \"image\", mimeType: \"image/png\", data: b64 };\n\tconst url = datum.url?.trim();\n\tif (!url) throw new Error(\"OpenAI images response datum contained no image data\");\n\tif (url.startsWith(\"data:\")) return parseDataUrl(url);\n\treturn hydrateImageUrl(url, options);\n}\n\nfunction parseDataUrl(url: string): ImageContent {\n\tconst match = /^data:([^;,]+);base64,(.+)$/i.exec(url);\n\tif (!match?.[1] || !match[2]) throw new Error(\"OpenAI images response contained an invalid data URL\");\n\tconst mimeType = supportedMime(match[1]);\n\tif (!mimeType) throw new Error(`OpenAI images response used unsupported MIME type: ${match[1]}`);\n\treturn { type: \"image\", mimeType, data: match[2] };\n}\n\nasync function hydrateImageUrl(url: string, options?: OpenAIImagesOptions): Promise<ImageContent> {\n\tlet parsed: URL;\n\ttry {\n\t\tparsed = new URL(url);\n\t} catch {\n\t\tthrow new Error(\"OpenAI images response URL must be absolute\");\n\t}\n\tif (parsed.protocol !== \"http:\" && parsed.protocol !== \"https:\") {\n\t\tthrow new Error(\"OpenAI images response URL must use HTTP or HTTPS\");\n\t}\n\tconst response = await (options?.fetch ?? globalThis.fetch)(url, options?.signal ? { signal: options.signal } : {});\n\tif (!response.ok) throw new Error(`OpenAI image hydration failed with HTTP ${response.status}`);\n\tconst declaredLength = response.headers.get(\"content-length\");\n\tif (declaredLength && Number(declaredLength) > MAX_IMAGE_BYTES) throw oversizedImageError();\n\tconst bytes = new Uint8Array(await response.arrayBuffer());\n\tif (bytes.byteLength === 0) throw new Error(\"OpenAI image hydration returned an empty body\");\n\tif (bytes.byteLength > MAX_IMAGE_BYTES) throw oversizedImageError();\n\tconst declaredMime = supportedMime(response.headers.get(\"content-type\")?.split(\";\", 1)[0]);\n\tconst detectedMime = detectMime(bytes);\n\tif (declaredMime && detectedMime && declaredMime !== detectedMime) {\n\t\tthrow new Error(`OpenAI image MIME mismatch: declared ${declaredMime}, detected ${detectedMime}`);\n\t}\n\tconst mimeType = detectedMime ?? declaredMime;\n\tif (!mimeType) throw new Error(\"OpenAI image hydration returned unsupported image content\");\n\treturn { type: \"image\", mimeType, data: bytesToBase64(bytes) };\n}\n\nfunction supportedMime(value: string | undefined): SupportedImageMime | undefined {\n\tconst normalized = value?.trim().toLowerCase();\n\tif (normalized === \"image/png\" || normalized === \"image/jpeg\" || normalized === \"image/webp\") return normalized;\n\treturn undefined;\n}\n\nfunction detectMime(bytes: Uint8Array): SupportedImageMime | undefined {\n\tif (hasMagic(bytes, PNG_MAGIC)) return \"image/png\";\n\tif (hasMagic(bytes, JPEG_MAGIC)) return \"image/jpeg\";\n\tif (hasMagic(bytes, WEBP_MAGIC.slice(0, 4)) && hasMagic(bytes, WEBP_MAGIC.slice(4), 8)) return \"image/webp\";\n\treturn undefined;\n}\n\nfunction hasMagic(bytes: Uint8Array, magic: readonly number[], offset = 0): boolean {\n\treturn magic.every((value, index) => bytes[offset + index] === value);\n}\n\nfunction bytesToBase64(bytes: Uint8Array): string {\n\tlet binary = \"\";\n\tfor (let offset = 0; offset < bytes.length; offset += 0x8000) {\n\t\tbinary += String.fromCharCode(...bytes.subarray(offset, offset + 0x8000));\n\t}\n\treturn btoa(binary);\n}\n\nfunction oversizedImageError(): Error {\n\treturn new Error(\"OpenAI image hydration exceeded the 24 MiB limit\");\n}\n\nfunction parseUsage(\n\trawUsage: { input_tokens?: number; output_tokens?: number; total_tokens?: number },\n\tmodel: ImagesModel<\"openai-images\">,\n) {\n\tconst input = rawUsage.input_tokens ?? 0;\n\tconst output = rawUsage.output_tokens ?? 0;\n\tconst usage = {\n\t\tinput,\n\t\toutput,\n\t\tcacheRead: 0,\n\t\tcacheWrite: 0,\n\t\ttotalTokens: rawUsage.total_tokens ?? input + output,\n\t\tcost: {\n\t\t\tinput: (model.cost.input / 1_000_000) * input,\n\t\t\toutput: (model.cost.output / 1_000_000) * output,\n\t\t\tcacheRead: 0,\n\t\t\tcacheWrite: 0,\n\t\t\ttotal: 0,\n\t\t},\n\t};\n\tusage.cost.total = usage.cost.input + usage.cost.output;\n\treturn usage;\n}\n"]}
+{"version":3,"file":"openai-images.js","sourceRoot":"","sources":["../../src/api/openai-images.ts"],"names":[],"mappings":"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","sourcesContent":["import OpenAI from \"openai\";\nimport type { ImageEditParamsNonStreaming, ImageGenerateParamsNonStreaming } from \"openai/resources/images.js\";\nimport type {\n\tAssistantImages,\n\tImageContent,\n\tImagesContext,\n\tImagesFunction,\n\tImagesModel,\n\tProviderHeaders,\n\tTextContent,\n} from \"../types.ts\";\nimport { formatProviderError, normalizeProviderError } from \"../utils/error-body.ts\";\nimport { headersToRecord } from \"../utils/headers.ts\";\nimport { retryProviderRequest } from \"../utils/provider-retry.ts\";\nimport { resolveOpenAIClientAuth } from \"./openai-client-auth.ts\";\nimport { buildEditParams } from \"./openai-images-edit.ts\";\nimport { buildParams, isImageParams, type OpenAIImagesOptions } from \"./openai-images-params.ts\";\nimport { requestedOutputFormat, resolveImage } from \"./openai-images-result.ts\";\n\nexport {\n\ttype OpenAIImageBackground,\n\ttype OpenAIImageModeration,\n\ttype OpenAIImageOutputFormat,\n\ttype OpenAIImageQuality,\n\ttype OpenAIImageSize,\n\ttype OpenAIImagesOptions,\n\tparseOpenAIImageOutputOptions,\n\tparseOpenAIImageSize,\n} from \"./openai-images-params.ts\";\n\nconst ENDPOINT_SUFFIXES = [\"/chat/completions\", \"/responses\", \"/models\"] as const;\n\nexport const generateImages: ImagesFunction<\"openai-images\", OpenAIImagesOptions> = async (\n\tmodel: ImagesModel<\"openai-images\">,\n\tcontext: ImagesContext,\n\toptions?: OpenAIImagesOptions,\n) => {\n\tconst output: AssistantImages = {\n\t\tapi: model.api,\n\t\tprovider: model.provider,\n\t\tmodel: model.id,\n\t\toutput: [],\n\t\tstopReason: \"stop\",\n\t\ttimestamp: Date.now(),\n\t};\n\n\ttry {\n\t\tlet params = buildParams(model, context, options);\n\t\tconst images = context.input.filter((item): item is ImageContent => item.type === \"image\");\n\t\tconst method = images.length > 0 ? \"edit\" : \"generate\";\n\t\tif (method === \"edit\") params = await buildEditParams(params, images, options?.mask);\n\t\tconst nextParams = await options?.onPayload?.(params, model);\n\t\tif (nextParams !== undefined) {\n\t\t\tif (!isImageParams(nextParams)) throw new Error(\"onPayload returned an invalid image generation payload\");\n\t\t\tparams = nextParams;\n\t\t}\n\n\t\tconst headers: ProviderHeaders = { ...model.headers, ...options?.headers };\n\t\tconst auth = resolveOpenAIClientAuth(model.provider, options?.apiKey, headers);\n\t\tconst client = new OpenAI({\n\t\t\tapiKey: auth.apiKey,\n\t\t\tbaseURL: normalizeBaseUrl(model.baseUrl),\n\t\t\tdangerouslyAllowBrowser: true,\n\t\t\tfetch: options?.fetch,\n\t\t\tdefaultHeaders: auth.headers,\n\t\t});\n\t\tconst requestOptions = {\n\t\t\t...(options?.signal ? { signal: options.signal } : {}),\n\t\t\t...(options?.timeoutMs !== undefined ? { timeout: options.timeoutMs } : {}),\n\t\t\tmaxRetries: 0,\n\t\t};\n\t\tconst { data: response, response: rawResponse } = await retryProviderRequest(\n\t\t\t() => {\n\t\t\t\t// openai SDK pinned at 6.26.0 predates gpt-image-2.5 quality tiers\n\t\t\t\tconst sdkParams = params as ImageGenerateParamsNonStreaming & ImageEditParamsNonStreaming;\n\t\t\t\treturn (\n\t\t\t\t\tmethod === \"edit\"\n\t\t\t\t\t\t? client.images.edit(sdkParams, requestOptions)\n\t\t\t\t\t\t: client.images.generate(sdkParams, requestOptions)\n\t\t\t\t).withResponse();\n\t\t\t},\n\t\t\t{\n\t\t\t\tmaxRetries: options?.maxRetries,\n\t\t\t\tmaxRetryDelayMs: options?.maxRetryDelayMs,\n\t\t\t\tsignal: options?.signal,\n\t\t\t},\n\t\t);\n\t\tawait options?.onResponse?.({ status: rawResponse.status, headers: headersToRecord(rawResponse.headers) }, model);\n\n\t\tif (response.usage) output.usage = parseUsage(response.usage, model);\n\t\tif (response.background === \"transparent\" || response.background === \"opaque\") {\n\t\t\toutput.background = response.background;\n\t\t}\n\t\tif (!response.data || response.data.length === 0)\n\t\t\tthrow new Error(\"OpenAI images response contained no image data\");\n\n\t\tconst outputFormat = requestedOutputFormat(params.output_format);\n\t\tfor (const datum of response.data) {\n\t\t\tconst image = await resolveImage(datum, outputFormat, options);\n\t\t\tif (datum.revised_prompt?.trim()) {\n\t\t\t\toutput.output.push({ type: \"text\", text: datum.revised_prompt } satisfies TextContent);\n\t\t\t}\n\t\t\toutput.output.push(image);\n\t\t}\n\t\treturn output;\n\t} catch (error) {\n\t\toutput.stopReason = options?.signal?.aborted ? \"aborted\" : \"error\";\n\t\toutput.errorMessage = formatProviderError(normalizeProviderError(error));\n\t\treturn output;\n\t}\n};\n\nfunction normalizeBaseUrl(baseUrl: string): string {\n\tlet url: URL;\n\ttry {\n\t\turl = new URL(baseUrl);\n\t} catch {\n\t\tthrow new Error(`Invalid OpenAI images base URL: ${baseUrl}`);\n\t}\n\tif (url.protocol !== \"http:\" && url.protocol !== \"https:\") {\n\t\tthrow new Error(\"OpenAI images base URL must use HTTP or HTTPS\");\n\t}\n\tif (url.search || url.hash) throw new Error(\"OpenAI images base URL must not include a query or fragment\");\n\tconst pathname = url.pathname.replace(/\\/+$/, \"\");\n\tconst normalizedPathname = pathname.toLowerCase();\n\tif (normalizedPathname.includes(\"/images\")) {\n\t\tthrow new Error(\"OpenAI images base URL must not include an images endpoint\");\n\t}\n\tif (ENDPOINT_SUFFIXES.some((suffix) => normalizedPathname.endsWith(suffix))) {\n\t\tthrow new Error(\"OpenAI images base URL must not include a known API endpoint\");\n\t}\n\turl.pathname = pathname.endsWith(\"/v1\") ? pathname : `${pathname}/v1`;\n\treturn url.toString();\n}\n\ninterface RawImageUsage {\n\tinput_tokens?: number;\n\tinput_tokens_details?: { image_tokens?: number; text_tokens?: number };\n\toutput_tokens?: number;\n\ttotal_tokens?: number;\n}\n\n/** Image input tokens carry their own rate; without a breakdown every input token is text. */\nfunction parseUsage(rawUsage: RawImageUsage, model: ImagesModel<\"openai-images\">) {\n\tconst input = rawUsage.input_tokens ?? 0;\n\tconst output = rawUsage.output_tokens ?? 0;\n\tconst imageTokens = rawUsage.input_tokens_details?.image_tokens ?? 0;\n\tconst textTokens = rawUsage.input_tokens_details?.text_tokens ?? Math.max(0, input - imageTokens);\n\tconst imageRate = model.cost.imageInput ?? model.cost.input;\n\tconst usage = {\n\t\tinput,\n\t\toutput,\n\t\tcacheRead: 0,\n\t\tcacheWrite: 0,\n\t\ttotalTokens: rawUsage.total_tokens ?? input + output,\n\t\tcost: {\n\t\t\tinput: (model.cost.input * textTokens + imageRate * imageTokens) / 1_000_000,\n\t\t\toutput: (model.cost.output / 1_000_000) * output,\n\t\t\tcacheRead: 0,\n\t\t\tcacheWrite: 0,\n\t\t\ttotal: 0,\n\t\t},\n\t};\n\tusage.cost.total = usage.cost.input + usage.cost.output;\n\treturn usage;\n}\n"]}