@alibaba-group/opensandbox-code-interpreter 0.1.3-dev1 → 0.1.3

package/README.md

@@ -49,7 +49,7 @@ const config = new ConnectionConfig({
 // 2. Create a Sandbox with the code-interpreter image + runtime versions
 const sandbox = await Sandbox.create({
   connectionConfig: config,
-  image: "opensandbox/code-interpreter:v1.0.1",
+  image: "opensandbox/code-interpreter:v1.0.2",
   entrypoint: ["/opt/opensandbox/code-interpreter.sh"],
   env: {
     PYTHON_VERSION: "3.11",
@@ -99,7 +99,7 @@ You can specify the desired version of a programming language by setting the cor
 ```ts
 const sandbox = await Sandbox.create({
   connectionConfig: config,
-  image: "opensandbox/code-interpreter:v1.0.1",
+  image: "opensandbox/code-interpreter:v1.0.2",
   entrypoint: ["/opt/opensandbox/code-interpreter.sh"],
   env: {
     JAVA_VERSION: "17",

package/dist/cjs/index.cjs

@@ -232,14 +232,18 @@ var CodesAdapter = class {
 // src/factory/defaultAdapterFactory.ts
 var DefaultAdapterFactory = class {
   createCodes(opts) {
+    const headers = {
+      ...opts.sandbox.connectionConfig.headers ?? {},
+      ...opts.endpointHeaders ?? {}
+    };
     const client = (0, import_internal.createExecdClient)({
       baseUrl: opts.execdBaseUrl,
-      headers: opts.sandbox.connectionConfig.headers,
+      headers,
       fetch: opts.sandbox.connectionConfig.fetch
     });
     return new CodesAdapter(client, {
       baseUrl: opts.execdBaseUrl,
-      headers: opts.sandbox.connectionConfig.headers,
+      headers,
       // Streaming calls (SSE) use a dedicated fetch, aligned with Kotlin/Python SDKs.
       fetch: opts.sandbox.connectionConfig.sseFetch
     });
@@ -256,9 +260,14 @@ var CodeInterpreter = class _CodeInterpreter {
     this.codes = codes;
   }
   static async create(sandbox, opts = {}) {
-    const execdBaseUrl = await sandbox.getEndpointUrl(import_opensandbox4.DEFAULT_EXECD_PORT);
+    const endpoint = await sandbox.getEndpoint(import_opensandbox4.DEFAULT_EXECD_PORT);
+    const execdBaseUrl = `${sandbox.connectionConfig.protocol}://${endpoint.endpoint}`;
     const adapterFactory = opts.adapterFactory ?? createDefaultAdapterFactory();
-    const codes = adapterFactory.createCodes({ sandbox, execdBaseUrl });
+    const codes = adapterFactory.createCodes({
+      sandbox,
+      execdBaseUrl,
+      endpointHeaders: endpoint.headers
+    });
     return new _CodeInterpreter(sandbox, codes);
   }
   get id() {

package/dist/cjs/index.cjs.map

@@ -1 +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"]}
+{"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 endpoint = await sandbox.getEndpoint(DEFAULT_EXECD_PORT);\n    const execdBaseUrl = `${sandbox.connectionConfig.protocol}://${endpoint.endpoint}`;\n    const adapterFactory = opts.adapterFactory ?? createDefaultAdapterFactory();\n    const codes = adapterFactory.createCodes({\n      sandbox,\n      execdBaseUrl,\n      endpointHeaders: endpoint.headers,\n    });\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}\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 headers: Record<string, string> = {\n      ...(opts.sandbox.connectionConfig.headers ?? {}),\n      ...(opts.endpointHeaders ?? {}),\n    };\n    const client = createExecdClient({\n      baseUrl: opts.execdBaseUrl,\n      headers,\n      fetch: opts.sandbox.connectionConfig.fetch,\n    });\n\n    return new CodesAdapter(client, {\n      baseUrl: opts.execdBaseUrl,\n      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}\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

@@ -51,6 +51,7 @@ interface Codes {
 interface CreateCodesStackOptions {
     sandbox: Sandbox;
     execdBaseUrl: string;
+    endpointHeaders?: Record<string, string>;
 }
 /**
  * Factory abstraction for Code Interpreter SDK to decouple from concrete adapters/clients.

package/dist/index.js

@@ -206,14 +206,18 @@ var CodesAdapter = class {
 // src/factory/defaultAdapterFactory.ts
 var DefaultAdapterFactory = class {
   createCodes(opts) {
+    const headers = {
+      ...opts.sandbox.connectionConfig.headers ?? {},
+      ...opts.endpointHeaders ?? {}
+    };
     const client = createExecdClient({
       baseUrl: opts.execdBaseUrl,
-      headers: opts.sandbox.connectionConfig.headers,
+      headers,
       fetch: opts.sandbox.connectionConfig.fetch
     });
     return new CodesAdapter(client, {
       baseUrl: opts.execdBaseUrl,
-      headers: opts.sandbox.connectionConfig.headers,
+      headers,
       // Streaming calls (SSE) use a dedicated fetch, aligned with Kotlin/Python SDKs.
       fetch: opts.sandbox.connectionConfig.sseFetch
     });
@@ -230,9 +234,14 @@ var CodeInterpreter = class _CodeInterpreter {
     this.codes = codes;
   }
   static async create(sandbox, opts = {}) {
-    const execdBaseUrl = await sandbox.getEndpointUrl(DEFAULT_EXECD_PORT);
+    const endpoint = await sandbox.getEndpoint(DEFAULT_EXECD_PORT);
+    const execdBaseUrl = `${sandbox.connectionConfig.protocol}://${endpoint.endpoint}`;
     const adapterFactory = opts.adapterFactory ?? createDefaultAdapterFactory();
-    const codes = adapterFactory.createCodes({ sandbox, execdBaseUrl });
+    const codes = adapterFactory.createCodes({
+      sandbox,
+      execdBaseUrl,
+      endpointHeaders: endpoint.headers
+    });
     return new _CodeInterpreter(sandbox, codes);
   }
   get id() {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../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\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":["SandboxApiException","SandboxError"]}
+{"version":3,"sources":["../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\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 endpoint = await sandbox.getEndpoint(DEFAULT_EXECD_PORT);\n    const execdBaseUrl = `${sandbox.connectionConfig.protocol}://${endpoint.endpoint}`;\n    const adapterFactory = opts.adapterFactory ?? createDefaultAdapterFactory();\n    const codes = adapterFactory.createCodes({\n      sandbox,\n      execdBaseUrl,\n      endpointHeaders: endpoint.headers,\n    });\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}\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 headers: Record<string, string> = {\n      ...(opts.sandbox.connectionConfig.headers ?? {}),\n      ...(opts.endpointHeaders ?? {}),\n    };\n    const client = createExecdClient({\n      baseUrl: opts.execdBaseUrl,\n      headers,\n      fetch: opts.sandbox.connectionConfig.fetch,\n    });\n\n    return new CodesAdapter(client, {\n      baseUrl: opts.execdBaseUrl,\n      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}\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":["SandboxApiException","SandboxError"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alibaba-group/opensandbox-code-interpreter",
-  "version": "0.1.3-dev1",
+  "version": "0.1.3",
   "description": "OpenSandbox Code Interpreter TypeScript/JavaScript SDK",
   "license": "Apache-2.0",
   "type": "module",
@@ -23,7 +23,7 @@
   "bugs": {
     "url": "https://github.com/alibaba/OpenSandbox/issues"
   },
-  "homepage": "https://github.com/alibaba/OpenSandbox",
+  "homepage": "https://open-sandbox.ai",
   "files": [
     "dist",
     "src"
@@ -32,7 +32,7 @@
     "node": ">=20"
   },
   "dependencies": {
-    "@alibaba-group/opensandbox": "^0.1.3-dev1"
+    "@alibaba-group/opensandbox": "^0.1.5"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.2",
@@ -43,6 +43,7 @@
   },
   "scripts": {
     "build": "tsup",
+    "test": "pnpm run build && node --test tests/*.test.mjs",
     "lint": "eslint src --max-warnings 0",
     "clean": "rm -rf dist"
   }

package/src/factory/adapterFactory.ts

@@ -18,6 +18,7 @@ import type { Codes } from "../services/codes.js";
 export interface CreateCodesStackOptions {
   sandbox: Sandbox;
   execdBaseUrl: string;
+  endpointHeaders?: Record<string, string>;
 }
 
 /**
@@ -25,4 +26,4 @@ export interface CreateCodesStackOptions {
  */
 export interface AdapterFactory {
   createCodes(opts: CreateCodesStackOptions): Codes;
-}
+}

package/src/factory/defaultAdapterFactory.ts

@@ -19,15 +19,19 @@ import type { Codes } from "../services/codes.js";
 
 export class DefaultAdapterFactory implements AdapterFactory {
   createCodes(opts: CreateCodesStackOptions): Codes {
+    const headers: Record<string, string> = {
+      ...(opts.sandbox.connectionConfig.headers ?? {}),
+      ...(opts.endpointHeaders ?? {}),
+    };
     const client = createExecdClient({
       baseUrl: opts.execdBaseUrl,
-      headers: opts.sandbox.connectionConfig.headers,
+      headers,
       fetch: opts.sandbox.connectionConfig.fetch,
     });
 
     return new CodesAdapter(client, {
       baseUrl: opts.execdBaseUrl,
-      headers: opts.sandbox.connectionConfig.headers,
+      headers,
       // Streaming calls (SSE) use a dedicated fetch, aligned with Kotlin/Python SDKs.
       fetch: opts.sandbox.connectionConfig.sseFetch,
     });
@@ -36,4 +40,4 @@ export class DefaultAdapterFactory implements AdapterFactory {
 
 export function createDefaultAdapterFactory(): AdapterFactory {
   return new DefaultAdapterFactory();
-}
+}

package/src/interpreter.ts

@@ -39,9 +39,14 @@ export class CodeInterpreter {
   ) {}
 
   static async create(sandbox: Sandbox, opts: CodeInterpreterCreateOptions = {}): Promise<CodeInterpreter> {
-    const execdBaseUrl = await sandbox.getEndpointUrl(DEFAULT_EXECD_PORT);
+    const endpoint = await sandbox.getEndpoint(DEFAULT_EXECD_PORT);
+    const execdBaseUrl = `${sandbox.connectionConfig.protocol}://${endpoint.endpoint}`;
     const adapterFactory = opts.adapterFactory ?? createDefaultAdapterFactory();
-    const codes = adapterFactory.createCodes({ sandbox, execdBaseUrl });
+    const codes = adapterFactory.createCodes({
+      sandbox,
+      execdBaseUrl,
+      endpointHeaders: endpoint.headers,
+    });
 
     return new CodeInterpreter(sandbox, codes);
   }
@@ -61,4 +66,4 @@ export class CodeInterpreter {
   get metrics() {
     return this.sandbox.metrics;
   }
-}
+}