@fias/create-fias-plugin 1.0.2 → 1.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fias/create-fias-plugin",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "publishConfig": {
     "access": "public"
   },

package/templates/default/AGENTS.md

@@ -82,6 +82,8 @@ const user = useFiasUser();
 **Permission:** `storage:sandbox`
 **Returns:** `FiasStorageApi`
 
+Storage is S3-backed and scoped per plugin + user. Data persists across sessions, browsers, and devices in live mode (staging/production). In mock mode, storage is in-memory and resets when the dev server restarts.
+
 ```tsx
 import { useFiasStorage } from '@fias/arche-sdk';
 
@@ -129,6 +131,41 @@ function AISummarizer() {
 
 The `entityId` references a published model entity. Browse available models with `npx fias-dev entities`. The `systemPrompt` tells the AI how to behave — this is where your plugin's intelligence lives.
 
+### `useImageGeneration()` — Generate images via AI models
+
+**Permission:** `entities:image_generate`
+**Returns:** `ImageGenerationApi`
+
+Generate images using platform image models. Images are saved to the user's Fias file system and a display URL is returned. Use `npx fias-dev entities --detail <entityId>` to check supported sizes, qualities, and styles for each model.
+
+```tsx
+import { useImageGeneration } from '@fias/arche-sdk';
+
+function ImageMaker() {
+  const { generate, isLoading, result, error } = useImageGeneration();
+
+  return (
+    <div>
+      <button
+        onClick={() =>
+          generate({
+            entityId: 'ent_modeldef_dalle3',
+            prompt: 'A serene mountain landscape at sunset',
+            size: '1024x1024',
+            quality: 'hd',
+          })
+        }
+        disabled={isLoading}
+      >
+        {isLoading ? 'Generating...' : 'Generate Image'}
+      </button>
+      {result && <img src={result.imageUrl} alt="Generated" />}
+      {error && <p>Error: {error.message}</p>}
+    </div>
+  );
+}
+```
+
 ### `useFiasNavigation()` — In-plugin routing
 
 **Permission:** None required
@@ -155,6 +192,8 @@ const { currentStep, setCurrentStep } = useStepNavigation('step-1');
 
 **Permission:** `storage:sandbox`
 
+Uses `useFiasStorage` under the hood — same persistence rules apply (durable in live mode, in-memory in mock mode).
+
 ```tsx
 import { usePersistentState } from '@fias/arche-sdk';
 
@@ -203,7 +242,7 @@ fias.showToast('Saved!', 'success'); // Toast: 'info' | 'success' | 'warning' |
 | `sdk`          | Yes      | SDK version range                                         |
 | `dependencies` | No       | npm packages with **exact** versions (max 20)             |
 
-**Permissions:** `theme:read`, `user:profile:read`, `storage:sandbox`, `entities:invoke`
+**Permissions:** `theme:read`, `user:profile:read`, `storage:sandbox`, `entities:invoke`, `entities:image_generate`
 
 **Using AI:** Add `"entities:invoke"` to permissions, then use `useEntityInvocation()` with a model entity ID and your own `systemPrompt`. Browse available models with `npx fias-dev entities`.
 
@@ -279,9 +318,10 @@ npx fias-dev login --env production   # Authenticate with production
 ### Browsing Available Entities
 
 ```bash
-npx fias-dev entities                    # List all
-npx fias-dev entities --search "text"    # Search by keyword
-npx fias-dev entities --type "prompt"    # Filter by type
+npx fias-dev entities                              # List all
+npx fias-dev entities --search "image"             # Search by keyword
+npx fias-dev entities --type "model-definition"    # Filter by type
+npx fias-dev entities --detail ent_modeldef_dalle3 # Full entity details (capabilities, sizes, pricing)
 ```
 
 ### Validating the Manifest

package/templates/default/CLAUDE.md

@@ -82,6 +82,8 @@ const user = useFiasUser();
 **Permission:** `storage:sandbox`
 **Returns:** `FiasStorageApi`
 
+Storage is S3-backed and scoped per plugin + user. Data persists across sessions, browsers, and devices in live mode (staging/production). In mock mode, storage is in-memory and resets when the dev server restarts.
+
 ```tsx
 import { useFiasStorage } from '@fias/arche-sdk';
 
@@ -129,6 +131,41 @@ function AISummarizer() {
 
 The `entityId` references a published model entity. Browse available models with `npx fias-dev entities`. The `systemPrompt` tells the AI how to behave — this is where your plugin's intelligence lives.
 
+### `useImageGeneration()` — Generate images via AI models
+
+**Permission:** `entities:image_generate`
+**Returns:** `ImageGenerationApi`
+
+Generate images using platform image models. Images are saved to the user's Fias file system and a display URL is returned. Use `npx fias-dev entities --detail <entityId>` to check supported sizes, qualities, and styles for each model.
+
+```tsx
+import { useImageGeneration } from '@fias/arche-sdk';
+
+function ImageMaker() {
+  const { generate, isLoading, result, error } = useImageGeneration();
+
+  return (
+    <div>
+      <button
+        onClick={() =>
+          generate({
+            entityId: 'ent_modeldef_dalle3',
+            prompt: 'A serene mountain landscape at sunset',
+            size: '1024x1024',
+            quality: 'hd',
+          })
+        }
+        disabled={isLoading}
+      >
+        {isLoading ? 'Generating...' : 'Generate Image'}
+      </button>
+      {result && <img src={result.imageUrl} alt="Generated" />}
+      {error && <p>Error: {error.message}</p>}
+    </div>
+  );
+}
+```
+
 ### `useFiasNavigation()` — In-plugin routing
 
 **Permission:** None required
@@ -155,6 +192,8 @@ const { currentStep, setCurrentStep } = useStepNavigation('step-1');
 
 **Permission:** `storage:sandbox`
 
+Uses `useFiasStorage` under the hood — same persistence rules apply (durable in live mode, in-memory in mock mode).
+
 ```tsx
 import { usePersistentState } from '@fias/arche-sdk';
 
@@ -203,7 +242,7 @@ fias.showToast('Saved!', 'success'); // Toast: 'info' | 'success' | 'warning' |
 | `sdk`          | Yes      | SDK version range                                         |
 | `dependencies` | No       | npm packages with **exact** versions (max 20)             |
 
-**Permissions:** `theme:read`, `user:profile:read`, `storage:sandbox`, `entities:invoke`
+**Permissions:** `theme:read`, `user:profile:read`, `storage:sandbox`, `entities:invoke`, `entities:image_generate`
 
 **Using AI:** Add `"entities:invoke"` to permissions, then use `useEntityInvocation()` with a model entity ID and your own `systemPrompt`. Browse available models with `npx fias-dev entities`.
 
@@ -279,9 +318,10 @@ npx fias-dev login --env production   # Authenticate with production
 ### Browsing Available Entities
 
 ```bash
-npx fias-dev entities                    # List all
-npx fias-dev entities --search "text"    # Search by keyword
-npx fias-dev entities --type "prompt"    # Filter by type
+npx fias-dev entities                              # List all
+npx fias-dev entities --search "image"             # Search by keyword
+npx fias-dev entities --type "model-definition"    # Filter by type
+npx fias-dev entities --detail ent_modeldef_dalle3 # Full entity details (capabilities, sizes, pricing)
 ```
 
 ### Validating the Manifest