@signaliz/cli 1.0.84 → 1.0.85

package/README.md

@@ -1,6 +1,6 @@
 # @signaliz/cli
 
-The Signaliz CLI exposes the Signaliz core products, Signal Awareness,
+The Signaliz CLI exposes all five core products, Signal Awareness,
 Signaliz Flow, and delivered managed builds through one public contract:
 
 ```bash

package/dist/bin.js

@@ -52,8 +52,10 @@ Product commands:
   signaliz flow --run-id run_...  Read a durable Flow checkpoint without dispatching new work
   signaliz builds list
   signaliz builds get --build-id BLD-...
-  signaliz builds run --build-id BLD-... [--input request.json] [--idempotency-key <key>]
+  signaliz builds quote --build-id BLD-... [--input request.json]
+  signaliz builds run --build-id BLD-... [--input request.json] --confirm-spend --max-credits <number> [--idempotency-key <key>]
   signaliz builds status --run-id <uuid> [--limit 100]
+  signaliz builds download --run-id <uuid> --out results.csv
 
 Access and connection:
   signaliz auth login
@@ -1986,18 +1988,44 @@ async function managedBuilds(args) {
     output(result, () => {
       process.stdout.write(`${result.build.build_id} \u2014 ${result.build.name}
 `);
-      process.stdout.write(`Fixed price: ${result.build.fixed_credits_per_run} Signaliz credits/run (${result.build.clay_credits_budget_per_run} Clay-credit budget)
+      process.stdout.write(`Base price: ${result.build.fixed_credits_per_run} Signaliz credits for ${result.build.included_records_per_run} included record(s)
+`);
+      process.stdout.write(`Additional records: ${result.build.additional_record_credits} Signaliz credits each \xB7 max ${result.build.max_records_per_run}
+`);
+      process.stdout.write(`Estimated Clay use: ${result.build.clay_credits_budget_per_run} base + ${result.build.additional_clay_credits_per_record} per additional record
 `);
       if (result.build.delivery_notes) process.stdout.write(`${result.build.delivery_notes}
 `);
     });
     return;
   }
+  if (action === "quote") {
+    const buildId = flag("build-id");
+    if (!buildId) throw new CliInputError("signaliz builds quote requires --build-id BLD-...");
+    const result = await client.quoteManagedBuildRun(buildId, readManagedBuildInput());
+    output(result, () => {
+      process.stdout.write(`${result.quote.item_count} record(s): ${result.quote.total_signaliz_credits} Signaliz credits
+`);
+      process.stdout.write(`Estimated Clay consumption: ${result.quote.estimated_clay_credits} credits
+`);
+      process.stdout.write("No run created and no credits charged.\n");
+    });
+    return;
+  }
   if (action === "run") {
     const buildId = flag("build-id");
     if (!buildId) throw new CliInputError("signaliz builds run requires --build-id BLD-...");
-    const result = await client.runManagedBuild(buildId, readManagedBuildInput(), flag("idempotency-key"));
+    const maxCredits = numberFlag("max-credits");
+    if (!hasFlag("confirm-spend") || maxCredits === void 0) {
+      throw new CliInputError("Live managed-build runs require --confirm-spend and --max-credits <number>. Use builds quote first.");
+    }
+    const result = await client.runManagedBuild(buildId, readManagedBuildInput(), {
+      idempotencyKey: flag("idempotency-key"),
+      confirmSpend: true,
+      maxCredits
+    });
     output(result, () => {
+      if (!result.run) throw new CliInputError(result.message || "Managed build was not queued.");
       process.stdout.write(`Managed build queued: ${result.run.run_id}
 `);
       process.stdout.write(`Charged: ${result.run.fixed_credits_charged} Signaliz credits (${result.run.billing_status})
@@ -2017,13 +2045,30 @@ async function managedBuilds(args) {
       process.stdout.write(`${result.run.build_id} run ${result.run.run_id}: ${result.run.status}
 `);
       process.stdout.write(`Results returned: ${result.returned || 0}
+`);
+      const csv = result.artifacts?.csv?.download_url;
+      if (csv) process.stdout.write(`CSV: ${csv}
 `);
       if (result.run.error) process.stdout.write(`Error: ${result.run.error}
 `);
     });
     return;
   }
-  throw new CliInputError("Usage: signaliz builds list|get|run|status");
+  if (action === "download") {
+    const runId = flag("run-id");
+    const out = flag("out");
+    if (!runId || !out) throw new CliInputError("signaliz builds download requires --run-id <uuid> --out results.csv");
+    const result = await client.getManagedBuildRun(runId, 1);
+    const url = result.artifacts?.csv?.download_url;
+    if (!url) throw new CliInputError("This run does not have a CSV artifact yet. Check builds status first.");
+    const response = await fetch(url);
+    if (!response.ok) throw new Error(`CSV download failed (HTTP ${response.status}).`);
+    (0, import_node_fs.writeFileSync)(out, Buffer.from(await response.arrayBuffer()));
+    output({ success: true, run_id: runId, path: out }, () => process.stdout.write(`Saved ${out}
+`));
+    return;
+  }
+  throw new CliInputError("Usage: signaliz builds list|get|quote|run|status|download");
 }
 async function main() {
   const [, , command, ...args] = process.argv;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signaliz/cli",
-  "version": "1.0.84",
+  "version": "1.0.85",
   "description": "Signaliz CLI for core products, Signal Awareness, Signaliz Flow, and reusable managed builds.",
   "bin": {
     "signaliz": "dist/bin.js"
@@ -29,7 +29,7 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@signaliz/sdk": "^1.0.88"
+    "@signaliz/sdk": "^1.0.89"
   },
   "devDependencies": {
     "tsup": "^8.0.0",