@evalops/maestro 0.10.51 → 0.10.53

package/dist/services/image-providers/masks.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Bounding-box → mask synthesis.
+ *
+ * The OpenAI image edit endpoint accepts a mask PNG whose transparent pixels
+ * mark the region the model is allowed to change. Requiring callers to author
+ * that PNG by hand is poor UX, so Painter accepts a pixel bounding box and we
+ * synthesize the mask here.
+ *
+ * This module is dependency-free (only `node:zlib`) so it is fully unit-
+ * testable and works whether or not the optional `sharp` package is present.
+ * Dimension detection of arbitrary input formats is handled by the caller
+ * (see `readPngDimensions` for the common PNG case).
+ *
+ * Convention: transparent (alpha 0) = editable region; opaque (alpha 255) =
+ * preserved. Matches the OpenAI Images API mask semantics.
+ *
+ * @module services/image-providers/masks
+ */
+/** Pixel rectangle. Coordinates outside the canvas are clipped to bounds. */
+export interface MaskRegion {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface ImageDimensions {
+    width: number;
+    height: number;
+}
+export declare function crc32(buf: Buffer): number;
+/** Clip a region to the canvas, returning a normalized {x,y,width,height}. */
+export declare function clipRegion(canvas: ImageDimensions, region: MaskRegion): {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+/**
+ * Encode an RGBA mask PNG of the given canvas size. Pixels inside `region`
+ * are transparent (editable); everything else is opaque (preserved).
+ *
+ * @throws if canvas dimensions are non-positive or the region is degenerate
+ *         after clipping.
+ */
+export declare function encodeMaskPng(canvas: ImageDimensions, region: MaskRegion): Buffer;
+/**
+ * Read {width, height} from a PNG buffer by parsing the IHDR chunk.
+ * Returns null if the buffer is not a PNG or the IHDR is malformed.
+ */
+export declare function readPngDimensions(buf: Buffer): ImageDimensions | null;
+//# sourceMappingURL=masks.d.ts.map

package/dist/services/image-providers/masks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"masks.d.ts","sourceRoot":"","sources":["../../../src/services/image-providers/masks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,6EAA6E;AAC7E,MAAM,WAAW,UAAU;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACf;AAoBD,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOzC;AAwBD,8EAA8E;AAC9E,wBAAgB,UAAU,CACzB,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,UAAU,GAChB;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAMzD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC5B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,UAAU,GAChB,MAAM,CAuCR;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAUrE"}

package/dist/services/image-providers/masks.js

@@ -0,0 +1,132 @@
+/**
+ * Bounding-box → mask synthesis.
+ *
+ * The OpenAI image edit endpoint accepts a mask PNG whose transparent pixels
+ * mark the region the model is allowed to change. Requiring callers to author
+ * that PNG by hand is poor UX, so Painter accepts a pixel bounding box and we
+ * synthesize the mask here.
+ *
+ * This module is dependency-free (only `node:zlib`) so it is fully unit-
+ * testable and works whether or not the optional `sharp` package is present.
+ * Dimension detection of arbitrary input formats is handled by the caller
+ * (see `readPngDimensions` for the common PNG case).
+ *
+ * Convention: transparent (alpha 0) = editable region; opaque (alpha 255) =
+ * preserved. Matches the OpenAI Images API mask semantics.
+ *
+ * @module services/image-providers/masks
+ */
+import { deflateSync } from "node:zlib";
+const PNG_SIGNATURE = Buffer.from([
+    0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a,
+]);
+// --- CRC32 (table-based, standard IEEE 802.3 polynomial) ---------------------
+const CRC_TABLE = (() => {
+    const table = new Uint32Array(256);
+    for (let n = 0; n < 256; n++) {
+        let c = n;
+        for (let k = 0; k < 8; k++) {
+            c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;
+        }
+        table[n] = c >>> 0;
+    }
+    return table;
+})();
+export function crc32(buf) {
+    let c = 0xffffffff;
+    for (let i = 0; i < buf.length; i++) {
+        const idx = (c ^ (buf[i] ?? 0)) & 0xff;
+        c = (CRC_TABLE[idx] ?? 0) ^ (c >>> 8);
+    }
+    return (c ^ 0xffffffff) >>> 0;
+}
+function pngChunk(type, data) {
+    const typeBuf = Buffer.from(type, "ascii");
+    const lenBuf = Buffer.alloc(4);
+    lenBuf.writeUInt32BE(data.length, 0);
+    const crcBuf = Buffer.alloc(4);
+    crcBuf.writeUInt32BE(crc32(Buffer.concat([typeBuf, data])), 0);
+    return Buffer.concat([lenBuf, typeBuf, data, crcBuf]);
+}
+function ihdr(width, height) {
+    const data = Buffer.alloc(13);
+    data.writeUInt32BE(width, 0);
+    data.writeUInt32BE(height, 4);
+    // bit depth 8, color type 6 (RGBA), compression 0, filter 0, interlace 0
+    data[8] = 8;
+    data[9] = 6;
+    data[10] = 0;
+    data[11] = 0;
+    data[12] = 0;
+    return data;
+}
+/** Clip a region to the canvas, returning a normalized {x,y,width,height}. */
+export function clipRegion(canvas, region) {
+    const x = Math.max(0, Math.floor(region.x));
+    const y = Math.max(0, Math.floor(region.y));
+    const x2 = Math.min(canvas.width, Math.ceil(region.x + region.width));
+    const y2 = Math.min(canvas.height, Math.ceil(region.y + region.height));
+    return { x, y, width: Math.max(0, x2 - x), height: Math.max(0, y2 - y) };
+}
+/**
+ * Encode an RGBA mask PNG of the given canvas size. Pixels inside `region`
+ * are transparent (editable); everything else is opaque (preserved).
+ *
+ * @throws if canvas dimensions are non-positive or the region is degenerate
+ *         after clipping.
+ */
+export function encodeMaskPng(canvas, region) {
+    if (canvas.width <= 0 || canvas.height <= 0) {
+        throw new Error(`encodeMaskPng: canvas dimensions must be positive (got ${canvas.width}x${canvas.height})`);
+    }
+    const clipped = clipRegion(canvas, region);
+    if (clipped.width <= 0 || clipped.height <= 0) {
+        throw new Error("encodeMaskPng: region is empty after clipping to canvas bounds");
+    }
+    const { width, height } = canvas;
+    // Build raw scanlines: filter byte 0 (None) + width * 4 bytes RGBA.
+    const rowLen = width * 4;
+    const raw = Buffer.alloc((rowLen + 1) * height);
+    for (let y = 0; y < height; y++) {
+        const rowStart = y * (rowLen + 1);
+        raw[rowStart] = 0; // filter: None
+        const inY = y >= clipped.y && y < clipped.y + clipped.height;
+        for (let x = 0; x < width; x++) {
+            const px = rowStart + 1 + x * 4;
+            const inX = x >= clipped.x && x < clipped.x + clipped.width;
+            // RGB 0; alpha 0 inside region (editable), 255 outside (preserved).
+            raw[px] = 0;
+            raw[px + 1] = 0;
+            raw[px + 2] = 0;
+            raw[px + 3] = inX && inY ? 0 : 255;
+        }
+    }
+    const idat = deflateSync(raw);
+    return Buffer.concat([
+        PNG_SIGNATURE,
+        pngChunk("IHDR", ihdr(width, height)),
+        pngChunk("IDAT", idat),
+        pngChunk("IEND", Buffer.alloc(0)),
+    ]);
+}
+/**
+ * Read {width, height} from a PNG buffer by parsing the IHDR chunk.
+ * Returns null if the buffer is not a PNG or the IHDR is malformed.
+ */
+export function readPngDimensions(buf) {
+    if (buf.length < 24)
+        return null;
+    if (!PNG_SIGNATURE.equals(buf.subarray(0, 8)))
+        return null;
+    // Bytes 12..16 = "IHDR"; 16..20 = width; 20..24 = height.
+    if (buf.toString("ascii", 12, 16) !== "IHDR")
+        return null;
+    const width = buf.readUInt32BE(16);
+    const height = buf.readUInt32BE(20);
+    if (!Number.isFinite(width) || !Number.isFinite(height))
+        return null;
+    if (width <= 0 || height <= 0)
+        return null;
+    return { width, height };
+}
+//# sourceMappingURL=masks.js.map

package/dist/services/image-providers/masks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"masks.js","sourceRoot":"","sources":["../../../src/services/image-providers/masks.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Bounding-box → mask synthesis.\n *\n * The OpenAI image edit endpoint accepts a mask PNG whose transparent pixels\n * mark the region the model is allowed to change. Requiring callers to author\n * that PNG by hand is poor UX, so Painter accepts a pixel bounding box and we\n * synthesize the mask here.\n *\n * This module is dependency-free (only `node:zlib`) so it is fully unit-\n * testable and works whether or not the optional `sharp` package is present.\n * Dimension detection of arbitrary input formats is handled by the caller\n * (see `readPngDimensions` for the common PNG case).\n *\n * Convention: transparent (alpha 0) = editable region; opaque (alpha 255) =\n * preserved. Matches the OpenAI Images API mask semantics.\n *\n * @module services/image-providers/masks\n */\n\nimport { deflateSync } from \"node:zlib\";\n\n/** Pixel rectangle. Coordinates outside the canvas are clipped to bounds. */\nexport interface MaskRegion {\n\tx: number;\n\ty: number;\n\twidth: number;\n\theight: number;\n}\n\nexport interface ImageDimensions {\n\twidth: number;\n\theight: number;\n}\n\nconst PNG_SIGNATURE = Buffer.from([\n\t0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a,\n]);\n\n// --- CRC32 (table-based, standard IEEE 802.3 polynomial) ---------------------\n\nconst CRC_TABLE: Uint32Array = (() => {\n\tconst table = new Uint32Array(256);\n\tfor (let n = 0; n < 256; n++) {\n\t\tlet c = n;\n\t\tfor (let k = 0; k < 8; k++) {\n\t\t\tc = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;\n\t\t}\n\t\ttable[n] = c >>> 0;\n\t}\n\treturn table;\n})();\n\nexport function crc32(buf: Buffer): number {\n\tlet c = 0xffffffff;\n\tfor (let i = 0; i < buf.length; i++) {\n\t\tconst idx = (c ^ (buf[i] ?? 0)) & 0xff;\n\t\tc = (CRC_TABLE[idx] ?? 0) ^ (c >>> 8);\n\t}\n\treturn (c ^ 0xffffffff) >>> 0;\n}\n\nfunction pngChunk(type: string, data: Buffer): Buffer {\n\tconst typeBuf = Buffer.from(type, \"ascii\");\n\tconst lenBuf = Buffer.alloc(4);\n\tlenBuf.writeUInt32BE(data.length, 0);\n\tconst crcBuf = Buffer.alloc(4);\n\tcrcBuf.writeUInt32BE(crc32(Buffer.concat([typeBuf, data])), 0);\n\treturn Buffer.concat([lenBuf, typeBuf, data, crcBuf]);\n}\n\nfunction ihdr(width: number, height: number): Buffer {\n\tconst data = Buffer.alloc(13);\n\tdata.writeUInt32BE(width, 0);\n\tdata.writeUInt32BE(height, 4);\n\t// bit depth 8, color type 6 (RGBA), compression 0, filter 0, interlace 0\n\tdata[8] = 8;\n\tdata[9] = 6;\n\tdata[10] = 0;\n\tdata[11] = 0;\n\tdata[12] = 0;\n\treturn data;\n}\n\n/** Clip a region to the canvas, returning a normalized {x,y,width,height}. */\nexport function clipRegion(\n\tcanvas: ImageDimensions,\n\tregion: MaskRegion,\n): { x: number; y: number; width: number; height: number } {\n\tconst x = Math.max(0, Math.floor(region.x));\n\tconst y = Math.max(0, Math.floor(region.y));\n\tconst x2 = Math.min(canvas.width, Math.ceil(region.x + region.width));\n\tconst y2 = Math.min(canvas.height, Math.ceil(region.y + region.height));\n\treturn { x, y, width: Math.max(0, x2 - x), height: Math.max(0, y2 - y) };\n}\n\n/**\n * Encode an RGBA mask PNG of the given canvas size. Pixels inside `region`\n * are transparent (editable); everything else is opaque (preserved).\n *\n * @throws if canvas dimensions are non-positive or the region is degenerate\n *         after clipping.\n */\nexport function encodeMaskPng(\n\tcanvas: ImageDimensions,\n\tregion: MaskRegion,\n): Buffer {\n\tif (canvas.width <= 0 || canvas.height <= 0) {\n\t\tthrow new Error(\n\t\t\t`encodeMaskPng: canvas dimensions must be positive (got ${canvas.width}x${canvas.height})`,\n\t\t);\n\t}\n\tconst clipped = clipRegion(canvas, region);\n\tif (clipped.width <= 0 || clipped.height <= 0) {\n\t\tthrow new Error(\n\t\t\t\"encodeMaskPng: region is empty after clipping to canvas bounds\",\n\t\t);\n\t}\n\n\tconst { width, height } = canvas;\n\t// Build raw scanlines: filter byte 0 (None) + width * 4 bytes RGBA.\n\tconst rowLen = width * 4;\n\tconst raw = Buffer.alloc((rowLen + 1) * height);\n\tfor (let y = 0; y < height; y++) {\n\t\tconst rowStart = y * (rowLen + 1);\n\t\traw[rowStart] = 0; // filter: None\n\t\tconst inY = y >= clipped.y && y < clipped.y + clipped.height;\n\t\tfor (let x = 0; x < width; x++) {\n\t\t\tconst px = rowStart + 1 + x * 4;\n\t\t\tconst inX = x >= clipped.x && x < clipped.x + clipped.width;\n\t\t\t// RGB 0; alpha 0 inside region (editable), 255 outside (preserved).\n\t\t\traw[px] = 0;\n\t\t\traw[px + 1] = 0;\n\t\t\traw[px + 2] = 0;\n\t\t\traw[px + 3] = inX && inY ? 0 : 255;\n\t\t}\n\t}\n\n\tconst idat = deflateSync(raw);\n\treturn Buffer.concat([\n\t\tPNG_SIGNATURE,\n\t\tpngChunk(\"IHDR\", ihdr(width, height)),\n\t\tpngChunk(\"IDAT\", idat),\n\t\tpngChunk(\"IEND\", Buffer.alloc(0)),\n\t]);\n}\n\n/**\n * Read {width, height} from a PNG buffer by parsing the IHDR chunk.\n * Returns null if the buffer is not a PNG or the IHDR is malformed.\n */\nexport function readPngDimensions(buf: Buffer): ImageDimensions | null {\n\tif (buf.length < 24) return null;\n\tif (!PNG_SIGNATURE.equals(buf.subarray(0, 8))) return null;\n\t// Bytes 12..16 = \"IHDR\"; 16..20 = width; 20..24 = height.\n\tif (buf.toString(\"ascii\", 12, 16) !== \"IHDR\") return null;\n\tconst width = buf.readUInt32BE(16);\n\tconst height = buf.readUInt32BE(20);\n\tif (!Number.isFinite(width) || !Number.isFinite(height)) return null;\n\tif (width <= 0 || height <= 0) return null;\n\treturn { width, height };\n}\n"]}

package/dist/services/image-providers/openai.d.ts

@@ -0,0 +1,35 @@
+import OpenAI from "openai";
+import type { EditOptions, GenerateOptions, ImageProvider, ImageResult } from "./types.js";
+export interface OpenAIImageProviderOptions {
+    apiKey?: string;
+    baseURL?: string;
+    model?: string;
+    /**
+     * Optional pre-built client, primarily for tests. When omitted the provider
+     * constructs `new OpenAI(...)` from `apiKey`/`baseURL`.
+     */
+    client?: OpenAI;
+    /**
+     * Persist decoded image bytes to disk and return the absolute path.
+     * Kept as a callback so the provider stays free of filesystem policy.
+     */
+    writeImage: (bytes: Buffer, ext: string) => Promise<{
+        path: string;
+    }>;
+}
+export declare class OpenAIImageProvider implements ImageProvider {
+    readonly id = "openai";
+    readonly supports: {
+        readonly generate: true;
+        readonly edit: true;
+        readonly mask: true;
+    };
+    private readonly client;
+    private readonly model;
+    private readonly writeImage;
+    constructor(options: OpenAIImageProviderOptions);
+    generate(options: GenerateOptions): Promise<ImageResult>;
+    edit(options: EditOptions): Promise<ImageResult>;
+    private toResult;
+}
+//# sourceMappingURL=openai.d.ts.map

package/dist/services/image-providers/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/services/image-providers/openai.ts"],"names":[],"mappings":"AAEA,OAAO,MAAkB,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EACX,WAAW,EACX,eAAe,EACf,aAAa,EAEb,WAAW,EAEX,MAAM,YAAY,CAAC;AAqCpB,MAAM,WAAW,0BAA0B;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtE;AAED,qBAAa,mBAAoB,YAAW,aAAa;IACxD,QAAQ,CAAC,EAAE,YAAY;IACvB,QAAQ,CAAC,QAAQ;;;;MAAuD;IAExE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA2C;gBAE1D,OAAO,EAAE,0BAA0B;IAQzC,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IAexD,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;YAuCxC,QAAQ;CAiBtB"}

package/dist/services/image-providers/openai.js

@@ -0,0 +1,93 @@
+import { readFile } from "node:fs/promises";
+import { basename, extname } from "node:path";
+import OpenAI, { toFile } from "openai";
+/** Default model. gpt-image-2 does NOT support transparency. */
+const DEFAULT_MODEL = "gpt-image-2";
+function mimeTypeForPath(path) {
+    switch (extname(path).toLowerCase()) {
+        case ".png":
+            return "image/png";
+        case ".jpg":
+        case ".jpeg":
+            return "image/jpeg";
+        case ".webp":
+            return "image/webp";
+        default:
+            return "application/octet-stream";
+    }
+}
+/** Narrow the images.edit/generate response union to its non-streaming member. */
+function extractItems(response) {
+    if (response && typeof response === "object" && "data" in response) {
+        const data = response.data;
+        return Array.isArray(data) ? data : [];
+    }
+    return [];
+}
+export class OpenAIImageProvider {
+    constructor(options) {
+        this.id = "openai";
+        this.supports = { generate: true, edit: true, mask: true };
+        this.client =
+            options.client ??
+                new OpenAI({ apiKey: options.apiKey, baseURL: options.baseURL });
+        this.model = options.model ?? DEFAULT_MODEL;
+        this.writeImage = options.writeImage;
+    }
+    async generate(options) {
+        const response = await this.client.images.generate({
+            model: this.model,
+            prompt: options.prompt,
+            size: options.size,
+            quality: options.quality,
+            background: options.background,
+            n: options.n ?? 1,
+        }, { signal: options.signal });
+        return this.toResult(extractItems(response));
+    }
+    async edit(options) {
+        if (!this.supports.edit) {
+            throw new Error("OpenAI image provider does not support editing.");
+        }
+        if (options.images.length === 0) {
+            throw new Error("Edit mode requires at least one input image path.");
+        }
+        const imageFiles = await Promise.all(options.images.slice(0, 3).map(async (p) => toFile(await readFile(p), basename(p), {
+            type: mimeTypeForPath(p),
+        })));
+        const params = {
+            model: this.model,
+            image: imageFiles,
+            prompt: options.prompt,
+            size: options.size,
+            quality: options.quality,
+            n: options.n ?? 1,
+        };
+        if (options.maskPath) {
+            params.mask = await toFile(await readFile(options.maskPath), basename(options.maskPath), { type: mimeTypeForPath(options.maskPath) });
+        }
+        const response = await this.client.images.edit(params, {
+            signal: options.signal,
+        });
+        return this.toResult(extractItems(response));
+    }
+    async toResult(items) {
+        const images = [];
+        for (const item of items) {
+            if (!item.b64_json)
+                continue;
+            const buf = Buffer.from(item.b64_json, "base64");
+            const { path } = await this.writeImage(buf, "png");
+            images.push({
+                path,
+                mimeType: "image/png",
+                revisedPrompt: item.revised_prompt ?? undefined,
+            });
+        }
+        if (images.length === 0) {
+            throw new Error("OpenAI image API returned no image data.");
+        }
+        return { images, provider: this.id, model: this.model };
+    }
+}
+//# sourceMappingURL=openai.js.map

package/dist/services/image-providers/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../../src/services/image-providers/openai.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFile } from \"node:fs/promises\";\nimport { basename, extname } from \"node:path\";\nimport OpenAI, { toFile } from \"openai\";\nimport type {\n\tEditOptions,\n\tGenerateOptions,\n\tImageProvider,\n\tImageQuality,\n\tImageResult,\n\tImageSize,\n} from \"./types.js\";\n\n/** Default model. gpt-image-2 does NOT support transparency. */\nconst DEFAULT_MODEL = \"gpt-image-2\";\n\ninterface RawImageItem {\n\tb64_json?: string | null;\n\trevised_prompt?: string | null;\n}\n\ninterface ImagesResponseLike {\n\tdata?: RawImageItem[];\n}\n\nfunction mimeTypeForPath(path: string): string {\n\tswitch (extname(path).toLowerCase()) {\n\t\tcase \".png\":\n\t\t\treturn \"image/png\";\n\t\tcase \".jpg\":\n\t\tcase \".jpeg\":\n\t\t\treturn \"image/jpeg\";\n\t\tcase \".webp\":\n\t\t\treturn \"image/webp\";\n\t\tdefault:\n\t\t\treturn \"application/octet-stream\";\n\t}\n}\n\n/** Narrow the images.edit/generate response union to its non-streaming member. */\nfunction extractItems(response: unknown): RawImageItem[] {\n\tif (response && typeof response === \"object\" && \"data\" in response) {\n\t\tconst data = (response as ImagesResponseLike).data;\n\t\treturn Array.isArray(data) ? data : [];\n\t}\n\treturn [];\n}\n\nexport interface OpenAIImageProviderOptions {\n\tapiKey?: string;\n\tbaseURL?: string;\n\tmodel?: string;\n\t/**\n\t * Optional pre-built client, primarily for tests. When omitted the provider\n\t * constructs `new OpenAI(...)` from `apiKey`/`baseURL`.\n\t */\n\tclient?: OpenAI;\n\t/**\n\t * Persist decoded image bytes to disk and return the absolute path.\n\t * Kept as a callback so the provider stays free of filesystem policy.\n\t */\n\twriteImage: (bytes: Buffer, ext: string) => Promise<{ path: string }>;\n}\n\nexport class OpenAIImageProvider implements ImageProvider {\n\treadonly id = \"openai\";\n\treadonly supports = { generate: true, edit: true, mask: true } as const;\n\n\tprivate readonly client: OpenAI;\n\tprivate readonly model: string;\n\tprivate readonly writeImage: OpenAIImageProviderOptions[\"writeImage\"];\n\n\tconstructor(options: OpenAIImageProviderOptions) {\n\t\tthis.client =\n\t\t\toptions.client ??\n\t\t\tnew OpenAI({ apiKey: options.apiKey, baseURL: options.baseURL });\n\t\tthis.model = options.model ?? DEFAULT_MODEL;\n\t\tthis.writeImage = options.writeImage;\n\t}\n\n\tasync generate(options: GenerateOptions): Promise<ImageResult> {\n\t\tconst response = await this.client.images.generate(\n\t\t\t{\n\t\t\t\tmodel: this.model,\n\t\t\t\tprompt: options.prompt,\n\t\t\t\tsize: options.size as ImageSize | undefined,\n\t\t\t\tquality: options.quality as ImageQuality | undefined,\n\t\t\t\tbackground: options.background,\n\t\t\t\tn: options.n ?? 1,\n\t\t\t},\n\t\t\t{ signal: options.signal },\n\t\t);\n\t\treturn this.toResult(extractItems(response));\n\t}\n\n\tasync edit(options: EditOptions): Promise<ImageResult> {\n\t\tif (!this.supports.edit) {\n\t\t\tthrow new Error(\"OpenAI image provider does not support editing.\");\n\t\t}\n\t\tif (options.images.length === 0) {\n\t\t\tthrow new Error(\"Edit mode requires at least one input image path.\");\n\t\t}\n\n\t\tconst imageFiles = await Promise.all(\n\t\t\toptions.images.slice(0, 3).map(async (p) =>\n\t\t\t\ttoFile(await readFile(p), basename(p), {\n\t\t\t\t\ttype: mimeTypeForPath(p),\n\t\t\t\t}),\n\t\t\t),\n\t\t);\n\n\t\tconst params: Parameters<OpenAI[\"images\"][\"edit\"]>[0] = {\n\t\t\tmodel: this.model,\n\t\t\timage: imageFiles,\n\t\t\tprompt: options.prompt,\n\t\t\tsize: options.size as Parameters<OpenAI[\"images\"][\"edit\"]>[0][\"size\"],\n\t\t\tquality: options.quality as ImageQuality | undefined,\n\t\t\tn: options.n ?? 1,\n\t\t};\n\n\t\tif (options.maskPath) {\n\t\t\tparams.mask = await toFile(\n\t\t\t\tawait readFile(options.maskPath),\n\t\t\t\tbasename(options.maskPath),\n\t\t\t\t{ type: mimeTypeForPath(options.maskPath) },\n\t\t\t);\n\t\t}\n\n\t\tconst response = await this.client.images.edit(params, {\n\t\t\tsignal: options.signal,\n\t\t});\n\t\treturn this.toResult(extractItems(response));\n\t}\n\n\tprivate async toResult(items: RawImageItem[]): Promise<ImageResult> {\n\t\tconst images = [];\n\t\tfor (const item of items) {\n\t\t\tif (!item.b64_json) continue;\n\t\t\tconst buf = Buffer.from(item.b64_json, \"base64\");\n\t\t\tconst { path } = await this.writeImage(buf, \"png\");\n\t\t\timages.push({\n\t\t\t\tpath,\n\t\t\t\tmimeType: \"image/png\",\n\t\t\t\trevisedPrompt: item.revised_prompt ?? undefined,\n\t\t\t});\n\t\t}\n\t\tif (images.length === 0) {\n\t\t\tthrow new Error(\"OpenAI image API returned no image data.\");\n\t\t}\n\t\treturn { images, provider: this.id, model: this.model };\n\t}\n}\n"]}

