@imgly/plugin-ai-apps-web 0.1.9 → 0.2.0

package/CHANGELOG.md

@@ -2,6 +2,40 @@
 
 ## [Unreleased]
 
+## [0.2.0] - 2025-07-15
+
+### Breaking Changes
+
+-   [all] **Provider Initialization**: `initProvider` is replaced with `initializeProviders` and `initializeProvider` with a different signature
+-   [all] **Quick Actions Structure**: `provider.input.quickctions.actions` replaced with `provider.input.quickActions.supported`
+-   [all] **History Asset Sources**: Combined history asset source is now not added to the default asset libraries anymore. Add the following sources to any library entry (default or not):
+    -   Image Generation History: `ly.img.ai.image-generation.history`
+    -   Video Generation History: `ly.img.ai.video-generation.history`
+    -   Audio Generation History: `ly.img.ai.audio-generation.history`
+    -   Sticker Generation History: `ly.img.ai.sticker-generation.history`
+-   [all] **ID Format Standardization**: All `ly.img.ai/` prefixed IDs changed to use dot notation `ly.img.ai.` for consistency
+    -   Panel IDs: `ly.img.ai/apps` → `ly.img.ai.apps`, `ly.img.ai/image-generation` → `ly.img.ai.image-generation`
+    -   Dock IDs: `ly.img.ai/apps.dock` → `ly.img.ai.apps.dock`
+
+### New Features
+
+-   [all] **Multiple Providers Support**: All plugin packages now support arrays of providers with automatic selection UI
+-   [image-generation] **Recraft20b Provider**: Added new Recraft20b (v2) provider via fal.ai with support for icon styles including `broken_line`, `colored_outline`, `colored_shapes`, and more
+-   [sticker-generation] **New Sticker Generation Plugin**: Added `@imgly/plugin-ai-sticker-generation-web` plugin for AI-powered sticker generation with support for text-to-sticker generation using Recraft20b provider with icon styles
+-   [image-generation] **Flux Pro Kontext Provider**: Added Flux Pro Kontext provider for image editing with style transfer and artist style options
+-   [image-generation] **Flux Pro Kontext Max Provider**: Added Flux Pro Kontext Max provider for enhanced image editing capabilities
+-   [video-generation] **Veo3 Provider**: Added Veo3 text-to-video provider via fal.ai with support for 16:9, 9:16, and 1:1 aspect ratios and 8-second duration
+-   [video-generation] **Kling Video V2.1 Master Providers**: Added Kling Video V2.1 Master providers for both text-to-video and image-to-video generation with configurable duration (5s/10s) and aspect ratios
+-   [text-generation] **Model Selection**: OpenAI and Anthropic providers now support configurable model selection through the `model` parameter
+
+### Deprecated Features
+
+-   [all] **Middleware Configuration**: The `middleware` property in provider configurations is deprecated. Use `middlewares` instead. The old property will continue to work for now.
+
+## [0.1.10] - 2025-06-20
+
+-   [all] Fix issue with GPT provider when using text provider
+
 ## [0.1.9] - 2025-06-05
 
 -   [all] Add support for custom headers

package/README.md

@@ -6,13 +6,14 @@ A plugin for orchestrating all AI generation capabilities in CreativeEditor SDK.
 
 The `@imgly/plugin-ai-apps-web` package provides a unified interface for accessing and organizing all AI generation features within the CreativeEditor SDK. It combines image, video, audio, and text generation capabilities into a single cohesive user experience.
 
-Features include:
+### Key Features
 
--   Central AI dock component with loading indicators
--   AI apps menu for quick access to all AI features
--   Integrated history management for generated assets
--   Automatic integration with asset libraries
--   Support for both Design and Video modes
+- **Unified AI Experience**: Centralized access to all AI generation capabilities
+- **AI Dock Component**: Single entry point for all AI features with loading indicators
+- **Smart Provider Management**: Automatically organizes providers based on editor mode
+- **Integrated History**: Seamless integration with asset libraries for generated content
+- **Mode-Aware Interface**: Different UI layouts for Design and Video modes
+- **Cross-Plugin Support**: Works with all IMG.LY AI generation plugins
 
 ## Installation
 
