deepline 0.1.249 → 0.1.251

package/dist/index.js

@@ -431,7 +431,7 @@ var SDK_RELEASE = {
   // runtime intentionally no longer compiles at publish or launch time.
   // 0.1.242 removes the retired Workers/ESM compiler, generated bundles, and
   // deploy-time artifact migration. Play authoring now has one CJS contract.
-  version: "0.1.249",
+  version: "0.1.251",
   apiContract: "2026-07-cjs-absurd-only-play-runtime-hard-cutover",
   supportPolicy: {
     minimumSupported: "0.1.53",
@@ -589,6 +589,7 @@ var COORDINATOR_INTERNAL_TOKEN_HEADER = "x-deepline-internal-token";
 var COORDINATOR_URL_OVERRIDE_HEADER = "x-deepline-coordinator-url";
 var WORKER_CALLBACK_URL_OVERRIDE_HEADER = "x-deepline-worker-callback-url";
 var RUNTIME_SCHEDULER_SCHEMA_OVERRIDE_HEADER = "x-deepline-runtime-scheduler-schema";
+var RUNTIME_ENVIRONMENT_TOKEN_HEADER = "x-deepline-runtime-environment-token";
 var ABSURD_RELEASE_OVERRIDE_HEADER = "x-deepline-absurd-release";
 var SYNTHETIC_RUN_HEADER = "x-deepline-synthetic-run";
 
@@ -1253,9 +1254,25 @@ function createSecretRedactionContext(initialValues = []) {
     }
     return value;
   }
+  function redactKnownSecrets(value) {
+    if (typeof value === "string") return redactString(value);
+    if (Array.isArray(value)) {
+      return value.map((entry) => redactKnownSecrets(entry));
+    }
+    if (value && typeof value === "object") {
+      return Object.fromEntries(
+        Object.entries(value).map(([key, entry]) => [
+          key,
+          redactKnownSecrets(entry)
+        ])
+      );
+    }
+    return value;
+  }
   return {
     register,
     redactString,
+    redactKnownSecrets,
     redact
   };
 }
@@ -2162,6 +2179,29 @@ async function* observeRunEvents(options) {
   }
 }
 
+// ../shared_libs/play-runtime/runtime-environment.ts
+var PLAY_RUNTIME_ENVIRONMENTS = ["preview"];
+var PLAY_RUNTIME_NAMESPACE_PATTERN = /^[a-z][a-z0-9-]{0,30}$/;
+function normalizePlayRuntimeNamespace(value) {
+  if (typeof value !== "string") return null;
+  const normalized = value.trim();
+  return PLAY_RUNTIME_NAMESPACE_PATTERN.test(normalized) ? normalized : null;
+}
+function normalizePlayRuntimeSelection(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  const record = value;
+  if (Object.keys(record).some(
+    (key) => key !== "environment" && key !== "namespace"
+  ) || record.environment !== "preview") {
+    return null;
+  }
+  const namespace = normalizePlayRuntimeNamespace(record.namespace);
+  return namespace ? { environment: "preview", namespace } : null;
+}
+function normalizePlayRuntimeEnvironment(value) {
+  return typeof value === "string" && PLAY_RUNTIME_ENVIRONMENTS.includes(value) ? value : null;
+}
+
 // src/client.ts
 var TERMINAL_PLAY_STATUSES = /* @__PURE__ */ new Set(["completed", "failed", "cancelled"]);
 var INCLUDE_TOOL_METADATA_HEADER = "x-deepline-include-tool-metadata";
@@ -2184,6 +2224,61 @@ function resolvePlayRunIntegrationMode(request) {
     request.integrationMode ?? process.env.DEEPLINE_EVAL_INTEGRATION_MODE
   );
 }