package/dist/services/image-providers/types.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Image provider abstraction.
+ *
+ * Image generation/editing is NOT symmetric across providers the way chat
+ * completion is: today only OpenAI's image API cleanly supports both
+ * generation and masked editing. The `supports` map keeps that asymmetry
+ * honest rather than pretending every provider implements every capability.
+ *
+ * Add a new provider by implementing `ImageProvider` and registering it in
+ * `./index.ts`. Do not weaken this interface to make a generate-only or
+ * edit-only provider look symmetric — declare what it actually supports and
+ * let callers fail closed.
+ *
+ * @module services/image-providers
+ */
+export type ImageSize = "1024x1024" | "1536x1024" | "1024x1536" | "1792x1024" | "1024x1792" | "auto";
+export type ImageQuality = "low" | "medium" | "high" | "auto";
+export type ImageBackground = "transparent" | "opaque" | "auto";
+export interface GenerateOptions {
+    prompt: string;
+    size?: ImageSize;
+    quality?: ImageQuality;
+    background?: ImageBackground;
+    /** Number of images to produce. Defaults to 1. */
+    n?: number;
+    signal?: AbortSignal;
+}
+export interface EditOptions extends Omit<GenerateOptions, "background"> {
+    /** 1-3 input image paths to edit. */
+    images: string[];
+    /**
+     * Optional mask image path. Transparent regions of the mask mark the
+     * areas the model is allowed to change. Omit for a whole-image edit.
+     */
+    maskPath?: string;
+}
+export interface ImageOutput {
+    /** Absolute path where the generated image was persisted. */
+    path: string;
+    mimeType: string;
+    /** Provider-returned revised prompt, when available. */
+    revisedPrompt?: string;
+}
+export interface ImageResult {
+    images: ImageOutput[];
+    /** Provider id (e.g. "openai"). */
+    provider: string;
+    model: string;
+}
+export interface ImageProvider {
+    id: string;
+    /** Capabilities this provider actually implements. Used to fail closed. */
+    supports: {
+        generate: boolean;
+        edit: boolean;
+        mask: boolean;
+    };
+    generate(options: GenerateOptions): Promise<ImageResult>;
+    edit(options: EditOptions): Promise<ImageResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/image-providers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/image-providers/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,SAAS,GAClB,WAAW,GACX,WAAW,GACX,WAAW,GACX,WAAW,GACX,WAAW,GACX,MAAM,CAAC;AAEV,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAE9D,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEhE,MAAM,WAAW,eAAe;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,kDAAkD;IAClD,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,WAAY,SAAQ,IAAI,CAAC,eAAe,EAAE,YAAY,CAAC;IACvE,qCAAqC;IACrC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC3B,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC3B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,2EAA2E;IAC3E,QAAQ,EAAE;QACT,QAAQ,EAAE,OAAO,CAAC;QAClB,IAAI,EAAE,OAAO,CAAC;QACd,IAAI,EAAE,OAAO,CAAC;KACd,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACzD,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACjD"}

package/dist/services/image-providers/types.js

@@ -0,0 +1,17 @@
+/**
+ * Image provider abstraction.
+ *
+ * Image generation/editing is NOT symmetric across providers the way chat
+ * completion is: today only OpenAI's image API cleanly supports both
+ * generation and masked editing. The `supports` map keeps that asymmetry
+ * honest rather than pretending every provider implements every capability.
+ *
+ * Add a new provider by implementing `ImageProvider` and registering it in
+ * `./index.ts`. Do not weaken this interface to make a generate-only or
+ * edit-only provider look symmetric — declare what it actually supports and
+ * let callers fail closed.
+ *
+ * @module services/image-providers
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/services/image-providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/image-providers/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG","sourcesContent":["/**\n * Image provider abstraction.\n *\n * Image generation/editing is NOT symmetric across providers the way chat\n * completion is: today only OpenAI's image API cleanly supports both\n * generation and masked editing. The `supports` map keeps that asymmetry\n * honest rather than pretending every provider implements every capability.\n *\n * Add a new provider by implementing `ImageProvider` and registering it in\n * `./index.ts`. Do not weaken this interface to make a generate-only or\n * edit-only provider look symmetric — declare what it actually supports and\n * let callers fail closed.\n *\n * @module services/image-providers\n */\n\nexport type ImageSize =\n\t| \"1024x1024\"\n\t| \"1536x1024\"\n\t| \"1024x1536\"\n\t| \"1792x1024\"\n\t| \"1024x1792\"\n\t| \"auto\";\n\nexport type ImageQuality = \"low\" | \"medium\" | \"high\" | \"auto\";\n\nexport type ImageBackground = \"transparent\" | \"opaque\" | \"auto\";\n\nexport interface GenerateOptions {\n\tprompt: string;\n\tsize?: ImageSize;\n\tquality?: ImageQuality;\n\tbackground?: ImageBackground;\n\t/** Number of images to produce. Defaults to 1. */\n\tn?: number;\n\tsignal?: AbortSignal;\n}\n\nexport interface EditOptions extends Omit<GenerateOptions, \"background\"> {\n\t/** 1-3 input image paths to edit. */\n\timages: string[];\n\t/**\n\t * Optional mask image path. Transparent regions of the mask mark the\n\t * areas the model is allowed to change. Omit for a whole-image edit.\n\t */\n\tmaskPath?: string;\n}\n\nexport interface ImageOutput {\n\t/** Absolute path where the generated image was persisted. */\n\tpath: string;\n\tmimeType: string;\n\t/** Provider-returned revised prompt, when available. */\n\trevisedPrompt?: string;\n}\n\nexport interface ImageResult {\n\timages: ImageOutput[];\n\t/** Provider id (e.g. \"openai\"). */\n\tprovider: string;\n\tmodel: string;\n}\n\nexport interface ImageProvider {\n\tid: string;\n\t/** Capabilities this provider actually implements. Used to fail closed. */\n\tsupports: {\n\t\tgenerate: boolean;\n\t\tedit: boolean;\n\t\tmask: boolean;\n\t};\n\tgenerate(options: GenerateOptions): Promise<ImageResult>;\n\tedit(options: EditOptions): Promise<ImageResult>;\n}\n"]}

