openrouter-genimage-kote-opencode 0.1.0

package/dist/references/attachments.js

@@ -0,0 +1,238 @@
+import { Buffer } from "node:buffer";
+import { PluginError } from "../openrouter/errors.js";
+import { abortableStreamRead, throwIfAborted } from "../utils/abort.js";
+import { imageBytesToDataUrl, parseImageDataUrl } from "./data-url.js";
+import { detectImageFormat, isSupportedImageMime, } from "./formats.js";
+import { ReferenceBudget } from "./limits.js";
+import { loadProjectImage, loadTrustedAttachmentFile, } from "./project-files.js";
+import { validatePublicHttpsUrl } from "./remote-urls.js";
+function isImagePart(part) {
+    return (part.type === "file" &&
+        typeof part.mime === "string" &&
+        part.mime.startsWith("image/") &&
+        typeof part.url === "string");
+}
+async function getMessage(client, sessionID, messageID, directory, signal) {
+    throwIfAborted(signal);
+    try {
+        const response = await client.session.message({
+            path: { id: sessionID, messageID },
+            query: { directory },
+            signal,
+        });
+        if (response.data === undefined)
+            throw new TypeError("message unavailable");
+        return response.data;
+    }
+    catch (error) {
+        throwIfAborted(signal);
+        throw new PluginError("GENIMAGE_ATTACHMENT_ACCESS_FAILED", "OpenCode could not provide the current message attachments.", { cause: error });
+    }
+}
+export async function getCurrentUserImageParts(client, context) {
+    const assistant = await getMessage(client, context.sessionID, context.messageID, context.directory, context.abort);
+    if (assistant.info.role !== "assistant" || typeof assistant.info.parentID !== "string") {
+        throw new PluginError("GENIMAGE_ATTACHMENT_ACCESS_FAILED", "The current assistant message does not identify its parent user message.");
+    }
+    const user = await getMessage(client, context.sessionID, assistant.info.parentID, context.directory, context.abort);
+    if (user.info.role !== "user") {
+        throw new PluginError("GENIMAGE_ATTACHMENT_ACCESS_FAILED", "The parent OpenCode message is not a user message.");
+    }
+    return user.parts.filter(isImagePart);
+}
+async function readAttachmentResponse(response, maximumBytes, signal) {
+    if (!response.ok || response.status >= 300) {
+        await response.body?.cancel().catch(() => { });
+        throw new PluginError("GENIMAGE_ATTACHMENT_ACCESS_FAILED", "OpenCode could not read the managed image attachment.", { details: { status: response.status } });
+    }
+    const contentLength = response.headers.get("content-length");
+    if (contentLength !== null) {
+        const parsed = Number(contentLength);
+        if (Number.isFinite(parsed) && parsed > maximumBytes) {
+            await response.body?.cancel().catch(() => { });
+            throw new PluginError("GENIMAGE_REFERENCE_TOO_LARGE", "The managed attachment exceeds the configured file-size limit.", { details: { maxFileBytes: maximumBytes } });
+        }
+    }
+    if (response.body === null) {
+        throw new PluginError("GENIMAGE_ATTACHMENT_ACCESS_FAILED", "The managed image attachment has no response body.");
+    }
+    const reader = response.body.getReader();
+    const chunks = [];
+    let total = 0;
+    try {
+        for (;;) {
+            throwIfAborted(signal);
+            const chunk = await abortableStreamRead(reader, signal);
+            if (chunk.done)
+                break;
+            total += chunk.value.byteLength;
+            if (total > maximumBytes) {
+                await reader.cancel("attachment size limit exceeded").catch(() => { });
+                throw new PluginError("GENIMAGE_REFERENCE_TOO_LARGE", "The managed attachment exceeds the configured file-size limit.", { details: { maxFileBytes: maximumBytes } });
+            }
+            chunks.push(chunk.value);
+        }
+    }
+    finally {
+        try {
+            reader.releaseLock();
+        }
+        catch {
+            void reader.cancel().catch(() => { });
+        }
+    }
+    return Buffer.concat(chunks.map((chunk) => Buffer.from(chunk)), total);
+}
+async function loadManagedAttachment(part, url, maximumBytes, signal, fetchImplementation) {
+    if (!isSupportedImageMime(part.mime)) {
+        throw new PluginError("GENIMAGE_REFERENCE_FORMAT_UNSUPPORTED", "Only PNG, JPEG, and WebP attachments are supported.");
+    }
+    let response;
+    try {
+        response = await fetchImplementation(url, {
+            method: "GET",
+            redirect: "manual",
+            signal,
+            headers: { Accept: "image/png, image/jpeg, image/webp" },
+        });
+    }
+    catch (error) {
+        throwIfAborted(signal);
+        throw new PluginError("GENIMAGE_ATTACHMENT_ACCESS_FAILED", "OpenCode could not read the managed image attachment.", { cause: error });
+    }
+    const bytes = await readAttachmentResponse(response, maximumBytes, signal);
+    const detected = detectImageFormat(bytes);
+    if (detected === undefined) {
+        throw new PluginError("GENIMAGE_REFERENCE_FORMAT_UNSUPPORTED", "The attachment is not a supported PNG, JPEG, or WebP image.");
+    }
+    if (detected.mime !== part.mime) {
+        throw new PluginError("GENIMAGE_REFERENCE_INVALID", "The attachment MIME type does not match its binary format.");
+    }
+    return {
+        bytes,
+        detected,
+        dataUrl: imageBytesToDataUrl(bytes, detected.mime),
+        canonicalPath: "",
+    };
+}
+function fromLocalImage(source, image) {
+    return {
+        source,
+        openRouterReference: {
+            type: "image_url",
+            image_url: { url: image.dataUrl },
+        },
+        byteLength: image.bytes.byteLength,
+        detected: image.detected,
+        ...(image.canonicalPath === "" ? {} : { canonicalSourcePath: image.canonicalPath }),
+    };
+}
+async function resolveMessagePart(part, serverUrl, maximumBytes, signal, fetchImplementation) {
+    if (part.url.startsWith("data:")) {
+        const decoded = parseImageDataUrl(part.url, maximumBytes);
+        if (decoded.detected.mime !== part.mime) {
+            throw new PluginError("GENIMAGE_REFERENCE_INVALID", "The attachment MIME type does not match its data URL.");
+        }
+        return {
+            source: "message_attachment",
+            openRouterReference: {
+                type: "image_url",
+                image_url: { url: decoded.dataUrl },
+            },
+            byteLength: decoded.bytes.byteLength,
+            detected: decoded.detected,
+        };
+    }
+    let url;
+    try {
+        url = new URL(part.url);
+    }
+    catch (error) {
+        throw new PluginError("GENIMAGE_ATTACHMENT_ACCESS_FAILED", "The OpenCode attachment URL is invalid.", { cause: error });
+    }
+    if (url.username !== "" || url.password !== "") {
+        throw new PluginError("GENIMAGE_ATTACHMENT_ACCESS_FAILED", "The OpenCode attachment URL contains credentials.");
+    }
+    if (url.protocol === "file:") {
+        return fromLocalImage("message_attachment", await loadTrustedAttachmentFile(part.url, maximumBytes, signal));
+    }
+    const isManaged = url.origin === serverUrl.origin || url.protocol === "blob:";
+    if (isManaged) {
+        return fromLocalImage("message_attachment", await loadManagedAttachment(part, url, maximumBytes, signal, fetchImplementation));
+    }
+    if (url.protocol === "https:") {
+        validatePublicHttpsUrl(part.url);
+        return {
+            source: "message_attachment",
+            openRouterReference: {
+                type: "image_url",
+                image_url: { url: part.url },
+            },
+        };
+    }
+    throw new PluginError("GENIMAGE_ATTACHMENT_ACCESS_FAILED", "The OpenCode attachment uses an unsupported URL scheme.");
+}
+export async function resolveImageReferences(options) {
+    const fetchImplementation = options.fetch ?? globalThis.fetch.bind(globalThis);
+    const budget = new ReferenceBudget(options.limits);
+    const parts = options.references === undefined ||
+        options.references.some((reference) => reference.type === "message_attachment")
+        ? await getCurrentUserImageParts(options.client, options.context)
+        : [];
+    const requested = options.references ?? parts.map((_, index) => ({ type: "message_attachment", index: index + 1 }));
+    if (requested.length === 0) {
+        throw new PluginError("GENIMAGE_REFERENCE_REQUIRED", "Image editing requires at least one visual reference.");
+    }
+    if (requested.length > options.limits.maxReferences || requested.length > 16) {
+        throw new PluginError("GENIMAGE_TOO_MANY_REFERENCES", "Too many image references were supplied.", { details: { maxReferences: Math.min(options.limits.maxReferences, 16) } });
+    }
+    const resolved = [];
+    let urlCharacters = 0;
+    for (const reference of requested) {
+        throwIfAborted(options.context.abort);
+        let item;
+        switch (reference.type) {
+            case "message_attachment": {
+                if (!Number.isInteger(reference.index) || reference.index < 1) {
+                    throw new PluginError("GENIMAGE_REFERENCE_INDEX_INVALID", "Attachment indexes start at 1 and must be integers.");
+                }
+                const part = parts[reference.index - 1];
+                if (part === undefined) {
+                    throw new PluginError("GENIMAGE_REFERENCE_INDEX_INVALID", "The requested image attachment index does not exist in the current user message.", { details: { index: reference.index, available: parts.length } });
+                }
+                item = await resolveMessagePart(part, options.serverUrl, options.limits.maxFileBytes, options.context.abort, fetchImplementation);
+                break;
+            }
+            case "project_file":
+                item = fromLocalImage("project_file", await loadProjectImage(options.context.worktree, reference.path, options.limits.maxFileBytes, options.context.abort));
+                break;
+            case "https_url": {
+                const url = validatePublicHttpsUrl(reference.url);
+                item = {
+                    source: "https_url",
+                    openRouterReference: {
+                        type: "image_url",
+                        image_url: { url },
+                    },
+                };
+                break;
+            }
+        }
+        if (item.byteLength === undefined) {
+            budget.addRemoteReference();
+            urlCharacters += item.openRouterReference.image_url.url.length;
+        }
+        else {
+            budget.addLocalReference(item.byteLength);
+        }
+        resolved.push(item);
+    }
+    budget.assertEstimatedRequestSize(options.promptLength, urlCharacters);
+    return {
+        references: resolved,
+        inputReferences: resolved.map((item) => item.openRouterReference),
+        canonicalSourcePaths: new Set(resolved.flatMap((item) => item.canonicalSourcePath === undefined ? [] : [item.canonicalSourcePath])),
+        localBytes: budget.localBytes,
+    };
+}
+//# sourceMappingURL=attachments.js.map

