deepline 0.1.271 → 0.1.272

package/dist/index.js

@@ -57,6 +57,7 @@ __export(src_exports, {
   SDK_API_CONTRACT: () => SDK_API_CONTRACT,
   SDK_VERSION: () => SDK_VERSION,
   defineInput: () => defineInput,
+  defineMonitor: () => defineMonitor,
   definePlay: () => definePlay,
   defineWorkflow: () => defineWorkflow,
   extractSummaryFields: () => extractSummaryFields,
@@ -437,7 +438,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.272",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -2644,6 +2645,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.
    *
@@ -2679,6 +2682,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() {
@@ -4541,6 +4556,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.
    *
@@ -4560,6 +4705,37 @@ var DeeplineClient = class {
   }
 };
 
+// src/monitors.ts
+function defineMonitor(definition) {
+  if (!definition || typeof definition !== "object") {
+    throw new Error("defineMonitor(definition) requires a definition object.");
+  }
+  const key = typeof definition.key === "string" ? definition.key.trim() : "";
+  if (!key) {
+    throw new Error('defineMonitor(definition) requires a non-empty "key".');
+  }
+  const tool = typeof definition.tool === "string" ? definition.tool.trim() : "";
+  if (!tool) {
+    throw new Error(
+      'defineMonitor(definition) requires a non-empty monitor tool id in "tool" (e.g. "deepline_native.company_radar").'
+    );
+  }
+  if (!definition.payload || typeof definition.payload !== "object" || Array.isArray(definition.payload)) {
+    throw new Error(
+      'defineMonitor(definition) requires "payload" to be a JSON object.'
+    );
+  }
+  if (definition.name !== void 0 && typeof definition.name !== "string") {
+    throw new Error('defineMonitor(definition) "name" must be a string.');
+  }
+  if (definition.controls !== void 0 && (typeof definition.controls !== "object" || Array.isArray(definition.controls))) {
+    throw new Error(
+      'defineMonitor(definition) "controls" must be a JSON object.'
+    );
+  }
+  return definition;
+}
+
 // ../shared_libs/plays/bootstrap-routes.ts
 var DEEPLINE_TOOL_CATEGORIES = [
   "company_search",
@@ -6792,6 +6968,7 @@ function extractSummaryFields(payload) {
   SDK_API_CONTRACT,
   SDK_VERSION,
   defineInput,
+  defineMonitor,
   definePlay,
   defineWorkflow,
   extractSummaryFields,

package/dist/index.mjs

@@ -367,7 +367,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.272",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -2574,6 +2574,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.
    *
@@ -2609,6 +2611,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() {
@@ -4471,6 +4485,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.
    *
@@ -4490,6 +4634,37 @@ var DeeplineClient = class {
   }
 };
 
+// src/monitors.ts
+function defineMonitor(definition) {
+  if (!definition || typeof definition !== "object") {
+    throw new Error("defineMonitor(definition) requires a definition object.");
+  }
+  const key = typeof definition.key === "string" ? definition.key.trim() : "";
+  if (!key) {
+    throw new Error('defineMonitor(definition) requires a non-empty "key".');
+  }
+  const tool = typeof definition.tool === "string" ? definition.tool.trim() : "";
+  if (!tool) {
+    throw new Error(
+      'defineMonitor(definition) requires a non-empty monitor tool id in "tool" (e.g. "deepline_native.company_radar").'
+    );
+  }
+  if (!definition.payload || typeof definition.payload !== "object" || Array.isArray(definition.payload)) {
+    throw new Error(
+      'defineMonitor(definition) requires "payload" to be a JSON object.'
+    );
+  }
+  if (definition.name !== void 0 && typeof definition.name !== "string") {
+    throw new Error('defineMonitor(definition) "name" must be a string.');
+  }
+  if (definition.controls !== void 0 && (typeof definition.controls !== "object" || Array.isArray(definition.controls))) {
+    throw new Error(
+      'defineMonitor(definition) "controls" must be a JSON object.'
+    );
+  }
+  return definition;
+}
+
 // ../shared_libs/plays/bootstrap-routes.ts
 var DEEPLINE_TOOL_CATEGORIES = [
   "company_search",
@@ -6727,6 +6902,7 @@ export {
   SDK_API_CONTRACT,
   SDK_VERSION,
   defineInput,
+  defineMonitor,
   definePlay,
   defineWorkflow,
   extractSummaryFields,

package/package.json

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