package/dist/services/intelligent-router/index.d.ts

@@ -1,5 +1,6 @@
 export { IntelligentRouterValidationError, normalizePerformanceMetricInput, normalizeRoutingOverrideInput, normalizeRoutingRequest, parseRoutingStrategy, } from "./normalize.js";
 export { recordIntelligentRouterChatMetric, registeredRoutingModels, resolveIntelligentRouterStrategy, resolveIntelligentRouterTaskType, selectIntelligentRouterModel, } from "./recorder.js";
 export { IntelligentRouterService, getIntelligentRouterService, setIntelligentRouterServiceForTest, } from "./service.js";
+export { type RoutingOutcome, type RoutingOutcomeEvidence, deriveRoutingOutcome, } from "./outcome.js";
 export { MODEL_PERFORMANCE_METRIC_SOURCES, ROUTING_STRATEGIES, type ModelPerformanceAggregate, type ModelPerformanceMetricInput, type ModelPerformanceMetricSource, type RoutedModel, type RoutingDecision, type RoutingModelCandidate, type RoutingModelCost, type RoutingOverride, type RoutingOverrideInput, type RoutingRequest, type RoutingRequestInput, type RoutingScore, type RoutingStrategy, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/services/intelligent-router/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/intelligent-router/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,gCAAgC,EAChC,+BAA+B,EAC/B,6BAA6B,EAC7B,uBAAuB,EACvB,oBAAoB,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACN,iCAAiC,EACjC,uBAAuB,EACvB,gCAAgC,EAChC,gCAAgC,EAChC,4BAA4B,GAC5B,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,wBAAwB,EACxB,2BAA2B,EAC3B,kCAAkC,GAClC,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,gCAAgC,EAChC,kBAAkB,EAClB,KAAK,yBAAyB,EAC9B,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EACjC,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,eAAe,GACpB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/intelligent-router/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,gCAAgC,EAChC,+BAA+B,EAC/B,6BAA6B,EAC7B,uBAAuB,EACvB,oBAAoB,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACN,iCAAiC,EACjC,uBAAuB,EACvB,gCAAgC,EAChC,gCAAgC,EAChC,4BAA4B,GAC5B,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,wBAAwB,EACxB,2BAA2B,EAC3B,kCAAkC,GAClC,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,oBAAoB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,gCAAgC,EAChC,kBAAkB,EAClB,KAAK,yBAAyB,EAC9B,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EACjC,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,eAAe,GACpB,MAAM,YAAY,CAAC"}

package/dist/services/intelligent-router/index.js

@@ -1,5 +1,6 @@
 export { IntelligentRouterValidationError, normalizePerformanceMetricInput, normalizeRoutingOverrideInput, normalizeRoutingRequest, parseRoutingStrategy, } from "./normalize.js";
 export { recordIntelligentRouterChatMetric, registeredRoutingModels, resolveIntelligentRouterStrategy, resolveIntelligentRouterTaskType, selectIntelligentRouterModel, } from "./recorder.js";
 export { IntelligentRouterService, getIntelligentRouterService, setIntelligentRouterServiceForTest, } from "./service.js";
+export { deriveRoutingOutcome, } from "./outcome.js";
 export { MODEL_PERFORMANCE_METRIC_SOURCES, ROUTING_STRATEGIES, } from "./types.js";
 //# sourceMappingURL=index.js.map

package/dist/services/intelligent-router/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/intelligent-router/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,gCAAgC,EAChC,+BAA+B,EAC/B,6BAA6B,EAC7B,uBAAuB,EACvB,oBAAoB,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACN,iCAAiC,EACjC,uBAAuB,EACvB,gCAAgC,EAChC,gCAAgC,EAChC,4BAA4B,GAC5B,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,wBAAwB,EACxB,2BAA2B,EAC3B,kCAAkC,GAClC,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,gCAAgC,EAChC,kBAAkB,GAclB,MAAM,YAAY,CAAC","sourcesContent":["export {\n\tIntelligentRouterValidationError,\n\tnormalizePerformanceMetricInput,\n\tnormalizeRoutingOverrideInput,\n\tnormalizeRoutingRequest,\n\tparseRoutingStrategy,\n} from \"./normalize.js\";\nexport {\n\trecordIntelligentRouterChatMetric,\n\tregisteredRoutingModels,\n\tresolveIntelligentRouterStrategy,\n\tresolveIntelligentRouterTaskType,\n\tselectIntelligentRouterModel,\n} from \"./recorder.js\";\nexport {\n\tIntelligentRouterService,\n\tgetIntelligentRouterService,\n\tsetIntelligentRouterServiceForTest,\n} from \"./service.js\";\nexport {\n\tMODEL_PERFORMANCE_METRIC_SOURCES,\n\tROUTING_STRATEGIES,\n\ttype ModelPerformanceAggregate,\n\ttype ModelPerformanceMetricInput,\n\ttype ModelPerformanceMetricSource,\n\ttype RoutedModel,\n\ttype RoutingDecision,\n\ttype RoutingModelCandidate,\n\ttype RoutingModelCost,\n\ttype RoutingOverride,\n\ttype RoutingOverrideInput,\n\ttype RoutingRequest,\n\ttype RoutingRequestInput,\n\ttype RoutingScore,\n\ttype RoutingStrategy,\n} from \"./types.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/intelligent-router/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,gCAAgC,EAChC,+BAA+B,EAC/B,6BAA6B,EAC7B,uBAAuB,EACvB,oBAAoB,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACN,iCAAiC,EACjC,uBAAuB,EACvB,gCAAgC,EAChC,gCAAgC,EAChC,4BAA4B,GAC5B,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,wBAAwB,EACxB,2BAA2B,EAC3B,kCAAkC,GAClC,MAAM,cAAc,CAAC;AACtB,OAAO,EAGN,oBAAoB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,gCAAgC,EAChC,kBAAkB,GAclB,MAAM,YAAY,CAAC","sourcesContent":["export {\n\tIntelligentRouterValidationError,\n\tnormalizePerformanceMetricInput,\n\tnormalizeRoutingOverrideInput,\n\tnormalizeRoutingRequest,\n\tparseRoutingStrategy,\n} from \"./normalize.js\";\nexport {\n\trecordIntelligentRouterChatMetric,\n\tregisteredRoutingModels,\n\tresolveIntelligentRouterStrategy,\n\tresolveIntelligentRouterTaskType,\n\tselectIntelligentRouterModel,\n} from \"./recorder.js\";\nexport {\n\tIntelligentRouterService,\n\tgetIntelligentRouterService,\n\tsetIntelligentRouterServiceForTest,\n} from \"./service.js\";\nexport {\n\ttype RoutingOutcome,\n\ttype RoutingOutcomeEvidence,\n\tderiveRoutingOutcome,\n} from \"./outcome.js\";\nexport {\n\tMODEL_PERFORMANCE_METRIC_SOURCES,\n\tROUTING_STRATEGIES,\n\ttype ModelPerformanceAggregate,\n\ttype ModelPerformanceMetricInput,\n\ttype ModelPerformanceMetricSource,\n\ttype RoutedModel,\n\ttype RoutingDecision,\n\ttype RoutingModelCandidate,\n\ttype RoutingModelCost,\n\ttype RoutingOverride,\n\ttype RoutingOverrideInput,\n\ttype RoutingRequest,\n\ttype RoutingRequestInput,\n\ttype RoutingScore,\n\ttype RoutingStrategy,\n} from \"./types.js\";\n"]}

