cyberlegion 1.9.0 → 2.0.0

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "cyberlegion",
3
- "version": "1.9.0",
3
+ "version": "2.0.0",
4
4
  "description": "Harness-agnostic agent session spawning and messaging over the filesystem",
5
5
  "keywords": [
6
6
  "agent",
package/plugin.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
3
3
  "name": "cyberlegion",
4
- "version": "1.9.0",
4
+ "version": "2.0.0",
5
5
  "description": "Agent session spawning, messaging, and dispatch — the Legion and its Legate.",
6
6
  "author": {
7
7
  "name": "unional"
package/readme.md CHANGED
@@ -30,7 +30,7 @@ npx cyberlegion unit register --handle scout # register/refresh this sess
30
30
  npx cyberlegion unit register --standing --handle homa # mint a standing, session-independent owner inbox
31
31
  npx cyberlegion unit whoami # print your own identity
32
32
  npx cyberlegion unit who # list addressable peers / live peer sessions
33
- npx cyberlegion unit prune # mark dead agents exited and sweep
33
+ npx cyberlegion unit prune # mark dead agents exited; delete exited ones with no worktree
34
34
  npx cyberlegion unit spawn --agent reviewer # launch a peer in its own git worktree (tmux/herdr)
35
35
  npx cyberlegion unit focus <ref> # move input focus to a peer's session
36
36
  npx cyberlegion unit nudge <ref> # ring a peer's session (doorbell)
@@ -12,12 +12,13 @@ place that judgment lives, loaded in-session by the `legate` gateway on a dispat
12
12
  realized headless by the `headless-legate` agent. Both loads run the exact same procedure below.
13
13
 
14
14
  **Input:** an intent to fulfill role `R` with brief `B`, optionally expecting a result that
15
- satisfies verdict schema `V`.
15
+ satisfies verdict schema `V`, and optionally the path `P` of an agent definition file. When the
16
+ caller supplies `P`, it is the definition to use; the by-name lookup is skipped.
16
17
 
17
18
  > **Running the CLI.** Every `node scripts/cyberlegion.mjs …` command below runs the `cyberlegion` CLI
18
19
  > this plugin ships. The path is relative to this skill's own directory, not the working directory.
19
20
  > If you cannot resolve it, run the published CLI of the version that shipped this skill instead,
20
- > with the same arguments: `npx -y cyberlegion@1.9.0`.
21
+ > with the same arguments: `npx -y cyberlegion@2.0.0`.
21
22
 
22
23
  ## 1. Resolve the agent definition
23
24
 
@@ -25,6 +26,18 @@ satisfies verdict schema `V`.
25
26
  node scripts/cyberlegion.mjs agent resolve <R> --format json
26
27
  ```
27
28
 
29
+ When the intent carries a definition path `P`, resolve that file instead and do not look `<R>` up by
30
+ name (a definition a plugin ships is not under the project's `.agents/agents/`, so by name it is not
31
+ found):
32
+
33
+ ```bash
34
+ node scripts/cyberlegion.mjs agent resolve --file <P> --format json
35
+ ```
36
+
37
+ Everything below reads the same resolved def either way. Wherever a step passes `--agent <R>` to
38
+ `unit spawn`, pass `--agent-file <P>` instead when `P` was given, and the subagent path builds its
39
+ instruction from the def resolved from `P`.
40
+
28
41
  Read `model`, `effort`, `harness`, `warm`, `interactive` off the resolved def. `warm` marks a role
29
42
  that should run as a live peer session (not a fire-and-forget unit); `interactive` marks a role that
30
43
  may need to grill the caller or converse over multiple rounds, not just return one result.
@@ -53,7 +66,7 @@ to open a pane in; its absence rules that strategy out regardless of what the ag
53
66
  mint a thread id, weave it (and an instruction to reply on it) into brief `B`, then:
54
67
 
55
68
  ```bash
56
- node scripts/cyberlegion.mjs unit spawn --agent <R> --brief-file <B> --at <placement>
69
+ node scripts/cyberlegion.mjs unit spawn --agent <R> --brief-file <B> --at <placement> # or --agent-file <P> when given
57
70
  node scripts/cyberlegion.mjs mail await --thread <the-minted-thread-id> [--timeout <ms>] [--max-wait <s>]
58
71
  ```
59
72