deepline 0.2.39 → 0.2.40

package/dist/index.d.mts

@@ -1170,6 +1170,57 @@ interface PlayListItem {
     currentRevision?: PlayRevisionSummary | null;
     liveRevision?: PlayRevisionSummary | null;
     aliases?: string[];
+    triggerStatus?: {
+        cron: string | null;
+        webhook: string | null;
+        blockedReason: string | null;
+    };
+}
+interface ProductNotificationEventDefinition {
+    id: string;
+    label: string;
+    description: string;
+    source: 'cron' | 'webhook';
+    outcome: 'succeeded' | 'failed';
+    defaultEnabled: boolean;
+}
+interface ProductNotificationSettings {
+    contractVersion: number;
+    catalog: ProductNotificationEventDefinition[];
+    notifications?: ProductNotification[];
+    providers?: Array<{
+        kind: string;
+        targetLabel: string;
+    }>;
+    destinations: Array<Record<string, unknown>>;
+    subscriptions: Array<{
+        eventType: string;
+        enabled: boolean;
+        destinationId: string;
+    }>;
+    dlq: {
+        count: number;
+        capped: boolean;
+    };
+    slackConnection?: {
+        connected: boolean;
+        status: string;
+    };
+}
+interface ProductNotification {
+    id: string;
+    name: string;
+    provider: string;
+    target: {
+        id: string;
+        name: string;
+    };
+    enabled: boolean;
+    status: string;
+    eventTypes: string[];
+    lastTestedAt?: number;
+    lastTestStatus?: string;
+    lastErrorMessage?: string;
 }
 interface PlayDescription {
     name: string;
@@ -3119,6 +3170,88 @@ declare class DeeplineClient {
         grep?: string;
         grepMode?: 'all' | 'any' | 'phrase';
     }): Promise<PlayListItem[]>;