package/dist/services/intelligent-router/normalize.d.ts

@@ -8,6 +8,7 @@ export type NormalizedModelPerformanceMetricInput = ModelPerformanceMetricInput
     source: ModelPerformanceMetricSource;
     latencyMs: number;
     success: boolean;
+    verified: boolean;
     costUsd: number;
     qualityScore: number;
     occurredAt: Date | string;

package/dist/services/intelligent-router/normalize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../src/services/intelligent-router/normalize.ts"],"names":[],"mappings":"AACA,OAAO,EAEN,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EAEjC,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,MAAM,YAAY,CAAC;AAEpB,qBAAa,gCAAiC,SAAQ,KAAK;gBAC9C,OAAO,EAAE,MAAM;CAI3B;AAmED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAQpE;AA4DD,wBAAgB,uBAAuB,CACtC,KAAK,EAAE,mBAAmB,EAC1B,sBAAsB,EAAE,qBAAqB,EAAE,GAC7C,cAAc,CAyBhB;AAED,MAAM,MAAM,qCAAqC,GAChD,2BAA2B,GAAG;IAC7B,MAAM,EAAE,4BAA4B,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,IAAI,GAAG,MAAM,CAAC;CAC1B,CAAC;AAEH,wBAAgB,+BAA+B,CAC9C,KAAK,EAAE,2BAA2B,GAChC,qCAAqC,CAiCvC;AAED,wBAAgB,6BAA6B,CAC5C,KAAK,EAAE,oBAAoB,GACzB,oBAAoB,CActB"}
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../src/services/intelligent-router/normalize.ts"],"names":[],"mappings":"AAEA,OAAO,EAEN,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EAEjC,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,MAAM,YAAY,CAAC;AAEpB,qBAAa,gCAAiC,SAAQ,KAAK;gBAC9C,OAAO,EAAE,MAAM;CAI3B;AAmED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAQpE;AA4DD,wBAAgB,uBAAuB,CACtC,KAAK,EAAE,mBAAmB,EAC1B,sBAAsB,EAAE,qBAAqB,EAAE,GAC7C,cAAc,CAkDhB;AAED,MAAM,MAAM,qCAAqC,GAChD,2BAA2B,GAAG;IAC7B,MAAM,EAAE,4BAA4B,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,IAAI,GAAG,MAAM,CAAC;CAC1B,CAAC;AAEH,wBAAgB,+BAA+B,CAC9C,KAAK,EAAE,2BAA2B,GAChC,qCAAqC,CAqCvC;AAED,wBAAgB,6BAA6B,CAC5C,KAAK,EAAE,oBAAoB,GACzB,oBAAoB,CActB"}

