neckbeard-agent 0.0.3 → 0.0.6

package/README.md

@@ -41,6 +41,9 @@ const agent = new Agent({
     summary: z.string(),
     keyPoints: z.array(z.string()),
   }),
+  envs: {
+    ANTHROPIC_API_KEY: process.env.ANTHROPIC_API_KEY,
+  },
   run: async (input) => {
     for await (const message of query({
       prompt: `Research "${input.topic}" and return JSON`,
@@ -67,7 +70,7 @@ npm install neckbeard-agent
 
 ```bash
 export E2B_API_KEY=your-key
-export ANTHROPIC_API_KEY=your-key
+export ANTHROPIC_API_KEY=your-key  # Pass via envs config, not auto-forwarded
 ```
 
 ## The Details
@@ -87,6 +90,7 @@ new Agent({
   },
   files?: [{ url, path }],     // pre-download into sandbox
   claudeDir?: string,          // upload .claude/ skills directory
+  envs?: Record<string, string | undefined>, // environment variables for sandbox
 })
 ```
 
@@ -102,6 +106,19 @@ The `files` option downloads things into the sandbox before your agent runs—us
 
 The `claudeDir` option uploads a local `.claude/` directory to the sandbox, enabling Claude Agent SDK skills. Point it at a directory containing `.claude/skills/*/SKILL.md` files.
 
+The `envs` option passes environment variables to the sandbox. These are available to your agent code via `process.env` and `ctx.env`. Undefined values are filtered out:
+
+```typescript
+const agent = new Agent({
+  template: 'code-interpreter-v1',
+  envs: {
+    ANTHROPIC_API_KEY: process.env.ANTHROPIC_API_KEY,
+    MY_API_KEY: process.env.MY_API_KEY,
+  },
+  // ...
+});
+```
+
 Some packages can't be bundled because they spawn child processes or have native modules. The Claude Agent SDK is like this. These get automatically marked as external and installed via npm in the sandbox.
 
 The `run` function gets a context object with an `executionId`, an `AbortSignal`, environment variables, and a logger.

package/dist/index.cjs

@@ -232,6 +232,7 @@ var Agent = class {
   dependencies;
   files;
   claudeDir;
+  envs;
   /** @internal Used by the sandbox runner - must be public for bundled code access */
   _run;
   _sourceFile;
@@ -246,6 +247,7 @@ var Agent = class {
     this.dependencies = config.dependencies ?? DEFAULT_DEPENDENCIES;
     this.files = config.files ?? [];
     this.claudeDir = config.claudeDir;
+    this.envs = config.envs ?? {};
   }
   get sandboxId() {
     return this._sandboxId;
@@ -272,14 +274,7 @@ var Agent = class {
     if (this._sandboxId) return this._sandboxId;
     const e2bApiKey = requireEnv("E2B_API_KEY");
     const esbuild = await getEsbuild();
-    const { Sandbox, Template } = await getE2b();
-    const templateExists = await Template.aliasExists(this.template, { apiKey: e2bApiKey });
-    if (!templateExists) {
-      throw new DeploymentError(
-        `Template "${this.template}" not found. Create it via E2B CLI: e2b template build --name ${this.template} --cpu-count 2 --memory-mb 2048
-Or use an existing template like 'code-interpreter-v1' (2 cores, 2048 MB) or 'base' (2 cores, 512 MB).`
-      );
-    }
+    const { Sandbox } = await getE2b();
     const collectedExternals = /* @__PURE__ */ new Set();
     const result = await esbuild.build({
       entryPoints: [this._sourceFile],
@@ -527,9 +522,9 @@ try {
       let capturedStderr = "";
       const result = await sandbox.commands.run(`cd ${SANDBOX_PATHS.agentDir} && node runner.mjs`, {
         timeoutMs: this.maxDuration * 1e3,
-        envs: {
-          ANTHROPIC_API_KEY: process.env.ANTHROPIC_API_KEY ?? ""
-        },
+        envs: Object.fromEntries(
+          Object.entries(this.envs).filter(([_, v]) => v !== void 0).map(([k, v]) => [k, v])
+        ),
         onStdout: (data) => {
           capturedStdout += data;
         },

package/dist/index.d.cts

@@ -124,6 +124,20 @@ interface AgentConfig<TInput, TOutput> {
      * - allowedTools includes 'Skill'
      */
     claudeDir?: string;
+    /**
+     * Environment variables to pass to the sandbox.
+     * These will be available to the agent code via process.env and ctx.env.
+     * Undefined values are filtered out.
+     *
+     * @example
+     * ```typescript
+     * envs: {
+     *   ANTHROPIC_API_KEY: process.env.ANTHROPIC_API_KEY,
+     *   MY_API_KEY: process.env.MY_API_KEY,
+     * }
+     * ```
+     */
+    envs?: Record<string, string | undefined>;
 }
 declare class Agent<TInput, TOutput> {
     readonly template: string;
@@ -133,6 +147,7 @@ declare class Agent<TInput, TOutput> {
     readonly dependencies: OsDependencies;
     readonly files: FileDownload[];
     readonly claudeDir?: string;
+    readonly envs: Record<string, string | undefined>;
     /** @internal Used by the sandbox runner - must be public for bundled code access */
     _run: (input: TInput, ctx: AgentRunContext) => Promise<TOutput>;
     private _sourceFile;

package/dist/index.d.ts

@@ -124,6 +124,20 @@ interface AgentConfig<TInput, TOutput> {
      * - allowedTools includes 'Skill'
      */
     claudeDir?: string;
+    /**
+     * Environment variables to pass to the sandbox.
+     * These will be available to the agent code via process.env and ctx.env.
+     * Undefined values are filtered out.
+     *
+     * @example
+     * ```typescript
+     * envs: {
+     *   ANTHROPIC_API_KEY: process.env.ANTHROPIC_API_KEY,
+     *   MY_API_KEY: process.env.MY_API_KEY,
+     * }
+     * ```
+     */
+    envs?: Record<string, string | undefined>;
 }
 declare class Agent<TInput, TOutput> {
     readonly template: string;
@@ -133,6 +147,7 @@ declare class Agent<TInput, TOutput> {
     readonly dependencies: OsDependencies;
     readonly files: FileDownload[];
     readonly claudeDir?: string;
+    readonly envs: Record<string, string | undefined>;
     /** @internal Used by the sandbox runner - must be public for bundled code access */
     _run: (input: TInput, ctx: AgentRunContext) => Promise<TOutput>;
     private _sourceFile;

package/dist/index.js

@@ -199,6 +199,7 @@ var Agent = class {
   dependencies;
   files;
   claudeDir;
+  envs;
   /** @internal Used by the sandbox runner - must be public for bundled code access */
   _run;
   _sourceFile;
@@ -213,6 +214,7 @@ var Agent = class {
     this.dependencies = config.dependencies ?? DEFAULT_DEPENDENCIES;
     this.files = config.files ?? [];
     this.claudeDir = config.claudeDir;
+    this.envs = config.envs ?? {};
   }
   get sandboxId() {
     return this._sandboxId;
@@ -239,14 +241,7 @@ var Agent = class {
     if (this._sandboxId) return this._sandboxId;
     const e2bApiKey = requireEnv("E2B_API_KEY");
     const esbuild = await getEsbuild();
-    const { Sandbox, Template } = await getE2b();
-    const templateExists = await Template.aliasExists(this.template, { apiKey: e2bApiKey });
-    if (!templateExists) {
-      throw new DeploymentError(
-        `Template "${this.template}" not found. Create it via E2B CLI: e2b template build --name ${this.template} --cpu-count 2 --memory-mb 2048
-Or use an existing template like 'code-interpreter-v1' (2 cores, 2048 MB) or 'base' (2 cores, 512 MB).`
-      );
-    }
+    const { Sandbox } = await getE2b();
     const collectedExternals = /* @__PURE__ */ new Set();
     const result = await esbuild.build({
       entryPoints: [this._sourceFile],
@@ -494,9 +489,9 @@ try {
       let capturedStderr = "";
       const result = await sandbox.commands.run(`cd ${SANDBOX_PATHS.agentDir} && node runner.mjs`, {
         timeoutMs: this.maxDuration * 1e3,
-        envs: {
-          ANTHROPIC_API_KEY: process.env.ANTHROPIC_API_KEY ?? ""
-        },
+        envs: Object.fromEntries(
+          Object.entries(this.envs).filter(([_, v]) => v !== void 0).map(([k, v]) => [k, v])
+        ),
         onStdout: (data) => {
           capturedStdout += data;
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neckbeard-agent",
-  "version": "0.0.3",
+  "version": "0.0.6",
   "description": "Deploy AI agents to E2B sandboxes",
   "type": "module",
   "exports": {
@@ -32,20 +32,24 @@
     "prepare": "npm run build"
   },
   "dependencies": {
-    "e2b": "^2.10.2",
     "esbuild": "^0.24.0",
     "pkg-types": "^2.3.0"
   },
   "peerDependencies": {
+    "e2b": "^2.2.0",
     "zod": "^3.0.0 || ^4.0.0"
   },
   "peerDependenciesMeta": {
+    "e2b": {
+      "optional": false
+    },
     "zod": {
       "optional": true
     }
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
+    "e2b": "^2.2.1",
     "tsup": "^8.3.0",
     "typescript": "^5.6.0"
   },