+function resolvePlayRunRuntimeSelection(request) {
+  if (request.runtime !== void 0) {
+    const runtime = normalizePlayRuntimeSelection(request.runtime);
+    if (!runtime) {
+      throw new DeeplineError(
+        'runtime must be exactly { environment: "preview", namespace } with namespace matching ^[a-z][a-z0-9-]{0,30}$.',
+        void 0,
+        "INVALID_RUNTIME_SELECTION"
+      );
+    }
+    return runtime;
+  }
+  const configured = process.env.DEEPLINE_RUNTIME_ENVIRONMENT?.trim();
+  const configuredNamespace = process.env.DEEPLINE_RUNTIME_NAMESPACE?.trim();
+  const configuredToken = process.env.DEEPLINE_RUNTIME_ENVIRONMENT_TOKEN?.trim();
+  if (!configured) {
+    if (configuredNamespace || configuredToken) {
+      throw new DeeplineError(
+        "DEEPLINE_RUNTIME_ENVIRONMENT=preview and DEEPLINE_RUNTIME_NAMESPACE are required when runtime selection configuration is present.",
+        void 0,
+        "INVALID_RUNTIME_ENVIRONMENT"
+      );
+    }
+    return void 0;
+  }
+  const environment = normalizePlayRuntimeEnvironment(configured);
+  if (!environment) {
+    throw new DeeplineError(
+      `DEEPLINE_RUNTIME_ENVIRONMENT supports only explicit preview selection. Received "${configured}". Omit it to use the app-native runtime.`,
+      void 0,
+      "INVALID_RUNTIME_ENVIRONMENT"
+    );
+  }
+  const namespace = normalizePlayRuntimeNamespace(configuredNamespace);
+  if (!namespace) {
+    throw new DeeplineError(
+      "DEEPLINE_RUNTIME_NAMESPACE is required for preview and must match ^[a-z][a-z0-9-]{0,30}$.",
+      void 0,
+      "INVALID_RUNTIME_NAMESPACE"
+    );
+  }
+  return { environment, namespace };
+}
+function runtimeSelectionHeaders(runtime) {
+  if (!runtime) return void 0;
+  const token = process.env.DEEPLINE_RUNTIME_ENVIRONMENT_TOKEN?.trim();
+  if (!token) {
+    throw new DeeplineError(
+      "DEEPLINE_RUNTIME_ENVIRONMENT_TOKEN is required for explicit preview runtime selection.",
+      void 0,
+      "RUNTIME_ENVIRONMENT_TOKEN_REQUIRED"
+    );
+  }
+  return { [RUNTIME_ENVIRONMENT_TOKEN_HEADER]: token };
+}
 function normalizeTestPolicyOverrides(value, source) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
