@melihmucuk/pi-crew 1.0.12 → 1.0.13

package/dist/integration/register-renderers.js

@@ -15,6 +15,11 @@ function getStatusColor(status) {
             return "muted";
     }
 }
+function renderWarningMessage(content, theme) {
+    const box = new Box(1, 1, (text) => theme.bg("customMessageBg", text));
+    box.addChild(new Text(theme.fg("warning", String(content ?? "")), 0, 0));
+    return box;
+}
 export function registerCrewMessageRenderers(pi) {
     pi.registerMessageRenderer("crew-result", (message, { expanded }, theme) => {
         const details = message.details;
@@ -46,8 +51,9 @@ export function registerCrewMessageRenderers(pi) {
         return box;
     });
     pi.registerMessageRenderer("crew-remaining", (message, _options, theme) => {
-        const box = new Box(1, 1, (text) => theme.bg("customMessageBg", text));
-        box.addChild(new Text(theme.fg("warning", String(message.content ?? "")), 0, 0));
-        return box;
+        return renderWarningMessage(message.content, theme);
+    });
+    pi.registerMessageRenderer("crew-list-warning", (message, _options, theme) => {
+        return renderWarningMessage(message.content, theme);
     });
 }

package/dist/integration/tool-presentation.d.ts

@@ -1,13 +1,8 @@
+import type { AgentToolResult } from "@mariozechner/pi-agent-core";
 import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
 import { Box, Text } from "@mariozechner/pi-tui";
 export type ToolTheme = Parameters<Exclude<Parameters<ExtensionAPI["registerTool"]>[0]["renderCall"], undefined>>[1];
-export type ToolResult = {
-    content: {
-        type: string;
-        text?: string;
-    }[];
-    details: unknown;
-};
+export type ToolResult = AgentToolResult<unknown>;
 export declare function toolError(text: string): {
     content: {
         type: "text";
@@ -18,7 +13,10 @@ export declare function toolError(text: string): {
         error: boolean;
     };
 };
-export declare function toolSuccess(text: string, details?: Record<string, unknown>): {
+export declare function toolSuccess(text: string, details?: Record<string, unknown>, options?: {
+    terminate?: boolean;
+}): {
+    terminate?: boolean | undefined;
     content: {
         type: "text";
         text: string;

package/dist/integration/tool-presentation.js

@@ -6,10 +6,11 @@ export function toolError(text) {
         details: { error: true },
     };
 }
-export function toolSuccess(text, details = {}) {
+export function toolSuccess(text, details = {}, options = {}) {
     return {
         content: [{ type: "text", text }],
         details,
+        ...(options.terminate ? { terminate: true } : {}),
     };
 }
 export function renderCrewCall(theme, name, id, preview) {

package/dist/integration/tools/crew-abort.js

@@ -1,4 +1,4 @@
-import { Type } from "@sinclair/typebox";
+import { Type } from "typebox";
 import { renderCrewCall, renderCrewResult, toolError, toolSuccess, } from "../tool-presentation.js";
 function formatAbortToolMessage(result) {
     const parts = [];
@@ -44,7 +44,7 @@ export function registerCrewAbortTool({ pi, crew }) {
                 if (abortedIds.length === 0) {
                     return toolError("No active subagents in the current session.");
                 }
-                return toolSuccess(`Aborted ${abortedIds.length} subagent(s): ${abortedIds.join(", ")}`, { ids: abortedIds });
+                return toolSuccess(`Aborted ${abortedIds.length} subagent(s): ${abortedIds.join(", ")}`, { ids: abortedIds }, { terminate: true });
             }
             const ids = params.subagent_id
                 ? [params.subagent_id]
@@ -60,7 +60,7 @@ export function registerCrewAbortTool({ pi, crew }) {
                 ids: result.abortedIds,
                 missing_ids: result.missingIds,
                 foreign_ids: result.foreignIds,
-            });
+            }, { terminate: true });
         },
         renderCall(args, theme, _context) {
             if (args.all) {

package/dist/integration/tools/crew-done.js

@@ -1,4 +1,4 @@
-import { Type } from "@sinclair/typebox";
+import { Type } from "typebox";
 import { renderCrewCall, renderCrewResult, toolError, toolSuccess, } from "../tool-presentation.js";
 export function registerCrewDoneTool({ pi, crew }) {
     pi.registerTool({

package/dist/integration/tools/crew-list.js

@@ -1,7 +1,7 @@
 import { Text } from "@mariozechner/pi-tui";
-import { Type } from "@sinclair/typebox";
+import { Type } from "typebox";
 import { discoverAgents } from "../../agent-discovery.js";
-import { STATUS_ICON } from "../../subagent-messages.js";
+import { STATUS_ICON, sendCrewListActiveWarning } from "../../subagent-messages.js";
 export function registerCrewListTool({ pi, crew, notifyDiscoveryWarnings, }) {
     pi.registerTool({
         name: "crew_list",
@@ -19,10 +19,6 @@ export function registerCrewListTool({ pi, crew, notifyDiscoveryWarnings, }) {
             const callerSessionId = ctx.sessionManager.getSessionId();
             const running = crew.getActiveSummariesForOwner(callerSessionId);
             const lines = [];
-            if (running.length > 0) {
-                lines.push("⚠ Active subagents detected. Do not poll crew_list for completion — results arrive as steering messages. Continue with unrelated work or end your turn and wait for the steering messages.");
-                lines.push("");
-            }
             lines.push("## Available Subagents");
             if (agents.length === 0) {
                 lines.push("No valid subagent definitions found. Add `.md` files to `<cwd>/.pi/agents/` or `~/.pi/agent/agents/`.");
@@ -54,11 +50,17 @@ export function registerCrewListTool({ pi, crew, notifyDiscoveryWarnings, }) {
                     lines.push(`id: ${agent.id}`);
                     lines.push(`name: ${agent.agentName}`);
                     lines.push(`status: ${icon} ${agent.status}`);
-                    lines.push(`task: ${agent.taskPreview}`);
-                    lines.push(`turns: ${agent.turns}`);
                 }
             }
             const text = lines.join("\n");
+            if (running.length > 0) {
+                Promise.resolve().then(() => {
+                    sendCrewListActiveWarning(pi.sendMessage.bind(pi), {
+                        isIdle: ctx.isIdle(),
+                        triggerTurn: true,
+                    });
+                });
+            }
             return { content: [{ type: "text", text }], details: {} };
         },
         renderCall(_args, theme, _context) {

package/dist/integration/tools/crew-respond.js

@@ -1,4 +1,4 @@
-import { Type } from "@sinclair/typebox";
+import { Type } from "typebox";
 import { renderCrewCall, renderCrewResult, toolError, toolSuccess, } from "../tool-presentation.js";
 export function registerCrewRespondTool({ pi, crew }) {
     pi.registerTool({

package/dist/integration/tools/crew-spawn.js

@@ -1,5 +1,5 @@
 import { getAgentDir } from "@mariozechner/pi-coding-agent";
-import { Type } from "@sinclair/typebox";
+import { Type } from "typebox";
 import { discoverAgents } from "../../agent-discovery.js";
 import { renderCrewCall, renderCrewResult, toolError, toolSuccess, } from "../tool-presentation.js";
 export function registerCrewSpawnTool({ pi, crew, extensionDir, notifyDiscoveryWarnings, }) {

package/dist/runtime/subagent-state.d.ts

@@ -20,7 +20,6 @@ export interface ActiveAgentSummary {
     id: string;
     agentName: string;
     status: SubagentStatus;
-    taskPreview: string;
     turns: number;
     contextTokens: number;
     model: string | undefined;

package/dist/runtime/subagent-state.js

@@ -15,12 +15,10 @@ export function isAbortableStatus(status) {
     return status === "running" || status === "waiting";
 }
 export function buildActiveAgentSummary(state) {
-    const taskPreview = state.task.length > 80 ? `${state.task.slice(0, 80)}...` : state.task;
     return {
         id: state.id,
         agentName: state.agentConfig.name,
         status: state.status,
-        taskPreview,
         turns: state.turns,
         contextTokens: state.contextTokens,
         model: state.model,

package/dist/subagent-messages.d.ts

@@ -31,3 +31,7 @@ export declare function sendRemainingNote(remainingCount: number, sendMessage: S
     isIdle: boolean;
     triggerTurn: boolean;
 }): void;
+export declare function sendCrewListActiveWarning(sendMessage: SendMessageFn, opts: {
+    isIdle: boolean;
+    triggerTurn: boolean;
+}): void;

package/dist/subagent-messages.js

@@ -57,3 +57,12 @@ export function sendRemainingNote(remainingCount, sendMessage, opts) {
         ? { triggerTurn: opts.triggerTurn }
         : { deliverAs: "steer", triggerTurn: opts.triggerTurn });
 }
+export function sendCrewListActiveWarning(sendMessage, opts) {
+    sendMessage({
+        customType: "crew-list-warning",
+        content: "⚠ Active subagents detected. Do not poll crew_list for completion — results arrive as steering messages. Continue with unrelated work or end your turn and wait for the steering messages.",
+        display: true,
+    }, opts.isIdle
+        ? { triggerTurn: opts.triggerTurn }
+        : { deliverAs: "steer", triggerTurn: opts.triggerTurn });
+}

package/docs/architecture.md

@@ -13,6 +13,7 @@ Primary components:
 - `extension/runtime/crew-runtime.ts` - Process-level singleton owning all subagent state
 - `extension/runtime/subagent-registry.ts` - In-memory subagent registry
 - `extension/runtime/delivery-coordinator.ts` - Owner-based result routing
+- `extension/runtime/overflow-recovery.ts` - Context overflow retry tracking for subagent prompts
 - `extension/bootstrap-session.ts` - Subagent session construction with extension filtering
 - `extension/agent-discovery.ts` - Subagent definition discovery and validation
 
@@ -26,6 +27,7 @@ Responsibilities:
 
 - Create subagent state records
 - Bootstrap isolated subagent sessions
+- Run subagent prompt cycles with overflow recovery
 - Transition subagents between states
 - Deliver results to owner sessions
 
@@ -40,7 +42,19 @@ Routes subagent results to the correct session at the correct time. Key behavior
 
 Underlying delivery: see pi's `sendMessage({ deliverAs, triggerTurn })` in extensions.md.
 
-### 2.3 Subagent registry
+`crew_list` uses the same idle/streaming delivery rules for its `crew-list-warning` custom message when active subagents exist. The warning is separate from tool output so the list remains a one-time snapshot while anti-polling guidance is delivered as a visible message.
+
+### 2.3 Overflow recovery
+
+Subagent prompt cycles are wrapped by overflow recovery tracking. The tracker observes `agent_end`, `compaction_start`, `compaction_end`, `auto_retry_start`, and `auto_retry_end` events to distinguish normal completion from context-overflow compaction and retry.
+
+Outcomes:
+
+- No overflow observed → prompt outcome is based on the final assistant message.
+- Overflow compaction completes with retry and the retry reaches a terminal `agent_end` → recovered; prompt outcome is based on the final assistant message.
+- Overflow handling times out, is cancelled, or compaction does not retry → failed; the subagent settles as `error` unless the final assistant message already reported an error.
+
+### 2.4 Subagent registry
 
 In-memory, process-scoped: `Map<subagentId, SubagentState>`
 
@@ -80,7 +94,7 @@ Critical: `deliverAs: "steer"` to an idle session leaves the message unprocessed
 
 ### 4.3 Deferred flush
 
-Pending message flush after `session_start` is deferred to next macrotask. Synchronous delivery loses custom message persistence (pi-core emits `session_start` before reconnecting agent listener during resume).
+Pending message flush after `session_start` is deferred to next macrotask. Synchronous delivery loses custom message persistence (pi-core emits `session_start` before reconnecting agent listener during resume). While a flush is scheduled, new deliveries for that owner are queued so ordering is preserved.
 
 ### 4.4 TTL cleanup
 
@@ -109,6 +123,10 @@ After prompt cycle completion, inspect assistant stop reason:
 
 `interactive: true` subagents enter `waiting` after each response. They accept follow-up messages via `crew_respond` until explicitly closed with `crew_done`. Closing does NOT emit a duplicate `crew-result`.
 
+### 5.4 Tool completion behavior
+
+`crew_respond` returns immediately and delivers the subagent response asynchronously. Successful `crew_abort` results terminate the current tool turn after aborting owned subagents.
+
 ## 6. Ownership and isolation
 
 Invariants:
@@ -145,9 +163,10 @@ JSON overrides: `~/.pi/agent/pi-crew.json` (global), `<cwd>/.pi/pi-crew.json` (p
 5. `crew_done` cleans up only; no duplicate result message.
 6. Queued results flush when owner session becomes active.
 7. `crew-result` messages appear before `crew-remaining` notes (ordering via `triggerTurn` split).
-8. Pending messages preserved for inactive sessions; TTL (24h) prevents memory leak.
-9. Active subagent state survives runtime replacement within same process.
-10. Graceful quit aborts subagents through `session_shutdown.reason === "quit"`; replacement paths do not.
+8. `crew-list-warning` is delivered as a separate custom message when `crew_list` is called while the owner has active subagents.
+9. Pending messages preserved for inactive sessions; TTL (24h) prevents memory leak.
+10. Active subagent state survives runtime replacement within same process.
+11. Graceful quit aborts subagents through `session_shutdown.reason === "quit"`; replacement paths do not.
 
 ## 9. Reading guide
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@melihmucuk/pi-crew",
-  "version": "1.0.12",
+  "version": "1.0.13",
   "type": "module",
   "description": "Non-blocking subagent orchestration for pi coding agent",
   "files": [
@@ -39,15 +39,15 @@
     "@mariozechner/pi-ai": "*",
     "@mariozechner/pi-coding-agent": "*",
     "@mariozechner/pi-tui": "*",
-    "@sinclair/typebox": "*"
+    "typebox": "*"
   },
   "devDependencies": {
-    "@mariozechner/pi-agent-core": "^0.68.0",
-    "@mariozechner/pi-ai": "^0.68.0",
-    "@mariozechner/pi-coding-agent": "^0.68.0",
-    "@mariozechner/pi-tui": "^0.68.0",
-    "@sinclair/typebox": "^0.34.49",
+    "@mariozechner/pi-agent-core": "^0.70.0",
+    "@mariozechner/pi-ai": "^0.70.0",
+    "@mariozechner/pi-coding-agent": "^0.70.0",
+    "@mariozechner/pi-tui": "^0.70.0",
     "@types/node": "^22.19.17",
+    "typebox": "^1.1.33",
     "typescript": "^5.9.3"
   }
-}
+}