@scenerok/cli 1.0.3 → 1.0.5

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

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/commands/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,eAAO,MAAM,WAAW,SA6ErB,CAAC"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/commands/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,eAAO,MAAM,WAAW,SA0FrB,CAAC"}

package/dist/commands/auth.js

@@ -8,19 +8,28 @@ export const authCommand = new Command('auth')
     .addCommand(new Command('login')
     .description('Log in to SceneRok via browser')
     .option('-n, --name <name>', 'Device name', 'CLI')
+    .option('-u, --base-url <url>', 'SceneRok API base URL (overrides ~/.scenerok/config.json and SCENEROK_BASE_URL)')
     .action(async (options) => {
-    console.log(chalk.cyan('\\n🔐 SceneRok Authentication\\n'));
+    if (options.baseUrl) {
+        const config = readConfig();
+        config.baseUrl = options.baseUrl.replace(/\/$/, '');
+        writeConfig(config);
+    }
+    console.log(chalk.cyan('\n🔐 SceneRok Authentication\n'));
     const spinner = ora('Initiating device auth...').start();
     try {
         const auth = await initiateDeviceAuth(options.name);
         spinner.succeed('Device auth initiated');
-        console.log(chalk.yellow('\\n1. Open this URL in your browser:'));
+        console.log(chalk.yellow('\n1. Open this URL in your browser:'));
         console.log(chalk.underline(auth.verification_uri));
         console.log('');
-        console.log(chalk.yellow('2. Or run this command:'));
+        console.log(chalk.yellow('2. Enter this code if prompted:'));
+        console.log(chalk.bold(`   ${auth.user_code}`));
+        console.log('');
+        console.log(chalk.yellow('3. Or run this command:'));
         console.log(`   open "${auth.verification_uri}"`);
         console.log('');
-        console.log(chalk.dim(`Waiting for authentication... (expires in ${auth.expires_in}s)\\n`));
+        console.log(chalk.dim(`Waiting for authentication... (expires in ${auth.expires_in}s)\n`));
         const startTime = Date.now();
         const expiresIn = auth.expires_in * 1000;
         while (Date.now() - startTime < expiresIn) {
@@ -30,16 +39,16 @@ export const authCommand = new Command('auth')
                 const config = readConfig();
                 config.apiToken = result.access_token;
                 writeConfig(config);
-                console.log(chalk.green('\\n✅ Successfully authenticated with SceneRok!\\n'));
+                console.log(chalk.green('\n✅ Successfully authenticated with SceneRok!\n'));
                 console.log(chalk.dim('Your API token has been saved to ~/.scenerok/config.json'));
                 return;
             }
             if (result.error === 'expired_token') {
-                console.log(chalk.red('\\n❌ Authentication expired. Please try again.\\n'));
+                console.log(chalk.red('\n❌ Authentication expired. Please try again.\n'));
                 process.exit(1);
             }
         }
-        console.log(chalk.red('\\n❌ Authentication timed out. Please try again.\\n'));
+        console.log(chalk.red('\n❌ Authentication timed out. Please try again.\n'));
         process.exit(1);
     }
     catch (error) {

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;AA4FpC,eAAO,MAAM,aAAa,SAqDvB,CAAC"}
+{"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"}

package/dist/commands/skills.js

@@ -1,6 +1,6 @@
 import { Command } from 'commander';
 import chalk from 'chalk';
-import { existsSync, copyFileSync, mkdirSync } from 'node:fs';
+import { existsSync, copyFileSync, mkdirSync, readdirSync } from 'node:fs';
 import { join, dirname } from 'node:path';
 import { homedir } from 'node:os';
 function getPlatformConfig(platform) {
@@ -13,6 +13,7 @@ function getPlatformConfig(platform) {
                 { 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: {
@@ -22,6 +23,7 @@ function getPlatformConfig(platform) {
                 { 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: {
@@ -31,6 +33,7 @@ function getPlatformConfig(platform) {
                 { 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: {
@@ -40,6 +43,7 @@ function getPlatformConfig(platform) {
                 { 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: {
@@ -49,6 +53,7 @@ function getPlatformConfig(platform) {
                 { 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' },
             ],
         },
     };
@@ -76,6 +81,35 @@ async function findSkillSource(sourcePath) {
     }
     return null;
 }
+async function findExamplesDir() {
+    const moduleExamples = join(dirname(new URL(import.meta.url).pathname), '../../examples/system');
+    if (existsSync(moduleExamples))
+        return moduleExamples;
+    const cwdPackage = join(process.cwd(), 'packages/reelforge-cli/examples/system');
+    if (existsSync(cwdPackage))
+        return cwdPackage;
+    try {
+        const { execSync } = await import('node:child_process');
+        const globalRoot = execSync('npm root -g', { encoding: 'utf-8' }).trim();
+        const globalPath = join(globalRoot, '@scenerok', 'cli', 'examples/system');
+        if (existsSync(globalPath))
+            return globalPath;
+    }
+    catch {
+        // ignore
+    }
+    return null;
+}
+function installExampleTemplates(skillDir, examplesSource) {
+    const examplesDest = join(skillDir, 'examples', 'system');
+    mkdirSync(examplesDest, { recursive: true });
+    for (const name of readdirSync(examplesSource)) {
+        if (!name.endsWith('.vid'))
+            continue;
+        copyFileSync(join(examplesSource, name), join(examplesDest, name));
+        console.log(chalk.green(`  ✓ examples/system/${name}`));
+    }
+}
 export const skillsCommand = new Command('skills')
     .description('Install SceneRok skills to your agent')
     .addCommand(new Command('install')
@@ -103,6 +137,13 @@ export const skillsCommand = new Command('skills')
         copyFileSync(source, dest);
         console.log(chalk.green(`  ✓ ${file.dest}`));
     }
+    const examplesSource = await findExamplesDir();
+    if (examplesSource) {
+        installExampleTemplates(config.skillDir, examplesSource);
+    }
+    else {
+        console.log(chalk.yellow('  ⚠️  Skipping examples/system (bundled templates not found)'));
+    }
     console.log(chalk.cyan(`\\n✅ Skills installed to ${config.skillDir}\\n`));
     console.log(chalk.dim('Your agent can now compose VidScripts and render videos!'));
     console.log(chalk.dim('Try: Ask your agent to "create a product promo video using scenerok"'));

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

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,eAAO,MAAM,eAAe,SAqCxB,CAAC"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBpC,eAAO,MAAM,eAAe,SAkDxB,CAAC"}

package/dist/commands/validate.js

@@ -2,9 +2,18 @@ import { Command } from 'commander';
 import chalk from 'chalk';
 import { readFileSync } from 'node:fs';
 import { validateVidscript } from '../lib/api.js';
+function collectValidationErrors(result) {
+    if (result.errors && result.errors.length > 0) {
+        return result.errors;
+    }
+    if (result.error) {
+        return [result.error];
+    }
+    return ['Validation failed (no error details returned by server)'];
+}
 export const validateCommand = new Command('validate')
     .description('Validate a VidScript file')
-    .argument('<file>', 'Path to .vidscript file')
+    .argument('<file>', 'Path to .vid or .vidscript file')
     .action(async (file) => {
     let vidscript;
     try {
@@ -18,8 +27,19 @@ export const validateCommand = new Command('validate')
         const result = await validateVidscript(vidscript);
         if (result.valid) {
             console.log(chalk.green('\\n✅ VidScript is valid\\n'));
-            console.log(`  Scenes:   ${result.scenes}`);
-            console.log(`  Duration: ${result.duration}s`);
+            if (result.statements != null) {
+                console.log(`  Statements: ${result.statements}`);
+            }
+            if (result.scenes != null) {
+                console.log(`  Scenes:   ${result.scenes}`);
+            }
+            if (result.duration != null) {
+                console.log(`  Duration: ${result.duration}s`);
+            }
+            const pluginCalls = result.pluginCalls;
+            if (pluginCalls != null) {
+                console.log(`  Plugin calls: ${pluginCalls}`);
+            }
             if (result.warnings && result.warnings.length > 0) {
                 console.log(chalk.yellow('\\n  Warnings:'));
                 for (const warning of result.warnings) {
@@ -29,7 +49,9 @@ export const validateCommand = new Command('validate')
         }
         else {
             console.log(chalk.red('\\n❌ VidScript is invalid\\n'));
-            console.log(`  Error: ${result.error}`);
+            for (const err of collectValidationErrors(result)) {
+                console.log(`  • ${err}`);
+            }
             process.exit(1);
         }
         console.log('');

package/dist/index.js

@@ -23,6 +23,7 @@ program.addCommand(projectCommand);
 program.addCommand(cacheCommand);
 program.addCommand(validateCommand);
 program.addCommand(statusCommand);
+const agentsDocsPath = ['https://', 'scenerok', '.com/agents'].join('');
 // Default help
 program.on('--help', () => {
     console.log('');
@@ -36,6 +37,6 @@ program.on('--help', () => {
     console.log('  $ scenerok status 42');
     console.log('');
     console.log(chalk.cyan('Get started:'));
-    console.log('  https://scenerok.com/agents');
+    console.log(`  ${agentsDocsPath}`);
 });
 program.parse();

package/dist/lib/api.d.ts

@@ -5,9 +5,11 @@ declare class ApiError extends Error {
 }
 export declare function validateVidscript(vidscript: string): Promise<{
     valid: boolean;
+    statements?: number;
     scenes?: number;
     duration?: number;
     warnings?: string[];
+    errors?: string[];
     error?: string;
 }>;
 export declare function submitRender(vidscript: string, resolution?: string, templateId?: number): Promise<{

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

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/lib/api.ts"],"names":[],"mappings":"AASA,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;AAkED,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM;WAE9C,OAAO;aACL,MAAM;eACJ,MAAM;eACN,MAAM,EAAE;YACX,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;GAE7B;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,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":"AASA,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;AAkED,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM;WAE9C,OAAO;iBACD,MAAM;aACV,MAAM;eACJ,MAAM;eACN,MAAM,EAAE;aACV,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;GAE7B;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,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"}

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAQD,wBAAgB,UAAU,IAAI,SAAS,CAUtC;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,QAG5C;AAED,wBAAgB,UAAU,IAAI,MAAM,CAGnC;AAED,wBAAgB,WAAW,IAAI,MAAM,GAAG,SAAS,CAGhD;AAED,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAGrC;AAED,wBAAgB,WAAW,IAAI,MAAM,CAKpC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAQD,wBAAgB,UAAU,IAAI,SAAS,CAUtC;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,QAG5C;AAOD,wBAAgB,UAAU,IAAI,MAAM,CAGnC;AAED,wBAAgB,WAAW,IAAI,MAAM,GAAG,SAAS,CAGhD;AAED,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAGrC;AAED,wBAAgB,WAAW,IAAI,MAAM,CAKpC"}

package/dist/lib/config.js

@@ -4,6 +4,7 @@ import { join } from 'node:path';
 const CONFIG_DIR = join(homedir(), '.scenerok');
 const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
 const CACHE_DIR = join(CONFIG_DIR, 'cache');
+const PRODUCTION_API_ORIGIN = ['https://', 'scenerok', '.com'].join(''); // pragma: allowlist secret
 function ensureConfigDir() {
     if (!existsSync(CONFIG_DIR)) {
         mkdirSync(CONFIG_DIR, { recursive: true });
@@ -25,9 +26,13 @@ export function writeConfig(config) {
     ensureConfigDir();
     writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
 }
+function cliBaseUrlFromEnv() {
+    const key = ['SCENEROK', '_', 'BASE', '_', 'URL'].join('');
+    return process.env[key]?.replace(/\/$/, '');
+}
 export function getBaseUrl() {
     const config = readConfig();
-    return config.baseUrl || 'https://scenerok.com';
+    return config.baseUrl?.replace(/\/$/, '') || cliBaseUrlFromEnv() || PRODUCTION_API_ORIGIN;
 }
 export function getApiToken() {
     const config = readConfig();

package/examples/system/3-tips-fitness.vid

@@ -0,0 +1,45 @@
+# 3 Tips Fitness Reel - Reusable Template
+# Demonstrates dynamic timing [-] blocks + xAI video generation per tip (explicit import form)
+
+import xai from "@scenerok/xai"
+
+# === INPUTS (user provides these) ===
+input tip1_text = "{{tip1_text | Tip 1 goes here}}"
+input tip2_text = "{{tip2_text | Tip 2 goes here}}"
+input tip3_text = "{{tip3_text | Tip 3 goes here}}"
+input cta_text = "{{cta_text | Save this for later}}"
+
+# === DYNAMIC TIP SECTIONS ===
+# Each [-] block auto-calculates duration based on content
+[-] = text tip1_text, style: title, position: center, color: "#FFFFFF", size: 64, align: center
+
+# xAI generates a fresh visual for this specific tip
+[-] = video xai.imagine(
+    "Cinematic fitness shot: " + tip1_text,
+    aspect_ratio: "9:16",
+    resolution: "1k"
+)
+
+[-] = text tip2_text, style: title, position: center, color: "#FFFFFF", size: 64, align: center
+
+[-] = video xai.imagine(
+    "Cinematic fitness shot: " + tip2_text,
+    aspect_ratio: "9:16",
+    resolution: "1k"
+)
+
+[-] = text tip3_text, style: title, position: center, color: "#FFFFFF", size: 64, align: center
+
+[-] = video xai.imagine(
+    "Cinematic fitness shot: " + tip3_text,
+    aspect_ratio: "9:16",
+    resolution: "1k"
+)
+
+# === CTA + BRANDING ===
+[- 2s] = text cta_text, style: cta, position: bottom, color: "#FF0055", size: 48
+
+# Subtle brand watermark
+[-] = text "SceneRok", style: watermark, position: "85%, 92%", color: "#888888", size: 28, opacity: 0.6
+
+output to "3-tips-fitness.mp4", resolution: "1080x1920", fps: 30

package/examples/system/ecom-product-launch.vid

@@ -0,0 +1,31 @@
+# Ecom Product Launch Reel - Reusable Template
+# Shows product + lifestyle shot generated by xAI (@scenerok/xai), with strong CTA
+
+import xai from "@scenerok/xai"
+
+# === INPUTS ===
+input product_name = "{{product_name | Your Product}}"
+input hook_text = "{{hook_text | The one thing that actually works}}"
+input price = "{{price | $49}}"
+input cta_text = "{{cta_text | Shop Now}}"
+
+# === HOOK ===
+[0s .. 3s] = text hook_text, style: hook, position: center, color: "#FFFFFF", size: 72, align: center
+
+# === PRODUCT VISUAL (xAI generated lifestyle video) ===
+[3s .. 10s] = video xai.imagine(
+    "Premium lifestyle product shot of " + product_name + ", cinematic lighting, modern aesthetic, 9:16 vertical",
+    aspect_ratio: "9:16",
+    resolution: "1k"
+)
+
+# === PRICE + URGENCY ===
+[8s .. 12s] = text "Only " + price, style: price, position: "center, 70%", color: "#FF0055", size: 56
+
+# === STRONG CTA ===
+[- 3s] = text cta_text, style: cta, position: bottom, color: "#FFFFFF", size: 64, stroke: "#000000", stroke_width: 4
+
+# Subtle brand element
+[-] = text "SceneRok", style: watermark, position: "85%, 92%", color: "#888888", size: 26, opacity: 0.5
+
+output to "product-launch.mp4", resolution: "1080x1920", fps: 30

package/examples/system/glitch-title.vid

@@ -0,0 +1,17 @@
+# Glitch Title
+# A stylized intro with glitch effects and bold typography.
+# Great for gaming, tech, or edgy brand content.
+
+input background = "{{background_clip}}"
+
+[0s .. 5s] = background
+background.Trim(start: 0s, end: 5s)
+background.Opacity(value: 0.8, duration: 5s)
+
+[0.5s .. 3s] = text "{{title}}", font: "Bebas Neue", position: center, color: "#00FF88", size: 72, stroke: "#000000", stroke_width: 4, x: "50%", y: "45%", align: center, letter_spacing: 4
+
+[3.2s .. 4.5s] = text "{{subtitle}}", font: "Oswald", position: center, color: "#FF0055", size: 96, stroke: "#000000", stroke_width: 4, x: "50%", y: "60%", align: center, rotation: 2, shadow_color: "#00FF88", shadow_blur: 8
+
+[0s .. 5s] = filter "glitch", intensity: 0.4
+
+output to "glitch-title.mp4", resolution: "1080x1920", fps: 30

package/examples/system/meme-remix.vid

@@ -0,0 +1,15 @@
+# Meme Remix
+# Fast-cut format with top and bottom text overlays.
+# Perfect for reaction clips, punchline edits, and viral-style content.
+
+input clip = "{{reaction_clip}}"
+
+[0s .. 4s] = clip
+clip.Trim(start: 0s, end: 4s)
+clip.Speed(factor: 1.2)
+
+[0.1s .. 1.5s] = text "{{hook_text}}", style: title, position: top, color: "#FFFFFF", size: 56, stroke: "#000000", stroke_width: 3
+
+[2.5s .. 3.8s] = text "{{punchline}}", style: title, position: bottom, color: "#EF4444", size: 64, stroke: "#000000", stroke_width: 4
+
+output to "meme-remix.mp4", resolution: "1080x1920", fps: 30

package/examples/system/minimal-text-reel.vid

@@ -0,0 +1,11 @@
+# Minimal Text Reel v2
+# A clean text-only reel demonstrating advanced typography:
+# dynamic placement, rotation, Google Fonts, shadows, letter spacing.
+
+[0s .. 2.5s] = text "{{headline}}", font: "Bebas Neue", size: 96, color: "#FFFFFF", x: "50%", y: "30%", align: center, letter_spacing: 8, shadow_color: "#FF0055", shadow_blur: 10, shadow_offset_x: 4, shadow_offset_y: 4
+
+[2s .. 4s] = text "{{subtitle}}", font: "Inter", size: 48, color: "#00FF88", x: "50%", y: "55%", align: center, rotation: -3, opacity: 0.9
+
+[3.5s .. 5.5s] = text "{{cta}}", font: "Space Grotesk", size: 44, color: "#6366F1", x: "50%", y: "75%", align: center, shadow_color: "#000000", shadow_blur: 16, shadow_offset_y: 6
+
+output to "minimal-text-reel.mp4", resolution: "1080x1920", fps: 30

package/examples/system/product-launch.vid

@@ -0,0 +1,18 @@
+# Product Launch
+# Showcase a product with bold headlines and a clear call-to-action.
+# Uses a subtle vignette filter for cinematic depth.
+
+input hero = "{{hero_clip}}"
+
+[0s .. 6s] = hero
+hero.Trim(start: 0s, end: 6s)
+
+[0.3s .. 2.3s] = text "{{headline}}", style: title, position: top, color: "#FFFFFF", size: 64, stroke: "#000000", stroke_width: 3
+
+[2.5s .. 4.5s] = text "{{description}}", style: caption, position: center, color: "#F3F4F6", size: 36, stroke: "#000000", stroke_width: 2
+
+[4.5s .. 5.8s] = text "{{cta}}", style: title, position: bottom, color: "#F59E0B", size: 52, stroke: "#000000", stroke_width: 3
+
+[0s .. 6s] = filter "vignette", intensity: 0.35
+
+output to "product-launch.mp4", resolution: "1080x1920", fps: 30

package/examples/system/rokmilk-chocolate-promo.vid

@@ -0,0 +1,24 @@
+# RokMilk Chocolate Milkshake — 15s promo (correct VidScript v2 patterns)
+# Requires: scenerok secrets set XAI_API_KEY=... (or configured on scenerok.com account)
+
+import xai from "@scenerok/xai"
+
+# Generated visuals — one clip per segment; prompts must use straight double quotes only
+[-] = video xai.imagine("Cinematic slow-motion pour of rich creamy chocolate milk into a sleek modern 250ml carton on marble, warm studio lighting, shallow depth of field, 9:16 vertical", aspect_ratio: "9:16", duration: 5)
+
+[-] = video xai.imagine("Elegant rotating product shot of premium chocolate milk carton labeled RokMilk, brown and gold palette, soft bokeh, advertising visual, 9:16 vertical", aspect_ratio: "9:16", duration: 5)
+
+[-] = video xai.imagine("Silky chocolate milk swirl in glass with RokMilk carton blurred in background, golden light, appetizing food cinematography, 9:16 vertical", aspect_ratio: "9:16", duration: 5)
+
+[0s .. 2.5s] = text "RokMilk", font: "Bebas Neue", size: 80, color: "#FFD700", x: "50%", y: "18%", align: center, stroke: "#3E1C00", stroke_width: 4, letter_spacing: 6, animate: fadeIn(0.6s)
+
+[2s .. 5s] = text "Chocolate Milkshake", font: "Outfit", size: 56, color: "#FFFFFF", x: "50%", y: "45%", align: center, stroke: "#3E1C00", stroke_width: 3, animate: riseIn(0.8s)
+
+[5s .. 8s] = text "250ml of Pure Indulgence", font: "Inter", size: 42, color: "#F3E5AB", x: "50%", y: "55%", align: center, stroke: "#3E1C00", stroke_width: 2, animate: slideY(40, 0, 0.8s)
+
+[11s .. 14s] = text "visit your nearest grocery store", font: "Bebas Neue", size: 48, color: "#FFD700", x: "50%", y: "82%", align: center, stroke: "#3E1C00", stroke_width: 4, letter_spacing: 3, animate: fadeIn(1s)
+
+[0s .. 15s] = filter "vignette", intensity: 0.3
+[0s .. 15s] = filter "saturation", value: 1.12
+
+output to "rokmilk-chocolate-promo.mp4", resolution: "1080x1920", fps: 30, background: "#1A0F05"

package/examples/system/testimonial-cut.vid

@@ -0,0 +1,16 @@
+# Testimonial Cut
+# A quote-focused format with a subtle vintage feel.
+# Great for customer stories, reviews, and social proof clips.
+
+input speaker = "{{speaker_clip}}"
+
+[0s .. 5s] = speaker
+speaker.Trim(start: 0s, end: 5s)
+
+[0.5s .. 3s] = text "{{quote}}", style: subtitle, position: center, color: "#FFFFFF", size: 42, stroke: "#000000", stroke_width: 2
+
+[3.2s .. 4.8s] = text "{{attribution}}", style: caption, position: bottom, color: "#D1D5DB", size: 32, stroke: "#000000", stroke_width: 2
+
+[0s .. 5s] = filter "sepia", intensity: 0.3
+
+output to "testimonial.mp4", resolution: "1080x1920", fps: 30

package/examples/system/ugc-testimonial-voiceover.vid

@@ -0,0 +1,33 @@
+# UGC Testimonial with Voiceover - Reusable Template
+# Uses xAI (via explicit import) for TTS voiceover + generated visuals
+
+import xai from "@scenerok/xai"
+
+# === INPUTS ===
+input quote = "{{quote | This product completely changed how I work}}"
+input customer_name = "{{customer_name | Sarah K.}}"
+input product_name = "{{product_name | SceneRok}}"
+
+# === VOICEOVER + VISUAL ===
+[-] = audio xai.tts(
+    quote + ". " + customer_name + " from " + product_name,
+    voice: "eve",
+    speed: 1.05
+)
+
+[-] = video xai.imagine(
+    "Cinematic lifestyle shot representing: " + quote + ", premium modern aesthetic, 9:16 vertical",
+    aspect_ratio: "9:16",
+    resolution: "1k"
+)
+
+# === QUOTE TEXT (appears while voiceover plays) ===
+[-] = text "\"" + quote + "\"", style: quote, position: center, color: "#FFFFFF", size: 52, align: center
+
+# === ATTRIBUTION ===
+[- 2s] = text "— " + customer_name, style: attribution, position: "center, 75%", color: "#CCCCCC", size: 32
+
+# === BRANDING ===
+[-] = text "Made with SceneRok", style: watermark, position: "85%, 92%", color: "#888888", size: 24, opacity: 0.6
+
+output to "ugc-testimonial.mp4", resolution: "1080x1920", fps: 30

package/examples/system/voice-visual-promo.vid

@@ -0,0 +1,21 @@
+# Voice + Visual Promo
+# Combines main footage with voiceover or music and layered titles.
+
+input main = "{{main_video}}"
+input voice = "{{voiceover_audio}}"
+
+[0s .. 12s] = main
+main.Trim(start: 0s, end: 12s)
+
+[0s .. 12s] = audio voice, volume: 0.9
+
+[0.5s .. 3s] = text "{{title}}", font: "Inter", size: 68, color: "{{brand_color}}", x: "50%", y: "22%", align: center, stroke: "#111827", stroke_width: 3
+
+[3s .. 7s] = text "{{subtitle}}", font: "Inter", size: 34, color: "#F3F4F6", x: "50%", y: "50%", align: center, stroke: "#0F172A", stroke_width: 2
+
+[7s .. 11s] = text "{{cta}}", font: "Inter", size: 56, color: "#FFFFFF", x: "50%", y: "78%", align: center, stroke: "#000000", stroke_width: 3
+
+[0s .. 12s] = filter "vignette", intensity: 0.22
+[0s .. 12s] = filter "saturation", value: 1.12
+
+output to "voice-visual-promo.mp4", resolution: "1080x1920", fps: 30

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scenerok/cli",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "SceneRok CLI - Create videos from your terminal and agent workflows",
   "type": "module",
   "bin": {
@@ -10,6 +10,7 @@
   "files": [
     "dist",
     "skills",
+    "examples",
     "README.md"
   ],
   "scripts": {

package/skills/aider/SKILL.md

@@ -86,18 +86,20 @@ import music from "@elevenlabs/music" # generative music
 use intro at [-] with { clip: main, headline: "Welcome" }
 ```
 
-### Plugin Calls
+### Plugin Calls (required import)
 
 ```vidscript
-import eleven from "/tts"
+import xai from "@scenerok/xai"
 
-[-] = audio eleven.tts("Welcome to SceneRok", voice: "Rachel")
-[-] = video xai.imagine("Cinematic product shot", aspect_ratio: "9:16")
-[-] = audio music("upbeat launch soundtrack", duration: 12, instrumental: true)
-[-] = audio xai.tts("Next line", voice: "eve")
+[-] = video xai.imagine("Cinematic product shot", aspect_ratio: "9:16", duration: 5)
+[-] = audio xai.tts("Welcome to SceneRok", voice: "eve")
 ```
 
-Package-style plugin calls are supported inside time blocks. Use `video ...` for generated visual clips and `audio ...` for generated speech, music, and other generated audio.
+**Always** add `import xai from "@scenerok/xai"` before any `xai.imagine` / `xai.tts` call or `animate: fadeIn(...)` helper. Calls without import fail validation with `Unknown function 'xai.imagine'`.
+
+Put plugin calls **directly** in time blocks — never `let clip = xai.imagine(...)`.
+
+Read `vidscript-strict.md` for anti-patterns and `examples/system/*.vid` for copy-paste templates (installed with `scenerok skills install`).
 
 ### Placeholders
 
@@ -165,7 +167,15 @@ Always ask clarifying questions about:
 - Desired duration and style
 - Whether they want to start from a template or from scratch
 
+## Reference files (in this skill folder)
+
+| File | Purpose |
+|------|---------|
+| `vidscript-guide.md` | Full grammar reference |
+| `vidscript-strict.md` | **Read first** — rules that prevent common agent mistakes |
+| `vidscript-sample.md` | Minimal promo with xAI import |
+| `examples/system/*.vid` | Official SceneRok templates (text-only, product launch, xAI reels) |
+
 ## Full Reference
 
-For exhaustive grammar documentation, visit:
 https://scenerok.com/docs/vidscript