@signaliz/cli 1.0.82 → 1.0.85

package/README.md

@@ -1,7 +1,7 @@
 # @signaliz/cli
 
-The Signaliz CLI exposes all five core products, plus Signal Awareness and
-Signaliz Flow through the same public contract:
+The Signaliz CLI exposes all five core products, Signal Awareness,
+Signaliz Flow, and delivered managed builds through one public contract:
 
 ```bash
 npm install -g @signaliz/cli
@@ -19,6 +19,7 @@ signaliz auth login
 # https://api.signaliz.com/functions/v1/api/v1/signal-awareness/companies/delete
 # https://api.signaliz.com/functions/v1/api/v1/signal-awareness/companies/schedule
 # https://api.signaliz.com/functions/v1/api/v1/flow
+# https://api.signaliz.com/functions/v1/api/v1/managed-builds
 # The same contracts are available under /api/v2/.
 
 signaliz find-email --company-domain example.com --full-name "Jane Doe"
@@ -70,6 +71,14 @@ signaliz flow --signal-query "companies with recent hiring" \
 signaliz flow --run-id run_... --json
 # Keep polling the returned run ID until status is completed or failed.
 # Flow leaves generated copy in review and never sends outreach.
+
+# Delivered GTM Contractor builds publish their Clay budget and fixed
+# Signaliz-credit price before each reusable run.
+signaliz builds list
+signaliz builds get --build-id BLD-A1B2C3D4E5F6
+signaliz builds run --build-id BLD-A1B2C3D4E5F6 \
+  --input request.json --idempotency-key customer-run-001
+signaliz builds status --run-id 11111111-1111-4111-8111-111111111111 --json
 ```
 
 Use `--json` with any product command for structured output.

package/dist/bin.js

@@ -17,7 +17,7 @@ var CONFIG_DIR = (0, import_node_path.join)((0, import_node_os.homedir)(), ".sig
 var CONFIG_FILE = (0, import_node_path.join)(CONFIG_DIR, "config.json");
 var HELP = `Signaliz CLI
 
-Six product commands:
+Product commands:
   signaliz find-email --linkedin-url https://www.linkedin.com/in/jane-doe [--no-wait]
   signaliz find-email --company-domain example.com --full-name "Jane Doe" [--no-wait]
   signaliz find-email --run-id run_...  Resume an existing Find Email run without duplicate spend
@@ -50,6 +50,12 @@ Six product commands:
   signaliz awareness schedule --domain acme.com --schedule daily|weekly|monthly
   signaliz flow --signal-query "companies with recent hiring" --campaign-offer "..." [--limit 5] [--lookback-days 90] [--people-titles "CEO,VP Sales"]
   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 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
@@ -1944,6 +1950,126 @@ async function awareness(args) {
   output(result, () => process.stdout.write(`Monitor deleted: ${monitorId || domain}
 `));
 }
+function readManagedBuildInput() {
+  const source = flag("input");
+  if (!source) return {};
+  let raw;
+  try {
+    raw = source.trim().startsWith("{") ? source.trim() : (0, import_node_fs.readFileSync)(source === "-" ? 0 : source, "utf8").trim();
+  } catch (error) {
+    throw new CliInputError(`Unable to read managed-build input: ${error instanceof Error ? error.message : String(error)}`);
+  }
+  try {
+    const parsed = JSON.parse(raw);
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) throw new Error("input must be one JSON object");
+    return parsed;
+  } catch (error) {
+    throw new CliInputError(`Managed-build input must be valid JSON: ${error instanceof Error ? error.message : String(error)}`);
+  }
+}
+async function managedBuilds(args) {
+  const action = args[0] || "list";
+  const client = createClient();
+  if (action === "list") {
+    const result = await client.listManagedBuilds();
+    output(result, () => {
+      if (!result.builds.length) return process.stdout.write("No Final Build systems are assigned to this workspace.\n");
+      for (const build of result.builds) {
+        process.stdout.write(`${build.build_id}	${build.name}	${build.fixed_credits_per_run} credits/run
+`);
+      }
+    });
+    return;
+  }
+  if (action === "get") {
+    const buildId = flag("build-id");
+    if (!buildId) throw new CliInputError("signaliz builds get requires --build-id BLD-...");
+    const result = await client.getManagedBuild(buildId);
+    output(result, () => {
+      process.stdout.write(`${result.build.build_id} \u2014 ${result.build.name}
+`);
+      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 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})
+`);
+      process.stdout.write(`Check results: signaliz builds status --run-id ${result.run.run_id}
+`);
+    });
+    return;
+  }
+  if (action === "status") {
+    const runId = flag("run-id");
+    if (!runId) throw new CliInputError("signaliz builds status requires --run-id <uuid>");
+    const limit = numberFlag("limit") ?? 100;
+    requireIntegerInRange(limit, "--limit", 1, 500);
+    const result = await client.getManagedBuildRun(runId, limit);
+    output(result, () => {
+      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;
+  }
+  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;
   if (!command || ["help", "--help", "-h"].includes(command)) {
@@ -1967,6 +2093,8 @@ async function main() {
       return awareness(args);
     case "flow":
       return flow();
+    case "builds":
+      return managedBuilds(args);
     case "signal-to-copy":
       return signalToCopy();
     case "health":

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@signaliz/cli",
-  "version": "1.0.82",
-  "description": "Signaliz CLI for Company Signal Enrichment, Signals First, Signal Awareness, Signal to Copy AI, and Signaliz Flow.",
+  "version": "1.0.85",
+  "description": "Signaliz CLI for core products, Signal Awareness, Signaliz Flow, and reusable managed builds.",
   "bin": {
     "signaliz": "dist/bin.js"
   },
@@ -11,7 +11,7 @@
   ],
   "scripts": {
     "build": "tsup src/bin.ts --format cjs --clean",
-    "test": "npm run build && node tests/help.test.cjs",
+    "test": "npm run build && node tests/help.test.cjs && node tests/managed-builds.test.cjs",
     "prepublishOnly": "npm run build"
   },
   "keywords": [
@@ -29,7 +29,7 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@signaliz/sdk": "^1.0.83"
+    "@signaliz/sdk": "^1.0.89"
   },
   "devDependencies": {
     "tsup": "^8.0.0",