@melihmucuk/pi-crew 1.0.11 → 1.0.13

package/README.md

@@ -58,7 +58,7 @@ Supported modes:
 "abort all active subagents"
 ```
 
-Tool-triggered aborts are reported back as steering messages with the reason `Aborted by tool request`.
+Tool-triggered aborts are reported back as steering messages with the reason `Aborted by tool request`. User-command aborts and shutdown-triggered aborts use distinct reasons.
 
 ### `crew_respond`
 
@@ -195,6 +195,8 @@ Override values replace the matching frontmatter fields for the named subagent a
 
 When the current session owns active subagents, a live status widget appears in the TUI for that session, showing each subagent's ID, model, turn count, and context token usage.
 
+On session replacement paths such as `/new`, `/resume`, `/fork`, and `/reload`, subagents keep running and reconnect to the owner session when it becomes active again. On real quit, pi-crew aborts running subagents during shutdown.
+
 ```
 ⠹ scout-a1b2 (claude-haiku-4-5) · turn 3 · 12.5k ctx
 ⠸ worker-c3d4 (claude-sonnet-4-6) · turn 7 · 45.2k ctx

package/dist/bootstrap-session.d.ts

@@ -4,6 +4,7 @@ import type { AgentConfig } from "./agent-discovery.js";
 export interface BootstrapContext {
     model: Model<Api> | undefined;
     modelRegistry: ModelRegistry;
+    agentDir: string;
     parentSessionFile?: string;
 }
 interface BootstrapOptions {

package/dist/bootstrap-session.js

@@ -1,7 +1,7 @@
 import { createAgentSession, DefaultResourceLoader, SessionManager, SettingsManager, } from "@mariozechner/pi-coding-agent";
-import { createSupportedTools, SUPPORTED_TOOL_NAMES } from "./tool-registry.js";
-function resolveTools(agentConfig, cwd) {
-    return createSupportedTools(agentConfig.tools ?? SUPPORTED_TOOL_NAMES, cwd);
+import { SUPPORTED_TOOL_NAMES } from "./tool-registry.js";
+function resolveTools(agentConfig) {
+    return [...(agentConfig.tools ?? SUPPORTED_TOOL_NAMES)];
 }
 function resolveModel(agentConfig, ctx) {
     const warnings = [];
@@ -33,9 +33,10 @@ export async function bootstrapSession(opts) {
     const modelRegistry = ctx.modelRegistry;
     const { model, warnings: modelWarnings } = resolveModel(agentConfig, ctx);
     warnings.push(...modelWarnings);
-    const tools = resolveTools(agentConfig, cwd);
+    const tools = resolveTools(agentConfig);
     const resourceLoader = new DefaultResourceLoader({
         cwd,
+        agentDir: ctx.agentDir,
         extensionsOverride: (base) => ({
             ...base,
             extensions: base.extensions.filter((ext) => !ext.resolvedPath.startsWith(extensionResolvedPath)),
@@ -59,6 +60,7 @@ export async function bootstrapSession(opts) {
     sessionManager.newSession({ parentSession: ctx.parentSessionFile });
     const result = await createAgentSession({
         cwd,
+        agentDir: ctx.agentDir,
         model,
         thinkingLevel: agentConfig.thinking,
         tools,

package/dist/index.js

@@ -10,13 +10,10 @@ function setupProcessHooks() {
     if (processHooksSetup)
         return;
     processHooksSetup = true;
-    const abortAndExit = (signal) => {
+    process.once('SIGINT', () => {
         crewRuntime.abortAll();
-        // Re-raise to restore default Node termination behavior
-        process.exit(128 + (signal === 'SIGINT' ? 2 : 15));
-    };
-    process.once('SIGINT', () => abortAndExit('SIGINT'));
-    process.once('SIGTERM', () => abortAndExit('SIGTERM'));
+        process.exit(130);
+    });
     process.on('beforeExit', () => crewRuntime.abortAll());
 }
 export default function (pi) {
@@ -38,20 +35,12 @@ export default function (pi) {
     pi.on("session_start", (_event, ctx) => {
         activateSession(ctx);
     });
-    pi.on("session_before_switch", () => {
-        // Session is about to switch - no action needed here.
-        // Subagent cleanup is handled by process hooks, not session_shutdown.
-    });
-    pi.on("session_before_fork", () => {
-        // Session is about to fork - no action needed here.
-        // Subagent cleanup is handled by process hooks, not session_shutdown.
-    });
-    pi.on("session_shutdown", (_event, ctx) => {
+    pi.on("session_shutdown", (event, ctx) => {
         const sessionId = ctx.sessionManager.getSessionId();
-        // Deactivate delivery to this session, but don't abort subagents.
-        // Subagents continue running and will complete normally.
-        // Real cleanup happens in process exit hooks.
         crewRuntime.deactivateSession(sessionId);
+        if (event.reason === "quit") {
+            crewRuntime.abortAll();
+        }
     });
     registerCrewIntegration(pi, crewRuntime, extensionDir);
 }

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,4 +1,5 @@
-import { Type } from "@sinclair/typebox";
+import { getAgentDir } from "@mariozechner/pi-coding-agent";
+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, }) {
@@ -31,6 +32,7 @@ export function registerCrewSpawnTool({ pi, crew, extensionDir, notifyDiscoveryW
             const id = crew.spawn(subagent, params.task, ctx.cwd, ownerSessionId, {
                 model: ctx.model,
                 modelRegistry: ctx.modelRegistry,
+                agentDir: getAgentDir(),
                 parentSessionFile: ctx.sessionManager.getSessionFile(),
                 onWarning: (msg) => ctx.ui.notify(msg, "warning"),
             }, extensionDir);

package/dist/runtime/crew-runtime.d.ts

@@ -15,6 +15,7 @@ interface AbortOptions {
 export interface SpawnContext {
     model: Model<Api> | undefined;
     modelRegistry: ModelRegistry;
+    agentDir: string;
     parentSessionFile?: string;
     onWarning?: (message: string) => void;
 }
@@ -50,8 +51,8 @@ declare class CrewRuntime {
     abortOwned(ids: string[], callerSessionId: string, opts: AbortOptions): AbortOwnedResult;
     abortAllOwned(callerSessionId: string, opts: AbortOptions): string[];
     /**
-     * Abort all running subagents (process-level cleanup).
-     * Called from process exit hooks.
+     * Abort all running subagents during shutdown cleanup.
+     * Called from SIGINT, session_shutdown(reason="quit"), and beforeExit fallback paths.
      */
     abortAll(): void;
     getAbortableAgents(): AbortableAgentSummary[];

package/dist/runtime/crew-runtime.js

@@ -7,6 +7,7 @@ function toBootstrapContext(ctx) {
     return {
         model: ctx.model,
         modelRegistry: ctx.modelRegistry,
+        agentDir: ctx.agentDir,
         parentSessionFile: ctx.parentSessionFile,
     };
 }
@@ -265,13 +266,13 @@ class CrewRuntime {
         return ids;
     }
     /**
-     * Abort all running subagents (process-level cleanup).
-     * Called from process exit hooks.
+     * Abort all running subagents during shutdown cleanup.
+     * Called from SIGINT, session_shutdown(reason="quit"), and beforeExit fallback paths.
      */
     abortAll() {
         const allAgents = this.registry.getAllRunning();
         for (const state of allAgents) {
-            this.abort(state.id, { reason: "Aborted on process exit" });
+            this.abort(state.id, { reason: "Aborted during shutdown" });
         }
     }
     getAbortableAgents() {

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/dist/tool-registry.d.ts

@@ -1,76 +1,5 @@
-declare const TOOL_FACTORIES: {
-    read: (cwd: string) => import("@mariozechner/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
-        path: import("@sinclair/typebox").TString;
-        offset: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-        limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-    }>, any>;
-    bash: (cwd: string) => import("@mariozechner/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
-        command: import("@sinclair/typebox").TString;
-        timeout: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-    }>, any>;
-    edit: (cwd: string) => import("@mariozechner/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
-        path: import("@sinclair/typebox").TString;
-        edits: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
-            oldText: import("@sinclair/typebox").TString;
-            newText: import("@sinclair/typebox").TString;
-        }>>;
-    }>, any>;
-    write: (cwd: string) => import("@mariozechner/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
-        path: import("@sinclair/typebox").TString;
-        content: import("@sinclair/typebox").TString;
-    }>, any>;
-    grep: (cwd: string) => import("@mariozechner/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
-        pattern: import("@sinclair/typebox").TString;
-        path: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-        glob: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-        ignoreCase: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
-        literal: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
-        context: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-        limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-    }>, any>;
-    find: (cwd: string) => import("@mariozechner/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
-        pattern: import("@sinclair/typebox").TString;
-        path: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-        limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-    }>, any>;
-    ls: (cwd: string) => import("@mariozechner/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
-        path: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-        limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-    }>, any>;
-};
-export type SupportedToolName = keyof typeof TOOL_FACTORIES;
+declare const SUPPORTED_TOOL_NAMES_LITERAL: readonly ["read", "bash", "edit", "write", "grep", "find", "ls"];
+export type SupportedToolName = (typeof SUPPORTED_TOOL_NAMES_LITERAL)[number];
 export declare const SUPPORTED_TOOL_NAMES: readonly ("read" | "bash" | "edit" | "write" | "grep" | "find" | "ls")[];
 export declare function isSupportedToolName(name: string): name is SupportedToolName;
-export declare function createSupportedTools(toolNames: readonly SupportedToolName[], cwd: string): (import("@mariozechner/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
-    path: import("@sinclair/typebox").TString;
-    offset: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-}>, any> | import("@mariozechner/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
-    command: import("@sinclair/typebox").TString;
-    timeout: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-}>, any> | import("@mariozechner/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
-    path: import("@sinclair/typebox").TString;
-    edits: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
-        oldText: import("@sinclair/typebox").TString;
-        newText: import("@sinclair/typebox").TString;
-    }>>;
-}>, any> | import("@mariozechner/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
-    path: import("@sinclair/typebox").TString;
-    content: import("@sinclair/typebox").TString;
-}>, any> | import("@mariozechner/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
-    pattern: import("@sinclair/typebox").TString;
-    path: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    glob: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    ignoreCase: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
-    literal: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
-    context: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-}>, any> | import("@mariozechner/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
-    pattern: import("@sinclair/typebox").TString;
-    path: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-}>, any> | import("@mariozechner/pi-agent-core").AgentTool<import("@sinclair/typebox").TObject<{
-    path: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-}>, any>)[];
 export {};

package/dist/tool-registry.js

@@ -1,17 +1,13 @@
-import { createBashTool, createEditTool, createFindTool, createGrepTool, createLsTool, createReadTool, createWriteTool, } from "@mariozechner/pi-coding-agent";
-const TOOL_FACTORIES = {
-    read: (cwd) => createReadTool(cwd),
-    bash: (cwd) => createBashTool(cwd),
-    edit: (cwd) => createEditTool(cwd),
-    write: (cwd) => createWriteTool(cwd),
-    grep: (cwd) => createGrepTool(cwd),
-    find: (cwd) => createFindTool(cwd),
-    ls: (cwd) => createLsTool(cwd),
-};
-export const SUPPORTED_TOOL_NAMES = Object.freeze(Object.keys(TOOL_FACTORIES));
+const SUPPORTED_TOOL_NAMES_LITERAL = [
+    "read",
+    "bash",
+    "edit",
+    "write",
+    "grep",
+    "find",
+    "ls",
+];
+export const SUPPORTED_TOOL_NAMES = Object.freeze([...SUPPORTED_TOOL_NAMES_LITERAL]);
 export function isSupportedToolName(name) {
-    return name in TOOL_FACTORIES;
-}
-export function createSupportedTools(toolNames, cwd) {
-    return toolNames.map((toolName) => TOOL_FACTORIES[toolName](cwd));
+    return SUPPORTED_TOOL_NAMES.includes(name);
 }

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
 
@@ -20,12 +21,13 @@ Primary components:
 
 ### 2.1 CrewRuntime singleton
 
-`CrewRuntime` is a process-level singleton that survives pi runtime replacement (`/resume`, `/new`, `/fork`). When pi discards an old extension instance and creates a new one, the new instance reconnects to the same `crewRuntime` and picks up existing subagent state.
+`CrewRuntime` is a process-level singleton that survives pi runtime replacement (`/resume`, `/new`, `/fork`, `/reload`). When pi discards an old extension instance and creates a new one, the new instance reconnects to the same `crewRuntime` and picks up existing subagent state.
 
 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
 
@@ -35,12 +37,24 @@ Routes subagent results to the correct session at the correct time. Key behavior
 
 - Tracks active session via `ActiveRuntimeBinding` (set on `session_start`, cleared on `session_shutdown`)
 - Queues results when owner session is inactive
-- Flushes queued results when owner session activates (`session_start` with `reason: "resume"` or `"fork"`)
+- Flushes queued results when owner session activates on any `session_start`; resume/fork are the important replacement paths because subagents survive runtime replacement within the same process
 - Uses `triggerTurn: false/true` split to preserve ordering between `crew-result` and `crew-remaining`
 
 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,13 +123,17 @@ 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:
 
 1. `crew_list`, `crew_abort`, `crew_respond`, `crew_done`, status widget: session-scoped. Only owner sees/controls.
 2. `/pi-crew-abort`: cross-session emergency escape hatch.
-3. `session_shutdown` deactivates delivery binding only; subagents continue running. Abort happens on process exit.
+3. `session_shutdown` always deactivates delivery binding. On replacement paths (`reload`, `new`, `resume`, `fork`), subagents continue running. On `quit`, the extension aborts all running subagents. `SIGINT` also aborts via a process hook, and `beforeExit` remains a fallback.
 
 ## 7. Subagent definition model
 
@@ -145,8 +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.
+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.11",
+  "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.65.0",
-    "@mariozechner/pi-ai": "^0.65.0",
-    "@mariozechner/pi-coding-agent": "^0.65.0",
-    "@mariozechner/pi-tui": "^0.65.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"
   }
-}
+}