sandbox-agent 0.0.1 → 0.1.0-rc.1

package/dist/index.js

@@ -0,0 +1,254 @@
+// src/client.ts
+var API_PREFIX = "/v1";
+var SandboxAgentError = class extends Error {
+  status;
+  problem;
+  response;
+  constructor(status, problem, response) {
+    super(problem?.title ?? `Request failed with status ${status}`);
+    this.name = "SandboxAgentError";
+    this.status = status;
+    this.problem = problem;
+    this.response = response;
+  }
+};
+var SandboxAgent = class _SandboxAgent {
+  baseUrl;
+  token;
+  fetcher;
+  defaultHeaders;
+  spawnHandle;
+  constructor(options) {
+    this.baseUrl = options.baseUrl.replace(/\/$/, "");
+    this.token = options.token;
+    this.fetcher = options.fetch ?? globalThis.fetch;
+    this.defaultHeaders = options.headers;
+    if (!this.fetcher) {
+      throw new Error("Fetch API is not available; provide a fetch implementation.");
+    }
+  }
+  static async connect(options) {
+    return new _SandboxAgent(options);
+  }
+  static async start(options = {}) {
+    const spawnOptions = normalizeSpawnOptions(options.spawn, true);
+    if (!spawnOptions.enabled) {
+      throw new Error("SandboxAgent.start requires spawn to be enabled.");
+    }
+    const { spawnSandboxAgent } = await import("./spawn-BT4YX7BC.js");
+    const handle = await spawnSandboxAgent(spawnOptions, options.fetch ?? globalThis.fetch);
+    const client = new _SandboxAgent({
+      baseUrl: handle.baseUrl,
+      token: handle.token,
+      fetch: options.fetch,
+      headers: options.headers
+    });
+    client.spawnHandle = handle;
+    return client;
+  }
+  async listAgents() {
+    return this.requestJson("GET", `${API_PREFIX}/agents`);
+  }
+  async getHealth() {
+    return this.requestJson("GET", `${API_PREFIX}/health`);
+  }
+  async installAgent(agent, request = {}) {
+    await this.requestJson("POST", `${API_PREFIX}/agents/${encodeURIComponent(agent)}/install`, {
+      body: request
+    });
+  }
+  async getAgentModes(agent) {
+    return this.requestJson("GET", `${API_PREFIX}/agents/${encodeURIComponent(agent)}/modes`);
+  }
+  async createSession(sessionId, request) {
+    return this.requestJson("POST", `${API_PREFIX}/sessions/${encodeURIComponent(sessionId)}`, {
+      body: request
+    });
+  }
+  async listSessions() {
+    return this.requestJson("GET", `${API_PREFIX}/sessions`);
+  }
+  async postMessage(sessionId, request) {
+    await this.requestJson("POST", `${API_PREFIX}/sessions/${encodeURIComponent(sessionId)}/messages`, {
+      body: request
+    });
+  }
+  async getEvents(sessionId, query) {
+    return this.requestJson("GET", `${API_PREFIX}/sessions/${encodeURIComponent(sessionId)}/events`, {
+      query
+    });
+  }
+  async getEventsSse(sessionId, query, signal) {
+    return this.requestRaw("GET", `${API_PREFIX}/sessions/${encodeURIComponent(sessionId)}/events/sse`, {
+      query,
+      accept: "text/event-stream",
+      signal
+    });
+  }
+  async postMessageStream(sessionId, request, query, signal) {
+    return this.requestRaw("POST", `${API_PREFIX}/sessions/${encodeURIComponent(sessionId)}/messages/stream`, {
+      query,
+      body: request,
+      accept: "text/event-stream",
+      signal
+    });
+  }
+  async *streamEvents(sessionId, query, signal) {
+    const response = await this.getEventsSse(sessionId, query, signal);
+    yield* this.parseSseStream(response);
+  }
+  async *streamTurn(sessionId, request, query, signal) {
+    const response = await this.postMessageStream(sessionId, request, query, signal);
+    yield* this.parseSseStream(response);
+  }
+  async replyQuestion(sessionId, questionId, request) {
+    await this.requestJson(
+      "POST",
+      `${API_PREFIX}/sessions/${encodeURIComponent(sessionId)}/questions/${encodeURIComponent(questionId)}/reply`,
+      { body: request }
+    );
+  }
+  async rejectQuestion(sessionId, questionId) {
+    await this.requestJson(
+      "POST",
+      `${API_PREFIX}/sessions/${encodeURIComponent(sessionId)}/questions/${encodeURIComponent(questionId)}/reject`
+    );
+  }
+  async replyPermission(sessionId, permissionId, request) {
+    await this.requestJson(
+      "POST",
+      `${API_PREFIX}/sessions/${encodeURIComponent(sessionId)}/permissions/${encodeURIComponent(permissionId)}/reply`,
+      { body: request }
+    );
+  }
+  async terminateSession(sessionId) {
+    await this.requestJson("POST", `${API_PREFIX}/sessions/${encodeURIComponent(sessionId)}/terminate`);
+  }
+  async dispose() {
+    if (this.spawnHandle) {
+      await this.spawnHandle.dispose();
+      this.spawnHandle = void 0;
+    }
+  }
+  async requestJson(method, path, options = {}) {
+    const response = await this.requestRaw(method, path, {
+      query: options.query,
+      body: options.body,
+      headers: options.headers,
+      accept: options.accept ?? "application/json"
+    });
+    if (response.status === 204) {
+      return void 0;
+    }
+    const text = await response.text();
+    if (!text) {
+      return void 0;
+    }
+    return JSON.parse(text);
+  }
+  async requestRaw(method, path, options = {}) {
+    const url = this.buildUrl(path, options.query);
+    const headers = new Headers(this.defaultHeaders ?? void 0);
+    if (this.token) {
+      headers.set("Authorization", `Bearer ${this.token}`);
+    }
+    if (options.accept) {
+      headers.set("Accept", options.accept);
+    }
+    const init = { method, headers, signal: options.signal };
+    if (options.body !== void 0) {
+      headers.set("Content-Type", "application/json");
+      init.body = JSON.stringify(options.body);
+    }
+    if (options.headers) {
+      const extra = new Headers(options.headers);
+      extra.forEach((value, key) => headers.set(key, value));
+    }
+    const response = await this.fetcher(url, init);
+    if (!response.ok) {
+      const problem = await this.readProblem(response);
+      throw new SandboxAgentError(response.status, problem, response);
+    }
+    return response;
+  }
+  buildUrl(path, query) {
+    const url = new URL(`${this.baseUrl}${path}`);
+    if (query) {
+      Object.entries(query).forEach(([key, value]) => {
+        if (value === void 0 || value === null) {
+          return;
+        }
+        url.searchParams.set(key, String(value));
+      });
+    }
+    return url.toString();
+  }
+  async readProblem(response) {
+    try {
+      const text = await response.clone().text();
+      if (!text) {
+        return void 0;
+      }
+      return JSON.parse(text);
+    } catch {
+      return void 0;
+    }
+  }
+  async *parseSseStream(response) {
+    if (!response.body) {
+      throw new Error("SSE stream is not readable in this environment.");
+    }
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) {
+        break;
+      }
+      buffer += decoder.decode(value, { stream: true }).replace(/\r\n/g, "\n");
+      let index = buffer.indexOf("\n\n");
+      while (index !== -1) {
+        const chunk = buffer.slice(0, index);
+        buffer = buffer.slice(index + 2);
+        const dataLines = chunk.split("\n").filter((line) => line.startsWith("data:"));
+        if (dataLines.length > 0) {
+          const payload = dataLines.map((line) => line.slice(5).trim()).join("\n");
+          if (payload) {
+            yield JSON.parse(payload);
+          }
+        }
+        index = buffer.indexOf("\n\n");
+      }
+    }
+  }
+};
+var normalizeSpawnOptions = (spawn, defaultEnabled) => {
+  if (typeof spawn === "boolean") {
+    return { enabled: spawn };
+  }
+  if (spawn) {
+    return { enabled: spawn.enabled ?? defaultEnabled, ...spawn };
+  }
+  return { enabled: defaultEnabled };
+};
+
+// src/inspector.ts
+var INSPECTOR_URL = "https://inspect.sandboxagent.dev";
+function buildInspectorUrl(options) {
+  const normalized = options.baseUrl.replace(/\/+$/, "");
+  const params = new URLSearchParams({ url: normalized });
+  if (options.token) {
+    params.set("token", options.token);
+  }
+  if (options.headers && Object.keys(options.headers).length > 0) {
+    params.set("headers", JSON.stringify(options.headers));
+  }
+  return `${INSPECTOR_URL}?${params.toString()}`;
+}
+export {
+  SandboxAgent,
+  SandboxAgentError,
+  buildInspectorUrl
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/inspector.ts"],"sourcesContent":["import type { SandboxAgentSpawnHandle, SandboxAgentSpawnOptions } from \"./spawn.ts\";\nimport type {\n  AgentInstallRequest,\n  AgentListResponse,\n  AgentModesResponse,\n  CreateSessionRequest,\n  CreateSessionResponse,\n  EventsQuery,\n  EventsResponse,\n  HealthResponse,\n  MessageRequest,\n  PermissionReplyRequest,\n  ProblemDetails,\n  QuestionReplyRequest,\n  SessionListResponse,\n  TurnStreamQuery,\n  UniversalEvent,\n} from \"./types.ts\";\n\nconst API_PREFIX = \"/v1\";\n\nexport interface SandboxAgentConnectOptions {\n  baseUrl: string;\n  token?: string;\n  fetch?: typeof fetch;\n  headers?: HeadersInit;\n}\n\nexport interface SandboxAgentStartOptions {\n  spawn?: SandboxAgentSpawnOptions | boolean;\n  fetch?: typeof fetch;\n  headers?: HeadersInit;\n}\n\nexport class SandboxAgentError extends Error {\n  readonly status: number;\n  readonly problem?: ProblemDetails;\n  readonly response: Response;\n\n  constructor(status: number, problem: ProblemDetails | undefined, response: Response) {\n    super(problem?.title ?? `Request failed with status ${status}`);\n    this.name = \"SandboxAgentError\";\n    this.status = status;\n    this.problem = problem;\n    this.response = response;\n  }\n}\n\ntype QueryValue = string | number | boolean | null | undefined;\n\ntype RequestOptions = {\n  query?: Record<string, QueryValue>;\n  body?: unknown;\n  headers?: HeadersInit;\n  accept?: string;\n  signal?: AbortSignal;\n};\n\nexport class SandboxAgent {\n  private readonly baseUrl: string;\n  private readonly token?: string;\n  private readonly fetcher: typeof fetch;\n  private readonly defaultHeaders?: HeadersInit;\n  private spawnHandle?: SandboxAgentSpawnHandle;\n\n  private constructor(options: SandboxAgentConnectOptions) {\n    this.baseUrl = options.baseUrl.replace(/\\/$/, \"\");\n    this.token = options.token;\n    this.fetcher = options.fetch ?? globalThis.fetch;\n    this.defaultHeaders = options.headers;\n\n    if (!this.fetcher) {\n      throw new Error(\"Fetch API is not available; provide a fetch implementation.\");\n    }\n  }\n\n  static async connect(options: SandboxAgentConnectOptions): Promise<SandboxAgent> {\n    return new SandboxAgent(options);\n  }\n\n  static async start(options: SandboxAgentStartOptions = {}): Promise<SandboxAgent> {\n    const spawnOptions = normalizeSpawnOptions(options.spawn, true);\n    if (!spawnOptions.enabled) {\n      throw new Error(\"SandboxAgent.start requires spawn to be enabled.\");\n    }\n    const { spawnSandboxAgent } = await import(\"./spawn.js\");\n    const handle = await spawnSandboxAgent(spawnOptions, options.fetch ?? globalThis.fetch);\n    const client = new SandboxAgent({\n      baseUrl: handle.baseUrl,\n      token: handle.token,\n      fetch: options.fetch,\n      headers: options.headers,\n    });\n    client.spawnHandle = handle;\n    return client;\n  }\n\n  async listAgents(): Promise<AgentListResponse> {\n    return this.requestJson(\"GET\", `${API_PREFIX}/agents`);\n  }\n\n  async getHealth(): Promise<HealthResponse> {\n    return this.requestJson(\"GET\", `${API_PREFIX}/health`);\n  }\n\n  async installAgent(agent: string, request: AgentInstallRequest = {}): Promise<void> {\n    await this.requestJson(\"POST\", `${API_PREFIX}/agents/${encodeURIComponent(agent)}/install`, {\n      body: request,\n    });\n  }\n\n  async getAgentModes(agent: string): Promise<AgentModesResponse> {\n    return this.requestJson(\"GET\", `${API_PREFIX}/agents/${encodeURIComponent(agent)}/modes`);\n  }\n\n  async createSession(sessionId: string, request: CreateSessionRequest): Promise<CreateSessionResponse> {\n    return this.requestJson(\"POST\", `${API_PREFIX}/sessions/${encodeURIComponent(sessionId)}`, {\n      body: request,\n    });\n  }\n\n  async listSessions(): Promise<SessionListResponse> {\n    return this.requestJson(\"GET\", `${API_PREFIX}/sessions`);\n  }\n\n  async postMessage(sessionId: string, request: MessageRequest): Promise<void> {\n    await this.requestJson(\"POST\", `${API_PREFIX}/sessions/${encodeURIComponent(sessionId)}/messages`, {\n      body: request,\n    });\n  }\n\n  async getEvents(sessionId: string, query?: EventsQuery): Promise<EventsResponse> {\n    return this.requestJson(\"GET\", `${API_PREFIX}/sessions/${encodeURIComponent(sessionId)}/events`, {\n      query,\n    });\n  }\n\n  async getEventsSse(sessionId: string, query?: EventsQuery, signal?: AbortSignal): Promise<Response> {\n    return this.requestRaw(\"GET\", `${API_PREFIX}/sessions/${encodeURIComponent(sessionId)}/events/sse`, {\n      query,\n      accept: \"text/event-stream\",\n      signal,\n    });\n  }\n\n  async postMessageStream(\n    sessionId: string,\n    request: MessageRequest,\n    query?: TurnStreamQuery,\n    signal?: AbortSignal,\n  ): Promise<Response> {\n    return this.requestRaw(\"POST\", `${API_PREFIX}/sessions/${encodeURIComponent(sessionId)}/messages/stream`, {\n      query,\n      body: request,\n      accept: \"text/event-stream\",\n      signal,\n    });\n  }\n\n  async *streamEvents(\n    sessionId: string,\n    query?: EventsQuery,\n    signal?: AbortSignal,\n  ): AsyncGenerator<UniversalEvent, void, void> {\n    const response = await this.getEventsSse(sessionId, query, signal);\n    yield* this.parseSseStream(response);\n  }\n\n  async *streamTurn(\n    sessionId: string,\n    request: MessageRequest,\n    query?: TurnStreamQuery,\n    signal?: AbortSignal,\n  ): AsyncGenerator<UniversalEvent, void, void> {\n    const response = await this.postMessageStream(sessionId, request, query, signal);\n    yield* this.parseSseStream(response);\n  }\n\n  async replyQuestion(\n    sessionId: string,\n    questionId: string,\n    request: QuestionReplyRequest,\n  ): Promise<void> {\n    await this.requestJson(\n      \"POST\",\n      `${API_PREFIX}/sessions/${encodeURIComponent(sessionId)}/questions/${encodeURIComponent(questionId)}/reply`,\n      { body: request },\n    );\n  }\n\n  async rejectQuestion(sessionId: string, questionId: string): Promise<void> {\n    await this.requestJson(\n      \"POST\",\n      `${API_PREFIX}/sessions/${encodeURIComponent(sessionId)}/questions/${encodeURIComponent(questionId)}/reject`,\n    );\n  }\n\n  async replyPermission(\n    sessionId: string,\n    permissionId: string,\n    request: PermissionReplyRequest,\n  ): Promise<void> {\n    await this.requestJson(\n      \"POST\",\n      `${API_PREFIX}/sessions/${encodeURIComponent(sessionId)}/permissions/${encodeURIComponent(permissionId)}/reply`,\n      { body: request },\n    );\n  }\n\n  async terminateSession(sessionId: string): Promise<void> {\n    await this.requestJson(\"POST\", `${API_PREFIX}/sessions/${encodeURIComponent(sessionId)}/terminate`);\n  }\n\n  async dispose(): Promise<void> {\n    if (this.spawnHandle) {\n      await this.spawnHandle.dispose();\n      this.spawnHandle = undefined;\n    }\n  }\n\n  private async requestJson<T>(method: string, path: string, options: RequestOptions = {}): Promise<T> {\n    const response = await this.requestRaw(method, path, {\n      query: options.query,\n      body: options.body,\n      headers: options.headers,\n      accept: options.accept ?? \"application/json\",\n    });\n\n    if (response.status === 204) {\n      return undefined as T;\n    }\n\n    const text = await response.text();\n    if (!text) {\n      return undefined as T;\n    }\n\n    return JSON.parse(text) as T;\n  }\n\n  private async requestRaw(method: string, path: string, options: RequestOptions = {}): Promise<Response> {\n    const url = this.buildUrl(path, options.query);\n    const headers = new Headers(this.defaultHeaders ?? undefined);\n\n    if (this.token) {\n      headers.set(\"Authorization\", `Bearer ${this.token}`);\n    }\n\n    if (options.accept) {\n      headers.set(\"Accept\", options.accept);\n    }\n\n    const init: RequestInit = { method, headers, signal: options.signal };\n    if (options.body !== undefined) {\n      headers.set(\"Content-Type\", \"application/json\");\n      init.body = JSON.stringify(options.body);\n    }\n\n    if (options.headers) {\n      const extra = new Headers(options.headers);\n      extra.forEach((value, key) => headers.set(key, value));\n    }\n\n    const response = await this.fetcher(url, init);\n    if (!response.ok) {\n      const problem = await this.readProblem(response);\n      throw new SandboxAgentError(response.status, problem, response);\n    }\n\n    return response;\n  }\n\n  private buildUrl(path: string, query?: Record<string, QueryValue>): string {\n    const url = new URL(`${this.baseUrl}${path}`);\n    if (query) {\n      Object.entries(query).forEach(([key, value]) => {\n        if (value === undefined || value === null) {\n          return;\n        }\n        url.searchParams.set(key, String(value));\n      });\n    }\n    return url.toString();\n  }\n\n  private async readProblem(response: Response): Promise<ProblemDetails | undefined> {\n    try {\n      const text = await response.clone().text();\n      if (!text) {\n        return undefined;\n      }\n      return JSON.parse(text) as ProblemDetails;\n    } catch {\n      return undefined;\n    }\n  }\n\n  private async *parseSseStream(response: Response): AsyncGenerator<UniversalEvent, void, void> {\n    if (!response.body) {\n      throw new Error(\"SSE stream is not readable in this environment.\");\n    }\n\n    const reader = response.body.getReader();\n    const decoder = new TextDecoder();\n    let buffer = \"\";\n\n    while (true) {\n      const { done, value } = await reader.read();\n      if (done) {\n        break;\n      }\n      // Normalize CRLF to LF for consistent parsing\n      buffer += decoder.decode(value, { stream: true }).replace(/\\r\\n/g, \"\\n\");\n      let index = buffer.indexOf(\"\\n\\n\");\n      while (index !== -1) {\n        const chunk = buffer.slice(0, index);\n        buffer = buffer.slice(index + 2);\n        const dataLines = chunk\n          .split(\"\\n\")\n          .filter((line) => line.startsWith(\"data:\"));\n        if (dataLines.length > 0) {\n          const payload = dataLines\n            .map((line) => line.slice(5).trim())\n            .join(\"\\n\");\n          if (payload) {\n            yield JSON.parse(payload) as UniversalEvent;\n          }\n        }\n        index = buffer.indexOf(\"\\n\\n\");\n      }\n    }\n  }\n}\n\nconst normalizeSpawnOptions = (\n  spawn: SandboxAgentSpawnOptions | boolean | undefined,\n  defaultEnabled: boolean,\n): SandboxAgentSpawnOptions => {\n  if (typeof spawn === \"boolean\") {\n    return { enabled: spawn };\n  }\n  if (spawn) {\n    return { enabled: spawn.enabled ?? defaultEnabled, ...spawn };\n  }\n  return { enabled: defaultEnabled };\n};\n","const INSPECTOR_URL = \"https://inspect.sandboxagent.dev\";\n\nexport interface InspectorUrlOptions {\n  /**\n   * Base URL of the sandbox-agent server.\n   */\n  baseUrl: string;\n  /**\n   * Optional bearer token for authentication.\n   */\n  token?: string;\n  /**\n   * Optional extra headers to pass to the sandbox-agent server.\n   * Will be JSON-encoded in the URL.\n   */\n  headers?: Record<string, string>;\n}\n\n/**\n * Builds a URL to the sandbox-agent inspector UI with the given connection parameters.\n */\nexport function buildInspectorUrl(options: InspectorUrlOptions): string {\n  const normalized = options.baseUrl.replace(/\\/+$/, \"\");\n  const params = new URLSearchParams({ url: normalized });\n  if (options.token) {\n    params.set(\"token\", options.token);\n  }\n  if (options.headers && Object.keys(options.headers).length > 0) {\n    params.set(\"headers\", JSON.stringify(options.headers));\n  }\n  return `${INSPECTOR_URL}?${params.toString()}`;\n}\n"],"mappings":"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","names":[]}

