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

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.1",
   "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.1",
   "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.47"
   },
   "engines": {
     "node": ">=22"