deepline 0.3.128 → 0.3.129

package/dist/bundling-sources/shared_libs/play-runtime/tool-result.ts

@@ -59,6 +59,7 @@ import {
   providerMetaFromToolResponseRawV2,
   type ToolResponseView,
 } from '../plays/tool-response-contract';
+import type { RuntimeReceiptValueReference } from './runtime-receipt-value';
 
 type PathSegment = string | number | '*';
 
@@ -69,9 +70,48 @@ const SERIALIZED_TOOL_EXECUTE_RESULT_V2_KIND =
 const SERIALIZED_TOOL_RESULT_LIST_PREVIEW_LIMIT = 5;
 const LIVE_TOOL_RESULT_LIST_DATASET_REGISTRY_LIMIT = 256;
 const SERIALIZED_TOOL_LIST_ROWS = Symbol('deepline.serialized_tool_list_rows');
+
+/**
+ * A live tool result may have been durably published by the execution relay
+ * before the runner sees its provider body. Keep that transport-only fact out
+ * of the public ToolExecuteResult and its persisted schema: the caller still
+ * receives the ordinary fully materialized result, while receipt publication
+ * can use the compact immutable R2 reference.
+ */
+const relayPublishedResultReferences = new WeakMap<
+  object,
+  RuntimeReceiptValueReference
+>();
+
+export function attachRelayPublishedToolResultReference(
+  result: ToolExecuteResult,
+  reference: RuntimeReceiptValueReference,
+): ToolExecuteResult {
+  relayPublishedResultReferences.set(result, reference);
+  return result;
+}
+
+export function relayPublishedToolResultReference(
+  result: ToolExecuteResult,
+): RuntimeReceiptValueReference | null {
+  return relayPublishedResultReferences.get(result) ?? null;
+}
+/**
+ * This registry is a same-process rehydration fast path, not an owner of a
+ * tool result. A strong process-global cache retained the full rows behind up
+ * to 256 otherwise-discarded list results. At map scale, a caller that only
+ * awaits `ctx.tools.execute()` could therefore keep hundreds of provider
+ * bodies alive after its cell had returned.
+ *
+ * The ToolExecuteResult that owns a live list already strongly owns its
+ * accessor and dataset. A weak lookup keeps the fast path while that result is
+ * still reachable, but lets the runtime release a result the authored Play no
+ * longer uses. Durable serialization still carries its normal list rows or
+ * preview, so a collected entry falls back to the existing durable path.
+ */
 const liveToolResultListDatasets = new Map<
   string,
-  PlayDataset<Record<string, unknown>>
+  WeakRef<PlayDataset<Record<string, unknown>>>
 >();
 
 /**
@@ -229,6 +269,12 @@ export type ParsedToolExecuteResponse = {
   result: unknown;
   /** Tool extractor metadata parsed from `_metadata.tool`, if present. */
   metadata: ToolResultMetadataInput | null;
