@spira-lab/cli 0.0.8 → 0.0.10

package/README.md

@@ -2,6 +2,14 @@
 
 Command line client for Spira.
 
+> ⚠️ **Database feature is deprecated.** The Brand Machine "Database" subsystem
+> has been retired from the product. The `spira dataBase glob | read | grep |
+> search` commands still exist for backward compatibility only — do NOT build
+> new workflows against them. Use the Brand Machine web dashboard or the
+> per-user cc-engine workspace (`spira workspace` / dashboard Workspace tab)
+> instead. The bundled `spira-database` skill has been removed so agents are
+> no longer guided toward these commands.
+
 ## Install
 
 ```bash

package/dist/index.cjs

@@ -3457,7 +3457,7 @@ var require_commander = __commonJS({
 });
 
 // src/program.ts
-var import_promises3 = require("node:fs/promises");
+var import_promises5 = require("node:fs/promises");
 
 // ../../node_modules/.pnpm/commander@14.0.3/node_modules/commander/esm.mjs
 var import_index = __toESM(require_commander(), 1);
@@ -18048,6 +18048,7 @@ var cliResultTypeSchema = external_exports.enum([
   "aiJobAction",
   "aiModelList",
   "aiModelDetail",
+  "aiModelProviderList",
   "workflowList",
   "workflowNodeCatalog",
   "workflowDetail",
@@ -18059,6 +18060,8 @@ var cliResultTypeSchema = external_exports.enum([
   "scheduleOccurrenceList",
   "scheduleExecutionList",
   "scheduleAction",
+  "mediaInfo",
+  "mediaAsset",
   "dataBaseGlob",
   "dataBaseRead",
   "dataBaseGrep",
@@ -18083,16 +18086,13 @@ var cliResultSchema = external_exports.object({
 // src/ai/model-docs.ts
 var cliAiModelDocs = [
   {
-    "id": "higgsfield-ai/soul/standard",
+    "id": "ai-influencer-image",
     "name": "AI Influencer",
     "mediaType": "image",
     "description": "AI Influencer image generation model.",
     "capabilities": [
       "text-to-image"
     ],
-    "providers": [
-      "image-higgsfield"
-    ],
     "variants": [
       {
         "key": "default",
@@ -18155,9 +18155,6 @@ var cliAiModelDocs = [
       "text-to-image",
       "image-to-image"
     ],
-    "providers": [
-      "socheap-media"
-    ],
     "variants": [
       {
         "key": "1k",
@@ -18248,9 +18245,6 @@ var cliAiModelDocs = [
       "text-to-image",
       "image-to-image"
     ],
-    "providers": [
-      "socheap-media"
-    ],
     "variants": [
       {
         "key": "standard",
@@ -18331,9 +18325,6 @@ var cliAiModelDocs = [
       "text-to-image",
       "image-to-image"
     ],
-    "providers": [
-      "socheap-media"
-    ],
     "variants": [
       {
         "key": "1k",
@@ -18430,9 +18421,6 @@ var cliAiModelDocs = [
       "text-to-image",
       "image-to-image"
     ],
-    "providers": [
-      "image-kie"
-    ],
     "variants": [
       {
         "key": "default",
@@ -18505,9 +18493,6 @@ var cliAiModelDocs = [
       "text-to-image",
       "image-to-image"
     ],
-    "providers": [
-      "socheap-media"
-    ],
     "variants": [
       {
         "key": "1k",
@@ -18598,9 +18583,6 @@ var cliAiModelDocs = [
       "text-to-video",
       "image-to-video"
     ],
-    "providers": [
-      "socheap-media"
-    ],
     "variants": [
       {
         "key": "4s-720p",
@@ -18860,9 +18842,6 @@ var cliAiModelDocs = [
       "text-to-video",
       "image-to-video"
     ],
-    "providers": [
-      "socheap-media"
-    ],
     "variants": [
       {
         "key": "480p",
@@ -18974,9 +18953,6 @@ var cliAiModelDocs = [
       "text-to-video",
       "image-to-video"
     ],
-    "providers": [
-      "hailuo-comfly"
-    ],
     "variants": [
       {
         "key": "default",
@@ -19030,8 +19006,8 @@ var cliAiModelDocs = [
       }
     ],
     "notes": [
-      "referenceVideo and generationType are not supported by the Hailuo Comfly provider.",
-      "duration=10 with resolution=1080P is rejected by the provider validator."
+      "referenceVideo and generationType are not supported for this model.",
+      "duration=10 with resolution=1080P is not supported."
     ]
   },
   {
@@ -19043,9 +19019,6 @@ var cliAiModelDocs = [
       "text-to-video",
       "image-to-video"
     ],
-    "providers": [
-      "socheap-media"
-    ],
     "variants": [
       {
         "key": "720p",
@@ -19169,9 +19142,6 @@ var cliAiModelDocs = [
     "capabilities": [
       "image-to-video"
     ],
-    "providers": [
-      "fal-ai"
-    ],
     "variants": [
       {
         "key": "default",
@@ -19286,9 +19256,6 @@ var cliAiModelDocs = [
       "text-to-video",
       "image-to-video"
     ],
-    "providers": [
-      "socheap-media"
-    ],
     "variants": [
       {
         "key": "standard-no-sound",
@@ -19431,7 +19398,7 @@ var cliAiModelDocs = [
     ],
     "notes": [
       "generation type is derived from referenceImage count: 0 text, 1 reference, 2 first/last frames.",
-      "referenceVideo, negativePrompt, and elements are not supported on the SoCheap Kling 3.0 path.",
+      "referenceVideo, negativePrompt, and elements are not supported for Kling 3.0.",
       "Use mode=4K for 4K generation; do not pass resolution."
     ]
   },
@@ -19443,9 +19410,6 @@ var cliAiModelDocs = [
     "capabilities": [
       "image-to-video"
     ],
-    "providers": [
-      "socheap-media"
-    ],
     "variants": [
       {
         "key": "standard",
@@ -19566,9 +19530,6 @@ var cliAiModelDocs = [
       "text-to-video",
       "image-to-video"
     ],
-    "providers": [
-      "socheap-media"
-    ],
     "variants": [
       {
         "key": "standard-480p-no-sound",
@@ -19730,9 +19691,6 @@ var cliAiModelDocs = [
       "text-to-video",
       "image-to-video"
     ],
-    "providers": [
-      "socheap-media"
-    ],
     "variants": [
       {
         "key": "standard-480p",
@@ -20016,9 +19974,6 @@ var cliAiModelDocs = [
       "text-to-video",
       "image-to-video"
     ],
-    "providers": [
-      "socheap-media"
-    ],
     "variants": [
       {
         "key": "fast-720p",
@@ -20169,14 +20124,9 @@ var cliAiModelDocs = [
         "description": "Whether the generated video should be extendable when supported."
       },
       {
-        "name": "extendFromTaskId",
+        "name": "extendFromJobId",
         "type": "string",
-        "description": "Provider task id of an existing Veo generation to extend."
-      },
-      {
-        "name": "extendProviderId",
-        "type": "string",
-        "description": "Original provider id for extension lineage. Must be socheap-media for this CLI path."
+        "description": "Spira job ID of an extendable Veo generation owned by the current user."
       }
     ],
     "examples": [
@@ -20196,7 +20146,7 @@ var cliAiModelDocs = [
       "referenceVideo and referenceAudio are not supported.",
       "image_to_video is not a supported generationType; use reference_to_video with one or more referenceImage URLs.",
       "first_last_frames_to_video requires exactly 2 referenceImage URLs.",
-      "extendFromTaskId requires extendProviderId=socheap-media and resolution=720p."
+      "extendFromJobId requires resolution=720p."
     ]
   },
   {
@@ -20205,7 +20155,6 @@ var cliAiModelDocs = [
     mediaType: "audio",
     description: "Suno music generation with simple prompt and custom song modes.",
     capabilities: ["text-to-audio"],
-    providers: ["socheap-media"],
     variants: [
       {
         key: "v5_5",
@@ -20270,7 +20219,6 @@ var cliAiModelDocs = [
     mediaType: "audio",
     description: "ElevenLabs prompt-to-music generation.",
     capabilities: ["text-to-audio"],
-    providers: ["elevenlabs-audio"],
     variants: [
       {
         key: "default",
@@ -20310,7 +20258,6 @@ var cliAiModelDocs = [
     mediaType: "audio",
     description: "ElevenLabs sound-effect generation from an English prompt.",
     capabilities: ["text-to-audio"],
-    providers: ["elevenlabs-audio"],
     variants: [
       {
         key: "default",
@@ -20350,7 +20297,6 @@ var cliAiModelDocs = [
     mediaType: "audio",
     description: "ElevenLabs text-to-speech using an existing voice ID.",
     capabilities: ["text-to-speech"],
-    providers: ["elevenlabs-audio"],
     variants: [
       {
         key: "multilingual-v2-v3",
@@ -20398,7 +20344,6 @@ var cliAiModelDocs = [
     mediaType: "audio",
     description: "Text-to-speech using either an existing voice ID or one reference audio URL.",
     capabilities: ["text-to-speech", "audio-to-speech"],
-    providers: ["elevenlabs-audio"],
     variants: [
       {
         key: "voice-clone-tts",
@@ -20462,8 +20407,9 @@ function getCliAiModelDoc(modelId) {
 }
 
 // src/ai/wait.ts
+var DEFAULT_WAIT_COMMAND = "spira ai jobs create";
 function wait(durationMs) {
-  return new Promise((resolve) => setTimeout(resolve, durationMs));
+  return new Promise((resolve2) => setTimeout(resolve2, durationMs));
 }
 function jobStatus(result) {
   if (!result.data || typeof result.data !== "object") return void 0;
@@ -20481,27 +20427,27 @@ function providerError(result) {
   }
   return void 0;
 }
-function completedResult(result) {
+function completedResult(result, command) {
   return cliResultSchema.parse({
     ...result,
     resultType: "aiJobStatus",
-    command: "spira ai jobs create",
+    command,
     nextActions: []
   });
 }
-function pollingError(result) {
+function pollingError(result, command) {
   return cliResultSchema.parse({
     ...result,
-    command: "spira ai jobs create"
+    command
   });
 }
-function terminalError(result, jobId, status) {
+function terminalError(result, jobId, status, command) {
   const message = providerError(result) ?? `AI job ${jobId} ended with status ${status}.`;
   return cliResultSchema.parse({
     ...result,
     status: "error",
     resultType: "aiJobStatus",
-    command: "spira ai jobs create",
+    command,
     error: {
       code: status === "FAILED" ? "PROVIDER_FAILED" : "ASYNC_STATE",
       message,
@@ -20511,12 +20457,12 @@ function terminalError(result, jobId, status) {
     }
   });
 }
-function timeoutResult(jobId, timeoutMs, lastResult) {
+function timeoutResult(jobId, timeoutMs, command, lastResult) {
   return cliResultSchema.parse({
     object: "cli.result",
     status: "error",
     resultType: "aiJobStatus",
-    command: "spira ai jobs create",
+    command,
     data: lastResult?.data,
     ids: { ...lastResult?.ids, jobId },
     error: {
@@ -20524,16 +20470,19 @@ function timeoutResult(jobId, timeoutMs, lastResult) {
       message: `AI job ${jobId} did not finish within ${timeoutMs}ms.`,
       resource: { type: "aiJob", id: jobId },
       retryable: true,
-      nextActions: [{ label: "Show job status", command: `spira ai jobs status ${jobId}` }]
+      nextActions: [
+        { label: "Keep waiting", command: `spira ai jobs wait ${jobId}` },
+        { label: "Show job status", command: `spira ai jobs status ${jobId}` }
+      ]
     }
   });
 }
-function contractError(result, jobId) {
+function contractError(result, jobId, command) {
   return cliResultSchema.parse({
     ...result,
     status: "error",
     resultType: "aiJobStatus",
-    command: "spira ai jobs create",
+    command,
     error: {
       code: "CONTRACT_MISMATCH",
       message: `AI job ${jobId} status response did not contain a recognized status.`,
@@ -20546,6 +20495,7 @@ function contractError(result, jobId) {
 async function waitForAiJob(input) {
   const now = input.now ?? Date.now;
   const sleep = input.sleep ?? wait;
+  const command = input.command ?? DEFAULT_WAIT_COMMAND;
   const deadline = now() + input.timeoutMs;
   let lastResult;
   let lastStatus;
@@ -20553,19 +20503,19 @@ async function waitForAiJob(input) {
     const result = await input.poll();
     lastResult = result;
     if (result.status === "error") {
-      if (!result.error?.retryable) return pollingError(result);
+      if (!result.error?.retryable) return pollingError(result, command);
     } else {
       const status = jobStatus(result);
       if (status && status !== lastStatus) {
         input.onStatus?.(status);
         lastStatus = status;
       }
-      if (status === "COMPLETED") return completedResult(result);
-      if (status === "FAILED" || status === "CANCELED") return terminalError(result, input.jobId, status);
-      if (status !== "QUEUED" && status !== "RUNNING") return contractError(result, input.jobId);
+      if (status === "COMPLETED") return completedResult(result, command);
+      if (status === "FAILED" || status === "CANCELED") return terminalError(result, input.jobId, status, command);
+      if (status !== "QUEUED" && status !== "RUNNING") return contractError(result, input.jobId, command);
     }
     const remainingMs = deadline - now();
-    if (remainingMs <= 0) return timeoutResult(input.jobId, input.timeoutMs, lastResult);
+    if (remainingMs <= 0) return timeoutResult(input.jobId, input.timeoutMs, command, lastResult);
     await sleep(Math.min(input.intervalMs, remainingMs));
   }
 }
@@ -20895,7 +20845,33 @@ var commandDefinitions = [
     },
     resultType: "aiJobStatus",
     examples: ["spira ai jobs status job_123"],
-    relatedCommands: []
+    relatedCommands: ["spira ai jobs wait <jobId>"]
+  },
+  {
+    path: ["ai", "jobs", "wait"],
+    purpose: "Block until an AI job finishes, then print the final result.",
+    arguments: [{ name: "jobId", description: "AI job ID.", required: true }],
+    options: [
+      {
+        name: "timeout",
+        flag: "--timeout <duration>",
+        description: "Maximum wait duration.",
+        type: "duration",
+        defaultValue: 6e5,
+        minimum: 1e3
+      },
+      {
+        name: "interval",
+        flag: "--interval <duration>",
+        description: "Polling interval while waiting.",
+        type: "duration",
+        defaultValue: 3e3,
+        minimum: 1e3
+      }
+    ],
+    resultType: "aiJobStatus",
+    examples: ["spira ai jobs wait job_123", "spira ai jobs wait job_123 --timeout 20m --interval 5s"],
+    relatedCommands: ["spira ai jobs status <jobId>", "spira ai jobs create"]
   },
   {
     path: ["ai", "models", "list"],
@@ -20921,6 +20897,21 @@ var commandDefinitions = [
     examples: ["spira ai models get nano-banana-2", "spira ai models get seedance-2.0"],
     relatedCommands: ["spira ai jobs create"]
   },
+  {
+    path: ["ai", "models", "providers"],
+    purpose: "List provider routing IDs for AI models; requires admin.access.",
+    permissions: ["admin.access"],
+    arguments: [{ name: "modelId", description: "Optional AI model ID.", required: false }],
+    http: {
+      method: "GET",
+      path: "/api/cli/v1/ai/models/providers",
+      authRequired: true,
+      query: [{ name: "modelId", source: "argument", from: "modelId" }]
+    },
+    resultType: "aiModelProviderList",
+    examples: ["spira ai models providers", "spira ai models providers veo3.1 --json"],
+    relatedCommands: ["spira ai models list", "spira ai jobs create"]
+  },
   {
     path: ["ai", "jobs", "create"],
     purpose: "Create an AI image, video, or audio generation job.",
@@ -20929,9 +20920,8 @@ var commandDefinitions = [
       {
         name: "providerId",
         flag: "--provider-id <providerId>",
-        description: "Advanced routing override.",
-        type: "string",
-        hidden: true
+        description: "Explicit provider routing override; requires admin.access.",
+        type: "string"
       },
       {
         name: "inputsJson",
@@ -20978,7 +20968,12 @@ var commandDefinitions = [
       `spira ai jobs create --model-id nano-banana-2 --inputs-json '{"prompt":"A product photo"}'`,
       `spira ai jobs create --model-id nano-banana-2 --inputs-json '{"prompt":"A product photo"}' --wait`
     ],
-    relatedCommands: ["spira ai jobs status <jobId>", "spira ai models get <modelId>", "spira credits balance"]
+    relatedCommands: [
+      "spira ai jobs wait <jobId>",
+      "spira ai jobs status <jobId>",
+      "spira ai models get <modelId>",
+      "spira credits balance"
+    ]
   },
   {
     path: ["workflows", "list"],
@@ -21347,6 +21342,92 @@ var commandDefinitions = [
     examples: ["spira schedules calendar --from 1781884800000 --to 1782490000000"],
     relatedCommands: ["spira schedules get <scheduleId>"]
   },
+  {
+    path: ["media", "info"],
+    purpose: "Resolve a TikTok / YouTube / Instagram / X / Facebook link and show its metadata.",
+    arguments: [{ name: "url", description: "Public post or video URL.", required: true }],
+    http: {
+      method: "POST",
+      path: "/api/tools/media/info",
+      authRequired: true,
+      body: [{ name: "url", source: "argument", from: "url" }]
+    },
+    resultType: "mediaInfo",
+    examples: [
+      "spira media info https://www.youtube.com/watch?v=dQw4w9WgXcQ",
+      "spira media info https://www.tiktok.com/@user/video/123 --json"
+    ],
+    relatedCommands: ["spira media video <url>", "spira media thumbnail <url>", "spira credits balance"]
+  },
+  {
+    path: ["media", "video"],
+    purpose: "Download the video file behind a social link.",
+    arguments: [{ name: "url", description: "Public post or video URL.", required: true }],
+    options: [
+      {
+        name: "maxHeight",
+        flag: "--max-height <pixels>",
+        description: "Cap the selected format height. Omit for the best available.",
+        type: "number",
+        minimum: 144
+      },
+      {
+        name: "quality",
+        flag: "--quality <mode>",
+        description: "compatible (default) grabs H.264 MP4 that any editor opens; best grabs the highest resolution, which may be WebM/AV1.",
+        type: "string",
+        enumValues: ["compatible", "best"]
+      },
+      {
+        name: "output",
+        flag: "--output <path>",
+        description: "Also save a local copy from the returned URL.",
+        type: "string"
+      }
+    ],
+    http: {
+      method: "POST",
+      path: "/api/tools/media/video",
+      authRequired: true,
+      body: [
+        { name: "url", source: "argument", from: "url" },
+        { name: "maxHeight", source: "option", from: "maxHeight" },
+        { name: "quality", source: "option", from: "quality" }
+      ]
+    },
+    resultType: "mediaAsset",
+    examples: [
+      "spira media video https://www.tiktok.com/@user/video/123",
+      "spira media video https://www.youtube.com/watch?v=dQw4w9WgXcQ --max-height 1080 --output ./downloads/",
+      "spira media video https://www.youtube.com/shorts/abc123 --quality best"
+    ],
+    relatedCommands: ["spira media info <url>", "spira media thumbnail <url>"]
+  },
+  {
+    path: ["media", "thumbnail"],
+    purpose: "Download the cover image behind a social link.",
+    arguments: [{ name: "url", description: "Public post or video URL.", required: true }],
+    options: [
+      {
+        name: "output",
+        flag: "--output <path>",
+        description: "Also save a local copy from the returned URL.",
+        type: "string"
+      }
+    ],
+    http: {
+      method: "POST",
+      path: "/api/tools/media/thumbnail",
+      authRequired: true,
+      body: [{ name: "url", source: "argument", from: "url" }]
+    },
+    resultType: "mediaAsset",
+    examples: [
+      "spira media thumbnail https://x.com/user/status/123",
+      "spira media thumbnail https://www.facebook.com/watch/?v=123 --output ./cover.jpg"
+    ],
+    relatedCommands: ["spira media info <url>", "spira media video <url>"]
+  },
   {
     path: ["dataBase", "glob"],
     purpose: "List files and folders in your Brand database matching a glob pattern.",
@@ -21878,6 +21959,69 @@ async function executeHttpCommand(input) {
   return successResult(input.command, response.body, response.requestId);
 }
 
+// src/media/save.ts
+var import_node_fs = require("node:fs");
+var import_promises3 = require("node:fs/promises");
+var import_node_path3 = require("node:path");
+var import_node_stream = require("node:stream");
+var import_promises4 = require("node:stream/promises");
+function assetRecord(data) {
+  if (!data || typeof data !== "object") return null;
+  const asset = data.asset;
+  return asset && typeof asset === "object" ? asset : null;
+}
+function fileNameFor(asset) {
+  const key = typeof asset.key === "string" ? (0, import_node_path3.basename)(asset.key) : "";
+  if (key) return key;
+  const fromUrl = typeof asset.url === "string" ? (0, import_node_path3.basename)(new URL(asset.url).pathname) : "";
+  return fromUrl || "download";
+}
+async function isDirectory(path) {
+  return (0, import_promises3.stat)(path).then((entry) => entry.isDirectory()).catch(() => false);
+}
+async function resolveTargetPath(output, asset) {
+  const target = (0, import_node_path3.resolve)(output);
+  const looksLikeDirectory = /[\\/]$/.test(output) || await isDirectory(target);
+  return looksLikeDirectory ? (0, import_node_path3.join)(target, fileNameFor(asset)) : target;
+}
+async function writeAssetToDisk(url2, targetPath) {
+  const response = await fetch(url2);
+  if (!response.ok || !response.body) {
+    throw new Error(`Download failed with status ${response.status}.`);
+  }
+  await (0, import_promises3.mkdir)((0, import_node_path3.dirname)(targetPath), { recursive: true });
+  await (0, import_promises4.pipeline)(
+    import_node_stream.Readable.fromWeb(response.body),
+    (0, import_node_fs.createWriteStream)(targetPath)
+  );
+}
+async function saveMediaAsset(result, output) {
+  if (result.status !== "success") return result;
+  const asset = assetRecord(result.data);
+  const url2 = asset && typeof asset.url === "string" ? asset.url : null;
+  if (!asset || !url2) {
+    return cliResultSchema.parse({
+      ...result,
+      warnings: [...result.warnings, "Response contained no downloadable asset URL; nothing was saved locally."]
+    });
+  }
+  try {
+    const targetPath = await resolveTargetPath(output, asset);
+    await writeAssetToDisk(url2, targetPath);
+    return cliResultSchema.parse({
+      ...result,
+      data: { ...result.data, asset: { ...asset, savedTo: targetPath } },
+      impact: [...result.impact, `Saved to ${targetPath}`]
+    });
+  } catch (error51) {
+    const message = error51 instanceof Error && error51.message ? error51.message : "Unknown error.";
+    return cliResultSchema.parse({
+      ...result,
+      warnings: [...result.warnings, `Could not save the file locally: ${message} The asset URL is still available.`]
+    });
+  }
+}
+
 // src/auth/login.ts
 var import_node_crypto = require("node:crypto");
 
@@ -21891,19 +22035,19 @@ function openBrowser(url2) {
   child.unref();
 }
 function closeServer(server) {
-  return new Promise((resolve) => server.close(() => resolve()));
+  return new Promise((resolve2) => server.close(() => resolve2()));
 }
 function startLoopbackCallbackServer(input) {
   const server = (0, import_node_http.createServer)();
   let timer = null;
   let resolveCallback = null;
   let rejectCallback = null;
-  const callback = new Promise((resolve, reject) => {
-    resolveCallback = resolve;
+  const callback = new Promise((resolve2, reject) => {
+    resolveCallback = resolve2;
     rejectCallback = reject;
   });
   const ready = new Promise(
-    (resolve, reject) => {
+    (resolve2, reject) => {
       timer = setTimeout(() => {
         rejectCallback?.(new Error("Timed out waiting for browser callback."));
         void closeServer(server);
@@ -21930,7 +22074,7 @@ function startLoopbackCallbackServer(input) {
           reject(new Error("Failed to start local CLI callback server."));
           return;
         }
-        resolve({
+        resolve2({
           redirectUri: `http://127.0.0.1:${address.port}/callback`,
           waitForCallback: () => callback,
           close: () => closeServer(server)
