deepline 0.1.145 → 0.1.146

package/dist/bundling-sources/sdk/src/release.ts

@@ -101,10 +101,10 @@ export const SDK_RELEASE = {
   // 0.1.108 ships explicit dataset column/tool recompute policy and removes
   // the SDK enrich generator's one-second stale policy.
   // 0.1.110 ships authored V2 prebuilts and required top-level play descriptions.
-  version: '0.1.145',
+  version: '0.1.146',
   apiContract: '2026-06-dataset-column-cell-stale-hard-cutover',
   supportPolicy: {
-    latest: '0.1.145',
+    latest: '0.1.146',
     minimumSupported: '0.1.53',
     deprecatedBelow: '0.1.53',
     commandMinimumSupported: [

package/dist/cli/index.js

@@ -619,10 +619,10 @@ var SDK_RELEASE = {
   // 0.1.108 ships explicit dataset column/tool recompute policy and removes
   // the SDK enrich generator's one-second stale policy.
   // 0.1.110 ships authored V2 prebuilts and required top-level play descriptions.
-  version: "0.1.145",
+  version: "0.1.146",
   apiContract: "2026-06-dataset-column-cell-stale-hard-cutover",
   supportPolicy: {
-    latest: "0.1.145",
+    latest: "0.1.146",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -18946,6 +18946,221 @@ Examples:
   }
 }
 
+// src/cli/commands/monitors.ts
+var FORBIDDEN_AS_API_ERROR = { forbiddenAsApiError: true };
+function buildHttpClient() {
+  return new HttpClient(resolveConfig());
+}
+function parseJsonObjectArg(raw, flag) {
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch (error) {
+    throw new Error(
+      `${flag} must be a JSON object. ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new Error(`${flag} must be a JSON object.`);
+  }
+  return parsed;
+}
+function encodeKey(key) {
+  return encodeURIComponent(key);
+}
+async function handleMonitorsTools(options) {
+  const http = buildHttpClient();
+  const params = new URLSearchParams();
+  if (options.provider) params.set("provider", options.provider);
+  if (options.tool) params.set("tool", options.tool);
+  if (options.search) params.set("search", options.search);
+  if (options.limit) params.set("limit", options.limit);
+  const query = params.toString();
+  const payload = await http.request(
+    `/api/v2/monitors/tools${query ? `?${query}` : ""}`,
+    { method: "GET", ...FORBIDDEN_AS_API_ERROR }
+  );
+  printCommandEnvelope(payload, { json: options.json });
+}
+async function handleMonitorsCheck(definition, options) {
+  const http = buildHttpClient();
+  const body = parseJsonObjectArg(definition, "--definition");
+  const payload = await http.request(
+    "/api/v2/monitors/check",
+    { method: "POST", body, ...FORBIDDEN_AS_API_ERROR }
+  );
+  printCommandEnvelope(payload, { json: options.json });
+}
+async function handleMonitorsDeploy(definition, options) {
+  const http = buildHttpClient();
+  const body = parseJsonObjectArg(definition, "--definition");
+  const payload = await http.request(
+    "/api/v2/monitors/deploy",
+    { method: "POST", body, ...FORBIDDEN_AS_API_ERROR }
+  );
+  printCommandEnvelope(payload, { json: options.json });
+}
+async function handleDeployedList(options) {
+  const http = buildHttpClient();
+  const params = new URLSearchParams();
+  if (options.status) params.set("status", options.status);
+  if (options.limit) params.set("limit", options.limit);
+  const query = params.toString();
+  const payload = await http.request(
+    `/api/v2/monitors/deployed${query ? `?${query}` : ""}`,
+    { method: "GET", ...FORBIDDEN_AS_API_ERROR }
+  );
+  printCommandEnvelope(payload, { json: options.json });
+}
+async function handleDeployedGet(key, options) {
+  const http = buildHttpClient();
+  const payload = await http.request(
+    `/api/v2/monitors/deployed/${encodeKey(key)}`,
+    { method: "GET", ...FORBIDDEN_AS_API_ERROR }
+  );
+  printCommandEnvelope(payload, { json: options.json });
+}
+async function handleDeployedDelete(key, options) {
+  const http = buildHttpClient();
+  const params = new URLSearchParams();
+  if (options.localOnly) params.set("local_only", "true");
+  const query = params.toString();
+  const payload = await http.request(
+    `/api/v2/monitors/deployed/${encodeKey(key)}${query ? `?${query}` : ""}`,
+    { method: "DELETE", ...FORBIDDEN_AS_API_ERROR }
+  );
+  printCommandEnvelope(payload, { json: options.json });
+}
+async function handleDeployedUpdate(key, patch, options) {
+  const http = buildHttpClient();
+  const body = parseJsonObjectArg(patch, "<patch>");
+  const payload = await http.request(
+    `/api/v2/monitors/deployed/${encodeKey(key)}`,
+    { method: "PATCH", body, ...FORBIDDEN_AS_API_ERROR }
+  );
+  printCommandEnvelope(payload, { json: options.json });
+}
+async function handleReactivate(key, options) {
+  const http = buildHttpClient();
+  const payload = await http.request(
+    `/api/v2/monitors/deployed/${encodeKey(key)}/reactivate`,
+    { method: "POST", body: {}, ...FORBIDDEN_AS_API_ERROR }
+  );
+  printCommandEnvelope(payload, { json: options.json });
+}
+function registerMonitorsCommands(program) {
+  const monitors = program.command("monitors").description("Discover, deploy, and manage Deepline monitors.").addHelpText(
+    "after",
+    `
+Notes:
+  Monitors are provider-backed signal feeds that deliver events into your
+  workspace. Access is granted by a Deepline admin via Admin -> Rollouts; until
+  then these commands return a clear monitor_access_required error.
+
+Examples:
+  deepline monitors tools --json
+  deepline monitors check '{"key":"my-monitor","tool":"...","payload":{}}'
+  deepline monitors deploy '{"key":"my-monitor","tool":"...","payload":{}}'
+  deepline monitors deployed --json
+  deepline monitors deployed get my-monitor --json
+  deepline monitors reactivate my-monitor --json
+`
+  );
+  monitors.command("tools").description("List or describe the monitor tools available to your org.").addHelpText(
+    "after",
+    `
+Notes:
+  Read-only. Filter the catalog with --provider, --tool, --search, or --limit.
+  Pass --tool to describe a single monitor tool.
+
+Examples:
+  deepline monitors tools
+  deepline monitors tools --provider theirstack --json
+  deepline monitors tools --tool theirstack_jobs --json
+`
+  ).option("--provider <provider>", "Filter by provider").option("--tool <tool>", "Describe a single monitor tool by id").option("--search <query>", "Search monitor tools by text").option("--limit <n>", "Limit the number of monitor tools returned").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleMonitorsTools);
+  monitors.command("check <definition>").description("Validate a monitor definition without deploying it.").addHelpText(
+    "after",
+    `
+Notes:
+  Read-only validation. <definition> is a JSON object with key, tool, payload,
+  and optional controls. Does not deploy or spend credits.
+
+Examples:
+  deepline monitors check '{"key":"my-monitor","tool":"theirstack_jobs","payload":{}}'
+`
+  ).option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleMonitorsCheck);
+  monitors.command("deploy <definition>").description("Deploy a monitor from a definition.").addHelpText(
+    "after",
+    `
+Notes:
+  Mutates workspace state and may spend Deepline credits. <definition> is a JSON
+  object with key, tool, payload, and optional controls.
+
+Examples:
+  deepline monitors deploy '{"key":"my-monitor","tool":"theirstack_jobs","payload":{}}'
+`
+  ).option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleMonitorsDeploy);
+  monitors.command("reactivate <key>").description("Reactivate a previously disabled deployed monitor.").addHelpText(
+    "after",
+    `
+Notes:
+  Mutates workspace state and may spend Deepline credits.
+
+Examples:
+  deepline monitors reactivate my-monitor --json
+`
+  ).option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleReactivate);
+  const deployed = monitors.command("deployed").description("List and manage your deployed monitors.").addHelpText(
+    "after",
+    `
+Notes:
+  With no subcommand, lists deployed monitors. Use get/update/delete to manage a
+  single monitor by its public key.
+
+Examples:
+  deepline monitors deployed --json
+  deepline monitors deployed --status all --json
+  deepline monitors deployed get my-monitor --json
+`
+  ).option("--status <status>", 'Filter by monitor status (or "all")').option("--limit <n>", "Limit the number of deployed monitors returned").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleDeployedList);
+  deployed.command("get <key>").description("Show a single deployed monitor by its public key.").addHelpText(
+    "after",
+    `
+Notes:
+  Read-only.
+
+Examples:
+  deepline monitors deployed get my-monitor --json
+`
+  ).option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleDeployedGet);
+  deployed.command("update <key> <patch>").description("Update a deployed monitor by its public key.").addHelpText(
+    "after",
+    `
+Notes:
+  Mutates workspace state. <patch> is a JSON object of fields to update.
+
+Examples:
+  deepline monitors deployed update my-monitor '{"controls":{"enabled":false}}' --json
+`
+  ).option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleDeployedUpdate);
+  deployed.command("delete <key>").description("Delete a deployed monitor by its public key.").addHelpText(
+    "after",
+    `
+Notes:
+  Mutates workspace state. By default deprovisions the upstream provider
+  resource; pass --local-only to remove only the Deepline-managed record.
+
+Examples:
+  deepline monitors deployed delete my-monitor --json
+  deepline monitors deployed delete my-monitor --local-only --json
+`
+  ).option(
+    "--local-only",
+    "Remove only the Deepline-managed record, leaving the upstream resource"
+  ).option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleDeployedDelete);
+}
+
 // src/cli/commands/org.ts
 async function fetchOrganizations(http, apiKey) {
   return http.post("/api/v2/auth/cli/organizations", { api_key: apiKey });
@@ -23991,6 +24206,7 @@ Exit codes:
   registerWorkflowCommands(program);
   registerSecretsCommands(program);
   registerBillingCommands(program);
+  registerMonitorsCommands(program);
   registerOrgCommands(program);
   registerEnrichCommand(program);
   registerCsvCommands(program);

package/dist/cli/index.mjs

@@ -604,10 +604,10 @@ var SDK_RELEASE = {
   // 0.1.108 ships explicit dataset column/tool recompute policy and removes
   // the SDK enrich generator's one-second stale policy.
   // 0.1.110 ships authored V2 prebuilts and required top-level play descriptions.
-  version: "0.1.145",
+  version: "0.1.146",
   apiContract: "2026-06-dataset-column-cell-stale-hard-cutover",
   supportPolicy: {
-    latest: "0.1.145",
+    latest: "0.1.146",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -18970,6 +18970,221 @@ Examples:
   }
 }
 
+// src/cli/commands/monitors.ts
+var FORBIDDEN_AS_API_ERROR = { forbiddenAsApiError: true };
+function buildHttpClient() {
+  return new HttpClient(resolveConfig());
+}
+function parseJsonObjectArg(raw, flag) {
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch (error) {
+    throw new Error(
+      `${flag} must be a JSON object. ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new Error(`${flag} must be a JSON object.`);
+  }
+  return parsed;
+}
+function encodeKey(key) {
+  return encodeURIComponent(key);
+}
+async function handleMonitorsTools(options) {
+  const http = buildHttpClient();
+  const params = new URLSearchParams();
+  if (options.provider) params.set("provider", options.provider);
+  if (options.tool) params.set("tool", options.tool);
+  if (options.search) params.set("search", options.search);
+  if (options.limit) params.set("limit", options.limit);
+  const query = params.toString();
+  const payload = await http.request(
+    `/api/v2/monitors/tools${query ? `?${query}` : ""}`,
+    { method: "GET", ...FORBIDDEN_AS_API_ERROR }
+  );
+  printCommandEnvelope(payload, { json: options.json });
+}
+async function handleMonitorsCheck(definition, options) {
+  const http = buildHttpClient();
+  const body = parseJsonObjectArg(definition, "--definition");
+  const payload = await http.request(
+    "/api/v2/monitors/check",
+    { method: "POST", body, ...FORBIDDEN_AS_API_ERROR }
+  );
+  printCommandEnvelope(payload, { json: options.json });
+}
+async function handleMonitorsDeploy(definition, options) {
+  const http = buildHttpClient();
+  const body = parseJsonObjectArg(definition, "--definition");
+  const payload = await http.request(
+    "/api/v2/monitors/deploy",
+    { method: "POST", body, ...FORBIDDEN_AS_API_ERROR }
+  );
+  printCommandEnvelope(payload, { json: options.json });
+}
+async function handleDeployedList(options) {
+  const http = buildHttpClient();
+  const params = new URLSearchParams();
+  if (options.status) params.set("status", options.status);
+  if (options.limit) params.set("limit", options.limit);
+  const query = params.toString();
+  const payload = await http.request(
+    `/api/v2/monitors/deployed${query ? `?${query}` : ""}`,
+    { method: "GET", ...FORBIDDEN_AS_API_ERROR }
+  );
+  printCommandEnvelope(payload, { json: options.json });
+}
+async function handleDeployedGet(key, options) {
+  const http = buildHttpClient();
+  const payload = await http.request(
+    `/api/v2/monitors/deployed/${encodeKey(key)}`,
+    { method: "GET", ...FORBIDDEN_AS_API_ERROR }
+  );
+  printCommandEnvelope(payload, { json: options.json });
+}
+async function handleDeployedDelete(key, options) {
+  const http = buildHttpClient();
+  const params = new URLSearchParams();
+  if (options.localOnly) params.set("local_only", "true");
+  const query = params.toString();
+  const payload = await http.request(
+    `/api/v2/monitors/deployed/${encodeKey(key)}${query ? `?${query}` : ""}`,
+    { method: "DELETE", ...FORBIDDEN_AS_API_ERROR }
+  );
+  printCommandEnvelope(payload, { json: options.json });
+}
+async function handleDeployedUpdate(key, patch, options) {
+  const http = buildHttpClient();
+  const body = parseJsonObjectArg(patch, "<patch>");
+  const payload = await http.request(
+    `/api/v2/monitors/deployed/${encodeKey(key)}`,
+    { method: "PATCH", body, ...FORBIDDEN_AS_API_ERROR }
+  );
+  printCommandEnvelope(payload, { json: options.json });
+}
+async function handleReactivate(key, options) {
+  const http = buildHttpClient();
+  const payload = await http.request(
+    `/api/v2/monitors/deployed/${encodeKey(key)}/reactivate`,
+    { method: "POST", body: {}, ...FORBIDDEN_AS_API_ERROR }
+  );
+  printCommandEnvelope(payload, { json: options.json });
+}
+function registerMonitorsCommands(program) {
+  const monitors = program.command("monitors").description("Discover, deploy, and manage Deepline monitors.").addHelpText(
+    "after",
+    `
+Notes:
+  Monitors are provider-backed signal feeds that deliver events into your
+  workspace. Access is granted by a Deepline admin via Admin -> Rollouts; until
+  then these commands return a clear monitor_access_required error.
+
+Examples:
+  deepline monitors tools --json
+  deepline monitors check '{"key":"my-monitor","tool":"...","payload":{}}'
+  deepline monitors deploy '{"key":"my-monitor","tool":"...","payload":{}}'
+  deepline monitors deployed --json
+  deepline monitors deployed get my-monitor --json
+  deepline monitors reactivate my-monitor --json
+`
+  );
+  monitors.command("tools").description("List or describe the monitor tools available to your org.").addHelpText(
+    "after",
+    `
+Notes:
+  Read-only. Filter the catalog with --provider, --tool, --search, or --limit.
+  Pass --tool to describe a single monitor tool.
+
+Examples:
+  deepline monitors tools
+  deepline monitors tools --provider theirstack --json
+  deepline monitors tools --tool theirstack_jobs --json
+`
+  ).option("--provider <provider>", "Filter by provider").option("--tool <tool>", "Describe a single monitor tool by id").option("--search <query>", "Search monitor tools by text").option("--limit <n>", "Limit the number of monitor tools returned").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleMonitorsTools);
+  monitors.command("check <definition>").description("Validate a monitor definition without deploying it.").addHelpText(
+    "after",
+    `
+Notes:
+  Read-only validation. <definition> is a JSON object with key, tool, payload,
+  and optional controls. Does not deploy or spend credits.
+
+Examples:
+  deepline monitors check '{"key":"my-monitor","tool":"theirstack_jobs","payload":{}}'
+`
+  ).option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleMonitorsCheck);
+  monitors.command("deploy <definition>").description("Deploy a monitor from a definition.").addHelpText(
+    "after",
+    `
+Notes:
+  Mutates workspace state and may spend Deepline credits. <definition> is a JSON
+  object with key, tool, payload, and optional controls.
+
+Examples:
+  deepline monitors deploy '{"key":"my-monitor","tool":"theirstack_jobs","payload":{}}'
+`
+  ).option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleMonitorsDeploy);
+  monitors.command("reactivate <key>").description("Reactivate a previously disabled deployed monitor.").addHelpText(
+    "after",
+    `
+Notes:
+  Mutates workspace state and may spend Deepline credits.
+
+Examples:
+  deepline monitors reactivate my-monitor --json
+`
+  ).option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleReactivate);
+  const deployed = monitors.command("deployed").description("List and manage your deployed monitors.").addHelpText(
+    "after",
+    `
+Notes:
+  With no subcommand, lists deployed monitors. Use get/update/delete to manage a
+  single monitor by its public key.
+
+Examples:
+  deepline monitors deployed --json
+  deepline monitors deployed --status all --json
+  deepline monitors deployed get my-monitor --json
+`
+  ).option("--status <status>", 'Filter by monitor status (or "all")').option("--limit <n>", "Limit the number of deployed monitors returned").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleDeployedList);
+  deployed.command("get <key>").description("Show a single deployed monitor by its public key.").addHelpText(
+    "after",
+    `
+Notes:
+  Read-only.
+
+Examples:
+  deepline monitors deployed get my-monitor --json
+`
+  ).option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleDeployedGet);
+  deployed.command("update <key> <patch>").description("Update a deployed monitor by its public key.").addHelpText(
+    "after",
+    `
+Notes:
+  Mutates workspace state. <patch> is a JSON object of fields to update.
+
+Examples:
+  deepline monitors deployed update my-monitor '{"controls":{"enabled":false}}' --json
+`
+  ).option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleDeployedUpdate);
+  deployed.command("delete <key>").description("Delete a deployed monitor by its public key.").addHelpText(
+    "after",
+    `
+Notes:
+  Mutates workspace state. By default deprovisions the upstream provider
+  resource; pass --local-only to remove only the Deepline-managed record.
+
+Examples:
+  deepline monitors deployed delete my-monitor --json
+  deepline monitors deployed delete my-monitor --local-only --json
+`
+  ).option(
+    "--local-only",
+    "Remove only the Deepline-managed record, leaving the upstream resource"
+  ).option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleDeployedDelete);
+}
+
 // src/cli/commands/org.ts
 async function fetchOrganizations(http, apiKey) {
   return http.post("/api/v2/auth/cli/organizations", { api_key: apiKey });
@@ -24030,6 +24245,7 @@ Exit codes:
   registerWorkflowCommands(program);
   registerSecretsCommands(program);
   registerBillingCommands(program);
+  registerMonitorsCommands(program);
   registerOrgCommands(program);
   registerEnrichCommand(program);
   registerCsvCommands(program);

package/dist/index.js

@@ -418,10 +418,10 @@ var SDK_RELEASE = {
   // 0.1.108 ships explicit dataset column/tool recompute policy and removes
   // the SDK enrich generator's one-second stale policy.
   // 0.1.110 ships authored V2 prebuilts and required top-level play descriptions.
-  version: "0.1.145",
+  version: "0.1.146",
   apiContract: "2026-06-dataset-column-cell-stale-hard-cutover",
   supportPolicy: {
-    latest: "0.1.145",
+    latest: "0.1.146",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [

package/dist/index.mjs

@@ -348,10 +348,10 @@ var SDK_RELEASE = {
   // 0.1.108 ships explicit dataset column/tool recompute policy and removes
   // the SDK enrich generator's one-second stale policy.
   // 0.1.110 ships authored V2 prebuilts and required top-level play descriptions.
-  version: "0.1.145",
+  version: "0.1.146",
   apiContract: "2026-06-dataset-column-cell-stale-hard-cutover",
   supportPolicy: {
-    latest: "0.1.145",
+    latest: "0.1.146",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.1.145",
+  "version": "0.1.146",
   "description": "Deepline SDK + CLI — B2B data enrichment powered by durable cloud execution",
   "license": "MIT",
   "repository": {