package/dist/references/attachments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.js","sourceRoot":"","sources":["../../src/references/attachments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAErD,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACvE,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACtE,OAAO,EACL,iBAAiB,EACjB,oBAAoB,GAErB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,eAAe,EAAwB,MAAM,aAAa,CAAA;AACnE,OAAO,EACL,gBAAgB,EAChB,yBAAyB,GAE1B,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAgFzD,SAAS,WAAW,CAClB,IAA0C;IAE1C,OAAO,CACL,IAAI,CAAC,IAAI,KAAK,MAAM;QACpB,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;QAC7B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAC9B,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,CAC7B,CAAA;AACH,CAAC;AAED,KAAK,UAAU,UAAU,CACvB,MAA6B,EAC7B,SAAiB,EACjB,SAAiB,EACjB,SAAiB,EACjB,MAAmB;IAEnB,cAAc,CAAC,MAAM,CAAC,CAAA;IACtB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;YAC5C,IAAI,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE;YAClC,KAAK,EAAE,EAAE,SAAS,EAAE;YACpB,MAAM;SACP,CAAC,CAAA;QACF,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS;YAAE,MAAM,IAAI,SAAS,CAAC,qBAAqB,CAAC,CAAA;QAC3E,OAAO,QAAQ,CAAC,IAAI,CAAA;IACtB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,cAAc,CAAC,MAAM,CAAC,CAAA;QACtB,MAAM,IAAI,WAAW,CACnB,mCAAmC,EACnC,6DAA6D,EAC7D,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAA;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAA6B,EAC7B,OAA6B;IAE7B,MAAM,SAAS,GAAG,MAAM,UAAU,CAChC,MAAM,EACN,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,KAAK,CACd,CAAA;IACD,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,KAAK,WAAW,IAAI,OAAO,SAAS,CAAC,IAAI,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACvF,MAAM,IAAI,WAAW,CACnB,mCAAmC,EACnC,0EAA0E,CAC3E,CAAA;IACH,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,UAAU,CAC3B,MAAM,EACN,OAAO,CAAC,SAAS,EACjB,SAAS,CAAC,IAAI,CAAC,QAAQ,EACvB,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,KAAK,CACd,CAAA;IACD,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC9B,MAAM,IAAI,WAAW,CACnB,mCAAmC,EACnC,oDAAoD,CACrD,CAAA;IACH,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;AACvC,CAAC;AAED,KAAK,UAAU,sBAAsB,CACnC,QAAkB,EAClB,YAAoB,EACpB,MAAmB;IAEnB,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;QAC3C,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QAC7C,MAAM,IAAI,WAAW,CACnB,mCAAmC,EACnC,uDAAuD,EACvD,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,EAAE,CACzC,CAAA;IACH,CAAC;IAED,MAAM,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA;IAC5D,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,MAAM,CAAC,aAAa,CAAC,CAAA;QACpC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,YAAY,EAAE,CAAC;YACrD,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;YAC7C,MAAM,IAAI,WAAW,CACnB,8BAA8B,EAC9B,gEAAgE,EAChE,EAAE,OAAO,EAAE,EAAE,YAAY,EAAE,YAAY,EAAE,EAAE,CAC5C,CAAA;QACH,CAAC;IACH,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QAC3B,MAAM,IAAI,WAAW,CACnB,mCAAmC,EACnC,oDAAoD,CACrD,CAAA;IACH,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAA;IACxC,MAAM,MAAM,GAAiB,EAAE,CAAA;IAC/B,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,IAAI,CAAC;QACH,SAAS,CAAC;YACR,cAAc,CAAC,MAAM,CAAC,CAAA;YACtB,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;YACvD,IAAI,KAAK,CAAC,IAAI;gBAAE,MAAK;YACrB,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,UAAU,CAAA;YAC/B,IAAI,KAAK,GAAG,YAAY,EAAE,CAAC;gBACzB,MAAM,MAAM,CAAC,MAAM,CAAC,gCAAgC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;gBACrE,MAAM,IAAI,WAAW,CACnB,8BAA8B,EAC9B,gEAAgE,EAChE,EAAE,OAAO,EAAE,EAAE,YAAY,EAAE,YAAY,EAAE,EAAE,CAC5C,CAAA;YACH,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QAC1B,CAAC;IACH,CAAC;YAAS,CAAC;QACT,IAAI,CAAC;YACH,MAAM,CAAC,WAAW,EAAE,CAAA;QACtB,CAAC;QAAC,MAAM,CAAC;YACP,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QACtC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;AACxE,CAAC;AAED,KAAK,UAAU,qBAAqB,CAClC,IAAsB,EACtB,GAAQ,EACR,YAAoB,EACpB,MAAmB,EACnB,mBAA4C;IAE5C,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,WAAW,CACnB,uCAAuC,EACvC,qDAAqD,CACtD,CAAA;IACH,CAAC;IAED,IAAI,QAAkB,CAAA;IACtB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,mBAAmB,CAAC,GAAG,EAAE;YACxC,MAAM,EAAE,KAAK;YACb,QAAQ,EAAE,QAAQ;YAClB,MAAM;YACN,OAAO,EAAE,EAAE,MAAM,EAAE,mCAAmC,EAAE;SACzD,CAAC,CAAA;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,cAAc,CAAC,MAAM,CAAC,CAAA;QACtB,MAAM,IAAI,WAAW,CACnB,mCAAmC,EACnC,uDAAuD,EACvD,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAA;IACH,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,sBAAsB,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,CAAC,CAAA;IAC1E,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAA;IACzC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,WAAW,CACnB,uCAAuC,EACvC,6DAA6D,CAC9D,CAAA;IACH,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;QAChC,MAAM,IAAI,WAAW,CACnB,4BAA4B,EAC5B,4DAA4D,CAC7D,CAAA;IACH,CAAC;IAED,OAAO;QACL,KAAK;QACL,QAAQ;QACR,OAAO,EAAE,mBAAmB,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC;QAClD,aAAa,EAAE,EAAE;KAClB,CAAA;AACH,CAAC;AAED,SAAS,cAAc,CACrB,MAAmC,EACnC,KAAuB;IAEvB,OAAO;QACL,MAAM;QACN,mBAAmB,EAAE;YACnB,IAAI,EAAE,WAAW;YACjB,SAAS,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,OAAO,EAAE;SAClC;QACD,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,UAAU;QAClC,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,GAAG,CAAC,KAAK,CAAC,aAAa,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC;KACpF,CAAA;AACH,CAAC;AAED,KAAK,UAAU,kBAAkB,CAC/B,IAAsB,EACtB,SAAc,EACd,YAAoB,EACpB,MAAmB,EACnB,mBAA4C;IAE5C,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,iBAAiB,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAA;QACzD,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;YACxC,MAAM,IAAI,WAAW,CACnB,4BAA4B,EAC5B,uDAAuD,CACxD,CAAA;QACH,CAAC;QACD,OAAO;YACL,MAAM,EAAE,oBAAoB;YAC5B,mBAAmB,EAAE;gBACnB,IAAI,EAAE,WAAW;gBACjB,SAAS,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE;aACpC;YACD,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,UAAU;YACpC,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAA;IACH,CAAC;IAED,IAAI,GAAQ,CAAA;IACZ,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,WAAW,CACnB,mCAAmC,EACnC,yCAAyC,EACzC,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAA;IACH,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,KAAK,EAAE,IAAI,GAAG,CAAC,QAAQ,KAAK,EAAE,EAAE,CAAC;QAC/C,MAAM,IAAI,WAAW,CACnB,mCAAmC,EACnC,mDAAmD,CACpD,CAAA;IACH,CAAC;IAED,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QAC7B,OAAO,cAAc,CACnB,oBAAoB,EACpB,MAAM,yBAAyB,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,EAAE,MAAM,CAAC,CAChE,CAAA;IACH,CAAC;IAED,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,CAAA;IAC7E,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,cAAc,CACnB,oBAAoB,EACpB,MAAM,qBAAqB,CACzB,IAAI,EACJ,GAAG,EACH,YAAY,EACZ,MAAM,EACN,mBAAmB,CACpB,CACF,CAAA;IACH,CAAC;IAED,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC9B,sBAAsB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAChC,OAAO;YACL,MAAM,EAAE,oBAAoB;YAC5B,mBAAmB,EAAE;gBACnB,IAAI,EAAE,WAAW;gBACjB,SAAS,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE;aAC7B;SACF,CAAA;IACH,CAAC;IAED,MAAM,IAAI,WAAW,CACnB,mCAAmC,EACnC,yDAAyD,CAC1D,CAAA;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAiC;IAEjC,MAAM,mBAAmB,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IAC9E,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IAClD,MAAM,KAAK,GACT,OAAO,CAAC,UAAU,KAAK,SAAS;QAChC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,oBAAoB,CAAC;QAC7E,CAAC,CAAC,MAAM,wBAAwB,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC;QACjE,CAAC,CAAC,EAAE,CAAA;IAER,MAAM,SAAS,GACb,OAAO,CAAC,UAAU,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;IACnG,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,WAAW,CACnB,6BAA6B,EAC7B,uDAAuD,CACxD,CAAA;IACH,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,IAAI,SAAS,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QAC7E,MAAM,IAAI,WAAW,CACnB,8BAA8B,EAC9B,0CAA0C,EAC1C,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,CAAC,EAAE,EAAE,CAC3E,CAAA;IACH,CAAC;IAED,MAAM,QAAQ,GAAwB,EAAE,CAAA;IACxC,IAAI,aAAa,GAAG,CAAC,CAAA;IACrB,KAAK,MAAM,SAAS,IAAI,SAAS,EAAE,CAAC;QAClC,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QACrC,IAAI,IAAuB,CAAA;QAC3B,QAAQ,SAAS,CAAC,IAAI,EAAE,CAAC;YACvB,KAAK,oBAAoB,CAAC,CAAC,CAAC;gBAC1B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;oBAC9D,MAAM,IAAI,WAAW,CACnB,kCAAkC,EAClC,qDAAqD,CACtD,CAAA;gBACH,CAAC;gBACD,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;gBACvC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;oBACvB,MAAM,IAAI,WAAW,CACnB,kCAAkC,EAClC,kFAAkF,EAClF,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,CACjE,CAAA;gBACH,CAAC;gBACD,IAAI,GAAG,MAAM,kBAAkB,CAC7B,IAAI,EACJ,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,MAAM,CAAC,YAAY,EAC3B,OAAO,CAAC,OAAO,CAAC,KAAK,EACrB,mBAAmB,CACpB,CAAA;gBACD,MAAK;YACP,CAAC;YACD,KAAK,cAAc;gBACjB,IAAI,GAAG,cAAc,CACnB,cAAc,EACd,MAAM,gBAAgB,CACpB,OAAO,CAAC,OAAO,CAAC,QAAQ,EACxB,SAAS,CAAC,IAAI,EACd,OAAO,CAAC,MAAM,CAAC,YAAY,EAC3B,OAAO,CAAC,OAAO,CAAC,KAAK,CACtB,CACF,CAAA;gBACD,MAAK;YACP,KAAK,WAAW,CAAC,CAAC,CAAC;gBACjB,MAAM,GAAG,GAAG,sBAAsB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;gBACjD,IAAI,GAAG;oBACL,MAAM,EAAE,WAAW;oBACnB,mBAAmB,EAAE;wBACnB,IAAI,EAAE,WAAW;wBACjB,SAAS,EAAE,EAAE,GAAG,EAAE;qBACnB;iBACF,CAAA;gBACD,MAAK;YACP,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YAClC,MAAM,CAAC,kBAAkB,EAAE,CAAA;YAC3B,aAAa,IAAI,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAA;QAChE,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QAC3C,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACrB,CAAC;IAED,MAAM,CAAC,0BAA0B,CAAC,OAAO,CAAC,YAAY,EAAE,aAAa,CAAC,CAAA;IACtE,OAAO;QACL,UAAU,EAAE,QAAQ;QACpB,eAAe,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,mBAAmB,CAAC;QACjE,oBAAoB,EAAE,IAAI,GAAG,CAC3B,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CACxB,IAAI,CAAC,mBAAmB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CACzE,CACF;QACD,UAAU,EAAE,MAAM,CAAC,UAAU;KAC9B,CAAA;AACH,CAAC"}

