openrouter-genimage-kote-opencode 0.1.0

package/dist/output/paths.js

@@ -0,0 +1,296 @@
+import { randomBytes } from "node:crypto";
+import { lstat, mkdir, realpath } from "node:fs/promises";
+import path from "node:path";
+import { PluginError } from "../openrouter/errors.js";
+import { isPathInside, sameCanonicalPath, } from "../references/project-files.js";
+import { formatFromExtension, } from "../references/formats.js";
+const WINDOWS_DRIVE_PREFIX = /^[A-Za-z]:/u;
+const WINDOWS_UNC_PREFIX = /^(?:\\\\|\/\/)/u;
+function pathError(message) {
+    return new PluginError("GENIMAGE_OUTPUT_PATH_INVALID", message);
+}
+function outsideError(message, cause) {
+    return new PluginError("GENIMAGE_OUTPUT_OUTSIDE_WORKTREE", message, {
+        ...(cause === undefined ? {} : { cause }),
+    });
+}
+function normalizeSeparators(value) {
+    return value.replaceAll("\\", "/");
+}
+function toNativeRelativePath(value) {
+    return normalizeSeparators(value).split("/").join(path.sep);
+}
+function portableRelativePath(value) {
+    return value.split(path.sep).join("/");
+}
+function containsControlCharacter(value) {
+    for (let index = 0; index < value.length; index += 1) {
+        const codeUnit = value.charCodeAt(index);
+        if (codeUnit <= 0x1f || codeUnit === 0x7f)
+            return true;
+    }
+    return false;
+}
+function pathExistsError(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        error.code === "ENOENT");
+}
+/** Validate a portable, worktree-relative path without resolving it. */
+export function assertSafeOutputRelativePath(value, kind = "file") {
+    const portable = normalizeSeparators(value);
+    const segments = portable.split("/");
+    if (value.trim() === "" ||
+        containsControlCharacter(value) ||
+        path.posix.isAbsolute(portable) ||
+        path.win32.isAbsolute(value) ||
+        WINDOWS_DRIVE_PREFIX.test(value) ||
+        WINDOWS_UNC_PREFIX.test(value)) {
+        throw pathError("Output paths must be relative to the OpenCode worktree.");
+    }
+    if (segments.includes("..")) {
+        throw outsideError("The output path may not traverse outside the worktree.");
+    }
+    if (kind === "file" &&
+        (portable.endsWith("/") || segments.at(-1) === "" || segments.at(-1) === ".")) {
+        throw pathError("The output path must name a file, not a directory.");
+    }
+    return portable;
+}
+export function isExistingPathError(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        error.code === "EEXIST");
+}
+export async function findNearestExistingAncestor(value) {
+    let current = path.resolve(value);
+    let atFilesystemRoot = false;
+    while (!atFilesystemRoot) {
+        try {
+            await lstat(current);
+            return current;
+        }
+        catch (error) {
+            if (!pathExistsError(error))
+                throw error;
+        }
+        const parent = path.dirname(current);
+        atFilesystemRoot = parent === current;
+        current = parent;
+    }
+    throw outsideError("No existing output ancestor was found.");
+}
+export async function assertOutputParentContained(canonicalWorktree, parent) {
+    let ancestor;
+    let canonicalAncestor;
+    try {
+        ancestor = await findNearestExistingAncestor(parent);
+        canonicalAncestor = await realpath(ancestor);
+    }
+    catch (error) {
+        if (error instanceof PluginError)
+            throw error;
+        throw new PluginError("GENIMAGE_OUTPUT_WRITE_FAILED", "The output directory could not be inspected.", { cause: error });
+    }
+    if (!isPathInside(canonicalWorktree, canonicalAncestor)) {
+        throw outsideError("The output directory resolves outside the worktree.");
+    }
+}
+/** Create an output parent, then canonicalize it again to catch symlink escapes. */
+export async function ensureSafeOutputParent(canonicalWorktree, parent) {
+    await assertOutputParentContained(canonicalWorktree, parent);
+    try {
+        await mkdir(parent, { recursive: true });
+        const canonicalParent = await realpath(parent);
+        if (!isPathInside(canonicalWorktree, canonicalParent)) {
+            throw outsideError("The output directory resolves outside the worktree.");
+        }
+        return canonicalParent;
+    }
+    catch (error) {
+        if (error instanceof PluginError)
+            throw error;
+        throw new PluginError("GENIMAGE_OUTPUT_WRITE_FAILED", "The output directory could not be created.", { cause: error });
+    }
+}
+export async function recheckSafeOutputParent(canonicalWorktree, parent) {
+    let canonicalParent;
+    try {
+        canonicalParent = await realpath(parent);
+    }
+    catch (error) {
+        throw new PluginError("GENIMAGE_OUTPUT_WRITE_FAILED", "The output directory could not be verified before publication.", { cause: error });
+    }
+    if (!isPathInside(canonicalWorktree, canonicalParent)) {
+        throw outsideError("The output directory changed to point outside the worktree.");
+    }
+}
+function utcTimestamp(value) {
+    if (!Number.isFinite(value.getTime()))
+        throw new TypeError("now must be a valid Date");
+    return value.toISOString().replaceAll("-", "").replaceAll(":", "").replace(".", "");
+}
+function safeShortId(randomId) {
+    const supplied = randomId?.();
+    const normalized = supplied?.replace(/[^A-Za-z0-9_-]/gu, "").slice(0, 12);
+    return normalized === undefined || normalized === ""
+        ? randomBytes(4).toString("hex")
+        : normalized;
+}
+function replaceWithActualExtension(relativePath, detected) {
+    const parsed = path.posix.parse(relativePath);
+    const requestedFormat = formatFromExtension(parsed.ext);
+    if (requestedFormat === detected.format)
+        return { relativePath };
+    const corrected = path.posix.join(parsed.dir, `${parsed.name === "" ? parsed.base : parsed.name}${detected.extension}`);
+    if (parsed.ext === "")
+        return { relativePath: corrected };
+    return {
+        relativePath: corrected,
+        warning: `Output extension ${parsed.ext} did not match the returned ${detected.format.toUpperCase()} bytes; the file was saved as ${detected.extension}.`,
+    };
+}
+function addOrdinalSuffix(relativePath, index, count) {
+    if (count === 1)
+        return relativePath;
+    const parsed = path.posix.parse(relativePath);
+    const width = Math.max(2, String(count).length);
+    return path.posix.join(parsed.dir, `${parsed.name}-${String(index + 1).padStart(width, "0")}${parsed.ext}`);
+}
+export function addCollisionSuffix(relativePath, collision) {
+    if (collision < 2 || !Number.isSafeInteger(collision)) {
+        throw new TypeError("collision must be an integer greater than one");
+    }
+    const parsed = path.posix.parse(relativePath);
+    return path.posix.join(parsed.dir, `${parsed.name}-${collision}${parsed.ext}`);
+}
+async function canonicalizeSourcePaths(worktree, sourcePaths) {
+    return Promise.all(sourcePaths.map(async (source) => {
+        const absolute = path.isAbsolute(source) ? path.resolve(source) : path.resolve(worktree, source);
+        try {
+            return await realpath(absolute);
+        }
+        catch {
+            return absolute;
+        }
+    }));
+}
+function assertNotSource(target, canonicalTarget, sourcePaths) {
+    if (sourcePaths.some((source) => sameCanonicalPath(source, target) ||
+        (canonicalTarget !== undefined && sameCanonicalPath(source, canonicalTarget)))) {
+        throw new PluginError("GENIMAGE_SOURCE_OVERWRITE_FORBIDDEN", "The output path may not overwrite a source image.");
+    }
+}
+async function inspectTarget(target, canonicalWorktree, sourcePaths) {
+    let stats;
+    try {
+        stats = await lstat(target);
+    }
+    catch (error) {
+        if (pathExistsError(error)) {
+            assertNotSource(target, undefined, sourcePaths);
+            return { exists: false, isDirectory: false };
+        }
+        throw new PluginError("GENIMAGE_OUTPUT_WRITE_FAILED", "The output path could not be inspected.", { cause: error });
+    }
+    let canonicalTarget;
+    try {
+        canonicalTarget = await realpath(target);
+    }
+    catch (error) {
+        throw new PluginError("GENIMAGE_OUTPUT_WRITE_FAILED", "The existing output path could not be resolved.", { cause: error });
+    }
+    if (!isPathInside(canonicalWorktree, canonicalTarget)) {
+        throw outsideError("The output path resolves outside the worktree.");
+    }
+    assertNotSource(target, canonicalTarget, sourcePaths);
+    return { exists: true, isDirectory: stats.isDirectory() };
+}
+function resolveInsideLexically(worktree, relativePath) {
+    const target = path.resolve(worktree, toNativeRelativePath(relativePath));
+    if (!isPathInside(path.resolve(worktree), target)) {
+        throw outsideError("The output path escapes the worktree.");
+    }
+    return target;
+}
+/**
+ * Plans non-conflicting destinations. This is advisory only: the writer still
+ * uses an atomic no-clobber operation to close the check/write race.
+ */
+export async function planOutputPaths(request) {
+    if (request.detectedFormats.length === 0) {
+        return { canonicalWorktree: await realpath(request.worktree), paths: [] };
+    }
+    let canonicalWorktree;
+    try {
+        canonicalWorktree = await realpath(request.worktree);
+    }
+    catch (error) {
+        throw new PluginError("GENIMAGE_OUTPUT_WRITE_FAILED", "The OpenCode worktree could not be resolved.", { cause: error });
+    }
+    const outputDirectory = assertSafeOutputRelativePath(request.outputDirectory, "directory");
+    const requestedOutput = request.outputPath === undefined
+        ? undefined
+        : assertSafeOutputRelativePath(request.outputPath);
+    const basePath = requestedOutput ??
+        `${outputDirectory.replace(/\/$/u, "")}/generated-${utcTimestamp(request.now ?? new Date())}-${safeShortId(request.randomId)}`;
+    const sourcePaths = await canonicalizeSourcePaths(request.worktree, request.sourcePaths ?? []);
+    // An explicit path naming a source is forbidden even when multi-image
+    // suffixing would otherwise make the eventual paths different.
+    if (requestedOutput !== undefined) {
+        const requestedAbsolute = resolveInsideLexically(request.worktree, requestedOutput);
+        let canonicalRequested;
+        try {
+            canonicalRequested = await realpath(requestedAbsolute);
+            const requestedStats = await lstat(requestedAbsolute);
+            if (requestedStats.isDirectory()) {
+                throw pathError("The output path points to an existing directory.");
+            }
+        }
+        catch (error) {
+            if (error instanceof PluginError)
+                throw error;
+            if (!pathExistsError(error)) {
+                throw new PluginError("GENIMAGE_OUTPUT_WRITE_FAILED", "The requested output path could not be inspected.", { cause: error });
+            }
+        }
+        assertNotSource(requestedAbsolute, canonicalRequested, sourcePaths);
+    }
+    const planned = [];
+    const reserved = new Set();
+    for (const [index, detected] of request.detectedFormats.entries()) {
+        const corrected = replaceWithActualExtension(basePath, detected);
+        const ordinal = addOrdinalSuffix(corrected.relativePath, index, request.detectedFormats.length);
+        let selected = false;
+        for (let collision = 1; collision < Number.MAX_SAFE_INTEGER; collision += 1) {
+            const relativePath = collision === 1 ? ordinal : addCollisionSuffix(ordinal, collision);
+            const absolutePath = resolveInsideLexically(request.worktree, relativePath);
+            await assertOutputParentContained(canonicalWorktree, path.dirname(absolutePath));
+            const inspection = await inspectTarget(absolutePath, canonicalWorktree, sourcePaths);
+            if (inspection.isDirectory) {
+                throw pathError("The output path points to an existing directory.");
+            }
+            const key = process.platform === "win32" ? absolutePath.toLowerCase() : absolutePath;
+            if (!inspection.exists && !reserved.has(key)) {
+                reserved.add(key);
+                planned.push({
+                    absolutePath,
+                    relativePath: portableRelativePath(path.relative(request.worktree, absolutePath)),
+                    filename: path.basename(absolutePath),
+                    warnings: corrected.warning === undefined ? [] : [corrected.warning],
+                    collisionBaseRelativePath: ordinal,
+                    collisionNumber: collision,
+                });
+                selected = true;
+                break;
+            }
+        }
+        if (!selected) {
+            throw new PluginError("GENIMAGE_OUTPUT_WRITE_FAILED", "No available output filename could be selected.");
+        }
+    }
+    return { canonicalWorktree, paths: planned };
+}
+//# sourceMappingURL=paths.js.map

