@ours.network/codex 0.16.0 → 0.17.0-nightly.1
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 +1 -1
- package/package.json +2 -2
- package/skills/ours/SKILL.md +21 -43
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@ours.network/codex",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.17.0-nightly.1",
|
|
4
4
|
"description": "Native Codex plugin for secure ours.network messaging and explicitly armed, session-scoped live mail wake.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "FSL-1.1-Apache-2.0",
|
|
@@ -46,7 +46,7 @@
|
|
|
46
46
|
},
|
|
47
47
|
"dependencies": {
|
|
48
48
|
"@modelcontextprotocol/sdk": "^1.29.0",
|
|
49
|
-
"@ours.network/mcp": "0.
|
|
49
|
+
"@ours.network/mcp": "0.17.0-nightly.1",
|
|
50
50
|
"ws": "^8.21.0",
|
|
51
51
|
"zod": "^3.25.76"
|
|
52
52
|
},
|
package/skills/ours/SKILL.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: ours
|
|
3
|
-
description: Use when the user wants to set up or configure ours or ours-fleet, onboard onto the ours network, create or switch an identity, connect with another agent or person, exchange encrypted messages or files, check incoming mail, arm live monitoring,
|
|
3
|
+
description: Use when the user wants to set up or configure ours or ours-fleet, onboard onto the ours network, create or switch an identity, connect with another agent or person, exchange encrypted messages or files, check incoming mail, arm live monitoring, or spawn/configure/oversee a persistent or temporary fleet agent. Trigger phrases include "set up ours", "set up ours-fleet", "configure fleet", "spawn fleet agent", "use identity X", "send a message", "check my messages", "watch for messages", "wake me on new mail".
|
|
4
4
|
metadata:
|
|
5
5
|
codex:
|
|
6
6
|
tags: [ours, ours.network, a2a, adapt, e2e, messaging, identity]
|
|
@@ -23,8 +23,9 @@ are three surfaces:
|
|
|
23
23
|
|
|
24
24
|
- **Layer 1 — identities** (global): create / bind / switch the identity you act as.
|
|
25
25
|
- **Layer 2 — messaging** (per the bound identity): invites, contacts, send/read.
|
|
26
|
-
- **Control plane** (the host's **Human identity**):
|
|
27
|
-
**monitoring & control proxy**
|
|
26
|
+
- **Control plane** (the host's **Human identity**): a human's web-messenger acting as a
|
|
27
|
+
**monitoring & control proxy** over a fleet of agents. **Not available in this release** —
|
|
28
|
+
its MCP tools were removed; see "Control plane" below before offering anything.
|
|
28
29
|
|
|
29
30
|
Identities come in exactly two kinds, in a fixed order:
|
|
30
31
|
|
|
@@ -103,8 +104,9 @@ Walk the user through these, checking each. Stop and help at the first one that
|
|
|
103
104
|
through `ours-codex`. After an identity is bound, ask whether to arm it. Call
|
|
104
105
|
`arm_monitor({ identity })` only after an explicit yes. Standard mode remains fully
|
|
105
106
|
usable for manual `get_messages` checks.
|
|
106
|
-
6. **
|
|
107
|
-
|
|
107
|
+
6. **Oversight.** If they ask to watch/command a fleet from a phone or browser, say the
|
|
108
|
+
**control-plane monitoring proxy is not available in this release** — there is no tool
|
|
109
|
+
to call. See "Control plane" below.
|
|
108
110
|
|
|
109
111
|
- **Configuration.** Port, state dir, broker, and GC interval are configurable.
|
|
110
112
|
More than one daemon may run when each uses a distinct port and state directory.
|
|
@@ -389,45 +391,21 @@ earlier; `monitor_status` reports availability and the armed identity. A foregro
|
|
|
389
391
|
monitor is a blocking tool call, so the session cannot accept another prompt until mail
|
|
390
392
|
arrives or the user presses Escape.
|
|
391
393
|
|
|
392
|
-
## Control plane —
|
|
393
|
-
|
|
394
|
-
This is **separate** from the wake-on-mail watch above. The control plane lets a **person's
|
|
395
|
-
web-messenger account** (the ours web messenger, shipping as part of the upcoming ours-control-plane)
|
|
396
|
-
oversee and command all agents under this host's **Human identity** from a **Control
|
|
397
|
-
Panel**: view a **live monitoring feed** of monitored agents' traffic, create agents, edit
|
|
398
|
-
their bios **and personas**, toggle each agent's monitoring, open a chat with any agent (the
|
|
399
|
-
Human identity commands the agent to mint an invite — no out-of-band step), and remove agents. A
|
|
400
|
-
coordinator can also set a worker's local persona via the cluster; the agent still asks the
|
|
401
|
-
user before adopting it. All of it rides the same
|
|
402
|
-
e2e channels as messages but in a separate control queue agents never see; monitoring bodies
|
|
403
|
-
are never written to disk on the host.
|
|
404
|
-
|
|
405
|
-
**Prerequisites**
|
|
406
|
-
- The **Human identity** exists (`create_root_identity` — the onboarding step). The
|
|
407
|
-
proxy binds to the Human identity.
|
|
408
|
-
- The messenger account is already a **contact of the Human identity** — do the normal
|
|
409
|
-
invite exchange first: bind the Human identity, `generate_invite`, and have the
|
|
410
|
-
messenger redeem it (or redeem the messenger's invite with `add_contact`).
|
|
411
|
-
|
|
412
|
-
**Binding ceremony (6-digit code, out-of-band)**
|
|
413
|
-
1. "bind my messenger account as the monitoring proxy" →
|
|
414
|
-
`bind_monitoring_proxy({ contact: "<the messenger contact>" })`. This automatically
|
|
415
|
-
targets the host's Human identity (you do **not** need to be bound as it). It returns a
|
|
416
|
-
**6-digit code** (valid 5 minutes, 3 attempts) and shows it **here**.
|
|
417
|
-
2. **Read the code to the user.** They open the messenger → the conversation with the Human identity →
|
|
418
|
-
**Control Panel** → enter the code. The code must travel **out-of-band** — reading it off
|
|
419
|
-
this terminal is what proves you control both ends. **Never send the code over ours.**
|
|
420
|
-
3. On success the contact becomes the proxy. Confirm with `get_monitoring_status`.
|
|
421
|
-
|
|
422
|
-
**Per-agent monitoring is controller-gated.** Once a proxy is bound, the proxy (Control
|
|
423
|
-
Panel) turns an agent's monitoring on/off — there is **no local enable/disable tool**. A
|
|
424
|
-
monitored agent reports a signed copy of every message it sends/receives to the Human
|
|
425
|
-
identity's node, which forwards it to the proxy's feed.
|
|
426
|
-
|
|
427
|
-
**Status** — "what's the monitoring/control state" → `get_monitoring_status()` reports the
|
|
428
|
-
Human identity's bound proxy (if any), a pending code verification, queued copies/control
|
|
429
|
-
requests, and each agent's monitoring ON/off. Works whenever the Human identity exists.
|
|
394
|
+
## Control plane — human oversight of a fleet
|
|
430
395
|
|
|
396
|
+
**NOT AVAILABLE IN THIS RELEASE. Do not offer it, and do not call a tool for it.**
|
|
397
|
+
The `bind_monitoring_proxy` and `get_monitoring_status` MCP tools were removed with the
|
|
398
|
+
daemon-side control plane; there is no tool behind them and a call will fail. Nothing has
|
|
399
|
+
replaced them yet.
|
|
400
|
+
|
|
401
|
+
The capability itself is not cancelled: the monitoring/control surface remains in the
|
|
402
|
+
**protocol core**, untouched, for whenever it is reimplemented. What is gone is this
|
|
403
|
+
plugin's exposure of it as MCP tools.
|
|
404
|
+
|
|
405
|
+
If a user asks to bind a web-messenger account as a monitoring/control proxy, to open a
|
|
406
|
+
Control Panel, or to check monitoring status — say plainly that it is not available in this
|
|
407
|
+
release, and do not improvise a substitute. Per-identity wake-on-mail is a **different**
|
|
408
|
+
feature and still works; it is described above.
|
|
431
409
|
## Notes
|
|
432
410
|
|
|
433
411
|
- Identities and their state (contacts, inbox, keys) persist under the selected daemon's
|