deepline 0.1.271 → 0.1.273

package/dist/cli/index.mjs

@@ -703,7 +703,7 @@ var SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: "0.1.271",
+  version: "0.1.273",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -2910,6 +2910,8 @@ var DeeplineClient = class {
   db;
   /** Billing namespace: subscription status/cancel and invoice history. */
   billing;
+  /** Monitors namespace: access, catalog, deploy/check, and lifecycle. */
+  monitors;
   /**
    * Create a low-level SDK client.
    *
@@ -2945,6 +2947,18 @@ var DeeplineClient = class {
         list: (options2) => this.listBillingInvoices(options2)
       }
     };
+    this.monitors = {
+      status: () => this.getMonitorsAccess(),
+      available: (toolIdOrOptions, options2) => this.getMonitorsAvailable(toolIdOrOptions, options2),
+      check: (definition) => this.checkMonitor(definition),
+      deploy: (definition, options2) => this.deployMonitor(definition, options2),
+      list: (options2) => this.listMonitors(options2),
+      get: (key) => this.getMonitor(key),
+      dependents: (key) => this.getMonitorDependents(key),
+      update: (key, patch) => this.updateMonitor(key, patch),
+      delete: (key, options2) => this.deleteMonitor(key, options2),
+      reactivate: (key, options2) => this.reactivateMonitor(key, options2)
+    };
   }
   /** The resolved base URL this client is targeting (e.g. `"http://localhost:3000"`). */
   get baseUrl() {
@@ -4807,6 +4821,136 @@ var DeeplineClient = class {
       `/api/v2/billing/invoices${suffix}`
     );
   }
+  // ——————————————————————————————————————————————————————————
+  // Monitors
+  // ——————————————————————————————————————————————————————————
+  /**
+   * Whether the current workspace can use Deepline Monitors. Reachable without
+   * monitor access; a denial is a normal 200 body, not a 403. Prefer
+   * `client.monitors.status()`.
+   */
+  async getMonitorsAccess() {
+    const payload = await this.http.request(
+      "/api/v2/monitors/access",
+      { method: "GET" }
+    );
+    return {
+      has_access: payload.has_access === true,
+      ...typeof payload.reason === "string" && payload.reason.trim() ? { reason: payload.reason.trim() } : {}
+    };
+  }
+  /**
+   * The deployable monitor tools catalog. Pass a tool id (positional or
+   * `{ tool }`) to describe one tool's full payload/stream contract, or no tool
+   * id for the compact inventory. Prefer `client.monitors.available(...)`.
+   */
+  async getMonitorsAvailable(toolIdOrOptions, maybeOptions) {
+    const positionalTool = typeof toolIdOrOptions === "string" ? toolIdOrOptions : void 0;
+    const options = toolIdOrOptions && typeof toolIdOrOptions === "object" ? toolIdOrOptions : maybeOptions ?? {};
+    const optionTool = toolIdOrOptions && typeof toolIdOrOptions === "object" ? toolIdOrOptions.tool : void 0;
+    const tool = positionalTool ?? optionTool;
+    const params = new URLSearchParams();
+    if (options.provider) params.set("provider", options.provider);
+    if (tool) params.set("tool", tool);
+    if (options.search) params.set("search", options.search);
+    if (options.limit !== void 0) params.set("limit", String(options.limit));
+    const compactList = !tool && options.full !== true;
+    if (compactList || options.compact) params.set("compact", "true");
+    const query = params.toString();
+    const suffix = query ? `?${query}` : "";
+    return this.http.request(
+      `/api/v2/monitors/tools${suffix}`,
+      { method: "GET", forbiddenAsApiError: true }
+    );
+  }
+  /** Validate a monitor definition without deploying it. Prefer `client.monitors.check(...)`. */
+  async checkMonitor(definition) {
+    return this.http.request("/api/v2/monitors/check", {
+      method: "POST",
+      body: definition,
+      forbiddenAsApiError: true
+    });
+  }
+  /**
+   * Deploy a monitor from a definition. `dryRun` validates via the check
+   * endpoint and returns the plan without deploying. Prefer
+   * `client.monitors.deploy(...)`.
+   */
+  async deployMonitor(definition, options) {
+    if (options?.dryRun) {
+      return this.http.request("/api/v2/monitors/check", {
+        method: "POST",
+        body: definition,
+        forbiddenAsApiError: true
+      });
+    }
+    return this.http.request("/api/v2/monitors/deploy", {
+      method: "POST",
+      body: definition,
+      forbiddenAsApiError: true
+    });
+  }
+  /** List deployed monitors. Prefer `client.monitors.list(...)`. */
+  async listMonitors(options) {
+    const params = new URLSearchParams();
+    if (options?.status) params.set("status", options.status);
+    if (options?.limit !== void 0) params.set("limit", String(options.limit));
+    if (options?.cursor) params.set("cursor", options.cursor);
+    if (options?.compact) params.set("compact", "true");
+    const query = params.toString();
+    const suffix = query ? `?${query}` : "";
+    return this.http.request(
+      `/api/v2/monitors/deployed${suffix}`,
+      { method: "GET", forbiddenAsApiError: true }
+    );
+  }
+  /** Fetch one deployed monitor by public key. Prefer `client.monitors.get(...)`. */
+  async getMonitor(key) {
+    return this.http.request(
+      `/api/v2/monitors/deployed/${encodeURIComponent(key)}`,
+      { method: "GET", forbiddenAsApiError: true }
+    );
+  }
+  /** Published plays depending on one monitor. Prefer `client.monitors.dependents(...)`. */
+  async getMonitorDependents(key) {
+    return this.http.request(
+      `/api/v2/monitors/deployed/${encodeURIComponent(key)}/dependents`,
+      { method: "GET", forbiddenAsApiError: true }
+    );
+  }
+  /** Update a deployed monitor by public key. Prefer `client.monitors.update(...)`. */
+  async updateMonitor(key, patch) {
+    return this.http.request(
+      `/api/v2/monitors/deployed/${encodeURIComponent(key)}`,
+      { method: "PATCH", body: patch, forbiddenAsApiError: true }
+    );
+  }
+  /**
+   * Delete a deployed monitor by public key. Deprovisions the upstream provider
+   * resource unless `localOnly`; `dryRun` returns the delete plan. Prefer
+   * `client.monitors.delete(...)`.
+   */
+  async deleteMonitor(key, options) {
+    const params = new URLSearchParams();
+    if (options?.localOnly) params.set("local_only", "true");
+    if (options?.dryRun) params.set("dry_run", "true");
+    const query = params.toString();
+    return this.http.request(
+      `/api/v2/monitors/deployed/${encodeURIComponent(key)}${query ? `?${query}` : ""}`,
+      { method: "DELETE", forbiddenAsApiError: true }
+    );
+  }
+  /**
+   * Reactivate a disabled monitor. `dryRun` returns the reactivation cost.
+   * Prefer `client.monitors.reactivate(...)`.
+   */
+  async reactivateMonitor(key, options) {
+    const query = options?.dryRun ? "?dry_run=true" : "";
+    return this.http.request(
+      `/api/v2/monitors/deployed/${encodeURIComponent(key)}/reactivate${query}`,
+      { method: "POST", body: {}, forbiddenAsApiError: true }
+    );
+  }
   /**
    * Check API connectivity and server health.
    *
@@ -24309,15 +24453,11 @@ Examples:
 // src/cli/commands/monitors.ts
 import { readFileSync as readFileSync9 } from "fs";
 import { createInterface } from "readline/promises";
-var FORBIDDEN_AS_API_ERROR = { forbiddenAsApiError: true };
 var JSON_OPTION_DESCRIPTION = "Emit JSON output. Also automatic when stdout is piped";
 function withJsonOption(command) {
   return command.option("--json", JSON_OPTION_DESCRIPTION);
 }
 var COMPACT_OPTION_DESCRIPTION = "Ask the server for high-signal fields only (smaller output for agent loops)";
-function buildHttpClient() {
-  return new HttpClient(resolveConfig());
-}
 var MonitorsUsageError = class extends Error {
   code = "MONITORS_USAGE_ERROR";
   constructor(message) {
@@ -24458,9 +24598,6 @@ or from a file / stdin:
   cat monitor.json | ${input2.command} --file -`
   );
 }
-function encodeKey(key) {
-  return encodeURIComponent(key);
-}
 function asRecord(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : null;
 }
@@ -24654,11 +24791,7 @@ Preview the plan first with:
   );
 }
 async function handleMonitorsStatus(options) {
-  const http = buildHttpClient();
-  const payload = await http.request(
-    "/api/v2/monitors/access",
-    { method: "GET" }
-  );
+  const payload = await new DeeplineClient().monitors.status();
   const hasAccess = payload.has_access === true;
   const reason = typeof payload.reason === "string" && payload.reason.trim() ? payload.reason.trim() : void 0;
   const text = hasAccess ? `\u2713 You have access to Deepline Monitors${reason ? `
@@ -24720,6 +24853,9 @@ function renderAvailableToolsText(payload) {
 `;
 }
 async function handleMonitorsAvailable(toolId, options) {
+  process.stderr.write(
+    "`deepline monitors available` is deprecated.\n  Browse types:    deepline tools list --categories monitors\n  Inspect a type:  deepline tools get <monitor-type>\n"
+  );
   if (toolId !== void 0 && options.tool !== void 0) {
     if (toolId !== options.tool) {
       throw new MonitorsUsageError(
@@ -24728,19 +24864,13 @@ async function handleMonitorsAvailable(toolId, options) {
     }
   }
   const tool = toolId ?? options.tool;
-  const http = buildHttpClient();
-  const params = new URLSearchParams();
-  if (options.provider) params.set("provider", options.provider);
-  if (tool) params.set("tool", tool);
-  if (options.search) params.set("search", options.search);
-  if (options.limit) params.set("limit", options.limit);
-  const compactList = !tool && !options.full;
-  if (compactList || options.compact) params.set("compact", "true");
-  const query = params.toString();
-  const payload = await http.request(
-    `/api/v2/monitors/tools${query ? `?${query}` : ""}`,
-    { method: "GET", ...FORBIDDEN_AS_API_ERROR }
-  );
+  const payload = await new DeeplineClient().monitors.available(tool, {
+    ...options.provider ? { provider: options.provider } : {},
+    ...options.search ? { search: options.search } : {},
+    ...options.limit ? { limit: options.limit } : {},
+    ...options.full ? { full: true } : {},
+    ...options.compact ? { compact: true } : {}
+  });
   printCommandEnvelope(payload, {
     json: options.json,
     // Human list view shows id + name + deployed_count ("deployed: N") so
@@ -24752,9 +24882,9 @@ async function handleMonitorsAvailable(toolId, options) {
 function renderDeployedListText(payload, requestedStatus) {
   const monitors = Array.isArray(payload.monitors) ? payload.monitors : null;
   if (!monitors) return void 0;
-  const lines = [
-    monitors.length === 0 ? "No deployed monitors matched." : `Deployed monitors (${monitors.length}):`
-  ];
+  const total = asFiniteNumber(payload.total);
+  const header = monitors.length === 0 ? "No deployed monitors matched." : total !== void 0 && total > monitors.length ? `Deployed monitors (${monitors.length} of ${total}):` : `Deployed monitors (${monitors.length}):`;
+  const lines = [header];
   for (const raw of monitors) {
     const entry = asRecord(raw);
     const key = entry ? asString(entry.key) ?? asString(entry.monitor_key) : void 0;
@@ -24770,6 +24900,13 @@ function renderDeployedListText(payload, requestedStatus) {
   lines.push(
     `Status filter: ${applied}${requestedStatus === void 0 && applied === "active" ? " (default)" : ""} \u2014 use --status all to include disabled monitors.`
   );
+  if (payload.is_truncated === true) {
+    const nextCursor = asString(payload.next_cursor);
+    lines.push(
+      total !== void 0 ? `List truncated \u2014 showing ${monitors.length} of ${total}. Before concluding "no matching monitor exists," page the full registry:` : 'List truncated. Before concluding "no matching monitor exists," page the full registry:',
+      nextCursor ? `  deepline monitors list${requestedStatus ? ` --status ${requestedStatus}` : ""} --cursor ${nextCursor}` : "  raise --limit above the reported total."
+    );
+  }
   if (monitors.length > 0) {
     lines.push("", "Inspect one: deepline monitors get <key> --json");
   }
@@ -24777,48 +24914,42 @@ function renderDeployedListText(payload, requestedStatus) {
 `;
 }
 async function handleMonitorsList(options) {
-  const http = buildHttpClient();
-  const params = new URLSearchParams();
-  if (options.status) params.set("status", options.status);
-  if (options.limit) params.set("limit", options.limit);
-  if (options.compact) params.set("compact", "true");
-  const query = params.toString();
-  const payload = await http.request(
-    `/api/v2/monitors/deployed${query ? `?${query}` : ""}`,
-    { method: "GET", ...FORBIDDEN_AS_API_ERROR }
-  );
+  const payload = await new DeeplineClient().monitors.list({
+    ...options.status ? { status: options.status } : {},
+    ...options.limit ? { limit: options.limit } : {},
+    ...options.cursor ? { cursor: options.cursor } : {},
+    ...options.compact ? { compact: true } : {}
+  });
   printCommandEnvelope(payload, {
     json: options.json,
     text: renderDeployedListText(payload, options.status)
   });
 }
 async function handleMonitorsCheck(definition, options) {
-  const http = buildHttpClient();
   const body = resolveMonitorJsonBody({
     positional: definition,
     file: options.file,
     argLabel: "<definition>",
     command: "deepline monitors check"
   });
-  const payload = await http.request(
-    "/api/v2/monitors/check",
-    { method: "POST", body, ...FORBIDDEN_AS_API_ERROR }
+  const payload = await new DeeplineClient().monitors.check(
+    body
   );
   printCommandEnvelope(payload, { json: options.json });
 }
 async function handleMonitorsDeploy(definition, options) {
-  const http = buildHttpClient();
   const body = resolveMonitorJsonBody({
     positional: definition,
     file: options.file,
     argLabel: "<definition>",
     command: "deepline monitors deploy"
   });
+  const client2 = new DeeplineClient();
+  const definitionArg = body;
   if (options.dryRun) {
-    const payload2 = await http.request(
-      "/api/v2/monitors/check",
-      { method: "POST", body, ...FORBIDDEN_AS_API_ERROR }
-    );
+    const payload2 = await client2.monitors.deploy(definitionArg, {
+      dryRun: true
+    });
     const valid = payload2.valid !== false;
     printCommandEnvelope(
       { dry_run: true, ...payload2 },
@@ -24829,10 +24960,7 @@ async function handleMonitorsDeploy(definition, options) {
     }
     return;
   }
-  const payload = await http.request(
-    "/api/v2/monitors/deploy",
-    { method: "POST", body, ...FORBIDDEN_AS_API_ERROR }
-  );
+  const payload = await client2.monitors.deploy(definitionArg);
   printCommandEnvelope(payload, {
     json: options.json,
     text: renderMonitorDeployCompletion(payload)
@@ -24881,15 +25009,9 @@ function renderMonitorGet(payload) {
 `;
 }
 async function handleMonitorsGet(key, options) {
-  const http = buildHttpClient();
-  const payload = await http.request(
-    `/api/v2/monitors/deployed/${encodeKey(key)}`,
-    { method: "GET", ...FORBIDDEN_AS_API_ERROR }
-  );
-  const dependents = await http.request(
-    `/api/v2/monitors/deployed/${encodeKey(key)}/dependents`,
-    { method: "GET", ...FORBIDDEN_AS_API_ERROR }
-  );
+  const client2 = new DeeplineClient();
+  const payload = await client2.monitors.get(key);
+  const dependents = await client2.monitors.dependents(key);
   const detail = { ...payload, dependents };
   printCommandEnvelope(detail, {
     json: options.json,
@@ -24912,15 +25034,12 @@ async function confirmMonitorDelete(key, options) {
   }
 }
 async function handleMonitorsDelete(key, options) {
-  const http = buildHttpClient();
-  const params = new URLSearchParams();
-  if (options.localOnly) params.set("local_only", "true");
+  const client2 = new DeeplineClient();
   if (options.dryRun) {
-    params.set("dry_run", "true");
-    const payload2 = await http.request(
-      `/api/v2/monitors/deployed/${encodeKey(key)}?${params.toString()}`,
-      { method: "DELETE", ...FORBIDDEN_AS_API_ERROR }
-    );
+    const payload2 = await client2.monitors.delete(key, {
+      ...options.localOnly ? { localOnly: true } : {},
+      dryRun: true
+    });
     assertMonitorDryRunAcknowledged(payload2, {
       command: "deepline monitors delete",
       mutation: "delete"
@@ -24948,34 +25067,25 @@ async function handleMonitorsDelete(key, options) {
       return;
     }
   }
-  const query = params.toString();
-  const payload = await http.request(
-    `/api/v2/monitors/deployed/${encodeKey(key)}${query ? `?${query}` : ""}`,
-    { method: "DELETE", ...FORBIDDEN_AS_API_ERROR }
-  );
+  const payload = await client2.monitors.delete(key, {
+    ...options.localOnly ? { localOnly: true } : {}
+  });
   printCommandEnvelope(payload, { json: options.json });
 }
 async function handleMonitorsUpdate(key, patch, options) {
-  const http = buildHttpClient();
   const body = resolveMonitorJsonBody({
     positional: patch,
     file: options.file,
     argLabel: "<patch>",
     command: `deepline monitors update ${key}`
   });
-  const payload = await http.request(
-    `/api/v2/monitors/deployed/${encodeKey(key)}`,
-    { method: "PATCH", body, ...FORBIDDEN_AS_API_ERROR }
-  );
+  const payload = await new DeeplineClient().monitors.update(key, body);
   printCommandEnvelope(payload, { json: options.json });
 }
 async function handleMonitorsReactivate(key, options) {
-  const http = buildHttpClient();
+  const client2 = new DeeplineClient();
   if (options.dryRun) {
-    const payload2 = await http.request(
-      `/api/v2/monitors/deployed/${encodeKey(key)}/reactivate?dry_run=true`,
-      { method: "POST", body: {}, ...FORBIDDEN_AS_API_ERROR }
-    );
+    const payload2 = await client2.monitors.reactivate(key, { dryRun: true });
     assertMonitorDryRunAcknowledged(payload2, {
       command: "deepline monitors reactivate",
       mutation: "reactivate"
@@ -24986,10 +25096,7 @@ async function handleMonitorsReactivate(key, options) {
     });
     return;
   }
-  const payload = await http.request(
-    `/api/v2/monitors/deployed/${encodeKey(key)}/reactivate`,
-    { method: "POST", body: {}, ...FORBIDDEN_AS_API_ERROR }
-  );
+  const payload = await client2.monitors.reactivate(key);
   printCommandEnvelope(payload, { json: options.json });
 }
 function registerMonitorsCommands(program) {
@@ -25078,17 +25185,24 @@ Examples:
 Notes:
   Read-only. --status filters by monitor status: active (default), disabled, or
   all. The output echoes the status filter that was applied. --compact returns
-  high-signal fields only.
+  high-signal fields only. The response reports total (the true registry count,
+  not the page size), returned, is_truncated, and next_cursor. When is_truncated
+  is true, page with --cursor <next_cursor> until it is false \u2014 a "no matching
+  monitor" reuse conclusion off a truncated page deploys a duplicate paid feed.
 
 Examples:
   deepline monitors list
   deepline monitors list --status all --json
+  deepline monitors list --status all --cursor <next_cursor> --json
   deepline monitors list --compact --json
 `
     ).option(
       "--status <status>",
       "Filter by monitor status: active (default), disabled, or all"
-    ).option("--limit <n>", "Limit the number of deployed monitors returned").option("--compact", COMPACT_OPTION_DESCRIPTION)
+    ).option("--limit <n>", "Limit the number of deployed monitors returned").option(
+      "--cursor <cursor>",
+      "Page past a truncated result using the next_cursor from a prior list response"
+    ).option("--compact", COMPACT_OPTION_DESCRIPTION)
   ).action(monitorsAction(handleMonitorsList));
   withJsonOption(
     monitors.command("get <key>").description("Show a single deployed monitor by its public key.").addHelpText(
@@ -25209,7 +25323,10 @@ Examples:
     monitors.command("deployed", { hidden: true }).description("Alias of `monitors list` (plus get/update/delete aliases).").option(
       "--status <status>",
       "Filter by monitor status: active (default), disabled, or all"
-    ).option("--limit <n>", "Limit the number of deployed monitors returned").option("--compact", COMPACT_OPTION_DESCRIPTION)
+    ).option("--limit <n>", "Limit the number of deployed monitors returned").option(
+      "--cursor <cursor>",
+      "Page past a truncated result using the next_cursor from a prior list response"
+    ).option("--compact", COMPACT_OPTION_DESCRIPTION)
   ).action(monitorsAction(handleMonitorsList));
   withJsonOption(
     deployed.command("get <key>").description("Alias of `monitors get <key>`.")