package/dist/references/data-url.d.ts

@@ -0,0 +1,12 @@
+import { Buffer } from "node:buffer";
+import { type DetectedImageFormat, type RasterImageMime } from "./formats.js";
+export interface DecodedImageData {
+    bytes: Buffer;
+    detected: DetectedImageFormat;
+    dataUrl: string;
+}
+export declare function estimatedDecodedBase64Bytes(value: string): number;
+export declare function decodeStrictBase64(value: string, maximumBytes?: number): Buffer;
+export declare function imageBytesToDataUrl(bytes: Uint8Array, mime: RasterImageMime): string;
+export declare function parseImageDataUrl(value: string, maximumBytes?: number): DecodedImageData;
+//# sourceMappingURL=data-url.d.ts.map

package/dist/references/data-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-url.d.ts","sourceRoot":"","sources":["../../src/references/data-url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGpC,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACrB,MAAM,cAAc,CAAA;AAErB,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,mBAAmB,CAAA;IAC7B,OAAO,EAAE,MAAM,CAAA;CAChB;AAmCD,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIjE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAuB/E;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,eAAe,GACpB,MAAM,CAER;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,MAAM,GACpB,gBAAgB,CAoDlB"}

package/dist/references/data-url.js

@@ -0,0 +1,75 @@
+import { Buffer } from "node:buffer";
+import { PluginError } from "../openrouter/errors.js";
+import { detectImageFormat, isSupportedImageMime, } from "./formats.js";
+function normalizeBase64(value) {
+    if (value === "" || /\s/u.test(value) || /[^A-Za-z0-9+/=]/u.test(value)) {
+        throw new PluginError("GENIMAGE_REFERENCE_INVALID", "The image contains invalid base64 data.");
+    }
+    const firstPadding = value.indexOf("=");
+    if (firstPadding !== -1 && !/^={1,2}$/u.test(value.slice(firstPadding))) {
+        throw new PluginError("GENIMAGE_REFERENCE_INVALID", "The image contains invalid base64 padding.");
+    }
+    const unpadded = firstPadding === -1 ? value : value.slice(0, firstPadding);
+    if (unpadded.length % 4 === 1) {
+        throw new PluginError("GENIMAGE_REFERENCE_INVALID", "The image contains invalid base64 data.");
+    }
+    const padded = `${unpadded}${"=".repeat((4 - (unpadded.length % 4)) % 4)}`;
+    if (firstPadding !== -1 && padded !== value) {
+        throw new PluginError("GENIMAGE_REFERENCE_INVALID", "The image contains non-canonical base64 padding.");
+    }
+    return padded;
+}
+export function estimatedDecodedBase64Bytes(value) {
+    const padded = normalizeBase64(value);
+    const padding = padded.endsWith("==") ? 2 : padded.endsWith("=") ? 1 : 0;
+    return (padded.length / 4) * 3 - padding;
+}
+export function decodeStrictBase64(value, maximumBytes) {
+    const padded = normalizeBase64(value);
+    const estimated = estimatedDecodedBase64Bytes(padded);
+    if (maximumBytes !== undefined && estimated > maximumBytes) {
+        throw new PluginError("GENIMAGE_REFERENCE_TOO_LARGE", "The reference image exceeds the configured file-size limit.", {
+            details: { maxFileBytes: maximumBytes },
+            suggestion: "Resize or compress the image, use fewer references, or provide a public HTTPS URL.",
+        });
+    }
+    const bytes = Buffer.from(padded, "base64");
+    if (bytes.toString("base64") !== padded) {
+        throw new PluginError("GENIMAGE_REFERENCE_INVALID", "The image contains invalid base64 data.");
+    }
+    return bytes;
+}
+export function imageBytesToDataUrl(bytes, mime) {
+    return `data:${mime};base64,${Buffer.from(bytes).toString("base64")}`;
+}
+export function parseImageDataUrl(value, maximumBytes) {
+    if (maximumBytes !== undefined &&
+        value.length > Math.ceil(maximumBytes / 3) * 4 + 64) {
+        throw new PluginError("GENIMAGE_REFERENCE_TOO_LARGE", "The reference image exceeds the configured file-size limit.", { details: { maxFileBytes: maximumBytes } });
+    }
+    const match = /^data:([^;,]+);base64,([A-Za-z0-9+/=]+)$/u.exec(value);
+    if (match === null) {
+        throw new PluginError("GENIMAGE_REFERENCE_INVALID", "The attachment is not a valid base64 image data URL.");
+    }
+    const declaredMime = match[1];
+    const encoded = match[2];
+    if (declaredMime === undefined ||
+        encoded === undefined ||
+        !isSupportedImageMime(declaredMime)) {
+        throw new PluginError("GENIMAGE_REFERENCE_FORMAT_UNSUPPORTED", "Only PNG, JPEG, and WebP reference images are supported.");
+    }
+    const bytes = decodeStrictBase64(encoded, maximumBytes);
+    const detected = detectImageFormat(bytes);
+    if (detected === undefined) {
+        throw new PluginError("GENIMAGE_REFERENCE_FORMAT_UNSUPPORTED", "The reference image is not a supported PNG, JPEG, or WebP file.");
+    }
+    if (detected.mime !== declaredMime) {
+        throw new PluginError("GENIMAGE_REFERENCE_INVALID", "The reference image MIME type does not match its binary format.");
+    }
+    return {
+        bytes,
+        detected,
+        dataUrl: imageBytesToDataUrl(bytes, detected.mime),
+    };
+}
+//# sourceMappingURL=data-url.js.map

