deepline 0.1.119 → 0.1.120

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

@@ -0,0 +1,146 @@
+/**
+ * GTM normalization primitives used by generated plays and user-authored
+ * prospecting notebooks.
+ *
+ * Keep these helpers small, deterministic, and schema-shaped. They are not an
+ * agent or a provider policy layer; they are the shared vocabulary for turning
+ * messy GTM rows into contact/account fields that Deepline plays understand.
+ * As provider enums and row conventions get sharper, improve them here so
+ * bootstrapped plays get better without carrying more generated glue.
+ *
+ * Do not add helpers that extract values from tool/play results. Result values
+ * should come from declared getters (`extractedValues.email.get()`) or declared
+ * play output fields (`result.email`). Helpers in this file normalize input
+ * rows and candidate entities, not opaque execution envelopes.
+ */
+
+export type GtmRow = Record<string, unknown>;
+
+export type GtmContact = GtmRow & {
+  first_name: string;
+  last_name: string;
+  domain: string;
+  company_name: string;
+  linkedin_url: string;
+  title: string;
+  email: string;
+  phone: string;
+};
+
+export function normalizeGtmRows(value: unknown): GtmRow[] {
+  if (!value) return [];
+  if (Array.isArray(value)) return value.filter(isRecord);
+  if (isRecord(value)) {
+    for (const key of ['rows', 'people', 'contacts', 'companies', 'data']) {
+      const nested = value[key];
+      if (Array.isArray(nested)) return nested.filter(isRecord);
+    }
+  }
+  return [];
+}
+
+export function normalizeGtmContact(row: GtmRow): GtmContact {
+  const first = pickString(row, [
+    'first_name',
+    'FIRST_NAME',
+    'firstName',
+    'first',
+    'firstname',
+    'First Name',
+    'given_name',
+    'givenName',
+  ]);
+  const last = pickString(row, [
+    'last_name',
+    'LAST_NAME',
+    'lastName',
+    'last',
+    'lastname',
+    'Last Name',
+    'family_name',
+    'familyName',
+  ]);
+  const full = pickString(row, [
+    'full_name',
+    'FULL_NAME',
+    'name',
+    'person_name',
+  ]);
+  const split = splitName(full);
+  return {
+    ...row,
+    first_name: first || split.first,
+    last_name: last || split.last,
+    domain: pickString(row, [
+      'domain',
+      'DOMAIN',
+      'company_domain',
+      'COMPANY_DOMAIN',
+      'companyDomain',
+      'website_domain',
+      'company website',
+      'Company Domain',
+      'Website',
+      'website',
+    ]),
+    company_name: pickString(row, [
+      'company_name',
+      'COMPANY_NAME',
+      'company',
+      'organization_name',
+      'account_name',
+      'Company',
+      'Account',
+    ]),
+    linkedin_url: pickString(row, [
+      'linkedin_url',
+      'LINKEDIN_URL',
+      'linkedin',
+      'person_linkedin_url',
+      'linkedin_profile',
+      'LinkedIn',
+    ]),
+    title: pickString(row, [
+      'title',
+      'TITLE',
+      'job_title',
+      'headline',
+      'Job Title',
+    ]),
+    email: pickString(row, [
+      'email',
+      'EMAIL',
+      'work_email',
+      'workEmail',
+      'Work Email',
+    ]),
+    phone: pickString(row, [
+      'phone',
+      'PHONE',
+      'phone_number',
+      'phoneNumber',
+      'mobile',
+      'Mobile Phone',
+    ]),
+  };
+}
+
+function isRecord(value: unknown): value is GtmRow {
+  return Boolean(value && typeof value === 'object' && !Array.isArray(value));
+}
+
+function pickString(row: GtmRow, names: string[]): string {
+  for (const name of names) {
+    const value = row[name];
+    if (typeof value === 'string' && value.trim()) return value.trim();
+  }
+  return '';
+}
+
+function splitName(value: string): { first: string; last: string } {
+  const parts = String(value || '')
+    .trim()
+    .split(/\s+/)
+    .filter(Boolean);
+  return { first: parts[0] ?? '', last: parts.slice(1).join(' ') };
+}

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

@@ -0,0 +1,12 @@
+/**
+ * Public helper shelf for generated plays and user-authored Deepline notebooks.
+ *
+ * Design intent: root `deepline` stays focused on SDK/runtime primitives like
+ * `definePlay`, while `deepline/helpers` carries reusable domain helpers that
+ * make generated plays smaller and easier to improve over time. Keep this file
+ * as a curated export surface, not a junk drawer; helper families should stay
+ * deterministic, dependency-light, and safe to run inside play workers.
+ */
+
+export { normalizeGtmContact, normalizeGtmRows } from './gtm.js';
+export type { GtmContact, GtmRow } from './gtm.js';

package/dist/{repo → bundling-sources}/sdk/src/index.ts

@@ -35,7 +35,8 @@
  * });
  * ```
  *
- * Then run: `deepline plays run --file my-play.play.ts --watch`
+ * Then run with the CLI: `deepline plays run --file my-play.play.ts --watch`
+ * Installed npm CLIs can also run saved or prebuilt plays by name.
  *
  * ## Architecture
  *

package/dist/{repo → bundling-sources}/sdk/src/play.ts

@@ -38,7 +38,9 @@
  * });
  * ```
  *
