@capsule-run/cli 0.5.2 → 0.6.0

package/README.md

@@ -20,7 +20,7 @@ npm install -g @capsule-run/cli
 npm install @capsule-run/sdk
 ```
 
-## Quick Start
+## Getting started
 
 Create `hello.ts`:
 
@@ -44,6 +44,35 @@ capsule run hello.ts
 
 > Use `--verbose` to display real-time task execution details.
 
+## Integrate Into an Existing Project
+
+The `run()` function lets you execute tasks programmatically from your application code, no CLI needed.
+
+> You need `@capsule-run/cli` in your dependencies to use the `runner` functions in TypeScript.
+
+```typescript
+import { run } from '@capsule-run/sdk/runner';
+
+const result = await run({
+  file: './capsule.ts',
+  args: ['code to execute']
+});
+```
+
+Create `capsule.ts`:
+
+```typescript
+import { task } from "@capsule-run/sdk";
+
+export const main = task({
+  name: "main",
+  compute: "LOW",
+  ram: "64MB"
+}, (code: string): string => {
+  return eval(code);
+});
+```
+
 ## How It Works
 
 Simply use a wrapper function to define your tasks:
@@ -108,11 +137,12 @@ Every task returns a structured JSON envelope containing both the result and exe
 | Parameter | Description | Type | Default | Example |
 |-----------|-------------|------|---------|---------|
 | `name` | Task identifier | `string` | *required* | `"process_data"` |
-| `compute` | CPU level: `"LOW"`, `"MEDIUM"`, `"HIGH"` | `string` | `"MEDIUM"` | `"HIGH"` |
+| `compute` | CPU level: `"LOW"`, `"MEDIUM`", `"HIGH"` | `string` | `"MEDIUM"` | `"HIGH"` |
 | `ram` | Memory limit | `string` | unlimited | `"512MB"`, `"2GB"` |
 | `timeout` | Maximum execution time | `string` or `number` | unlimited | `"30s"`, `"5m"`, `30000` (ms) |
 | `maxRetries` | Retry attempts on failure | `number` | `0` | `3` |
 | `allowedFiles` | Folders accessible in the sandbox | `string[]` | `[]` | `["./data", "./output"]` |
+| `allowedHosts` | Domains accessible in the sandbox | `string[]` | `["*"]` | `["api.openai.com", "*.anthropic.com"]` |
 | `envVariables` | Environment variables accessible in the sandbox | `string[]` | `[]` | `["API_KEY"]` |
 
 ### Compute Levels
@@ -163,6 +193,24 @@ export const main = task({ name: "main", allowedFiles: ["./data"] }, async () =>
 });
 ```
 
+### Network Access
+
+Tasks can make HTTP requests to domains specified in `allowedHosts`. By default, all outbound requests are allowed (`[\"*\"]`). Restrict access by providing a whitelist of domains.
+
+> Wildcards are supported: `*.example.com` matches all subdomains of `example.com`.
+
+```typescript
+import { task } from "@capsule-run/sdk";
+
+export const main = task({
+    name: "main",
+    allowedHosts: ["api.openai.com", "*.anthropic.com"]
+}, async () => {
+    const response = await fetch("https://api.openai.com/v1/models");
+    return response.json();
+});
+```
+
 ### Environment Variables
 
 Tasks can access environment variables to read configuration, API keys, or other runtime settings. Use the standard `process.env`:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capsule-run/cli",
-  "version": "0.5.2",
+  "version": "0.6.0",
   "description": "Secure WASM runtime to isolate and manage AI agent tasks",
   "bin": {
     "capsule": "./bin/capsule.js"
@@ -29,9 +29,9 @@
     "node": ">=18"
   },
   "optionalDependencies": {
-    "@capsule-run/cli-darwin-arm64": "0.5.2",
-    "@capsule-run/cli-darwin-x64": "0.5.2",
-    "@capsule-run/cli-linux-x64": "0.5.2",
-    "@capsule-run/cli-win32-x64": "0.5.2"
+    "@capsule-run/cli-darwin-arm64": "0.6.0",
+    "@capsule-run/cli-darwin-x64": "0.6.0",
+    "@capsule-run/cli-linux-x64": "0.6.0",
+    "@capsule-run/cli-win32-x64": "0.6.0"
   }
 }