@fastgpt-sdk/sandbox-adapter 0.0.36 → 0.0.37

package/dist/adapters/BaseSandboxAdapter.d.ts

@@ -1,6 +1,6 @@
 import type { ISandbox } from '../interfaces/ISandbox';
 import { CommandPolyfillService } from '../polyfill/CommandPolyfillService';
-import type { ContentReplaceEntry, DirectoryEntry, ExecuteOptions, ExecuteResult, FileDeleteResult, FileInfo, FileReadResult, FileWriteEntry, FileWriteResult, MoveEntry, PermissionEntry, ReadFileOptions, SandboxId, SandboxInfo, SandboxMetrics, SandboxStatus, SearchResult, StreamHandlers } from '../types';
+import type { ContentReplaceEntry, DirectoryEntry, Endpoint, ExecuteOptions, ExecuteResult, FileDeleteResult, FileInfo, FileReadResult, FileWriteEntry, FileWriteResult, MoveEntry, PermissionEntry, ReadFileOptions, SandboxEndpointSelector, SandboxId, SandboxInfo, SandboxMetrics, SandboxProxyService, SandboxProxyTarget, SandboxStatus, SearchResult, StreamHandlers } from '../types';
 /**
  * Abstract base class for all sandbox adapters.
  *
@@ -37,6 +37,8 @@ export declare abstract class BaseSandboxAdapter implements ISandbox {
     waitUntilReady(timeoutMs?: number): Promise<void>;
     waitUntilDeleted(timeoutMs?: number): Promise<void>;
     renewExpiration(_additionalSeconds: number): Promise<void>;
+    getEndpoint(_selector: SandboxEndpointSelector): Promise<Endpoint>;
+    getProxyTarget(_service?: SandboxProxyService): Promise<SandboxProxyTarget>;
     abstract execute(command: string, options?: ExecuteOptions): Promise<ExecuteResult>;
     executeStream(command: string, handlers: StreamHandlers, options?: ExecuteOptions): Promise<void>;
     executeBackground(_command: string, _options?: ExecuteOptions): Promise<{

package/dist/adapters/OpenSandboxAdapter/index.d.ts

@@ -1,4 +1,4 @@
-import type { Endpoint, ExecuteOptions, ExecuteResult, FileWriteEntry, FileWriteResult, SandboxId, SandboxInfo, SandboxMetrics, StreamHandlers } from '@/types';
+import type { Endpoint, ExecuteOptions, ExecuteResult, FileWriteEntry, FileWriteResult, SandboxEndpointSelector, SandboxId, SandboxInfo, SandboxMetrics, SandboxProxyService, SandboxProxyTarget, StreamHandlers } from '@/types';
 import { BaseSandboxAdapter } from '../BaseSandboxAdapter';
 import type { OpenSandboxConfigType } from './type';
 export type { OpenSandboxConfigType } from './type';
@@ -23,6 +23,11 @@ export interface OpenSandboxConnectionConfig {
     debug?: boolean;
     /** Route execd traffic through the OpenSandbox server proxy */
     useServerProxy?: boolean;
+    /**
+     * Rewrite OpenSandbox local endpoint host when sandbox-proxy runs on the host
+     * instead of inside Docker/Kubernetes.
+     */
+    replaceDockerInternalWithLocalhost?: boolean;
     /**
      * Sandbox runtime type.
      * @default 'docker'
@@ -65,8 +70,6 @@ export declare class OpenSandboxAdapter extends BaseSandboxAdapter {
     private createConnectionConfig;
     private static readonly STATE_MAP;
     private mapStatus;
-    private convertImageSpec;
-    private parseImageSpec;
     private convertResourceLimits;
     private parseResourceLimits;
     private extractExitCode;
@@ -85,11 +88,12 @@ export declare class OpenSandboxAdapter extends BaseSandboxAdapter {
      */
     close(): Promise<void>;
     /**
-     * Get endpoint information for a specific port exposed by the sandbox.
-     * @param port The port number to get endpoint for
-     * @returns Endpoint with host, port, protocol and url fields
+     * Get endpoint information for a provider endpoint or well-known service.
      */
-    getEndpoint(port: number): Promise<Endpoint>;
+    getEndpoint(selector: SandboxEndpointSelector): Promise<Endpoint>;
+    private getOpenSandboxEndpoint;
+    getProxyTarget(service?: SandboxProxyService): Promise<SandboxProxyTarget>;
+    private getDirectEndpointOrigin;
     getInfo(): Promise<SandboxInfo | null>;
     renewExpiration(additionalSeconds: number): Promise<void>;
     writeFiles(entries: FileWriteEntry[]): Promise<FileWriteResult[]>;

package/dist/adapters/OpenSandboxAdapter/type.d.ts

@@ -1,4 +1,4 @@
-import { ImageSpec, NetworkPolicy, ResourceLimits } from '@/types';
+import type { ImageSpec, NetworkPolicy, ResourceLimits } from '@/types';
 import type { Volume } from '@alibaba-group/opensandbox';
 /**
  * Configuration for creating a sandbox.

package/dist/adapters/SealosDevboxAdapter/api.d.ts

@@ -1,4 +1,4 @@
-import { type DevboxApiConfig, type DevboxApiResponse, type DevboxInfoData, type DevboxMutationData, type DownloadFileParams, type ExecRequest, type ExecResponseData, type UploadFileParams, type UploadResponseData } from './type';
+import { type DevboxApiConfig, type DevboxApiResponse, type DevboxCreateRequest, type DevboxInfoData, type DevboxMutationData, type DownloadFileParams, type ExecRequest, type ExecResponseData, type UploadFileParams, type UploadResponseData } from './type';
 /**
  * HTTP client for the Sealos Devbox REST API.
  *
@@ -11,7 +11,7 @@ export declare class DevboxApi {
     private url;
     private request;
     /** POST /api/v1/devbox — create a devbox */
-    create(name: string): Promise<DevboxApiResponse<DevboxMutationData>>;
+    create(req: DevboxCreateRequest): Promise<DevboxApiResponse<DevboxMutationData>>;
     /** GET /api/v1/devbox/{name} — query devbox info (state + SSH) */
     info(name: string): Promise<DevboxApiResponse<DevboxInfoData>>;
     /** POST /api/v1/devbox/{name}/pause */

package/dist/adapters/SealosDevboxAdapter/index.d.ts

@@ -1,4 +1,4 @@
-import type { ExecuteOptions, ExecuteResult, SandboxId, SandboxInfo } from '../../types';
+import type { Endpoint, ExecuteOptions, ExecuteResult, ImageSpec, KubeAccessPolicy, LabelSpec, LifecyclePolicy, SandboxEndpointSelector, SandboxId, SandboxInfo, SandboxProxyService, SandboxProxyTarget } from '../../types';
 import { BaseSandboxAdapter } from '../BaseSandboxAdapter';
 /**
  * Configuration for Sealos Devbox Adapter.
@@ -9,16 +9,33 @@ export interface SealosDevboxConfig {
     /** JWT authentication token */
     token: string;
     sandboxId: string;
