@scenerok/cli 1.0.7 → 1.0.9

package/dist/commands/render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/commands/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6EpC,eAAO,MAAM,aAAa,SAAwB,CAAC;AAEnD,eAAO,MAAM,aAAa,SA0FtB,CAAC"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/commands/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoFpC,eAAO,MAAM,aAAa,SAAwB,CAAC;AAEnD,eAAO,MAAM,aAAa,SAqItB,CAAC"}

package/dist/commands/render.js

@@ -2,9 +2,10 @@ import { Command } from 'commander';
 import chalk from 'chalk';
 import ora from 'ora';
 import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { join, resolve } from 'node:path';
-import { submitRender, getRenderStatus, downloadRender } from '../lib/api.js';
+import { basename, join, resolve } from 'node:path';
+import { submitRender, getRenderStatus, downloadRender, uploadCliAssets } from '../lib/api.js';
 import { isAuthenticated } from '../lib/config.js';
+import { prepareProject, getMimeType, rewritePreparedVidscriptWithAssetUrls, writeAssetManifest, } from '../lib/project.js';
 function formatDuration(ms) {
     const totalSeconds = Math.max(0, Math.round(ms / 1000));
     const minutes = Math.floor(totalSeconds / 60);
@@ -81,11 +82,54 @@ export const renderCommand = new Command('render')
         process.exit(1);
     }
     let vidscript;
+    let preparedProject = null;
     try {
-        vidscript = readFileSync(file, 'utf-8');
+        preparedProject = prepareProject(file);
+        vidscript = preparedProject.rewrittenVidscript;
     }
     catch {
-        console.log(chalk.red(`❌ Could not read file: ${file}`));
+        try {
+            vidscript = readFileSync(file, 'utf-8');
+        }
+        catch {
+            console.log(chalk.red(`❌ Could not read file: ${file}`));
+            process.exit(1);
+        }
+    }
+    if (preparedProject && preparedProject.assets.length > 0) {
+        const assetSpinner = ora(`Uploading ${preparedProject.assets.length} local asset${preparedProject.assets.length === 1 ? '' : 's'}...`).start();
+        try {
+            const formData = new FormData();
+            for (const asset of preparedProject.assets) {
+                const bytes = readFileSync(asset.absolutePath);
+                const blob = new Blob([new Uint8Array(bytes)], { type: getMimeType(asset.absolutePath) });
+                formData.append('asset', blob, basename(asset.absolutePath));
+                formData.append('assetPath', asset.localPath);
+            }
+            const uploaded = await uploadCliAssets(formData);
+            const mappings = uploaded.assets.map((asset, index) => ({
+                localPath: preparedProject.assets[index].localPath,
+                id: asset.id,
+                url: asset.url,
+                mimeType: asset.mimeType,
+                fileSize: asset.fileSize,
+            }));
+            vidscript = rewritePreparedVidscriptWithAssetUrls(vidscript, mappings);
+            const manifestPath = writeAssetManifest(preparedProject, mappings);
+            assetSpinner.succeed(`Uploaded ${uploaded.assets.length} asset${uploaded.assets.length === 1 ? '' : 's'}`);
+            console.log(chalk.dim(`  Manifest: ${manifestPath}`));
+        }
+        catch (error) {
+            assetSpinner.fail('Asset upload failed');
+            console.error(chalk.red(error instanceof Error ? error.message : String(error)));
+            process.exit(1);
+        }
+    }
+    else if (preparedProject) {
+        vidscript = preparedProject.originalVidscript;
+    }
+    if (vidscript.includes('__SCENEROK_ASSET_')) {
+        console.log(chalk.red('❌ Some local assets could not be uploaded or mapped.'));
         process.exit(1);
     }
     const spinner = ora('Submitting render job...').start();

package/dist/commands/skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/commands/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkIpC,eAAO,MAAM,aAAa,SA4DvB,CAAC"}
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/commands/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwGpC,eAAO,MAAM,aAAa,SA4DvB,CAAC"}

package/dist/commands/skills.js

