@alibaba-group/opensandbox-code-interpreter 0.1.1 → 0.1.2-dev0

package/dist/cjs/index.cjs

@@ -0,0 +1,294 @@
+"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, {
+  CodeInterpreter: () => CodeInterpreter,
+  DefaultAdapterFactory: () => DefaultAdapterFactory,
+  SupportedLanguages: () => SupportedLanguage,
+  createDefaultAdapterFactory: () => createDefaultAdapterFactory
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/interpreter.ts
+var import_opensandbox4 = require("@alibaba-group/opensandbox");
+
+// src/factory/defaultAdapterFactory.ts
+var import_internal = require("@alibaba-group/opensandbox/internal");
+
+// src/adapters/codesAdapter.ts
+var import_opensandbox3 = require("@alibaba-group/opensandbox");
+
+// src/adapters/openapiError.ts
+var import_opensandbox = require("@alibaba-group/opensandbox");
+function throwOnOpenApiFetchError(result, fallbackMessage) {
+  if (!result.error) return;
+  const requestId = result.response.headers.get("x-request-id") ?? void 0;
+  const status = result.response.status ?? 0;
+  const err = result.error;
+  const message = err?.message ?? err?.error?.message ?? fallbackMessage;
+  const code = err?.code ?? err?.error?.code;
+  const msg = err?.message ?? err?.error?.message ?? message;
+  throw new import_opensandbox.SandboxApiException({
+    message: msg,
+    statusCode: status,
+    requestId,
+    error: code ? new import_opensandbox.SandboxError(String(code), String(msg ?? "")) : new import_opensandbox.SandboxError(import_opensandbox.SandboxError.UNEXPECTED_RESPONSE, String(msg ?? "")),
+    rawBody: result.error
+  });
+}
+
+// src/adapters/sse.ts
+var import_opensandbox2 = require("@alibaba-group/opensandbox");
+function tryParseJson(line) {
+  try {
+    return JSON.parse(line);
+  } catch {
+    return void 0;
+  }
+}
+async function* parseJsonEventStream(res, opts) {
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    const parsed = tryParseJson(text);
+    const err = parsed && typeof parsed === "object" ? parsed : void 0;
+    const requestId = res.headers.get("x-request-id") ?? void 0;
+    const message = err?.message ?? opts?.fallbackErrorMessage ?? `Stream request failed (status=${res.status})`;
+    const code = err?.code ? String(err.code) : import_opensandbox2.SandboxError.UNEXPECTED_RESPONSE;
+    throw new import_opensandbox2.SandboxApiException({
+      message,
+      statusCode: res.status,
+      requestId,
+      error: new import_opensandbox2.SandboxError(code, err?.message ? String(err.message) : message),
+      rawBody: parsed ?? text
+    });
+  }
+  if (!res.body) return;
+  const reader = res.body.getReader();
+  const decoder = new TextDecoder("utf-8");
+  let buf = "";
+  while (true) {
+    const { value, done } = await reader.read();
+    if (done) break;
+    buf += decoder.decode(value, { stream: true });
+    let idx;
+    while ((idx = buf.indexOf("\n")) >= 0) {
+      const rawLine = buf.slice(0, idx);
+      buf = buf.slice(idx + 1);
+      const line = rawLine.trim();
+      if (!line) continue;
+      if (line.startsWith(":")) continue;
+      if (line.startsWith("event:") || line.startsWith("id:") || line.startsWith("retry:")) continue;
+      const jsonLine = line.startsWith("data:") ? line.slice("data:".length).trim() : line;
+      if (!jsonLine) continue;
+      const parsed = tryParseJson(jsonLine);
+      if (!parsed) continue;
+      yield parsed;
+    }
+  }
+  const last = buf.trim();
+  if (last) {
+    const jsonLine = last.startsWith("data:") ? last.slice("data:".length).trim() : last;
+    const parsed = tryParseJson(jsonLine);
+    if (parsed) yield parsed;
+  }
+}
+
+// src/adapters/codesAdapter.ts
+function joinUrl(baseUrl, pathname) {
+  const base = baseUrl.endsWith("/") ? baseUrl.slice(0, -1) : baseUrl;
+  const path = pathname.startsWith("/") ? pathname : `/${pathname}`;
+  return `${base}${path}`;
+}
+var CodesAdapter = class {
+  constructor(client, opts) {
+    this.client = client;
+    this.opts = opts;
+    this.fetch = opts.fetch ?? fetch;
+  }
+  fetch;
+  async createContext(language) {
+    const body = { language };
+    const { data, error, response } = await this.client.POST("/code/context", {
+      body
+    });
+    throwOnOpenApiFetchError({ error, response }, "Create code context failed");
+    const ok = data;
+    if (!ok || typeof ok !== "object") {
+      throw new Error("Create code context failed: unexpected response shape");
+    }
+    if (typeof ok.language !== "string" || !ok.language) {
+      throw new Error("Create code context failed: missing language");
+    }
+    return { id: ok.id, language: ok.language };
+  }
+  async getContext(contextId) {
+    if (!contextId?.trim()) {
+      throw new import_opensandbox3.InvalidArgumentException({ message: "contextId cannot be empty" });
+    }
+    const { data, error, response } = await this.client.GET("/code/contexts/{context_id}", {
+      params: { path: { context_id: contextId } }
+    });
+    throwOnOpenApiFetchError({ error, response }, "Get code context failed");
+    const ok = data;
+    if (!ok || typeof ok !== "object") {
+      throw new Error("Get code context failed: unexpected response shape");
+    }
+    if (typeof ok.language !== "string" || !ok.language) {
+      throw new Error("Get code context failed: missing language");
+    }
+    return { id: ok.id, language: ok.language };
+  }
+  async listContexts(language) {
+    const { data, error, response } = await this.client.GET("/code/contexts", {
+      params: language ? { query: { language } } : void 0
+    });
+    throwOnOpenApiFetchError({ error, response }, "List code contexts failed");
+    const ok = data;
+    if (!Array.isArray(ok)) {
+      throw new Error("List code contexts failed: unexpected response shape");
+    }
+    return ok.filter((c) => c && typeof c === "object").map((c) => ({ id: c.id, language: c.language }));
+  }
+  async deleteContext(contextId) {
+    if (!contextId?.trim()) {
+      throw new import_opensandbox3.InvalidArgumentException({ message: "contextId cannot be empty" });
+    }
+    const { error, response } = await this.client.DELETE("/code/contexts/{context_id}", {
+      params: { path: { context_id: contextId } }
+    });
+    throwOnOpenApiFetchError({ error, response }, "Delete code context failed");
+  }
+  async deleteContexts(language) {
+    const { error, response } = await this.client.DELETE("/code/contexts", {
+      params: { query: { language } }
+    });
+    throwOnOpenApiFetchError({ error, response }, "Delete code contexts failed");
+  }
+  async interrupt(contextId) {
+    const { error, response } = await this.client.DELETE("/code", {
+      params: { query: { id: contextId } }
+    });
+    throwOnOpenApiFetchError({ error, response }, "Interrupt code failed");
+  }
+  async *runStream(req, signal) {
+    const url = joinUrl(this.opts.baseUrl, "/code");
+    const body = JSON.stringify(req);
+    const res = await this.fetch(url, {
+      method: "POST",
+      headers: {
+        "accept": "text/event-stream",
+        "content-type": "application/json",
+        ...this.opts.headers ?? {}
+      },
+      body,
+      signal
+    });
+    for await (const ev of parseJsonEventStream(res, { fallbackErrorMessage: "Run code failed" })) {
+      yield ev;
+    }
+  }
+  async run(code, opts = {}) {
+    if (!code.trim()) {
+      throw new import_opensandbox3.InvalidArgumentException({ message: "Code cannot be empty" });
+    }
+    if (opts.context && opts.language) {
+      throw new import_opensandbox3.InvalidArgumentException({ message: "Provide either opts.context or opts.language, not both" });
+    }
+    const context = opts.context ?? (opts.language ? { language: opts.language } : { language: "python" });
+    const req = {
+      code,
+      context: { id: context.id, language: context.language }
+    };
+    const execution = {
+      logs: { stdout: [], stderr: [] },
+      result: []
+    };
+    const dispatcher = new import_opensandbox3.ExecutionEventDispatcher(execution, opts.handlers);
+    for await (const ev of this.runStream(req, opts.signal)) {
+      await dispatcher.dispatch(ev);
+    }
+    return execution;
+  }
+};
+
+// src/factory/defaultAdapterFactory.ts
+var DefaultAdapterFactory = class {
+  createCodes(opts) {
+    const client = (0, import_internal.createExecdClient)({
+      baseUrl: opts.execdBaseUrl,
+      headers: opts.sandbox.connectionConfig.headers,
+      fetch: opts.sandbox.connectionConfig.fetch
+    });
+    return new CodesAdapter(client, {
+      baseUrl: opts.execdBaseUrl,
+      headers: opts.sandbox.connectionConfig.headers,
+      // Streaming calls (SSE) use a dedicated fetch, aligned with Kotlin/Python SDKs.
+      fetch: opts.sandbox.connectionConfig.sseFetch
+    });
+  }
+};
+function createDefaultAdapterFactory() {
+  return new DefaultAdapterFactory();
+}
+
+// src/interpreter.ts
+var CodeInterpreter = class _CodeInterpreter {
+  constructor(sandbox, codes) {
+    this.sandbox = sandbox;
+    this.codes = codes;
+  }
+  static async create(sandbox, opts = {}) {
+    const execdBaseUrl = await sandbox.getEndpointUrl(import_opensandbox4.DEFAULT_EXECD_PORT);
+    const adapterFactory = opts.adapterFactory ?? createDefaultAdapterFactory();
+    const codes = adapterFactory.createCodes({ sandbox, execdBaseUrl });
+    return new _CodeInterpreter(sandbox, codes);
+  }
+  get id() {
+    return this.sandbox.id;
+  }
+  get files() {
+    return this.sandbox.files;
+  }
+  get commands() {
+    return this.sandbox.commands;
+  }
+  get metrics() {
+    return this.sandbox.metrics;
+  }
+};
+
+// src/models.ts
+var SupportedLanguage = {
+  PYTHON: "python",
+  JAVA: "java",
+  GO: "go",
+  TYPESCRIPT: "typescript",
+  JAVASCRIPT: "javascript",
+  BASH: "bash"
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CodeInterpreter,
+  DefaultAdapterFactory,
+  SupportedLanguages,
+  createDefaultAdapterFactory
+});
+//# sourceMappingURL=index.cjs.map

