openrouter-genimage-kote-opencode 0.1.0

package/dist/openrouter/models.js

@@ -0,0 +1,113 @@
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function parseFiniteNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+function parseCapability(value) {
+    if (!isRecord(value))
+        return undefined;
+    if (value.type === "boolean")
+        return { type: "boolean" };
+    if (value.type === "enum" && Array.isArray(value.values)) {
+        const values = value.values.filter((entry) => typeof entry === "string" ||
+            (typeof entry === "number" && Number.isFinite(entry)));
+        return values.length === value.values.length
+            ? { type: "enum", values }
+            : undefined;
+    }
+    const min = parseFiniteNumber(value.min);
+    const max = parseFiniteNumber(value.max);
+    if (value.type === "range" && min !== undefined && max !== undefined && min <= max) {
+        return { type: "range", min, max };
+    }
+    return undefined;
+}
+function parseSupportedParameters(value) {
+    if (!isRecord(value))
+        return {};
+    const result = {};
+    for (const [name, descriptor] of Object.entries(value)) {
+        const parsed = parseCapability(descriptor);
+        if (parsed !== undefined)
+            result[name] = parsed;
+    }
+    return result;
+}
+function parseModalities(value) {
+    if (!Array.isArray(value) || !value.every((item) => typeof item === "string")) {
+        return [];
+    }
+    return value;
+}
+function parseImageModel(value) {
+    if (!isRecord(value) || typeof value.id !== "string" || !isRecord(value.architecture)) {
+        return undefined;
+    }
+    return {
+        id: value.id,
+        ...(typeof value.name === "string" ? { name: value.name } : {}),
+        architecture: {
+            input_modalities: parseModalities(value.architecture.input_modalities),
+            output_modalities: parseModalities(value.architecture.output_modalities),
+        },
+        supported_parameters: parseSupportedParameters(value.supported_parameters),
+        ...(typeof value.endpoints === "string" ? { endpoints: value.endpoints } : {}),
+        ...(typeof value.supports_streaming === "boolean"
+            ? { supports_streaming: value.supports_streaming }
+            : {}),
+    };
+}
+export function parseImageModelsResponse(value) {
+    if (!isRecord(value) || !Array.isArray(value.data)) {
+        throw new TypeError("OpenRouter image-model response has an invalid shape.");
+    }
+    const models = value.data.map(parseImageModel);
+    if (models.some((model) => model === undefined)) {
+        throw new TypeError("OpenRouter image-model response contains an invalid record.");
+    }
+    return models;
+}
+function parseEndpoint(value) {
+    if (!isRecord(value))
+        return undefined;
+    return {
+        ...(typeof value.provider_name === "string"
+            ? { provider_name: value.provider_name }
+            : {}),
+        ...(typeof value.provider_slug === "string"
+            ? { provider_slug: value.provider_slug }
+            : {}),
+        ...(typeof value.provider_tag === "string" || value.provider_tag === null
+            ? { provider_tag: value.provider_tag }
+            : {}),
+        supported_parameters: parseSupportedParameters(value.supported_parameters),
+        ...(typeof value.supports_streaming === "boolean"
+            ? { supports_streaming: value.supports_streaming }
+            : {}),
+    };
+}
+export function parseImageModelEndpointsResponse(value) {
+    if (!isRecord(value) || typeof value.id !== "string" || !Array.isArray(value.endpoints)) {
+        throw new TypeError("OpenRouter image endpoint response has an invalid shape.");
+    }
+    const endpoints = value.endpoints.map(parseEndpoint);
+    if (endpoints.some((endpoint) => endpoint === undefined)) {
+        throw new TypeError("OpenRouter image endpoint response contains an invalid record.");
+    }
+    return { id: value.id, endpoints: endpoints };
+}
+export function capabilitySupports(descriptor, value) {
+    if (descriptor === undefined)
+        return false;
+    if (descriptor.type === "boolean")
+        return true;
+    if (descriptor.type === "enum")
+        return descriptor.values.includes(value);
+    const numericValue = Array.isArray(value) ? value.length : value;
+    return (typeof numericValue === "number" &&
+        Number.isFinite(numericValue) &&
+        numericValue >= descriptor.min &&
+        numericValue <= descriptor.max);
+}
+//# sourceMappingURL=models.js.map

package/dist/openrouter/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/openrouter/models.ts"],"names":[],"mappings":"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"}