@@ -4,64 +4,39 @@ import { existsSync, copyFileSync, mkdirSync, readdirSync } from 'node:fs';
 import { join, dirname } from 'node:path';
 import { homedir } from 'node:os';
 function getPlatformConfig(platform) {
-    const cwd = process.cwd();
     const configs = {
         opencode: {
             name: 'OpenCode',
             skillDir: join(homedir(), '.agents/skills/scenerok'),
-            files: [
-                { source: 'skills/opencode/SKILL.md', dest: 'SKILL.md' },
-                { source: 'skills/opencode/vidscript-guide.md', dest: 'vidscript-guide.md' },
-                { source: 'skills/opencode/vidscript-sample.md', dest: 'vidscript-sample.md' },
-                { source: 'skills/opencode/vidscript-strict.md', dest: 'vidscript-strict.md' },
-            ],
         },
         claude: {
             name: 'Claude Code',
             skillDir: join(homedir(), '.claude/skills/scenerok'),
-            files: [
-                { source: 'skills/claude/SKILL.md', dest: 'SKILL.md' },
-                { source: 'skills/claude/vidscript-guide.md', dest: 'vidscript-guide.md' },
-                { source: 'skills/claude/vidscript-sample.md', dest: 'vidscript-sample.md' },
-                { source: 'skills/claude/vidscript-strict.md', dest: 'vidscript-strict.md' },
-            ],
         },
         codex: {
             name: 'Codex',
             skillDir: join(homedir(), '.codex/skills/scenerok'),
-            files: [
-                { source: 'skills/codex/SKILL.md', dest: 'SKILL.md' },
-                { source: 'skills/codex/vidscript-guide.md', dest: 'vidscript-guide.md' },
-                { source: 'skills/codex/vidscript-sample.md', dest: 'vidscript-sample.md' },
-                { source: 'skills/codex/vidscript-strict.md', dest: 'vidscript-strict.md' },
-            ],
         },
         cursor: {
             name: 'Cursor',
             skillDir: join(homedir(), '.cursor/skills/scenerok'),
-            files: [
-                { source: 'skills/cursor/SKILL.md', dest: 'SKILL.md' },
-                { source: 'skills/cursor/vidscript-guide.md', dest: 'vidscript-guide.md' },
-                { source: 'skills/cursor/vidscript-sample.md', dest: 'vidscript-sample.md' },
-                { source: 'skills/cursor/vidscript-strict.md', dest: 'vidscript-strict.md' },
-            ],
         },
         aider: {
             name: 'Aider',
             skillDir: join(homedir(), '.aider/skills/scenerok'),
-            files: [
-                { source: 'skills/aider/SKILL.md', dest: 'SKILL.md' },
-                { source: 'skills/aider/vidscript-guide.md', dest: 'vidscript-guide.md' },
-                { source: 'skills/aider/vidscript-sample.md', dest: 'vidscript-sample.md' },
-                { source: 'skills/aider/vidscript-strict.md', dest: 'vidscript-strict.md' },
-            ],
         },
     };
     return configs[platform] || null;
 }
