executor 1.2.1 → 1.2.3

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.
package/README.md CHANGED
@@ -228,11 +228,20 @@ At a high level, every execution follows the same loop:
228
228
 
229
229
  1. `executor` resolves the current local installation and workspace.
230
230
  2. It builds a tool catalog from built-in tools plus all connected workspace sources.
231
- 3. It runs your TypeScript inside the QuickJS sandbox runtime by default.
231
+ 3. It runs your TypeScript inside the configured sandbox runtime. QuickJS is the default, and `.executor/executor.jsonc` can set `"runtime": "quickjs" | "ses" | "deno"`.
232
232
  4. Tool calls are dispatched through `executor` rather than directly from your code.
233
233
  5. If a tool needs interaction, the run pauses and records a pending interaction.
234
234
  6. Once the interaction is resolved, the execution continues and eventually completes or fails.
235
235
 
236
+ Example:
237
+
238
+ ```jsonc
239
+ {
240
+ "runtime": "ses",
241
+ "sources": {}
242
+ }
243
+ ```
244
+
236
245
  This gives you a stable surface for agent automation:
237
246
 
238
247
  - the agent sees a coherent catalog
@@ -317,6 +326,7 @@ If you are exploring the repo, these are the directories that matter most:
317
326
  - `apps/web`: local React web UI
318
327
  - `packages/server`: local HTTP server that serves API, MCP, and UI
319
328
  - `packages/control-plane`: source management, secrets, persistence, execution, and inspection
329
+ - `packages/runtime-deno-subprocess`: optional Deno subprocess runtime for TypeScript execution
320
330
  - `packages/runtime-quickjs`: default QuickJS sandbox runtime for TypeScript execution
321
331
  - `packages/runtime-ses`: optional SES sandbox runtime for TypeScript execution
322
332
  - `packages/executor-mcp`: MCP bridge for `execute` and `resume`