@@ -20,7 +21,7 @@ Features include:
 npm install @imgly/plugin-ai-apps-web
 ```
 
-## Usage
+## Basic Usage
 
 To use the plugin, import it and configure it with your preferred providers:
 
@@ -33,50 +34,56 @@ import { AnthropicProvider } from '@imgly/plugin-ai-text-generation-web/anthropi
 import FalAiImage from '@imgly/plugin-ai-image-generation-web/fal-ai';
 import FalAiVideo from '@imgly/plugin-ai-video-generation-web/fal-ai';
 import ElevenLabs from '@imgly/plugin-ai-audio-generation-web/elevenlabs';
+import FalAiSticker from '@imgly/plugin-ai-sticker-generation-web/fal-ai';
 
 // Initialize CreativeEditor SDK
 CreativeEditorSDK.create(domElement, {
-    license: 'your-license-key'
-    // Other configuration options...
+  license: 'your-license-key'
+  // Other configuration options...
 }).then(async (cesdk) => {
-    // Add the AI Apps plugin
-    cesdk.addPlugin(
-        AiApps({
-            providers: {
-                // Text generation
-                text2text: AnthropicProvider({
-                    proxyUrl: 'https://your-anthropic-proxy.example.com'
-                }),
-
-                // Image generation
-                text2image: FalAiImage.RecraftV3({
-                    proxyUrl: 'https://your-fal-ai-proxy.example.com'
-                }),
-                image2image: FalAiImage.GeminiFlashEdit({
-                    proxyUrl: 'https://your-fal-ai-proxy.example.com'
-                }),
-
-                // Video generation (used in video mode)
-                text2video: FalAiVideo.MinimaxVideo01Live({
-                    proxyUrl: 'https://your-fal-ai-proxy.example.com'
-                }),
-                image2video: FalAiVideo.MinimaxVideo01LiveImageToVideo({
-                    proxyUrl: 'https://your-fal-ai-proxy.example.com'
-                }),
-
-                // Audio generation (used in video mode)
-                text2speech: ElevenLabs.MonolingualV1({
-                    proxyUrl: 'https://your-elevenlabs-proxy.example.com'
-                }),
-                text2sound: ElevenLabs.SoundEffects({
-                    proxyUrl: 'https://your-elevenlabs-proxy.example.com'
-                })
-            }
+  // Add the AI Apps plugin
+  cesdk.addPlugin(
+    AiApps({
+      providers: {
+        // Text generation
+        text2text: AnthropicProvider({
+          proxyUrl: 'http://your-proxy-server.com/api/proxy'
+        }),
+
+        // Image generation
+        text2image: FalAiImage.RecraftV3({
+          proxyUrl: 'http://your-proxy-server.com/api/proxy'
+        }),
+        image2image: FalAiImage.GeminiFlashEdit({
+          proxyUrl: 'http://your-proxy-server.com/api/proxy'
+        }),
+
+        // Video generation (used in video mode)
+        text2video: FalAiVideo.MinimaxVideo01Live({
+          proxyUrl: 'http://your-proxy-server.com/api/proxy'
+        }),
+        image2video: FalAiVideo.MinimaxVideo01LiveImageToVideo({
+          proxyUrl: 'http://your-proxy-server.com/api/proxy'
+        }),
+
+        // Audio generation (used in video mode)
+        text2speech: ElevenLabs.MonolingualV1({
+          proxyUrl: 'http://your-proxy-server.com/api/proxy'
+        }),
+        text2sound: ElevenLabs.SoundEffects({
+          proxyUrl: 'http://your-proxy-server.com/api/proxy'
+        }),
+
+        // Sticker generation
+        text2sticker: FalAiSticker.Recraft20b({
+          proxyUrl: 'http://your-proxy-server.com/api/proxy'
         })
-    );
+      }
+    })
+  );
 
-    // Position the AI dock button in the dock order
-    cesdk.ui.setDockOrder(['ly.img.ai/apps.dock', ...cesdk.ui.getDockOrder()]);
+  // Position the AI dock button in the dock order
+  cesdk.ui.setDockOrder(['ly.img.ai.apps.dock', ...cesdk.ui.getDockOrder()]);
 });
 ```
 