@@ -22110,20 +22254,18 @@ function dataArray(data) {
 }
 function renderRows(rows, columns) {
   if (rows.length === 0) return "No results.\n";
-  const records = rows.map((row) => row && typeof row === "object" ? row : { value: row });
+  const records = rows.map(
+    (row) => row && typeof row === "object" ? row : { value: row }
+  );
   const widths = columns.map(
-    (column) => Math.min(
-      42,
-      Math.max(
-        column.length,
-        ...records.map((record2) => valueToText(record2[column]).slice(0, 42).length)
-      )
-    )
+    (column) => Math.min(42, Math.max(column.length, ...records.map((record2) => valueToText(record2[column]).slice(0, 42).length)))
   );
   const header = columns.map((column, index) => column.padEnd(widths[index])).join("  ");
   const divider = widths.map((width) => "-".repeat(width)).join("  ");
   const body = records.map(
-    (record2) => columns.map((column, index) => valueToText(record2[column]).replace(/\s+/g, " ").slice(0, widths[index]).padEnd(widths[index])).join("  ")
+    (record2) => columns.map(
+      (column, index) => valueToText(record2[column]).replace(/\s+/g, " ").slice(0, widths[index]).padEnd(widths[index])
+    ).join("  ")
   ).join("\n");
   return `${header}
 ${divider}
@@ -22293,6 +22435,9 @@ function renderAiJobStatus(data) {
 function renderAiModelList(data) {
   return renderRows(dataArray(data), ["id", "mediaType", "creditOptions", "name", "capabilities"]);
 }
+function renderAiModelProviderList(data) {
+  return renderRows(dataArray(data), ["modelId", "name", "providers", "hidden"]);
+}
 function renderAiModelDetail(data) {
   const record2 = objectRecord2(data);
   const fields = Array.isArray(record2.fields) ? record2.fields.map(objectRecord2) : [];
@@ -22393,6 +22538,57 @@ function formatAnchor(anchor) {
   }
   return parts.join(", ") || "-";
 }
+function formatMediaDuration(value) {
+  if (typeof value !== "number" || !Number.isFinite(value) || value < 0) return "-";
+  const total = Math.round(value);
+  const hours = Math.floor(total / 3600);
+  const minutes = Math.floor(total % 3600 / 60);
+  const seconds = total % 60;
+  const padded = `${String(minutes).padStart(hours ? 2 : 1, "0")}:${String(seconds).padStart(2, "0")}`;
+  return hours ? `${hours}:${padded}` : padded;
+}
+function renderMediaInfo(data) {
+  const info = objectRecord2(objectRecord2(data).info);
+  const formats = Array.isArray(info.formats) ? info.formats.map(objectRecord2) : [];
+  const lines = [
+    `platform: ${valueToText(info.platform)}`,
+    `title: ${compactText(info.title)}`,
+    `uploader: ${valueToText(info.uploader ?? info.channel)}`,
+    `duration: ${formatMediaDuration(info.duration)}`,
+    `views: ${valueToText(info.view_count)}`,
+    `likes: ${valueToText(info.like_count)}`,
+    `uploadDate: ${valueToText(info.upload_date)}`,
+    `url: ${valueToText(info.webpage_url ?? info.url)}`,
+    `suggestedFilename: ${valueToText(info.suggested_filename)}`
+  ];
+  if (formats.length === 0) return `${lines.join("\n")}
+`;
+  const rows = formats.filter((format) => format.has_video === true).map((format) => ({
+    format_id: format.format_id,
+    ext: format.ext,
+    resolution: format.resolution,
+    fps: format.fps,
+    size: formatByteSize(format.filesize),
+    audio: format.has_audio === true ? "yes" : "no"
+  }));
+  if (rows.length === 0) return `${lines.join("\n")}
+`;
+  return `${lines.join("\n")}
+videoFormats (${rows.length}):
+${renderRows(rows, ["format_id", "ext", "resolution", "fps", "size", "audio"])}`;
+}
+function renderMediaAsset(data) {
+  const asset = objectRecord2(objectRecord2(data).asset);
+  const lines = [
+    `title: ${compactText(asset.title)}`,
+    `size: ${formatByteSize(asset.size)}`,
+    `contentType: ${valueToText(asset.contentType)}`,
+    `url: ${valueToText(asset.url)}`
+  ];
+  if (asset.savedTo) lines.push(`savedTo: ${valueToText(asset.savedTo)}`);
+  return `${lines.join("\n")}
+`;
+}
 function renderDataBaseGlob(data) {
   const record2 = objectRecord2(data);
   const pattern = valueToText(record2.pattern);
@@ -22512,6 +22708,8 @@ function renderSuccess(result) {
       return renderAiModelList(result.data);
     case "aiModelDetail":
       return renderAiModelDetail(result.data);
+    case "aiModelProviderList":
+      return renderAiModelProviderList(result.data);
     case "workflowList":
       return renderRows(dataArray(result.data), ["id", "name", "creatorName", "nodeTypes", "updatedAt"]);
     case "workflowNodeCatalog":
@@ -22527,7 +22725,18 @@ function renderSuccess(result) {
     case "scheduleOccurrenceList":
       return renderRows(dataArray(result.data), ["id", "scheduleId", "scheduledAt", "status", "executorType"]);
     case "scheduleExecutionList":
-      return renderRows(dataArray(result.data), ["id", "scheduleId", "status", "originalScheduledAt", "startedAt", "finishedAt"]);
+      return renderRows(dataArray(result.data), [
+        "id",
+        "scheduleId",
+        "status",
+        "originalScheduledAt",
+        "startedAt",
+        "finishedAt"
+      ]);
+    case "mediaInfo":
+      return renderMediaInfo(result.data);
+    case "mediaAsset":
+      return renderMediaAsset(result.data);
     case "dataBaseGlob":
       return renderDataBaseGlob(result.data);
     case "dataBaseRead":
@@ -22865,12 +23074,12 @@ function renderCommandIndex() {
 `;
 }
 async function packageVersion() {
-  if ("0.0.8".length > 0) {
-    return "0.0.8";
+  if ("0.0.10".length > 0) {
+    return "0.0.10";
   }
   try {
     const packageUrl = new URL("../package.json", import_meta.url);
-    const pkg = JSON.parse(await (0, import_promises3.readFile)(packageUrl, "utf8"));
+    const pkg = JSON.parse(await (0, import_promises5.readFile)(packageUrl, "utf8"));
     return pkg.version ?? "0.0.0";
   } catch {
     return "0.0.0";
@@ -23073,6 +23282,25 @@ ${url2}
       poll: () => executeHttpCommand({ command: statusCommand, args: { jobId }, options: {} })
     });
   }