package/dist/openrouter/requests.d.ts

@@ -0,0 +1,6 @@
+import type { ImageGenerationParameters, ResolvedPluginOptions } from "../config/types.js";
+import type { GenerateImageArgs, OpenRouterImageRequest, OpenRouterInputReference } from "./schemas.js";
+export declare function mergeGenerationParameters(defaults: ImageGenerationParameters, overrides: ImageGenerationParameters): ImageGenerationParameters;
+export declare function buildTextToImageRequest(options: Pick<ResolvedPluginOptions, "model" | "defaults">, args: GenerateImageArgs): OpenRouterImageRequest;
+export declare function buildImageToImageRequest(options: Pick<ResolvedPluginOptions, "model" | "defaults" | "input">, args: GenerateImageArgs, inputReferences: readonly OpenRouterInputReference[]): OpenRouterImageRequest;
+//# sourceMappingURL=requests.d.ts.map

package/dist/openrouter/requests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requests.d.ts","sourceRoot":"","sources":["../../src/openrouter/requests.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,qBAAqB,EACtB,MAAM,oBAAoB,CAAA;AAM3B,OAAO,KAAK,EACV,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,EACzB,MAAM,cAAc,CAAA;AAgDrB,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,yBAAyB,EACnC,SAAS,EAAE,yBAAyB,GACnC,yBAAyB,CAW3B;AAgBD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,IAAI,CAAC,qBAAqB,EAAE,OAAO,GAAG,UAAU,CAAC,EAC1D,IAAI,EAAE,iBAAiB,GACtB,sBAAsB,CAExB;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,IAAI,CAAC,qBAAqB,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC,EACpE,IAAI,EAAE,iBAAiB,EACvB,eAAe,EAAE,SAAS,wBAAwB,EAAE,GACnD,sBAAsB,CAyBxB"}

package/dist/openrouter/requests.js

@@ -0,0 +1,74 @@
+import { generateImageArgsSchema, generationParametersSchema, } from "../config/schema.js";
+import { PluginError } from "./errors.js";
+const PARAMETER_KEYS = [
+    "aspect_ratio",
+    "background",
+    "n",
+    "output_format",
+    "output_compression",
+    "quality",
+    "resolution",
+    "seed",
+];
+function parameterError() {
+    return new PluginError("GENIMAGE_PARAMETER_UNSUPPORTED", "Image generation parameters are invalid or incompatible.", {
+        suggestion: "Check the prompt, output format, background, compression, and generation limits.",
+    });
+}
+function parseArgs(rawArgs) {
+    const result = generateImageArgsSchema.safeParse(rawArgs);
+    if (!result.success) {
+        throw parameterError();
+    }
+    return result.data;
+}
+function copyDefinedParameters(source) {
+    const result = {};
+    for (const key of PARAMETER_KEYS) {
+        const value = source[key];
+        if (value !== undefined) {
+            Object.assign(result, { [key]: value });
+        }
+    }
+    return result;
+}
+export function mergeGenerationParameters(defaults, overrides) {
+    const merged = {
+        ...copyDefinedParameters(defaults),
+        ...copyDefinedParameters(overrides),
+    };
+    const result = generationParametersSchema.safeParse(merged);
+    if (!result.success) {
+        throw parameterError();
+    }
+    return copyDefinedParameters(result.data);
+}
+function createBaseRequest(options, rawArgs) {
+    const args = parseArgs(rawArgs);
+    const parameters = mergeGenerationParameters(options.defaults, args);
+    return {
+        model: options.model,
+        prompt: args.prompt,
+        ...parameters,
+    };
+}
+export function buildTextToImageRequest(options, args) {
+    return createBaseRequest(options, args);
+}
+export function buildImageToImageRequest(options, args, inputReferences) {
+    if (inputReferences.length === 0) {
+        throw new PluginError("GENIMAGE_REFERENCE_REQUIRED", "Image editing requires at least one visual reference.");
+    }
+    if (inputReferences.length > options.input.maxReferences) {
+        throw new PluginError("GENIMAGE_TOO_MANY_REFERENCES", "The number of image references exceeds the configured limit.", { details: { maxReferences: options.input.maxReferences } });
+    }
+    const references = inputReferences.map((reference) => ({
+        type: reference.type,
+        image_url: { url: reference.image_url.url },
+    }));
+    return {
+        ...createBaseRequest(options, args),
+        input_references: references,
+    };
+}
+//# sourceMappingURL=requests.js.map

