opencode-img 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Matt Safaii
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,127 @@
+# opencode-img
+
+An OpenCode V2 plugin that generates and edits bitmap images through the OpenAI Image API. One tool, `gpt_imagegen`, takes a prompt and an output path, calls the API with your key, and writes one image to disk.
+
+[![OpenCode V2 plugin](https://img.shields.io/badge/OpenCode-V2%20plugin-blue.svg)](https://opencode.ai/v2/docs/build/plugins)
+[![npm version](https://img.shields.io/npm/v/opencode-img.svg)](https://www.npmjs.com/package/opencode-img)
+[![CI](https://github.com/mattsafaii/opencode-img/actions/workflows/ci.yml/badge.svg)](https://github.com/mattsafaii/opencode-img/actions/workflows/ci.yml)
+[![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
+
+Source: [github.com/mattsafaii/opencode-img](https://github.com/mattsafaii/opencode-img)
+
+**Status:** 0.1.0, early release.
+
+## What it does
+
+- **Generates and edits.** A prompt makes a new image; local `referenceImages` edit an existing one through the real `/v1/images/edits` multipart endpoint.
+- **Never overwrites.** A taken output path gets the next version instead.
+- **Your key, two ways.** The OpenCode connection from `/connect`, or `OPENAI_API_KEY`.
+- **No SDK.** Native `fetch`, `FormData`, and `Blob` only.
+
+## Install
+
+OpenCode installs the package on next launch, so there is no separate install step. Add it with the CLI:
+
+```sh
+opencode plugin add opencode-img
+```
+
+Or add it to `opencode.json`:
+
+```jsonc
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugins": ["opencode-img"]
+}
+```
+
+## Add your OpenAI API key
+
+Connect OpenAI in OpenCode, or set `OPENAI_API_KEY`. When both are present, the environment variable wins.
+
+1. **OpenCode connection (easiest).** Run `/connect`, choose OpenAI, and paste your key. The tool uses that connection with no further setup.
+2. **Environment variable.** Set `OPENAI_API_KEY` in the environment of the OpenCode server before it starts. Use it for headless setups, or when your key lives in the OpenCode Console (BYOK), which plugins cannot read.
+
+A missing key fails before any network request, and the error names both.
+
+A key connected through the OpenCode Console (BYOK) stays in Console and is not available to plugins; set `OPENAI_API_KEY` in that case.
+
+## Use
+
+Ask the agent for what you want, and it calls `gpt_imagegen`:
+
+```text
+Generate a 1024x1024 image of a red square on a white background and save it to assets/square.png.
+```
+
+### Tool arguments
+
+| Argument | Required | Description |
+| --- | --- | --- |
+| `prompt` | yes | What to generate, or the edit to make. |
+| `outputPath` | yes | Where to save the image. Relative paths resolve against the session directory. |
+| `model` | no | OpenAI image model. Defaults to `gpt-image-1.5`. |
+| `quality` | no | `auto`, `low`, `medium`, `high`, `standard`, `hd`, `xhigh`, or `max`. |
+| `size` | no | `WIDTHxHEIGHT` (for example `1024x1024`) or `auto`. |
+| `outputFormat` | no | `png`, `jpeg`, or `webp` for GPT image models. Inferred from the output path extension when omitted. |
+| `referenceImages` | no | Local image paths. When present, the tool edits them through `/v1/images/edits`. |
+
+## Worked examples
+
+### Edit an existing image
+
+Pass local paths in `referenceImages` and the tool edits them.
+
+```text
+Take assets/example-generate.png, change the coffee cup to a teacup, and add a spoon on the saucer. Save it to assets/example-edit.png.
+```
+
+### Generate from a prompt
+
+```text
+Generate a flat vector illustration of a steaming coffee cup on a saucer, two-tone, centered on a plain white background, and save it to assets/example-generate.png.
+```
+
+### Run the same path twice
+
+The first file is left untouched; the new image lands at `example-generate-1.png`.
+
+```text
+Now do the same path, but a slice of cake on a plate instead.
+```
+
+## Output
+
+- One image per request.
+- An existing file is never replaced: `image.png` becomes `image-1.png`, then `image-2.png`.
+- An explicit `outputFormat` must match a known image extension on the path; a conflict is rejected.
+- A failure — a missing key, an unreadable reference image, an API error, or a cancellation — stops before the write, so no file is created.
+- The tool returns the saved path plus metadata: model, MIME type, byte count, and the settings used.
+
+## Disclaimer
+
+opencode-img is an independent project. It is not made by, affiliated with, or endorsed by OpenAI or the OpenCode team. Using the OpenAI Image API is subject to OpenAI's terms and usage policies.
+
+## Development
+
+```sh
+pnpm install
+pnpm test
+pnpm typecheck
+pnpm build
+```
+
+Built and tested on Node 24. OpenCode runs the plugin in its bundled Bun runtime.
+
+To load a local build in OpenCode, point `plugins` at the package's `dist` directory (a configured plugin path must be a directory containing an entry file):
+
+```jsonc
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugins": ["/absolute/path/to/opencode-img/dist"]
+}
+```
+
+Publish with `pnpm publish`, or push a `v*` tag to publish through `.github/workflows/publish.yml`. The workflow uses npm trusted publishing (OIDC), so it needs no token — only a trusted publisher configured for the repository on npmjs.com.
+
+The provider boundary stays internal so another image service can be added later without a public plugin registry.

package/dist/config.d.ts

@@ -0,0 +1,43 @@
+/** The OpenAI image model used when the caller does not name one. */
+export declare const DEFAULT_MODEL = "gpt-image-1.5";
+/** Quality values accepted by the OpenAI Images API. */
+export declare const QUALITY_VALUES: readonly ["auto", "standard", "hd", "low", "medium", "high", "xhigh", "max"];
+/** Output formats accepted by the GPT image models. */
+export declare const OUTPUT_FORMAT_VALUES: readonly ["png", "jpeg", "webp"];
+export type Quality = (typeof QUALITY_VALUES)[number];
+export type OutputFormat = (typeof OUTPUT_FORMAT_VALUES)[number];
+export interface GenerationSettings {
+    model: string;
+    quality?: Quality;
+    size?: string;
+    outputFormat?: OutputFormat;
+}
+export interface GenerationSettingsInput {
+    model?: unknown;
+    quality?: unknown;
+    size?: unknown;
+    outputFormat?: unknown;
+}
+/** True when the model is one of the GPT image models rather than a DALL·E model. */
+export declare function isGptImageModel(model: string): boolean;
+/**
+ * The output format implied by a path's extension, or `undefined` when the
+ * extension is absent or not one the API produces.
+ */
+export declare function outputFormatForExtension(filePath: string): OutputFormat | undefined;
+/**
+ * Validate the optional generation settings and apply the model default.
+ *
+ * Size is checked as a shape (`auto` or `WIDTHxHEIGHT`) rather than a fixed
+ * list so newer models that accept arbitrary resolutions keep working.
+ */
+export declare function resolveSettings(input: GenerationSettingsInput): GenerationSettings;
+/**
+ * Keep the encoded format and the output filename in agreement.
+ *
+ * An explicit `outputFormat` must match a known image extension on the path.
+ * When the format is omitted, a known extension selects it so the bytes never
+ * contradict the name. DALL·E models can only produce PNG.
+ */
+export declare function reconcileOutputFormat(settings: GenerationSettings, targetPath: string): GenerationSettings;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,qEAAqE;AACrE,eAAO,MAAM,aAAa,kBAAkB,CAAA;AAE5C,wDAAwD;AACxD,eAAO,MAAM,cAAc,8EASjB,CAAA;AAEV,uDAAuD;AACvD,eAAO,MAAM,oBAAoB,kCAAmC,CAAA;AAEpE,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;AACrD,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEhE,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,YAAY,CAAA;CAC5B;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAYnF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,uBAAuB,GAAG,kBAAkB,CAsClF;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,kBAAkB,EAC5B,UAAU,EAAE,MAAM,GACjB,kBAAkB,CAuBpB"}

package/dist/config.js

@@ -0,0 +1,99 @@
+import { extname } from "node:path";
+import { invalidArgument, requireNonEmptyString } from "./errors.js";
+/** The OpenAI image model used when the caller does not name one. */
+export const DEFAULT_MODEL = "gpt-image-1.5";
+/** Quality values accepted by the OpenAI Images API. */
+export const QUALITY_VALUES = [
+    "auto",
+    "standard",
+    "hd",
+    "low",
+    "medium",
+    "high",
+    "xhigh",
+    "max",
+];
+/** Output formats accepted by the GPT image models. */
+export const OUTPUT_FORMAT_VALUES = ["png", "jpeg", "webp"];
+/** True when the model is one of the GPT image models rather than a DALL·E model. */
+export function isGptImageModel(model) {
+    return !model.startsWith("dall-e");
+}
+/**
+ * The output format implied by a path's extension, or `undefined` when the
+ * extension is absent or not one the API produces.
+ */
+export function outputFormatForExtension(filePath) {
+    switch (extname(filePath).toLowerCase()) {
+        case ".png":
+            return "png";
+        case ".jpg":
+        case ".jpeg":
+            return "jpeg";
+        case ".webp":
+            return "webp";
+        default:
+            return undefined;
+    }
+}
+/**
+ * Validate the optional generation settings and apply the model default.
+ *
+ * Size is checked as a shape (`auto` or `WIDTHxHEIGHT`) rather than a fixed
+ * list so newer models that accept arbitrary resolutions keep working.
+ */
+export function resolveSettings(input) {
+    const model = input.model === undefined ? DEFAULT_MODEL : requireNonEmptyString(input.model, "model");
+    const settings = { model };
+    if (input.quality !== undefined) {
+        const quality = requireNonEmptyString(input.quality, "quality");
+        if (!QUALITY_VALUES.includes(quality)) {
+            throw invalidArgument(`\`quality\` must be one of ${QUALITY_VALUES.join(", ")}.`);
+        }
+        settings.quality = quality;
+    }
+    if (input.size !== undefined) {
+        const size = requireNonEmptyString(input.size, "size");
+        if (size !== "auto" && !/^\d+x\d+$/.test(size)) {
+            throw invalidArgument("`size` must be `auto` or a `WIDTHxHEIGHT` string such as `1024x1024`.");
+        }
+        settings.size = size;
+    }
+    if (input.outputFormat !== undefined) {
+        const outputFormat = requireNonEmptyString(input.outputFormat, "outputFormat");
+        if (!OUTPUT_FORMAT_VALUES.includes(outputFormat)) {
+            throw invalidArgument(`\`outputFormat\` must be one of ${OUTPUT_FORMAT_VALUES.join(", ")}.`);
+        }
+        if (!isGptImageModel(model)) {
+            throw invalidArgument("`outputFormat` is only supported by the GPT image models; DALL·E models always return PNG.");
+        }
+        settings.outputFormat = outputFormat;
+    }
+    return settings;
+}
+/**
+ * Keep the encoded format and the output filename in agreement.
+ *
+ * An explicit `outputFormat` must match a known image extension on the path.
+ * When the format is omitted, a known extension selects it so the bytes never
+ * contradict the name. DALL·E models can only produce PNG.
+ */
+export function reconcileOutputFormat(settings, targetPath) {
+    const extensionFormat = outputFormatForExtension(targetPath);
+    if (extensionFormat === undefined)
+        return settings;
+    if (settings.outputFormat !== undefined) {
+        if (settings.outputFormat !== extensionFormat) {
+            throw invalidArgument(`\`outputFormat\` is \`${settings.outputFormat}\` but \`outputPath\` ends in \`.${extensionFormat}\`. Align them or drop \`outputFormat\`.`);
+        }
+        return settings;
+    }
+    if (!isGptImageModel(settings.model)) {
+        if (extensionFormat !== "png") {
+            throw invalidArgument(`DALL·E models always return PNG, so \`outputPath\` cannot end in \`.${extensionFormat}\`.`);
+        }
+        return settings;
+    }
+    return { ...settings, outputFormat: extensionFormat };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Error raised by the `gpt_imagegen` tool and its internal image provider.
+ *
+ * Every error names the operation that failed and carries a stable `code` so
+ * callers and tests can branch on the failure without matching message text.
+ * Messages never include the API key or other request credentials.
+ */
+export type ImageToolErrorCode = "missing_api_key" | "invalid_argument" | "invalid_reference" | "api_error" | "malformed_response" | "cancelled" | "write_failed";
+/** The operations the tool and provider report failures against. */
+export type ImageToolOperation = "validate API key" | "validate arguments" | "read reference image" | "generate image" | "edit image" | "decode image response" | "write image file";
+export declare class ImageToolError extends Error {
+    readonly code: ImageToolErrorCode;
+    readonly operation: ImageToolOperation;
+    constructor(code: ImageToolErrorCode, operation: ImageToolOperation, message: string, options?: {
+        cause?: unknown;
+    });
+}
+/** An invalid-argument error with the shared validation operation. */
+export declare function invalidArgument(message: string): ImageToolError;
+/** Return `value` when it is a non-empty string, otherwise fail validation. */
+export declare function requireNonEmptyString(value: unknown, field: string): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAC1B,iBAAiB,GACjB,kBAAkB,GAClB,mBAAmB,GACnB,WAAW,GACX,oBAAoB,GACpB,WAAW,GACX,cAAc,CAAA;AAElB,oEAAoE;AACpE,MAAM,MAAM,kBAAkB,GAC1B,kBAAkB,GAClB,oBAAoB,GACpB,sBAAsB,GACtB,gBAAgB,GAChB,YAAY,GACZ,uBAAuB,GACvB,kBAAkB,CAAA;AAEtB,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAA;IACjC,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAA;gBAGpC,IAAI,EAAE,kBAAkB,EACxB,SAAS,EAAE,kBAAkB,EAC7B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAOhC;AAED,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAE/D;AAED,+EAA+E;AAC/E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAK3E"}

package/dist/errors.js

@@ -0,0 +1,22 @@
+export class ImageToolError extends Error {
+    code;
+    operation;
+    constructor(code, operation, message, options) {
+        super(message, options);
+        this.name = "ImageToolError";
+        this.code = code;
+        this.operation = operation;
+    }
+}
+/** An invalid-argument error with the shared validation operation. */
+export function invalidArgument(message) {
+    return new ImageToolError("invalid_argument", "validate arguments", message);
+}
+/** Return `value` when it is a non-empty string, otherwise fail validation. */
+export function requireNonEmptyString(value, field) {
+    if (typeof value !== "string" || value.trim() === "") {
+        throw invalidArgument(`\`${field}\` must be a non-empty string.`);
+    }
+    return value;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AA0BA,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,IAAI,CAAoB;IACxB,SAAS,CAAoB;IAEtC,YACE,IAAwB,EACxB,SAA6B,EAC7B,OAAe,EACf,OAA6B;QAE7B,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QACvB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;IAC5B,CAAC;CACF;AAED,sEAAsE;AACtE,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,OAAO,IAAI,cAAc,CAAC,kBAAkB,EAAE,oBAAoB,EAAE,OAAO,CAAC,CAAA;AAC9E,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,qBAAqB,CAAC,KAAc,EAAE,KAAa;IACjE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACrD,MAAM,eAAe,CAAC,KAAK,KAAK,gCAAgC,CAAC,CAAA;IACnE,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/image.d.ts

@@ -0,0 +1,20 @@
+import type { OutputFormat } from "./config.ts";
+export interface DecodedImage {
+    data: Uint8Array;
+    revisedPrompt?: string;
+}
+/**
+ * Pull the first image out of an OpenAI Images response.
+ *
+ * GPT image models and DALL·E models configured with `response_format=b64_json`
+ * both return `data[0].b64_json`. The bytes are decoded here and checked for
+ * emptiness so a zero-byte or corrupt payload never reaches the filesystem.
+ */
+export declare function decodeImageResponse(payload: unknown): DecodedImage;
+/** The MIME type OpenAI returns for a given output format. */
+export declare function mimeTypeForOutputFormat(format: OutputFormat | undefined): string;
+/** The MIME type of a reference image, or `undefined` for an unsupported type. */
+export declare function mimeTypeForReferencePath(filePath: string): string | undefined;
+/** The extensions the edits endpoint accepts for reference images. */
+export declare const SUPPORTED_REFERENCE_EXTENSIONS: string[];
+//# sourceMappingURL=image.d.ts.map

package/dist/image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../src/image.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,UAAU,CAAA;IAChB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAYD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,CA6BlE;AAED,8DAA8D;AAC9D,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,CAUhF;AASD,kFAAkF;AAClF,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAI7E;AAED,sEAAsE;AACtE,eAAO,MAAM,8BAA8B,UAAiC,CAAA"}

package/dist/image.js

@@ -0,0 +1,66 @@
+import { ImageToolError } from "./errors.js";
+const BASE64_PATTERN = /^[A-Za-z0-9+/]*={0,2}$/;
+function malformed(detail) {
+    return new ImageToolError("malformed_response", "decode image response", `OpenAI returned image data that could not be read: ${detail}.`);
+}
+/**
+ * Pull the first image out of an OpenAI Images response.
+ *
+ * GPT image models and DALL·E models configured with `response_format=b64_json`
+ * both return `data[0].b64_json`. The bytes are decoded here and checked for
+ * emptiness so a zero-byte or corrupt payload never reaches the filesystem.
+ */
+export function decodeImageResponse(payload) {
+    if (typeof payload !== "object" || payload === null) {
+        throw malformed("the response body was not a JSON object");
+    }
+    const data = payload.data;
+    if (!Array.isArray(data) || data.length === 0) {
+        throw malformed("the response contained no images");
+    }
+    const first = data[0];
+    const encoded = first?.b64_json;
+    if (typeof encoded !== "string" || encoded === "") {
+        throw malformed("the image entry had no base64 payload");
+    }
+    if (encoded.length % 4 !== 0 || !BASE64_PATTERN.test(encoded)) {
+        throw malformed("the base64 payload was not valid base64");
+    }
+    const bytes = Buffer.from(encoded, "base64");
+    if (bytes.byteLength === 0) {
+        throw malformed("the decoded image was empty");
+    }
+    const decoded = { data: bytes };
+    if (typeof first.revised_prompt === "string" && first.revised_prompt !== "") {
+        decoded.revisedPrompt = first.revised_prompt;
+    }
+    return decoded;
+}
+/** The MIME type OpenAI returns for a given output format. */
+export function mimeTypeForOutputFormat(format) {
+    switch (format) {
+        case "jpeg":
+            return "image/jpeg";
+        case "webp":
+            return "image/webp";
+        case "png":
+        case undefined:
+            return "image/png";
+    }
+}
+const MIME_BY_EXTENSION = {
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".webp": "image/webp",
+};
+/** The MIME type of a reference image, or `undefined` for an unsupported type. */
+export function mimeTypeForReferencePath(filePath) {
+    const dot = filePath.lastIndexOf(".");
+    if (dot === -1)
+        return undefined;
+    return MIME_BY_EXTENSION[filePath.slice(dot).toLowerCase()];
+}
+/** The extensions the edits endpoint accepts for reference images. */
+export const SUPPORTED_REFERENCE_EXTENSIONS = Object.keys(MIME_BY_EXTENSION);
+//# sourceMappingURL=image.js.map

package/dist/image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.js","sourceRoot":"","sources":["../src/image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAQ5C,MAAM,cAAc,GAAG,wBAAwB,CAAA;AAE/C,SAAS,SAAS,CAAC,MAAc;IAC/B,OAAO,IAAI,cAAc,CACvB,oBAAoB,EACpB,uBAAuB,EACvB,sDAAsD,MAAM,GAAG,CAChE,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACpD,MAAM,SAAS,CAAC,yCAAyC,CAAC,CAAA;IAC5D,CAAC;IAED,MAAM,IAAI,GAAI,OAA8B,CAAC,IAAI,CAAA;IACjD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9C,MAAM,SAAS,CAAC,kCAAkC,CAAC,CAAA;IACrD,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAqD,CAAA;IACzE,MAAM,OAAO,GAAG,KAAK,EAAE,QAAQ,CAAA;IAC/B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QAClD,MAAM,SAAS,CAAC,uCAAuC,CAAC,CAAA;IAC1D,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9D,MAAM,SAAS,CAAC,yCAAyC,CAAC,CAAA;IAC5D,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;IAC5C,IAAI,KAAK,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,SAAS,CAAC,6BAA6B,CAAC,CAAA;IAChD,CAAC;IAED,MAAM,OAAO,GAAiB,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;IAC7C,IAAI,OAAO,KAAK,CAAC,cAAc,KAAK,QAAQ,IAAI,KAAK,CAAC,cAAc,KAAK,EAAE,EAAE,CAAC;QAC5E,OAAO,CAAC,aAAa,GAAG,KAAK,CAAC,cAAc,CAAA;IAC9C,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,uBAAuB,CAAC,MAAgC;IACtE,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,MAAM;YACT,OAAO,YAAY,CAAA;QACrB,KAAK,MAAM;YACT,OAAO,YAAY,CAAA;QACrB,KAAK,KAAK,CAAC;QACX,KAAK,SAAS;YACZ,OAAO,WAAW,CAAA;IACtB,CAAC;AACH,CAAC;AAED,MAAM,iBAAiB,GAAqC;IAC1D,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,YAAY;IACrB,OAAO,EAAE,YAAY;CACtB,CAAA;AAED,kFAAkF;AAClF,MAAM,UAAU,wBAAwB,CAAC,QAAgB;IACvD,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;IACrC,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,OAAO,SAAS,CAAA;IAChC,OAAO,iBAAiB,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAA;AAC7D,CAAC;AAED,sEAAsE;AACtE,MAAM,CAAC,MAAM,8BAA8B,GAAG,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import { Plugin } from "@opencode/plugin";
+/**
+ * opencode-img — an OpenCode V2 plugin that adds the `gpt_imagegen` tool.
+ *
+ * Relative output and reference-image paths resolve against the session
+ * directory. The OpenAI API key comes from `OPENAI_API_KEY`, then the OpenAI
+ * connection the user made with `/connect`.
+ */
+declare const _default: Plugin.Plugin;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAMzC;;;;;;GAMG;;AACH,wBAuBE"}

package/dist/index.js

@@ -0,0 +1,35 @@
+import { Plugin } from "@opencode/plugin";
+import { createGptImagegenTool } from "./tool.js";
+/** OpenCode's built-in integration id for OpenAI. */
+const OPENAI_INTEGRATION_ID = "openai";
+/**
+ * opencode-img — an OpenCode V2 plugin that adds the `gpt_imagegen` tool.
+ *
+ * Relative output and reference-image paths resolve against the session
+ * directory. The OpenAI API key comes from `OPENAI_API_KEY`, then the OpenAI
+ * connection the user made with `/connect`.
+ */
+export default Plugin.define({
+    id: "opencode-img",
+    async setup(ctx) {
+        await ctx.tool.transform((editor) => {
+            editor.add(createGptImagegenTool({
+                resolveSessionDirectory: async (sessionID) => {
+                    const session = await ctx.session.get({ sessionID });
+                    return session.location.directory;
+                },
+                resolveApiKey: async () => {
+                    const connection = await ctx.integration.connection.active(OPENAI_INTEGRATION_ID);
+                    if (!connection)
+                        return undefined;
+                    const credential = await ctx.integration.connection.resolve(connection);
+                    if (credential?.type === "key" && typeof credential.key === "string") {
+                        return credential.key;
+                    }
+                    return undefined;
+                },
+            }));
+        });
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAA;AAEjD,qDAAqD;AACrD,MAAM,qBAAqB,GAAG,QAAQ,CAAA;AAEtC;;;;;;GAMG;AACH,eAAe,MAAM,CAAC,MAAM,CAAC;IAC3B,EAAE,EAAE,cAAc;IAClB,KAAK,CAAC,KAAK,CAAC,GAAG;QACb,MAAM,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE;YAClC,MAAM,CAAC,GAAG,CACR,qBAAqB,CAAC;gBACpB,uBAAuB,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;oBAC3C,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,CAAC,CAAA;oBACpD,OAAO,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAA;gBACnC,CAAC;gBACD,aAAa,EAAE,KAAK,IAAI,EAAE;oBACxB,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAA;oBACjF,IAAI,CAAC,UAAU;wBAAE,OAAO,SAAS,CAAA;oBACjC,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;oBACvE,IAAI,UAAU,EAAE,IAAI,KAAK,KAAK,IAAI,OAAO,UAAU,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;wBACrE,OAAO,UAAU,CAAC,GAAG,CAAA;oBACvB,CAAC;oBACD,OAAO,SAAS,CAAA;gBAClB,CAAC;aACF,CAAC,CACH,CAAA;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;CACF,CAAC,CAAA"}

package/dist/openai-provider.d.ts

@@ -0,0 +1,16 @@
+import type { ImageProvider } from "./provider.ts";
+export declare const DEFAULT_BASE_URL = "https://api.openai.com/v1";
+export interface OpenAIImageProviderOptions {
+    apiKey: string;
+    baseUrl?: string;
+    fetch?: typeof globalThis.fetch;
+}
+/**
+ * Create the OpenAI adapter for the internal {@link ImageProvider} seam.
+ *
+ * With no reference images the request goes to `/images/generations` as JSON.
+ * With reference images it becomes a multipart request to `/images/edits` and
+ * every image is attached under the `image[]` field.
+ */
+export declare function createOpenAIImageProvider(options: OpenAIImageProviderOptions): ImageProvider;
+//# sourceMappingURL=openai-provider.d.ts.map

package/dist/openai-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-provider.d.ts","sourceRoot":"","sources":["../src/openai-provider.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAA6B,MAAM,eAAe,CAAA;AAE7E,eAAO,MAAM,gBAAgB,8BAA8B,CAAA;AAE3D,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAChC;AA8DD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,0BAA0B,GAClC,aAAa,CAiFf"}

package/dist/openai-provider.js

@@ -0,0 +1,132 @@
+import { isGptImageModel } from "./config.js";
+import { ImageToolError } from "./errors.js";
+import { decodeImageResponse, mimeTypeForOutputFormat } from "./image.js";
+export const DEFAULT_BASE_URL = "https://api.openai.com/v1";
+const MAX_ERROR_DETAIL = 500;
+function isAbort(error, signal) {
+    return ((error instanceof Error && error.name === "AbortError") || signal?.aborted === true);
+}
+function safeErrorDetail(body) {
+    const trimmed = body.trim();
+    if (trimmed === "")
+        return "no response body";
+    try {
+        const parsed = JSON.parse(trimmed);
+        const message = parsed.error?.message;
+        if (typeof message === "string" && message !== "") {
+            return message.slice(0, MAX_ERROR_DETAIL);
+        }
+    }
+    catch {
+        // Not JSON; fall through to the raw text.
+    }
+    return trimmed.slice(0, MAX_ERROR_DETAIL);
+}
+/**
+ * The settings the request carries, as ordered field/value pairs. One mapping
+ * feeds both the JSON generation body and the multipart edit form, so adding a
+ * setting means editing this list once.
+ */
+function requestFields(request) {
+    const { model, quality, size, outputFormat } = request.settings;
+    const fields = [
+        ["model", model],
+        ["prompt", request.prompt],
+        ["n", 1],
+    ];
+    if (quality !== undefined)
+        fields.push(["quality", quality]);
+    if (size !== undefined)
+        fields.push(["size", size]);
+    if (isGptImageModel(model)) {
+        if (outputFormat !== undefined)
+            fields.push(["output_format", outputFormat]);
+    }
+    else {
+        // DALL·E models default to a URL; ask for base64 so one decode path serves both.
+        fields.push(["response_format", "b64_json"]);
+    }
+    return fields;
+}
+function buildGenerationBody(request) {
+    return Object.fromEntries(requestFields(request));
+}
+function buildEditForm(request) {
+    const form = new FormData();
+    for (const [key, value] of requestFields(request))
+        form.set(key, String(value));
+    for (const reference of request.references ?? []) {
+        const blob = new Blob([reference.data], { type: reference.mimeType });
+        form.append("image[]", blob, reference.filename);
+    }
+    return form;
+}
+/**
+ * Create the OpenAI adapter for the internal {@link ImageProvider} seam.
+ *
+ * With no reference images the request goes to `/images/generations` as JSON.
+ * With reference images it becomes a multipart request to `/images/edits` and
+ * every image is attached under the `image[]` field.
+ */
+export function createOpenAIImageProvider(options) {
+    const apiKey = options.apiKey;
+    const baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    const fetchImpl = options.fetch ?? globalThis.fetch;
+    async function send(request, operation, signal) {
+        const hasReferences = (request.references?.length ?? 0) > 0;
+        const url = hasReferences ? `${baseUrl}/images/edits` : `${baseUrl}/images/generations`;
+        let response;
+        try {
+            response = hasReferences
+                ? await fetchImpl(url, {
+                    method: "POST",
+                    headers: { Authorization: `Bearer ${apiKey}` },
+                    body: buildEditForm(request),
+                    signal,
+                })
+                : await fetchImpl(url, {
+                    method: "POST",
+                    headers: {
+                        Authorization: `Bearer ${apiKey}`,
+                        "Content-Type": "application/json",
+                    },
+                    body: JSON.stringify(buildGenerationBody(request)),
+                    signal,
+                });
+        }
+        catch (error) {
+            if (isAbort(error, signal)) {
+                throw new ImageToolError("cancelled", operation, "The image request was cancelled.", {
+                    cause: error,
+                });
+            }
+            throw new ImageToolError("api_error", operation, `Could not reach OpenAI while trying to ${operation}: ${error.message}.`, { cause: error });
+        }
+        if (!response.ok) {
+            const detail = safeErrorDetail(await response.text().catch(() => ""));
+            throw new ImageToolError("api_error", operation, `OpenAI returned HTTP ${response.status} while trying to ${operation}: ${detail}`);
+        }
+        let payload;
+        try {
+            payload = await response.json();
+        }
+        catch (error) {
+            throw new ImageToolError("malformed_response", operation, "OpenAI returned a response body that was not valid JSON.", { cause: error });
+        }
+        const decoded = decodeImageResponse(payload);
+        const result = {
+            data: decoded.data,
+            mimeType: mimeTypeForOutputFormat(request.settings.outputFormat),
+        };
+        if (decoded.revisedPrompt !== undefined)
+            result.revisedPrompt = decoded.revisedPrompt;
+        return result;
+    }
+    return {
+        generate(request, signal) {
+            const hasReferences = (request.references?.length ?? 0) > 0;
+            return send(request, hasReferences ? "edit image" : "generate image", signal);
+        },
+    };
+}
+//# sourceMappingURL=openai-provider.js.map

package/dist/openai-provider.js.map

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

package/dist/paths.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Resolve a requested output path against the OpenCode session directory.
+ * Absolute paths are returned unchanged.
+ */
+export declare function resolveOutputPath(requested: string, sessionDirectory: string): string;
+/**
+ * Return the first path at or after `filePath` that does not yet exist.
+ * `report.png` becomes `report-1.png`, then `report-2.png`, and so on.
+ */
+export declare function chooseAvailablePath(filePath: string): Promise<string>;
+/**
+ * Write the image at the first available path without replacing an existing
+ * file. Uses the exclusive-create flag so a concurrent writer cannot be
+ * overwritten; a collision advances to the next versioned name.
+ */
+export declare function writeImageWithoutOverwrite(targetPath: string, data: Uint8Array): Promise<string>;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAErF;AAiBD;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM3E;AAED;;;;GAIG;AACH,wBAAsB,0BAA0B,CAC9C,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,MAAM,CAAC,CAyBjB"}

package/dist/paths.js

@@ -0,0 +1,62 @@
+import { constants } from "node:fs";
+import { access, mkdir, writeFile } from "node:fs/promises";
+import { dirname, extname, isAbsolute, resolve } from "node:path";
+import { ImageToolError } from "./errors.js";
+/**
+ * Resolve a requested output path against the OpenCode session directory.
+ * Absolute paths are returned unchanged.
+ */
+export function resolveOutputPath(requested, sessionDirectory) {
+    return isAbsolute(requested) ? requested : resolve(sessionDirectory, requested);
+}
+async function exists(filePath) {
+    try {
+        await access(filePath, constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function versionedPath(filePath, version) {
+    const extension = extname(filePath);
+    const base = extension === "" ? filePath : filePath.slice(0, -extension.length);
+    return `${base}-${version}${extension}`;
+}
+/**
+ * Return the first path at or after `filePath` that does not yet exist.
+ * `report.png` becomes `report-1.png`, then `report-2.png`, and so on.
+ */
+export async function chooseAvailablePath(filePath) {
+    if (!(await exists(filePath)))
+        return filePath;
+    for (let version = 1;; version += 1) {
+        const candidate = versionedPath(filePath, version);
+        if (!(await exists(candidate)))
+            return candidate;
+    }
+}
+/**
+ * Write the image at the first available path without replacing an existing
+ * file. Uses the exclusive-create flag so a concurrent writer cannot be
+ * overwritten; a collision advances to the next versioned name.
+ */
+export async function writeImageWithoutOverwrite(targetPath, data) {
+    let candidate = await chooseAvailablePath(targetPath);
+    for (let attempt = 0; attempt < 1000; attempt += 1) {
+        try {
+            await mkdir(dirname(candidate), { recursive: true });
+            await writeFile(candidate, data, { flag: "wx" });
+            return candidate;
+        }
+        catch (error) {
+            if (error.code === "EEXIST") {
+                candidate = await chooseAvailablePath(candidate);
+                continue;
+            }
+            throw new ImageToolError("write_failed", "write image file", `Could not write the image to \`${candidate}\`: ${error.message}.`, { cause: error });
+        }
+    }
+    throw new ImageToolError("write_failed", "write image file", `Could not find an available filename for \`${targetPath}\`.`);
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AACnC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC3D,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAE5C;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB,EAAE,gBAAwB;IAC3E,OAAO,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAA;AACjF,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,QAAgB;IACpC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,CAAC,CAAA;QACtC,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,QAAgB,EAAE,OAAe;IACtD,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IACnC,MAAM,IAAI,GAAG,SAAS,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IAC/E,OAAO,GAAG,IAAI,IAAI,OAAO,GAAG,SAAS,EAAE,CAAA;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,QAAgB;IACxD,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;QAAE,OAAO,QAAQ,CAAA;IAC9C,KAAK,IAAI,OAAO,GAAG,CAAC,GAAI,OAAO,IAAI,CAAC,EAAE,CAAC;QACrC,MAAM,SAAS,GAAG,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QAClD,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;YAAE,OAAO,SAAS,CAAA;IAClD,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,UAAkB,EAClB,IAAgB;IAEhB,IAAI,SAAS,GAAG,MAAM,mBAAmB,CAAC,UAAU,CAAC,CAAA;IACrD,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QACnD,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;YACpD,MAAM,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;YAChD,OAAO,SAAS,CAAA;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACvD,SAAS,GAAG,MAAM,mBAAmB,CAAC,SAAS,CAAC,CAAA;gBAChD,SAAQ;YACV,CAAC;YACD,MAAM,IAAI,cAAc,CACtB,cAAc,EACd,kBAAkB,EAClB,kCAAkC,SAAS,OAAQ,KAAe,CAAC,OAAO,GAAG,EAC7E,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAA;QACH,CAAC;IACH,CAAC;IACD,MAAM,IAAI,cAAc,CACtB,cAAc,EACd,kBAAkB,EAClB,8CAA8C,UAAU,KAAK,CAC9D,CAAA;AACH,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,28 @@
+import type { GenerationSettings } from "./config.ts";
+/** A local reference image passed to the edits endpoint. */
+export interface ImageReference {
+    filename: string;
+    mimeType: string;
+    data: Uint8Array;
+}
+export interface ImageRequest {
+    prompt: string;
+    settings: GenerationSettings;
+    references?: ImageReference[];
+}
+export interface ImageResult {
+    data: Uint8Array;
+    mimeType: string;
+    revisedPrompt?: string;
+}
+/**
+ * The internal seam between the tool and an image service.
+ *
+ * It stays private to the package: the tool depends on this interface, and the
+ * OpenAI adapter implements it. A second service would be added by writing
+ * another implementation, not by exposing a plugin registry.
+ */
+export interface ImageProvider {
+    generate(request: ImageRequest, signal?: AbortSignal): Promise<ImageResult>;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAErD,4DAA4D;AAC5D,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,UAAU,CAAA;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,UAAU,CAAC,EAAE,cAAc,EAAE,CAAA;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,UAAU,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;CAC5E"}

package/dist/provider.js

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

package/dist/provider.js.map

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

package/dist/tool.d.ts

@@ -0,0 +1,25 @@
+import type { Info as ToolInfo } from "@opencode/plugin/promise/tool";
+export declare const TOOL_NAME = "gpt_imagegen";
+export interface GptImagegenDependencies {
+    /** Resolve the OpenCode session directory used as the base for relative paths. */
+    resolveSessionDirectory: (sessionID: string) => Promise<string>;
+    /** Environment source for `OPENAI_API_KEY`; defaults to `process.env`. */
+    env?: Record<string, string | undefined>;
+    /**
+     * Resolve a key from OpenCode's OpenAI connection. Consulted only when the
+     * option and the environment variable are absent.
+     */
+    resolveApiKey?: () => Promise<string | undefined>;
+    /** Override the OpenAI API base URL. */
+    baseUrl?: string;
+    /** Inject a fetch implementation (used by tests). */
+    fetch?: typeof globalThis.fetch;
+}
+/**
+ * Build the `gpt_imagegen` tool definition.
+ *
+ * The definition is a plain value so tests can call its `execute` with a fake
+ * context, a temporary session directory, and a stubbed fetch implementation.
+ */
+export declare function createGptImagegenTool(dependencies: GptImagegenDependencies): ToolInfo;
+//# sourceMappingURL=tool.d.ts.map

package/dist/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,IAAI,QAAQ,EAAqC,MAAM,+BAA+B,CAAA;AAcxG,eAAO,MAAM,SAAS,iBAAiB,CAAA;AASvC,MAAM,WAAW,uBAAuB;IACtC,kFAAkF;IAClF,uBAAuB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAC/D,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;IACxC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACjD,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,qDAAqD;IACrD,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAChC;AAyHD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,uBAAuB,GAAG,QAAQ,CAmErF"}

package/dist/tool.js

@@ -0,0 +1,164 @@
+import { readFile } from "node:fs/promises";
+import { basename } from "node:path";
+import { DEFAULT_MODEL, OUTPUT_FORMAT_VALUES, QUALITY_VALUES, reconcileOutputFormat, resolveSettings, } from "./config.js";
+import { ImageToolError, invalidArgument, requireNonEmptyString } from "./errors.js";
+import { SUPPORTED_REFERENCE_EXTENSIONS, mimeTypeForReferencePath } from "./image.js";
+import { createOpenAIImageProvider } from "./openai-provider.js";
+import { resolveOutputPath, writeImageWithoutOverwrite } from "./paths.js";
+export const TOOL_NAME = "gpt_imagegen";
+/**
+ * Find the OpenAI API key, in precedence order: the `OPENAI_API_KEY`
+ * environment variable, then OpenCode's OpenAI connection. Fails before any
+ * network request when neither is present.
+ */
+async function resolveApiKey(dependencies) {
+    const env = dependencies.env ?? process.env;
+    const fromEnv = env.OPENAI_API_KEY;
+    if (typeof fromEnv === "string" && fromEnv !== "")
+        return fromEnv;
+    const fromConnection = await dependencies.resolveApiKey?.();
+    if (typeof fromConnection === "string" && fromConnection !== "")
+        return fromConnection;
+    throw new ImageToolError("missing_api_key", "validate API key", "No OpenAI API key was found. Connect OpenAI in OpenCode (run /connect) or set OPENAI_API_KEY.");
+}
+const INPUT_SCHEMA = {
+    type: "object",
+    properties: {
+        prompt: {
+            type: "string",
+            description: "Text description of the image to generate or the edit to make.",
+        },
+        outputPath: {
+            type: "string",
+            description: "Where to save the image. Relative paths resolve against the session directory; an existing file is never replaced.",
+        },
+        model: {
+            type: "string",
+            description: `OpenAI image model. Defaults to ${DEFAULT_MODEL}.`,
+        },
+        quality: {
+            type: "string",
+            enum: [...QUALITY_VALUES],
+            description: "Generation quality. Defaults to the model's own default.",
+        },
+        size: {
+            type: "string",
+            description: "Image size as WIDTHxHEIGHT, or auto. Defaults to the model's own default.",
+        },
+        outputFormat: {
+            type: "string",
+            enum: [...OUTPUT_FORMAT_VALUES],
+            description: "Output format for GPT image models. Defaults to the format implied by the output path extension.",
+        },
+        referenceImages: {
+            type: "array",
+            items: { type: "string" },
+            description: "Local reference image paths. When present the tool edits them through the OpenAI edits endpoint.",
+        },
+    },
+    required: ["prompt", "outputPath"],
+    additionalProperties: false,
+};
+function readReferencePaths(value) {
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value)) {
+        throw invalidArgument("`referenceImages` must be an array of file paths.");
+    }
+    return value.map((entry) => {
+        if (typeof entry !== "string" || entry.trim() === "") {
+            throw invalidArgument("Every `referenceImages` entry must be a file path.");
+        }
+        return entry;
+    });
+}
+async function loadReferences(paths, sessionDirectory) {
+    const references = [];
+    for (const requested of paths) {
+        const filePath = resolveOutputPath(requested, sessionDirectory);
+        const mimeType = mimeTypeForReferencePath(filePath);
+        if (mimeType === undefined) {
+            throw new ImageToolError("invalid_reference", "read reference image", `Reference image \`${filePath}\` has an unsupported type. Use ${SUPPORTED_REFERENCE_EXTENSIONS.join(", ")}.`);
+        }
+        let data;
+        try {
+            data = await readFile(filePath);
+        }
+        catch (error) {
+            const code = error.code;
+            const detail = code === "ENOENT" ? "was not found" : `could not be read (${error.message})`;
+            throw new ImageToolError("invalid_reference", "read reference image", `Reference image \`${filePath}\` ${detail}.`, { cause: error });
+        }
+        if (data.byteLength === 0) {
+            throw new ImageToolError("invalid_reference", "read reference image", `Reference image \`${filePath}\` is empty.`);
+        }
+        references.push({ filename: basename(filePath), mimeType, data });
+    }
+    return references;
+}
+/**
+ * Build the `gpt_imagegen` tool definition.
+ *
+ * The definition is a plain value so tests can call its `execute` with a fake
+ * context, a temporary session directory, and a stubbed fetch implementation.
+ */
+export function createGptImagegenTool(dependencies) {
+    return {
+        name: TOOL_NAME,
+        description: "Generate a new bitmap image from a prompt, or edit one from local reference images, using the OpenAI Image API. Saves one image to disk and returns its path.",
+        input: INPUT_SCHEMA,
+        options: { codemode: true },
+        async execute(input, context) {
+            const apiKey = await resolveApiKey(dependencies);
+            const record = (input ?? {});
+            const prompt = requireNonEmptyString(record.prompt, "prompt");
+            const outputPath = requireNonEmptyString(record.outputPath, "outputPath");
+            const requestedSettings = resolveSettings({
+                model: record.model,
+                quality: record.quality,
+                size: record.size,
+                outputFormat: record.outputFormat,
+            });
+            const referencePaths = readReferencePaths(record.referenceImages);
+            const sessionDirectory = await dependencies.resolveSessionDirectory(context.sessionID);
+            const targetPath = resolveOutputPath(outputPath, sessionDirectory);
+            const settings = reconcileOutputFormat(requestedSettings, targetPath);
+            const references = await loadReferences(referencePaths, sessionDirectory);
+            await context.progress({
+                status: references.length > 0 ? "editing image" : "generating image",
+            });
+            const provider = createOpenAIImageProvider({
+                apiKey,
+                baseUrl: dependencies.baseUrl,
+                fetch: dependencies.fetch,
+            });
+            const result = await provider.generate({ prompt, settings, references }, context.signal);
+            if (context.signal?.aborted === true) {
+                throw new ImageToolError("cancelled", "write image file", "The image request was cancelled before the file was written.");
+            }
+            await context.progress({ status: "writing image" });
+            const savedPath = await writeImageWithoutOverwrite(targetPath, result.data);
+            const metadata = {
+                path: savedPath,
+                model: settings.model,
+                mimeType: result.mimeType,
+                bytes: result.data.byteLength,
+            };
+            if (settings.quality !== undefined)
+                metadata.quality = settings.quality;
+            if (settings.size !== undefined)
+                metadata.size = settings.size;
+            if (settings.outputFormat !== undefined)
+                metadata.outputFormat = settings.outputFormat;
+            if (result.revisedPrompt !== undefined)
+                metadata.revisedPrompt = result.revisedPrompt;
+            if (references.length > 0)
+                metadata.referenceImages = references.map((ref) => ref.filename);
+            return {
+                content: `Saved image to \`${savedPath}\` (${result.mimeType}, ${result.data.byteLength} bytes).`,
+                metadata,
+            };
+        },
+    };
+}
+//# sourceMappingURL=tool.js.map

package/dist/tool.js.map

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

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "opencode-img",
+  "version": "0.1.0",
+  "description": "An OpenCode V2 plugin that generates and edits bitmap images through the OpenAI Image API.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "openai",
+    "image-generation"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mattsafaii/opencode-img.git"
+  },
+  "homepage": "https://github.com/mattsafaii/opencode-img#readme",
+  "bugs": {
+    "url": "https://github.com/mattsafaii/opencode-img/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@opencode/plugin": "^2.0.10"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.9.0"
+  },
+  "scripts": {
+    "test": "node --test \"test/**/*.test.ts\"",
+    "typecheck": "tsc --noEmit",
+    "build": "tsc -p tsconfig.build.json"
+  }
+}