@code-yeongyu/senpi 2026.9.9 → 2026.9.10

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

@@ -0,0 +1,4 @@
+import type { ImageContent } from "../types.ts";
+import type { OpenAIImageParams } from "./openai-images-params.ts";
+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

@@ -0,0 +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;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

@@ -0,0 +1,15 @@
+import { toFile } from "openai";
+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((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

@@ -0,0 +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,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

@@ -0,0 +1,60 @@
+import type { Uploadable } from "openai";
+import type { ImageGenerateParamsNonStreaming } from "openai/resources/images.js";
+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;
+    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

@@ -0,0 +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,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

@@ -0,0 +1,93 @@
+import { sanitizeSurrogates } from "../utils/sanitize-unicode.js";
+const MAX_PROMPT_CHARS = 32_000;
+export function parseOpenAIImageSize(size) {
+    if (["auto", "1024x1024", "1536x1024", "1024x1536"].includes(size))
+        return { ok: true, size };
+    const match = /^\d+x\d+$/.exec(size);
+    if (!match || match[0] !== size) {
+        return { ok: false, error: "OpenAI image size must be auto or WIDTHxHEIGHT with integer dimensions" };
+    }
+    const [width, height] = size.split("x").map(Number);
+    if (width > 3840 || height > 3840) {
+        return { ok: false, error: "OpenAI image size edges must be at most 3840 pixels" };
+    }
+    if (width % 16 !== 0 || height % 16 !== 0) {
+        return { ok: false, error: "OpenAI image size width and height must be divisible by 16" };
+    }
+    if (width > height * 3 || height > width * 3) {
+        return { ok: false, error: "OpenAI image size aspect ratio must be between 1:3 and 3:1 inclusive" };
+    }
+    const pixels = width * height;
+    if (pixels < 655360 || pixels > 8294400) {
+        return { ok: false, error: "OpenAI image size must contain between 655360 and 8294400 pixels inclusive" };
+    }
+    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) {
+        if (item.type !== "text")
+            continue;
+        const text = sanitizeSurrogates(item.text);
+        if (text.trim())
+            promptParts.push(text);
+    }
+    const prompt = promptParts.join("\n\n");
+    if (!prompt.trim())
+        throw new Error("Image generation requires a non-empty text prompt");
+    if (prompt.length > MAX_PROMPT_CHARS) {
+        throw new Error(`Image generation prompt exceeds ${MAX_PROMPT_CHARS} characters`);
+    }
+    const size = options?.size ?? "auto";
+    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: 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) {
+    return typeof value === "object" && value !== null && "prompt" in value && typeof value.prompt === "string";
+}
+//# sourceMappingURL=openai-images-params.js.map

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

@@ -0,0 +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 { 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,8 +1,5 @@
-import type { ImagesFunction, ImagesOptions } from "../types.ts";
-export interface OpenAIImagesOptions extends ImagesOptions {
-    size?: "auto" | "1024x1024" | "1024x1536" | "1536x1024";
-    quality?: "auto" | "low" | "medium" | "high";
-    n?: number;
-}
+import type { ImagesFunction } from "../types.ts";
+import { type OpenAIImagesOptions } 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,EAEd,aAAa,EAGb,MAAM,aAAa,CAAC;AAgBrB,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACzD,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,CAAC;IACxD,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC7C,CAAC,CAAC,EAAE,MAAM,CAAC;CACX;AAED,eAAO,MAAM,cAAc,EAAE,cAAc,CAAC,eAAe,EAAE,mBAAmB,CA+D/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

@@ -2,14 +2,12 @@ import OpenAI from "openai";
 import { formatProviderError, normalizeProviderError } from "../utils/error-body.js";
 import { headersToRecord } from "../utils/headers.js";
 import { retryProviderRequest } from "../utils/provider-retry.js";
-import { sanitizeSurrogates } from "../utils/sanitize-unicode.js";
 import { resolveOpenAIClientAuth } from "./openai-client-auth.js";
-const MAX_PROMPT_CHARS = 32_000;
-const MAX_IMAGE_BYTES = 24 * 1024 * 1024;
+import { buildEditParams } from "./openai-images-edit.js";
+import { buildParams, isImageParams } from "./openai-images-params.js";
+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,
@@ -21,9 +19,13 @@ export const generateImages = async (model, context, options) => {
     };
     try {
         let params = buildParams(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, options?.mask);
         const nextParams = await options?.onPayload?.(params, model);
         if (nextParams !== undefined) {
-            if (!isGenerateParams(nextParams))
+            if (!isImageParams(nextParams))
                 throw new Error("onPayload returned an invalid image generation payload");
             params = nextParams;
         }
@@ -41,7 +43,13 @@ export const generateImages = async (model, context, options) => {
             ...(options?.timeoutMs !== undefined ? { timeout: options.timeoutMs } : {}),
             maxRetries: 0,
         };
-        const { data: response, response: rawResponse } = await retryProviderRequest(() => client.images.generate(params, requestOptions).withResponse(), {
+        const { data: response, response: rawResponse } = await retryProviderRequest(() => {
+            // openai SDK pinned at 6.26.0 predates gpt-image-2.5 quality tiers
+            const sdkParams = params;
+            return (method === "edit"
+                ? client.images.edit(sdkParams, requestOptions)
+                : client.images.generate(sdkParams, requestOptions)).withResponse();
+        }, {
             maxRetries: options?.maxRetries,
             maxRetryDelayMs: options?.maxRetryDelayMs,
             signal: options?.signal,
@@ -49,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 });
             }
@@ -66,35 +78,6 @@ export const generateImages = async (model, context, options) => {
         return output;
     }
 };
-function buildParams(model, context, options) {
-    const promptParts = [];
-    for (const item of context.input) {
-        if (item.type === "image") {
-            throw new Error("generations does not accept image input; use the images edit endpoint");
-        }
-        const text = sanitizeSurrogates(item.text);
-        if (text.trim())
-            promptParts.push(text);
-    }
-    const prompt = promptParts.join("\n\n");
-    if (!prompt.trim())
-        throw new Error("Image generation requires a non-empty text prompt");
-    if (prompt.length > MAX_PROMPT_CHARS) {
-        throw new Error(`Image generation prompt exceeds ${MAX_PROMPT_CHARS} characters`);
-    }
-    return {
-        model: model.id,
-        prompt,
-        size: options?.size ?? "auto",
-        quality: options?.quality ?? "auto",
-        n: options?.n ?? 1,
-        output_format: "png",
-        stream: false,
-    };
-}
-function isGenerateParams(value) {
-    return typeof value === "object" && value !== null && "prompt" in value && typeof value.prompt === "string";
-}
 function normalizeBaseUrl(baseUrl) {
     let url;
     try {
@@ -119,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,
@@ -209,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,