@agen-ai/sandbox 0.0.0-stage → 0.4.4

package/dist/withSandbox.js

@@ -0,0 +1,39 @@
+import { SandboxRunError } from "./errors.js";
+import { parseSandboxRunOptions } from "./internal/operations.js";
+import { actualOperation, observe } from "./lifecycle/observation.js";
+import { parseSandboxRequest } from "./policy/parse.js";
+async function withSandbox(backend, request, use, options) {
+  const parsed = parseSandboxRunOptions(options);
+  const admitted = parseSandboxRequest(request);
+  if (typeof use !== "function") throw new TypeError("Sandbox use must be a function.");
+  const operation = parsed.signal === void 0 ? {} : { signal: parsed.signal };
+  const owner = backend.reserve(admitted, parsed.recovery);
+  let outcome;
+  try {
+    const sandbox = await owner.start(operation);
+    operation.signal?.throwIfAborted();
+    const actual = actualOperation(() => use(sandbox));
+    const execution = admitted.policy.execution;
+    const value = await observe(actual, execution.kind === "deadline" ? execution.timeoutMs : void 0, {
+      ...operation,
+      onInterrupt: () => {
+        void owner.stop().catch(() => {
+        });
+      }
+    });
+    outcome = { kind: "returned", value };
+  } catch (error) {
+    outcome = { kind: "threw", error };
+  }
+  try {
+    await owner.destroy();
+  } catch (cleanupError) {
+    if (outcome.kind === "threw") throw new SandboxRunError({ primaryError: outcome.error, cleanupError, owner });
+    throw cleanupError;
+  }
+  if (outcome.kind === "threw") throw outcome.error;
+  return outcome.value;
+}
+export {
+  withSandbox
+};

package/package.json

@@ -1,6 +1,79 @@
 {
   "name": "@agen-ai/sandbox",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.4.4",
+  "private": false,
+  "description": "Bounded provider-neutral sandbox ownership, processes, files and recovery contracts.",
+  "type": "module",
+  "sideEffects": false,
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./backend": {
+      "types": "./dist/backend/index.d.ts",
+      "import": "./dist/backend/index.js"
+    },
+    "./acp": {
+      "types": "./dist/acp/index.d.ts",
+      "import": "./dist/acp/index.js"
+    },
+    "./node": {
+      "types": "./dist/node/index.d.ts",
+      "import": "./dist/node/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "zod": "4.4.3",
+    "@agen-ai/validation": "^0.4.4"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.0",
+    "@agen-ai/agent-runtime": "^0.4.4",
+    "@agen-ai/provider-acp": "^0.4.4",
+    "@agen-ai/agent-protocol": "^0.4.4"
+  },
+  "peerDependencies": {
+    "@agen-ai/provider-acp": "^0.4.4"
+  },
+  "peerDependenciesMeta": {
+    "@agen-ai/provider-acp": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/trevor-nichols/agenai-agent-sdk.git",
+    "directory": "packages/sandbox"
+  },
+  "homepage": "https://github.com/trevor-nichols/agenai-agent-sdk#readme",
+  "bugs": {
+    "url": "https://github.com/trevor-nichols/agenai-agent-sdk/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "pnpm run clean && pnpm run build:runtime && pnpm run build:types",
+    "build:runtime": "tsup",
+    "build:types": "tsc --project tsconfig.json --emitDeclarationOnly --outDir dist",
+    "typecheck": "tsc --noEmit && tsc --project tsconfig.test.json --noEmit",
+    "test": "node --import tsx --test tests/*.test.ts",
+    "clean": "rimraf dist *.tsbuildinfo"
+  }
 }