deepline 0.3.108 → 0.3.110

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

@@ -200,7 +200,7 @@ export const SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: '0.3.108',
+  version: '0.3.110',
   updateSummary:
     'Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.',
   packageCapabilities: {

package/dist/bundling-sources/shared_libs/observability/scheduled-jobs.json

@@ -903,6 +903,24 @@
     "failureAlert": "convex_action_wrapper",
     "domainReportRequired": true
   },
+  {
+    "id": "convex.process-notification-usage-refreshes",
+    "name": "Process product notification usage refreshes",
+    "scheduler": "convex_cron",
+    "cadence": "every 60s",
+    "timezone": "UTC",
+    "source": "packages/convex/crons.ts",
+    "locator": "process notification usage refreshes",
+    "owner": "platform",
+    "criticality": "critical",
+    "purpose": "Recover missed usage-notification wakes and coalesce latest-state observations per organization.",
+    "successDefinition": "Queued usage wakes are observed and retired after their notification transaction commits; an empty queue is a valid no-op.",
+    "failureDefinition": "The worker cannot read or commit a batch, leaving usage wakes for the next retry and reporting the failure.",
+    "startGraceMs": 30000,
+    "runTimeoutMs": 1800000,
+    "failureAlert": "convex_action_wrapper",
+    "domainReportRequired": true
+  },
   {
     "id": "convex.fail-stale-play-deployments",
     "name": "Fail stale play deployments",

package/dist/bundling-sources/shared_libs/observability/scheduled-work-manual.ts

@@ -18,6 +18,7 @@ export const MANUALLY_RUNNABLE_CONVEX_CRON_JOB_IDS = [
   'convex.monitor-deployment-job-tick',
   'convex.provider-monitor-global-audit-daily',
   'convex.recover-notification-delivery-work',
+  'convex.process-notification-usage-refreshes',
   'convex.observe-operational-queue-health',
   'convex.cleanup-expired-notification-audit-records',
   'convex.fail-stale-play-deployments',

package/dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/runtime-queue-health.ts

@@ -409,26 +409,26 @@ function absurdProjectionQuery(queueTable: string): string {
       FROM ${table}
       WHERE state = 'pending' AND available_at <= $1::timestamptz
       ORDER BY available_at, run_id
-      LIMIT $3)
+      LIMIT $2)
       UNION ALL
       (SELECT 'delayed'::text, available_at
       FROM ${table}
       WHERE state = 'sleeping'
       ORDER BY available_at, run_id
-      LIMIT $3)
+      LIMIT $2)
       UNION ALL
       (SELECT 'delayed'::text, available_at
       FROM ${table}
       WHERE state = 'pending' AND available_at > $1::timestamptz
       ORDER BY available_at, run_id
-      LIMIT $3)
+      LIMIT $2)
       UNION ALL
       (SELECT 'in_flight'::text, coalesce(started_at, created_at)
       FROM ${table}
       WHERE state = 'running'
         AND (claim_expires_at IS NULL OR claim_expires_at > $1::timestamptz)
       ORDER BY available_at, run_id
-      LIMIT $3)
+      LIMIT $2)
       UNION ALL
       (SELECT 'blocked'::text, coalesce(claim_expires_at, started_at, created_at)
       FROM ${table}
@@ -436,30 +436,30 @@ function absurdProjectionQuery(queueTable: string): string {
         AND claim_expires_at IS NOT NULL
         AND claim_expires_at <= $1::timestamptz
       ORDER BY claim_expires_at, run_id
-      LIMIT $3)
+      LIMIT $2)
       UNION ALL
       (SELECT 'dead_lettered'::text, coalesce(failed_at, created_at)
       FROM ${table}
       WHERE state = 'failed'
       ORDER BY available_at, run_id
-      LIMIT $3)
+      LIMIT $2)
     )
     SELECT
-      least(count(*) FILTER (WHERE bucket = 'ready'), $4) AS ready,
-      least(count(*) FILTER (WHERE bucket = 'delayed'), $4) AS delayed,
-      least(count(*) FILTER (WHERE bucket = 'in_flight'), $4) AS in_flight,
-      least(count(*) FILTER (WHERE bucket = 'blocked'), $4) AS blocked,
-      least(count(*) FILTER (WHERE bucket = 'dead_lettered'), $4) AS dead_lettered,
+      least(count(*) FILTER (WHERE bucket = 'ready'), $3) AS ready,
+      least(count(*) FILTER (WHERE bucket = 'delayed'), $3) AS delayed,
+      least(count(*) FILTER (WHERE bucket = 'in_flight'), $3) AS in_flight,
+      least(count(*) FILTER (WHERE bucket = 'blocked'), $3) AS blocked,
+      least(count(*) FILTER (WHERE bucket = 'dead_lettered'), $3) AS dead_lettered,
       max(${intervalExpr('age_at')}) FILTER (WHERE bucket = 'ready') AS oldest_ready_ms,
       max(${intervalExpr('age_at')}) FILTER (WHERE bucket = 'delayed') AS oldest_delayed_ms,
       max(${intervalExpr('age_at')}) FILTER (WHERE bucket = 'in_flight') AS oldest_in_flight_ms,
       max(${intervalExpr('age_at')}) FILTER (WHERE bucket = 'blocked') AS oldest_blocked_ms,
       max(${intervalExpr('age_at')}) FILTER (WHERE bucket = 'dead_lettered') AS oldest_dead_lettered_ms,