package/dist/openrouter/requests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requests.js","sourceRoot":"","sources":["../../src/openrouter/requests.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAOzC,MAAM,cAAc,GAAG;IACrB,cAAc;IACd,YAAY;IACZ,GAAG;IACH,eAAe;IACf,oBAAoB;IACpB,SAAS;IACT,YAAY;IACZ,MAAM;CACyD,CAAA;AAEjE,SAAS,cAAc;IACrB,OAAO,IAAI,WAAW,CACpB,gCAAgC,EAChC,0DAA0D,EAC1D;QACE,UAAU,EACR,kFAAkF;KACrF,CACF,CAAA;AACH,CAAC;AAED,SAAS,SAAS,CAAC,OAAgB;IACjC,MAAM,MAAM,GAAG,uBAAuB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;IACzD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,cAAc,EAAE,CAAA;IACxB,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAA;AACpB,CAAC;AAED,SAAS,qBAAqB,CAC5B,MAAiC;IAEjC,MAAM,MAAM,GAA8B,EAAE,CAAA;IAE5C,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;QACzB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;QACzC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,QAAmC,EACnC,SAAoC;IAEpC,MAAM,MAAM,GAAG;QACb,GAAG,qBAAqB,CAAC,QAAQ,CAAC;QAClC,GAAG,qBAAqB,CAAC,SAAS,CAAC;KACpC,CAAA;IACD,MAAM,MAAM,GAAG,0BAA0B,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IAC3D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,cAAc,EAAE,CAAA;IACxB,CAAC;IAED,OAAO,qBAAqB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;AAC3C,CAAC;AAED,SAAS,iBAAiB,CACxB,OAA0D,EAC1D,OAAgB;IAEhB,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;IAC/B,MAAM,UAAU,GAAG,yBAAyB,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;IAEpE,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,GAAG,UAAU;KACd,CAAA;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,OAA0D,EAC1D,IAAuB;IAEvB,OAAO,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;AACzC,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,OAAoE,EACpE,IAAuB,EACvB,eAAoD;IAEpD,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,WAAW,CACnB,6BAA6B,EAC7B,uDAAuD,CACxD,CAAA;IACH,CAAC;IAED,IAAI,eAAe,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;QACzD,MAAM,IAAI,WAAW,CACnB,8BAA8B,EAC9B,8DAA8D,EAC9D,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,EAAE,CAC5D,CAAA;IACH,CAAC;IAED,MAAM,UAAU,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACrD,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,SAAS,EAAE,EAAE,GAAG,EAAE,SAAS,CAAC,SAAS,CAAC,GAAG,EAAE;KAC5C,CAAC,CAAC,CAAA;IAEH,OAAO;QACL,GAAG,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC;QACnC,gBAAgB,EAAE,UAAU;KAC7B,CAAA;AACH,CAAC"}

package/dist/openrouter/schemas.d.ts

@@ -0,0 +1,37 @@
+import type { ImageAspectRatio, ImageBackground, ImageGenerationParameters, ImageOutputFormat, ImageQuality, ImageResolution } from "../config/types.js";
+export interface GenerateImageArgs extends ImageGenerationParameters {
+    prompt: string;
+    output_path?: string | undefined;
+}
+export interface OpenRouterInputReference {
+    type: "image_url";
+    image_url: {
+        url: string;
+    };
+}
+export interface OpenRouterImageRequest {
+    model: string;
+    prompt: string;
+    input_references?: OpenRouterInputReference[] | undefined;
+    aspect_ratio?: ImageAspectRatio | undefined;
+    background?: ImageBackground | undefined;
+    n?: number | undefined;
+    output_format?: ImageOutputFormat | undefined;
+    output_compression?: number | undefined;
+    quality?: ImageQuality | undefined;
+    resolution?: ImageResolution | undefined;
+    seed?: number | undefined;
+}
+export interface OpenRouterGeneratedImage {
+    b64_json: string;
+    media_type?: string | undefined;
+}
+export interface OpenRouterImageUsage {
+    cost?: number | undefined;
+    [key: string]: unknown;
+}
+export interface OpenRouterImageResponse {
+    data: OpenRouterGeneratedImage[];
+    usage?: OpenRouterImageUsage | undefined;
+}
+//# sourceMappingURL=schemas.d.ts.map

