deepline 0.3.86 → 0.3.87

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

@@ -88,11 +88,11 @@ import type { PlayStagedFileRef } from './plays/local-file-discovery.js';
 import type { PlayCompilerManifest } from '../../shared_libs/plays/compiler-manifest.js';
 import type { EnrichCompiledConfig } from './cli/enrich-play-compiler.js';
 import { RUNTIME_ENVIRONMENT_TOKEN_HEADER } from '../../shared_libs/play-runtime/coordinator-headers.js';
-import { resolveTheirstackClientTimeoutMs } from '../../shared_libs/integrations/theirstack-execution-policy.js';
+import { resolveTheirstackClientTimeoutMs } from '../../shared_libs/integration-contracts/theirstack/execution-policy.js';
 import {
   BETTERCONTACT_LAUNCHER_CLIENT_TIMEOUT_MS,
   usesExtendedBetterContactLauncherBudget,
-} from '../../shared_libs/integrations/bettercontact-execution-policy.js';
+} from '../../shared_libs/integration-contracts/bettercontact/execution-policy.js';
 import {
   normalizePlayRuntimeEnvironment,
   normalizePlayRuntimeNamespace,

package/dist/bundling-sources/sdk/src/monitor-fleet-contract.ts

@@ -1,7 +1,7 @@
 /**
  * The fleet member ceiling, mirrored — deliberately a literal.
  *
- * The canonical declaration is shared_libs/monitors/monitor-fleet-limits.ts,
+ * The canonical declaration is packages/monitors/monitor-fleet-limits.ts,
  * which the Convex commit mutation reads to size its transaction. This package
  * cannot import it: the workspace-architecture ratchet forbids NEW shared_libs
  * imports from packages absolutely (only relocations of pre-existing edges

package/dist/bundling-sources/sdk/src/plays/bundle-play-file.ts

@@ -84,7 +84,7 @@ let hasWarnedAboutNonDevelopmentBundling = false;
  * The SDK's job is to turn a local play file into a portable artifact using
  * only SDK/runtime sources. It must work for installed packages, source
  * checkouts, CI smoke jobs, and clean worktrees without app-generated files
- * such as `src/lib/generated/tool-typecheck-catalog.jsonl`.
+ * such as `packages/integrations/generated/tool-typecheck-catalog.jsonl`.
  *
  * Tool-aware validation belongs to the Deepline API after upload:
  * `compilePlayManifest` / server preflight runs the cloud typechecker inside

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

@@ -199,7 +199,7 @@ export const SDK_RELEASE = {
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
-  version: '0.3.86',
+  version: '0.3.87',
   updateSummary:
     'Automatic CLI updates are now enabled by default. To opt out, run `deepline settings autoupdate off`; use `deepline settings autoupdate on` to re-enable updates or `deepline settings autoupdate pin <version>` to hold an exact release. This release also adds raw-v2 tool responses at toolResponse.rawV2 while preserving existing toolResponse.raw and declared getters.',
   packageCapabilities: {

package/dist/bundling-sources/shared_libs/integration-contracts/AGENTS.md

@@ -0,0 +1,9 @@
+# Integration Contracts
+
+This package is the only integration-owned boundary shared with public clients.
+
+- Put a value here only when both `packages/integrations` and a public client such as `packages/sdk` must interpret it identically.
+- Keep contracts pure and dependency-light. Do not import provider runtimes, generated catalogs, credentials, billing implementations, action schemas, or application code.
+- Provider implementations and server-only policy remain in `packages/integrations`.
+- The public SDK bundles this package; it must not acquire a runtime dependency on a private workspace package.
+- Prefer a server-driven protocol over adding provider-specific client knowledge when compatibility permits it.

package/dist/bundling-sources/shared_libs/integration-contracts/README.md

@@ -0,0 +1,3 @@
+# `@deepline/integration-contracts`
+
+Pure contracts that must be interpreted identically by integration runtimes and public clients. Server-only integration code belongs in `packages/integrations`; SDK-only behavior belongs in `packages/sdk`.

package/dist/bundling-sources/shared_libs/integration-contracts/index.ts

@@ -0,0 +1,2 @@
+export * from './bettercontact/execution-policy';
+export * from './theirstack/execution-policy';

package/dist/bundling-sources/shared_libs/monitors/analytics-install-guides.ts

@@ -0,0 +1,77 @@
+export type AnalyticsInstallGuide = {
+  id: 'html' | 'wordpress' | 'react' | 'nextjs' | 'gtm' | 'webflow' | 'shopify';
+  label: string;
+  steps: string[];
+};
+
+/** Kept as data so the UI, email preview, and regression test share one guide source. */
+export const ANALYTICS_INSTALL_GUIDES: readonly AnalyticsInstallGuide[] = [
+  {
+    id: 'html',
+    label: 'HTML',
+    steps: [
+      'Open the shared layout or template used by every page.',
+      'Paste the loader immediately before the closing </head> tag, publish, then validate below.',
+    ],
+  },
+  {
+    id: 'wordpress',
+    label: 'WordPress',
+    steps: [
+      'Install or open WPCode / Insert Headers and Footers.',
+      'Add the loader to the site-wide Header area, save it, clear any cache, then validate below.',
+    ],
+  },
+  {
+    id: 'react',
+    label: 'React',
+    steps: [
+      'Open the root HTML template (usually public/index.html).',
+      'Paste the loader in <head>, not inside a rendered component, deploy, then validate below.',
+    ],
+  },
+  {
+    id: 'nextjs',
+    label: 'Next.js',
+    steps: [
+      'Open app/layout.tsx (or pages/_document.tsx in the Pages Router).',
+      'Use the Next.js code below once in the document head, deploy, then validate below.',
+    ],
+  },
+  {
+    id: 'gtm',
+    label: 'Google Tag Manager',
+    steps: [
+      'Create a new Custom HTML tag and paste the loader.',
+      'Trigger it on All Pages, publish the container, then validate below.',
+    ],
+  },
+  {
+    id: 'webflow',
+    label: 'Webflow',
+    steps: [
+      'Open Project settings → Custom code.',
+      'Paste the loader in Head code, publish the site, then validate below.',
+    ],
+  },
+  {
+    id: 'shopify',
+    label: 'Shopify',
+    steps: [
+      'Open Online Store → Themes → Edit code → layout/theme.liquid.',
+      'Paste the loader immediately before </head>, save the theme, then validate below.',
+    ],
+  },
+];
+
+function scriptBody(loader: string) {
+  return loader.replace(/^<script>\s*/i, '').replace(/\s*<\/script>$/i, '');
+}
+
+export function analyticsGuideCode(
+  guide: AnalyticsInstallGuide,
+  loader: string,
+) {
+  if (guide.id !== 'nextjs') return loader;
+  return `import Script from 'next/script';\n\n<Script\n  id="deepline-analytics"\n  strategy="afterInteractive"\n  dangerouslySetInnerHTML={{ __html: ${JSON.stringify(scriptBody(loader))} }}\n/>`;
+}

package/dist/bundling-sources/shared_libs/monitors/billing/charges.ts

@@ -0,0 +1,125 @@
+import type {
+  MonitorBillingPhase,
+  MonitorBillingPolicy,
+  MonitorRetailCharge,
+  MonitorRetailChargeComponent,
+} from '@deepline/monitors/billing/types';
+
+export type MonitorCustomerChargeQuote = {
+  providerCapability: string;
+  phase: MonitorBillingPhase;
+  providerCostKey?: string;
+  knownCredits: number;
+  pendingProviderCostKeys: string[];
+  components: readonly MonitorRetailChargeComponent[];
+};
+
+export type PublicMonitorCustomerChargeSummary = {
+  phase: Extract<MonitorBillingPhase, 'create' | 'reactivate'>;
+  label: string;
+  known_credits: number;
+  pending_provider_pricing: boolean;
+  display: string;
+  variable_by_payload?: boolean;
+};
+
+function chargesForPhase(
+  policy: MonitorBillingPolicy,
+  phase: MonitorBillingPhase,
+): MonitorRetailCharge[] {
+  return [
+    policy.customerCreateCharge,
+    policy.customerReactivateCharge,
+    ...policy.customerUsageCharges,
+  ].filter((charge) => charge.phase === phase);
+}
+
+export function quoteMonitorCustomerCharge(input: {
+  policy: MonitorBillingPolicy;
+  phase: MonitorBillingPhase;
+  providerCostKey?: string;
+}): MonitorCustomerChargeQuote {
+  let knownCredits = 0;
+  const pendingProviderCostKeys: string[] = [];
+  const components = chargesForPhase(input.policy, input.phase)
+    .flatMap((charge) => charge.components)
+    .filter(
+      (component) =>
+        component.kind !== 'upstream_cost_markup' ||
+        !input.providerCostKey ||
+        component.providerCostKey === input.providerCostKey,
+    );
+
+  for (const component of components) {
+    if (component.kind === 'fixed_deepline_credits') {
+      knownCredits += component.credits;
+    }
+    if (component.kind === 'upstream_cost_markup') {
+      if (typeof component.retailCredits === 'number') {
+        knownCredits += component.retailCredits;
+      } else {
+        pendingProviderCostKeys.push(component.providerCostKey);
+      }
+    }
+  }
+
+  return {
+    providerCapability: input.policy.providerCapability,
+    phase: input.phase,
+    ...(input.providerCostKey
+      ? { providerCostKey: input.providerCostKey }
+      : {}),
+    knownCredits,
+    pendingProviderCostKeys,
+    components,
+  };
+}
+
+function formatCredits(credits: number) {
+  return `${credits.toLocaleString('en')} Deepline ${
+    credits === 1 ? 'credit' : 'credits'
+  }`;
+}
+
+export function publicMonitorCustomerChargeSummary(input: {
+  policy: MonitorBillingPolicy;
+  phase: Extract<MonitorBillingPhase, 'create' | 'reactivate'>;
+}): PublicMonitorCustomerChargeSummary {
+  if (input.policy.payloadPricing) {
+    const primaryCharge =
+      input.phase === 'create'
+        ? input.policy.customerCreateCharge
+        : input.policy.customerReactivateCharge;
+    return {
+      phase: input.phase,
+      label: primaryCharge.label,
+      known_credits: 0,
+      pending_provider_pricing: false,
+      variable_by_payload: true,
+      display: `Varies by ${input.policy.payloadPricing.discriminator}; see per-type pricing.`,
+    };
+  }
+  const quote = quoteMonitorCustomerCharge(input);
+  const primaryCharge =
+    input.phase === 'create'
+      ? input.policy.customerCreateCharge
+      : input.policy.customerReactivateCharge;
+  const hasPendingProviderPricing = quote.pendingProviderCostKeys.length > 0;
+  const display = hasPendingProviderPricing
+    ? quote.knownCredits > 0
+      ? `At least ${formatCredits(
+          quote.knownCredits,
+        )}; provider-specific monitor pricing is still being resolved.`
+      : 'Provider-specific monitor pricing is still being resolved.'
+    : quote.knownCredits > 0
+      ? formatCredits(quote.knownCredits)
+      : 'No Deepline credits';
+
+  return {
+    phase: input.phase,
+    label: primaryCharge.label,
+    known_credits: quote.knownCredits,
+    pending_provider_pricing: hasPendingProviderPricing,
+    display,
+  };
+}