@@ -102,13 +109,98 @@ The `providers` object can include the following provider functions:
 | `image2video` | `Provider<'video'>` | Provider for image-to-video generation (video mode only) |
 | `text2speech` | `Provider<'audio'>` | Provider for text-to-speech generation (video mode only) |
 | `text2sound`  | `Provider<'audio'>` | Provider for sound effects generation (video mode only)  |
+| `text2sticker` | `Provider<'sticker'>` | Provider for sticker generation                          |
+
+### Provider Selection Strategy
+
+The plugin intelligently selects which providers to use based on the current editor mode:
+
+#### Design Mode
+- **Uses**: `text2text`, `text2image`, `image2image`, `text2sticker`
+- **Focus**: Image, text, and sticker generation for design workflows
+- **UI**: Shows AI apps cards for different generation types
+
+#### Video Mode  
+- **Uses**: All providers including `text2video`, `image2video`, `text2speech`, `text2sound`, `text2sticker`
+- **Focus**: Comprehensive media generation for video production
+- **UI**: Shows AI apps cards for different generation types
+
+## Advanced Configuration
+
+### Multiple Providers per Type
+
+You can configure multiple providers for the same generation type by passing an array. When multiple providers are configured, a selection box will be rendered in the AI app interface allowing users to choose between different providers:
+
+```typescript
+import FalAiImage from '@imgly/plugin-ai-image-generation-web/fal-ai';
+import OpenAiImage from '@imgly/plugin-ai-image-generation-web/open-ai';
+
+cesdk.addPlugin(
+  AiApps({
+    providers: {
+      // Multiple image providers - selection box will be shown
+      text2image: [
+        FalAiImage.RecraftV3({
+          proxyUrl: 'http://your-proxy-server.com/api/proxy'
+        }),
+        FalAiImage.Recraft20b({
+          proxyUrl: 'http://your-proxy-server.com/api/proxy'
+        }),
+        OpenAiImage.GptImage1.Text2Image({
+          proxyUrl: 'http://your-proxy-server.com/api/proxy'
+        })
+      ],
+      
+      // Other providers...
+    }
+  })
+);
+```
+
+### Custom Headers and Configuration
+
+Pass custom headers and configuration to providers:
+
+```typescript
+cesdk.addPlugin(
+  AiApps({
+    providers: {
+      text2image: FalAiImage.RecraftV3({
+        proxyUrl: 'http://your-proxy-server.com/api/proxy',
+        headers: {
+          'x-client-version': '1.0.0',
+          'x-request-source': 'cesdk-plugin',
+          'x-user-id': 'user-123'
+        },
+        debug: true
+      })
+    },
+    debug: true
+  })
+);
+```
 
 ## UI Integration
 
-The plugin adds the following UI components:
+The plugin adds the following UI components to CreativeEditor SDK:
+
+### AI Dock Button
+
+The main entry point for all AI features, accessible from the dock:
+
+- **ID**: `ly.img.ai.apps.dock`
+- **Functionality**: Opens AI generation interface
+- **Loading States**: Shows progress indicators during generation
+- **Mode Awareness**: Adapts interface based on current editor mode
+
+### AI Apps Menu
+
+The plugin shows a card-based interface for different AI capabilities:
 
