@spira-lab/cli 0.0.11 → 0.0.14

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

@@ -18083,8 +18083,353 @@ var cliResultSchema = external_exports.object({
   error: cliErrorSchema.optional()
 });
 
+// ../../packages/contracts/dist/cli/kie-ai-model-docs.js
+function videoDoc(input) {
+  const exampleInputs = {
+    prompt: "A cinematic camera move through a bright modern studio",
+    duration: input.durations[0]
+  };
+  if (input.sizes?.[0])
+    exampleInputs.size = input.sizes[0];
+  if (input.resolutions?.[0])
+    exampleInputs.resolution = input.resolutions[0];
+  if (input.sound)
+    exampleInputs.sound = false;
+  if (input.acceptsImage || input.requiresImage)
+    exampleInputs.referenceImage = ["https://example.com/reference.png"];
+  if (input.requiresVideo)
+    exampleInputs.referenceVideo = ["https://example.com/motion.mp4"];
+  return {
+    id: input.id,
+    name: input.name,
+    mediaType: "video",
+    description: input.description,
+    capabilities: input.capabilities,
+    variants: input.variants,
+    fields: [
+      { name: "prompt", type: "string", required: true, description: "Text instruction for the video." },
+      {
+        name: "duration",
+        type: "string",
+        description: "Output duration in seconds.",
+        values: input.durations,
+        defaultValue: input.durations[0]
+      },
+      ...input.sizes ? [
+        {
+          name: "size",
+          type: "string",
+          description: "Output aspect ratio.",
+          values: input.sizes,
+          defaultValue: input.sizes[0]
+        }
+      ] : [],
+      ...input.resolutions ? [
+        {
+          name: "resolution",
+          type: "string",
+          description: "Output resolution.",
+          values: input.resolutions,
+          defaultValue: input.resolutions[0]
+        }
+      ] : [],
+      ...input.sound ? [
+        {
+          name: "sound",
+          type: "boolean",
+          description: "Generate native audio.",
+          defaultValue: false
+        }
+      ] : [],
+      ...input.acceptsImage || input.requiresImage ? [
+        {
+          name: "referenceImage",
+          type: "string[]",
+          required: input.requiresImage,
+          description: input.requiresImage ? "Exactly one public image URL is required." : input.maxReferenceImages === 2 ? "Optional one or two public image URLs. Two URLs are used as first and last frames." : "Optional single public image URL for image-to-video."
+        }
+      ] : [],
+      ...input.requiresVideo ? [
+        {
+          name: "referenceVideo",
+          type: "string[]",
+          required: true,
+          description: "Exactly one public 3-30 second motion reference video URL is required."
+        }
+      ] : []
+    ],
+    examples: [{ label: "Generate video", inputs: exampleInputs }],
+    notes: input.notes
+  };
+}
+function imageDoc(input) {
+  const exampleInputs = {
+    prompt: input.requiresImage ? "Change the background to pale yellow" : "A clean editorial product photograph",
+    size: input.sizes[0]
+  };
+  if (input.resolutions?.[0])
+    exampleInputs.resolution = input.resolutions[0];
+  if (input.modes?.[0])
+    exampleInputs.mode = input.modes[0];
+  if (input.outputFormats?.[0])
+    exampleInputs.outputFormat = input.outputFormats[0];
+  if (input.acceptsImage || input.requiresImage)
+    exampleInputs.referenceImage = ["https://example.com/reference.png"];
+  return {
+    id: input.id,
+    name: input.name,
+    mediaType: "image",
+    description: input.description,
+    capabilities: input.capabilities,
+    variants: input.variants,
+    fields: [
+      { name: "prompt", type: "string", required: true, description: "Text instruction for the image." },
+      {
+        name: "size",
+        type: "string",
+        description: "Output aspect ratio.",
+        values: input.sizes,
+        defaultValue: input.sizes[0]
+      },
+      ...input.resolutions ? [
+        {
+          name: "resolution",
+          type: "string",
+          description: "Output resolution.",
+          values: input.resolutions,
+          defaultValue: input.resolutions[0]
+        }
+      ] : [],
+      ...input.modes ? [
+        {
+          name: "mode",
+          type: "string",
+          description: "Generation tier.",
+          values: input.modes,
+          defaultValue: input.modes[0]
+        }
+      ] : [],
+      ...input.outputFormats ? [
+        {
+          name: "outputFormat",
+          type: "string",
+          description: "Output image format.",
+          values: input.outputFormats,
+          defaultValue: input.outputFormats[0]
+        }
+      ] : [],
+      ...input.acceptsImage || input.requiresImage ? [
+        {
+          name: "referenceImage",
+          type: "string[]",
+          required: input.requiresImage,
+          description: input.requiresImage ? "Exactly one public image URL is required." : "Optional public image URL for image editing."
+        }
+      ] : []
+    ],
+    examples: [{ label: input.requiresImage ? "Edit image" : "Generate image", inputs: exampleInputs }]
+  };
+}
+var perSecond = (key, display, creditsPerUnit, conditions = {}) => ({ key, display, conditions, billingUnit: "per_second", creditsPerUnit });
+var perGeneration = (key, display, creditsPerUnit, conditions = {}) => ({ key, display, conditions, billingUnit: "per_generation", creditsPerUnit });
+var KIE_CLI_AI_MODEL_DOCS = [
+  videoDoc({
+    id: "kling-2.6",
+    name: "Kling 2.6",
+    description: "Native-audio video generation with synchronized dialogue from text or image.",
+    capabilities: ["text-to-video", "image-to-video"],
+    variants: [
+      perSecond("silent", "Sound off", 5.5, { sound: false }),
+      perSecond("sound", "Sound on", 11, { sound: true })
+    ],
+    durations: ["5", "10"],
+    sizes: ["16:9", "9:16", "1:1"],
+    acceptsImage: true,
+    sound: true
+  }),
+  videoDoc({
+    id: "kling-2.6-motion-control",
+    name: "Kling 2.6 Motion Control",
+    description: "Reference-motion transfer with character consistency and controllable output resolution.",
+    capabilities: ["image-to-video", "motion-control"],
+    variants: [
+      perSecond("720p", "720p", 5.5, { resolution: "720p" }),
+      perSecond("1080p", "1080p", 9, { resolution: "1080p" })
+    ],
+    durations: ["3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "20", "25", "30"],
+    resolutions: ["720p", "1080p"],
+    requiresImage: true,
+    requiresVideo: true
+  }),
+  videoDoc({
+    id: "kling-2.5-turbo-pro",
+    name: "Kling 2.5",
+    description: "Kling 2.5 Turbo Pro text/image-to-video through KIE.",
+    capabilities: ["text-to-video", "image-to-video"],
+    variants: [perSecond("default", "Per second", 4.2)],
+    durations: ["5", "10"],
+    sizes: ["16:9", "9:16", "1:1"],
+    acceptsImage: true
+  }),
+  videoDoc({
+    id: "kling-2.1-master",
+    name: "Kling 2.1 Master",
+    description: "Kling 2.1 Master text/image-to-video through KIE.",
+    capabilities: ["text-to-video", "image-to-video"],
+    variants: [perSecond("default", "Per second", 16)],
+    durations: ["5", "10"],
+    sizes: ["16:9", "9:16", "1:1"],
+    acceptsImage: true
+  }),
+  videoDoc({
+    id: "kling-2.1-pro",
+    name: "Kling 2.1 Pro",
+    description: "Kling 2.1 Pro image-to-video through KIE.",
+    capabilities: ["image-to-video"],
+    variants: [perSecond("default", "Per second", 5)],
+    durations: ["5", "10"],
+    requiresImage: true
+  }),
+  videoDoc({
+    id: "kling-2.1-standard",
+    name: "Kling 2.1 Standard",
+    description: "Kling 2.1 Standard image-to-video through KIE.",
+    capabilities: ["image-to-video"],
+    variants: [perSecond("default", "Per second", 2.5)],
+    durations: ["5", "10"],
+    requiresImage: true
+  }),
+  videoDoc({
+    id: "wan-2.2-a14b-turbo",
+    name: "Wan 2.2",
+    description: "Wan 2.2 A14B Turbo text/image-to-video through KIE.",
+    capabilities: ["text-to-video", "image-to-video"],
+    variants: [
+      perGeneration("480p", "480p / 5 seconds", 20, { resolution: "480p" }),
+      perGeneration("720p", "720p / 5 seconds", 40, { resolution: "720p" })
+    ],
+    durations: ["5"],
+    sizes: ["16:9", "9:16", "1:1"],
+    resolutions: ["480p", "720p"],
+    acceptsImage: true
+  }),
+  videoDoc({
+    id: "wan-2.5",
+    name: "Wan 2.5",
+    description: "Cinematic text and image video generation with synchronized dialogue, ambience, and music.",
+    capabilities: ["text-to-video", "image-to-video"],
+    variants: [
+      perSecond("720p", "720p", 6, { resolution: "720p" }),
+      perSecond("1080p", "1080p", 10, { resolution: "1080p" })
+    ],
+    durations: ["5", "10"],
+    sizes: ["16:9", "9:16", "1:1"],
+    resolutions: ["720p", "1080p"],
+    acceptsImage: true
+  }),
+  videoDoc({
+    id: "wan-2.6",
+    name: "Wan 2.6",
+    description: "Multi-shot HD video generation with stable characters and synchronized native audio.",
+    capabilities: ["text-to-video", "image-to-video"],
+    variants: [
+      perGeneration("720p-5", "720p / 5 seconds", 35, { resolution: "720p", duration: "5" }),
+      perGeneration("720p-10", "720p / 10 seconds", 70, { resolution: "720p", duration: "10" }),
+      perGeneration("720p-15", "720p / 15 seconds", 105, { resolution: "720p", duration: "15" }),
+      perGeneration("1080p-5", "1080p / 5 seconds", 52.25, { resolution: "1080p", duration: "5" }),
+      perGeneration("1080p-10", "1080p / 10 seconds", 104.75, { resolution: "1080p", duration: "10" }),
+      perGeneration("1080p-15", "1080p / 15 seconds", 157.5, { resolution: "1080p", duration: "15" })
+    ],
+    durations: ["5", "10", "15"],
+    resolutions: ["720p", "1080p"],
+    acceptsImage: true
+  }),
+  videoDoc({
+    id: "wan-2.7",
+    name: "Wan 2.7",
+    description: "Controllable cinematic video generation with first and last frame guidance.",
+    capabilities: ["text-to-video", "image-to-video"],
+    variants: [
+      perSecond("720p", "720p", 8, { resolution: "720p" }),
+      perSecond("1080p", "1080p", 12, { resolution: "1080p" })
+    ],
+    durations: ["5", "2", "3", "4", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15"],
+    sizes: ["16:9", "9:16", "1:1", "4:3", "3:4"],
+    resolutions: ["720p", "1080p"],
+    acceptsImage: true,
+    maxReferenceImages: 2,
+    notes: ["Aspect ratio applies to text-to-video. Image-to-video inherits framing from the reference images."]
+  }),
+  imageDoc({
+    id: "seedream-4.5",
+    name: "Seedream 4.5",
+    description: "Precise 4K image generation and consistent multi-image editing.",
+    capabilities: ["text-to-image", "image-to-image"],
+    variants: [perGeneration("default", "Per image", 3.25)],
+    sizes: ["1:1", "4:3", "3:4", "16:9", "9:16", "2:3", "3:2", "21:9"],
+    resolutions: ["2K", "4K"],
+    acceptsImage: true
+  }),
+  imageDoc({
+    id: "nano-banana",
+    name: "Nano Banana",
+    description: "Fast, cost-efficient image generation powered by Gemini 2.5 Flash Image.",
+    capabilities: ["text-to-image"],
+    variants: [perGeneration("default", "Per image", 2)],
+    sizes: ["1:1", "9:16", "16:9", "4:3", "3:4", "3:2", "2:3", "5:4", "4:5", "21:9", "auto"],
+    outputFormats: ["png", "jpg"]
+  }),
+  imageDoc({
+    id: "seedream-4.0",
+    name: "Seedream 4.0",
+    description: "Seedream 4.0 image generation/editing through KIE.",
+    capabilities: ["text-to-image", "image-to-image"],
+    variants: [perGeneration("default", "Per image", 2.5)],
+    sizes: ["1:1", "4:3", "3:4", "3:2", "2:3", "16:9", "9:16", "21:9"],
+    resolutions: ["1K", "2K", "4K"],
+    acceptsImage: true
+  }),
+  imageDoc({
+    id: "flux-kontext",
+    name: "Flux.1 Kontext",
+    description: "Flux.1 Kontext image generation/editing through KIE.",
+    capabilities: ["text-to-image", "image-to-image"],
+    variants: [perGeneration("pro", "Pro", 2.5, { mode: "pro" }), perGeneration("max", "Max", 5, { mode: "max" })],
+    sizes: ["16:9", "9:16", "1:1", "4:3", "3:4", "21:9"],
+    modes: ["pro", "max"],
+    outputFormats: ["png", "jpg"],
+    acceptsImage: true
+  }),
+  imageDoc({
+    id: "qwen-image-edit",
+    name: "Qwen Image Edit",
+    description: "Precise semantic, appearance, and bilingual text editing while preserving visual coherence.",
+    capabilities: ["image-to-image"],
+    variants: [
+      perGeneration("1:1", "1:1", 0.5, { size: "1:1" }),
+      perGeneration("1:1-hd", "1:1 HD", 1.75, { size: "1:1 HD" }),
+      perGeneration("3:4", "3:4", 1.25, { size: "3:4" }),
+      perGeneration("9:16", "9:16", 1, { size: "9:16" }),
+      perGeneration("4:3", "4:3", 1.25, { size: "4:3" }),
+      perGeneration("16:9", "16:9", 1, { size: "16:9" })
+    ],
+    sizes: ["1:1", "1:1 HD", "3:4", "9:16", "4:3", "16:9"],
+    outputFormats: ["png", "jpg"],
+    requiresImage: true
+  }),
+  imageDoc({
+    id: "z-image",
+    name: "Z-Image",
+    description: "Fast photorealistic image generation with strong bilingual text rendering.",
+    capabilities: ["text-to-image"],
+    variants: [perGeneration("default", "Per image", 0.4)],
+    sizes: ["1:1", "4:3", "3:4", "16:9", "9:16"]
+  })
+];
+
 // src/ai/model-docs.ts
 var cliAiModelDocs = [
+  ...KIE_CLI_AI_MODEL_DOCS,
   {
     "id": "ai-influencer-image",
     "name": "AI Influencer",
@@ -18581,7 +18926,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 +19129,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 +19480,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 +20467,218 @@ 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: "bria-video-background-removal",
+    name: "Bria Video Background Removal",
+    mediaType: "video",
+    description: "Remove a video background with Bria VRMBG 3.0 and replace it with a solid colour.",
+    capabilities: ["video-to-video"],
+    variants: [
+      {
+        key: "default",
+        display: "Per second of source video",
+        conditions: {},
+        billingUnit: "per_second",
+        creditsPerUnit: 0.42
+      }
+    ],
+    fields: [
+      {
+        name: "referenceVideo",
+        type: "string[]",
+        description: "Exactly one public HTTP/HTTPS source video URL, up to 100 MiB.",
+        required: true
+      },
+      {
+        name: "mode",
+        type: "string",
+        description: "Solid replacement background colour.",
+        values: ["Green", "Black", "White", "Gray", "Red", "Blue", "Yellow", "Cyan", "Magenta", "Orange"],
+        defaultValue: "Green"
+      },
+      {
+        name: "preserveAudio",
+        type: "boolean",
+        description: "Keep the source audio track in the output.",
+        defaultValue: true
+      },
+      {
+        name: "autoZoom",
+        type: "boolean",
+        description: "Crop the output to the tightest rectangle that contains the subject for the whole clip.",
+        defaultValue: false
+      }
+    ],
+    examples: [
+      {
+        label: "Remove a video background",
+        inputs: {
+          referenceVideo: ["https://example.com/source.mp4"],
+          mode: "Green",
+          preserveAudio: true,
+          autoZoom: false
+        }
+      }
+    ],
+    notes: [
+      "No prompt is required or accepted; provide exactly one referenceVideo URL.",
+      "Every colour uses the same rate, billed from the measured source-video duration.",
+      "The output is H.264 MP4 with a solid background; transparent output is not available through this model integration."
+    ]
+  },
   {
     "id": "veo3.1",
     "name": "Veo 3.1",
@@ -20076,9 +20790,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 +20822,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 +20861,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 +21394,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 +21410,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 +21455,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 +21479,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 +21723,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 +21974,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 +22350,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 +22388,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 +22398,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 +22438,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 +22452,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 +23071,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 +23133,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 +23142,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 +23816,8 @@ function renderCommandIndex() {
 `;
 }
 async function packageVersion() {
-  if ("0.0.11".length > 0) {
-    return "0.0.11";
+  if ("0.0.14".length > 0) {
+    return "0.0.14";
   }
   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.14",
   "description": "Command line client for Spira.",
   "type": "module",
   "bin": {