sogni-gen 1.3.1 → 1.3.3

package/README.md

@@ -41,6 +41,33 @@ Restart Claude Desktop after saving. The same natural-language commands work.
 
 > **Note:** Both Claude Code and Claude Desktop require Sogni credentials — see [Setup](#setup) below.
 
+### Global npm Install (CLI + MCP)
+
+```bash
+npm install -g sogni-gen
+sogni-gen --version
+```
+
+If `sogni-gen-mcp` is on your `PATH`, you can register it directly:
+
+```bash
+# Claude Code using globally installed binary
+claude mcp add sogni -- sogni-gen-mcp
+```
+
+Claude Desktop config using global binary:
+
+```json
+{
+  "mcpServers": {
+    "sogni": {
+      "command": "sogni-gen-mcp",
+      "args": []
+    }
+  }
+}
+```
+
 ### Quick Install (OpenClaw) - Recommended
 
 Point your OpenClaw to the [`llm.txt`](https://raw.githubusercontent.com/Sogni-AI/openclaw-sogni-gen/main/llm.txt) and everything is set up — just paste the URL into Telegram, WhatsApp, or iMessages and the bot handles image and video generation automatically.
@@ -269,6 +296,7 @@ Multi-angle mode auto-builds the `<sks>` prompt and applies the `multiple_angles
 --lora-strengths <n>  Comma-separated LoRA strengths
 --token-type <type>   spark|sogni
 --balance, --balances Show SPARK/SOGNI balances and exit
+--version, -V         Show sogni-gen version and exit
 --video, -v           Generate video instead of image
 --workflow <type>     t2v|i2v|s2v|animate-move|animate-replace
 --fps <num>           Frames per second (video)

package/desktop-extension/server/mcp-server.mjs

@@ -18,7 +18,7 @@ import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprot
 import { spawn } from 'child_process';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
-import { existsSync } from 'fs';
+import { existsSync, readFileSync } from 'fs';
 import { homedir } from 'os';
 
 // ---------------------------------------------------------------------------
@@ -29,6 +29,14 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const SOGNI_GEN = join(__dirname, 'sogni-gen.mjs');
 const CREDENTIALS_PATH = join(homedir(), '.config', 'sogni', 'credentials');
+const SERVER_VERSION = (() => {
+  try {
+    const pkg = JSON.parse(readFileSync(join(__dirname, 'package.json'), 'utf8'));
+    return pkg.version || 'unknown';
+  } catch {
+    return 'unknown';
+  }
+})();
 
 // ---------------------------------------------------------------------------
 // CLI spawning helper
@@ -110,7 +118,7 @@ function checkCredentials() {
 // Result formatting
 // ---------------------------------------------------------------------------
 
-function formatSuccess(result) {
+async function formatSuccess(result) {
   const parts = [];
 
   if (result.type === 'balance') {
@@ -144,13 +152,55 @@ function formatSuccess(result) {
 
   const content = [{ type: 'text', text: parts.join('\n') }];
 
-  // Also include image URLs as image content so Claude can see them
+  // Download images/videos and save locally + embed as base64 for Claude Desktop
+  const savedPaths = [];
   for (const url of urls) {
-    if (/\.(png|jpg|jpeg|webp|gif)(\?|$)/i.test(url)) {
-      content.push({ type: 'image', data: url, mimeType: 'image/png' });
+    const isImage = /\.(png|jpg|jpeg|webp|gif)(\?|$)/i.test(url);
+    const isVideo = /\.(mp4|webm|mov)(\?|$)/i.test(url);
+
+    if (!isImage && !isVideo) continue;
+
+    try {
+      const resp = await fetch(url);
+      if (!resp.ok) continue;
+      const buf = Buffer.from(await resp.arrayBuffer());
+
+      // Determine extension and build a temp file path
+      const ext = isImage
+        ? (url.match(/\.(png|jpg|jpeg|webp|gif)/i)?.[1]?.toLowerCase() || 'png')
+        : (url.match(/\.(mp4|webm|mov)/i)?.[1]?.toLowerCase() || 'mp4');
+
+      // Save to ~/Downloads/sogni/ so the user can find it easily
+      const { mkdirSync, writeFileSync } = await import('fs');
+      const downloadsDir = join(homedir(), 'Downloads', 'sogni');
+      mkdirSync(downloadsDir, { recursive: true });
+      const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+      const filename = `sogni-${timestamp}-${savedPaths.length}.${ext}`;
+      const filePath = join(downloadsDir, filename);
+      writeFileSync(filePath, buf);
+      savedPaths.push(filePath);
+
+      // For images, embed as base64 (Claude Desktop can render these inline)
+      if (isImage) {
+        const mimeType = ext === 'jpg' || ext === 'jpeg' ? 'image/jpeg'
+          : ext === 'webp' ? 'image/webp'
+          : ext === 'gif' ? 'image/gif'
+          : 'image/png';
+        content.push({ type: 'image', data: buf.toString('base64'), mimeType });
+      }
+    } catch {
+      // If download fails, skip — the URL is still in the text above
     }
   }
 
+  // Append saved file paths to the text output
+  if (savedPaths.length > 0) {
+    const textBlock = content[0];
+    textBlock.text += '\n\n' + savedPaths.map((p, i) =>
+      savedPaths.length === 1 ? `📁 Saved: ${p}` : `📁 Saved #${i + 1}: ${p}`
+    ).join('\n');
+  }
+
   return { content };
 }
 