package/dist/references/data-url.js.map

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

package/dist/references/formats.d.ts

@@ -0,0 +1,13 @@
+export type RasterImageFormat = "png" | "jpeg" | "webp";
+export type RasterImageMime = "image/png" | "image/jpeg" | "image/webp";
+export interface DetectedImageFormat {
+    format: RasterImageFormat;
+    mime: RasterImageMime;
+    extension: ".png" | ".jpeg" | ".webp";
+}
+export declare function detectImageFormat(bytes: Uint8Array): DetectedImageFormat | undefined;
+export declare function isSupportedImageMime(value: string): value is RasterImageMime;
+export declare function formatFromExtension(extension: string): RasterImageFormat | undefined;
+export declare function mimeForFormat(format: RasterImageFormat): RasterImageMime;
+export declare function extensionForFormat(format: RasterImageFormat): DetectedImageFormat["extension"];
+//# sourceMappingURL=formats.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formats.d.ts","sourceRoot":"","sources":["../../src/references/formats.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAA;AACvD,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,YAAY,GAAG,YAAY,CAAA;AAEvE,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,iBAAiB,CAAA;IACzB,IAAI,EAAE,eAAe,CAAA;IACrB,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAA;CACtC;AASD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,mBAAmB,GAAG,SAAS,CAuBpF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,eAAe,CAE5E;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAYpF;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,iBAAiB,GAAG,eAAe,CAMxE;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,iBAAiB,GACxB,mBAAmB,CAAC,WAAW,CAAC,CAElC"}

