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

package/README.md

@@ -1,61 +1,106 @@
 # @agimon-ai/doompi-team
 
-**Subagents should leave a paper trail.**
+An asynchronous subagent runtime for Pi: agent discovery, background runs, membership, intercom, and model/tool policy.
 
-This is Doompi's async-only team runtime: named agents, background runs, peer messaging,
-and one task board shared with the parent. Agents can work in parallel and use the model
-policy owned by the selected Team package entry without turning the main conversation
-into a wall of child transcripts.
+Part of the [DoomPi distribution](https://www.npmjs.com/package/@agimon-ai/doompi).
 
-Runs are detached from an environment snapshot and may outlive the parent that launched
-them. Each child gets its own resolved harness state, so recovery does not depend on the
-parent still being around to explain itself.
+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.
 
-This is part of [Doompi](https://www.npmjs.com/package/@agimon-ai/doompi). Most users load
-it through a major-mode layer.
+> **Alpha:** run, policy, and intercom contracts may change between releases.
 
-## Install
+## Requirements
 
-```bash
-npm install @agimon-ai/doompi-team
-```
+- Node.js 22.19.0 or newer
+- Pi Agent Core, Pi AI, Pi, and Pi TUI 0.84.2
 
-## How it loads
+## Install
 
-Put the package in a layer, then add that layer to a major mode. When Team needs
-configuration, use the package-object form so the options stay with their owner:
+Add Team to a DoomPi layer. Add Task separately when you want graph-backed delegation:
 
 ```yaml
 layers:
-  team:
+  coordination:
     packages:
+      - '@agimon-ai/doompi-task'
       - name: '@agimon-ai/doompi-team'
         config:
           models:
-            - model: openai-codex/gpt-5.6-luna
-              thinking: xhigh
-          excludeTools: [ask_user_question, intercom, subagent]
+            - model: provider/model-id
+              thinking: high
+          excludeTools: [ask_user_question]
 
 majorMode:
-  dev:
-    description: Development mode with delegated Team agents.
-    layers: [team]
+  development:
+    description: Development with tasks and delegated agents.
+    layers: [coordination]
+```
+
+For Team without Task in standalone Pi:
+
+```bash
+pi install npm:@agimon-ai/doompi-team
 ```
 
-Use the shorter string form when no Team configuration is needed. The package's Pi
-manifest selects the Doom adapter. Later selected Team entries replace `models`; their
-`excludeTools` values are unioned in layer order. A sibling `layer.config` block is
-invalid because it cannot say which package owns the options.
+Team-only sessions can launch and manage agents directly; they simply have no Task-owned graph to update.
+
+## Commands and tools
+
+Slash commands include:
+
+```text
+/run
+/parallel
+/subagents-doctor
+/subagents-stop
+/subagents-list
+/subagents-fleet
+```
+
+The `subagent` tool exposes `agents`, `run`, `status`, `steer`, `stop`, `suspended`, and `restore`. The `intercom` tool exposes `members`, `send`, `ask`, `pending`, and `reply`.
+
+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.
+
+## Run lifecycle
 
-## Leader
+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.
 
-- `SPC a l` lists the agents available to this session.
-- `SPC a r` opens current-session runs and their controls.
+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.
+
+## Model and tool policy
+
+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.
+
+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.
+
+## Task delegation bridge
+
+With Task installed:
+
+1. Task selects a pending, unblocked task and sends a delegation request.
+2. Team resolves the named agent, context, model, skills, and capability policy.
+3. Team owns the background run, messaging, steering, and suspension.
+4. Task records the terminal result on its own task.
+
+This is a protocol relationship, not shared persistence.
 
 ## Public API
 
-The root export contains the team runtime. Supported subpaths expose agent discovery,
-background-run services, and the Doom adapter; `package.json` carries the complete list.
+```ts
+import { createExtensionContainer, resolveSubagentLaunchContract } from '@agimon-ai/doompi-team';
+```
+
+Focused subpaths expose background-work, capability-ceiling, delegation, and team-snapshot contracts. Host adapters are available at `/extensions/pi` and `/extensions/doom`.
+
+## Development
+
+```bash
+pnpm build
+pnpm typecheck
+pnpm test
+pnpm lint
+```
+
+Maintained by [Agimon](https://agimon.ai/about).
 
 ## License
 

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "@agimon-ai/doompi-team",
-  "version": "0.0.1-alpha.21",
-  "description": "Async-only subagent team runtime for Pi: named agents, peer messaging, shared task board",
+  "version": "0.0.1-alpha.23",
+  "description": "Asynchronous named subagents, team runs, intercom, and model policy for Pi coding agents.",
   "keywords": [
-    "ai",
+    "agent-team",
     "coding-agent",
-    "developer-tools",
     "doompi",
-    "pi-package"
+    "inter-agent-communication",
+    "multi-agent",
+    "pi-coding-agent",
+    "subagents"
   ],
   "homepage": "https://agimon.ai",
   "license": "MIT",
@@ -38,12 +40,12 @@
     "reflect-metadata": "0.2.2",
     "typebox": "1.1.38",
     "yaml": "2.9.0",
-    "@agimon-ai/doompi-config": "0.0.1-alpha.21",
-    "@agimon-ai/doompi-extension-contracts": "0.0.1-alpha.21",
-    "@agimon-ai/doompi-mcp": "0.0.1-alpha.21",
-    "@agimon-ai/doompi-telemetry": "0.0.1-alpha.21",
-    "@agimon-ai/mcp-proxy": "0.31.11",
-    "@agimon-ai/doompi-ui": "0.0.1-alpha.21"
+    "@agimon-ai/doompi-extension-contracts": "0.0.1-alpha.23",
+    "@agimon-ai/doompi-ui": "0.0.1-alpha.23",
+    "@agimon-ai/doompi-telemetry": "0.0.1-alpha.23",
+    "@agimon-ai/mcp-proxy": "0.31.13",
+    "@agimon-ai/doompi-config": "0.0.1-alpha.23",
+    "@agimon-ai/doompi-mcp": "0.0.1-alpha.23"
   },
   "devDependencies": {
     "@earendil-works/pi-agent-core": "0.84.2",