@signaliz/cli 1.0.81 → 1.0.84

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 the Signaliz 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"
@@ -68,6 +69,16 @@ signaliz awareness delete --domain acme.com
 signaliz flow --signal-query "companies with recent hiring" \
   --campaign-offer "pipeline intelligence"
 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,10 @@ 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 run --build-id BLD-... [--input request.json] [--idempotency-key <key>]
+  signaliz builds status --run-id <uuid> [--limit 100]
 
 Access and connection:
   signaliz auth login
@@ -1619,6 +1623,9 @@ async function flow() {
   if (!signalQuery || !campaignOffer) {
     fail('Usage: signaliz flow --signal-query "companies with recent hiring" --campaign-offer "your offer" [--limit 5]');
   }
+  if (hasFlag("dry-run")) {
+    throw new CliInputError("Signaliz Flow starts immediately; --dry-run is no longer supported.");
+  }
   const removedFlowControls = [
     "after-date",
     "before-date",
@@ -1660,16 +1667,6 @@ async function flow() {
   requireIntegerInRange(request.signalLimit, "limit", 1, 25);
   requireIntegerInRange(request.lookbackDays, "lookbackDays", 1, 365);
   requireIntegerInRange(request.peoplePerCompany, "peoplePerCompany", 1, 5);
-  if (hasFlag("dry-run")) {
-    const result2 = await createClient().startFlow({ ...request, dryRun: true });
-    output(result2, () => {
-      process.stdout.write(`Signaliz Flow plan: up to ${result2.plan.maximumReviewCandidates} review candidates. No work was dispatched.
-`);
-      for (const safeguard of result2.plan.safeguards) process.stdout.write(`- ${safeguard}
-`);
-    });
-    return;
-  }
   const result = await createClient().startFlow(request);
   output(result, () => process.stdout.write(`Signaliz Flow started: ${result.runId}
 Check status: signaliz flow --run-id ${result.runId}
@@ -1951,6 +1948,83 @@ 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(`Fixed price: ${result.build.fixed_credits_per_run} Signaliz credits/run (${result.build.clay_credits_budget_per_run} Clay-credit budget)
+`);
+      if (result.build.delivery_notes) process.stdout.write(`${result.build.delivery_notes}
+`);
+    });
+    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"));
+    output(result, () => {
+      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}
+`);
+      if (result.run.error) process.stdout.write(`Error: ${result.run.error}
+`);
+    });
+    return;
+  }
+  throw new CliInputError("Usage: signaliz builds list|get|run|status");
+}
 async function main() {
   const [, , command, ...args] = process.argv;
   if (!command || ["help", "--help", "-h"].includes(command)) {
@@ -1974,6 +2048,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.81",
-  "description": "Signaliz CLI for Company Signal Enrichment, Signals First, Signal Awareness, Signal to Copy AI, and Signaliz Flow.",
+  "version": "1.0.84",
+  "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.88"
   },
   "devDependencies": {
     "tsup": "^8.0.0",