package/dist/references/formats.js

@@ -0,0 +1,50 @@
+const PNG_SIGNATURE = Uint8Array.from([137, 80, 78, 71, 13, 10, 26, 10]);
+function startsWith(bytes, signature) {
+    if (bytes.byteLength < signature.byteLength)
+        return false;
+    return signature.every((value, index) => bytes[index] === value);
+}
+export function detectImageFormat(bytes) {
+    if (startsWith(bytes, PNG_SIGNATURE)) {
+        return { format: "png", mime: "image/png", extension: ".png" };
+    }
+    if (bytes.byteLength >= 3 &&
+        bytes[0] === 0xff &&
+        bytes[1] === 0xd8 &&
+        bytes[2] === 0xff) {
+        return { format: "jpeg", mime: "image/jpeg", extension: ".jpeg" };
+    }
+    if (bytes.byteLength >= 12 &&
+        String.fromCharCode(...bytes.subarray(0, 4)) === "RIFF" &&
+        String.fromCharCode(...bytes.subarray(8, 12)) === "WEBP") {
+        return { format: "webp", mime: "image/webp", extension: ".webp" };
+    }
+    return undefined;
+}
+export function isSupportedImageMime(value) {
+    return value === "image/png" || value === "image/jpeg" || value === "image/webp";
+}
+export function formatFromExtension(extension) {
+    switch (extension.toLowerCase()) {
+        case ".png":
+            return "png";
+        case ".jpg":
+        case ".jpeg":
+            return "jpeg";
+        case ".webp":
+            return "webp";
+        default:
+            return undefined;
+    }
+}
+export function mimeForFormat(format) {
+    return format === "png"
+        ? "image/png"
+        : format === "jpeg"
+            ? "image/jpeg"
+            : "image/webp";
+}
+export function extensionForFormat(format) {
+    return format === "png" ? ".png" : format === "jpeg" ? ".jpeg" : ".webp";
+}
+//# sourceMappingURL=formats.js.map

