deepline 0.3.480 → 0.3.481

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

@@ -177,11 +177,14 @@ import {
   mintStagedPlayFileUploads,
   normalizePlayRunStart,
   CLI_PLAY_RUN_START_STREAM_PATH,
+  CLI_PLAY_RUN_SUPPORTED_HEADER,
   CliPlayAdmissionUnsupportedError,
   PLAY_RUN_START_STREAM_PATH,
   stagePlayFiles,
   preparePlayRunAdmission,
+  readPlayRunAdmissionCapability,
   type MintStagedFileUpload,
+  type PlayRunAdmissionCapability,
   type PlayRunStartOptions,
   type ResolvedStartPlayRunRequest,
 } from './plays/run-request';
@@ -3527,7 +3530,7 @@ export class DeeplineClient {
   /**
    * Re-establish this workspace's tenant storage contract: role/DB connect
    * grants plus materialized table grants. Org-admin only. Use when a run fails
-   * with WORKSPACE_STORAGE_NOT_READY.
+   * with `WORKSPACE_STORAGE_NOT_READY`.
    */
   async repairIngestionStorage(input?: {
     provider?: string;
@@ -3595,6 +3598,10 @@ export class DeeplineClient {
     request: StartPlayRunRequest,
     options?: {
       cliAdmission?: boolean;
+      /** @internal Capability response prefetched by the CLI during local preparation. */
+      admissionCapability?:
+        | Promise<PlayRunAdmissionCapability>
+        | PlayRunAdmissionCapability;
       onSubmission?: (intent: {
         workflowId: string;
         orgId: string;
@@ -3607,6 +3614,11 @@ export class DeeplineClient {
       this.http,
       resolved.request,
       options?.onSubmission,
+      {
+        ...(options && Object.hasOwn(options, 'admissionCapability')
+          ? { admissionCapability: options.admissionCapability }
+          : {}),
+      },
     );
     const bodyJson = JSON.stringify(prepared.body);
     const headers = runtimeSelectionHeaders(resolved.runtime, this.environment);
@@ -3629,12 +3641,15 @@ export class DeeplineClient {
           await preparePlayRunAdmission(
             http,
             JSON.parse(bodyJson) as ResolvedStartPlayRunRequest,
+            undefined,
+            { signal: streamOptions?.signal },
           );
         }
         submitted = true;
         const streamPath = options?.cliAdmission
           ? CLI_PLAY_RUN_START_STREAM_PATH
           : PLAY_RUN_START_STREAM_PATH;
+        let cliAdmissionSupported = false;
         try {
           for await (const event of http.streamSse<PlayLiveEvent>(streamPath, {
             method: 'POST',
@@ -3642,12 +3657,22 @@ export class DeeplineClient {
             headers,
             signal: streamOptions?.signal,
             exactUrlOnly: true,
+            ...(options?.cliAdmission
+              ? {
+                  onResponse: (response: Response) => {
+                    cliAdmissionSupported =
+                      response.headers.get(CLI_PLAY_RUN_SUPPORTED_HEADER) ===
+                      'true';
+                  },
+                }
+              : {}),
           })) {
             if (event.scope === 'play') yield event;
           }
         } catch (error) {
           if (
             options?.cliAdmission &&
+            !cliAdmissionSupported &&
             error instanceof DeeplineError &&
             (error.statusCode === 404 || error.statusCode === 405)
           ) {
@@ -3659,6 +3684,15 @@ export class DeeplineClient {
     };
   }
 
+  /**
+   * Internal CLI helper. Reads the server's admission contract before local
+   * preparation so the network round trip can overlap with compilation.
+   * @internal
+   */
+  async prefetchPlayRunAdmissionCapability(): Promise<PlayRunAdmissionCapability> {
+    return readPlayRunAdmissionCapability(this.http);
+  }
+
   /**
    * Submit a play run through the legacy event response.
    *

package/dist/bundling-sources/sdk/src/http-core.ts

@@ -121,6 +121,7 @@ interface StreamOptions {
   body?: unknown;
   headers?: Record<string, string>;
   signal?: AbortSignal;
+  onResponse?: (response: Response) => void;
 }
 
 type RequestAbortTaggedError = Error & {
@@ -941,6 +942,7 @@ export class HttpClient {
               : undefined,
           signal: options?.signal,
         });
+        options?.onResponse?.(response);
 
         if (!response.ok) {
           const body = await response.text();

package/dist/bundling-sources/sdk/src/plays/run-request.ts

@@ -68,6 +68,12 @@ export interface PlayRunHttp {
   ): Promise<T>;
 }
 
+export type PlayRunAdmissionCapability = {
+  admissionContract?: string;
+  strictTotalBudget?: string;
+  orgId?: string;
+} | null;
+
 // ── Run-start body and response ─────────────────────────────────────────────
 
 /**
@@ -188,7 +194,12 @@ export async function preparePlayRunAdmission(
     orgId: string;
     request: Record<string, unknown>;
   }) => void | Promise<void>,
-  options?: { signal?: AbortSignal },
+  options?: {
+    signal?: AbortSignal;
+    admissionCapability?:
+      | Promise<PlayRunAdmissionCapability>
+      | PlayRunAdmissionCapability;
+  },
 ): Promise<{
   body: Record<string, unknown>;
   workflowId?: string;
@@ -196,36 +207,10 @@ export async function preparePlayRunAdmission(
 }> {
   // The reader ships before the writer. An older route ignores workflowId;
   // that response cannot prove an identity can be reused safely after a timeout.
-  let capability: {
-    admissionContract?: string;
-    strictTotalBudget?: string;
-    orgId?: string;
-  } | null = null;
-  if (http.get) {
-    try {
-      capability = await http.get(PLAY_RUN_START_PATH, options);
-    } catch (error) {
-      if (
-        !(error instanceof DeeplineError) ||
-        ![404, 405].includes(error.statusCode ?? 0)
-      )
-        throw error;
-      // Only an authoritative absent route proves an older server. A timeout,
-      // 503, or authentication denial must never switch to an unkeyed writer.
-    }
-    if (
-      capability &&
-      !['caller-intent-v1', 'unsupported'].includes(
-        capability.admissionContract ?? '',
-      )
-    ) {
-      throw new DeeplineError(
-        'The server admission capability response is unknown; execution was not submitted.',
-        503,
-        'PLAY_RUN_ADMISSION_CAPABILITY_UNKNOWN',
-      );
-    }
-  }
+  const capability =
+    options && Object.hasOwn(options, 'admissionCapability')
+      ? await options.admissionCapability
+      : await readPlayRunAdmissionCapability(http, options);
   const supportsCallerIntent =
     capability?.admissionContract === 'caller-intent-v1';
   options?.signal?.throwIfAborted();
@@ -316,6 +301,44 @@ export async function preparePlayRunAdmission(
   return { body: submittedBody, workflowId, supportsCallerIntent };
 }
 
+/** Read the admission contract before submission; callers may overlap this GET with local preparation. */
+export async function readPlayRunAdmissionCapability(
+  http: PlayRunHttp,
+  options?: { signal?: AbortSignal },
+): Promise<PlayRunAdmissionCapability> {
+  let capability: PlayRunAdmissionCapability = null;
+  if (http.get) {
+    try {
+      capability = await http.get<PlayRunAdmissionCapability>(
+        PLAY_RUN_START_PATH,
+        options,
+      );
+    } catch (error) {
+      if (
+        !(error instanceof DeeplineError) ||
+        ![404, 405].includes(error.statusCode ?? 0)
+      ) {
+        throw error;
+      }
+      // Only an authoritative absent route proves an older server. A timeout,
+      // 503, or authentication denial must never switch to an unkeyed writer.
+    }
+    if (
+      capability &&
+      !['caller-intent-v1', 'unsupported'].includes(
+        capability.admissionContract ?? '',
+      )
+    ) {
+      throw new DeeplineError(
+        'The server admission capability response is unknown; execution was not submitted.',
+        503,
+        'PLAY_RUN_ADMISSION_CAPABILITY_UNKNOWN',
+      );
+    }
+  }
+  return capability;
+}
+
 export async function startPlayRun(
   http: PlayRunHttp,
   request: ResolvedStartPlayRunRequest,

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

@@ -205,7 +205,7 @@ export const SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: '0.3.480',
+  version: '0.3.481',
   updateSummary: {
     introducedIn: '0.3.90',
     summary: