@slicervm/sdk 0.1.8 → 0.1.9

package/README.md

@@ -36,8 +36,10 @@ await vm.delete();
 ## Cold forks
 
 A stopped persistent VM can be committed as an immutable disk parent, then
-forked into cold-booted children. Fork calls always wait until the child agent
-has finalised its guest identity.
+forked into cold-booted children. Fork calls wait for agent readiness and guest
+identity finalisation by default. `wait: 'none'` acknowledges launch only; if
+requested asynchronous finalisation fails, the daemon removes the child rather
+than expose cloned identity or secrets with partially applied policy.
 
 ```ts
 await vm.shutdown();
@@ -47,9 +49,15 @@ const parent = await vm.commit({
 });
 
 const child = await parent.fork({
+  wait: 'agent',
   waitTimeoutSec: 120,
+  persistent: false,
+  vcpu: 1,
+  ramBytes: 512 * 1024 * 1024,
   network: { allow: [], drop: ['0.0.0.0/0'] },
+  tagMode: 'replace',
   tags: ['job=node-build'],
+  secrets: [],
 });
 
 const description = await child.describe();

package/dist/index.cjs

@@ -323,7 +323,8 @@ function vmForkFromWire(w) {
     status: w.status,
     ...w.parent_status !== void 0 && { parentStatus: w.parent_status },
     ...w.child_status !== void 0 && { childStatus: w.child_status },
-    mode: w.mode ?? ""
+    mode: w.mode ?? "",
+    ...w.persistent !== void 0 && { persistent: w.persistent }
   };
 }
 function vmDescriptionFromWire(w) {
@@ -373,6 +374,31 @@ function secretFromWire(w) {
     ...w.modified_at !== void 0 && { modifiedAt: w.modified_at }
   };
 }
+
+// src/fork.ts
+function buildForkRequest(opts) {
+  const wait = opts.wait ?? "agent";
+  if (wait !== "agent" && wait !== "none") {
+    throw new Error(`invalid fork wait mode ${JSON.stringify(wait)}`);
+  }
+  const query = new URLSearchParams({ wait });
+  if (opts.waitTimeoutSec !== void 0 && opts.waitTimeoutSec > 0) {
+    query.set("timeout", `${opts.waitTimeoutSec}s`);
+  }
+  const body = {};
+  if (opts.network !== void 0) body.network = opts.network;
+  if (opts.tags !== void 0) body.tags = opts.tags;
+  if (opts.tagMode !== void 0) body.tag_mode = opts.tagMode;
+  if (opts.secrets !== void 0) body.secrets = opts.secrets;
+  if (opts.persistent !== void 0) body.persistent = opts.persistent;
+  if (opts.fixups !== void 0) body.fixups = opts.fixups;
+  if (opts.vcpu !== void 0) body.vcpu = opts.vcpu;
+  if (opts.ramBytes !== void 0) body.ram_bytes = opts.ramBytes;
+  return {
+    query: query.toString(),
+    ...Object.keys(body).length > 0 && { body }
+  };
+}
 function looksLikeUnixSocketPath(s) {
   if (!s) return false;
   return s.startsWith("/") || s.startsWith("./") || s.startsWith("../") || s.includes("/");
@@ -1098,20 +1124,11 @@ function errMsg(e) {
 }
 async function forkPath(transport, commitId, opts) {
   const id = validateCommitId(commitId);
-  const q = new URLSearchParams();
-  q.set("wait", "agent");
-  if (opts.waitTimeoutSec !== void 0 && opts.waitTimeoutSec > 0) {
-    q.set("timeout", `${opts.waitTimeoutSec}s`);
-  }
-  const query = q.toString() ? `?${q.toString()}` : "";
-  const body = opts.network !== void 0 || (opts.tags?.length ?? 0) > 0 ? {
-    ...opts.network !== void 0 && { network: opts.network },
-    ...(opts.tags?.length ?? 0) > 0 && { tags: opts.tags }
-  } : void 0;
+  const request = buildForkRequest(opts);
   const wire = await transport.request(
     "POST",
-    `/vm/commits/${encodeURIComponent(id)}/fork${query}`,
-    body
+    `/vm/commits/${encodeURIComponent(id)}/fork?${request.query}`,
+    request.body
   );
   return vmForkFromWire(wire);
 }
@@ -1412,18 +1429,11 @@ var CommitsAPI = class {
   }
   async fork(commitId, opts = {}) {
     const id = validateCommitId2(commitId);
-    const qs = new URLSearchParams({ wait: "agent" });
-    if (opts.waitTimeoutSec !== void 0 && opts.waitTimeoutSec > 0) {
-      qs.set("timeout", `${opts.waitTimeoutSec}s`);
-    }
-    const body = opts.network !== void 0 || (opts.tags?.length ?? 0) > 0 ? {
-      ...opts.network !== void 0 && { network: opts.network },
-      ...(opts.tags?.length ?? 0) > 0 && { tags: opts.tags }
-    } : void 0;
+    const request = buildForkRequest(opts);
     const wire = await this.transport.request(
       "POST",
-      `/vm/commits/${encodeURIComponent(id)}/fork?${qs.toString()}`,
-      body
+      `/vm/commits/${encodeURIComponent(id)}/fork?${request.query}`,
+      request.body
     );
     return vmForkFromWire(wire);
   }