deepline 0.1.320 → 0.2.1

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

@@ -105,17 +105,14 @@ export type PlayDatasetTransformOptions = {
  * runtime control. Use `count()` and `peek()` for bounded inspection. Use
  * `materialize(limit)` or async iteration only when the dataset is intentionally
  * small and bounded. `PlayDataset` intentionally does not expose `.rows`,
- * `.toArray()`, or other array aliases; those hide the runtime cost of loading
- * persisted rows into memory.
+ * `.toArray()`, `.length`, numeric indexing, spread, or synchronous iteration;
+ * those hide the runtime cost of loading persisted rows into memory or make
+ * behavior depend on whether rows happen to be resident.
  *
  * @sdkReference runtime 190
  */
-export interface PlayDataset<T> extends AsyncIterable<T>, Iterable<T> {
+export interface PlayDataset<T> extends AsyncIterable<T> {
   readonly [PLAY_DATASET_BRAND]: true;
-  /** Authoritative row count when known without I/O. */
-  readonly length: number;
-  /** Resident row access. Throws when the requested row requires I/O. */
-  readonly [index: number]: T;
   /** Dataset kind. */
   readonly datasetKind: PlayDatasetKind;
   /** Dataset id. */
@@ -413,7 +410,6 @@ export function trimSerializedPlayDatasetPreview<T>(
 }
 
 class DeferredPlayDataset<T> implements PlayDataset<T> {
-  readonly [index: number]: T;
   readonly [PLAY_DATASET_BRAND] = true as const;
   readonly datasetKind: PlayDatasetKind;
   readonly datasetId: string;
@@ -456,15 +452,6 @@ class DeferredPlayDataset<T> implements PlayDataset<T> {
     this.resolvers = input.resolvers;
   }
 
-  get length(): number {
-    if (this.knownCount === null) {
-      throw this.requiresAsyncAccess(
-        'The row count is not known until this lazy transform executes.',
-      );
-    }
-    return this.knownCount;
-  }
-
   async count(): Promise<number> {
     this.cachedCount = await this.resolvers.count();
     this.knownCount = this.cachedCount;
@@ -492,6 +479,9 @@ class DeferredPlayDataset<T> implements PlayDataset<T> {
       return undefined;
     }
     if (this.residentRows) return this.residentRows[normalized];
+    if (normalized < this.previewRows.length) {
+      return this.previewRows[normalized];
+    }
     if (this.resolvers.at) return await this.resolvers.at(normalized);
     let current = 0;
     for await (const row of this.resolvers.iterate()) {
@@ -591,33 +581,6 @@ class DeferredPlayDataset<T> implements PlayDataset<T> {
     }
   }
 
-  [Symbol.iterator](): Iterator<T> {
-    if (!this.residentRows) {
-      throw this.requiresAsyncAccess(
-        'Synchronous iteration is available only when every row is resident.',
-      );
-    }
-    return this.residentRows[Symbol.iterator]();
-  }
-
-  residentAt(index: number): T | undefined {
-    if (this.knownCount !== null && index >= this.knownCount) return undefined;
-    if (!this.residentRows) {
-      throw this.requiresAsyncAccess(
-        `Row ${index} is not resident and may require dataset paging.`,
-      );
-    }
-    return this.residentRows[index];
-  }
-
-  private requiresAsyncAccess(detail: string): Error {
-    return new Error(
-      `PLAY_DATASET_REQUIRES_ASYNC_ACCESS: ${detail} ` +
-        `Dataset Handle ${this.sourceLabel ?? this.datasetId}. ` +
-        'Use await dataset.first(), await dataset.at(index), await dataset.materialize(limit), or for await...of.',
-    );
-  }
-
   toJSON() {
     return {
       kind: 'dataset' as const,
@@ -802,8 +765,28 @@ export function createDeferredPlayDataset<T>(input: {
   const boundMethods = new Map<PropertyKey, unknown>();
   const dataset = new Proxy(target, {
     get(dataset, property) {
+      if (property === 'length') {
+        throw datasetAsyncOnlyError(
+          dataset,
+          'Dataset Handles do not expose synchronous .length.',
+          'Use await dataset.count().',
+        );
+      }
       if (typeof property === 'string' && /^(0|[1-9]\d*)$/.test(property)) {
-        return dataset.residentAt(Number(property));
+        throw datasetAsyncOnlyError(
+          dataset,
+          `Dataset Handles do not expose synchronous row indexing (${property}).`,
+          `Use await dataset.at(${property}) or await dataset.first().`,
+        );
+      }
+      if (property === Symbol.iterator) {
+        return () => {
+          throw datasetAsyncOnlyError(
+            dataset,
+            'Dataset Handles do not support synchronous iteration.',
+            'Use for await...of or await dataset.materialize(limit).',
+          );
+        };
       }
       const value = Reflect.get(dataset, property, dataset);
       if (typeof value !== 'function') return value;
@@ -817,8 +800,10 @@ export function createDeferredPlayDataset<T>(input: {
         property === 'length' ||
         (typeof property === 'string' && /^(0|[1-9]\d*)$/.test(property))
       ) {
-        throw new Error(
-          'PLAY_DATASET_READ_ONLY: Dataset Handle rows cannot be assigned directly.',
+        throw datasetAsyncOnlyError(
+          target,
+          'Dataset Handles do not support synchronous array assignment.',
+          'Transform rows with dataset.map(...) or explicitly materialize a bounded array.',
         );
       }
       return false;
@@ -831,6 +816,17 @@ export function createDeferredPlayDataset<T>(input: {
   return dataset;
 }
 
+function datasetAsyncOnlyError(
+  dataset: Pick<PlayDataset<unknown>, 'datasetId' | 'sourceLabel'>,
+  detail: string,
+  guidance: string,
+): Error {
+  return new Error(
+    `PLAY_DATASET_ASYNC_ONLY: ${detail} ` +
+      `Dataset Handle ${dataset.sourceLabel ?? dataset.datasetId}. ${guidance}`,
+  );
+}
+
 export function createPlayDataset<T>(
   rows: readonly T[],
   metadata?: {

package/dist/cli/index.js

@@ -1037,7 +1037,10 @@ var SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: "0.1.320",
+  // 0.2.0 makes Dataset Handles uniformly async-only after 0.1.320 briefly
+  // exposed storage-dependent synchronous access. This deliberate minor
+  // release keeps lazy paging semantics independent of row residency.
+  version: "0.2.1",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -3244,6 +3247,33 @@ function usesExtendedTheirstackJobSearchBudget(endpointId, payload) {
   return maxAgeDays !== null && maxAgeDays >= 365 ? true : usesLongExplicitDateWindow(payload);
 }
 
+// ../shared_libs/play-runtime/backend.ts
+var PLAY_RUNTIME_BACKENDS = {
+  localProcess: "local_process",
+  daytona: "daytona",
+  modal: "modal"
+};
+var PLAY_ARTIFACT_KINDS = {
+  cjsNode20: "cjs_node20"
+};
+var PLAY_BACKEND_DESCRIPTORS = {
+  [PLAY_RUNTIME_BACKENDS.localProcess]: {
+    id: PLAY_RUNTIME_BACKENDS.localProcess,
+    artifactKind: PLAY_ARTIFACT_KINDS.cjsNode20,
+    label: "Local node subprocess"
+  },
+  [PLAY_RUNTIME_BACKENDS.daytona]: {
+    id: PLAY_RUNTIME_BACKENDS.daytona,
+    artifactKind: PLAY_ARTIFACT_KINDS.cjsNode20,
+    label: "Daytona sandbox"
+  },
+  [PLAY_RUNTIME_BACKENDS.modal]: {
+    id: PLAY_RUNTIME_BACKENDS.modal,
+    artifactKind: PLAY_ARTIFACT_KINDS.cjsNode20,
+    label: "Modal sandbox"
+  }
+};
+
 // ../shared_libs/play-runtime/runtime-environment.ts
 var PLAY_RUNTIME_ENVIRONMENTS = ["preview"];
 var PLAY_RUNTIME_NAMESPACE_PATTERN = /^[a-z][a-z0-9-]{0,30}$/;
@@ -3256,12 +3286,19 @@ 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"
+    (key) => key !== "environment" && key !== "namespace" && key !== "backend"
   ) || record.environment !== "preview") {
     return null;
   }
   const namespace = normalizePlayRuntimeNamespace(record.namespace);
-  return namespace ? { environment: "preview", namespace } : null;
+  if (!namespace) return null;
+  if (record.backend === void 0) {
+    return { environment: "preview", namespace };
+  }
+  if (record.backend !== PLAY_RUNTIME_BACKENDS.daytona && record.backend !== PLAY_RUNTIME_BACKENDS.modal) {
+    return null;
+  }
+  return { environment: "preview", namespace, backend: record.backend };
 }
 function normalizePlayRuntimeEnvironment(value) {
   return typeof value === "string" && PLAY_RUNTIME_ENVIRONMENTS.includes(value) ? value : null;
@@ -3294,7 +3331,7 @@ function resolvePlayRunRuntimeSelection(request) {
     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}$.',
+        'runtime must be { environment: "preview", namespace, backend?: "daytona" | "modal" } with namespace matching ^[a-z][a-z0-9-]{0,30}$.',
         void 0,
         "INVALID_RUNTIME_SELECTION"
       );
@@ -3330,7 +3367,18 @@ function resolvePlayRunRuntimeSelection(request) {
       "INVALID_RUNTIME_NAMESPACE"
     );
   }
-  return { environment, namespace };
+  const configuredBackend = process.env.DEEPLINE_PLAY_RUNNER_BACKEND?.trim();
+  if (!configuredBackend) {
+    return { environment, namespace };
+  }
+  if (configuredBackend !== "daytona" && configuredBackend !== "modal") {
+    throw new DeeplineError(
+      `DEEPLINE_PLAY_RUNNER_BACKEND must be daytona or modal for preview runtime selection. Received "${configuredBackend}".`,
+      void 0,
+      "INVALID_RUNTIME_BACKEND"
+    );
+  }
+  return { environment, namespace, backend: configuredBackend };
 }
 function runtimeSelectionHeaders(runtime) {
   if (!runtime) return void 0;
@@ -11991,7 +12039,7 @@ async function traceCliSpan(phase, fields, run) {
 
 // src/cli/play-check-hints.ts
 var EXTRACTED_GETTER_ERROR_HINT = "Deepline hint: extractedValues/extractedLists .get() only works for declared Deepline getters listed by `deepline tools describe <tool> --json`. Use `toolExecutionResult.toolResponse.raw` for provider/tool-specific scalar fields, and `toolExecutionResult.extractedLists.<name>.get()` for declared row/list outputs.";
-var DATASET_API_HINT = "Deepline hint: PlayDataset is lazy and durable. Complete resident handles support read-only length/index/iteration. For paged rows use `.first()`, `.at(index)`, `.peek(n)`, `.materialize(limit)`, or async iteration; do not use `.rows` or `.toArray()`.";
+var DATASET_API_HINT = "Deepline hint: PlayDataset is lazy, durable, and async-only. Use `.count()`, `.first()`, `.at(index)`, `.peek(n)`, `.materialize(limit)`, or async iteration; do not use `.length`, numeric indexing, spread, synchronous iteration, `.rows`, or `.toArray()`.";
 var ROW_PROPERTY_HINT = "Deepline hint: this row type only contains fields produced by the CSV/schema and previous map steps. Check source column casing and the exact output field names from earlier steps before scaling.";
 var TOOLS_EXECUTE_SIGNATURE_HINT = "Deepline hint: ctx.tools.execute requires a request object: `ctx.tools.execute({ id, tool, input, description })`. The stable `id` is required for logs, metadata, and receipt attachment; provider-call reuse is based on play, tool, semantic input, auth scope, provider action version, and cache policy.";
 var RUN_PLAY_SIGNATURE_HINT = "Deepline hint: ctx.runPlay uses a stable key plus a composable child play reference. Direct-run-only or dataset-backed batch plays must be run directly, exported, then consumed by a separate play.";
@@ -12009,7 +12057,7 @@ function looksLikeInvalidExtractedGetter(error, sourceLine) {
 function looksLikeDatasetApiMisuse(error, sourceLine) {
   return /Property '(?:rows|toArray|forEach|map|filter|reduce)' does not exist on type '[^']*PlayDataset/.test(
     error
-  ) || /\b(?:\.rows|\.toArray\(\)|\.forEach\(|\.map\(|\.filter\(|\.reduce\()/.test(
+  ) || /PlayDataset/.test(error) && (/Property 'length' does not exist/.test(error) || /can't be used to index type/.test(error) || /\[Symbol\.iterator\]/.test(error) || /not iterable/.test(error)) || /\b(?:\.rows|\.toArray\(\)|\.forEach\(|\.map\(|\.filter\(|\.reduce\()/.test(
     sourceLine
   );
 }
@@ -12064,27 +12112,6 @@ ${hint}`;
   });
 }
 
-// ../shared_libs/play-runtime/backend.ts
-var PLAY_RUNTIME_BACKENDS = {
-  localProcess: "local_process",
-  daytona: "daytona"
-};
-var PLAY_ARTIFACT_KINDS = {
-  cjsNode20: "cjs_node20"
-};
-var PLAY_BACKEND_DESCRIPTORS = {
-  [PLAY_RUNTIME_BACKENDS.localProcess]: {
-    id: PLAY_RUNTIME_BACKENDS.localProcess,
-    artifactKind: PLAY_ARTIFACT_KINDS.cjsNode20,
-    label: "Local node subprocess"
-  },
-  [PLAY_RUNTIME_BACKENDS.daytona]: {
-    id: PLAY_RUNTIME_BACKENDS.daytona,
-    artifactKind: PLAY_ARTIFACT_KINDS.cjsNode20,
-    label: "Daytona sandbox"
-  }
-};
-
 // ../shared_libs/play-runtime/dedup-backend.ts
 var PLAY_DEDUP_BACKENDS = {
   inMemory: "in_memory",

package/dist/cli/index.mjs

@@ -1022,7 +1022,10 @@ var SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: "0.1.320",
+  // 0.2.0 makes Dataset Handles uniformly async-only after 0.1.320 briefly
+  // exposed storage-dependent synchronous access. This deliberate minor
+  // release keeps lazy paging semantics independent of row residency.
+  version: "0.2.1",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -3229,6 +3232,33 @@ function usesExtendedTheirstackJobSearchBudget(endpointId, payload) {
   return maxAgeDays !== null && maxAgeDays >= 365 ? true : usesLongExplicitDateWindow(payload);
 }
 
+// ../shared_libs/play-runtime/backend.ts
+var PLAY_RUNTIME_BACKENDS = {
+  localProcess: "local_process",
+  daytona: "daytona",
+  modal: "modal"
+};
+var PLAY_ARTIFACT_KINDS = {
+  cjsNode20: "cjs_node20"
+};
+var PLAY_BACKEND_DESCRIPTORS = {
+  [PLAY_RUNTIME_BACKENDS.localProcess]: {
+    id: PLAY_RUNTIME_BACKENDS.localProcess,
+    artifactKind: PLAY_ARTIFACT_KINDS.cjsNode20,
+    label: "Local node subprocess"
+  },
+  [PLAY_RUNTIME_BACKENDS.daytona]: {
+    id: PLAY_RUNTIME_BACKENDS.daytona,
+    artifactKind: PLAY_ARTIFACT_KINDS.cjsNode20,
+    label: "Daytona sandbox"
+  },
+  [PLAY_RUNTIME_BACKENDS.modal]: {
+    id: PLAY_RUNTIME_BACKENDS.modal,
+    artifactKind: PLAY_ARTIFACT_KINDS.cjsNode20,
+    label: "Modal sandbox"
+  }
+};
+
 // ../shared_libs/play-runtime/runtime-environment.ts
 var PLAY_RUNTIME_ENVIRONMENTS = ["preview"];
 var PLAY_RUNTIME_NAMESPACE_PATTERN = /^[a-z][a-z0-9-]{0,30}$/;
@@ -3241,12 +3271,19 @@ 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"
+    (key) => key !== "environment" && key !== "namespace" && key !== "backend"
   ) || record.environment !== "preview") {
     return null;
   }
   const namespace = normalizePlayRuntimeNamespace(record.namespace);
-  return namespace ? { environment: "preview", namespace } : null;
+  if (!namespace) return null;
+  if (record.backend === void 0) {
+    return { environment: "preview", namespace };
+  }
+  if (record.backend !== PLAY_RUNTIME_BACKENDS.daytona && record.backend !== PLAY_RUNTIME_BACKENDS.modal) {
+    return null;
+  }
+  return { environment: "preview", namespace, backend: record.backend };
 }
 function normalizePlayRuntimeEnvironment(value) {
   return typeof value === "string" && PLAY_RUNTIME_ENVIRONMENTS.includes(value) ? value : null;
@@ -3279,7 +3316,7 @@ function resolvePlayRunRuntimeSelection(request) {
     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}$.',
+        'runtime must be { environment: "preview", namespace, backend?: "daytona" | "modal" } with namespace matching ^[a-z][a-z0-9-]{0,30}$.',
         void 0,
         "INVALID_RUNTIME_SELECTION"
       );
@@ -3315,7 +3352,18 @@ function resolvePlayRunRuntimeSelection(request) {
       "INVALID_RUNTIME_NAMESPACE"
     );
   }
-  return { environment, namespace };
+  const configuredBackend = process.env.DEEPLINE_PLAY_RUNNER_BACKEND?.trim();
+  if (!configuredBackend) {
+    return { environment, namespace };
+  }
+  if (configuredBackend !== "daytona" && configuredBackend !== "modal") {
+    throw new DeeplineError(
+      `DEEPLINE_PLAY_RUNNER_BACKEND must be daytona or modal for preview runtime selection. Received "${configuredBackend}".`,
+      void 0,
+      "INVALID_RUNTIME_BACKEND"
+    );
+  }
+  return { environment, namespace, backend: configuredBackend };
 }
 function runtimeSelectionHeaders(runtime) {
   if (!runtime) return void 0;
@@ -12020,7 +12068,7 @@ async function traceCliSpan(phase, fields, run) {
 
 // src/cli/play-check-hints.ts
 var EXTRACTED_GETTER_ERROR_HINT = "Deepline hint: extractedValues/extractedLists .get() only works for declared Deepline getters listed by `deepline tools describe <tool> --json`. Use `toolExecutionResult.toolResponse.raw` for provider/tool-specific scalar fields, and `toolExecutionResult.extractedLists.<name>.get()` for declared row/list outputs.";
-var DATASET_API_HINT = "Deepline hint: PlayDataset is lazy and durable. Complete resident handles support read-only length/index/iteration. For paged rows use `.first()`, `.at(index)`, `.peek(n)`, `.materialize(limit)`, or async iteration; do not use `.rows` or `.toArray()`.";
+var DATASET_API_HINT = "Deepline hint: PlayDataset is lazy, durable, and async-only. Use `.count()`, `.first()`, `.at(index)`, `.peek(n)`, `.materialize(limit)`, or async iteration; do not use `.length`, numeric indexing, spread, synchronous iteration, `.rows`, or `.toArray()`.";
 var ROW_PROPERTY_HINT = "Deepline hint: this row type only contains fields produced by the CSV/schema and previous map steps. Check source column casing and the exact output field names from earlier steps before scaling.";
 var TOOLS_EXECUTE_SIGNATURE_HINT = "Deepline hint: ctx.tools.execute requires a request object: `ctx.tools.execute({ id, tool, input, description })`. The stable `id` is required for logs, metadata, and receipt attachment; provider-call reuse is based on play, tool, semantic input, auth scope, provider action version, and cache policy.";
 var RUN_PLAY_SIGNATURE_HINT = "Deepline hint: ctx.runPlay uses a stable key plus a composable child play reference. Direct-run-only or dataset-backed batch plays must be run directly, exported, then consumed by a separate play.";
@@ -12038,7 +12086,7 @@ function looksLikeInvalidExtractedGetter(error, sourceLine) {
 function looksLikeDatasetApiMisuse(error, sourceLine) {
   return /Property '(?:rows|toArray|forEach|map|filter|reduce)' does not exist on type '[^']*PlayDataset/.test(
     error
-  ) || /\b(?:\.rows|\.toArray\(\)|\.forEach\(|\.map\(|\.filter\(|\.reduce\()/.test(
+  ) || /PlayDataset/.test(error) && (/Property 'length' does not exist/.test(error) || /can't be used to index type/.test(error) || /\[Symbol\.iterator\]/.test(error) || /not iterable/.test(error)) || /\b(?:\.rows|\.toArray\(\)|\.forEach\(|\.map\(|\.filter\(|\.reduce\()/.test(
     sourceLine
   );
 }
@@ -12093,27 +12141,6 @@ ${hint}`;
   });
 }
 
-// ../shared_libs/play-runtime/backend.ts
-var PLAY_RUNTIME_BACKENDS = {
-  localProcess: "local_process",
-  daytona: "daytona"
-};
-var PLAY_ARTIFACT_KINDS = {
-  cjsNode20: "cjs_node20"
-};
-var PLAY_BACKEND_DESCRIPTORS = {
-  [PLAY_RUNTIME_BACKENDS.localProcess]: {
-    id: PLAY_RUNTIME_BACKENDS.localProcess,
-    artifactKind: PLAY_ARTIFACT_KINDS.cjsNode20,
-    label: "Local node subprocess"
-  },
-  [PLAY_RUNTIME_BACKENDS.daytona]: {
-    id: PLAY_RUNTIME_BACKENDS.daytona,
-    artifactKind: PLAY_ARTIFACT_KINDS.cjsNode20,
-    label: "Daytona sandbox"
-  }
-};
-
 // ../shared_libs/play-runtime/dedup-backend.ts
 var PLAY_DEDUP_BACKENDS = {
   inMemory: "in_memory",

package/dist/index.d.mts

@@ -1,10 +1,12 @@
-import { a as PlayCompilerManifest, D as DeeplineError, c as ToolExecutionError, d as ToolExecutionErrorOptions, T as ToolExecutionErrorSchemaVersion } from './tool-execution-error-YDz7UMl-.mjs';
-export { e as ProviderTransientError, f as ProviderTransientErrorCategory, g as ToolExecutionErrorCategory, h as ToolExecutionErrorOrigin, i as ToolExecutionFailureV1, j as ToolExecutionNetworkKind, k as ToolExecutionNetworkScope } from './tool-execution-error-YDz7UMl-.mjs';
+import { c as PlayRuntimeBackendId, a as PlayCompilerManifest, D as DeeplineError, d as ToolExecutionError, e as ToolExecutionErrorOptions, T as ToolExecutionErrorSchemaVersion } from './tool-execution-error-4-rhemLQ.mjs';
+export { f as ProviderTransientError, g as ProviderTransientErrorCategory, h as ToolExecutionErrorCategory, i as ToolExecutionErrorOrigin, j as ToolExecutionFailureV1, k as ToolExecutionNetworkKind, l as ToolExecutionNetworkScope } from './tool-execution-error-4-rhemLQ.mjs';
 
 type PlayRuntimeSelection = {
     environment: 'preview';
     /** Caller-named isolation scope inside a remote runtime environment. */
     namespace: string;
+    /** Explicit managed-sandbox executor. Omission preserves Daytona compatibility. */
+    backend?: Extract<PlayRuntimeBackendId, 'daytona' | 'modal'>;
 };
 
 /**
@@ -3605,17 +3607,14 @@ type PlayDatasetTransformOptions = {
  * runtime control. Use `count()` and `peek()` for bounded inspection. Use
  * `materialize(limit)` or async iteration only when the dataset is intentionally
  * small and bounded. `PlayDataset` intentionally does not expose `.rows`,
- * `.toArray()`, or other array aliases; those hide the runtime cost of loading
- * persisted rows into memory.
+ * `.toArray()`, `.length`, numeric indexing, spread, or synchronous iteration;
+ * those hide the runtime cost of loading persisted rows into memory or make
+ * behavior depend on whether rows happen to be resident.
  *
  * @sdkReference runtime 190
  */
-interface PlayDataset<T> extends AsyncIterable<T>, Iterable<T> {
+interface PlayDataset<T> extends AsyncIterable<T> {
     readonly [PLAY_DATASET_BRAND]: true;
-    /** Authoritative row count when known without I/O. */
-    readonly length: number;
-    /** Resident row access. Throws when the requested row requires I/O. */
-    readonly [index: number]: T;
     /** Dataset kind. */
     readonly datasetKind: PlayDatasetKind;
     /** Dataset id. */

package/dist/index.d.ts

@@ -1,10 +1,12 @@
-import { a as PlayCompilerManifest, D as DeeplineError, c as ToolExecutionError, d as ToolExecutionErrorOptions, T as ToolExecutionErrorSchemaVersion } from './tool-execution-error-YDz7UMl-.js';
-export { e as ProviderTransientError, f as ProviderTransientErrorCategory, g as ToolExecutionErrorCategory, h as ToolExecutionErrorOrigin, i as ToolExecutionFailureV1, j as ToolExecutionNetworkKind, k as ToolExecutionNetworkScope } from './tool-execution-error-YDz7UMl-.js';
+import { c as PlayRuntimeBackendId, a as PlayCompilerManifest, D as DeeplineError, d as ToolExecutionError, e as ToolExecutionErrorOptions, T as ToolExecutionErrorSchemaVersion } from './tool-execution-error-4-rhemLQ.js';
+export { f as ProviderTransientError, g as ProviderTransientErrorCategory, h as ToolExecutionErrorCategory, i as ToolExecutionErrorOrigin, j as ToolExecutionFailureV1, k as ToolExecutionNetworkKind, l as ToolExecutionNetworkScope } from './tool-execution-error-4-rhemLQ.js';
 
 type PlayRuntimeSelection = {
     environment: 'preview';
     /** Caller-named isolation scope inside a remote runtime environment. */
     namespace: string;
+    /** Explicit managed-sandbox executor. Omission preserves Daytona compatibility. */
+    backend?: Extract<PlayRuntimeBackendId, 'daytona' | 'modal'>;
 };
 
 /**
@@ -3605,17 +3607,14 @@ type PlayDatasetTransformOptions = {
  * runtime control. Use `count()` and `peek()` for bounded inspection. Use
  * `materialize(limit)` or async iteration only when the dataset is intentionally
  * small and bounded. `PlayDataset` intentionally does not expose `.rows`,
- * `.toArray()`, or other array aliases; those hide the runtime cost of loading
- * persisted rows into memory.
+ * `.toArray()`, `.length`, numeric indexing, spread, or synchronous iteration;
+ * those hide the runtime cost of loading persisted rows into memory or make
+ * behavior depend on whether rows happen to be resident.
  *
  * @sdkReference runtime 190
  */
-interface PlayDataset<T> extends AsyncIterable<T>, Iterable<T> {
+interface PlayDataset<T> extends AsyncIterable<T> {
     readonly [PLAY_DATASET_BRAND]: true;
-    /** Authoritative row count when known without I/O. */
-    readonly length: number;
-    /** Resident row access. Throws when the requested row requires I/O. */
-    readonly [index: number]: T;
     /** Dataset kind. */
     readonly datasetKind: PlayDatasetKind;
     /** Dataset id. */