@fastgpt-sdk/sandbox-adapter 0.0.20 → 0.0.22

package/README.md

@@ -10,6 +10,24 @@ A unified, high-level abstraction layer for cloud sandbox providers. It offers a
 pnpm add @fastgpt/sandbox
 ```
 
+## Next.js 集成
+
+如果在 Next.js 项目中使用，需要配置以处理 ESM 依赖。在 `next.config.js` 中添加：
+
+```javascript
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  transpilePackages: ['@fastgpt-sdk/sandbox-adapter'],
+  experimental: {
+    esmExternals: 'loose',
+  },
+};
+
+module.exports = nextConfig;
+```
+
+详细说明请参考 [Next.js 集成指南](./docs/NEXTJS_INTEGRATION.md)。
+
 ## 用途
 
 ### 1. 操作沙盒

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

@@ -1,20 +1,26 @@
 import { BaseSandboxAdapter } from '../BaseSandboxAdapter';
 import type { ExecuteOptions, ExecuteResult, SandboxId, SandboxInfo, FileWriteEntry, FileWriteResult, FileDeleteResult, FileReadResult, MoveEntry, DirectoryEntry } from '@/types';
-import type { E2BConfig, E2BCreateConfig } from './type';
+import type { E2BConfig } from './type';
 /**
  * E2B 沙盒适配器 - 使用官方 SDK
+ *
+ * 使用 metadata 映射上游 sandboxId 到 E2B 实际 ID
  */
 export declare class E2BAdapter extends BaseSandboxAdapter {
     private config;
     readonly provider: "e2b";
     private sandbox;
     private _id;
-    private createConfig?;
-    constructor(config: E2BConfig, createConfig?: E2BCreateConfig);
+    constructor(config: E2BConfig);
     get id(): SandboxId;
+    /**
+     * 通过 metadata 查找 E2B 沙盒实例
+     * @returns E2B Sandbox 实例，如果未找到则返回 null
+     */
+    private findSandbox;
+    private ensureSandbox;
     ensureRunning(): Promise<void>;
     create(): Promise<void>;
-    connect(): Promise<void>;
     start(): Promise<void>;
     stop(): Promise<void>;
     delete(): Promise<void>;
@@ -29,4 +35,4 @@ export declare class E2BAdapter extends BaseSandboxAdapter {
     listDirectory(path: string): Promise<DirectoryEntry[]>;
     ping(): Promise<boolean>;
 }
-export type { E2BConfig, E2BCreateConfig } from './type';
+export type { E2BConfig } from './type';

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

@@ -5,7 +5,7 @@ export interface E2BConfig {
     /** E2B API Key */
     apiKey: string;
     /** 可选的沙盒 ID，用于连接到已存在的沙盒 */
-    sandboxId?: string;
+    sandboxId: string;
     /** 可选的模板 ID，用于创建新沙盒 */
     template?: string;
     /** 可选的超时时间（秒） */
@@ -15,8 +15,3 @@ export interface E2BConfig {
     /** 可选的元数据 */
     metadata?: Record<string, string>;
 }
-/**
- * E2B 创建沙盒配置（用于覆盖构造函数中的配置）
- * 继承自 E2BConfig 但排除 apiKey 和 sandboxId
- */
-export type E2BCreateConfig = Omit<E2BConfig, 'apiKey' | 'sandboxId'>;

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

@@ -1,4 +1,5 @@
 import { ImageSpec, NetworkPolicy, ResourceLimits } from '@/types';
+import type { Volume } from '@alibaba-group/opensandbox';
 /**
  * Configuration for creating a sandbox.
  */
@@ -17,6 +18,8 @@ export interface OpenSandboxConfigType {
     metadata?: Record<string, any>;
     /** Network access policy */
     networkPolicy?: NetworkPolicy;
+    /** Optional volume mounts for persistent storage */
+    volumes?: Volume[];
     /** Provider-specific extensions */
     extensions?: Record<string, unknown>;
     /** Skip readiness checks after create/connect */

package/dist/adapters/index.d.ts

@@ -1,19 +1,19 @@
 import { type SealosDevboxConfig } from './SealosDevboxAdapter';
 import { type OpenSandboxConnectionConfig, type OpenSandboxConfigType } from './OpenSandboxAdapter';
-import { type E2BConfig, type E2BCreateConfig } from './E2BAdapter';
+import { type E2BConfig } from './E2BAdapter';
 import { ISandbox } from '@/interfaces';
 export { SealosDevboxAdapter } from './SealosDevboxAdapter';
 export type { SealosDevboxConfig } from './SealosDevboxAdapter';
 export { OpenSandboxAdapter } from './OpenSandboxAdapter';
 export type { OpenSandboxConfigType, OpenSandboxConnectionConfig } from './OpenSandboxAdapter';
 export { E2BAdapter } from './E2BAdapter';
-export type { E2BConfig, E2BCreateConfig } from './E2BAdapter';
+export type { E2BConfig } from './E2BAdapter';
 export type SandboxProviderType = 'opensandbox' | 'sealosdevbox' | 'e2b';
 /** Maps each provider name to the ISandbox config type it exposes. */
 interface SandboxConfigMap {
     opensandbox: OpenSandboxConfigType;
     sealosdevbox: undefined;
-    e2b: E2BCreateConfig;
+    e2b: undefined;
 }
 /** Resolves the concrete ISandbox type for a given provider. */
 /** Maps each provider name to its constructor (connection) config type. */