@slicervm/sdk 0.1.8 → 0.1.10

package/dist/index.d.cts

@@ -27,6 +27,15 @@ interface VMInfo {
     status?: string;
     persistent?: boolean;
 }
+interface VMTagResponse {
+    hostname: string;
+    tags: string[];
+}
+interface VMTagUpdate {
+    add?: string[];
+    remove?: string[];
+    replace?: string[];
+}
 /**
  * Per-launch network policy override for isolated host groups.
  * Omitted lists inherit the host group's policy. Empty lists intentionally
@@ -320,11 +329,31 @@ interface VMForkNetworkPolicy {
     /** Omit to inherit; pass an empty array to clear the drop list. */
     drop?: string[];
 }
+type VMForkWait = 'agent' | 'none';
+type VMForkTagMode = 'append' | 'replace';
+type VMForkFixup = 'hostname' | 'machine-id' | 'ssh-host-keys';
 interface VMForkOptions {
-    /** Agent-readiness timeout in seconds. Forks always wait for the child agent. */
+    /**
+     * Defaults to agent. None acknowledges launch only; the daemon removes the
+     * child if requested asynchronous finalisation later fails.
+     */
+    wait?: VMForkWait;
+    /** Server-side agent/finalisation timeout in seconds when waiting. */
     waitTimeoutSec?: number;
     network?: VMForkNetworkPolicy;
+    /** Omit to inherit tags; provided tags append unless tagMode is replace. */
     tags?: string[];
+    tagMode?: VMForkTagMode;
+    /** Omit to inherit grants; pass an empty array to clear and blot secrets. */
+    secrets?: string[];
+    /** Defaults to true; false makes the fork ephemeral. */
+    persistent?: boolean;
+    /** Omit for all correctness fix-ups; pass an empty array to disable them. */
+    fixups?: VMForkFixup[];
+    /** Child vCPU count, up to the source host-group limit. */
+    vcpu?: number;
+    /** Child RAM in bytes, up to the source host-group limit. */
+    ramBytes?: number;
 }
 interface VMForkResponse {
     hostname: string;
@@ -334,6 +363,7 @@ interface VMForkResponse {
     parentStatus?: string;
     childStatus?: string;
     mode: string;
+    persistent?: boolean;
 }
 interface VMNetworkPolicy {
     allow: string[];
@@ -629,6 +659,7 @@ interface VMInit {
     ip?: string;
     createdAt?: string;
     arch?: string;
+    tags?: string[];
 }
 declare class CommittedVM {
     private readonly transport;
@@ -651,10 +682,16 @@ declare class VM {
     readonly ip?: string;
     readonly createdAt?: string;
     readonly arch?: string;
+    tags?: string[];
     readonly fs: VMFileSystem;
     readonly bg: VMBg;
     private readonly transport;
     constructor(transport: TransportClient, init: VMInit);
+    getTags(): Promise<string[]>;
+    updateTags(update: VMTagUpdate): Promise<string[]>;
+    addTags(...tags: string[]): Promise<string[]>;
+    removeTags(...tags: string[]): Promise<string[]>;
+    replaceTags(tags: string[]): Promise<string[]>;
     delete(): Promise<void>;
     health(): Promise<AgentHealth>;
     logs(): Promise<VMLogs>;
@@ -1088,4 +1125,4 @@ declare class SlicerShellSession {
     private teardown;
 }
 
-export { type AddProxyAllowRequest, type AddressMapping, type AgentHealth, type BgDeleteResponse, type BgExecInfo, type BgExecRequest, type BgExecResponse, type BgKillOptions, type BgKillResponse, type BgLogOptions, type BgWaitExitResponse, CommitsAPI, CommittedVM, type CreateProxyClientOptions, type CreateProxySecretRequest, type CreateSecretRequest, type CreateVMNetworkPolicy, type CreateVMOptions, type CreateVMRequest, type CreateVMResponse, type DeleteResponse, type ExecFrame, type ExecRequest, type ExecResult, type ExecResultBinary, type ExecStdio, ExecStdioBase64, ExecStdioText, FRAME_TYPE_DATA, FRAME_TYPE_HEARTBEAT, FRAME_TYPE_SESSION_CLOSE, FRAME_TYPE_SHUTDOWN, FRAME_TYPE_WINDOW_SIZE, type FSEntry, type FSMkdirRequest, type FSWatchEvent, type FSWatchEventType, type FSWatchRequest, Forwarder, type ForwarderListener, type ForwarderOptions, GiB, type HostGroup, HostGroupsAPI, type ListOptions, MiB, NonRootUser, ProxyAPI, type ProxyAllowRule, ProxyAllowsAPI, type ProxyClient, type ProxyClientCreated, ProxyClientsAPI, type ProxySecret, ProxySecretBasic, ProxySecretBearer, ProxySecretOAuthClientCredentials, type ProxySecretType, ProxySecretsAPI, type RemoveProxyAllowByTupleRequest, type Secret, SecretExistsError, SecretsAPI, type ShellSessionOptions, type ShutdownRequest, SlicerAPIError, SlicerClient, type SlicerClientOptions, type SlicerInfo, SlicerShellSession, type UpdateSecretRequest, VM, VMBg, type VMCommitDeleteResponse, type VMCommitInfo, type VMCommitListOptions, type VMCommitOptions, type VMCommitResponse, type VMDescription, VMFileSystem, type VMForkNetworkPolicy, type VMForkOptions, type VMForkResponse, type VMInfo, type VMInit, type VMLogs, type VMNetworkDescription, type VMNetworkPolicy, type VMSnapshot, type VMStat, VMsAPI, type WaitOptions, type XTermLike, encodeFrame, parseAddressMapping, parseFrame, resolveTransport };
+export { type AddProxyAllowRequest, type AddressMapping, type AgentHealth, type BgDeleteResponse, type BgExecInfo, type BgExecRequest, type BgExecResponse, type BgKillOptions, type BgKillResponse, type BgLogOptions, type BgWaitExitResponse, CommitsAPI, CommittedVM, type CreateProxyClientOptions, type CreateProxySecretRequest, type CreateSecretRequest, type CreateVMNetworkPolicy, type CreateVMOptions, type CreateVMRequest, type CreateVMResponse, type DeleteResponse, type ExecFrame, type ExecRequest, type ExecResult, type ExecResultBinary, type ExecStdio, ExecStdioBase64, ExecStdioText, FRAME_TYPE_DATA, FRAME_TYPE_HEARTBEAT, FRAME_TYPE_SESSION_CLOSE, FRAME_TYPE_SHUTDOWN, FRAME_TYPE_WINDOW_SIZE, type FSEntry, type FSMkdirRequest, type FSWatchEvent, type FSWatchEventType, type FSWatchRequest, Forwarder, type ForwarderListener, type ForwarderOptions, GiB, type HostGroup, HostGroupsAPI, type ListOptions, MiB, NonRootUser, ProxyAPI, type ProxyAllowRule, ProxyAllowsAPI, type ProxyClient, type ProxyClientCreated, ProxyClientsAPI, type ProxySecret, ProxySecretBasic, ProxySecretBearer, ProxySecretOAuthClientCredentials, type ProxySecretType, ProxySecretsAPI, type RemoveProxyAllowByTupleRequest, type Secret, SecretExistsError, SecretsAPI, type ShellSessionOptions, type ShutdownRequest, SlicerAPIError, SlicerClient, type SlicerClientOptions, type SlicerInfo, SlicerShellSession, type UpdateSecretRequest, VM, VMBg, type VMCommitDeleteResponse, type VMCommitInfo, type VMCommitListOptions, type VMCommitOptions, type VMCommitResponse, type VMDescription, VMFileSystem, type VMForkFixup, type VMForkNetworkPolicy, type VMForkOptions, type VMForkResponse, type VMForkTagMode, type VMForkWait, type VMInfo, type VMInit, type VMLogs, type VMNetworkDescription, type VMNetworkPolicy, type VMSnapshot, type VMStat, type VMTagResponse, type VMTagUpdate, VMsAPI, type WaitOptions, type XTermLike, encodeFrame, parseAddressMapping, parseFrame, resolveTransport };

package/dist/index.d.ts

@@ -27,6 +27,15 @@ interface VMInfo {
     status?: string;
     persistent?: boolean;
 }
+interface VMTagResponse {
+    hostname: string;
+    tags: string[];
+}
+interface VMTagUpdate {
+    add?: string[];
+    remove?: string[];
+    replace?: string[];
+}
 /**
  * Per-launch network policy override for isolated host groups.
  * Omitted lists inherit the host group's policy. Empty lists intentionally
@@ -320,11 +329,31 @@ interface VMForkNetworkPolicy {
     /** Omit to inherit; pass an empty array to clear the drop list. */
     drop?: string[];
 }
+type VMForkWait = 'agent' | 'none';
+type VMForkTagMode = 'append' | 'replace';
+type VMForkFixup = 'hostname' | 'machine-id' | 'ssh-host-keys';
 interface VMForkOptions {
-    /** Agent-readiness timeout in seconds. Forks always wait for the child agent. */
+    /**
+     * Defaults to agent. None acknowledges launch only; the daemon removes the
+     * child if requested asynchronous finalisation later fails.
+     */
+    wait?: VMForkWait;
+    /** Server-side agent/finalisation timeout in seconds when waiting. */
     waitTimeoutSec?: number;
     network?: VMForkNetworkPolicy;
+    /** Omit to inherit tags; provided tags append unless tagMode is replace. */
     tags?: string[];
+    tagMode?: VMForkTagMode;
+    /** Omit to inherit grants; pass an empty array to clear and blot secrets. */
+    secrets?: string[];
+    /** Defaults to true; false makes the fork ephemeral. */
+    persistent?: boolean;
+    /** Omit for all correctness fix-ups; pass an empty array to disable them. */
+    fixups?: VMForkFixup[];
+    /** Child vCPU count, up to the source host-group limit. */
+    vcpu?: number;
+    /** Child RAM in bytes, up to the source host-group limit. */
+    ramBytes?: number;
 }
 interface VMForkResponse {
     hostname: string;
@@ -334,6 +363,7 @@ interface VMForkResponse {
     parentStatus?: string;
     childStatus?: string;
     mode: string;
+    persistent?: boolean;
 }
 interface VMNetworkPolicy {
     allow: string[];
@@ -629,6 +659,7 @@ interface VMInit {
     ip?: string;
     createdAt?: string;
     arch?: string;
+    tags?: string[];
 }
 declare class CommittedVM {
     private readonly transport;
@@ -651,10 +682,16 @@ declare class VM {
     readonly ip?: string;
     readonly createdAt?: string;
     readonly arch?: string;
+    tags?: string[];
     readonly fs: VMFileSystem;
     readonly bg: VMBg;
     private readonly transport;
     constructor(transport: TransportClient, init: VMInit);
+    getTags(): Promise<string[]>;
+    updateTags(update: VMTagUpdate): Promise<string[]>;
+    addTags(...tags: string[]): Promise<string[]>;
+    removeTags(...tags: string[]): Promise<string[]>;
+    replaceTags(tags: string[]): Promise<string[]>;
     delete(): Promise<void>;
     health(): Promise<AgentHealth>;
     logs(): Promise<VMLogs>;
@@ -1088,4 +1125,4 @@ declare class SlicerShellSession {
     private teardown;
 }
 
-export { type AddProxyAllowRequest, type AddressMapping, type AgentHealth, type BgDeleteResponse, type BgExecInfo, type BgExecRequest, type BgExecResponse, type BgKillOptions, type BgKillResponse, type BgLogOptions, type BgWaitExitResponse, CommitsAPI, CommittedVM, type CreateProxyClientOptions, type CreateProxySecretRequest, type CreateSecretRequest, type CreateVMNetworkPolicy, type CreateVMOptions, type CreateVMRequest, type CreateVMResponse, type DeleteResponse, type ExecFrame, type ExecRequest, type ExecResult, type ExecResultBinary, type ExecStdio, ExecStdioBase64, ExecStdioText, FRAME_TYPE_DATA, FRAME_TYPE_HEARTBEAT, FRAME_TYPE_SESSION_CLOSE, FRAME_TYPE_SHUTDOWN, FRAME_TYPE_WINDOW_SIZE, type FSEntry, type FSMkdirRequest, type FSWatchEvent, type FSWatchEventType, type FSWatchRequest, Forwarder, type ForwarderListener, type ForwarderOptions, GiB, type HostGroup, HostGroupsAPI, type ListOptions, MiB, NonRootUser, ProxyAPI, type ProxyAllowRule, ProxyAllowsAPI, type ProxyClient, type ProxyClientCreated, ProxyClientsAPI, type ProxySecret, ProxySecretBasic, ProxySecretBearer, ProxySecretOAuthClientCredentials, type ProxySecretType, ProxySecretsAPI, type RemoveProxyAllowByTupleRequest, type Secret, SecretExistsError, SecretsAPI, type ShellSessionOptions, type ShutdownRequest, SlicerAPIError, SlicerClient, type SlicerClientOptions, type SlicerInfo, SlicerShellSession, type UpdateSecretRequest, VM, VMBg, type VMCommitDeleteResponse, type VMCommitInfo, type VMCommitListOptions, type VMCommitOptions, type VMCommitResponse, type VMDescription, VMFileSystem, type VMForkNetworkPolicy, type VMForkOptions, type VMForkResponse, type VMInfo, type VMInit, type VMLogs, type VMNetworkDescription, type VMNetworkPolicy, type VMSnapshot, type VMStat, VMsAPI, type WaitOptions, type XTermLike, encodeFrame, parseAddressMapping, parseFrame, resolveTransport };
+export { type AddProxyAllowRequest, type AddressMapping, type AgentHealth, type BgDeleteResponse, type BgExecInfo, type BgExecRequest, type BgExecResponse, type BgKillOptions, type BgKillResponse, type BgLogOptions, type BgWaitExitResponse, CommitsAPI, CommittedVM, type CreateProxyClientOptions, type CreateProxySecretRequest, type CreateSecretRequest, type CreateVMNetworkPolicy, type CreateVMOptions, type CreateVMRequest, type CreateVMResponse, type DeleteResponse, type ExecFrame, type ExecRequest, type ExecResult, type ExecResultBinary, type ExecStdio, ExecStdioBase64, ExecStdioText, FRAME_TYPE_DATA, FRAME_TYPE_HEARTBEAT, FRAME_TYPE_SESSION_CLOSE, FRAME_TYPE_SHUTDOWN, FRAME_TYPE_WINDOW_SIZE, type FSEntry, type FSMkdirRequest, type FSWatchEvent, type FSWatchEventType, type FSWatchRequest, Forwarder, type ForwarderListener, type ForwarderOptions, GiB, type HostGroup, HostGroupsAPI, type ListOptions, MiB, NonRootUser, ProxyAPI, type ProxyAllowRule, ProxyAllowsAPI, type ProxyClient, type ProxyClientCreated, ProxyClientsAPI, type ProxySecret, ProxySecretBasic, ProxySecretBearer, ProxySecretOAuthClientCredentials, type ProxySecretType, ProxySecretsAPI, type RemoveProxyAllowByTupleRequest, type Secret, SecretExistsError, SecretsAPI, type ShellSessionOptions, type ShutdownRequest, SlicerAPIError, SlicerClient, type SlicerClientOptions, type SlicerInfo, SlicerShellSession, type UpdateSecretRequest, VM, VMBg, type VMCommitDeleteResponse, type VMCommitInfo, type VMCommitListOptions, type VMCommitOptions, type VMCommitResponse, type VMDescription, VMFileSystem, type VMForkFixup, type VMForkNetworkPolicy, type VMForkOptions, type VMForkResponse, type VMForkTagMode, type VMForkWait, type VMInfo, type VMInit, type VMLogs, type VMNetworkDescription, type VMNetworkPolicy, type VMSnapshot, type VMStat, type VMTagResponse, type VMTagUpdate, VMsAPI, type WaitOptions, type XTermLike, encodeFrame, parseAddressMapping, parseFrame, resolveTransport };

package/dist/index.js

@@ -312,7 +312,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) {
@@ -362,6 +363,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("/");
@@ -840,6 +866,7 @@ var VM = class {
   ip;
   createdAt;
   arch;
+  tags;
   fs;
   bg;
   transport;
@@ -850,10 +877,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",
@@ -1087,20 +1141,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);
 }
@@ -1319,7 +1364,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] }
     });
   }
   /**
@@ -1339,7 +1385,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. */
@@ -1401,18 +1448,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);
   }