deepline 0.1.8 → 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/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.8";
+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.8",
+  "version": "0.1.9",
   "description": "Deepline SDK + CLI — B2B data enrichment powered by durable cloud execution",
   "license": "MIT",
   "repository": {