+    /** Read product-notification destinations, subscriptions, event catalog, and DLQ health. */
+    getNotificationSettings(): Promise<ProductNotificationSettings>;
+    /** Start the Slack OAuth flow required by product notifications. */
+    connectNotificationSlack(options?: {
+        successUrl?: string;
+        failureUrl?: string;
+    }): Promise<{
+        ok: boolean;
+        redirect_url: string;
+    }>;
+    /** List Slack channels visible to the connected Deepline Slack app. */
+    listNotificationSlackChannels(query?: string): Promise<{
+        identity: {
+            teamId: string;
+            teamName?: string;
+        };
+        channels: Array<{
+            id: string;
+            name: string;
+            isPrivate: boolean;
+        }>;
+    }>;
+    /** Select the Slack channel used for product notifications. */
+    setNotificationSlack(channel: string): Promise<unknown>;
+    /** Send one synchronous test ping and return Slack's delivery result. */
+    testNotificationSlack(): Promise<{
+        ok: boolean;
+        deliveryId: string;
+        state: string;
+        message: string;
+    }>;
+    /** Disable Slack product notifications without deleting the OAuth connection. */
+    disableNotificationSlack(): Promise<unknown>;
+    /** Enable or disable event IDs from the server-provided notification catalog. */
+    setNotificationSubscriptions(eventTypes: string[], enabled: boolean): Promise<unknown>;
+    /** List exhausted deliveries. Dead-lettered messages never replay automatically. */
+    listNotificationDlq(limit?: number): Promise<unknown>;
+    /** Inspect one exhausted notification delivery. */
+    getNotificationDlqDelivery(deliveryId: string): Promise<unknown>;
+    /** Explicitly retry or archive one dead-lettered notification delivery. */
+    updateNotificationDlqDelivery(deliveryId: string, action: 'retry' | 'archive'): Promise<unknown>;
+    /** List the workspace's named notification rules. */
+    getNotifications(): Promise<ProductNotificationSettings>;
+    /** List Slack channels available to an already-connected Slack integration. */
+    listNotificationChannels(query?: string): Promise<{
+        identity: {
+            teamId: string;
+            teamName?: string;
+        };
+        channels: Array<{
+            id: string;
+            name: string;
+            isPrivate: boolean;
+        }>;
+    }>;
+    /** Create a named notification routed through an existing provider integration. */
+    createNotification(input: {
+        name: string;
+        provider: 'slack';
+        channel: string;
+        eventTypes: string[];
+    }): Promise<unknown>;
+    /** Update a notification's target, event selection, or enabled state. */
+    updateNotification(notificationId: string, input: {
+        enabled: boolean;
+    } | {
+        name: string;
+        channel: string;
+        eventTypes: string[];
+    }): Promise<unknown>;
+    /** Send a validation ping to one notification. */
+    testNotification(notificationId: string): Promise<{
+        ok: boolean;
+        deliveryId: string;
+        state: string;
+        message: string;
+    }>;
+    /** Archive one notification without touching its provider integration. */
+    deleteNotification(notificationId: string): Promise<{
+        deleted: boolean;
+        id: string;
+    }>;
     /**
      * Search callable plays and return compact play descriptions.
      *

package/dist/index.d.ts

@@ -1170,6 +1170,57 @@ interface PlayListItem {
     currentRevision?: PlayRevisionSummary | null;
     liveRevision?: PlayRevisionSummary | null;
     aliases?: string[];
+    triggerStatus?: {
+        cron: string | null;
+        webhook: string | null;
+        blockedReason: string | null;
+    };
+}
+interface ProductNotificationEventDefinition {
+    id: string;
+    label: string;
+    description: string;
+    source: 'cron' | 'webhook';
+    outcome: 'succeeded' | 'failed';
+    defaultEnabled: boolean;
+}
+interface ProductNotificationSettings {
+    contractVersion: number;
+    catalog: ProductNotificationEventDefinition[];
+    notifications?: ProductNotification[];
+    providers?: Array<{
+        kind: string;
+        targetLabel: string;
+    }>;
+    destinations: Array<Record<string, unknown>>;
+    subscriptions: Array<{
+        eventType: string;
+        enabled: boolean;
+        destinationId: string;
+    }>;
+    dlq: {
+        count: number;
+        capped: boolean;
+    };
+    slackConnection?: {
+        connected: boolean;
+        status: string;
+    };
+}
+interface ProductNotification {
+    id: string;
+    name: string;
+    provider: string;
+    target: {
+        id: string;
+        name: string;
+    };
+    enabled: boolean;
+    status: string;
+    eventTypes: string[];
+    lastTestedAt?: number;
+    lastTestStatus?: string;
+    lastErrorMessage?: string;
 }
 interface PlayDescription {
     name: string;
@@ -3119,6 +3170,88 @@ declare class DeeplineClient {
         grep?: string;
         grepMode?: 'all' | 'any' | 'phrase';
     }): Promise<PlayListItem[]>;
+    /** Read product-notification destinations, subscriptions, event catalog, and DLQ health. */
+    getNotificationSettings(): Promise<ProductNotificationSettings>;
+    /** Start the Slack OAuth flow required by product notifications. */
+    connectNotificationSlack(options?: {
+        successUrl?: string;
+        failureUrl?: string;
+    }): Promise<{
+        ok: boolean;
+        redirect_url: string;
+    }>;
+    /** List Slack channels visible to the connected Deepline Slack app. */
+    listNotificationSlackChannels(query?: string): Promise<{
+        identity: {
+            teamId: string;
+            teamName?: string;
+        };
+        channels: Array<{
+            id: string;
+            name: string;
+            isPrivate: boolean;
+        }>;
+    }>;
+    /** Select the Slack channel used for product notifications. */
+    setNotificationSlack(channel: string): Promise<unknown>;
+    /** Send one synchronous test ping and return Slack's delivery result. */
+    testNotificationSlack(): Promise<{
+        ok: boolean;
+        deliveryId: string;
+        state: string;
+        message: string;
+    }>;
+    /** Disable Slack product notifications without deleting the OAuth connection. */
+    disableNotificationSlack(): Promise<unknown>;
+    /** Enable or disable event IDs from the server-provided notification catalog. */
+    setNotificationSubscriptions(eventTypes: string[], enabled: boolean): Promise<unknown>;
+    /** List exhausted deliveries. Dead-lettered messages never replay automatically. */
+    listNotificationDlq(limit?: number): Promise<unknown>;
+    /** Inspect one exhausted notification delivery. */
+    getNotificationDlqDelivery(deliveryId: string): Promise<unknown>;
+    /** Explicitly retry or archive one dead-lettered notification delivery. */
+    updateNotificationDlqDelivery(deliveryId: string, action: 'retry' | 'archive'): Promise<unknown>;
+    /** List the workspace's named notification rules. */
+    getNotifications(): Promise<ProductNotificationSettings>;
+    /** List Slack channels available to an already-connected Slack integration. */
+    listNotificationChannels(query?: string): Promise<{
+        identity: {
+            teamId: string;
+            teamName?: string;
+        };
+        channels: Array<{
+            id: string;
+            name: string;
+            isPrivate: boolean;
+        }>;
+    }>;
+    /** Create a named notification routed through an existing provider integration. */
+    createNotification(input: {
+        name: string;
+        provider: 'slack';
+        channel: string;
+        eventTypes: string[];
+    }): Promise<unknown>;
+    /** Update a notification's target, event selection, or enabled state. */
+    updateNotification(notificationId: string, input: {
+        enabled: boolean;
+    } | {
+        name: string;
+        channel: string;
+        eventTypes: string[];
+    }): Promise<unknown>;
+    /** Send a validation ping to one notification. */
+    testNotification(notificationId: string): Promise<{
+        ok: boolean;
+        deliveryId: string;
+        state: string;
+        message: string;
+    }>;
+    /** Archive one notification without touching its provider integration. */
+    deleteNotification(notificationId: string): Promise<{
+        deleted: boolean;
+        id: string;
+    }>;
     /**
      * Search callable plays and return compact play descriptions.
      *

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.39",
+  version: "0.2.40",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -1391,6 +1391,9 @@ var HttpClient = class {
       headers
     });
   }
+  async put(path, body, headers) {
+    return this.request(path, { method: "PUT", body, headers });
+  }
   /**
    * Send a DELETE request.
    *
@@ -1541,6 +1544,61 @@ function withCoworkNetworkHint(message) {
 ${COWORK_NETWORK_HINT}`;
 }
 
+// ../shared_libs/product-notifications/contract.ts
+var PRODUCT_NOTIFICATION_EVENT_CATALOG = [
+  {
+    id: "play.cron.succeeded",
+    label: "Cron success",
+    description: "A scheduled Play run completed successfully.",
+    source: "cron",
+    outcome: "succeeded",
+    defaultEnabled: true
+  },
+  {
+    id: "play.cron.failed",
+    label: "Cron failure",
+    description: "A scheduled Play could not start or its run reached a failed terminal state.",
+    source: "cron",
+    outcome: "failed",
+    defaultEnabled: true
+  },
+  {
+    id: "play.webhook.succeeded",
+    label: "Webhook success",
+    description: "An accepted webhook-triggered Play completed successfully.",
+    source: "webhook",
+    outcome: "succeeded",
+    defaultEnabled: true
+  },
+  {
+    id: "play.webhook.failed",
+    label: "Webhook failure",
+    description: "An accepted webhook-triggered Play reached a failed terminal state.",
+    source: "webhook",
+    outcome: "failed",
+    defaultEnabled: true
+  }
+];
+var PRODUCT_NOTIFICATION_EVENT_TYPE_SET = new Set(
+  PRODUCT_NOTIFICATION_EVENT_CATALOG.map((event) => event.id)
+);
+var PRODUCT_NOTIFICATION_SLACK_OAUTH_SCOPES = [
+  "channels:read",
+  "chat:write",
+  "groups:read"
+];
+var PRODUCT_NOTIFICATION_RETRY_DELAYS_MS = [
+  0,
+  6e4,
+  5 * 6e4,
+  15 * 6e4,
+  60 * 6e4
+];
+var PRODUCT_NOTIFICATION_MAX_ATTEMPTS = PRODUCT_NOTIFICATION_RETRY_DELAYS_MS.length;
+var PRODUCT_NOTIFICATION_DELIVERY_LEASE_MS = 2 * 6e4;
+var PRODUCT_NOTIFICATION_SUCCESS_TTL_MS = 15 * 6e4;
+var PRODUCT_NOTIFICATION_FAILURE_TTL_MS = 24 * 60 * 6e4;
+
 // src/stream-reconnect.ts
 var STREAM_RECONNECT_BASE_DELAY_MS = 500;
 var STREAM_RECONNECT_MAX_DELAY_MS = 15e3;
@@ -5097,6 +5155,95 @@ var DeeplineClient = class {
     );
     return response.plays ?? [];
   }
+  /** Read product-notification destinations, subscriptions, event catalog, and DLQ health. */
+  async getNotificationSettings() {
+    return this.http.get("/api/v2/settings/notifications");
+  }
+  /** Start the Slack OAuth flow required by product notifications. */
+  async connectNotificationSlack(options) {
+    return this.http.post("/api/v2/integrations/connect", {
+      provider: "slack",
+      scopes: [...PRODUCT_NOTIFICATION_SLACK_OAUTH_SCOPES],
+      ...options?.successUrl ? { success_url: options.successUrl } : {},
+      ...options?.failureUrl ? { failure_url: options.failureUrl } : {}
+    });
+  }
+  /** List Slack channels visible to the connected Deepline Slack app. */
+  async listNotificationSlackChannels(query) {
+    const suffix = query ? `?query=${encodeURIComponent(query)}` : "";
+    return this.http.get(`/api/v2/settings/notifications/channels${suffix}`);
+  }
+  /** Select the Slack channel used for product notifications. */
+  async setNotificationSlack(channel) {
+    return this.http.put("/api/v2/settings/notifications", { channel });
+  }
+  /** Send one synchronous test ping and return Slack's delivery result. */
+  async testNotificationSlack() {
+    return this.http.post("/api/v2/settings/notifications/test", {});
+  }
+  /** Disable Slack product notifications without deleting the OAuth connection. */
+  async disableNotificationSlack() {
+    return this.http.delete("/api/v2/settings/notifications");
+  }
+  /** Enable or disable event IDs from the server-provided notification catalog. */
+  async setNotificationSubscriptions(eventTypes, enabled) {
+    return this.http.patch("/api/v2/settings/notifications/subscriptions", {
+      eventTypes,
+      enabled
+    });
+  }
+  /** List exhausted deliveries. Dead-lettered messages never replay automatically. */
+  async listNotificationDlq(limit = 25) {
+    return this.http.get(
+      `/api/v2/settings/notifications/dlq?limit=${encodeURIComponent(String(limit))}`
+    );
+  }
+  /** Inspect one exhausted notification delivery. */
+  async getNotificationDlqDelivery(deliveryId) {
+    return this.http.get(
+      `/api/v2/settings/notifications/dlq/${encodeURIComponent(deliveryId)}`
+    );
+  }
+  /** Explicitly retry or archive one dead-lettered notification delivery. */
+  async updateNotificationDlqDelivery(deliveryId, action) {
+    return this.http.post(
+      `/api/v2/settings/notifications/dlq/${encodeURIComponent(deliveryId)}`,
+      { action }
+    );
+  }
+  /** List the workspace's named notification rules. */
+  async getNotifications() {
+    return this.http.get("/api/v2/notifications");
+  }
+  /** List Slack channels available to an already-connected Slack integration. */
+  async listNotificationChannels(query) {
+    const suffix = query ? `?search=${encodeURIComponent(query)}` : "";
+    return this.http.get(`/api/v2/notifications/slack/channels${suffix}`);
+  }
+  /** Create a named notification routed through an existing provider integration. */
+  async createNotification(input) {
+    return this.http.post("/api/v2/notifications", input);
+  }
+  /** Update a notification's target, event selection, or enabled state. */
+  async updateNotification(notificationId, input) {
+    return this.http.patch(
+      `/api/v2/notifications/${encodeURIComponent(notificationId)}`,
+      input
+    );
+  }
+  /** Send a validation ping to one notification. */
+  async testNotification(notificationId) {
+    return this.http.post(
+      `/api/v2/notifications/${encodeURIComponent(notificationId)}/test`,
+      {}
+    );
+  }
+  /** Archive one notification without touching its provider integration. */
+  async deleteNotification(notificationId) {
+    return this.http.delete(
+      `/api/v2/notifications/${encodeURIComponent(notificationId)}`
+    );
+  }
   /**
    * Search callable plays and return compact play descriptions.
    *

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.39",
+  version: "0.2.40",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -1317,6 +1317,9 @@ var HttpClient = class {
       headers
     });
   }
+  async put(path, body, headers) {
+    return this.request(path, { method: "PUT", body, headers });
+  }
   /**
    * Send a DELETE request.
    *
@@ -1467,6 +1470,61 @@ function withCoworkNetworkHint(message) {
 ${COWORK_NETWORK_HINT}`;
 }
 
+// ../shared_libs/product-notifications/contract.ts
+var PRODUCT_NOTIFICATION_EVENT_CATALOG = [
+  {
+    id: "play.cron.succeeded",
+    label: "Cron success",
+    description: "A scheduled Play run completed successfully.",
+    source: "cron",
+    outcome: "succeeded",
+    defaultEnabled: true
+  },
+  {
+    id: "play.cron.failed",
+    label: "Cron failure",
+    description: "A scheduled Play could not start or its run reached a failed terminal state.",
+    source: "cron",
+    outcome: "failed",
+    defaultEnabled: true
+  },
+  {
+    id: "play.webhook.succeeded",
+    label: "Webhook success",
+    description: "An accepted webhook-triggered Play completed successfully.",
+    source: "webhook",
+    outcome: "succeeded",
+    defaultEnabled: true
+  },
+  {
+    id: "play.webhook.failed",
+    label: "Webhook failure",
+    description: "An accepted webhook-triggered Play reached a failed terminal state.",
+    source: "webhook",
+    outcome: "failed",
+    defaultEnabled: true
+  }
+];
+var PRODUCT_NOTIFICATION_EVENT_TYPE_SET = new Set(
+  PRODUCT_NOTIFICATION_EVENT_CATALOG.map((event) => event.id)
+);
+var PRODUCT_NOTIFICATION_SLACK_OAUTH_SCOPES = [
+  "channels:read",
+  "chat:write",
+  "groups:read"
+];
+var PRODUCT_NOTIFICATION_RETRY_DELAYS_MS = [
+  0,
+  6e4,
+  5 * 6e4,
+  15 * 6e4,
+  60 * 6e4
+];
+var PRODUCT_NOTIFICATION_MAX_ATTEMPTS = PRODUCT_NOTIFICATION_RETRY_DELAYS_MS.length;
+var PRODUCT_NOTIFICATION_DELIVERY_LEASE_MS = 2 * 6e4;
+var PRODUCT_NOTIFICATION_SUCCESS_TTL_MS = 15 * 6e4;
+var PRODUCT_NOTIFICATION_FAILURE_TTL_MS = 24 * 60 * 6e4;
+
 // src/stream-reconnect.ts
 var STREAM_RECONNECT_BASE_DELAY_MS = 500;
 var STREAM_RECONNECT_MAX_DELAY_MS = 15e3;
@@ -5023,6 +5081,95 @@ var DeeplineClient = class {
     );
     return response.plays ?? [];
   }
+  /** Read product-notification destinations, subscriptions, event catalog, and DLQ health. */
+  async getNotificationSettings() {
+    return this.http.get("/api/v2/settings/notifications");
+  }
+  /** Start the Slack OAuth flow required by product notifications. */
+  async connectNotificationSlack(options) {
+    return this.http.post("/api/v2/integrations/connect", {
+      provider: "slack",
+      scopes: [...PRODUCT_NOTIFICATION_SLACK_OAUTH_SCOPES],
+      ...options?.successUrl ? { success_url: options.successUrl } : {},
+      ...options?.failureUrl ? { failure_url: options.failureUrl } : {}
+    });
+  }
+  /** List Slack channels visible to the connected Deepline Slack app. */
+  async listNotificationSlackChannels(query) {
+    const suffix = query ? `?query=${encodeURIComponent(query)}` : "";
+    return this.http.get(`/api/v2/settings/notifications/channels${suffix}`);
+  }
+  /** Select the Slack channel used for product notifications. */
+  async setNotificationSlack(channel) {
+    return this.http.put("/api/v2/settings/notifications", { channel });
+  }
+  /** Send one synchronous test ping and return Slack's delivery result. */
+  async testNotificationSlack() {
+    return this.http.post("/api/v2/settings/notifications/test", {});
+  }
+  /** Disable Slack product notifications without deleting the OAuth connection. */
+  async disableNotificationSlack() {
+    return this.http.delete("/api/v2/settings/notifications");
+  }
+  /** Enable or disable event IDs from the server-provided notification catalog. */
+  async setNotificationSubscriptions(eventTypes, enabled) {
+    return this.http.patch("/api/v2/settings/notifications/subscriptions", {
+      eventTypes,
+      enabled
+    });
+  }
+  /** List exhausted deliveries. Dead-lettered messages never replay automatically. */
+  async listNotificationDlq(limit = 25) {
+    return this.http.get(
+      `/api/v2/settings/notifications/dlq?limit=${encodeURIComponent(String(limit))}`
+    );
+  }
+  /** Inspect one exhausted notification delivery. */
+  async getNotificationDlqDelivery(deliveryId) {
+    return this.http.get(
+      `/api/v2/settings/notifications/dlq/${encodeURIComponent(deliveryId)}`
+    );
+  }
+  /** Explicitly retry or archive one dead-lettered notification delivery. */
+  async updateNotificationDlqDelivery(deliveryId, action) {
+    return this.http.post(
+      `/api/v2/settings/notifications/dlq/${encodeURIComponent(deliveryId)}`,
+      { action }
+    );
+  }
+  /** List the workspace's named notification rules. */
+  async getNotifications() {
+    return this.http.get("/api/v2/notifications");
+  }
+  /** List Slack channels available to an already-connected Slack integration. */
+  async listNotificationChannels(query) {
+    const suffix = query ? `?search=${encodeURIComponent(query)}` : "";
+    return this.http.get(`/api/v2/notifications/slack/channels${suffix}`);
+  }
+  /** Create a named notification routed through an existing provider integration. */
+  async createNotification(input) {
+    return this.http.post("/api/v2/notifications", input);
+  }
+  /** Update a notification's target, event selection, or enabled state. */
+  async updateNotification(notificationId, input) {
+    return this.http.patch(
+      `/api/v2/notifications/${encodeURIComponent(notificationId)}`,
+      input
+    );
+  }
+  /** Send a validation ping to one notification. */
+  async testNotification(notificationId) {
+    return this.http.post(
+      `/api/v2/notifications/${encodeURIComponent(notificationId)}/test`,
+      {}
+    );
+  }
+  /** Archive one notification without touching its provider integration. */
+  async deleteNotification(notificationId) {
+    return this.http.delete(
+      `/api/v2/notifications/${encodeURIComponent(notificationId)}`
+    );
+  }
   /**
    * Search callable plays and return compact play descriptions.
    *

package/dist/install-integrity.json

@@ -202,6 +202,7 @@
     "dist/bundling-sources/shared_libs/plays/static-pipeline.ts",
     "dist/bundling-sources/shared_libs/plays/tool-category-descriptions.ts",
     "dist/bundling-sources/shared_libs/plays/tool-codegen.ts",
+    "dist/bundling-sources/shared_libs/product-notifications/contract.ts",
     "dist/bundling-sources/shared_libs/runtime-env.ts",
     "dist/bundling-sources/shared_libs/security/outbound-url-policy.ts",
     "dist/bundling-sources/shared_libs/security/safe-fetch.ts",

package/package.json

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