package/dist/output/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/output/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AACzD,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,EACL,YAAY,EACZ,iBAAiB,GAClB,MAAM,gCAAgC,CAAA;AACvC,OAAO,EACL,mBAAmB,GAEpB,MAAM,0BAA0B,CAAA;AA2BjC,MAAM,oBAAoB,GAAG,aAAa,CAAA;AAC1C,MAAM,kBAAkB,GAAG,iBAAiB,CAAA;AAE5C,SAAS,SAAS,CAAC,OAAe;IAChC,OAAO,IAAI,WAAW,CAAC,8BAA8B,EAAE,OAAO,CAAC,CAAA;AACjE,CAAC;AAED,SAAS,YAAY,CAAC,OAAe,EAAE,KAAe;IACpD,OAAO,IAAI,WAAW,CAAC,kCAAkC,EAAE,OAAO,EAAE;QAClE,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;KAC1C,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAa;IACxC,OAAO,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;AACpC,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAa;IACzC,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC7D,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAa;IACzC,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACxC,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAa;IAC7C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;QACxC,IAAI,QAAQ,IAAI,IAAI,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,IAAI,CAAA;IACxD,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACd,KAA4B,CAAC,IAAI,KAAK,QAAQ,CAChD,CAAA;AACH,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,4BAA4B,CAC1C,KAAa,EACb,OAA6B,MAAM;IAEnC,MAAM,QAAQ,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAA;IAC3C,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACpC,IACE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;QACnB,wBAAwB,CAAC,KAAK,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC;QAC5B,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC;QAChC,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,EAC9B,CAAC;QACD,MAAM,SAAS,CAAC,yDAAyD,CAAC,CAAA;IAC5E,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,MAAM,YAAY,CAAC,wDAAwD,CAAC,CAAA;IAC9E,CAAC;IACD,IACE,IAAI,KAAK,MAAM;QACf,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,EAC7E,CAAC;QACD,MAAM,SAAS,CAAC,oDAAoD,CAAC,CAAA;IACvE,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACd,KAA4B,CAAC,IAAI,KAAK,QAAQ,CAChD,CAAA;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,KAAa;IAC7D,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IACjC,IAAI,gBAAgB,GAAG,KAAK,CAAA;IAC5B,OAAO,CAAC,gBAAgB,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,OAAO,CAAC,CAAA;YACpB,OAAO,OAAO,CAAA;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC;gBAAE,MAAM,KAAK,CAAA;QAC1C,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QACpC,gBAAgB,GAAG,MAAM,KAAK,OAAO,CAAA;QACrC,OAAO,GAAG,MAAM,CAAA;IAClB,CAAC;IACD,MAAM,YAAY,CAAC,wCAAwC,CAAC,CAAA;AAC9D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,iBAAyB,EACzB,MAAc;IAEd,IAAI,QAAgB,CAAA;IACpB,IAAI,iBAAyB,CAAA;IAC7B,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,2BAA2B,CAAC,MAAM,CAAC,CAAA;QACpD,iBAAiB,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAC9C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,WAAW;YAAE,MAAM,KAAK,CAAA;QAC7C,MAAM,IAAI,WAAW,CACnB,8BAA8B,EAC9B,8CAA8C,EAC9C,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAA;IACH,CAAC;IACD,IAAI,CAAC,YAAY,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,EAAE,CAAC;QACxD,MAAM,YAAY,CAAC,qDAAqD,CAAC,CAAA;IAC3E,CAAC;AACH,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,iBAAyB,EACzB,MAAc;IAEd,MAAM,2BAA2B,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAA;IAC5D,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QACxC,MAAM,eAAe,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAA;QAC9C,IAAI,CAAC,YAAY,CAAC,iBAAiB,EAAE,eAAe,CAAC,EAAE,CAAC;YACtD,MAAM,YAAY,CAAC,qDAAqD,CAAC,CAAA;QAC3E,CAAC;QACD,OAAO,eAAe,CAAA;IACxB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,WAAW;YAAE,MAAM,KAAK,CAAA;QAC7C,MAAM,IAAI,WAAW,CACnB,8BAA8B,EAC9B,4CAA4C,EAC5C,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAA;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,iBAAyB,EACzB,MAAc;IAEd,IAAI,eAAuB,CAAA;IAC3B,IAAI,CAAC;QACH,eAAe,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAA;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,WAAW,CACnB,8BAA8B,EAC9B,gEAAgE,EAChE,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAA;IACH,CAAC;IACD,IAAI,CAAC,YAAY,CAAC,iBAAiB,EAAE,eAAe,CAAC,EAAE,CAAC;QACtD,MAAM,YAAY,CAAC,6DAA6D,CAAC,CAAA;IACnF,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,KAAW;IAC/B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,0BAA0B,CAAC,CAAA;IACtF,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;AACrF,CAAC;AAED,SAAS,WAAW,CAAC,QAAoC;IACvD,MAAM,QAAQ,GAAG,QAAQ,EAAE,EAAE,CAAA;IAC7B,MAAM,UAAU,GAAG,QAAQ,EAAE,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IACzE,OAAO,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,EAAE;QAClD,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;QAChC,CAAC,CAAC,UAAU,CAAA;AAChB,CAAC;AAED,SAAS,0BAA0B,CACjC,YAAoB,EACpB,QAA6B;IAE7B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;IAC7C,MAAM,eAAe,GAAG,mBAAmB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IACvD,IAAI,eAAe,KAAK,QAAQ,CAAC,MAAM;QAAE,OAAO,EAAE,YAAY,EAAE,CAAA;IAEhE,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAC/B,MAAM,CAAC,GAAG,EACV,GAAG,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAC,SAAS,EAAE,CACzE,CAAA;IACD,IAAI,MAAM,CAAC,GAAG,KAAK,EAAE;QAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,CAAA;IACzD,OAAO;QACL,YAAY,EAAE,SAAS;QACvB,OAAO,EAAE,oBAAoB,MAAM,CAAC,GAAG,+BAA+B,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,iCAAiC,QAAQ,CAAC,SAAS,GAAG;KAC1J,CAAA;AACH,CAAC;AAED,SAAS,gBAAgB,CACvB,YAAoB,EACpB,KAAa,EACb,KAAa;IAEb,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,YAAY,CAAA;IACpC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;IAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAA;IAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CACpB,MAAM,CAAC,GAAG,EACV,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,EAAE,CACxE,CAAA;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,YAAoB,EAAE,SAAiB;IACxE,IAAI,SAAS,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,SAAS,CAAC,+CAA+C,CAAC,CAAA;IACtE,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;IAC7C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,IAAI,IAAI,SAAS,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC,CAAA;AAChF,CAAC;AAED,KAAK,UAAU,uBAAuB,CACpC,QAAgB,EAChB,WAA8B;IAE9B,OAAO,OAAO,CAAC,GAAG,CAChB,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QAChG,IAAI,CAAC;YACH,OAAO,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAA;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,QAAQ,CAAA;QACjB,CAAC;IACH,CAAC,CAAC,CACH,CAAA;AACH,CAAC;AAED,SAAS,eAAe,CACtB,MAAc,EACd,eAAmC,EACnC,WAA8B;IAE9B,IACE,WAAW,CAAC,IAAI,CACd,CAAC,MAAM,EAAE,EAAE,CACT,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC;QACjC,CAAC,eAAe,KAAK,SAAS,IAAI,iBAAiB,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAChF,EACD,CAAC;QACD,MAAM,IAAI,WAAW,CACnB,qCAAqC,EACrC,mDAAmD,CACpD,CAAA;IACH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,MAAc,EACd,iBAAyB,EACzB,WAA8B;IAE9B,IAAI,KAAK,CAAA;IACT,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,CAAA;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,CAAC,CAAA;YAC/C,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,CAAA;QAC9C,CAAC;QACD,MAAM,IAAI,WAAW,CACnB,8BAA8B,EAC9B,yCAAyC,EACzC,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAA;IACH,CAAC;IAED,IAAI,eAAuB,CAAA;IAC3B,IAAI,CAAC;QACH,eAAe,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAA;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,WAAW,CACnB,8BAA8B,EAC9B,iDAAiD,EACjD,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAA;IACH,CAAC;IACD,IAAI,CAAC,YAAY,CAAC,iBAAiB,EAAE,eAAe,CAAC,EAAE,CAAC;QACtD,MAAM,YAAY,CAAC,gDAAgD,CAAC,CAAA;IACtE,CAAC;IACD,eAAe,CAAC,MAAM,EAAE,eAAe,EAAE,WAAW,CAAC,CAAA;IACrD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,EAAE,CAAA;AAC3D,CAAC;AAED,SAAS,sBAAsB,CAAC,QAAgB,EAAE,YAAoB;IACpE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,oBAAoB,CAAC,YAAY,CAAC,CAAC,CAAA;IACzE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC;QAClD,MAAM,YAAY,CAAC,uCAAuC,CAAC,CAAA;IAC7D,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAA0B;IAE1B,IAAI,OAAO,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;IAC3E,CAAC;IAED,IAAI,iBAAyB,CAAA;IAC7B,IAAI,CAAC;QACH,iBAAiB,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;IACtD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,WAAW,CACnB,8BAA8B,EAC9B,8CAA8C,EAC9C,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAA;IACH,CAAC;IAED,MAAM,eAAe,GAAG,4BAA4B,CAClD,OAAO,CAAC,eAAe,EACvB,WAAW,CACZ,CAAA;IACD,MAAM,eAAe,GACnB,OAAO,CAAC,UAAU,KAAK,SAAS;QAC9B,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,4BAA4B,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;IACtD,MAAM,QAAQ,GACZ,eAAe;QACf,GAAG,eAAe,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,cAAc,YAAY,CAAC,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,IAAI,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAA;IAChI,MAAM,WAAW,GAAG,MAAM,uBAAuB,CAC/C,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,WAAW,IAAI,EAAE,CAC1B,CAAA;IAED,sEAAsE;IACtE,+DAA+D;IAC/D,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,iBAAiB,GAAG,sBAAsB,CAAC,OAAO,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAA;QACnF,IAAI,kBAAsC,CAAA;QAC1C,IAAI,CAAC;YACH,kBAAkB,GAAG,MAAM,QAAQ,CAAC,iBAAiB,CAAC,CAAA;YACtD,MAAM,cAAc,GAAG,MAAM,KAAK,CAAC,iBAAiB,CAAC,CAAA;YACrD,IAAI,cAAc,CAAC,WAAW,EAAE,EAAE,CAAC;gBACjC,MAAM,SAAS,CAAC,kDAAkD,CAAC,CAAA;YACrE,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,WAAW;gBAAE,MAAM,KAAK,CAAA;YAC7C,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5B,MAAM,IAAI,WAAW,CACnB,8BAA8B,EAC9B,mDAAmD,EACnD,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAA;YACH,CAAC;QACH,CAAC;QACD,eAAe,CAAC,iBAAiB,EAAE,kBAAkB,EAAE,WAAW,CAAC,CAAA;IACrE,CAAC;IAED,MAAM,OAAO,GAAwB,EAAE,CAAA;IACvC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAA;IAClC,KAAK,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,OAAO,CAAC,eAAe,CAAC,OAAO,EAAE,EAAE,CAAC;QAClE,MAAM,SAAS,GAAG,0BAA0B,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;QAChE,MAAM,OAAO,GAAG,gBAAgB,CAC9B,SAAS,CAAC,YAAY,EACtB,KAAK,EACL,OAAO,CAAC,eAAe,CAAC,MAAM,CAC/B,CAAA;QACD,IAAI,QAAQ,GAAG,KAAK,CAAA;QACpB,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC,gBAAgB,EAAE,SAAS,IAAI,CAAC,EAAE,CAAC;YAC5E,MAAM,YAAY,GAChB,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;YACpE,MAAM,YAAY,GAAG,sBAAsB,CAAC,OAAO,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAA;YAC3E,MAAM,2BAA2B,CAAC,iBAAiB,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAA;YAChF,MAAM,UAAU,GAAG,MAAM,aAAa,CACpC,YAAY,EACZ,iBAAiB,EACjB,WAAW,CACZ,CAAA;YACD,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC;gBAC3B,MAAM,SAAS,CAAC,kDAAkD,CAAC,CAAA;YACrE,CAAC;YACD,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,YAAY,CAAA;YACpF,IAAI,CAAC,UAAU,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC7C,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;gBACjB,OAAO,CAAC,IAAI,CAAC;oBACX,YAAY;oBACZ,YAAY,EAAE,oBAAoB,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;oBACjF,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;oBACrC,QAAQ,EACN,SAAS,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC;oBAC5D,yBAAyB,EAAE,OAAO;oBAClC,eAAe,EAAE,SAAS;iBAC3B,CAAC,CAAA;gBACF,QAAQ,GAAG,IAAI,CAAA;gBACf,MAAK;YACP,CAAC;QACH,CAAC;QACD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,WAAW,CACnB,8BAA8B,EAC9B,iDAAiD,CAClD,CAAA;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,OAAO,EAAE,CAAA;AAC9C,CAAC"}

