@ours.network/fleet-codex 1.0.5 → 1.1.0-nightly.10
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/.codex-plugin/plugin.json +14 -3
- package/README.md +1 -1
- package/package.json +24 -5
- package/skills/oversee-agents/SKILL.md +3 -4
- package/skills/spawn-ours-agent/SKILL.md +16 -34
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "ours-fleet",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.1.0-nightly.10",
|
|
4
4
|
"description": "Spawn, configure, and oversee ours-fleet roles from OpenAI Codex.",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "Adapt Framework Solutions Ltd",
|
|
@@ -9,7 +9,14 @@
|
|
|
9
9
|
"homepage": "https://github.com/adapt-toolkit/ours-fleet/tree/main/integrations/codex/ours-fleet",
|
|
10
10
|
"repository": "https://github.com/adapt-toolkit/ours-fleet",
|
|
11
11
|
"license": "FSL-1.1-Apache-2.0",
|
|
12
|
-
"keywords": [
|
|
12
|
+
"keywords": [
|
|
13
|
+
"codex",
|
|
14
|
+
"ours.network",
|
|
15
|
+
"fleet",
|
|
16
|
+
"agents",
|
|
17
|
+
"spawn",
|
|
18
|
+
"oversight"
|
|
19
|
+
],
|
|
13
20
|
"skills": "./skills/",
|
|
14
21
|
"interface": {
|
|
15
22
|
"displayName": "ours.network Fleet",
|
|
@@ -17,7 +24,11 @@
|
|
|
17
24
|
"longDescription": "Create temporary or supervised ours-fleet roles, configure Codex models and permissions, and keep spawned agents healthy from inside Codex.",
|
|
18
25
|
"developerName": "Adapt Framework Solutions Ltd",
|
|
19
26
|
"category": "Productivity",
|
|
20
|
-
"capabilities": [
|
|
27
|
+
"capabilities": [
|
|
28
|
+
"Interactive",
|
|
29
|
+
"Read",
|
|
30
|
+
"Write"
|
|
31
|
+
],
|
|
21
32
|
"websiteURL": "https://ours.network",
|
|
22
33
|
"defaultPrompt": [
|
|
23
34
|
"Spawn a new Codex fleet agent for this task.",
|
package/README.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# @ours.network/fleet-codex
|
|
2
2
|
|
|
3
3
|
Native OpenAI Codex plugin for `ours-fleet`. It adds skills for creating Codex
|
|
4
|
-
fleet roles and overseeing agents
|
|
4
|
+
fleet roles and overseeing agents through structured sessions. The
|
|
5
5
|
`@ours.network/fleet` CLI performs the actual lifecycle operations.
|
|
6
6
|
|
|
7
7
|
## Install
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@ours.network/fleet-codex",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.1.0-nightly.10",
|
|
4
4
|
"description": "Native Codex plugin for spawning, configuring, and overseeing ours-fleet agents.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "FSL-1.1-Apache-2.0",
|
|
@@ -11,13 +11,32 @@
|
|
|
11
11
|
"url": "git+https://github.com/adapt-toolkit/ours-fleet.git",
|
|
12
12
|
"directory": "integrations/codex/ours-fleet"
|
|
13
13
|
},
|
|
14
|
-
"keywords": [
|
|
15
|
-
|
|
14
|
+
"keywords": [
|
|
15
|
+
"codex",
|
|
16
|
+
"openai",
|
|
17
|
+
"plugin",
|
|
18
|
+
"fleet",
|
|
19
|
+
"agents",
|
|
20
|
+
"spawn",
|
|
21
|
+
"oversight",
|
|
22
|
+
"ours.network"
|
|
23
|
+
],
|
|
24
|
+
"files": [
|
|
25
|
+
".codex-plugin",
|
|
26
|
+
"skills",
|
|
27
|
+
"bin",
|
|
28
|
+
"README.md",
|
|
29
|
+
"LICENSE"
|
|
30
|
+
],
|
|
16
31
|
"bin": {
|
|
17
32
|
"ours-fleet-codex-install": "bin/ours-fleet-codex-install.mjs"
|
|
18
33
|
},
|
|
19
|
-
"engines": {
|
|
20
|
-
|
|
34
|
+
"engines": {
|
|
35
|
+
"node": ">=20"
|
|
36
|
+
},
|
|
37
|
+
"publishConfig": {
|
|
38
|
+
"access": "public"
|
|
39
|
+
},
|
|
21
40
|
"scripts": {
|
|
22
41
|
"test": "node --test"
|
|
23
42
|
}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: oversee-agents
|
|
3
|
-
description: Inspect, monitor, and unstick ours-fleet agents from Codex using
|
|
3
|
+
description: Inspect, monitor, and unstick ours-fleet agents from Codex using ACP session controls and supervisor state. Use when the user asks to keep an eye on agents, oversee spawned roles, check agent status, babysit a subagent, resolve a fleet prompt, or when Codex has just spawned a role and should verify its progress.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Oversee ours-fleet agents
|
|
@@ -14,11 +14,10 @@ ours-fleet peek <Name> [lines]
|
|
|
14
14
|
ours-fleet status <Name>
|
|
15
15
|
ours-fleet logs <Name>
|
|
16
16
|
ours-fleet send <Name> "<text>"
|
|
17
|
-
ours-fleet send <Name> --key <key>
|
|
18
17
|
```
|
|
19
18
|
|
|
20
|
-
Text `send`, `peek`, and `attach`
|
|
21
|
-
|
|
19
|
+
Text `send`, `peek`, and `attach` use the structured ACP session. Use the
|
|
20
|
+
`/permit` control shown by `attach` for permission requests.
|
|
22
21
|
|
|
23
22
|
## Establish scope
|
|
24
23
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: spawn-ours-agent
|
|
3
|
-
description: Spawn and configure a new ours-fleet agent from Codex, with a permanent or temporary lifetime and
|
|
3
|
+
description: Spawn and configure a new ours-fleet agent from Codex, with a permanent or temporary lifetime and an ACP session. Use when the user asks to spawn an agent, create a fleet role, start a background agent, delegate work to another Codex session, choose its model or permissions, or create a subagent with its own ours identity and console.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Spawn an ours-fleet agent
|
|
@@ -54,8 +54,8 @@ What this means in practice, on this harness:
|
|
|
54
54
|
|
|
55
55
|
| Neutral intent | Native settings | Meets the floor? |
|
|
56
56
|
| --- | --- | --- |
|
|
57
|
-
| `--approval allow --filesystem workspace` |
|
|
58
|
-
| `--approval allow --filesystem read-only` |
|
|
57
|
+
| `--approval allow --filesystem workspace` | `agent-full-access` / `never` / `danger-full-access` | yes |
|
|
58
|
+
| `--approval allow --filesystem read-only` | `agent-full-access` / `never` / `danger-full-access` | yes |
|
|
59
59
|
| `--approval auto` | ACP: `agent` / `on-request` / `workspace-write` | no — `read-state` only |
|
|
60
60
|
| `--approval ask` or legacy `deny` | conservative prompting mode | no — `read-state` only |
|
|
61
61
|
|
|
@@ -96,7 +96,7 @@ Ask only for choices not already supplied:
|
|
|
96
96
|
|
|
97
97
|
- **Lifetime:** permanent (supervised, restartable, survives reboot) or
|
|
98
98
|
temporary (detached supervisor, removed on exit/reboot).
|
|
99
|
-
- **Session:** `
|
|
99
|
+
- **Session:** `acp`; both lifetimes use the shared structured session interface.
|
|
100
100
|
- **Name:** `[A-Za-z0-9_-]+`; confirm it is absent from `ours-fleet config` and
|
|
101
101
|
`ours-fleet ls`.
|
|
102
102
|
- **Mission and working directory.**
|
|
@@ -105,20 +105,10 @@ Ask only for choices not already supplied:
|
|
|
105
105
|
- **Persona:** local operating contract covering mandate, quality bar,
|
|
106
106
|
boundaries, and escalation. Use the writing-agent-bios skill when available.
|
|
107
107
|
- **Coordinator:** optionally announce readiness to an existing ours identity.
|
|
108
|
-
- **
|
|
109
|
-
legacy `--monitor` consent flag only after a clear yes. This is distinct from
|
|
110
|
-
fleet YAML `monitor.mode: fleet|native`, which chooses the wake owner.
|
|
108
|
+
- **Brain:** select a declared Brain whose Codex runtime and monitor policy match the request.
|
|
111
109
|
|
|
112
|
-
Codex-native
|
|
113
|
-
|
|
114
|
-
- model: launcher default or `--model <id>`
|
|
115
|
-
- native approval: `--permission-mode untrusted|on-request|never`
|
|
116
|
-
- native sandbox: `--sandbox read-only|workspace-write|danger-full-access`
|
|
117
|
-
- launcher: `auto` (preferred), `ours-codex`, or `codex`
|
|
118
|
-
- profile: `--profile <name>`
|
|
119
|
-
- search: `--search`
|
|
120
|
-
- arbitrary config: repeatable `--codex-config key=value`
|
|
121
|
-
- additional writable roots: repeatable `--add-dir <path>`
|
|
110
|
+
Codex-native model, reasoning, sandbox, launcher, profile, search, arbitrary config,
|
|
111
|
+
and additional writable roots are Brain-owned and are never separate spawn flags.
|
|
122
112
|
|
|
123
113
|
## 5. Materialize approved profile text
|
|
124
114
|
|
|
@@ -150,10 +140,8 @@ cannot cross.
|
|
|
150
140
|
Build an argument array from the approved choices. Permanent, unattended:
|
|
151
141
|
|
|
152
142
|
```sh
|
|
153
|
-
ours-fleet spawn Worker --
|
|
154
|
-
--
|
|
155
|
-
--mission "Own the worker implementation" --cwd /absolute/project \
|
|
156
|
-
--bio-file /tmp/worker-bio.md --persona-file /tmp/worker-persona.md \
|
|
143
|
+
ours-fleet spawn Worker --brain CodexWorker --role Worker \
|
|
144
|
+
--cwd /absolute/project \
|
|
157
145
|
--approval allow --filesystem workspace --unattended deny \
|
|
158
146
|
--isolation-file /tmp/worker-isolation.yaml \
|
|
159
147
|
--coordinator Coordinator
|
|
@@ -162,17 +150,12 @@ ours-fleet spawn Worker --harness codex --launcher auto \
|
|
|
162
150
|
Permanent, attended — a human will answer its prompts:
|
|
163
151
|
|
|
164
152
|
```sh
|
|
165
|
-
ours-fleet spawn Worker --
|
|
166
|
-
--
|
|
167
|
-
--mission "Own the worker implementation" --cwd /absolute/project \
|
|
168
|
-
--bio-file /tmp/worker-bio.md --persona-file /tmp/worker-persona.md \
|
|
153
|
+
ours-fleet spawn Worker --brain CodexWorker --role Worker \
|
|
154
|
+
--cwd /absolute/project \
|
|
169
155
|
--approval ask --filesystem workspace --unattended wait
|
|
170
156
|
```
|
|
171
157
|
|
|
172
|
-
Add `--temp` for a temporary role
|
|
173
|
-
Pass the legacy `--monitor` flag only after consent to arm Codex's native
|
|
174
|
-
monitor. It does not select the wake owner; `monitor.mode` does that in YAML.
|
|
175
|
-
Pass model, profile, search, config, and additional directories exactly as
|
|
158
|
+
Add `--temp` for a temporary role. Pass Brain and Role selections exactly as
|
|
176
159
|
approved. Do not persist secrets in `--codex-config` or fleet YAML; use the
|
|
177
160
|
role's `env` configuration for environment-based credentials.
|
|
178
161
|
|
|
@@ -190,14 +173,13 @@ settings it translated to; the floor line lists what the role actually grants,
|
|
|
190
173
|
or names what is missing. A failure there means the role will silently do less
|
|
191
174
|
than its briefing says — fix the permissions rather than starting it.
|
|
192
175
|
|
|
193
|
-
|
|
194
|
-
readiness.
|
|
176
|
+
`status` must report `backend: acp`, `alive: true`, and a running/idle
|
|
177
|
+
readiness. Confirm that
|
|
195
178
|
Codex loaded its briefing and reached identity binding. First use can display
|
|
196
179
|
Codex authorization prompts for ours MCP tools.
|
|
197
180
|
Surface those prompts to the user; do not grant persistent trust without their
|
|
198
|
-
explicit approval.
|
|
199
|
-
|
|
200
|
-
through `ours-fleet attach`.
|
|
181
|
+
explicit approval. Permissions are answered through `ours-fleet attach` and only
|
|
182
|
+
within the authorization scope the user approved.
|
|
201
183
|
|
|
202
184
|
If monitoring was approved, confirm the console reports `arm_monitor` success.
|
|
203
185
|
Under native Codex, expect the role to surface the `ours-codex` recommendation
|