-      count(*) FILTER (WHERE bucket = 'ready') > $4 AS ready_truncated,
-      count(*) FILTER (WHERE bucket = 'delayed') > $4 AS delayed_truncated,
-      count(*) FILTER (WHERE bucket = 'in_flight') > $4 AS in_flight_truncated,
-      count(*) FILTER (WHERE bucket = 'blocked') > $4 AS blocked_truncated,
-      count(*) FILTER (WHERE bucket = 'dead_lettered') > $4 AS dead_lettered_truncated,
+      count(*) FILTER (WHERE bucket = 'ready') > $3 AS ready_truncated,
+      count(*) FILTER (WHERE bucket = 'delayed') > $3 AS delayed_truncated,
+      count(*) FILTER (WHERE bucket = 'in_flight') > $3 AS in_flight_truncated,
+      count(*) FILTER (WHERE bucket = 'blocked') > $3 AS blocked_truncated,
+      count(*) FILTER (WHERE bucket = 'dead_lettered') > $3 AS dead_lettered_truncated,
       0::bigint AS admitted,
       0::bigint AS started,
       0::bigint AS completed,
@@ -493,34 +493,34 @@ function outboxProjectionQuery(schema: string): string {
       FROM ${table}
       WHERE delivered_at IS NULL AND failed_at IS NULL
       ORDER BY coalesce(next_attempt_at, created_at), created_at, event_id
-      LIMIT $3
+      LIMIT $2
     ), dead_sample AS (
       SELECT 'dead_lettered'::text AS bucket, coalesce(failed_at, created_at) AS age_at
       FROM ${table}
       WHERE delivered_at IS NULL AND failed_at IS NOT NULL
       ORDER BY failed_at, event_id
-      LIMIT $3
+      LIMIT $2
     ), sampled AS (
       SELECT * FROM pending_sample
       UNION ALL
       SELECT * FROM dead_sample
     )
     SELECT
-      least(count(*) FILTER (WHERE bucket = 'ready'), $4) AS ready,
-      least(count(*) FILTER (WHERE bucket = 'delayed'), $4) AS delayed,
-      least(count(*) FILTER (WHERE bucket = 'in_flight'), $4) AS in_flight,
-      least(count(*) FILTER (WHERE bucket = 'blocked'), $4) AS blocked,
-      least(count(*) FILTER (WHERE bucket = 'dead_lettered'), $4) AS dead_lettered,
+      least(count(*) FILTER (WHERE bucket = 'ready'), $3) AS ready,
+      least(count(*) FILTER (WHERE bucket = 'delayed'), $3) AS delayed,
+      least(count(*) FILTER (WHERE bucket = 'in_flight'), $3) AS in_flight,
+      least(count(*) FILTER (WHERE bucket = 'blocked'), $3) AS blocked,
+      least(count(*) FILTER (WHERE bucket = 'dead_lettered'), $3) AS dead_lettered,
       max(${intervalExpr('age_at')}) FILTER (WHERE bucket = 'ready') AS oldest_ready_ms,
       max(${intervalExpr('age_at')}) FILTER (WHERE bucket = 'delayed') AS oldest_delayed_ms,
       max(${intervalExpr('age_at')}) FILTER (WHERE bucket = 'in_flight') AS oldest_in_flight_ms,
       max(${intervalExpr('age_at')}) FILTER (WHERE bucket = 'blocked') AS oldest_blocked_ms,
       max(${intervalExpr('age_at')}) FILTER (WHERE bucket = 'dead_lettered') AS oldest_dead_lettered_ms,
-      count(*) FILTER (WHERE bucket <> 'dead_lettered') > $4 AS ready_truncated,
-      count(*) FILTER (WHERE bucket <> 'dead_lettered') > $4 AS delayed_truncated,
-      count(*) FILTER (WHERE bucket <> 'dead_lettered') > $4 AS in_flight_truncated,
-      count(*) FILTER (WHERE bucket <> 'dead_lettered') > $4 AS blocked_truncated,
-      count(*) FILTER (WHERE bucket = 'dead_lettered') > $4 AS dead_lettered_truncated,
+      count(*) FILTER (WHERE bucket <> 'dead_lettered') > $3 AS ready_truncated,
+      count(*) FILTER (WHERE bucket <> 'dead_lettered') > $3 AS delayed_truncated,
+      count(*) FILTER (WHERE bucket <> 'dead_lettered') > $3 AS in_flight_truncated,
+      count(*) FILTER (WHERE bucket <> 'dead_lettered') > $3 AS blocked_truncated,
+      count(*) FILTER (WHERE bucket = 'dead_lettered') > $3 AS dead_lettered_truncated,
       0::bigint AS admitted,
       0::bigint AS started,
       0::bigint AS completed,
@@ -556,23 +556,23 @@ function cleanupProjectionQuery(schema: string): string {
       FROM ${table}
       WHERE status <> 'deleted'
       ORDER BY available_at, created_at, provider, sandbox_id
-      LIMIT $3
+      LIMIT $2
     )
     SELECT