package/dist/cjs/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/index.ts","../../src/interpreter.ts","../../src/factory/defaultAdapterFactory.ts","../../src/adapters/codesAdapter.ts","../../src/adapters/openapiError.ts","../../src/adapters/sse.ts","../../src/models.ts"],"sourcesContent":["// Copyright 2026 Alibaba Group Holding Ltd.\n// \n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n// \n//     http://www.apache.org/licenses/LICENSE-2.0\n// \n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\nexport { CodeInterpreter } from \"./interpreter.js\";\nexport type { CodeInterpreterCreateOptions } from \"./interpreter.js\";\n\nexport type { AdapterFactory } from \"./factory/adapterFactory.js\";\nexport { DefaultAdapterFactory, createDefaultAdapterFactory } from \"./factory/defaultAdapterFactory.js\";\n\nexport type { CodeContext, SupportedLanguage } from \"./models.js\";\nexport { SupportedLanguage as SupportedLanguages } from \"./models.js\";\n\nexport type { Codes } from \"./services/codes.js\";\n\nexport type {\n  Execution,\n  ExecutionComplete,\n  ExecutionError,\n  ExecutionHandlers,\n  ExecutionInit,\n  ExecutionResult,\n  OutputMessage,\n} from \"@alibaba-group/opensandbox\";","// Copyright 2026 Alibaba Group Holding Ltd.\n// \n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n// \n//     http://www.apache.org/licenses/LICENSE-2.0\n// \n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\nimport { DEFAULT_EXECD_PORT } from \"@alibaba-group/opensandbox\";\nimport type { Sandbox } from \"@alibaba-group/opensandbox\";\n\nimport { createDefaultAdapterFactory } from \"./factory/defaultAdapterFactory.js\";\nimport type { AdapterFactory } from \"./factory/adapterFactory.js\";\nimport type { Codes } from \"./services/codes.js\";\n\nexport interface CodeInterpreterCreateOptions {\n  adapterFactory?: AdapterFactory;\n}\n\n/**\n * Code interpreter facade (JS/TS).\n *\n * This class wraps an existing {@link Sandbox} and provides a high-level API for code execution.\n *\n * - Use {@link codes} to create contexts and run code.\n * - {@link files}, {@link commands}, and {@link metrics} are exposed for convenience and are\n *   the same instances as on the underlying {@link Sandbox}.\n */\nexport class CodeInterpreter {\n  private constructor(\n    readonly sandbox: Sandbox,\n    readonly codes: Codes,\n  ) {}\n\n  static async create(sandbox: Sandbox, opts: CodeInterpreterCreateOptions = {}): Promise<CodeInterpreter> {\n    const execdBaseUrl = await sandbox.getEndpointUrl(DEFAULT_EXECD_PORT);\n    const adapterFactory = opts.adapterFactory ?? createDefaultAdapterFactory();\n    const codes = adapterFactory.createCodes({ sandbox, execdBaseUrl });\n\n    return new CodeInterpreter(sandbox, codes);\n  }\n\n  get id() {\n    return this.sandbox.id;\n  }\n\n  get files() {\n    return this.sandbox.files;\n  }\n\n  get commands() {\n    return this.sandbox.commands;\n  }\n\n  get metrics() {\n    return this.sandbox.metrics;\n  }\n}","// Copyright 2026 Alibaba Group Holding Ltd.\n// \n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n// \n//     http://www.apache.org/licenses/LICENSE-2.0\n// \n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\nimport { createExecdClient } from \"@alibaba-group/opensandbox/internal\";\nimport type { AdapterFactory, CreateCodesStackOptions } from \"./adapterFactory.js\";\nimport { CodesAdapter } from \"../adapters/codesAdapter.js\";\nimport type { Codes } from \"../services/codes.js\";\n\nexport class DefaultAdapterFactory implements AdapterFactory {\n  createCodes(opts: CreateCodesStackOptions): Codes {\n    const client = createExecdClient({\n      baseUrl: opts.execdBaseUrl,\n      headers: opts.sandbox.connectionConfig.headers,\n      fetch: opts.sandbox.connectionConfig.fetch,\n    });\n\n    return new CodesAdapter(client, {\n      baseUrl: opts.execdBaseUrl,\n      headers: opts.sandbox.connectionConfig.headers,\n      // Streaming calls (SSE) use a dedicated fetch, aligned with Kotlin/Python SDKs.\n      fetch: opts.sandbox.connectionConfig.sseFetch,\n    });\n  }\n}\n\nexport function createDefaultAdapterFactory(): AdapterFactory {\n  return new DefaultAdapterFactory();\n}","// Copyright 2026 Alibaba Group Holding Ltd.\n// \n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n// \n//     http://www.apache.org/licenses/LICENSE-2.0\n// \n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\nimport type { ExecdClient, ExecdPaths } from \"@alibaba-group/opensandbox/internal\";\nimport type { ServerStreamEvent } from \"@alibaba-group/opensandbox\";\nimport type { Execution, ExecutionHandlers } from \"@alibaba-group/opensandbox\";\nimport {\n  ExecutionEventDispatcher,\n  InvalidArgumentException,\n} from \"@alibaba-group/opensandbox\";\n\nimport type { Codes } from \"../services/codes.js\";\nimport type { CodeContext, SupportedLanguage } from \"../models.js\";\nimport { throwOnOpenApiFetchError } from \"./openapiError.js\";\nimport { parseJsonEventStream } from \"./sse.js\";\n\ntype ApiCreateContextRequest =\n  ExecdPaths[\"/code/context\"][\"post\"][\"requestBody\"][\"content\"][\"application/json\"];\ntype ApiCreateContextOk =\n  ExecdPaths[\"/code/context\"][\"post\"][\"responses\"][200][\"content\"][\"application/json\"];\ntype ApiGetContextOk =\n  ExecdPaths[\"/code/contexts/{context_id}\"][\"get\"][\"responses\"][200][\"content\"][\"application/json\"];\ntype ApiListContextsOk =\n  ExecdPaths[\"/code/contexts\"][\"get\"][\"responses\"][200][\"content\"][\"application/json\"];\ntype ApiRunCodeRequest =\n  ExecdPaths[\"/code\"][\"post\"][\"requestBody\"][\"content\"][\"application/json\"];\n\n/**\n * Single-layer codes adapter for the Code Interpreter SDK.\n *\n * - Handles HTTP/SSE streaming via the underlying execd adapter\n * - Builds the structured {@link Execution} result for `run(...)`\n */\nfunction joinUrl(baseUrl: string, pathname: string): string {\n  const base = baseUrl.endsWith(\"/\") ? baseUrl.slice(0, -1) : baseUrl;\n  const path = pathname.startsWith(\"/\") ? pathname : `/${pathname}`;\n  return `${base}${path}`;\n}\n\nexport class CodesAdapter implements Codes {\n  private readonly fetch: typeof fetch;\n\n  constructor(\n    private readonly client: ExecdClient,\n    private readonly opts: { baseUrl: string; fetch?: typeof fetch; headers?: Record<string, string> },\n  ) {\n    this.fetch = opts.fetch ?? fetch;\n  }\n\n  async createContext(language: SupportedLanguage): Promise<CodeContext> {\n    const body: ApiCreateContextRequest = { language };\n    const { data, error, response } = await this.client.POST(\"/code/context\", {\n      body,\n    });\n    throwOnOpenApiFetchError({ error, response }, \"Create code context failed\");\n    const ok = data as ApiCreateContextOk | undefined;\n    if (!ok || typeof ok !== \"object\") {\n      throw new Error(\"Create code context failed: unexpected response shape\");\n    }\n    if (typeof ok.language !== \"string\" || !ok.language) {\n      throw new Error(\"Create code context failed: missing language\");\n    }\n    return { id: ok.id, language: ok.language };\n  }\n\n  async getContext(contextId: string): Promise<CodeContext> {\n    if (!contextId?.trim()) {\n      throw new InvalidArgumentException({ message: \"contextId cannot be empty\" });\n    }\n    const { data, error, response } = await this.client.GET(\"/code/contexts/{context_id}\", {\n      params: { path: { context_id: contextId } },\n    });\n    throwOnOpenApiFetchError({ error, response }, \"Get code context failed\");\n    const ok = data as ApiGetContextOk | undefined;\n    if (!ok || typeof ok !== \"object\") {\n      throw new Error(\"Get code context failed: unexpected response shape\");\n    }\n    if (typeof (ok as any).language !== \"string\" || !(ok as any).language) {\n      throw new Error(\"Get code context failed: missing language\");\n    }\n    return { id: (ok as any).id, language: (ok as any).language };\n  }\n\n  async listContexts(language?: SupportedLanguage): Promise<CodeContext[]> {\n    const { data, error, response } = await this.client.GET(\"/code/contexts\", {\n      params: language ? { query: { language } } : undefined,\n    } as any);\n    throwOnOpenApiFetchError({ error, response }, \"List code contexts failed\");\n    const ok = data as ApiListContextsOk | undefined;\n    if (!Array.isArray(ok)) {\n      throw new Error(\"List code contexts failed: unexpected response shape\");\n    }\n    return ok\n      .filter((c) => c && typeof c === \"object\")\n      .map((c: any) => ({ id: c.id, language: c.language as any }));\n  }\n\n  async deleteContext(contextId: string): Promise<void> {\n    if (!contextId?.trim()) {\n      throw new InvalidArgumentException({ message: \"contextId cannot be empty\" });\n    }\n    const { error, response } = await this.client.DELETE(\"/code/contexts/{context_id}\", {\n      params: { path: { context_id: contextId } },\n    });\n    throwOnOpenApiFetchError({ error, response }, \"Delete code context failed\");\n  }\n\n  async deleteContexts(language: SupportedLanguage): Promise<void> {\n    const { error, response } = await this.client.DELETE(\"/code/contexts\", {\n      params: { query: { language } },\n    });\n    throwOnOpenApiFetchError({ error, response }, \"Delete code contexts failed\");\n  }\n\n  async interrupt(contextId: string): Promise<void> {\n    const { error, response } = await this.client.DELETE(\"/code\", {\n      params: { query: { id: contextId } },\n    });\n    throwOnOpenApiFetchError({ error, response }, \"Interrupt code failed\");\n  }\n\n  async *runStream(req: ApiRunCodeRequest, signal?: AbortSignal): AsyncIterable<ServerStreamEvent> {\n    const url = joinUrl(this.opts.baseUrl, \"/code\");\n    const body = JSON.stringify(req);\n    const res = await this.fetch(url, {\n      method: \"POST\",\n      headers: {\n        \"accept\": \"text/event-stream\",\n        \"content-type\": \"application/json\",\n        ...(this.opts.headers ?? {}),\n      },\n      body,\n      signal,\n    });\n\n    for await (const ev of parseJsonEventStream<ServerStreamEvent>(res, { fallbackErrorMessage: \"Run code failed\" })) {\n      yield ev;\n    }\n  }\n\n  async run(\n    code: string,\n    opts: { context?: CodeContext; language?: SupportedLanguage; handlers?: ExecutionHandlers; signal?: AbortSignal } = {},\n  ): Promise<Execution> {\n    if (!code.trim()) {\n      throw new InvalidArgumentException({ message: \"Code cannot be empty\" });\n    }\n\n    if (opts.context && opts.language) {\n      throw new InvalidArgumentException({ message: \"Provide either opts.context or opts.language, not both\" });\n    }\n\n    const context: CodeContext =\n      opts.context ??\n      (opts.language\n        ? { language: opts.language }\n        : { language: \"python\" });\n\n    // Make the OpenAPI contract explicit so backend schema changes surface quickly.\n    const req: ApiRunCodeRequest = {\n      code,\n      context: { id: context.id, language: context.language },\n    };\n\n    const execution: Execution = {\n      logs: { stdout: [], stderr: [] },\n      result: [],\n    };\n    const dispatcher = new ExecutionEventDispatcher(execution, opts.handlers);\n\n    for await (const ev of this.runStream(req, opts.signal)) {\n      await dispatcher.dispatch(ev as any);\n    }\n\n    return execution;\n  }\n}","// Copyright 2026 Alibaba Group Holding Ltd.\n// \n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n// \n//     http://www.apache.org/licenses/LICENSE-2.0\n// \n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\nimport { SandboxApiException, SandboxError } from \"@alibaba-group/opensandbox\";\n\nexport function throwOnOpenApiFetchError(\n  result: { error?: unknown; response: Response },\n  fallbackMessage: string,\n): void {\n  if (!result.error) return;\n\n  const requestId = result.response.headers.get(\"x-request-id\") ?? undefined;\n  const status = (result.response as any).status ?? 0;\n\n  const err = result.error as any;\n  const message =\n    err?.message ??\n    err?.error?.message ??\n    fallbackMessage;\n\n  const code = err?.code ?? err?.error?.code;\n  const msg = err?.message ?? err?.error?.message ?? message;\n\n  throw new SandboxApiException({\n    message: msg,\n    statusCode: status,\n    requestId,\n    error: code\n      ? new SandboxError(String(code), String(msg ?? \"\"))\n      : new SandboxError(SandboxError.UNEXPECTED_RESPONSE, String(msg ?? \"\")),\n    rawBody: result.error,\n  });\n}","// Copyright 2026 Alibaba Group Holding Ltd.\n// \n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n// \n//     http://www.apache.org/licenses/LICENSE-2.0\n// \n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\nimport { SandboxApiException, SandboxError } from \"@alibaba-group/opensandbox\";\n\nfunction tryParseJson(line: string): unknown | undefined {\n  try {\n    return JSON.parse(line);\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Parses an SSE-like stream that may be either:\n * - standard SSE frames (`data: {...}\\n\\n`)\n * - newline-delimited JSON (one JSON object per line)\n */\nexport async function* parseJsonEventStream<T>(\n  res: Response,\n  opts?: { fallbackErrorMessage?: string },\n): AsyncIterable<T> {\n  if (!res.ok) {\n    const text = await res.text().catch(() => \"\");\n    const parsed = tryParseJson(text);\n    const err = parsed && typeof parsed === \"object\" ? (parsed as any) : undefined;\n    const requestId = res.headers.get(\"x-request-id\") ?? undefined;\n    const message = err?.message ?? opts?.fallbackErrorMessage ?? `Stream request failed (status=${res.status})`;\n    const code = err?.code ? String(err.code) : SandboxError.UNEXPECTED_RESPONSE;\n    throw new SandboxApiException({\n      message,\n      statusCode: res.status,\n      requestId,\n      error: new SandboxError(code, err?.message ? String(err.message) : message),\n      rawBody: parsed ?? text,\n    });\n  }\n\n  if (!res.body) return;\n\n  const reader = res.body.getReader();\n  const decoder = new TextDecoder(\"utf-8\");\n  let buf = \"\";\n\n  while (true) {\n    const { value, done } = await reader.read();\n    if (done) break;\n\n    buf += decoder.decode(value, { stream: true });\n    let idx: number;\n\n    while ((idx = buf.indexOf(\"\\n\")) >= 0) {\n      const rawLine = buf.slice(0, idx);\n      buf = buf.slice(idx + 1);\n\n      const line = rawLine.trim();\n      if (!line) continue;\n\n      // Support standard SSE \"data:\" prefix\n      if (line.startsWith(\":\")) continue;\n      if (line.startsWith(\"event:\") || line.startsWith(\"id:\") || line.startsWith(\"retry:\")) continue;\n\n      const jsonLine = line.startsWith(\"data:\") ? line.slice(\"data:\".length).trim() : line;\n      if (!jsonLine) continue;\n\n      const parsed = tryParseJson(jsonLine);\n      if (!parsed) continue;\n      yield parsed as T;\n    }\n  }\n\n  // flush last line if exists\n  const last = buf.trim();\n  if (last) {\n    const jsonLine = last.startsWith(\"data:\") ? last.slice(\"data:\".length).trim() : last;\n    const parsed = tryParseJson(jsonLine);\n    if (parsed) yield parsed as T;\n  }\n}","// Copyright 2026 Alibaba Group Holding Ltd.\n// \n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n// \n//     http://www.apache.org/licenses/LICENSE-2.0\n// \n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\nexport const SupportedLanguage = {\n  PYTHON: \"python\",\n  JAVA: \"java\",\n  GO: \"go\",\n  TYPESCRIPT: \"typescript\",\n  JAVASCRIPT: \"javascript\",\n  BASH: \"bash\",\n} as const;\n\nexport type SupportedLanguage =\n  (typeof SupportedLanguage)[keyof typeof SupportedLanguage];\n\nexport interface CodeContext {\n  id?: string;\n  language: SupportedLanguage | (string & {});\n}\n\nexport interface RunCodeRequest {\n  code: string;\n  context: CodeContext;\n}"],"mappings":"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","names":["import_opensandbox","import_opensandbox","import_opensandbox"]}

