@spira-lab/cli 0.0.8 → 0.0.9

package/dist/index.cjs

@@ -18048,6 +18048,7 @@ var cliResultTypeSchema = external_exports.enum([
   "aiJobAction",
   "aiModelList",
   "aiModelDetail",
+  "aiModelProviderList",
   "workflowList",
   "workflowNodeCatalog",
   "workflowDetail",
@@ -18083,16 +18084,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 +18153,6 @@ var cliAiModelDocs = [
       "text-to-image",
       "image-to-image"
     ],
-    "providers": [
-      "socheap-media"
-    ],
     "variants": [
       {
         "key": "1k",
@@ -18248,9 +18243,6 @@ var cliAiModelDocs = [
       "text-to-image",
       "image-to-image"
     ],
-    "providers": [
-      "socheap-media"
-    ],
     "variants": [
       {
         "key": "standard",
@@ -18331,9 +18323,6 @@ var cliAiModelDocs = [
       "text-to-image",
       "image-to-image"
     ],
-    "providers": [
-      "socheap-media"
-    ],
     "variants": [
       {
         "key": "1k",
@@ -18430,9 +18419,6 @@ var cliAiModelDocs = [
       "text-to-image",
       "image-to-image"
     ],
-    "providers": [
-      "image-kie"
-    ],
     "variants": [
       {
         "key": "default",
@@ -18505,9 +18491,6 @@ var cliAiModelDocs = [
       "text-to-image",
       "image-to-image"
     ],
-    "providers": [
-      "socheap-media"
-    ],
     "variants": [
       {
         "key": "1k",
@@ -18598,9 +18581,6 @@ var cliAiModelDocs = [
       "text-to-video",
       "image-to-video"
     ],
-    "providers": [
-      "socheap-media"
-    ],
     "variants": [
       {
         "key": "4s-720p",
@@ -18860,9 +18840,6 @@ var cliAiModelDocs = [
       "text-to-video",
       "image-to-video"
     ],
-    "providers": [
-      "socheap-media"
-    ],
     "variants": [
       {
         "key": "480p",
@@ -18974,9 +18951,6 @@ var cliAiModelDocs = [
       "text-to-video",
       "image-to-video"
     ],
-    "providers": [
-      "hailuo-comfly"
-    ],
     "variants": [
       {
         "key": "default",
@@ -19030,8 +19004,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 +19017,6 @@ var cliAiModelDocs = [
       "text-to-video",
       "image-to-video"
     ],
-    "providers": [
-      "socheap-media"
-    ],
     "variants": [
       {
         "key": "720p",
@@ -19169,9 +19140,6 @@ var cliAiModelDocs = [
     "capabilities": [
       "image-to-video"
     ],
-    "providers": [
-      "fal-ai"
-    ],
     "variants": [
       {
         "key": "default",
@@ -19286,9 +19254,6 @@ var cliAiModelDocs = [
       "text-to-video",
       "image-to-video"
     ],
-    "providers": [
-      "socheap-media"
-    ],
     "variants": [
       {
         "key": "standard-no-sound",
@@ -19431,7 +19396,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 +19408,6 @@ var cliAiModelDocs = [
     "capabilities": [
       "image-to-video"
     ],
-    "providers": [
-      "socheap-media"
-    ],
     "variants": [
       {
         "key": "standard",
@@ -19566,9 +19528,6 @@ var cliAiModelDocs = [
       "text-to-video",
       "image-to-video"
     ],
-    "providers": [
-      "socheap-media"
-    ],
     "variants": [
       {
         "key": "standard-480p-no-sound",
@@ -19730,9 +19689,6 @@ var cliAiModelDocs = [
       "text-to-video",
       "image-to-video"
     ],
-    "providers": [
-      "socheap-media"
-    ],
     "variants": [
       {
         "key": "standard-480p",
@@ -20016,9 +19972,6 @@ var cliAiModelDocs = [
       "text-to-video",
       "image-to-video"
     ],
-    "providers": [
-      "socheap-media"
-    ],
     "variants": [
       {
         "key": "fast-720p",
@@ -20169,14 +20122,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 +20144,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 +20153,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 +20217,6 @@ var cliAiModelDocs = [
     mediaType: "audio",
     description: "ElevenLabs prompt-to-music generation.",
     capabilities: ["text-to-audio"],
-    providers: ["elevenlabs-audio"],
     variants: [
       {
         key: "default",
@@ -20310,7 +20256,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 +20295,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 +20342,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,6 +20405,7 @@ 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));
 }
@@ -20481,27 +20425,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 +20455,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 +20468,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 +20493,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 +20501,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 +20843,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 +20895,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 +20918,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 +20966,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"],
@@ -22110,20 +22103,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 +22284,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) : [];
@@ -22512,6 +22506,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 +22523,14 @@ 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 "dataBaseGlob":
       return renderDataBaseGlob(result.data);
     case "dataBaseRead":
@@ -22865,8 +22868,8 @@ function renderCommandIndex() {
 `;
 }
 async function packageVersion() {
-  if ("0.0.8".length > 0) {
-    return "0.0.8";
+  if ("0.0.9".length > 0) {
+    return "0.0.9";
   }
   try {
     const packageUrl = new URL("../package.json", import_meta.url);
@@ -23069,6 +23072,20 @@ ${url2}
       timeoutMs: options.waitTimeout,
       intervalMs: options.waitInterval,
       onStatus: (status) => output.error(`AI job ${jobId}: ${status}
+`),
+      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: {} })
     });
@@ -23098,7 +23115,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.9",
   "description": "Command line client for Spira.",
   "type": "module",
   "bin": {