-      least(count(*) FILTER (WHERE bucket = 'ready'), $4) AS ready,
-      least(count(*) FILTER (WHERE bucket = 'delayed'), $4) AS delayed,
-      least(count(*) FILTER (WHERE bucket = 'in_flight'), $4) AS in_flight,
-      least(count(*) FILTER (WHERE bucket = 'blocked'), $4) AS blocked,
+      least(count(*) FILTER (WHERE bucket = 'ready'), $3) AS ready,
+      least(count(*) FILTER (WHERE bucket = 'delayed'), $3) AS delayed,
+      least(count(*) FILTER (WHERE bucket = 'in_flight'), $3) AS in_flight,
+      least(count(*) FILTER (WHERE bucket = 'blocked'), $3) AS blocked,
       0::bigint AS dead_lettered,
       max(${intervalExpr('age_at')}) FILTER (WHERE bucket = 'ready') AS oldest_ready_ms,
       max(${intervalExpr('age_at')}) FILTER (WHERE bucket = 'delayed') AS oldest_delayed_ms,
       max(${intervalExpr('age_at')}) FILTER (WHERE bucket = 'in_flight') AS oldest_in_flight_ms,
       max(${intervalExpr('age_at')}) FILTER (WHERE bucket = 'blocked') AS oldest_blocked_ms,
       NULL::bigint AS oldest_dead_lettered_ms,
-      count(*) > $4 AS ready_truncated,
-      count(*) > $4 AS delayed_truncated,
-      count(*) > $4 AS in_flight_truncated,
-      count(*) > $4 AS blocked_truncated,
+      count(*) > $3 AS ready_truncated,
+      count(*) > $3 AS delayed_truncated,
+      count(*) > $3 AS in_flight_truncated,
+      count(*) > $3 AS blocked_truncated,
       false AS dead_lettered_truncated,
       0::bigint AS admitted,
       0::bigint AS started,
