@lizard-build/sdk 0.1.17 → 0.1.18

package/dist/index.d.mts

@@ -137,6 +137,11 @@ interface SandboxInfo {
     metadata?: Record<string, string>;
 }
 interface SandboxOpts extends ConnectionOpts {
+    /**
+     * ID of the project this sandbox belongs to. Required: a sandbox must be
+     * attributed to a project so its CPU, RAM, egress, and storage are billed.
+     */
+    projectId: string;
     template?: string;
     metadata?: Record<string, string>;
     envs?: Record<string, string>;
@@ -175,7 +180,7 @@ declare class SandboxClient {
  * ```ts
  * import { Sandbox } from 'lizard'
  *
- * const sandbox = await Sandbox.create('base')
+ * const sandbox = await Sandbox.create('base', { projectId: 'proj_abc123' })
  * await sandbox.fs.write('/app/index.js', 'console.log("hello world")')
  * const result = await sandbox.process.exec('node /app/index.js')
  * console.log(result.stdout) // "hello world"
@@ -184,7 +189,7 @@ declare class SandboxClient {
  *
  * @example Pause and resume a long-running session:
  * ```ts
- * const sandbox = await Sandbox.create('code-interpreter-v1')
+ * const sandbox = await Sandbox.create('code-interpreter-v1', { projectId: 'proj_abc123' })
  * await sandbox.process.exec('pip install numpy')
  * const id = sandbox.sandboxId
  * await sandbox.pause()
@@ -229,7 +234,7 @@ declare class Sandbox extends SandboxClient {
      *
      * @example
      * ```ts
-     * const sandbox = await Sandbox.create()
+     * const sandbox = await Sandbox.create({ projectId: 'proj_abc123' })
      * ```
      */
     static create(opts?: SandboxOpts): Promise<Sandbox>;
@@ -244,8 +249,8 @@ declare class Sandbox extends SandboxClient {
      *
      * @example
      * ```ts
-     * const sandbox = await Sandbox.create('base')
-     * const sandbox = await Sandbox.create('code-interpreter-v1', { timeoutMs: 10 * 60 * 1000 })
+     * const sandbox = await Sandbox.create('base', { projectId: 'proj_abc123' })
+     * const sandbox = await Sandbox.create('code-interpreter-v1', { projectId: 'proj_abc123', timeoutMs: 10 * 60 * 1000 })
      * ```
      */
     static create(template: string, opts?: SandboxOpts): Promise<Sandbox>;
@@ -409,7 +414,7 @@ interface CreateContextOpts {
  * ```ts
  * import { CodeSandbox } from 'lizard/code-interpreter'
  *
- * const sandbox = await CodeSandbox.create()
+ * const sandbox = await CodeSandbox.create({ projectId: 'proj_abc123' })
  *
  * await sandbox.runCode('x = 42')
  * const result = await sandbox.runCode('print(x * 2)')

package/dist/index.d.ts

@@ -137,6 +137,11 @@ interface SandboxInfo {
     metadata?: Record<string, string>;
 }
 interface SandboxOpts extends ConnectionOpts {
+    /**
+     * ID of the project this sandbox belongs to. Required: a sandbox must be
+     * attributed to a project so its CPU, RAM, egress, and storage are billed.
+     */
+    projectId: string;
     template?: string;
     metadata?: Record<string, string>;
     envs?: Record<string, string>;
@@ -175,7 +180,7 @@ declare class SandboxClient {
  * ```ts
  * import { Sandbox } from 'lizard'
  *
- * const sandbox = await Sandbox.create('base')
+ * const sandbox = await Sandbox.create('base', { projectId: 'proj_abc123' })
  * await sandbox.fs.write('/app/index.js', 'console.log("hello world")')
  * const result = await sandbox.process.exec('node /app/index.js')
  * console.log(result.stdout) // "hello world"
@@ -184,7 +189,7 @@ declare class SandboxClient {
  *
  * @example Pause and resume a long-running session:
  * ```ts
- * const sandbox = await Sandbox.create('code-interpreter-v1')
+ * const sandbox = await Sandbox.create('code-interpreter-v1', { projectId: 'proj_abc123' })
  * await sandbox.process.exec('pip install numpy')
  * const id = sandbox.sandboxId
  * await sandbox.pause()
@@ -229,7 +234,7 @@ declare class Sandbox extends SandboxClient {
      *
      * @example
      * ```ts
-     * const sandbox = await Sandbox.create()
+     * const sandbox = await Sandbox.create({ projectId: 'proj_abc123' })
      * ```
      */
     static create(opts?: SandboxOpts): Promise<Sandbox>;
@@ -244,8 +249,8 @@ declare class Sandbox extends SandboxClient {
      *
      * @example
      * ```ts
-     * const sandbox = await Sandbox.create('base')
-     * const sandbox = await Sandbox.create('code-interpreter-v1', { timeoutMs: 10 * 60 * 1000 })
+     * const sandbox = await Sandbox.create('base', { projectId: 'proj_abc123' })
+     * const sandbox = await Sandbox.create('code-interpreter-v1', { projectId: 'proj_abc123', timeoutMs: 10 * 60 * 1000 })
      * ```
      */
     static create(template: string, opts?: SandboxOpts): Promise<Sandbox>;
@@ -409,7 +414,7 @@ interface CreateContextOpts {
  * ```ts
  * import { CodeSandbox } from 'lizard/code-interpreter'
  *
- * const sandbox = await CodeSandbox.create()
+ * const sandbox = await CodeSandbox.create({ projectId: 'proj_abc123' })
  *
  * await sandbox.runCode('x = 42')
  * const result = await sandbox.runCode('print(x * 2)')

package/dist/index.js

@@ -233,11 +233,17 @@ var Fs = class {
 // src/sandbox/client.ts
 var SandboxClient = class {
   static async createSandbox(template, timeoutMs, opts) {
+    if (!opts?.projectId) {
+      throw new LizardError(
+        "projectId is required: a sandbox must belong to a project so its usage is billed. Pass { projectId } to Sandbox.create()."
+      );
+    }
     const config = new ConnectionConfig(opts);
     const res = await fetch(`${config.apiUrl}/api/sandboxes`, {
       method: "POST",
       headers: config.headers,
       body: JSON.stringify({
+        projectId: opts.projectId,
         template,
         timeoutMs,
         metadata: opts?.metadata,

package/dist/index.mjs

@@ -201,11 +201,17 @@ var Fs = class {
 // src/sandbox/client.ts
 var SandboxClient = class {
   static async createSandbox(template, timeoutMs, opts) {
+    if (!opts?.projectId) {
+      throw new LizardError(
+        "projectId is required: a sandbox must belong to a project so its usage is billed. Pass { projectId } to Sandbox.create()."
+      );
+    }
     const config = new ConnectionConfig(opts);
     const res = await fetch(`${config.apiUrl}/api/sandboxes`, {
       method: "POST",
       headers: config.headers,
       body: JSON.stringify({
+        projectId: opts.projectId,
         template,
         timeoutMs,
         metadata: opts?.metadata,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lizard-build/sdk",
-  "version": "0.1.17",
+  "version": "0.1.18",
   "description": "Lizard SDK — cloud sandboxes for AI agents",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",