package/dist/output/writer.d.ts

@@ -0,0 +1,33 @@
+import { PluginError } from "../openrouter/errors.js";
+import { type DetectedImageFormat } from "../references/formats.js";
+import type { ValidatedImage } from "./formats.js";
+export interface SaveImagesOptions {
+    images: readonly ValidatedImage[];
+    outputPath?: string | undefined;
+    outputDirectory: string;
+    worktree: string;
+    sourcePaths?: readonly string[] | undefined;
+    signal?: AbortSignal | undefined;
+    now?: Date | undefined;
+    randomId?: (() => string) | undefined;
+}
+export interface SavedImage {
+    absolutePath: string;
+    relativePath: string;
+    filename: string;
+    mime: DetectedImageFormat["mime"];
+    bytes: number;
+    data: Buffer;
+    detected: DetectedImageFormat;
+    warnings: string[];
+}
+export declare class ImageSaveError extends PluginError {
+    readonly savedImages: readonly SavedImage[];
+    constructor(error: PluginError, savedImages: readonly SavedImage[]);
+}
+/**
+ * Saves validated images in response order. If a later write fails, the thrown
+ * ImageSaveError exposes already published images for partial-success handling.
+ */
+export declare function saveImages(options: SaveImagesOptions): Promise<SavedImage[]>;
+//# sourceMappingURL=writer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../src/output/writer.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAiB,MAAM,yBAAyB,CAAA;AACpE,OAAO,EAAqB,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAEtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAUlD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAA;IACjC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,eAAe,EAAE,MAAM,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;IAC3C,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;IAChC,GAAG,CAAC,EAAE,IAAI,GAAG,SAAS,CAAA;IACtB,QAAQ,CAAC,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,CAAA;CACtC;AAED,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,mBAAmB,CAAC,MAAM,CAAC,CAAA;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,mBAAmB,CAAA;IAC7B,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,qBAAa,cAAe,SAAQ,WAAW;IAC7C,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAA;gBAE/B,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,UAAU,EAAE;CAYnE;AA8ID;;;GAGG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAiDlF"}

