@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.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ours-fleet",
3
- "version": "1.0.5",
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": ["codex", "ours.network", "fleet", "agents", "spawn", "oversight"],
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": ["Interactive", "Read", "Write"],
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 in their tmux consoles. The
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.5",
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": ["codex", "openai", "plugin", "fleet", "agents", "spawn", "oversight", "ours.network"],
15
- "files": [".codex-plugin", "skills", "bin", "README.md", "LICENSE"],
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": { "node": ">=20" },
20
- "publishConfig": { "access": "public" },
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 their tmux or 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.
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` work for tmux and ACP. Raw `send --key` is
21
- tmux-only; use the `/permit` control shown by ACP `attach` for ACP permissions.
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 a tmux or 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, session, or permissions, or create a subagent with its own ours identity and console.
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` | ACP: `agent-full-access` / `never` / `danger-full-access`; tmux: `never` / `workspace-write` | yes |
58
- | `--approval allow --filesystem read-only` | ACP: `agent-full-access` / `never` / `danger-full-access`; tmux: `never` / `read-only` | ACP yes; tmux no |
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:** `tmux` or `acp`; both lifetimes support both.
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
- - **Native Codex mail monitoring:** explicitly ask whether to arm it. Pass the
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 controls, offered when relevant:
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 --harness codex --launcher auto \
154
- --session <tmux|acp> \
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 --harness codex --launcher auto \
166
- --session <tmux|acp> \
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; it can also use `--session acp`.
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
- For ACP, `status` must report `backend: acp`, `alive: true`, and a running/idle
194
- readiness. For a temporary tmux role, the pane is authoritative. Confirm that
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. Use `ours-fleet send <Name> --key <choice>` only for tmux and
199
- only for the authorization scope the user approved; ACP permissions are answered
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