+    /**
+     * Optional override for the Sealos httpgate wildcard domain. When omitted,
+     * it is derived from gateway.url returned by Devbox Server.
+     */
+    httpgateDomain?: string;
+}
+export interface SealosDevboxCreateConfig {
+    image?: ImageSpec;
+    env?: Record<string, string>;
+    labels?: LabelSpec[];
+    upstreamID?: string;
+    kubeAccess?: KubeAccessPolicy;
+    lifecycle?: LifecyclePolicy;
+    workingDir?: string;
 }
 export declare class SealosDevboxAdapter extends BaseSandboxAdapter {
     private config;
+    private createConfig?;
     readonly provider: "sealosdevbox";
     get rootPath(): string;
     private api;
     private _id;
-    constructor(config: SealosDevboxConfig);
+    constructor(config: SealosDevboxConfig, createConfig?: SealosDevboxCreateConfig | undefined);
     get id(): SandboxId;
     private StatusAdapt;
+    private buildCreateRequest;
+    private removeUndefined;
     getInfo(): Promise<SandboxInfo | null>;
     ensureRunning(): Promise<void>;
     create(): Promise<void>;
@@ -26,6 +43,12 @@ export declare class SealosDevboxAdapter extends BaseSandboxAdapter {
     start(): Promise<void>;
     delete(): Promise<void>;
     execute(command: string, options?: ExecuteOptions): Promise<ExecuteResult>;
+    getEndpoint(selector: SandboxEndpointSelector): Promise<Endpoint>;
+    getProxyTarget(service?: SandboxProxyService): Promise<SandboxProxyTarget>;
+    private getHttpgateTarget;
+    private getGatewayUniqueID;
+    private getHttpgateDomain;
+    private normalizeHttpgateDomain;
     /**
      * Check if the devbox is ready by querying info endpoint.
      * Ready when spec, status, and phase are all "Running".

package/dist/adapters/SealosDevboxAdapter/type.d.ts

@@ -52,6 +52,23 @@ export interface DevboxMutationData {
     state?: string;
     status?: string;
 }
+/** Request body for the create endpoint. */
+export interface DevboxCreateRequest {
+    name: string;
+    image?: string;
+    env?: Record<string, string>;
+    labels?: Array<{
+        key: string;
+        value: string;
+    }>;
+    upstreamID?: string;
+    kubeAccess?: {
+        enabled?: boolean;
+        roleTemplate?: 'view' | 'edit' | 'admin';
+    };
+    pauseAt?: string;
+    archiveAfterPauseTime?: string;
+}
 /** SSH connection info returned by the info endpoint. */
 export interface DevboxSshInfo {
     user: string;
@@ -63,14 +80,27 @@ export interface DevboxSshInfo {
     privateKeyEncoding: string;
     privateKeyBase64: string;
 }
+/** HTTP gateway info returned by the info endpoint. */
+export interface DevboxGatewayInfo {
+    url: string;
+    token?: string;
+    port?: number;
+    uniqueID?: string;
+}
 /** Response data from the GET info endpoint. */
 export interface DevboxInfoData {
     name: string;
+    image?: string;
+    creationTimestamp?: string;
     deletionTimestamp?: string | null;
     state: {
         phase: `${DevboxPhaseEnum}`;
     };
     ssh: DevboxSshInfo;
+    gateway?: DevboxGatewayInfo;
+    codeServerGateway?: DevboxGatewayInfo & {
+        password?: string;
+    };
 }
 /** Response data from the upload endpoint. */
 export interface UploadResponseData {

package/dist/adapters/index.d.ts

@@ -1,9 +1,9 @@
-import { type SealosDevboxConfig } from './SealosDevboxAdapter';
+import { type SealosDevboxConfig, type SealosDevboxCreateConfig } from './SealosDevboxAdapter';
 import { type OpenSandboxConnectionConfig, type OpenSandboxConfigType } from './OpenSandboxAdapter';
 import { type E2BConfig } from './E2BAdapter';
 import { ISandbox } from '@/interfaces';
 export { SealosDevboxAdapter } from './SealosDevboxAdapter';
-export type { SealosDevboxConfig } from './SealosDevboxAdapter';
+export type { SealosDevboxConfig, SealosDevboxCreateConfig } from './SealosDevboxAdapter';
 export { OpenSandboxAdapter } from './OpenSandboxAdapter';
 export type { OpenSandboxConfigType, OpenSandboxConnectionConfig } from './OpenSandboxAdapter';
 export type { Volume as OpenSandboxVolume } from '@alibaba-group/opensandbox';
@@ -13,7 +13,7 @@ export type SandboxProviderType = 'opensandbox' | 'sealosdevbox' | 'e2b';
 /** Maps each provider name to the ISandbox config type it exposes. */
 interface SandboxConfigMap {
     opensandbox: OpenSandboxConfigType;
-    sealosdevbox: undefined;
+    sealosdevbox: SealosDevboxCreateConfig;
     e2b: undefined;
 }
 /** Resolves the concrete ISandbox type for a given provider. */

package/dist/adapters/ports.d.ts

@@ -0,0 +1,7 @@
+/**
+ * OpenSandbox exposes execd through this direct endpoint. code-server itself is
+ * still reached via execd path proxying at /proxy/8080.
+ */
+export declare const OPEN_SANDBOX_EXECD_PORT = 44772;
+export declare const OPEN_SANDBOX_CODE_SERVER_PORT = 8080;
+export declare const SEALOS_DEVBOX_CODE_SERVER_PORT = 1318;

package/dist/index.cjs

@@ -4,39 +4,60 @@ var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toESMCache_node;
+var __toESMCache_esm;
 var __toESM = (mod, isNodeMode, target) => {
+  var canCache = mod != null && typeof mod === "object";
+  if (canCache) {
+    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
+    var cached = cache.get(mod);
+    if (cached)
+      return cached;
+  }
   target = mod != null ? __create(__getProtoOf(mod)) : {};
   const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
   for (let key of __getOwnPropNames(mod))
     if (!__hasOwnProp.call(to, key))
       __defProp(to, key, {
-        get: () => mod[key],
+        get: __accessProp.bind(mod, key),
         enumerable: true
       });
+  if (canCache)
+    cache.set(mod, to);
   return to;
 };
-var __moduleCache = /* @__PURE__ */ new WeakMap;
 var __toCommonJS = (from) => {
-  var entry = __moduleCache.get(from), desc;
+  var entry = (__moduleCache ??= new WeakMap).get(from), desc;
   if (entry)
     return entry;
   entry = __defProp({}, "__esModule", { value: true });
-  if (from && typeof from === "object" || typeof from === "function")
-    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
-      get: () => from[key],
-      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-    }));
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (var key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(entry, key))
+        __defProp(entry, key, {
+          get: __accessProp.bind(from, key),
+          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+        });
+  }
   __moduleCache.set(from, entry);
   return entry;
 };