package/dist/index.d.ts

@@ -1,9 +1,90 @@
-export { CodeInterpreter } from "./interpreter.js";
-export type { CodeInterpreterCreateOptions } from "./interpreter.js";
-export type { AdapterFactory } from "./factory/adapterFactory.js";
-export { DefaultAdapterFactory, createDefaultAdapterFactory } from "./factory/defaultAdapterFactory.js";
-export type { CodeContext, SupportedLanguage } from "./models.js";
-export { SupportedLanguage as SupportedLanguages } from "./models.js";
-export type { Codes } from "./services/codes.js";
-export type { Execution, ExecutionComplete, ExecutionError, ExecutionHandlers, ExecutionInit, ExecutionResult, OutputMessage, } from "@alibaba-group/opensandbox";
-//# sourceMappingURL=index.d.ts.map
+import * as _alibaba_group_opensandbox from '@alibaba-group/opensandbox';
+import { ExecutionHandlers, Execution, ServerStreamEvent, Sandbox } from '@alibaba-group/opensandbox';
+export { Execution, ExecutionComplete, ExecutionError, ExecutionHandlers, ExecutionInit, ExecutionResult, OutputMessage } from '@alibaba-group/opensandbox';
+
+declare const SupportedLanguage: {
+    readonly PYTHON: "python";
+    readonly JAVA: "java";
+    readonly GO: "go";
+    readonly TYPESCRIPT: "typescript";
+    readonly JAVASCRIPT: "javascript";
+    readonly BASH: "bash";
+};
+type SupportedLanguage = (typeof SupportedLanguage)[keyof typeof SupportedLanguage];
+interface CodeContext {
+    id?: string;
+    language: SupportedLanguage | (string & {});
+}
+interface RunCodeRequest {
+    code: string;
+    context: CodeContext;
+}
+
+interface Codes {
+    createContext(language: SupportedLanguage): Promise<CodeContext>;
+    /**
+     * Get an existing context by id.
+     */
+    getContext(contextId: string): Promise<CodeContext>;
+    /**
+     * List active contexts. If language is provided, filters by language/runtime.
+     */
+    listContexts(language?: SupportedLanguage): Promise<CodeContext[]>;
+    /**
+     * Delete a context by id.
+     */
+    deleteContext(contextId: string): Promise<void>;
+    /**
+     * Delete all contexts under the specified language/runtime.
+     */
+    deleteContexts(language: SupportedLanguage): Promise<void>;
+    run(code: string, opts?: {
+        context?: CodeContext;
+        language?: SupportedLanguage;
+        handlers?: ExecutionHandlers;
+        signal?: AbortSignal;
+    }): Promise<Execution>;
+    runStream(req: RunCodeRequest, signal?: AbortSignal): AsyncIterable<ServerStreamEvent>;
+    interrupt(contextId: string): Promise<void>;
+}
+
+interface CreateCodesStackOptions {
+    sandbox: Sandbox;
+    execdBaseUrl: string;
+}
+/**
+ * Factory abstraction for Code Interpreter SDK to decouple from concrete adapters/clients.
+ */
+interface AdapterFactory {
+    createCodes(opts: CreateCodesStackOptions): Codes;
+}
+
+interface CodeInterpreterCreateOptions {
+    adapterFactory?: AdapterFactory;
+}
+/**
+ * Code interpreter facade (JS/TS).
+ *
+ * This class wraps an existing {@link Sandbox} and provides a high-level API for code execution.
+ *
+ * - Use {@link codes} to create contexts and run code.
+ * - {@link files}, {@link commands}, and {@link metrics} are exposed for convenience and are
+ *   the same instances as on the underlying {@link Sandbox}.
+ */
+declare class CodeInterpreter {
+    readonly sandbox: Sandbox;
+    readonly codes: Codes;
+    private constructor();
+    static create(sandbox: Sandbox, opts?: CodeInterpreterCreateOptions): Promise<CodeInterpreter>;
+    get id(): string;
+    get files(): _alibaba_group_opensandbox.SandboxFiles;
+    get commands(): _alibaba_group_opensandbox.ExecdCommands;
+    get metrics(): _alibaba_group_opensandbox.ExecdMetrics;
+}
+
+declare class DefaultAdapterFactory implements AdapterFactory {
+    createCodes(opts: CreateCodesStackOptions): Codes;
+}
+declare function createDefaultAdapterFactory(): AdapterFactory;
+
+export { type AdapterFactory, type CodeContext, CodeInterpreter, type CodeInterpreterCreateOptions, type Codes, DefaultAdapterFactory, SupportedLanguage, SupportedLanguage as SupportedLanguages, createDefaultAdapterFactory };