opencode-img 0.1.0 → 0.2.0

package/README.md

@@ -1,6 +1,6 @@
 # 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.
+An OpenCode V2 plugin that generates and edits bitmap images through OpenAI, Gemini, and xAI image APIs. 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)
@@ -9,13 +9,13 @@ An OpenCode V2 plugin that generates and edits bitmap images through the OpenAI
 
 Source: [github.com/mattsafaii/opencode-img](https://github.com/mattsafaii/opencode-img)
 
-**Status:** 0.1.0, early release.
+**Status:** 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.
+- **Generates and edits.** A prompt makes a new image; local `referenceImages` edit an existing one.
+- **Three providers.** `openai` (default), `gemini` (Nano Banana), and `grok` (Grok Imagine), selectable per call.
 - **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
@@ -35,16 +35,55 @@ Or add it to `opencode.json`:
 }
 ```
 
-## Add your OpenAI API key
+## Plugin options
 
-Connect OpenAI in OpenCode, or set `OPENAI_API_KEY`. When both are present, the environment variable wins.
+Set call defaults in `opencode.json` with the object form:
 
-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.
+```jsonc
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugins": [
+    {
+      "package": "opencode-img",
+      "options": {
+        "provider": "gemini",
+        "models": {
+          "openai": "gpt-image-1.5",
+          "gemini": "gemini-3.1-flash-image",
+          "grok": "grok-imagine-image-2.0"
+        }
+      }
+    }
+  ]
+}
+```
+
+- `provider` — used when a call does not name one. Defaults to `openai`.
+- `models` — per-provider default model. Each provider falls back to its built-in default.
+
+A call can still pass `provider` or `model` to override either.
+
+## Providers
+
+| `provider` | Default model | Key |
+| --- | --- | --- |
+| `openai` (default) | `gpt-image-1.5` | `OPENAI_API_KEY`, or the OpenAI connection from `/connect` |
+| `gemini` | `gemini-3.1-flash-image` (Nano Banana 2) | `GEMINI_API_KEY` (or `GOOGLE_API_KEY`, `GOOGLE_GENERATIVE_AI_API_KEY`), or the Google connection from `/connect` |
+| `grok` | `grok-imagine-image-2.0` (Grok Imagine) | `XAI_API_KEY`, or the xAI connection from `/connect` |
+
+Pass `provider` to pick one.
+
+## Add your API key
+
+Set the environment variable for the provider you use, or connect it in OpenCode. When both are present, the environment variable wins.
+
+- **OpenAI:** `OPENAI_API_KEY`, or `/connect` → OpenAI.
+- **Gemini:** `GEMINI_API_KEY`, or `/connect` → Google.
+- **Grok:** `XAI_API_KEY`, or `/connect` → xAI.
 
-A missing key fails before any network request, and the error names both.
+Use the environment variable for headless setups, or when your key lives in the OpenCode Console (BYOK), which plugins cannot read.
 
-A key connected through the OpenCode Console (BYOK) stays in Console and is not available to plugins; set `OPENAI_API_KEY` in that case.
+A missing key fails before any network request, and the error names the provider's variables and integration.
 
 ## Use
 
@@ -60,14 +99,17 @@ Generate a 1024x1024 image of a red square on a white background and save it to
 | --- | --- | --- |
 | `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`. |
+| `provider` | no | `openai` (default), `gemini`, or `grok`. |
+| `model` | no | Image model. Defaults to the provider's default. |
+| `quality` | no | `auto`, `low`, `medium`, `high`, `standard`, `hd`, `xhigh`, or `max` (OpenAI); `auto`, `low`, or `medium` (Grok). |
+| `size` | no | `WIDTHxHEIGHT` (for example `1024x1024`) or `auto` (OpenAI only). |
+| `outputFormat` | no | `png`, `jpeg`, or `webp` (OpenAI); `png` or `jpeg` (Gemini). Inferred from the output path extension when omitted. |
+| `referenceImages` | no | Local image paths. When present, the tool edits them. |
 
 ## Worked examples
 
+Each image below is a real output of this plugin.
+
 ### Edit an existing image
 
 Pass local paths in `referenceImages` and the tool edits them.
@@ -76,12 +118,16 @@ Pass local paths in `referenceImages` and the tool edits them.
 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.
 ```
 