@@ -2882,6 +2977,7 @@ var DeeplineClient = class {
     const integrationMode = resolvePlayRunIntegrationMode(request);
     const testPolicyOverrides = request.testPolicyOverrides ?? parseEnvTestPolicyOverrides();
     const forceToolRefresh = request.forceToolRefresh === true;
+    const runtime = resolvePlayRunRuntimeSelection(request);
     const response = await this.http.post(
       "/api/v2/plays/run",
       {
@@ -2908,9 +3004,10 @@ var DeeplineClient = class {
         // defaults to absurd; callers normally omit this field.
         ...request.profile ? { profile: request.profile } : {},
         ...integrationMode ? { integrationMode } : {},
+        ...runtime ? { runtime } : {},
         ...testPolicyOverrides ? { testPolicyOverrides } : {}
       },
-      void 0,
+      runtimeSelectionHeaders(runtime),
       // A start can reach the server even when its response is lost or times
       // out. Retrying this mutation without an idempotency key can create a
       // second root run, so callers must resolve ambiguous failures explicitly.
@@ -2933,6 +3030,7 @@ var DeeplineClient = class {
     const integrationMode = resolvePlayRunIntegrationMode(request);
     const testPolicyOverrides = request.testPolicyOverrides ?? parseEnvTestPolicyOverrides();
     const forceToolRefresh = request.forceToolRefresh === true;
+    const runtime = resolvePlayRunRuntimeSelection(request);
     const body = {
       ...request.name ? { name: request.name } : {},
       ...request.revisionId ? { revisionId: request.revisionId } : {},
@@ -2955,6 +3053,7 @@ var DeeplineClient = class {
       ...typeof request.waitForCompletionMs === "number" ? { waitForCompletionMs: request.waitForCompletionMs } : {},
       ...request.profile ? { profile: request.profile } : {},
       ...integrationMode ? { integrationMode } : {},
+      ...runtime ? { runtime } : {},
       ...testPolicyOverrides ? { testPolicyOverrides } : {}
     };
     for await (const event of this.http.streamSse(
@@ -2962,6 +3061,7 @@ var DeeplineClient = class {
       {
         method: "POST",
         body,
+        headers: runtimeSelectionHeaders(runtime),
         signal: options?.signal
       }
     )) {

package/dist/index.mjs

@@ -361,7 +361,7 @@ var SDK_RELEASE = {
   // runtime intentionally no longer compiles at publish or launch time.
   // 0.1.242 removes the retired Workers/ESM compiler, generated bundles, and
   // deploy-time artifact migration. Play authoring now has one CJS contract.
-  version: "0.1.249",
+  version: "0.1.251",
   apiContract: "2026-07-cjs-absurd-only-play-runtime-hard-cutover",
   supportPolicy: {
     minimumSupported: "0.1.53",
@@ -519,6 +519,7 @@ var COORDINATOR_INTERNAL_TOKEN_HEADER = "x-deepline-internal-token";
 var COORDINATOR_URL_OVERRIDE_HEADER = "x-deepline-coordinator-url";
 var WORKER_CALLBACK_URL_OVERRIDE_HEADER = "x-deepline-worker-callback-url";
 var RUNTIME_SCHEDULER_SCHEMA_OVERRIDE_HEADER = "x-deepline-runtime-scheduler-schema";
+var RUNTIME_ENVIRONMENT_TOKEN_HEADER = "x-deepline-runtime-environment-token";
 var ABSURD_RELEASE_OVERRIDE_HEADER = "x-deepline-absurd-release";
 var SYNTHETIC_RUN_HEADER = "x-deepline-synthetic-run";
 
@@ -1183,9 +1184,25 @@ function createSecretRedactionContext(initialValues = []) {
     }
     return value;
   }
+  function redactKnownSecrets(value) {
+    if (typeof value === "string") return redactString(value);
+    if (Array.isArray(value)) {
+      return value.map((entry) => redactKnownSecrets(entry));
+    }
+    if (value && typeof value === "object") {
+      return Object.fromEntries(
+        Object.entries(value).map(([key, entry]) => [
+          key,
+          redactKnownSecrets(entry)
+        ])
+      );
+    }
+    return value;
+  }
   return {
     register,
     redactString,
+    redactKnownSecrets,
     redact
   };
 }
@@ -2092,6 +2109,29 @@ async function* observeRunEvents(options) {
   }
 }
 
+// ../shared_libs/play-runtime/runtime-environment.ts
+var PLAY_RUNTIME_ENVIRONMENTS = ["preview"];
+var PLAY_RUNTIME_NAMESPACE_PATTERN = /^[a-z][a-z0-9-]{0,30}$/;
+function normalizePlayRuntimeNamespace(value) {
+  if (typeof value !== "string") return null;
+  const normalized = value.trim();
+  return PLAY_RUNTIME_NAMESPACE_PATTERN.test(normalized) ? normalized : null;
+}
+function normalizePlayRuntimeSelection(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  const record = value;
+  if (Object.keys(record).some(
+    (key) => key !== "environment" && key !== "namespace"
+  ) || record.environment !== "preview") {
+    return null;
+  }
+  const namespace = normalizePlayRuntimeNamespace(record.namespace);
+  return namespace ? { environment: "preview", namespace } : null;
+}
+function normalizePlayRuntimeEnvironment(value) {
+  return typeof value === "string" && PLAY_RUNTIME_ENVIRONMENTS.includes(value) ? value : null;
+}
+
 // src/client.ts
 var TERMINAL_PLAY_STATUSES = /* @__PURE__ */ new Set(["completed", "failed", "cancelled"]);
 var INCLUDE_TOOL_METADATA_HEADER = "x-deepline-include-tool-metadata";
@@ -2114,6 +2154,61 @@ function resolvePlayRunIntegrationMode(request) {
     request.integrationMode ?? process.env.DEEPLINE_EVAL_INTEGRATION_MODE
   );
 }
+function resolvePlayRunRuntimeSelection(request) {
+  if (request.runtime !== void 0) {
+    const runtime = normalizePlayRuntimeSelection(request.runtime);
+    if (!runtime) {
+      throw new DeeplineError(
+        'runtime must be exactly { environment: "preview", namespace } with namespace matching ^[a-z][a-z0-9-]{0,30}$.',
+        void 0,
+        "INVALID_RUNTIME_SELECTION"
+      );
+    }
+    return runtime;
+  }
+  const configured = process.env.DEEPLINE_RUNTIME_ENVIRONMENT?.trim();
+  const configuredNamespace = process.env.DEEPLINE_RUNTIME_NAMESPACE?.trim();
+  const configuredToken = process.env.DEEPLINE_RUNTIME_ENVIRONMENT_TOKEN?.trim();
+  if (!configured) {
+    if (configuredNamespace || configuredToken) {
+      throw new DeeplineError(
+        "DEEPLINE_RUNTIME_ENVIRONMENT=preview and DEEPLINE_RUNTIME_NAMESPACE are required when runtime selection configuration is present.",
+        void 0,
+        "INVALID_RUNTIME_ENVIRONMENT"
+      );
+    }
+    return void 0;
+  }
+  const environment = normalizePlayRuntimeEnvironment(configured);
+  if (!environment) {
+    throw new DeeplineError(
+      `DEEPLINE_RUNTIME_ENVIRONMENT supports only explicit preview selection. Received "${configured}". Omit it to use the app-native runtime.`,
+      void 0,
+      "INVALID_RUNTIME_ENVIRONMENT"
+    );
+  }
+  const namespace = normalizePlayRuntimeNamespace(configuredNamespace);
+  if (!namespace) {
+    throw new DeeplineError(
+      "DEEPLINE_RUNTIME_NAMESPACE is required for preview and must match ^[a-z][a-z0-9-]{0,30}$.",
+      void 0,
+      "INVALID_RUNTIME_NAMESPACE"
+    );
+  }
+  return { environment, namespace };
+}
+function runtimeSelectionHeaders(runtime) {
+  if (!runtime) return void 0;
+  const token = process.env.DEEPLINE_RUNTIME_ENVIRONMENT_TOKEN?.trim();
+  if (!token) {
+    throw new DeeplineError(
+      "DEEPLINE_RUNTIME_ENVIRONMENT_TOKEN is required for explicit preview runtime selection.",
+      void 0,
+      "RUNTIME_ENVIRONMENT_TOKEN_REQUIRED"
+    );
+  }
+  return { [RUNTIME_ENVIRONMENT_TOKEN_HEADER]: token };
+}
 function normalizeTestPolicyOverrides(value, source) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
@@ -2812,6 +2907,7 @@ var DeeplineClient = class {
     const integrationMode = resolvePlayRunIntegrationMode(request);
     const testPolicyOverrides = request.testPolicyOverrides ?? parseEnvTestPolicyOverrides();
     const forceToolRefresh = request.forceToolRefresh === true;
+    const runtime = resolvePlayRunRuntimeSelection(request);
     const response = await this.http.post(
       "/api/v2/plays/run",
       {
@@ -2838,9 +2934,10 @@ var DeeplineClient = class {
         // defaults to absurd; callers normally omit this field.
         ...request.profile ? { profile: request.profile } : {},
         ...integrationMode ? { integrationMode } : {},
+        ...runtime ? { runtime } : {},
         ...testPolicyOverrides ? { testPolicyOverrides } : {}
       },
-      void 0,
+      runtimeSelectionHeaders(runtime),
       // A start can reach the server even when its response is lost or times
       // out. Retrying this mutation without an idempotency key can create a
       // second root run, so callers must resolve ambiguous failures explicitly.
@@ -2863,6 +2960,7 @@ var DeeplineClient = class {
     const integrationMode = resolvePlayRunIntegrationMode(request);
     const testPolicyOverrides = request.testPolicyOverrides ?? parseEnvTestPolicyOverrides();
     const forceToolRefresh = request.forceToolRefresh === true;
+    const runtime = resolvePlayRunRuntimeSelection(request);
     const body = {
       ...request.name ? { name: request.name } : {},
       ...request.revisionId ? { revisionId: request.revisionId } : {},
@@ -2885,6 +2983,7 @@ var DeeplineClient = class {
       ...typeof request.waitForCompletionMs === "number" ? { waitForCompletionMs: request.waitForCompletionMs } : {},
       ...request.profile ? { profile: request.profile } : {},
       ...integrationMode ? { integrationMode } : {},
+      ...runtime ? { runtime } : {},
       ...testPolicyOverrides ? { testPolicyOverrides } : {}
     };
     for await (const event of this.http.streamSse(
@@ -2892,6 +2991,7 @@ var DeeplineClient = class {
       {
         method: "POST",
         body,
+        headers: runtimeSelectionHeaders(runtime),
         signal: options?.signal
       }
     )) {

package/package.json

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