deepline 0.2.2 → 0.2.4

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

@@ -686,6 +686,13 @@ export type MonitorListEntry = {
   status?: string;
   tool?: string;
   name?: string;
+  configured?: boolean;
+  active?: boolean;
+  provider?: string;
+  output_table?: string | null;
+  webhook_state?: string;
+  last_received_event?: string | null;
+  bound_plays?: Array<Record<string, unknown>>;
   [key: string]: unknown;
 };
 
@@ -756,6 +763,8 @@ export type MonitorUpdateResult = {
 };
 export type MonitorDeleteResult = Record<string, unknown>;
 export type MonitorReactivateResult = Record<string, unknown>;
+export type MonitorTestResult = Record<string, unknown>;
+export type MonitorValidateResult = Record<string, unknown>;
 
 /**
  * Public monitors namespace exposed as `client.monitors`.
@@ -791,6 +800,12 @@ export type MonitorsNamespace = {
   list: (options?: MonitorsListOptions) => Promise<MonitorsListResult>;
   /** Fetch one deployed monitor by public key (without dependents). */
   get: (key: string) => Promise<MonitorDetail>;
+  /** Send an explicit payload through the deployed monitor's normal webhook path. */
+  test: (
+    key: string,
+    payload: Record<string, unknown>,
+  ) => Promise<MonitorTestResult>;
+  validate: (key: string) => Promise<MonitorValidateResult>;
   /** List the published plays depending on one monitor's output streams. */
   dependents: (key: string) => Promise<MonitorDependents>;
   /** Update a deployed monitor by public key. */
@@ -1489,6 +1504,8 @@ export class DeeplineClient {
       deploy: (definition, options) => this.deployMonitor(definition, options),
       list: (options) => this.listMonitors(options),
       get: (key) => this.getMonitor(key),
+      test: (key, payload) => this.testMonitorWebhook(key, payload),
+      validate: (key) => this.validateMonitor(key),
       dependents: (key) => this.getMonitorDependents(key),
       update: (key, patch) => this.updateMonitor(key, patch),
       delete: (key, options) => this.deleteMonitor(key, options),
@@ -4085,10 +4102,33 @@ export class DeeplineClient {
         body: definition,
       });
     }
-    return this.http.request<MonitorDeployResult>('/api/v2/monitors/deploy', {
+    const deployed = await this.http.request<MonitorDeployResult>(
+      '/api/v2/monitors/deploy',
+      {
       method: 'POST',
       body: definition,
-    });
+      },
+    );
+    if (definition.tool !== 'deepline.deanonymizer') return deployed;
+
+    // Deanonymizer remains an ordinary monitor deploy. Its provider-specific
+    // post-deploy work creates/reuses the tracker and returns the artifact a
+    // caller needs to install it; there is intentionally no separate setup
+    // command in the public monitor lifecycle.
+    const setup = await this.setupMonitor(
+      definition.tool,
+      definition.payload ?? {},
+    );
+    return {
+      ...deployed,
+      monitor: {
+        ...(deployed.monitor && typeof deployed.monitor === 'object'
+          ? deployed.monitor
+          : {}),
+        tracking: setup.tracking ?? null,
+        ip2company: setup.ip2company ?? null,
+      },
+    };
   }
 
   /** List deployed monitors. Prefer `client.monitors.list(...)`. */
@@ -4119,6 +4159,33 @@ export class DeeplineClient {
     );
   }
 
