deepline 0.1.7 → 0.1.9

package/dist/repo/apps/play-runner-workers/src/entry.ts

@@ -89,6 +89,7 @@ import {
   type ToolExecuteResult,
   type ToolResultMetadataInput,
 } from './runtime/tool-result';
+import { coordinatorRequestHeaders } from '../../../shared_libs/play-runtime/coordinator-headers';
 
 // The play's default export. The bundler injects this — see bundle-play-file.ts.
 // eslint-disable-next-line @typescript-eslint/ban-ts-comment
@@ -130,6 +131,8 @@ type RunRequest = {
   playCallGovernance?: PlayCallGovernanceSnapshot | null;
   /** Cloudflare coordinator URL for direct Workflow control-plane signals. */
   coordinatorUrl?: string | null;
+  /** Request-scoped coordinator auth token for preview/dev direct control calls. */
+  coordinatorInternalToken?: string | null;
   /**
    * Total input rows known at submit time, when the dispatcher can count them.
    * `undefined` when the input streams from R2 (unknown row count).
@@ -761,6 +764,12 @@ async function submitChildPlayThroughCoordinator(input: {
   logs?: string[];
   timings?: Array<{ phase: string; ms: number }>;
 }> {
+  if (cachedCoordinatorBinding) {
+    if (!isRecord(input.body)) {
+      throw new Error('ctx.runPlay child submit requires an object body.');
+    }
+    return cachedCoordinatorBinding.submitChild(input.req.runId, input.body);
+  }
   const coordinatorUrl = input.req.coordinatorUrl?.trim();
   if (coordinatorUrl) {
     // Keep child plays on the same coordinator/Workflow submit path as
@@ -772,8 +781,12 @@ async function submitChildPlayThroughCoordinator(input: {
       {
         method: 'POST',
         headers: {
-          'content-type': 'application/json',
           'x-deepline-request-id': makeRequestId(),
+          ...coordinatorRequestHeaders({
+            runId: input.req.runId,
+            contentType: 'application/json',
+            internalToken: input.req.coordinatorInternalToken,
+          }),
         },
         body: JSON.stringify(input.body),
       },
@@ -796,14 +809,8 @@ async function submitChildPlayThroughCoordinator(input: {
     }
     return parsed;
   }
-  if (cachedCoordinatorBinding) {
-    if (!isRecord(input.body)) {
-      throw new Error('ctx.runPlay child submit requires an object body.');
-    }
-    return cachedCoordinatorBinding.submitChild(input.req.runId, input.body);
-  }
   throw new Error(
-    'ctx.runPlay child submit requires coordinatorUrl in the cf-workflows runtime.',
+    'ctx.runPlay child submit requires a coordinator binding in the cf-workflows runtime.',
   );
 }
 
@@ -948,7 +955,6 @@ async function signalParentPlayTerminal(input: {
       : {}),
     emittedAt: nowMs(),
   };
-  const coordinatorUrl = input.req.coordinatorUrl?.trim();
   const signalBody = {
     signal: 'integration_event',
     eventKey,
@@ -958,6 +964,7 @@ async function signalParentPlayTerminal(input: {
     await cachedCoordinatorBinding.signal(governance.parentRunId, signalBody);
     return;
   }
+  const coordinatorUrl = input.req.coordinatorUrl?.trim();
   if (coordinatorUrl) {
     const res = await fetch(
       `${coordinatorUrl.replace(/\/$/, '')}/workflow/${encodeURIComponent(
@@ -966,26 +973,27 @@ async function signalParentPlayTerminal(input: {
       {
         method: 'POST',
         headers: {
-          'content-type': 'application/json',
           'x-deepline-request-id': makeRequestId(),
+          ...coordinatorRequestHeaders({
+            runId: governance.parentRunId,
+            contentType: 'application/json',
+            internalToken: input.req.coordinatorInternalToken,
+          }),
         },
         body: JSON.stringify(signalBody),
       },
     );
-    if (!res.ok) {
-      const text = await res.text().catch(() => '');
-      throw new Error(
-        `Coordinator signal ${res.status}: ${text.slice(0, 800)}`,
-      );
+    if (res.ok) {
+      return;
     }
-    return;
+    const text = await res.text().catch(() => '');
+    throw new Error(
+      text.slice(0, 800) || `Coordinator parent signal failed with ${res.status}.`,
+    );
   }
-  await postDeeplineApi(input.req, '/api/v2/plays/run/signal', {
-    workflowId: governance.parentRunId,
-    signal: 'integration_event',
-    eventKey,
-    data,
-  });
+  throw new Error(
+    'Child play terminal signaling requires a coordinator binding in the cf-workflows runtime.',
+  );
 }
 
 async function executeTool(
@@ -4483,6 +4491,11 @@ function runRequestFromWorkflowParams(
       typeof params.coordinatorUrl === 'string' && params.coordinatorUrl.trim()
         ? params.coordinatorUrl.trim()
         : null,
+    coordinatorInternalToken:
+      typeof params.coordinatorInternalToken === 'string' &&
+      params.coordinatorInternalToken.trim()
+        ? params.coordinatorInternalToken.trim()
+        : null,
     totalRows:
       typeof params.totalRows === 'number' && Number.isFinite(params.totalRows)
         ? params.totalRows

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

@@ -968,9 +968,16 @@ async function startAndWaitForPlayCompletionByStream(input: {
         const dashboardUrl =
           getDashboardUrlFromLiveEvent(event) ??
           buildPlayDashboardUrl(input.client.baseUrl, input.playName);
-        input.progress.phase(
-          `loading play on ${dashboardUrl}`,
-        );
+        if (!input.jsonOutput) {
+          writeStartedPlayRun({
+            runId: workflowId,
+            playName: input.playName,
+            dashboardUrl,
+            jsonOutput: false,
+            progress: input.progress,
+          });
+        }
+        input.progress.phase(`loading play on ${dashboardUrl}`);
         emittedDashboardUrl = true;
       }
       assertPlayWaitNotTimedOut({
@@ -1100,8 +1107,8 @@ async function waitForPlayCompletionByPolling(input: {
       const now = Date.now();
       if (now - lastTransientPollWarningAt >= 30_000) {
         const message = error instanceof Error ? error.message : String(error);
-        process.stderr.write(
-          `[play tail] transient status poll failed; retrying: ${message}\n`,
+        input.progress.writeLine(
+          `[play tail] transient status poll failed; retrying: ${message}`,
         );
         lastTransientPollWarningAt = now;
       }
@@ -1787,6 +1794,7 @@ function writeStartedPlayRun(input: {
   statusUrl?: string;
   dashboardUrl?: string;
   jsonOutput: boolean;
+  progress?: CliProgress;
 }): void {
   const payload = {
     runId: input.runId,
@@ -1815,7 +1823,12 @@ function writeStartedPlayRun(input: {
     lines.push(`  play page: ${input.dashboardUrl}`);
   }
 
-  console.log(lines.join('\n'));
+  const output = lines.join('\n');
+  if (input.progress) {
+    input.progress.writeLine(output, process.stdout);
+    return;
+  }
+  console.log(output);
 }
 
 function parsePlayRunOptions(args: string[]): PlayRunCommandOptions {
@@ -2188,6 +2201,7 @@ async function handleFileBackedRun(
     statusUrl: started.statusUrl,
     dashboardUrl,
     jsonOutput: options.jsonOutput,
+    progress,
   });
   return 0;
 }
@@ -2303,6 +2317,7 @@ async function handleNamedRun(options: PlayRunCommandOptions): Promise<number> {
     statusUrl: started.statusUrl,
     dashboardUrl,
     jsonOutput: options.jsonOutput,
+    progress,
   });
   return 0;
 }

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

@@ -56,6 +56,20 @@ export class CliProgress {
     }
   }
 
+  writeLine(line: string, stream: NodeJS.WriteStream = process.stderr): void {
+    if (!this.enabled || !this.interactive) {
+      stream.write(`${line}\n`);
+      return;
+    }
+    const activeMessage = this.lastMessage;
+    this.worker?.terminate().catch(() => undefined);
+    this.worker = null;
+    stream.write(`\r\x1b[2K${line}\n`);
+    if (activeMessage) {
+      this.startWorker().postMessage({ type: 'phase', message: activeMessage });
+    }
+  }
+
   private settle(mark: '✓' | '✗'): void {
     if (!this.enabled || !this.lastMessage) {
       return;

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

@@ -2,6 +2,7 @@ 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 { getActiveCliProgress } from './progress.js';
 import { baseUrlSlug } from '../config.js';
 
 const CHECK_TIMEOUT_MS = 3_000;
@@ -128,10 +129,13 @@ export async function syncSdkSkillsIfNeeded(baseUrl: string): Promise<void> {
   const update = await fetchSkillsUpdate(baseUrl, localVersion);
   if (!update?.needsUpdate || !update.remoteVersion) return;
 
-  process.stderr.write('SDK skills changed; syncing deepline-sdk skill...\n');
+  const progress = getActiveCliProgress();
+  progress?.writeLine('SDK skills changed; syncing deepline-sdk skill...') ??
+    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');
+  progress?.writeLine('SDK skills are up to date.') ??
+    process.stderr.write('SDK skills are up to date.\n');
 }

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

@@ -23,6 +23,7 @@ import { AuthError, DeeplineError, RateLimitError } from './errors.js';
 import { SDK_API_CONTRACT, SDK_VERSION } from './version.js';
 import type { LiveEventEnvelope } from './types.js';
 import {
+  COORDINATOR_INTERNAL_TOKEN_HEADER,
   COORDINATOR_URL_OVERRIDE_HEADER,
   WORKER_CALLBACK_URL_OVERRIDE_HEADER,
 } from '../../shared_libs/play-runtime/coordinator-headers.js';
@@ -84,6 +85,13 @@ export class HttpClient {
       : undefined;
     if (coordinatorUrl?.trim()) {
       headers[COORDINATOR_URL_OVERRIDE_HEADER] = coordinatorUrl.trim();
+      const coordinatorInternalToken = typeof process !== 'undefined'
+        ? process.env?.DEEPLINE_INTERNAL_TOKEN
+        : undefined;
+      if (coordinatorInternalToken?.trim()) {
+        headers[COORDINATOR_INTERNAL_TOKEN_HEADER] =
+          coordinatorInternalToken.trim();
+      }
     }
     const workerCallbackUrl = typeof process !== 'undefined'
       ? process.env?.DEEPLINE_WORKER_CALLBACK_URL

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

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

package/dist/repo/shared_libs/play-runtime/coordinator-headers.ts

@@ -51,6 +51,7 @@ function resolveInternalCoordinatorToken(): string | null {
 export function coordinatorRequestHeaders(input: {
   runId: string;
   contentType?: string | null;
+  internalToken?: string | null;
   /**
    * When set, the coordinator validates this matches the runId in the URL.
    * Pass the runId on `/cancel` / `/signal` calls so a leaked dispatcher
@@ -66,7 +67,8 @@ export function coordinatorRequestHeaders(input: {
   if (trimmed) {
     headers[COORDINATOR_VERSION_KEY_HEADER] = trimmed;
   }
-  const internalToken = resolveInternalCoordinatorToken();
+  const internalToken =
+    input.internalToken?.trim() || resolveInternalCoordinatorToken();
   if (internalToken) {
     headers[COORDINATOR_INTERNAL_TOKEN_HEADER] = internalToken;
   }

package/dist/repo/shared_libs/play-runtime/scheduler-backend.ts

@@ -94,6 +94,8 @@ export type PlaySchedulerSubmitInput = {
   totalRows?: number;
   /** Internal scheduler/coordinator URL for Worker-side capabilities. */
   coordinatorUrl?: string | null;
+  /** Request-scoped coordinator auth token for non-production preview/dev runs. */
+  coordinatorInternalToken?: string | null;
 };
 
 export type PlaySchedulerProgressEvent =
@@ -151,7 +153,10 @@ export interface PlaySchedulerBackend {
   /** Open a handle to an already-submitted run (e.g. for tail-reconnect). */
   attach(
     runId: string,
-    options?: { coordinatorUrl?: string | null },
+    options?: {
+      coordinatorUrl?: string | null;
+      coordinatorInternalToken?: string | null;
+    },
   ): Promise<PlaySchedulerRunHandle>;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Deepline SDK + CLI — B2B data enrichment powered by durable cloud execution",
   "license": "MIT",
   "repository": {