package/dist/openrouter/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/openrouter/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,yBAAyB,EACzB,iBAAiB,EACjB,YAAY,EACZ,eAAe,EAChB,MAAM,oBAAoB,CAAA;AAE3B,MAAM,WAAW,iBAAkB,SAAQ,yBAAyB;IAClE,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACjC;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,WAAW,CAAA;IACjB,SAAS,EAAE;QACT,GAAG,EAAE,MAAM,CAAA;KACZ,CAAA;CACF;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,gBAAgB,CAAC,EAAE,wBAAwB,EAAE,GAAG,SAAS,CAAA;IACzD,YAAY,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAA;IAC3C,UAAU,CAAC,EAAE,eAAe,GAAG,SAAS,CAAA;IACxC,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACtB,aAAa,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAA;IAC7C,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACvC,OAAO,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;IAClC,UAAU,CAAC,EAAE,eAAe,GAAG,SAAS,CAAA;IACxC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC1B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAChC;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,wBAAwB,EAAE,CAAA;IAChC,KAAK,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAA;CACzC"}

package/dist/openrouter/schemas.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schemas.js.map

package/dist/openrouter/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/openrouter/schemas.ts"],"names":[],"mappings":""}

package/dist/output/attachments.d.ts

@@ -0,0 +1,10 @@
+import type { SavedImage } from "./writer.js";
+export interface ToolFileAttachment {
+    type: "file";
+    mime: SavedImage["mime"];
+    filename: string;
+    url: string;
+}
+export declare function createToolAttachment(image: SavedImage): ToolFileAttachment;
+export declare function createToolAttachments(images: readonly SavedImage[]): ToolFileAttachment[];
+//# sourceMappingURL=attachments.d.ts.map

package/dist/output/attachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../../src/output/attachments.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,CAAA;IACxB,QAAQ,EAAE,MAAM,CAAA;IAChB,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,UAAU,GAAG,kBAAkB,CAO1E;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,UAAU,EAAE,GAC5B,kBAAkB,EAAE,CAEtB"}

package/dist/output/attachments.js

@@ -0,0 +1,13 @@
+import { imageBytesToDataUrl } from "../references/data-url.js";
+export function createToolAttachment(image) {
+    return {
+        type: "file",
+        mime: image.mime,
+        filename: image.filename,
+        url: imageBytesToDataUrl(image.data, image.mime),
+    };
+}
+export function createToolAttachments(images) {
+    return images.map(createToolAttachment);
+}
+//# sourceMappingURL=attachments.js.map

package/dist/output/attachments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.js","sourceRoot":"","sources":["../../src/output/attachments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAU/D,MAAM,UAAU,oBAAoB,CAAC,KAAiB;IACpD,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,GAAG,EAAE,mBAAmB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC;KACjD,CAAA;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,MAA6B;IAE7B,OAAO,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAA;AACzC,CAAC"}

package/dist/output/formats.d.ts

@@ -0,0 +1,42 @@
+import type { Buffer } from "node:buffer";
+import type { ImageOutputFormat } from "../config/types.js";
+import { type DetectedImageFormat } from "../references/formats.js";
+export interface EncodedOutputImage {
+    b64_json: string;
+    media_type?: string | undefined;
+}
+export interface ValidatedImage {
+    bytes: Buffer;
+    detected: DetectedImageFormat;
+    warnings?: readonly string[] | undefined;
+}
+export interface DecodedImage extends ValidatedImage {
+    warnings: string[];
+}
+export interface DecodeOutputImageOptions {
+    maxDecodedBytes: number;
+    expectedFormat?: ImageOutputFormat | undefined;
+    /** One-based result index, used only in safe diagnostic messages. */
+    index?: number | undefined;
+}
+export interface DecodeOutputImagesOptions {
+    maxDecodedBytes: number;
+    expectedFormat?: ImageOutputFormat | undefined;
+}
+export interface DecodedOutputImages {
+    images: DecodedImage[];
+    warnings: string[];
+    invalidCount: number;
+}
+/**
+ * Strictly decodes one OpenRouter image result and classifies it from magic
+ * bytes. Provider media-type fields are advisory and can only produce a
+ * warning; they never override the binary format.
+ */
+export declare function decodeOutputImage(image: unknown, options: DecodeOutputImageOptions): DecodedImage;
+/**
+ * Decodes a response defensively. Invalid entries are skipped so callers can
+ * report partial success. The decoded-byte budget applies to the full set.
+ */
+export declare function decodeOutputImages(data: unknown, options: DecodeOutputImagesOptions): DecodedOutputImages;
+//# sourceMappingURL=formats.d.ts.map