@@ -161,11 +211,20 @@ function formatError(result) {
   return { content: [{ type: 'text', text: parts.join('\n') }], isError: true };
 }
 
-function formatResult(result) {
+async function formatResult(result) {
   if (result.success === false) return formatError(result);
   return formatSuccess(result);
 }
 
+async function runAndFormat(args, { timeoutMs = 30_000, requireCredentials = true } = {}) {
+  if (requireCredentials) {
+    const credErr = checkCredentials();
+    if (credErr) return credErr;
+  }
+  const result = await runSogniGen(args, { timeoutMs });
+  return formatResult(result);
+}
+
 // ---------------------------------------------------------------------------
 // Tool definitions
 // ---------------------------------------------------------------------------
@@ -446,6 +505,14 @@ The face likeness is preserved while applying the style from the prompt.`,
       properties: {},
     },
   },
+  {
+    name: 'get_version',
+    description: 'Show the running sogni-gen version for this MCP server instance.',
+    inputSchema: {
+      type: 'object',
+      properties: {},
+    },
+  },
 ];
 
 // ---------------------------------------------------------------------------
@@ -453,9 +520,6 @@ The face likeness is preserved while applying the style from the prompt.`,
 // ---------------------------------------------------------------------------
 
 async function handleGenerateImage(params) {
-  const credErr = checkCredentials();
-  if (credErr) return credErr;
-
   const args = [params.prompt];
   if (params.model) args.push('-m', params.model);
   if (params.width) args.push('-w', String(params.width));
@@ -467,14 +531,10 @@ async function handleGenerateImage(params) {
   if (params.loras?.length) args.push('--loras', params.loras.join(','));
   if (params.lora_strengths?.length) args.push('--lora-strengths', params.lora_strengths.join(','));
 
-  const result = await runSogniGen(args, { timeoutMs: 60_000 });
-  return formatResult(result);
+  return runAndFormat(args, { timeoutMs: 60_000 });
 }
 
 async function handleGenerateVideo(params) {
-  const credErr = checkCredentials();
-  if (credErr) return credErr;
-
   const args = ['--video', params.prompt];
   if (params.workflow) args.push('--workflow', params.workflow);
   if (params.model) args.push('-m', params.model);
@@ -491,14 +551,10 @@ async function handleGenerateVideo(params) {
   if (params.output) args.push('-o', params.output);
   if (params.looping) args.push('--looping');
 
-  const result = await runSogniGen(args, { timeoutMs: 600_000 });
-  return formatResult(result);
+  return runAndFormat(args, { timeoutMs: 600_000 });
 }
 
 async function handleEditImage(params) {
-  const credErr = checkCredentials();
-  if (credErr) return credErr;
-
   const args = [];
   for (const img of params.context_images) {
     args.push('-c', img);
@@ -509,14 +565,10 @@ async function handleEditImage(params) {
   if (params.height) args.push('-h', String(params.height));
   if (params.output) args.push('-o', params.output);
 
-  const result = await runSogniGen(args, { timeoutMs: 60_000 });
-  return formatResult(result);
+  return runAndFormat(args, { timeoutMs: 60_000 });
 }
 
 async function handlePhotobooth(params) {
-  const credErr = checkCredentials();
-  if (credErr) return credErr;
-
   const args = ['--photobooth', '--ref', params.reference_face, params.prompt];
   if (params.model) args.push('-m', params.model);
   if (params.cn_strength != null) args.push('--cn-strength', String(params.cn_strength));
@@ -526,16 +578,22 @@ async function handlePhotobooth(params) {
   if (params.count) args.push('-n', String(params.count));
   if (params.output) args.push('-o', params.output);
 
-  const result = await runSogniGen(args, { timeoutMs: 60_000 });
-  return formatResult(result);
+  return runAndFormat(args, { timeoutMs: 60_000 });
 }
 
 async function handleCheckBalance() {
-  const credErr = checkCredentials();
-  if (credErr) return credErr;
+  return runAndFormat(['--balance'], { timeoutMs: 30_000 });
+}
 
-  const result = await runSogniGen(['--balance'], { timeoutMs: 30_000 });
-  return formatResult(result);
+async function handleGetVersion() {
+  const result = await runSogniGen(['--version'], { timeoutMs: 5_000 });
+  if (result.success === false) return formatError(result);
+  return {
+    content: [{
+      type: 'text',
+      text: `mcp-server version: ${SERVER_VERSION}\nsogni-gen version: ${result.version || 'unknown'}`,
+    }],
+  };
 }
 
 function handleListModels() {
@@ -560,7 +618,7 @@ Defaults:
 // ---------------------------------------------------------------------------
 
 const server = new Server(
-  { name: 'sogni', version: '1.3.0' },
+  { name: 'sogni', version: SERVER_VERSION },
   { capabilities: { tools: {} } },
 );
 
@@ -582,6 +640,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         return await handleCheckBalance();
       case 'list_models':
         return handleListModels();
+      case 'get_version':
+        return await handleGetVersion();
       default:
         return {
           content: [{ type: 'text', text: `Unknown tool: ${name}` }],

package/desktop-extension/server/sogni-gen.mjs

@@ -19,6 +19,14 @@ const IS_OPENCLAW_INVOCATION = Boolean(process.env.OPENCLAW_PLUGIN_CONFIG);
 const RAW_ARGS = process.argv.slice(2);
 const CLI_WANTS_JSON = RAW_ARGS.includes('--json');
 const JSON_ERROR_MODE = CLI_WANTS_JSON || IS_OPENCLAW_INVOCATION;
+const PACKAGE_VERSION = (() => {
+  try {
+    const pkg = JSON.parse(readFileSync(new URL('./package.json', import.meta.url), 'utf8'));
+    return pkg.version || 'unknown';
+  } catch {
+    return 'unknown';
+  }
+})();
 const VIDEO_WORKFLOW_DEFAULT_MODELS = {
   't2v': 'wan_v2.2-14b-fp8_t2v_lightx2v',
   'i2v': 'wan_v2.2-14b-fp8_i2v_lightx2v',
@@ -587,6 +595,7 @@ const options = {
   autoResizeVideoAssets: null,
   estimateVideoCost: false,
   showBalance: false,
+  showVersion: false,
   angles360Video: null,
   refImage: null, // Reference image for video (start frame)
   refImageEnd: null, // End frame for video interpolation
@@ -811,6 +820,8 @@ for (let i = 0; i < args.length; i++) {
     options.estimateVideoCost = true;
   } else if (arg === '--balance' || arg === '--balances') {
     options.showBalance = true;
+  } else if (arg === '--version' || arg === '-V') {
+    options.showVersion = true;
   } else if (arg === '--help') {
     console.log(`
 sogni-gen - Generate images and videos using Sogni AI
@@ -873,6 +884,7 @@ General:
   --guidance <num>      Override guidance (model-dependent)
   --token-type <type>   Token type: spark|sogni (default: spark)
   --balance, --balances Show SPARK/SOGNI balances and exit
+  --version, -V         Show sogni-gen version and exit
   --last                Show last render info (JSON)
   --json                Output JSON with all details
   --strict-size         Do not auto-adjust video size to satisfy i2v reference resizing constraints
@@ -1199,7 +1211,7 @@ if (options.video) {
   options.model = options.model || openclawConfig?.defaultImageModel || 'z_image_turbo_bf16';
 }
 
-if (!options.prompt && !options.estimateVideoCost && !options.multiAngle && !options.showBalance) {
+if (!options.prompt && !options.estimateVideoCost && !options.multiAngle && !options.showBalance && !options.showVersion) {
   fatalCliError('No prompt provided. Use --help for usage.', { code: 'INVALID_ARGUMENT' });
 }
 
@@ -1452,7 +1464,7 @@ if (options.lastSeed) {
   }
 }
 
-if (!options.estimateVideoCost && (options.seed === null || options.seed === undefined)) {
+if (!options.estimateVideoCost && !options.showVersion && (options.seed === null || options.seed === undefined)) {
   const strategy = options.seedStrategy || openclawConfig?.seedStrategy || 'prompt-hash';
   const normalized = normalizeSeedStrategy(strategy) || 'prompt-hash';
   options.seedStrategy = normalized;
@@ -2163,6 +2175,21 @@ async function main() {
   let client = null;
   
   try {
+    if (options.showVersion) {
+      if (options.json) {
+        console.log(JSON.stringify({
+          success: true,
+          type: 'version',
+          name: 'sogni-gen',
+          version: PACKAGE_VERSION,
+          timestamp: new Date().toISOString()
+        }));
+      } else {
+        console.log(PACKAGE_VERSION);
+      }
+      return;
+    }
+
     const creds = loadCredentials();
     log('Connecting to Sogni...');
     client = new SogniClientWrapper({

package/mcp-server.mjs

@@ -18,7 +18,7 @@ import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprot
 import { spawn } from 'child_process';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
-import { existsSync } from 'fs';
+import { existsSync, readFileSync } from 'fs';
 import { homedir } from 'os';
 
 // ---------------------------------------------------------------------------
@@ -29,6 +29,14 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const SOGNI_GEN = join(__dirname, 'sogni-gen.mjs');
 const CREDENTIALS_PATH = join(homedir(), '.config', 'sogni', 'credentials');
+const SERVER_VERSION = (() => {
+  try {
+    const pkg = JSON.parse(readFileSync(join(__dirname, 'package.json'), 'utf8'));
+    return pkg.version || 'unknown';
+  } catch {
+    return 'unknown';
+  }
+})();
 
 // ---------------------------------------------------------------------------
 // CLI spawning helper
@@ -144,26 +152,58 @@ async function formatSuccess(result) {
 
   const content = [{ type: 'text', text: parts.join('\n') }];
 
-  // Download images and include as Base64-encoded content so Claude can see them
+  // Download images/videos and save locally + embed as base64 for MCP clients
+  // that support inline image rendering (e.g. Claude Desktop).
+  // For Claude Code (terminal), the saved file path is the primary way to view results.
+  const savedPaths = [];
   for (const url of urls) {
-    if (/\.(png|jpg|jpeg|webp|gif)(\?|$)/i.test(url)) {
-      try {
-        const resp = await fetch(url);
-        if (resp.ok) {
-          const buf = Buffer.from(await resp.arrayBuffer());
-          const ext = url.match(/\.(png|jpg|jpeg|webp|gif)/i)?.[1]?.toLowerCase() || 'png';
-          const mimeType = ext === 'jpg' || ext === 'jpeg' ? 'image/jpeg'
-            : ext === 'webp' ? 'image/webp'
-            : ext === 'gif' ? 'image/gif'
-            : 'image/png';
-          content.push({ type: 'image', data: buf.toString('base64'), mimeType });
-        }
-      } catch {
-        // If download fails, skip embedding — the URL is still in the text
+    const isImage = /\.(png|jpg|jpeg|webp|gif)(\?|$)/i.test(url);
+    const isVideo = /\.(mp4|webm|mov)(\?|$)/i.test(url);
+
+    if (!isImage && !isVideo) continue;
+
+    try {
+      const resp = await fetch(url);
+      if (!resp.ok) continue;
+      const buf = Buffer.from(await resp.arrayBuffer());
+
+      // Determine extension and build a temp file path
+      const ext = isImage
+        ? (url.match(/\.(png|jpg|jpeg|webp|gif)/i)?.[1]?.toLowerCase() || 'png')
+        : (url.match(/\.(mp4|webm|mov)/i)?.[1]?.toLowerCase() || 'mp4');
+
+      // Save to ~/Downloads/sogni/ so the user can find it easily
+      const { mkdirSync, writeFileSync } = await import('fs');
+      const downloadsDir = join(homedir(), 'Downloads', 'sogni');
+      mkdirSync(downloadsDir, { recursive: true });
+      const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+      const filename = `sogni-${timestamp}-${savedPaths.length}.${ext}`;
+      const filePath = join(downloadsDir, filename);
+      writeFileSync(filePath, buf);
+      savedPaths.push(filePath);
+
+      // For images, also embed as base64 (Claude Desktop can render these)
+      if (isImage) {
+        const mimeType = ext === 'jpg' || ext === 'jpeg' ? 'image/jpeg'
+          : ext === 'webp' ? 'image/webp'
+          : ext === 'gif' ? 'image/gif'
+          : 'image/png';
+        content.push({ type: 'image', data: buf.toString('base64'), mimeType });
       }
+    } catch {
+      // If download fails, skip — the URL is still in the text above
     }
   }
 
+  // Append saved file paths to the text output so Claude Code users can see/open them
+  if (savedPaths.length > 0) {
+    const textBlock = content[0];
+    textBlock.text += '\n\n' + savedPaths.map((p, i) =>
+      savedPaths.length === 1 ? `📁 Saved: ${p}` : `📁 Saved #${i + 1}: ${p}`
+    ).join('\n');
+    textBlock.text += '\n\nTip: In Claude Code, ask Claude to run `open <path>` to view the file.';
+  }
+
   return { content };
 }
 
@@ -179,6 +219,15 @@ async function formatResult(result) {
   return formatSuccess(result);
 }
 
+async function runAndFormat(args, { timeoutMs = 30_000, requireCredentials = true } = {}) {
+  if (requireCredentials) {
+    const credErr = checkCredentials();
+    if (credErr) return credErr;
+  }
+  const result = await runSogniGen(args, { timeoutMs });
+  return formatResult(result);
+}
+
 // ---------------------------------------------------------------------------
 // Tool definitions
 // ---------------------------------------------------------------------------
@@ -459,6 +508,14 @@ The face likeness is preserved while applying the style from the prompt.`,
       properties: {},
     },
   },
+  {
+    name: 'get_version',
+    description: 'Show the running sogni-gen version for this MCP server instance.',
+    inputSchema: {
+      type: 'object',
+      properties: {},
+    },
+  },
 ];
 
 // ---------------------------------------------------------------------------
@@ -466,9 +523,6 @@ The face likeness is preserved while applying the style from the prompt.`,
 // ---------------------------------------------------------------------------
 
 async function handleGenerateImage(params) {
-  const credErr = checkCredentials();
-  if (credErr) return credErr;
-
   const args = [params.prompt];
   if (params.model) args.push('-m', params.model);
   if (params.width) args.push('-w', String(params.width));
@@ -480,14 +534,10 @@ async function handleGenerateImage(params) {
   if (params.loras?.length) args.push('--loras', params.loras.join(','));
   if (params.lora_strengths?.length) args.push('--lora-strengths', params.lora_strengths.join(','));
 
-  const result = await runSogniGen(args, { timeoutMs: 60_000 });
-  return formatResult(result);
+  return runAndFormat(args, { timeoutMs: 60_000 });
 }
 
 async function handleGenerateVideo(params) {
-  const credErr = checkCredentials();
-  if (credErr) return credErr;
-
   const args = ['--video', params.prompt];
   if (params.workflow) args.push('--workflow', params.workflow);
   if (params.model) args.push('-m', params.model);
@@ -504,14 +554,10 @@ async function handleGenerateVideo(params) {
   if (params.output) args.push('-o', params.output);
   if (params.looping) args.push('--looping');
 
-  const result = await runSogniGen(args, { timeoutMs: 600_000 });
-  return formatResult(result);
+  return runAndFormat(args, { timeoutMs: 600_000 });
 }
 
 async function handleEditImage(params) {
-  const credErr = checkCredentials();
-  if (credErr) return credErr;
-
   const args = [];
   for (const img of params.context_images) {
     args.push('-c', img);
@@ -522,14 +568,10 @@ async function handleEditImage(params) {
   if (params.height) args.push('-h', String(params.height));
   if (params.output) args.push('-o', params.output);
 
-  const result = await runSogniGen(args, { timeoutMs: 60_000 });
-  return formatResult(result);
+  return runAndFormat(args, { timeoutMs: 60_000 });
 }
 
 async function handlePhotobooth(params) {
-  const credErr = checkCredentials();
-  if (credErr) return credErr;
-
   const args = ['--photobooth', '--ref', params.reference_face, params.prompt];
   if (params.model) args.push('-m', params.model);
   if (params.cn_strength != null) args.push('--cn-strength', String(params.cn_strength));
@@ -539,16 +581,22 @@ async function handlePhotobooth(params) {
   if (params.count) args.push('-n', String(params.count));
   if (params.output) args.push('-o', params.output);
 
-  const result = await runSogniGen(args, { timeoutMs: 60_000 });
-  return formatResult(result);
+  return runAndFormat(args, { timeoutMs: 60_000 });
 }
 
 async function handleCheckBalance() {
-  const credErr = checkCredentials();
-  if (credErr) return credErr;
+  return runAndFormat(['--balance'], { timeoutMs: 30_000 });
+}
 
-  const result = await runSogniGen(['--balance'], { timeoutMs: 30_000 });
-  return formatResult(result);
+async function handleGetVersion() {
+  const result = await runSogniGen(['--version'], { timeoutMs: 5_000 });
+  if (result.success === false) return formatError(result);
+  return {
+    content: [{
+      type: 'text',
+      text: `mcp-server version: ${SERVER_VERSION}\nsogni-gen version: ${result.version || 'unknown'}`,
+    }],
+  };
 }
 
 function handleListModels() {
@@ -573,7 +621,7 @@ Defaults:
 // ---------------------------------------------------------------------------
 
 const server = new Server(
-  { name: 'sogni', version: '1.3.0' },
+  { name: 'sogni', version: SERVER_VERSION },
   { capabilities: { tools: {} } },
 );
 
@@ -595,6 +643,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         return await handleCheckBalance();
       case 'list_models':
         return handleListModels();
+      case 'get_version':
+        return await handleGetVersion();
       default:
         return {
           content: [{ type: 'text', text: `Unknown tool: ${name}` }],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sogni-gen",
-  "version": "1.3.1",
+  "version": "1.3.3",
   "description": "Sogni AI image & video generation — OpenClaw plugin and MCP server for Claude Code / Claude Desktop",
   "type": "module",
   "main": "sogni-gen.mjs",

package/sogni-gen.mjs

@@ -19,6 +19,14 @@ const IS_OPENCLAW_INVOCATION = Boolean(process.env.OPENCLAW_PLUGIN_CONFIG);
 const RAW_ARGS = process.argv.slice(2);
 const CLI_WANTS_JSON = RAW_ARGS.includes('--json');
 const JSON_ERROR_MODE = CLI_WANTS_JSON || IS_OPENCLAW_INVOCATION;
+const PACKAGE_VERSION = (() => {
+  try {
+    const pkg = JSON.parse(readFileSync(new URL('./package.json', import.meta.url), 'utf8'));
+    return pkg.version || 'unknown';
+  } catch {
+    return 'unknown';
+  }
+})();
 const VIDEO_WORKFLOW_DEFAULT_MODELS = {
   't2v': 'wan_v2.2-14b-fp8_t2v_lightx2v',
   'i2v': 'wan_v2.2-14b-fp8_i2v_lightx2v',
@@ -587,6 +595,7 @@ const options = {
   autoResizeVideoAssets: null,
   estimateVideoCost: false,
   showBalance: false,
+  showVersion: false,
   angles360Video: null,
   refImage: null, // Reference image for video (start frame)
   refImageEnd: null, // End frame for video interpolation
@@ -811,6 +820,8 @@ for (let i = 0; i < args.length; i++) {
     options.estimateVideoCost = true;
   } else if (arg === '--balance' || arg === '--balances') {
     options.showBalance = true;
+  } else if (arg === '--version' || arg === '-V') {
+    options.showVersion = true;
   } else if (arg === '--help') {
     console.log(`
 sogni-gen - Generate images and videos using Sogni AI
@@ -873,6 +884,7 @@ General:
   --guidance <num>      Override guidance (model-dependent)
   --token-type <type>   Token type: spark|sogni (default: spark)
   --balance, --balances Show SPARK/SOGNI balances and exit
+  --version, -V         Show sogni-gen version and exit
   --last                Show last render info (JSON)
   --json                Output JSON with all details
   --strict-size         Do not auto-adjust video size to satisfy i2v reference resizing constraints
@@ -1199,7 +1211,7 @@ if (options.video) {
   options.model = options.model || openclawConfig?.defaultImageModel || 'z_image_turbo_bf16';
 }
 
-if (!options.prompt && !options.estimateVideoCost && !options.multiAngle && !options.showBalance) {
+if (!options.prompt && !options.estimateVideoCost && !options.multiAngle && !options.showBalance && !options.showVersion) {
   fatalCliError('No prompt provided. Use --help for usage.', { code: 'INVALID_ARGUMENT' });
 }
 
@@ -1452,7 +1464,7 @@ if (options.lastSeed) {
   }
 }
 
-if (!options.estimateVideoCost && (options.seed === null || options.seed === undefined)) {
+if (!options.estimateVideoCost && !options.showVersion && (options.seed === null || options.seed === undefined)) {
   const strategy = options.seedStrategy || openclawConfig?.seedStrategy || 'prompt-hash';
   const normalized = normalizeSeedStrategy(strategy) || 'prompt-hash';
   options.seedStrategy = normalized;
@@ -2163,6 +2175,21 @@ async function main() {
   let client = null;
   
   try {
+    if (options.showVersion) {
+      if (options.json) {
+        console.log(JSON.stringify({
+          success: true,
+          type: 'version',
+          name: 'sogni-gen',
+          version: PACKAGE_VERSION,
+          timestamp: new Date().toISOString()
+        }));
+      } else {
+        console.log(PACKAGE_VERSION);
+      }
+      return;
+    }
+
     const creds = loadCredentials();
     log('Connecting to Sogni...');
     client = new SogniClientWrapper({