deepline 0.1.3 → 0.1.7

package/dist/index.d.mts

@@ -1325,7 +1325,7 @@ declare class DeeplineClient {
     }>;
 }
 
-declare const SDK_VERSION = "0.1.3";
+declare const SDK_VERSION = "0.1.7";
 declare const SDK_API_CONTRACT = "2026-04-plays-v1";
 
 /**

package/dist/index.d.ts

@@ -1325,7 +1325,7 @@ declare class DeeplineClient {
     }>;
 }
 
-declare const SDK_VERSION = "0.1.3";
+declare const SDK_VERSION = "0.1.7";
 declare const SDK_API_CONTRACT = "2026-04-plays-v1";
 
 /**

package/dist/index.js

@@ -196,7 +196,7 @@ function resolveConfig(options) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.1.3";
+var SDK_VERSION = "0.1.7";
 var SDK_API_CONTRACT = "2026-04-plays-v1";
 
 // ../shared_libs/play-runtime/coordinator-headers.ts

package/dist/index.mjs

@@ -149,7 +149,7 @@ function resolveConfig(options) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.1.3";
+var SDK_VERSION = "0.1.7";
 var SDK_API_CONTRACT = "2026-04-plays-v1";
 
 // ../shared_libs/play-runtime/coordinator-headers.ts

package/dist/repo/sdk/src/cli/commands/auth.ts

@@ -98,6 +98,29 @@ function sleep(ms: number): Promise<void> {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
+function printDeeplineLogo(): void {
+  if (process.stdout.isTTY && (process.stdout.columns ?? 80) >= 70) {
+    console.log(' ██████╗  ███████╗ ███████╗ ██████╗  ██╗      ██╗ ███╗   ██╗ ███████╗');
+    console.log(' ██╔══██╗ ██╔════╝ ██╔════╝ ██╔══██╗ ██║      ██║ ████╗  ██║ ██╔════╝');
+    console.log(' ██║  ██║ █████╗   █████╗   ██████╔╝ ██║      ██║ ██╔██╗ ██║ █████╗');
+    console.log(' ██║  ██║ ██╔══╝   ██╔══╝   ██╔═══╝  ██║      ██║ ██║╚██╗██║ ██╔══╝');
+    console.log(' ██████╔╝ ███████╗ ███████╗ ██║      ███████╗ ██║ ██║ ╚████║ ███████╗');
+    console.log(' ╚═════╝  ╚══════╝ ╚══════╝ ╚═╝      ╚══════╝ ╚═╝ ╚═╝  ╚═══╝ ╚══════╝');
+    console.log('');
+    return;
+  }
+  console.log('DEEPLINE');
+}
+
+function printClaimSuccessBanner(statusData: Record<string, unknown>): void {
+  console.log('');
+  printDeeplineLogo();
+  console.log('✓ All set! Your CLI is connected.');
+  if (statusData.org_name) {
+    console.log(`  • Signed in with organization: ${statusData.org_name}`);
+  }
+}
+
 export async function handleRegister(args: string[]): Promise<number> {
   const baseUrl = autoDetectBaseUrl().replace(/\/$/, '');
 
@@ -189,12 +212,7 @@ export async function handleRegister(args: string[]): Promise<number> {
           DEEPLINE_API_KEY: apiKey,
           DEEPLINE_CLAIM_TOKEN: '',
         }, baseUrl);
-        console.log('');
-        console.log('DEEPLINE');
-        console.log('All set! Your CLI is connected.');
-        if (statusData.org_name) {
-          console.log(`  Signed in with organization: ${statusData.org_name}`);
-        }
+        printClaimSuccessBanner(statusData);
         return EXIT_OK;
       }
     }
@@ -262,7 +280,7 @@ export async function handleWait(args: string[]): Promise<number> {
           DEEPLINE_API_KEY: apiKey,
           DEEPLINE_CLAIM_TOKEN: '',
         }, baseUrl);
-        console.log('All set! Your CLI is connected.');
+        printClaimSuccessBanner(data);
         return EXIT_OK;
       }
     }

package/dist/repo/sdk/src/cli/commands/play.ts

@@ -1,6 +1,7 @@
 import { createHash } from 'node:crypto';
 import {
   existsSync,
+  mkdirSync,
   readFileSync,
   readdirSync,
   realpathSync,
@@ -140,6 +141,81 @@ function defaultMaterializedPlayPath(reference: string): string {
   return resolve(`${safeName || 'play'}.play.ts`);
 }
 
+function sanitizeGeneratedPlayName(value: string): string {
+  return (
+    value
+      .trim()
+      .toLowerCase()
+      .replace(/^prebuilt\//, '')
+      .replace(/[^a-z0-9-]/g, '-')
+      .replace(/-+/g, '-')
+      .replace(/^-|-$/g, '') || 'play'
+  );
+}
+
+function buildGeneratedCsvWrapperSource(input: {
+  wrapperName: string;
+  playRef: string;
+}): string {
+  return `import { definePlay } from 'deepline';
+
+export default definePlay(
+  ${JSON.stringify(input.wrapperName)},
+  async (ctx, input: Record<string, unknown> & { file: string }) => {
+    const rows = await ctx.csv<Record<string, unknown>>(input.file);
+    const constants = Object.fromEntries(
+      Object.entries(input).filter(([key]) => key !== 'file'),
+    );
+
+    const mappedRows = await ctx
+      .map('csv_rows', rows, {
+        key: (row, index) =>
+          String(
+            row.id ??
+              row.lead_id ??
+              row.email ??
+              row.linkedin_url ??
+              row.domain ??
+              index,
+          ),
+      })
+      .step('result', (row, rowCtx) =>
+        rowCtx.runPlay(
+          'row_play',
+          ${JSON.stringify(input.playRef)},
+          {
+            ...constants,
+            ...row,
+          },
+          {
+            description: 'Run the source play for this CSV row.',
+          },
+        ),
+      )
+      .run({ description: 'Run the source play once per CSV row.' });
+
+    return { rows: mappedRows };
+  },
+);
+`;
+}
+
+function writeGeneratedCsvWrapperPlay(playRef: string): string {
+  const baseName = sanitizeGeneratedPlayName(
+    parseReferencedPlayTarget(playRef).unqualifiedPlayName,
+  );
+  const wrapperName = `${baseName}-csv`;
+  const outputDir = resolve('.deepline', 'generated');
+  const outputPath = join(outputDir, `${wrapperName}.play.ts`);
+  mkdirSync(outputDir, { recursive: true });
+  writeFileSync(
+    outputPath,
+    buildGeneratedCsvWrapperSource({ wrapperName, playRef }),
+    'utf-8',
+  );
+  return outputPath;
+}
+
 type MaterializedRemotePlaySource = {
   path: string;
   status: 'created' | 'updated' | 'unchanged';
@@ -2184,6 +2260,22 @@ async function handleNamedRun(options: PlayRunCommandOptions): Promise<number> {
       waitTimeoutMs: options.waitTimeoutMs,
       progress,
     });
+    if (finalStatus.status !== 'completed' && options.csvPath) {
+      progress.phase('generating csv wrapper play');
+      const generatedPlayPath = writeGeneratedCsvWrapperPlay(
+        options.target.name,
+      );
+      progress.writeLogLine(
+        `Generated CSV wrapper play: ${generatedPlayPath}`,
+      );
+      progress.phase('running generated csv wrapper play');
+      return handleFileBackedRun({
+        ...options,
+        target: { kind: 'file', path: generatedPlayPath },
+        revisionId: null,
+        revisionSelector: null,
+      });
+    }
     const exportedPath = exportPlayStatusRows(finalStatus, options.outPath);
     if (finalStatus.status === 'completed') {
       progress.complete();

package/dist/repo/sdk/src/cli/index.ts

@@ -14,6 +14,7 @@ import { registerOrgCommands } from './commands/org.js';
 import { registerPlayCommands } from './commands/play.js';
 import { registerToolsCommands } from './commands/tools.js';
 import { createCliProgress } from './progress.js';
+import { syncSdkSkillsIfNeeded } from './skills-sync.js';
 import { recordCliTrace, traceCliSpan } from './trace.js';
 import { printJsonError } from './utils.js';
 
@@ -75,6 +76,14 @@ Output:
       { baseUrl },
       () => enforceSdkCompatibility(baseUrl),
     );
+    if (printStartupPhase) {
+      progress?.phase('checking sdk skills');
+    }
+    await traceCliSpan(
+      'cli.sdk_skills_sync',
+      { baseUrl },
+      () => syncSdkSkillsIfNeeded(baseUrl),
+    );
   });
 
   registerAuthCommands(program);
@@ -122,6 +131,7 @@ Output:
       ok: false,
       error: error instanceof Error ? error.message : String(error),
     });
+    progress?.fail();
     if (process.argv.includes('--json')) {
       printJsonError(error);
     } else if (error instanceof Error) {

package/dist/repo/sdk/src/cli/skills-sync.ts

@@ -0,0 +1,137 @@
+import { spawn } from 'node:child_process';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { baseUrlSlug } from '../config.js';
+
+const CHECK_TIMEOUT_MS = 3_000;
+const SDK_SKILL_NAME = 'deepline-sdk';
+const SKILL_AGENTS = ['codex', 'claude-code', 'cursor'] as const;
+
+type UpdateCheckResponse = {
+  skills?: {
+    needs_update?: unknown;
+    remote?: {
+      version?: unknown;
+    };
+  };
+};
+
+let attemptedSync = false;
+
+function shouldSkipSkillsSync(): boolean {
+  const value = process.env.DEEPLINE_SKIP_SKILLS_SYNC?.trim().toLowerCase();
+  return value === '1' || value === 'true' || value === 'yes' || value === 'on';
+}
+
+function sdkSkillsVersionPath(baseUrl: string): string {
+  const home = process.env.HOME?.trim() || homedir();
+  return join(home, '.local', 'deepline', baseUrlSlug(baseUrl), 'sdk-skills', '.version');
+}
+
+function readLocalSkillsVersion(baseUrl: string): string {
+  const path = sdkSkillsVersionPath(baseUrl);
+  if (!existsSync(path)) return '';
+  try {
+    return readFileSync(path, 'utf-8').trim();
+  } catch {
+    return '';
+  }
+}
+
+function writeLocalSkillsVersion(baseUrl: string, version: string): void {
+  const path = sdkSkillsVersionPath(baseUrl);
+  mkdirSync(dirname(path), { recursive: true });
+  writeFileSync(path, `${version}\n`, 'utf-8');
+}
+
+async function fetchSkillsUpdate(baseUrl: string, localVersion: string): Promise<{
+  needsUpdate: boolean;
+  remoteVersion: string;
+} | null> {
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), CHECK_TIMEOUT_MS);
+  try {
+    const response = await fetch(new URL('/api/v2/cli/update-check', baseUrl), {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        skills: {
+          version: localVersion,
+        },
+      }),
+      signal: controller.signal,
+    });
+    if (!response.ok) return null;
+    const data = (await response.json().catch(() => null)) as UpdateCheckResponse | null;
+    const skills = data?.skills;
+    if (!skills) return null;
+    return {
+      needsUpdate: skills.needs_update === true,
+      remoteVersion: typeof skills.remote?.version === 'string' ? skills.remote.version.trim() : '',
+    };
+  } catch {
+    return null;
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+
+function runSkillsInstall(baseUrl: string): Promise<boolean> {
+  const packageUrl = new URL('/.well-known/skills/index.json', baseUrl).toString();
+  const args = [
+    'skills',
+    'add',
+    packageUrl,
+    '--agents',
+    ...SKILL_AGENTS,
+    '--global',
+    '--yes',
+    '--skill',
+    SDK_SKILL_NAME,
+    '--full-depth',
+  ];
+
+  return new Promise((resolve) => {
+    const child = spawn('npx', args, {
+      stdio: ['ignore', 'ignore', 'pipe'],
+      env: process.env,
+    });
+    let stderr = '';
+    child.stderr.on('data', (chunk: Buffer) => {
+      stderr += chunk.toString('utf-8');
+    });
+    child.on('error', (error) => {
+      process.stderr.write(`SDK skills sync failed to start: ${error.message}\n`);
+      resolve(false);
+    });
+    child.on('close', (code) => {
+      if (code === 0) {
+        resolve(true);
+        return;
+      }
+      const detail = stderr.trim();
+      process.stderr.write(
+        `SDK skills sync failed${detail ? `: ${detail}` : ''}\n` +
+          `Run manually: npx ${args.map((arg) => (arg.includes(' ') ? JSON.stringify(arg) : arg)).join(' ')}\n`,
+      );
+      resolve(false);
+    });
+  });
+}
+
+export async function syncSdkSkillsIfNeeded(baseUrl: string): Promise<void> {
+  if (attemptedSync || shouldSkipSkillsSync()) return;
+  attemptedSync = true;
+
+  const localVersion = readLocalSkillsVersion(baseUrl);
+  const update = await fetchSkillsUpdate(baseUrl, localVersion);
+  if (!update?.needsUpdate || !update.remoteVersion) return;
+
+  process.stderr.write('SDK skills changed; syncing deepline-sdk skill...\n');
+  const installed = await runSkillsInstall(baseUrl);
+  if (!installed) return;
+
+  writeLocalSkillsVersion(baseUrl, update.remoteVersion);
+  process.stderr.write('SDK skills are up to date.\n');
+}

package/dist/repo/sdk/src/version.ts

@@ -1,2 +1,2 @@
-export const SDK_VERSION = "0.1.3";
+export const SDK_VERSION = "0.1.7";
 export const SDK_API_CONTRACT = "2026-04-plays-v1";

package/dist/repo/shared_libs/plays/bundling/index.ts

@@ -165,6 +165,14 @@ function formatTypeScriptDiagnostic(diagnostic: ts.Diagnostic): string | null {
   return `${diagnostic.file.fileName}:${line + 1}:${character + 1} ${message}`;
 }
 
+function resolveBundledTypeRoots(): string[] {
+  try {
+    return [dirname(dirname(playArtifactRequire.resolve('@types/node/package.json')))];
+  } catch {
+    return [];
+  }
+}
+
 function typecheckPlaySource(
   input: SourceGraphAnalysis,
   adapter: PlayBundlingAdapter,
@@ -196,6 +204,7 @@ function typecheckPlaySource(
     allowJs: true,
     resolveJsonModule: true,
     types: ['node'],
+    typeRoots: resolveBundledTypeRoots(),
   });
   return ts
     .getPreEmitDiagnostics(program)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.1.3",
+  "version": "0.1.7",
   "description": "Deepline SDK + CLI — B2B data enrichment powered by durable cloud execution",
   "license": "MIT",
   "repository": {
@@ -44,12 +44,14 @@
     "prepublishOnly": "tsup"
   },
   "dependencies": {
+    "@types/node": "^20.0.0",
+    "acorn": "^8.16.0",
+    "acorn-walk": "^8.3.5",
     "commander": "^14.0.3",
     "csv-parse": "^5.6.0",
     "csv-stringify": "^6.5.0",
     "esbuild": "^0.25.11",
-    "typescript": "^5.9.3",
-    "@types/node": "^20.0.0"
+    "typescript": "^5.9.3"
   },
   "devDependencies": {
     "tsup": "^8.0.0"