@agimon-ai/doompi-team 0.0.1-alpha.21 → 0.0.1-alpha.22

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 +75 -34
  2. package/package.json +7 -7
package/README.md CHANGED
@@ -1,61 +1,102 @@
1
1
  # @agimon-ai/doompi-team
2
2
 
3
- **Subagents should leave a paper trail.**
3
+ An asynchronous subagent runtime for Pi: agent discovery, background runs, membership, intercom, and model/tool policy.
4
4
 
5
- This is Doompi's async-only team runtime: named agents, background runs, peer messaging,
6
- and one task board shared with the parent. Agents can work in parallel and use the model
7
- policy owned by the selected Team package entry without turning the main conversation
8
- into a wall of child transcripts.
5
+ Team does not own Task's graph. When both packages are loaded, Team fulfills Task delegation requests while Task remains the source of truth for task status and dependencies.
9
6
 
10
- Runs are detached from an environment snapshot and may outlive the parent that launched
11
- them. Each child gets its own resolved harness state, so recovery does not depend on the
12
- parent still being around to explain itself.
7
+ > **Alpha:** run, policy, and intercom contracts may change between releases.
13
8
 
14
- This is part of [Doompi](https://www.npmjs.com/package/@agimon-ai/doompi). Most users load
15
- it through a major-mode layer.
9
+ ## Requirements
16
10
 
17
- ## Install
18
-
19
- ```bash
20
- npm install @agimon-ai/doompi-team
21
- ```
11
+ - Node.js 22.19.0 or newer
12
+ - Pi Agent Core, Pi AI, Pi, and Pi TUI 0.84.2
22
13
 
23
- ## How it loads
14
+ ## Install
24
15
 
25
- Put the package in a layer, then add that layer to a major mode. When Team needs
26
- configuration, use the package-object form so the options stay with their owner:
16
+ Add Team to a DoomPi layer. Add Task separately when you want graph-backed delegation:
27
17
 
28
18
  ```yaml
29
19
  layers:
30
- team:
20
+ coordination:
31
21
  packages:
22
+ - '@agimon-ai/doompi-task'
32
23
  - name: '@agimon-ai/doompi-team'
33
24
  config:
34
25
  models:
35
- - model: openai-codex/gpt-5.6-luna
36
- thinking: xhigh
37
- excludeTools: [ask_user_question, intercom, subagent]
26
+ - model: provider/model-id
27
+ thinking: high
28
+ excludeTools: [ask_user_question]
38
29
 
39
30
  majorMode:
40
- dev:
41
- description: Development mode with delegated Team agents.
42
- layers: [team]
31
+ development:
32
+ description: Development with tasks and delegated agents.
33
+ layers: [coordination]
43
34
  ```
44
35
 
45
- Use the shorter string form when no Team configuration is needed. The package's Pi
46
- manifest selects the Doom adapter. Later selected Team entries replace `models`; their
47
- `excludeTools` values are unioned in layer order. A sibling `layer.config` block is
48
- invalid because it cannot say which package owns the options.
36
+ For Team without Task in standalone Pi:
37
+
38
+ ```bash
39
+ pi install npm:@agimon-ai/doompi-team
40
+ ```
41
+
42
+ Team-only sessions can launch and manage agents directly; they simply have no Task-owned graph to update.
43
+
44
+ ## Commands and tools
45
+
46
+ Slash commands include:
47
+
48
+ ```text
49
+ /run
50
+ /parallel
51
+ /subagents-doctor
52
+ /subagents-stop
53
+ /subagents-list
54
+ /subagents-fleet
55
+ ```
56
+
57
+ The `subagent` tool exposes `agents`, `run`, `status`, `steer`, `stop`, `suspended`, and `restore`. The `intercom` tool exposes `members`, `send`, `ask`, `pending`, and `reply`.
58
+
59
+ Use `SPC a l` to browse agents and `SPC a r` to inspect current-session runs. TUI views require an interactive host; tools and commands support headless orchestration.
49
60
 
50
- ## Leader
61
+ ## Run lifecycle
51
62
 
52
- - `SPC a l` lists the agents available to this session.
53
- - `SPC a r` opens current-session runs and their controls.
63
+ Runs are asynchronous. The parent receives a run identifier and later completion or failure rather than an inline child transcript. A shutdown requests suspension and writes restorable state. A later session can list suspended work and explicitly restore it; reopening does not automatically restart children, and Team does not promise that every run continues after its parent exits.
64
+
65
+ The root session scopes run results, transcripts, control inboxes, membership, intercom, and suspended records. State is stored in private, per-user temporary directories with per-session subdirectories. Launch contracts can contain full prompts and are written with private permissions and removed after handoff. Intercom messages expire after 24 hours; stale membership and run state are swept through liveness checks.
66
+
67
+ ## Model and tool policy
68
+
69
+ Package configuration belongs on the Team package entry. When several selected entries contribute configuration, later entries replace the `models` list and `excludeTools` values are unioned in layer order.
70
+
71
+ Agent configuration, explicit launch options, Team policy, and provider availability determine the final model and tools. A child cannot exceed the capability ceiling supplied by its parent/provider policy. Allowed MCP and stdio tools can execute commands, so treat agent definitions and inherited environment as trusted configuration.
72
+
73
+ ## Task delegation bridge
74
+
75
+ With Task installed:
76
+
77
+ 1. Task selects a pending, unblocked task and sends a delegation request.
78
+ 2. Team resolves the named agent, context, model, skills, and capability policy.
79
+ 3. Team owns the background run, messaging, steering, and suspension.
80
+ 4. Task records the terminal result on its own task.
81
+
82
+ This is a protocol relationship, not shared persistence.
54
83
 
55
84
  ## Public API
56
85
 
57
- The root export contains the team runtime. Supported subpaths expose agent discovery,
58
- background-run services, and the Doom adapter; `package.json` carries the complete list.
86
+ ```ts
87
+ import { createExtensionContainer, resolveSubagentLaunchContract } from '@agimon-ai/doompi-team';
88
+ ```
89
+
90
+ Focused subpaths expose background-work, capability-ceiling, delegation, and team-snapshot contracts. Host adapters are available at `/extensions/pi` and `/extensions/doom`.
91
+
92
+ ## Development
93
+
94
+ ```bash
95
+ pnpm build
96
+ pnpm typecheck
97
+ pnpm test
98
+ pnpm lint
99
+ ```
59
100
 
60
101
  ## License
61
102
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@agimon-ai/doompi-team",
3
- "version": "0.0.1-alpha.21",
3
+ "version": "0.0.1-alpha.22",
4
4
  "description": "Async-only subagent team runtime for Pi: named agents, peer messaging, shared task board",
5
5
  "keywords": [
6
6
  "ai",
@@ -38,12 +38,12 @@
38
38
  "reflect-metadata": "0.2.2",
39
39
  "typebox": "1.1.38",
40
40
  "yaml": "2.9.0",
41
- "@agimon-ai/doompi-config": "0.0.1-alpha.21",
42
- "@agimon-ai/doompi-extension-contracts": "0.0.1-alpha.21",
43
- "@agimon-ai/doompi-mcp": "0.0.1-alpha.21",
44
- "@agimon-ai/doompi-telemetry": "0.0.1-alpha.21",
45
- "@agimon-ai/mcp-proxy": "0.31.11",
46
- "@agimon-ai/doompi-ui": "0.0.1-alpha.21"
41
+ "@agimon-ai/doompi-config": "0.0.1-alpha.22",
42
+ "@agimon-ai/doompi-extension-contracts": "0.0.1-alpha.22",
43
+ "@agimon-ai/doompi-mcp": "0.0.1-alpha.22",
44
+ "@agimon-ai/doompi-telemetry": "0.0.1-alpha.22",
45
+ "@agimon-ai/doompi-ui": "0.0.1-alpha.22",
46
+ "@agimon-ai/mcp-proxy": "0.31.12"
47
47
  },
48
48
  "devDependencies": {
49
49
  "@earendil-works/pi-agent-core": "0.84.2",