package/dist/references/formats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formats.js","sourceRoot":"","sources":["../../src/references/formats.ts"],"names":[],"mappings":"AASA,MAAM,aAAa,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAA;AAExE,SAAS,UAAU,CAAC,KAAiB,EAAE,SAAqB;IAC1D,IAAI,KAAK,CAAC,UAAU,GAAG,SAAS,CAAC,UAAU;QAAE,OAAO,KAAK,CAAA;IACzD,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,CAAA;AAClE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAiB;IACjD,IAAI,UAAU,CAAC,KAAK,EAAE,aAAa,CAAC,EAAE,CAAC;QACrC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,CAAA;IAChE,CAAC;IAED,IACE,KAAK,CAAC,UAAU,IAAI,CAAC;QACrB,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;QACjB,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;QACjB,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,EACjB,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,CAAA;IACnE,CAAC;IAED,IACE,KAAK,CAAC,UAAU,IAAI,EAAE;QACtB,MAAM,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,MAAM;QACvD,MAAM,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,EACxD,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,CAAA;IACnE,CAAC;IAED,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,OAAO,KAAK,KAAK,WAAW,IAAI,KAAK,KAAK,YAAY,IAAI,KAAK,KAAK,YAAY,CAAA;AAClF,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,SAAiB;IACnD,QAAQ,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC;QAChC,KAAK,MAAM;YACT,OAAO,KAAK,CAAA;QACd,KAAK,MAAM,CAAC;QACZ,KAAK,OAAO;YACV,OAAO,MAAM,CAAA;QACf,KAAK,OAAO;YACV,OAAO,MAAM,CAAA;QACf;YACE,OAAO,SAAS,CAAA;IACpB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAyB;IACrD,OAAO,MAAM,KAAK,KAAK;QACrB,CAAC,CAAC,WAAW;QACb,CAAC,CAAC,MAAM,KAAK,MAAM;YACjB,CAAC,CAAC,YAAY;YACd,CAAC,CAAC,YAAY,CAAA;AACpB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,MAAyB;IAEzB,OAAO,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAA;AAC1E,CAAC"}