+const sharedSkillFiles = [
+    'SKILL.md',
+    'vidscript-guide.md',
+    'vidscript-sample.md',
+    'vidscript-strict.md',
+].map((name) => ({ source: `skills/shared/${name}`, dest: name }));
 async function findSkillSource(sourcePath) {
-    // Check relative to node_modules/@scenerok/cli (scoped package)
-    const modulePath = join(dirname(new URL(import.meta.url).pathname), '../../../..', sourcePath);
+    // Check relative to the installed @scenerok/cli package.
+    const modulePath = join(dirname(new URL(import.meta.url).pathname), '../..', sourcePath);
     if (existsSync(modulePath))
         return modulePath;
     // Check relative to CWD
@@ -127,7 +102,7 @@ export const skillsCommand = new Command('skills')
     if (!existsSync(config.skillDir)) {
         mkdirSync(config.skillDir, { recursive: true });
     }
-    for (const file of config.files) {
+    for (const file of sharedSkillFiles) {
         const source = await findSkillSource(file.source);
         const dest = join(config.skillDir, file.dest);
         if (!source) {

package/dist/lib/api.d.ts

@@ -90,6 +90,17 @@ export declare function uploadProject(formData: FormData): Promise<{
     }>;
     render?: Awaited<ReturnType<typeof submitRender>> | null;
 }>;
+export declare function uploadCliAssets(formData: FormData): Promise<{
+    assets: Array<{
+        id: number;
+        filename: string;
+        url: string;
+        mimeType: string | null;
+        fileType: string;
+        fileSize: number;
+        externalId: string | null;
+    }>;
+}>;
 export declare function listProjects(): Promise<{
     projects: Array<{
         id: number;

package/dist/lib/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/lib/api.ts"],"names":[],"mappings":"AAUA,cAAM,QAAS,SAAQ,KAAK;IAGjB,MAAM,EAAE,MAAM;IACd,YAAY,CAAC,EAAE,OAAO;gBAF7B,OAAO,EAAE,MAAM,EACR,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,OAAO,YAAA;CAKhC;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB,EAAE,MAAM,CAAC;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,SAAS,EAAE,KAAK,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,KAAK,GAAG,WAAW,GAAG,MAAM,GAAG,eAAe,CAAC;QAC5D,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;CACJ;AAoGD,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM;WAE9C,OAAO;iBACD,MAAM;aACV,MAAM;eACJ,MAAM;eACN,MAAM,EAAE;wBACC,KAAK,CAAC;QACxB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,SAAS,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,cAAc,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;qBACe,MAAM;mBACR,kBAAkB;aACxB,MAAM,EAAE;YACT,MAAM;GAEjB;AAED,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;cAEhF,MAAM;YACR,MAAM;gBACF,MAAM;oBACF,MAAM;eACX,MAAM;iBACJ,MAAM;aACV,MAAM;kBACD,MAAM;gBACR,MAAM,GAAG,IAAI;GAE5B;AAED,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM;QAE9C,MAAM;YACF,MAAM;cACJ,MAAM;eACL,MAAM,GAAG,IAAI;oBACR,MAAM;eACX,MAAM;iBACJ,MAAM;mBACJ,OAAO;WACf,MAAM,GAAG,IAAI;eACT,MAAM;iBACJ,MAAM,GAAG,IAAI;uBACP,MAAM,GAAG,IAAI;GAEnC;AAED,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAmBpG;AAED,wBAAsB,aAAa,CAAC,QAAQ,EAAE,QAAQ;aAEzC;QACP,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;KACpB;YACO,KAAK,CAAC;QACZ,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;aACO,OAAO,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,GAAG,IAAI;GAE3D;AAED,wBAAsB,YAAY;cAEpB,KAAK,CAAC;QACd,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC;GAEL;AAED,wBAAsB,aAAa,CAAC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO;aAMxE,KAAK,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,QAAQ,EAAE,OAAO,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;GAEL;AAED,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE;aAE5C,KAAK,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,QAAQ,EAAE,OAAO,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;GAEL;AAED,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM;iBAE1C,MAAM;eACR,MAAM;sBACC,MAAM;gBACZ,MAAM;cACR,MAAM;GAEnB;AAED,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM;YAE3C,MAAM;mBACC,MAAM;iBACR,MAAM;iBACN,MAAM;YACX,MAAM;GAEjB;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/lib/api.ts"],"names":[],"mappings":"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"}

package/dist/lib/api.js

@@ -112,6 +112,9 @@ export async function downloadRender(renderId) {
 export async function uploadProject(formData) {
     return apiFormCall('/api/cli/projects', formData);
 }
+export async function uploadCliAssets(formData) {
+    return apiFormCall('/api/cli/assets', formData);
+}
 export async function listProjects() {
     return apiCall('GET', '/api/cli/projects');
 }

package/dist/lib/project.d.ts

@@ -6,9 +6,24 @@ export interface PreparedProject {
     assets: Array<{
         localPath: string;
         absolutePath: string;
+        size: number;
+        sha256: string;
     }>;
 }
+export declare function getMimeType(filePath: string): string;
 export declare function listAssetFiles(assetDir: string): string[];
 export declare function prepareProject(entryFile: string, assetDirs?: string[]): PreparedProject;
 export declare function appendProjectToForm(formData: FormData, project: PreparedProject): Promise<void>;
+export declare function buildAssetToken(localPath: string): string;
+export declare function rewritePreparedVidscriptWithAssetUrls(vidscript: string, mappings: Array<{
+    localPath: string;
+    url: string;
+}>): string;
+export declare function writeAssetManifest(project: PreparedProject, mappings: Array<{
+    localPath: string;
+    url: string;
+    id?: number;
+    mimeType?: string | null;
+    fileSize?: number;
+}>): string;
 //# sourceMappingURL=project.d.ts.map

package/dist/lib/project.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/lib/project.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,KAAK,CAAC;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;CACJ;AAuBD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAoBzD;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,GAAE,MAAM,EAAO,GAAG,eAAe,CAgD3F;AAED,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAcrG"}
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/lib/project.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,KAAK,CAAC;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ;AAcD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAepD;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAoBzD;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,GAAE,MAAM,EAAO,GAAG,eAAe,CAiE3F;AAED,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAcrG;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,qCAAqC,CACnD,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,KAAK,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,GAClD,MAAM,CAMR;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,KAAK,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAC5G,MAAM,CAwBR"}

package/dist/lib/project.js

@@ -1,11 +1,21 @@
-import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { createHash } from 'node:crypto';
+import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
 import { basename, dirname, isAbsolute, join, relative, resolve } from 'node:path';
 const INPUT_RE = /^(\s*input\s+[A-Za-z_][A-Za-z0-9_]*\s*=\s*)(["'])([^"']+)(\2)/gm;
+const ASSET_IMPORT_RE = /^(\s*)import\s+([A-Za-z_][A-Za-z0-9_]*)\s+from\s+(["'])([^"']+)\3\s*;?\s*$/gm;
 const HTTP_RE = /^https?:\/\//i;
+const MEDIA_EXT_RE = /\.(mp4|mov|m4v|webm|mp3|wav|m4a|aac|ogg|png|jpe?g|webp|gif|avif|svg)(?:[?#].*)?$/i;
 function isRenderableLocalPath(value) {
-    return Boolean(value) && !HTTP_RE.test(value) && !value.startsWith('/uploads/') && !value.startsWith('data:');
+    return Boolean(value)
+        && !HTTP_RE.test(value)
+        && !value.startsWith('scenerok://')
+        && !value.startsWith('/uploads/')
+        && !value.startsWith('data:');
 }
-function getMimeType(filePath) {
+function isAssetImportPath(value) {
+    return isRenderableLocalPath(value) && MEDIA_EXT_RE.test(value);
+}
+export function getMimeType(filePath) {
     const ext = filePath.toLowerCase().split('.').pop();
     switch (ext) {
         case 'mp4': return 'video/mp4';
@@ -60,6 +70,18 @@ export function prepareProject(entryFile, assetDirs = []) {
         assetsByPath.set(localPath, absolutePath);
         return `${prefix}${quote}{{asset:${localPath}}}${suffix}`;
     });
+    rewrittenVidscript = rewrittenVidscript.replace(ASSET_IMPORT_RE, (match, indent, localName, _quote, rawPath) => {
+        if (!isAssetImportPath(rawPath)) {
+            return match;
+        }
+        const absolutePath = isAbsolute(rawPath) ? rawPath : resolve(rootDir, rawPath);
+        if (!existsSync(absolutePath)) {
+            return match;
+        }
+        const localPath = relative(rootDir, absolutePath).replace(/\\/g, '/');
+        assetsByPath.set(localPath, absolutePath);
+        return `${indent}input ${localName} = "{{asset:${localPath}}}"`;
+    });
     for (const dir of assetDirs) {
         const absoluteDir = resolve(dir);
         for (const absolutePath of listAssetFiles(absoluteDir)) {
@@ -79,6 +101,8 @@ export function prepareProject(entryFile, assetDirs = []) {
         assets: Array.from(assetsByPath.entries()).map(([localPath, absolutePath]) => ({
             localPath,
             absolutePath,
+            size: statSync(absolutePath).size,
+            sha256: createHash('sha256').update(readFileSync(absolutePath)).digest('hex'),
         })),
     };
 }
@@ -95,3 +119,38 @@ export async function appendProjectToForm(formData, project) {
     }
     formData.set('vidscript', serverVidscript);
 }
+export function buildAssetToken(localPath) {
+    return `__SCENEROK_ASSET_${Buffer.from(localPath).toString('base64url')}__`;
+}
+export function rewritePreparedVidscriptWithAssetUrls(vidscript, mappings) {
+    let next = vidscript;
+    for (const mapping of mappings) {
+        next = next.replaceAll(buildAssetToken(mapping.localPath), mapping.url);
+    }
+    return next;
+}
+export function writeAssetManifest(project, mappings) {
+    const manifestDir = join(project.rootDir, '.scenerok');
+    mkdirSync(manifestDir, { recursive: true });
+    const manifestPath = join(manifestDir, 'assets.manifest.json');
+    const byLocalPath = new Map(project.assets.map((asset) => [asset.localPath, asset]));
+    const manifest = {
+        version: 1,
+        entryFile: project.entryFile,
+        generatedAt: new Date().toISOString(),
+        assets: mappings.map((mapping) => {
+            const localAsset = byLocalPath.get(mapping.localPath);
+            return {
+                localPath: mapping.localPath,
+                absolutePath: localAsset?.absolutePath,
+                size: localAsset?.size ?? mapping.fileSize,
+                sha256: localAsset?.sha256,
+                assetId: mapping.id,
+                mimeType: mapping.mimeType,
+                url: mapping.url,
+            };
+        }),
+    };
+    writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`);
+    return manifestPath;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scenerok/cli",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "SceneRok CLI - Create videos from your terminal and agent workflows",
   "type": "module",
   "bin": {
@@ -16,7 +16,8 @@
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",
-    "prepublishOnly": "npm run build"
+    "sync:skills": "node ../../scripts/sync-scenerok-skills.mjs",
+    "prepublishOnly": "npm run sync:skills && npm run build"
   },
   "keywords": [
     "scenerok",

package/skills/{skills/aider → shared}/SKILL.md

@@ -7,11 +7,11 @@ description: >-
   SceneRok, scenerok CLI, or terminal/agent video generation.
 ---
 
-# SceneRok Skill for Aider
+# SceneRok Agent Skill
 
 ## Overview
 
-You are a VidScript composer and video generation expert integrated with Aider. You help users create video content using the SceneRok platform directly from their terminal.
+You are a VidScript composer and video generation expert integrated with your agent. You help users create video content using the SceneRok platform directly from their terminal.
 
 ## Capabilities
 
@@ -21,6 +21,7 @@ You are a VidScript composer and video generation expert integrated with Aider.
 - Check render status and retrieve output
 - Guide users through video creation workflows
 - Fill template placeholders and customize system templates
+- When the user gives a product or website URL, use available browser or screenshot tools to capture real site visuals for VidScript assets
 
 ## VidScript Language
 
@@ -28,7 +29,7 @@ VidScript is a declarative language for describing video compositions using time
 
 ### Core Concepts
 
-**Inputs** - Declare video sources:
+**Inputs** - Declare video/image sources:
 ```vidscript
 input hero = "https://cdn.example.com/hero.mp4"
 input logo = "/uploads/logo.png"
@@ -91,7 +92,7 @@ import xai from "@scenerok/xai"
 import eleven from "@elevenlabs/music"
 import motion from "@scenerok/basic-animations"
 
-[-] = video xai.imagine("Cinematic product shot", aspect_ratio: "9:16", duration: 5)
+[-] = video xai.imagine("Cinematic product shot, premium lighting, no text, no words, no letters, no captions, no logos, no watermark, no readable UI copy", aspect_ratio: "9:16", duration: 5)
 [-] = audio xai.tts("Welcome to SceneRok", voice: "eve")
 
 # ElevenLabs music package functions require an import alias.
@@ -117,17 +118,37 @@ input hero = "{{hero_clip}}"
 
 1. **Understand the goal** — What video does the user want? (promo, testimonial, meme, etc.)
 2. **Plan the structure** — Time blocks, durations, inputs
-3. **Gather assets** — Video URLs or local paths
-4. **Compose VidScript** — Write the full script
-5. **Validate** — Run `scenerok validate script.vid`
-6. **Render** — Run `scenerok render script.vid --watch`
-7. **Deliver** — Share the download URL when complete
+3. **Gather assets** — Video URLs, local paths, or captured website screenshots/images; when the user provides a URL, use browser screenshot capability if available
+4. **Probe asset dimensions** — Inspect every local or downloaded image/video before placing it. Use `ffprobe` for video/audio, `sips -g pixelWidth -g pixelHeight file` on macOS images, or `identify file` when ImageMagick is available.
+5. **Compose VidScript** — Write the full script using measured dimensions, aspect-ratio-preserving scale, centered/safe-area placement, and entry/exit animation beats for each visual asset
+6. **Validate** — Run `scenerok validate script.vid`
+7. **Render** — Run `scenerok render script.vid --watch`
+8. **Deliver** — Share the download URL when complete
+
+## Website URL Asset Workflow
+
+When the user provides a product, company, landing page, app store listing, or ecommerce URL, treat the site as the primary visual source for the video.
+
+1. Visit the URL with an available browser tool before composing the final VidScript.
+2. Capture screenshots of useful page states: hero section, product detail, pricing or offer section, testimonials, checkout/app preview, and any visual proof points.
+3. Detect and save usable product images, app screenshots, brand marks, and logos from the page when available. Prefer direct image assets only when they are accessible and clearly match the product; otherwise use browser screenshots.
+4. Probe saved asset dimensions before composing. Record width, height, aspect ratio, and duration if video; never guess dimensions from filenames or screenshots.
+5. Use those screenshots or images as VidScript input assets and build the ad from real product visuals. Crop, resize, overlay text, add filters, and sequence them into a promo.
+6. Scale assets from their measured aspect ratio to fit the output frame and safe areas. For 1080x1920 ads, keep primary visuals inside roughly 80-88% of frame width and reserve enough top/bottom room for text.
+7. Animate visual assets intentionally: use entry animations such as `motion.popIn`, `motion.riseIn`, or `motion.slideY`; use short exit fade/slide segments when a clean transition is needed. For static plates, split the asset into a main segment and a final 0.4-0.7s segment with `motion.fadeOut(...)` to create a real exit.
+8. Use generative visuals such as `xai.imagine` only as a fallback, background texture, transition, or supplemental shot when real website assets are missing, low quality, or the user explicitly asks for generated footage.
+9. For every generated visual prompt, explicitly require a clean scene with no text, no words, no letters, no captions, no logos, no watermarks, and no readable UI copy. AI video generation often corrupts text; all final titles, offers, captions, CTAs, prices, and labels must be created with VidScript `text` primitives.
+10. Do not invent product claims. Extract copy, pricing, feature names, social proof, and CTA language from the site or ask the user.
 
 ## Best Practices
 
 - **Use dynamic timeblocks** — `[-]` auto-advances the cursor, reducing calculation errors
 - **Use `prev` for offsets** — `[prev + 0.5s .. prev + 2s]` for gaps between content
 - **Named arguments for clarity** — `hero.Trim(start: 0s, end: 5s)` over `hero.Trim(0s, 5s)`
+- **Prefer real website assets for URL-based ads** — browser screenshots, product images, app screenshots, and logos should come before fully generative clips
+- **Probe before placing** — get exact dimensions for every real asset, calculate scale from aspect ratio, and set `width`, `height`, `x`, and `y` explicitly
+- **Animate assets, not only text** — give product screenshots/logos/cards a clear entrance and a clean exit; split static visuals into main and fade-out segments if needed
+- **Keep generated media text-free** — prompts for AI-generated images/videos must explicitly say no text, no words, no letters, no captions, no logos, no watermarks, and no readable UI copy; add all final copy with VidScript `text` primitives
 - Use 1080x1920 for vertical content (TikTok/Instagram)
 - Use 1920x1080 for horizontal content (YouTube)
 - Hook viewers in the first 3 seconds
@@ -167,7 +188,7 @@ If a render fails:
 Always ask clarifying questions about:
 - Target platform (TikTok, Instagram, YouTube, etc.)
 - Brand colors and fonts
-- Existing assets (video clips, logo, etc.)
+- Existing assets, product URLs, browser-captured screenshots, logos, and page images
 - Desired duration and style
 - Whether they want to start from a template or from scratch
 
@@ -180,6 +201,15 @@ Always ask clarifying questions about:
 | `vidscript-sample.md` | Minimal promo with xAI import |
 | `examples/system/*.vid` | Official SceneRok templates (text-only, product launch, xAI reels) |
 
+## SceneRok codebase development
+
+This skill covers **VidScript composition and rendering videos**. For engineering on the SceneRok platform (parser, render subsystem, API, billing, GPU workers), load the **`scenerok-development`** skill from `.agents/skills/scenerok-development/` in the SceneRok repository.
+
+| Doc | Purpose |
+|-----|---------|
+| `plan-v1/35-render-subsystem-architecture.md` | Render registries, IR flow, extension points |
+| `AGENTS.md` | Project context, env vars, dev commands |
+
 ## Full Reference
 
 https://scenerok.com/docs/vidscript

package/skills/{claude → shared}/vidscript-guide.md

@@ -8,7 +8,11 @@ VidScript is a declarative DSL for composing short-form videos. Write a script,
 2. **Validate early** — `scenerok validate file.vid` (errors show as `Line N:C — message`).
 3. **Music package syntax** — `import eleven from "@elevenlabs/music"`, then call `eleven.music(...)`, `eleven.generateMusic(...)`, or `eleven.composeMusic(...)`.
 4. **Copy working examples** — see `examples/system/` in this skill folder (e.g. `minimal-text-reel.vid`, `ecom-product-launch.vid`, `rokmilk-chocolate-promo.vid`).
-5. **Strict rules** — see `vidscript-strict.md` for invalid patterns (bare `xai.imagine`, bare `eleven.music(...)` without import, trailing params after direct plugin calls, nested quotes in prompts).
+5. **URL assets first** — if the user gives a website or product URL and browser screenshot tools are available, capture real page screenshots, product images, app screenshots, and logos for VidScript `input` assets before using generated visuals.
+6. **Probe asset dimensions** — before placing real assets, inspect width, height, and duration with `ffprobe`, `sips`, or `identify`; then scale from the measured aspect ratio and set explicit `width`, `height`, `x`, and `y`.
+7. **Animate real assets** — visual inputs should have entry motion and, where transitions matter, an exit beat. For static plates, split into a main segment and a short final `motion.fadeOut(...)` segment.
+8. **Generated media has no text** — prompts for AI-generated images/videos must explicitly ask for no text, no words, no letters, no captions, no logos, no watermarks, and no readable UI copy. Use VidScript `text` primitives for all final copy.
+9. **Strict rules** — see `vidscript-strict.md` for invalid patterns (bare `xai.imagine`, bare `eleven.music(...)` without import, trailing params after direct plugin calls, nested quotes in prompts).
 
 ### Common validation failures
 
@@ -39,7 +43,28 @@ input hero = "https://cdn.example.com/hero.mp4"
 input logo = "./assets/logo.png"
 ```
 
-Supports HTTP(S) URLs, `/uploads/` paths, and local paths.
+Supports HTTP(S) URLs, `/uploads/` paths, and local paths for video/image assets.
+
+For ads based on a supplied URL, use browser tools to capture real website screenshots and save product images or logos when available. Declare those files as inputs and use them in the composition before reaching for generated clips.
+
+After declaring or downloading assets, probe dimensions before placing them:
+
+```bash
+ffprobe -v error -select_streams v:0 -show_entries stream=width,height,duration -of csv=p=0 asset.mp4
+sips -g pixelWidth -g pixelHeight asset.png
+identify asset.webp
+```
+
+Use the measured width and height to preserve aspect ratio. For a 1080x1920 vertical ad, a common centered fit is:
+
+```text
+scaledWidth = min(assetWidth * scale, 900)
+scaledHeight = scaledWidth / (assetWidth / assetHeight)
+x = (1080 - scaledWidth) / 2
+y = chosen safe-area top offset
+```
+
+Do not guess asset size. Tiny logos, wide screenshots, and tall app screenshots need different scale and placement.
 
 ### Output Declaration
 
@@ -152,7 +177,7 @@ hero.Speed(factor: 1.5)
 | `x` | number \| string | Horizontal position. Number = px from left. `"50%"` = percent of width. Overrides `position`. |
 | `y` | number \| string | Vertical position. Number = px from top. `"50%"` = percent of height. Overrides `position`. |
 | `color` | string | Hex color |
-| `size` | number | Font size in pixels |
+| `size` | number \| string | Font size in output canvas pixels. `size: 72` is shorthand for `size: "72px"`. |
 | `font` | string | Font family. System fonts or Google Fonts: `"Inter"`, `"Bebas Neue"`, `"Space Grotesk"`, `"Outfit"`, etc. |
 | `align` | string | `left`, `center`, `right`. Default: `center` |
 | `line_height` | number | Line height multiplier for multi-line text. Default: 1.2 |
@@ -233,7 +258,7 @@ import xai from "@scenerok/xai"
 import eleven from "@elevenlabs/music"
 import motion from "@scenerok/basic-animations"
 
-[-] = video xai.imagine("Cinematic product shot", aspect_ratio: "9:16", duration: 5)
+[-] = video xai.imagine("Cinematic product shot, premium lighting, no text, no words, no letters, no captions, no logos, no watermark, no readable UI copy", aspect_ratio: "9:16", duration: 5)
 [-] = audio xai.tts("Welcome to SceneRok", voice: "eve")
 
 # ElevenLabs music package functions require an import alias.
@@ -254,68 +279,77 @@ let bed = eleven.music("Warm premium launch bed", duration: 15, instrumental: tr
 [0s .. 15s] = audio eleven.music("..."), volume: 0.5      # trailing params after direct plugin call
 ```
 
-## Animations, Effects & Plugins (v2 Extensibility)
+## Animations, Effects & Rendering (v2)
 
-VidScript v2 uses a **minimal-grammar, plugin-first** architecture for animations and effects.
+VidScript v2 uses a **minimal-grammar, plugin-first** architecture. The compiler lowers VidScript into `IRTimeline` — the single contract shared by browser preview and final render.
 
-Instead of adding dozens of animation keywords to the language, we use two powerful parameters:
+User-facing extension uses two parameters on any text or video surface:
 
-- `animate:`
-- `effects:`
-
-These accept either plugin function calls or plain object descriptors.
+- `animate:` — motion over time (plugin calls or object descriptors)
+- `effects:` — post-processing filters with optional animated params
 
 ### animate: parameter
 
-Attach animations to **any** text or video surface.
-
 ```vidscript
 import motion from "@scenerok/basic-animations"
 
-text "Hello", animate: motion.fadeIn(0.8s)
+[0s .. 3s] = text "Hello", x: "50%", y: "50%", animate: motion.fadeIn(0.8s)
 
-video hero, animate: [motion.fadeIn(0.5s), motion.slideY(-40, 0, 1.2s)]
+[-] = video hero, animate: [motion.fadeIn(0.5s), motion.slideY(-40, 0, 1.2s)]
 
-text "Title", animate: {
+# Static asset with measured 4:3-ish aspect ratio, centered in a vertical 1080x1920 frame.
+[0s .. 3.4s] = video app_screen, width: 760, height: 615, x: 160, y: 300, animate: [motion.riseIn(0.6s, 70), motion.float(2.4s, 8)]
+[3.4s .. 4s] = video app_screen, width: 760, height: 615, x: 160, y: 300, animate: motion.fadeOut(0.6s)
+
+[0s .. 2s] = text "Title", animate: {
   type: "fade",
   from: { opacity: 0 },
   to: { opacity: 1 },
   start: 0,
-  end: 1.5
+  end: 1.5,
+  easing: "easeOutQuad"
 }
 ```
 
-### effects: parameter
+Compiler lowers `animate:` into `IRMotionTrack[]` (property-path keyframes). Legacy `IRAnimation` descriptors are adapted at runtime for backward compatibility.
 
-Attach post-processing effects, with support for animated parameters.
+### effects: parameter
 
 ```vidscript
-text "Dramatic", effects: [grayscale(intensity: 0.8)]
+[0s .. 5s] = filter "vignette", intensity: 0.4
 
-video hero, effects: [{
-  name: "glitch",
-  strength: animate: { type: "fade", from: { strength: 0 }, to: { strength: 1 } }
-}]
+[0s .. 5s] = filter "glitch", intensity: 0.5, animate: motion.fadeIn(1s)
 ```
 
-### Currently Available Animation Functions (`basic-animations` plugin)
-
-| Function                  | Description                  |
-|---------------------------|------------------------------|
-| `motion.fadeIn(duration?)`       | Opacity 0 → 1                |
-| `motion.fadeOut(duration?)`      | Opacity 1 → 0                |
-| `motion.slideX(from, to, dur?)`  | Horizontal slide             |
-| `motion.slideY(from, to, dur?)`  | Vertical slide               |
-| `motion.popIn(duration?)`        | Scale + fade entrance        |
-| `motion.riseIn(duration?, dist?)` | Upward fade entrance         |
-| `motion.swingIn(duration?)`      | Rotating slide/fade         |
-| `motion.glitchIn(duration?)`     | Jitter + flash entrance      |
-| `motion.float(duration?, amp?)`   | Gentle vertical bob          |
-| `motion.typewriter(duration?)`   | Character reveal             |
-
-More plugins (advanced text animations, pixel effects, 3D, etc.) are planned.
+Built-in filters: `monochrome`, `sepia`, `blur`, `chromatic`, `glitch`, `vignette`, `contrast`, `saturation`, `brightness`.
 
-The full architecture and IR details live in `plan-v1/29-surface-animation-effect-plugin-architecture.md`.
+### Animation functions (`@scenerok/basic-animations`)
+
+| Function | Description |
+|----------|-------------|
+| `motion.fadeIn(duration?)` | Opacity 0 → 1 |
+| `motion.fadeOut(duration?)` | Opacity 1 → 0 |
+| `motion.slideX(from, to, dur?)` | Horizontal slide |
+| `motion.slideY(from, to, dur?)` | Vertical slide |
+| `motion.popIn(duration?)` | Scale + fade entrance |
+| `motion.riseIn(duration?, dist?)` | Upward fade entrance |
+| `motion.swingIn(duration?)` | Rotating slide/fade |
+| `motion.glitchIn(duration?)` | Jitter + flash entrance |
+| `motion.float(duration?, amp?)` | Gentle vertical bob |
+| `motion.typewriter(duration?)` | Character reveal |
+
+### Render architecture (contributors)
+
+Implemented registry-based rendering. See `plan-v1/35-render-subsystem-architecture.md`.
+
+| Registry | Path | Add via |
+|----------|------|---------|
+| Motion | `src/lib/motion/registry.ts` | `registerEasing`, `registerMotionBehavior` |
+| Surface | `src/render/surfaces/registry.ts` | `registerSurfaceRenderer` |
+| Effect | `src/render/effects/registry.ts` | `registerEffect` or `src/shaders/library.ts` |
+| Engine | `src/render/engine/index.ts` | `createRenderEngine` backends |
+
+For SceneRok platform engineering, load the **`scenerok-development`** skill (`.agents/skills/scenerok-development/`).
 
 ## Expressions