neoagent 2.3.1-beta.66 → 2.3.1-beta.68

package/.env.example

@@ -4,7 +4,8 @@
 
 PORT=3333
 NODE_ENV=production
-SESSION_SECRET=change-this-to-a-random-secret-in-production
+# Auto-generated on first start or setup if left blank.
+SESSION_SECRET=
 
 # Optional: dedicated key for encrypting local at-rest secrets (for example API_KEYS.json).
 # If unset, encryption falls back to SESSION_SECRET.
@@ -23,7 +24,7 @@ NEOAGENT_DEPLOYMENT_MODE=self_hosted
 # Deployment profile:
 #   private -> single-user / trusted host runtime
 #   prod    -> multi-user / isolated per-user VM runtime
-NEOAGENT_PROFILE=private
+NEOAGENT_PROFILE=prod
 
 # VM runtime settings used by `prod`.
 # Set these before switching NEOAGENT_PROFILE=prod.
@@ -38,9 +39,8 @@ NEOAGENT_VM_BASE_IMAGE=
 
 # The guest image must boot a Linux guest that runs `npm run start:guest-agent`
 # and exposes the guest agent on port 8421.
-# Replace this placeholder before using NEOAGENT_PROFILE=prod.
-# Example: openssl rand -hex 32
-NEOAGENT_VM_GUEST_TOKEN=change-this-guest-token-before-prod
+# Auto-generated on first start or setup if left blank.
+NEOAGENT_VM_GUEST_TOKEN=
 NEOAGENT_VM_MEMORY_MB=4096
 NEOAGENT_VM_CPUS=2
 

package/lib/manager.js

@@ -18,6 +18,7 @@ const {
   LOG_DIR,
   ENV_FILE,
   PID_FILE,
+  getDefaultVmBaseImageUrl,
   ensureRuntimeDirs,
   migrateLegacyRuntime
 } = require('../runtime/paths');