package/dist/output/writer.js

@@ -0,0 +1,176 @@
+import { randomUUID } from "node:crypto";
+import { link, open, unlink } from "node:fs/promises";
+import path from "node:path";
+import { PluginError, isPluginError } from "../openrouter/errors.js";
+import { detectImageFormat } from "../references/formats.js";
+import { isAbortError, throwIfAborted } from "../utils/abort.js";
+import { addCollisionSuffix, ensureSafeOutputParent, isExistingPathError, planOutputPaths, recheckSafeOutputParent, } from "./paths.js";
+export class ImageSaveError extends PluginError {
+    savedImages;
+    constructor(error, savedImages) {
+        super(error.code, error.message, {
+            details: {
+                ...(error.details ?? {}),
+                savedCount: savedImages.length,
+            },
+            ...(error.suggestion === undefined ? {} : { suggestion: error.suggestion }),
+            cause: error,
+        });
+        this.name = "ImageSaveError";
+        this.savedImages = [...savedImages];
+    }
+}
+const NEVER_ABORTED = new AbortController().signal;
+function outputWriteError(message, cause) {
+    return new PluginError("GENIMAGE_OUTPUT_WRITE_FAILED", message, { cause });
+}
+function validatedActualImage(image) {
+    const actual = detectImageFormat(image.bytes);
+    if (actual === undefined) {
+        throw new PluginError("GENIMAGE_IMAGE_INVALID", "An output image failed binary format validation before it was saved.");
+    }
+    const warnings = [...(image.warnings ?? [])];
+    if (actual.format !== image.detected.format) {
+        warnings.push(`Output metadata said ${image.detected.format.toUpperCase()}, but the bytes are ${actual.format.toUpperCase()}; the binary format was used.`);
+    }
+    return { bytes: image.bytes, detected: actual, warnings };
+}
+async function removeTemporaryFile(temporaryPath) {
+    try {
+        await unlink(temporaryPath);
+    }
+    catch (error) {
+        if (typeof error !== "object" ||
+            error === null ||
+            !("code" in error) ||
+            error.code !== "ENOENT") {
+            throw error;
+        }
+    }
+}
+async function writeCompleteTemporaryFile(temporaryPath, bytes, signal) {
+    let handle;
+    try {
+        handle = await open(temporaryPath, "wx", 0o600);
+        throwIfAborted(signal);
+        await handle.writeFile(bytes);
+        throwIfAborted(signal);
+        await handle.sync();
+    }
+    finally {
+        await handle?.close();
+    }
+}
+function withCollision(originalAbsolute, originalRelative, collision) {
+    const relativePath = addCollisionSuffix(originalRelative, collision);
+    const absolutePath = path.resolve(path.dirname(originalAbsolute), path.basename(relativePath));
+    return { absolutePath, relativePath, filename: path.basename(absolutePath) };
+}
+async function publishOne(initial, image, canonicalWorktree, signal) {
+    const lexicalParent = path.dirname(initial.absolutePath);
+    const parent = await ensureSafeOutputParent(canonicalWorktree, lexicalParent);
+    throwIfAborted(signal);
+    const canonicalInitial = {
+        absolutePath: path.join(parent, initial.filename),
+        relativePath: initial.relativePath,
+        filename: initial.filename,
+    };
+    const temporaryPath = path.join(parent, `.${initial.filename}.${randomUUID()}.tmp`);
+    try {
+        await writeCompleteTemporaryFile(temporaryPath, image.bytes, signal);
+        let destination = canonicalInitial;
+        for (let collision = initial.collisionNumber; collision < Number.MAX_SAFE_INTEGER; collision += 1) {
+            throwIfAborted(signal);
+            await recheckSafeOutputParent(canonicalWorktree, parent);
+            try {
+                // Linking a complete same-directory temporary file is atomic and, in
+                // contrast to rename on POSIX, is guaranteed not to replace a target.
+                await link(temporaryPath, destination.absolutePath);
+                try {
+                    await removeTemporaryFile(temporaryPath);
+                }
+                catch {
+                    // Publication succeeded. Cleanup is retried in finally and must not
+                    // turn a complete, visible result into a reported write failure.
+                }
+                return {
+                    absolutePath: destination.absolutePath,
+                    relativePath: destination.relativePath,
+                    filename: destination.filename,
+                    mime: image.detected.mime,
+                    bytes: image.bytes.byteLength,
+                    data: image.bytes,
+                    detected: image.detected,
+                    warnings: [...(image.warnings ?? [])],
+                };
+            }
+            catch (error) {
+                if (!isExistingPathError(error))
+                    throw error;
+                destination = withCollision(canonicalInitial.absolutePath, initial.collisionBaseRelativePath, collision + 1);
+            }
+        }
+        throw new Error("output filename collision limit exhausted");
+    }
+    catch (error) {
+        if (signal.aborted || isAbortError(error))
+            throw error;
+        if (isPluginError(error))
+            throw error;
+        throw outputWriteError("The generated image could not be written atomically.", error);
+    }
+    finally {
+        try {
+            await removeTemporaryFile(temporaryPath);
+        }
+        catch {
+            // The intended final path is either absent or fully published. A failed
+            // cleanup is deliberately not allowed to mask that primary outcome.
+        }
+    }
+}
+/**
+ * Saves validated images in response order. If a later write fails, the thrown
+ * ImageSaveError exposes already published images for partial-success handling.
+ */
+export async function saveImages(options) {
+    const signal = options.signal ?? NEVER_ABORTED;
+    throwIfAborted(signal);
+    if (options.images.length === 0) {
+        throw new PluginError("GENIMAGE_IMAGE_INVALID", "No valid generated images were available to save.");
+    }
+    const images = options.images.map(validatedActualImage);
+    const plan = await planOutputPaths({
+        worktree: options.worktree,
+        outputDirectory: options.outputDirectory,
+        ...(options.outputPath === undefined ? {} : { outputPath: options.outputPath }),
+        detectedFormats: images.map((image) => image.detected),
+        ...(options.sourcePaths === undefined ? {} : { sourcePaths: options.sourcePaths }),
+        ...(options.now === undefined ? {} : { now: options.now }),
+        ...(options.randomId === undefined ? {} : { randomId: options.randomId }),
+    });
+    const saved = [];
+    try {
+        for (const [index, image] of images.entries()) {
+            const destination = plan.paths[index];
+            if (destination === undefined) {
+                throw outputWriteError("An output destination could not be planned.", new Error("missing output path"));
+            }
+            const result = await publishOne(destination, {
+                ...image,
+                warnings: [...(image.warnings ?? []), ...destination.warnings],
+            }, plan.canonicalWorktree, signal);
+            saved.push(result);
+        }
+        return saved;
+    }
+    catch (error) {
+        if (signal.aborted || isAbortError(error))
+            throw error;
+        const pluginError = isPluginError(error)
+            ? error
+            : outputWriteError("The generated image could not be saved.", error);
+        throw new ImageSaveError(pluginError, saved);
+    }
+}
+//# sourceMappingURL=writer.js.map