-1. **AI Dock Button**: Access point for all AI features
-2. **AI Apps Menu**: In video mode, shows cards for all available AI generation types
+- **Generate Image**: Access to image generation providers
+- **Generate Video**: Access to video generation providers  
+- **Generate Audio**: Access to audio generation providers
+- **Edit Text**: Access to text generation providers
 
 ### Dock Integration
 
@@ -116,31 +208,301 @@ To position the AI dock button in your editor's dock, use the `setDockOrder` met
 
 ```typescript
 // Add the AI dock component to the beginning of the dock
-cesdk.ui.setDockOrder(['ly.img.ai/apps.dock', ...cesdk.ui.getDockOrder()]);
+cesdk.ui.setDockOrder(['ly.img.ai.apps.dock', ...cesdk.ui.getDockOrder()]);
 
 // Or add it at a specific position
 const currentOrder = cesdk.ui.getDockOrder();
-currentOrder.splice(2, 0, 'ly.img.ai/apps.dock');
+currentOrder.splice(2, 0, 'ly.img.ai.apps.dock');
 cesdk.ui.setDockOrder(currentOrder);
 ```
 
 ## Asset History Integration
 
-The plugin automatically integrates generated assets into the appropriate asset libraries:
+The plugin automatically integrates generated assets into the appropriate asset libraries using the following history source IDs:
+
+- **Image Generation History**: `ly.img.ai.image-generation.history`
+- **Video Generation History**: `ly.img.ai.video-generation.history`
+- **Audio Generation History**: `ly.img.ai.audio-generation.history`
+- **Sticker Generation History**: `ly.img.ai.sticker-generation.history`
+
+To add these history sources to existing asset library entries, use the following approach:
+
+```typescript
+// Add AI image history to the default image asset library
+const imageEntry = cesdk.ui.getAssetLibraryEntry('ly.img.image');
+if (imageEntry != null) {
+  cesdk.ui.updateAssetLibraryEntry('ly.img.image', {
+    sourceIds: [...imageEntry.sourceIds, 'ly.img.ai.image-generation.history']
+  });
+}
+
+// Add AI video history to the default video asset library
+const videoEntry = cesdk.ui.getAssetLibraryEntry('ly.img.video');
+if (videoEntry != null) {
+  cesdk.ui.updateAssetLibraryEntry('ly.img.video', {
+    sourceIds: [...videoEntry.sourceIds, 'ly.img.ai.video-generation.history']
+  });
+}
+
+// Add AI audio history to the default audio asset library
+const audioEntry = cesdk.ui.getAssetLibraryEntry('ly.img.audio');
+if (audioEntry != null) {
+  cesdk.ui.updateAssetLibraryEntry('ly.img.audio', {
+    sourceIds: [...audioEntry.sourceIds, 'ly.img.ai.audio-generation.history']
+  });
+}
+
+// Add AI sticker history to the default sticker asset library
+const stickerEntry = instance.ui.getAssetLibraryEntry('ly.img.sticker');
+if (stickerEntry != null) {
+  instance.ui.updateAssetLibraryEntry('ly.img.sticker', {
+    sourceIds: [...stickerEntry.sourceIds, 'ly.img.ai.sticker-generation.history']
+  });
+}
+```
+
+This integration creates a seamless experience where users can easily find and reuse their AI-generated assets alongside other content.
+
+## Quick Actions Integration
+
+The plugin automatically integrates with the quick actions system, providing context-sensitive AI operations directly in the canvas menu. You need to specify the children with the quick action order:
+
+```typescript
+// Quick actions are automatically registered and will appear in canvas menus
+cesdk.ui.setCanvasMenuOrder([
+  {
+    id: 'ly.img.ai.text.canvasMenu',
+    children: [
+      'ly.img.improve',
+      'ly.img.fix',
+      'ly.img.shorter',
+      'ly.img.longer',
+      'ly.img.separator',
+      'ly.img.changeTone',
+      'ly.img.translate',
+      'ly.img.separator',
+      'ly.img.changeTextTo'
+    ]
+  },
+  {
+    id: 'ly.img.ai.image.canvasMenu',
+    children: [
+      'ly.img.styleTransfer',
+      'ly.img.artistTransfer',
+      'ly.img.separator',
+      'ly.img.editImage',
+      'ly.img.swapBackground',
+      'ly.img.createVariant',
+      'ly.img.combineImages',
+      'ly.img.separator',
+      'ly.img.remixPage',
+      'ly.img.separator',
+      'ly.img.createVideo'
+    ]
+  },
+  ...cesdk.ui.getCanvasMenuOrder()
+]);
+```
+
+Quick actions provide:
+- **Context-aware operations**: Work with currently selected blocks
+- **One-click transformations**: Apply AI operations without opening panels
+- **Cross-plugin functionality**: Actions from one plugin can work with providers from another
+
+## Error Handling and Debugging
+
+### Debug Mode
+
+Enable debug mode to get detailed logging information:
+
+```typescript
+cesdk.addPlugin(
+  AiApps({
+    providers: {
+      text2image: FalAiImage.RecraftV3({
+        proxyUrl: 'http://your-proxy-server.com/api/proxy',
+        debug: true // Provider-level debugging
+      })
+    },
+    debug: true // Plugin-level debugging
+  })
+);
+```
+
+### Common Issues and Solutions
+
+#### Provider Not Loading
+- **Check proxy URLs**: Ensure all proxy URLs are correctly configured and accessible
+- **Verify licenses**: Make sure your CreativeEditor SDK license includes AI features
+- **Check browser console**: Look for network errors or API issues
+
+#### Quick Actions Not Appearing
+- **Verify canvas menu order**: Ensure quick action menus are added to canvas menu order with proper children configuration
+- **Check provider support**: Verify that providers declare support for the quick actions
+- **Scope permissions**: Ensure blocks have the required scopes for quick actions
 