package/dist/references/index.d.ts

@@ -0,0 +1,7 @@
+export { getCurrentUserImageParts, resolveImageReferences, type HttpsUrlReference, type ImageReference, type MessageAttachmentReference, type OpenCodeFilePart, type OpenCodeMessageClient, type ProjectFileReference, type ReferenceToolContext, type ResolvedReference, type ResolvedReferences, type ResolveReferencesOptions, } from "./attachments.js";
+export { decodeStrictBase64, estimatedDecodedBase64Bytes, imageBytesToDataUrl, parseImageDataUrl, type DecodedImageData, } from "./data-url.js";
+export { detectImageFormat, extensionForFormat, formatFromExtension, isSupportedImageMime, mimeForFormat, type DetectedImageFormat, type RasterImageFormat, type RasterImageMime, } from "./formats.js";
+export { ReferenceBudget, type ReferenceLimits } from "./limits.js";
+export { assertSafeRelativePath, isPathInside, loadProjectImage, loadTrustedAttachmentFile, sameCanonicalPath, type LoadedLocalImage, } from "./project-files.js";
+export { MAX_REFERENCE_URL_LENGTH, validatePublicHttpsUrl } from "./remote-urls.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/references/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,0BAA0B,EAC/B,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,GAC9B,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,kBAAkB,EAClB,2BAA2B,EAC3B,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAA;AACnE,OAAO,EACL,sBAAsB,EACtB,YAAY,EACZ,gBAAgB,EAChB,yBAAyB,EACzB,iBAAiB,EACjB,KAAK,gBAAgB,GACtB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/references/index.js

@@ -0,0 +1,7 @@
+export { getCurrentUserImageParts, resolveImageReferences, } from "./attachments.js";
+export { decodeStrictBase64, estimatedDecodedBase64Bytes, imageBytesToDataUrl, parseImageDataUrl, } from "./data-url.js";
+export { detectImageFormat, extensionForFormat, formatFromExtension, isSupportedImageMime, mimeForFormat, } from "./formats.js";
+export { ReferenceBudget } from "./limits.js";
+export { assertSafeRelativePath, isPathInside, loadProjectImage, loadTrustedAttachmentFile, sameCanonicalPath, } from "./project-files.js";
+export { MAX_REFERENCE_URL_LENGTH, validatePublicHttpsUrl } from "./remote-urls.js";
+//# sourceMappingURL=index.js.map

package/dist/references/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/references/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,sBAAsB,GAWvB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,kBAAkB,EAClB,2BAA2B,EAC3B,mBAAmB,EACnB,iBAAiB,GAElB,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,GAId,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,eAAe,EAAwB,MAAM,aAAa,CAAA;AACnE,OAAO,EACL,sBAAsB,EACtB,YAAY,EACZ,gBAAgB,EAChB,yBAAyB,EACzB,iBAAiB,GAElB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/references/limits.d.ts

@@ -0,0 +1,15 @@
+export interface ReferenceLimits {
+    maxReferences: number;
+    maxFileBytes: number;
+    maxTotalBytes: number;
+}
+export declare class ReferenceBudget {
+    #private;
+    constructor(limits: ReferenceLimits);
+    get referenceCount(): number;
+    get localBytes(): number;
+    addRemoteReference(): void;
+    addLocalReference(bytes: number): void;
+    assertEstimatedRequestSize(promptCharacters: number, urlCharacters: number): void;
+}
+//# sourceMappingURL=limits.d.ts.map

package/dist/references/limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../../src/references/limits.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,qBAAa,eAAe;;gBAKd,MAAM,EAAE,eAAe;IAInC,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,kBAAkB,IAAI,IAAI;IAI1B,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAoCtC,0BAA0B,CAAC,gBAAgB,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI;CA+BlF"}

package/dist/references/limits.js