package/dist/output/formats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formats.d.ts","sourceRoot":"","sources":["../../src/output/formats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAG3D,OAAO,EAGL,KAAK,mBAAmB,EAEzB,MAAM,0BAA0B,CAAA;AAEjC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAChC;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,mBAAmB,CAAA;IAC7B,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;CACzC;AAED,MAAM,WAAW,YAAa,SAAQ,cAAc;IAClD,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,eAAe,EAAE,MAAM,CAAA;IACvB,cAAc,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAA;IAC9C,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC3B;AAED,MAAM,WAAW,yBAAyB;IACxC,eAAe,EAAE,MAAM,CAAA;IACvB,cAAc,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAA;CAC/C;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,YAAY,EAAE,CAAA;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;CACrB;AAgED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,wBAAwB,GAChC,YAAY,CA2Dd;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,yBAAyB,GACjC,mBAAmB,CA8CrB"}

package/dist/output/formats.js

@@ -0,0 +1,126 @@
+import { PluginError, isPluginError } from "../openrouter/errors.js";
+import { decodeStrictBase64 } from "../references/data-url.js";
+import { detectImageFormat, isSupportedImageMime, } from "../references/formats.js";
+function imageLabel(index) {
+    return index === undefined ? "The returned image" : `Returned image ${index}`;
+}
+function invalidImage(message, cause) {
+    return new PluginError("GENIMAGE_IMAGE_INVALID", message, {
+        ...(cause === undefined ? {} : { cause }),
+    });
+}
+function extractEncodedPayload(value) {
+    if (!value.startsWith("data:"))
+        return { encoded: value };
+    const match = /^data:([^;,]+);base64,(.*)$/u.exec(value);
+    const declaredMime = match?.[1];
+    const encoded = match?.[2];
+    if (declaredMime === undefined || encoded === undefined || encoded === "") {
+        throw invalidImage("OpenRouter returned an invalid image data URL.");
+    }
+    return { encoded, declaredMime };
+}
+function normalizeDeclaredMime(value) {
+    return value.trim().toLowerCase();
+}
+function addDeclaredMimeWarning(warnings, declaredMime, actualMime, index) {
+    if (declaredMime === undefined)
+        return;
+    const normalized = normalizeDeclaredMime(declaredMime);
+    if (normalized === actualMime)
+        return;
+    const declaration = isSupportedImageMime(normalized)
+        ? normalized
+        : "an unsupported media type";
+    warnings.push(`${imageLabel(index)} was declared as ${declaration}, but its bytes are ${actualMime}; the binary format was used.`);
+}
+function addExpectedFormatWarning(warnings, expectedFormat, detected, index) {
+    if (expectedFormat === undefined || expectedFormat === detected.format)
+        return;
+    warnings.push(`${imageLabel(index)} is ${detected.format.toUpperCase()}, although ${expectedFormat.toUpperCase()} was requested; it will be saved with the actual format extension.`);
+}
+/**
+ * Strictly decodes one OpenRouter image result and classifies it from magic
+ * bytes. Provider media-type fields are advisory and can only produce a
+ * warning; they never override the binary format.
+ */
+export function decodeOutputImage(image, options) {
+    if (!Number.isSafeInteger(options.maxDecodedBytes) || options.maxDecodedBytes <= 0) {
+        throw new TypeError("maxDecodedBytes must be a positive safe integer");
+    }
+    if (typeof image !== "object" ||
+        image === null ||
+        Array.isArray(image) ||
+        !("b64_json" in image) ||
+        typeof image.b64_json !== "string" ||
+        image.b64_json === "" ||
+        ("media_type" in image &&
+            image.media_type !== undefined &&
+            typeof image.media_type !== "string")) {
+        throw invalidImage("OpenRouter returned an image without valid base64 data.");
+    }
+    const encodedImage = image;
+    const payload = extractEncodedPayload(encodedImage.b64_json);
+    let bytes;
+    try {
+        bytes = decodeStrictBase64(payload.encoded, options.maxDecodedBytes);
+    }
+    catch (error) {
+        throw invalidImage("OpenRouter returned invalid or oversized base64 image data.", error);
+    }
+    const detected = detectImageFormat(bytes);
+    if (detected === undefined) {
+        throw invalidImage("OpenRouter returned an unsupported image binary; only PNG, JPEG, and WebP are accepted.");
+    }
+    const warnings = [];
+    addDeclaredMimeWarning(warnings, payload.declaredMime, detected.mime, options.index);
+    if (encodedImage.media_type !== undefined &&
+        normalizeDeclaredMime(encodedImage.media_type) !==
+            normalizeDeclaredMime(payload.declaredMime ?? "")) {
+        addDeclaredMimeWarning(warnings, encodedImage.media_type, detected.mime, options.index);
+    }
+    addExpectedFormatWarning(warnings, options.expectedFormat, detected, options.index);
+    return { bytes, detected, warnings };
+}
+/**
+ * Decodes a response defensively. Invalid entries are skipped so callers can
+ * report partial success. The decoded-byte budget applies to the full set.
+ */
+export function decodeOutputImages(data, options) {
+    if (!Array.isArray(data) || data.length === 0) {
+        throw new PluginError("GENIMAGE_RESPONSE_INVALID", "OpenRouter returned no generated images.");
+    }
+    if (!Number.isSafeInteger(options.maxDecodedBytes) || options.maxDecodedBytes <= 0) {
+        throw new TypeError("maxDecodedBytes must be a positive safe integer");
+    }
+    const entries = data;
+    const images = [];
+    const warnings = [];
+    let decodedBytes = 0;
+    let invalidCount = 0;
+    for (const [zeroBasedIndex, image] of entries.entries()) {
+        const index = zeroBasedIndex + 1;
+        try {
+            const decoded = decodeOutputImage(image, {
+                maxDecodedBytes: options.maxDecodedBytes - decodedBytes,
+                ...(options.expectedFormat === undefined
+                    ? {}
+                    : { expectedFormat: options.expectedFormat }),
+                index,
+            });
+            decodedBytes += decoded.bytes.byteLength;
+            images.push(decoded);
+            warnings.push(...decoded.warnings);
+        }
+        catch (error) {
+            invalidCount += 1;
+            const code = isPluginError(error) ? error.code : "GENIMAGE_IMAGE_INVALID";
+            warnings.push(`Returned image ${index} was invalid and was skipped (${code}).`);
+        }
+    }
+    if (images.length === 0) {
+        throw new PluginError("GENIMAGE_IMAGE_INVALID", "OpenRouter did not return any valid PNG, JPEG, or WebP images.", { details: { returnedCount: entries.length, invalidCount } });
+    }
+    return { images, warnings, invalidCount };
+}
+//# sourceMappingURL=formats.js.map

