condensationai 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Condensation contributors
+
+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,72 @@
+# condensationai
+
+JavaScript and TypeScript SDK for Condensation. The package ships ESM, CommonJS,
+and TypeScript declarations with no runtime dependencies. Requires Node.js 20+.
+
+## Install
+
+```sh
+npm install condensationai
+```
+
+Sign in at https://workspaces.condensation.ai/account using Codegraff and create a
+sandbox API key. Set `CONDENSATION_API_KEY` in your server environment. Never
+embed it in browser code or commit it to Git.
+
+```ts
+import { Condensation } from 'condensationai';
+
+const client = new Condensation();
+const wallet = await client.wallet();
+console.log(wallet.purchasedMicroUsd / 1_000_000);
+
+const sandbox = await client.create({ language: 'python', autoStopMinutes: 5 });
+try {
+  const result = await client.run(sandbox.id, 'python -c "print(1 + 1)"');
+  console.log(result.result);
+} finally {
+  await client.delete(sandbox.id);
+}
+```
+
+The same example works in JavaScript. CommonJS: `const { Condensation } =
+require('condensationai')`.
+
+## Billing and access
+
+Purchased credits use the existing Codegraff balance, shared with nanohub and
+Condensation. This first SDK release routes sandboxes through Codegraff's existing
+gateway and uses that gateway's resource rates, not the Condensation fleet rates
+on the pricing page. Condensation monthly bonuses do not fund this gateway path;
+Build checkout remains disabled until that integration is ready. Inspect the
+sandbox meter and configure a small auto-stop window. Stopped sandboxes can still
+incur storage charges; delete them when finished.
+
+SDK keys can read their owner's wallet and manage that account's sandboxes. They
+cannot access inference, GitHub credentials, chat sessions, billing mutations, or
+admin endpoints. They see the owner's Codegraff sandboxes too. The configured
+monthly key budget is checked by the gateway at request admission; concurrent or
+already-running work can exceed a budget. The shared account balance remains the
+funding source.
+
+## API
+
+- `wallet()`, `list()`, `get(id)`, `create(options)`
+- `run(id, command, options)`, `runAsync(id, command, options)`
+- `execution(id, execId)`, `cancelExecution(id, execId)`
+- `uploadBase64(id, path, contentBase64)`, `downloadBase64(id, path)`
+- `meter(id)`, `stop(id)`, `start(id)`, `delete(id)`
+
+File operations reflect the gateway API. Its current download implementation is
+text-oriented; arbitrary binary round trips are not guaranteed.
+
+`new Condensation({ apiKey, baseUrl, timeoutMs, fetch })` supports explicit
+configuration and injected fetch for tests. The default base URL is
+`https://api.condensation.ai`; the default timeout is 120 seconds.
+
+Requests never follow redirects or retry automatically. On a failed create,
+command, or deletion, inspect state before repeating it: the server may have
+completed the operation. `CondensationError.status` carries the HTTP status (zero
+for a transport failure), and `.details` carries the API error body.
+
+Source contract: `api/openapi.json` in the Condensation repository.

package/dist/index.cjs

