deepline 0.1.320 → 0.2.1

package/dist/index.js

@@ -760,7 +760,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",
@@ -2967,6 +2970,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}$/;
@@ -2979,12 +3009,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;
@@ -3017,7 +3054,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"
       );
@@ -3053,7 +3090,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;
@@ -5842,14 +5890,6 @@ var DeferredPlayDataset = class {
     this.workProgress = input.workProgress;
     this.resolvers = input.resolvers;
   }
-  get length() {
-    if (this.knownCount === null) {
-      throw this.requiresAsyncAccess(
-        "The row count is not known until this lazy transform executes."
-      );
-    }
-    return this.knownCount;
-  }
   async count() {
     this.cachedCount = await this.resolvers.count();
     this.knownCount = this.cachedCount;
@@ -5873,6 +5913,9 @@ var DeferredPlayDataset = class {
       return void 0;
     }
     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()) {
@@ -5942,28 +5985,6 @@ var DeferredPlayDataset = class {
       yield row;
     }
   }
-  [Symbol.iterator]() {
-    if (!this.residentRows) {
-      throw this.requiresAsyncAccess(
-        "Synchronous iteration is available only when every row is resident."
-      );
-    }
-    return this.residentRows[Symbol.iterator]();
-  }
-  residentAt(index) {
-    if (this.knownCount !== null && index >= this.knownCount) return void 0;
-    if (!this.residentRows) {
-      throw this.requiresAsyncAccess(
-        `Row ${index} is not resident and may require dataset paging.`
-      );
-    }
-    return this.residentRows[index];
-  }
-  requiresAsyncAccess(detail) {
-    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",
@@ -6094,8 +6115,28 @@ function createDeferredPlayDataset(input) {
   const boundMethods = /* @__PURE__ */ new Map();
   const dataset = new Proxy(target, {
     get(dataset2, property) {
+      if (property === "length") {
+        throw datasetAsyncOnlyError(
+          dataset2,
+          "Dataset Handles do not expose synchronous .length.",
+          "Use await dataset.count()."
+        );
+      }
       if (typeof property === "string" && /^(0|[1-9]\d*)$/.test(property)) {
-        return dataset2.residentAt(Number(property));
+        throw datasetAsyncOnlyError(
+          dataset2,
+          `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(
+            dataset2,
+            "Dataset Handles do not support synchronous iteration.",
+            "Use for await...of or await dataset.materialize(limit)."
+          );
+        };
       }
       const value = Reflect.get(dataset2, property, dataset2);
       if (typeof value !== "function") return value;
@@ -6106,8 +6147,10 @@ function createDeferredPlayDataset(input) {
     },
     set(_dataset, property) {
       if (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;
@@ -6119,6 +6162,11 @@ function createDeferredPlayDataset(input) {
   }
   return dataset;
 }
+function datasetAsyncOnlyError(dataset, detail, guidance) {
+  return new Error(
+    `PLAY_DATASET_ASYNC_ONLY: ${detail} Dataset Handle ${dataset.sourceLabel ?? dataset.datasetId}. ${guidance}`
+  );
+}
 function createPlayDataset(rows, metadata) {
   const materializedRows = [...rows];
   return createDeferredPlayDataset({

package/dist/index.mjs

@@ -686,7 +686,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",
@@ -2893,6 +2896,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}$/;
@@ -2905,12 +2935,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;
@@ -2943,7 +2980,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"
       );
@@ -2979,7 +3016,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;
@@ -5768,14 +5816,6 @@ var DeferredPlayDataset = class {
     this.workProgress = input.workProgress;
     this.resolvers = input.resolvers;
   }
-  get length() {
-    if (this.knownCount === null) {
-      throw this.requiresAsyncAccess(
-        "The row count is not known until this lazy transform executes."
-      );
-    }
-    return this.knownCount;
-  }
   async count() {
     this.cachedCount = await this.resolvers.count();
     this.knownCount = this.cachedCount;
@@ -5799,6 +5839,9 @@ var DeferredPlayDataset = class {
       return void 0;
     }
     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()) {
@@ -5868,28 +5911,6 @@ var DeferredPlayDataset = class {
       yield row;
     }
   }
-  [Symbol.iterator]() {
-    if (!this.residentRows) {
-      throw this.requiresAsyncAccess(
-        "Synchronous iteration is available only when every row is resident."
-      );
-    }
-    return this.residentRows[Symbol.iterator]();
-  }
-  residentAt(index) {
-    if (this.knownCount !== null && index >= this.knownCount) return void 0;
-    if (!this.residentRows) {
-      throw this.requiresAsyncAccess(
-        `Row ${index} is not resident and may require dataset paging.`
-      );
-    }
-    return this.residentRows[index];
-  }
-  requiresAsyncAccess(detail) {
-    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",
@@ -6020,8 +6041,28 @@ function createDeferredPlayDataset(input) {
   const boundMethods = /* @__PURE__ */ new Map();
   const dataset = new Proxy(target, {
     get(dataset2, property) {
+      if (property === "length") {
+        throw datasetAsyncOnlyError(
+          dataset2,
+          "Dataset Handles do not expose synchronous .length.",
+          "Use await dataset.count()."
+        );
+      }
       if (typeof property === "string" && /^(0|[1-9]\d*)$/.test(property)) {
-        return dataset2.residentAt(Number(property));
+        throw datasetAsyncOnlyError(
+          dataset2,
+          `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(
+            dataset2,
+            "Dataset Handles do not support synchronous iteration.",
+            "Use for await...of or await dataset.materialize(limit)."
+          );
+        };
       }
       const value = Reflect.get(dataset2, property, dataset2);
       if (typeof value !== "function") return value;
@@ -6032,8 +6073,10 @@ function createDeferredPlayDataset(input) {
     },
     set(_dataset, property) {
       if (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;
@@ -6045,6 +6088,11 @@ function createDeferredPlayDataset(input) {
   }
   return dataset;
 }
+function datasetAsyncOnlyError(dataset, detail, guidance) {
+  return new Error(
+    `PLAY_DATASET_ASYNC_ONLY: ${detail} Dataset Handle ${dataset.sourceLabel ?? dataset.datasetId}. ${guidance}`
+  );
+}
 function createPlayDataset(rows, metadata) {
   const materializedRows = [...rows];
   return createDeferredPlayDataset({

package/dist/plays/bundle-play-file.d.mts

@@ -1,5 +1,5 @@
-import { T as ToolExecutionErrorSchemaVersion, P as PlayArtifactKind$1, a as PlayCompilerManifest } from '../tool-execution-error-YDz7UMl-.mjs';
-export { b as PLAY_ARTIFACT_KINDS } from '../tool-execution-error-YDz7UMl-.mjs';
+import { T as ToolExecutionErrorSchemaVersion, P as PlayArtifactKind$1, a as PlayCompilerManifest } from '../tool-execution-error-4-rhemLQ.mjs';
+export { b as PLAY_ARTIFACT_KINDS } from '../tool-execution-error-4-rhemLQ.mjs';
 
 type PlayPackageImport = {
     name: string;

package/dist/plays/bundle-play-file.d.ts

@@ -1,5 +1,5 @@
-import { T as ToolExecutionErrorSchemaVersion, P as PlayArtifactKind$1, a as PlayCompilerManifest } from '../tool-execution-error-YDz7UMl-.js';
-export { b as PLAY_ARTIFACT_KINDS } from '../tool-execution-error-YDz7UMl-.js';
+import { T as ToolExecutionErrorSchemaVersion, P as PlayArtifactKind$1, a as PlayCompilerManifest } from '../tool-execution-error-4-rhemLQ.js';
+export { b as PLAY_ARTIFACT_KINDS } from '../tool-execution-error-4-rhemLQ.js';
 
 type PlayPackageImport = {
     name: string;

package/dist/plays/bundle-play-file.mjs

@@ -25,7 +25,8 @@ import { build, transformSync } from "esbuild";
 // ../shared_libs/play-runtime/backend.ts
 var PLAY_RUNTIME_BACKENDS = {
   localProcess: "local_process",
-  daytona: "daytona"
+  daytona: "daytona",
+  modal: "modal"
 };
 var PLAY_ARTIFACT_KINDS = {
   cjsNode20: "cjs_node20"
@@ -40,6 +41,11 @@ var PLAY_BACKEND_DESCRIPTORS = {
     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"
   }
 };
 

package/dist/{tool-execution-error-YDz7UMl-.d.mts → tool-execution-error-4-rhemLQ.d.mts}

@@ -1,3 +1,9 @@
+declare const PLAY_RUNTIME_BACKENDS: {
+    readonly localProcess: "local_process";
+    readonly daytona: "daytona";
+    readonly modal: "modal";
+};
+type PlayRuntimeBackendId = (typeof PLAY_RUNTIME_BACKENDS)[keyof typeof PLAY_RUNTIME_BACKENDS];
 /**
  * The one executable Play artifact contract. Daytona and local-process both
  * load CommonJS under Node 20.
@@ -437,4 +443,4 @@ declare class ProviderTransientError extends ToolExecutionError {
     static [Symbol.hasInstance](value: unknown): boolean;
 }
 
-export { DeeplineError as D, type PlayArtifactKind as P, type ToolExecutionErrorSchemaVersion as T, type PlayCompilerManifest as a, PLAY_ARTIFACT_KINDS as b, ToolExecutionError as c, type ToolExecutionErrorOptions as d, ProviderTransientError as e, type ProviderTransientErrorCategory as f, type ToolExecutionErrorCategory as g, type ToolExecutionErrorOrigin as h, type ToolExecutionFailureV1 as i, type ToolExecutionNetworkKind as j, type ToolExecutionNetworkScope as k };
+export { DeeplineError as D, type PlayArtifactKind as P, type ToolExecutionErrorSchemaVersion as T, type PlayCompilerManifest as a, PLAY_ARTIFACT_KINDS as b, type PlayRuntimeBackendId as c, ToolExecutionError as d, type ToolExecutionErrorOptions as e, ProviderTransientError as f, type ProviderTransientErrorCategory as g, type ToolExecutionErrorCategory as h, type ToolExecutionErrorOrigin as i, type ToolExecutionFailureV1 as j, type ToolExecutionNetworkKind as k, type ToolExecutionNetworkScope as l };

package/dist/{tool-execution-error-YDz7UMl-.d.ts → tool-execution-error-4-rhemLQ.d.ts}

@@ -1,3 +1,9 @@
+declare const PLAY_RUNTIME_BACKENDS: {
+    readonly localProcess: "local_process";
+    readonly daytona: "daytona";
+    readonly modal: "modal";
+};
+type PlayRuntimeBackendId = (typeof PLAY_RUNTIME_BACKENDS)[keyof typeof PLAY_RUNTIME_BACKENDS];
 /**
  * The one executable Play artifact contract. Daytona and local-process both
  * load CommonJS under Node 20.
@@ -437,4 +443,4 @@ declare class ProviderTransientError extends ToolExecutionError {
     static [Symbol.hasInstance](value: unknown): boolean;
 }
 
-export { DeeplineError as D, type PlayArtifactKind as P, type ToolExecutionErrorSchemaVersion as T, type PlayCompilerManifest as a, PLAY_ARTIFACT_KINDS as b, ToolExecutionError as c, type ToolExecutionErrorOptions as d, ProviderTransientError as e, type ProviderTransientErrorCategory as f, type ToolExecutionErrorCategory as g, type ToolExecutionErrorOrigin as h, type ToolExecutionFailureV1 as i, type ToolExecutionNetworkKind as j, type ToolExecutionNetworkScope as k };
+export { DeeplineError as D, type PlayArtifactKind as P, type ToolExecutionErrorSchemaVersion as T, type PlayCompilerManifest as a, PLAY_ARTIFACT_KINDS as b, type PlayRuntimeBackendId as c, ToolExecutionError as d, type ToolExecutionErrorOptions as e, ProviderTransientError as f, type ProviderTransientErrorCategory as g, type ToolExecutionErrorCategory as h, type ToolExecutionErrorOrigin as i, type ToolExecutionFailureV1 as j, type ToolExecutionNetworkKind as k, type ToolExecutionNetworkScope as l };

package/package.json

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