+  if (commandKey(definition.path) === "ai jobs wait") {
+    const statusCommand = findCommandDefinition(["ai", "jobs", "status"]);
+    if (!statusCommand) throw new Error("AI job status command is not registered.");
+    const jobId = args.jobId;
+    return waitForAiJob({
+      jobId,
+      command: "spira ai jobs wait",
+      timeoutMs: options.timeout,
+      intervalMs: options.interval,
+      onStatus: (status) => output.error(`AI job ${jobId}: ${status}
+`),
+      poll: () => executeHttpCommand({ command: statusCommand, args: { jobId }, options: {} })
+    });
+  }
+  if (commandKey(definition.path) === "media video" || commandKey(definition.path) === "media thumbnail") {
+    const downloaded = await executeHttpCommand({ command: definition, args, options });
+    if (typeof options.output !== "string" || options.output.length === 0) return downloaded;
+    return saveMediaAsset(downloaded, options.output);
+  }
   return executeHttpCommand({ command: definition, args, options });
 }
 function addLeafCommand(root, definition, output) {
@@ -23098,7 +23326,7 @@ function addLeafCommand(root, definition, output) {
     output.write(
       renderResult(result, {
         json: Boolean(options.json),
-        compactAiJobWait: commandKey(definition.path) === "ai jobs create" && options.wait === true
+        compactAiJobWait: commandKey(definition.path) === "ai jobs create" && options.wait === true || commandKey(definition.path) === "ai jobs wait"
       })
     );
     if (result.status === "error") process.exitCode = 1;

package/package.json

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