package/dist/output/writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.js","sourceRoot":"","sources":["../../src/output/writer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AACpE,OAAO,EAAE,iBAAiB,EAA4B,MAAM,0BAA0B,CAAA;AACtF,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAEhE,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,eAAe,EACf,uBAAuB,GAExB,MAAM,YAAY,CAAA;AAwBnB,MAAM,OAAO,cAAe,SAAQ,WAAW;IACpC,WAAW,CAAuB;IAE3C,YAAY,KAAkB,EAAE,WAAkC;QAChE,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE;YAC/B,OAAO,EAAE;gBACP,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;gBACxB,UAAU,EAAE,WAAW,CAAC,MAAM;aAC/B;YACD,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC;YAC3E,KAAK,EAAE,KAAK;SACb,CAAC,CAAA;QACF,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;QAC5B,IAAI,CAAC,WAAW,GAAG,CAAC,GAAG,WAAW,CAAC,CAAA;IACrC,CAAC;CACF;AAED,MAAM,aAAa,GAAG,IAAI,eAAe,EAAE,CAAC,MAAM,CAAA;AAElD,SAAS,gBAAgB,CAAC,OAAe,EAAE,KAAc;IACvD,OAAO,IAAI,WAAW,CAAC,8BAA8B,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;AAC5E,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAqB;IACjD,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAC7C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,WAAW,CACnB,wBAAwB,EACxB,sEAAsE,CACvE,CAAA;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAA;IAC5C,IAAI,MAAM,CAAC,MAAM,KAAK,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC5C,QAAQ,CAAC,IAAI,CACX,wBAAwB,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,uBAAuB,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,+BAA+B,CAC7I,CAAA;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;AAC3D,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,aAAqB;IACtD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,aAAa,CAAC,CAAA;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IACE,OAAO,KAAK,KAAK,QAAQ;YACzB,KAAK,KAAK,IAAI;YACd,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC;YACjB,KAA4B,CAAC,IAAI,KAAK,QAAQ,EAC/C,CAAC;YACD,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,0BAA0B,CACvC,aAAqB,EACrB,KAAa,EACb,MAAmB;IAEnB,IAAI,MAAM,CAAA;IACV,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,IAAI,EAAE,KAAK,CAAC,CAAA;QAC/C,cAAc,CAAC,MAAM,CAAC,CAAA;QACtB,MAAM,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;QAC7B,cAAc,CAAC,MAAM,CAAC,CAAA;QACtB,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;IACrB,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,EAAE,KAAK,EAAE,CAAA;IACvB,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CACpB,gBAAwB,EACxB,gBAAwB,EACxB,SAAiB;IAEjB,MAAM,YAAY,GAAG,kBAAkB,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAA;IACpE,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAA;IAC9F,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAA;AAC9E,CAAC;AAED,KAAK,UAAU,UAAU,CACvB,OAA0B,EAC1B,KAAqB,EACrB,iBAAyB,EACzB,MAAmB;IAEnB,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;IACxD,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,iBAAiB,EAAE,aAAa,CAAC,CAAA;IAC7E,cAAc,CAAC,MAAM,CAAC,CAAA;IAEtB,MAAM,gBAAgB,GAAG;QACvB,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC;QACjD,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAA;IAED,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAC7B,MAAM,EACN,IAAI,OAAO,CAAC,QAAQ,IAAI,UAAU,EAAE,MAAM,CAC3C,CAAA;IACD,IAAI,CAAC;QACH,MAAM,0BAA0B,CAAC,aAAa,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;QACpE,IAAI,WAAW,GAAG,gBAAgB,CAAA;QAClC,KACE,IAAI,SAAS,GAAG,OAAO,CAAC,eAAe,EACvC,SAAS,GAAG,MAAM,CAAC,gBAAgB,EACnC,SAAS,IAAI,CAAC,EACd,CAAC;YACD,cAAc,CAAC,MAAM,CAAC,CAAA;YACtB,MAAM,uBAAuB,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAA;YACxD,IAAI,CAAC;gBACH,qEAAqE;gBACrE,sEAAsE;gBACtE,MAAM,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,YAAY,CAAC,CAAA;gBACnD,IAAI,CAAC;oBACH,MAAM,mBAAmB,CAAC,aAAa,CAAC,CAAA;gBAC1C,CAAC;gBAAC,MAAM,CAAC;oBACP,oEAAoE;oBACpE,iEAAiE;gBACnE,CAAC;gBACD,OAAO;oBACL,YAAY,EAAE,WAAW,CAAC,YAAY;oBACtC,YAAY,EAAE,WAAW,CAAC,YAAY;oBACtC,QAAQ,EAAE,WAAW,CAAC,QAAQ;oBAC9B,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI;oBACzB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,UAAU;oBAC7B,IAAI,EAAE,KAAK,CAAC,KAAK;oBACjB,QAAQ,EAAE,KAAK,CAAC,QAAQ;oBACxB,QAAQ,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;iBACtC,CAAA;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC;oBAAE,MAAM,KAAK,CAAA;gBAC5C,WAAW,GAAG,aAAa,CACzB,gBAAgB,CAAC,YAAY,EAC7B,OAAO,CAAC,yBAAyB,EACjC,SAAS,GAAG,CAAC,CACd,CAAA;YACH,CAAC;QACH,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAA;IAC9D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,MAAM,CAAC,OAAO,IAAI,YAAY,CAAC,KAAK,CAAC;YAAE,MAAM,KAAK,CAAA;QACtD,IAAI,aAAa,CAAC,KAAK,CAAC;YAAE,MAAM,KAAK,CAAA;QACrC,MAAM,gBAAgB,CAAC,sDAAsD,EAAE,KAAK,CAAC,CAAA;IACvF,CAAC;YAAS,CAAC;QACT,IAAI,CAAC;YACH,MAAM,mBAAmB,CAAC,aAAa,CAAC,CAAA;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,wEAAwE;YACxE,oEAAoE;QACtE,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAA0B;IACzD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,aAAa,CAAA;IAC9C,cAAc,CAAC,MAAM,CAAC,CAAA;IACtB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,WAAW,CACnB,wBAAwB,EACxB,mDAAmD,CACpD,CAAA;IACH,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAA;IACvD,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC;QACjC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;QAC/E,eAAe,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC;QACtD,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;QAClF,GAAG,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;QAC1D,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;KAC1E,CAAC,CAAA;IAEF,MAAM,KAAK,GAAiB,EAAE,CAAA;IAC9B,IAAI,CAAC;QACH,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;YAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;YACrC,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;gBAC9B,MAAM,gBAAgB,CACpB,6CAA6C,EAC7C,IAAI,KAAK,CAAC,qBAAqB,CAAC,CACjC,CAAA;YACH,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,UAAU,CAC7B,WAAW,EACX;gBACE,GAAG,KAAK;gBACR,QAAQ,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,GAAG,WAAW,CAAC,QAAQ,CAAC;aAC/D,EACD,IAAI,CAAC,iBAAiB,EACtB,MAAM,CACP,CAAA;YACD,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACpB,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,MAAM,CAAC,OAAO,IAAI,YAAY,CAAC,KAAK,CAAC;YAAE,MAAM,KAAK,CAAA;QACtD,MAAM,WAAW,GAAG,aAAa,CAAC,KAAK,CAAC;YACtC,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,gBAAgB,CAAC,yCAAyC,EAAE,KAAK,CAAC,CAAA;QACtE,MAAM,IAAI,cAAc,CAAC,WAAW,EAAE,KAAK,CAAC,CAAA;IAC9C,CAAC;AACH,CAAC"}

