@computesdk/opencomputer 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 computesdk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,98 @@
+# @computesdk/opencomputer
+
+OpenComputer provider for ComputeSDK - create persistent cloud VMs, run commands, read/write files, expose preview URLs, and manage checkpoints through the ComputeSDK interface.
+
+## Installation
+
+```bash
+npm install computesdk @computesdk/opencomputer
+```
+
+## Setup
+
+Create an OpenComputer API key and set:
+
+```bash
+export OPENCOMPUTER_API_KEY=your_api_key_here
+```
+
+Optionally override the API URL:
+
+```bash
+export OPENCOMPUTER_API_URL=https://app.opencomputer.dev
+```
+
+## Quick Start
+
+```typescript
+import { compute } from 'computesdk';
+import { opencomputer } from '@computesdk/opencomputer';
+
+compute.setConfig({
+  provider: opencomputer({ apiKey: process.env.OPENCOMPUTER_API_KEY }),
+});
+
+const sandbox = await compute.sandbox.create({ templateId: 'base' });
+
+const result = await sandbox.runCommand('echo "Hello from OpenComputer"');
+console.log(result.stdout);
+
+await sandbox.filesystem.writeFile('/tmp/hello.txt', 'Hello ComputeSDK');
+console.log(await sandbox.filesystem.readFile('/tmp/hello.txt'));
+
+const url = await sandbox.getUrl({ port: 3000 });
+console.log(url);
+
+await sandbox.destroy();
+```
+
+## Configuration
+
+```typescript
+interface OpenComputerConfig {
+  apiKey?: string;
+  apiUrl?: string;
+  template?: string;
+  timeout?: number;
+  envs?: Record<string, string>;
+  metadata?: Record<string, string>;
+  cpuCount?: number;
+  memoryMB?: number;
+  diskMB?: number;
+  secretStore?: string;
+  burst?: boolean;
+  previewAuth?: { scheme?: 'bearer'; token?: 'auto' | string };
+}
+```
+
+`timeout` uses ComputeSDK's millisecond convention and is converted to OpenComputer's seconds-based API.
+
+## Features
+
+- Command execution via OpenComputer exec
+- Filesystem read, write, mkdir, list, exists, and remove
+- Sandbox create, reconnect by ID, and destroy
+- Preview URLs for sandbox ports
+- Checkpoints through ComputeSDK snapshots
+
+## Snapshots
+
+OpenComputer checkpoints are scoped to a source sandbox. This provider returns snapshot IDs in the form `sandboxId:checkpointId` so ComputeSDK can later delete the checkpoint.
+
+```typescript
+const sandbox = await compute.sandbox.create();
+
+const snapshot = await compute.snapshot.create(sandbox.sandboxId, {
+  name: 'ready-state',
+});
+
+const clone = await compute.sandbox.create({ snapshotId: snapshot.id });
+
+await compute.snapshot.delete(snapshot.id);
+await clone.destroy();
+await sandbox.destroy();
+```
+
+You can also pass a raw OpenComputer checkpoint ID to `compute.sandbox.create({ snapshotId })` when you only need to fork from it.
+
+Snapshots default to OpenComputer `disk_only` checkpoints with `promoteToFull: true`. Override with `metadata: { kind: 'full' }` or `metadata: { promoteToFull: false }` when needed.

package/dist/index.d.mts

@@ -0,0 +1,139 @@
+import * as _computesdk_provider from '@computesdk/provider';
+
+/**
+ * OpenComputer Provider - Factory-based Implementation
+ *
+ * Wraps the official `@opencomputer/sdk` so OpenComputer sandboxes can be used
+ * through the ComputeSDK provider interface.
+ */
+interface OpenComputerProcessResult {
+    stdout?: string;
+    stderr?: string;
+    exitCode?: number;
+}
+interface OpenComputerExecSession {
+    sessionId: string;
+}
+interface OpenComputerEntryInfo {
+    name: string;
+    isDir: boolean;
+    path: string;
+    size: number;
+}
+interface OpenComputerCheckpointInfo {
+    id: string;
+    sandboxId?: string;
+    orgId?: string;
+    name?: string;
+    status?: string;
+    sizeBytes?: number;
+    createdAt?: string;
+    sandboxConfig?: Record<string, unknown>;
+}
+interface OpenComputerPreviewURLResult {
+    hostname?: string;
+    customHostname?: string;
+    port: number;
+}
+interface OpenComputerNativeSandbox {
+    readonly sandboxId: string;
+    readonly id: string;
+    readonly status: string;
+    readonly previewAuthToken?: string;
+    readonly webhooks?: Array<{
+        id: string;
+        url: string;
+        secret?: string;
+    }>;
+    readonly commands: {
+        run(command: string, opts?: {
+            cwd?: string;
+            env?: Record<string, string>;
+            timeout?: number;
+            timeoutMs?: number;
+        }): Promise<OpenComputerProcessResult>;
+    };
+    readonly exec?: {
+        run(command: string, opts?: {
+            cwd?: string;
+            env?: Record<string, string>;
+            timeout?: number;
+            timeoutMs?: number;
+        }): Promise<OpenComputerProcessResult>;
+        background?(command: string, opts?: {
+            cwd?: string;
+            env?: Record<string, string>;
+            timeout?: number;
+            timeoutMs?: number;
+        }): Promise<OpenComputerExecSession>;
+    };
+    readonly files: {
+        read(path: string): Promise<string>;
+        write(path: string, content: string): Promise<void>;
+        makeDir(path: string): Promise<void>;
+        list(path?: string): Promise<OpenComputerEntryInfo[]>;
+        exists(path: string): Promise<boolean>;
+        remove(path: string): Promise<void>;
+    };
+    getPreviewDomain(port: number): string;
+    createPreviewURL(opts: {
+        port: number;
+        domain?: string;
+        authConfig?: Record<string, unknown>;
+    }): Promise<OpenComputerPreviewURLResult>;
+    listPreviewURLs(): Promise<OpenComputerPreviewURLResult[]>;
+    kill(): Promise<void>;
+    isRunning(): Promise<boolean>;
+    createCheckpoint(name: string, opts?: {
+        kind?: 'full' | 'disk_only';
+        promoteToFull?: boolean;
+        retentionPolicy?: unknown;
+    }): Promise<OpenComputerCheckpointInfo>;
+    listCheckpoints(): Promise<OpenComputerCheckpointInfo[]>;
+    deleteCheckpoint(checkpointId: string): Promise<void>;
+}
+interface OpenComputerConfig {
+    /** OpenComputer API key - falls back to OPENCOMPUTER_API_KEY. */
+    apiKey?: string;
+    /** OpenComputer API URL - falls back to OPENCOMPUTER_API_URL, then production. */
+    apiUrl?: string;
+    /** Default template for new sandboxes. Defaults to OpenComputer's `base` template. */
+    template?: string;
+    /** Default idle timeout in milliseconds. OpenComputer receives this as seconds. */
+    timeout?: number;
+    /** Default environment variables for new sandboxes. */
+    envs?: Record<string, string>;
+    /** Default metadata for new sandboxes. */
+    metadata?: Record<string, string>;
+    /** OpenComputer CPU count for new sandboxes. */
+    cpuCount?: number;
+    /** OpenComputer memory size in MB for new sandboxes. */
+    memoryMB?: number;
+    /** OpenComputer workspace disk size in MB for new sandboxes. */
+    diskMB?: number;
+    /** Secret store to attach to new sandboxes. */
+    secretStore?: string;
+    /** Create Burst sandboxes by default. */
+    burst?: boolean;
+    /** Require bearer auth on preview URLs. */
+    previewAuth?: {
+        scheme?: 'bearer';
+        token?: 'auto' | string;
+    };
+}
+interface OpenComputerSnapshot {
+    id: string;
+    provider: 'opencomputer';
+    createdAt: Date;
+    metadata: {
+        sandboxId?: string;
+        orgId?: string;
+        name?: string;
+        status?: string;
+        sizeBytes?: number;
+        sandboxConfig?: Record<string, unknown>;
+    };
+}
+declare const opencomputer: (config?: OpenComputerConfig) => _computesdk_provider.Provider<OpenComputerNativeSandbox, any, OpenComputerSnapshot>;
+
+export { type OpenComputerConfig, type OpenComputerNativeSandbox, type OpenComputerSnapshot, opencomputer };

package/dist/index.d.ts

@@ -0,0 +1,139 @@
+import * as _computesdk_provider from '@computesdk/provider';
+
+/**
+ * OpenComputer Provider - Factory-based Implementation
+ *
+ * Wraps the official `@opencomputer/sdk` so OpenComputer sandboxes can be used
+ * through the ComputeSDK provider interface.
+ */
+interface OpenComputerProcessResult {
+    stdout?: string;
+    stderr?: string;
+    exitCode?: number;
+}
+interface OpenComputerExecSession {
+    sessionId: string;
+}
+interface OpenComputerEntryInfo {
+    name: string;
+    isDir: boolean;
+    path: string;
+    size: number;
+}
+interface OpenComputerCheckpointInfo {
+    id: string;
+    sandboxId?: string;
+    orgId?: string;
+    name?: string;
+    status?: string;
+    sizeBytes?: number;
+    createdAt?: string;
+    sandboxConfig?: Record<string, unknown>;
+}
+interface OpenComputerPreviewURLResult {
+    hostname?: string;
+    customHostname?: string;
+    port: number;
+}
+interface OpenComputerNativeSandbox {
+    readonly sandboxId: string;
+    readonly id: string;
+    readonly status: string;
+    readonly previewAuthToken?: string;
+    readonly webhooks?: Array<{
+        id: string;
+        url: string;
+        secret?: string;
+    }>;
+    readonly commands: {
+        run(command: string, opts?: {
+            cwd?: string;
+            env?: Record<string, string>;
+            timeout?: number;
+            timeoutMs?: number;
+        }): Promise<OpenComputerProcessResult>;
+    };
+    readonly exec?: {
+        run(command: string, opts?: {
+            cwd?: string;
+            env?: Record<string, string>;
+            timeout?: number;
+            timeoutMs?: number;
+        }): Promise<OpenComputerProcessResult>;
+        background?(command: string, opts?: {
+            cwd?: string;
+            env?: Record<string, string>;
+            timeout?: number;
+            timeoutMs?: number;
+        }): Promise<OpenComputerExecSession>;
+    };
+    readonly files: {
+        read(path: string): Promise<string>;
+        write(path: string, content: string): Promise<void>;
+        makeDir(path: string): Promise<void>;
+        list(path?: string): Promise<OpenComputerEntryInfo[]>;
+        exists(path: string): Promise<boolean>;
+        remove(path: string): Promise<void>;
+    };
+    getPreviewDomain(port: number): string;
+    createPreviewURL(opts: {
+        port: number;
+        domain?: string;
+        authConfig?: Record<string, unknown>;
+    }): Promise<OpenComputerPreviewURLResult>;
+    listPreviewURLs(): Promise<OpenComputerPreviewURLResult[]>;
+    kill(): Promise<void>;
+    isRunning(): Promise<boolean>;
+    createCheckpoint(name: string, opts?: {
+        kind?: 'full' | 'disk_only';
+        promoteToFull?: boolean;
+        retentionPolicy?: unknown;
+    }): Promise<OpenComputerCheckpointInfo>;
+    listCheckpoints(): Promise<OpenComputerCheckpointInfo[]>;
+    deleteCheckpoint(checkpointId: string): Promise<void>;
+}
+interface OpenComputerConfig {
+    /** OpenComputer API key - falls back to OPENCOMPUTER_API_KEY. */
+    apiKey?: string;
+    /** OpenComputer API URL - falls back to OPENCOMPUTER_API_URL, then production. */
+    apiUrl?: string;
+    /** Default template for new sandboxes. Defaults to OpenComputer's `base` template. */
+    template?: string;
+    /** Default idle timeout in milliseconds. OpenComputer receives this as seconds. */
+    timeout?: number;
+    /** Default environment variables for new sandboxes. */
+    envs?: Record<string, string>;
+    /** Default metadata for new sandboxes. */
+    metadata?: Record<string, string>;
+    /** OpenComputer CPU count for new sandboxes. */
+    cpuCount?: number;
+    /** OpenComputer memory size in MB for new sandboxes. */
+    memoryMB?: number;
+    /** OpenComputer workspace disk size in MB for new sandboxes. */
+    diskMB?: number;
+    /** Secret store to attach to new sandboxes. */
+    secretStore?: string;
+    /** Create Burst sandboxes by default. */
+    burst?: boolean;
+    /** Require bearer auth on preview URLs. */
+    previewAuth?: {
+        scheme?: 'bearer';
+        token?: 'auto' | string;
+    };
+}
+interface OpenComputerSnapshot {
+    id: string;
+    provider: 'opencomputer';
+    createdAt: Date;
+    metadata: {
+        sandboxId?: string;
+        orgId?: string;
+        name?: string;
+        status?: string;
+        sizeBytes?: number;
+        sandboxConfig?: Record<string, unknown>;
+    };
+}
+declare const opencomputer: (config?: OpenComputerConfig) => _computesdk_provider.Provider<OpenComputerNativeSandbox, any, OpenComputerSnapshot>;
+
+export { type OpenComputerConfig, type OpenComputerNativeSandbox, type OpenComputerSnapshot, opencomputer };