+  async testMonitorWebhook(
+    key: string,
+    payload: Record<string, unknown>,
+  ): Promise<MonitorTestResult> {
+    return this.http.request<MonitorTestResult>(
+      `/api/v2/monitors/deployed/${encodeURIComponent(key)}/test`,
+      { method: 'POST', body: { payload } },
+    );
+  }
+
+  async setupMonitor(
+    tool: string,
+    payload: Record<string, unknown>,
+  ): Promise<Record<string, unknown>> {
+    return this.http.request<Record<string, unknown>>(
+      `/api/v2/monitors/setup/${encodeURIComponent(tool)}`,
+      { method: 'POST', body: payload },
+    );
+  }
+
+  async validateMonitor(key: string): Promise<MonitorValidateResult> {
+    return this.http.request<MonitorValidateResult>(
+      `/api/v2/monitors/deployed/${encodeURIComponent(key)}/validate`,
+      { method: 'POST', body: {} },
+    );
+  }
+
   /** Published plays depending on one monitor. Prefer `client.monitors.dependents(...)`. */
   async getMonitorDependents(key: string): Promise<MonitorDependents> {
     return this.http.request<MonitorDependents>(

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

@@ -160,7 +160,7 @@ export const SDK_RELEASE = {
   // 0.2.0 makes Dataset Handles uniformly async-only after 0.1.320 briefly
   // exposed storage-dependent synchronous access. This deliberate minor
   // release keeps lazy paging semantics independent of row residency.
-  version: '0.2.2',
+  version: '0.2.4',
   contracts: {
     api: {
       name: 'sdk-http-api',

package/dist/bundling-sources/shared_libs/play-runtime/opensosdata-batching.ts

@@ -0,0 +1,182 @@
+import {
+  defineBatchStrategyMap,
+  type BatchOperationStrategy,
+} from './batching-types';
+
+type OpenSosDataScalarPayload = Record<string, unknown> & {
+  entity_name: string;
+  state: string;
+};
+
+type OpenSosDataBulkPayload = Record<string, unknown> & {
+  entities: Array<{ entity_name: string; state: string }>;
+};
+
+type OpenSosDataBulkResultRow = Record<string, unknown> & {
+  entity_name?: string;
+  state?: string;
+  success?: boolean;
+  data?: unknown;
+  error?: string | null;
+  cost?: number;
+};
+
+type OpenSosDataBulkResult = Record<string, unknown> & {
+  job_id?: string;
+  status?: string;
+  polling_interrupted?: boolean;
+  polling_timed_out?: boolean;
+  recovery_operation?: string;
+  results?: OpenSosDataBulkResultRow[];
+};
+
+function normalizeEntityName(value: unknown): string {
+  return String(value ?? '')
+    .trim()
+    .replace(/\s+/g, ' ')
+    .toLowerCase();
+}
+
+function normalizeState(value: unknown): string {
+  return String(value ?? '')
+    .trim()
+    .toUpperCase();
+}
+
+function correlationKey(input: {
+  entity_name?: unknown;
+  state?: unknown;
+}): string {
+  return JSON.stringify([
+    normalizeEntityName(input.entity_name),
+    normalizeState(input.state),
+  ]);
+}
+
+function requireResultIdentity(row: OpenSosDataBulkResultRow): string {
+  if (
+    typeof row.entity_name !== 'string' ||
+    !row.entity_name.trim() ||
+    typeof row.state !== 'string' ||
+    !row.state.trim()
+  ) {
+    throw new Error(
+      'OpenSOSData bulk result is missing entity_name/state correlation identity.',
+    );
+  }
+  return correlationKey(row);
+}
+
+function toScalarResult(
+  row: OpenSosDataBulkResultRow,
+): Record<string, unknown> {
+  const scalarResult: Record<string, unknown> = { ...row };
+  delete scalarResult.entity_name;
+  delete scalarResult.state;
+  if (typeof scalarResult.success !== 'boolean') {
+    scalarResult.success = row.data !== undefined;
+  }
+  return scalarResult;
+}
+
+export const opensosDataBusinessLookupBatchStrategy: BatchOperationStrategy<
+  OpenSosDataScalarPayload,
+  OpenSosDataBulkPayload,
+  OpenSosDataBulkResult,
+  Record<string, unknown>,
+  OpenSosDataBulkResultRow
+> = {
+  sourceOperation: 'opensosdata_business_lookup',
+  batchOperation: 'opensosdata_bulk_lookup',
+  kind: 'identifier_batch',
+  maxBatchSize: 256,
+  canBatchWith() {
+    return true;
+  },
+  toBucketKey() {
+    return 'opensosdata_bulk_lookup';
+  },
+  toItemKey(payload) {
+    return correlationKey(payload);
+  },
+  compile(payloads) {
+    return {
+      batchOperation: 'opensosdata_bulk_lookup',
+      batchPayload: {
+        entities: payloads.map((payload) => ({
+          entity_name: payload.entity_name,
+          state: payload.state,
+        })),
+      },
+      items: payloads.map((payload) => ({
+        itemKey: correlationKey(payload),
+        payload,
+      })),
+    };
+  },
+  splitResult(fullResult, compiled) {
+    if (
+      typeof fullResult.job_id === 'string' &&
+      (fullResult.status === 'queued' || fullResult.status === 'processing')
+    ) {
+      return compiled.items.map((item) => ({
+        itemKey: item.itemKey,
+        result: {
+          job_id: fullResult.job_id,
+          status: fullResult.status,
+          polling_interrupted: fullResult.polling_interrupted === true,
+          polling_timed_out: fullResult.polling_timed_out === true,
+          recovery_operation:
+            fullResult.recovery_operation ?? 'opensosdata_get_bulk_result',
+        },
+        rawResult: fullResult,
+      }));
+    }
+    if (!Array.isArray(fullResult.results)) {
+      throw new Error(
+        'OpenSOSData completed bulk result is missing its results array.',
+      );
+    }
+
+    const remainingByKey = new Map<string, number>();
+    for (const item of compiled.items) {
+      remainingByKey.set(
+        item.itemKey,
+        (remainingByKey.get(item.itemKey) ?? 0) + 1,
+      );
+    }
+
+    const rowsByKey = new Map<string, OpenSosDataBulkResultRow[]>();
+    for (const row of fullResult.results) {
+      const key = requireResultIdentity(row);
+      const remaining = remainingByKey.get(key) ?? 0;
+      if (remaining < 1) {
+        throw new Error(
+          `OpenSOSData bulk result has unmatched correlation identity ${key}.`,
+        );
+      }
+      remainingByKey.set(key, remaining - 1);
+      const rows = rowsByKey.get(key);
+      if (rows) rows.push(row);
+      else rowsByKey.set(key, [row]);
+    }
+
+    return compiled.items.map((item) => {
+      const row = rowsByKey.get(item.itemKey)?.shift();
+      if (!row) {
+        throw new Error(
+          `OpenSOSData bulk result is missing result identity ${item.itemKey}.`,
+        );
+      }
+      return {
+        itemKey: item.itemKey,
+        result: toScalarResult(row),
+        rawResult: row,
+      };
+    });
+  },
+};
+
+export const opensosdataBatchStrategies = defineBatchStrategyMap({
+  opensosdata_business_lookup: opensosDataBusinessLookupBatchStrategy,
+});

package/dist/bundling-sources/shared_libs/play-runtime/play-runtime-batching-registry.ts

@@ -1,6 +1,7 @@
 import type { AnyBatchOperationStrategy } from './batching-types';
 import { DEFAULT_PLAY_RUNTIME_BATCH_STRATEGIES } from './default-batch-strategies';
 import { fullenrichBatchStrategies } from './fullenrich-batching';
+import { opensosdataBatchStrategies } from './opensosdata-batching';
 
 export const PLAY_RUNTIME_BATCH_OPERATION_REGISTRY: Record<
   string,
@@ -8,6 +9,7 @@ export const PLAY_RUNTIME_BATCH_OPERATION_REGISTRY: Record<
 > = {
   ...DEFAULT_PLAY_RUNTIME_BATCH_STRATEGIES,
   ...fullenrichBatchStrategies,
+  ...opensosdataBatchStrategies,
 };
 
 export function getPlayRuntimeBatchStrategy(

package/dist/cli/index.js

@@ -1040,7 +1040,7 @@ var SDK_RELEASE = {
   // 0.2.0 makes Dataset Handles uniformly async-only after 0.1.320 briefly
   // exposed storage-dependent synchronous access. This deliberate minor
   // release keeps lazy paging semantics independent of row residency.
-  version: "0.2.2",
+  version: "0.2.4",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -3778,6 +3778,8 @@ var DeeplineClient = class {
       deploy: (definition, options2) => this.deployMonitor(definition, options2),
       list: (options2) => this.listMonitors(options2),
       get: (key) => this.getMonitor(key),
+      test: (key, payload) => this.testMonitorWebhook(key, payload),
+      validate: (key) => this.validateMonitor(key),
       dependents: (key) => this.getMonitorDependents(key),
       update: (key, patch) => this.updateMonitor(key, patch),
       delete: (key, options2) => this.deleteMonitor(key, options2),
@@ -5739,10 +5741,26 @@ var DeeplineClient = class {
         body: definition
       });
     }
-    return this.http.request("/api/v2/monitors/deploy", {
-      method: "POST",
-      body: definition
-    });
+    const deployed = await this.http.request(
+      "/api/v2/monitors/deploy",
+      {
+        method: "POST",
+        body: definition
+      }
+    );
+    if (definition.tool !== "deepline.deanonymizer") return deployed;
+    const setup = await this.setupMonitor(
+      definition.tool,
+      definition.payload ?? {}
+    );
+    return {
+      ...deployed,
+      monitor: {
+        ...deployed.monitor && typeof deployed.monitor === "object" ? deployed.monitor : {},
+        tracking: setup.tracking ?? null,
+        ip2company: setup.ip2company ?? null
+      }
+    };
   }
   /** List deployed monitors. Prefer `client.monitors.list(...)`. */
   async listMonitors(options) {
@@ -5766,6 +5784,24 @@ var DeeplineClient = class {
       { method: "GET" }
     );
   }
+  async testMonitorWebhook(key, payload) {
+    return this.http.request(
+      `/api/v2/monitors/deployed/${encodeURIComponent(key)}/test`,
+      { method: "POST", body: { payload } }
+    );
+  }
+  async setupMonitor(tool, payload) {
+    return this.http.request(
+      `/api/v2/monitors/setup/${encodeURIComponent(tool)}`,
+      { method: "POST", body: payload }
+    );
+  }
+  async validateMonitor(key) {
+    return this.http.request(
+      `/api/v2/monitors/deployed/${encodeURIComponent(key)}/validate`,
+      { method: "POST", body: {} }
+    );
+  }
   /** Published plays depending on one monitor. Prefer `client.monitors.dependents(...)`. */
   async getMonitorDependents(key) {
     return this.http.request(
@@ -25753,6 +25789,26 @@ function renderMonitorDeployCompletion(payload) {
   if (pricingLine) {
     lines.push("", `Pricing: ${pricingLine}`);
   }
+  const guidance = asRecord2(payload.setup_guidance);
+  if (guidance) {
+    const callbackUrl = asString(guidance.callback_url);
+    const steps = Array.isArray(guidance.steps) ? guidance.steps : [];
+    const docs = Array.isArray(guidance.documentation) ? guidance.documentation : [];
+    lines.push("", asString(guidance.title) ?? "Provider setup:");
+    if (callbackUrl) lines.push(`  Callback URL: ${callbackUrl}`);
+    for (const step of steps)
+      if (asString(step)) lines.push(`  \u2022 ${asString(step)}`);
+    for (const raw of docs) {
+      const doc = asRecord2(raw);
+      const label = asString(doc?.label);
+      const url = asString(doc?.url);
+      if (label && url) lines.push(`  Docs: ${label} \u2014 ${url}`);
+    }
+    const payloadExample = asRecord2(guidance.payload_example);
+    if (payloadExample) {
+      lines.push(`  Payload example: ${JSON.stringify(payloadExample)}`);
+    }
+  }
   lines.push(
     "",
     "This monitor streams new rows into your Customer DB \u2014 there is no manual run.",
@@ -25970,9 +26026,21 @@ function renderDeployedListText(payload, requestedStatus) {
     const status = asString(entry.status);
     const tool = asString(entry.tool);
     const name = asString(entry.name);
+    const outputTable = asString(entry.output_table);
+    const webhookState = asString(entry.webhook_state);
+    const boundPlays = Array.isArray(entry.bound_plays) ? entry.bound_plays.length : void 0;
     lines.push(
       `  ${key}${status ? `  ${status}` : ""}${tool ? `  ${tool}` : ""}${name ? `  (${name})` : ""}`
     );
+    if (outputTable || webhookState || boundPlays !== void 0) {
+      lines.push(
+        `    ${[
+          outputTable ? `table: ${outputTable}` : null,
+          webhookState ? `webhook: ${webhookState}` : null,
+          boundPlays !== void 0 ? `bound Plays: ${boundPlays}` : null
+        ].filter(Boolean).join("  ")}`
+      );
+    }
   }
   const applied = asString(payload.status_filter_applied) ?? requestedStatus ?? "active";
   lines.push(
@@ -26054,6 +26122,8 @@ function renderMonitorGet(payload) {
   const billing = asRecord2(payload.billing);
   const nextRenewalAt = billing ? asString(billing.next_renewal_at) : void 0;
   const dependents = asRecord2(payload.dependents);
+  const webhook = asRecord2(payload.webhook);
+  const guidance = asRecord2(payload.setup_guidance);
   const plays = dependents && Array.isArray(dependents.plays) ? dependents.plays : [];
   const lines = [
     `Monitor: ${key}`,
@@ -26065,6 +26135,36 @@ function renderMonitorGet(payload) {
   if (definition) {
     lines.push("", "Current definition:", `  ${JSON.stringify(definition)}`);
   }
+  if (webhook) {
+    lines.push("", `Webhook: ${asString(webhook.state) ?? "unknown"}`);
+    const callbackUrl = asString(webhook.callback_url);
+    if (callbackUrl) lines.push(`  Callback URL (sensitive): ${callbackUrl}`);
+  }
+  if (guidance) {
+    lines.push("", asString(guidance.title) ?? "Provider setup:");
+    for (const step of Array.isArray(guidance.steps) ? guidance.steps : []) {
+      const text = asString(step);
+      if (text) lines.push(`  \u2022 ${text}`);
+    }
+    for (const raw of Array.isArray(guidance.documentation) ? guidance.documentation : []) {
+      const doc = asRecord2(raw);
+      const label = asString(doc?.label);
+      const url = asString(doc?.url);
+      if (label && url) lines.push(`  Docs: ${label} \u2014 ${url}`);
+    }
+    const payloadExample = asRecord2(guidance.payload_example);
+    if (payloadExample) {
+      lines.push(`  Payload example: ${JSON.stringify(payloadExample)}`);
+    }
+  }
+  const samplePayload2 = asRecord2(payload.sample_payload);
+  if (samplePayload2) {
+    lines.push(
+      "",
+      `Sample test payload: ${JSON.stringify(samplePayload2)}`,
+      `  deepline monitors test ${key} '${JSON.stringify(samplePayload2)}' --json`
+    );
+  }
   lines.push("", `Dependent published plays (${plays.length}):`);
   if (plays.length === 0) {
     lines.push("  none");
@@ -26096,6 +26196,20 @@ async function handleMonitorsGet(key, options) {
     text: renderMonitorGet(detail)
   });
 }
+async function handleMonitorsTest(key, payload, options) {
+  const explicitPayload = parseJsonObjectArg(payload, "<payload>");
+  const result = await new DeeplineClient().monitors.test(key, explicitPayload);
+  const text = `Webhook test for ${key}: ${result.accepted === true ? "accepted" : "rejected"}
+  persisted rows: ${asFiniteNumber(result.persisted_rows) ?? 0}
+  bound Plays dispatched: ${asFiniteNumber(result.dispatched_bound_plays) ?? 0}
+`;
+  printCommandEnvelope(result, { json: options.json, text });
+}
+async function handleMonitorsValidate(key, options) {
+  const result = await new DeeplineClient().monitors.validate(key);
+  printCommandEnvelope(result, { json: options.json });
+  if (result.valid === false) process.exitCode = 7;
+}
 async function confirmMonitorDelete(key, options) {
   const rl = (0, import_promises4.createInterface)({
     input: process.stdin,
@@ -26185,8 +26299,8 @@ Notes:
   Deepline monitors are Deepline-native signal feeds: a monitor writes events
   into a Customer DB table; a play reacts to each new row via a
   sqlListeners trigger \u2014 see \`deepline plays bootstrap monitor-triggered\`.
-  The customer launch currently includes Company Radar and Contact Radar; use
-  \`deepline monitors available\` for the exact live tool ids.
+  The Monitors rollout controls access to the live provider catalog; use
+  \`deepline tools list --categories monitors\` for the exact tool ids available to you.
   Access is granted by a Deepline admin via Admin -> Rollouts; until then these
   commands return a clear monitor_access_required error.
 
@@ -26296,6 +26410,25 @@ Examples:
 `
     )
   ).action(monitorsAction(handleMonitorsGet));
+  withJsonOption(
+    monitors.command("test <key> <payload>").description(
+      "Send an explicit payload through a monitor\u2019s webhook ingestion path."
+    ).addHelpText(
+      "after",
+      `
+Notes:
+  <payload> must be an explicit JSON object. The command uses the deployed
+  monitor\u2019s real validation, persistence, and inline Play dispatch path; it does
+  not synthesize a provider event or accept an omitted payload.
+
+Examples:
+  deepline monitors test rb2b-website-visitors '{"LinkedIn URL":"https://www.linkedin.com/in/example","Website":"https://example.com"}' --json
+`
+    )
+  ).action(monitorsAction(handleMonitorsTest));
+  withJsonOption(
+    monitors.command("validate <key>").description("Validate a deployed monitor\u2019s provider configuration.")
+  ).action(monitorsAction(handleMonitorsValidate));
   withJsonOption(
     monitors.command("check [definition]").description("Validate a monitor definition without deploying it.").addHelpText(
       "after",

package/dist/cli/index.mjs

@@ -1025,7 +1025,7 @@ var SDK_RELEASE = {
   // 0.2.0 makes Dataset Handles uniformly async-only after 0.1.320 briefly
   // exposed storage-dependent synchronous access. This deliberate minor
   // release keeps lazy paging semantics independent of row residency.
-  version: "0.2.2",
+  version: "0.2.4",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -3763,6 +3763,8 @@ var DeeplineClient = class {
       deploy: (definition, options2) => this.deployMonitor(definition, options2),
       list: (options2) => this.listMonitors(options2),
       get: (key) => this.getMonitor(key),
+      test: (key, payload) => this.testMonitorWebhook(key, payload),
+      validate: (key) => this.validateMonitor(key),
       dependents: (key) => this.getMonitorDependents(key),
       update: (key, patch) => this.updateMonitor(key, patch),
       delete: (key, options2) => this.deleteMonitor(key, options2),
@@ -5724,10 +5726,26 @@ var DeeplineClient = class {
         body: definition
       });
     }
-    return this.http.request("/api/v2/monitors/deploy", {
-      method: "POST",
-      body: definition
-    });
+    const deployed = await this.http.request(
+      "/api/v2/monitors/deploy",
+      {
+        method: "POST",
+        body: definition
+      }
+    );
+    if (definition.tool !== "deepline.deanonymizer") return deployed;
+    const setup = await this.setupMonitor(
+      definition.tool,
+      definition.payload ?? {}
+    );
+    return {
+      ...deployed,
+      monitor: {
+        ...deployed.monitor && typeof deployed.monitor === "object" ? deployed.monitor : {},
+        tracking: setup.tracking ?? null,
+        ip2company: setup.ip2company ?? null
+      }
+    };
   }
   /** List deployed monitors. Prefer `client.monitors.list(...)`. */
   async listMonitors(options) {
@@ -5751,6 +5769,24 @@ var DeeplineClient = class {
       { method: "GET" }
     );
   }
+  async testMonitorWebhook(key, payload) {
+    return this.http.request(
+      `/api/v2/monitors/deployed/${encodeURIComponent(key)}/test`,
+      { method: "POST", body: { payload } }
+    );
+  }
+  async setupMonitor(tool, payload) {
+    return this.http.request(
+      `/api/v2/monitors/setup/${encodeURIComponent(tool)}`,
+      { method: "POST", body: payload }
+    );
+  }
+  async validateMonitor(key) {
+    return this.http.request(
+      `/api/v2/monitors/deployed/${encodeURIComponent(key)}/validate`,
+      { method: "POST", body: {} }
+    );
+  }
   /** Published plays depending on one monitor. Prefer `client.monitors.dependents(...)`. */
   async getMonitorDependents(key) {
     return this.http.request(
@@ -25789,6 +25825,26 @@ function renderMonitorDeployCompletion(payload) {
   if (pricingLine) {
     lines.push("", `Pricing: ${pricingLine}`);
   }
+  const guidance = asRecord2(payload.setup_guidance);
+  if (guidance) {
+    const callbackUrl = asString(guidance.callback_url);
+    const steps = Array.isArray(guidance.steps) ? guidance.steps : [];
+    const docs = Array.isArray(guidance.documentation) ? guidance.documentation : [];
+    lines.push("", asString(guidance.title) ?? "Provider setup:");
+    if (callbackUrl) lines.push(`  Callback URL: ${callbackUrl}`);
+    for (const step of steps)
+      if (asString(step)) lines.push(`  \u2022 ${asString(step)}`);
+    for (const raw of docs) {
+      const doc = asRecord2(raw);
+      const label = asString(doc?.label);
+      const url = asString(doc?.url);
+      if (label && url) lines.push(`  Docs: ${label} \u2014 ${url}`);
+    }
+    const payloadExample = asRecord2(guidance.payload_example);
+    if (payloadExample) {
+      lines.push(`  Payload example: ${JSON.stringify(payloadExample)}`);
+    }
+  }
   lines.push(
     "",
     "This monitor streams new rows into your Customer DB \u2014 there is no manual run.",
@@ -26006,9 +26062,21 @@ function renderDeployedListText(payload, requestedStatus) {
     const status = asString(entry.status);
     const tool = asString(entry.tool);
     const name = asString(entry.name);
+    const outputTable = asString(entry.output_table);
+    const webhookState = asString(entry.webhook_state);
+    const boundPlays = Array.isArray(entry.bound_plays) ? entry.bound_plays.length : void 0;
     lines.push(
       `  ${key}${status ? `  ${status}` : ""}${tool ? `  ${tool}` : ""}${name ? `  (${name})` : ""}`
     );
+    if (outputTable || webhookState || boundPlays !== void 0) {
+      lines.push(
+        `    ${[
+          outputTable ? `table: ${outputTable}` : null,
+          webhookState ? `webhook: ${webhookState}` : null,
+          boundPlays !== void 0 ? `bound Plays: ${boundPlays}` : null
+        ].filter(Boolean).join("  ")}`
+      );
+    }
   }
   const applied = asString(payload.status_filter_applied) ?? requestedStatus ?? "active";
   lines.push(
@@ -26090,6 +26158,8 @@ function renderMonitorGet(payload) {
   const billing = asRecord2(payload.billing);
   const nextRenewalAt = billing ? asString(billing.next_renewal_at) : void 0;
   const dependents = asRecord2(payload.dependents);
+  const webhook = asRecord2(payload.webhook);
+  const guidance = asRecord2(payload.setup_guidance);
   const plays = dependents && Array.isArray(dependents.plays) ? dependents.plays : [];
   const lines = [
     `Monitor: ${key}`,
@@ -26101,6 +26171,36 @@ function renderMonitorGet(payload) {
   if (definition) {
     lines.push("", "Current definition:", `  ${JSON.stringify(definition)}`);
   }
+  if (webhook) {
+    lines.push("", `Webhook: ${asString(webhook.state) ?? "unknown"}`);
+    const callbackUrl = asString(webhook.callback_url);
+    if (callbackUrl) lines.push(`  Callback URL (sensitive): ${callbackUrl}`);
+  }
+  if (guidance) {
+    lines.push("", asString(guidance.title) ?? "Provider setup:");
+    for (const step of Array.isArray(guidance.steps) ? guidance.steps : []) {
+      const text = asString(step);
+      if (text) lines.push(`  \u2022 ${text}`);
+    }
+    for (const raw of Array.isArray(guidance.documentation) ? guidance.documentation : []) {
+      const doc = asRecord2(raw);
+      const label = asString(doc?.label);
+      const url = asString(doc?.url);
+      if (label && url) lines.push(`  Docs: ${label} \u2014 ${url}`);
+    }
+    const payloadExample = asRecord2(guidance.payload_example);
+    if (payloadExample) {
+      lines.push(`  Payload example: ${JSON.stringify(payloadExample)}`);
+    }
+  }
+  const samplePayload2 = asRecord2(payload.sample_payload);
+  if (samplePayload2) {
+    lines.push(
+      "",
+      `Sample test payload: ${JSON.stringify(samplePayload2)}`,
+      `  deepline monitors test ${key} '${JSON.stringify(samplePayload2)}' --json`
+    );
+  }
   lines.push("", `Dependent published plays (${plays.length}):`);
   if (plays.length === 0) {
     lines.push("  none");
@@ -26132,6 +26232,20 @@ async function handleMonitorsGet(key, options) {
     text: renderMonitorGet(detail)
   });
 }
+async function handleMonitorsTest(key, payload, options) {
+  const explicitPayload = parseJsonObjectArg(payload, "<payload>");
+  const result = await new DeeplineClient().monitors.test(key, explicitPayload);
+  const text = `Webhook test for ${key}: ${result.accepted === true ? "accepted" : "rejected"}
+  persisted rows: ${asFiniteNumber(result.persisted_rows) ?? 0}
+  bound Plays dispatched: ${asFiniteNumber(result.dispatched_bound_plays) ?? 0}
+`;
+  printCommandEnvelope(result, { json: options.json, text });
+}
+async function handleMonitorsValidate(key, options) {
+  const result = await new DeeplineClient().monitors.validate(key);
+  printCommandEnvelope(result, { json: options.json });
+  if (result.valid === false) process.exitCode = 7;
+}
 async function confirmMonitorDelete(key, options) {
   const rl = createInterface({
     input: process.stdin,
@@ -26221,8 +26335,8 @@ Notes:
   Deepline monitors are Deepline-native signal feeds: a monitor writes events
   into a Customer DB table; a play reacts to each new row via a
   sqlListeners trigger \u2014 see \`deepline plays bootstrap monitor-triggered\`.
-  The customer launch currently includes Company Radar and Contact Radar; use
-  \`deepline monitors available\` for the exact live tool ids.
+  The Monitors rollout controls access to the live provider catalog; use
+  \`deepline tools list --categories monitors\` for the exact tool ids available to you.
   Access is granted by a Deepline admin via Admin -> Rollouts; until then these
   commands return a clear monitor_access_required error.
 
@@ -26332,6 +26446,25 @@ Examples:
 `
     )
   ).action(monitorsAction(handleMonitorsGet));
+  withJsonOption(
+    monitors.command("test <key> <payload>").description(
+      "Send an explicit payload through a monitor\u2019s webhook ingestion path."
+    ).addHelpText(
+      "after",
+      `
+Notes:
+  <payload> must be an explicit JSON object. The command uses the deployed
+  monitor\u2019s real validation, persistence, and inline Play dispatch path; it does
+  not synthesize a provider event or accept an omitted payload.
+
+Examples:
+  deepline monitors test rb2b-website-visitors '{"LinkedIn URL":"https://www.linkedin.com/in/example","Website":"https://example.com"}' --json
+`
+    )
+  ).action(monitorsAction(handleMonitorsTest));
+  withJsonOption(
+    monitors.command("validate <key>").description("Validate a deployed monitor\u2019s provider configuration.")
+  ).action(monitorsAction(handleMonitorsValidate));
   withJsonOption(
     monitors.command("check [definition]").description("Validate a monitor definition without deploying it.").addHelpText(
       "after",

package/dist/index.d.mts

@@ -1930,6 +1930,13 @@ type MonitorListEntry = {
     status?: string;
     tool?: string;
     name?: string;
+    configured?: boolean;
+    active?: boolean;
+    provider?: string;
+    output_table?: string | null;
+    webhook_state?: string;
+    last_received_event?: string | null;
+    bound_plays?: Array<Record<string, unknown>>;
     [key: string]: unknown;
 };
 /**
@@ -2001,6 +2008,8 @@ type MonitorUpdateResult = {
 };
 type MonitorDeleteResult = Record<string, unknown>;
 type MonitorReactivateResult = Record<string, unknown>;
+type MonitorTestResult = Record<string, unknown>;
+type MonitorValidateResult = Record<string, unknown>;
 /**
  * Public monitors namespace exposed as `client.monitors`.
  *
@@ -2033,6 +2042,9 @@ type MonitorsNamespace = {
     list: (options?: MonitorsListOptions) => Promise<MonitorsListResult>;
     /** Fetch one deployed monitor by public key (without dependents). */
     get: (key: string) => Promise<MonitorDetail>;
+    /** Send an explicit payload through the deployed monitor's normal webhook path. */
+    test: (key: string, payload: Record<string, unknown>) => Promise<MonitorTestResult>;
+    validate: (key: string) => Promise<MonitorValidateResult>;
     /** List the published plays depending on one monitor's output streams. */
     dependents: (key: string) => Promise<MonitorDependents>;
     /** Update a deployed monitor by public key. */
@@ -3162,6 +3174,9 @@ declare class DeeplineClient {
     listMonitors(options?: MonitorsListOptions): Promise<MonitorsListResult>;
     /** Fetch one deployed monitor by public key. Prefer `client.monitors.get(...)`. */
     getMonitor(key: string): Promise<MonitorDetail>;
+    testMonitorWebhook(key: string, payload: Record<string, unknown>): Promise<MonitorTestResult>;
+    setupMonitor(tool: string, payload: Record<string, unknown>): Promise<Record<string, unknown>>;
+    validateMonitor(key: string): Promise<MonitorValidateResult>;
     /** Published plays depending on one monitor. Prefer `client.monitors.dependents(...)`. */
     getMonitorDependents(key: string): Promise<MonitorDependents>;
     /** Update a deployed monitor by public key. Prefer `client.monitors.update(...)`. */

package/dist/index.d.ts

@@ -1930,6 +1930,13 @@ type MonitorListEntry = {
     status?: string;
     tool?: string;
     name?: string;
+    configured?: boolean;
+    active?: boolean;
+    provider?: string;
+    output_table?: string | null;
+    webhook_state?: string;
+    last_received_event?: string | null;
+    bound_plays?: Array<Record<string, unknown>>;
     [key: string]: unknown;
 };
 /**
@@ -2001,6 +2008,8 @@ type MonitorUpdateResult = {
 };
 type MonitorDeleteResult = Record<string, unknown>;
 type MonitorReactivateResult = Record<string, unknown>;
+type MonitorTestResult = Record<string, unknown>;
+type MonitorValidateResult = Record<string, unknown>;
 /**
  * Public monitors namespace exposed as `client.monitors`.
  *
@@ -2033,6 +2042,9 @@ type MonitorsNamespace = {
     list: (options?: MonitorsListOptions) => Promise<MonitorsListResult>;
     /** Fetch one deployed monitor by public key (without dependents). */
     get: (key: string) => Promise<MonitorDetail>;
+    /** Send an explicit payload through the deployed monitor's normal webhook path. */
+    test: (key: string, payload: Record<string, unknown>) => Promise<MonitorTestResult>;
+    validate: (key: string) => Promise<MonitorValidateResult>;
     /** List the published plays depending on one monitor's output streams. */
     dependents: (key: string) => Promise<MonitorDependents>;
     /** Update a deployed monitor by public key. */
@@ -3162,6 +3174,9 @@ declare class DeeplineClient {
     listMonitors(options?: MonitorsListOptions): Promise<MonitorsListResult>;
     /** Fetch one deployed monitor by public key. Prefer `client.monitors.get(...)`. */
     getMonitor(key: string): Promise<MonitorDetail>;
+    testMonitorWebhook(key: string, payload: Record<string, unknown>): Promise<MonitorTestResult>;
+    setupMonitor(tool: string, payload: Record<string, unknown>): Promise<Record<string, unknown>>;
+    validateMonitor(key: string): Promise<MonitorValidateResult>;
     /** Published plays depending on one monitor. Prefer `client.monitors.dependents(...)`. */
     getMonitorDependents(key: string): Promise<MonitorDependents>;
     /** Update a deployed monitor by public key. Prefer `client.monitors.update(...)`. */

package/dist/index.js

@@ -763,7 +763,7 @@ var SDK_RELEASE = {
   // 0.2.0 makes Dataset Handles uniformly async-only after 0.1.320 briefly
   // exposed storage-dependent synchronous access. This deliberate minor
   // release keeps lazy paging semantics independent of row residency.
-  version: "0.2.2",
+  version: "0.2.4",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -3501,6 +3501,8 @@ var DeeplineClient = class {
       deploy: (definition, options2) => this.deployMonitor(definition, options2),
       list: (options2) => this.listMonitors(options2),
       get: (key) => this.getMonitor(key),
+      test: (key, payload) => this.testMonitorWebhook(key, payload),
+      validate: (key) => this.validateMonitor(key),
       dependents: (key) => this.getMonitorDependents(key),
       update: (key, patch) => this.updateMonitor(key, patch),
       delete: (key, options2) => this.deleteMonitor(key, options2),
@@ -5462,10 +5464,26 @@ var DeeplineClient = class {
         body: definition
       });
     }
-    return this.http.request("/api/v2/monitors/deploy", {
-      method: "POST",
-      body: definition
-    });
+    const deployed = await this.http.request(
+      "/api/v2/monitors/deploy",
+      {
+        method: "POST",
+        body: definition
+      }
+    );
+    if (definition.tool !== "deepline.deanonymizer") return deployed;
+    const setup = await this.setupMonitor(
+      definition.tool,
+      definition.payload ?? {}
+    );
+    return {
+      ...deployed,
+      monitor: {
+        ...deployed.monitor && typeof deployed.monitor === "object" ? deployed.monitor : {},
+        tracking: setup.tracking ?? null,
+        ip2company: setup.ip2company ?? null
+      }
+    };
   }
   /** List deployed monitors. Prefer `client.monitors.list(...)`. */
   async listMonitors(options) {
@@ -5489,6 +5507,24 @@ var DeeplineClient = class {
       { method: "GET" }
     );
   }
+  async testMonitorWebhook(key, payload) {
+    return this.http.request(
+      `/api/v2/monitors/deployed/${encodeURIComponent(key)}/test`,
+      { method: "POST", body: { payload } }
+    );
+  }
+  async setupMonitor(tool, payload) {
+    return this.http.request(
+      `/api/v2/monitors/setup/${encodeURIComponent(tool)}`,
+      { method: "POST", body: payload }
+    );
+  }
+  async validateMonitor(key) {
+    return this.http.request(
+      `/api/v2/monitors/deployed/${encodeURIComponent(key)}/validate`,
+      { method: "POST", body: {} }
+    );
+  }
   /** Published plays depending on one monitor. Prefer `client.monitors.dependents(...)`. */
   async getMonitorDependents(key) {
     return this.http.request(

package/dist/index.mjs

@@ -689,7 +689,7 @@ var SDK_RELEASE = {
   // 0.2.0 makes Dataset Handles uniformly async-only after 0.1.320 briefly
   // exposed storage-dependent synchronous access. This deliberate minor
   // release keeps lazy paging semantics independent of row residency.
-  version: "0.2.2",
+  version: "0.2.4",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -3427,6 +3427,8 @@ var DeeplineClient = class {
       deploy: (definition, options2) => this.deployMonitor(definition, options2),
       list: (options2) => this.listMonitors(options2),
       get: (key) => this.getMonitor(key),
+      test: (key, payload) => this.testMonitorWebhook(key, payload),
+      validate: (key) => this.validateMonitor(key),
       dependents: (key) => this.getMonitorDependents(key),
       update: (key, patch) => this.updateMonitor(key, patch),
       delete: (key, options2) => this.deleteMonitor(key, options2),
@@ -5388,10 +5390,26 @@ var DeeplineClient = class {
         body: definition
       });
     }
-    return this.http.request("/api/v2/monitors/deploy", {
-      method: "POST",
-      body: definition
-    });
+    const deployed = await this.http.request(
+      "/api/v2/monitors/deploy",
+      {
+        method: "POST",
+        body: definition
+      }
+    );
+    if (definition.tool !== "deepline.deanonymizer") return deployed;
+    const setup = await this.setupMonitor(
+      definition.tool,
+      definition.payload ?? {}
+    );
+    return {
+      ...deployed,
+      monitor: {
+        ...deployed.monitor && typeof deployed.monitor === "object" ? deployed.monitor : {},
+        tracking: setup.tracking ?? null,
+        ip2company: setup.ip2company ?? null
+      }
+    };
   }
   /** List deployed monitors. Prefer `client.monitors.list(...)`. */
   async listMonitors(options) {
@@ -5415,6 +5433,24 @@ var DeeplineClient = class {
       { method: "GET" }
     );
   }
+  async testMonitorWebhook(key, payload) {
+    return this.http.request(
+      `/api/v2/monitors/deployed/${encodeURIComponent(key)}/test`,
+      { method: "POST", body: { payload } }
+    );
+  }
+  async setupMonitor(tool, payload) {
+    return this.http.request(
+      `/api/v2/monitors/setup/${encodeURIComponent(tool)}`,
+      { method: "POST", body: payload }
+    );
+  }
+  async validateMonitor(key) {
+    return this.http.request(
+      `/api/v2/monitors/deployed/${encodeURIComponent(key)}/validate`,
+      { method: "POST", body: {} }
+    );
+  }
   /** Published plays depending on one monitor. Prefer `client.monitors.dependents(...)`. */
   async getMonitorDependents(key) {
     return this.http.request(

package/package.json

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