neckbeard-agent 0.0.4 → 0.0.7

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

@@ -144,6 +144,25 @@ async function runSandboxCommand(sandbox, cmd, timeoutMs) {
     };
   }
 }
+function isWorkspacePackage(pkg, searchPaths) {
+  for (const basePath of searchPaths) {
+    try {
+      const pkgJsonPath = require.resolve(`${pkg}/package.json`, { paths: [basePath] });
+      if (!pkgJsonPath.includes("node_modules")) {
+        return true;
+      }
+      const pkgJson = JSON.parse((0, import_node_fs.readFileSync)(pkgJsonPath, "utf-8"));
+      const version = pkgJson.version || "";
+      if (version.startsWith("workspace:")) {
+        return true;
+      }
+      return false;
+    } catch {
+      continue;
+    }
+  }
+  return false;
+}
 async function resolvePackageVersion(pkg, sourceFileDir) {
   try {
     const pkgJsonPath = require.resolve(`${pkg}/package.json`, { paths: [sourceFileDir] });
@@ -232,6 +251,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 +266,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;
@@ -274,6 +295,7 @@ var Agent = class {
     const esbuild = await getEsbuild();
     const { Sandbox } = await getE2b();
     const collectedExternals = /* @__PURE__ */ new Set();
+    const sourceFileDir = (0, import_node_path.dirname)(this._sourceFile);
     const result = await esbuild.build({
       entryPoints: [this._sourceFile],
       bundle: true,
@@ -320,9 +342,14 @@ var __dirname = __neckbeard_dirname(__filename);
               return null;
             }
             const match = args.path.match(/^(@[^/]+\/[^/]+|[^/]+)/);
-            if (match) {
-              collectedExternals.add(match[1]);
+            if (!match) {
+              return { external: true };
             }
+            const pkgName = match[1];
+            if (isWorkspacePackage(pkgName, [sourceFileDir, process.cwd()])) {
+              return null;
+            }
+            collectedExternals.add(pkgName);
             return { external: true };
           });
         }
@@ -447,7 +474,6 @@ try {
     await sandbox.files.write(SANDBOX_PATHS.runnerModule, runnerCode);
     if (collectedExternals.size > 0) {
       const dependencies = {};
-      const sourceFileDir = (0, import_node_path.dirname)(this._sourceFile);
       for (const pkg of collectedExternals) {
         try {
           dependencies[pkg] = await resolvePackageVersion(pkg, sourceFileDir);
@@ -520,9 +546,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

@@ -111,6 +111,25 @@ async function runSandboxCommand(sandbox, cmd, timeoutMs) {
     };
   }
 }
+function isWorkspacePackage(pkg, searchPaths) {
+  for (const basePath of searchPaths) {
+    try {
+      const pkgJsonPath = __require.resolve(`${pkg}/package.json`, { paths: [basePath] });
+      if (!pkgJsonPath.includes("node_modules")) {
+        return true;
+      }
+      const pkgJson = JSON.parse(readFileSync(pkgJsonPath, "utf-8"));
+      const version = pkgJson.version || "";
+      if (version.startsWith("workspace:")) {
+        return true;
+      }
+      return false;
+    } catch {
+      continue;
+    }
+  }
+  return false;
+}
 async function resolvePackageVersion(pkg, sourceFileDir) {
   try {
     const pkgJsonPath = __require.resolve(`${pkg}/package.json`, { paths: [sourceFileDir] });
@@ -199,6 +218,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 +233,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;
@@ -241,6 +262,7 @@ var Agent = class {
     const esbuild = await getEsbuild();
     const { Sandbox } = await getE2b();
     const collectedExternals = /* @__PURE__ */ new Set();
+    const sourceFileDir = dirname(this._sourceFile);
     const result = await esbuild.build({
       entryPoints: [this._sourceFile],
       bundle: true,
@@ -287,9 +309,14 @@ var __dirname = __neckbeard_dirname(__filename);
               return null;
             }
             const match = args.path.match(/^(@[^/]+\/[^/]+|[^/]+)/);
-            if (match) {
-              collectedExternals.add(match[1]);
+            if (!match) {
+              return { external: true };
             }
+            const pkgName = match[1];
+            if (isWorkspacePackage(pkgName, [sourceFileDir, process.cwd()])) {
+              return null;
+            }
+            collectedExternals.add(pkgName);
             return { external: true };
           });
         }
@@ -414,7 +441,6 @@ try {
     await sandbox.files.write(SANDBOX_PATHS.runnerModule, runnerCode);
     if (collectedExternals.size > 0) {
       const dependencies = {};
-      const sourceFileDir = dirname(this._sourceFile);
       for (const pkg of collectedExternals) {
         try {
           dependencies[pkg] = await resolvePackageVersion(pkg, sourceFileDir);
@@ -487,9 +513,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.4",
+  "version": "0.0.7",
   "description": "Deploy AI agents to E2B sandboxes",
   "type": "module",
   "exports": {