@sylphx/sdk 0.10.4 → 0.10.5

package/dist/index.d.ts

@@ -7580,8 +7580,8 @@ interface SandboxOptions {
     env?: Record<string, string>;
     /**
      * Shared volume mounts from org-level managed volumes.
-     * Requires ReadWriteMany volumes (CephFS). Multiple sandboxes can mount
-     * the same volume for shared filesystem access.
+     * Use volumes created with sharing="shared" when multiple sandboxes need
+     * concurrent filesystem access.
      */
     volumeMounts?: Array<{
         /** Volume resource ID (from `sylphx volumes list`) */
@@ -7786,7 +7786,7 @@ declare class SandboxClient {
     /**
      * Create a new sandbox.
      *
-     * Platform provisions the K8s pod, waits for readiness, and returns
+     * Platform provisions the sandbox runtime, waits for readiness, and returns
      * { endpoint, token } once the sandbox is fully ready to accept traffic.
      * No client-side polling required.
      */
@@ -7872,7 +7872,7 @@ declare class SandboxClient {
  *
  * Fire-and-forget batch compute API (Modal-style run-to-completion jobs).
  *
- * Runs are ephemeral K8s Jobs that run to completion. Use them for:
+ * Runs are ephemeral isolated jobs that run to completion. Use them for:
  * - ML training folds (walk-forward cross-validation)
  * - Data processing pipelines
  * - Batch inference
@@ -7919,11 +7919,11 @@ declare class SandboxClient {
  *
  * ## Architecture
  *
- * - Workers are K8s Jobs (backoffLimit: 0, no restarts)
+ * - Workers are isolated one-shot runs (backoffLimit: 0, no restarts)
  * - Images must be from registry.sylphx.com (scanned, private)
- * - Volumes: org-level volumeResources mounted as PVCs
- *   - ReadWriteOnce → rook-ceph-block (single pod)
- *   - ReadWriteMany → rook-cephfs (concurrent pods — use for shared feature caches)
+ * - Volumes: org-level volume resources mounted into the run
+ *   - single-writer for one active writer at a time
+ *   - shared for concurrent runs and shared feature caches
  * - Auth: sk_* secret key (server-side only)
  * - Quota: 20 concurrent workers per org
  *
@@ -7981,12 +7981,12 @@ interface CreateRunOptions {
     resources?: RunResourceSpec;
     /**
      * Hard timeout in seconds (default: 3600 = 1 hour, max: 86400 = 24 hours).
-     * K8s terminates the Job when the deadline is reached (status: 'timeout').
+     * The platform terminates the run when the deadline is reached (status: 'timeout').
      */
     timeoutSeconds?: number;
     /**
      * Volume mounts from org-level volumeResources.
-     * ReadWriteMany volumes (rook-cephfs) allow concurrent access by multiple parallel workers.
+     * Shared volumes allow concurrent access by multiple parallel workers.
      */
     volumeMounts?: RunVolumeMount[];
 }
@@ -8094,7 +8094,7 @@ declare class RunHandle {
     /**
      * Fetch captured logs for this worker.
      *
-     * - For a running worker: returns live logs streamed from K8s (may be incomplete)
+     * - For a running worker: returns live logs streamed from the runtime (may be incomplete)
      * - For a completed worker: returns the full captured output stored in DB
      *
      * @example
@@ -8108,8 +8108,8 @@ declare class RunHandle {
     /**
      * Cancel this worker.
      *
-     * - If still pending: immediately cancelled (no K8s Job created)
-     * - If running: K8s Job deleted (pod terminated)
+     * - If still pending: immediately cancelled
+     * - If running: runtime is terminated
      * - If already completed: no-op
      */
     cancel(): Promise<void>;
@@ -8131,9 +8131,9 @@ declare class RunHandle {
  */
 declare const RunsClient: {
     /**
-     * Spawn a new worker (K8s Job) and return a handle.
+     * Spawn a new worker and return a handle.
      *
-     * The Job is created immediately and starts pulling the image.
+     * The run is created immediately and starts pulling the image.
      * Use the returned handle to `.wait()` for completion or `.cancel()`.
      *
      * @example
@@ -8193,9 +8193,9 @@ declare const RunsClient: {
 /** @deprecated Use RunsClient */
 declare const WorkersClient: {
     /**
-     * Spawn a new worker (K8s Job) and return a handle.
+     * Spawn a new worker and return a handle.
      *
-     * The Job is created immediately and starts pulling the image.
+     * The run is created immediately and starts pulling the image.
      * Use the returned handle to `.wait()` for completion or `.cancel()`.
      *
      * @example

package/dist/index.mjs

@@ -10259,7 +10259,7 @@ var SandboxClient = class _SandboxClient {
   /**
    * Create a new sandbox.
    *
-   * Platform provisions the K8s pod, waits for readiness, and returns
+   * Platform provisions the sandbox runtime, waits for readiness, and returns
    * { endpoint, token } once the sandbox is fully ready to accept traffic.
    * No client-side polling required.
    */
@@ -10548,7 +10548,7 @@ var RunHandle = class {
   /**
    * Fetch captured logs for this worker.
    *
-   * - For a running worker: returns live logs streamed from K8s (may be incomplete)
+   * - For a running worker: returns live logs streamed from the runtime (may be incomplete)
    * - For a completed worker: returns the full captured output stored in DB
    *
    * @example
@@ -10567,8 +10567,8 @@ var RunHandle = class {
   /**
    * Cancel this worker.
    *
-   * - If still pending: immediately cancelled (no K8s Job created)
-   * - If running: K8s Job deleted (pod terminated)
+   * - If still pending: immediately cancelled
+   * - If running: runtime is terminated
    * - If already completed: no-op
    */
   async cancel() {
@@ -10580,9 +10580,9 @@ var RunsClient = {
   // Run
   // --------------------------------------------------------------------------
   /**
-   * Spawn a new worker (K8s Job) and return a handle.
+   * Spawn a new worker and return a handle.
    *
-   * The Job is created immediately and starts pulling the image.
+   * The run is created immediately and starts pulling the image.
    * Use the returned handle to `.wait()` for completion or `.cancel()`.
    *
    * @example