--   AI-generated images appear in the standard image library
--   AI-generated videos appear in the standard video library
--   AI-generated audio appears in the standard audio library
+#### Generation Failures
+- **API connectivity**: Check that your proxy endpoints are working
+- **Rate limiting**: Verify you're not exceeding API rate limits
+- **Input validation**: Ensure inputs meet provider requirements
 
-This integration creates a seamless experience where users can easily find and reuse their AI-generated assets.
+## Plugin Architecture
+
+### How It Works
+
+The AI Apps plugin acts as an orchestrator that:
+
+1. **Initializes Providers**: Sets up all configured AI providers
+2. **Manages UI**: Creates appropriate interface based on editor mode
+3. **Coordinates Actions**: Integrates quick actions across different plugins
+4. **Handles Assets**: Manages generated content and asset library integration
+
+### Provider Lifecycle
+
+1. **Registration**: Providers are registered with the global ProviderRegistry
+2. **Initialization**: Provider `initialize` methods are called
+3. **UI Setup**: Panels and quick actions are registered
+4. **Event Handling**: The plugin coordinates between providers and UI
+
+## TypeScript Support
+
+The plugin is fully typed with TypeScript, providing excellent development experience:
+
+```typescript
+import AiApps, { Providers } from '@imgly/plugin-ai-apps-web';
+
+// Strongly typed provider configuration
+const providers: Providers = {
+  text2image: FalAiImage.RecraftV3({
+    proxyUrl: 'http://your-proxy-server.com/api/proxy'
+  }),
+  // TypeScript will enforce correct provider types
+};
+
+cesdk.addPlugin(AiApps({ providers }));
+```
 
 ## Related Packages
 