package/dist/services/intelligent-router/normalize.js

@@ -1,3 +1,4 @@
+import { parseAgentProfileLevel } from "../../agent/profiles.js";
 import { isRecord } from "../../utils/json.js";
 import { MODEL_PERFORMANCE_METRIC_SOURCES, ROUTING_STRATEGIES, } from "./types.js";
 export class IntelligentRouterValidationError extends Error {
@@ -124,16 +125,29 @@ export function normalizeRoutingRequest(input, defaultAvailableModels) {
     }
     const requestInput = input;
     const taskType = cleanOptionalString(requestInput.taskType) ?? "chat";
+    const profileInput = cleanOptionalString(requestInput.profileHint) ??
+        cleanOptionalString(requestInput.profile_hint) ??
+        "medium";
+    const profileLevel = parseAgentProfileLevel(profileInput);
+    if (!profileLevel) {
+        throw new IntelligentRouterValidationError("Invalid agent profile. Use low, medium, high, or ultra.");
+    }
     const modelHint = cleanOptionalString(requestInput.modelHint) ??
         cleanOptionalString(requestInput.model_hint);
     const unavailableModels = normalizeUnavailableModels(requestInput.unavailableModels ?? requestInput.unavailable_models);
     const availableModels = normalizeAvailableModels(requestInput.availableModels);
+    const taskSummary = cleanOptionalString(requestInput.taskSummary) ??
+        cleanOptionalString(requestInput.task_summary);
+    const priorFailures = Math.max(0, Math.floor(parseFiniteNumber(requestInput.priorFailures ?? requestInput.prior_failures, "priorFailures") ?? 0));
     return {
         taskType,
+        profileLevel,
         strategy: parseRoutingStrategy(requestInput.strategy),
         unavailableModels,
         availableModels: availableModels.length > 0 ? availableModels : defaultAvailableModels,
+        priorFailures,
         ...(modelHint ? { modelHint } : {}),
+        ...(taskSummary ? { taskSummary } : {}),
     };
 }
 export function normalizePerformanceMetricInput(input) {
@@ -157,6 +171,9 @@ export function normalizePerformanceMetricInput(input) {
         source: parseMetricSource(metricInput.source),
         latencyMs,
         success: parseOptionalBoolean(metricInput.success) ?? true,
+        verified: typeof metricInput.verified === "boolean"
+            ? metricInput.verified
+            : parseMetricSource(metricInput.source) === "eval",
         costUsd,
         qualityScore: Math.max(0, Math.min(1, qualityScore)),
         ...(cleanOptionalString(metricInput.evalSuite)