package/dist/index.js

@@ -0,0 +1,343 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  opencomputer: () => opencomputer
+});
+module.exports = __toCommonJS(index_exports);
+var import_provider = require("@computesdk/provider");
+var _SandboxClass = null;
+async function loadSandbox() {
+  if (!_SandboxClass) {
+    const mod = await import("@opencomputer/sdk");
+    _SandboxClass = mod.Sandbox;
+  }
+  return _SandboxClass;
+}
+function env(name) {
+  return typeof process !== "undefined" ? process.env?.[name] : void 0;
+}
+function baseOpts(config) {
+  return {
+    apiKey: config.apiKey || env("OPENCOMPUTER_API_KEY"),
+    apiUrl: config.apiUrl || env("OPENCOMPUTER_API_URL")
+  };
+}
+function toSeconds(milliseconds) {
+  return milliseconds == null ? void 0 : Math.ceil(milliseconds / 1e3);
+}
+function stringifyMetadata(metadata) {
+  if (!metadata) return void 0;
+  const out = {};
+  for (const [key, value] of Object.entries(metadata)) {
+    if (value == null || typeof value === "function" || typeof value === "symbol") {
+      continue;
+    }
+    if (typeof value === "string") {
+      out[key] = value;
+      continue;
+    }
+    if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") {
+      out[key] = String(value);
+      continue;
+    }
+    try {
+      const serialized = JSON.stringify(value);
+      if (serialized !== void 0) {
+        out[key] = serialized;
+      }
+    } catch {
+    }
+  }
+  return out;
+}
+function redactWebhooks(webhooks) {
+  return webhooks?.map((webhook) => ({
+    id: webhook.id,
+    url: webhook.url,
+    hasSecret: typeof webhook.secret === "string" && webhook.secret.length > 0
+  }));
+}
+function createOpts(config, options) {
+  return {
+    ...baseOpts(config),
+    template: options?.templateId || config.template,
+    timeout: toSeconds(options?.timeout ?? config.timeout),
+    envs: { ...config.envs, ...options?.envs },
+    metadata: { ...config.metadata, ...stringifyMetadata(options?.metadata) },
+    cpuCount: options?.cpuCount ?? config.cpuCount,
+    memoryMB: options?.memoryMB ?? options?.memory ?? config.memoryMB,
+    diskMB: options?.diskMB ?? config.diskMB,
+    secretStore: options?.secretStore ?? config.secretStore,
+    burst: options?.burst ?? config.burst,
+    sandboxFamily: options?.sandboxFamily,
+    previewAuth: options?.previewAuth ?? config.previewAuth,
+    webhooks: options?.webhooks
+  };
+}
+function snapshotToCompute(snapshot) {
+  const id = snapshot.sandboxId ? `${snapshot.sandboxId}:${snapshot.id}` : snapshot.id;
+  return {
+    id,
+    provider: "opencomputer",
+    createdAt: snapshot.createdAt ? new Date(snapshot.createdAt) : /* @__PURE__ */ new Date(),
+    metadata: {
+      sandboxId: snapshot.sandboxId,
+      orgId: snapshot.orgId,
+      name: snapshot.name,
+      status: snapshot.status,
+      sizeBytes: snapshot.sizeBytes,
+      sandboxConfig: snapshot.sandboxConfig
+    }
+  };
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function waitForCheckpointReady(sandbox, checkpoint, timeoutMs = 3e5) {
+  if (checkpoint.status === "ready") return checkpoint;
+  if (checkpoint.status === "failed") {
+    throw new Error(`OpenComputer checkpoint ${checkpoint.id} failed.`);
+  }
+  const deadline = Date.now() + timeoutMs;
+  let delay = 1e3;
+  for (; ; ) {
+    if (Date.now() >= deadline) {
+      throw new Error(`OpenComputer checkpoint ${checkpoint.id} was not ready after ${timeoutMs}ms.`);
+    }
+    const checkpoints = await sandbox.listCheckpoints();
+    const current = checkpoints.find((candidate) => candidate.id === checkpoint.id);
+    if (!current) {
+      throw new Error(`OpenComputer checkpoint ${checkpoint.id} disappeared while waiting for readiness.`);
+    }
+    if (current.status === "ready") return current;
+    if (current.status === "failed") {
+      throw new Error(`OpenComputer checkpoint ${checkpoint.id} failed.`);
+    }
+    await sleep(delay);
+    delay = Math.min(delay * 1.5, 5e3);
+  }
+}
+function isCheckpointIndexMiss(error) {
+  if (!(error instanceof Error)) return false;
+  const message = error.message.toLowerCase();
+  return message.includes("404") && message.includes("checkpoint") && message.includes("not found");
+}
+async function createFromCheckpointWithRetry(Sandbox, checkpointId, opts, timeoutMs = 6e4) {
+  const deadline = Date.now() + timeoutMs;
+  let delay = 1e3;
+  for (; ; ) {
+    try {
+      return await Sandbox.createFromCheckpoint(checkpointId, opts);
+    } catch (error) {
+      if (!isCheckpointIndexMiss(error) || Date.now() >= deadline) {
+        throw error;
+      }
+      await sleep(delay);
+      delay = Math.min(delay * 1.5, 5e3);
+    }
+  }
+}
+async function createSandbox(config, options) {
+  const Sandbox = await loadSandbox();
+  const opts = createOpts(config, options);
+  if (options?.snapshotId) {
+    const checkpointId = options.snapshotId.includes(":") ? options.snapshotId.slice(options.snapshotId.indexOf(":") + 1) : options.snapshotId;
+    const sandbox2 = await createFromCheckpointWithRetry(Sandbox, checkpointId, {
+      ...baseOpts(config),
+      timeout: opts.timeout,
+      envs: opts.envs,
+      secretStore: opts.secretStore
+    });
+    return { sandbox: sandbox2, sandboxId: sandbox2.sandboxId || sandbox2.id };
+  }
+  const sandbox = await Sandbox.create(opts);
+  return { sandbox, sandboxId: sandbox.sandboxId || sandbox.id };
+}
+var _provider = (0, import_provider.defineProvider)({
+  name: "opencomputer",
+  methods: {
+    sandbox: {
+      create: createSandbox,
+      getById: async (config, sandboxId) => {
+        const Sandbox = await loadSandbox();
+        try {
+          const sandbox = await Sandbox.connect(sandboxId, baseOpts(config));
+          return { sandbox, sandboxId: sandbox.sandboxId || sandbox.id || sandboxId };
+        } catch (error) {
+          if (error instanceof Error && (error.message.includes("404") || error.message.includes("not found"))) {
+            return null;
+          }
+          throw new Error(`Failed to get OpenComputer sandbox ${sandboxId}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+      },
+      list: async () => {
+        throw new Error("OpenComputer provider does not support listing sandboxes via the TypeScript SDK.");
+      },
+      destroy: async (config, sandboxId) => {
+        const Sandbox = await loadSandbox();
+        try {
+          const sandbox = await Sandbox.connect(sandboxId, baseOpts(config));
+          await sandbox.kill();
+        } catch (error) {
+          if (error instanceof Error && (error.message.includes("404") || error.message.includes("not found"))) {
+            return;
+          }
+          throw new Error(`Failed to destroy OpenComputer sandbox ${sandboxId}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+      },
+      runCommand: async (sandbox, command, options) => {
+        const startTime = Date.now();
+        try {
+          const runOptions = {
+            cwd: options?.cwd,
+            env: options?.env,
+            timeout: toSeconds(options?.timeout),
+            timeoutMs: options?.timeout
+          };
+          if (options?.background && sandbox.exec?.background) {
+            const session = await sandbox.exec.background(command, runOptions);
+            return {
+              stdout: session.sessionId,
+              stderr: "",
+              exitCode: 0,
+              durationMs: Date.now() - startTime
+            };
+          }
+          const result = await (sandbox.exec ?? sandbox.commands).run(command, runOptions);
+          return {
+            stdout: result.stdout || "",
+            stderr: result.stderr || "",
+            exitCode: result.exitCode ?? 0,
+            durationMs: Date.now() - startTime
+          };
+        } catch (error) {
+          throw new Error(`OpenComputer command execution failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+      },
+      getInfo: async (sandbox) => {
+        let status = sandbox.status;
+        try {
+          status = await sandbox.isRunning() ? "running" : sandbox.status;
+        } catch {
+          status = sandbox.status;
+        }
+        return {
+          id: sandbox.sandboxId || sandbox.id,
+          provider: "opencomputer",
+          status: status === "running" ? "running" : status === "error" ? "error" : "stopped",
+          createdAt: /* @__PURE__ */ new Date(),
+          timeout: 0,
+          metadata: {
+            opencomputerSandboxId: sandbox.sandboxId || sandbox.id,
+            previewAuthEnabled: Boolean(sandbox.previewAuthToken),
+            webhooks: redactWebhooks(sandbox.webhooks)
+          }
+        };
+      },
+      getUrl: async (sandbox, options) => {
+        const protocol = options.protocol || "https";
+        const domain = sandbox.getPreviewDomain(options.port);
+        if (domain) {
+          return `${protocol}://${domain}`;
+        }
+        const preview = await sandbox.createPreviewURL({ port: options.port });
+        const hostname = preview.customHostname || preview.hostname;
+        if (!hostname) {
+          throw new Error(`OpenComputer did not return a preview hostname for port ${options.port}.`);
+        }
+        return `${protocol}://${hostname}`;
+      },
+      filesystem: {
+        readFile: async (sandbox, path) => sandbox.files.read(path),
+        writeFile: async (sandbox, path, content) => {
+          await sandbox.files.write(path, content);
+        },
+        mkdir: async (sandbox, path) => {
+          await sandbox.files.makeDir(path);
+        },
+        readdir: async (sandbox, path) => {
+          const entries = await sandbox.files.list(path);
+          return entries.map((entry) => ({
+            name: entry.name,
+            type: entry.isDir ? "directory" : "file",
+            size: entry.size,
+            modified: /* @__PURE__ */ new Date()
+          }));
+        },
+        exists: async (sandbox, path) => sandbox.files.exists(path),
+        remove: async (sandbox, path) => {
+          await sandbox.files.remove(path);
+        }
+      },
+      getInstance: (sandbox) => sandbox
+    },
+    snapshot: {
+      create: async (config, sandboxId, options) => {
+        const Sandbox = await loadSandbox();
+        const sandbox = await Sandbox.connect(sandboxId, baseOpts(config));
+        const metadata = options?.metadata;
+        const kind = metadata?.kind ?? "disk_only";
+        const snapshot = await sandbox.createCheckpoint(options?.name || `snapshot-${Date.now()}`, {
+          kind,
+          promoteToFull: metadata?.promoteToFull ?? (kind === "disk_only" ? true : void 0),
+          retentionPolicy: metadata?.retentionPolicy
+        });
+        return snapshotToCompute(await waitForCheckpointReady(sandbox, snapshot));
+      },
+      list: async (config, options) => {
+        if (!options?.sandboxId) {
+          throw new Error("OpenComputer snapshots are scoped to a sandbox. Pass `sandboxId` to list snapshots.");
+        }
+        const Sandbox = await loadSandbox();
+        const sandbox = await Sandbox.connect(options.sandboxId, baseOpts(config));
+        const snapshots = await sandbox.listCheckpoints();
+        return snapshots.map(snapshotToCompute);
+      },
+      delete: async (config, snapshotId) => {
+        const sandboxId = snapshotId.split(":", 1)[0];
+        if (!sandboxId || sandboxId === snapshotId) {
+          throw new Error("OpenComputer snapshot deletion requires a sandbox-scoped id in the form `sandboxId:checkpointId`.");
+        }
+        const checkpointId = snapshotId.slice(sandboxId.length + 1);
+        const Sandbox = await loadSandbox();
+        const sandbox = await Sandbox.connect(sandboxId, baseOpts(config));
+        await sandbox.deleteCheckpoint(checkpointId);
+      }
+    }
+  }
+});
+var opencomputer = (config = {}) => _provider(config);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  opencomputer
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * OpenComputer Provider - Factory-based Implementation\n *\n * Wraps the official `@opencomputer/sdk` so OpenComputer sandboxes can be used\n * through the ComputeSDK provider interface.\n */\n\nimport { defineProvider } from '@computesdk/provider';\n\nimport type {\n  CommandResult,\n  CreateSandboxOptions,\n  CreateSnapshotOptions,\n  FileEntry,\n  ListSnapshotsOptions,\n  RunCommandOptions,\n  SandboxInfo,\n} from '@computesdk/provider';\n\ninterface OpenComputerSandboxOpts {\n  template?: string;\n  timeout?: number;\n  apiKey?: string;\n  apiUrl?: string;\n  envs?: Record<string, string>;\n  metadata?: Record<string, string>;\n  cpuCount?: number;\n  memoryMB?: number;\n  diskMB?: number;\n  secretStore?: string;\n  snapshot?: string;\n  burst?: boolean;\n  sandboxFamily?: 'spot';\n  previewAuth?: { scheme?: 'bearer'; token?: 'auto' | string };\n  webhooks?: Array<{ url: string; secret?: string; eventTypes?: string[] }>;\n}\n\ninterface OpenComputerProcessResult {\n  stdout?: string;\n  stderr?: string;\n  exitCode?: number;\n}\n\ninterface OpenComputerExecSession {\n  sessionId: string;\n}\n\ninterface OpenComputerEntryInfo {\n  name: string;\n  isDir: boolean;\n  path: string;\n  size: number;\n}\n\ninterface OpenComputerCheckpointInfo {\n  id: string;\n  sandboxId?: string;\n  orgId?: string;\n  name?: string;\n  status?: string;\n  sizeBytes?: number;\n  createdAt?: string;\n  sandboxConfig?: Record<string, unknown>;\n}\n\ninterface OpenComputerPreviewURLResult {\n  hostname?: string;\n  customHostname?: string;\n  port: number;\n}\n\ninterface OpenComputerNativeSandbox {\n  readonly sandboxId: string;\n  readonly id: string;\n  readonly status: string;\n  readonly previewAuthToken?: string;\n  readonly webhooks?: Array<{ id: string; url: string; secret?: string }>;\n  readonly commands: {\n    run(command: string, opts?: { cwd?: string; env?: Record<string, string>; timeout?: number; timeoutMs?: number }): Promise<OpenComputerProcessResult>;\n  };\n  readonly exec?: {\n    run(command: string, opts?: { cwd?: string; env?: Record<string, string>; timeout?: number; timeoutMs?: number }): Promise<OpenComputerProcessResult>;\n    background?(command: string, opts?: { cwd?: string; env?: Record<string, string>; timeout?: number; timeoutMs?: number }): Promise<OpenComputerExecSession>;\n  };\n  readonly files: {\n    read(path: string): Promise<string>;\n    write(path: string, content: string): Promise<void>;\n    makeDir(path: string): Promise<void>;\n    list(path?: string): Promise<OpenComputerEntryInfo[]>;\n    exists(path: string): Promise<boolean>;\n    remove(path: string): Promise<void>;\n  };\n  getPreviewDomain(port: number): string;\n  createPreviewURL(opts: { port: number; domain?: string; authConfig?: Record<string, unknown> }): Promise<OpenComputerPreviewURLResult>;\n  listPreviewURLs(): Promise<OpenComputerPreviewURLResult[]>;\n  kill(): Promise<void>;\n  isRunning(): Promise<boolean>;\n  createCheckpoint(name: string, opts?: { kind?: 'full' | 'disk_only'; promoteToFull?: boolean; retentionPolicy?: unknown }): Promise<OpenComputerCheckpointInfo>;\n  listCheckpoints(): Promise<OpenComputerCheckpointInfo[]>;\n  deleteCheckpoint(checkpointId: string): Promise<void>;\n}\n\ninterface OpenComputerSandboxStatic {\n  create(opts?: OpenComputerSandboxOpts): Promise<OpenComputerNativeSandbox>;\n  connect(sandboxId: string, opts?: Pick<OpenComputerSandboxOpts, 'apiKey' | 'apiUrl'>): Promise<OpenComputerNativeSandbox>;\n  createFromCheckpoint(checkpointId: string, opts?: Pick<OpenComputerSandboxOpts, 'apiKey' | 'apiUrl' | 'timeout' | 'envs' | 'secretStore'>): Promise<OpenComputerNativeSandbox>;\n}\n\nlet _SandboxClass: OpenComputerSandboxStatic | null = null;\n\nasync function loadSandbox(): Promise<OpenComputerSandboxStatic> {\n  if (!_SandboxClass) {\n    const mod = await import('@opencomputer/sdk');\n    _SandboxClass = (mod as { Sandbox: OpenComputerSandboxStatic }).Sandbox;\n  }\n  return _SandboxClass;\n}\n\nexport interface OpenComputerConfig {\n  /** OpenComputer API key - falls back to OPENCOMPUTER_API_KEY. */\n  apiKey?: string;\n  /** OpenComputer API URL - falls back to OPENCOMPUTER_API_URL, then production. */\n  apiUrl?: string;\n  /** Default template for new sandboxes. Defaults to OpenComputer's `base` template. */\n  template?: string;\n  /** Default idle timeout in milliseconds. OpenComputer receives this as seconds. */\n  timeout?: number;\n  /** Default environment variables for new sandboxes. */\n  envs?: Record<string, string>;\n  /** Default metadata for new sandboxes. */\n  metadata?: Record<string, string>;\n  /** OpenComputer CPU count for new sandboxes. */\n  cpuCount?: number;\n  /** OpenComputer memory size in MB for new sandboxes. */\n  memoryMB?: number;\n  /** OpenComputer workspace disk size in MB for new sandboxes. */\n  diskMB?: number;\n  /** Secret store to attach to new sandboxes. */\n  secretStore?: string;\n  /** Create Burst sandboxes by default. */\n  burst?: boolean;\n  /** Require bearer auth on preview URLs. */\n  previewAuth?: { scheme?: 'bearer'; token?: 'auto' | string };\n}\n\nexport interface OpenComputerSnapshot {\n  id: string;\n  provider: 'opencomputer';\n  createdAt: Date;\n  metadata: {\n    sandboxId?: string;\n    orgId?: string;\n    name?: string;\n    status?: string;\n    sizeBytes?: number;\n    sandboxConfig?: Record<string, unknown>;\n  };\n}\n\nfunction env(name: string): string | undefined {\n  return typeof process !== 'undefined' ? process.env?.[name] : undefined;\n}\n\nfunction baseOpts(config: OpenComputerConfig): Pick<OpenComputerSandboxOpts, 'apiKey' | 'apiUrl'> {\n  return {\n    apiKey: config.apiKey || env('OPENCOMPUTER_API_KEY'),\n    apiUrl: config.apiUrl || env('OPENCOMPUTER_API_URL'),\n  };\n}\n\nfunction toSeconds(milliseconds: number | undefined): number | undefined {\n  return milliseconds == null ? undefined : Math.ceil(milliseconds / 1000);\n}\n\nfunction stringifyMetadata(metadata: Record<string, unknown> | undefined): Record<string, string> | undefined {\n  if (!metadata) return undefined;\n  const out: Record<string, string> = {};\n  for (const [key, value] of Object.entries(metadata)) {\n    if (value == null || typeof value === 'function' || typeof value === 'symbol') {\n      continue;\n    }\n    if (typeof value === 'string') {\n      out[key] = value;\n      continue;\n    }\n    if (typeof value === 'number' || typeof value === 'boolean' || typeof value === 'bigint') {\n      out[key] = String(value);\n      continue;\n    }\n    try {\n      const serialized = JSON.stringify(value);\n      if (serialized !== undefined) {\n        out[key] = serialized;\n      }\n    } catch {\n      // Skip metadata values that cannot be represented as JSON strings.\n    }\n  }\n  return out;\n}\n\nfunction redactWebhooks(webhooks: OpenComputerNativeSandbox['webhooks']): Array<{ id: string; url: string; hasSecret: boolean }> | undefined {\n  return webhooks?.map((webhook) => ({\n    id: webhook.id,\n    url: webhook.url,\n    hasSecret: typeof webhook.secret === 'string' && webhook.secret.length > 0,\n  }));\n}\n\nfunction createOpts(config: OpenComputerConfig, options?: CreateSandboxOptions): OpenComputerSandboxOpts {\n  return {\n    ...baseOpts(config),\n    template: options?.templateId || config.template,\n    timeout: toSeconds(options?.timeout ?? config.timeout),\n    envs: { ...config.envs, ...options?.envs },\n    metadata: { ...config.metadata, ...stringifyMetadata(options?.metadata) },\n    cpuCount: (options as any)?.cpuCount ?? config.cpuCount,\n    memoryMB: (options as any)?.memoryMB ?? (options as any)?.memory ?? config.memoryMB,\n    diskMB: (options as any)?.diskMB ?? config.diskMB,\n    secretStore: (options as any)?.secretStore ?? config.secretStore,\n    burst: (options as any)?.burst ?? config.burst,\n    sandboxFamily: (options as any)?.sandboxFamily,\n    previewAuth: (options as any)?.previewAuth ?? config.previewAuth,\n    webhooks: (options as any)?.webhooks,\n  };\n}\n\nfunction snapshotToCompute(snapshot: OpenComputerCheckpointInfo): OpenComputerSnapshot {\n  const id = snapshot.sandboxId ? `${snapshot.sandboxId}:${snapshot.id}` : snapshot.id;\n  return {\n    id,\n    provider: 'opencomputer',\n    createdAt: snapshot.createdAt ? new Date(snapshot.createdAt) : new Date(),\n    metadata: {\n      sandboxId: snapshot.sandboxId,\n      orgId: snapshot.orgId,\n      name: snapshot.name,\n      status: snapshot.status,\n      sizeBytes: snapshot.sizeBytes,\n      sandboxConfig: snapshot.sandboxConfig,\n    },\n  };\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nasync function waitForCheckpointReady(\n  sandbox: OpenComputerNativeSandbox,\n  checkpoint: OpenComputerCheckpointInfo,\n  timeoutMs = 300_000,\n): Promise<OpenComputerCheckpointInfo> {\n  if (checkpoint.status === 'ready') return checkpoint;\n  if (checkpoint.status === 'failed') {\n    throw new Error(`OpenComputer checkpoint ${checkpoint.id} failed.`);\n  }\n\n  const deadline = Date.now() + timeoutMs;\n  let delay = 1_000;\n\n  for (;;) {\n    if (Date.now() >= deadline) {\n      throw new Error(`OpenComputer checkpoint ${checkpoint.id} was not ready after ${timeoutMs}ms.`);\n    }\n\n    const checkpoints = await sandbox.listCheckpoints();\n    const current = checkpoints.find((candidate) => candidate.id === checkpoint.id);\n    if (!current) {\n      throw new Error(`OpenComputer checkpoint ${checkpoint.id} disappeared while waiting for readiness.`);\n    }\n    if (current.status === 'ready') return current;\n    if (current.status === 'failed') {\n      throw new Error(`OpenComputer checkpoint ${checkpoint.id} failed.`);\n    }\n\n    await sleep(delay);\n    delay = Math.min(delay * 1.5, 5_000);\n  }\n}\n\nfunction isCheckpointIndexMiss(error: unknown): boolean {\n  if (!(error instanceof Error)) return false;\n  const message = error.message.toLowerCase();\n  return message.includes('404') && message.includes('checkpoint') && message.includes('not found');\n}\n\nasync function createFromCheckpointWithRetry(\n  Sandbox: OpenComputerSandboxStatic,\n  checkpointId: string,\n  opts: Pick<OpenComputerSandboxOpts, 'apiKey' | 'apiUrl' | 'timeout' | 'envs' | 'secretStore'>,\n  timeoutMs = 60_000,\n): Promise<OpenComputerNativeSandbox> {\n  const deadline = Date.now() + timeoutMs;\n  let delay = 1_000;\n\n  for (;;) {\n    try {\n      return await Sandbox.createFromCheckpoint(checkpointId, opts);\n    } catch (error) {\n      if (!isCheckpointIndexMiss(error) || Date.now() >= deadline) {\n        throw error;\n      }\n      await sleep(delay);\n      delay = Math.min(delay * 1.5, 5_000);\n    }\n  }\n}\n\nasync function createSandbox(config: OpenComputerConfig, options?: CreateSandboxOptions) {\n  const Sandbox = await loadSandbox();\n  const opts = createOpts(config, options);\n\n  if (options?.snapshotId) {\n    const checkpointId = options.snapshotId.includes(':')\n      ? options.snapshotId.slice(options.snapshotId.indexOf(':') + 1)\n      : options.snapshotId;\n    const sandbox = await createFromCheckpointWithRetry(Sandbox, checkpointId, {\n      ...baseOpts(config),\n      timeout: opts.timeout,\n      envs: opts.envs,\n      secretStore: opts.secretStore,\n    });\n    return { sandbox, sandboxId: sandbox.sandboxId || sandbox.id };\n  }\n\n  const sandbox = await Sandbox.create(opts);\n  return { sandbox, sandboxId: sandbox.sandboxId || sandbox.id };\n}\n\nconst _provider = defineProvider<OpenComputerNativeSandbox, OpenComputerConfig, any, OpenComputerSnapshot>({\n  name: 'opencomputer',\n  methods: {\n    sandbox: {\n      create: createSandbox,\n\n      getById: async (config: OpenComputerConfig, sandboxId: string) => {\n        const Sandbox = await loadSandbox();\n        try {\n          const sandbox = await Sandbox.connect(sandboxId, baseOpts(config));\n          return { sandbox, sandboxId: sandbox.sandboxId || sandbox.id || sandboxId };\n        } catch (error) {\n          if (error instanceof Error && (error.message.includes('404') || error.message.includes('not found'))) {\n            return null;\n          }\n          throw new Error(`Failed to get OpenComputer sandbox ${sandboxId}: ${error instanceof Error ? error.message : String(error)}`);\n        }\n      },\n\n      list: async () => {\n        throw new Error('OpenComputer provider does not support listing sandboxes via the TypeScript SDK.');\n      },\n\n      destroy: async (config: OpenComputerConfig, sandboxId: string) => {\n        const Sandbox = await loadSandbox();\n        try {\n          const sandbox = await Sandbox.connect(sandboxId, baseOpts(config));\n          await sandbox.kill();\n        } catch (error) {\n          if (error instanceof Error && (error.message.includes('404') || error.message.includes('not found'))) {\n            return;\n          }\n          throw new Error(`Failed to destroy OpenComputer sandbox ${sandboxId}: ${error instanceof Error ? error.message : String(error)}`);\n        }\n      },\n\n      runCommand: async (sandbox: OpenComputerNativeSandbox, command: string, options?: RunCommandOptions): Promise<CommandResult> => {\n        const startTime = Date.now();\n        try {\n          const runOptions = {\n            cwd: options?.cwd,\n            env: options?.env,\n            timeout: toSeconds(options?.timeout),\n            timeoutMs: options?.timeout,\n          };\n          if (options?.background && sandbox.exec?.background) {\n            const session = await sandbox.exec.background(command, runOptions);\n            return {\n              stdout: session.sessionId,\n              stderr: '',\n              exitCode: 0,\n              durationMs: Date.now() - startTime,\n            };\n          }\n\n          const result = await (sandbox.exec ?? sandbox.commands).run(command, runOptions);\n          return {\n            stdout: result.stdout || '',\n            stderr: result.stderr || '',\n            exitCode: result.exitCode ?? 0,\n            durationMs: Date.now() - startTime,\n          };\n        } catch (error) {\n          throw new Error(`OpenComputer command execution failed: ${error instanceof Error ? error.message : String(error)}`);\n        }\n      },\n\n      getInfo: async (sandbox: OpenComputerNativeSandbox): Promise<SandboxInfo> => {\n        let status = sandbox.status;\n        try {\n          status = (await sandbox.isRunning()) ? 'running' : sandbox.status;\n        } catch {\n          status = sandbox.status;\n        }\n\n        return {\n          id: sandbox.sandboxId || sandbox.id,\n          provider: 'opencomputer',\n          status: status === 'running' ? 'running' : status === 'error' ? 'error' : 'stopped',\n          createdAt: new Date(),\n          timeout: 0,\n          metadata: {\n            opencomputerSandboxId: sandbox.sandboxId || sandbox.id,\n            previewAuthEnabled: Boolean(sandbox.previewAuthToken),\n            webhooks: redactWebhooks(sandbox.webhooks),\n          },\n        };\n      },\n\n      getUrl: async (sandbox: OpenComputerNativeSandbox, options: { port: number; protocol?: string }): Promise<string> => {\n        const protocol = options.protocol || 'https';\n        const domain = sandbox.getPreviewDomain(options.port);\n        if (domain) {\n          return `${protocol}://${domain}`;\n        }\n\n        const preview = await sandbox.createPreviewURL({ port: options.port });\n        const hostname = preview.customHostname || preview.hostname;\n        if (!hostname) {\n          throw new Error(`OpenComputer did not return a preview hostname for port ${options.port}.`);\n        }\n        return `${protocol}://${hostname}`;\n      },\n\n      filesystem: {\n        readFile: async (sandbox: OpenComputerNativeSandbox, path: string): Promise<string> =>\n          sandbox.files.read(path),\n        writeFile: async (sandbox: OpenComputerNativeSandbox, path: string, content: string): Promise<void> => {\n          await sandbox.files.write(path, content);\n        },\n        mkdir: async (sandbox: OpenComputerNativeSandbox, path: string): Promise<void> => {\n          await sandbox.files.makeDir(path);\n        },\n        readdir: async (sandbox: OpenComputerNativeSandbox, path: string): Promise<FileEntry[]> => {\n          const entries = await sandbox.files.list(path);\n          return entries.map((entry) => ({\n            name: entry.name,\n            type: entry.isDir ? 'directory' as const : 'file' as const,\n            size: entry.size,\n            modified: new Date(),\n          }));\n        },\n        exists: async (sandbox: OpenComputerNativeSandbox, path: string): Promise<boolean> =>\n          sandbox.files.exists(path),\n        remove: async (sandbox: OpenComputerNativeSandbox, path: string): Promise<void> => {\n          await sandbox.files.remove(path);\n        },\n      },\n\n      getInstance: (sandbox: OpenComputerNativeSandbox): OpenComputerNativeSandbox => sandbox,\n    },\n\n    snapshot: {\n      create: async (config: OpenComputerConfig, sandboxId: string, options?: CreateSnapshotOptions) => {\n        const Sandbox = await loadSandbox();\n        const sandbox = await Sandbox.connect(sandboxId, baseOpts(config));\n        const metadata = options?.metadata as\n          | { kind?: 'full' | 'disk_only'; promoteToFull?: boolean; retentionPolicy?: unknown }\n          | undefined;\n        const kind = metadata?.kind ?? 'disk_only';\n        const snapshot = await sandbox.createCheckpoint(options?.name || `snapshot-${Date.now()}`, {\n          kind,\n          promoteToFull: metadata?.promoteToFull ?? (kind === 'disk_only' ? true : undefined),\n          retentionPolicy: metadata?.retentionPolicy,\n        });\n        return snapshotToCompute(await waitForCheckpointReady(sandbox, snapshot));\n      },\n      list: async (config: OpenComputerConfig, options?: ListSnapshotsOptions) => {\n        if (!options?.sandboxId) {\n          throw new Error('OpenComputer snapshots are scoped to a sandbox. Pass `sandboxId` to list snapshots.');\n        }\n        const Sandbox = await loadSandbox();\n        const sandbox = await Sandbox.connect(options.sandboxId, baseOpts(config));\n        const snapshots = await sandbox.listCheckpoints();\n        return snapshots.map(snapshotToCompute);\n      },\n      delete: async (config: OpenComputerConfig, snapshotId: string) => {\n        const sandboxId = snapshotId.split(':', 1)[0];\n        if (!sandboxId || sandboxId === snapshotId) {\n          throw new Error('OpenComputer snapshot deletion requires a sandbox-scoped id in the form `sandboxId:checkpointId`.');\n        }\n        const checkpointId = snapshotId.slice(sandboxId.length + 1);\n        const Sandbox = await loadSandbox();\n        const sandbox = await Sandbox.connect(sandboxId, baseOpts(config));\n        await sandbox.deleteCheckpoint(checkpointId);\n      },\n    },\n  },\n});\n\nexport const opencomputer = (config: OpenComputerConfig = {}) => _provider(config);\nexport type { OpenComputerNativeSandbox };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,sBAA+B;AAqG/B,IAAI,gBAAkD;AAEtD,eAAe,cAAkD;AAC/D,MAAI,CAAC,eAAe;AAClB,UAAM,MAAM,MAAM,OAAO,mBAAmB;AAC5C,oBAAiB,IAA+C;AAAA,EAClE;AACA,SAAO;AACT;AA2CA,SAAS,IAAI,MAAkC;AAC7C,SAAO,OAAO,YAAY,cAAc,QAAQ,MAAM,IAAI,IAAI;AAChE;AAEA,SAAS,SAAS,QAAgF;AAChG,SAAO;AAAA,IACL,QAAQ,OAAO,UAAU,IAAI,sBAAsB;AAAA,IACnD,QAAQ,OAAO,UAAU,IAAI,sBAAsB;AAAA,EACrD;AACF;AAEA,SAAS,UAAU,cAAsD;AACvE,SAAO,gBAAgB,OAAO,SAAY,KAAK,KAAK,eAAe,GAAI;AACzE;AAEA,SAAS,kBAAkB,UAAmF;AAC5G,MAAI,CAAC,SAAU,QAAO;AACtB,QAAM,MAA8B,CAAC;AACrC,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,QAAQ,GAAG;AACnD,QAAI,SAAS,QAAQ,OAAO,UAAU,cAAc,OAAO,UAAU,UAAU;AAC7E;AAAA,IACF;AACA,QAAI,OAAO,UAAU,UAAU;AAC7B,UAAI,GAAG,IAAI;AACX;AAAA,IACF;AACA,QAAI,OAAO,UAAU,YAAY,OAAO,UAAU,aAAa,OAAO,UAAU,UAAU;AACxF,UAAI,GAAG,IAAI,OAAO,KAAK;AACvB;AAAA,IACF;AACA,QAAI;AACF,YAAM,aAAa,KAAK,UAAU,KAAK;AACvC,UAAI,eAAe,QAAW;AAC5B,YAAI,GAAG,IAAI;AAAA,MACb;AAAA,IACF,QAAQ;AAAA,IAER;AAAA,EACF;AACA,SAAO;AACT;AAEA,SAAS,eAAe,UAAqH;AAC3I,SAAO,UAAU,IAAI,CAAC,aAAa;AAAA,IACjC,IAAI,QAAQ;AAAA,IACZ,KAAK,QAAQ;AAAA,IACb,WAAW,OAAO,QAAQ,WAAW,YAAY,QAAQ,OAAO,SAAS;AAAA,EAC3E,EAAE;AACJ;AAEA,SAAS,WAAW,QAA4B,SAAyD;AACvG,SAAO;AAAA,IACL,GAAG,SAAS,MAAM;AAAA,IAClB,UAAU,SAAS,cAAc,OAAO;AAAA,IACxC,SAAS,UAAU,SAAS,WAAW,OAAO,OAAO;AAAA,IACrD,MAAM,EAAE,GAAG,OAAO,MAAM,GAAG,SAAS,KAAK;AAAA,IACzC,UAAU,EAAE,GAAG,OAAO,UAAU,GAAG,kBAAkB,SAAS,QAAQ,EAAE;AAAA,IACxE,UAAW,SAAiB,YAAY,OAAO;AAAA,IAC/C,UAAW,SAAiB,YAAa,SAAiB,UAAU,OAAO;AAAA,IAC3E,QAAS,SAAiB,UAAU,OAAO;AAAA,IAC3C,aAAc,SAAiB,eAAe,OAAO;AAAA,IACrD,OAAQ,SAAiB,SAAS,OAAO;AAAA,IACzC,eAAgB,SAAiB;AAAA,IACjC,aAAc,SAAiB,eAAe,OAAO;AAAA,IACrD,UAAW,SAAiB;AAAA,EAC9B;AACF;AAEA,SAAS,kBAAkB,UAA4D;AACrF,QAAM,KAAK,SAAS,YAAY,GAAG,SAAS,SAAS,IAAI,SAAS,EAAE,KAAK,SAAS;AAClF,SAAO;AAAA,IACL;AAAA,IACA,UAAU;AAAA,IACV,WAAW,SAAS,YAAY,IAAI,KAAK,SAAS,SAAS,IAAI,oBAAI,KAAK;AAAA,IACxE,UAAU;AAAA,MACR,WAAW,SAAS;AAAA,MACpB,OAAO,SAAS;AAAA,MAChB,MAAM,SAAS;AAAA,MACf,QAAQ,SAAS;AAAA,MACjB,WAAW,SAAS;AAAA,MACpB,eAAe,SAAS;AAAA,IAC1B;AAAA,EACF;AACF;AAEA,SAAS,MAAM,IAA2B;AACxC,SAAO,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,EAAE,CAAC;AACzD;AAEA,eAAe,uBACb,SACA,YACA,YAAY,KACyB;AACrC,MAAI,WAAW,WAAW,QAAS,QAAO;AAC1C,MAAI,WAAW,WAAW,UAAU;AAClC,UAAM,IAAI,MAAM,2BAA2B,WAAW,EAAE,UAAU;AAAA,EACpE;AAEA,QAAM,WAAW,KAAK,IAAI,IAAI;AAC9B,MAAI,QAAQ;AAEZ,aAAS;AACP,QAAI,KAAK,IAAI,KAAK,UAAU;AAC1B,YAAM,IAAI,MAAM,2BAA2B,WAAW,EAAE,wBAAwB,SAAS,KAAK;AAAA,IAChG;AAEA,UAAM,cAAc,MAAM,QAAQ,gBAAgB;AAClD,UAAM,UAAU,YAAY,KAAK,CAAC,cAAc,UAAU,OAAO,WAAW,EAAE;AAC9E,QAAI,CAAC,SAAS;AACZ,YAAM,IAAI,MAAM,2BAA2B,WAAW,EAAE,2CAA2C;AAAA,IACrG;AACA,QAAI,QAAQ,WAAW,QAAS,QAAO;AACvC,QAAI,QAAQ,WAAW,UAAU;AAC/B,YAAM,IAAI,MAAM,2BAA2B,WAAW,EAAE,UAAU;AAAA,IACpE;AAEA,UAAM,MAAM,KAAK;AACjB,YAAQ,KAAK,IAAI,QAAQ,KAAK,GAAK;AAAA,EACrC;AACF;AAEA,SAAS,sBAAsB,OAAyB;AACtD,MAAI,EAAE,iBAAiB,OAAQ,QAAO;AACtC,QAAM,UAAU,MAAM,QAAQ,YAAY;AAC1C,SAAO,QAAQ,SAAS,KAAK,KAAK,QAAQ,SAAS,YAAY,KAAK,QAAQ,SAAS,WAAW;AAClG;AAEA,eAAe,8BACb,SACA,cACA,MACA,YAAY,KACwB;AACpC,QAAM,WAAW,KAAK,IAAI,IAAI;AAC9B,MAAI,QAAQ;AAEZ,aAAS;AACP,QAAI;AACF,aAAO,MAAM,QAAQ,qBAAqB,cAAc,IAAI;AAAA,IAC9D,SAAS,OAAO;AACd,UAAI,CAAC,sBAAsB,KAAK,KAAK,KAAK,IAAI,KAAK,UAAU;AAC3D,cAAM;AAAA,MACR;AACA,YAAM,MAAM,KAAK;AACjB,cAAQ,KAAK,IAAI,QAAQ,KAAK,GAAK;AAAA,IACrC;AAAA,EACF;AACF;AAEA,eAAe,cAAc,QAA4B,SAAgC;AACvF,QAAM,UAAU,MAAM,YAAY;AAClC,QAAM,OAAO,WAAW,QAAQ,OAAO;AAEvC,MAAI,SAAS,YAAY;AACvB,UAAM,eAAe,QAAQ,WAAW,SAAS,GAAG,IAChD,QAAQ,WAAW,MAAM,QAAQ,WAAW,QAAQ,GAAG,IAAI,CAAC,IAC5D,QAAQ;AACZ,UAAMA,WAAU,MAAM,8BAA8B,SAAS,cAAc;AAAA,MACzE,GAAG,SAAS,MAAM;AAAA,MAClB,SAAS,KAAK;AAAA,MACd,MAAM,KAAK;AAAA,MACX,aAAa,KAAK;AAAA,IACpB,CAAC;AACD,WAAO,EAAE,SAAAA,UAAS,WAAWA,SAAQ,aAAaA,SAAQ,GAAG;AAAA,EAC/D;AAEA,QAAM,UAAU,MAAM,QAAQ,OAAO,IAAI;AACzC,SAAO,EAAE,SAAS,WAAW,QAAQ,aAAa,QAAQ,GAAG;AAC/D;AAEA,IAAM,gBAAY,gCAAyF;AAAA,EACzG,MAAM;AAAA,EACN,SAAS;AAAA,IACP,SAAS;AAAA,MACP,QAAQ;AAAA,MAER,SAAS,OAAO,QAA4B,cAAsB;AAChE,cAAM,UAAU,MAAM,YAAY;AAClC,YAAI;AACF,gBAAM,UAAU,MAAM,QAAQ,QAAQ,WAAW,SAAS,MAAM,CAAC;AACjE,iBAAO,EAAE,SAAS,WAAW,QAAQ,aAAa,QAAQ,MAAM,UAAU;AAAA,QAC5E,SAAS,OAAO;AACd,cAAI,iBAAiB,UAAU,MAAM,QAAQ,SAAS,KAAK,KAAK,MAAM,QAAQ,SAAS,WAAW,IAAI;AACpG,mBAAO;AAAA,UACT;AACA,gBAAM,IAAI,MAAM,sCAAsC,SAAS,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC,EAAE;AAAA,QAC9H;AAAA,MACF;AAAA,MAEA,MAAM,YAAY;AAChB,cAAM,IAAI,MAAM,kFAAkF;AAAA,MACpG;AAAA,MAEA,SAAS,OAAO,QAA4B,cAAsB;AAChE,cAAM,UAAU,MAAM,YAAY;AAClC,YAAI;AACF,gBAAM,UAAU,MAAM,QAAQ,QAAQ,WAAW,SAAS,MAAM,CAAC;AACjE,gBAAM,QAAQ,KAAK;AAAA,QACrB,SAAS,OAAO;AACd,cAAI,iBAAiB,UAAU,MAAM,QAAQ,SAAS,KAAK,KAAK,MAAM,QAAQ,SAAS,WAAW,IAAI;AACpG;AAAA,UACF;AACA,gBAAM,IAAI,MAAM,0CAA0C,SAAS,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC,EAAE;AAAA,QAClI;AAAA,MACF;AAAA,MAEA,YAAY,OAAO,SAAoC,SAAiB,YAAwD;AAC9H,cAAM,YAAY,KAAK,IAAI;AAC3B,YAAI;AACF,gBAAM,aAAa;AAAA,YACjB,KAAK,SAAS;AAAA,YACd,KAAK,SAAS;AAAA,YACd,SAAS,UAAU,SAAS,OAAO;AAAA,YACnC,WAAW,SAAS;AAAA,UACtB;AACA,cAAI,SAAS,cAAc,QAAQ,MAAM,YAAY;AACnD,kBAAM,UAAU,MAAM,QAAQ,KAAK,WAAW,SAAS,UAAU;AACjE,mBAAO;AAAA,cACL,QAAQ,QAAQ;AAAA,cAChB,QAAQ;AAAA,cACR,UAAU;AAAA,cACV,YAAY,KAAK,IAAI,IAAI;AAAA,YAC3B;AAAA,UACF;AAEA,gBAAM,SAAS,OAAO,QAAQ,QAAQ,QAAQ,UAAU,IAAI,SAAS,UAAU;AAC/E,iBAAO;AAAA,YACL,QAAQ,OAAO,UAAU;AAAA,YACzB,QAAQ,OAAO,UAAU;AAAA,YACzB,UAAU,OAAO,YAAY;AAAA,YAC7B,YAAY,KAAK,IAAI,IAAI;AAAA,UAC3B;AAAA,QACF,SAAS,OAAO;AACd,gBAAM,IAAI,MAAM,0CAA0C,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC,EAAE;AAAA,QACpH;AAAA,MACF;AAAA,MAEA,SAAS,OAAO,YAA6D;AAC3E,YAAI,SAAS,QAAQ;AACrB,YAAI;AACF,mBAAU,MAAM,QAAQ,UAAU,IAAK,YAAY,QAAQ;AAAA,QAC7D,QAAQ;AACN,mBAAS,QAAQ;AAAA,QACnB;AAEA,eAAO;AAAA,UACL,IAAI,QAAQ,aAAa,QAAQ;AAAA,UACjC,UAAU;AAAA,UACV,QAAQ,WAAW,YAAY,YAAY,WAAW,UAAU,UAAU;AAAA,UAC1E,WAAW,oBAAI,KAAK;AAAA,UACpB,SAAS;AAAA,UACT,UAAU;AAAA,YACR,uBAAuB,QAAQ,aAAa,QAAQ;AAAA,YACpD,oBAAoB,QAAQ,QAAQ,gBAAgB;AAAA,YACpD,UAAU,eAAe,QAAQ,QAAQ;AAAA,UAC3C;AAAA,QACF;AAAA,MACF;AAAA,MAEA,QAAQ,OAAO,SAAoC,YAAkE;AACnH,cAAM,WAAW,QAAQ,YAAY;AACrC,cAAM,SAAS,QAAQ,iBAAiB,QAAQ,IAAI;AACpD,YAAI,QAAQ;AACV,iBAAO,GAAG,QAAQ,MAAM,MAAM;AAAA,QAChC;AAEA,cAAM,UAAU,MAAM,QAAQ,iBAAiB,EAAE,MAAM,QAAQ,KAAK,CAAC;AACrE,cAAM,WAAW,QAAQ,kBAAkB,QAAQ;AACnD,YAAI,CAAC,UAAU;AACb,gBAAM,IAAI,MAAM,2DAA2D,QAAQ,IAAI,GAAG;AAAA,QAC5F;AACA,eAAO,GAAG,QAAQ,MAAM,QAAQ;AAAA,MAClC;AAAA,MAEA,YAAY;AAAA,QACV,UAAU,OAAO,SAAoC,SACnD,QAAQ,MAAM,KAAK,IAAI;AAAA,QACzB,WAAW,OAAO,SAAoC,MAAc,YAAmC;AACrG,gBAAM,QAAQ,MAAM,MAAM,MAAM,OAAO;AAAA,QACzC;AAAA,QACA,OAAO,OAAO,SAAoC,SAAgC;AAChF,gBAAM,QAAQ,MAAM,QAAQ,IAAI;AAAA,QAClC;AAAA,QACA,SAAS,OAAO,SAAoC,SAAuC;AACzF,gBAAM,UAAU,MAAM,QAAQ,MAAM,KAAK,IAAI;AAC7C,iBAAO,QAAQ,IAAI,CAAC,WAAW;AAAA,YAC7B,MAAM,MAAM;AAAA,YACZ,MAAM,MAAM,QAAQ,cAAuB;AAAA,YAC3C,MAAM,MAAM;AAAA,YACZ,UAAU,oBAAI,KAAK;AAAA,UACrB,EAAE;AAAA,QACJ;AAAA,QACA,QAAQ,OAAO,SAAoC,SACjD,QAAQ,MAAM,OAAO,IAAI;AAAA,QAC3B,QAAQ,OAAO,SAAoC,SAAgC;AACjF,gBAAM,QAAQ,MAAM,OAAO,IAAI;AAAA,QACjC;AAAA,MACF;AAAA,MAEA,aAAa,CAAC,YAAkE;AAAA,IAClF;AAAA,IAEA,UAAU;AAAA,MACR,QAAQ,OAAO,QAA4B,WAAmB,YAAoC;AAChG,cAAM,UAAU,MAAM,YAAY;AAClC,cAAM,UAAU,MAAM,QAAQ,QAAQ,WAAW,SAAS,MAAM,CAAC;AACjE,cAAM,WAAW,SAAS;AAG1B,cAAM,OAAO,UAAU,QAAQ;AAC/B,cAAM,WAAW,MAAM,QAAQ,iBAAiB,SAAS,QAAQ,YAAY,KAAK,IAAI,CAAC,IAAI;AAAA,UACzF;AAAA,UACA,eAAe,UAAU,kBAAkB,SAAS,cAAc,OAAO;AAAA,UACzE,iBAAiB,UAAU;AAAA,QAC7B,CAAC;AACD,eAAO,kBAAkB,MAAM,uBAAuB,SAAS,QAAQ,CAAC;AAAA,MAC1E;AAAA,MACA,MAAM,OAAO,QAA4B,YAAmC;AAC1E,YAAI,CAAC,SAAS,WAAW;AACvB,gBAAM,IAAI,MAAM,qFAAqF;AAAA,QACvG;AACA,cAAM,UAAU,MAAM,YAAY;AAClC,cAAM,UAAU,MAAM,QAAQ,QAAQ,QAAQ,WAAW,SAAS,MAAM,CAAC;AACzE,cAAM,YAAY,MAAM,QAAQ,gBAAgB;AAChD,eAAO,UAAU,IAAI,iBAAiB;AAAA,MACxC;AAAA,MACA,QAAQ,OAAO,QAA4B,eAAuB;AAChE,cAAM,YAAY,WAAW,MAAM,KAAK,CAAC,EAAE,CAAC;AAC5C,YAAI,CAAC,aAAa,cAAc,YAAY;AAC1C,gBAAM,IAAI,MAAM,mGAAmG;AAAA,QACrH;AACA,cAAM,eAAe,WAAW,MAAM,UAAU,SAAS,CAAC;AAC1D,cAAM,UAAU,MAAM,YAAY;AAClC,cAAM,UAAU,MAAM,QAAQ,QAAQ,WAAW,SAAS,MAAM,CAAC;AACjE,cAAM,QAAQ,iBAAiB,YAAY;AAAA,MAC7C;AAAA,IACF;AAAA,EACF;AACF,CAAC;AAEM,IAAM,eAAe,CAAC,SAA6B,CAAC,MAAM,UAAU,MAAM;","names":["sandbox"]}

package/dist/index.mjs

@@ -0,0 +1,308 @@
+// src/index.ts
+import { defineProvider } from "@computesdk/provider";
+var _SandboxClass = null;
+async function loadSandbox() {
+  if (!_SandboxClass) {
+    const mod = await import("@opencomputer/sdk");
+    _SandboxClass = mod.Sandbox;
+  }
+  return _SandboxClass;
+}
+function env(name) {
+  return typeof process !== "undefined" ? process.env?.[name] : void 0;
+}
+function baseOpts(config) {
+  return {
+    apiKey: config.apiKey || env("OPENCOMPUTER_API_KEY"),
+    apiUrl: config.apiUrl || env("OPENCOMPUTER_API_URL")
+  };
+}
+function toSeconds(milliseconds) {
+  return milliseconds == null ? void 0 : Math.ceil(milliseconds / 1e3);
+}
+function stringifyMetadata(metadata) {
+  if (!metadata) return void 0;
+  const out = {};
+  for (const [key, value] of Object.entries(metadata)) {
+    if (value == null || typeof value === "function" || typeof value === "symbol") {
+      continue;
+    }
+    if (typeof value === "string") {
+      out[key] = value;
+      continue;
+    }
+    if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") {
+      out[key] = String(value);
+      continue;
+    }
+    try {
+      const serialized = JSON.stringify(value);
+      if (serialized !== void 0) {
+        out[key] = serialized;
+      }
+    } catch {
+    }
+  }
+  return out;
+}
+function redactWebhooks(webhooks) {
+  return webhooks?.map((webhook) => ({
+    id: webhook.id,
+    url: webhook.url,
+    hasSecret: typeof webhook.secret === "string" && webhook.secret.length > 0
+  }));
+}
+function createOpts(config, options) {
+  return {
+    ...baseOpts(config),
+    template: options?.templateId || config.template,
+    timeout: toSeconds(options?.timeout ?? config.timeout),
+    envs: { ...config.envs, ...options?.envs },
+    metadata: { ...config.metadata, ...stringifyMetadata(options?.metadata) },
+    cpuCount: options?.cpuCount ?? config.cpuCount,
+    memoryMB: options?.memoryMB ?? options?.memory ?? config.memoryMB,
+    diskMB: options?.diskMB ?? config.diskMB,
+    secretStore: options?.secretStore ?? config.secretStore,
+    burst: options?.burst ?? config.burst,
+    sandboxFamily: options?.sandboxFamily,
+    previewAuth: options?.previewAuth ?? config.previewAuth,
+    webhooks: options?.webhooks
+  };
+}
+function snapshotToCompute(snapshot) {
+  const id = snapshot.sandboxId ? `${snapshot.sandboxId}:${snapshot.id}` : snapshot.id;
+  return {
+    id,
+    provider: "opencomputer",
+    createdAt: snapshot.createdAt ? new Date(snapshot.createdAt) : /* @__PURE__ */ new Date(),
+    metadata: {
+      sandboxId: snapshot.sandboxId,
+      orgId: snapshot.orgId,
+      name: snapshot.name,
+      status: snapshot.status,
+      sizeBytes: snapshot.sizeBytes,
+      sandboxConfig: snapshot.sandboxConfig
+    }
+  };
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function waitForCheckpointReady(sandbox, checkpoint, timeoutMs = 3e5) {
+  if (checkpoint.status === "ready") return checkpoint;
+  if (checkpoint.status === "failed") {
+    throw new Error(`OpenComputer checkpoint ${checkpoint.id} failed.`);
+  }
+  const deadline = Date.now() + timeoutMs;
+  let delay = 1e3;
+  for (; ; ) {
+    if (Date.now() >= deadline) {
+      throw new Error(`OpenComputer checkpoint ${checkpoint.id} was not ready after ${timeoutMs}ms.`);
+    }
+    const checkpoints = await sandbox.listCheckpoints();
+    const current = checkpoints.find((candidate) => candidate.id === checkpoint.id);
+    if (!current) {
+      throw new Error(`OpenComputer checkpoint ${checkpoint.id} disappeared while waiting for readiness.`);
+    }
+    if (current.status === "ready") return current;
+    if (current.status === "failed") {
+      throw new Error(`OpenComputer checkpoint ${checkpoint.id} failed.`);
+    }
+    await sleep(delay);
+    delay = Math.min(delay * 1.5, 5e3);
+  }
+}
+function isCheckpointIndexMiss(error) {
+  if (!(error instanceof Error)) return false;
+  const message = error.message.toLowerCase();
+  return message.includes("404") && message.includes("checkpoint") && message.includes("not found");
+}
+async function createFromCheckpointWithRetry(Sandbox, checkpointId, opts, timeoutMs = 6e4) {
+  const deadline = Date.now() + timeoutMs;
+  let delay = 1e3;
+  for (; ; ) {
+    try {
+      return await Sandbox.createFromCheckpoint(checkpointId, opts);
+    } catch (error) {
+      if (!isCheckpointIndexMiss(error) || Date.now() >= deadline) {
+        throw error;
+      }
+      await sleep(delay);
+      delay = Math.min(delay * 1.5, 5e3);
+    }
+  }
+}
+async function createSandbox(config, options) {
+  const Sandbox = await loadSandbox();
+  const opts = createOpts(config, options);
+  if (options?.snapshotId) {
+    const checkpointId = options.snapshotId.includes(":") ? options.snapshotId.slice(options.snapshotId.indexOf(":") + 1) : options.snapshotId;
+    const sandbox2 = await createFromCheckpointWithRetry(Sandbox, checkpointId, {
+      ...baseOpts(config),
+      timeout: opts.timeout,
+      envs: opts.envs,
+      secretStore: opts.secretStore
+    });
+    return { sandbox: sandbox2, sandboxId: sandbox2.sandboxId || sandbox2.id };
+  }
+  const sandbox = await Sandbox.create(opts);
+  return { sandbox, sandboxId: sandbox.sandboxId || sandbox.id };
+}
+var _provider = defineProvider({
+  name: "opencomputer",
+  methods: {
+    sandbox: {
+      create: createSandbox,
+      getById: async (config, sandboxId) => {
+        const Sandbox = await loadSandbox();
+        try {
+          const sandbox = await Sandbox.connect(sandboxId, baseOpts(config));
+          return { sandbox, sandboxId: sandbox.sandboxId || sandbox.id || sandboxId };
+        } catch (error) {
+          if (error instanceof Error && (error.message.includes("404") || error.message.includes("not found"))) {
+            return null;
+          }
+          throw new Error(`Failed to get OpenComputer sandbox ${sandboxId}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+      },
+      list: async () => {
+        throw new Error("OpenComputer provider does not support listing sandboxes via the TypeScript SDK.");
+      },
+      destroy: async (config, sandboxId) => {
+        const Sandbox = await loadSandbox();
+        try {
+          const sandbox = await Sandbox.connect(sandboxId, baseOpts(config));
+          await sandbox.kill();
+        } catch (error) {
+          if (error instanceof Error && (error.message.includes("404") || error.message.includes("not found"))) {
+            return;
+          }
+          throw new Error(`Failed to destroy OpenComputer sandbox ${sandboxId}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+      },
+      runCommand: async (sandbox, command, options) => {
+        const startTime = Date.now();
+        try {
+          const runOptions = {
+            cwd: options?.cwd,
+            env: options?.env,
+            timeout: toSeconds(options?.timeout),
+            timeoutMs: options?.timeout
+          };
+          if (options?.background && sandbox.exec?.background) {
+            const session = await sandbox.exec.background(command, runOptions);
+            return {
+              stdout: session.sessionId,
+              stderr: "",
+              exitCode: 0,
+              durationMs: Date.now() - startTime
+            };
+          }
+          const result = await (sandbox.exec ?? sandbox.commands).run(command, runOptions);
+          return {
+            stdout: result.stdout || "",
+            stderr: result.stderr || "",
+            exitCode: result.exitCode ?? 0,
+            durationMs: Date.now() - startTime
+          };
+        } catch (error) {
+          throw new Error(`OpenComputer command execution failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+      },
+      getInfo: async (sandbox) => {
+        let status = sandbox.status;
+        try {
+          status = await sandbox.isRunning() ? "running" : sandbox.status;
+        } catch {
+          status = sandbox.status;
+        }
+        return {
+          id: sandbox.sandboxId || sandbox.id,
+          provider: "opencomputer",
+          status: status === "running" ? "running" : status === "error" ? "error" : "stopped",
+          createdAt: /* @__PURE__ */ new Date(),
+          timeout: 0,
+          metadata: {
+            opencomputerSandboxId: sandbox.sandboxId || sandbox.id,
+            previewAuthEnabled: Boolean(sandbox.previewAuthToken),
+            webhooks: redactWebhooks(sandbox.webhooks)
+          }
+        };
+      },
+      getUrl: async (sandbox, options) => {
+        const protocol = options.protocol || "https";
+        const domain = sandbox.getPreviewDomain(options.port);
+        if (domain) {
+          return `${protocol}://${domain}`;
+        }
+        const preview = await sandbox.createPreviewURL({ port: options.port });
+        const hostname = preview.customHostname || preview.hostname;
+        if (!hostname) {
+          throw new Error(`OpenComputer did not return a preview hostname for port ${options.port}.`);
+        }
+        return `${protocol}://${hostname}`;
+      },
+      filesystem: {
+        readFile: async (sandbox, path) => sandbox.files.read(path),
+        writeFile: async (sandbox, path, content) => {
+          await sandbox.files.write(path, content);
+        },
+        mkdir: async (sandbox, path) => {
+          await sandbox.files.makeDir(path);
+        },
+        readdir: async (sandbox, path) => {
+          const entries = await sandbox.files.list(path);
+          return entries.map((entry) => ({
+            name: entry.name,
+            type: entry.isDir ? "directory" : "file",
+            size: entry.size,
+            modified: /* @__PURE__ */ new Date()
+          }));
+        },
+        exists: async (sandbox, path) => sandbox.files.exists(path),
+        remove: async (sandbox, path) => {
+          await sandbox.files.remove(path);
+        }
+      },
+      getInstance: (sandbox) => sandbox
+    },
+    snapshot: {
+      create: async (config, sandboxId, options) => {
+        const Sandbox = await loadSandbox();
+        const sandbox = await Sandbox.connect(sandboxId, baseOpts(config));
+        const metadata = options?.metadata;
+        const kind = metadata?.kind ?? "disk_only";
+        const snapshot = await sandbox.createCheckpoint(options?.name || `snapshot-${Date.now()}`, {
+          kind,
+          promoteToFull: metadata?.promoteToFull ?? (kind === "disk_only" ? true : void 0),
+          retentionPolicy: metadata?.retentionPolicy
+        });
+        return snapshotToCompute(await waitForCheckpointReady(sandbox, snapshot));
+      },
+      list: async (config, options) => {
+        if (!options?.sandboxId) {
+          throw new Error("OpenComputer snapshots are scoped to a sandbox. Pass `sandboxId` to list snapshots.");
+        }
+        const Sandbox = await loadSandbox();
+        const sandbox = await Sandbox.connect(options.sandboxId, baseOpts(config));
+        const snapshots = await sandbox.listCheckpoints();
+        return snapshots.map(snapshotToCompute);
+      },
+      delete: async (config, snapshotId) => {
+        const sandboxId = snapshotId.split(":", 1)[0];
+        if (!sandboxId || sandboxId === snapshotId) {
+          throw new Error("OpenComputer snapshot deletion requires a sandbox-scoped id in the form `sandboxId:checkpointId`.");
+        }
+        const checkpointId = snapshotId.slice(sandboxId.length + 1);
+        const Sandbox = await loadSandbox();
+        const sandbox = await Sandbox.connect(sandboxId, baseOpts(config));
+        await sandbox.deleteCheckpoint(checkpointId);
+      }
+    }
+  }
+});
+var opencomputer = (config = {}) => _provider(config);
+export {
+  opencomputer
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * OpenComputer Provider - Factory-based Implementation\n *\n * Wraps the official `@opencomputer/sdk` so OpenComputer sandboxes can be used\n * through the ComputeSDK provider interface.\n */\n\nimport { defineProvider } from '@computesdk/provider';\n\nimport type {\n  CommandResult,\n  CreateSandboxOptions,\n  CreateSnapshotOptions,\n  FileEntry,\n  ListSnapshotsOptions,\n  RunCommandOptions,\n  SandboxInfo,\n} from '@computesdk/provider';\n\ninterface OpenComputerSandboxOpts {\n  template?: string;\n  timeout?: number;\n  apiKey?: string;\n  apiUrl?: string;\n  envs?: Record<string, string>;\n  metadata?: Record<string, string>;\n  cpuCount?: number;\n  memoryMB?: number;\n  diskMB?: number;\n  secretStore?: string;\n  snapshot?: string;\n  burst?: boolean;\n  sandboxFamily?: 'spot';\n  previewAuth?: { scheme?: 'bearer'; token?: 'auto' | string };\n  webhooks?: Array<{ url: string; secret?: string; eventTypes?: string[] }>;\n}\n\ninterface OpenComputerProcessResult {\n  stdout?: string;\n  stderr?: string;\n  exitCode?: number;\n}\n\ninterface OpenComputerExecSession {\n  sessionId: string;\n}\n\ninterface OpenComputerEntryInfo {\n  name: string;\n  isDir: boolean;\n  path: string;\n  size: number;\n}\n\ninterface OpenComputerCheckpointInfo {\n  id: string;\n  sandboxId?: string;\n  orgId?: string;\n  name?: string;\n  status?: string;\n  sizeBytes?: number;\n  createdAt?: string;\n  sandboxConfig?: Record<string, unknown>;\n}\n\ninterface OpenComputerPreviewURLResult {\n  hostname?: string;\n  customHostname?: string;\n  port: number;\n}\n\ninterface OpenComputerNativeSandbox {\n  readonly sandboxId: string;\n  readonly id: string;\n  readonly status: string;\n  readonly previewAuthToken?: string;\n  readonly webhooks?: Array<{ id: string; url: string; secret?: string }>;\n  readonly commands: {\n    run(command: string, opts?: { cwd?: string; env?: Record<string, string>; timeout?: number; timeoutMs?: number }): Promise<OpenComputerProcessResult>;\n  };\n  readonly exec?: {\n    run(command: string, opts?: { cwd?: string; env?: Record<string, string>; timeout?: number; timeoutMs?: number }): Promise<OpenComputerProcessResult>;\n    background?(command: string, opts?: { cwd?: string; env?: Record<string, string>; timeout?: number; timeoutMs?: number }): Promise<OpenComputerExecSession>;\n  };\n  readonly files: {\n    read(path: string): Promise<string>;\n    write(path: string, content: string): Promise<void>;\n    makeDir(path: string): Promise<void>;\n    list(path?: string): Promise<OpenComputerEntryInfo[]>;\n    exists(path: string): Promise<boolean>;\n    remove(path: string): Promise<void>;\n  };\n  getPreviewDomain(port: number): string;\n  createPreviewURL(opts: { port: number; domain?: string; authConfig?: Record<string, unknown> }): Promise<OpenComputerPreviewURLResult>;\n  listPreviewURLs(): Promise<OpenComputerPreviewURLResult[]>;\n  kill(): Promise<void>;\n  isRunning(): Promise<boolean>;\n  createCheckpoint(name: string, opts?: { kind?: 'full' | 'disk_only'; promoteToFull?: boolean; retentionPolicy?: unknown }): Promise<OpenComputerCheckpointInfo>;\n  listCheckpoints(): Promise<OpenComputerCheckpointInfo[]>;\n  deleteCheckpoint(checkpointId: string): Promise<void>;\n}\n\ninterface OpenComputerSandboxStatic {\n  create(opts?: OpenComputerSandboxOpts): Promise<OpenComputerNativeSandbox>;\n  connect(sandboxId: string, opts?: Pick<OpenComputerSandboxOpts, 'apiKey' | 'apiUrl'>): Promise<OpenComputerNativeSandbox>;\n  createFromCheckpoint(checkpointId: string, opts?: Pick<OpenComputerSandboxOpts, 'apiKey' | 'apiUrl' | 'timeout' | 'envs' | 'secretStore'>): Promise<OpenComputerNativeSandbox>;\n}\n\nlet _SandboxClass: OpenComputerSandboxStatic | null = null;\n\nasync function loadSandbox(): Promise<OpenComputerSandboxStatic> {\n  if (!_SandboxClass) {\n    const mod = await import('@opencomputer/sdk');\n    _SandboxClass = (mod as { Sandbox: OpenComputerSandboxStatic }).Sandbox;\n  }\n  return _SandboxClass;\n}\n\nexport interface OpenComputerConfig {\n  /** OpenComputer API key - falls back to OPENCOMPUTER_API_KEY. */\n  apiKey?: string;\n  /** OpenComputer API URL - falls back to OPENCOMPUTER_API_URL, then production. */\n  apiUrl?: string;\n  /** Default template for new sandboxes. Defaults to OpenComputer's `base` template. */\n  template?: string;\n  /** Default idle timeout in milliseconds. OpenComputer receives this as seconds. */\n  timeout?: number;\n  /** Default environment variables for new sandboxes. */\n  envs?: Record<string, string>;\n  /** Default metadata for new sandboxes. */\n  metadata?: Record<string, string>;\n  /** OpenComputer CPU count for new sandboxes. */\n  cpuCount?: number;\n  /** OpenComputer memory size in MB for new sandboxes. */\n  memoryMB?: number;\n  /** OpenComputer workspace disk size in MB for new sandboxes. */\n  diskMB?: number;\n  /** Secret store to attach to new sandboxes. */\n  secretStore?: string;\n  /** Create Burst sandboxes by default. */\n  burst?: boolean;\n  /** Require bearer auth on preview URLs. */\n  previewAuth?: { scheme?: 'bearer'; token?: 'auto' | string };\n}\n\nexport interface OpenComputerSnapshot {\n  id: string;\n  provider: 'opencomputer';\n  createdAt: Date;\n  metadata: {\n    sandboxId?: string;\n    orgId?: string;\n    name?: string;\n    status?: string;\n    sizeBytes?: number;\n    sandboxConfig?: Record<string, unknown>;\n  };\n}\n\nfunction env(name: string): string | undefined {\n  return typeof process !== 'undefined' ? process.env?.[name] : undefined;\n}\n\nfunction baseOpts(config: OpenComputerConfig): Pick<OpenComputerSandboxOpts, 'apiKey' | 'apiUrl'> {\n  return {\n    apiKey: config.apiKey || env('OPENCOMPUTER_API_KEY'),\n    apiUrl: config.apiUrl || env('OPENCOMPUTER_API_URL'),\n  };\n}\n\nfunction toSeconds(milliseconds: number | undefined): number | undefined {\n  return milliseconds == null ? undefined : Math.ceil(milliseconds / 1000);\n}\n\nfunction stringifyMetadata(metadata: Record<string, unknown> | undefined): Record<string, string> | undefined {\n  if (!metadata) return undefined;\n  const out: Record<string, string> = {};\n  for (const [key, value] of Object.entries(metadata)) {\n    if (value == null || typeof value === 'function' || typeof value === 'symbol') {\n      continue;\n    }\n    if (typeof value === 'string') {\n      out[key] = value;\n      continue;\n    }\n    if (typeof value === 'number' || typeof value === 'boolean' || typeof value === 'bigint') {\n      out[key] = String(value);\n      continue;\n    }\n    try {\n      const serialized = JSON.stringify(value);\n      if (serialized !== undefined) {\n        out[key] = serialized;\n      }\n    } catch {\n      // Skip metadata values that cannot be represented as JSON strings.\n    }\n  }\n  return out;\n}\n\nfunction redactWebhooks(webhooks: OpenComputerNativeSandbox['webhooks']): Array<{ id: string; url: string; hasSecret: boolean }> | undefined {\n  return webhooks?.map((webhook) => ({\n    id: webhook.id,\n    url: webhook.url,\n    hasSecret: typeof webhook.secret === 'string' && webhook.secret.length > 0,\n  }));\n}\n\nfunction createOpts(config: OpenComputerConfig, options?: CreateSandboxOptions): OpenComputerSandboxOpts {\n  return {\n    ...baseOpts(config),\n    template: options?.templateId || config.template,\n    timeout: toSeconds(options?.timeout ?? config.timeout),\n    envs: { ...config.envs, ...options?.envs },\n    metadata: { ...config.metadata, ...stringifyMetadata(options?.metadata) },\n    cpuCount: (options as any)?.cpuCount ?? config.cpuCount,\n    memoryMB: (options as any)?.memoryMB ?? (options as any)?.memory ?? config.memoryMB,\n    diskMB: (options as any)?.diskMB ?? config.diskMB,\n    secretStore: (options as any)?.secretStore ?? config.secretStore,\n    burst: (options as any)?.burst ?? config.burst,\n    sandboxFamily: (options as any)?.sandboxFamily,\n    previewAuth: (options as any)?.previewAuth ?? config.previewAuth,\n    webhooks: (options as any)?.webhooks,\n  };\n}\n\nfunction snapshotToCompute(snapshot: OpenComputerCheckpointInfo): OpenComputerSnapshot {\n  const id = snapshot.sandboxId ? `${snapshot.sandboxId}:${snapshot.id}` : snapshot.id;\n  return {\n    id,\n    provider: 'opencomputer',\n    createdAt: snapshot.createdAt ? new Date(snapshot.createdAt) : new Date(),\n    metadata: {\n      sandboxId: snapshot.sandboxId,\n      orgId: snapshot.orgId,\n      name: snapshot.name,\n      status: snapshot.status,\n      sizeBytes: snapshot.sizeBytes,\n      sandboxConfig: snapshot.sandboxConfig,\n    },\n  };\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nasync function waitForCheckpointReady(\n  sandbox: OpenComputerNativeSandbox,\n  checkpoint: OpenComputerCheckpointInfo,\n  timeoutMs = 300_000,\n): Promise<OpenComputerCheckpointInfo> {\n  if (checkpoint.status === 'ready') return checkpoint;\n  if (checkpoint.status === 'failed') {\n    throw new Error(`OpenComputer checkpoint ${checkpoint.id} failed.`);\n  }\n\n  const deadline = Date.now() + timeoutMs;\n  let delay = 1_000;\n\n  for (;;) {\n    if (Date.now() >= deadline) {\n      throw new Error(`OpenComputer checkpoint ${checkpoint.id} was not ready after ${timeoutMs}ms.`);\n    }\n\n    const checkpoints = await sandbox.listCheckpoints();\n    const current = checkpoints.find((candidate) => candidate.id === checkpoint.id);\n    if (!current) {\n      throw new Error(`OpenComputer checkpoint ${checkpoint.id} disappeared while waiting for readiness.`);\n    }\n    if (current.status === 'ready') return current;\n    if (current.status === 'failed') {\n      throw new Error(`OpenComputer checkpoint ${checkpoint.id} failed.`);\n    }\n\n    await sleep(delay);\n    delay = Math.min(delay * 1.5, 5_000);\n  }\n}\n\nfunction isCheckpointIndexMiss(error: unknown): boolean {\n  if (!(error instanceof Error)) return false;\n  const message = error.message.toLowerCase();\n  return message.includes('404') && message.includes('checkpoint') && message.includes('not found');\n}\n\nasync function createFromCheckpointWithRetry(\n  Sandbox: OpenComputerSandboxStatic,\n  checkpointId: string,\n  opts: Pick<OpenComputerSandboxOpts, 'apiKey' | 'apiUrl' | 'timeout' | 'envs' | 'secretStore'>,\n  timeoutMs = 60_000,\n): Promise<OpenComputerNativeSandbox> {\n  const deadline = Date.now() + timeoutMs;\n  let delay = 1_000;\n\n  for (;;) {\n    try {\n      return await Sandbox.createFromCheckpoint(checkpointId, opts);\n    } catch (error) {\n      if (!isCheckpointIndexMiss(error) || Date.now() >= deadline) {\n        throw error;\n      }\n      await sleep(delay);\n      delay = Math.min(delay * 1.5, 5_000);\n    }\n  }\n}\n\nasync function createSandbox(config: OpenComputerConfig, options?: CreateSandboxOptions) {\n  const Sandbox = await loadSandbox();\n  const opts = createOpts(config, options);\n\n  if (options?.snapshotId) {\n    const checkpointId = options.snapshotId.includes(':')\n      ? options.snapshotId.slice(options.snapshotId.indexOf(':') + 1)\n      : options.snapshotId;\n    const sandbox = await createFromCheckpointWithRetry(Sandbox, checkpointId, {\n      ...baseOpts(config),\n      timeout: opts.timeout,\n      envs: opts.envs,\n      secretStore: opts.secretStore,\n    });\n    return { sandbox, sandboxId: sandbox.sandboxId || sandbox.id };\n  }\n\n  const sandbox = await Sandbox.create(opts);\n  return { sandbox, sandboxId: sandbox.sandboxId || sandbox.id };\n}\n\nconst _provider = defineProvider<OpenComputerNativeSandbox, OpenComputerConfig, any, OpenComputerSnapshot>({\n  name: 'opencomputer',\n  methods: {\n    sandbox: {\n      create: createSandbox,\n\n      getById: async (config: OpenComputerConfig, sandboxId: string) => {\n        const Sandbox = await loadSandbox();\n        try {\n          const sandbox = await Sandbox.connect(sandboxId, baseOpts(config));\n          return { sandbox, sandboxId: sandbox.sandboxId || sandbox.id || sandboxId };\n        } catch (error) {\n          if (error instanceof Error && (error.message.includes('404') || error.message.includes('not found'))) {\n            return null;\n          }\n          throw new Error(`Failed to get OpenComputer sandbox ${sandboxId}: ${error instanceof Error ? error.message : String(error)}`);\n        }\n      },\n\n      list: async () => {\n        throw new Error('OpenComputer provider does not support listing sandboxes via the TypeScript SDK.');\n      },\n\n      destroy: async (config: OpenComputerConfig, sandboxId: string) => {\n        const Sandbox = await loadSandbox();\n        try {\n          const sandbox = await Sandbox.connect(sandboxId, baseOpts(config));\n          await sandbox.kill();\n        } catch (error) {\n          if (error instanceof Error && (error.message.includes('404') || error.message.includes('not found'))) {\n            return;\n          }\n          throw new Error(`Failed to destroy OpenComputer sandbox ${sandboxId}: ${error instanceof Error ? error.message : String(error)}`);\n        }\n      },\n\n      runCommand: async (sandbox: OpenComputerNativeSandbox, command: string, options?: RunCommandOptions): Promise<CommandResult> => {\n        const startTime = Date.now();\n        try {\n          const runOptions = {\n            cwd: options?.cwd,\n            env: options?.env,\n            timeout: toSeconds(options?.timeout),\n            timeoutMs: options?.timeout,\n          };\n          if (options?.background && sandbox.exec?.background) {\n            const session = await sandbox.exec.background(command, runOptions);\n            return {\n              stdout: session.sessionId,\n              stderr: '',\n              exitCode: 0,\n              durationMs: Date.now() - startTime,\n            };\n          }\n\n          const result = await (sandbox.exec ?? sandbox.commands).run(command, runOptions);\n          return {\n            stdout: result.stdout || '',\n            stderr: result.stderr || '',\n            exitCode: result.exitCode ?? 0,\n            durationMs: Date.now() - startTime,\n          };\n        } catch (error) {\n          throw new Error(`OpenComputer command execution failed: ${error instanceof Error ? error.message : String(error)}`);\n        }\n      },\n\n      getInfo: async (sandbox: OpenComputerNativeSandbox): Promise<SandboxInfo> => {\n        let status = sandbox.status;\n        try {\n          status = (await sandbox.isRunning()) ? 'running' : sandbox.status;\n        } catch {\n          status = sandbox.status;\n        }\n\n        return {\n          id: sandbox.sandboxId || sandbox.id,\n          provider: 'opencomputer',\n          status: status === 'running' ? 'running' : status === 'error' ? 'error' : 'stopped',\n          createdAt: new Date(),\n          timeout: 0,\n          metadata: {\n            opencomputerSandboxId: sandbox.sandboxId || sandbox.id,\n            previewAuthEnabled: Boolean(sandbox.previewAuthToken),\n            webhooks: redactWebhooks(sandbox.webhooks),\n          },\n        };\n      },\n\n      getUrl: async (sandbox: OpenComputerNativeSandbox, options: { port: number; protocol?: string }): Promise<string> => {\n        const protocol = options.protocol || 'https';\n        const domain = sandbox.getPreviewDomain(options.port);\n        if (domain) {\n          return `${protocol}://${domain}`;\n        }\n\n        const preview = await sandbox.createPreviewURL({ port: options.port });\n        const hostname = preview.customHostname || preview.hostname;\n        if (!hostname) {\n          throw new Error(`OpenComputer did not return a preview hostname for port ${options.port}.`);\n        }\n        return `${protocol}://${hostname}`;\n      },\n\n      filesystem: {\n        readFile: async (sandbox: OpenComputerNativeSandbox, path: string): Promise<string> =>\n          sandbox.files.read(path),\n        writeFile: async (sandbox: OpenComputerNativeSandbox, path: string, content: string): Promise<void> => {\n          await sandbox.files.write(path, content);\n        },\n        mkdir: async (sandbox: OpenComputerNativeSandbox, path: string): Promise<void> => {\n          await sandbox.files.makeDir(path);\n        },\n        readdir: async (sandbox: OpenComputerNativeSandbox, path: string): Promise<FileEntry[]> => {\n          const entries = await sandbox.files.list(path);\n          return entries.map((entry) => ({\n            name: entry.name,\n            type: entry.isDir ? 'directory' as const : 'file' as const,\n            size: entry.size,\n            modified: new Date(),\n          }));\n        },\n        exists: async (sandbox: OpenComputerNativeSandbox, path: string): Promise<boolean> =>\n          sandbox.files.exists(path),\n        remove: async (sandbox: OpenComputerNativeSandbox, path: string): Promise<void> => {\n          await sandbox.files.remove(path);\n        },\n      },\n\n      getInstance: (sandbox: OpenComputerNativeSandbox): OpenComputerNativeSandbox => sandbox,\n    },\n\n    snapshot: {\n      create: async (config: OpenComputerConfig, sandboxId: string, options?: CreateSnapshotOptions) => {\n        const Sandbox = await loadSandbox();\n        const sandbox = await Sandbox.connect(sandboxId, baseOpts(config));\n        const metadata = options?.metadata as\n          | { kind?: 'full' | 'disk_only'; promoteToFull?: boolean; retentionPolicy?: unknown }\n          | undefined;\n        const kind = metadata?.kind ?? 'disk_only';\n        const snapshot = await sandbox.createCheckpoint(options?.name || `snapshot-${Date.now()}`, {\n          kind,\n          promoteToFull: metadata?.promoteToFull ?? (kind === 'disk_only' ? true : undefined),\n          retentionPolicy: metadata?.retentionPolicy,\n        });\n        return snapshotToCompute(await waitForCheckpointReady(sandbox, snapshot));\n      },\n      list: async (config: OpenComputerConfig, options?: ListSnapshotsOptions) => {\n        if (!options?.sandboxId) {\n          throw new Error('OpenComputer snapshots are scoped to a sandbox. Pass `sandboxId` to list snapshots.');\n        }\n        const Sandbox = await loadSandbox();\n        const sandbox = await Sandbox.connect(options.sandboxId, baseOpts(config));\n        const snapshots = await sandbox.listCheckpoints();\n        return snapshots.map(snapshotToCompute);\n      },\n      delete: async (config: OpenComputerConfig, snapshotId: string) => {\n        const sandboxId = snapshotId.split(':', 1)[0];\n        if (!sandboxId || sandboxId === snapshotId) {\n          throw new Error('OpenComputer snapshot deletion requires a sandbox-scoped id in the form `sandboxId:checkpointId`.');\n        }\n        const checkpointId = snapshotId.slice(sandboxId.length + 1);\n        const Sandbox = await loadSandbox();\n        const sandbox = await Sandbox.connect(sandboxId, baseOpts(config));\n        await sandbox.deleteCheckpoint(checkpointId);\n      },\n    },\n  },\n});\n\nexport const opencomputer = (config: OpenComputerConfig = {}) => _provider(config);\nexport type { OpenComputerNativeSandbox };\n"],"mappings":"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","names":["sandbox"]}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@computesdk/opencomputer",
+  "version": "1.0.1",
+  "description": "OpenComputer provider for ComputeSDK - persistent cloud VMs with checkpoints, preview URLs, command execution, and filesystem access",
+  "author": "ComputeSDK",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "computesdk",
+    "opencomputer",
+    "sandbox",
+    "checkpoint",
+    "code-execution",
+    "cloud",
+    "compute",
+    "provider"
+  ],
+  "dependencies": {
+    "@opencomputer/sdk": "^0.12.4",
+    "@computesdk/provider": "2.1.4",
+    "computesdk": "4.1.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@vitest/coverage-v8": "^1.0.0",
+    "eslint": "^8.37.0",
+    "rimraf": "^5.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0",
+    "@computesdk/test-utils": "2.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/computesdk/computesdk.git",
+    "directory": "packages/opencomputer"
+  },
+  "homepage": "https://www.computesdk.com",
+  "bugs": {
+    "url": "https://github.com/computesdk/computesdk/issues"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "rimraf dist",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint"
+  }
+}