@miosa/sdk 3.2.0 → 3.2.1

package/dist/index.d.ts

@@ -7449,6 +7449,13 @@ declare class Sandbox {
     waitUntilReady(options?: {
         timeout?: number;
         stream?: boolean;
+        /**
+         * Require the sandbox to be *command-ready* (exec will succeed) before
+         * resolving `true`, not merely aggregate-`ready`. Defaults to `true` so a
+         * resolved wait guarantees exec won't 409 SANDBOX_NOT_COMMAND_READY. Set
+         * `false` for the legacy aggregate-ready semantics.
+         */
+        requireCommandReady?: boolean;
     }): Promise<boolean>;
     private bootFailedError;
     /** Best-effort final check so an SSE `event: timeout` does not mask a boot failure that just landed. */

package/dist/index.js

@@ -168,7 +168,7 @@ var TokenRefreshFailedError = class extends MiosaError {
 };
 
 // src/version.ts
-var SDK_VERSION = "3.2.0";
+var SDK_VERSION = "3.2.1";
 var SDK_USER_AGENT = `@miosa/sdk/${SDK_VERSION}`;
 
 // src/http.ts
@@ -8451,6 +8451,36 @@ function encodeContent(content) {
   for (let i = 0; i < bytes.length; i++) bin += String.fromCharCode(bytes[i]);
   return btoa(bin);
 }
+function generateIdempotencyKey() {
+  const c = globalThis.crypto;
+  if (c && typeof c.randomUUID === "function") return c.randomUUID();
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (ch) => {
+    const r = Math.random() * 16 | 0;
+    const v = ch === "x" ? r : r & 3 | 8;
+    return v.toString(16);
+  });
+}
+var PLATFORM_READINESS_COMPONENTS = [
+  "command_agent",
+  "process_control",
+  "resource_contract",
+  "clock",
+  "identity",
+  "durability",
+  "filesystem",
+  "internal_probe"
+];
+function isCommandReady(payload) {
+  if (payload["ready"] === true) return true;
+  const readiness = payload["readiness"];
+  const components = readiness?.["components"] ?? payload["components"] ?? payload["readiness_components"];
+  if (!components || typeof components !== "object") return false;
+  return PLATFORM_READINESS_COMPONENTS.every((name) => {
+    const comp = components[name];
+    const status = typeof comp === "string" ? comp : comp?.status;
+    return status === "ready";
+  });
+}
 var SANDBOX_TEMPLATE = "miosa-sandbox";
 var SANDBOX_TIER_BY_CPU = {
   1: { size: "xs", memoryMb: 2048 },
@@ -9452,6 +9482,7 @@ var Sandbox = class _Sandbox {
   async waitUntilReady(options = {}) {
     const timeout = options.timeout ?? 30;
     const stream = options.stream ?? true;
+    const requireCommandReady = options.requireCommandReady ?? true;
     if (stream) {
       const sseResult = await this.tryReadinessStream(timeout);
       if (sseResult === true) {
@@ -9467,7 +9498,8 @@ var Sandbox = class _Sandbox {
     while (Date.now() < deadlineMs) {
       try {
         const data = await this.readiness();
-        if (data.ready === true || data.status === "ready") {
+        const ready = requireCommandReady ? isCommandReady(data) : data.ready === true || data.status === "ready";
+        if (ready) {
           await this.adoptReadyState();
           return true;
         }
@@ -9643,14 +9675,12 @@ var Sandboxes = class {
     });
   }
   async create(params = {}) {
-    const idempotencyKey11 = params.idempotencyKey ?? params.idempotency_key;
+    const idempotencyKey11 = params.idempotencyKey ?? params.idempotency_key ?? generateIdempotencyKey();
     const requestOptions = {
       method: "POST",
-      body: createBody(params)
+      body: createBody(params),
+      headers: { "Idempotency-Key": idempotencyKey11 }
     };
-    if (idempotencyKey11) {
-      requestOptions.headers = { "Idempotency-Key": idempotencyKey11 };
-    }
     const data = unwrap48(
       await this.http.request(
         "/sandboxes",