@@ -0,0 +1,123 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Condensation: () => Condensation,
+  CondensationError: () => CondensationError,
+  default: () => index_default
+});
+module.exports = __toCommonJS(index_exports);
+var CondensationError = class extends Error {
+  constructor(message, status, details) {
+    super(message);
+    this.status = status;
+    this.details = details;
+    this.name = "CondensationError";
+  }
+};
+function identifier(value) {
+  if (!/^[a-zA-Z0-9_-]+$/.test(value)) throw new TypeError("Invalid sandbox or execution ID");
+  return value;
+}
+var Condensation = class {
+  apiKey;
+  baseUrl;
+  timeoutMs;
+  transport;
+  constructor(options = {}) {
+    const env = globalThis.process?.env;
+    const apiKey = options.apiKey || env?.CONDENSATION_API_KEY;
+    if (!apiKey) throw new TypeError("Set CONDENSATION_API_KEY or pass apiKey");
+    const url = new URL(options.baseUrl || "https://api.condensation.ai");
+    const local = url.protocol === "http:" && ["localhost", "127.0.0.1", "[::1]"].includes(url.hostname);
+    if (url.protocol !== "https:" && !local || url.username || url.password || url.search || url.hash || url.pathname !== "/") throw new TypeError("baseUrl must be an HTTPS origin (HTTP is allowed for localhost)");
+    this.apiKey = apiKey;
+    this.baseUrl = url.origin;
+    this.timeoutMs = options.timeoutMs ?? 12e4;
+    this.transport = options.fetch || globalThis.fetch;
+    if (!Number.isFinite(this.timeoutMs) || this.timeoutMs <= 0) throw new TypeError("timeoutMs must be positive");
+  }
+  /** Requests are never retried automatically: a failed mutation may have succeeded. */
+  async request(method, path, body) {
+    let response;
+    try {
+      response = await this.transport(this.baseUrl + path, { method, headers: { authorization: `Bearer ${this.apiKey}`, "content-type": "application/json" }, body: body === void 0 ? void 0 : JSON.stringify(body), redirect: "error", signal: AbortSignal.timeout(this.timeoutMs) });
+    } catch {
+      throw new CondensationError("Connection failed or timed out. Check resource state before retrying a mutation.", 0, null);
+    }
+    const text = await response.text();
+    let data;
+    try {
+      data = text ? JSON.parse(text) : void 0;
+    } catch {
+      throw new CondensationError("The server returned an invalid response.", response.status, null);
+    }
+    if (!response.ok) {
+      const error = data?.error;
+      throw new CondensationError(typeof error === "string" ? error : error?.message || `Request failed (${response.status})`, response.status, data);
+    }
+    return data;
+  }
+  wallet() {
+    return this.request("GET", "/v1/wallet");
+  }
+  list() {
+    return this.request("GET", "/v1/sandboxes");
+  }
+  get(id) {
+    return this.request("GET", `/v1/sandboxes/${identifier(id)}`);
+  }
+  create(options = {}) {
+    return this.request("POST", "/v1/sandboxes", options);
+  }
+  run(id, command, options = {}) {
+    return this.request("POST", `/v1/sandboxes/${identifier(id)}/exec`, { ...options, command });
+  }
+  runAsync(id, command, options = {}) {
+    return this.request("POST", `/v1/sandboxes/${identifier(id)}/exec`, { ...options, command, async: true });
+  }
+  execution(id, execId) {
+    return this.request("GET", `/v1/sandboxes/${identifier(id)}/exec/${identifier(execId)}`);
+  }
+  cancelExecution(id, execId) {
+    return this.request("DELETE", `/v1/sandboxes/${identifier(id)}/exec/${identifier(execId)}`);
+  }
+  uploadBase64(id, path, contentBase64) {
+    return this.request("POST", `/v1/sandboxes/${identifier(id)}/upload`, { path, contentBase64 });
+  }
+  downloadBase64(id, path) {
+    return this.request("POST", `/v1/sandboxes/${identifier(id)}/download`, { path });
+  }
+  meter(id) {
+    return this.request("GET", `/v1/sandboxes/${identifier(id)}/meter`);
+  }
+  stop(id) {
+    return this.request("POST", `/v1/sandboxes/${identifier(id)}/stop`, {});
+  }
+  start(id) {
+    return this.request("POST", `/v1/sandboxes/${identifier(id)}/start`, {});
+  }
+  delete(id) {
+    return this.request("DELETE", `/v1/sandboxes/${identifier(id)}`);
+  }
+};
+var index_default = Condensation;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "sourcesContent": ["export interface Wallet {\n  currency: 'USD'; accountId: string; purchasedMicroUsd: number;\n  reservedMicroUsd: number; debtMicroUsd: number; condensationBonusMicroUsd: number;\n}\nexport interface SandboxInfo {\n  id: string; state: string; cpu: number; memory: number; disk: number;\n  language?: string; labels?: Record<string,string>; reservedCreditsMicro?: number;\n}\nexport interface CreateOptions {\n  language?: 'javascript'|'typescript'|'python';\n  autoStopMinutes?: number;\n  labels?: Record<string,string>;\n}\nexport interface CommandOptions { cwd?: string; timeoutSeconds?: number; }\nexport interface CommandResult { exitCode: number; result: string; }\nexport interface AsyncCommand { execId: string; state: string; async: true; }\nexport interface ClientOptions {\n  apiKey?: string; baseUrl?: string; timeoutMs?: number;\n  /** Inject a standards-compliant fetch for testing or custom networking. */\n  fetch?: typeof globalThis.fetch;\n}\nexport class CondensationError extends Error {\n  constructor(message:string, public readonly status:number, public readonly details:unknown) {super(message);this.name='CondensationError';}\n}\nfunction identifier(value:string):string {\n  if(!/^[a-zA-Z0-9_-]+$/.test(value))throw new TypeError('Invalid sandbox or execution ID');\n  return value;\n}\nexport class Condensation {\n  private readonly apiKey:string;\n  private readonly baseUrl:string;\n  private readonly timeoutMs:number;\n  private readonly transport:typeof globalThis.fetch;\n  constructor(options:ClientOptions={}) {\n    const env=(globalThis as {process?:{env?:Record<string,string|undefined>}}).process?.env;\n    const apiKey=options.apiKey||env?.CONDENSATION_API_KEY;\n    if(!apiKey)throw new TypeError('Set CONDENSATION_API_KEY or pass apiKey');\n    const url=new URL(options.baseUrl||'https://api.condensation.ai');\n    const local=url.protocol==='http:'&&['localhost','127.0.0.1','[::1]'].includes(url.hostname);\n    if((url.protocol!=='https:'&&!local)||url.username||url.password||url.search||url.hash||url.pathname!=='/')throw new TypeError('baseUrl must be an HTTPS origin (HTTP is allowed for localhost)');\n    this.apiKey=apiKey;this.baseUrl=url.origin;this.timeoutMs=options.timeoutMs??120000;this.transport=options.fetch||globalThis.fetch;\n    if(!Number.isFinite(this.timeoutMs)||this.timeoutMs<=0)throw new TypeError('timeoutMs must be positive');\n  }\n  /** Requests are never retried automatically: a failed mutation may have succeeded. */\n  private async request<T>(method:string,path:string,body?:unknown):Promise<T> {\n    let response:Response;\n    try {response=await this.transport(this.baseUrl+path,{method,headers:{authorization:`Bearer ${this.apiKey}`,'content-type':'application/json'},body:body===undefined?undefined:JSON.stringify(body),redirect:'error',signal:AbortSignal.timeout(this.timeoutMs)});}\n    catch {throw new CondensationError('Connection failed or timed out. Check resource state before retrying a mutation.',0,null);}\n    const text=await response.text();let data:unknown;\n    try{data=text?JSON.parse(text):undefined;}catch{throw new CondensationError('The server returned an invalid response.',response.status,null);}\n    if(!response.ok){const error=(data as {error?:string|{message?:string}})?.error;throw new CondensationError(typeof error==='string'?error:error?.message||`Request failed (${response.status})`,response.status,data);}\n    return data as T;\n  }\n  wallet():Promise<Wallet>{return this.request('GET','/v1/wallet');}\n  list():Promise<SandboxInfo[]>{return this.request('GET','/v1/sandboxes');}\n  get(id:string):Promise<SandboxInfo>{return this.request('GET',`/v1/sandboxes/${identifier(id)}`);}\n  create(options:CreateOptions={}):Promise<SandboxInfo>{return this.request('POST','/v1/sandboxes',options);}\n  run(id:string,command:string,options:CommandOptions={}):Promise<CommandResult>{return this.request('POST',`/v1/sandboxes/${identifier(id)}/exec`,{...options,command});}\n  runAsync(id:string,command:string,options:CommandOptions={}):Promise<AsyncCommand>{return this.request('POST',`/v1/sandboxes/${identifier(id)}/exec`,{...options,command,async:true});}\n  execution(id:string,execId:string):Promise<Record<string,unknown>>{return this.request('GET',`/v1/sandboxes/${identifier(id)}/exec/${identifier(execId)}`);}\n  cancelExecution(id:string,execId:string):Promise<Record<string,unknown>>{return this.request('DELETE',`/v1/sandboxes/${identifier(id)}/exec/${identifier(execId)}`);}\n  uploadBase64(id:string,path:string,contentBase64:string):Promise<{ok:boolean}>{return this.request('POST',`/v1/sandboxes/${identifier(id)}/upload`,{path,contentBase64});}\n  downloadBase64(id:string,path:string):Promise<{contentBase64:string}>{return this.request('POST',`/v1/sandboxes/${identifier(id)}/download`,{path});}\n  meter(id:string):Promise<Record<string,unknown>>{return this.request('GET',`/v1/sandboxes/${identifier(id)}/meter`);}\n  stop(id:string):Promise<Record<string,unknown>>{return this.request('POST',`/v1/sandboxes/${identifier(id)}/stop`,{});}\n  start(id:string):Promise<Record<string,unknown>>{return this.request('POST',`/v1/sandboxes/${identifier(id)}/start`,{});}\n  delete(id:string):Promise<void>{return this.request('DELETE',`/v1/sandboxes/${identifier(id)}`);}\n}\nexport default Condensation;\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/index.d.cts

@@ -0,0 +1,76 @@
+export interface Wallet {
+    currency: 'USD';
+    accountId: string;
+    purchasedMicroUsd: number;
+    reservedMicroUsd: number;
+    debtMicroUsd: number;
+    condensationBonusMicroUsd: number;
+}
+export interface SandboxInfo {
+    id: string;
+    state: string;
+    cpu: number;
+    memory: number;
+    disk: number;
+    language?: string;
+    labels?: Record<string, string>;
+    reservedCreditsMicro?: number;
+}
+export interface CreateOptions {
+    language?: 'javascript' | 'typescript' | 'python';
+    autoStopMinutes?: number;
+    labels?: Record<string, string>;
+}
+export interface CommandOptions {
+    cwd?: string;
+    timeoutSeconds?: number;
+}
+export interface CommandResult {
+    exitCode: number;
+    result: string;
+}
+export interface AsyncCommand {
+    execId: string;
+    state: string;
+    async: true;
+}
+export interface ClientOptions {
+    apiKey?: string;
+    baseUrl?: string;
+    timeoutMs?: number;
+    /** Inject a standards-compliant fetch for testing or custom networking. */
+    fetch?: typeof globalThis.fetch;
+}
+export declare class CondensationError extends Error {
+    readonly status: number;
+    readonly details: unknown;
+    constructor(message: string, status: number, details: unknown);
+}
+export declare class Condensation {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly timeoutMs;
+    private readonly transport;
+    constructor(options?: ClientOptions);
+    /** Requests are never retried automatically: a failed mutation may have succeeded. */
+    private request;
+    wallet(): Promise<Wallet>;
+    list(): Promise<SandboxInfo[]>;
+    get(id: string): Promise<SandboxInfo>;
+    create(options?: CreateOptions): Promise<SandboxInfo>;
+    run(id: string, command: string, options?: CommandOptions): Promise<CommandResult>;
+    runAsync(id: string, command: string, options?: CommandOptions): Promise<AsyncCommand>;
+    execution(id: string, execId: string): Promise<Record<string, unknown>>;
+    cancelExecution(id: string, execId: string): Promise<Record<string, unknown>>;
+    uploadBase64(id: string, path: string, contentBase64: string): Promise<{
+        ok: boolean;
+    }>;
+    downloadBase64(id: string, path: string): Promise<{
+        contentBase64: string;
+    }>;
+    meter(id: string): Promise<Record<string, unknown>>;
+    stop(id: string): Promise<Record<string, unknown>>;
+    start(id: string): Promise<Record<string, unknown>>;
+    delete(id: string): Promise<void>;
+}
+export default Condensation;

package/dist/index.d.ts

@@ -0,0 +1,76 @@
+export interface Wallet {
+    currency: 'USD';
+    accountId: string;
+    purchasedMicroUsd: number;
+    reservedMicroUsd: number;
+    debtMicroUsd: number;
+    condensationBonusMicroUsd: number;
+}
+export interface SandboxInfo {
+    id: string;
+    state: string;
+    cpu: number;
+    memory: number;
+    disk: number;
+    language?: string;
+    labels?: Record<string, string>;
+    reservedCreditsMicro?: number;
+}
+export interface CreateOptions {
+    language?: 'javascript' | 'typescript' | 'python';
+    autoStopMinutes?: number;
+    labels?: Record<string, string>;
+}
+export interface CommandOptions {
+    cwd?: string;
+    timeoutSeconds?: number;
+}
+export interface CommandResult {
+    exitCode: number;
+    result: string;
+}
+export interface AsyncCommand {
+    execId: string;
+    state: string;
+    async: true;
+}
+export interface ClientOptions {
+    apiKey?: string;
+    baseUrl?: string;
+    timeoutMs?: number;
+    /** Inject a standards-compliant fetch for testing or custom networking. */
+    fetch?: typeof globalThis.fetch;
+}
+export declare class CondensationError extends Error {
+    readonly status: number;
+    readonly details: unknown;
+    constructor(message: string, status: number, details: unknown);
+}
+export declare class Condensation {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly timeoutMs;
+    private readonly transport;
+    constructor(options?: ClientOptions);
+    /** Requests are never retried automatically: a failed mutation may have succeeded. */
+    private request;
+    wallet(): Promise<Wallet>;
+    list(): Promise<SandboxInfo[]>;
+    get(id: string): Promise<SandboxInfo>;
+    create(options?: CreateOptions): Promise<SandboxInfo>;
+    run(id: string, command: string, options?: CommandOptions): Promise<CommandResult>;
+    runAsync(id: string, command: string, options?: CommandOptions): Promise<AsyncCommand>;
+    execution(id: string, execId: string): Promise<Record<string, unknown>>;
+    cancelExecution(id: string, execId: string): Promise<Record<string, unknown>>;
+    uploadBase64(id: string, path: string, contentBase64: string): Promise<{
+        ok: boolean;
+    }>;
+    downloadBase64(id: string, path: string): Promise<{
+        contentBase64: string;
+    }>;
+    meter(id: string): Promise<Record<string, unknown>>;
+    stop(id: string): Promise<Record<string, unknown>>;
+    start(id: string): Promise<Record<string, unknown>>;
+    delete(id: string): Promise<void>;
+}
+export default Condensation;

package/dist/index.js

@@ -0,0 +1,102 @@
+// src/index.ts
+var CondensationError = class extends Error {
+  constructor(message, status, details) {
+    super(message);
+    this.status = status;
+    this.details = details;
+    this.name = "CondensationError";
+  }
+};
+function identifier(value) {
+  if (!/^[a-zA-Z0-9_-]+$/.test(value)) throw new TypeError("Invalid sandbox or execution ID");
+  return value;
+}
+var Condensation = class {
+  apiKey;
+  baseUrl;
+  timeoutMs;
+  transport;
+  constructor(options = {}) {
+    const env = globalThis.process?.env;
+    const apiKey = options.apiKey || env?.CONDENSATION_API_KEY;
+    if (!apiKey) throw new TypeError("Set CONDENSATION_API_KEY or pass apiKey");
+    const url = new URL(options.baseUrl || "https://api.condensation.ai");
+    const local = url.protocol === "http:" && ["localhost", "127.0.0.1", "[::1]"].includes(url.hostname);
+    if (url.protocol !== "https:" && !local || url.username || url.password || url.search || url.hash || url.pathname !== "/") throw new TypeError("baseUrl must be an HTTPS origin (HTTP is allowed for localhost)");
+    this.apiKey = apiKey;
+    this.baseUrl = url.origin;
+    this.timeoutMs = options.timeoutMs ?? 12e4;
+    this.transport = options.fetch || globalThis.fetch;
+    if (!Number.isFinite(this.timeoutMs) || this.timeoutMs <= 0) throw new TypeError("timeoutMs must be positive");
+  }
+  /** Requests are never retried automatically: a failed mutation may have succeeded. */
+  async request(method, path, body) {
+    let response;
+    try {
+      response = await this.transport(this.baseUrl + path, { method, headers: { authorization: `Bearer ${this.apiKey}`, "content-type": "application/json" }, body: body === void 0 ? void 0 : JSON.stringify(body), redirect: "error", signal: AbortSignal.timeout(this.timeoutMs) });
+    } catch {
+      throw new CondensationError("Connection failed or timed out. Check resource state before retrying a mutation.", 0, null);
+    }
+    const text = await response.text();
+    let data;
+    try {
+      data = text ? JSON.parse(text) : void 0;
+    } catch {
+      throw new CondensationError("The server returned an invalid response.", response.status, null);
+    }
+    if (!response.ok) {
+      const error = data?.error;
+      throw new CondensationError(typeof error === "string" ? error : error?.message || `Request failed (${response.status})`, response.status, data);
+    }
+    return data;
+  }
+  wallet() {
+    return this.request("GET", "/v1/wallet");
+  }
+  list() {
+    return this.request("GET", "/v1/sandboxes");
+  }
+  get(id) {
+    return this.request("GET", `/v1/sandboxes/${identifier(id)}`);
+  }
+  create(options = {}) {
+    return this.request("POST", "/v1/sandboxes", options);
+  }
+  run(id, command, options = {}) {
+    return this.request("POST", `/v1/sandboxes/${identifier(id)}/exec`, { ...options, command });
+  }
+  runAsync(id, command, options = {}) {
+    return this.request("POST", `/v1/sandboxes/${identifier(id)}/exec`, { ...options, command, async: true });
+  }
+  execution(id, execId) {
+    return this.request("GET", `/v1/sandboxes/${identifier(id)}/exec/${identifier(execId)}`);
+  }
+  cancelExecution(id, execId) {
+    return this.request("DELETE", `/v1/sandboxes/${identifier(id)}/exec/${identifier(execId)}`);
+  }
+  uploadBase64(id, path, contentBase64) {
+    return this.request("POST", `/v1/sandboxes/${identifier(id)}/upload`, { path, contentBase64 });
+  }
+  downloadBase64(id, path) {
+    return this.request("POST", `/v1/sandboxes/${identifier(id)}/download`, { path });
+  }
+  meter(id) {
+    return this.request("GET", `/v1/sandboxes/${identifier(id)}/meter`);
+  }
+  stop(id) {
+    return this.request("POST", `/v1/sandboxes/${identifier(id)}/stop`, {});
+  }
+  start(id) {
+    return this.request("POST", `/v1/sandboxes/${identifier(id)}/start`, {});
+  }
+  delete(id) {
+    return this.request("DELETE", `/v1/sandboxes/${identifier(id)}`);
+  }
+};
+var index_default = Condensation;
+export {
+  Condensation,
+  CondensationError,
+  index_default as default
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "sourcesContent": ["export interface Wallet {\n  currency: 'USD'; accountId: string; purchasedMicroUsd: number;\n  reservedMicroUsd: number; debtMicroUsd: number; condensationBonusMicroUsd: number;\n}\nexport interface SandboxInfo {\n  id: string; state: string; cpu: number; memory: number; disk: number;\n  language?: string; labels?: Record<string,string>; reservedCreditsMicro?: number;\n}\nexport interface CreateOptions {\n  language?: 'javascript'|'typescript'|'python';\n  autoStopMinutes?: number;\n  labels?: Record<string,string>;\n}\nexport interface CommandOptions { cwd?: string; timeoutSeconds?: number; }\nexport interface CommandResult { exitCode: number; result: string; }\nexport interface AsyncCommand { execId: string; state: string; async: true; }\nexport interface ClientOptions {\n  apiKey?: string; baseUrl?: string; timeoutMs?: number;\n  /** Inject a standards-compliant fetch for testing or custom networking. */\n  fetch?: typeof globalThis.fetch;\n}\nexport class CondensationError extends Error {\n  constructor(message:string, public readonly status:number, public readonly details:unknown) {super(message);this.name='CondensationError';}\n}\nfunction identifier(value:string):string {\n  if(!/^[a-zA-Z0-9_-]+$/.test(value))throw new TypeError('Invalid sandbox or execution ID');\n  return value;\n}\nexport class Condensation {\n  private readonly apiKey:string;\n  private readonly baseUrl:string;\n  private readonly timeoutMs:number;\n  private readonly transport:typeof globalThis.fetch;\n  constructor(options:ClientOptions={}) {\n    const env=(globalThis as {process?:{env?:Record<string,string|undefined>}}).process?.env;\n    const apiKey=options.apiKey||env?.CONDENSATION_API_KEY;\n    if(!apiKey)throw new TypeError('Set CONDENSATION_API_KEY or pass apiKey');\n    const url=new URL(options.baseUrl||'https://api.condensation.ai');\n    const local=url.protocol==='http:'&&['localhost','127.0.0.1','[::1]'].includes(url.hostname);\n    if((url.protocol!=='https:'&&!local)||url.username||url.password||url.search||url.hash||url.pathname!=='/')throw new TypeError('baseUrl must be an HTTPS origin (HTTP is allowed for localhost)');\n    this.apiKey=apiKey;this.baseUrl=url.origin;this.timeoutMs=options.timeoutMs??120000;this.transport=options.fetch||globalThis.fetch;\n    if(!Number.isFinite(this.timeoutMs)||this.timeoutMs<=0)throw new TypeError('timeoutMs must be positive');\n  }\n  /** Requests are never retried automatically: a failed mutation may have succeeded. */\n  private async request<T>(method:string,path:string,body?:unknown):Promise<T> {\n    let response:Response;\n    try {response=await this.transport(this.baseUrl+path,{method,headers:{authorization:`Bearer ${this.apiKey}`,'content-type':'application/json'},body:body===undefined?undefined:JSON.stringify(body),redirect:'error',signal:AbortSignal.timeout(this.timeoutMs)});}\n    catch {throw new CondensationError('Connection failed or timed out. Check resource state before retrying a mutation.',0,null);}\n    const text=await response.text();let data:unknown;\n    try{data=text?JSON.parse(text):undefined;}catch{throw new CondensationError('The server returned an invalid response.',response.status,null);}\n    if(!response.ok){const error=(data as {error?:string|{message?:string}})?.error;throw new CondensationError(typeof error==='string'?error:error?.message||`Request failed (${response.status})`,response.status,data);}\n    return data as T;\n  }\n  wallet():Promise<Wallet>{return this.request('GET','/v1/wallet');}\n  list():Promise<SandboxInfo[]>{return this.request('GET','/v1/sandboxes');}\n  get(id:string):Promise<SandboxInfo>{return this.request('GET',`/v1/sandboxes/${identifier(id)}`);}\n  create(options:CreateOptions={}):Promise<SandboxInfo>{return this.request('POST','/v1/sandboxes',options);}\n  run(id:string,command:string,options:CommandOptions={}):Promise<CommandResult>{return this.request('POST',`/v1/sandboxes/${identifier(id)}/exec`,{...options,command});}\n  runAsync(id:string,command:string,options:CommandOptions={}):Promise<AsyncCommand>{return this.request('POST',`/v1/sandboxes/${identifier(id)}/exec`,{...options,command,async:true});}\n  execution(id:string,execId:string):Promise<Record<string,unknown>>{return this.request('GET',`/v1/sandboxes/${identifier(id)}/exec/${identifier(execId)}`);}\n  cancelExecution(id:string,execId:string):Promise<Record<string,unknown>>{return this.request('DELETE',`/v1/sandboxes/${identifier(id)}/exec/${identifier(execId)}`);}\n  uploadBase64(id:string,path:string,contentBase64:string):Promise<{ok:boolean}>{return this.request('POST',`/v1/sandboxes/${identifier(id)}/upload`,{path,contentBase64});}\n  downloadBase64(id:string,path:string):Promise<{contentBase64:string}>{return this.request('POST',`/v1/sandboxes/${identifier(id)}/download`,{path});}\n  meter(id:string):Promise<Record<string,unknown>>{return this.request('GET',`/v1/sandboxes/${identifier(id)}/meter`);}\n  stop(id:string):Promise<Record<string,unknown>>{return this.request('POST',`/v1/sandboxes/${identifier(id)}/stop`,{});}\n  start(id:string):Promise<Record<string,unknown>>{return this.request('POST',`/v1/sandboxes/${identifier(id)}/start`,{});}\n  delete(id:string):Promise<void>{return this.request('DELETE',`/v1/sandboxes/${identifier(id)}`);}\n}\nexport default Condensation;\n"],
+  "mappings": "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",
+  "names": []
+}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "condensationai",
+  "version": "0.1.0",
+  "description": "Condensation SDK for sandbox infrastructure and the shared Codegraff wallet",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "node build.mjs",
+    "test": "node --test test/*.test.mjs",
+    "prepack": "npm run build && npm test"
+  },
+  "license": "MIT",
+  "homepage": "https://workspaces.condensation.ai/docs/sdk",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "condensation",
+    "sandbox",
+    "codegraff",
+    "ai",
+    "typescript"
+  ],
+  "devDependencies": {
+    "esbuild": "0.25.0",
+    "typescript": "5.9.3"
+  }
+}