@pi-unipi/subagents 0.2.7 → 2.0.0

package/README.md

@@ -1,34 +1,46 @@
 # @pi-unipi/subagents
 
-Parallel sub-agent execution for [Pi coding agent](https://github.com/badlogic/pi-mono). Spawn background or foreground agents, track activity, and manage concurrent work.
+Parallel execution with file locking. Spawn background or foreground agents to work on tasks concurrently — research files, fix lint errors, run tests — while the main agent keeps going.
 
-## Install
+Two built-in agent types: `explore` for read-only research, `work` for file modifications with transparent locking. Define your own types as markdown files.
 
-```bash
-pi install npm:@pi-unipi/subagents
-```
+## Commands
 
-Or as part of the full suite:
-```bash
-pi install npm:unipi
-```
+Subagents has no user commands. It's an agent tool package — the agent calls it directly.
+
+## Special Triggers
 
-## Tools
+Workflow skills detect subagents and inject parallel strategies. When `@pi-unipi/subagents` is installed, these skills get enhanced:
+
+| Skill | What Changes |
+|-------|--------------|
+| `brainstorm` | Parallel research for different approaches |
+| `document` | Parallel documentation of different modules |
+| `gather-context` | Parallel codebase exploration |
+| `review-work` | Parallel task verification |
+| `scan-issues` | Parallel scanning by category |
+| `work` | Parallel task execution (with file locking) |
+
+Subagents registers with the info-screen dashboard, showing active agents and their status. The footer displays agent activity in its extension status segment.
+
+## Agent Tools
 
 | Tool | Description |
 |------|-------------|
 | `spawn_helper` | Launch a sub-agent for parallel work |
 | `get_helper_result` | Check status and retrieve results from a background agent |
 
-## Agent Types
+### spawn_helper Parameters
 
-| Type | Description |
-|------|-------------|
-| `explore` | Parallel file reads, research, analysis |
-| `work` | Parallel file writes with transparent locking |
-| Custom | Define your own in `~/.unipi/config/agents/<name>.md` |
-
-## Usage
+| Parameter | Description |
+|-----------|-------------|
+| `type` | Agent type (`explore`, `work`, or custom) |
+| `prompt` | Task for the agent |
+| `description` | Short description (3-5 words) |
+| `run_in_background` | Return immediately, notify on completion |
+| `max_turns` | Max agentic turns before stopping |
+| `model` | Model override (e.g. `"haiku"`, `"sonnet"`) |
+| `thinking` | Thinking level (`off`, `minimal`, `low`, `medium`, `high`, `xhigh`) |
 
 ### Foreground (blocks until done)
 
@@ -57,18 +69,6 @@ spawn_helper(
 get_helper_result(agent_id: "helper_abc123")
 ```
 
-## Options
-
-| Parameter | Description |
-|-----------|-------------|
-| `type` | Agent type (`explore`, `work`, or custom) |
-| `prompt` | Task for the agent |
-| `description` | Short description (3-5 words) |
-| `run_in_background` | Return immediately, notify on completion |
-| `max_turns` | Max agentic turns before stopping |
-| `model` | Model override (e.g. `"haiku"`, `"sonnet"`) |
-| `thinking` | Thinking level (`off`, `minimal`, `low`, `medium`, `high`, `xhigh`) |
-
 ## Custom Agent Types
 
 Create markdown files defining agent behavior:
@@ -81,7 +81,7 @@ Create markdown files defining agent behavior:
 <workspace>/.unipi/config/agents/deployer.md
 ```
 
-## Configuration
+## Configurables
 
 ```json
 // ~/.unipi/config/subagents.json
@@ -95,19 +95,11 @@ Create markdown files defining agent behavior:
 }
 ```
 
-## Features
-
-- **Concurrent execution** — run up to N agents simultaneously
-- **File locking** — transparent locking for parallel writes
-- **ESC propagation** — kill all agents with ESC
-- **Activity tracking** — real-time widget showing agent progress
-- **Info screen integration** — agent status in dashboard
-
-## Dependencies
-
-- `@pi-unipi/core` — shared utilities
-- `@pi-unipi/workflow` — workflow integration
-- `@pi-unipi/info-screen` — dashboard registration
+| Setting | Default | What It Does |
+|---------|---------|--------------|
+| `enabled` | true | Enable/disable subagents |
+| `maxConcurrent` | 3 | Max agents running at once |
+| `types.{name}.enabled` | true | Toggle agent types |
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/subagents",
-  "version": "0.2.7",
+  "version": "2.0.0",
   "description": "Subagents for UniPi — parallel execution, file locking, workflow integration",
   "type": "module",
   "main": "dist/index.js",

package/src/index.ts

@@ -12,7 +12,7 @@ import { Type } from "@sinclair/typebox";
 import { existsSync, readdirSync } from "node:fs";
 import { join } from "node:path";
 import { homedir } from "node:os";
-import { emitEvent, MODULES, UNIPI_EVENTS } from "@pi-unipi/core";
+import { emitEvent, MODULES, UNIPI_EVENTS, type UnipiBadgeGenerateRequestEvent } from "@pi-unipi/core";
 import { AgentManager } from "./agent-manager.js";
 import { initConfig } from "./config.js";
 import { type AgentActivity, type NotificationDetails, BUILTIN_TYPES } from "./types.js";
@@ -21,8 +21,7 @@ import { AgentWidget } from "./widget.js";
 
 /** Get info registry from global */
 function getInfoRegistry() {
-  const g = globalThis as any;
-  return g.__unipi_info_registry;
+  return globalThis.__unipi_info_registry;
 }
 
 // ---- Formatting helpers (shared between renderers and inline text) ----
@@ -338,7 +337,7 @@ export default function (pi: ExtensionAPI) {
   }
 
   // Store session context for badge generation
-  let sessionCtx: any = null;
+  let sessionCtx: import("@mariozechner/pi-coding-agent").ExtensionContext | null = null;
 
   // Session start: emit MODULE_READY + capture context
   pi.on("session_start", async (_event, ctx) => {
@@ -352,7 +351,8 @@ export default function (pi: ExtensionAPI) {
   });
 
   // Listen for badge generation requests — spawn background agent
-  pi.events.on(UNIPI_EVENTS.BADGE_GENERATE_REQUEST, async (event: any) => {
+  pi.events.on(UNIPI_EVENTS.BADGE_GENERATE_REQUEST, async (data) => {
+    const event = data as UnipiBadgeGenerateRequestEvent;
     if (!sessionCtx) return;
 
     const summary = event?.conversationSummary ?? "";

package/src/widget.ts

@@ -11,6 +11,7 @@
  */
 
 import { truncateToWidth } from "@mariozechner/pi-tui";
+import type { ExtensionUIContext } from "@mariozechner/pi-coding-agent";
 import type { AgentManager } from "./agent-manager.js";
 import type { AgentActivity } from "./types.js";
 
@@ -94,8 +95,8 @@ function describeActivity(activeTools: Map<string, string>, responseText?: strin
 export class AgentWidget {
   private spinnerFrame = 0;
   private timer?: ReturnType<typeof setInterval>;
-  private uiCtx?: any;
-  private tui?: any;
+  private uiCtx?: ExtensionUIContext;
+  private tui?: import("@mariozechner/pi-tui").TUI;
   private widgetRegistered = false;
   /** Last content key — skips requestRender when only spinner changed. */
   private lastContentKey = "";
@@ -112,7 +113,7 @@ export class AgentWidget {
     private activity: Map<string, AgentActivity>,
   ) {}
 
-  setUICtx(ctx: any) {
+  setUICtx(ctx: ExtensionUIContext) {
     if (ctx !== this.uiCtx) {
       this.uiCtx = ctx;
       this.widgetRegistered = false;