@celestoai/sdk 0.1.0 → 0.1.1

package/README.md

@@ -1,6 +1,9 @@
-# Celesto SDK (Gatekeeper)
+# @celestoai/sdk
 
-Node-only TypeScript SDK for Celesto's Gatekeeper API (`/v1/gatekeeper`).
+Node-only TypeScript SDK for the [Celesto](https://celesto.ai) platform. Covers:
+
+- **Computers** (`/v1/computers`) — create, manage, and interact with sandboxed virtual machines
+- **Gatekeeper** (`/v1/gatekeeper`) — delegated access to user resources
 
 ## Install
 
@@ -8,16 +11,71 @@ Node-only TypeScript SDK for Celesto's Gatekeeper API (`/v1/gatekeeper`).
 npm install @celestoai/sdk
 ```
 
-## Usage
+## Quickstart
 
 ```ts
-import { GatekeeperClient } from "@celestoai/sdk/gatekeeper";
+import { Celesto } from "@celestoai/sdk";
 
-const client = new GatekeeperClient({
-  baseUrl: "https://api.celesto.ai",
-  token: process.env.CELESTO_API_KEY
+const celesto = new Celesto({
+  token: process.env.CELESTO_API_KEY,
+  // organizationId: "org_123", // optional, for JWTs with multiple orgs
 });
 
+// Computers
+const computer = await celesto.computers.create({ cpus: 2, memory: 2048 });
+const result = await celesto.computers.exec(computer.id, "uname -a");
+console.log(result.stdout);
+await celesto.computers.delete(computer.id);
+```
+
+## Computers
+
+### Lifecycle
+
+```ts
+const computer = await celesto.computers.create({
+  cpus: 2,
+  memory: 2048,
+  image: "ubuntu-desktop-24.04",
+});
+
+await celesto.computers.stop(computer.id);
+await celesto.computers.start(computer.id);
+await celesto.computers.delete(computer.id);
+
+const { computers, count } = await celesto.computers.list();
+```
+
+### Running commands
+
+```ts
+const result = await celesto.computers.exec(computer.id, "ls -la", { timeout: 60 });
+console.log(result.exitCode, result.stdout, result.stderr);
+```
+
+### Terminal connection
+
+`getTerminalConnection()` resolves a computer name or ID and returns everything you need
+to open a WebSocket terminal with any library of your choice. No built-in WebSocket
+dependency — bring your own.
+
+```ts
+const conn = await celesto.computers.getTerminalConnection("my-computer");
+
+// Use any WebSocket library (ws, Node 22+ built-in, etc.)
+import WebSocket from "ws";
+const ws = new WebSocket(conn.url, { headers: conn.headers });
+ws.on("open", () => ws.send(conn.firstMessage));
+ws.on("message", (data) => process.stdout.write(data));
+```
+
+## Gatekeeper
+
+```ts
+import { GatekeeperClient } from "@celestoai/sdk/gatekeeper";
+
+const client = new GatekeeperClient({ token: process.env.CELESTO_API_KEY });
+
 const connect = await client.connect({
   subject: "customer_123",
   provider: "google_drive",
@@ -29,26 +87,14 @@ if (connect.status === "redirect") {
 }
 ```
 
-## Gatekeeper API coverage
-
-- `connect`
-- `listConnections`
-- `getConnection`
-- `revokeConnection`
-- `listDriveFiles`
-- `getAccessRules`
-- `updateAccessRules`
-- `clearAccessRules`
+Full docs: https://docs.celesto.ai/celesto-sdk/gatekeeper
 
 ## Notes
 
 - `token` accepts either a Celesto API key or a JWT.
 - `organizationId` adds the `X-Current-Organization` header.
-- Requires Node 18+ for built-in `fetch`.
+- Requires Node 18+ for built-in `fetch`. Zero runtime dependencies.
 
 ## License
 
-Apache-2.0. The SDK is open source; use of the Celesto platform is governed by the Celesto Terms of Service:
-```
-https://celesto.ai/legal/terms
-```
+Apache-2.0. The SDK is open source; use of the Celesto platform is governed by the Celesto Terms of Service: https://celesto.ai/legal/terms

package/dist/chunk-4KVRJSVJ.js

@@ -0,0 +1,177 @@
+import {
+  buildRequestContext,
+  request
+} from "./chunk-N3HU6ONW.js";
+
+// src/gatekeeper/client.ts
+var toConnectRequest = (payload) => ({
+  subject: payload.subject,
+  provider: payload.provider ?? "google_drive",
+  project_name: payload.projectName,
+  redirect_uri: payload.redirectUri
+});
+var toConnectResponse = (payload) => ({
+  status: payload.status,
+  oauthUrl: payload.oauth_url ?? void 0,
+  connectionId: payload.connection_id ?? void 0
+});
+var toConnection = (payload) => ({
+  id: payload.id,
+  subject: payload.subject,
+  provider: payload.provider,
+  projectId: payload.project_id,
+  accountEmail: payload.account_email ?? null,
+  scopes: payload.scopes ?? [],
+  status: payload.status,
+  createdAt: payload.created_at,
+  updatedAt: payload.updated_at,
+  lastUsedAt: payload.last_used_at ?? null,
+  accessRules: payload.access_rules ? {
+    version: payload.access_rules.version ?? "1",
+    allowedFolders: payload.access_rules.allowed_folders ?? [],
+    allowedFiles: payload.access_rules.allowed_files ?? [],
+    unrestricted: false
+  } : null
+});
+var toAccessRules = (payload) => ({
+  version: payload.version,
+  allowedFolders: payload.allowed_folders ?? [],
+  allowedFiles: payload.allowed_files ?? [],
+  unrestricted: payload.unrestricted
+});
+var toDriveFile = (payload) => ({
+  id: payload.id,
+  name: payload.name ?? null,
+  mimeType: payload.mime_type ?? null,
+  size: payload.size ?? null,
+  modifiedTime: payload.modified_time ?? null,
+  createdTime: payload.created_time ?? null,
+  webViewLink: payload.web_view_link ?? null,
+  iconLink: payload.icon_link ?? null,
+  thumbnailLink: payload.thumbnail_link ?? null,
+  parents: payload.parents ?? null,
+  driveId: payload.drive_id ?? null,
+  shared: payload.shared ?? null,
+  ownedByMe: payload.owned_by_me ?? null
+});
+var gatekeeperPath = (path) => `/v1/gatekeeper${path}`;
+var pickOverrides = (options) => ({
+  headers: options?.headers,
+  signal: options?.signal
+});
+var GatekeeperClient = class {
+  constructor(config) {
+    this.config = config;
+  }
+  async connect(payload, options) {
+    const ctx = buildRequestContext(this.config);
+    const data = await request(ctx, {
+      method: "POST",
+      path: gatekeeperPath("/connect"),
+      body: toConnectRequest(payload),
+      ...pickOverrides(options)
+    });
+    return toConnectResponse(data);
+  }
+  async listConnections(params, options) {
+    const ctx = buildRequestContext(this.config);
+    const data = await request(ctx, {
+      method: "GET",
+      path: gatekeeperPath("/connections"),
+      query: {
+        project_name: params.projectName,
+        status_filter: params.statusFilter
+      },
+      ...pickOverrides(options)
+    });
+    return {
+      total: data.total,
+      data: data.data.map(toConnection)
+    };
+  }
+  async getConnection(connectionId, options) {
+    const ctx = buildRequestContext(this.config);
+    const data = await request(ctx, {
+      method: "GET",
+      path: gatekeeperPath(`/connections/${connectionId}`),
+      ...pickOverrides(options)
+    });
+    return toConnection(data);
+  }
+  async revokeConnection(params, options) {
+    const ctx = buildRequestContext(this.config);
+    return request(ctx, {
+      method: "DELETE",
+      path: gatekeeperPath("/connections"),
+      query: {
+        subject: params.subject,
+        project_name: params.projectName,
+        provider: params.provider
+      },
+      ...pickOverrides(options)
+    });
+  }
+  async listDriveFiles(params, options) {
+    const ctx = buildRequestContext(this.config);
+    const data = await request(ctx, {
+      method: "GET",
+      path: gatekeeperPath("/connectors/drive/files"),
+      query: {
+        project_name: params.projectName,
+        subject: params.subject,
+        page_size: params.pageSize,
+        page_token: params.pageToken,
+        folder_id: params.folderId,
+        query: params.query,
+        include_folders: params.includeFolders,
+        order_by: params.orderBy
+      },
+      ...pickOverrides(options)
+    });
+    return {
+      files: data.files.map(toDriveFile),
+      nextPageToken: data.next_page_token ?? null
+    };
+  }
+  async getAccessRules(connectionId, options) {
+    const ctx = buildRequestContext(this.config);
+    const data = await request(ctx, {
+      method: "GET",
+      path: gatekeeperPath(`/connections/${connectionId}/access-rules`),
+      ...pickOverrides(options)
+    });
+    return toAccessRules(data);
+  }
+  async updateAccessRules(params, options) {
+    const ctx = buildRequestContext(this.config);
+    const data = await request(ctx, {
+      method: "PUT",
+      path: gatekeeperPath("/connections/access-rules"),
+      query: {
+        subject: params.subject,
+        project_name: params.projectName,
+        provider: params.provider
+      },
+      body: {
+        allowed_folders: params.accessRules.allowedFolders ?? [],
+        allowed_files: params.accessRules.allowedFiles ?? []
+      },
+      ...pickOverrides(options)
+    });
+    return toAccessRules(data);
+  }
+  async clearAccessRules(connectionId, options) {
+    const ctx = buildRequestContext(this.config);
+    const data = await request(ctx, {
+      method: "DELETE",
+      path: gatekeeperPath(`/connections/${connectionId}/access-rules`),
+      ...pickOverrides(options)
+    });
+    return toAccessRules(data);
+  }
+};
+
+export {
+  GatekeeperClient
+};
+//# sourceMappingURL=chunk-4KVRJSVJ.js.map

package/dist/chunk-4KVRJSVJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/gatekeeper/client.ts"],"sourcesContent":["import { buildRequestContext, ClientConfig, RequestOverrides } from \"../core/config\";\nimport { request } from \"../core/http\";\nimport {\n  GatekeeperAccessRules,\n  GatekeeperAccessRulesParams,\n  GatekeeperConnectRequest,\n  GatekeeperConnectResponse,\n  GatekeeperConnection,\n  GatekeeperDriveFile,\n  GatekeeperDriveListParams,\n  GatekeeperDriveListResponse,\n  GatekeeperListConnectionsParams,\n  GatekeeperListConnectionsResponse,\n  GatekeeperRevokeParams,\n  GatekeeperRevokeResponse,\n} from \"./types\";\n\ninterface GatekeeperConnectRequestWire {\n  subject: string;\n  provider: string;\n  project_name: string;\n  redirect_uri?: string;\n}\n\ninterface GatekeeperConnectResponseWire {\n  status: string;\n  oauth_url?: string | null;\n  connection_id?: string | null;\n}\n\ninterface GatekeeperConnectionWire {\n  id: string;\n  subject: string;\n  provider: string;\n  project_id: string;\n  account_email?: string | null;\n  scopes?: string[];\n  status: string;\n  created_at: string;\n  updated_at: string;\n  last_used_at?: string | null;\n  access_rules?: {\n    allowed_folders?: string[];\n    allowed_files?: string[];\n    version?: string;\n  } | null;\n}\n\ninterface GatekeeperListConnectionsResponseWire {\n  data: GatekeeperConnectionWire[];\n  total: number;\n}\n\ninterface GatekeeperDriveFileWire {\n  id: string;\n  name?: string | null;\n  mime_type?: string | null;\n  size?: number | null;\n  modified_time?: string | null;\n  created_time?: string | null;\n  web_view_link?: string | null;\n  icon_link?: string | null;\n  thumbnail_link?: string | null;\n  parents?: string[] | null;\n  drive_id?: string | null;\n  shared?: boolean | null;\n  owned_by_me?: boolean | null;\n}\n\ninterface GatekeeperDriveListResponseWire {\n  files: GatekeeperDriveFileWire[];\n  next_page_token?: string | null;\n}\n\ninterface GatekeeperAccessRulesResponseWire {\n  version: string;\n  allowed_folders: string[];\n  allowed_files: string[];\n  unrestricted: boolean;\n}\n\nconst toConnectRequest = (payload: GatekeeperConnectRequest): GatekeeperConnectRequestWire => ({\n  subject: payload.subject,\n  provider: payload.provider ?? \"google_drive\",\n  project_name: payload.projectName,\n  redirect_uri: payload.redirectUri,\n});\n\nconst toConnectResponse = (payload: GatekeeperConnectResponseWire): GatekeeperConnectResponse => ({\n  status: payload.status,\n  oauthUrl: payload.oauth_url ?? undefined,\n  connectionId: payload.connection_id ?? undefined,\n});\n\nconst toConnection = (payload: GatekeeperConnectionWire): GatekeeperConnection => ({\n  id: payload.id,\n  subject: payload.subject,\n  provider: payload.provider,\n  projectId: payload.project_id,\n  accountEmail: payload.account_email ?? null,\n  scopes: payload.scopes ?? [],\n  status: payload.status,\n  createdAt: payload.created_at,\n  updatedAt: payload.updated_at,\n  lastUsedAt: payload.last_used_at ?? null,\n  accessRules: payload.access_rules\n    ? {\n        version: payload.access_rules.version ?? \"1\",\n        allowedFolders: payload.access_rules.allowed_folders ?? [],\n        allowedFiles: payload.access_rules.allowed_files ?? [],\n        unrestricted: false,\n      }\n    : null,\n});\n\nconst toAccessRules = (payload: GatekeeperAccessRulesResponseWire): GatekeeperAccessRules => ({\n  version: payload.version,\n  allowedFolders: payload.allowed_folders ?? [],\n  allowedFiles: payload.allowed_files ?? [],\n  unrestricted: payload.unrestricted,\n});\n\nconst toDriveFile = (payload: GatekeeperDriveFileWire): GatekeeperDriveFile => ({\n  id: payload.id,\n  name: payload.name ?? null,\n  mimeType: payload.mime_type ?? null,\n  size: payload.size ?? null,\n  modifiedTime: payload.modified_time ?? null,\n  createdTime: payload.created_time ?? null,\n  webViewLink: payload.web_view_link ?? null,\n  iconLink: payload.icon_link ?? null,\n  thumbnailLink: payload.thumbnail_link ?? null,\n  parents: payload.parents ?? null,\n  driveId: payload.drive_id ?? null,\n  shared: payload.shared ?? null,\n  ownedByMe: payload.owned_by_me ?? null,\n});\n\nconst gatekeeperPath = (path: string): string => `/v1/gatekeeper${path}`;\n\nconst pickOverrides = (options?: RequestOverrides): RequestOverrides => ({\n  headers: options?.headers,\n  signal: options?.signal,\n});\n\nexport class GatekeeperClient {\n  private readonly config: ClientConfig;\n\n  constructor(config: ClientConfig) {\n    this.config = config;\n  }\n\n  async connect(payload: GatekeeperConnectRequest, options?: RequestOverrides): Promise<GatekeeperConnectResponse> {\n    const ctx = buildRequestContext(this.config);\n    const data = await request<GatekeeperConnectResponseWire>(ctx, {\n      method: \"POST\",\n      path: gatekeeperPath(\"/connect\"),\n      body: toConnectRequest(payload),\n      ...pickOverrides(options),\n    });\n    return toConnectResponse(data);\n  }\n\n  async listConnections(params: GatekeeperListConnectionsParams, options?: RequestOverrides): Promise<GatekeeperListConnectionsResponse> {\n    const ctx = buildRequestContext(this.config);\n    const data = await request<GatekeeperListConnectionsResponseWire>(ctx, {\n      method: \"GET\",\n      path: gatekeeperPath(\"/connections\"),\n      query: {\n        project_name: params.projectName,\n        status_filter: params.statusFilter,\n      },\n      ...pickOverrides(options),\n    });\n\n    return {\n      total: data.total,\n      data: data.data.map(toConnection),\n    };\n  }\n\n  async getConnection(connectionId: string, options?: RequestOverrides): Promise<GatekeeperConnection> {\n    const ctx = buildRequestContext(this.config);\n    const data = await request<GatekeeperConnectionWire>(ctx, {\n      method: \"GET\",\n      path: gatekeeperPath(`/connections/${connectionId}`),\n      ...pickOverrides(options),\n    });\n    return toConnection(data);\n  }\n\n  async revokeConnection(params: GatekeeperRevokeParams, options?: RequestOverrides): Promise<GatekeeperRevokeResponse> {\n    const ctx = buildRequestContext(this.config);\n    return request<GatekeeperRevokeResponse>(ctx, {\n      method: \"DELETE\",\n      path: gatekeeperPath(\"/connections\"),\n      query: {\n        subject: params.subject,\n        project_name: params.projectName,\n        provider: params.provider,\n      },\n      ...pickOverrides(options),\n    });\n  }\n\n  async listDriveFiles(params: GatekeeperDriveListParams, options?: RequestOverrides): Promise<GatekeeperDriveListResponse> {\n    const ctx = buildRequestContext(this.config);\n    const data = await request<GatekeeperDriveListResponseWire>(ctx, {\n      method: \"GET\",\n      path: gatekeeperPath(\"/connectors/drive/files\"),\n      query: {\n        project_name: params.projectName,\n        subject: params.subject,\n        page_size: params.pageSize,\n        page_token: params.pageToken,\n        folder_id: params.folderId,\n        query: params.query,\n        include_folders: params.includeFolders,\n        order_by: params.orderBy,\n      },\n      ...pickOverrides(options),\n    });\n\n    return {\n      files: data.files.map(toDriveFile),\n      nextPageToken: data.next_page_token ?? null,\n    };\n  }\n\n  async getAccessRules(connectionId: string, options?: RequestOverrides): Promise<GatekeeperAccessRules> {\n    const ctx = buildRequestContext(this.config);\n    const data = await request<GatekeeperAccessRulesResponseWire>(ctx, {\n      method: \"GET\",\n      path: gatekeeperPath(`/connections/${connectionId}/access-rules`),\n      ...pickOverrides(options),\n    });\n    return toAccessRules(data);\n  }\n\n  async updateAccessRules(params: GatekeeperAccessRulesParams, options?: RequestOverrides): Promise<GatekeeperAccessRules> {\n    const ctx = buildRequestContext(this.config);\n    const data = await request<GatekeeperAccessRulesResponseWire>(ctx, {\n      method: \"PUT\",\n      path: gatekeeperPath(\"/connections/access-rules\"),\n      query: {\n        subject: params.subject,\n        project_name: params.projectName,\n        provider: params.provider,\n      },\n      body: {\n        allowed_folders: params.accessRules.allowedFolders ?? [],\n        allowed_files: params.accessRules.allowedFiles ?? [],\n      },\n      ...pickOverrides(options),\n    });\n    return toAccessRules(data);\n  }\n\n  async clearAccessRules(connectionId: string, options?: RequestOverrides): Promise<GatekeeperAccessRules> {\n    const ctx = buildRequestContext(this.config);\n    const data = await request<GatekeeperAccessRulesResponseWire>(ctx, {\n      method: \"DELETE\",\n      path: gatekeeperPath(`/connections/${connectionId}/access-rules`),\n      ...pickOverrides(options),\n    });\n    return toAccessRules(data);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-N3HU6ONW.js

@@ -0,0 +1,148 @@
+// src/core/errors.ts
+var CelestoError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "CelestoError";
+  }
+};
+var CelestoApiError = class extends CelestoError {
+  constructor(message, status, data, requestId) {
+    super(message);
+    this.name = "CelestoApiError";
+    this.status = status;
+    this.data = data;
+    this.requestId = requestId;
+  }
+};
+var CelestoNetworkError = class extends CelestoError {
+  constructor(message, cause) {
+    super(message);
+    this.name = "CelestoNetworkError";
+    this.cause = cause;
+  }
+};
+
+// src/core/config.ts
+var DEFAULT_BASE_URL = "https://api.celesto.ai";
+var buildRequestContext = (config) => ({
+  fetch: config.fetch ?? fetch,
+  baseUrl: config.baseUrl ?? DEFAULT_BASE_URL,
+  token: config.token ?? config.apiKey,
+  organizationId: config.organizationId,
+  userAgent: config.userAgent,
+  timeoutMs: config.timeoutMs,
+  headers: config.headers
+});
+
+// src/core/http.ts
+var joinUrl = (baseUrl, path) => {
+  const trimmedBase = baseUrl.endsWith("/") ? baseUrl.slice(0, -1) : baseUrl;
+  const normalizedPath = path.startsWith("/") ? path : `/${path}`;
+  return `${trimmedBase}${normalizedPath}`;
+};
+var buildQuery = (query) => {
+  if (!query) {
+    return "";
+  }
+  const params = new URLSearchParams();
+  for (const [key, value] of Object.entries(query)) {
+    if (value === void 0 || value === null) {
+      continue;
+    }
+    if (Array.isArray(value)) {
+      for (const item of value) {
+        params.append(key, String(item));
+      }
+      continue;
+    }
+    params.set(key, String(value));
+  }
+  const serialized = params.toString();
+  return serialized ? `?${serialized}` : "";
+};
+var parseResponseBody = async (response) => {
+  if (response.status === 204) {
+    return void 0;
+  }
+  const contentType = response.headers.get("content-type") ?? "";
+  if (contentType.includes("application/json")) {
+    return response.json();
+  }
+  return response.text();
+};
+var extractErrorMessage = (data, status) => {
+  if (data && typeof data === "object") {
+    const record = data;
+    if (typeof record.detail === "string") {
+      return record.detail;
+    }
+    if (typeof record.message === "string") {
+      return record.message;
+    }
+    if (typeof record.error === "string") {
+      return record.error;
+    }
+  }
+  return `Request failed with status ${status}`;
+};
+var request = async (ctx, options) => {
+  const url = `${joinUrl(ctx.baseUrl, options.path)}${buildQuery(options.query)}`;
+  const headers = {
+    ...ctx.headers ?? {},
+    ...options.headers ?? {}
+  };
+  if (ctx.token) {
+    headers.Authorization = `Bearer ${ctx.token}`;
+  }
+  if (ctx.organizationId) {
+    headers["X-Current-Organization"] = ctx.organizationId;
+  }
+  if (ctx.userAgent && !headers["User-Agent"]) {
+    headers["User-Agent"] = ctx.userAgent;
+  }
+  const init = {
+    method: options.method,
+    headers,
+    body: void 0,
+    signal: options.signal
+  };
+  if (options.body !== void 0) {
+    headers["Content-Type"] = headers["Content-Type"] ?? "application/json";
+    init.body = headers["Content-Type"].includes("application/json") ? JSON.stringify(options.body) : options.body;
+  }
+  let timeoutId;
+  let controller;
+  if (!options.signal && ctx.timeoutMs && ctx.timeoutMs > 0) {
+    controller = new AbortController();
+    timeoutId = setTimeout(() => controller?.abort(), ctx.timeoutMs);
+    init.signal = controller.signal;
+  }
+  try {
+    const response = await ctx.fetch(url, init);
+    const data = await parseResponseBody(response);
+    if (!response.ok) {
+      const message = extractErrorMessage(data, response.status);
+      throw new CelestoApiError(message, response.status, data, response.headers.get("x-request-id") ?? void 0);
+    }
+    return data;
+  } catch (err) {
+    if (err instanceof CelestoApiError) {
+      throw err;
+    }
+    const error = err instanceof Error ? err : new Error(String(err));
+    throw new CelestoNetworkError(error.message, error);
+  } finally {
+    if (timeoutId) {
+      clearTimeout(timeoutId);
+    }
+  }
+};
+
+export {
+  buildRequestContext,
+  CelestoError,
+  CelestoApiError,
+  CelestoNetworkError,
+  request
+};
+//# sourceMappingURL=chunk-N3HU6ONW.js.map

package/dist/chunk-N3HU6ONW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/errors.ts","../src/core/config.ts","../src/core/http.ts"],"sourcesContent":["/** Base error for all Celesto SDK errors. */\nexport class CelestoError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"CelestoError\";\n  }\n}\n\n/** Thrown when an API request returns a non-2xx HTTP status. */\nexport class CelestoApiError extends CelestoError {\n  readonly status: number;\n  readonly data: unknown;\n  readonly requestId?: string;\n\n  constructor(message: string, status: number, data: unknown, requestId?: string) {\n    super(message);\n    this.name = \"CelestoApiError\";\n    this.status = status;\n    this.data = data;\n    this.requestId = requestId;\n  }\n}\n\n/** Thrown when fetch() itself fails — DNS, network, timeout, abort. */\nexport class CelestoNetworkError extends CelestoError {\n  readonly cause?: Error;\n\n  constructor(message: string, cause?: Error) {\n    super(message);\n    this.name = \"CelestoNetworkError\";\n    this.cause = cause;\n  }\n}\n","export type FetchLike = typeof fetch;\n\nexport interface ClientConfig {\n  /** Base API URL, e.g. https://api.celesto.ai */\n  baseUrl?: string;\n  /** Bearer token (API key or JWT). */\n  token?: string;\n  /** Alias for token. */\n  apiKey?: string;\n  /** Organization ID to send as X-Current-Organization. */\n  organizationId?: string;\n  /** Optional user agent for server-side requests. */\n  userAgent?: string;\n  /** Default request timeout in milliseconds. */\n  timeoutMs?: number;\n  /** Override fetch implementation (useful for testing). */\n  fetch?: FetchLike;\n  /** Default headers to include in every request. */\n  headers?: Record<string, string>;\n}\n\nexport interface RequestOptions {\n  method: \"GET\" | \"POST\" | \"PUT\" | \"PATCH\" | \"DELETE\";\n  path: string;\n  query?: Record<string, string | number | boolean | undefined | null | (string | number | boolean)[]>;\n  body?: unknown;\n  headers?: Record<string, string>;\n  signal?: AbortSignal;\n}\n\nexport interface RequestOverrides {\n  headers?: Record<string, string>;\n  signal?: AbortSignal;\n}\n\nexport interface RequestContext {\n  fetch: FetchLike;\n  baseUrl: string;\n  token?: string;\n  organizationId?: string;\n  userAgent?: string;\n  timeoutMs?: number;\n  headers?: Record<string, string>;\n}\n\nexport const DEFAULT_BASE_URL = \"https://api.celesto.ai\";\n\nexport const buildRequestContext = (config: ClientConfig): RequestContext => ({\n  fetch: config.fetch ?? fetch,\n  baseUrl: config.baseUrl ?? DEFAULT_BASE_URL,\n  token: config.token ?? config.apiKey,\n  organizationId: config.organizationId,\n  userAgent: config.userAgent,\n  timeoutMs: config.timeoutMs,\n  headers: config.headers,\n});\n","import { CelestoApiError, CelestoNetworkError } from \"./errors\";\nimport { RequestContext, RequestOptions } from \"./config\";\n\nconst joinUrl = (baseUrl: string, path: string): string => {\n  const trimmedBase = baseUrl.endsWith(\"/\") ? baseUrl.slice(0, -1) : baseUrl;\n  const normalizedPath = path.startsWith(\"/\") ? path : `/${path}`;\n  return `${trimmedBase}${normalizedPath}`;\n};\n\nconst buildQuery = (\n  query?: RequestOptions[\"query\"],\n): string => {\n  if (!query) {\n    return \"\";\n  }\n\n  const params = new URLSearchParams();\n  for (const [key, value] of Object.entries(query)) {\n    if (value === undefined || value === null) {\n      continue;\n    }\n    if (Array.isArray(value)) {\n      for (const item of value) {\n        params.append(key, String(item));\n      }\n      continue;\n    }\n    params.set(key, String(value));\n  }\n\n  const serialized = params.toString();\n  return serialized ? `?${serialized}` : \"\";\n};\n\nconst parseResponseBody = async (response: Response): Promise<unknown> => {\n  if (response.status === 204) {\n    return undefined;\n  }\n\n  const contentType = response.headers.get(\"content-type\") ?? \"\";\n  if (contentType.includes(\"application/json\")) {\n    return response.json();\n  }\n\n  return response.text();\n};\n\nconst extractErrorMessage = (data: unknown, status: number): string => {\n  if (data && typeof data === \"object\") {\n    const record = data as Record<string, unknown>;\n    if (typeof record.detail === \"string\") {\n      return record.detail;\n    }\n    if (typeof record.message === \"string\") {\n      return record.message;\n    }\n    if (typeof record.error === \"string\") {\n      return record.error;\n    }\n  }\n  return `Request failed with status ${status}`;\n};\n\nexport const request = async <T>(ctx: RequestContext, options: RequestOptions): Promise<T> => {\n  const url = `${joinUrl(ctx.baseUrl, options.path)}${buildQuery(options.query)}`;\n\n  const headers: Record<string, string> = {\n    ...(ctx.headers ?? {}),\n    ...(options.headers ?? {}),\n  };\n\n  if (ctx.token) {\n    headers.Authorization = `Bearer ${ctx.token}`;\n  }\n\n  if (ctx.organizationId) {\n    headers[\"X-Current-Organization\"] = ctx.organizationId;\n  }\n\n  if (ctx.userAgent && !headers[\"User-Agent\"]) {\n    headers[\"User-Agent\"] = ctx.userAgent;\n  }\n\n  const init: RequestInit = {\n    method: options.method,\n    headers,\n    body: undefined,\n    signal: options.signal,\n  };\n\n  if (options.body !== undefined) {\n    headers[\"Content-Type\"] = headers[\"Content-Type\"] ?? \"application/json\";\n    init.body = headers[\"Content-Type\"].includes(\"application/json\")\n      ? JSON.stringify(options.body)\n      : (options.body as BodyInit);\n  }\n\n  let timeoutId: ReturnType<typeof setTimeout> | undefined;\n  let controller: AbortController | undefined;\n\n  if (!options.signal && ctx.timeoutMs && ctx.timeoutMs > 0) {\n    controller = new AbortController();\n    timeoutId = setTimeout(() => controller?.abort(), ctx.timeoutMs);\n    init.signal = controller.signal;\n  }\n\n  try {\n    const response = await ctx.fetch(url, init);\n    const data = await parseResponseBody(response);\n\n    if (!response.ok) {\n      const message = extractErrorMessage(data, response.status);\n      throw new CelestoApiError(message, response.status, data, response.headers.get(\"x-request-id\") ?? undefined);\n    }\n\n    return data as T;\n  } catch (err) {\n    if (err instanceof CelestoApiError) {\n      throw err;\n    }\n    const error = err instanceof Error ? err : new Error(String(err));\n    throw new CelestoNetworkError(error.message, error);\n  } finally {\n    if (timeoutId) {\n      clearTimeout(timeoutId);\n    }\n  }\n};\n"],"mappings":"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","names":[]}

package/dist/chunk-OGMV3NFZ.js

@@ -0,0 +1,164 @@
+import {
+  buildRequestContext,
+  request
+} from "./chunk-N3HU6ONW.js";
+
+// src/computers/client.ts
+var toConnection = (payload) => {
+  if (!payload) {
+    return void 0;
+  }
+  const out = {};
+  if (payload.ssh != null) {
+    out.ssh = payload.ssh;
+  }
+  if (payload.access_url != null) {
+    out.accessUrl = payload.access_url;
+  }
+  return out;
+};
+var toComputerInfo = (payload) => ({
+  id: payload.id,
+  name: payload.name,
+  status: payload.status,
+  vcpus: payload.vcpus,
+  ramMb: payload.ram_mb,
+  image: payload.image,
+  connection: toConnection(payload.connection),
+  lastError: payload.last_error ?? null,
+  createdAt: payload.created_at,
+  stoppedAt: payload.stopped_at ?? null
+});
+var toExecResponse = (payload) => ({
+  exitCode: payload.exit_code,
+  stdout: payload.stdout,
+  stderr: payload.stderr
+});
+var computersPath = (path) => `/v1/computers${path}`;
+var pickOverrides = (options) => ({
+  headers: options?.headers,
+  signal: options?.signal
+});
+var ComputersClient = class {
+  constructor(config) {
+    this.config = config;
+  }
+  async create(params = {}, options) {
+    const ctx = buildRequestContext(this.config);
+    const data = await request(ctx, {
+      method: "POST",
+      path: computersPath(""),
+      body: {
+        vcpus: params.cpus ?? 1,
+        ram_mb: params.memory ?? 1024,
+        image: params.image ?? "ubuntu-desktop-24.04"
+      },
+      ...pickOverrides(options)
+    });
+    return toComputerInfo(data);
+  }
+  async list(options) {
+    const ctx = buildRequestContext(this.config);
+    const data = await request(ctx, {
+      method: "GET",
+      path: computersPath(""),
+      ...pickOverrides(options)
+    });
+    return {
+      computers: data.computers.map(toComputerInfo),
+      count: data.count
+    };
+  }
+  async get(computerId, options) {
+    const ctx = buildRequestContext(this.config);
+    const data = await request(ctx, {
+      method: "GET",
+      path: computersPath(`/${encodeURIComponent(computerId)}`),
+      ...pickOverrides(options)
+    });
+    return toComputerInfo(data);
+  }
+  async exec(computerId, command, params = {}, options) {
+    const ctx = buildRequestContext(this.config);
+    const data = await request(ctx, {
+      method: "POST",
+      path: computersPath(`/${encodeURIComponent(computerId)}/exec`),
+      body: {
+        command,
+        timeout: params.timeout ?? 30
+      },
+      ...pickOverrides(options)
+    });
+    return toExecResponse(data);
+  }
+  async stop(computerId, options) {
+    const ctx = buildRequestContext(this.config);
+    const data = await request(ctx, {
+      method: "POST",
+      path: computersPath(`/${encodeURIComponent(computerId)}/stop`),
+      ...pickOverrides(options)
+    });
+    return toComputerInfo(data);
+  }
+  async start(computerId, options) {
+    const ctx = buildRequestContext(this.config);
+    const data = await request(ctx, {
+      method: "POST",
+      path: computersPath(`/${encodeURIComponent(computerId)}/start`),
+      ...pickOverrides(options)
+    });
+    return toComputerInfo(data);
+  }
+  async delete(computerId, options) {
+    const ctx = buildRequestContext(this.config);
+    const data = await request(ctx, {
+      method: "DELETE",
+      path: computersPath(`/${encodeURIComponent(computerId)}`),
+      ...pickOverrides(options)
+    });
+    return toComputerInfo(data);
+  }
+  /**
+   * Get connection info for opening a WebSocket terminal session.
+   *
+   * Accepts either a computer ID (e.g. `cmp_xxx`) or a human-readable name.
+   * The name is resolved to the canonical ID via a GET call — the backend's
+   * WebSocket endpoint does not resolve names on its own.
+   *
+   * Returns the URL, headers, and first message needed to open the connection
+   * with any WebSocket library of your choice.
+   *
+   * @example
+   * ```ts
+   * const conn = await celesto.computers.getTerminalConnection("my-computer");
+   * const ws = new WebSocket(conn.url, { headers: conn.headers });
+   * ws.on("open", () => ws.send(conn.firstMessage));
+   * ws.on("message", (data) => process.stdout.write(data));
+   * ```
+   */
+  async getTerminalConnection(computerIdOrName) {
+    const info = await this.get(computerIdOrName);
+    const ctx = buildRequestContext(this.config);
+    if (!ctx.token) {
+      throw new Error("A token is required for terminal connections");
+    }
+    const wsBase = ctx.baseUrl.replace(/^https:/i, "wss:").replace(/^http:/i, "ws:");
+    const url = `${wsBase}/v1/computers/${encodeURIComponent(info.id)}/terminal`;
+    const headers = {
+      Authorization: `Bearer ${ctx.token}`
+    };
+    if (ctx.organizationId) {
+      headers["X-Current-Organization"] = ctx.organizationId;
+    }
+    return {
+      url,
+      headers,
+      firstMessage: JSON.stringify({ token: ctx.token })
+    };
+  }
+};
+
+export {
+  ComputersClient
+};
+//# sourceMappingURL=chunk-OGMV3NFZ.js.map

package/dist/chunk-OGMV3NFZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/computers/client.ts"],"sourcesContent":["import { buildRequestContext, ClientConfig, RequestOverrides } from \"../core/config\";\nimport { request } from \"../core/http\";\nimport {\n  ComputerConnectionInfo,\n  ComputerExecResponse,\n  ComputerInfo,\n  ComputerListResponse,\n  ComputerStatus,\n  CreateComputerParams,\n  ExecParams,\n  TerminalConnectionInfo,\n} from \"./types\";\n\ninterface ComputerConnectionInfoWire {\n  ssh?: string | null;\n  access_url?: string | null;\n}\n\ninterface ComputerInfoWire {\n  id: string;\n  name: string;\n  status: ComputerStatus;\n  vcpus: number;\n  ram_mb: number;\n  image: string;\n  connection?: ComputerConnectionInfoWire | null;\n  last_error?: string | null;\n  created_at: string;\n  stopped_at?: string | null;\n}\n\ninterface ComputerListResponseWire {\n  computers: ComputerInfoWire[];\n  count: number;\n}\n\ninterface ComputerExecResponseWire {\n  exit_code: number;\n  stdout: string;\n  stderr: string;\n}\n\nconst toConnection = (\n  payload: ComputerConnectionInfoWire | null | undefined,\n): ComputerConnectionInfo | undefined => {\n  if (!payload) {\n    return undefined;\n  }\n  const out: ComputerConnectionInfo = {};\n  if (payload.ssh != null) {\n    out.ssh = payload.ssh;\n  }\n  if (payload.access_url != null) {\n    out.accessUrl = payload.access_url;\n  }\n  return out;\n};\n\nconst toComputerInfo = (payload: ComputerInfoWire): ComputerInfo => ({\n  id: payload.id,\n  name: payload.name,\n  status: payload.status,\n  vcpus: payload.vcpus,\n  ramMb: payload.ram_mb,\n  image: payload.image,\n  connection: toConnection(payload.connection),\n  lastError: payload.last_error ?? null,\n  createdAt: payload.created_at,\n  stoppedAt: payload.stopped_at ?? null,\n});\n\nconst toExecResponse = (payload: ComputerExecResponseWire): ComputerExecResponse => ({\n  exitCode: payload.exit_code,\n  stdout: payload.stdout,\n  stderr: payload.stderr,\n});\n\nconst computersPath = (path: string): string => `/v1/computers${path}`;\n\nconst pickOverrides = (options?: RequestOverrides): RequestOverrides => ({\n  headers: options?.headers,\n  signal: options?.signal,\n});\n\n/**\n * Client for managing sandboxed computers (AI sandboxes).\n *\n * Provides create/list/get/exec/stop/start/delete over HTTP, plus\n * `getTerminalConnection()` which returns the URL and headers needed\n * to open a WebSocket terminal with any WS library of your choice.\n *\n * @example\n * ```ts\n * const celesto = new Celesto({ token: process.env.CELESTO_API_KEY });\n * const computer = await celesto.computers.create({ cpus: 2, memory: 2048 });\n * const result = await celesto.computers.exec(computer.id, \"uname -a\");\n * console.log(result.stdout);\n * await celesto.computers.delete(computer.id);\n * ```\n */\nexport class ComputersClient {\n  private readonly config: ClientConfig;\n\n  constructor(config: ClientConfig) {\n    this.config = config;\n  }\n\n  async create(params: CreateComputerParams = {}, options?: RequestOverrides): Promise<ComputerInfo> {\n    const ctx = buildRequestContext(this.config);\n    const data = await request<ComputerInfoWire>(ctx, {\n      method: \"POST\",\n      path: computersPath(\"\"),\n      body: {\n        vcpus: params.cpus ?? 1,\n        ram_mb: params.memory ?? 1024,\n        image: params.image ?? \"ubuntu-desktop-24.04\",\n      },\n      ...pickOverrides(options),\n    });\n    return toComputerInfo(data);\n  }\n\n  async list(options?: RequestOverrides): Promise<ComputerListResponse> {\n    const ctx = buildRequestContext(this.config);\n    const data = await request<ComputerListResponseWire>(ctx, {\n      method: \"GET\",\n      path: computersPath(\"\"),\n      ...pickOverrides(options),\n    });\n    return {\n      computers: data.computers.map(toComputerInfo),\n      count: data.count,\n    };\n  }\n\n  async get(computerId: string, options?: RequestOverrides): Promise<ComputerInfo> {\n    const ctx = buildRequestContext(this.config);\n    const data = await request<ComputerInfoWire>(ctx, {\n      method: \"GET\",\n      path: computersPath(`/${encodeURIComponent(computerId)}`),\n      ...pickOverrides(options),\n    });\n    return toComputerInfo(data);\n  }\n\n  async exec(\n    computerId: string,\n    command: string,\n    params: ExecParams = {},\n    options?: RequestOverrides,\n  ): Promise<ComputerExecResponse> {\n    const ctx = buildRequestContext(this.config);\n    const data = await request<ComputerExecResponseWire>(ctx, {\n      method: \"POST\",\n      path: computersPath(`/${encodeURIComponent(computerId)}/exec`),\n      body: {\n        command,\n        timeout: params.timeout ?? 30,\n      },\n      ...pickOverrides(options),\n    });\n    return toExecResponse(data);\n  }\n\n  async stop(computerId: string, options?: RequestOverrides): Promise<ComputerInfo> {\n    const ctx = buildRequestContext(this.config);\n    const data = await request<ComputerInfoWire>(ctx, {\n      method: \"POST\",\n      path: computersPath(`/${encodeURIComponent(computerId)}/stop`),\n      ...pickOverrides(options),\n    });\n    return toComputerInfo(data);\n  }\n\n  async start(computerId: string, options?: RequestOverrides): Promise<ComputerInfo> {\n    const ctx = buildRequestContext(this.config);\n    const data = await request<ComputerInfoWire>(ctx, {\n      method: \"POST\",\n      path: computersPath(`/${encodeURIComponent(computerId)}/start`),\n      ...pickOverrides(options),\n    });\n    return toComputerInfo(data);\n  }\n\n  async delete(computerId: string, options?: RequestOverrides): Promise<ComputerInfo> {\n    const ctx = buildRequestContext(this.config);\n    const data = await request<ComputerInfoWire>(ctx, {\n      method: \"DELETE\",\n      path: computersPath(`/${encodeURIComponent(computerId)}`),\n      ...pickOverrides(options),\n    });\n    return toComputerInfo(data);\n  }\n\n  /**\n   * Get connection info for opening a WebSocket terminal session.\n   *\n   * Accepts either a computer ID (e.g. `cmp_xxx`) or a human-readable name.\n   * The name is resolved to the canonical ID via a GET call — the backend's\n   * WebSocket endpoint does not resolve names on its own.\n   *\n   * Returns the URL, headers, and first message needed to open the connection\n   * with any WebSocket library of your choice.\n   *\n   * @example\n   * ```ts\n   * const conn = await celesto.computers.getTerminalConnection(\"my-computer\");\n   * const ws = new WebSocket(conn.url, { headers: conn.headers });\n   * ws.on(\"open\", () => ws.send(conn.firstMessage));\n   * ws.on(\"message\", (data) => process.stdout.write(data));\n   * ```\n   */\n  async getTerminalConnection(computerIdOrName: string): Promise<TerminalConnectionInfo> {\n    const info = await this.get(computerIdOrName);\n    const ctx = buildRequestContext(this.config);\n\n    if (!ctx.token) {\n      throw new Error(\"A token is required for terminal connections\");\n    }\n\n    const wsBase = ctx.baseUrl.replace(/^https:/i, \"wss:\").replace(/^http:/i, \"ws:\");\n    const url = `${wsBase}/v1/computers/${encodeURIComponent(info.id)}/terminal`;\n\n    const headers: Record<string, string> = {\n      Authorization: `Bearer ${ctx.token}`,\n    };\n    if (ctx.organizationId) {\n      headers[\"X-Current-Organization\"] = ctx.organizationId;\n    }\n\n    return {\n      url,\n      headers,\n      firstMessage: JSON.stringify({ token: ctx.token }),\n    };\n  }\n}\n"],"mappings":"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","names":[]}