@@ -0,0 +1,62 @@
+import { PluginError } from "../openrouter/errors.js";
+export class ReferenceBudget {
+    #limits;
+    #referenceCount = 0;
+    #localBytes = 0;
+    constructor(limits) {
+        this.#limits = limits;
+    }
+    get referenceCount() {
+        return this.#referenceCount;
+    }
+    get localBytes() {
+        return this.#localBytes;
+    }
+    addRemoteReference() {
+        this.#addReferenceCount();
+    }
+    addLocalReference(bytes) {
+        if (!Number.isSafeInteger(bytes) || bytes < 0) {
+            throw new PluginError("GENIMAGE_REFERENCE_INVALID", "The reference image has an invalid byte size.");
+        }
+        if (bytes > this.#limits.maxFileBytes) {
+            throw new PluginError("GENIMAGE_REFERENCE_TOO_LARGE", "The reference image exceeds the configured file-size limit.", {
+                details: { bytes, maxFileBytes: this.#limits.maxFileBytes },
+                suggestion: "Resize or compress the image, use fewer references, or provide a public HTTPS URL.",
+            });
+        }
+        if (this.#localBytes + bytes > this.#limits.maxTotalBytes) {
+            throw new PluginError("GENIMAGE_TOTAL_REFERENCE_SIZE_EXCEEDED", "The combined local reference images exceed the configured size limit.", {
+                details: {
+                    bytes: this.#localBytes + bytes,
+                    maxTotalBytes: this.#limits.maxTotalBytes,
+                },
+                suggestion: "Resize or compress images, use fewer references, or provide public HTTPS URLs.",
+            });
+        }
+        this.#addReferenceCount();
+        this.#localBytes += bytes;
+    }
+    assertEstimatedRequestSize(promptCharacters, urlCharacters) {
+        const estimatedBase64Bytes = Math.ceil(this.#localBytes / 3) * 4;
+        const overhead = 64 * 1024 + promptCharacters * 4 + urlCharacters * 4;
+        const maximum = Math.ceil(this.#limits.maxTotalBytes / 3) * 4 + 1024 * 1024;
+        if (estimatedBase64Bytes + overhead > maximum) {
+            throw new PluginError("GENIMAGE_TOTAL_REFERENCE_SIZE_EXCEEDED", "The encoded reference payload exceeds the safe request-size limit.", {
+                suggestion: "Resize or compress images, use fewer references, or provide public HTTPS URLs.",
+            });
+        }
+    }
+    #addReferenceCount() {
+        this.#referenceCount += 1;
+        if (this.#referenceCount > this.#limits.maxReferences || this.#referenceCount > 16) {
+            throw new PluginError("GENIMAGE_TOO_MANY_REFERENCES", "Too many image references were supplied.", {
+                details: {
+                    maxReferences: Math.min(this.#limits.maxReferences, 16),
+                },
+                suggestion: "Use fewer references.",
+            });
+        }
+    }
+}
+//# sourceMappingURL=limits.js.map

package/dist/references/limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.js","sourceRoot":"","sources":["../../src/references/limits.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAQrD,MAAM,OAAO,eAAe;IACjB,OAAO,CAAiB;IACjC,eAAe,GAAG,CAAC,CAAA;IACnB,WAAW,GAAG,CAAC,CAAA;IAEf,YAAY,MAAuB;QACjC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;IACvB,CAAC;IAED,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,eAAe,CAAA;IAC7B,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAA;IACzB,CAAC;IAED,kBAAkB;QAChB,IAAI,CAAC,kBAAkB,EAAE,CAAA;IAC3B,CAAC;IAED,iBAAiB,CAAC,KAAa;QAC7B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YAC9C,MAAM,IAAI,WAAW,CACnB,4BAA4B,EAC5B,+CAA+C,CAChD,CAAA;QACH,CAAC;QACD,IAAI,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;YACtC,MAAM,IAAI,WAAW,CACnB,8BAA8B,EAC9B,6DAA6D,EAC7D;gBACE,OAAO,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE;gBAC3D,UAAU,EACR,oFAAoF;aACvF,CACF,CAAA;QACH,CAAC;QACD,IAAI,IAAI,CAAC,WAAW,GAAG,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;YAC1D,MAAM,IAAI,WAAW,CACnB,wCAAwC,EACxC,uEAAuE,EACvE;gBACE,OAAO,EAAE;oBACP,KAAK,EAAE,IAAI,CAAC,WAAW,GAAG,KAAK;oBAC/B,aAAa,EAAE,IAAI,CAAC,OAAO,CAAC,aAAa;iBAC1C;gBACD,UAAU,EACR,gFAAgF;aACnF,CACF,CAAA;QACH,CAAC;QACD,IAAI,CAAC,kBAAkB,EAAE,CAAA;QACzB,IAAI,CAAC,WAAW,IAAI,KAAK,CAAA;IAC3B,CAAC;IAED,0BAA0B,CAAC,gBAAwB,EAAE,aAAqB;QACxE,MAAM,oBAAoB,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,GAAG,CAAC,CAAA;QAChE,MAAM,QAAQ,GAAG,EAAE,GAAG,IAAI,GAAG,gBAAgB,GAAG,CAAC,GAAG,aAAa,GAAG,CAAC,CAAA;QACrE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAA;QAC3E,IAAI,oBAAoB,GAAG,QAAQ,GAAG,OAAO,EAAE,CAAC;YAC9C,MAAM,IAAI,WAAW,CACnB,wCAAwC,EACxC,oEAAoE,EACpE;gBACE,UAAU,EACR,gFAAgF;aACnF,CACF,CAAA;QACH,CAAC;IACH,CAAC;IAED,kBAAkB;QAChB,IAAI,CAAC,eAAe,IAAI,CAAC,CAAA;QACzB,IAAI,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,IAAI,IAAI,CAAC,eAAe,GAAG,EAAE,EAAE,CAAC;YACnF,MAAM,IAAI,WAAW,CACnB,8BAA8B,EAC9B,0CAA0C,EAC1C;gBACE,OAAO,EAAE;oBACP,aAAa,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC;iBACxD;gBACD,UAAU,EAAE,uBAAuB;aACpC,CACF,CAAA;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/references/project-files.d.ts

@@ -0,0 +1,13 @@
+import { type DetectedImageFormat } from "./formats.js";
+export interface LoadedLocalImage {
+    bytes: Buffer;
+    detected: DetectedImageFormat;
+    dataUrl: string;
+    canonicalPath: string;
+}
+export declare function isPathInside(root: string, candidate: string): boolean;
+export declare function assertSafeRelativePath(value: string): string;
+export declare function loadProjectImage(worktree: string, relativePath: string, maximumBytes: number, signal: AbortSignal): Promise<LoadedLocalImage>;
+export declare function loadTrustedAttachmentFile(fileUrl: string, maximumBytes: number, signal: AbortSignal): Promise<LoadedLocalImage>;
+export declare function sameCanonicalPath(left: string, right: string): boolean;
+//# sourceMappingURL=project-files.d.ts.map

package/dist/references/project-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-files.d.ts","sourceRoot":"","sources":["../../src/references/project-files.ts"],"names":[],"mappings":"AAOA,OAAO,EAAqB,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAE1E,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,mBAAmB,CAAA;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,MAAM,CAAA;CACtB;AAMD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAMrE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAiB5D;AA6GD,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,gBAAgB,CAAC,CAqC3B;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,gBAAgB,CAAC,CAgB3B;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAEtE"}