@jkawwa/paperclipai-plugin-e2b 0.3.1-jk.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +41 -0
  2. package/package.json +53 -0
package/README.md ADDED
@@ -0,0 +1,41 @@
1
+ # `@paperclipai/plugin-e2b`
2
+
3
+ Published E2B sandbox provider plugin for Paperclip.
4
+
5
+ This package lives in the Paperclip monorepo, but it is intentionally excluded from the root `pnpm` workspace and shaped to publish and install like a standalone npm package. That means operators can install it from the Plugins page by package name, and the host will fetch its transitive dependencies at install time without adding lockfile churn to the Paperclip repo.
6
+
7
+ ## Install
8
+
9
+ From a Paperclip instance, install:
10
+
11
+ ```text
12
+ @paperclipai/plugin-e2b
13
+ ```
14
+
15
+ The host plugin installer runs `npm install` into the managed plugin directory, so package dependencies such as `e2b` are pulled in during installation.
16
+
17
+ ## Configuration
18
+
19
+ Configure E2B from `Company Settings -> Environments`, not from the plugin's instance settings page.
20
+
21
+ - Put the E2B API key on the sandbox environment itself.
22
+ - When you save an environment, Paperclip stores pasted API keys as company secrets.
23
+ - `E2B_API_KEY` remains an optional host-level fallback when an environment omits the key.
24
+
25
+ ## Local development
26
+
27
+ ```bash
28
+ cd packages/plugins/sandbox-providers/e2b
29
+ pnpm install --ignore-workspace --no-lockfile
30
+ pnpm build
31
+ pnpm test
32
+ pnpm typecheck
33
+ ```
34
+
35
+ These commands assume the repo root has already been installed once so the local `@paperclipai/plugin-sdk` workspace package is available to the compiler during development.
36
+
37
+ ## Package layout
38
+
39
+ - `src/manifest.ts` declares the sandbox-provider driver metadata
40
+ - `src/plugin.ts` implements the environment lifecycle hooks
41
+ - `paperclipPlugin.manifest` and `paperclipPlugin.worker` point the host at the built plugin entrypoints in `dist/`
package/package.json ADDED
@@ -0,0 +1,53 @@
1
+ {
2
+ "name": "@jkawwa/paperclipai-plugin-e2b",
3
+ "version": "0.3.1-jk.1",
4
+ "description": "E2B sandbox provider plugin for Paperclip environments",
5
+ "license": "MIT",
6
+ "homepage": "https://github.com/paperclipai/paperclip",
7
+ "bugs": {
8
+ "url": "https://github.com/paperclipai/paperclip/issues"
9
+ },
10
+ "repository": {
11
+ "type": "git",
12
+ "url": "https://github.com/paperclipai/paperclip",
13
+ "directory": "packages/plugins/sandbox-providers/e2b"
14
+ },
15
+ "type": "module",
16
+ "exports": {
17
+ ".": {
18
+ "types": "./dist/index.d.ts",
19
+ "import": "./dist/index.js"
20
+ }
21
+ },
22
+ "publishConfig": {
23
+ "access": "public"
24
+ },
25
+ "files": [
26
+ "dist"
27
+ ],
28
+ "paperclipPlugin": {
29
+ "manifest": "./dist/manifest.js",
30
+ "worker": "./dist/worker.js"
31
+ },
32
+ "keywords": [
33
+ "paperclip",
34
+ "plugin",
35
+ "sandbox",
36
+ "e2b"
37
+ ],
38
+ "scripts": {
39
+ "build": "rm -rf dist && tsc",
40
+ "clean": "rm -rf dist",
41
+ "test": "vitest run --config vitest.config.ts"
42
+ },
43
+ "dependencies": {
44
+ "e2b": "^2.19.0"
45
+ },
46
+ "devDependencies": {
47
+ "@types/node": "^24.6.0",
48
+ "typescript": "^5.7.3",
49
+ "vitest": "^3.2.4"
50
+ },
51
+ "main": "./dist/index.js",
52
+ "types": "./dist/index.d.ts"
53
+ }