@open330/oac-execution 2026.3.1 → 2026.3.2

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 +46 -0
  2. package/package.json +4 -3
package/README.md ADDED
@@ -0,0 +1,46 @@
1
+ # @open330/oac-execution
2
+
3
+ Agent execution engine for [OAC (Open Agent Contribution)](https://github.com/Open330/open-agent-contribution).
4
+
5
+ ## Install
6
+
7
+ ```bash
8
+ npm install @open330/oac-execution
9
+ ```
10
+
11
+ ## What's Inside
12
+
13
+ - **ExecutionEngine** — priority-based job queue with `p-queue`, retry, and abort support
14
+ - **CodexAdapter** — `AgentProvider` implementation for OpenAI Codex CLI
15
+ - **Git Worktree Sandbox** — isolated execution environments per task via `git worktree`
16
+
17
+ ## Usage
18
+
19
+ ```typescript
20
+ import { CodexAdapter, createSandbox, executeTask } from '@open330/oac-execution';
21
+
22
+ const adapter = new CodexAdapter();
23
+ const sandbox = await createSandbox(repo, task);
24
+ const result = await executeTask(adapter, task, sandbox);
25
+ ```
26
+
27
+ ## Adding Custom Agents
28
+
29
+ Implement the `AgentProvider` interface:
30
+
31
+ ```typescript
32
+ import type { AgentProvider } from '@open330/oac-execution';
33
+
34
+ export class MyAgent implements AgentProvider {
35
+ readonly id = 'my-agent';
36
+ readonly name = 'My Agent';
37
+ async checkAvailability() { /* ... */ }
38
+ execute(params) { /* ... */ }
39
+ async estimateTokens(params) { /* ... */ }
40
+ async abort(executionId) { /* ... */ }
41
+ }
42
+ ```
43
+
44
+ ## License
45
+
46
+ MIT — see the [main repo](https://github.com/Open330/open-agent-contribution) for details.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@open330/oac-execution",
3
- "version": "2026.3.1",
3
+ "version": "2026.3.2",
4
4
  "description": "Agent execution engine and sandboxing for OAC",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -18,7 +18,8 @@
18
18
  }
19
19
  },
20
20
  "files": [
21
- "dist"
21
+ "dist",
22
+ "README.md"
22
23
  ],
23
24
  "publishConfig": {
24
25
  "access": "public"
@@ -30,7 +31,7 @@
30
31
  "execa": "^9.5.2",
31
32
  "p-queue": "^8.1.0",
32
33
  "simple-git": "^3.27.0",
33
- "@open330/oac-core": "2026.3.1"
34
+ "@open330/oac-core": "2026.3.2"
34
35
  },
35
36
  "devDependencies": {
36
37
  "tsup": "^8.3.6",