--   [@imgly/plugin-ai-generation-web](https://github.com/imgly/plugin-ai-generation-web) - Core utilities for AI generation
--   [@imgly/plugin-ai-image-generation-web](https://github.com/imgly/plugin-ai-image-generation-web) - AI image generation
--   [@imgly/plugin-ai-video-generation-web](https://github.com/imgly/plugin-ai-video-generation-web) - AI video generation
--   [@imgly/plugin-ai-audio-generation-web](https://github.com/imgly/plugin-ai-audio-generation-web) - AI audio generation
--   [@imgly/plugin-ai-text-generation-web](https://github.com/imgly/plugin-ai-text-generation-web) - AI text generation
+This plugin works with the following IMG.LY AI generation packages:
+
+- **[@imgly/plugin-ai-generation-web](https://github.com/imgly/plugins/tree/main/packages/plugin-ai-generation-web)** - Core utilities for AI generation
+- **[@imgly/plugin-ai-image-generation-web](https://github.com/imgly/plugins/tree/main/packages/plugin-ai-image-generation-web)** - AI image generation
+- **[@imgly/plugin-ai-video-generation-web](https://github.com/imgly/plugins/tree/main/packages/plugin-ai-video-generation-web)** - AI video generation
+- **[@imgly/plugin-ai-audio-generation-web](https://github.com/imgly/plugins/tree/main/packages/plugin-ai-audio-generation-web)** - AI audio generation
+- **[@imgly/plugin-ai-text-generation-web](https://github.com/imgly/plugins/tree/main/packages/plugin-ai-text-generation-web)** - AI text generation
+
+## Examples
+
+### Simple Setup for Design Mode
+
+```typescript
+import CreativeEditorSDK from '@cesdk/cesdk-js';
+import AiApps from '@imgly/plugin-ai-apps-web';
+import FalAiImage from '@imgly/plugin-ai-image-generation-web/fal-ai';
+
+CreativeEditorSDK.create(domElement, {
+  license: 'your-license-key'
+}).then(async (cesdk) => {
+  cesdk.addPlugin(
+    AiApps({
+      providers: {
+        text2image: FalAiImage.RecraftV3({
+          proxyUrl: 'http://your-proxy-server.com/api/proxy'
+        })
+      }
+    })
+  );
+
+  cesdk.ui.setDockOrder(['ly.img.ai.apps.dock', ...cesdk.ui.getDockOrder()]);
+});
+```
+
+### Complete Setup for Video Mode
+
+```typescript
+import CreativeEditorSDK from '@cesdk/cesdk-js';
+import AiApps from '@imgly/plugin-ai-apps-web';
+import FalAiImage from '@imgly/plugin-ai-image-generation-web/fal-ai';
+import FalAiVideo from '@imgly/plugin-ai-video-generation-web/fal-ai';
+import ElevenLabs from '@imgly/plugin-ai-audio-generation-web/elevenlabs';
+import { AnthropicProvider } from '@imgly/plugin-ai-text-generation-web/anthropic';
+
+CreativeEditorSDK.create(domElement, {
+  license: 'your-license-key',
+  ui: {
+    elements: {
+      panels: {
+        settings: true
+      }
+    }
+  }
+}).then(async (cesdk) => {
+  cesdk.addPlugin(
+    AiApps({
+      providers: {
+        text2text: AnthropicProvider({
+          proxyUrl: 'http://your-proxy-server.com/api/proxy'
+        }),
+        text2image: FalAiImage.RecraftV3({
+          proxyUrl: 'http://your-proxy-server.com/api/proxy'
+        }),
+        image2image: FalAiImage.GeminiFlashEdit({
+          proxyUrl: 'http://your-proxy-server.com/api/proxy'
+        }),
+        text2video: FalAiVideo.MinimaxVideo01Live({
+          proxyUrl: 'http://your-proxy-server.com/api/proxy'
+        }),
+        image2video: FalAiVideo.MinimaxVideo01LiveImageToVideo({
+          proxyUrl: 'http://your-proxy-server.com/api/proxy'
+        }),
+        text2speech: ElevenLabs.MonolingualV1({
+          proxyUrl: 'http://your-proxy-server.com/api/proxy'
+        }),
+        text2sound: ElevenLabs.SoundEffects({
+          proxyUrl: 'http://your-proxy-server.com/api/proxy'
+        })
+      }
+    })
+  );
+
+  // Setup dock and canvas menus
+  cesdk.ui.setDockOrder(['ly.img.ai.apps.dock', ...cesdk.ui.getDockOrder()]);
+  cesdk.ui.setCanvasMenuOrder([
+    {
+      id: 'ly.img.ai.text.canvasMenu',
+      children: [
+        'ly.img.improve',
+        'ly.img.fix',
+        'ly.img.shorter',
+        'ly.img.longer',
+        'ly.img.separator',
+        'ly.img.changeTone',
+        'ly.img.translate',
+        'ly.img.separator',
+        'ly.img.changeTextTo'
+      ]
+    },
+    {
+      id: 'ly.img.ai.image.canvasMenu',
+      children: [
+        'ly.img.styleTransfer',
+        'ly.img.artistTransfer',
+        'ly.img.separator',
+        'ly.img.editImage',
+        'ly.img.swapBackground',
+        'ly.img.createVariant',
+        'ly.img.combineImages',
+        'ly.img.separator',
+        'ly.img.remixPage',
+        'ly.img.separator',
+        'ly.img.createVideo'
+      ]
+    },
+    ...cesdk.ui.getCanvasMenuOrder()
+  ]);
+});
+```
 
 ## License
 

package/dist/ActiveAssetSource.d.ts

@@ -1,14 +1,14 @@
 import CreativeEditorSDK from '@cesdk/cesdk-js';
 import type { AssetDefinition, AssetQueryData, AssetSource, AssetsQueryResult } from '@cesdk/engine';
 /**
- * A custom AssetSource implementation that manages assets from an array
+ * A custom AssetSource implementation that manages assets from an array or dynamic function
  * and provides functionality to mark assets as active.
  */
 export declare class CustomAssetSource implements AssetSource {
     /** The unique id of the asset source */
     id: string;
-    /** Array of assets to be served by this source */
-    private assets;
+    /** Array of assets or function that returns assets */
+    private assetsOrProvider;
     /** Set of IDs for active assets */
     private activeAssetIds;
     private loaderDisposer;
@@ -17,9 +17,13 @@ export declare class CustomAssetSource implements AssetSource {
      * Creates a new instance of CustomAssetSource
      *
      * @param id - The unique identifier for this asset source
-     * @param assets - Array of asset definitions to include in this source
+     * @param assetsOrProvider - Array of asset definitions or function that returns asset definitions
      */
-    constructor(id: string, cesdk: CreativeEditorSDK, assets?: AssetDefinition[]);
+    constructor(id: string, cesdk: CreativeEditorSDK, assetsOrProvider?: AssetDefinition[] | (() => AssetDefinition[]));
+    /**
+     * Get all current assets definitions used by this asset source
+     */
+    getCurrentAssets(): AssetDefinition[];
     /**
      * Find assets based on the provided query data
      * Supports pagination, searching, filtering, and active-first sorting
@@ -83,8 +87,8 @@ export declare class CustomAssetSource implements AssetSource {
  * Helper function to create a CustomAssetSource instance
  *
  * @param id - The unique identifier for this asset source
- * @param assets - Array of asset definitions to include in this source
+ * @param assetsOrProvider - Array of asset definitions or function that returns asset definitions
  * @returns A new CustomAssetSource instance
  */
-export declare function createCustomAssetSource(id: string, cesdk: CreativeEditorSDK, assets?: AssetDefinition[]): CustomAssetSource;
+export declare function createCustomAssetSource(id: string, cesdk: CreativeEditorSDK, assetsOrProvider?: AssetDefinition[] | (() => AssetDefinition[])): CustomAssetSource;
 export default CustomAssetSource;