package/dist/references/attachments.d.ts

@@ -0,0 +1,82 @@
+import type { OpenRouterInputReference } from "../openrouter/schemas.js";
+import { type DetectedImageFormat } from "./formats.js";
+import { type ReferenceLimits } from "./limits.js";
+export interface MessageAttachmentReference {
+    type: "message_attachment";
+    index: number;
+}
+export interface ProjectFileReference {
+    type: "project_file";
+    path: string;
+}
+export interface HttpsUrlReference {
+    type: "https_url";
+    url: string;
+}
+export type ImageReference = MessageAttachmentReference | ProjectFileReference | HttpsUrlReference;
+export interface OpenCodeFilePart {
+    type: "file";
+    mime: string;
+    filename?: string;
+    url: string;
+}
+interface OpenCodeMessageData {
+    info: {
+        role: "user" | "assistant";
+        parentID?: string;
+    };
+    parts: Array<OpenCodeFilePart | {
+        type: string;
+        [key: string]: unknown;
+    }>;
+}
+export interface OpenCodeMessageClient {
+    session: {
+        message(options: {
+            path: {
+                id: string;
+                messageID: string;
+            };
+            query?: {
+                directory?: string;
+            };
+            signal?: AbortSignal;
+        }): Promise<{
+            data?: OpenCodeMessageData;
+            error?: unknown;
+        }>;
+    };
+}
+export interface ReferenceToolContext {
+    sessionID: string;
+    messageID: string;
+    directory: string;
+    worktree: string;
+    abort: AbortSignal;
+}
+export interface ResolvedReference {
+    source: ImageReference["type"];
+    openRouterReference: OpenRouterInputReference;
+    byteLength?: number;
+    detected?: DetectedImageFormat;
+    canonicalSourcePath?: string;
+}
+export interface ResolveReferencesOptions {
+    references: readonly ImageReference[] | undefined;
+    context: ReferenceToolContext;
+    client: OpenCodeMessageClient;
+    serverUrl: URL;
+    limits: ReferenceLimits;
+    promptLength: number;
+    fetch?: typeof globalThis.fetch;
+}
+export interface ResolvedReferences {
+    references: ResolvedReference[];
+    inputReferences: OpenRouterInputReference[];
+    canonicalSourcePaths: ReadonlySet<string>;
+    localBytes: number;
+}
+export declare function getCurrentUserImageParts(client: OpenCodeMessageClient, context: ReferenceToolContext): Promise<OpenCodeFilePart[]>;
+export declare function resolveImageReferences(options: ResolveReferencesOptions): Promise<ResolvedReferences>;
+export {};
+//# sourceMappingURL=attachments.d.ts.map

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

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