@denieler/e2b-codex 0.1.1 → 0.1.3

package/README.md

@@ -1,11 +1,9 @@
-# @denieler/e2e-codex
+# @denieler/e2b-codex
 
 Use a shared E2B template with Codex preinstalled, then create fresh sandboxes from that template and talk to `codex app-server` over websocket.
 
 ![e2b-codex banner](https://raw.githubusercontent.com/denieler/e2b-codex/main/assets/e2b-codex-banner.svg)
 
-![e2b-codex banner](./assets/e2b-codex-banner.svg)
-
 This project covers two jobs:
 
 - runtime use: create a sandbox, connect to Codex, send prompts, continue conversations
@@ -16,7 +14,7 @@ This project covers two jobs:
 Install the package:
 
 ```bash
-npm install @denieler/e2e-codex
+npm install @denieler/e2b-codex
 ```
 
 ### What you need
@@ -47,7 +45,7 @@ What this does:
 ### Create a ready sandbox in code
 
 ```ts
-import { createReadyCodexSandbox } from "@denieler/e2e-codex";
+import { createReadyCodexSandbox } from "@denieler/e2b-codex";
 
 const ready = await createReadyCodexSandbox({
   e2bApiKey: process.env.E2B_API_KEY!,
@@ -64,10 +62,25 @@ The returned object includes:
 - `authToken`
 - `workspaceRoot`
 
+### Connect to an existing sandbox in code
+
+```ts
+import { connectCodexSandbox } from "@denieler/e2b-codex";
+
+const ready = await connectCodexSandbox({
+  e2bApiKey: process.env.E2B_API_KEY!,
+  sandboxId: "sandbox-id",
+  openAiApiKey: process.env.OPENAI_API_KEY!,
+  userId: "user-123",
+});
+```
+
+Use this when you already persisted `sandboxId` and want to reconnect to the same sandbox instead of creating a new one.
+
 ### Connect to Codex over websocket
 
 ```ts
-import { connectCodexClient } from "@denieler/e2e-codex";
+import { connectCodexClient } from "@denieler/e2b-codex";
 
 const client = await connectCodexClient(ready);
 ```
@@ -115,7 +128,7 @@ If your websocket connection drops, reconnect using the same `websocketUrl` and
 If you want one fresh sandbox and one prompt, use:
 
 ```ts
-import { createReadyCodexSandbox, runPrompt } from "@denieler/e2e-codex";
+import { createReadyCodexSandbox, runPrompt } from "@denieler/e2b-codex";
 
 const sandbox = await createReadyCodexSandbox({
   e2bApiKey: process.env.E2B_API_KEY!,

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { CodexAppServerClient } from "./codex-app-server.js";
 export { loadLocalEnvFile, requireEnvVar } from "./env.js";
 export { template } from "./template.js";
-export { connectCodexClient, createReadyCodexSandbox, runPrompt, } from "./sandbox.js";
-export type { CreateCodexSandboxOptions, ReadyCodexSandbox } from "./sandbox.js";
+export { connectCodexSandbox, connectCodexClient, createReadyCodexSandbox, runPrompt, } from "./sandbox.js";
+export type { CodexSandboxOptions, ConnectCodexSandboxOptions, CreateCodexSandboxOptions, ReadyCodexSandbox, } from "./sandbox.js";

package/dist/index.js

@@ -1,4 +1,4 @@
 export { CodexAppServerClient } from "./codex-app-server.js";
 export { loadLocalEnvFile, requireEnvVar } from "./env.js";
 export { template } from "./template.js";
-export { connectCodexClient, createReadyCodexSandbox, runPrompt, } from "./sandbox.js";
+export { connectCodexSandbox, connectCodexClient, createReadyCodexSandbox, runPrompt, } from "./sandbox.js";

package/dist/sandbox.d.ts

@@ -1,8 +1,7 @@
 import { Sandbox } from "e2b";
 import { CodexAppServerClient } from "./codex-app-server.js";
-export type CreateCodexSandboxOptions = {
+export type CodexSandboxOptions = {
     e2bApiKey: string;
-    templateId: string;
     openAiApiKey: string;
     userId: string;
     timeoutMs?: number;
@@ -11,6 +10,12 @@ export type CreateCodexSandboxOptions = {
     workspaceRoot?: string;
     metadata?: Record<string, string>;
 };
+export type CreateCodexSandboxOptions = CodexSandboxOptions & {
+    templateId: string;
+};
+export type ConnectCodexSandboxOptions = Omit<CodexSandboxOptions, "allowInternetAccess" | "metadata"> & {
+    sandboxId: string;
+};
 export type ReadyCodexSandbox = {
     sandbox: Sandbox;
     sandboxId: string;
@@ -20,6 +25,7 @@ export type ReadyCodexSandbox = {
     workspaceRoot: string;
 };
 export declare function createReadyCodexSandbox(options: CreateCodexSandboxOptions): Promise<ReadyCodexSandbox>;
+export declare function connectCodexSandbox(options: ConnectCodexSandboxOptions): Promise<ReadyCodexSandbox>;
 export declare function connectCodexClient(readySandbox: Pick<ReadyCodexSandbox, "websocketUrl" | "authToken">): Promise<CodexAppServerClient>;
 export declare function runPrompt(options: {
     sandbox: ReadyCodexSandbox;

package/dist/sandbox.js

@@ -73,6 +73,30 @@ export async function createReadyCodexSandbox(options) {
         workspaceRoot,
     };
 }
+export async function connectCodexSandbox(options) {
+    const port = options.port ?? 4571;
+    const workspaceRoot = options.workspaceRoot ?? "/workspace";
+    const sandbox = await Sandbox.connect(options.sandboxId, {
+        apiKey: options.e2bApiKey,
+    });
+    if (options.timeoutMs) {
+        await sandbox.setTimeout(options.timeoutMs);
+    }
+    await ensureAppServerRunning(sandbox, {
+        openAiApiKey: options.openAiApiKey,
+        port,
+        workspaceRoot,
+        userId: options.userId,
+    });
+    return {
+        sandbox,
+        sandboxId: sandbox.sandboxId,
+        websocketUrl: `wss://${sandbox.getHost(port)}`,
+        authToken: createAppServerToken(options.userId),
+        port,
+        workspaceRoot,
+    };
+}
 export async function connectCodexClient(readySandbox) {
     let lastError = null;
     for (let attempt = 0; attempt < 20; attempt += 1) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@denieler/e2b-codex",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Build and use E2B sandboxes with Codex preinstalled and codex app-server ready over websocket.",
   "license": "MIT",
   "type": "module",