+  /**
+   * Transport-only reference attached by the trusted execution relay after it
+   * persisted the complete serialized result. The raw response still remains
+   * present for ordinary live Play evaluation.
+   */
+  receiptOutputRef?: RuntimeReceiptValueReference;
 };
 
 export function parseToolExecuteResponse(
@@ -1473,7 +1519,7 @@ function rememberLiveToolResultListDataset(
 ): void {
   if (!datasetId) return;
   liveToolResultListDatasets.delete(datasetId);
-  liveToolResultListDatasets.set(datasetId, dataset);
+  liveToolResultListDatasets.set(datasetId, new WeakRef(dataset));
   while (
     liveToolResultListDatasets.size >
     LIVE_TOOL_RESULT_LIST_DATASET_REGISTRY_LIMIT
@@ -1487,8 +1533,14 @@ function rememberLiveToolResultListDataset(
 function readLiveToolResultListDataset(
   serialized: SerializedPlayDataset<Record<string, unknown>>,
 ): PlayDataset<Record<string, unknown>> | null {
-  const dataset = liveToolResultListDatasets.get(serialized.datasetId);
-  if (!dataset) return null;
+  const reference = liveToolResultListDatasets.get(serialized.datasetId);
+  const dataset = reference?.deref();
+  if (!dataset) {
+    // Keep the small key registry honest too. A dead weak entry is not useful
+    // to a later deserialize and must not consume one of the LRU slots.
+    liveToolResultListDatasets.delete(serialized.datasetId);
+    return null;
+  }
   const current = dataset.toJSON();
   if (current.count !== serialized.count) return null;
   return dataset;

package/dist/bundling-sources/shared_libs/play-runtime/work-receipts.ts

@@ -43,6 +43,8 @@ export function workReceiptFailureKindCodeForWrite(
 
 export type WorkReceipt = {
   key: string;
+  /** Completion acknowledgement only: whether this request published the output. */
+  completionDisposition?: 'persisted' | 'existing';
   status: WorkReceiptStatus;
   output?: unknown;
   error?: string | null;

package/dist/bundling-sources/shared_libs/plays/authoring-contract.ts

@@ -7,18 +7,17 @@ import type { ToolExecutionErrorSchemaVersion } from './tool-execution-error';
 import type { PlayDataset, PlayDatasetInput, PlayDatasetRow } from './dataset';
 
 export const LEGACY_PLAY_AUTHORING_CONTRACT_EDITION = 1 as const;
-export const PLAY_AUTHORING_CONTRACT_EDITION = 7 as const;
+export const PLAY_AUTHORING_CONTRACT_EDITION = 8 as const;
 export const PLAY_AUTHORING_INPUT_SCHEMA_SNAPSHOT_EDITION = 3 as const;
 export const SUPPORTED_PLAY_AUTHORING_CONTRACT_EDITIONS = [
-  1, 2, 3, 4, 5, 6, 7,
+  1, 2, 3, 4, 5, 6, 7, 8,
 ] as const;
 
 export type PlayAuthoringContractEdition =
   (typeof SUPPORTED_PLAY_AUTHORING_CONTRACT_EDITIONS)[number];
 
-export const PLAY_AUTHORING_CONTRACT_CHANGELOG = [
+const PLAY_AUTHORING_CONTRACT_CHANGELOG_DETAILS = [
   {
-    edition: 1,
     changed:
       'Historical extraction semantics. Invalid or unresolved optional authoring fields may normalize to absence.',
     compatibilityOwner: 'Plays Runtime',
@@ -27,7 +26,6 @@ export const PLAY_AUTHORING_CONTRACT_CHANGELOG = [
       'After every retained edition 1 artifact has a materialized admitted snapshot.',
   },
   {
-    edition: 2,
     changed:
       'Pins admitted authoring snapshots and rejects ambiguous billing, secret, webhook, fetch, timeout, receipt-wait, and freshness contracts.',
     compatibilityOwner: 'Plays Runtime',
@@ -36,7 +34,6 @@ export const PLAY_AUTHORING_CONTRACT_CHANGELOG = [
       'After every retained edition 2 artifact has an admitted input schema or has been republished.',
   },
   {
-    edition: 3,
     changed:
       'Materializes the declared input schema in the admitted snapshot so launch never reparses current source.',
     compatibilityOwner: 'Plays Runtime',
@@ -44,7 +41,6 @@ export const PLAY_AUTHORING_CONTRACT_CHANGELOG = [
     readerRemoval: null,
   },
   {
-    edition: 4,
     changed:
       'ctx.secrets.get(name) resolves an allowed secret to a plaintext string for ordinary Play code. Editions 1–3 retain opaque secret handles.',
     compatibilityOwner: 'Plays Runtime',
@@ -52,7 +48,6 @@ export const PLAY_AUTHORING_CONTRACT_CHANGELOG = [
     readerRemoval: null,
   },
   {
-    edition: 5,
     changed:
       'ctx.fetch throws a typed, redacted CtxFetchHttpError for non-2xx responses. Editions 1–4 continue to return the response record for every HTTP status.',
     compatibilityOwner: 'Plays Runtime',
@@ -60,7 +55,6 @@ export const PLAY_AUTHORING_CONTRACT_CHANGELOG = [
     readerRemoval: null,
   },
   {
-    edition: 6,
     changed:
       'Adds static cron input and rejects unknown definePlay and binding fields during new admission. Editions 1–5 retain their admitted binding semantics.',
     compatibilityOwner: 'Plays Runtime',
@@ -68,15 +62,27 @@ export const PLAY_AUTHORING_CONTRACT_CHANGELOG = [
     readerRemoval: null,
   },
   {
-    edition: 7,
     changed:
       'Slack HITL calls that omit timeout wait one week. Editions 1–6 retain the historical 24-hour default.',
     compatibilityOwner: 'Plays Runtime',
     newWritesEnd: null,
     readerRemoval: null,
   },
+  {
+    changed:
+      'Lets an inline scalar child execute without a stored static pipeline. Dataset creation and suspension remain rejected by the authoritative runtime capability boundary; editions 1–7 retain static-contract preflight rejection.',
+    compatibilityOwner: 'Plays Runtime',
+    newWritesEnd: null,
+    readerRemoval: null,
+  },
 ] as const;
 
+export const PLAY_AUTHORING_CONTRACT_CHANGELOG =
+  SUPPORTED_PLAY_AUTHORING_CONTRACT_EDITIONS.map((edition, index) => ({
+    edition,
+    ...PLAY_AUTHORING_CONTRACT_CHANGELOG_DETAILS[index]!,
+  }));
+
 /**
  * Customer-visible runtime capabilities that are not expressible as one
  * `ctx.*` signature. The generated authoring reference renders this inventory

package/dist/bundling-sources/shared_libs/plays/dataset.ts

@@ -6,6 +6,7 @@ const residentRowsByDataset = new WeakMap<object, readonly unknown[]>();
 const DEFAULT_MATERIALIZE_LIMIT = 10_000;
 export const PLAY_DATASET_EXECUTION_PAGE_ROWS = 1_000;
 export const PLAY_DATASET_EXECUTION_PAGE_BYTES = 64 * 1024 * 1024;
+const DATASET_UTF8_ENCODER = new TextEncoder();
 
 export type PlayDatasetKind = 'csv' | 'map';
 
@@ -899,7 +900,9 @@ export async function* iteratePlayDatasetInputPages<T>(
     options?.estimateRowBytes ??
     ((row: T) => {
       const serialized = JSON.stringify(row);
-      return serialized === undefined ? 0 : serialized.length;
+      return serialized === undefined
+        ? 0
+        : DATASET_UTF8_ENCODER.encode(serialized).byteLength;
     });
   let page: T[] = [];
   let pageBytes = 0;

package/dist/cli/index.js

@@ -3068,7 +3068,7 @@ var 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.128",
+  version: "0.3.129",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1
@@ -3906,6 +3906,20 @@ var HttpClient = class {
             }
             throw lastError;
           }
+          if (typeof parsed === "string") {
+            const interstitial = detectHtmlErrorBody(
+              body,
+              response.headers.get("content-type")
+            );
+            if (interstitial) {
+              throw new DeeplineError(
+                `${this.config.baseUrl} returned a deployment-protection page instead of JSON. Set VERCEL_PROTECTION_BYPASS_TOKEN, or run \`vercel login\` if the CLI session expired.`,
+                response.status,
+                "DEPLOYMENT_PROTECTED",
+                { htmlErrorPage: true }
+              );
+            }
+          }
           return parsed;
         } catch (error) {
           clearTimeout(timeoutId);
@@ -4402,6 +4416,11 @@ function normalizePlayRunLedgerTerminalSource(value) {
   ) ? value : null;
 }
 
+// ../play-runtime/run-log-buffer.ts
+var RUNNER_LOG_MAX_BYTES = 5 * 1024 * 1024;
+var TERMINAL_RESERVE_BYTES = 64 * 1024;
+var encoder = new TextEncoder();
+
 // ../play-runtime/secret-redaction.ts
 var SECRET_REDACTION_PLACEHOLDER = "[REDACTED_SECRET]";
 var BEARER_TOKEN_RE = /\bBearer\s+[A-Za-z0-9._~+/=-]{12,}\b/g;
@@ -4419,6 +4438,18 @@ var SENSITIVE_FIELD_NAME_RE = new RegExp(
   `(^|[._-])(?:${SENSITIVE_FIELD_NAME})$`,
   "i"
 );
+var SENSITIVE_FIELD_NAME_CACHE_MAX_ENTRIES = 4096;
+var sensitiveFieldNameCache = /* @__PURE__ */ new Map();
+function isSensitiveFieldName(key) {
+  const cached = sensitiveFieldNameCache.get(key);
+  if (cached !== void 0) return cached;
+  const sensitive = SENSITIVE_FIELD_NAME_RE.test(key);
+  if (sensitiveFieldNameCache.size >= SENSITIVE_FIELD_NAME_CACHE_MAX_ENTRIES) {
+    sensitiveFieldNameCache.clear();
+  }
+  sensitiveFieldNameCache.set(key, sensitive);
+  return sensitive;
+}
 var SERIALIZED_SECRET_FIELD_RE = new RegExp(
   `"(${SENSITIVE_FIELD_NAME})"\\s*:\\s*(?:"[^"\\\\]*"|\\{[^{}]*\\})`,
   "gi"
@@ -4426,7 +4457,45 @@ var SERIALIZED_SECRET_FIELD_RE = new RegExp(
 function escapeRegExp(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
+var REDACTION_TRIGGER_RE = new RegExp(
+  [
+    // Sensitive field names, in object keys and in `name=`/`"name":` text.
+    "token",
+    "secret",
+    "password",
+    "authorization",
+    "cookie",
+    "credential",
+    // One `key` branch instead of `api[_-]?key`, `private[_-]?key` and `key_`.
+    // A regex alternation costs roughly one substring scan per branch, and a
+    // broader branch can only send more payloads down the exact path.
+    "key",
+    // Self-identifying credential prefixes.
+    "bearer",
+    "basic",
+    "-----BEGIN",
+    "xox[baprs]-",
+    "[prs]k_",
+    "pat_",
+    "ghp_",
+    // URL credentials: `//user:pass@host` userinfo and sensitive query params.
+    // The userinfo class excludes `/` exactly as the rule it guards does.
+    "//[^\\s/]{0,256}@",
+    "[?#&]sig",
+    // JWTs carry no keyword at all, so the shape itself is the marker. Anchor
+    // on the separating dot and drop JWT_RE's leading `{8,}` segment: a dot is
+    // rare enough for the engine to skip between candidates, which makes this
+    // gate roughly ten times cheaper than re-running JWT_RE itself, and
+    // dropping a required segment can only widen what it accepts.
+    "\\.[A-Za-z0-9_-]{1,16384}\\.[A-Za-z0-9_-]{8}"
+  ].join("|"),
+  "i"
+);
+function mightContainRedactableSecret(value) {
+  return REDACTION_TRIGGER_RE.test(value);
+}
 function redactSecretLikeString(value) {
+  if (!mightContainRedactableSecret(value)) return value;
   const serializedRedacted = value.replace(
     SERIALIZED_SECRET_FIELD_RE,
     `"$1":"${SECRET_REDACTION_PLACEHOLDER}"`
@@ -4448,9 +4517,26 @@ function redactSecretLikeString(value) {
 }
 function createSecretRedactionContext(initialValues = []) {
   const exactSecrets = /* @__PURE__ */ new Set();
+  const exactSecretMatchers = /* @__PURE__ */ new Map();
   function register(value) {
     if (value.length > 0) exactSecrets.add(value);
   }
+  function matchersForSecret(secret) {
+    const cached = exactSecretMatchers.get(secret);
+    if (cached) return cached;
+    const literals = [secret];
+    try {
+      const encoded = encodeURIComponent(secret);
+      if (encoded !== secret) literals.push(encoded);
+    } catch {
+    }
+    const built = literals.map((literal) => ({
+      literal,
+      matcher: new RegExp(escapeRegExp(literal), "g")
+    }));
+    exactSecretMatchers.set(secret, built);
+    return built;
+  }
   for (const value of initialValues) register(value);
   function containsRegisteredSecret(value, {
     includeEncoded = false,
@@ -4473,21 +4559,13 @@ function createSecretRedactionContext(initialValues = []) {
     return exactSecrets.has(value);
   }
   function redactRegisteredSecrets(value) {
+    if (exactSecrets.size === 0) return value;
     let output2 = value;
     for (const secret of exactSecrets) {
-      output2 = output2.replace(
-        new RegExp(escapeRegExp(secret), "g"),
-        SECRET_REDACTION_PLACEHOLDER
-      );
-      try {
-        const encoded = encodeURIComponent(secret);
-        if (encoded !== secret) {
-          output2 = output2.replace(
-            new RegExp(escapeRegExp(encoded), "g"),
-            SECRET_REDACTION_PLACEHOLDER
-          );
-        }
-      } catch {
+      for (const { literal, matcher } of matchersForSecret(secret)) {
+        if (!output2.includes(literal)) continue;
+        matcher.lastIndex = 0;
+        output2 = output2.replace(matcher, SECRET_REDACTION_PLACEHOLDER);
       }
     }
     return output2;
@@ -4498,13 +4576,33 @@ function createSecretRedactionContext(initialValues = []) {
   }
   function redact(value) {
     if (typeof value === "string") return redactString2(value);
-    if (Array.isArray(value)) return value.map((entry) => redact(entry));
+    if (Array.isArray(value)) {
+      let changed = false;
+      const next = new Array(value.length);
+      for (let index = 0; index < value.length; index += 1) {
+        const entry = value[index];
+        const redacted = redact(entry);
+        next[index] = redacted;
+        if (redacted !== entry) changed = true;
+      }
+      return changed ? next : value;
+    }
     if (value && typeof value === "object") {
+      const prototype = Object.getPrototypeOf(value);
+      let changed = prototype !== Object.prototype && prototype !== null;
+      const source = value;
+      const keys = Object.keys(source);
+      const redactedValues = new Array(keys.length);
+      for (let index = 0; index < keys.length; index += 1) {
+        const key = keys[index];
+        const entry = source[key];
+        const redacted = isSensitiveFieldName(key) ? SECRET_REDACTION_PLACEHOLDER : redact(entry);
+        redactedValues[index] = redacted;
+        if (redacted !== entry) changed = true;
+      }
+      if (!changed) return value;
       return Object.fromEntries(
-        Object.entries(value).map(([key, entry]) => [
-          key,
-          SENSITIVE_FIELD_NAME_RE.test(key) ? SECRET_REDACTION_PLACEHOLDER : redact(entry)
-        ])
+        keys.map((key, index) => [key, redactedValues[index]])
       );
     }
     return value;
@@ -4542,9 +4640,10 @@ var CUSTOMER_OUTPUT_VALUE_MAX_BYTES = 5 * 1024 * 1024;
 var CUSTOMER_OUTPUT_TOTAL_MAX_BYTES = 5 * 1024 * 1024;
 var RUNTIME_RECEIPT_OUTPUT_MAX_BYTES = 10 * 1024 * 1024;
 var RUNTIME_RECEIPT_COMPLETION_BUFFER_MAX_BYTES = 32 * 1024 * 1024;
+var RUNTIME_RECEIPT_CONTROL_BUFFER_MAX_BYTES = 2 * 1024 * 1024;
 var RUNNER_TERMINAL_PUSH_MAX_BODY_BYTES = 16 * 1024 * 1024;
 var RUNTIME_RECEIPT_GATEWAY_BATCH_MAX_BYTES = 12 * 1024 * 1024;
-var RUNTIME_RECEIPT_WRITER_TARGET_BATCH_BYTES = 4 * 1024 * 1024;
+var RUNTIME_RECEIPT_WRITER_TARGET_BATCH_BYTES = 8 * 1024 * 1024;
 var RUNNER_POST_TERMINAL_DIAGNOSTIC_MAX_BYTES = 64 * 1024;
 var JSON_SIZE_LIMIT_REACHED = Symbol("JSON_SIZE_LIMIT_REACHED");
 
@@ -5352,7 +5451,11 @@ function normalizePlayRunLedgerSnapshot(value, fallback) {
       finiteNumber(value.totalLogCount) ?? logTail.length,
       logTail.length
     ),
-    logsTruncated: value.logsTruncated === true,
+    // A persisted snapshot carrying more lines than the tail keeps is
+    // truncated here, whatever the stored flag says. Reporting `false` while
+    // dropping lines is silent loss: a reader would take the tail for the
+    // whole log.
+    logsTruncated: value.logsTruncated === true || logTail.length > LOG_TAIL_LIMIT,
     activeStepId: optionalNullableString(value.activeStepId),
     activeActivityId: optionalNullableString(value.activeActivityId),
     activeArtifactTableNamespace: optionalNullableString(
@@ -6343,28 +6446,42 @@ var PLAY_BACKEND_DESCRIPTORS = {
 // ../play-runtime/runtime-environment.ts
 var PLAY_RUNTIME_ENVIRONMENTS = ["preview"];
 var PLAY_RUNTIME_NAMESPACE_PATTERN = /^[a-z][a-z0-9-]{0,30}$/;
+var PLAY_RUNTIME_SANDBOX_PLACEMENT_POLICY_PATTERN = /^[a-z][a-z0-9_]*@[1-9][0-9]*$/;
 function normalizePlayRuntimeNamespace(value) {
   if (typeof value !== "string") return null;
   const normalized = value.trim();
   return PLAY_RUNTIME_NAMESPACE_PATTERN.test(normalized) ? normalized : null;
 }
+function normalizePlayRuntimeSandboxPlacementPolicy(value) {
+  if (typeof value !== "string") return null;
+  const normalized = value.trim();
+  return PLAY_RUNTIME_SANDBOX_PLACEMENT_POLICY_PATTERN.test(normalized) ? normalized : null;
+}
 function normalizePlayRuntimeSelection(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) return null;
   const record3 = value;
   if (Object.keys(record3).some(
-    (key) => key !== "environment" && key !== "namespace" && key !== "backend"
+    (key) => key !== "environment" && key !== "namespace" && key !== "backend" && key !== "sandboxPlacementPolicy"
   ) || record3.environment !== "preview") {
     return null;
   }
   const namespace = normalizePlayRuntimeNamespace(record3.namespace);
   if (!namespace) return null;
-  if (record3.backend === void 0) {
-    return { environment: "preview", namespace };
+  const sandboxPlacementPolicy = record3.sandboxPlacementPolicy === void 0 ? void 0 : normalizePlayRuntimeSandboxPlacementPolicy(
+    record3.sandboxPlacementPolicy
+  );
+  if (record3.sandboxPlacementPolicy !== void 0 && sandboxPlacementPolicy === null) {
+    return null;
   }
-  if (record3.backend !== PLAY_RUNTIME_BACKENDS.daytona && record3.backend !== PLAY_RUNTIME_BACKENDS.modal) {
+  if (record3.backend !== void 0 && record3.backend !== PLAY_RUNTIME_BACKENDS.daytona && record3.backend !== PLAY_RUNTIME_BACKENDS.modal) {
     return null;
   }
-  return { environment: "preview", namespace, backend: record3.backend };
+  return {
+    environment: "preview",
+    namespace,
+    ...record3.backend === void 0 ? {} : { backend: record3.backend },
+    ...sandboxPlacementPolicy ? { sandboxPlacementPolicy } : {}
+  };
 }
 function normalizePlayRuntimeEnvironment(value) {
   return typeof value === "string" && PLAY_RUNTIME_ENVIRONMENTS.includes(value) ? value : null;
@@ -6458,7 +6575,7 @@ function resolvePlayRunRuntimeSelection(request) {
     const runtime = normalizePlayRuntimeSelection(request.runtime);
     if (!runtime) {
       throw new DeeplineError(
-        'runtime must be { environment: "preview", namespace, backend?: "daytona" | "modal" } with namespace matching ^[a-z][a-z0-9-]{0,30}$.',
+        'runtime must be { environment: "preview", namespace, backend?: "daytona" | "modal", sandboxPlacementPolicy?: "policy_name@1" } with namespace matching ^[a-z][a-z0-9-]{0,30}$.',
         void 0,
         "INVALID_RUNTIME_SELECTION"
       );
@@ -6468,11 +6585,15 @@ function resolvePlayRunRuntimeSelection(request) {
   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();
+  const configuredPlacementPolicy = process.env.DEEPLINE_RUNTIME_SANDBOX_PLACEMENT_POLICY?.trim();
   if (!configured) {
-    if (configuredNamespace || configuredToken) {
+    if (configuredNamespace || configuredToken || configuredPlacementPolicy) {
       const present = [];
       if (configuredNamespace) present.push("DEEPLINE_RUNTIME_NAMESPACE");
       if (configuredToken) present.push("DEEPLINE_RUNTIME_ENVIRONMENT_TOKEN");
+      if (configuredPlacementPolicy) {
+        present.push("DEEPLINE_RUNTIME_SANDBOX_PLACEMENT_POLICY");
+      }
       const isPlural = present.length > 1;
       throw new DeeplineError(
         [
@@ -6503,18 +6624,28 @@ function resolvePlayRunRuntimeSelection(request) {
       "INVALID_RUNTIME_NAMESPACE"
     );
   }
-  const configuredBackend = process.env.DEEPLINE_PLAY_RUNNER_BACKEND?.trim();
-  if (!configuredBackend) {
-    return { environment, namespace };
-  }
-  if (configuredBackend !== "daytona" && configuredBackend !== "modal") {
+  const configuredBackendValue = process.env.DEEPLINE_PLAY_RUNNER_BACKEND?.trim();
+  const configuredBackend = configuredBackendValue === "daytona" || configuredBackendValue === "modal" ? configuredBackendValue : void 0;
+  if (configuredBackendValue && !configuredBackend) {
     throw new DeeplineError(
-      `DEEPLINE_PLAY_RUNNER_BACKEND must be daytona or modal for preview runtime selection. Received "${configuredBackend}".`,
+      `DEEPLINE_PLAY_RUNNER_BACKEND must be daytona or modal for preview runtime selection. Received "${configuredBackendValue}".`,
       void 0,
       "INVALID_RUNTIME_BACKEND"
     );
   }
-  return { environment, namespace, backend: configuredBackend };
+  if (configuredPlacementPolicy && !normalizePlayRuntimeSandboxPlacementPolicy(configuredPlacementPolicy)) {
+    throw new DeeplineError(
+      `DEEPLINE_RUNTIME_SANDBOX_PLACEMENT_POLICY must be a versioned placement policy id such as daytona_only@1. Received "${configuredPlacementPolicy}".`,
+      void 0,
+      "INVALID_RUNTIME_SANDBOX_PLACEMENT_POLICY"
+    );
+  }
+  return {
+    environment,
+    namespace,
+    ...configuredBackend ? { backend: configuredBackend } : {},
+    ...configuredPlacementPolicy ? { sandboxPlacementPolicy: configuredPlacementPolicy } : {}
+  };
 }
 function runtimeSelectionHeaders(runtime) {
   if (!runtime) return void 0;
@@ -16815,6 +16946,70 @@ var import_esbuild = require("esbuild");
 // ../plays/authoring-contract.ts
 var import_typebox = require("@sinclair/typebox");
 var import_value = require("@sinclair/typebox/value");
+var SUPPORTED_PLAY_AUTHORING_CONTRACT_EDITIONS = [
+  1,
+  2,
+  3,
+  4,
+  5,
+  6,
+  7,
+  8
+];
+var PLAY_AUTHORING_CONTRACT_CHANGELOG_DETAILS = [
+  {
+    changed: "Historical extraction semantics. Invalid or unresolved optional authoring fields may normalize to absence.",
+    compatibilityOwner: "Plays Runtime",
+    newWritesEnd: "2026-11-03",
+    readerRemoval: "After every retained edition 1 artifact has a materialized admitted snapshot."
+  },
+  {
+    changed: "Pins admitted authoring snapshots and rejects ambiguous billing, secret, webhook, fetch, timeout, receipt-wait, and freshness contracts.",
+    compatibilityOwner: "Plays Runtime",
+    newWritesEnd: "2026-08-03",
+    readerRemoval: "After every retained edition 2 artifact has an admitted input schema or has been republished."
+  },
+  {
+    changed: "Materializes the declared input schema in the admitted snapshot so launch never reparses current source.",
+    compatibilityOwner: "Plays Runtime",
+    newWritesEnd: "2026-08-19",
+    readerRemoval: null
+  },
+  {
+    changed: "ctx.secrets.get(name) resolves an allowed secret to a plaintext string for ordinary Play code. Editions 1\u20133 retain opaque secret handles.",
+    compatibilityOwner: "Plays Runtime",
+    newWritesEnd: null,
+    readerRemoval: null
+  },
+  {
+    changed: "ctx.fetch throws a typed, redacted CtxFetchHttpError for non-2xx responses. Editions 1\u20134 continue to return the response record for every HTTP status.",
+    compatibilityOwner: "Plays Runtime",
+    newWritesEnd: null,
+    readerRemoval: null
+  },
+  {
+    changed: "Adds static cron input and rejects unknown definePlay and binding fields during new admission. Editions 1\u20135 retain their admitted binding semantics.",
+    compatibilityOwner: "Plays Runtime",
+    newWritesEnd: null,
+    readerRemoval: null
+  },
+  {
+    changed: "Slack HITL calls that omit timeout wait one week. Editions 1\u20136 retain the historical 24-hour default.",
+    compatibilityOwner: "Plays Runtime",
+    newWritesEnd: null,
+    readerRemoval: null
+  },
+  {
+    changed: "Lets an inline scalar child execute without a stored static pipeline. Dataset creation and suspension remain rejected by the authoritative runtime capability boundary; editions 1\u20137 retain static-contract preflight rejection.",
+    compatibilityOwner: "Plays Runtime",
+    newWritesEnd: null,
+    readerRemoval: null
+  }
+];
+var PLAY_AUTHORING_CONTRACT_CHANGELOG = SUPPORTED_PLAY_AUTHORING_CONTRACT_EDITIONS.map((edition, index) => ({
+  edition,
+  ...PLAY_AUTHORING_CONTRACT_CHANGELOG_DETAILS[index]
+}));
 var PLAY_SQL_LISTENER_WHERE_OPERATORS = [
   "eq",
   "neq",
@@ -23460,7 +23655,7 @@ function assertPlayWaitNotTimedOut(input2) {
   if (input2.waitTimeoutMs !== null && Date.now() - input2.startedAt >= input2.waitTimeoutMs) {
     const hasRealRunId = input2.workflowId.length > 0 && input2.workflowId !== "pending";
     const phaseSuffix = input2.lastPhase && input2.lastPhase.trim() ? ` (last observed phase: ${input2.lastPhase.trim()})` : "";
-    const tailHint = hasRealRunId ? ` Run 'deepline runs tail ${input2.workflowId} --json' to inspect it, or rerun with a larger --tail-timeout-ms.` : ` The run never reported a workflow id \u2014 the start request likely failed before reaching the scheduler. Check server logs and rerun with a larger --tail-timeout-ms.`;
+    const tailHint = hasRealRunId ? ` The CLI stopped waiting; it did not cancel the run. Check its current state with 'deepline runs get ${input2.workflowId} --json', or reattach with 'deepline runs tail ${input2.workflowId} --json'. Do not start another run just to retrieve results.` : ` No run id was received, so acceptance is unknown. Check recent runs with 'deepline runs list --play <play-name> --json' before submitting again.`;
     throw new DeeplineError(
       `Timed out waiting for play ${hasRealRunId ? input2.workflowId : "<no run id>"} after ${Math.ceil(input2.waitTimeoutMs / 1e3)}s${phaseSuffix}.${tailHint}`,
       void 0,
@@ -25025,6 +25220,18 @@ function buildRunPackageTextLines(packaged) {
   const lines = [
     `${status === "completed" ? "\u2713" : status === "failed" ? "\u2717" : "\u2022"} ${status}  ${runId}`
   ];
+  const isRuntimeTimeout = status === "failed" && (readRecordArray(packaged.errors).some(
+    (error) => error.code === "RUNTIME_LIMIT_EXCEEDED"
+  ) || typeof run.error === "string" && /RUNTIME_LIMIT_EXCEEDED/.test(run.error));
+  if (isRuntimeTimeout) {
+    lines.push("  RUNTIME_LIMIT_EXCEEDED: the Play stopped before returning.");
+    lines.push(
+      "  Inspect the dataset catalog below and export saved data before rerunning unfinished work."
+    );
+    lines.push(
+      "  Adjust runtime.timeout in the Play (maximum 4h), remove the override for the 30-minute default, or use fewer rows."
+    );
+  }
   const runError = typeof run.error === "string" && run.error.trim() ? run.error.trim() : null;
   if (runError && (status === "failed" || status === "cancelled")) {
     lines.push(`  error: ${truncateErrorForDisplay(runError, runId)}`);
@@ -25101,14 +25308,19 @@ function buildRunPackageTextLines(packaged) {
   const legacyExportCommand = hasCatalogExportAction ? null : actionToCommand(next.export);
   const runAgainCommand = typeof next.run === "string" && next.run.trim() ? next.run.trim() : null;
   if (inspectCommand) lines.push(`  inspect: ${inspectCommand}`);
-  if (fullResultCommand) lines.push(`  full result: ${fullResultCommand}`);
+  if (fullResultCommand)
+    lines.push(
+      `  ${isRuntimeTimeout ? "full run details" : "full result"}: ${fullResultCommand}`
+    );
   if (logsCommand) lines.push(`  logs: ${logsCommand}`);
   if (billingCommand) lines.push(`  billing: ${billingCommand}`);
   if (legacyExportCommand) {
     lines.push(`  export CSV: ${legacyExportCommand}`);
   }
   if (runAgainCommand) {
-    lines.push("  run again (completed work is reused):");
+    lines.push(
+      isRuntimeTimeout ? "  run again after adjusting the deadline or batch (compatible completed work may be reused):" : "  run again (completed work is reused):"
+    );
     lines.push(`    ${runAgainCommand}`);
   }
   return lines;