package/dist/output/formats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formats.js","sourceRoot":"","sources":["../../src/output/formats.ts"],"names":[],"mappings":"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"}

package/dist/output/index.d.ts

@@ -0,0 +1,5 @@
+export { createToolAttachment, createToolAttachments, type ToolFileAttachment, } from "./attachments.js";
+export { decodeOutputImage, decodeOutputImages, type DecodeOutputImageOptions, type DecodeOutputImagesOptions, type DecodedImage, type DecodedOutputImages, type EncodedOutputImage, type ValidatedImage, } from "./formats.js";
+export { addCollisionSuffix, assertOutputParentContained, assertSafeOutputRelativePath, ensureSafeOutputParent, findNearestExistingAncestor, isExistingPathError, planOutputPaths, recheckSafeOutputParent, type OutputPathPlan, type OutputPathRequest, type PlannedOutputPath, } from "./paths.js";
+export { ImageSaveError, saveImages, type SavedImage, type SaveImagesOptions, } from "./writer.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/output/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/output/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,KAAK,kBAAkB,GACxB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,cAAc,GACpB,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,kBAAkB,EAClB,2BAA2B,EAC3B,4BAA4B,EAC5B,sBAAsB,EACtB,2BAA2B,EAC3B,mBAAmB,EACnB,eAAe,EACf,uBAAuB,EACvB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,cAAc,EACd,UAAU,EACV,KAAK,UAAU,EACf,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAA"}

package/dist/output/index.js

