@open330/oac-execution 2026.3.1 → 2026.3.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.
Files changed (2) hide show
  1. package/README.md +51 -0
  2. package/package.json +4 -3
package/README.md ADDED
@@ -0,0 +1,51 @@
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
+ - **ClaudeCodeAdapter** — `AgentProvider` implementation for Claude Code CLI (`claude-code`)
15
+ - **CodexAdapter** — `AgentProvider` implementation for OpenAI Codex CLI (`codex`)
16
+ - **Git Worktree Sandbox** — isolated execution environments per task via `git worktree`
17
+
18
+ ## Usage
19
+
20
+ ```typescript
21
+ import { ClaudeCodeAdapter, CodexAdapter, createSandbox, executeTask } from '@open330/oac-execution';
22
+
23
+ // Use Claude Code
24
+ const claude = new ClaudeCodeAdapter();
25
+ // Or use Codex
26
+ const codex = new CodexAdapter();
27
+
28
+ const sandbox = await createSandbox(repo, task);
29
+ const result = await executeTask(claude, task, sandbox);
30
+ ```
31
+
32
+ ## Adding Custom Agents
33
+
34
+ Implement the `AgentProvider` interface:
35
+
36
+ ```typescript
37
+ import type { AgentProvider } from '@open330/oac-execution';
38
+
39
+ export class MyAgent implements AgentProvider {
40
+ readonly id = 'my-agent';
41
+ readonly name = 'My Agent';
42
+ async checkAvailability() { /* ... */ }
43
+ execute(params) { /* ... */ }
44
+ async estimateTokens(params) { /* ... */ }
45
+ async abort(executionId) { /* ... */ }
46
+ }
47
+ ```
48
+
49
+ ## License
50
+
51
+ 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.3",
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.3"
34
35
  },
35
36
  "devDependencies": {
36
37
  "tsup": "^8.3.6",