@spira-lab/cli 0.0.11 → 0.0.13

package/README.md

@@ -25,7 +25,8 @@ spira ai models list
 spira ai models list --media-type audio
 spira ai jobs create --model-id nano-banana-2 --inputs-json '{"prompt":"A product photo"}' --wait
 spira ai jobs create --model-id elevenlabs-music-generation --inputs-json '{"prompt":"A short ambient cue","duration":"10"}' --wait
-spira workflows node-catalog --json
+spira workflows node-catalog --view summary --json
+spira workflows node-catalog --view full --node-type textInput --node-type textChatLlm --json
 spira workflows create --name "Product launch workflow"
 spira workflows update <workflowId> --workflow-definition-json '{"nodes":[],"edges":[]}'
 ```

package/dist/index.cjs

@@ -18581,7 +18581,8 @@ var cliAiModelDocs = [
     "description": "Gemini Omni text/image/video-reference to video model.",
     "capabilities": [
       "text-to-video",
-      "image-to-video"
+      "image-to-video",
+      "video-to-video"
     ],
     "variants": [
       {
@@ -18783,7 +18784,7 @@ var cliAiModelDocs = [
       {
         "name": "referenceVideo",
         "type": "string[]",
-        "description": "Optional source video URL. Requires videoStartSeconds and videoEndSeconds; selected clip must be 10 seconds or shorter."
+        "description": "Optional source video URL; source must be 30 seconds or shorter. Requires videoStartSeconds and videoEndSeconds; selected clip must be 10 seconds or shorter."
       },
       {
         "name": "videoStartSeconds",
@@ -19134,6 +19135,162 @@ var cliAiModelDocs = [
       "image_to_video requires exactly 1 referenceImage and does not send aspect ratio; size applies to text_to_video and reference_to_video."
     ]
   },
+  {
+    "id": "minimax-h3",
+    "name": "MiniMax H3",
+    "mediaType": "video",
+    "description": "MiniMax H3 multimodal video model. The only model that accepts image, video, and audio references in the same request.",
+    "capabilities": [
+      "text-to-video",
+      "image-to-video"
+    ],
+    "variants": [
+      {
+        "key": "768p",
+        "display": "768p",
+        "conditions": {
+          "resolution": "768p"
+        },
+        "billingUnit": "per_second",
+        "creditsPerUnit": 9.6
+      },
+      {
+        "key": "2k",
+        "display": "2K",
+        "conditions": {
+          "resolution": "2k"
+        },
+        "billingUnit": "per_second",
+        "creditsPerUnit": 15.6
+      }
+    ],
+    "fields": [
+      {
+        "name": "prompt",
+        "type": "string",
+        "description": "Text instruction for the video. Up to 7000 characters.",
+        "required": true
+      },
+      {
+        "name": "mode",
+        "type": "string",
+        "description": "Model mode or quality/speed tier.",
+        "values": [
+          "standard"
+        ],
+        "defaultValue": "standard"
+      },
+      {
+        "name": "duration",
+        "type": "string",
+        "description": "Output duration in seconds.",
+        "values": [
+          "6",
+          "4",
+          "5",
+          "7",
+          "8",
+          "9",
+          "10",
+          "11",
+          "12",
+          "13",
+          "14",
+          "15"
+        ],
+        "defaultValue": "6"
+      },
+      {
+        "name": "size",
+        "type": "string",
+        "description": "Output aspect ratio. Only sent for text_to_video and reference_to_video; 'auto' is accepted for reference_to_video only.",
+        "values": [
+          "16:9",
+          "9:16",
+          "21:9",
+          "4:3",
+          "1:1",
+          "3:4",
+          "auto"
+        ],
+        "defaultValue": "16:9"
+      },
+      {
+        "name": "resolution",
+        "type": "string",
+        "description": "Output resolution.",
+        "values": [
+          "768p",
+          "2k"
+        ],
+        "defaultValue": "768p"
+      },
+      {
+        "name": "referenceImage",
+        "type": "string[]",
+        "description": "Optional public HTTP image URLs, up to 9. 1 image is the start frame, 2 images are the first and last frames, 3 or more are general references."
+      },
+      {
+        "name": "referenceVideo",
+        "type": "string[]",
+        "description": "Optional public HTTP MP4/MOV URLs, up to 3, reference_to_video only. Each clip must be 2 to 15 seconds and they must total at most 15 seconds."
+      },
+      {
+        "name": "referenceAudio",
+        "type": "string[]",
+        "description": "Optional public HTTP WAV/MP3 URLs, up to 3, reference_to_video only. Each clip must be 2 to 15 seconds. Audio cannot be the only reference."
+      },
+      {
+        "name": "generationType",
+        "type": "string",
+        "description": "Optional workflow mode hint. Inferred from the references when omitted.",
+        "values": [
+          "text_to_video",
+          "image_to_video",
+          "first_last_frames_to_video",
+          "reference_to_video"
+        ]
+      }
+    ],
+    "examples": [
+      {
+        "label": "Text to video",
+        "inputs": {
+          "prompt": "A cinematic tracking shot gliding through a rain-soaked neon alley at night",
+          "duration": "6",
+          "size": "16:9",
+          "resolution": "768p"
+        }
+      },
+      {
+        "label": "Multimodal reference to video",
+        "inputs": {
+          "prompt": "Keep the character appearance, follow the reference camera movement, match the reference music",
+          "generationType": "reference_to_video",
+          "referenceImage": [
+            "https://example.com/character.jpg"
+          ],
+          "referenceVideo": [
+            "https://example.com/movement.mp4"
+          ],
+          "referenceAudio": [
+            "https://example.com/music.mp3"
+          ],
+          "duration": "8",
+          "size": "auto",
+          "resolution": "2k"
+        }
+      }
+    ],
+    "notes": [
+      "generationType is inferred from the references: none is text_to_video, 1 image is image_to_video, 2 images are first_last_frames_to_video, and 3+ images or any video/audio reference is reference_to_video. Pass generationType=reference_to_video explicitly to treat 1 or 2 images as plain references instead of frames.",
+      "image, video, and audio references support at most 12 items in total.",
+      "size is rejected for image_to_video and first_last_frames_to_video, so it is not sent for those modes. 'auto' is valid only for reference_to_video.",
+      "Billing counts the generated duration plus the full duration of every reference video, at the output resolution's rate. The first 5 reference images are free; each one after that adds a flat surcharge.",
+      "sound, seed, negativePrompt, storyboard, elements, and video extension are not supported.",
+      "An error_code of generation_failed with a 'system error, MiniMax-H3 task-control' message is an upstream capacity fault, not a prompt problem. Failed jobs are not charged, so retry the same prompt."
+    ]
+  },
   {
     "id": "heygen-avatar-4",
     "name": "HeyGen Avatar 4 Lipsync",
@@ -19965,6 +20122,159 @@ var cliAiModelDocs = [
       "generationType=text_to_video rejects reference inputs; reference_to_video requires at least one reference input; first_last_frames_to_video requires exactly 2 reference images and no video/audio input."
     ]
   },
+  {
+    "id": "seedance-2.5",
+    "name": "Seedance 2.5",
+    "mediaType": "video",
+    "description": "Seedance 2.5 text/image/reference video model with multi-asset references and up to 30s output.",
+    "capabilities": [
+      "text-to-video",
+      "image-to-video",
+      "reference-to-video"
+    ],
+    "variants": [
+      {
+        "key": "480p",
+        "display": "480p",
+        "conditions": {
+          "resolution": "480p"
+        },
+        "billingUnit": "per_second",
+        "creditsPerUnit": 13.63
+      },
+      {
+        "key": "720p",
+        "display": "720p",
+        "conditions": {
+          "resolution": "720p"
+        },
+        "billingUnit": "per_second",
+        "creditsPerUnit": 30.68
+      },
+      {
+        "key": "480p-video-url",
+        "display": "480p, with input video",
+        "conditions": {
+          "resolution": "480p",
+          "feature": "video_url"
+        },
+        "billingUnit": "per_second",
+        "creditsPerUnit": 8.18
+      },
+      {
+        "key": "720p-video-url",
+        "display": "720p, with input video",
+        "conditions": {
+          "resolution": "720p",
+          "feature": "video_url"
+        },
+        "billingUnit": "per_second",
+        "creditsPerUnit": 18.41
+      }
+    ],
+    "fields": [
+      {
+        "name": "prompt",
+        "type": "string",
+        "description": "Text instruction for the video.",
+        "required": true
+      },
+      {
+        "name": "duration",
+        "type": "string",
+        "description": "Output duration in seconds.",
+        "values": [
+          "4",
+          "5",
+          "6",
+          "8",
+          "10",
+          "12",
+          "15",
+          "20",
+          "25",
+          "30"
+        ],
+        "defaultValue": "5"
+      },
+      {
+        "name": "size",
+        "type": "string",
+        "description": "Output aspect ratio. 'adaptive' lets the model pick framing from its references.",
+        "values": [
+          "adaptive",
+          "9:16",
+          "16:9",
+          "1:1",
+          "4:3",
+          "3:4",
+          "21:9"
+        ],
+        "defaultValue": "adaptive"
+      },
+      {
+        "name": "resolution",
+        "type": "string",
+        "description": "Output resolution. Seedance 2.5 has no 1080p tier.",
+        "values": [
+          "720p",
+          "480p"
+        ],
+        "defaultValue": "720p"
+      },
+      {
+        "name": "referenceImage",
+        "type": "string[]",
+        "description": "Optional image URLs. At most 30; must be public HTTP/HTTPS URLs."
+      },
+      {
+        "name": "referenceVideo",
+        "type": "string[]",
+        "description": "Optional source video URLs. At most 10, each 2-30s, 30s total across all clips."
+      },
+      {
+        "name": "referenceAudio",
+        "type": "string[]",
+        "description": "Optional reference audio URLs. At most 10, each 2-30s, 30s total across all clips."
+      },
+      {
+        "name": "sound",
+        "type": "boolean",
+        "description": "Whether to request generated sound.",
+        "defaultValue": true
+      },
+      {
+        "name": "generationType",
+        "type": "string",
+        "description": "Optional workflow mode hint; inferred from reference counts when omitted.",
+        "values": [
+          "text_to_video",
+          "image_to_video",
+          "first_last_frames_to_video",
+          "reference_to_video"
+        ]
+      }
+    ],
+    "examples": [
+      {
+        "label": "Generate video",
+        "inputs": {
+          "prompt": "A calm 5 second vertical shot of a minimal terminal interface glowing on a laptop",
+          "duration": "5",
+          "size": "9:16",
+          "resolution": "480p",
+          "sound": false
+        }
+      }
+    ],
+    "notes": [
+      "Seedance 2.5 has no fast tier, no 1080p, and does not support seed, extend, storyboard, elements, or negativePrompt.",
+      "asset:// URIs are rejected; every reference must be a public HTTP/HTTPS URL. Seedance 2.0 does accept asset:// URIs.",
+      "referenceImage supports at most 30 URLs, referenceVideo at most 10, referenceAudio at most 10, and at most 50 references in total.",
+      "With input video the per-second rate drops but billable seconds become the summed duration of every input video (minimum 4) plus the output duration.",
+      "generationType=text_to_video rejects reference inputs; first_last_frames_to_video requires exactly 2 reference images; only reference_to_video accepts video or audio references."
+    ]
+  },
   {
     "id": "veo3.1",
     "name": "Veo 3.1",
@@ -20076,9 +20386,11 @@ var cliAiModelDocs = [
       {
         "name": "duration",
         "type": "string",
-        "description": "Output duration in seconds.",
+        "description": "Output duration in seconds. SoCheap supports 4, 6, and 8 for text_to_video and first_last_frames_to_video; fast reference_to_video is 8 only.",
         "values": [
-          "8"
+          "8",
+          "4",
+          "6"
         ],
         "defaultValue": "8"
       },
@@ -20106,7 +20418,7 @@ var cliAiModelDocs = [
       {
         "name": "referenceImage",
         "type": "string[]",
-        "description": "Optional image URLs. 1 image can be reference_to_video; exactly 2 images can be first_last_frames_to_video."
+        "description": "Optional image URLs, at most 3. On veo-google: 1 = first frame, 2 = first and last frames, 3 = subject references. On socheap-media: 1 = reference_to_video (fast mode only), exactly 2 = first_last_frames_to_video."
       },
       {
         "name": "generationType",
@@ -20145,8 +20457,12 @@ var cliAiModelDocs = [
       "Veo 3.1 supports 16:9 and 9:16 output aspect ratios.",
       "referenceVideo and referenceAudio are not supported.",
       "image_to_video is not a supported generationType; use reference_to_video with one or more referenceImage URLs.",
+      "socheap-media supports duration 4, 6, and 8 for text_to_video and first_last_frames_to_video at 720p, 1080p, and 4k. Fast reference_to_video remains 8 seconds.",
+      "veo-google supports duration 4 and 6 only at resolution=720p, with at most 2 referenceImage URLs and extend unset.",
+      "quality mode with a single referenceImage requires --provider-id veo-google; socheap-media needs exactly 2 frames in quality mode.",
       "first_last_frames_to_video requires exactly 2 referenceImage URLs.",
-      "extendFromJobId requires resolution=720p."
+      "extendFromJobId requires resolution=720p and a source generated by socheap-media. Omit duration; SoCheap extensions have a fixed 7 second output.",
+      "Veo renders picture and audio in one pass, so an audio-side failure fails the whole job. It is intermittent \u2014 retry the same prompt before rewriting it."
     ]
   },
   {
@@ -20674,13 +20990,6 @@ var commandDefinitions = [
         type: "string",
         enumValues: ["draft", "scheduled", "pending", "completed", "failed", "canceled"]
       },
-      {
-        name: "accountSource",
-        flag: "--account-source <source>",
-        description: "Filter by account type.",
-        type: "string",
-        enumValues: ["oauth_account", "operation_account"]
-      },
       {
         name: "agentId",
         flag: "--agent-id <agentId>",
@@ -20697,7 +21006,6 @@ var commandDefinitions = [
         { name: "offset", source: "option", from: "offset" },
         { name: "platform", source: "option", from: "platform" },
         { name: "status", source: "option", from: "status" },
-        { name: "accountSource", source: "option", from: "accountSource" },
         { name: "agentId", source: "option", from: "agentId" }
       ]
     },
@@ -20743,14 +21051,6 @@ var commandDefinitions = [
         enumValues: ["video", "photo", "text", "mixed"]
       },
       { name: "accountId", flag: "--account-id <accountId>", description: "Publishing account ID.", type: "string" },
-      {
-        name: "accountSource",
-        flag: "--account-source <source>",
-        description: "Publishing account type.",
-        type: "string",
-        enumValues: ["oauth_account", "operation_account"],
-        defaultValue: "oauth_account"
-      },
       { name: "title", flag: "--title <title>", description: "Draft title.", type: "string" },
       {
         name: "description",
@@ -20775,7 +21075,6 @@ var commandDefinitions = [
         { name: "platform", source: "option", from: "platform" },
         { name: "contentKind", source: "option", from: "contentKind" },
         { name: "accountId", source: "option", from: "accountId" },
-        { name: "accountSource", source: "option", from: "accountSource" },
         { name: "title", source: "option", from: "title" },
         { name: "description", source: "option", from: "description" },
         { name: "mediaUrls", source: "option", from: "mediaUrls" },
@@ -21020,16 +21319,37 @@ var commandDefinitions = [
         type: "string",
         enumValues: ["dashboard", "admin"],
         defaultValue: "dashboard"
+      },
+      {
+        name: "view",
+        flag: "--view <view>",
+        description: "Catalog detail level. Use summary for discovery and full for selected node schemas.",
+        type: "string",
+        enumValues: ["summary", "full"],
+        defaultValue: "full"
+      },
+      {
+        name: "nodeType",
+        flag: "--node-type <nodeType>",
+        description: "Return only this node type. Repeat to request multiple types.",
+        type: "stringArray"
       }
     ],
     http: {
       method: "GET",
       path: "/api/cli/v1/workflows/node-catalog",
       authRequired: true,
-      query: [{ name: "surface", source: "option", from: "surface" }]
+      query: [
+        { name: "surface", source: "option", from: "surface" },
+        { name: "view", source: "option", from: "view" },
+        { name: "type", source: "option", from: "nodeType" }
+      ]
     },
     resultType: "workflowNodeCatalog",
-    examples: ["spira workflows node-catalog --json", "spira workflows node-catalog --surface admin --json"],
+    examples: [
+      "spira workflows node-catalog --view summary --json",
+      "spira workflows node-catalog --view full --node-type textInput --node-type textChatLlm --json"
+    ],
     relatedCommands: [
       "spira workflows create --name <name>",
       "spira workflows update <workflowId>",
@@ -21250,6 +21570,31 @@ var commandDefinitions = [
     examples: ["spira workflows runs start wf_123"],
     relatedCommands: ["spira workflows runs get <runId>", "spira credits balance"]
   },
+  {
+    path: ["workflows", "runs", "cancel"],
+    purpose: "Cancel a running workflow run. Idempotent.",
+    arguments: [{ name: "runId", description: "Workflow run ID.", required: true }],
+    options: [
+      {
+        name: "surface",
+        flag: "--surface <surface>",
+        description: "Workflow access surface.",
+        type: "string",
+        enumValues: ["dashboard", "admin"],
+        defaultValue: "dashboard"
+      }
+    ],
+    http: {
+      method: "POST",
+      path: "/api/workflows/runs/:runId/cancel",
+      authRequired: true,
+      pathParams: [{ name: "runId", source: "argument", from: "runId" }],
+      body: [{ name: "surface", source: "option", from: "surface" }]
+    },
+    resultType: "workflowRunAction",
+    examples: ["spira workflows runs cancel run_abc"],
+    relatedCommands: ["spira workflows runs get <runId>", "spira workflows runs list <workflowId>"]
+  },
   {
     path: ["schedules", "list"],
     purpose: "List schedules.",
@@ -21601,8 +21946,12 @@ var import_node_path2 = require("node:path");
 var import_promises = require("node:fs/promises");
 var import_node_path = require("node:path");
 var import_node_os = require("node:os");
-var CONFIG_DIR = process.env.SPIRA_CLI_HOME || (0, import_node_path.join)((0, import_node_os.homedir)(), ".spira");
-var SESSION_PATH = (0, import_node_path.join)(CONFIG_DIR, "session.json");
+function configDir() {
+  return process.env.SPIRA_CLI_HOME || (0, import_node_path.join)((0, import_node_os.homedir)(), ".spira");
+}
+function sessionPath() {
+  return (0, import_node_path.join)(configDir(), "session.json");
+}
 function normalizeBaseUrl(apiUrl) {
   const parsed = new URL(apiUrl);
   parsed.pathname = parsed.pathname.replace(/\/+$/, "");
@@ -21635,7 +21984,7 @@ function cookieHeaderFromSession(session) {
 }
 async function readSession() {
   try {
-    const raw = await (0, import_promises.readFile)(SESSION_PATH, "utf8");
+    const raw = await (0, import_promises.readFile)(sessionPath(), "utf8");
     const parsed = JSON.parse(raw);
     if (!parsed.apiUrl || !Array.isArray(parsed.cookies)) return null;
     return parsed;
@@ -21645,17 +21994,17 @@ async function readSession() {
   }
 }
 async function writeSession(session) {
-  await (0, import_promises.mkdir)((0, import_node_path.dirname)(SESSION_PATH), { recursive: true, mode: 448 });
+  await (0, import_promises.mkdir)((0, import_node_path.dirname)(sessionPath()), { recursive: true, mode: 448 });
   const normalized = {
     ...session,
     apiUrl: normalizeBaseUrl(session.apiUrl)
   };
-  await (0, import_promises.writeFile)(SESSION_PATH, `${JSON.stringify(normalized, null, 2)}
+  await (0, import_promises.writeFile)(sessionPath(), `${JSON.stringify(normalized, null, 2)}
 `, { mode: 384 });
   return normalized;
 }
 async function clearSession() {
-  await (0, import_promises.rm)(SESSION_PATH, { force: true });
+  await (0, import_promises.rm)(sessionPath(), { force: true });
 }
 function splitCombinedSetCookieHeader(value) {
   return value.split(/,(?=\s*[^;,=\s]+=[^;,]*)/g).map((item) => item.trim()).filter(Boolean);
@@ -21685,10 +22034,12 @@ async function refreshSessionCookies(session, headers) {
 
 // src/auth/config.ts
 var DEFAULT_BASE_URL = "https://spira.ai";
-var CONFIG_PATH = (0, import_node_path2.join)(CONFIG_DIR, "config.json");
+function configPath() {
+  return (0, import_node_path2.join)(configDir(), "config.json");
+}
 async function readConfig() {
   try {
-    const raw = await (0, import_promises2.readFile)(CONFIG_PATH, "utf8");
+    const raw = await (0, import_promises2.readFile)(configPath(), "utf8");
     const parsed = JSON.parse(raw);
     return parsed && typeof parsed === "object" ? parsed : {};
   } catch (error51) {
@@ -21697,8 +22048,8 @@ async function readConfig() {
   }
 }
 async function writeConfig(config2) {
-  await (0, import_promises2.mkdir)((0, import_node_path2.dirname)(CONFIG_PATH), { recursive: true, mode: 448 });
-  await (0, import_promises2.writeFile)(CONFIG_PATH, `${JSON.stringify(config2, null, 2)}
+  await (0, import_promises2.mkdir)((0, import_node_path2.dirname)(configPath()), { recursive: true, mode: 448 });
+  await (0, import_promises2.writeFile)(configPath(), `${JSON.stringify(config2, null, 2)}
 `, { mode: 384 });
   return config2;
 }
@@ -22316,11 +22667,10 @@ function renderAccountList(data) {
       return {
         platform: record2.platform,
         connected: record2.oauthAccountsCount,
-        managed: record2.cloudDeviceAccountsCount,
         publishWith: record2.availableStrategies
       };
     });
-    return renderRows(rows, ["platform", "connected", "managed", "publishWith"]);
+    return renderRows(rows, ["platform", "connected", "publishWith"]);
   }
   return renderKeyValues(data);
 }
@@ -22379,7 +22729,6 @@ function renderSocialSubmissionDetail(data) {
     platform: raw.platform,
     status: raw.status ?? "published",
     contentKind: raw.contentKind,
-    accountSource: raw.accountSource,
     agentId: raw.agentId,
     postUrl: nested.postUrl,
     providerSubmissionId: nested.tweetId
@@ -22389,7 +22738,6 @@ function renderSocialSubmissionDetail(data) {
     `platform: ${valueToText(record2.platform)}`,
     `status: ${valueToText(record2.status)}`,
     `content: ${valueToText(record2.contentKind)}`,
-    `accountType: ${valueToText(record2.accountSource)}`,
     `agentId: ${valueToText(record2.agentId)}`
   ];
   const title = compactText(record2.title);
@@ -23064,8 +23412,8 @@ function renderCommandIndex() {
 `;
 }
 async function packageVersion() {
-  if ("0.0.11".length > 0) {
-    return "0.0.11";
+  if ("0.0.13".length > 0) {
+    return "0.0.13";
   }
   try {
     const packageUrl = new URL("../package.json", import_meta.url);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spira-lab/cli",
-  "version": "0.0.11",
+  "version": "0.0.13",
   "description": "Command line client for Spira.",
   "type": "module",
   "bin": {