+![A teacup edited from the coffee-cup reference](./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.
 ```
 
+![A generated flat illustration of a coffee cup](./assets/example-generate.png)
+
 ### Run the same path twice
 
 The first file is left untouched; the new image lands at `example-generate-1.png`.
@@ -90,6 +136,8 @@ The first file is left untouched; the new image lands at `example-generate-1.png
 Now do the same path, but a slice of cake on a plate instead.
 ```
 
+![The second image, written to the versioned path](./assets/example-generate-1.png)
+
 ## Output
 
 - One image per request.
@@ -100,7 +148,7 @@ Now do the same path, but a slice of cake on a plate instead.
 
 ## 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.
+opencode-img is an independent project. It is not made by, affiliated with, or endorsed by any provider it supports or the OpenCode team. Calls to a provider's API are subject to that provider's terms and usage policies.
 
 ## Development
 

package/dist/config.d.ts

@@ -1,5 +1,3 @@
-/** 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. */
@@ -26,18 +24,19 @@ export declare function isGptImageModel(model: string): boolean;
  */
 export declare function outputFormatForExtension(filePath: string): OutputFormat | undefined;
 /**
- * Validate the optional generation settings and apply the model default.
+ * Validate the optional generation settings and apply the provider's default
+ * model.
  *
  * 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;
+export declare function resolveSettings(input: GenerationSettingsInput, defaultModel: string): 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.
+ * contradict the name.
  */
 export declare function reconcileOutputFormat(settings: GenerationSettings, targetPath: string): GenerationSettings;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,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;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,uBAAuB,EAC9B,YAAY,EAAE,MAAM,GACnB,kBAAkB,CAiCpB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,kBAAkB,EAC5B,UAAU,EAAE,MAAM,GACjB,kBAAkB,CAcpB"}

package/dist/config.js

@@ -1,7 +1,5 @@
 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",
@@ -37,13 +35,14 @@ export function outputFormatForExtension(filePath) {
     }
 }
 /**
- * Validate the optional generation settings and apply the model default.
+ * Validate the optional generation settings and apply the provider's default
+ * model.
  *
  * 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");
+export function resolveSettings(input, defaultModel) {
+    const model = input.model === undefined ? defaultModel : requireNonEmptyString(input.model, "model");
     const settings = { model };
     if (input.quality !== undefined) {
         const quality = requireNonEmptyString(input.quality, "quality");
@@ -64,9 +63,6 @@ export function resolveSettings(input) {
         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;
@@ -76,7 +72,7 @@ export function resolveSettings(input) {
  *
  * 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.
+ * contradict the name.
  */
 export function reconcileOutputFormat(settings, targetPath) {
     const extensionFormat = outputFormatForExtension(targetPath);
@@ -88,12 +84,6 @@ export function reconcileOutputFormat(settings, targetPath) {
         }
         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

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

package/dist/gemini-provider.d.ts

@@ -0,0 +1,17 @@
+import { type GenerationSettings, type GenerationSettingsInput } from "./config.ts";
+import type { ImageProvider, ImageProviderOptions } from "./provider.ts";
+export declare const DEFAULT_BASE_URL = "https://generativelanguage.googleapis.com/v1beta";
+/** Nano Banana 2, the generalist Gemini image model. */
+export declare const GEMINI_DEFAULT_MODEL = "gemini-3.1-flash-image";
+/** Resolve the settings Gemini accepts. Quality, size, and webp do not apply. */
+export declare function resolveGeminiSettings(input: GenerationSettingsInput, targetPath: string): GenerationSettings;
+/**
+ * Create the Gemini (Nano Banana) adapter for the internal {@link ImageProvider}
+ * seam.
+ *
+ * Generation and editing use one endpoint. The prompt and every reference image
+ * travel together as content parts, and the generated image comes back in the
+ * response steps.
+ */
+export declare function createGeminiImageProvider(options: ImageProviderOptions): ImageProvider;
+//# sourceMappingURL=gemini-provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gemini-provider.d.ts","sourceRoot":"","sources":["../src/gemini-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAE7B,MAAM,aAAa,CAAA;AAIpB,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAA6B,MAAM,eAAe,CAAA;AAEnG,eAAO,MAAM,gBAAgB,qDAAqD,CAAA;AAElF,wDAAwD;AACxD,eAAO,MAAM,oBAAoB,2BAA2B,CAAA;AAK5D,iFAAiF;AACjF,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,uBAAuB,EAC9B,UAAU,EAAE,MAAM,GACjB,kBAAkB,CAoBpB;AAqDD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAgEtF"}

package/dist/gemini-provider.js

@@ -0,0 +1,130 @@
+import { reconcileOutputFormat, resolveSettings, } from "./config.js";
+import { ImageToolError, invalidArgument } from "./errors.js";
+import { sendJsonRequest } from "./http.js";
+import { decodeBase64Image, mimeTypeForOutputFormat } from "./image.js";
+export const DEFAULT_BASE_URL = "https://generativelanguage.googleapis.com/v1beta";
+/** Nano Banana 2, the generalist Gemini image model. */
+export const GEMINI_DEFAULT_MODEL = "gemini-3.1-flash-image";
+/** Output formats the Gemini image models can produce. */
+const SUPPORTED_OUTPUT_FORMATS = ["png", "jpeg"];
+/** Resolve the settings Gemini accepts. Quality, size, and webp do not apply. */
+export function resolveGeminiSettings(input, targetPath) {
+    const settings = resolveSettings(input, GEMINI_DEFAULT_MODEL);
+    if (settings.quality !== undefined) {
+        throw invalidArgument("`quality` is not supported by the gemini provider.");
+    }
+    if (settings.size !== undefined) {
+        throw invalidArgument("`size` is not supported by the gemini provider; Gemini uses aspect ratios.");
+    }
+    const reconciled = reconcileOutputFormat(settings, targetPath);
+    if (reconciled.outputFormat !== undefined &&
+        !SUPPORTED_OUTPUT_FORMATS.includes(reconciled.outputFormat)) {
+        throw invalidArgument(`The gemini provider cannot produce ${reconciled.outputFormat}; use png or jpeg.`);
+    }
+    return reconciled;
+}
+function asRecord(value) {
+    return typeof value === "object" && value !== null
+        ? value
+        : undefined;
+}
+function imageBlockFrom(value) {
+    const block = asRecord(value);
+    if (block === undefined)
+        return undefined;
+    if (block.type !== undefined && block.type !== "image")
+        return undefined;
+    const data = block.data;
+    if (typeof data !== "string" || data === "")
+        return undefined;
+    const mimeType = typeof block.mime_type === "string"
+        ? block.mime_type
+        : typeof block.mimeType === "string"
+            ? block.mimeType
+            : "image/png";
+    return { data, mimeType };
+}
+/** Find the last image block in an Interactions response. */
+function findImage(payload) {
+    const root = asRecord(payload);
+    if (root === undefined)
+        return undefined;
+    const direct = imageBlockFrom(root.output_image ?? root.outputImage);
+    if (direct !== undefined)
+        return direct;
+    const steps = root.steps;
+    if (!Array.isArray(steps))
+        return undefined;
+    let found;
+    for (const step of steps) {
+        const content = asRecord(step)?.content;
+        if (!Array.isArray(content))
+            continue;
+        for (const block of content) {
+            const image = imageBlockFrom(block);
+            if (image !== undefined)
+                found = image;
+        }
+    }
+    return found;
+}
+/**
+ * Create the Gemini (Nano Banana) adapter for the internal {@link ImageProvider}
+ * seam.
+ *
+ * Generation and editing use one endpoint. The prompt and every reference image
+ * travel together as content parts, and the generated image comes back in the
+ * response steps.
+ */
+export function createGeminiImageProvider(options) {
+    const apiKey = options.apiKey;
+    const baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    const fetchImpl = options.fetch ?? globalThis.fetch;
+    function buildBody(request) {
+        const input = [{ type: "text", text: request.prompt }];
+        for (const reference of request.references ?? []) {
+            input.push({
+                type: "image",
+                mime_type: reference.mimeType,
+                data: Buffer.from(reference.data).toString("base64"),
+            });
+        }
+        const body = { model: request.settings.model, input };
+        if (request.settings.outputFormat !== undefined) {
+            body.response_format = {
+                type: "image",
+                mime_type: mimeTypeForOutputFormat(request.settings.outputFormat),
+            };
+        }
+        return body;
+    }
+    async function send(request, operation, signal) {
+        const payload = await sendJsonRequest({
+            provider: "Gemini",
+            operation,
+            fetchImpl,
+            url: `${baseUrl}/interactions`,
+            init: {
+                method: "POST",
+                headers: {
+                    "x-goog-api-key": apiKey,
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify(buildBody(request)),
+            },
+            signal,
+        });
+        const image = findImage(payload);
+        if (image === undefined) {
+            throw new ImageToolError("malformed_response", "decode image response", "The image response could not be read: the response contained no image.");
+        }
+        return { data: decodeBase64Image(image.data), mimeType: image.mimeType };
+    }
+    return {
+        generate(request, signal) {
+            const hasReferences = (request.references?.length ?? 0) > 0;
+            return send(request, hasReferences ? "edit image" : "generate image", signal);
+        },
+    };
+}
+//# sourceMappingURL=gemini-provider.js.map

package/dist/gemini-provider.js.map

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

package/dist/grok-provider.d.ts

@@ -0,0 +1,17 @@
+import { type GenerationSettings, type GenerationSettingsInput } from "./config.ts";
+import type { ImageProvider, ImageProviderOptions } from "./provider.ts";
+export declare const DEFAULT_BASE_URL = "https://api.x.ai/v1";
+/** Grok Imagine Image 2.0, the current xAI image model. */
+export declare const GROK_DEFAULT_MODEL = "grok-imagine-image-2.0";
+/** Resolve the settings xAI accepts. Size and output format do not apply. */
+export declare function resolveGrokSettings(input: GenerationSettingsInput, _targetPath: string): GenerationSettings;
+/**
+ * Create the Grok Imagine (xAI) adapter for the internal {@link ImageProvider}
+ * seam.
+ *
+ * Generation posts JSON to `/images/generations`. Editing posts JSON to
+ * `/images/edits` with the source images as data URIs; the endpoint does not
+ * accept multipart form data.
+ */
+export declare function createGrokImageProvider(options: ImageProviderOptions): ImageProvider;
+//# sourceMappingURL=grok-provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"grok-provider.d.ts","sourceRoot":"","sources":["../src/grok-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAE7B,MAAM,aAAa,CAAA;AAIpB,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EAIrB,MAAM,eAAe,CAAA;AAEtB,eAAO,MAAM,gBAAgB,wBAAwB,CAAA;AAErD,2DAA2D;AAC3D,eAAO,MAAM,kBAAkB,2BAA2B,CAAA;AAK1D,6EAA6E;AAC7E,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,uBAAuB,EAC9B,WAAW,EAAE,MAAM,GAClB,kBAAkB,CAepB;AAMD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAiEpF"}

package/dist/grok-provider.js

@@ -0,0 +1,94 @@
+import { resolveSettings, } from "./config.js";
+import { invalidArgument } from "./errors.js";
+import { sendJsonRequest } from "./http.js";
+import { decodeImageResponse, mimeTypeForImageBytes } from "./image.js";
+export const DEFAULT_BASE_URL = "https://api.x.ai/v1";
+/** Grok Imagine Image 2.0, the current xAI image model. */
+export const GROK_DEFAULT_MODEL = "grok-imagine-image-2.0";
+/** Quality values the xAI image model accepts. */
+const GROK_QUALITY_VALUES = ["auto", "low", "medium"];
+/** Resolve the settings xAI accepts. Size and output format do not apply. */
+export function resolveGrokSettings(input, _targetPath) {
+    const settings = resolveSettings(input, GROK_DEFAULT_MODEL);
+    if (settings.size !== undefined) {
+        throw invalidArgument("`size` is not supported by the grok provider; xAI uses aspect ratios.");
+    }
+    if (settings.outputFormat !== undefined) {
+        throw invalidArgument("`outputFormat` is not supported by the grok provider.");
+    }
+    if (settings.quality !== undefined && !GROK_QUALITY_VALUES.includes(settings.quality)) {
+        throw invalidArgument(`The grok provider accepts quality ${GROK_QUALITY_VALUES.join(", ")}.`);
+    }
+    return settings;
+}
+function referenceDataUri(reference) {
+    return `data:${reference.mimeType};base64,${Buffer.from(reference.data).toString("base64")}`;
+}
+/**
+ * Create the Grok Imagine (xAI) adapter for the internal {@link ImageProvider}
+ * seam.
+ *
+ * Generation posts JSON to `/images/generations`. Editing posts JSON to
+ * `/images/edits` with the source images as data URIs; the endpoint does not
+ * accept multipart form data.
+ */
+export function createGrokImageProvider(options) {
+    const apiKey = options.apiKey;
+    const baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    const fetchImpl = options.fetch ?? globalThis.fetch;
+    function buildBody(request) {
+        const body = {
+            model: request.settings.model,
+            prompt: request.prompt,
+            n: 1,
+            response_format: "b64_json",
+        };
+        if (request.settings.quality !== undefined)
+            body.quality = request.settings.quality;
+        const references = request.references ?? [];
+        if (references.length === 1) {
+            body.image = { url: referenceDataUri(references[0]), type: "image_url" };
+        }
+        else if (references.length > 1) {
+            body.image = references.map((reference) => ({
+                url: referenceDataUri(reference),
+                type: "image_url",
+            }));
+        }
+        return body;
+    }
+    async function send(request, operation, signal) {
+        const hasReferences = (request.references?.length ?? 0) > 0;
+        const url = hasReferences ? `${baseUrl}/images/edits` : `${baseUrl}/images/generations`;
+        const payload = await sendJsonRequest({
+            provider: "xAI",
+            operation,
+            fetchImpl,
+            url,
+            init: {
+                method: "POST",
+                headers: {
+                    Authorization: `Bearer ${apiKey}`,
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify(buildBody(request)),
+            },
+            signal,
+        });
+        const decoded = decodeImageResponse(payload);
+        const result = {
+            data: decoded.data,
+            mimeType: mimeTypeForImageBytes(decoded.data),
+        };
+        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=grok-provider.js.map

package/dist/grok-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grok-provider.js","sourceRoot":"","sources":["../src/grok-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,GAIhB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AASvE,MAAM,CAAC,MAAM,gBAAgB,GAAG,qBAAqB,CAAA;AAErD,2DAA2D;AAC3D,MAAM,CAAC,MAAM,kBAAkB,GAAG,wBAAwB,CAAA;AAE1D,kDAAkD;AAClD,MAAM,mBAAmB,GAAuB,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAA;AAEzE,6EAA6E;AAC7E,MAAM,UAAU,mBAAmB,CACjC,KAA8B,EAC9B,WAAmB;IAEnB,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAA;IAE3D,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,eAAe,CAAC,uEAAuE,CAAC,CAAA;IAChG,CAAC;IACD,IAAI,QAAQ,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACxC,MAAM,eAAe,CAAC,uDAAuD,CAAC,CAAA;IAChF,CAAC;IACD,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACtF,MAAM,eAAe,CACnB,qCAAqC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACvE,CAAA;IACH,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,SAAS,gBAAgB,CAAC,SAAyB;IACjD,OAAO,QAAQ,SAAS,CAAC,QAAQ,WAAW,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAA;AAC9F,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAA6B;IACnE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;IAC7B,MAAM,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,gBAAgB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IACzE,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAA;IAEnD,SAAS,SAAS,CAAC,OAAqB;QACtC,MAAM,IAAI,GAA4B;YACpC,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK;YAC7B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,CAAC,EAAE,CAAC;YACJ,eAAe,EAAE,UAAU;SAC5B,CAAA;QACD,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAA;QAEnF,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,EAAE,CAAA;QAC3C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,GAAG,EAAE,GAAG,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAA;QAC3E,CAAC;aAAM,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;gBAC1C,GAAG,EAAE,gBAAgB,CAAC,SAAS,CAAC;gBAChC,IAAI,EAAE,WAAW;aAClB,CAAC,CAAC,CAAA;QACL,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK,UAAU,IAAI,CACjB,OAAqB,EACrB,SAA0C,EAC1C,MAA+B;QAE/B,MAAM,aAAa,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAA;QAC3D,MAAM,GAAG,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO,qBAAqB,CAAA;QAEvF,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC;YACpC,QAAQ,EAAE,KAAK;YACf,SAAS;YACT,SAAS;YACT,GAAG;YACH,IAAI,EAAE;gBACJ,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,aAAa,EAAE,UAAU,MAAM,EAAE;oBACjC,cAAc,EAAE,kBAAkB;iBACnC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;aACzC;YACD,MAAM;SACP,CAAC,CAAA;QAEF,MAAM,OAAO,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAA;QAC5C,MAAM,MAAM,GAAgB;YAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,QAAQ,EAAE,qBAAqB,CAAC,OAAO,CAAC,IAAI,CAAC;SAC9C,CAAA;QACD,IAAI,OAAO,CAAC,aAAa,KAAK,SAAS;YAAE,MAAM,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAA;QACrF,OAAO,MAAM,CAAA;IACf,CAAC;IAED,OAAO;QACL,QAAQ,CAAC,OAAqB,EAAE,MAAoB;YAClD,MAAM,aAAa,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAA;YAC3D,OAAO,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAA;QAC/E,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/http.d.ts

@@ -0,0 +1,23 @@
+import { type ImageToolOperation } from "./errors.ts";
+/** True when a fetch failure is an abort rather than a real error. */
+export declare function isAbort(error: unknown, signal: AbortSignal | undefined): boolean;
+/** A short, safe detail string pulled from an error response body. */
+export declare function safeErrorDetail(body: string): string;
+export interface JsonRequest {
+    /** Provider name used in error messages, for example `OpenAI`. */
+    provider: string;
+    operation: ImageToolOperation;
+    fetchImpl: typeof globalThis.fetch;
+    url: string;
+    init: RequestInit;
+    signal: AbortSignal | undefined;
+}
+/**
+ * Send a JSON request and return the parsed body.
+ *
+ * Shared by every adapter so the failure semantics stay identical: an abort is a
+ * cancellation, a non-OK status is an API error carrying the status and a
+ * bounded detail, and an unreadable body is a malformed response.
+ */
+export declare function sendJsonRequest(request: JsonRequest): Promise<unknown>;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAIrE,sEAAsE;AACtE,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CAEhF;AAED,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAapD;AAED,MAAM,WAAW,WAAW;IAC1B,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,kBAAkB,CAAA;IAC7B,SAAS,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;IAClC,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,WAAW,CAAA;IACjB,MAAM,EAAE,WAAW,GAAG,SAAS,CAAA;CAChC;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAqC5E"}

package/dist/http.js

@@ -0,0 +1,55 @@
+import { ImageToolError } from "./errors.js";
+const MAX_ERROR_DETAIL = 500;
+/** True when a fetch failure is an abort rather than a real error. */
+export function isAbort(error, signal) {
+    return (error instanceof Error && error.name === "AbortError") || signal?.aborted === true;
+}
+/** A short, safe detail string pulled from an error response body. */
+export 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);
+}
+/**
+ * Send a JSON request and return the parsed body.
+ *
+ * Shared by every adapter so the failure semantics stay identical: an abort is a
+ * cancellation, a non-OK status is an API error carrying the status and a
+ * bounded detail, and an unreadable body is a malformed response.
+ */
+export async function sendJsonRequest(request) {
+    let response;
+    try {
+        response = await request.fetchImpl(request.url, { ...request.init, signal: request.signal });
+    }
+    catch (error) {
+        if (isAbort(error, request.signal)) {
+            throw new ImageToolError("cancelled", request.operation, "The image request was cancelled.", {
+                cause: error,
+            });
+        }
+        throw new ImageToolError("api_error", request.operation, `Could not reach ${request.provider} while trying to ${request.operation}: ${error.message}.`, { cause: error });
+    }
+    if (!response.ok) {
+        const detail = safeErrorDetail(await response.text().catch(() => ""));
+        throw new ImageToolError("api_error", request.operation, `${request.provider} returned HTTP ${response.status} while trying to ${request.operation}: ${detail}`);
+    }
+    try {
+        return await response.json();
+    }
+    catch (error) {
+        throw new ImageToolError("malformed_response", request.operation, `${request.provider} returned a response body that was not valid JSON.`, { cause: error });
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAA2B,MAAM,aAAa,CAAA;AAErE,MAAM,gBAAgB,GAAG,GAAG,CAAA;AAE5B,sEAAsE;AACtE,MAAM,UAAU,OAAO,CAAC,KAAc,EAAE,MAA+B;IACrE,OAAO,CAAC,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC,IAAI,MAAM,EAAE,OAAO,KAAK,IAAI,CAAA;AAC5F,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;IAC3B,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,kBAAkB,CAAA;IAC7C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAsC,CAAA;QACvE,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,EAAE,OAAO,CAAA;QACrC,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;YAClD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAA;QAC3C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,0CAA0C;IAC5C,CAAC;IACD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAA;AAC3C,CAAC;AAYD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAoB;IACxD,IAAI,QAAkB,CAAA;IACtB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAC9F,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,cAAc,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,EAAE,kCAAkC,EAAE;gBAC3F,KAAK,EAAE,KAAK;aACb,CAAC,CAAA;QACJ,CAAC;QACD,MAAM,IAAI,cAAc,CACtB,WAAW,EACX,OAAO,CAAC,SAAS,EACjB,mBAAmB,OAAO,CAAC,QAAQ,oBAAoB,OAAO,CAAC,SAAS,KAAM,KAAe,CAAC,OAAO,GAAG,EACxG,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAA;IACH,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;QACrE,MAAM,IAAI,cAAc,CACtB,WAAW,EACX,OAAO,CAAC,SAAS,EACjB,GAAG,OAAO,CAAC,QAAQ,kBAAkB,QAAQ,CAAC,MAAM,oBAAoB,OAAO,CAAC,SAAS,KAAK,MAAM,EAAE,CACvG,CAAA;IACH,CAAC;IAED,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,cAAc,CACtB,oBAAoB,EACpB,OAAO,CAAC,SAAS,EACjB,GAAG,OAAO,CAAC,QAAQ,oDAAoD,EACvE,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAA;IACH,CAAC;AACH,CAAC"}