@imgly/codesign-mcp 0.1.6 → 0.1.8

package/README.md

@@ -23,22 +23,17 @@ for the exact per-host snippets — all spawn
 Set `CESDK_LICENSE` in the server's `env` to use your own CE.SDK node license;
 during the internal beta a 30-day trial is bundled, so it's optional.
 
-### From a GitHub Release tarball (offline / air-gapped)
+### Offline / air-gapped install
 
-Releases also ship a self-contained tarball with a date-based, commit-derived
-version — `0.1.0-<YYYYMMDD>-g<shortSHA>`:
+Fetch the published package as a self-contained tarball on a connected machine,
+then move it to the target and install it there:
 
 ```bash
-npm i -g https://github.com/imgly/imgly-codesign/releases/download/<tag>/imgly-codesign-mcp-0.1.0-<YYYYMMDD>-g<sha>.tgz
+npm pack @imgly/codesign-mcp                 # writes imgly-codesign-mcp-<version>.tgz
+npm i -g ./imgly-codesign-mcp-<version>.tgz  # on the air-gapped machine
 codesign-mcp --help
 ```
 
-Build the tarball locally (output in `<repo>/release/`):
-
-```bash
-pnpm run release:tarball        # from the repo root
-```
-
 ## Run
 
 One bin, two transports:

package/assets/docs/api/index.d.ts