@@ -0,0 +1,5 @@
+export { createToolAttachment, createToolAttachments, } from "./attachments.js";
+export { decodeOutputImage, decodeOutputImages, } from "./formats.js";
+export { addCollisionSuffix, assertOutputParentContained, assertSafeOutputRelativePath, ensureSafeOutputParent, findNearestExistingAncestor, isExistingPathError, planOutputPaths, recheckSafeOutputParent, } from "./paths.js";
+export { ImageSaveError, saveImages, } from "./writer.js";
+//# sourceMappingURL=index.js.map

package/dist/output/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/output/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,qBAAqB,GAEtB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,GAOnB,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,kBAAkB,EAClB,2BAA2B,EAC3B,4BAA4B,EAC5B,sBAAsB,EACtB,2BAA2B,EAC3B,mBAAmB,EACnB,eAAe,EACf,uBAAuB,GAIxB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,cAAc,EACd,UAAU,GAGX,MAAM,aAAa,CAAA"}

package/dist/output/paths.d.ts

@@ -0,0 +1,38 @@
+import { type DetectedImageFormat } from "../references/formats.js";
+export interface OutputPathRequest {
+    worktree: string;
+    outputDirectory: string;
+    outputPath?: string | undefined;
+    detectedFormats: readonly DetectedImageFormat[];
+    sourcePaths?: readonly string[] | undefined;
+    now?: Date | undefined;
+    randomId?: (() => string) | undefined;
+}
+export interface PlannedOutputPath {
+    absolutePath: string;
+    relativePath: string;
+    filename: string;
+    warnings: string[];
+    /** Unsuffixed candidate used to continue a collision sequence atomically. */
+    collisionBaseRelativePath: string;
+    collisionNumber: number;
+}
+export interface OutputPathPlan {
+    canonicalWorktree: string;
+    paths: PlannedOutputPath[];
+}
+/** Validate a portable, worktree-relative path without resolving it. */
+export declare function assertSafeOutputRelativePath(value: string, kind?: "file" | "directory"): string;
+export declare function isExistingPathError(error: unknown): boolean;
+export declare function findNearestExistingAncestor(value: string): Promise<string>;
+export declare function assertOutputParentContained(canonicalWorktree: string, parent: string): Promise<void>;
+/** Create an output parent, then canonicalize it again to catch symlink escapes. */
+export declare function ensureSafeOutputParent(canonicalWorktree: string, parent: string): Promise<string>;
+export declare function recheckSafeOutputParent(canonicalWorktree: string, parent: string): Promise<void>;
+export declare function addCollisionSuffix(relativePath: string, collision: number): string;
+/**
+ * Plans non-conflicting destinations. This is advisory only: the writer still
+ * uses an atomic no-clobber operation to close the check/write race.
+ */
+export declare function planOutputPaths(request: OutputPathRequest): Promise<OutputPathPlan>;
+//# sourceMappingURL=paths.d.ts.map

package/dist/output/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/output/paths.ts"],"names":[],"mappings":"AASA,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,0BAA0B,CAAA;AAEjC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,MAAM,CAAA;IACvB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,eAAe,EAAE,SAAS,mBAAmB,EAAE,CAAA;IAC/C,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;IAC3C,GAAG,CAAC,EAAE,IAAI,GAAG,SAAS,CAAA;IACtB,QAAQ,CAAC,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,CAAA;CACtC;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,6EAA6E;IAC7E,yBAAyB,EAAE,MAAM,CAAA;IACjC,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,iBAAiB,EAAE,MAAM,CAAA;IACzB,KAAK,EAAE,iBAAiB,EAAE,CAAA;CAC3B;AA4CD,wEAAwE;AACxE,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,MAAM,GAAG,WAAoB,GAClC,MAAM,CAuBR;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAO3D;AAED,wBAAsB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAehF;AAED,wBAAsB,2BAA2B,CAC/C,iBAAiB,EAAE,MAAM,EACzB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED,oFAAoF;AACpF,wBAAsB,sBAAsB,CAC1C,iBAAiB,EAAE,MAAM,EACzB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAiBjB;AAED,wBAAsB,uBAAuB,CAC3C,iBAAiB,EAAE,MAAM,EACzB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAcf;AAgDD,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAMlF;AAkFD;;;GAGG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,cAAc,CAAC,CAwGzB"}