- * Then run via CLI: `deepline plays run --file my-play.play.ts --watch`
+ * Then run via the CLI:
+ * `deepline plays run --file my-play.play.ts --watch`.
+ * Installed npm CLIs can also run saved or prebuilt plays by name.
  *
  * ### Programmatic usage
  *

package/dist/{repo → bundling-sources}/sdk/src/plays/bundle-play-file.ts

@@ -46,19 +46,29 @@ const SOURCE_REPO_ROOT = resolve(SDK_PACKAGE_ROOT, '..');
 const HAS_SOURCE_BUNDLING_SOURCES = existsSync(
   resolve(SOURCE_REPO_ROOT, 'apps', 'play-runner-workers', 'src', 'entry.ts'),
 );
-const PACKAGED_REPO_ROOT = resolve(SDK_PACKAGE_ROOT, 'dist', 'repo');
+const PACKAGED_BUNDLING_SOURCE_ROOT = resolve(
+  SDK_PACKAGE_ROOT,
+  'dist',
+  'bundling-sources',
+);
 const HAS_PACKAGED_BUNDLING_SOURCES = existsSync(
-  resolve(PACKAGED_REPO_ROOT, 'apps', 'play-runner-workers', 'src', 'entry.ts'),
+  resolve(
+    PACKAGED_BUNDLING_SOURCE_ROOT,
+    'apps',
+    'play-runner-workers',
+    'src',
+    'entry.ts',
+  ),
 );
 const PROJECT_ROOT = HAS_SOURCE_BUNDLING_SOURCES
   ? SOURCE_REPO_ROOT
   : HAS_PACKAGED_BUNDLING_SOURCES
-    ? PACKAGED_REPO_ROOT
+    ? PACKAGED_BUNDLING_SOURCE_ROOT
     : resolve(SDK_PACKAGE_ROOT, '..');
 const SDK_SOURCE_ROOT = HAS_SOURCE_BUNDLING_SOURCES
   ? resolve(SOURCE_REPO_ROOT, 'sdk', 'src')
   : HAS_PACKAGED_BUNDLING_SOURCES
-    ? resolve(PACKAGED_REPO_ROOT, 'sdk', 'src')
+    ? resolve(PACKAGED_BUNDLING_SOURCE_ROOT, 'sdk', 'src')
     : resolve(SDK_PACKAGE_ROOT, 'src');
 const SDK_PACKAGE_JSON = resolve(SDK_PACKAGE_ROOT, 'package.json');
 const SDK_ENTRY_FILE = resolve(SDK_SOURCE_ROOT, 'index.ts');
@@ -126,7 +136,9 @@ function defaultPlayBundleTarget(): PlayArtifactKind {
 export function createSdkPlayBundlingAdapter(): PlayBundlingAdapter {
   return {
     projectRoot: PROJECT_ROOT,
-    nodeModulesDir: resolve(PROJECT_ROOT, 'node_modules'),
+    nodeModulesDir: HAS_PACKAGED_BUNDLING_SOURCES
+      ? resolve(SDK_PACKAGE_ROOT, 'node_modules')
+      : resolve(PROJECT_ROOT, 'node_modules'),
     cacheDir: join(
       tmpdir(),
       `deepline-play-artifacts-v${PLAY_BUNDLE_CACHE_VERSION}`,

package/dist/{repo → bundling-sources}/sdk/src/release.ts

@@ -99,10 +99,10 @@ export const SDK_RELEASE = {
   // skill on the sdk sync surface, and the people-search-to-email prebuilt.
   // 0.1.108 ships explicit dataset column/tool recompute policy and removes
   // the SDK enrich generator's one-second stale policy.
-  version: '0.1.119',
+  version: '0.1.120',
   apiContract: '2026-06-dataset-column-cell-stale-hard-cutover',
   supportPolicy: {
-    latest: '0.1.119',
+    latest: '0.1.120',
     minimumSupported: '0.1.53',
     deprecatedBelow: '0.1.53',
     commandMinimumSupported: [

package/dist/{repo → bundling-sources}/sdk/src/runs/observe-transport.ts

@@ -233,9 +233,8 @@ export async function* observeRunEvents(
   if (typeof WebSocket === 'undefined') {
     // Node 18/20 have no global WebSocket; use the ws shim.
     try {
-      // 'ws' lives in sdk/package.json (not the repo root, which typechecks
-      // this file without sdk's node_modules) — resolve dynamically so the
-      // root tsc does not need @types/ws.
+      // Optional transport helper: thin SDK installs omit this and fall back to
+      // the canonical SSE tail path instead of pulling a websocket stack.
       const wsModuleName = 'ws';
       const ws = (await import(wsModuleName)) as { default: unknown };
       webSocketConstructor = ws.default as typeof WebSocket;

package/dist/bundling-sources/shared_libs/play-data-plane/index.ts

@@ -0,0 +1,3 @@
+export * from './cell-policy';
+export * from './column-names';
+export * from './sheet-contract';