deepline 0.2.39 → 0.2.41

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.41",
   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;
@@ -2933,6 +2991,7 @@ async function* observeRunEvents(options) {
 // ../shared_libs/integrations/theirstack-execution-policy.ts
 var THEIRSTACK_SLOW_JOB_SEARCH_PROVIDER_TIMEOUT_MS = 135e3;
 var THEIRSTACK_SLOW_JOB_SEARCH_CLIENT_TIMEOUT_MS = 6e4 + THEIRSTACK_SLOW_JOB_SEARCH_PROVIDER_TIMEOUT_MS + 15e3;
+var THEIRSTACK_COMPANY_SEARCH_CLIENT_TIMEOUT_MS = 21e4;
 var LONG_JOB_SEARCH_WINDOW_MS = 365 * 24 * 60 * 60 * 1e3;
 var DATE_ONLY_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
 function parseDateOnly(value) {
@@ -2976,6 +3035,12 @@ function usesExtendedTheirstackJobSearchBudget(endpointId, payload) {
   const maxAgeDays = parseMaxAgeDays(payload.posted_at_max_age_days);
   return maxAgeDays !== null && maxAgeDays >= 365 ? true : usesLongExplicitDateWindow(payload);
 }
+function resolveTheirstackClientTimeoutMs(endpointId, payload) {
+  if (endpointId === "theirstack_company_search") {
+    return THEIRSTACK_COMPANY_SEARCH_CLIENT_TIMEOUT_MS;
+  }
+  return usesExtendedTheirstackJobSearchBudget(endpointId, payload) ? THEIRSTACK_SLOW_JOB_SEARCH_CLIENT_TIMEOUT_MS : null;
+}
 
 // ../shared_libs/play-runtime/backend.ts
 var PLAY_RUNTIME_BACKENDS = {
@@ -3222,9 +3287,11 @@ function resolveToolExecuteTimeoutMs(toolId, input) {
       return Math.floor(requestedTimeoutMs) + APIFY_SYNC_RESPONSE_GRACE_MS;
     }
   }
-  if (usesExtendedTheirstackJobSearchBudget(normalized, input)) {
-    return THEIRSTACK_SLOW_JOB_SEARCH_CLIENT_TIMEOUT_MS;
-  }
+  const theirstackTimeoutMs = resolveTheirstackClientTimeoutMs(
+    normalized,
+    input
+  );
+  if (theirstackTimeoutMs !== null) return theirstackTimeoutMs;
   return normalized === "deeplineagent" || normalized === "deeplineagent_deeplineagent" || normalized === "ai_inference" || normalized === "deeplineagent_ai_inference" || normalized === "aiinference" ? DEEPLINEAGENT_EXECUTE_TIMEOUT_MS : void 0;
 }
 var RUNS_FAILED_LOG_LIMIT = 20;
@@ -5097,6 +5164,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.
    *