@@ -425,6 +426,7 @@ async function cmdSetup() {
   ensureRuntimeDirs();
 
   const current = Object.fromEntries(parseEnv(readEnvFileRaw()).entries());
+  const defaultVmBaseImageUrl = getDefaultVmBaseImageUrl();
 
   logInfo('Press Enter to keep the current value shown in brackets.');
 
@@ -436,7 +438,7 @@ async function cmdSetup() {
   const secureCookies = await ask('Secure cookies (true/false)', secureCookiesDefault);
   const trustProxyDefault = current.TRUST_PROXY || secureCookiesDefault;
   const trustProxy = await ask('Trust reverse proxy headers (true/false)', trustProxyDefault);
-  const sessionSecret = await askSecret('Session secret', current.SESSION_SECRET || randomSecret());
+  const sessionSecret = current.SESSION_SECRET || randomSecret();
   const deploymentMode = await ask(
     'Deployment mode (self_hosted/managed)',
     current.NEOAGENT_DEPLOYMENT_MODE || 'self_hosted'
@@ -446,6 +448,11 @@ async function cmdSetup() {
     current.NEOAGENT_RELEASE_CHANNEL || 'stable'
   );
   const origins = await ask('Allowed CORS origins', current.ALLOWED_ORIGINS || '');
+  const deploymentProfile = current.NEOAGENT_PROFILE || 'prod';
+  const vmBaseImageUrl = current.NEOAGENT_VM_BASE_IMAGE_URL || defaultVmBaseImageUrl;
+  const vmMemoryMb = current.NEOAGENT_VM_MEMORY_MB || '4096';
+  const vmCpus = current.NEOAGENT_VM_CPUS || '2';
+  const vmGuestToken = current.NEOAGENT_VM_GUEST_TOKEN || randomSecret();
 
   heading('AI Providers');
   const anthropic = await askSecret('Anthropic API key', current.ANTHROPIC_API_KEY || '');
@@ -562,8 +569,13 @@ async function cmdSetup() {
     `SECURE_COOKIES=${normalizedSecureCookies}`,
     `TRUST_PROXY=${normalizedTrustProxy}`,
     `SESSION_SECRET=${sessionSecret}`,
+    `NEOAGENT_PROFILE=${deploymentProfile}`,
     `NEOAGENT_DEPLOYMENT_MODE=${normalizedDeploymentMode}`,
     `NEOAGENT_RELEASE_CHANNEL=${normalizedReleaseChannel}`,
+    `NEOAGENT_VM_BASE_IMAGE_URL=${vmBaseImageUrl}`,
+    `NEOAGENT_VM_MEMORY_MB=${vmMemoryMb}`,
+    `NEOAGENT_VM_CPUS=${vmCpus}`,
+    `NEOAGENT_VM_GUEST_TOKEN=${vmGuestToken}`,
     anthropic ? `ANTHROPIC_API_KEY=${anthropic}` : '',
     anthropicBaseUrl ? `ANTHROPIC_BASE_URL=${anthropicBaseUrl}` : '',
     openai ? `OPENAI_API_KEY=${openai}` : '',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neoagent",
-  "version": "2.3.1-beta.66",
+  "version": "2.3.1-beta.68",
   "description": "Proactive personal AI agent with no limits",
   "license": "MIT",
   "main": "server/index.js",
@@ -54,6 +54,9 @@
     "@anthropic-ai/sdk": "^0.39.0",
     "@google/generative-ai": "^0.24.0",
     "@modelcontextprotocol/sdk": "^1.12.1",
+    "@remotion/cli": "^4.0.459",
+    "@slidev/cli": "^52.15.2",
+    "@slidev/theme-default": "^0.25.0",
     "baileys": "^6.7.21",
     "bcrypt": "^6.0.0",
     "better-sqlite3": "^11.8.1",
@@ -73,11 +76,13 @@
     "nodemailer": "^8.0.5",
     "openai": "^4.85.4",
     "otplib": "^13.4.0",
+    "playwright-chromium": "^1.59.1",
     "proper-lockfile": "^4.1.2",
     "puppeteer-core": "^24.40.0",
     "puppeteer-extra": "^3.3.6",
     "puppeteer-extra-plugin-stealth": "^2.11.2",
     "qrcode": "^1.5.4",
+    "remotion": "^4.0.459",
     "sharp": "^0.34.5",
     "socket.io": "^4.8.1",
     "telegraf": "^4.16.3",

package/runtime/paths.js

@@ -1,6 +1,8 @@
 const fs = require('fs');
+const crypto = require('crypto');
 const os = require('os');
 const path = require('path');
+const { parseEnv } = require('./env');
 
 const APP_DIR = path.resolve(__dirname, '..');
 const HOME_DIR = os.homedir();
@@ -15,6 +17,10 @@ const PID_FILE = path.join(DATA_DIR, 'neoagent.pid');
 const LEGACY_ENV_FILE = path.join(APP_DIR, '.env');
 const LEGACY_DATA_DIR = path.join(APP_DIR, 'data');
 const LEGACY_AGENT_DATA_DIR = path.join(APP_DIR, 'agent-data');
+const DEFAULT_VM_BASE_IMAGE_URLS = Object.freeze({
+  arm64: 'https://cloud-images.ubuntu.com/releases/24.04/release/ubuntu-24.04-server-cloudimg-arm64.img',
+  x64: 'https://cloud-images.ubuntu.com/releases/24.04/release/ubuntu-24.04-server-cloudimg-amd64.img',
+});
 
 function ensureRuntimeDirs() {
   for (const dir of [RUNTIME_HOME, DATA_DIR, LOG_DIR, AGENT_DATA_DIR]) {
@@ -95,6 +101,133 @@ function migrateLegacyRuntime(logger = () => {}) {
   return changed;
 }
 
+function readEnvFileRaw(envFile = ENV_FILE) {
+  try {
+    return fs.readFileSync(envFile, 'utf8');
+  } catch {
+    return '';
+  }
+}
+
+function upsertEnvValue(envFile, key, value) {
+  const raw = readEnvFileRaw(envFile);
+  const lines = raw ? raw.split('\n') : [];
+  let replaced = false;
+
+  for (let i = 0; i < lines.length; i++) {
+    if (lines[i].startsWith(`${key}=`)) {
+      lines[i] = `${key}=${value}`;
+      replaced = true;
+      break;
+    }
+  }
+
+  if (!replaced) {
+    lines.push(`${key}=${value}`);
+  }
+
+  const output = lines.filter((line, idx, arr) => idx !== arr.length - 1 || line !== '').join('\n') + '\n';
+  fs.mkdirSync(path.dirname(envFile), { recursive: true });
+  fs.writeFileSync(envFile, output, { mode: 0o600 });
+}
+
+function generateSecret(bytes = 32) {
+  return crypto.randomBytes(bytes).toString('hex');
+}
+
+function getDefaultVmBaseImageUrl(arch = process.arch) {
+  return arch === 'arm64' ? DEFAULT_VM_BASE_IMAGE_URLS.arm64 : DEFAULT_VM_BASE_IMAGE_URLS.x64;
+}
+
+function isPlaceholderValue(value, placeholders) {
+  const secret = String(value || '').trim();
+  return !secret || placeholders.has(secret);
+}
+
+function isValidVmGuestToken(value) {
+  const secret = String(value || '').trim();
+  if (!secret || secret.length < 32) return false;
+  if (/^(change|replace|set|your|example|sample|placeholder|token|secret)[-_a-z0-9]*$/i.test(secret)) return false;
+  if (/change-this-guest-token-before-prod/i.test(secret)) return false;
+  if (/^(.)\1+$/.test(secret)) return false;
+  return true;
+}
+
+function ensureSecureRuntimeEnv({ envFile = ENV_FILE, env = process.env, logger = console } = {}) {
+  const raw = readEnvFileRaw(envFile);
+  const parsed = parseEnv(raw);
+  const changes = [];
+  const defaultProfile = 'prod';
+  const sessionPlaceholders = new Set([
+    'neoagent-dev-secret-change-me',
+    'change-this-to-a-random-secret-in-production',
+    'change-me-to-something-random',
+  ]);
+
+  let deploymentProfile = String(env.NEOAGENT_PROFILE || parsed.get('NEOAGENT_PROFILE') || '').trim();
+  if (!deploymentProfile) {
+    deploymentProfile = defaultProfile;
+    env.NEOAGENT_PROFILE = deploymentProfile;
+    upsertEnvValue(envFile, 'NEOAGENT_PROFILE', deploymentProfile);
+    changes.push('NEOAGENT_PROFILE');
+  }
+
+  let vmBaseImageUrl = String(env.NEOAGENT_VM_BASE_IMAGE_URL || parsed.get('NEOAGENT_VM_BASE_IMAGE_URL') || '').trim();
+  if (!vmBaseImageUrl) {
+    vmBaseImageUrl = getDefaultVmBaseImageUrl();
+    env.NEOAGENT_VM_BASE_IMAGE_URL = vmBaseImageUrl;
+    upsertEnvValue(envFile, 'NEOAGENT_VM_BASE_IMAGE_URL', vmBaseImageUrl);
+    changes.push('NEOAGENT_VM_BASE_IMAGE_URL');
+  }
+
+  let vmMemoryMb = String(env.NEOAGENT_VM_MEMORY_MB || parsed.get('NEOAGENT_VM_MEMORY_MB') || '').trim();
+  if (!vmMemoryMb) {
+    vmMemoryMb = '4096';
+    env.NEOAGENT_VM_MEMORY_MB = vmMemoryMb;
+    upsertEnvValue(envFile, 'NEOAGENT_VM_MEMORY_MB', vmMemoryMb);
+    changes.push('NEOAGENT_VM_MEMORY_MB');
+  }
+
+  let vmCpus = String(env.NEOAGENT_VM_CPUS || parsed.get('NEOAGENT_VM_CPUS') || '').trim();
+  if (!vmCpus) {
+    vmCpus = '2';
+    env.NEOAGENT_VM_CPUS = vmCpus;
+    upsertEnvValue(envFile, 'NEOAGENT_VM_CPUS', vmCpus);
+    changes.push('NEOAGENT_VM_CPUS');
+  }
+
+  let sessionSecret = String(env.SESSION_SECRET || parsed.get('SESSION_SECRET') || '').trim();
+  if (isPlaceholderValue(sessionSecret, sessionPlaceholders)) {
+    sessionSecret = generateSecret(32);
+    env.SESSION_SECRET = sessionSecret;
+    upsertEnvValue(envFile, 'SESSION_SECRET', sessionSecret);
+    changes.push('SESSION_SECRET');
+  }
+
+  let guestToken = String(env.NEOAGENT_VM_GUEST_TOKEN || parsed.get('NEOAGENT_VM_GUEST_TOKEN') || '').trim();
+  if (!isValidVmGuestToken(guestToken)) {
+    guestToken = generateSecret(32);
+    env.NEOAGENT_VM_GUEST_TOKEN = guestToken;
+    upsertEnvValue(envFile, 'NEOAGENT_VM_GUEST_TOKEN', guestToken);
+    changes.push('NEOAGENT_VM_GUEST_TOKEN');
+  }
+
+  if (changes.length > 0 && logger) {
+    const message = `Initialized runtime defaults: ${changes.join(', ')}`;
+    if (typeof logger.info === 'function') {
+      logger.info(message);
+    } else if (typeof logger.log === 'function') {
+      logger.log(message);
+    }
+  }
+
+  return {
+    changes,
+    sessionSecret: env.SESSION_SECRET || null,
+    guestToken: env.NEOAGENT_VM_GUEST_TOKEN || null,
+  };
+}
+
 module.exports = {
   APP_DIR,
   HOME_DIR,
@@ -108,6 +241,9 @@ module.exports = {
   LEGACY_ENV_FILE,
   LEGACY_DATA_DIR,
   LEGACY_AGENT_DATA_DIR,
+  DEFAULT_VM_BASE_IMAGE_URLS,
   ensureRuntimeDirs,
+  ensureSecureRuntimeEnv,
+  getDefaultVmBaseImageUrl,
   migrateLegacyRuntime
 };

package/runtime/paths.test.js

@@ -0,0 +1,29 @@
+const test = require('node:test');
+const assert = require('node:assert/strict');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+const {
+  ensureSecureRuntimeEnv,
+} = require('./paths');
+
+test('ensureSecureRuntimeEnv generates runtime secrets when missing', () => {
+  const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'neoagent-runtime-'));
+  const envFile = path.join(tempDir, '.env');
+  const env = {};
+
+  const result = ensureSecureRuntimeEnv({
+    envFile,
+    env,
+    logger: null,
+  });
+
+  const content = fs.readFileSync(envFile, 'utf8');
+  assert.match(content, /^SESSION_SECRET=/m);
+  assert.match(content, /^NEOAGENT_VM_GUEST_TOKEN=/m);
+  assert.equal(result.changes.includes('SESSION_SECRET'), true);
+  assert.equal(result.changes.includes('NEOAGENT_VM_GUEST_TOKEN'), true);
+  assert.ok(String(env.SESSION_SECRET || '').length >= 64);
+  assert.ok(String(env.NEOAGENT_VM_GUEST_TOKEN || '').length >= 64);
+});

package/server/index.js

@@ -3,6 +3,7 @@
 const {
   ENV_FILE,
   LEGACY_ENV_FILE,
+  ensureSecureRuntimeEnv,
   migrateLegacyRuntime,
   ensureRuntimeDirs
 } = require('../runtime/paths');
@@ -11,6 +12,7 @@ const dotenv = require('dotenv');
 
 migrateLegacyRuntime();
 ensureRuntimeDirs();
+ensureSecureRuntimeEnv({ logger: console });
 dotenv.config({ path: LEGACY_ENV_FILE });
 dotenv.config({ path: ENV_FILE, override: true });
 
@@ -19,10 +21,6 @@ const { createServer } = require('http');
 
 const db = require('./db/database');
 const { setupConsoleInterceptor } = require('./utils/logger');
-const {
-  configuredSessionSecret,
-  isInsecureSessionSecret,
-} = require('./services/account/session_secret');
 const { validateOrigin } = require('./config/origins');
 const {
   applyHttpMiddleware,
@@ -87,16 +85,6 @@ function logStartupConfig() {
 
 logStartupConfig();
 
-if (!configuredSessionSecret()) {
-  console.warn(
-    'WARNING: SESSION_SECRET not set — using a process-local random fallback. Set it in .env before exposing this server.'
-  );
-} else if (isInsecureSessionSecret()) {
-  console.warn(
-    'WARNING: SESSION_SECRET uses a known placeholder value. Replace it with a random secret before exposing this server.'
-  );
-}
-
 const app = express();
 app.disable('x-powered-by');
 const httpServer = createServer(app);

package/server/public/.last_build_id

@@ -1 +1 @@
-03e50077364c472b1caef378bca9ddc5
+2cdc5aa958700a8fae243c563d18825d

package/server/public/flutter_bootstrap.js

@@ -37,6 +37,6 @@ _flutter.buildConfig = {"engineRevision":"42d3d75a56efe1a2e9902f52dc8006099c45d9
 
 _flutter.loader.load({
   serviceWorkerSettings: {
-    serviceWorkerVersion: "167614730" /* Flutter's service worker is deprecated and will be removed in a future Flutter release. */
+    serviceWorkerVersion: "1009655341" /* Flutter's service worker is deprecated and will be removed in a future Flutter release. */
   }
 });

package/server/public/main.dart.js

@@ -127230,7 +127230,7 @@ r===$&&A.b()
 o.push(A.id(p,A.iS(!1,new A.a3(B.tE,A.dZ(new A.cU(B.h8,new A.a5p(r,p),p),p,p),p),!1,B.I,!0),p,p,0,0,0,p))}r=!1
 if(!s.ay)if(!s.ch){r=s.e
 r===$&&A.b()
-r=B.b.A("mp05guq4-d8088a9").length!==0&&r.b}if(r){r=s.d
+r=B.b.A("mp0wqm0n-9104fe4").length!==0&&r.b}if(r){r=s.d
 r===$&&A.b()
 r=r.V&&!r.a0?84:0
 q=s.e
@@ -131894,7 +131894,7 @@ $S:324}
 A.Y0.prototype={}
 A.R0.prototype={
 mJ(a){var s=this
-if(B.b.A("mp05guq4-d8088a9").length===0||s.a!=null)return
+if(B.b.A("mp0wqm0n-9104fe4").length===0||s.a!=null)return
 s.zY()
 s.a=A.pN(B.Pr,new A.b3g(s))},
 zY(){var s=0,r=A.l(t.H),q,p=2,o=[],n=this,m,l,k,j,i,h,g,f
@@ -131912,7 +131912,7 @@ if(!t.f.b(k)){s=1
 break}i=J.Z(k,"buildId")
 h=i==null?null:B.b.A(J.r(i))
 j=h==null?"":h
-if(J.bi(j)===0||J.c(j,"mp05guq4-d8088a9")){s=1
+if(J.bi(j)===0||J.c(j,"mp0wqm0n-9104fe4")){s=1
 break}n.b=!0
 n.J()
 p=2
@@ -131929,7 +131929,7 @@ case 2:return A.i(o.at(-1),r)}})
 return A.k($async$zY,r)},
 v_(){var s=0,r=A.l(t.H),q,p=2,o=[],n=this,m,l,k,j,i,h,g,f,e,d,c,b,a,a0,a1
 var $async$v_=A.h(function(a2,a3){if(a2===1){o.push(a3)
-s=p}for(;;)switch(s){case 0:if(B.b.A("mp05guq4-d8088a9").length===0||n.c){s=1
+s=p}for(;;)switch(s){case 0:if(B.b.A("mp0wqm0n-9104fe4").length===0||n.c){s=1
 break}n.c=!0
 n.J()
 p=4

package/server/services/ai/deliverables/workflows.js

@@ -43,6 +43,7 @@ function createWorkflow(config) {
         supportingCapabilities: request.supportingCapabilities,
         preferredTools: [...this.preferredTools],
         expectedOutputs: [...this.expectedOutputs],
+        summaryHints: [...this.summaryHints],
         validationRules: [
           `Produce deliverable artifacts of type "${config.type}" before finishing.`,
           'Mention output files or artifact links explicitly in the final response when available.',
@@ -110,10 +111,15 @@ const WORKFLOWS = [
   createWorkflow({
     type: 'slides',
     displayName: 'Slides',
-    preferredTools: ['write_file', 'edit_file', 'execute_command', 'browser_screenshot', 'generate_image'],
+    preferredTools: ['generate_slide_deck', 'write_file', 'edit_file', 'execute_command', 'browser_screenshot', 'generate_image'],
     expectedOutputs: ['presentation deck', 'exported slide file', 'visual proof'],
     expectedArtifactKinds: ['slides', 'document', 'image'],
     expectedExtensions: ['.ppt', '.pptx', '.pdf', '.html', '.png', '.jpg', '.jpeg'],
+    summaryHints: [
+      'Prefer generate_slide_deck for final deck creation and export.',
+      'Use 5-12 slides with clear titles and concise body copy.',
+      'Request pdf or pdf+pptx exports when the user wants a finished shareable deck.',
+    ],
   }),
   createWorkflow({
     type: 'document',
@@ -161,10 +167,15 @@ const WORKFLOWS = [
   createWorkflow({
     type: 'video',
     displayName: 'Video',
-    preferredTools: ['execute_command', 'write_file', 'edit_file'],
+    preferredTools: ['generate_video_with_remotion', 'execute_command', 'write_file', 'edit_file'],
     expectedOutputs: ['rendered video asset'],
     expectedArtifactKinds: ['video'],
     expectedExtensions: ['.mp4', '.mov', '.m4v', '.webm'],
+    summaryHints: [
+      'Prefer generate_video_with_remotion for the final rendered asset.',
+      'Use 3-10 scenes with explicit duration_seconds and concise on-screen text.',
+      'Attach local assets by absolute image_path or audio_path when available.',
+    ],
   }),
 ];
 
@@ -184,6 +195,7 @@ function buildDeliverableWorkflowGuidance(plan) {
     plan.requestedOutputs?.length ? `Requested outputs: ${plan.requestedOutputs.join(', ')}` : '',
     plan.preferredTools?.length ? `Preferred tools/capabilities: ${plan.preferredTools.join(', ')}` : '',
     plan.expectedOutputs?.length ? `Expected artifacts: ${plan.expectedOutputs.join(', ')}` : '',
+    plan.summaryHints?.length ? `Execution guidance: ${plan.summaryHints.join(' ')}` : '',
     'Before finishing, ensure the final deliverable exists, validate it, and summarize the produced artifacts clearly.',
   ].filter(Boolean).join('\n');
 }

package/server/services/ai/integrated_tools/index.js

@@ -0,0 +1,98 @@
+'use strict';
+
+const { generateSlideDeck } = require('./slidev');
+const { generateVideoWithRemotion } = require('./remotion');
+
+function getIntegratedToolDefinitions() {
+  return [
+    {
+      name: 'generate_slide_deck',
+      description: 'Generate a polished presentation using Slidev and export finished artifacts. Prefer this for decks instead of raw file-writing. Best practice: pass a clear title and a complete slides array, and request export_formats ["pdf"] or ["pdf","pptx"] for a shareable final result.',
+      parameters: {
+        type: 'object',
+        properties: {
+          title: { type: 'string', description: 'Deck title.' },
+          subtitle: { type: 'string', description: 'Optional deck subtitle or framing line.' },
+          theme: { type: 'string', description: 'Slidev theme name. Defaults to "default".' },
+          deck_markdown: { type: 'string', description: 'Optional full Slidev markdown deck. Use this when you want exact Slidev syntax control.' },
+          slides: {
+            type: 'array',
+            description: 'Structured slide definitions. Use this for most decks if you do not need custom Slidev markdown.',
+            items: {
+              type: 'object',
+              properties: {
+                title: { type: 'string', description: 'Slide title.' },
+                body: { type: 'string', description: 'Short narrative paragraph or statement.' },
+                bullets: { type: 'array', items: { type: 'string' }, description: 'Bullet list for the slide.' },
+                notes: { type: 'string', description: 'Presenter notes.' },
+                image_url: { type: 'string', description: 'Optional remote image URL to embed.' },
+                image_path: { type: 'string', description: 'Optional absolute local image path to embed.' },
+                layout: { type: 'string', description: 'Optional Slidev layout, for example cover, section, statement, quote, or two-cols.' },
+                className: { type: 'string', description: 'Optional Slidev class value.' },
+              },
+            },
+          },
+          export_formats: {
+            type: 'array',
+            items: { type: 'string', enum: ['pdf', 'pptx', 'png'] },
+            description: 'Finished output formats. Defaults to ["pdf"].',
+          },
+          filename_base: { type: 'string', description: 'Optional output filename base.' },
+        },
+        required: ['title'],
+      },
+    },
+    {
+      name: 'generate_video_with_remotion',
+      description: 'Generate a finished MP4 video using Remotion. Prefer this for explainers, launch videos, reels, and narrated visual summaries. Best practice: pass 3-10 scenes with explicit duration_seconds, concise on-screen text, and optional image_path or image_url assets.',
+      parameters: {
+        type: 'object',
+        properties: {
+          title: { type: 'string', description: 'Video title or opening headline.' },
+          subtitle: { type: 'string', description: 'Optional supporting line.' },
+          style: { type: 'string', description: 'High-level visual style direction.' },
+          aspect_ratio: { type: 'string', enum: ['16:9', '9:16', '1:1', '4:5'], description: 'Video canvas aspect ratio. Defaults to 16:9.' },
+          fps: { type: 'number', description: 'Frames per second. Defaults to 30.' },
+          audio_path: { type: 'string', description: 'Optional absolute local path to a soundtrack or voiceover file.' },
+          scenes: {
+            type: 'array',
+            description: 'Scene list in playback order.',
+            items: {
+              type: 'object',
+              properties: {
+                title: { type: 'string', description: 'Scene headline.' },
+                body: { type: 'string', description: 'Supporting sentence or paragraph.' },
+                bullets: { type: 'array', items: { type: 'string' }, description: 'Optional bullets to show in the scene.' },
+                duration_seconds: { type: 'number', description: 'Scene duration in seconds.' },
+                image_url: { type: 'string', description: 'Optional remote image URL.' },
+                image_path: { type: 'string', description: 'Optional absolute local image path.' },
+                accent_color: { type: 'string', description: 'Optional accent color, for example #7dd3fc.' },
+                background_color: { type: 'string', description: 'Optional scene background color.' },
+                align: { type: 'string', enum: ['left', 'center', 'right'], description: 'Text alignment.' },
+              },
+              required: ['title'],
+            },
+          },
+          filename_base: { type: 'string', description: 'Optional output filename base.' },
+        },
+        required: ['title', 'scenes'],
+      },
+    },
+  ];
+}
+
+async function executeIntegratedTool(toolName, args, context = {}) {
+  switch (String(toolName || '').trim()) {
+    case 'generate_slide_deck':
+      return generateSlideDeck(args, context);
+    case 'generate_video_with_remotion':
+      return generateVideoWithRemotion(args, context);
+    default:
+      return null;
+  }
+}
+
+module.exports = {
+  executeIntegratedTool,
+  getIntegratedToolDefinitions,
+};