@douglas-agent/sandbank-cli 0.5.4

package/README.md

@@ -0,0 +1,229 @@
+# Sandbank
+
+> Unified sandbox SDK for AI agents — write once, run on any cloud.
+
+**[Website](https://sandbank.dev)** | **[中文文档](./README.zh-CN.md)** | **[日本語ドキュメント](./README.ja.md)**
+
+Sandbank provides a single TypeScript interface for creating, managing, and orchestrating cloud sandboxes. Switch between providers without changing your application code.
+
+## Why Sandbank?
+
+AI agents need isolated execution environments. But every cloud provider has a different API — Daytona, Fly.io, Cloudflare Workers all speak different languages. Sandbank unifies them behind one interface:
+
+```typescript
+import { createProvider } from '@douglas-agent/sandbank-core'
+import { DaytonaAdapter } from '@douglas-agent/sandbank-daytona'
+
+const provider = createProvider(new DaytonaAdapter({ apiKey: '...' }))
+const sandbox = await provider.create({ image: 'node:22' })
+
+const result = await sandbox.exec('echo "Hello from the sandbox"')
+console.log(result.stdout) // Hello from the sandbox
+
+await provider.destroy(sandbox.id)
+```
+
+Swap `DaytonaAdapter` for `FlyioAdapter` or `CloudflareAdapter` — zero code changes.
+
+## Architecture
+
+```
+┌──────────────────────────────────────────────────────┐
+│  Your Application / AI Agent                         │
+├──────────────────────────────────────────────────────┤
+│  @douglas-agent/sandbank-core         Unified Provider Interface   │
+│  @douglas-agent/sandbank-skills       Skill Registry & Injection   │
+│  @douglas-agent/sandbank-agent        In-sandbox Agent Client      │
+│  @douglas-agent/sandbank-relay        Multi-agent Communication    │
+├──────────────────────────────────────────────────────┤
+│  @douglas-agent/sandbank-daytona  @douglas-agent/sandbank-flyio  @douglas-agent/sandbank-cloudflare  │
+│  @douglas-agent/sandbank-boxlite                                   │
+│  Provider Adapters                                   │
+├──────────────────────────────────────────────────────┤
+│  Daytona    Fly.io Machines    Cloudflare Workers     │
+│  BoxLite (self-hosted Docker)                        │
+└──────────────────────────────────────────────────────┘
+```
+
+## Packages
+
+| Package | Description |
+|---------|-------------|
+| [`@douglas-agent/sandbank-core`](./packages/core) | Provider abstraction, capability system, error types |
+| [`@douglas-agent/sandbank-skills`](./packages/skills) | Skill registry and local filesystem loader |
+| [`@douglas-agent/sandbank-daytona`](./packages/daytona) | Daytona cloud sandbox adapter |
+| [`@douglas-agent/sandbank-flyio`](./packages/flyio) | Fly.io Machines adapter |
+| [`@douglas-agent/sandbank-cloudflare`](./packages/cloudflare) | Cloudflare Workers adapter |
+| [`@douglas-agent/sandbank-boxlite`](./packages/boxlite) | BoxLite self-hosted Docker adapter |
+| [`@douglas-agent/sandbank-relay`](./packages/relay) | WebSocket relay for multi-agent communication |
+| [`@douglas-agent/sandbank-agent`](./packages/agent) | Lightweight client for agents running inside sandboxes |
+
+## Provider Support
+
+### Core Operations
+
+All providers implement these — the minimum contract:
+
+| Operation | Daytona | Fly.io | Cloudflare | BoxLite |
+|-----------|:-------:|:------:|:----------:|:-------:|
+| Create / Destroy | ✅ | ✅ | ✅ | ✅ |
+| List sandboxes | ✅ | ✅ | ✅ | ✅ |
+| Execute commands | ✅ | ✅ | ✅ | ✅ |
+| Read / Write files | ✅ | ✅ | ✅ | ✅ |
+| Skill injection | ✅ | ✅ | ✅ | ✅ |
+
+### Extended Capabilities
+
+Capabilities are opt-in. Use `withVolumes(provider)`, `withPortExpose(sandbox)`, etc. to safely check and access them at runtime.
+
+| Capability | Daytona | Fly.io | Cloudflare | BoxLite | Description |
+|------------|:-------:|:------:|:----------:|:-------:|-------------|
+| `volumes` | ✅ | ✅ | ⚠️* | ❌ | Persistent volume management |
+| `port.expose` | ✅ | ✅ | ⚠️** | ✅ | Expose sandbox ports to the internet |
+| `exec.stream` | ❌ | ❌ | ✅ | ✅ | Stream stdout/stderr in real-time |
+| `snapshot` | ❌ | ❌ | ✅ | ✅ | Snapshot and restore sandbox state |
+| `terminal` | ✅ | ✅ | ✅ | ✅ | Interactive web terminal (ttyd) |
+| `sleep` | ❌ | ❌ | ❌ | ✅ | Hibernate and wake sandboxes |
+| `skills` | ✅ | ✅ | ✅ | ✅ | Load and inject skill definitions into sandboxes |
+
+\* Cloudflare `volumes` requires `storage` option in adapter config.
+
+\*\* Cloudflare reserves port 3000 for its sandbox control plane. Use any port in 1024–65535 except 3000.
+
+### Provider Characteristics
+
+| | Daytona | Fly.io | Cloudflare | BoxLite |
+|---|---------|--------|------------|---------|
+| **Runtime** | Full VM | Firecracker microVM | V8 isolate + container | Docker container |
+| **Cold start** | ~10s | ~3-5s | ~1s | ~2-5s |
+| **File I/O** | Native SDK | Via exec (base64) | Native SDK | Via exec (base64) |
+| **Regions** | Multi | Multi | Global edge | Self-hosted |
+| **External deps** | `@daytonaio/sdk` | None (pure fetch) | `@cloudflare/sandbox` | BoxLite API |
+
+## Multi-Agent Sessions
+
+Sandbank includes a built-in orchestration layer for multi-agent workflows. The **Relay** handles real-time messaging and shared context between sandboxes.
+
+```typescript
+import { createSession } from '@douglas-agent/sandbank-core'
+
+const session = await createSession({
+  provider,
+  relay: { type: 'memory' },
+})
+
+// Spawn agents in isolated sandboxes
+const architect = await session.spawn('architect', {
+  image: 'node:22',
+  env: { ROLE: 'architect' },
+})
+
+const developer = await session.spawn('developer', {
+  image: 'node:22',
+  env: { ROLE: 'developer' },
+})
+
+// Shared context — all agents can read/write
+await session.context.set('spec', { endpoints: ['/users', '/posts'] })
+
+// Wait for all agents to complete
+await session.waitForAll()
+await session.close()
+```
+
+Inside the sandbox, agents use `@douglas-agent/sandbank-agent`:
+
+```typescript
+import { connect } from '@douglas-agent/sandbank-agent'
+
+const session = await connect() // reads SANDBANK_* env vars
+
+session.on('message', async (msg) => {
+  if (msg.type === 'task') {
+    // do work...
+    await session.send(msg.from, 'done', result)
+  }
+})
+
+await session.complete({ status: 'success', summary: 'Built 5 API endpoints' })
+```
+
+## Quick Start
+
+```bash
+# Install
+pnpm add @douglas-agent/sandbank-core @douglas-agent/sandbank-daytona  # or @douglas-agent/sandbank-flyio, @douglas-agent/sandbank-cloudflare
+
+# Set up provider
+export DAYTONA_API_KEY=your-key
+```
+
+```typescript
+import { createProvider } from '@douglas-agent/sandbank-core'
+import { DaytonaAdapter } from '@douglas-agent/sandbank-daytona'
+
+const provider = createProvider(
+  new DaytonaAdapter({ apiKey: process.env.DAYTONA_API_KEY! })
+)
+
+// Create a sandbox
+const sandbox = await provider.create({
+  image: 'node:22',
+  resources: { cpu: 2, memory: 2048 },
+  autoDestroyMinutes: 30,
+})
+
+// Run commands
+const { stdout } = await sandbox.exec('node --version')
+
+// File operations
+await sandbox.writeFile('/app/index.js', 'console.log("hi")')
+await sandbox.exec('node /app/index.js')
+
+// Clean up
+await provider.destroy(sandbox.id)
+```
+
+## Development
+
+```bash
+git clone https://github.com/chekusu/sandbank.git
+cd sandbank
+pnpm install
+
+# Run all unit tests
+pnpm test
+
+# Run cross-provider conformance tests
+pnpm test:conformance
+
+# Typecheck
+pnpm typecheck
+```
+
+### Running Integration Tests
+
+Integration tests hit real APIs and are gated by environment variables:
+
+```bash
+# Daytona
+DAYTONA_API_KEY=... pnpm test
+
+# Fly.io
+FLY_API_TOKEN=... FLY_APP_NAME=... pnpm test
+
+# Cloudflare
+E2E_WORKER_URL=... pnpm test
+```
+
+## Design Principles
+
+1. **Minimal interface, maximum interop** — only the true common denominator (exec + files + lifecycle)
+2. **Explicit over implicit** — no auto-fallback, no caching, no hidden retries
+3. **Capability detection, not fake implementations** — if a provider doesn't support it, it errors
+4. **Idempotent operations** — destroying an already-destroyed sandbox is a no-op
+5. **Full decoupling** — provider layer and session layer are independent, compose freely
+
+## License
+
+MIT

package/dist/cli/api.d.ts

@@ -0,0 +1,6 @@
+import { createX402Fetch } from '@douglas-agent/sandbank-cloud';
+import type { CliFlags } from './auth.js';
+export type ApiClient = ReturnType<typeof createX402Fetch>;
+export declare function createApiClient(flags: CliFlags): ApiClient;
+export declare function printJson(value: unknown): void;
+//# sourceMappingURL=api.d.ts.map

package/dist/cli/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/cli/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAGzC,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAA;AAE1D,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,CAE1D;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAE9C"}

package/dist/cli/api.js

@@ -0,0 +1,8 @@
+import { createX402Fetch } from '@douglas-agent/sandbank-cloud';
+import { resolveCloudConfig } from './auth.js';
+export function createApiClient(flags) {
+    return createX402Fetch(resolveCloudConfig(flags));
+}
+export function printJson(value) {
+    console.log(JSON.stringify(value, null, 2));
+}

package/dist/cli/api.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=api.test.d.ts.map

package/dist/cli/api.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.test.d.ts","sourceRoot":"","sources":["../../src/cli/api.test.ts"],"names":[],"mappings":""}

package/dist/cli/api.test.js

@@ -0,0 +1,31 @@
+import { describe, it, expect, vi } from 'vitest';
+vi.mock('@douglas-agent/sandbank-cloud', () => ({
+    createX402Fetch: vi.fn((config) => ({
+        x402Fetch: vi.fn(),
+        x402FetchRaw: vi.fn(),
+        baseUrl: config.url || 'https://cloud.sandbank.dev',
+    })),
+}));
+vi.mock('./auth.js', () => ({
+    resolveCloudConfig: vi.fn((flags) => ({
+        url: flags.url || 'https://cloud.sandbank.dev',
+        apiToken: flags.apiKey,
+    })),
+}));
+import { createApiClient, printJson } from './api.js';
+describe('createApiClient', () => {
+    it('creates a client with resolved config', () => {
+        const client = createApiClient({ apiKey: 'test' });
+        expect(client).toHaveProperty('x402Fetch');
+        expect(client).toHaveProperty('x402FetchRaw');
+        expect(client).toHaveProperty('baseUrl');
+    });
+});
+describe('printJson', () => {
+    it('prints JSON to stdout', () => {
+        const spy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        printJson({ foo: 'bar' });
+        expect(spy).toHaveBeenCalledWith(JSON.stringify({ foo: 'bar' }, null, 2));
+        spy.mockRestore();
+    });
+});

package/dist/cli/auth.d.ts

@@ -0,0 +1,25 @@
+import type { SandbankCloudConfig } from '@douglas-agent/sandbank-cloud';
+export interface CliFlags {
+    apiKey?: string;
+    walletKey?: string;
+    url?: string;
+    json?: boolean;
+}
+/**
+ * Resolve SandbankCloudConfig from CLI flags, env vars, and saved credentials.
+ *
+ * Priority for API token:
+ *   1. --api-key flag
+ *   2. SANDBANK_API_KEY env
+ *   3. SANDBANK_AGENT_TOKEN env (inside sandbox)
+ *   4. ~/.sandbank/credentials.json
+ *
+ * Priority for wallet key:
+ *   1. --wallet-key flag
+ *   2. SANDBANK_WALLET_KEY env
+ *   3. ~/.sandbank/credentials.json
+ */
+export declare function resolveCloudConfig(flags: CliFlags): SandbankCloudConfig;
+/** Get current box ID (only available inside a sandbox) */
+export declare function currentBoxId(): string | undefined;
+//# sourceMappingURL=auth.d.ts.map

package/dist/cli/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/cli/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AAGxE,MAAM,WAAW,QAAQ;IACvB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,QAAQ,GAAG,mBAAmB,CAkBvE;AAED,2DAA2D;AAC3D,wBAAgB,YAAY,IAAI,MAAM,GAAG,SAAS,CAEjD"}

package/dist/cli/auth.js

@@ -0,0 +1,34 @@
+import { loadCredentials } from './config.js';
+/**
+ * Resolve SandbankCloudConfig from CLI flags, env vars, and saved credentials.
+ *
+ * Priority for API token:
+ *   1. --api-key flag
+ *   2. SANDBANK_API_KEY env
+ *   3. SANDBANK_AGENT_TOKEN env (inside sandbox)
+ *   4. ~/.sandbank/credentials.json
+ *
+ * Priority for wallet key:
+ *   1. --wallet-key flag
+ *   2. SANDBANK_WALLET_KEY env
+ *   3. ~/.sandbank/credentials.json
+ */
+export function resolveCloudConfig(flags) {
+    const creds = loadCredentials();
+    const apiToken = flags.apiKey
+        || process.env['SANDBANK_API_KEY']
+        || process.env['SANDBANK_AGENT_TOKEN']
+        || creds.apiKey;
+    const walletPrivateKey = flags.walletKey
+        || process.env['SANDBANK_WALLET_KEY']
+        || creds.walletKey;
+    const url = flags.url
+        || process.env['SANDBANK_API_URL']
+        || creds.url
+        || 'https://cloud.sandbank.dev';
+    return { url, apiToken, walletPrivateKey };
+}
+/** Get current box ID (only available inside a sandbox) */
+export function currentBoxId() {
+    return process.env['SANDBANK_BOX_ID'];
+}

package/dist/cli/auth.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=auth.test.d.ts.map

package/dist/cli/auth.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.test.d.ts","sourceRoot":"","sources":["../../src/cli/auth.test.ts"],"names":[],"mappings":""}

package/dist/cli/auth.test.js

@@ -0,0 +1,89 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+vi.mock('./config.js', () => ({
+    loadCredentials: vi.fn(() => ({})),
+}));
+import { resolveCloudConfig, currentBoxId } from './auth.js';
+import { loadCredentials } from './config.js';
+describe('resolveCloudConfig', () => {
+    const origEnv = { ...process.env };
+    beforeEach(() => {
+        vi.mocked(loadCredentials).mockReturnValue({});
+        delete process.env['SANDBANK_API_KEY'];
+        delete process.env['SANDBANK_AGENT_TOKEN'];
+        delete process.env['SANDBANK_WALLET_KEY'];
+        delete process.env['SANDBANK_API_URL'];
+    });
+    afterEach(() => {
+        Object.assign(process.env, origEnv);
+    });
+    it('uses default URL when nothing configured', () => {
+        const config = resolveCloudConfig({});
+        expect(config.url).toBe('https://cloud.sandbank.dev');
+        expect(config.apiToken).toBeUndefined();
+        expect(config.walletPrivateKey).toBeUndefined();
+    });
+    it('prioritizes --api-key flag over env', () => {
+        process.env['SANDBANK_API_KEY'] = 'env-key';
+        const config = resolveCloudConfig({ apiKey: 'flag-key' });
+        expect(config.apiToken).toBe('flag-key');
+    });
+    it('uses SANDBANK_API_KEY env var', () => {
+        process.env['SANDBANK_API_KEY'] = 'env-key';
+        const config = resolveCloudConfig({});
+        expect(config.apiToken).toBe('env-key');
+    });
+    it('uses SANDBANK_AGENT_TOKEN as fallback', () => {
+        process.env['SANDBANK_AGENT_TOKEN'] = 'agent-token';
+        const config = resolveCloudConfig({});
+        expect(config.apiToken).toBe('agent-token');
+    });
+    it('prefers SANDBANK_API_KEY over SANDBANK_AGENT_TOKEN', () => {
+        process.env['SANDBANK_API_KEY'] = 'api-key';
+        process.env['SANDBANK_AGENT_TOKEN'] = 'agent-token';
+        const config = resolveCloudConfig({});
+        expect(config.apiToken).toBe('api-key');
+    });
+    it('falls back to saved credentials', () => {
+        vi.mocked(loadCredentials).mockReturnValue({ apiKey: 'saved-key', url: 'https://custom.dev' });
+        const config = resolveCloudConfig({});
+        expect(config.apiToken).toBe('saved-key');
+        expect(config.url).toBe('https://custom.dev');
+    });
+    it('resolves wallet key from flag', () => {
+        const config = resolveCloudConfig({ walletKey: '0xabc' });
+        expect(config.walletPrivateKey).toBe('0xabc');
+    });
+    it('resolves wallet key from env', () => {
+        process.env['SANDBANK_WALLET_KEY'] = '0xdef';
+        const config = resolveCloudConfig({});
+        expect(config.walletPrivateKey).toBe('0xdef');
+    });
+    it('resolves wallet key from saved credentials', () => {
+        vi.mocked(loadCredentials).mockReturnValue({ walletKey: '0x123' });
+        const config = resolveCloudConfig({});
+        expect(config.walletPrivateKey).toBe('0x123');
+    });
+    it('uses --url flag', () => {
+        const config = resolveCloudConfig({ url: 'http://localhost:3000' });
+        expect(config.url).toBe('http://localhost:3000');
+    });
+    it('uses SANDBANK_API_URL env', () => {
+        process.env['SANDBANK_API_URL'] = 'http://local:4000';
+        const config = resolveCloudConfig({});
+        expect(config.url).toBe('http://local:4000');
+    });
+});
+describe('currentBoxId', () => {
+    const origEnv = { ...process.env };
+    afterEach(() => {
+        Object.assign(process.env, origEnv);
+    });
+    it('returns SANDBANK_BOX_ID when set', () => {
+        process.env['SANDBANK_BOX_ID'] = 'box-123';
+        expect(currentBoxId()).toBe('box-123');
+    });
+    it('returns undefined when not set', () => {
+        delete process.env['SANDBANK_BOX_ID'];
+        expect(currentBoxId()).toBeUndefined();
+    });
+});

package/dist/cli/commands/addons.d.ts

@@ -0,0 +1,3 @@
+import type { CliFlags } from '../auth.js';
+export declare function addonsCommand(args: string[], flags: CliFlags): Promise<void>;
+//# sourceMappingURL=addons.d.ts.map

package/dist/cli/commands/addons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addons.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/addons.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAY1C,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDlF"}

package/dist/cli/commands/addons.js

@@ -0,0 +1,54 @@
+import { currentBoxId } from '../auth.js';
+import { createApiClient, printJson } from '../api.js';
+function takeOption(args, name) {
+    const idx = args.indexOf(name);
+    if (idx === -1)
+        return undefined;
+    const value = args[idx + 1];
+    args.splice(idx, 2);
+    return value;
+}
+export async function addonsCommand(args, flags) {
+    const sub = args[0];
+    const boxId = takeOption(args, '--box') || currentBoxId();
+    if (sub === 'create') {
+        const type = args[1];
+        if (!type) {
+            console.error('Usage: sandbank addons create <type> [--intent "..."] [--box <id>]');
+            process.exit(1);
+        }
+        if (!boxId) {
+            console.error('No box ID. Use --box <id> or run inside a sandbox.');
+            process.exit(1);
+        }
+        const intent = takeOption(args, '--intent') || args.slice(2).join(' ') || undefined;
+        const api = createApiClient(flags);
+        const result = await api.x402Fetch(`/boxes/${boxId}/addons`, { method: 'POST', body: JSON.stringify({ type, intent }) });
+        if (flags.json)
+            return printJson(result);
+        console.log(`${result.type} ${result.id} ${result.status}`);
+        if (result.relay_name)
+            console.log(`relay: ${result.relay_name}`);
+        return;
+    }
+    if (sub === 'list' || sub === 'ls') {
+        if (!boxId) {
+            console.error('No box ID. Use --box <id> or run inside a sandbox.');
+            process.exit(1);
+        }
+        const api = createApiClient(flags);
+        const addons = await api.x402Fetch(`/boxes/${boxId}/addons`);
+        if (flags.json)
+            return printJson(addons);
+        if (addons.length === 0) {
+            console.log('No addons');
+            return;
+        }
+        for (const a of addons) {
+            console.log(`${a.id}  ${a.type.padEnd(12)}  ${a.status.padEnd(8)}  ${a.created_at}`);
+        }
+        return;
+    }
+    console.error('Usage: sandbank addons <create|list> ...');
+    process.exit(1);
+}

package/dist/cli/commands/clone.d.ts

@@ -0,0 +1,3 @@
+import type { CliFlags } from '../auth.js';
+export declare function cloneCommand(args: string[], flags: CliFlags): Promise<void>;
+//# sourceMappingURL=clone.d.ts.map

package/dist/cli/commands/clone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/clone.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAI1C,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBjF"}

package/dist/cli/commands/clone.js

@@ -0,0 +1,18 @@
+import { currentBoxId } from '../auth.js';
+import { createApiClient, printJson } from '../api.js';
+export async function cloneCommand(args, flags) {
+    const id = args[0] || currentBoxId();
+    if (!id) {
+        console.error('Usage: sandbank clone <id>');
+        console.error('Inside a sandbox, <id> defaults to the current box.');
+        process.exit(1);
+    }
+    const api = createApiClient(flags);
+    const result = await api.x402Fetch(`/boxes/${id}/clone`, {
+        method: 'POST',
+        body: JSON.stringify({}),
+    });
+    if (flags.json)
+        return printJson(result);
+    console.log(`Cloned ${id} → ${result.id} (${result.status})`);
+}

package/dist/cli/commands/commands.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=commands.test.d.ts.map

package/dist/cli/commands/commands.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.test.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/commands.test.ts"],"names":[],"mappings":""}