@sylphx/sdk 0.10.4 → 0.10.6

package/dist/index.d.ts

@@ -2007,10 +2007,14 @@ declare function verifyEmail(config: SylphxConfig, token: string): Promise<void>
  *
  * @example
  * ```typescript
- * await forgotPassword(config, 'user@example.com')
+ * await forgotPassword(config, 'user@example.com', {
+ *   redirectUrl: 'https://app.example.com/reset-password'
+ * })
  * ```
  */
-declare function forgotPassword(config: SylphxConfig, email: string): Promise<void>;
+declare function forgotPassword(config: SylphxConfig, email: string, options?: {
+    redirectUrl?: string;
+}): Promise<void>;
 /**
  * Request a verification email resend.
  *
@@ -7580,8 +7584,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 +7790,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 +7876,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 +7923,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 +7985,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 +8098,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 +8112,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 +8135,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 +8197,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
@@ -8504,15 +8508,13 @@ interface ProjectMetadata {
     readonly slug: string;
     readonly [key: string]: unknown;
 }
-type ChallengeMethod = 'password' | 'email' | 'totp' | 'backup_code';
+type ChallengeMethod = 'password' | 'email' | 'totp' | 'backup';
 type ChallengeType = 'identity' | 'mfa';
 interface ChallengeVerifyInput {
     /** Verification method to use. */
     readonly method: ChallengeMethod;
-    /** Credential matching `method` (password, OTP, TOTP code, backup code). */
-    readonly credential: string;
-    /** Whether this challenge is for identity step-up or MFA gate (default: identity). */
-    readonly type?: ChallengeType;
+    /** Verification value matching `method` (password, email code, TOTP code, backup code). */
+    readonly value: string;
 }
 interface ChallengeVerifyResult {
     readonly verified: boolean;
@@ -8532,7 +8534,7 @@ declare function getProjectMetadata(config: SylphxConfig): Promise<ProjectMetada
  *
  * @example
  * ```typescript
- * await verifyChallenge(config, { method: 'password', credential: pw })
+ * await verifyChallenge(config, { method: 'password', value: pw })
  * ```
  */
 declare function verifyChallenge(config: SylphxConfig, input: ChallengeVerifyInput): Promise<ChallengeVerifyResult>;

package/dist/index.mjs

@@ -5915,10 +5915,13 @@ async function verifyEmail(config, token) {
     body: { token }
   });
 }
-async function forgotPassword(config, email) {
+async function forgotPassword(config, email, options = {}) {
   await callApi(config, "/auth/forgot-password", {
     method: "POST",
-    body: { email }
+    body: {
+      email,
+      ...options.redirectUrl ? { redirectUrl: options.redirectUrl } : {}
+    }
   });
 }
 async function resendVerificationEmail(config, email) {
@@ -5932,7 +5935,7 @@ async function resendVerificationEmail(config, email) {
 async function resetPassword(config, input) {
   await callApi(config, "/auth/reset-password", {
     method: "POST",
-    body: { token: input.token, newPassword: input.password }
+    body: { token: input.token, password: input.password }
   });
 }
 async function getSession(config) {
@@ -10259,7 +10262,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 +10551,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 +10570,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 +10583,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