package/dist/spawn-BT4YX7BC.js

@@ -0,0 +1,168 @@
+// src/spawn.ts
+var PLATFORM_PACKAGES = {
+  "darwin-arm64": "@sandbox-agent/cli-darwin-arm64",
+  "darwin-x64": "@sandbox-agent/cli-darwin-x64",
+  "linux-x64": "@sandbox-agent/cli-linux-x64",
+  "win32-x64": "@sandbox-agent/cli-win32-x64"
+};
+function isNodeRuntime() {
+  return typeof process !== "undefined" && !!process.versions?.node;
+}
+async function spawnSandboxAgent(options, fetcher) {
+  if (!isNodeRuntime()) {
+    throw new Error("Autospawn requires a Node.js runtime.");
+  }
+  const {
+    spawn
+  } = await import("child_process");
+  const crypto = await import("crypto");
+  const fs = await import("fs");
+  const path = await import("path");
+  const net = await import("net");
+  const { createRequire } = await import("module");
+  const bindHost = options.host ?? "127.0.0.1";
+  const port = options.port ?? await getFreePort(net, bindHost);
+  const connectHost = bindHost === "0.0.0.0" || bindHost === "::" ? "127.0.0.1" : bindHost;
+  const token = options.token ?? crypto.randomBytes(24).toString("hex");
+  const timeoutMs = options.timeoutMs ?? 15e3;
+  const logMode = options.log ?? "inherit";
+  const binaryPath = options.binaryPath ?? resolveBinaryFromEnv(fs, path) ?? resolveBinaryFromCliPackage(createRequire(import.meta.url), path, fs) ?? resolveBinaryFromPath(fs, path);
+  if (!binaryPath) {
+    throw new Error("sandbox-agent binary not found. Install @sandbox-agent/cli or set SANDBOX_AGENT_BIN.");
+  }
+  const stdio = logMode === "inherit" ? "inherit" : logMode === "silent" ? "ignore" : "pipe";
+  const args = ["server", "--host", bindHost, "--port", String(port), "--token", token];
+  const child = spawn(binaryPath, args, {
+    stdio,
+    env: {
+      ...process.env,
+      ...options.env ?? {}
+    }
+  });
+  const cleanup = registerProcessCleanup(child);
+  const baseUrl = `http://${connectHost}:${port}`;
+  const ready = waitForHealth(baseUrl, fetcher ?? globalThis.fetch, timeoutMs, child, token);
+  await ready;
+  const dispose = async () => {
+    if (child.exitCode !== null) {
+      cleanup.dispose();
+      return;
+    }
+    child.kill("SIGTERM");
+    const exited = await waitForExit(child, 5e3);
+    if (!exited) {
+      child.kill("SIGKILL");
+    }
+    cleanup.dispose();
+  };
+  return { baseUrl, token, child, dispose };
+}
+function resolveBinaryFromEnv(fs, path) {
+  const value = process.env.SANDBOX_AGENT_BIN;
+  if (!value) {
+    return null;
+  }
+  const resolved = path.resolve(value);
+  if (fs.existsSync(resolved)) {
+    return resolved;
+  }
+  return null;
+}
+function resolveBinaryFromCliPackage(require2, path, fs) {
+  const key = `${process.platform}-${process.arch}`;
+  const pkg = PLATFORM_PACKAGES[key];
+  if (!pkg) {
+    return null;
+  }
+  try {
+    const pkgPath = require2.resolve(`${pkg}/package.json`);
+    const bin = process.platform === "win32" ? "sandbox-agent.exe" : "sandbox-agent";
+    const resolved = path.join(path.dirname(pkgPath), "bin", bin);
+    return fs.existsSync(resolved) ? resolved : null;
+  } catch {
+    return null;
+  }
+}
+function resolveBinaryFromPath(fs, path) {
+  const pathEnv = process.env.PATH ?? "";
+  const separator = process.platform === "win32" ? ";" : ":";
+  const candidates = pathEnv.split(separator).filter(Boolean);
+  const bin = process.platform === "win32" ? "sandbox-agent.exe" : "sandbox-agent";
+  for (const dir of candidates) {
+    const resolved = path.join(dir, bin);
+    if (fs.existsSync(resolved)) {
+      return resolved;
+    }
+  }
+  return null;
+}
+async function getFreePort(net, host) {
+  return new Promise((resolve, reject) => {
+    const server = net.createServer();
+    server.unref();
+    server.on("error", reject);
+    server.listen(0, host, () => {
+      const address = server.address();
+      server.close(() => resolve(address.port));
+    });
+  });
+}
+async function waitForHealth(baseUrl, fetcher, timeoutMs, child, token) {
+  if (!fetcher) {
+    throw new Error("Fetch API is not available; provide a fetch implementation.");
+  }
+  const start = Date.now();
+  let lastError;
+  while (Date.now() - start < timeoutMs) {
+    if (child.exitCode !== null) {
+      throw new Error("sandbox-agent exited before becoming healthy.");
+    }
+    try {
+      const response = await fetcher(`${baseUrl}/v1/health`, {
+        headers: { Authorization: `Bearer ${token}` }
+      });
+      if (response.ok) {
+        return;
+      }
+      lastError = `status ${response.status}`;
+    } catch (err) {
+      lastError = err instanceof Error ? err.message : String(err);
+    }
+    await new Promise((resolve) => setTimeout(resolve, 200));
+  }
+  throw new Error(`Timed out waiting for sandbox-agent health (${lastError ?? "unknown error"}).`);
+}
+async function waitForExit(child, timeoutMs) {
+  if (child.exitCode !== null) {
+    return true;
+  }
+  return new Promise((resolve) => {
+    const timer = setTimeout(() => resolve(false), timeoutMs);
+    child.once("exit", () => {
+      clearTimeout(timer);
+      resolve(true);
+    });
+  });
+}
+function registerProcessCleanup(child) {
+  const handler = () => {
+    if (child.exitCode === null) {
+      child.kill("SIGTERM");
+    }
+  };
+  process.once("exit", handler);
+  process.once("SIGINT", handler);
+  process.once("SIGTERM", handler);
+  return {
+    dispose: () => {
+      process.off("exit", handler);
+      process.off("SIGINT", handler);
+      process.off("SIGTERM", handler);
+    }
+  };
+}
+export {
+  isNodeRuntime,
+  spawnSandboxAgent
+};
+//# sourceMappingURL=spawn-BT4YX7BC.js.map

