@slicervm/sdk 0.1.8 → 0.1.10

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("/");
@@ -851,6 +877,7 @@ var VM = class {
   ip;
   createdAt;
   arch;
+  tags;
   fs;
   bg;
   transport;
@@ -861,10 +888,37 @@ var VM = class {
     if (init.ip !== void 0) this.ip = init.ip;
     if (init.createdAt !== void 0) this.createdAt = init.createdAt;
     if (init.arch !== void 0) this.arch = init.arch;
+    if (init.tags !== void 0) this.tags = init.tags;
     this.fs = new VMFileSystem(transport, this.hostname);
     this.bg = new VMBg(transport, this.hostname);
   }
   // --- lifecycle --------------------------------------------------------
+  async getTags() {
+    const response = await this.transport.request(
+      "GET",
+      `/vm/${encodeURIComponent(this.hostname)}/tags`
+    );
+    this.tags = response.tags;
+    return response.tags;
+  }
+  async updateTags(update) {
+    const response = await this.transport.request(
+      "PATCH",
+      `/vm/${encodeURIComponent(this.hostname)}/tags`,
+      update
+    );
+    this.tags = response.tags;
+    return response.tags;
+  }
+  async addTags(...tags) {
+    return this.updateTags({ add: tags });
+  }
+  async removeTags(...tags) {
+    return this.updateTags({ remove: tags });
+  }
+  async replaceTags(tags) {
+    return this.updateTags({ replace: tags });
+  }
   async delete() {
     await this.transport.request(
       "DELETE",
@@ -1098,20 +1152,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);
 }
@@ -1330,7 +1375,8 @@ var VMsAPI = class {
       hostGroup: res.hostGroup ?? hostGroup,
       ...res.ip !== void 0 && { ip: res.ip },
       ...res.createdAt !== void 0 && { createdAt: res.createdAt },
-      ...res.arch !== void 0 && { arch: res.arch }
+      ...res.arch !== void 0 && { arch: res.arch },
+      ...req.tags !== void 0 && { tags: [...req.tags] }
     });
   }
   /**
@@ -1350,7 +1396,8 @@ var VMsAPI = class {
       hostGroup: found.hostGroup ?? "",
       ...found.ip !== void 0 && { ip: found.ip },
       ...found.createdAt !== void 0 && { createdAt: found.createdAt },
-      ...found.arch !== void 0 && { arch: found.arch }
+      ...found.arch !== void 0 && { arch: found.arch },
+      ...found.tags !== void 0 && { tags: found.tags }
     });
   }
   /** Return raw VM metadata across all host groups. */
@@ -1412,18 +1459,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);
   }