@@ -658,7 +658,7 @@ export async function readRuntimeQueueHealthFromClient(
   for (const queueName of queueNames) {
     const result = await client.query<CountRow>(
       absurdProjectionQuery(`r_${queueName}`),
-      [now, now, sampleLimit + 1, sampleLimit],
+      [now, sampleLimit + 1, sampleLimit],
     );
     projections.push(
       projectionFromRow({
@@ -673,13 +673,11 @@ export async function readRuntimeQueueHealthFromClient(
   }
   const [outbox, cleanup] = await Promise.all([
     client.query<CountRow>(outboxProjectionQuery(schema), [
-      now,
       now,
       sampleLimit + 1,
       sampleLimit,
     ]),
     client.query<CountRow>(cleanupProjectionQuery(schema), [
-      now,
       now,
       sampleLimit + 1,
       sampleLimit,

package/dist/bundling-sources/shared_libs/product-notifications/catalog.ts

@@ -68,6 +68,8 @@ export type ProductNotificationPresentation = {
   subjectKind: string;
   subjectId: string;
   severity?: ProductNotificationSeverity;
+  /** Selects an alternate email layout; absent means the standard one. */
+  emailFormat?: 'thank_you';
 };
 
 type ProductNotificationRuleInput = {
@@ -233,6 +235,31 @@ function formatCredits(value: number): string {
   return value.toLocaleString('en-US', { maximumFractionDigits: 2 });
 }
 
+export const DEEPLINE_DOCS_URL = 'https://deepline.com/docs';
+
+/** Points a newly paying workspace at the docs to get value from Deepline. */
+const LEARN_DEEPLINE_DETAIL: NotificationText = [
+  'To learn more about how to use Deepline, ',
+  { link: 'check out the docs', href: DEEPLINE_DOCS_URL },
+  '.',
+];
+
+export const DEEPLINE_DEMO_URL =
+  'https://calendly.com/d/csdb-85z-t6z/deepline-demo';
+
+/**
+ * Growth welcomes lead with a demo call. One detail per line so the links read
+ * as a short list with the app's Lucide icons.
+ */
+const GROWTH_LEARN_MORE_DETAILS: NotificationText[] = [
+  'To learn more about Deepline:',
+  [{ icon: 'calendar' }, { link: 'Schedule a demo', href: DEEPLINE_DEMO_URL }],
+  [
+    { icon: 'book-open' },
+    { link: 'Check out the docs', href: DEEPLINE_DOCS_URL },
+  ],
+];
+
 /** One canonical registry owns every notification type's runtime and UI metadata. */
 const PRODUCT_NOTIFICATION_TYPE_REGISTRY = [
   {
@@ -546,6 +573,108 @@ const PRODUCT_NOTIFICATION_TYPE_REGISTRY = [
       },
     },
   },
+  {
+    id: 'credits.purchased',
+    eventName: ProductNotificationEvent.CreditsPurchaseCompleted,
+    requiredFilter: {},
+    allowedTriggers: ['threshold_crossing'],
+    catalog: {
+      name: 'Credit purchase thank-you',
+      category: 'credits',
+      description:
+        'Thank the workspace when a credit purchase of at least the chosen size completes.',
+      allowMultiple: false,
+      editor: {
+        kind: 'threshold',
+        label: 'Minimum credits',
+        defaultThreshold: 500,
+        minimum: 0,
+        suffix: 'credits',
+      },
+    },
+    rule: {
+      default: { ruleKey: 'default.credits_purchased', groupKey: 'default' },
+      create: (input, base, editor) => ({
+        ...base,
+        repeatMode: 'every_match',
+        trigger: {
+          kind: 'threshold_crossing',
+          direction: 'at_or_above',
+          threshold: input.threshold ?? defaultThreshold(editor),
+          unit: 'credits',
+        },
+      }),
+      validate: (trigger) => {
+        if (
+          trigger.kind !== 'threshold_crossing' ||
+          trigger.direction !== 'at_or_above' ||
+          trigger.unit !== 'credits'
+        ) {
+          throw new Error(
+            'Credit purchase rules must reach a purchased credit amount.',
+          );
+        }
+        if (!Number.isFinite(trigger.threshold) || trigger.threshold < 0) {
+          throw new Error(
+            'Credit purchase thresholds must be finite and nonnegative.',
+          );
+        }
+      },
+      present: ({ payload }) => ({
+        title: 'Thank you for your credit purchase',
+        summary: [
+          'Your ',
+          { workspace: true },
+          ' added ',
+          { strong: `${formatCredits(Number(payload.credits))} credits` },
+          '. Thank you for supporting Deepline.',
+        ],
+        details: [LEARN_DEEPLINE_DETAIL],
+        emailFormat: 'thank_you',
+        targetUrl: String(payload.targetUrl),
+        subjectKind: 'workspace',
+        subjectId: String(payload.accountId),
+      }),
+    },
+  },
+  {
+    id: 'plan.purchased',
+    eventName: ProductNotificationEvent.BillingPlanPurchased,
+    requiredFilter: {},
+    allowedTriggers: ['each_match'],
+    catalog: {
+      name: 'Plan welcome',
+      category: 'credits',
+      description: 'Thank the workspace when it purchases a plan.',
+      allowMultiple: false,
+      editor: { kind: 'none' },
+    },
+    rule: {
+      default: { ruleKey: 'default.plan_purchased', groupKey: 'default' },
+      create: (_input, base) => ({
+        ...base,
+        repeatMode: 'every_match',
+        trigger: { kind: 'each_match' },
+      }),
+      present: ({ payload }) => ({
+        title: `Welcome to ${payload.planName}`,
+        summary: [
+          'Your ',
+          { workspace: true },
+          ` is now on the ${payload.planName} plan. Thank you for supporting Deepline.`,
+        ],
+        // No credit-lifetime claims: they differ by plan.
+        details:
+          payload.offerKey === 'growth-v1'
+            ? GROWTH_LEARN_MORE_DETAILS
+            : [LEARN_DEEPLINE_DETAIL],
+        emailFormat: 'thank_you',
+        targetUrl: String(payload.targetUrl),
+        subjectKind: 'workspace',
+        subjectId: String(payload.accountId),
+      }),
+    },
+  },
   {
     id: 'play.failed',
     eventName: ProductNotificationEvent.PlayRunCompleted,

package/dist/bundling-sources/shared_libs/product-notifications/content.ts

@@ -1,7 +1,17 @@
 /** Type-owned content, independent of email markup and persisted audit strings. */
 export type NotificationText =
   | string
-  | readonly (string | { strong: string } | { workspace: true })[];
+  | readonly (
+      | string
+      | { strong: string }
+      | { workspace: true }
+      /** An absolute https link authored in code, never customer input. */
+      | { link: string; href: string }
+      /** A decorative brand icon; plain text omits it. */
+      | { icon: NotificationIcon }
+    )[];
+
+export type NotificationIcon = 'calendar' | 'book-open';
 
 export function notificationText(
   content: NotificationText,
@@ -12,6 +22,8 @@ export function notificationText(
     .map((part) => {
       if (typeof part === 'string') return part;
       if ('strong' in part) return part.strong;
+      if ('link' in part) return `${part.link} (${part.href})`;
+      if ('icon' in part) return '';
       return workspaceName ? `workspace ${workspaceName}` : 'workspace';
     })
     .join('');

package/dist/bundling-sources/shared_libs/product-notifications/default-policy.ts

@@ -14,7 +14,7 @@ import {
  * they create sparse copy-on-write overrides.
  */
 export const CURRENT_PRODUCT_NOTIFICATION_DEFAULT_POLICY = {
-  version: 5,
+  version: 6,
   groups: [
     {
       groupKey: 'default',

package/dist/bundling-sources/shared_libs/product-notifications/email.ts

@@ -32,10 +32,24 @@ type ProductNotificationEmailContent = {
   details: NotificationText[];
   targetUrl?: string;
   severity?: 'success' | 'warning' | 'error';
+  /**
+   * `thank_you` is the standard layout without the notification group header,
+   * with details shown as a compact list instead of divided rows. Kept as its
+   * own format so these emails can diverge later.
+   */
+  emailFormat?: 'thank_you';
 };
 
 const MAX_RECIPIENTS = 50;
 
+/**
+ * Lucide icons rasterized to 48px PNGs in the light-theme muted foreground
+ * color, served from `apps/deepline-api/public/brand/email`. Email clients do
+ * not render inline SVG.
+ */
+export const NOTIFICATION_ICON_BASE_URL =
+  'https://code.deepline.com/brand/email';
+
 const SEVERITY_STYLE: Record<
   NonNullable<ProductNotificationEmailContent['severity']>,
   { bg: string; text: string; label: string }
@@ -74,6 +88,14 @@ function unsubscribeUrl(value: string): string {
   return url.toString();
 }
 
+function externalLinkUrl(value: string): string {
+  const url = new URL(value);
+  if (url.protocol !== 'https:') {
+    throw new Error('Notification content links must use HTTPS.');
+  }
+  return url.toString();
+}
+
 function contentHtml(
   content: NotificationText,
   workspaceName?: string,
@@ -84,6 +106,10 @@ function contentHtml(
       if (typeof part === 'string') return escapeHtml(part);
       if ('strong' in part)
         return `<strong>${escapeHtml(part.strong)}</strong>`;
+      if ('link' in part)
+        return `<a href="${escapeHtml(externalLinkUrl(part.href))}" style="color:#0a0a0a;text-decoration:underline">${escapeHtml(part.link)}</a>`;
+      if ('icon' in part)
+        return `<img src="${NOTIFICATION_ICON_BASE_URL}/icon-${part.icon}.png" width="16" height="16" alt="" style="display:inline-block;vertical-align:-3px;margin-right:8px;border:0">`;
       return workspaceName
         ? `workspace <strong>${escapeHtml(workspaceName)}</strong>`
         : 'workspace';
@@ -95,8 +121,12 @@ function detailHtml(
   detail: NotificationText,
   workspaceName: string | undefined,
   borderBottom: boolean,
+  /** List-style rows: no dividers, tighter spacing. */
+  compact = false,
 ): string {
-  const border = borderBottom ? ';border-bottom:1px solid #f0f0f0' : '';
+  const border =
+    borderBottom && !compact ? ';border-bottom:1px solid #f0f0f0' : '';
+  const padding = compact ? '5px 0' : '12px 0';
   if (
     Array.isArray(detail) &&
     detail.length === 2 &&
@@ -109,7 +139,7 @@ function detailHtml(
     const value = typeof detail[1] === 'string' ? detail[1] : detail[1].strong;
     return `<table role="presentation" width="100%" cellspacing="0" cellpadding="0"><tr><td style="padding:12px 0${border};font-size:14px;color:#0a0a0a">${escapeHtml(detail[0].trimEnd())}</td><td align="right" style="padding:12px 0${border};font-size:14px;color:#0a0a0a${typeof detail[1] === 'string' ? '' : ';font-weight:600'}">${escapeHtml(value)}</td></tr></table>`;
   }
-  return `<p style="margin:0;padding:12px 0${border};font-size:14px;color:#0a0a0a">${contentHtml(detail, workspaceName)}</p>`;
+  return `<p style="margin:0;padding:${padding}${border};font-size:14px;color:#0a0a0a">${contentHtml(detail, workspaceName)}</p>`;
 }
 
 export function renderProductNotificationEmail(
@@ -155,9 +185,12 @@ export function renderProductNotificationEmail(
   const oneClickOptOutUrl = input.oneClickUnsubscribeUrl
     ? unsubscribeUrl(input.oneClickUnsubscribeUrl)
     : optOutUrl;
+  const showGroupHeader = input.content.emailFormat !== 'thank_you';
   const text = [
     input.content.title,
-    `Notification group: ${input.content.groupName}`,
+    ...(showGroupHeader
+      ? [`Notification group: ${input.content.groupName}`]
+      : []),
     ...(targetUrl ? [`Open Deepline: ${targetUrl}`] : []),
     '',
     notificationText(input.content.summary, input.workspaceName),
@@ -184,16 +217,25 @@ export function renderProductNotificationEmail(
     `<td align="left" valign="middle"><a href="${escapeHtml(logoUrl)}" style="display:inline-block;text-decoration:none"><img src="https://code.deepline.com/brand/logo_full_dark.png" width="120" height="auto" alt="Deepline" style="display:block;border:0"></a></td>`,
     `<td align="right" valign="middle">${severityBadge}</td>`,
     '</tr></table>',
-    '<p style="margin:0 0 16px">',
-    `<span style="font-size:12px;color:#a3a3a3;letter-spacing:.06em;text-transform:uppercase">${escapeHtml(input.content.groupName)}</span>`,
-    '</p>',
+    ...(showGroupHeader
+      ? [
+          '<p style="margin:0 0 16px">',
+          `<span style="font-size:12px;color:#a3a3a3;letter-spacing:.06em;text-transform:uppercase">${escapeHtml(input.content.groupName)}</span>`,
+          '</p>',
+        ]
+      : []),
     `<h1 style="margin:0 0 8px;font-size:22px;font-weight:600;color:#0a0a0a;line-height:1.3;letter-spacing:-0.02em">${escapeHtml(input.content.title)}</h1>`,
     `<p style="margin:0 0 24px;font-size:15px;line-height:1.6;color:#525252">${contentHtml(input.content.summary, input.workspaceName)}</p>`,
     ...(detailCount > 0
       ? [
-          '<table role="presentation" width="100%" cellspacing="0" cellpadding="0" style="border:1px solid #e5e5e5;border-radius:10px;margin:0 0 28px"><tr><td style="padding:4px 18px">',
+          `<table role="presentation" width="100%" cellspacing="0" cellpadding="0" style="border:1px solid #e5e5e5;border-radius:10px;margin:0 0 28px"><tr><td style="padding:${showGroupHeader ? '4px' : '11px'} 18px">`,
           ...input.content.details.map((detail, index) =>
-            detailHtml(detail, input.workspaceName, index < detailCount - 1),
+            detailHtml(
+              detail,
+              input.workspaceName,
+              index < detailCount - 1,
+              !showGroupHeader,
+            ),
           ),
           '</td></tr></table>',
         ]

package/dist/bundling-sources/shared_libs/product-notifications/events.ts

@@ -15,7 +15,9 @@ export const PRODUCT_NOTIFICATION_MAX_SOURCE_CLOCK_SKEW_MS = 5 * 60 * 1_000;
 
 export const ProductNotificationEvent = {
   CreditsBalanceChanged: 'credits.balance.changed',
+  CreditsPurchaseCompleted: 'credits.purchase.completed',
   CreditsUsageRecorded: 'credits.usage.recorded',
+  BillingPlanPurchased: 'billing.plan.purchased',
   MonitorLifecycleChanged: 'monitor.lifecycle.changed',
   PlayLifecycleChanged: 'play.lifecycle.changed',
   PlayRunCompleted: 'play.run.completed',
@@ -31,6 +33,7 @@ export type ProductNotificationEvent =
 
 export const ProductNotificationProducerKey = {
   BillingCredits: 'billing.credits',
+  BillingPlans: 'billing.plans',
   BillingUsage: 'billing.usage',
   MonitorsLifecycle: 'monitors.lifecycle',
   PlaysLifecycle: 'plays.lifecycle',
@@ -53,6 +56,8 @@ export const PRODUCT_NOTIFICATION_EVENT_NAMES = [
   ProductNotificationEvent.PlayRunCompleted,
   ProductNotificationEvent.WebhookDeliveryCompleted,
   ProductNotificationEvent.CreditsUsageRecorded,
+  ProductNotificationEvent.CreditsPurchaseCompleted,
+  ProductNotificationEvent.BillingPlanPurchased,
 ] as const;
 
 export const PRODUCT_NOTIFICATION_COMPATIBILITY_EVENT_NAMES = [
@@ -175,6 +180,33 @@ export const PRODUCT_NOTIFICATION_EVENT_DEFINITIONS: readonly ProductNotificatio
       allowedTriggers: ['threshold_crossing'],
       allowedThresholdUnits: ['percent', 'usage'],
     },
+    {
+      // One paid credit purchase (manual or automatic recharge) settled.
+      eventName: ProductNotificationEvent.CreditsPurchaseCompleted,
+      producerKey: ProductNotificationProducerKey.BillingCredits,
+      requiredFacts: {
+        accountId: 'string',
+        credits: 'number',
+        targetUrl: 'string',
+      },
+      orderingSubjectFact: 'accountId',
+      allowedTriggers: ['threshold_crossing'],
+      allowedThresholdUnits: ['credits'],
+    },
+    {
+      // The workspace moved onto a paid acquisition offer.
+      eventName: ProductNotificationEvent.BillingPlanPurchased,
+      producerKey: ProductNotificationProducerKey.BillingPlans,
+      requiredFacts: {
+        accountId: 'string',
+        offerKey: 'string',
+        planName: 'string',
+        targetUrl: 'string',
+      },
+      optionalFacts: { previousOfferKey: 'string' },
+      orderingSubjectFact: 'accountId',
+      allowedTriggers: ['each_match'],
+    },
     ...PRODUCT_NOTIFICATION_COMPATIBILITY_EVENT_NAMES.map((eventName) => ({
       eventName,
       producerKey: ProductNotificationProducerKey.LegacyProductNotifications,
@@ -396,6 +428,13 @@ export function adaptProductNotificationObservation(input: {
       unit: 'credits',
     };
   }
+  if (event.eventName === ProductNotificationEvent.CreditsPurchaseCompleted) {
+    return {
+      kind: 'threshold_state',
+      currentValue: Number(event.payload.credits),
+      unit: 'credits',
+    };
+  }
   const limit = Number(event.payload.limit);
   if (event.eventName === ProductNotificationEvent.CreditsUsageRecorded) {
     if (!(limit > 0)) throw new Error('Monthly usage limit must be positive.');

package/dist/cli/index.js

@@ -1298,7 +1298,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.108",
+  version: "0.3.110",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1

package/dist/cli/index.mjs

@@ -1271,7 +1271,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.108",
+  version: "0.3.110",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1

package/dist/index.d.mts

@@ -318,7 +318,17 @@ type NotificationText = string | readonly (string | {
     strong: string;
 } | {
     workspace: true;
+}
+/** An absolute https link authored in code, never customer input. */
+ | {
+    link: string;
+    href: string;
+}
+/** A decorative brand icon; plain text omits it. */
+ | {
+    icon: NotificationIcon;
 })[];
+type NotificationIcon = 'calendar' | 'book-open';
 
 /**
  * The sections the configuration surface skims by. Declared here so UI, API,
@@ -368,6 +378,8 @@ type ProductNotificationPresentation = {
     subjectKind: string;
     subjectId: string;
     severity?: ProductNotificationSeverity;
+    /** Selects an alternate email layout; absent means the standard one. */
+    emailFormat?: 'thank_you';
 };
 type ProductNotificationRuleInput = {
     ruleKey: string;
@@ -698,6 +710,143 @@ declare const PRODUCT_NOTIFICATION_TYPE_REGISTRY: readonly [{
             severity: "warning";
         };
     };
+}, {
+    readonly id: "credits.purchased";
+    readonly eventName: "credits.purchase.completed";
+    readonly requiredFilter: {};
+    readonly allowedTriggers: ["threshold_crossing"];
+    readonly catalog: {
+        readonly name: "Credit purchase thank-you";
+        readonly category: "credits";
+        readonly description: "Thank the workspace when a credit purchase of at least the chosen size completes.";
+        readonly allowMultiple: false;
+        readonly editor: {
+            readonly kind: "threshold";
+            readonly label: "Minimum credits";
+            readonly defaultThreshold: 500;
+            readonly minimum: 0;
+            readonly suffix: "credits";
+        };
+    };
+    readonly rule: {
+        readonly default: {
+            readonly ruleKey: "default.credits_purchased";
+            readonly groupKey: "default";
+        };
+        readonly create: (input: ProductNotificationRuleInput, base: ProductNotificationRuleBase, editor: {
+            kind: "threshold";
+            label: string;
+            defaultThreshold: number;
+            minimum: number;
+            maximum?: number;
+            suffix?: string;
+            /**
+             * When set, editors show and accept `remainingOf - threshold` (for
+             * example percent remaining) while the stored trigger stays in the
+             * runtime's "used" terms. Bounds and defaults are stored values.
+             */
+            remainingOf?: number;
+        } | {
+            kind: "play_failure";
+            defaultFailureCount: number;
+        } | {
+            kind: "play_scope";
+        } | {
+            kind: "none";
+        }) => {
+            repeatMode: "every_match";
+            trigger: {
+                kind: "threshold_crossing";
+                direction: "at_or_above";
+                threshold: number;
+                unit: string;
+            };
+            groupKey: string;
+            enabled: boolean;
+            conditionGeneration?: number | undefined;
+            ruleKey: string;
+            notificationType: string;
+            eventName: string;
+            eventFilter: ProductNotificationFacts;
+        };
+        readonly validate: (trigger: ProductNotificationTrigger) => void;
+        readonly present: ({ payload }: {
+            payload: ProductNotificationFacts;
+            trigger: ProductNotificationTrigger;
+            occurredAt?: number;
+        }) => {
+            title: string;
+            summary: (string | {
+                workspace: true;
+                strong?: undefined;
+            } | {
+                strong: string;
+                workspace?: undefined;
+            })[];
+            details: (readonly (string | {
+                strong: string;
+            } | {
+                workspace: true;
+            } | {
+                link: string;
+                href: string;
+            } | {
+                icon: NotificationIcon;
+            })[])[];
+            emailFormat: "thank_you";
+            targetUrl: string;
+            subjectKind: string;
+            subjectId: string;
+        };
+    };
+}, {
+    readonly id: "plan.purchased";
+    readonly eventName: "billing.plan.purchased";
+    readonly requiredFilter: {};
+    readonly allowedTriggers: ["each_match"];
+    readonly catalog: {
+        readonly name: "Plan welcome";
+        readonly category: "credits";
+        readonly description: "Thank the workspace when it purchases a plan.";
+        readonly allowMultiple: false;
+        readonly editor: {
+            readonly kind: "none";
+        };
+    };
+    readonly rule: {
+        readonly default: {
+            readonly ruleKey: "default.plan_purchased";
+            readonly groupKey: "default";
+        };
+        readonly create: (_input: ProductNotificationRuleInput, base: ProductNotificationRuleBase) => {
+            repeatMode: "every_match";
+            trigger: {
+                kind: "each_match";
+            };
+            groupKey: string;
+            enabled: boolean;
+            conditionGeneration?: number | undefined;
+            ruleKey: string;
+            notificationType: string;
+            eventName: string;
+            eventFilter: ProductNotificationFacts;
+        };
+        readonly present: ({ payload }: {
+            payload: ProductNotificationFacts;
+            trigger: ProductNotificationTrigger;
+            occurredAt?: number;
+        }) => {
+            title: string;
+            summary: (string | {
+                workspace: true;
+            })[];
+            details: NotificationText[];
+            emailFormat: "thank_you";
+            targetUrl: string;
+            subjectKind: string;
+            subjectId: string;
+        };
+    };
 }, {
     readonly id: "play.failed";
     readonly eventName: "play.run.completed";

package/dist/index.d.ts

@@ -318,7 +318,17 @@ type NotificationText = string | readonly (string | {
     strong: string;
 } | {
     workspace: true;
+}
+/** An absolute https link authored in code, never customer input. */
+ | {
+    link: string;
+    href: string;
+}
+/** A decorative brand icon; plain text omits it. */
+ | {
+    icon: NotificationIcon;
 })[];
+type NotificationIcon = 'calendar' | 'book-open';
 
 /**
  * The sections the configuration surface skims by. Declared here so UI, API,
@@ -368,6 +378,8 @@ type ProductNotificationPresentation = {
     subjectKind: string;
     subjectId: string;
     severity?: ProductNotificationSeverity;
+    /** Selects an alternate email layout; absent means the standard one. */
+    emailFormat?: 'thank_you';
 };
 type ProductNotificationRuleInput = {
     ruleKey: string;
@@ -698,6 +710,143 @@ declare const PRODUCT_NOTIFICATION_TYPE_REGISTRY: readonly [{
             severity: "warning";
         };
     };
+}, {
+    readonly id: "credits.purchased";
+    readonly eventName: "credits.purchase.completed";
+    readonly requiredFilter: {};
+    readonly allowedTriggers: ["threshold_crossing"];
+    readonly catalog: {
+        readonly name: "Credit purchase thank-you";
+        readonly category: "credits";
+        readonly description: "Thank the workspace when a credit purchase of at least the chosen size completes.";
+        readonly allowMultiple: false;
+        readonly editor: {
+            readonly kind: "threshold";
+            readonly label: "Minimum credits";
+            readonly defaultThreshold: 500;
+            readonly minimum: 0;
+            readonly suffix: "credits";
+        };
+    };
+    readonly rule: {
+        readonly default: {
+            readonly ruleKey: "default.credits_purchased";
+            readonly groupKey: "default";
+        };
+        readonly create: (input: ProductNotificationRuleInput, base: ProductNotificationRuleBase, editor: {
+            kind: "threshold";
+            label: string;
+            defaultThreshold: number;
+            minimum: number;
+            maximum?: number;
+            suffix?: string;
+            /**
+             * When set, editors show and accept `remainingOf - threshold` (for
+             * example percent remaining) while the stored trigger stays in the
+             * runtime's "used" terms. Bounds and defaults are stored values.
+             */
+            remainingOf?: number;
+        } | {
+            kind: "play_failure";
+            defaultFailureCount: number;
+        } | {
+            kind: "play_scope";
+        } | {
+            kind: "none";
+        }) => {
+            repeatMode: "every_match";
+            trigger: {
+                kind: "threshold_crossing";
+                direction: "at_or_above";
+                threshold: number;
+                unit: string;
+            };
+            groupKey: string;
+            enabled: boolean;
+            conditionGeneration?: number | undefined;
+            ruleKey: string;
+            notificationType: string;
+            eventName: string;
+            eventFilter: ProductNotificationFacts;
+        };
+        readonly validate: (trigger: ProductNotificationTrigger) => void;
+        readonly present: ({ payload }: {
+            payload: ProductNotificationFacts;
+            trigger: ProductNotificationTrigger;
+            occurredAt?: number;
+        }) => {
+            title: string;
+            summary: (string | {
+                workspace: true;
+                strong?: undefined;
+            } | {
+                strong: string;
+                workspace?: undefined;
+            })[];
+            details: (readonly (string | {
+                strong: string;
+            } | {
+                workspace: true;
+            } | {
+                link: string;
+                href: string;
+            } | {
+                icon: NotificationIcon;
+            })[])[];
+            emailFormat: "thank_you";
+            targetUrl: string;
+            subjectKind: string;
+            subjectId: string;
+        };
+    };
+}, {
+    readonly id: "plan.purchased";
+    readonly eventName: "billing.plan.purchased";
+    readonly requiredFilter: {};
+    readonly allowedTriggers: ["each_match"];
+    readonly catalog: {
+        readonly name: "Plan welcome";
+        readonly category: "credits";
+        readonly description: "Thank the workspace when it purchases a plan.";
+        readonly allowMultiple: false;
+        readonly editor: {
+            readonly kind: "none";
+        };
+    };
+    readonly rule: {
+        readonly default: {
+            readonly ruleKey: "default.plan_purchased";
+            readonly groupKey: "default";
+        };
+        readonly create: (_input: ProductNotificationRuleInput, base: ProductNotificationRuleBase) => {
+            repeatMode: "every_match";
+            trigger: {
+                kind: "each_match";
+            };
+            groupKey: string;
+            enabled: boolean;
+            conditionGeneration?: number | undefined;
+            ruleKey: string;
+            notificationType: string;
+            eventName: string;
+            eventFilter: ProductNotificationFacts;
+        };
+        readonly present: ({ payload }: {
+            payload: ProductNotificationFacts;
+            trigger: ProductNotificationTrigger;
+            occurredAt?: number;
+        }) => {
+            title: string;
+            summary: (string | {
+                workspace: true;
+            })[];
+            details: NotificationText[];
+            emailFormat: "thank_you";
+            targetUrl: string;
+            subjectKind: string;
+            subjectId: string;
+        };
+    };
 }, {
     readonly id: "play.failed";
     readonly eventName: "play.run.completed";

package/dist/index.js

@@ -860,7 +860,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.108",
+  version: "0.3.110",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1

package/dist/index.mjs

@@ -768,7 +768,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.108",
+  version: "0.3.110",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1

package/dist/release.d.mts

@@ -149,7 +149,7 @@ type SdkRelease = {
     supportPolicy: SdkSupportPolicy;
 };
 declare const SDK_RELEASE: {
-    readonly version: "0.3.108";
+    readonly version: "0.3.110";
     readonly updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.";
     readonly packageCapabilities: {
         readonly updatePreferences: 1;

package/dist/release.d.ts

@@ -149,7 +149,7 @@ type SdkRelease = {
     supportPolicy: SdkSupportPolicy;
 };
 declare const SDK_RELEASE: {
-    readonly version: "0.3.108";
+    readonly version: "0.3.110";
     readonly updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.";
     readonly packageCapabilities: {
         readonly updatePreferences: 1;

package/dist/release.js

@@ -74,7 +74,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.108",
+  version: "0.3.110",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1

package/dist/release.mjs

@@ -48,7 +48,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.108",
+  version: "0.3.110",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.3.108",
+  "version": "0.3.110",
   "description": "GTM data CLI and TypeScript SDK for coding agents",
   "license": "MIT",
   "homepage": "https://code.deepline.com",