@lizard-build/sdk 0.1.30 → 0.1.31

package/dist/index.d.mts

@@ -70,8 +70,12 @@ interface FsOpts {
 interface FileInfo {
     name: string;
     path: string;
-    type: 'file' | 'dir';
+    type: 'file' | 'dir' | 'symlink';
     size: number;
+    /** Permission bits as a string, e.g. `-rw-r--r--`. Absent on older sandboxes. */
+    mode?: string;
+    /** Last modification time, unix milliseconds. Absent on older sandboxes. */
+    modTime?: number;
 }
 /**
  * Read and write files inside a Lizard sandbox microVM.
@@ -126,6 +130,35 @@ declare class Fs {
      * Create a directory (and any missing parents) inside the microVM.
      */
     makeDir(path: string, opts?: FsOpts): Promise<void>;
+    /**
+     * Metadata for a single path — size, type, permissions, modification time.
+     *
+     * Saves listing a parent directory and filtering it just to answer "does this
+     * exist, and how big is it".
+     *
+     * @example
+     * ```ts
+     * const info = await sandbox.fs.stat('/app/out.bin')
+     * console.log(info.size, info.type)
+     * ```
+     *
+     * Throws `NotFoundError` if the path does not exist. Sandboxes created before
+     * this shipped run a guest agent without it and throw `LizardError` (501) —
+     * recreate the sandbox to use it.
+     */
+    stat(path: string, opts?: FsOpts): Promise<FileInfo>;
+    /**
+     * Move or rename a path. Creates the destination's parent directories.
+     *
+     * @example
+     * ```ts
+     * await sandbox.fs.move('/tmp/build.log', '/app/logs/build.log')
+     * ```
+     *
+     * Sandboxes created before this shipped run a guest agent without it and throw
+     * `LizardError` (501) — recreate the sandbox to use it.
+     */
+    move(from: string, to: string): Promise<void>;
     private execInternal;
 }
 

package/dist/index.d.ts

@@ -70,8 +70,12 @@ interface FsOpts {
 interface FileInfo {
     name: string;
     path: string;
-    type: 'file' | 'dir';
+    type: 'file' | 'dir' | 'symlink';
     size: number;
+    /** Permission bits as a string, e.g. `-rw-r--r--`. Absent on older sandboxes. */
+    mode?: string;
+    /** Last modification time, unix milliseconds. Absent on older sandboxes. */
+    modTime?: number;
 }
 /**
  * Read and write files inside a Lizard sandbox microVM.
@@ -126,6 +130,35 @@ declare class Fs {
      * Create a directory (and any missing parents) inside the microVM.
      */
     makeDir(path: string, opts?: FsOpts): Promise<void>;
+    /**
+     * Metadata for a single path — size, type, permissions, modification time.
+     *
+     * Saves listing a parent directory and filtering it just to answer "does this
+     * exist, and how big is it".
+     *
+     * @example
+     * ```ts
+     * const info = await sandbox.fs.stat('/app/out.bin')
+     * console.log(info.size, info.type)
+     * ```
+     *
+     * Throws `NotFoundError` if the path does not exist. Sandboxes created before
+     * this shipped run a guest agent without it and throw `LizardError` (501) —
+     * recreate the sandbox to use it.
+     */
+    stat(path: string, opts?: FsOpts): Promise<FileInfo>;
+    /**
+     * Move or rename a path. Creates the destination's parent directories.
+     *
+     * @example
+     * ```ts
+     * await sandbox.fs.move('/tmp/build.log', '/app/logs/build.log')
+     * ```
+     *
+     * Sandboxes created before this shipped run a guest agent without it and throw
+     * `LizardError` (501) — recreate the sandbox to use it.
+     */
+    move(from: string, to: string): Promise<void>;
     private execInternal;
 }
 

package/dist/index.js

