@tool-bridge/server 0.1.1 → 0.3.0

package/dist/e2b-NFSUHTZR.js

@@ -0,0 +1,305 @@
+import {
+  createProviderPlugin,
+  guardedFetch,
+  requireApiKey,
+  upstreamError
+} from "./chunk-CSJEZHQO.js";
+import "./chunk-K7FVSFUX.js";
+import {
+  TBError,
+  external_exports
+} from "./chunk-JLTYA2B3.js";
+import "./chunk-MLKGABMK.js";
+
+// ../plugins/src/e2b/api.ts
+var SERVICE = "e2b";
+var API_BASE = "https://api.e2b.app";
+var REQUEST_TIMEOUT_MS = 3e4;
+function text(value) {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return trimmed === "" ? void 0 : trimmed;
+}
+function record(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+}
+function compact(input) {
+  return Object.fromEntries(
+    Object.entries(input).filter(([, value]) => value !== void 0)
+  );
+}
+function requireText(value, field) {
+  const result = text(value);
+  if (result === void 0) throw new TBError("invalid_argument", `${field} is required.`);
+  return result;
+}
+function requireRecord(value, label) {
+  const result = record(value);
+  if (result === void 0) throw upstreamError(502, `${label} was not an object`);
+  return result;
+}
+function stringArray(value) {
+  if (!Array.isArray(value)) return void 0;
+  const items = value.filter((item) => typeof item === "string" && item !== "");
+  return items.length > 0 ? items : void 0;
+}
+function errorMessage(payload, status) {
+  if (typeof payload === "string") {
+    const trimmed = payload.trim();
+    if (trimmed !== "") return trimmed;
+  }
+  const body = record(payload);
+  return text(body?.message) ?? text(body?.error) ?? text(body?.detail) ?? `E2B request failed with status ${status}`;
+}
+function buildUrl(path, query) {
+  const url = new URL(`${API_BASE}${path}`);
+  for (const [key, value] of Object.entries(query ?? {})) {
+    if (value === void 0) continue;
+    url.searchParams.set(key, Array.isArray(value) ? value.join(",") : String(value));
+  }
+  return url.toString();
+}
+async function request(ctx, options) {
+  const headers = {
+    "accept": "application/json",
+    "x-api-key": requireApiKey(ctx, SERVICE)
+  };
+  if (options.body !== void 0) headers["content-type"] = "application/json";
+  let response;
+  try {
+    response = await guardedFetch(buildUrl(options.path, options.query), {
+      method: options.method ?? "GET",
+      headers,
+      signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+      ...options.body === void 0 ? {} : { body: JSON.stringify(options.body) }
+    });
+  } catch (error) {
+    if (error instanceof TBError) throw error;
+    if (error instanceof Error && error.name === "TimeoutError") {
+      throw upstreamError(504, `E2B ${REQUEST_TIMEOUT_MS / 1e3}s \u5185\u6CA1\u6709\u8FD4\u56DE`);
+    }
+    throw upstreamError(502, error instanceof Error ? `E2B request failed: ${error.message}` : "E2B request failed");
+  }
+  const raw = response.status === 204 ? "" : await response.text().catch(() => "");
+  let payload = raw === "" ? options.emptySuccess ?? null : null;
+  if (raw !== "") {
+    try {
+      payload = JSON.parse(raw);
+    } catch {
+      if (!response.ok) payload = raw;
+      else throw upstreamError(502, "E2B returned invalid JSON");
+    }
+  }
+  if (!response.ok) throw upstreamError(response.status, errorMessage(payload, response.status));
+  return payload;
+}
+async function requestSandboxArray(ctx, options) {
+  const payload = await request(ctx, options);
+  if (!Array.isArray(payload)) throw upstreamError(502, "E2B returned a non-array sandboxes payload");
+  return payload.map((sandbox) => requireRecord(sandbox, "E2B sandbox"));
+}
+async function createSandbox(input, ctx) {
+  const payload = await request(ctx, {
+    // 创建走的是 v1 路径,不是列表那个 /v2/sandboxes。
+    path: "/sandboxes",
+    method: "POST",
+    body: compact({
+      templateID: requireText(input.templateID, "templateID"),
+      timeout: input.timeout,
+      autoPause: input.autoPause,
+      autoPauseMemory: input.autoPauseMemory,
+      autoResume: input.autoResume,
+      secure: input.secure,
+      allow_internet_access: input.allow_internet_access,
+      network: input.network,
+      metadata: input.metadata,
+      envVars: input.envVars,
+      // `mcp: null` 是"显式关掉 MCP",与"没给这个字段"不是一回事,故不能被 compact 掉。
+      mcp: input.mcp === null ? null : record(input.mcp),
+      volumeMounts: input.volumeMounts
+    })
+  });
+  return { sandbox: requireRecord(payload, "E2B create sandbox response") };
+}
+async function listSandboxes(input, ctx) {
+  const sandboxes = await requestSandboxArray(ctx, {
+    path: "/v2/sandboxes",
+    query: compact({
+      metadata: text(input.metadata),
+      state: stringArray(input.state),
+      nextToken: text(input.nextToken),
+      limit: input.limit
+    })
+  });
+  return { sandboxes };
+}
+async function getSandbox(input, ctx) {
+  const sandboxID = requireText(input.sandboxID, "sandboxID");
+  const payload = await request(ctx, { path: `/sandboxes/${encodeURIComponent(sandboxID)}` });
+  return { sandbox: requireRecord(payload, "E2B get sandbox response") };
+}
+async function deleteSandbox(input, ctx) {
+  const sandboxID = requireText(input.sandboxID, "sandboxID");
+  await request(ctx, {
+    path: `/sandboxes/${encodeURIComponent(sandboxID)}`,
+    method: "DELETE",
+    // 删除成功是 204 空 body,出参 schema 要的这个形状由本层合成。
+    emptySuccess: { sandboxID, success: true }
+  });
+  return { sandboxID, success: true };
+}
+
+// ../plugins/src/e2b/schema.ts
+var createSandboxInput = external_exports.strictObject({
+  templateID: external_exports.string().min(1).regex(new RegExp("\\S")).describe("The E2B template identifier used to create the sandbox."),
+  timeout: external_exports.int().min(0).describe("Time to live for the sandbox in seconds.").optional(),
+  autoPause: external_exports.boolean().describe("Whether E2B should automatically pause the sandbox after timeout.").optional(),
+  autoPauseMemory: external_exports.boolean().describe("Whether auto-pause should preserve the sandbox memory snapshot when autoPause is true.").optional(),
+  autoResume: external_exports.strictObject({
+    enabled: external_exports.boolean().describe("Whether auto-resume is enabled for paused sandboxes.").optional()
+  }).describe("Auto-resume configuration for paused sandboxes.").optional(),
+  secure: external_exports.boolean().describe("Whether E2B should secure all system communication with the sandbox.").optional(),
+  allow_internet_access: external_exports.boolean().describe("Whether the sandbox can access the internet.").optional(),
+  network: external_exports.looseObject({
+    allowPublicTraffic: external_exports.boolean().describe("Whether sandbox URLs are publicly accessible.").optional(),
+    allowOut: external_exports.array(external_exports.string().describe("One allowed destination such as a CIDR block, IP address, or domain.")).describe("Allowed outbound destinations for sandbox egress traffic.").optional(),
+    denyOut: external_exports.array(external_exports.string().describe("One denied CIDR block or IP address.")).describe("Denied outbound CIDR blocks or IP addresses for sandbox egress traffic.").optional(),
+    egressProxy: external_exports.looseObject({}).describe("The egress proxy configuration returned or accepted by E2B.").nullable().optional(),
+    maskRequestHost: external_exports.string().describe("The host mask used for sandbox requests.").optional(),
+    rules: external_exports.looseObject({}).describe("Per-domain outbound request transform rules.").optional()
+  }).describe("The E2B sandbox network configuration object.").optional(),
+  metadata: external_exports.record(external_exports.string(), external_exports.string().describe("One sandbox metadata value.")).describe("String metadata attached to the sandbox.").optional(),
+  envVars: external_exports.record(external_exports.string(), external_exports.string().describe("One sandbox environment variable value.")).describe("Environment variables passed to the sandbox.").optional(),
+  mcp: external_exports.looseObject({}).describe("MCP configuration for the sandbox.").nullable().optional(),
+  volumeMounts: external_exports.array(external_exports.strictObject({
+    name: external_exports.string().describe("The volume name.").optional(),
+    path: external_exports.string().describe("The volume mount path inside the sandbox.").optional()
+  }).describe("An E2B sandbox volume mount.")).describe("Volume mounts to attach to the sandbox.").optional()
+}).describe("The input payload for creating an E2B sandbox.");
+var createSandboxOutput = external_exports.strictObject({
+  sandbox: external_exports.looseObject({
+    templateID: external_exports.string().describe("Identifier of the template from which the sandbox was created.").optional(),
+    sandboxID: external_exports.string().describe("Identifier of the sandbox.").optional(),
+    alias: external_exports.string().describe("Alias of the template when returned by E2B.").optional(),
+    clientID: external_exports.string().describe("Deprecated E2B client identifier.").optional(),
+    envdVersion: external_exports.string().describe("Version of envd running in the sandbox.").optional(),
+    envdAccessToken: external_exports.string().describe("Access token for envd requests when the sandbox is secure.").nullable().optional(),
+    trafficAccessToken: external_exports.string().describe("Token required for accessing the sandbox through the E2B proxy when returned.").nullable().optional(),
+    domain: external_exports.string().describe("Deprecated E2B sandbox domain field.").nullable().optional()
+  }).describe("The E2B sandbox created by the API.").optional()
+}).describe("The response returned when creating an E2B sandbox.");
+var listSandboxesInput = external_exports.strictObject({
+  metadata: external_exports.string().min(1).describe('Metadata query used to filter sandboxes, such as "user=abc&app=prod". Keys and values must already be URL encoded.').optional(),
+  state: external_exports.array(external_exports.enum(["running", "paused"]).describe("The E2B sandbox lifecycle state.")).min(1).describe("Sandbox states used to filter the list.").optional(),
+  nextToken: external_exports.string().min(1).describe("Cursor returned by E2B for the next page.").optional(),
+  limit: external_exports.int().min(1).max(100).describe("Maximum number of sandboxes to return per page.").optional()
+}).describe("The input payload for listing E2B sandboxes.");
+var listSandboxesOutput = external_exports.strictObject({
+  sandboxes: external_exports.array(external_exports.looseObject({
+    templateID: external_exports.string().describe("Identifier of the template from which the sandbox was created.").optional(),
+    alias: external_exports.string().describe("Alias of the template when returned by E2B.").optional(),
+    sandboxID: external_exports.string().describe("Identifier of the sandbox.").optional(),
+    clientID: external_exports.string().describe("Deprecated E2B client identifier.").optional(),
+    startedAt: external_exports.iso.datetime({ offset: true }).describe("Time when the sandbox was started.").optional(),
+    endAt: external_exports.iso.datetime({ offset: true }).describe("Time when the sandbox will expire.").optional(),
+    cpuCount: external_exports.int().describe("CPU cores allocated to the sandbox.").optional(),
+    memoryMB: external_exports.int().describe("Memory allocated to the sandbox in MiB.").optional(),
+    diskSizeMB: external_exports.int().describe("Disk size allocated to the sandbox in MiB.").optional(),
+    metadata: external_exports.record(external_exports.string(), external_exports.string().describe("One sandbox metadata value.")).describe("String metadata attached to the sandbox.").optional(),
+    state: external_exports.enum(["running", "paused"]).describe("The E2B sandbox lifecycle state.").optional(),
+    envdVersion: external_exports.string().describe("Version of envd running in the sandbox.").optional(),
+    volumeMounts: external_exports.array(external_exports.strictObject({
+      name: external_exports.string().describe("The volume name.").optional(),
+      path: external_exports.string().describe("The volume mount path inside the sandbox.").optional()
+    }).describe("An E2B sandbox volume mount.")).describe("Volume mounts attached to the sandbox.").optional()
+  }).describe("An E2B sandbox returned by the sandbox list endpoint.")).describe("The sandboxes returned by E2B.").optional()
+}).describe("The response returned when listing E2B sandboxes.");
+var getSandboxInput = external_exports.strictObject({
+  sandboxID: external_exports.string().min(1).regex(new RegExp("\\S")).describe("The E2B sandbox identifier.").optional()
+}).describe("The input payload for selecting an E2B sandbox.");
+var getSandboxOutput = external_exports.strictObject({
+  sandbox: external_exports.looseObject({
+    templateID: external_exports.string().describe("Identifier of the template from which the sandbox was created.").optional(),
+    alias: external_exports.string().describe("Alias of the template when returned by E2B.").optional(),
+    sandboxID: external_exports.string().describe("Identifier of the sandbox.").optional(),
+    clientID: external_exports.string().describe("Deprecated E2B client identifier.").optional(),
+    startedAt: external_exports.iso.datetime({ offset: true }).describe("Time when the sandbox was started.").optional(),
+    endAt: external_exports.iso.datetime({ offset: true }).describe("Time when the sandbox will expire.").optional(),
+    envdVersion: external_exports.string().describe("Version of envd running in the sandbox.").optional(),
+    envdAccessToken: external_exports.string().describe("Access token for envd requests when the sandbox is secure.").nullable().optional(),
+    trafficAccessToken: external_exports.string().describe("Token required for accessing the sandbox through the E2B proxy when returned.").nullable().optional(),
+    domain: external_exports.string().describe("Deprecated E2B sandbox domain field.").nullable().optional(),
+    allowInternetAccess: external_exports.boolean().describe("Whether internet access was explicitly enabled or disabled for the sandbox.").nullable().optional(),
+    cpuCount: external_exports.int().describe("CPU cores allocated to the sandbox.").optional(),
+    memoryMB: external_exports.int().describe("Memory allocated to the sandbox in MiB.").optional(),
+    diskSizeMB: external_exports.int().describe("Disk size allocated to the sandbox in MiB.").optional(),
+    metadata: external_exports.record(external_exports.string(), external_exports.string().describe("One sandbox metadata value.")).describe("String metadata attached to the sandbox.").optional(),
+    state: external_exports.enum(["running", "paused"]).describe("The E2B sandbox lifecycle state.").optional(),
+    network: external_exports.looseObject({
+      allowPublicTraffic: external_exports.boolean().describe("Whether sandbox URLs are publicly accessible.").optional(),
+      allowOut: external_exports.array(external_exports.string().describe("One allowed destination such as a CIDR block, IP address, or domain.")).describe("Allowed outbound destinations for sandbox egress traffic.").optional(),
+      denyOut: external_exports.array(external_exports.string().describe("One denied CIDR block or IP address.")).describe("Denied outbound CIDR blocks or IP addresses for sandbox egress traffic.").optional(),
+      egressProxy: external_exports.looseObject({}).describe("The egress proxy configuration returned or accepted by E2B.").nullable().optional(),
+      maskRequestHost: external_exports.string().describe("The host mask used for sandbox requests.").optional(),
+      rules: external_exports.looseObject({}).describe("Per-domain outbound request transform rules.").optional()
+    }).describe("The E2B sandbox network configuration object.").optional(),
+    lifecycle: external_exports.looseObject({}).describe("Sandbox lifecycle configuration returned by E2B.").optional(),
+    volumeMounts: external_exports.array(external_exports.strictObject({
+      name: external_exports.string().describe("The volume name.").optional(),
+      path: external_exports.string().describe("The volume mount path inside the sandbox.").optional()
+    }).describe("An E2B sandbox volume mount.")).describe("Volume mounts attached to the sandbox.").optional()
+  }).describe("Detailed E2B sandbox information.").optional()
+}).describe("The response returned when retrieving an E2B sandbox.");
+var deleteSandboxInput = external_exports.strictObject({
+  sandboxID: external_exports.string().min(1).regex(new RegExp("\\S")).describe("The E2B sandbox identifier.").optional()
+}).describe("The input payload for selecting an E2B sandbox.");
+var deleteSandboxOutput = external_exports.strictObject({
+  sandboxID: external_exports.string().min(1).regex(new RegExp("\\S")).describe("The E2B sandbox identifier.").optional(),
+  success: external_exports.boolean().describe("Whether the sandbox delete request completed successfully.").optional()
+}).describe("The response returned after deleting an E2B sandbox.");
+var e2bActions = {
+  create_sandbox: {
+    description: "Create an E2B sandbox from a template.",
+    effect: "write",
+    inputSchema: createSandboxInput,
+    outputSchema: external_exports.toJSONSchema(createSandboxOutput, { io: "output", unrepresentable: "any" })
+  },
+  list_sandboxes: {
+    description: "List E2B sandboxes visible to the current API key.",
+    effect: "read",
+    inputSchema: listSandboxesInput,
+    outputSchema: external_exports.toJSONSchema(listSandboxesOutput, { io: "output", unrepresentable: "any" })
+  },
+  get_sandbox: {
+    description: "Get one E2B sandbox by sandbox identifier.",
+    effect: "read",
+    inputSchema: getSandboxInput,
+    outputSchema: external_exports.toJSONSchema(getSandboxOutput, { io: "output", unrepresentable: "any" })
+  },
+  delete_sandbox: {
+    description: "Kill an E2B sandbox by sandbox identifier.",
+    effect: "destructive",
+    inputSchema: deleteSandboxInput,
+    outputSchema: external_exports.toJSONSchema(deleteSandboxOutput, { io: "output", unrepresentable: "any" })
+  }
+};
+
+// ../plugins/src/e2b/index.ts
+function createE2bPlugin() {
+  return createProviderPlugin({
+    description: "E2B",
+    credentialProbe: "list_sandboxes",
+    actions: e2bActions,
+    handlers: {
+      create_sandbox: createSandbox,
+      list_sandboxes: listSandboxes,
+      get_sandbox: getSandbox,
+      delete_sandbox: deleteSandbox
+    }
+  });
+}
+var e2b_default = createE2bPlugin();
+export {
+  createE2bPlugin,
+  e2b_default as default
+};