@fastgpt-sdk/sandbox-adapter 0.0.36 → 0.0.38-beta.0

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,11 +11,13 @@ 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 */
     pause(name: string): Promise<DevboxApiResponse<DevboxMutationData>>;
+    /** POST /api/v1/devbox/{name}/stop */
+    stop(name: string): Promise<DevboxApiResponse<DevboxMutationData>>;
     /** POST /api/v1/devbox/{name}/resume */
     resume(name: string): Promise<DevboxApiResponse<DevboxMutationData>>;
     /** DELETE /api/v1/devbox/{name} */

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,13 @@ 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 waitForCodeServerHealthz;
+    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

@@ -46,12 +46,30 @@ export interface ExecResponseData {
     stderr: string;
     executedAt: string;
 }
-/** Response data from create/pause/resume/delete endpoints. */
+/** Response data from create/pause/stop/resume/delete endpoints. */
 export interface DevboxMutationData {
     name: string;
+    namespace?: string;
     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 +81,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;