@@ -261,6 +261,49 @@ var Fs = class {
   async makeDir(path, opts) {
     await this.execInternal(`mkdir -p ${JSON.stringify(path)}`, opts?.user);
   }
+  /**
+   * Metadata for a single path — size, type, permissions, modification time.
+   *
+   * Saves listing a parent directory and filtering it just to answer "does this
+   * exist, and how big is it".
+   *
+   * @example
+   * ```ts
+   * const info = await sandbox.fs.stat('/app/out.bin')
+   * console.log(info.size, info.type)
+   * ```
+   *
+   * Throws `NotFoundError` if the path does not exist. Sandboxes created before
+   * this shipped run a guest agent without it and throw `LizardError` (501) —
+   * recreate the sandbox to use it.
+   */
+  async stat(path, opts) {
+    const url = new URL(`${this.config.apiUrl}/api/sandboxes/${this.sandboxId}/files/stat`);
+    url.searchParams.set("path", path);
+    if (opts?.user) url.searchParams.set("user", opts.user);
+    const res = await fetch(url.toString(), { headers: this.config.headers });
+    if (!res.ok) await handleApiError(res);
+    return res.json();
+  }
+  /**
+   * Move or rename a path. Creates the destination's parent directories.
+   *
+   * @example
+   * ```ts
+   * await sandbox.fs.move('/tmp/build.log', '/app/logs/build.log')
+   * ```
+   *
+   * Sandboxes created before this shipped run a guest agent without it and throw
+   * `LizardError` (501) — recreate the sandbox to use it.
+   */
+  async move(from, to) {
+    const res = await fetch(`${this.config.apiUrl}/api/sandboxes/${this.sandboxId}/files/move`, {
+      method: "POST",
+      headers: this.config.headers,
+      body: JSON.stringify({ from, to })
+    });
+    if (!res.ok) await handleApiError(res);
+  }
   async execInternal(cmd, user) {
     const res = await fetch(`${this.config.apiUrl}/api/sandboxes/${this.sandboxId}/exec`, {
       method: "POST",

package/dist/index.mjs

@@ -225,6 +225,49 @@ var Fs = class {
   async makeDir(path, opts) {
     await this.execInternal(`mkdir -p ${JSON.stringify(path)}`, opts?.user);
   }
+  /**
+   * Metadata for a single path — size, type, permissions, modification time.
+   *
+   * Saves listing a parent directory and filtering it just to answer "does this
+   * exist, and how big is it".
+   *
+   * @example
+   * ```ts
+   * const info = await sandbox.fs.stat('/app/out.bin')
+   * console.log(info.size, info.type)
+   * ```
+   *
+   * Throws `NotFoundError` if the path does not exist. Sandboxes created before
+   * this shipped run a guest agent without it and throw `LizardError` (501) —
+   * recreate the sandbox to use it.
+   */
+  async stat(path, opts) {
+    const url = new URL(`${this.config.apiUrl}/api/sandboxes/${this.sandboxId}/files/stat`);
+    url.searchParams.set("path", path);
+    if (opts?.user) url.searchParams.set("user", opts.user);
+    const res = await fetch(url.toString(), { headers: this.config.headers });
+    if (!res.ok) await handleApiError(res);
+    return res.json();
+  }
+  /**
+   * Move or rename a path. Creates the destination's parent directories.
+   *
+   * @example
+   * ```ts
+   * await sandbox.fs.move('/tmp/build.log', '/app/logs/build.log')
+   * ```
+   *
+   * Sandboxes created before this shipped run a guest agent without it and throw
+   * `LizardError` (501) — recreate the sandbox to use it.
+   */
+  async move(from, to) {
+    const res = await fetch(`${this.config.apiUrl}/api/sandboxes/${this.sandboxId}/files/move`, {
+      method: "POST",
+      headers: this.config.headers,
+      body: JSON.stringify({ from, to })
+    });
+    if (!res.ok) await handleApiError(res);
+  }
   async execInternal(cmd, user) {
     const res = await fetch(`${this.config.apiUrl}/api/sandboxes/${this.sandboxId}/exec`, {
       method: "POST",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lizard-build/sdk",
-  "version": "0.1.30",
+  "version": "0.1.31",
   "description": "Firecracker microVM sandboxes for AI agents — boot Linux in milliseconds, run code, write files, expose ports over HTTPS, then pause a session with memory intact and resume it later. TypeScript SDK for Lizard Sandboxes (lizard.build).",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",