@evalops/maestro 0.10.50 → 0.10.53

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":"AAAA,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;AAuED,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,5 @@
+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 {
     constructor(message) {
@@ -5,9 +7,6 @@ export class IntelligentRouterValidationError extends Error {
         this.name = "IntelligentRouterValidationError";
     }
 }
-function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
 function cleanOptionalString(value) {
     if (typeof value !== "string")
         return undefined;
@@ -126,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) {
@@ -159,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)

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

@@ -1 +1 @@
-{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../../src/services/intelligent-router/normalize.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\tMODEL_PERFORMANCE_METRIC_SOURCES,\n\ttype ModelPerformanceMetricInput,\n\ttype ModelPerformanceMetricSource,\n\tROUTING_STRATEGIES,\n\ttype RoutingModelCandidate,\n\ttype RoutingOverrideInput,\n\ttype RoutingRequest,\n\ttype RoutingRequestInput,\n\ttype RoutingStrategy,\n} from \"./types.js\";\n\nexport class IntelligentRouterValidationError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"IntelligentRouterValidationError\";\n\t}\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction cleanOptionalString(value: unknown): string | undefined {\n\tif (typeof value !== \"string\") return undefined;\n\tconst trimmed = value.trim();\n\treturn trimmed ? trimmed : undefined;\n}\n\nfunction cleanRequiredString(value: unknown, label: string): string {\n\tconst trimmed = cleanOptionalString(value);\n\tif (!trimmed) {\n\t\tthrow new IntelligentRouterValidationError(`${label} is required.`);\n\t}\n\treturn trimmed;\n}\n\nfunction parseFiniteNumber(value: unknown, label: string): number | undefined {\n\tif (value === undefined || value === null || value === \"\") return undefined;\n\tconst parsed = typeof value === \"number\" ? value : Number(value);\n\tif (!Number.isFinite(parsed)) {\n\t\tthrow new IntelligentRouterValidationError(`${label} must be a number.`);\n\t}\n\treturn parsed;\n}\n\nfunction parseOptionalBoolean(value: unknown): boolean | undefined {\n\tif (value === undefined || value === null || value === \"\") return undefined;\n\tif (typeof value === \"boolean\") return value;\n\tif (typeof value === \"string\") {\n\t\tconst normalized = value.trim().toLowerCase();\n\t\tif (normalized === \"true\") return true;\n\t\tif (normalized === \"false\") return false;\n\t}\n\tthrow new IntelligentRouterValidationError(\"success must be a boolean.\");\n}\n\nfunction parseMetricSource(value: unknown): ModelPerformanceMetricSource {\n\tif (value === undefined || value === null) return \"production\";\n\tif (typeof value !== \"string\") {\n\t\tthrow new IntelligentRouterValidationError(\n\t\t\t\"source must be production or eval.\",\n\t\t);\n\t}\n\tconst normalized = value.trim().toLowerCase();\n\tif (\n\t\tMODEL_PERFORMANCE_METRIC_SOURCES.includes(\n\t\t\tnormalized as ModelPerformanceMetricSource,\n\t\t)\n\t) {\n\t\treturn normalized as ModelPerformanceMetricSource;\n\t}\n\tthrow new IntelligentRouterValidationError(\n\t\t\"source must be production or eval.\",\n\t);\n}\n\nfunction parseOptionalDate(value: unknown, label: string): Date | undefined {\n\tif (value === undefined || value === null || value === \"\") return undefined;\n\tconst parsed = value instanceof Date ? value : new Date(String(value));\n\tif (Number.isNaN(parsed.getTime())) {\n\t\tthrow new IntelligentRouterValidationError(\n\t\t\t`${label} must be a valid date.`,\n\t\t);\n\t}\n\treturn parsed;\n}\n\nexport function parseRoutingStrategy(value: unknown): RoutingStrategy {\n\tconst normalized = cleanOptionalString(value)?.toLowerCase() ?? \"balanced\";\n\tif (ROUTING_STRATEGIES.includes(normalized as RoutingStrategy)) {\n\t\treturn normalized as RoutingStrategy;\n\t}\n\tthrow new IntelligentRouterValidationError(\n\t\t\"Invalid routing strategy. Use balanced, quality, cost, or latency.\",\n\t);\n}\n\nfunction normalizeUnavailableModels(value: unknown): string[] {\n\tif (value === undefined || value === null) return [];\n\tif (typeof value === \"string\") {\n\t\treturn value\n\t\t\t.split(\",\")\n\t\t\t.map((entry) => entry.trim())\n\t\t\t.filter(Boolean);\n\t}\n\tif (!Array.isArray(value)) {\n\t\tthrow new IntelligentRouterValidationError(\n\t\t\t\"unavailableModels must be an array or comma-separated string.\",\n\t\t);\n\t}\n\treturn value.map((entry) => String(entry).trim()).filter(Boolean);\n}\n\nfunction normalizeAvailableModels(value: unknown): RoutingModelCandidate[] {\n\tif (value === undefined || value === null) return [];\n\tif (!Array.isArray(value)) {\n\t\tthrow new IntelligentRouterValidationError(\n\t\t\t\"availableModels must be an array.\",\n\t\t);\n\t}\n\treturn value.filter(isRecord).map((entry) => {\n\t\tconst provider = cleanRequiredString(entry.provider, \"provider\");\n\t\tconst model = cleanRequiredString(entry.model, \"model\");\n\t\tconst name = cleanOptionalString(entry.name);\n\t\tconst available =\n\t\t\ttypeof entry.available === \"boolean\" ? entry.available : undefined;\n\t\tconst cost = (() => {\n\t\t\tif (!isRecord(entry.cost)) return undefined;\n\t\t\tconst input = parseFiniteNumber(entry.cost.input, \"cost.input\");\n\t\t\tconst output = parseFiniteNumber(entry.cost.output, \"cost.output\");\n\t\t\tconst cacheRead = parseFiniteNumber(\n\t\t\t\tentry.cost.cacheRead,\n\t\t\t\t\"cost.cacheRead\",\n\t\t\t);\n\t\t\tconst cacheWrite = parseFiniteNumber(\n\t\t\t\tentry.cost.cacheWrite,\n\t\t\t\t\"cost.cacheWrite\",\n\t\t\t);\n\t\t\treturn {\n\t\t\t\t...(input !== undefined ? { input } : {}),\n\t\t\t\t...(output !== undefined ? { output } : {}),\n\t\t\t\t...(cacheRead !== undefined ? { cacheRead } : {}),\n\t\t\t\t...(cacheWrite !== undefined ? { cacheWrite } : {}),\n\t\t\t};\n\t\t})();\n\t\treturn {\n\t\t\tprovider,\n\t\t\tmodel,\n\t\t\t...(name ? { name } : {}),\n\t\t\t...(cost && Object.keys(cost).length > 0 ? { cost } : {}),\n\t\t\t...(available !== undefined ? { available } : {}),\n\t\t};\n\t});\n}\n\nexport function normalizeRoutingRequest(\n\tinput: RoutingRequestInput,\n\tdefaultAvailableModels: RoutingModelCandidate[],\n): RoutingRequest {\n\tif (!isRecord(input)) {\n\t\tthrow new IntelligentRouterValidationError(\n\t\t\t\"Routing request must be an object.\",\n\t\t);\n\t}\n\tconst requestInput = input as RoutingRequestInput;\n\tconst taskType = cleanOptionalString(requestInput.taskType) ?? \"chat\";\n\tconst modelHint =\n\t\tcleanOptionalString(requestInput.modelHint) ??\n\t\tcleanOptionalString(requestInput.model_hint);\n\tconst unavailableModels = normalizeUnavailableModels(\n\t\trequestInput.unavailableModels ?? requestInput.unavailable_models,\n\t);\n\tconst availableModels = normalizeAvailableModels(\n\t\trequestInput.availableModels,\n\t);\n\treturn {\n\t\ttaskType,\n\t\tstrategy: parseRoutingStrategy(requestInput.strategy),\n\t\tunavailableModels,\n\t\tavailableModels:\n\t\t\tavailableModels.length > 0 ? availableModels : defaultAvailableModels,\n\t\t...(modelHint ? { modelHint } : {}),\n\t};\n}\n\nexport type NormalizedModelPerformanceMetricInput =\n\tModelPerformanceMetricInput & {\n\t\tsource: ModelPerformanceMetricSource;\n\t\tlatencyMs: number;\n\t\tsuccess: boolean;\n\t\tcostUsd: number;\n\t\tqualityScore: number;\n\t\toccurredAt: Date | string;\n\t};\n\nexport function normalizePerformanceMetricInput(\n\tinput: ModelPerformanceMetricInput,\n): NormalizedModelPerformanceMetricInput {\n\tif (!isRecord(input)) {\n\t\tthrow new IntelligentRouterValidationError(\"Metric must be an object.\");\n\t}\n\tconst metricInput = input as ModelPerformanceMetricInput;\n\tconst latencyMs = parseFiniteNumber(metricInput.latencyMs, \"latencyMs\") ?? 0;\n\tconst costUsd = parseFiniteNumber(metricInput.costUsd, \"costUsd\") ?? 0;\n\tconst qualityScore =\n\t\tparseFiniteNumber(metricInput.qualityScore, \"qualityScore\") ?? 0.5;\n\tif (latencyMs < 0) {\n\t\tthrow new IntelligentRouterValidationError(\"latencyMs cannot be negative.\");\n\t}\n\tif (costUsd < 0) {\n\t\tthrow new IntelligentRouterValidationError(\"costUsd cannot be negative.\");\n\t}\n\treturn {\n\t\ttaskType: cleanRequiredString(metricInput.taskType, \"taskType\"),\n\t\tprovider: cleanRequiredString(metricInput.provider, \"provider\"),\n\t\tmodel: cleanRequiredString(metricInput.model, \"model\"),\n\t\tsource: parseMetricSource(metricInput.source),\n\t\tlatencyMs,\n\t\tsuccess: parseOptionalBoolean(metricInput.success) ?? true,\n\t\tcostUsd,\n\t\tqualityScore: Math.max(0, Math.min(1, qualityScore)),\n\t\t...(cleanOptionalString(metricInput.evalSuite)\n\t\t\t? { evalSuite: cleanOptionalString(metricInput.evalSuite) }\n\t\t\t: {}),\n\t\t...(cleanOptionalString(metricInput.evalCase)\n\t\t\t? { evalCase: cleanOptionalString(metricInput.evalCase) }\n\t\t\t: {}),\n\t\toccurredAt:\n\t\t\tparseOptionalDate(metricInput.occurredAt, \"occurredAt\") ?? new Date(),\n\t};\n}\n\nexport function normalizeRoutingOverrideInput(\n\tinput: RoutingOverrideInput,\n): RoutingOverrideInput {\n\tif (!isRecord(input)) {\n\t\tthrow new IntelligentRouterValidationError(\"Override must be an object.\");\n\t}\n\tconst overrideInput = input as RoutingOverrideInput;\n\tconst reason = cleanOptionalString(overrideInput.reason);\n\tconst expiresAt = parseOptionalDate(overrideInput.expiresAt, \"expiresAt\");\n\treturn {\n\t\ttaskType: cleanRequiredString(overrideInput.taskType, \"taskType\"),\n\t\tprovider: cleanRequiredString(overrideInput.provider, \"provider\"),\n\t\tmodel: cleanRequiredString(overrideInput.model, \"model\"),\n\t\t...(reason ? { reason } : {}),\n\t\t...(expiresAt ? { expiresAt } : {}),\n\t};\n}\n"]}
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../../src/services/intelligent-router/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EACN,gCAAgC,EAGhC,kBAAkB,GAMlB,MAAM,YAAY,CAAC;AAEpB,MAAM,OAAO,gCAAiC,SAAQ,KAAK;IAC1D,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kCAAkC,CAAC;IAChD,CAAC;CACD;AAED,SAAS,mBAAmB,CAAC,KAAc;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACtC,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc,EAAE,KAAa;IACzD,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,MAAM,IAAI,gCAAgC,CAAC,GAAG,KAAK,eAAe,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc,EAAE,KAAa;IACvD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IAC5E,MAAM,MAAM,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,gCAAgC,CAAC,GAAG,KAAK,oBAAoB,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAc;IAC3C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IAC5E,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC9C,IAAI,UAAU,KAAK,MAAM;YAAE,OAAO,IAAI,CAAC;QACvC,IAAI,UAAU,KAAK,OAAO;YAAE,OAAO,KAAK,CAAC;IAC1C,CAAC;IACD,MAAM,IAAI,gCAAgC,CAAC,4BAA4B,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACxC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,YAAY,CAAC;IAC/D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,gCAAgC,CACzC,oCAAoC,CACpC,CAAC;IACH,CAAC;IACD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,IACC,gCAAgC,CAAC,QAAQ,CACxC,UAA0C,CAC1C,EACA,CAAC;QACF,OAAO,UAA0C,CAAC;IACnD,CAAC;IACD,MAAM,IAAI,gCAAgC,CACzC,oCAAoC,CACpC,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc,EAAE,KAAa;IACvD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IAC5E,MAAM,MAAM,GAAG,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACvE,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,gCAAgC,CACzC,GAAG,KAAK,wBAAwB,CAChC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc;IAClD,MAAM,UAAU,GAAG,mBAAmB,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,IAAI,UAAU,CAAC;IAC3E,IAAI,kBAAkB,CAAC,QAAQ,CAAC,UAA6B,CAAC,EAAE,CAAC;QAChE,OAAO,UAA6B,CAAC;IACtC,CAAC;IACD,MAAM,IAAI,gCAAgC,CACzC,oEAAoE,CACpE,CAAC;AACH,CAAC;AAED,SAAS,0BAA0B,CAAC,KAAc;IACjD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IACrD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,KAAK;aACV,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;aAC5B,MAAM,CAAC,OAAO,CAAC,CAAC;IACnB,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,gCAAgC,CACzC,+DAA+D,CAC/D,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAc;IAC/C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IACrD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,gCAAgC,CACzC,mCAAmC,CACnC,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC3C,MAAM,QAAQ,GAAG,mBAAmB,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QACjE,MAAM,KAAK,GAAG,mBAAmB,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACxD,MAAM,IAAI,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,SAAS,GACd,OAAO,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;QACpE,MAAM,IAAI,GAAG,CAAC,GAAG,EAAE;YAClB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,OAAO,SAAS,CAAC;YAC5C,MAAM,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;YAChE,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;YACnE,MAAM,SAAS,GAAG,iBAAiB,CAClC,KAAK,CAAC,IAAI,CAAC,SAAS,EACpB,gBAAgB,CAChB,CAAC;YACF,MAAM,UAAU,GAAG,iBAAiB,CACnC,KAAK,CAAC,IAAI,CAAC,UAAU,EACrB,iBAAiB,CACjB,CAAC;YACF,OAAO;gBACN,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzC,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3C,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjD,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACnD,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QACL,OAAO;YACN,QAAQ;YACR,KAAK;YACL,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzB,GAAG,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjD,CAAC;IACH,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CACtC,KAA0B,EAC1B,sBAA+C;IAE/C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,gCAAgC,CACzC,oCAAoC,CACpC,CAAC;IACH,CAAC;IACD,MAAM,YAAY,GAAG,KAA4B,CAAC;IAClD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC;IACtE,MAAM,YAAY,GACjB,mBAAmB,CAAC,YAAY,CAAC,WAAW,CAAC;QAC7C,mBAAmB,CAAC,YAAY,CAAC,YAAY,CAAC;QAC9C,QAAQ,CAAC;IACV,MAAM,YAAY,GAAG,sBAAsB,CAAC,YAAY,CAAC,CAAC;IAC1D,IAAI,CAAC,YAAY,EAAE,CAAC;QACnB,MAAM,IAAI,gCAAgC,CACzC,yDAAyD,CACzD,CAAC;IACH,CAAC;IACD,MAAM,SAAS,GACd,mBAAmB,CAAC,YAAY,CAAC,SAAS,CAAC;QAC3C,mBAAmB,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;IAC9C,MAAM,iBAAiB,GAAG,0BAA0B,CACnD,YAAY,CAAC,iBAAiB,IAAI,YAAY,CAAC,kBAAkB,CACjE,CAAC;IACF,MAAM,eAAe,GAAG,wBAAwB,CAC/C,YAAY,CAAC,eAAe,CAC5B,CAAC;IACF,MAAM,WAAW,GAChB,mBAAmB,CAAC,YAAY,CAAC,WAAW,CAAC;QAC7C,mBAAmB,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;IAChD,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAC7B,CAAC,EACD,IAAI,CAAC,KAAK,CACT,iBAAiB,CAChB,YAAY,CAAC,aAAa,IAAI,YAAY,CAAC,cAAc,EACzD,eAAe,CACf,IAAI,CAAC,CACN,CACD,CAAC;IACF,OAAO;QACN,QAAQ;QACR,YAAY;QACZ,QAAQ,EAAE,oBAAoB,CAAC,YAAY,CAAC,QAAQ,CAAC;QACrD,iBAAiB;QACjB,eAAe,EACd,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,sBAAsB;QACtE,aAAa;QACb,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvC,CAAC;AACH,CAAC;AAaD,MAAM,UAAU,+BAA+B,CAC9C,KAAkC;IAElC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,gCAAgC,CAAC,2BAA2B,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,WAAW,GAAG,KAAoC,CAAC;IACzD,MAAM,SAAS,GAAG,iBAAiB,CAAC,WAAW,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;IAC7E,MAAM,OAAO,GAAG,iBAAiB,CAAC,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IACvE,MAAM,YAAY,GACjB,iBAAiB,CAAC,WAAW,CAAC,YAAY,EAAE,cAAc,CAAC,IAAI,GAAG,CAAC;IACpE,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,gCAAgC,CAAC,+BAA+B,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QACjB,MAAM,IAAI,gCAAgC,CAAC,6BAA6B,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO;QACN,QAAQ,EAAE,mBAAmB,CAAC,WAAW,CAAC,QAAQ,EAAE,UAAU,CAAC;QAC/D,QAAQ,EAAE,mBAAmB,CAAC,WAAW,CAAC,QAAQ,EAAE,UAAU,CAAC;QAC/D,KAAK,EAAE,mBAAmB,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC;QACtD,MAAM,EAAE,iBAAiB,CAAC,WAAW,CAAC,MAAM,CAAC;QAC7C,SAAS;QACT,OAAO,EAAE,oBAAoB,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,IAAI;QAC1D,QAAQ,EACP,OAAO,WAAW,CAAC,QAAQ,KAAK,SAAS;YACxC,CAAC,CAAC,WAAW,CAAC,QAAQ;YACtB,CAAC,CAAC,iBAAiB,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,MAAM;QACpD,OAAO;QACP,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;QACpD,GAAG,CAAC,mBAAmB,CAAC,WAAW,CAAC,SAAS,CAAC;YAC7C,CAAC,CAAC,EAAE,SAAS,EAAE,mBAAmB,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE;YAC3D,CAAC,CAAC,EAAE,CAAC;QACN,GAAG,CAAC,mBAAmB,CAAC,WAAW,CAAC,QAAQ,CAAC;YAC5C,CAAC,CAAC,EAAE,QAAQ,EAAE,mBAAmB,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE;YACzD,CAAC,CAAC,EAAE,CAAC;QACN,UAAU,EACT,iBAAiB,CAAC,WAAW,CAAC,UAAU,EAAE,YAAY,CAAC,IAAI,IAAI,IAAI,EAAE;KACtE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC5C,KAA2B;IAE3B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,gCAAgC,CAAC,6BAA6B,CAAC,CAAC;IAC3E,CAAC;IACD,MAAM,aAAa,GAAG,KAA6B,CAAC;IACpD,MAAM,MAAM,GAAG,mBAAmB,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,iBAAiB,CAAC,aAAa,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAC1E,OAAO;QACN,QAAQ,EAAE,mBAAmB,CAAC,aAAa,CAAC,QAAQ,EAAE,UAAU,CAAC;QACjE,QAAQ,EAAE,mBAAmB,CAAC,aAAa,CAAC,QAAQ,EAAE,UAAU,CAAC;QACjE,KAAK,EAAE,mBAAmB,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC;QACxD,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7B,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACnC,CAAC;AACH,CAAC","sourcesContent":["import { parseAgentProfileLevel } from \"../../agent/profiles.js\";\nimport { isRecord } from \"../../utils/json.js\";\nimport {\n\tMODEL_PERFORMANCE_METRIC_SOURCES,\n\ttype ModelPerformanceMetricInput,\n\ttype ModelPerformanceMetricSource,\n\tROUTING_STRATEGIES,\n\ttype RoutingModelCandidate,\n\ttype RoutingOverrideInput,\n\ttype RoutingRequest,\n\ttype RoutingRequestInput,\n\ttype RoutingStrategy,\n} from \"./types.js\";\n\nexport class IntelligentRouterValidationError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"IntelligentRouterValidationError\";\n\t}\n}\n\nfunction cleanOptionalString(value: unknown): string | undefined {\n\tif (typeof value !== \"string\") return undefined;\n\tconst trimmed = value.trim();\n\treturn trimmed ? trimmed : undefined;\n}\n\nfunction cleanRequiredString(value: unknown, label: string): string {\n\tconst trimmed = cleanOptionalString(value);\n\tif (!trimmed) {\n\t\tthrow new IntelligentRouterValidationError(`${label} is required.`);\n\t}\n\treturn trimmed;\n}\n\nfunction parseFiniteNumber(value: unknown, label: string): number | undefined {\n\tif (value === undefined || value === null || value === \"\") return undefined;\n\tconst parsed = typeof value === \"number\" ? value : Number(value);\n\tif (!Number.isFinite(parsed)) {\n\t\tthrow new IntelligentRouterValidationError(`${label} must be a number.`);\n\t}\n\treturn parsed;\n}\n\nfunction parseOptionalBoolean(value: unknown): boolean | undefined {\n\tif (value === undefined || value === null || value === \"\") return undefined;\n\tif (typeof value === \"boolean\") return value;\n\tif (typeof value === \"string\") {\n\t\tconst normalized = value.trim().toLowerCase();\n\t\tif (normalized === \"true\") return true;\n\t\tif (normalized === \"false\") return false;\n\t}\n\tthrow new IntelligentRouterValidationError(\"success must be a boolean.\");\n}\n\nfunction parseMetricSource(value: unknown): ModelPerformanceMetricSource {\n\tif (value === undefined || value === null) return \"production\";\n\tif (typeof value !== \"string\") {\n\t\tthrow new IntelligentRouterValidationError(\n\t\t\t\"source must be production or eval.\",\n\t\t);\n\t}\n\tconst normalized = value.trim().toLowerCase();\n\tif (\n\t\tMODEL_PERFORMANCE_METRIC_SOURCES.includes(\n\t\t\tnormalized as ModelPerformanceMetricSource,\n\t\t)\n\t) {\n\t\treturn normalized as ModelPerformanceMetricSource;\n\t}\n\tthrow new IntelligentRouterValidationError(\n\t\t\"source must be production or eval.\",\n\t);\n}\n\nfunction parseOptionalDate(value: unknown, label: string): Date | undefined {\n\tif (value === undefined || value === null || value === \"\") return undefined;\n\tconst parsed = value instanceof Date ? value : new Date(String(value));\n\tif (Number.isNaN(parsed.getTime())) {\n\t\tthrow new IntelligentRouterValidationError(\n\t\t\t`${label} must be a valid date.`,\n\t\t);\n\t}\n\treturn parsed;\n}\n\nexport function parseRoutingStrategy(value: unknown): RoutingStrategy {\n\tconst normalized = cleanOptionalString(value)?.toLowerCase() ?? \"balanced\";\n\tif (ROUTING_STRATEGIES.includes(normalized as RoutingStrategy)) {\n\t\treturn normalized as RoutingStrategy;\n\t}\n\tthrow new IntelligentRouterValidationError(\n\t\t\"Invalid routing strategy. Use balanced, quality, cost, or latency.\",\n\t);\n}\n\nfunction normalizeUnavailableModels(value: unknown): string[] {\n\tif (value === undefined || value === null) return [];\n\tif (typeof value === \"string\") {\n\t\treturn value\n\t\t\t.split(\",\")\n\t\t\t.map((entry) => entry.trim())\n\t\t\t.filter(Boolean);\n\t}\n\tif (!Array.isArray(value)) {\n\t\tthrow new IntelligentRouterValidationError(\n\t\t\t\"unavailableModels must be an array or comma-separated string.\",\n\t\t);\n\t}\n\treturn value.map((entry) => String(entry).trim()).filter(Boolean);\n}\n\nfunction normalizeAvailableModels(value: unknown): RoutingModelCandidate[] {\n\tif (value === undefined || value === null) return [];\n\tif (!Array.isArray(value)) {\n\t\tthrow new IntelligentRouterValidationError(\n\t\t\t\"availableModels must be an array.\",\n\t\t);\n\t}\n\treturn value.filter(isRecord).map((entry) => {\n\t\tconst provider = cleanRequiredString(entry.provider, \"provider\");\n\t\tconst model = cleanRequiredString(entry.model, \"model\");\n\t\tconst name = cleanOptionalString(entry.name);\n\t\tconst available =\n\t\t\ttypeof entry.available === \"boolean\" ? entry.available : undefined;\n\t\tconst cost = (() => {\n\t\t\tif (!isRecord(entry.cost)) return undefined;\n\t\t\tconst input = parseFiniteNumber(entry.cost.input, \"cost.input\");\n\t\t\tconst output = parseFiniteNumber(entry.cost.output, \"cost.output\");\n\t\t\tconst cacheRead = parseFiniteNumber(\n\t\t\t\tentry.cost.cacheRead,\n\t\t\t\t\"cost.cacheRead\",\n\t\t\t);\n\t\t\tconst cacheWrite = parseFiniteNumber(\n\t\t\t\tentry.cost.cacheWrite,\n\t\t\t\t\"cost.cacheWrite\",\n\t\t\t);\n\t\t\treturn {\n\t\t\t\t...(input !== undefined ? { input } : {}),\n\t\t\t\t...(output !== undefined ? { output } : {}),\n\t\t\t\t...(cacheRead !== undefined ? { cacheRead } : {}),\n\t\t\t\t...(cacheWrite !== undefined ? { cacheWrite } : {}),\n\t\t\t};\n\t\t})();\n\t\treturn {\n\t\t\tprovider,\n\t\t\tmodel,\n\t\t\t...(name ? { name } : {}),\n\t\t\t...(cost && Object.keys(cost).length > 0 ? { cost } : {}),\n\t\t\t...(available !== undefined ? { available } : {}),\n\t\t};\n\t});\n}\n\nexport function normalizeRoutingRequest(\n\tinput: RoutingRequestInput,\n\tdefaultAvailableModels: RoutingModelCandidate[],\n): RoutingRequest {\n\tif (!isRecord(input)) {\n\t\tthrow new IntelligentRouterValidationError(\n\t\t\t\"Routing request must be an object.\",\n\t\t);\n\t}\n\tconst requestInput = input as RoutingRequestInput;\n\tconst taskType = cleanOptionalString(requestInput.taskType) ?? \"chat\";\n\tconst profileInput =\n\t\tcleanOptionalString(requestInput.profileHint) ??\n\t\tcleanOptionalString(requestInput.profile_hint) ??\n\t\t\"medium\";\n\tconst profileLevel = parseAgentProfileLevel(profileInput);\n\tif (!profileLevel) {\n\t\tthrow new IntelligentRouterValidationError(\n\t\t\t\"Invalid agent profile. Use low, medium, high, or ultra.\",\n\t\t);\n\t}\n\tconst modelHint =\n\t\tcleanOptionalString(requestInput.modelHint) ??\n\t\tcleanOptionalString(requestInput.model_hint);\n\tconst unavailableModels = normalizeUnavailableModels(\n\t\trequestInput.unavailableModels ?? requestInput.unavailable_models,\n\t);\n\tconst availableModels = normalizeAvailableModels(\n\t\trequestInput.availableModels,\n\t);\n\tconst taskSummary =\n\t\tcleanOptionalString(requestInput.taskSummary) ??\n\t\tcleanOptionalString(requestInput.task_summary);\n\tconst priorFailures = Math.max(\n\t\t0,\n\t\tMath.floor(\n\t\t\tparseFiniteNumber(\n\t\t\t\trequestInput.priorFailures ?? requestInput.prior_failures,\n\t\t\t\t\"priorFailures\",\n\t\t\t) ?? 0,\n\t\t),\n\t);\n\treturn {\n\t\ttaskType,\n\t\tprofileLevel,\n\t\tstrategy: parseRoutingStrategy(requestInput.strategy),\n\t\tunavailableModels,\n\t\tavailableModels:\n\t\t\tavailableModels.length > 0 ? availableModels : defaultAvailableModels,\n\t\tpriorFailures,\n\t\t...(modelHint ? { modelHint } : {}),\n\t\t...(taskSummary ? { taskSummary } : {}),\n\t};\n}\n\nexport type NormalizedModelPerformanceMetricInput =\n\tModelPerformanceMetricInput & {\n\t\tsource: ModelPerformanceMetricSource;\n\t\tlatencyMs: number;\n\t\tsuccess: boolean;\n\t\tverified: boolean;\n\t\tcostUsd: number;\n\t\tqualityScore: number;\n\t\toccurredAt: Date | string;\n\t};\n\nexport function normalizePerformanceMetricInput(\n\tinput: ModelPerformanceMetricInput,\n): NormalizedModelPerformanceMetricInput {\n\tif (!isRecord(input)) {\n\t\tthrow new IntelligentRouterValidationError(\"Metric must be an object.\");\n\t}\n\tconst metricInput = input as ModelPerformanceMetricInput;\n\tconst latencyMs = parseFiniteNumber(metricInput.latencyMs, \"latencyMs\") ?? 0;\n\tconst costUsd = parseFiniteNumber(metricInput.costUsd, \"costUsd\") ?? 0;\n\tconst qualityScore =\n\t\tparseFiniteNumber(metricInput.qualityScore, \"qualityScore\") ?? 0.5;\n\tif (latencyMs < 0) {\n\t\tthrow new IntelligentRouterValidationError(\"latencyMs cannot be negative.\");\n\t}\n\tif (costUsd < 0) {\n\t\tthrow new IntelligentRouterValidationError(\"costUsd cannot be negative.\");\n\t}\n\treturn {\n\t\ttaskType: cleanRequiredString(metricInput.taskType, \"taskType\"),\n\t\tprovider: cleanRequiredString(metricInput.provider, \"provider\"),\n\t\tmodel: cleanRequiredString(metricInput.model, \"model\"),\n\t\tsource: parseMetricSource(metricInput.source),\n\t\tlatencyMs,\n\t\tsuccess: parseOptionalBoolean(metricInput.success) ?? true,\n\t\tverified:\n\t\t\ttypeof metricInput.verified === \"boolean\"\n\t\t\t\t? metricInput.verified\n\t\t\t\t: parseMetricSource(metricInput.source) === \"eval\",\n\t\tcostUsd,\n\t\tqualityScore: Math.max(0, Math.min(1, qualityScore)),\n\t\t...(cleanOptionalString(metricInput.evalSuite)\n\t\t\t? { evalSuite: cleanOptionalString(metricInput.evalSuite) }\n\t\t\t: {}),\n\t\t...(cleanOptionalString(metricInput.evalCase)\n\t\t\t? { evalCase: cleanOptionalString(metricInput.evalCase) }\n\t\t\t: {}),\n\t\toccurredAt:\n\t\t\tparseOptionalDate(metricInput.occurredAt, \"occurredAt\") ?? new Date(),\n\t};\n}\n\nexport function normalizeRoutingOverrideInput(\n\tinput: RoutingOverrideInput,\n): RoutingOverrideInput {\n\tif (!isRecord(input)) {\n\t\tthrow new IntelligentRouterValidationError(\"Override must be an object.\");\n\t}\n\tconst overrideInput = input as RoutingOverrideInput;\n\tconst reason = cleanOptionalString(overrideInput.reason);\n\tconst expiresAt = parseOptionalDate(overrideInput.expiresAt, \"expiresAt\");\n\treturn {\n\t\ttaskType: cleanRequiredString(overrideInput.taskType, \"taskType\"),\n\t\tprovider: cleanRequiredString(overrideInput.provider, \"provider\"),\n\t\tmodel: cleanRequiredString(overrideInput.model, \"model\"),\n\t\t...(reason ? { reason } : {}),\n\t\t...(expiresAt ? { expiresAt } : {}),\n\t};\n}\n"]}

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

@@ -0,0 +1,19 @@
+export interface RoutingOutcomeEvidence {
+    assistantCompleted: boolean;
+    verificationPassed?: boolean;
+    userAccepted?: boolean;
+    userRejected?: boolean;
+    userRetried?: boolean;
+    attempts?: number;
+    totalCostUsd?: number;
+}
+export interface RoutingOutcome {
+    verified: boolean;
+    success: boolean;
+    qualityScore: number;
+    reasons: string[];
+    attempts?: number;
+    totalCostUsd?: number;
+}
+export declare function deriveRoutingOutcome(evidence: RoutingOutcomeEvidence): RoutingOutcome;
+//# sourceMappingURL=outcome.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"outcome.d.ts","sourceRoot":"","sources":["../../../src/services/intelligent-router/outcome.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACtC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,oBAAoB,CACnC,QAAQ,EAAE,sBAAsB,GAC9B,cAAc,CAiDhB"}