@framers/agentos-ext-image-generation 1.1.0 → 2.0.0

package/dist/ImageGenerationService.d.ts

@@ -1,9 +1,19 @@
 /**
  * @fileoverview Image generation service backed by AgentOS's shared
  * provider-agnostic image API.
+ *
+ * Image data a provider returns is saved and the result carries the saved
+ * copy's URL, never the data: see `imageFiles.ts`.
  */
 import { type ImageProviderOptionBag } from '@framers/agentos';
+import { type SaveImage } from './imageFiles.js';
 export type ImageGenerationProvider = 'openai' | 'openrouter' | 'stability' | 'replicate';
+/**
+ * The quality of an image. OpenAI's GPT Image models take `low`, `medium`,
+ * `high` and `auto`; `standard` and `hd` were DALL·E 3's names and are sent
+ * to them as `medium` and `high`.
+ */
+export type ImageQuality = 'low' | 'medium' | 'high' | 'auto' | 'standard' | 'hd';
 export interface ImageGenerationConfig {
     openaiApiKey?: string;
     openrouterApiKey?: string;
@@ -12,13 +22,20 @@ export interface ImageGenerationConfig {
     defaultProvider?: ImageGenerationProvider;
     defaultModel?: string;
     defaultSize?: string;
-    defaultQuality?: 'standard' | 'hd';
+    defaultQuality?: ImageQuality;
+    /**
+     * Where image data a provider returns is saved (else `AGENTOS_IMAGE_DIR`,
+     * else a folder in the user's temp directory).
+     */
+    imageDir?: string;
+    /** Stores image data in place of the default saver and returns the http(s) URL the host's clients load. */
+    saveImage?: SaveImage;
 }
 export interface GenerateImageOptions {
     prompt: string;
-    size?: '1024x1024' | '1792x1024' | '1024x1792' | '512x512' | '256x256';
+    size?: string;
     aspectRatio?: string;
-    quality?: 'standard' | 'hd';
+    quality?: ImageQuality;
     style?: 'vivid' | 'natural';
     n?: number;
     provider?: ImageGenerationProvider;
@@ -28,6 +45,7 @@ export interface GenerateImageOptions {
     providerOptions?: ImageProviderOptionBag | Record<string, unknown>;
 }
 export interface GeneratedImage {
+    /** The provider's image URL, or the URL of the copy that was saved of the image data it returned. */
     url: string;
     revisedPrompt?: string;
     provider: string;
@@ -36,6 +54,7 @@ export interface GeneratedImage {
 }
 export declare class ImageGenerationService {
     private readonly config;
+    private readonly store;
     private initialized;
     constructor(config: ImageGenerationConfig);
     get hasOpenAI(): boolean;
@@ -44,12 +63,25 @@ export declare class ImageGenerationService {
     get hasReplicate(): boolean;
     get hasAnyProvider(): boolean;
     initialize(): Promise<void>;
-    generateImage(options: GenerateImageOptions): Promise<GeneratedImage>;
+    /**
+     * Generates one image.
+     *
+     * @param options - The prompt and its settings.
+     * @param context - The tool call's context, when there is one: image data
+     *   is saved in the calling user's own subdirectory and handed to a host's
+     *   `saveImage` with it.
+     */
+    generateImage(options: GenerateImageOptions, context?: unknown): Promise<GeneratedImage>;
     shutdown(): Promise<void>;
     private resolveProvider;
     private getApiKey;
     private defaultModelForProvider;
     private displayNameForProvider;
+    /**
+     * The provider options of a call. A `style` goes to an OpenAI model that
+     * is not a GPT Image model (one behind a gateway) as its `style` parameter;
+     * a GPT Image model is sent none, from the call or from the options.
+     */
     private normalizeProviderOptions;
 }
 //# sourceMappingURL=ImageGenerationService.d.ts.map

package/dist/ImageGenerationService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ImageGenerationService.d.ts","sourceRoot":"","sources":["../src/ImageGenerationService.ts"],"names":[],"mappings":"AACA;;;GAGG;AAEH,OAAO,EAAiB,KAAK,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE9E,MAAM,MAAM,uBAAuB,GAAG,QAAQ,GAAG,YAAY,GAAG,WAAW,GAAG,WAAW,CAAC;AAE1F,MAAM,WAAW,qBAAqB;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,uBAAuB,CAAC;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpE;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AASD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,EAAE,qBAAqB;IAIzC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,IAAI,cAAc,IAAI,OAAO,CAE5B;IAEK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;IA+CrE,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,SAAS;IAejB,OAAO,CAAC,uBAAuB;IAe/B,OAAO,CAAC,sBAAsB;IAe9B,OAAO,CAAC,wBAAwB;CAoCjC"}
+{"version":3,"file":"ImageGenerationService.d.ts","sourceRoot":"","sources":["../src/ImageGenerationService.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAEH,OAAO,EAAiB,KAAK,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE9E,OAAO,EAA2C,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE1F,MAAM,MAAM,uBAAuB,GAAG,QAAQ,GAAG,YAAY,GAAG,WAAW,GAAG,WAAW,CAAC;AAE1F;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;AAwBlF,MAAM,WAAW,qBAAqB;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,uBAAuB,CAAC;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,YAAY,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2GAA2G;IAC3G,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpE;AAED,MAAM,WAAW,cAAc;IAC7B,qGAAqG;IACrG,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AASD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,EAAE,qBAAqB;IAKzC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,IAAI,cAAc,IAAI,OAAO,CAE5B;IAEK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;;;;;;OAOG;IACG,aAAa,CAAC,OAAO,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC;IAkDxF,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,SAAS;IAejB,OAAO,CAAC,uBAAuB;IAe/B,OAAO,CAAC,sBAAsB;IAe9B;;;;OAIG;IACH,OAAO,CAAC,wBAAwB;CAkBjC"}

package/dist/ImageGenerationService.js

@@ -3,10 +3,33 @@
 /**
  * @fileoverview Image generation service backed by AgentOS's shared
  * provider-agnostic image API.
+ *
+ * Image data a provider returns is saved and the result carries the saved
+ * copy's URL, never the data: see `imageFiles.ts`.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ImageGenerationService = void 0;
 const agentos_1 = require("@framers/agentos");
+const imageFiles_js_1 = require("./imageFiles.js");
+/**
+ * OpenAI's model for making an image from a prompt. OpenAI shut down
+ * `dall-e-2` and `dall-e-3` on 2026-05-12, and shuts down `gpt-image-1` on
+ * 2026-10-23 and `gpt-image-1.5` on 2026-12-01
+ * (https://developers.openai.com/api/docs/deprecations).
+ */
+const OPENAI_IMAGE_MODEL = 'gpt-image-2.5-flare';
+/** Whether `model` names one of OpenAI's GPT Image models. */
+function isGptImageModel(model) {
+    return /^(gpt-image-|chatgpt-image-)/.test(model);
+}
+/**
+ * What a GPT Image model is told for a style, in the prompt: it takes no
+ * `style` parameter, which was DALL·E 3's.
+ */
+const STYLE_SENTENCE = {
+    vivid: 'Style: vivid, hyper-real and dramatic.',
+    natural: 'Style: natural and realistic.',
+};
 const PROVIDER_DOCS_URL = {
     openai: 'https://platform.openai.com/api-keys',
     openrouter: 'https://openrouter.ai/settings/keys',
@@ -17,6 +40,7 @@ class ImageGenerationService {
     constructor(config) {
         this.initialized = false;
         this.config = config;
+        this.store = (0, imageFiles_js_1.imageStore)(config);
     }
     get hasOpenAI() {
         return !!this.config.openaiApiKey;
@@ -36,7 +60,15 @@ class ImageGenerationService {
     async initialize() {
         this.initialized = true;
     }
-    async generateImage(options) {
+    /**
+     * Generates one image.
+     *
+     * @param options - The prompt and its settings.
+     * @param context - The tool call's context, when there is one: image data
+     *   is saved in the calling user's own subdirectory and handed to a host's
+     *   `saveImage` with it.
+     */
+    async generateImage(options, context) {
         const provider = this.resolveProvider(options.provider);
         const apiKey = this.getApiKey(provider);
         if (!apiKey) {
@@ -44,27 +76,30 @@ class ImageGenerationService {
             throw new Error(`${envVar} is required for ${this.displayNameForProvider(provider)} image generation. `
                 + `Set it in your environment or .env file. Get one at ${PROVIDER_DOCS_URL[provider]}`);
         }
-        const providerOptions = this.normalizeProviderOptions(provider, options);
         const model = options.model || this.config.defaultModel || this.defaultModelForProvider(provider);
+        // A GPT Image model takes neither DALL·E 3's quality names nor its
+        // `style` parameter: the names are rewritten, and a style goes into the
+        // prompt.
+        const gptImage = provider === 'openai' && isGptImageModel(model);
+        const quality = options.quality || this.config.defaultQuality;
+        const style = gptImage && options.style ? STYLE_SENTENCE[options.style] : undefined;
         const result = await (0, agentos_1.generateImage)({
             model: `${provider}:${model}`,
-            prompt: options.prompt,
+            prompt: style ? `${options.prompt}\n\n${style}` : options.prompt,
             apiKey,
             size: options.size || this.config.defaultSize || '1024x1024',
             aspectRatio: options.aspectRatio,
-            quality: options.quality || this.config.defaultQuality || 'standard',
+            quality: gptImage ? gptImageQuality(quality) : quality,
             n: options.n,
             seed: options.seed,
             negativePrompt: options.negativePrompt,
-            providerOptions,
+            providerOptions: this.normalizeProviderOptions(provider, options, gptImage),
         });
-        const first = result.images[0];
+        const first = result.images?.[0];
         if (!first) {
             throw new Error('Image generation returned no images.');
         }
-        const url = first.url || first.dataUrl || (first.base64
-            ? `data:${first.mimeType || 'image/png'};base64,${first.base64}`
-            : undefined);
+        const url = await (0, imageFiles_js_1.storeImage)(first, 'generate_image', this.store, context);
         if (!url) {
             throw new Error('Image generation returned no image URL or image data.');
         }
@@ -113,7 +148,7 @@ class ImageGenerationService {
     defaultModelForProvider(provider) {
         switch (provider) {
             case 'openai':
-                return 'dall-e-3';
+                return OPENAI_IMAGE_MODEL;
             case 'openrouter':
                 return 'google/gemini-2.5-flash-image';
             case 'stability':
@@ -121,7 +156,7 @@ class ImageGenerationService {
             case 'replicate':
                 return 'black-forest-labs/flux-schnell';
             default:
-                return 'gpt-image-1';
+                return OPENAI_IMAGE_MODEL;
         }
     }
     displayNameForProvider(provider) {
@@ -138,34 +173,33 @@ class ImageGenerationService {
                 return provider;
         }
     }
-    normalizeProviderOptions(provider, options) {
-        if (!options.providerOptions && !options.style && provider !== 'openai') {
-            return undefined;
-        }
-        const providerOptions = options.providerOptions && typeof options.providerOptions === 'object' && !Array.isArray(options.providerOptions)
+    /**
+     * The provider options of a call. A `style` goes to an OpenAI model that
+     * is not a GPT Image model (one behind a gateway) as its `style` parameter;
+     * a GPT Image model is sent none, from the call or from the options.
+     */
+    normalizeProviderOptions(provider, options, gptImage) {
+        const given = options.providerOptions && typeof options.providerOptions === 'object' && !Array.isArray(options.providerOptions)
             ? { ...options.providerOptions }
             : undefined;
-        if (provider === 'openai' && options.style) {
-            const openAIOptions = {
-                ...(providerOptions?.openai ?? {}),
-                style: options.style,
-            };
-            return {
-                ...(providerOptions ?? {}),
-                openai: openAIOptions,
-            };
+        if (provider !== 'openai')
+            return given;
+        if (gptImage) {
+            if (!given?.openai || typeof given.openai !== 'object')
+                return given;
+            const { style: _style, ...openai } = given.openai;
+            return { ...given, openai };
         }
-        if (provider === 'openai') {
-            return {
-                ...(providerOptions ?? {}),
-                openai: {
-                    ...(providerOptions?.openai ?? {}),
-                    style: options.style ?? providerOptions?.openai?.style ?? 'vivid',
-                },
-            };
-        }
-        return providerOptions;
+        if (!options.style)
+            return given;
+        return { ...(given ?? {}), openai: { ...(given?.openai ?? {}), style: options.style } };
     }
 }
 exports.ImageGenerationService = ImageGenerationService;
+/** The quality a GPT Image model is sent: `medium` when none is given, and for DALL·E 3's `standard`; `high` for its `hd`. */
+function gptImageQuality(quality) {
+    if (!quality || quality === 'standard')
+        return 'medium';
+    return quality === 'hd' ? 'high' : quality;
+}
 //# sourceMappingURL=ImageGenerationService.js.map

package/dist/ImageGenerationService.js.map

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

package/dist/imageFiles.d.ts

@@ -0,0 +1,113 @@
+/**
+ * @fileoverview Where the image tools keep image data, and how a saved image
+ * comes back as a source.
+ *
+ * A provider that answers with image data (OpenAI's GPT Image models always
+ * do) used to have that data returned to the model as a `data:` URL: megabytes
+ * of base64 in the next request. The tools save the bytes to a file and return
+ * its `file:` URL, or hand them to the host's own saver. A saved file's URL is
+ * accepted as a source by the image-editing tools and by `vision-pipeline`.
+ * The image-generation, image-editing and vision-pipeline packs each carry
+ * this file, the same in all three, so they agree on the directory.
+ *
+ * The directory is private to the service's user, each caller has a
+ * subdirectory of its own, and no other user can change a directory above
+ * it. That is the trust boundary: only this user can put a file there, or
+ * swap the directory for another, so a file there with the saver's name
+ * pattern is one the service wrote.
+ */
+/** The most bytes of a saved image the tools read back as a source: 50 MiB. */
+export declare const MAX_SOURCE_BYTES: number;
+/**
+ * The images directory: the pack option `imageDir`, else the environment
+ * variable `AGENTOS_IMAGE_DIR`, else a folder in the user's temp directory,
+ * which the operating system clears (the packs delete nothing). On POSIX the
+ * default carries the user id, since `/tmp` is shared. On Windows it is the
+ * user's own temp folder whatever `TEMP` says: `os.tmpdir()` reads `TEMP`,
+ * which can name a folder every user shares.
+ */
+export declare function imageDirectory(option?: unknown): string;
+/**
+ * The name of a caller's subdirectory: `u-` and 32 hex characters of the
+ * SHA-256 of its user id, or `shared` for a call that carries none. A host
+ * with several users gives each call its user (`context.userContext.userId`),
+ * so one user's saved image is no source for another.
+ */
+export declare function scopeOf(context?: {
+    userContext?: {
+        userId?: unknown;
+    };
+}): string;
+/** The kind of image `bytes` are, by their signature: PNG, JPEG or WebP. */
+export declare function imageKind(bytes: Buffer): {
+    ext: 'png' | 'jpg' | 'webp';
+    mimeType: string;
+} | undefined;
+/**
+ * Saves image bytes as a new file in the caller's subdirectory of `dir` and
+ * returns its `file:` URL. The extension comes from the bytes' signature, and
+ * the name is random, so a file is never overwritten.
+ *
+ * @throws When the bytes are not a PNG, JPEG or WebP image, or when the
+ *   directory cannot be made, is not private to this user, or cannot be
+ *   written. The message names the directory and the option that sets it.
+ */
+export declare function saveImageFile(bytes: Buffer, dir: string, scope: string): Promise<string>;
+/**
+ * The bytes of the saved image that `source` names, or `undefined` when
+ * `source` is not the `file:` URL of an image the saver wrote for this
+ * caller. Every reason gives `undefined`, so the caller's one refusal does
+ * not tell which files exist.
+ *
+ * The file must carry the saver's name pattern and sit directly in the
+ * caller's subdirectory of the images directory's real path: the same
+ * directory by device and inode, itself a directory and not a link, private
+ * to this user, as the images directory is, with no directory above it that
+ * another user can change. It must be a regular file with one link and at
+ * most {@link MAX_SOURCE_BYTES}, and start with a PNG, JPEG or WebP
+ * signature. It is opened once, without following a link, and read from
+ * that handle.
+ */
+export declare function readSavedImage(source: string, dir: string, scope: string): Promise<Buffer | undefined>;
+/** An image as AgentOS's image functions return it. */
+export interface ReturnedImage {
+    url?: string;
+    dataUrl?: string;
+    base64?: string;
+    mimeType?: string;
+}
+/**
+ * A host's own saver: it stores the bytes where the host's clients can load
+ * them and returns that http(s) URL.
+ */
+export type SaveImage = (image: {
+    bytes: Buffer;
+    mimeType: string;
+    tool: string;
+    context?: unknown;
+}) => string | Promise<string>;
+/** Where the tools keep image data: the directory of the default saver, and a host's own saver when it gave one. */
+export interface ImageStore {
+    /** The images directory (see {@link imageDirectory}). */
+    dir: string;
+    /** The host's saver, which replaces the default. */
+    saveImage?: SaveImage;
+}
+/** The store for a pack's options: its `imageDir` and its `saveImage`, when that is a function. */
+export declare function imageStore(options?: {
+    imageDir?: unknown;
+    saveImage?: unknown;
+}): ImageStore;
+/**
+ * An image a provider returned, as the reference the caller gets: the
+ * provider's http(s) URL as it is, or, for image data, the URL under which
+ * it was saved. Image data is never returned itself: as a `data:` URL it
+ * would go into the model's next request, megabytes of base64. `undefined`
+ * when the provider returned neither a URL nor data.
+ *
+ * @throws When the data is not a PNG, JPEG or WebP image, when it cannot be
+ *   saved, or when the host's saver throws or returns anything but an
+ *   http(s) URL of at most 2,048 characters.
+ */
+export declare function storeImage(image: ReturnedImage | undefined, tool: string, store: ImageStore, context?: unknown): Promise<string | undefined>;
+//# sourceMappingURL=imageFiles.d.ts.map

package/dist/imageFiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageFiles.d.ts","sourceRoot":"","sources":["../src/imageFiles.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;GAiBG;AASH,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,QAAmB,CAAC;AAQjD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAOvD;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GAAG,MAAM,CAKhF;AAED,4EAA4E;AAC5E,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAStG;AAsCD;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAuB9F;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA+C5G;AAED,uDAAuD;AACvD,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAE/B,oHAAoH;AACpH,MAAM,WAAW,UAAU;IACzB,yDAAyD;IACzD,GAAG,EAAE,MAAM,CAAC;IACZ,oDAAoD;IACpD,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,mGAAmG;AACnG,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,UAAU,CAK5F;AAwBD;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,aAAa,GAAG,SAAS,EAChC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,UAAU,EACjB,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAgB7B"}

package/dist/imageFiles.js

@@ -0,0 +1,325 @@
+"use strict";
+// @ts-nocheck
+/**
+ * @fileoverview Where the image tools keep image data, and how a saved image
+ * comes back as a source.
+ *
+ * A provider that answers with image data (OpenAI's GPT Image models always
+ * do) used to have that data returned to the model as a `data:` URL: megabytes
+ * of base64 in the next request. The tools save the bytes to a file and return
+ * its `file:` URL, or hand them to the host's own saver. A saved file's URL is
+ * accepted as a source by the image-editing tools and by `vision-pipeline`.
+ * The image-generation, image-editing and vision-pipeline packs each carry
+ * this file, the same in all three, so they agree on the directory.
+ *
+ * The directory is private to the service's user, each caller has a
+ * subdirectory of its own, and no other user can change a directory above
+ * it. That is the trust boundary: only this user can put a file there, or
+ * swap the directory for another, so a file there with the saver's name
+ * pattern is one the service wrote.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_SOURCE_BYTES = void 0;
+exports.imageDirectory = imageDirectory;
+exports.scopeOf = scopeOf;
+exports.imageKind = imageKind;
+exports.saveImageFile = saveImageFile;
+exports.readSavedImage = readSavedImage;
+exports.imageStore = imageStore;
+exports.storeImage = storeImage;
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const fs = __importStar(require("node:fs/promises"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const node_url_1 = require("node:url");
+/** The most bytes of a saved image the tools read back as a source: 50 MiB. */
+exports.MAX_SOURCE_BYTES = 50 * 1024 * 1024;
+/** The name of a file the saver wrote. */
+const SAVED_NAME = /^agentos-image-[0-9a-f]{32}\.(png|jpg|webp)$/;
+/** The eight bytes every PNG starts with. */
+const PNG_SIGNATURE = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]);
+/**
+ * The images directory: the pack option `imageDir`, else the environment
+ * variable `AGENTOS_IMAGE_DIR`, else a folder in the user's temp directory,
+ * which the operating system clears (the packs delete nothing). On POSIX the
+ * default carries the user id, since `/tmp` is shared. On Windows it is the
+ * user's own temp folder whatever `TEMP` says: `os.tmpdir()` reads `TEMP`,
+ * which can name a folder every user shares.
+ */
+function imageDirectory(option) {
+    const named = [option, process.env.AGENTOS_IMAGE_DIR]
+        .map((value) => (typeof value === 'string' ? value.trim() : ''))
+        .find(Boolean);
+    if (named)
+        return path.resolve(named);
+    if (typeof process.getuid === 'function')
+        return path.join(os.tmpdir(), `agentos-images-${process.getuid()}`);
+    return path.join(os.homedir(), 'AppData', 'Local', 'Temp', 'agentos-images');
+}
+/**
+ * The name of a caller's subdirectory: `u-` and 32 hex characters of the
+ * SHA-256 of its user id, or `shared` for a call that carries none. A host
+ * with several users gives each call its user (`context.userContext.userId`),
+ * so one user's saved image is no source for another.
+ */
+function scopeOf(context) {
+    const userId = context?.userContext?.userId;
+    return typeof userId === 'string' && userId !== ''
+        ? `u-${(0, node_crypto_1.createHash)('sha256').update(userId).digest('hex').slice(0, 32)}`
+        : 'shared';
+}
+/** The kind of image `bytes` are, by their signature: PNG, JPEG or WebP. */
+function imageKind(bytes) {
+    if (bytes.length >= 8 && bytes.subarray(0, 8).equals(PNG_SIGNATURE))
+        return { ext: 'png', mimeType: 'image/png' };
+    if (bytes.length >= 3 && bytes[0] === 0xff && bytes[1] === 0xd8 && bytes[2] === 0xff) {
+        return { ext: 'jpg', mimeType: 'image/jpeg' };
+    }
+    if (bytes.length >= 12 && bytes.toString('latin1', 0, 4) === 'RIFF' && bytes.toString('latin1', 8, 12) === 'WEBP') {
+        return { ext: 'webp', mimeType: 'image/webp' };
+    }
+    return undefined;
+}
+/**
+ * Whether a directory's `stat` (taken with `bigint: true`) shows it private
+ * to this user: a directory this user owns that neither its group nor others
+ * can write. Where the platform has no user ids (Windows) only the kind is
+ * checked: the default there is inside the user's own profile.
+ */
+function isPrivateDirectory(stat) {
+    if (!stat.isDirectory())
+        return false;
+    if (typeof process.getuid !== 'function')
+        return true;
+    return stat.uid === BigInt(process.getuid()) && (stat.mode & BigInt(0o022)) === BigInt(0);
+}
+/**
+ * Whether no other user can rename or replace `dir`, a real path, through a
+ * directory above it: each one is owned by this user or by root, and none
+ * can be written by its group or by others unless it is sticky (as `/tmp`
+ * is), where only an entry's owner can rename it. Where the platform has no
+ * user ids (Windows) nothing is checked.
+ */
+async function hasTrustedParents(dir) {
+    if (typeof process.getuid !== 'function')
+        return true;
+    const uid = BigInt(process.getuid());
+    for (let parent = path.dirname(dir);; parent = path.dirname(parent)) {
+        const stat = await fs.lstat(parent, { bigint: true });
+        const sticky = (stat.mode & BigInt(0o1000)) !== BigInt(0);
+        const writableByOthers = (stat.mode & BigInt(0o022)) !== BigInt(0);
+        if (!stat.isDirectory() || (stat.uid !== uid && stat.uid !== BigInt(0)) || (writableByOthers && !sticky))
+            return false;
+        if (path.dirname(parent) === parent)
+            return true;
+    }
+}
+/** The error for a directory that is not private to this user. */
+function notPrivate(dir) {
+    return new Error(`${dir} is not a directory that this user owns and no one else can write`);
+}
+/**
+ * Saves image bytes as a new file in the caller's subdirectory of `dir` and
+ * returns its `file:` URL. The extension comes from the bytes' signature, and
+ * the name is random, so a file is never overwritten.
+ *
+ * @throws When the bytes are not a PNG, JPEG or WebP image, or when the
+ *   directory cannot be made, is not private to this user, or cannot be
+ *   written. The message names the directory and the option that sets it.
+ */
+async function saveImageFile(bytes, dir, scope) {
+    const kind = imageKind(bytes);
+    if (!kind)
+        throw new Error('The provider returned data that is not a PNG, JPEG or WebP image.');
+    try {
+        // The directory is written by its real path, which no other user can
+        // change once the directories above it are checked.
+        await fs.mkdir(dir, { recursive: true, mode: 0o700 });
+        const root = await fs.realpath(dir);
+        if (!isPrivateDirectory(await fs.stat(root, { bigint: true })))
+            throw notPrivate(root);
+        if (!(await hasTrustedParents(root)))
+            throw new Error(`another user can change a directory above ${root}`);
+        const scopeDir = path.join(root, scope);
+        await fs.mkdir(scopeDir, { recursive: true, mode: 0o700 });
+        // lstat: a caller's directory that is a link to another caller's is refused.
+        if (!isPrivateDirectory(await fs.lstat(scopeDir, { bigint: true })))
+            throw notPrivate(scopeDir);
+        const file = path.join(scopeDir, `agentos-image-${(0, node_crypto_1.randomBytes)(16).toString('hex')}.${kind.ext}`);
+        await fs.writeFile(file, bytes, { flag: 'wx', mode: 0o600 });
+        return (0, node_url_1.pathToFileURL)(file).href;
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        throw new Error(`The image could not be saved under ${dir}: ${reason}. Set the pack's imageDir option, or AGENTOS_IMAGE_DIR, to a directory that the service's user owns and no one else can write.`);
+    }
+}
+/**
+ * The bytes of the saved image that `source` names, or `undefined` when
+ * `source` is not the `file:` URL of an image the saver wrote for this
+ * caller. Every reason gives `undefined`, so the caller's one refusal does
+ * not tell which files exist.
+ *
+ * The file must carry the saver's name pattern and sit directly in the
+ * caller's subdirectory of the images directory's real path: the same
+ * directory by device and inode, itself a directory and not a link, private
+ * to this user, as the images directory is, with no directory above it that
+ * another user can change. It must be a regular file with one link and at
+ * most {@link MAX_SOURCE_BYTES}, and start with a PNG, JPEG or WebP
+ * signature. It is opened once, without following a link, and read from
+ * that handle.
+ */
+async function readSavedImage(source, dir, scope) {
+    let handle;
+    try {
+        const url = new URL(source);
+        if (url.protocol !== 'file:' || url.hostname !== '')
+            return undefined;
+        const named = (0, node_url_1.fileURLToPath)(url);
+        if (!SAVED_NAME.test(path.basename(named)))
+            return undefined;
+        // fs.promises.realpath asks the operating system. (fs.realpathSync and
+        // fs.realpath resolve ".." in the text first, as path.resolve does.)
+        const real = await fs.realpath(named);
+        if (!SAVED_NAME.test(path.basename(real)))
+            return undefined;
+        // The images directory as it is now, by its real path, so a directory
+        // swapped in for it is read as what it is; and the caller's directory in
+        // it by lstat, so a link to another caller's directory is refused.
+        const root = await fs.realpath(dir);
+        const [rootDir, parent, scopeDir] = await Promise.all([
+            fs.stat(root, { bigint: true }),
+            fs.stat(path.dirname(real), { bigint: true }),
+            fs.lstat(path.join(root, scope), { bigint: true }),
+        ]);
+        if (!isPrivateDirectory(rootDir) || !isPrivateDirectory(scopeDir))
+            return undefined;
+        if (parent.dev !== scopeDir.dev || parent.ino !== scopeDir.ino)
+            return undefined;
+        if (!(await hasTrustedParents(root)))
+            return undefined;
+        // A FIFO would hold an open until a writer came; only a regular file is opened.
+        if (!(await fs.lstat(real)).isFile())
+            return undefined;
+        handle = await fs.open(real, node_fs_1.constants.O_RDONLY | (node_fs_1.constants.O_NOFOLLOW ?? 0) | (node_fs_1.constants.O_NONBLOCK ?? 0));
+        const stat = await handle.stat();
+        if (!stat.isFile() || stat.nlink !== 1 || stat.size > exports.MAX_SOURCE_BYTES)
+            return undefined;
+        // One byte more than the size at open: a file that has grown is refused.
+        const buffer = Buffer.alloc(stat.size + 1);
+        let length = 0;
+        while (length < buffer.length) {
+            const { bytesRead } = await handle.read(buffer, length, buffer.length - length, null);
+            if (bytesRead === 0)
+                break;
+            length += bytesRead;
+        }
+        if (length > stat.size)
+            return undefined;
+        const bytes = buffer.subarray(0, length);
+        return imageKind(bytes) ? bytes : undefined;
+    }
+    catch {
+        return undefined;
+    }
+    finally {
+        await handle?.close().catch(() => { });
+    }
+}
+/** The store for a pack's options: its `imageDir` and its `saveImage`, when that is a function. */
+function imageStore(options) {
+    return {
+        dir: imageDirectory(options?.imageDir),
+        saveImage: typeof options?.saveImage === 'function' ? options.saveImage : undefined,
+    };
+}
+/** The longest reference a host's saver may return. */
+const MAX_REFERENCE_LENGTH = 2048;
+/** The bytes of a base64 `data:` URL, the form AgentOS's providers give image data in; `undefined` for anything else. */
+function dataUrlBytes(value) {
+    if (typeof value !== 'string' || !/^data:/i.test(value))
+        return undefined;
+    const comma = value.indexOf(',');
+    if (comma === -1 || !/; *base64 *$/i.test(value.slice(0, comma)))
+        return undefined;
+    return Buffer.from(value.slice(comma + 1), 'base64');
+}
+/** Whether a saver's result is an http(s) URL short enough to hand to the model. */
+function isHttpReference(value) {
+    if (typeof value !== 'string' || value.length === 0 || value.length > MAX_REFERENCE_LENGTH)
+        return false;
+    try {
+        const { protocol } = new URL(value);
+        return protocol === 'http:' || protocol === 'https:';
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * An image a provider returned, as the reference the caller gets: the
+ * provider's http(s) URL as it is, or, for image data, the URL under which
+ * it was saved. Image data is never returned itself: as a `data:` URL it
+ * would go into the model's next request, megabytes of base64. `undefined`
+ * when the provider returned neither a URL nor data.
+ *
+ * @throws When the data is not a PNG, JPEG or WebP image, when it cannot be
+ *   saved, or when the host's saver throws or returns anything but an
+ *   http(s) URL of at most 2,048 characters.
+ */
+async function storeImage(image, tool, store, context) {
+    if (!image)
+        return undefined;
+    if (typeof image.url === 'string' && /^https?:\/\//i.test(image.url))
+        return image.url;
+    const bytes = typeof image.base64 === 'string' && image.base64 !== ''
+        ? Buffer.from(image.base64, 'base64')
+        : (dataUrlBytes(image.dataUrl) ?? dataUrlBytes(image.url));
+    if (!bytes || bytes.length === 0)
+        return undefined;
+    if (!store.saveImage)
+        return saveImageFile(bytes, store.dir, scopeOf(context));
+    const kind = imageKind(bytes);
+    if (!kind)
+        throw new Error('The provider returned data that is not a PNG, JPEG or WebP image.');
+    const reference = await store.saveImage({ bytes, mimeType: kind.mimeType, tool, context });
+    if (!isHttpReference(reference)) {
+        throw new Error("The host's saveImage must return an http(s) URL of at most 2,048 characters.");
+    }
+    return reference;
+}
+//# sourceMappingURL=imageFiles.js.map

package/dist/imageFiles.js.map

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

package/dist/index.d.ts

@@ -1,4 +1,15 @@
+/**
+ * @fileoverview Image Generation Extension Pack: the `generate_image` tool on
+ * AgentOS's `generateImage`, with OpenAI, OpenRouter, Stability AI and
+ * Replicate.
+ *
+ * Image data a provider returns is saved, never returned: to a file in the
+ * images directory (`imageDir`, `AGENTOS_IMAGE_DIR`, or a folder in the
+ * user's temp directory), or by the host's `saveImage`.
+ */
 import type { ExtensionPackContext, ExtensionPack } from '@framers/agentos';
+import { type ImageQuality } from './ImageGenerationService.js';
+import type { SaveImage } from './imageFiles.js';
 export interface ImageGenerationOptions {
     openaiApiKey?: string;
     openrouterApiKey?: string;
@@ -7,11 +18,30 @@ export interface ImageGenerationOptions {
     defaultProvider?: 'openai' | 'openrouter' | 'stability' | 'replicate';
     defaultModel?: string;
     defaultSize?: string;
-    defaultQuality?: 'standard' | 'hd';
+    defaultQuality?: ImageQuality;
+    /**
+     * Where image data a provider returns is saved, each caller in a
+     * subdirectory of its own (else `AGENTOS_IMAGE_DIR`, else a folder in the
+     * user's temp directory). The directory must belong to the service's user,
+     * with no one else able to write it, and every directory above it to that
+     * user or root, writable by no one else unless it is sticky as `/tmp` is. The image-editing and
+     * vision-pipeline packs take the same option: give all three the same
+     * directory, so an image this pack saved is a source for them.
+     */
+    imageDir?: string;
+    /**
+     * Stores image data in place of the default saver and returns the http(s)
+     * URL under which the host's clients load it. A `file:` URL names a file
+     * on the machine that ran the tool, so a host whose clients are elsewhere
+     * sets this.
+     */
+    saveImage?: SaveImage;
     priority?: number;
 }
 export declare function createExtensionPack(context: ExtensionPackContext): ExtensionPack;
 export { ImageGenerationService } from './ImageGenerationService.js';
+export type { ImageGenerationConfig, GenerateImageOptions, GeneratedImage, ImageQuality } from './ImageGenerationService.js';
+export type { ImageStore, SaveImage } from './imageFiles.js';
 export { GenerateImageTool } from './tools/generateImage.js';
 export default createExtensionPack;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,oBAAoB,EACpB,aAAa,EAEd,MAAM,kBAAkB,CAAC;AAK1B,MAAM,WAAW,sBAAsB;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,QAAQ,GAAG,YAAY,GAAG,WAAW,GAAG,WAAW,CAAC;IACtE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAsEhF;AAED,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA;;;;;;;;GAQG;AACH,OAAO,KAAK,EACV,oBAAoB,EACpB,aAAa,EAEd,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAA0B,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAC;AACxF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAOjD,MAAM,WAAW,sBAAsB;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,QAAQ,GAAG,YAAY,GAAG,WAAW,GAAG,WAAW,CAAC;IACtE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,YAAY,CAAC;IAC9B;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAwEhF;AAED,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC7H,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,eAAe,mBAAmB,CAAC"}

package/dist/index.js

@@ -4,6 +4,9 @@ exports.GenerateImageTool = exports.ImageGenerationService = void 0;
 exports.createExtensionPack = createExtensionPack;
 const ImageGenerationService_js_1 = require("./ImageGenerationService.js");
 const generateImage_js_1 = require("./tools/generateImage.js");
+// This pack compiles to CommonJS, where `require` reads the package's own
+// version: `import.meta` does not exist there.
+const { version } = require('../package.json');
 function createExtensionPack(context) {
     const options = (context.options ?? {});
     const openaiApiKey = options.openaiApiKey ||
@@ -27,11 +30,13 @@ function createExtensionPack(context) {
         defaultModel: options.defaultModel,
         defaultSize: options.defaultSize,
         defaultQuality: options.defaultQuality,
+        imageDir: options.imageDir,
+        saveImage: options.saveImage,
     });
     const tool = new generateImage_js_1.GenerateImageTool(service);
     return {
         name: '@framers/agentos-ext-image-generation',
-        version: '1.0.0',
+        version,
         descriptors: [
             {
                 id: tool.name,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAsBA,kDAsEC;AArFD,2EAAqE;AACrE,+DAA6D;AAc7D,SAAgB,mBAAmB,CAAC,OAA6B;IAC/D,MAAM,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAA2B,CAAC;IAElE,MAAM,YAAY,GAChB,OAAO,CAAC,YAAY;QACpB,OAAO,CAAC,SAAS,EAAE,CAAC,eAAe,CAAC;QACpC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAE7B,MAAM,gBAAgB,GACpB,OAAO,CAAC,gBAAgB;QACxB,OAAO,CAAC,SAAS,EAAE,CAAC,mBAAmB,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAEjC,MAAM,eAAe,GACnB,OAAO,CAAC,eAAe;QACvB,OAAO,CAAC,SAAS,EAAE,CAAC,kBAAkB,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAEhC,MAAM,iBAAiB,GACrB,OAAO,CAAC,iBAAiB;QACzB,OAAO,CAAC,SAAS,EAAE,CAAC,oBAAoB,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IAElC,MAAM,OAAO,GAAG,IAAI,kDAAsB,CAAC;QACzC,YAAY;QACZ,gBAAgB;QAChB,eAAe;QACf,iBAAiB;QACjB,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,cAAc,EAAE,OAAO,CAAC,cAAc;KACvC,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,IAAI,oCAAiB,CAAC,OAAO,CAAC,CAAC;IAE5C,OAAO;QACL,IAAI,EAAE,uCAAuC;QAC7C,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE;YACX;gBACE,EAAE,EAAE,IAAI,CAAC,IAAI;gBACb,IAAI,EAAE,MAAM;gBACZ,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;gBAChC,OAAO,EAAE,IAAI;gBACb,eAAe,EAAE;oBACf,EAAE,EAAE,EAAE,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE;oBACvC,EAAE,EAAE,EAAE,mBAAmB,EAAE,QAAQ,EAAE,IAAI,EAAE;oBAC3C,EAAE,EAAE,EAAE,kBAAkB,EAAE,QAAQ,EAAE,IAAI,EAAE;oBAC1C,EAAE,EAAE,EAAE,oBAAoB,EAAE,QAAQ,EAAE,IAAI,EAAE;iBAC7C;aACF;SACF;QACD,UAAU,EAAE,KAAK,EAAE,EAA8B,EAAE,EAAE;YACnD,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;YAC3B,MAAM,SAAS,GAAa,EAAE,CAAC;YAC/B,IAAI,OAAO,CAAC,SAAS;gBAAE,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAChD,IAAI,OAAO,CAAC,aAAa;gBAAE,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACxD,IAAI,OAAO,CAAC,YAAY;gBAAE,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACzD,IAAI,OAAO,CAAC,YAAY;gBAAE,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACtD,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC;gBACjC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC;gBACvB,CAAC,CAAC,4GAA4G,CAAC;YACjH,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,0CAA0C,MAAM,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,YAAY,EAAE,KAAK,EAAE,EAA8B,EAAE,EAAE;YACrD,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC;YACzB,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,wCAAwC,CAAC,CAAC;QAC7D,CAAC;KACF,CAAC;AACJ,CAAC;AAED,yEAAqE;AAA5D,mIAAA,sBAAsB,OAAA;AAC/B,6DAA6D;AAApD,qHAAA,iBAAiB,OAAA;AAC1B,kBAAe,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/generateImage.d.ts

@@ -6,16 +6,18 @@ import type { ITool, JSONSchemaObject, ToolExecutionContext, ToolExecutionResult
 import type { ImageGenerationService } from '../ImageGenerationService.js';
 export interface GenerateImageInput {
     prompt: string;
-    size?: '1024x1024' | '1792x1024' | '1024x1792';
+    size?: '1024x1024' | '1536x1024' | '1024x1536' | '1792x1024' | '1024x1792';
     aspectRatio?: string;
-    quality?: 'standard' | 'hd';
+    quality?: 'low' | 'medium' | 'high' | 'auto' | 'standard' | 'hd';
     style?: 'vivid' | 'natural';
     provider?: 'openai' | 'openrouter' | 'stability' | 'replicate';
+    /** The provider's own model id, without a provider prefix. */
     model?: string;
     seed?: number;
     negativePrompt?: string;
 }
 export interface GenerateImageOutput {
+    /** The image as a URL: the provider's, or the file: URL of the copy that was saved of the image data it returned. */
     url: string;
     revisedPrompt?: string;
     provider: string;
@@ -26,12 +28,20 @@ export declare class GenerateImageTool implements ITool<GenerateImageInput, Gene
     readonly id = "tool.generate_image";
     readonly name = "generate_image";
     readonly displayName = "Generate Image";
-    readonly description = "Generate an image from a text prompt using the configured image providers. Returns a URL or data URL to the generated image.";
+    readonly description: string;
     readonly category = "media";
     readonly hasSideEffects = false;
     readonly inputSchema: JSONSchemaObject;
     private service;
     constructor(service: ImageGenerationService);
-    execute(args: GenerateImageInput, _context?: ToolExecutionContext): Promise<ToolExecutionResult<GenerateImageOutput>>;
+    execute(args: GenerateImageInput, context?: ToolExecutionContext): Promise<ToolExecutionResult<GenerateImageOutput>>;
+    /**
+     * The service call for a tool call's arguments, or the error for an
+     * argument the schema does not allow. Only the schema's own fields are
+     * taken: the model writes the arguments, and anything else it adds (`n`,
+     * `providerOptions`, whose `extraBody` goes into the provider's request)
+     * is not passed on.
+     */
+    private optionsFrom;
 }
 //# sourceMappingURL=generateImage.d.ts.map

package/dist/tools/generateImage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generateImage.d.ts","sourceRoot":"","sources":["../../src/tools/generateImage.ts"],"names":[],"mappings":"AACA;;;GAGG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC3G,OAAO,KAAK,EAAE,sBAAsB,EAAwB,MAAM,8BAA8B,CAAC;AAEjG,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,WAAW,CAAC;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,QAAQ,CAAC,EAAE,QAAQ,GAAG,YAAY,GAAG,WAAW,GAAG,WAAW,CAAC;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,iBAAkB,YAAW,KAAK,CAAC,kBAAkB,EAAE,mBAAmB,CAAC;IACtF,QAAQ,CAAC,EAAE,yBAAyB;IACpC,QAAQ,CAAC,IAAI,oBAAoB;IACjC,QAAQ,CAAC,WAAW,oBAAoB;IACxC,QAAQ,CAAC,WAAW,kIAAkI;IACtJ,QAAQ,CAAC,QAAQ,WAAW;IAC5B,QAAQ,CAAC,cAAc,SAAS;IAEhC,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CA6CpC;IAEF,OAAO,CAAC,OAAO,CAAyB;gBAE5B,OAAO,EAAE,sBAAsB;IAIrC,OAAO,CACX,IAAI,EAAE,kBAAkB,EACxB,QAAQ,CAAC,EAAE,oBAAoB,GAC9B,OAAO,CAAC,mBAAmB,CAAC,mBAAmB,CAAC,CAAC;CA8BrD"}
+{"version":3,"file":"generateImage.d.ts","sourceRoot":"","sources":["../../src/tools/generateImage.ts"],"names":[],"mappings":"AACA;;;GAGG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC3G,OAAO,KAAK,EAAE,sBAAsB,EAAwB,MAAM,8BAA8B,CAAC;AAEjG,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,CAAC;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IACjE,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,QAAQ,CAAC,EAAE,QAAQ,GAAG,YAAY,GAAG,WAAW,GAAG,WAAW,CAAC;IAC/D,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,qHAAqH;IACrH,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AASD,qBAAa,iBAAkB,YAAW,KAAK,CAAC,kBAAkB,EAAE,mBAAmB,CAAC;IACtF,QAAQ,CAAC,EAAE,yBAAyB;IACpC,QAAQ,CAAC,IAAI,oBAAoB;IACjC,QAAQ,CAAC,WAAW,oBAAoB;IACxC,QAAQ,CAAC,WAAW,SAEgH;IACpI,QAAQ,CAAC,QAAQ,WAAW;IAC5B,QAAQ,CAAC,cAAc,SAAS;IAEhC,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CA6CpC;IAEF,OAAO,CAAC,OAAO,CAAyB;gBAE5B,OAAO,EAAE,sBAAsB;IAIrC,OAAO,CACX,IAAI,EAAE,kBAAkB,EACxB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,mBAAmB,CAAC,mBAAmB,CAAC,CAAC;IAiCpD;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;CAsBpB"}

package/dist/tools/generateImage.js

@@ -6,12 +6,19 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GenerateImageTool = void 0;
+const SIZES = ['1024x1024', '1536x1024', '1024x1536', '1792x1024', '1024x1792'];
+const QUALITIES = ['low', 'medium', 'high', 'auto', 'standard', 'hd'];
+const STYLES = ['vivid', 'natural'];
+const PROVIDERS = ['openai', 'openrouter', 'stability', 'replicate'];
+/** The arguments that are optional strings with no list of values. */
+const STRING_FIELDS = ['aspectRatio', 'model', 'negativePrompt'];
 class GenerateImageTool {
     constructor(service) {
         this.id = 'tool.generate_image';
         this.name = 'generate_image';
         this.displayName = 'Generate Image';
-        this.description = 'Generate an image from a text prompt using the configured image providers. Returns a URL or data URL to the generated image.';
+        this.description = 'Generate an image from a text prompt using the configured image providers. Returns the image as a URL: ' +
+            'the provider\'s, or the file: URL of a copy saved on this machine, which the image-editing and vision tools accept as a source.';
         this.category = 'media';
         this.hasSideEffects = false;
         this.inputSchema = {
@@ -23,8 +30,8 @@ class GenerateImageTool {
                 },
                 size: {
                     type: 'string',
-                    enum: ['1024x1024', '1792x1024', '1024x1792'],
-                    description: 'Image dimensions. 1024x1024 (square, default), 1792x1024 (landscape), 1024x1792 (portrait).',
+                    enum: SIZES,
+                    description: 'Image dimensions. 1024x1024 (square, default), 1536x1024 or 1792x1024 (landscape), 1024x1536 or 1024x1792 (portrait).',
                 },
                 aspectRatio: {
                     type: 'string',
@@ -32,22 +39,22 @@ class GenerateImageTool {
                 },
                 quality: {
                     type: 'string',
-                    enum: ['standard', 'hd'],
-                    description: 'Image quality. "hd" produces higher detail but costs more.',
+                    enum: QUALITIES,
+                    description: 'Image quality: low, medium (default), high, or auto. "standard" and "hd" are read as medium and high. Higher quality costs more.',
                 },
                 style: {
                     type: 'string',
-                    enum: ['vivid', 'natural'],
-                    description: 'Style preset. "vivid" (default) for hyper-real/dramatic, "natural" for more realistic.',
+                    enum: STYLES,
+                    description: 'Optional style: "vivid" for hyper-real and dramatic, "natural" for more realistic.',
                 },
                 provider: {
                     type: 'string',
-                    enum: ['openai', 'openrouter', 'stability', 'replicate'],
+                    enum: PROVIDERS,
                     description: 'Which AI provider to use. If omitted, the extension uses its configured default provider.',
                 },
                 model: {
                     type: 'string',
-                    description: 'Optional provider-native model id, for example gpt-image-1, stable-image-core, or black-forest-labs/flux-schnell.',
+                    description: "Optional: the provider's own model id, for example gpt-image-2.5-flare, stable-image-core, or black-forest-labs/flux-schnell.",
                 },
                 seed: {
                     type: 'number',
@@ -62,9 +69,12 @@ class GenerateImageTool {
         };
         this.service = service;
     }
-    async execute(args, _context) {
+    async execute(args, context) {
+        const options = this.optionsFrom(args);
+        if (typeof options === 'string')
+            return { success: false, error: options };
         try {
-            const result = await this.service.generateImage(args);
+            const result = await this.service.generateImage(options, context);
             return {
                 success: true,
                 output: {
@@ -92,6 +102,42 @@ class GenerateImageTool {
             };
         }
     }
+    /**
+     * The service call for a tool call's arguments, or the error for an
+     * argument the schema does not allow. Only the schema's own fields are
+     * taken: the model writes the arguments, and anything else it adds (`n`,
+     * `providerOptions`, whose `extraBody` goes into the provider's request)
+     * is not passed on.
+     */
+    optionsFrom(args) {
+        if (typeof args?.prompt !== 'string' || !args.prompt.trim())
+            return 'prompt is required.';
+        const options = { prompt: args.prompt };
+        for (const field of STRING_FIELDS) {
+            const value = args[field];
+            if (value === undefined || value === null)
+                continue;
+            if (typeof value !== 'string')
+                return `${field} must be a string.`;
+            if (value.trim())
+                options[field] = value.trim();
+        }
+        for (const [field, allowed] of [['size', SIZES], ['quality', QUALITIES], ['style', STYLES], ['provider', PROVIDERS]]) {
+            const value = args[field];
+            if (value === undefined || value === null)
+                continue;
+            if (!allowed.includes(value))
+                return `${field} must be one of ${allowed.join(', ')}.`;
+            options[field] = value;
+        }
+        if (args.seed !== undefined && args.seed !== null) {
+            const seed = typeof args.seed === 'string' && args.seed.trim() !== '' ? Number(args.seed) : args.seed;
+            if (typeof seed !== 'number' || !Number.isFinite(seed))
+                return 'seed must be a number.';
+            options.seed = seed;
+        }
+        return options;
+    }
 }
 exports.GenerateImageTool = GenerateImageTool;
 //# sourceMappingURL=generateImage.js.map

package/dist/tools/generateImage.js.map

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

package/manifest.json

@@ -2,11 +2,11 @@
   "id": "com.framers.tools.image-generation",
   "name": "@framers/agentos-ext-image-generation",
   "displayName": "Image Generation",
-  "version": "1.1.0",
+  "version": "2.0.0",
   "description": "Generate images from text prompts using OpenAI, OpenRouter, Stability AI, or Replicate.",
   "category": "tool",
   "author": "Framers AI",
-  "license": "MIT",
+  "license": "Apache-2.0",
   "entry": "./src/index.ts",
   "tools": ["generate_image"],
   "requiredSecrets": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@framers/agentos-ext-image-generation",
-  "version": "1.1.0",
+  "version": "2.0.0",
   "description": "Image generation extension for AgentOS — OpenAI, OpenRouter, Stability AI, and Replicate",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -21,7 +21,7 @@
     "name": "Framers AI",
     "url": "https://frame.dev"
   },
-  "license": "MIT",
+  "license": "Apache-2.0",
   "peerDependencies": {
     "@framers/agentos": ">=0.10.40"
   },
@@ -29,7 +29,7 @@
     "@types/node": "^20.0.0",
     "typescript": "^5.0.0",
     "vitest": "^3.2.7",
-    "@framers/agentos": "^0.10.40"
+    "@framers/agentos": "^0.13.40"
   },
   "engines": {
     "node": ">=22"