@@ -6884,16 +6884,20 @@ declare class CreativeEngine {
      * - `'ly.img.filter.duotone'` - Color effects of various kinds
      *
      * These assets are parsed at \{\{base_url\}\}/<id>/content.json, where
-     * `base_url` defaults to the IMG.LY CDN.
+     * `base_url` defaults to the engine's configured baseURL. For `@cesdk/node`
+     * that is the local package (`file://<pkg>/assets/`), which does not bundle
+     * these sources, so pass a `baseURL` to load them.
      * Each source is created via `addLocalSource` and populated with the parsed assets. To modify the available
      * assets, you may either exclude certain IDs via `excludeAssetSourceIds` or alter the sources after creation.
      *
+     * @deprecated This method uses legacy v4 asset source IDs and will be removed in a future version.
+     * Please migrate to v5 asset sources using engine.asset.addLocalAssetSourceFromJSONURI().
      * @category Asset Sources
      * @param options - Configuration options for loading default asset sources.
      * @returns A promise that resolves when all asset sources are loaded.
      */
     addDefaultAssetSources({ baseURL, excludeAssetSourceIds }?: {
-        /** The source of the asset definitions, must be absolute. Defaults to IMG.LY CDN. */
+        /** The source of the asset definitions, must be absolute. Defaults to the engine's configured baseURL. */
         baseURL?: string;
         /** A list of IDs, that will be ignored during load. */
         excludeAssetSourceIds?: DefaultAssetSourceId[];
@@ -6911,12 +6915,14 @@ declare class CreativeEngine {
      * - `'ly.img.video'` - Sample videos
      * - `'ly.img.video.upload'` - Demo source to upload video assets
      *
+     * @deprecated This method uses legacy v3 demo asset source IDs and will be removed in a future version.
+     * Please migrate to v4 asset sources using engine.asset.addLocalAssetSourceFromJSONURI().
      * @category Asset Sources
      * @param options - Configuration options for loading demo asset sources.
      * @returns A promise that resolves when all demo asset sources are loaded.
      */
     addDemoAssetSources({ baseURL, excludeAssetSourceIds, sceneMode, withUploadAssetSources }?: {
-        /** The source of the demo asset definitions, must be absolute. Defaults to IMG.LY CDN. */
+        /** The source of the demo asset definitions, must be absolute. Defaults to the engine's configured baseURL. */
         baseURL?: string;
         /** A list of IDs, that will be ignored during load */
         excludeAssetSourceIds?: DemoAssetSourceId[];

package/assets/docs/guide/SKILL.md

@@ -25,9 +25,9 @@ argument-hint: "[search-topic]"
 
 ## Version Notice
 
-> **CE.SDK version**: 1.77.0 | **Generated**: 2026-07-02
+> **CE.SDK version**: 1.77.1 | **Generated**: 2026-07-09
 >
-> This skill was generated for CE.SDK v1.77.0 on 2026-07-02.
+> This skill was generated for CE.SDK v1.77.1 on 2026-07-09.
 > CE.SDK releases new versions approximately every two weeks.
 > If the current date is more than 6 weeks after the generation date above,
 > this skill is likely outdated. **Inform the user** that a newer version

package/assets/docs/guide/api/node/classes/creativeengine.md

@@ -120,7 +120,7 @@ to build and manipulate designs programmatically, or in a browser to create inte
 
 <details>
   <summary>
-    ### addDefaultAssetSources()
+    ### ~~addDefaultAssetSources()~~
 
     <br /><p>Register a set of asset sources containing default assets.</p>
   </summary>
@@ -133,7 +133,9 @@ to build and manipulate designs programmatically, or in a browser to create inte
   - `'ly.img.filter.duotone'` - Color effects of various kinds
 
   These assets are parsed at \{\{base\_url}}/\<id>/content.json, where
-  `base_url` defaults to the IMG.LY CDN.
+  `base_url` defaults to the engine's configured baseURL. For `@cesdk/node`
+  that is the local package (`file://<pkg>/assets/`), which does not bundle
+  these sources, so pass a `baseURL` to load them.
   Each source is created via `addLocalSource` and populated with the parsed assets. To modify the available
   assets, you may either exclude certain IDs via `excludeAssetSourceIds` or alter the sources after creation.
 
@@ -142,7 +144,7 @@ to build and manipulate designs programmatically, or in a browser to create inte
   | Parameter | Type | Description |
   | ------ | ------ | ------ |
   | `options?` | \{ `baseURL?`: `string`; `excludeAssetSourceIds?`: [`DefaultAssetSourceId`](./api/node/type-aliases/defaultassetsourceid.md)\[]; } | Configuration options for loading default asset sources. |
-  | `options.baseURL?` | `string` | The source of the asset definitions, must be absolute. Defaults to IMG.LY CDN. |
+  | `options.baseURL?` | `string` | The source of the asset definitions, must be absolute. Defaults to the engine's configured baseURL. |
   | `options.excludeAssetSourceIds?` | [`DefaultAssetSourceId`](./api/node/type-aliases/defaultassetsourceid.md)\[] | A list of IDs, that will be ignored during load. |
 
   #### Returns
@@ -151,18 +153,17 @@ to build and manipulate designs programmatically, or in a browser to create inte
 
   A promise that resolves when all asset sources are loaded.
 
-  #### Signature
+  #### Deprecated
 
-  ```typescript
-  addDefaultAssetSources(options?: object): Promise<void>
-  ```
+  This method uses legacy v4 asset source IDs and will be removed in a future version.
+  Please migrate to v5 asset sources using engine.asset.addLocalAssetSourceFromJSONURI().
 
   ***
 </details>
 
 <details>
   <summary>
-    ### addDemoAssetSources()
+    ### ~~addDemoAssetSources()~~
 
     <br /><p>Register a set of demo asset sources containing example assets.</p>
   </summary>
@@ -183,7 +184,7 @@ to build and manipulate designs programmatically, or in a browser to create inte
   | Parameter | Type | Description |
   | ------ | ------ | ------ |
   | `options?` | \{ `baseURL?`: `string`; `excludeAssetSourceIds?`: [`DemoAssetSourceId`](./api/node/type-aliases/demoassetsourceid.md)\[]; `sceneMode?`: `"Design"` | `"Video"`; `withUploadAssetSources?`: `boolean`; } | Configuration options for loading demo asset sources. |
-  | `options.baseURL?` | `string` | The source of the demo asset definitions, must be absolute. Defaults to IMG.LY CDN. |
+  | `options.baseURL?` | `string` | The source of the demo asset definitions, must be absolute. Defaults to the engine's configured baseURL. |
   | `options.excludeAssetSourceIds?` | [`DemoAssetSourceId`](./api/node/type-aliases/demoassetsourceid.md)\[] | A list of IDs, that will be ignored during load |
   | `options.sceneMode?` | `"Design"` | `"Video"` | If 'Video' video specific demo asset sources will be loaded as well (default 'Design') |
   | `options.withUploadAssetSources?` | `boolean` | If 'true' asset sources for uploads are added (default false) |
@@ -194,11 +195,10 @@ to build and manipulate designs programmatically, or in a browser to create inte
 
   A promise that resolves when all demo asset sources are loaded.
 
-  #### Signature
+  #### Deprecated
 
-  ```typescript
-  addDemoAssetSources(options?: object): Promise<void>
-  ```
+  This method uses legacy v3 demo asset source IDs and will be removed in a future version.
+  Please migrate to v4 asset sources using engine.asset.addLocalAssetSourceFromJSONURI().
 </details>
 
 ## Other

package/assets/docs/guide/edit-image/transform/scale.md

@@ -45,7 +45,6 @@ A value of `2.0`, for example, makes the block twice as large.
   2. Add credentials to `.env`:
      ```bash
      LICENSE_KEY="<your_license_key>"
-     CESDK_BASE_URL="https://cdn.img.ly/packages/imgly/cesdk-node/1.60.0/assets"
      ```
 
   ````
@@ -59,8 +58,7 @@ A value of `2.0`, for example, makes the block twice as large.
 
   async function run() {
     const engine = await CreativeEngine.init({
-      license: process.env.LICENSE_KEY,
-      baseURL: process.env.CESDK_BASE_URL
+      license: process.env.LICENSE_KEY
     });
 
     try {

package/assets/docs/guide/filters-and-effects/duotone.md

@@ -45,7 +45,7 @@ async function main(): Promise<void> {
 
   try {
     // Load the filter asset source to access duotone presets
-    const defaultAssetsUrl = `https://cdn.img.ly/packages/imgly/cesdk-node/${CreativeEngine.version}/assets/v4/`;
+    const defaultAssetsUrl = engine.getBaseURL();
     let hasAssetSources = false;
     try {
       await engine.asset.addLocalAssetSourceFromJSONURI(

package/assets/docs/guide/get-started/bun.md

@@ -81,7 +81,6 @@ const { MimeType } = CreativeEngine as any;
 // Configuration for the engine
 const config = {
   // license: 'YOUR_CESDK_LICENSE_KEY', // Replace with your CE.SDK license key
-  baseURL: `https://cdn.img.ly/packages/imgly/cesdk-node/${CreativeEngine.version}/assets`,
 };
 
 // Initialize CE.SDK Engine
@@ -141,7 +140,6 @@ const { MimeType } = CreativeEngine as any;
 // Configuration for the engine
 const config = {
   // license: 'YOUR_CESDK_LICENSE_KEY', // Replace with your CE.SDK license key
-  baseURL: `https://cdn.img.ly/packages/imgly/cesdk-node/${CreativeEngine.version}/assets`,
 };
 
 // Initialize CE.SDK Engine

package/assets/docs/guide/get-started/deno.md

@@ -68,7 +68,6 @@ const { MimeType } = CreativeEngine as any;
 // CE.SDK configuration
 const config = {
   // license: 'YOUR_CESDK_LICENSE_KEY', // Enter your CE.SDK license key
-  baseURL: `https://cdn.img.ly/packages/imgly/cesdk-node/${CreativeEngine.version}/assets`,
 };
 
 try {

package/assets/docs/guide/get-started/vanilla.md

@@ -89,7 +89,6 @@ import CreativeEngine from '@cesdk/node';
 // Configuration for the engine
 const config = {
   // license: 'YOUR_CESDK_LICENSE_KEY', // Replace with your CE.SDK license key
-  baseURL: `https://cdn.img.ly/packages/imgly/cesdk-node/${CreativeEngine.version}/assets`,
 };
 
 try {
@@ -139,7 +138,6 @@ const { MimeType } = CreativeEngine;
 // Configuration for the engine
 const config = {
   // license: 'YOUR_CESDK_LICENSE_KEY', // Replace with your CE.SDK license key
-  baseURL: `https://cdn.img.ly/packages/imgly/cesdk-node/${CreativeEngine.version}/assets`,
 };
 
 // Initialize CE.SDK Engine

package/assets/docs/guide/import-media/default-assets.md

@@ -25,11 +25,9 @@ async function main(): Promise<void> {
   });
 
   try {
-    // Versioned CDN URLs using the SDK package (recommended)
-    // For production, self-host these assets - see the Serve Assets guide
-    const PACKAGE_BASE = `https://cdn.img.ly/packages/imgly/cesdk-node/${CreativeEngine.version}/assets`;
-    const DEFAULT_ASSETS_URL = `${PACKAGE_BASE}/v4/`;
-    const DEMO_ASSETS_URL = `${PACKAGE_BASE}/demo/v3/`;
+    // Resolve asset sources from the engine's self-hosted baseURL.
+    const DEFAULT_ASSETS_URL = engine.getBaseURL();
+    const DEMO_ASSETS_URL = engine.getBaseURL();
 
     // Load default asset sources (core editor components)
     await engine.asset.addLocalAssetSourceFromJSONURI(
@@ -152,7 +150,7 @@ async function main(): Promise<void> {
 main().catch(console.error);
 ```
 
-Load all asset sources from IMG.LY's CDN to populate your CE.SDK engine with shapes, stickers, filters, effects, fonts, images, and other media for server-side rendering.
+Register CE.SDK's default asset sources from your self-hosted asset library to populate the engine with shapes, stickers, filters, effects, fonts, images, and other media for server-side rendering.
 
 > **Reading time:** 5 minutes
 >
@@ -164,21 +162,21 @@ Load all asset sources from IMG.LY's CDN to populate your CE.SDK engine with sha
 >
 > - [Open in StackBlitz](https://stackblitz.com/github/imgly/cesdk-web-examples/tree/v$UBQ_VERSION$/guides-import-media-default-assets-server-js)
 
-CE.SDK provides built-in asset sources for shapes, stickers, filters, effects, fonts, and sample media. This guide demonstrates loading all available asset sources from IMG.LY's CDN and applying them to create a scene with a star shape, a sticker, and an image, then exporting to PNG.
+CE.SDK provides built-in asset sources for shapes, stickers, filters, effects, fonts, and sample media. This guide demonstrates registering all available asset sources from your self-hosted asset library and applying them to create a scene with a star shape, a sticker, and an image, then exporting to PNG.
 
-> **Production Deployment:** The IMG.LY CDN is for development and prototyping only. For production, download and self-host assets from your own server. See the [Serve Assets](./serve-assets.md) guide for instructions.
+> **Offline-first:** `@cesdk/node` is offline-first and resolves assets from the local package or a location you host — it does not fetch the content library from the IMG.LY CDN. Download the asset library once and extract it, then point `baseURL` at it. See the [Serve Assets](./serve-assets.md) guide for instructions.
 
 ## What Are Default and Demo Assets?
 
-IMG.LY provides two categories of asset sources hosted on the IMG.LY CDN for development and prototyping:
+CE.SDK ships two categories of asset sources you self-host and register with the engine:
 
 **Default Assets** are core editor components:
 
 | Source ID | Description |
 |-----------|-------------|
 | `ly.img.sticker` | Emojis, emoticons, decorations |
-| `ly.img.vectorpath` | Shapes: stars, arrows, polygons |
-| `ly.img.colors.defaultPalette` | Default color palette |
+| `ly.img.vector.shape` | Shapes: stars, arrows, polygons |
+| `ly.img.color.palette` | Default color palette |
 | `ly.img.filter.lut` | LUT-based color filters |
 | `ly.img.filter.duotone` | Duotone color effects |
 | `ly.img.effect` | Visual effects |
@@ -201,12 +199,12 @@ IMG.LY provides two categories of asset sources hosted on the IMG.LY CDN for dev
 
 ## Loading Assets from URL
 
-Use `addLocalAssetSourceFromJSONURI()` to load an asset source directly from a JSON URL:
+Use `addLocalAssetSourceFromJSONURI()` to register an asset source from its `content.json`. `@cesdk/node` is offline-first: it resolves assets relative to the engine's `baseURL` (your self-hosted assets), so no IMG.LY CDN is used at runtime.
 
 ```typescript
-const baseURL = `https://cdn.img.ly/packages/imgly/cesdk-node/${CreativeEngine.version}/assets/v4/`;
+const baseURL = engine.getBaseURL();
 await engine.asset.addLocalAssetSourceFromJSONURI(
-  `${baseURL}ly.img.vectorpath/content.json`
+  `${baseURL}ly.img.vector.shape/content.json`
 );
 ```
 
@@ -221,16 +219,14 @@ const engine = await CreativeEngine.init({
 });
 ```
 
-## Versioned CDN URLs
+## Point at Your Self-Hosted Assets
 
-Use the SDK version to construct versioned CDN URLs. This ensures assets are compatible with your SDK version. For production deployments, see the [Serve Assets](./serve-assets.md) guide to self-host assets.
+`@cesdk/node` resolves asset sources relative to the engine's `baseURL`. Self-host the asset library (extract `imgly-assets.zip`) and set `baseURL` on init — there is no IMG.LY CDN in the production path. See the [Serve Assets](./serve-assets.md) guide for the download and setup steps.
 
-```typescript highlight-cdn-urls
-// Versioned CDN URLs using the SDK package (recommended)
-// For production, self-host these assets - see the Serve Assets guide
-const PACKAGE_BASE = `https://cdn.img.ly/packages/imgly/cesdk-node/${CreativeEngine.version}/assets`;
-const DEFAULT_ASSETS_URL = `${PACKAGE_BASE}/v4/`;
-const DEMO_ASSETS_URL = `${PACKAGE_BASE}/demo/v3/`;
+```typescript highlight-asset-urls
+// Resolve asset sources from the engine's self-hosted baseURL.
+const DEFAULT_ASSETS_URL = engine.getBaseURL();
+const DEMO_ASSETS_URL = engine.getBaseURL();
 ```
 
 ## Loading Default Asset Sources
@@ -282,11 +278,11 @@ engine.dispose();
 Use the `matcher` option to load only specific assets from a source:
 
 ```typescript
-const baseURL = `https://cdn.img.ly/packages/imgly/cesdk-node/${CreativeEngine.version}/assets/v4/`;
+const baseURL = engine.getBaseURL();
 
 // Load only star and arrow shapes
 await engine.asset.addLocalAssetSourceFromJSONURI(
-  `${baseURL}ly.img.vectorpath/content.json`,
+  `${baseURL}ly.img.vector.shape/content.json`,
   { matcher: ['*star*', '*arrow*'] }
 );
 

package/assets/docs/guide/plugins/print-ready-pdf.md

@@ -200,7 +200,6 @@ async function convertToPrintReady() {
   // Initialize CE.SDK Engine
   const engine = await CreativeEngine.init({
     license: 'YOUR_CESDK_LICENSE_KEY',
-    baseURL: `https://cdn.img.ly/packages/imgly/cesdk-node/${CreativeEngine.version}/assets`,
   });
 
   // Load scene from file
@@ -328,7 +327,6 @@ import { readdirSync } from 'fs';
 async function batchConvert() {
   const engine = await CreativeEngine.init({
     license: 'YOUR_CESDK_LICENSE_KEY',
-    baseURL: `https://cdn.img.ly/packages/imgly/cesdk-node/${CreativeEngine.version}/assets`,
   });
 
   // Find all .scene files

package/assets/docs/guide/serve-assets.md

@@ -4,35 +4,40 @@
 
 ---
 
-Configure CE.SDK to load engine assets from your own servers or local filesystem for server-side deployments.
+Configure CE.SDK to load engine assets from your own servers or local
+filesystem for server-side deployments.
 
-The `@cesdk/node` package bundles the core WASM engine files directly. No additional setup is required to initialize the engine and use its APIs.
+The `@cesdk/node` package bundles the core WASM engine files, font fallback files, and the emoji font directly. No additional setup is required to initialize the engine, render text with full Unicode and emoji coverage, and use its APIs offline.
 
-For rendering-only workflows (loading existing scenes and exporting to PDF, PNG, or video), the engine loads scene-referenced assets directly from their embedded URLs. You only need to configure asset paths if you want to self-host font fallback files or emoji assets.
+`@cesdk/node` is offline-first: the default `baseURL` resolves to the package's own `assets/` directory (`file://<pkg>/assets/`), so the engine boots without reaching the IMG.LY CDN. You only need to configure assets when you register content asset sources (stickers, shapes, typefaces, filters, and so on) or want to serve the bundled core and font assets from your own location.
 
-[Download Assets (v$UBQ\_VERSION$)](https://cdn.img.ly/packages/imgly/cesdk-node/$UBQ_VERSION$/imgly-assets.zip)
+For rendering-only workflows (loading existing scenes and exporting to PDF, PNG, or video), the engine loads scene-referenced assets directly from their embedded URLs. You only need to configure asset paths if you want to serve those assets from your own server or CDN instead of the copies bundled in the package.
 
 ## Understanding Asset Categories
 
 The `imgly-assets.zip` contains directories organized by function:
 
-| Directory                       | Contents                        | Bundled in npm? | When Needed                         |
-| ------------------------------- | ------------------------------- | --------------- | ----------------------------------- |
-| `core/`                         | WASM engine files               | **Yes**         | Always (bundled)                    |
-| `i18n/`                         | Translations                    | **Yes**         | Always (bundled)                    |
-| `emoji/`                        | Emoji assets                    | No              | If rendering emojis                 |
-| `fonts/`                        | System fonts                    | No              | If using system fonts               |
+| Directory   | Contents                                                        | Bundled in npm? | When Needed                  |
+| ----------- | --------------------------------------------------------------- | --------------- | ---------------------------- |
+| `core/`     | WASM engine files                                               | **Yes**         | Always (bundled)             |
+| `i18n/`     | Translations                                                    | **Yes**         | Always (bundled)             |
+| `emoji/`    | Emoji assets                                                    | **Yes**         | If rendering emojis          |
+| `fonts/`    | System fonts                                                    | **Yes**         | If using system fonts        |
+| `ly.img.*/` | Content asset sources (stickers, shapes, typefaces, filters, …) | No              | If registering asset sources |
 
-> **Note:** Asset source directories (`ly.img.sticker/`, `ly.img.filter/`, etc.) are only used in browser builds. The server package does not use asset source plugins.
+> **Note:** The `ly.img.*` content sources are usable server-side, but they are not
+> bundled in the npm package. To use them, self-host them from the archive and
+> register each with the engine API. The `@cesdk/cesdk-js/plugins` asset-source
+> plugins are editor-only and are not used with `@cesdk/node`.
 
 ## Engine-Level Assets
 
-The engine uses additional assets for font fallback (Unicode character coverage) and emoji rendering. By default, these are loaded from `https://cdn.img.ly/assets/v7`. When you configure the `basePath` setting for your engine, font fallback files and the emoji font are automatically loaded from that location:
+The engine uses additional assets for font fallback (Unicode character coverage) and emoji rendering. By default, these load from the `assets/` directory bundled inside the `@cesdk/node` package, so they work offline without reaching the IMG.LY CDN. When you set `baseURL` for your engine, font fallback files and the emoji font are loaded from that location instead:
 
-- **Font fallback files** — Used when text contains characters not covered by the selected font. Located at `{basePath}/fonts/font-{index}.ttf`.
-- **Emoji font** — The default emoji font (NotoColorEmoji.ttf). Located at `{basePath}/emoji/NotoColorEmoji.ttf`.
+- **Font fallback files** — Used when text contains characters not covered by the selected font. Located at `{baseURL}/fonts/font-{index}.ttf`.
+- **Emoji font** — The default emoji font (NotoColorEmoji.ttf). Located at `{baseURL}/emoji/NotoColorEmoji.ttf`.
 
-The `fonts/` and `emoji/` directories are already included in the `imgly-assets.zip` download. When you set up self-hosted assets and configure `basePath`, ensure these directories are present at your `basePath` location.
+The `fonts/` and `emoji/` directories ship inside the package and are also included in the `imgly-assets.zip` download. When you self-host and point `baseURL` at your own location, ensure these directories are present there.
 
 ## Self-Hosting Assets
 
@@ -47,7 +52,9 @@ import { pathToFileURL } from 'url';
 
 const engine = await CreativeEngine.init({
   license: 'YOUR_CESDK_LICENSE_KEY',
-  baseURL: pathToFileURL(path.resolve(`./cesdk-assets/${CreativeEngine.version}`)).href + '/'
+  baseURL:
+    pathToFileURL(path.resolve(`./cesdk-assets/${CreativeEngine.version}`))
+      .href + '/'
 });
 
 // Use the engine for processing
@@ -72,6 +79,52 @@ const engine = await CreativeEngine.init({
 });
 ```
 
+## Register Asset Sources
+
+To use the default content sources (stickers, shapes, typefaces, filters, and so on) server-side, extract the archive, point `baseURL` at it, and register each source you need directly through the engine API. This is the same asset API used in the browser; the `@cesdk/cesdk-js/plugins` asset-source plugins are editor-only and are not used with `@cesdk/node`.
+
+[Download Assets (v$UBQ\_VERSION$)](https://cdn.img.ly/packages/imgly/cesdk-node/$UBQ_VERSION$/imgly-assets.zip)
+
+Or download and extract it from the command line:
+
+```bash
+# Download and extract the content assets for your SDK version
+curl -O https://cdn.img.ly/packages/imgly/cesdk-node/$UBQ_VERSION$/imgly-assets.zip
+mkdir -p cesdk-assets/$UBQ_VERSION$
+unzip imgly-assets.zip -d cesdk-assets/$UBQ_VERSION$/
+rm imgly-assets.zip
+```
+
+`engine.getBaseURL()` returns the configured base, so you can point each source at its `content.json` relative to it:
+
+```javascript
+import CreativeEngine from '@cesdk/node';
+import path from 'path';
+import { pathToFileURL } from 'url';
+
+const engine = await CreativeEngine.init({
+  license: 'YOUR_CESDK_LICENSE_KEY',
+  baseURL:
+    pathToFileURL(path.resolve(`./cesdk-assets/${CreativeEngine.version}`))
+      .href + '/'
+});
+
+const baseURL = engine.getBaseURL();
+
+for (const sourceId of [
+  'ly.img.sticker',
+  'ly.img.vector.shape',
+  'ly.img.typeface',
+  'ly.img.filter'
+]) {
+  await engine.asset.addLocalAssetSourceFromJSONURI(
+    `${baseURL}${sourceId}/content.json`
+  );
+}
+```
+
+Point `baseURL` at a `file://` path for local hosting or at your own CDN. For the full list of source IDs and matcher filtering, see the [Default Assets](./import-media/default-assets.md) guide.
+
 ## Troubleshooting
 
 ### File URL Formatting
@@ -82,16 +135,20 @@ When using `file://` URLs:
 - URLs must end with a trailing slash for directories
 - Always use `pathToFileURL()` from the `url` module instead of string concatenation
 
-> **Caution:** **License validation requires network access**: The engine validates your license key against `api.img.ly` during initialization. Ensure your server environment allows outbound HTTPS connections to this endpoint.
+> **Caution:** **License validation requires network access**: The engine validates your
+> license key against `api.img.ly` during initialization. Ensure your server
+> environment allows outbound HTTPS connections to this endpoint.
 
 ## API Reference
 
-| Method/Config | Purpose |
-|--------------|---------|
-| `CreativeEngine.init(config)` | Initialize engine with configuration |
-| `engine.editor.setSettingString('basePath', url)` | Set base path for resolving relative paths and loading font/emoji assets |
-| `CreativeEngine.version` | Get current SDK version string |
-| `pathToFileURL(path)` | Convert filesystem path to `file://` URL (Node.js `url` module) |
+| Method/Config                                                       | Purpose                                                                 |
+| ------------------------------------------------------------------- | ----------------------------------------------------------------------- |
+| `CreativeEngine.init(config)`                                       | Initialize engine with configuration                                    |
+| `config.baseURL`                                                    | Base path for engine and content assets (defaults to the local package) |
+| `engine.getBaseURL()`                                               | Return the configured base URL                                          |
+| `engine.asset.addLocalAssetSourceFromJSONURI(contentURI, options?)` | Register a content asset source from its `content.json`                 |
+| `CreativeEngine.version`                                            | Get current SDK version string                                          |
+| `pathToFileURL(path)`                                               | Convert filesystem path to `file://` URL (Node.js `url` module)         |
 
 
 

package/assets/docs/handbook/SKILL.md

@@ -66,11 +66,11 @@ Return: the FIRST content part is `text` containing JSON `{ revision, parent }`.
 
 **Dirty-on-throw:** if your `code` throws, the engine slot is marked dirty. The next `edit` pays one engine reload (regardless of `parent`). Don't catch and swallow errors that should propagate — let them throw so the safety contract kicks in.
 
-### `preview({ blockId, revision?, format?, width?, height? })`
+### `preview({ blockId, revision, format?, width?, height? })`
 
-Render a block (almost always a page) to an inline image so you can see the result. `blockId` is REQUIRED — preview the page you're working on, not the scene root.
+Render a block (almost always a page) to an inline image so you can see the result. `blockId` and `revision` are BOTH REQUIRED — preview the page you're working on (not the scene root), and pass the `revision` it belongs to.
 
-- Optional `revision`: load that revision into the engine before rendering. Without it, renders the engine's current state (almost always what you want directly after `edit`).
+- `revision` is loaded before rendering, so `blockId` always resolves against the right scene — never against a different design another agent may have loaded on a shared server. Pass the `revision` you got back from `edit` (or one from `list` / `history`).
 - Defaults: `format="webp"`, `width=512`. Width/height clamped at 1800 px.
 
 ### `export({ target, format, revision, blockId })`
@@ -119,13 +119,12 @@ Workspace tools. `list` returns every design's `{ rootRevision, title, latestLea
 
 ⚠ Past code (from `inspect`) reveals the **pattern** of an edit — which APIs were called, what kind of block was targeted — **not block ids**. Block ids are session-scoped: id `127` in a past edit is not the same block in your engine session. Use past code as a discovery template (e.g. `getChildren(page).find(b => engine.block.getType(b) === '...')`); never replay literal numeric ids.
 
-### `open_editor({ revision?, pin? })`
+### `view({ revision, pin? })`
 
-Returns a URL the human can open to view the design in CE.SDK.
+Returns a URL the human can open to view the design in CE.SDK. `revision` is required.
 
 - **`revision`** → the design's **stable URL**. The viewer keeps it live, re-rendering as you `edit` — so print it **once**, don't paste a fresh URL every turn.
-- **`revision` + `pin: true`** → a frozen permalink to that exact revision, for pointing at one specific state (e.g. comparing two revisions side by side). `pin` has no effect without `revision`.
-- **no arguments** → the workspace landing page (mini-studio).
+- **`revision` + `pin: true`** → a frozen permalink to that exact revision, for pointing at one specific state (e.g. comparing two revisions side by side).
 
 The viewer is **read-only** — the human's edits there are local and discarded on your next `edit`. They look, you write.