+var __moduleCache;
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
       get: all[name],
       enumerable: true,
       configurable: true,
-      set: (newValue) => all[name] = () => newValue
+      set: __exportSetter.bind(all, name)
     });
 };
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
@@ -19139,7 +19160,7 @@ var require_frame = __commonJS((exports2, module2) => {
   var BUFFER_SIZE = 8 * 1024;
   var buffer = null;
   var bufIdx = BUFFER_SIZE;
-  var randomFillSync = runtimeFeatures.has("crypto") ? require("node:crypto").randomFillSync : function randomFillSync(buffer2, _offset, _size) {
+  var randomFillSync = runtimeFeatures.has("crypto") ? require("node:crypto").randomFillSync : function randomFillSync2(buffer2, _offset, _size) {
     for (let i = 0;i < buffer2.length; ++i) {
       buffer2[i] = Math.random() * 255 | 0;
     }
@@ -21083,7 +21104,7 @@ var require_eventsource = __commonJS((exports2, module2) => {
 
 // node_modules/undici/index.js
 var require_undici = __commonJS((exports2, module2) => {
-  var __filename = "/Volumes/code/dev/agent-sandbox-adaptor/node_modules/undici/index.js";
+  var __filename = "/Users/sealos/Documents/GitHub/agent-sandbox-adaptor/node_modules/undici/index.js";
   var Client = require_client();
   var Dispatcher = require_dispatcher();
   var Pool = require_pool();
@@ -21206,7 +21227,7 @@ var require_undici = __commonJS((exports2, module2) => {
     err.stack = stack ? `${stack}
 ${captureLines}` : capture.stack;
   }
-  module2.exports.fetch = function fetch(init, options = undefined) {
+  module2.exports.fetch = function fetch2(init, options = undefined) {
     return fetchImpl(init, options).catch((err) => {
       appendFetchStackTrace(err, __filename);
       throw err;
@@ -45388,6 +45409,12 @@ class BaseSandboxAdapter {
   async renewExpiration(_additionalSeconds) {
     throw new FeatureNotSupportedError("Sandbox expiration renewal not supported by this provider", "renewExpiration", this.provider);
   }
+  async getEndpoint(_selector) {
+    throw new FeatureNotSupportedError("Endpoint resolution not supported by this provider", "getEndpoint", this.provider);
+  }
+  async getProxyTarget(_service = "code-server") {
+    throw new FeatureNotSupportedError("Proxy target resolution not supported by this provider", "getProxyTarget", this.provider);
+  }
   async executeStream(command, handlers, options) {
     const result = await this.execute(command, options);
     if (handlers.onStdout && result.stdout) {
@@ -45624,10 +45651,10 @@ class DevboxApi {
     const result = await res.json();
     return result;
   }
-  async create(name) {
+  async create(req) {
     return this.request(this.url("/api/v1/devbox"), {
       method: "POST",
-      body: JSON.stringify({ name })
+      body: JSON.stringify(req)
     });
   }
   async info(name) {
@@ -45685,18 +45712,60 @@ class DevboxApi {
   }
 }
 
+// src/adapters/ports.ts
+var OPEN_SANDBOX_EXECD_PORT = 44772;
+var OPEN_SANDBOX_CODE_SERVER_PORT = 8080;
+var SEALOS_DEVBOX_CODE_SERVER_PORT = 1318;
+
+// src/utils/image.ts
+function formatImageSpec(image) {
+  const parts = [image.repository];
+  if (image.tag)
+    parts.push(":", image.tag);
+  if (image.digest)
+    parts.push("@", image.digest);
+  return parts.join("");
+}
+function parseImageSpec(image) {
+  if (!image)
+    return { repository: "" };
+  const atIndex = image.indexOf("@");
+  if (atIndex > -1) {
+    return { repository: image.slice(0, atIndex), digest: image.slice(atIndex + 1) };
+  }
+  const colonIndex = image.indexOf(":");
+  if (colonIndex > -1) {
+    return { repository: image.slice(0, colonIndex), tag: image.slice(colonIndex + 1) };
+  }
+  return { repository: image };
+}
+
+// src/utils/url.ts
+function normalizePathPrefix(path) {
+  if (!path)
+    return "";
+  const normalized = path.startsWith("/") ? path : `/${path}`;
+  return normalized.length > 1 ? normalized.replace(/\/+$/, "") : "";
+}
+function joinUrlPath(url, path) {
+  const normalizedPath = normalizePathPrefix(path);
+  return normalizedPath ? `${url.replace(/\/+$/, "")}${normalizedPath}` : url.replace(/\/+$/, "");
+}
+
 // src/adapters/SealosDevboxAdapter/index.ts
 class SealosDevboxAdapter extends BaseSandboxAdapter {
   config;
+  createConfig;
   provider = "sealosdevbox";
   get rootPath() {
     return "/home/devbox/workspace";
   }
   api;
   _id;
-  constructor(config) {
+  constructor(config, createConfig) {
     super();
     this.config = config;
+    this.createConfig = createConfig;
     this.api = new DevboxApi({ baseUrl: config.baseUrl, token: config.token });
     this._id = config.sandboxId;
     this.polyfillService = new CommandPolyfillService(this);
@@ -45721,6 +45790,26 @@ class SealosDevboxAdapter extends BaseSandboxAdapter {
         return "Error";
     }
   }
+  buildCreateRequest() {
+    const spec = this.createConfig ?? {};
+    const env = { ...spec.env ?? {} };
+    if (spec.workingDir && !env.CODEX_GATEWAY_CWD) {
+      env.CODEX_GATEWAY_CWD = spec.workingDir;
+    }
+    return this.removeUndefined({
+      name: this._id,
+      image: spec.image ? formatImageSpec(spec.image) : undefined,
+      env: Object.keys(env).length > 0 ? env : undefined,
+      labels: spec.labels,
+      upstreamID: spec.upstreamID,
+      kubeAccess: spec.kubeAccess,
+      pauseAt: spec.lifecycle?.pauseAt,
+      archiveAfterPauseTime: spec.lifecycle?.archiveAfterPauseTime
+    });
+  }
+  removeUndefined(obj) {
+    return Object.fromEntries(Object.entries(obj).filter(([, value]) => value !== undefined));
+  }
   async getInfo() {
     try {
       const res = await this.api.info(this._id);
@@ -45732,10 +45821,10 @@ class SealosDevboxAdapter extends BaseSandboxAdapter {
       this._status = { state: this.StatusAdapt(data), message: res.message };
       return {
         id: data.name,
-        image: { repository: "" },
+        image: parseImageSpec(data.image),
         entrypoint: [],
         status: this._status,
-        createdAt: new Date
+        createdAt: data.creationTimestamp ? new Date(data.creationTimestamp) : new Date
       };
     } catch (error) {
       throw new CommandExecutionError(`Failed to get sandbox info`, "getInfo", error instanceof Error ? error : undefined);
@@ -45773,7 +45862,10 @@ class SealosDevboxAdapter extends BaseSandboxAdapter {
   async create() {
     try {
       this._status = { state: "Creating" };
-      await this.api.create(this._id);
+      const res = await this.api.create(this.buildCreateRequest());
+      if (res.code !== 200 && res.code !== 201) {
+        throw new Error(res.message || `Devbox create failed with code ${res.code}`);
+      }
       await this.waitUntilReady();
       await new Promise((resolve) => setTimeout(resolve, 1000));
       this._status = { state: "Running" };
@@ -45829,11 +45921,98 @@ class SealosDevboxAdapter extends BaseSandboxAdapter {
       throw new CommandExecutionError(`Command execution failed: ${error?.message || error?.code}`, command, error instanceof Error ? error : undefined);
     }
   }
+  async getEndpoint(selector) {
+    const port = typeof selector === "number" ? selector : SEALOS_DEVBOX_CODE_SERVER_PORT;
+    const target = await this.getHttpgateTarget(port);
+    const url = new URL(target.origin);
+    return {
+      host: url.host,
+      port: target.port,
+      protocol: url.protocol === "https:" ? "https" : "http",
+      url: joinUrlPath(target.origin, target.basePath)
+    };
+  }
+  async getProxyTarget(service = "code-server") {
+    if (service !== "code-server") {
+      throw new FeatureNotSupportedError(`Proxy service "${service}" is not supported by this provider`, "getProxyTarget", this.provider);
+    }
+    const target = await this.getHttpgateTarget(SEALOS_DEVBOX_CODE_SERVER_PORT);
+    return {
+      service,
+      origin: target.origin,
+      basePath: target.basePath,
+      auth: "code-server",
+      ...target.password ? { password: target.password } : {}
+    };
+  }
+  async getHttpgateTarget(port) {
+    const res = await this.api.info(this._id);
+    if (res.code !== 200 || !res.data) {
+      throw new ConnectionError(`Failed to get devbox info: ${res.message}`, this.config.baseUrl);
+    }
+    if (port === SEALOS_DEVBOX_CODE_SERVER_PORT) {
+      const gateway2 = res.data.codeServerGateway;
+      if (!gateway2?.url) {
+        throw new ConnectionError("Devbox info does not include codeServerGateway.url; cannot resolve code-server endpoint", this.config.baseUrl);
+      }
+      const codeServerUrl = new URL(gateway2.url);
+      return {
+        origin: codeServerUrl.origin,
+        basePath: normalizePathPrefix(codeServerUrl.pathname),
+        port: gateway2.port ?? port,
+        password: gateway2.password
+      };
+    }
+    const gatewayUrl = res.data.gateway?.url;
+    if (!gatewayUrl) {
+      throw new ConnectionError("Devbox info does not include gateway.url; cannot derive httpgate endpoint", this.config.baseUrl);
+    }
+    const gateway = new URL(gatewayUrl);
+    const uniqueID = this.getGatewayUniqueID(res.data, gateway);
+    const domain = this.getHttpgateDomain(gateway);
+    return {
+      origin: `${gateway.protocol}//devbox-${uniqueID}-${port}.${domain}`,
+      basePath: "",
+      port
+    };
+  }
+  getGatewayUniqueID(data, gateway) {
+    if (data.gateway?.uniqueID)
+      return data.gateway.uniqueID;
+    const parts = gateway.pathname.split("/").filter(Boolean);
+    const uniqueID = parts[parts.length - 1];
+    if (!uniqueID) {
+      throw new ConnectionError("Devbox gateway.url does not include uniqueID; cannot derive httpgate endpoint", this.config.baseUrl);
+    }
+    return uniqueID;
+  }
+  getHttpgateDomain(gateway) {
+    if (this.config.httpgateDomain) {
+      return this.normalizeHttpgateDomain(this.config.httpgateDomain);
+    }
+    const prefix = "devbox-gateway.";
+    if (!gateway.host.startsWith(prefix)) {
+      throw new ConnectionError(`Cannot derive httpgate domain from gateway host "${gateway.host}"`, this.config.baseUrl);
+    }
+    return gateway.host.slice(prefix.length);
+  }
+  normalizeHttpgateDomain(domain) {
+    const trimmed = domain.trim().replace(/^\.+|\.+$/g, "");
+    if (!trimmed) {
+      throw new ConnectionError("httpgateDomain is empty", this.config.baseUrl);
+    }
+    if (trimmed.includes("://")) {
+      return new URL(trimmed).host;
+    }
+    return trimmed;
+  }
   async ping() {
     try {
       const res = await this.api.info(this._id);
       if (res.code !== 200)
         return false;
+      if (!res.data)
+        return false;
       return res.data.state.phase === "Running" /* Running */;
     } catch {
       return false;
@@ -47425,7 +47604,7 @@ function createNodeFetch() {
   const nodeFetch = async (input, init) => {
     dispatcherPromise ??= (async () => {
       try {
-        const mod = await Promise.resolve().then(() => __toESM(require_undici()));
+        const mod = await Promise.resolve().then(() => __toESM(require_undici(), 1));
         const Agent = mod.Agent;
         if (!Agent) {
           return;
@@ -48085,27 +48264,6 @@ class OpenSandboxAdapter extends BaseSandboxAdapter {
       message: sdkStatus.message
     };
   }
-  convertImageSpec(image) {
-    const parts = [image.repository];
-    if (image.tag) {
-      parts.push(":", image.tag);
-    }
-    if (image.digest) {
-      parts.push("@", image.digest);
-    }
-    return parts.join("");
-  }
-  parseImageSpec(image) {
-    const atIndex = image.indexOf("@");
-    if (atIndex > -1) {
-      return { repository: image.slice(0, atIndex), digest: image.slice(atIndex + 1) };
-    }
-    const colonIndex = image.indexOf(":");
-    if (colonIndex > -1) {
-      return { repository: image.slice(0, colonIndex), tag: image.slice(colonIndex + 1) };
-    }
-    return { repository: image };
-  }
   convertResourceLimits(resourceLimits) {
     if (!resourceLimits)
       return;
@@ -48220,7 +48378,7 @@ class OpenSandboxAdapter extends BaseSandboxAdapter {
     }
     try {
       this._status = { state: "Creating" };
-      const image = this.convertImageSpec(cfg.image);
+      const image = formatImageSpec(cfg.image);
       const resource = this.convertResourceLimits(cfg.resourceLimits);
       this.sandbox = await Sandbox.create({
         connectionConfig: this._connection,
@@ -48324,7 +48482,18 @@ class OpenSandboxAdapter extends BaseSandboxAdapter {
   async close() {
     await this.sandbox.close();
   }
-  async getEndpoint(port) {
+  async getEndpoint(selector) {
+    const port = typeof selector === "number" ? selector : OPEN_SANDBOX_EXECD_PORT;
+    const endpoint = await this.getOpenSandboxEndpoint(port);
+    if (selector === "code-server") {
+      return {
+        ...endpoint,
+        url: joinUrlPath(endpoint.url, `/proxy/${OPEN_SANDBOX_CODE_SERVER_PORT}`)
+      };
+    }
+    return endpoint;
+  }
+  async getOpenSandboxEndpoint(port) {
     const sdkEndpoint = await this.sandbox.getEndpoint(port);
     const raw = sdkEndpoint.endpoint;
     const colonIdx = raw.lastIndexOf(":");
@@ -48343,6 +48512,40 @@ class OpenSandboxAdapter extends BaseSandboxAdapter {
       url: `https://${raw}`
     };
   }
+  async getProxyTarget(service = "code-server") {
+    if (service !== "code-server") {
+      throw new FeatureNotSupportedError(`Proxy service "${service}" is not supported by this provider`, "getProxyTarget", this.provider);
+    }
+    return {
+      service,
+      origin: await this.getDirectEndpointOrigin(OPEN_SANDBOX_EXECD_PORT),
+      basePath: `/proxy/${OPEN_SANDBOX_CODE_SERVER_PORT}`,
+      auth: "code-server"
+    };
+  }
+  async getDirectEndpointOrigin(port) {
+    if (!this.id) {
+      throw new SandboxStateError("Sandbox not initialized. Call create() or connect() first.", "UnExist", "Running");
+    }
+    const headers = {
+      ...this._connection.headers,
+      Accept: "application/json"
+    };
+    const response = await this._connection.fetch(`${this._connection.getBaseUrl()}/sandboxes/${this.id}/endpoints/${port}?use_server_proxy=false`, { method: "GET", headers });
+    if (!response.ok) {
+      throw new ConnectionError(`OpenSandbox endpoint lookup failed: HTTP ${response.status}`, this.connectionConfig.baseUrl);
+    }
+    const data = await response.json();
+    if (!data.endpoint) {
+      throw new ConnectionError("OpenSandbox returned no endpoint", this.connectionConfig.baseUrl);
+    }
+    let hostPort = data.endpoint.replace(/\/proxy\/\d+\/?$/, "");
+    if (this.connectionConfig.replaceDockerInternalWithLocalhost) {
+      hostPort = hostPort.replace(/^host\.docker\.internal\b/, "localhost");
+    }
+    const url = new URL(/^https?:\/\//.test(hostPort) ? hostPort : `http://${hostPort}`);
+    return url.origin;
+  }
   async getInfo() {
     if (!this._sandbox) {
       return null;
@@ -48351,7 +48554,7 @@ class OpenSandboxAdapter extends BaseSandboxAdapter {
       const info = await this.sandbox.getInfo();
       return {
         id: info.id,
-        image: typeof info.image === "string" ? this.parseImageSpec(info.image) : ("uri" in info.image) ? this.parseImageSpec(info.image.uri) : info.image,
+        image: typeof info.image === "string" ? parseImageSpec(info.image) : ("uri" in info.image) ? parseImageSpec(info.image.uri) : info.image,
         entrypoint: info.entrypoint,
         metadata: info.metadata,
         status: this.mapStatus(info.status),
@@ -48533,7 +48736,7 @@ class OpenSandboxAdapter extends BaseSandboxAdapter {
 }
 
 // src/adapters/E2BAdapter/index.ts
-var import_code_interpreter = __toESM(require_dist3());
+var import_code_interpreter = __toESM(require_dist3(), 1);
 class E2BAdapter extends BaseSandboxAdapter {
   config;
   provider = "e2b";
@@ -48853,7 +49056,7 @@ function createSandbox(provider, config, createConfig) {
     case "opensandbox":
       return new OpenSandboxAdapter(config, createConfig);
     case "sealosdevbox":
-      return new SealosDevboxAdapter(config);
+      return new SealosDevboxAdapter(config, createConfig);
     case "e2b":
       return new E2BAdapter(config);
     default:

package/dist/index.js

@@ -5,39 +5,60 @@ var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toESMCache_node;
+var __toESMCache_esm;
 var __toESM = (mod, isNodeMode, target) => {
+  var canCache = mod != null && typeof mod === "object";
+  if (canCache) {
+    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
+    var cached = cache.get(mod);
+    if (cached)
+      return cached;
+  }
   target = mod != null ? __create(__getProtoOf(mod)) : {};
   const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
   for (let key of __getOwnPropNames(mod))
     if (!__hasOwnProp.call(to, key))
       __defProp(to, key, {
-        get: () => mod[key],
+        get: __accessProp.bind(mod, key),
         enumerable: true
       });
+  if (canCache)
+    cache.set(mod, to);
   return to;
 };
-var __moduleCache = /* @__PURE__ */ new WeakMap;
 var __toCommonJS = (from) => {
-  var entry = __moduleCache.get(from), desc;
+  var entry = (__moduleCache ??= new WeakMap).get(from), desc;
   if (entry)
     return entry;
   entry = __defProp({}, "__esModule", { value: true });
-  if (from && typeof from === "object" || typeof from === "function")
-    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
-      get: () => from[key],
-      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-    }));
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (var key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(entry, key))
+        __defProp(entry, key, {
+          get: __accessProp.bind(from, key),
+          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+        });
+  }
   __moduleCache.set(from, entry);
   return entry;
 };
+var __moduleCache;
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
       get: all[name],
       enumerable: true,
       configurable: true,
-      set: (newValue) => all[name] = () => newValue
+      set: __exportSetter.bind(all, name)
     });
 };
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
@@ -19141,7 +19162,7 @@ var require_frame = __commonJS((exports, module) => {
   var BUFFER_SIZE = 8 * 1024;
   var buffer = null;
   var bufIdx = BUFFER_SIZE;
-  var randomFillSync = runtimeFeatures.has("crypto") ? __require("node:crypto").randomFillSync : function randomFillSync(buffer2, _offset, _size) {
+  var randomFillSync = runtimeFeatures.has("crypto") ? __require("node:crypto").randomFillSync : function randomFillSync2(buffer2, _offset, _size) {
     for (let i = 0;i < buffer2.length; ++i) {
       buffer2[i] = Math.random() * 255 | 0;
     }
@@ -21085,7 +21106,7 @@ var require_eventsource = __commonJS((exports, module) => {
 
 // node_modules/undici/index.js
 var require_undici = __commonJS((exports, module) => {
-  var __filename = "/Volumes/code/dev/agent-sandbox-adaptor/node_modules/undici/index.js";
+  var __filename = "/Users/sealos/Documents/GitHub/agent-sandbox-adaptor/node_modules/undici/index.js";
   var Client = require_client();
   var Dispatcher = require_dispatcher();
   var Pool = require_pool();
@@ -21208,7 +21229,7 @@ var require_undici = __commonJS((exports, module) => {
     err.stack = stack ? `${stack}
 ${captureLines}` : capture.stack;
   }
-  exports.fetch = function fetch(init, options = undefined) {
+  exports.fetch = function fetch2(init, options = undefined) {
     return fetchImpl(init, options).catch((err) => {
       appendFetchStackTrace(err, __filename);
       throw err;
@@ -45372,6 +45393,12 @@ class BaseSandboxAdapter {
   async renewExpiration(_additionalSeconds) {
     throw new FeatureNotSupportedError("Sandbox expiration renewal not supported by this provider", "renewExpiration", this.provider);
   }
+  async getEndpoint(_selector) {
+    throw new FeatureNotSupportedError("Endpoint resolution not supported by this provider", "getEndpoint", this.provider);
+  }
+  async getProxyTarget(_service = "code-server") {
+    throw new FeatureNotSupportedError("Proxy target resolution not supported by this provider", "getProxyTarget", this.provider);
+  }
   async executeStream(command, handlers, options) {
     const result = await this.execute(command, options);
     if (handlers.onStdout && result.stdout) {
@@ -45608,10 +45635,10 @@ class DevboxApi {
     const result = await res.json();
     return result;
   }
-  async create(name) {
+  async create(req) {
     return this.request(this.url("/api/v1/devbox"), {
       method: "POST",
-      body: JSON.stringify({ name })
+      body: JSON.stringify(req)
     });
   }
   async info(name) {
@@ -45669,18 +45696,60 @@ class DevboxApi {
   }
 }
 
+// src/adapters/ports.ts
+var OPEN_SANDBOX_EXECD_PORT = 44772;
+var OPEN_SANDBOX_CODE_SERVER_PORT = 8080;
+var SEALOS_DEVBOX_CODE_SERVER_PORT = 1318;
+
+// src/utils/image.ts
+function formatImageSpec(image) {
+  const parts = [image.repository];
+  if (image.tag)
+    parts.push(":", image.tag);
+  if (image.digest)
+    parts.push("@", image.digest);
+  return parts.join("");
+}
+function parseImageSpec(image) {
+  if (!image)
+    return { repository: "" };
+  const atIndex = image.indexOf("@");
+  if (atIndex > -1) {
+    return { repository: image.slice(0, atIndex), digest: image.slice(atIndex + 1) };
+  }
+  const colonIndex = image.indexOf(":");
+  if (colonIndex > -1) {
+    return { repository: image.slice(0, colonIndex), tag: image.slice(colonIndex + 1) };
+  }
+  return { repository: image };
+}
+
+// src/utils/url.ts
+function normalizePathPrefix(path) {
+  if (!path)
+    return "";
+  const normalized = path.startsWith("/") ? path : `/${path}`;
+  return normalized.length > 1 ? normalized.replace(/\/+$/, "") : "";
+}
+function joinUrlPath(url, path) {
+  const normalizedPath = normalizePathPrefix(path);
+  return normalizedPath ? `${url.replace(/\/+$/, "")}${normalizedPath}` : url.replace(/\/+$/, "");
+}
+
 // src/adapters/SealosDevboxAdapter/index.ts
 class SealosDevboxAdapter extends BaseSandboxAdapter {
   config;
+  createConfig;
   provider = "sealosdevbox";
   get rootPath() {
     return "/home/devbox/workspace";
   }
   api;
   _id;
-  constructor(config) {
+  constructor(config, createConfig) {
     super();
     this.config = config;
+    this.createConfig = createConfig;
     this.api = new DevboxApi({ baseUrl: config.baseUrl, token: config.token });
     this._id = config.sandboxId;
     this.polyfillService = new CommandPolyfillService(this);
@@ -45705,6 +45774,26 @@ class SealosDevboxAdapter extends BaseSandboxAdapter {
         return "Error";
     }
   }
+  buildCreateRequest() {
+    const spec = this.createConfig ?? {};
+    const env = { ...spec.env ?? {} };
+    if (spec.workingDir && !env.CODEX_GATEWAY_CWD) {
+      env.CODEX_GATEWAY_CWD = spec.workingDir;
+    }
+    return this.removeUndefined({
+      name: this._id,
+      image: spec.image ? formatImageSpec(spec.image) : undefined,
+      env: Object.keys(env).length > 0 ? env : undefined,
+      labels: spec.labels,
+      upstreamID: spec.upstreamID,
+      kubeAccess: spec.kubeAccess,
+      pauseAt: spec.lifecycle?.pauseAt,
+      archiveAfterPauseTime: spec.lifecycle?.archiveAfterPauseTime
+    });
+  }
+  removeUndefined(obj) {
+    return Object.fromEntries(Object.entries(obj).filter(([, value]) => value !== undefined));
+  }
   async getInfo() {
     try {
       const res = await this.api.info(this._id);
@@ -45716,10 +45805,10 @@ class SealosDevboxAdapter extends BaseSandboxAdapter {
       this._status = { state: this.StatusAdapt(data), message: res.message };
       return {
         id: data.name,
-        image: { repository: "" },
+        image: parseImageSpec(data.image),
         entrypoint: [],
         status: this._status,
-        createdAt: new Date
+        createdAt: data.creationTimestamp ? new Date(data.creationTimestamp) : new Date
       };
     } catch (error) {
       throw new CommandExecutionError(`Failed to get sandbox info`, "getInfo", error instanceof Error ? error : undefined);
@@ -45757,7 +45846,10 @@ class SealosDevboxAdapter extends BaseSandboxAdapter {
   async create() {
     try {
       this._status = { state: "Creating" };
-      await this.api.create(this._id);
+      const res = await this.api.create(this.buildCreateRequest());
+      if (res.code !== 200 && res.code !== 201) {
+        throw new Error(res.message || `Devbox create failed with code ${res.code}`);
+      }
       await this.waitUntilReady();
       await new Promise((resolve) => setTimeout(resolve, 1000));
       this._status = { state: "Running" };
@@ -45813,11 +45905,98 @@ class SealosDevboxAdapter extends BaseSandboxAdapter {
       throw new CommandExecutionError(`Command execution failed: ${error?.message || error?.code}`, command, error instanceof Error ? error : undefined);
     }
   }
+  async getEndpoint(selector) {
+    const port = typeof selector === "number" ? selector : SEALOS_DEVBOX_CODE_SERVER_PORT;
+    const target = await this.getHttpgateTarget(port);
+    const url = new URL(target.origin);
+    return {
+      host: url.host,
+      port: target.port,
+      protocol: url.protocol === "https:" ? "https" : "http",
+      url: joinUrlPath(target.origin, target.basePath)
+    };
+  }
+  async getProxyTarget(service = "code-server") {
+    if (service !== "code-server") {
+      throw new FeatureNotSupportedError(`Proxy service "${service}" is not supported by this provider`, "getProxyTarget", this.provider);
+    }
+    const target = await this.getHttpgateTarget(SEALOS_DEVBOX_CODE_SERVER_PORT);
+    return {
+      service,
+      origin: target.origin,
+      basePath: target.basePath,
+      auth: "code-server",
+      ...target.password ? { password: target.password } : {}
+    };
+  }
+  async getHttpgateTarget(port) {
+    const res = await this.api.info(this._id);
+    if (res.code !== 200 || !res.data) {
+      throw new ConnectionError(`Failed to get devbox info: ${res.message}`, this.config.baseUrl);
+    }
+    if (port === SEALOS_DEVBOX_CODE_SERVER_PORT) {
+      const gateway2 = res.data.codeServerGateway;
+      if (!gateway2?.url) {
+        throw new ConnectionError("Devbox info does not include codeServerGateway.url; cannot resolve code-server endpoint", this.config.baseUrl);
+      }
+      const codeServerUrl = new URL(gateway2.url);
+      return {
+        origin: codeServerUrl.origin,
+        basePath: normalizePathPrefix(codeServerUrl.pathname),
+        port: gateway2.port ?? port,
+        password: gateway2.password
+      };
+    }
+    const gatewayUrl = res.data.gateway?.url;
+    if (!gatewayUrl) {
+      throw new ConnectionError("Devbox info does not include gateway.url; cannot derive httpgate endpoint", this.config.baseUrl);
+    }
+    const gateway = new URL(gatewayUrl);
+    const uniqueID = this.getGatewayUniqueID(res.data, gateway);
+    const domain = this.getHttpgateDomain(gateway);
+    return {
+      origin: `${gateway.protocol}//devbox-${uniqueID}-${port}.${domain}`,
+      basePath: "",
+      port
+    };
+  }
+  getGatewayUniqueID(data, gateway) {
+    if (data.gateway?.uniqueID)
+      return data.gateway.uniqueID;
+    const parts = gateway.pathname.split("/").filter(Boolean);
+    const uniqueID = parts[parts.length - 1];
+    if (!uniqueID) {
+      throw new ConnectionError("Devbox gateway.url does not include uniqueID; cannot derive httpgate endpoint", this.config.baseUrl);
+    }
+    return uniqueID;
+  }
+  getHttpgateDomain(gateway) {
+    if (this.config.httpgateDomain) {
+      return this.normalizeHttpgateDomain(this.config.httpgateDomain);
+    }
+    const prefix = "devbox-gateway.";
+    if (!gateway.host.startsWith(prefix)) {
+      throw new ConnectionError(`Cannot derive httpgate domain from gateway host "${gateway.host}"`, this.config.baseUrl);
+    }
+    return gateway.host.slice(prefix.length);
+  }
+  normalizeHttpgateDomain(domain) {
+    const trimmed = domain.trim().replace(/^\.+|\.+$/g, "");
+    if (!trimmed) {
+      throw new ConnectionError("httpgateDomain is empty", this.config.baseUrl);
+    }
+    if (trimmed.includes("://")) {
+      return new URL(trimmed).host;
+    }
+    return trimmed;
+  }
   async ping() {
     try {
       const res = await this.api.info(this._id);
       if (res.code !== 200)
         return false;
+      if (!res.data)
+        return false;
       return res.data.state.phase === "Running" /* Running */;
     } catch {
       return false;
@@ -48069,27 +48248,6 @@ class OpenSandboxAdapter extends BaseSandboxAdapter {
       message: sdkStatus.message
     };
   }
-  convertImageSpec(image) {
-    const parts = [image.repository];
-    if (image.tag) {
-      parts.push(":", image.tag);
-    }
-    if (image.digest) {
-      parts.push("@", image.digest);
-    }
-    return parts.join("");
-  }
-  parseImageSpec(image) {
-    const atIndex = image.indexOf("@");
-    if (atIndex > -1) {
-      return { repository: image.slice(0, atIndex), digest: image.slice(atIndex + 1) };
-    }
-    const colonIndex = image.indexOf(":");
-    if (colonIndex > -1) {
-      return { repository: image.slice(0, colonIndex), tag: image.slice(colonIndex + 1) };
-    }
-    return { repository: image };
-  }
   convertResourceLimits(resourceLimits) {
     if (!resourceLimits)
       return;
@@ -48204,7 +48362,7 @@ class OpenSandboxAdapter extends BaseSandboxAdapter {
     }
     try {
       this._status = { state: "Creating" };
-      const image = this.convertImageSpec(cfg.image);
+      const image = formatImageSpec(cfg.image);
       const resource = this.convertResourceLimits(cfg.resourceLimits);
       this.sandbox = await Sandbox.create({
         connectionConfig: this._connection,
@@ -48308,7 +48466,18 @@ class OpenSandboxAdapter extends BaseSandboxAdapter {
   async close() {
     await this.sandbox.close();
   }
-  async getEndpoint(port) {
+  async getEndpoint(selector) {
+    const port = typeof selector === "number" ? selector : OPEN_SANDBOX_EXECD_PORT;
+    const endpoint = await this.getOpenSandboxEndpoint(port);
+    if (selector === "code-server") {
+      return {
+        ...endpoint,
+        url: joinUrlPath(endpoint.url, `/proxy/${OPEN_SANDBOX_CODE_SERVER_PORT}`)
+      };
+    }
+    return endpoint;
+  }
+  async getOpenSandboxEndpoint(port) {
     const sdkEndpoint = await this.sandbox.getEndpoint(port);
     const raw = sdkEndpoint.endpoint;
     const colonIdx = raw.lastIndexOf(":");
@@ -48327,6 +48496,40 @@ class OpenSandboxAdapter extends BaseSandboxAdapter {
       url: `https://${raw}`
     };
   }
+  async getProxyTarget(service = "code-server") {
+    if (service !== "code-server") {
+      throw new FeatureNotSupportedError(`Proxy service "${service}" is not supported by this provider`, "getProxyTarget", this.provider);
+    }
+    return {
+      service,
+      origin: await this.getDirectEndpointOrigin(OPEN_SANDBOX_EXECD_PORT),
+      basePath: `/proxy/${OPEN_SANDBOX_CODE_SERVER_PORT}`,
+      auth: "code-server"
+    };
+  }
+  async getDirectEndpointOrigin(port) {
+    if (!this.id) {
+      throw new SandboxStateError("Sandbox not initialized. Call create() or connect() first.", "UnExist", "Running");
+    }
+    const headers = {
+      ...this._connection.headers,
+      Accept: "application/json"
+    };
+    const response = await this._connection.fetch(`${this._connection.getBaseUrl()}/sandboxes/${this.id}/endpoints/${port}?use_server_proxy=false`, { method: "GET", headers });
+    if (!response.ok) {
+      throw new ConnectionError(`OpenSandbox endpoint lookup failed: HTTP ${response.status}`, this.connectionConfig.baseUrl);
+    }
+    const data = await response.json();
+    if (!data.endpoint) {
+      throw new ConnectionError("OpenSandbox returned no endpoint", this.connectionConfig.baseUrl);
+    }
+    let hostPort = data.endpoint.replace(/\/proxy\/\d+\/?$/, "");
+    if (this.connectionConfig.replaceDockerInternalWithLocalhost) {
+      hostPort = hostPort.replace(/^host\.docker\.internal\b/, "localhost");
+    }
+    const url = new URL(/^https?:\/\//.test(hostPort) ? hostPort : `http://${hostPort}`);
+    return url.origin;
+  }
   async getInfo() {
     if (!this._sandbox) {
       return null;
@@ -48335,7 +48538,7 @@ class OpenSandboxAdapter extends BaseSandboxAdapter {
       const info = await this.sandbox.getInfo();
       return {
         id: info.id,
-        image: typeof info.image === "string" ? this.parseImageSpec(info.image) : ("uri" in info.image) ? this.parseImageSpec(info.image.uri) : info.image,
+        image: typeof info.image === "string" ? parseImageSpec(info.image) : ("uri" in info.image) ? parseImageSpec(info.image.uri) : info.image,
         entrypoint: info.entrypoint,
         metadata: info.metadata,
         status: this.mapStatus(info.status),
@@ -48837,7 +49040,7 @@ function createSandbox(provider, config, createConfig) {
     case "opensandbox":
       return new OpenSandboxAdapter(config, createConfig);
     case "sealosdevbox":
-      return new SealosDevboxAdapter(config);
+      return new SealosDevboxAdapter(config, createConfig);
     case "e2b":
       return new E2BAdapter(config);
     default:

package/dist/interfaces/ISandbox.d.ts

@@ -2,6 +2,7 @@ import type { ICommandExecution } from './ICommandExecution';
 import type { IFileSystem } from './IFileSystem';
 import type { IHealthCheck } from './IHealthCheck';
 import type { ISandboxLifecycle } from './ISandboxLifecycle';
+import type { Endpoint, SandboxEndpointSelector, SandboxProxyService, SandboxProxyTarget } from '../types';
 /**
  * Unified sandbox interface.
  * Composes all sandbox behaviors into a single interface.
@@ -15,4 +16,8 @@ import type { ISandboxLifecycle } from './ISandboxLifecycle';
 export interface ISandbox extends ISandboxLifecycle, ICommandExecution, IFileSystem, IHealthCheck {
     /** Provider name (e.g., 'opensandbox') */
     readonly provider: string;
+    /** Resolve an endpoint exposed by the sandbox provider. */
+    getEndpoint(selector: SandboxEndpointSelector): Promise<Endpoint>;
+    /** Resolve the upstream target used by FastGPT sandbox-proxy. */
+    getProxyTarget(service?: SandboxProxyService): Promise<SandboxProxyTarget>;
 }

package/dist/types/index.d.ts

@@ -1,3 +1,3 @@
 export type { BackgroundExecution, ExecuteOptions, ExecuteResult, OutputMessage, StreamHandlers } from './execution';
 export type { ContentReplaceEntry, DirectoryEntry, FileDeleteResult, FileInfo, FileReadResult, FileWriteEntry, FileWriteResult, MoveEntry, PermissionEntry, ReadFileOptions, SearchResult } from './filesystem';
-export type { Endpoint, ImageSpec, NetworkPolicy, ResourceLimits, SandboxId, SandboxInfo, SandboxMetrics, SandboxState, SandboxStatus } from './sandbox';
+export type { Endpoint, ImageSpec, KubeAccessPolicy, LabelSpec, LifecyclePolicy, NetworkPolicy, ResourceLimits, SandboxCreateSpec, SandboxEndpointSelector, SandboxId, SandboxInfo, SandboxMetrics, SandboxProxyService, SandboxProxyTarget, SandboxState, SandboxStatus } from './sandbox';

package/dist/types/sandbox.d.ts

@@ -37,6 +37,18 @@ export interface NetworkPolicy {
     allowEgress?: boolean;
     allowedHosts?: string[];
 }
+export interface LabelSpec {
+    key: string;
+    value: string;
+}
+export interface LifecyclePolicy {
+    pauseAt?: string;
+    archiveAfterPauseTime?: string;
+}
+export interface KubeAccessPolicy {
+    enabled?: boolean;
+    roleTemplate?: 'view' | 'edit' | 'admin';
+}
 /**
  * Information about a sandbox.
  */
@@ -69,3 +81,36 @@ export interface Endpoint {
     protocol: 'http' | 'https';
     url: string;
 }
+/**
+ * App-facing create spec shared by callers that choose a provider at runtime.
+ * Individual adapters should map only the fields their backend actually supports.
+ */
+export interface SandboxCreateSpec {
+    image?: ImageSpec;
+    entrypoint?: string[];
+    timeout?: number;
+    timeoutSeconds?: number | null;
+    resourceLimits?: ResourceLimits;
+    env?: Record<string, string>;
+    metadata?: Record<string, unknown>;
+    labels?: LabelSpec[];
+    lifecycle?: LifecyclePolicy;
+    kubeAccess?: KubeAccessPolicy;
+    networkPolicy?: NetworkPolicy;
+    volumes?: unknown[];
+    workingDir?: string;
+    upstreamID?: string;
+    extensions?: Record<string, unknown>;
+    skipHealthCheck?: boolean;
+    readyTimeoutSeconds?: number;
+    healthCheckPollingInterval?: number;
+}
+export type SandboxProxyService = 'code-server';
+export type SandboxEndpointSelector = number | SandboxProxyService;
+export interface SandboxProxyTarget {
+    service: SandboxProxyService;
+    origin: string;
+    basePath: string;
+    auth: 'code-server';
+    password?: string;
+}

package/dist/utils/image.d.ts

@@ -0,0 +1,3 @@
+import type { ImageSpec } from '@/types';
+export declare function formatImageSpec(image: ImageSpec): string;
+export declare function parseImageSpec(image?: string): ImageSpec;

package/dist/utils/url.d.ts

@@ -0,0 +1,2 @@
+export declare function normalizePathPrefix(path: string): string;
+export declare function joinUrlPath(url: string, path: string): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fastgpt-sdk/sandbox-adapter",
-  "version": "0.0.36",
+  "version": "0.0.37",
   "description": "Unified abstraction layer for cloud sandbox providers with adapter pattern and feature polyfilling",
   "type": "module",
   "main": "./dist/index.cjs",