package/dist/spawn-BT4YX7BC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/spawn.ts"],"sourcesContent":["import type { ChildProcess } from \"node:child_process\";\nimport type { AddressInfo } from \"node:net\";\n\nexport type SandboxAgentSpawnLogMode = \"inherit\" | \"pipe\" | \"silent\";\n\nexport type SandboxAgentSpawnOptions = {\n  enabled?: boolean;\n  host?: string;\n  port?: number;\n  token?: string;\n  binaryPath?: string;\n  timeoutMs?: number;\n  log?: SandboxAgentSpawnLogMode;\n  env?: Record<string, string>;\n};\n\nexport type SandboxAgentSpawnHandle = {\n  baseUrl: string;\n  token: string;\n  child: ChildProcess;\n  dispose: () => Promise<void>;\n};\n\nconst PLATFORM_PACKAGES: Record<string, string> = {\n  \"darwin-arm64\": \"@sandbox-agent/cli-darwin-arm64\",\n  \"darwin-x64\": \"@sandbox-agent/cli-darwin-x64\",\n  \"linux-x64\": \"@sandbox-agent/cli-linux-x64\",\n  \"win32-x64\": \"@sandbox-agent/cli-win32-x64\",\n};\n\nexport function isNodeRuntime(): boolean {\n  return typeof process !== \"undefined\" && !!process.versions?.node;\n}\n\nexport async function spawnSandboxAgent(\n  options: SandboxAgentSpawnOptions,\n  fetcher?: typeof fetch,\n): Promise<SandboxAgentSpawnHandle> {\n  if (!isNodeRuntime()) {\n    throw new Error(\"Autospawn requires a Node.js runtime.\");\n  }\n\n  const {\n    spawn,\n  } = await import(\"node:child_process\");\n  const crypto = await import(\"node:crypto\");\n  const fs = await import(\"node:fs\");\n  const path = await import(\"node:path\");\n  const net = await import(\"node:net\");\n  const { createRequire } = await import(\"node:module\");\n\n  const bindHost = options.host ?? \"127.0.0.1\";\n  const port = options.port ?? (await getFreePort(net, bindHost));\n  const connectHost = bindHost === \"0.0.0.0\" || bindHost === \"::\" ? \"127.0.0.1\" : bindHost;\n  const token = options.token ?? crypto.randomBytes(24).toString(\"hex\");\n  const timeoutMs = options.timeoutMs ?? 15_000;\n  const logMode: SandboxAgentSpawnLogMode = options.log ?? \"inherit\";\n\n  const binaryPath =\n    options.binaryPath ??\n    resolveBinaryFromEnv(fs, path) ??\n    resolveBinaryFromCliPackage(createRequire(import.meta.url), path, fs) ??\n    resolveBinaryFromPath(fs, path);\n\n  if (!binaryPath) {\n    throw new Error(\"sandbox-agent binary not found. Install @sandbox-agent/cli or set SANDBOX_AGENT_BIN.\");\n  }\n\n  const stdio = logMode === \"inherit\" ? \"inherit\" : logMode === \"silent\" ? \"ignore\" : \"pipe\";\n  const args = [\"server\", \"--host\", bindHost, \"--port\", String(port), \"--token\", token];\n  const child = spawn(binaryPath, args, {\n    stdio,\n    env: {\n      ...process.env,\n      ...(options.env ?? {}),\n    },\n  });\n  const cleanup = registerProcessCleanup(child);\n\n  const baseUrl = `http://${connectHost}:${port}`;\n  const ready = waitForHealth(baseUrl, fetcher ?? globalThis.fetch, timeoutMs, child, token);\n\n  await ready;\n\n  const dispose = async () => {\n    if (child.exitCode !== null) {\n      cleanup.dispose();\n      return;\n    }\n    child.kill(\"SIGTERM\");\n    const exited = await waitForExit(child, 5_000);\n    if (!exited) {\n      child.kill(\"SIGKILL\");\n    }\n    cleanup.dispose();\n  };\n\n  return { baseUrl, token, child, dispose };\n}\n\nfunction resolveBinaryFromEnv(fs: typeof import(\"node:fs\"), path: typeof import(\"node:path\")): string | null {\n  const value = process.env.SANDBOX_AGENT_BIN;\n  if (!value) {\n    return null;\n  }\n  const resolved = path.resolve(value);\n  if (fs.existsSync(resolved)) {\n    return resolved;\n  }\n  return null;\n}\n\nfunction resolveBinaryFromCliPackage(\n  require: ReturnType<typeof import(\"node:module\").createRequire>,\n  path: typeof import(\"node:path\"),\n  fs: typeof import(\"node:fs\"),\n): string | null {\n  const key = `${process.platform}-${process.arch}`;\n  const pkg = PLATFORM_PACKAGES[key];\n  if (!pkg) {\n    return null;\n  }\n  try {\n    const pkgPath = require.resolve(`${pkg}/package.json`);\n    const bin = process.platform === \"win32\" ? \"sandbox-agent.exe\" : \"sandbox-agent\";\n    const resolved = path.join(path.dirname(pkgPath), \"bin\", bin);\n    return fs.existsSync(resolved) ? resolved : null;\n  } catch {\n    return null;\n  }\n}\n\nfunction resolveBinaryFromPath(fs: typeof import(\"node:fs\"), path: typeof import(\"node:path\")): string | null {\n  const pathEnv = process.env.PATH ?? \"\";\n  const separator = process.platform === \"win32\" ? \";\" : \":\";\n  const candidates = pathEnv.split(separator).filter(Boolean);\n  const bin = process.platform === \"win32\" ? \"sandbox-agent.exe\" : \"sandbox-agent\";\n  for (const dir of candidates) {\n    const resolved = path.join(dir, bin);\n    if (fs.existsSync(resolved)) {\n      return resolved;\n    }\n  }\n  return null;\n}\n\nasync function getFreePort(net: typeof import(\"node:net\"), host: string): Promise<number> {\n  return new Promise((resolve, reject) => {\n    const server = net.createServer();\n    server.unref();\n    server.on(\"error\", reject);\n    server.listen(0, host, () => {\n      const address = server.address() as AddressInfo;\n      server.close(() => resolve(address.port));\n    });\n  });\n}\n\nasync function waitForHealth(\n  baseUrl: string,\n  fetcher: typeof fetch | undefined,\n  timeoutMs: number,\n  child: ChildProcess,\n  token: string,\n): Promise<void> {\n  if (!fetcher) {\n    throw new Error(\"Fetch API is not available; provide a fetch implementation.\");\n  }\n  const start = Date.now();\n  let lastError: string | undefined;\n\n  while (Date.now() - start < timeoutMs) {\n    if (child.exitCode !== null) {\n      throw new Error(\"sandbox-agent exited before becoming healthy.\");\n    }\n    try {\n      const response = await fetcher(`${baseUrl}/v1/health`, {\n        headers: { Authorization: `Bearer ${token}` },\n      });\n      if (response.ok) {\n        return;\n      }\n      lastError = `status ${response.status}`;\n    } catch (err) {\n      lastError = err instanceof Error ? err.message : String(err);\n    }\n    await new Promise((resolve) => setTimeout(resolve, 200));\n  }\n\n  throw new Error(`Timed out waiting for sandbox-agent health (${lastError ?? \"unknown error\"}).`);\n}\n\nasync function waitForExit(child: ChildProcess, timeoutMs: number): Promise<boolean> {\n  if (child.exitCode !== null) {\n    return true;\n  }\n  return new Promise((resolve) => {\n    const timer = setTimeout(() => resolve(false), timeoutMs);\n    child.once(\"exit\", () => {\n      clearTimeout(timer);\n      resolve(true);\n    });\n  });\n}\n\nfunction registerProcessCleanup(child: ChildProcess): { dispose: () => void } {\n  const handler = () => {\n    if (child.exitCode === null) {\n      child.kill(\"SIGTERM\");\n    }\n  };\n\n  process.once(\"exit\", handler);\n  process.once(\"SIGINT\", handler);\n  process.once(\"SIGTERM\", handler);\n\n  return {\n    dispose: () => {\n      process.off(\"exit\", handler);\n      process.off(\"SIGINT\", handler);\n      process.off(\"SIGTERM\", handler);\n    },\n  };\n}\n"],"mappings":"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","names":["require"]}

package/package.json

@@ -1,11 +1,41 @@
 {
   "name": "sandbox-agent",
-  "version": "0.0.1",
-  "description": "Universal API for automatic coding agents in sandboxes. Supports Claude Code, Codex, OpenCode, and Amp.",
+  "version": "0.1.0-rc.1",
+  "description": "Universal API for automatic coding agents in sandboxes. Supprots Claude Code, Codex, OpenCode, and Amp.",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/rivet-dev/sandbox-agent"
   },
-  "main": "index.js"
-}
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "openapi-typescript": "^6.7.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "optionalDependencies": {
+    "@sandbox-agent/cli": "0.1.0"
+  },
+  "scripts": {
+    "generate:openapi": "cargo check -p sandbox-agent-openapi-gen && cargo run -p sandbox-agent-openapi-gen -- --out ../../docs/openapi.json",
+    "generate:types": "openapi-typescript ../../docs/openapi.json -o src/generated/openapi.ts",
+    "generate": "pnpm run generate:openapi && pnpm run generate:types",
+    "build": "if [ -z \"$SKIP_OPENAPI_GEN\" ]; then pnpm run generate:openapi; fi && pnpm run generate:types && tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}

package/index.js

@@ -1 +0,0 @@
-module.exports = {};