@melihmucuk/pi-crew 1.0.17 → 1.0.18

package/extension/integration/register-renderers.ts

@@ -1,77 +0,0 @@
-import {
-	type ExtensionAPI,
-	getMarkdownTheme,
-} from "@earendil-works/pi-coding-agent";
-import { Box, Markdown, Text } from "@earendil-works/pi-tui";
-import {
-	type CrewResultMessageDetails,
-	STATUS_ICON,
-	getCrewResultTitle,
-} from "../subagent-messages.js";
-
-type MessageRenderer = Parameters<ExtensionAPI["registerMessageRenderer"]>[1];
-type MessageRendererTheme = Parameters<MessageRenderer>[2];
-
-function getStatusColor(status: CrewResultMessageDetails["status"]): "success" | "error" | "warning" | "muted" {
-	switch (status) {
-		case "done":
-			return "success";
-		case "error":
-		case "aborted":
-			return "error";
-		case "running":
-		case "waiting":
-			return "warning";
-		default:
-			return "muted";
-	}
-}
-
-function renderWarningMessage(content: unknown, theme: MessageRendererTheme): Box {
-	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: ExtensionAPI): void {
-	pi.registerMessageRenderer("crew-result", (message, { expanded }, theme) => {
-		const details = message.details as CrewResultMessageDetails | undefined;
-		const title = details ? getCrewResultTitle(details) : "Subagent update";
-		const icon = details
-			? theme.fg(getStatusColor(details.status), STATUS_ICON[details.status])
-			: theme.fg("muted", "ℹ");
-		const header = `${icon} ${theme.fg("toolTitle", theme.bold(title))}`;
-		const body = details?.body ?? (!details && message.content ? String(message.content) : undefined);
-
-		const box = new Box(1, 1, (text) => theme.bg("customMessageBg", text));
-		box.addChild(new Text(header, 0, 0));
-
-		if (details?.sessionFile) {
-			box.addChild(new Text(theme.fg("muted", `📁 ${details.sessionFile}`), 0, 0));
-		}
-
-		if (body) {
-			if (expanded) {
-				box.addChild(new Text("", 0, 0));
-				box.addChild(new Markdown(body, 0, 0, getMarkdownTheme()));
-			} else {
-				const lines = body.split("\n");
-				const preview = lines.slice(0, 5).join("\n");
-				box.addChild(new Text(theme.fg("dim", preview), 0, 0));
-				if (lines.length > 5) {
-					box.addChild(new Text(theme.fg("muted", "(Ctrl+O to expand)"), 0, 0));
-				}
-			}
-		}
-
-		return box;
-	});
-
-	pi.registerMessageRenderer("crew-remaining", (message, _options, theme) => {
-		return renderWarningMessage(message.content, theme);
-	});
-
-	pi.registerMessageRenderer("crew-list-warning", (message, _options, theme) => {
-		return renderWarningMessage(message.content, theme);
-	});
-}

package/extension/integration/register-tools.ts

@@ -1,47 +0,0 @@
-import type {
-	ExtensionAPI,
-	ExtensionContext,
-} from "@earendil-works/pi-coding-agent";
-import { discoverAgents, type AgentDiscoveryWarning } from "../agent-discovery.js";
-import type { CrewRuntime } from "../runtime/crew-runtime.js";
-import { createCrewToolActions } from "./crew-tool-actions.js";
-import { CrewToolExecutor } from "./crew-tool-executor.js";
-import { registerCrewAbortTool } from "./tools/crew-abort.js";
-import { registerCrewDoneTool } from "./tools/crew-done.js";
-import { registerCrewListTool } from "./tools/crew-list.js";
-import { registerCrewRespondTool } from "./tools/crew-respond.js";
-import { registerCrewSpawnTool } from "./tools/crew-spawn.js";
-
-export function registerCrewTools(
-	pi: ExtensionAPI,
-	crew: CrewRuntime,
-	extensionDir: string,
-): void {
-	const shownDiscoveryWarnings = new Set<string>();
-
-	const notifyDiscoveryWarnings = (
-		ctx: ExtensionContext,
-		warnings: AgentDiscoveryWarning[],
-	) => {
-		if (!ctx.hasUI) return;
-		for (const warning of warnings) {
-			const key = `${warning.filePath}:${warning.message}`;
-			if (shownDiscoveryWarnings.has(key)) continue;
-			shownDiscoveryWarnings.add(key);
-			ctx.ui.notify(`${warning.message} (${warning.filePath})`, "error");
-		}
-	};
-
-	const actions = createCrewToolActions({
-		crew,
-		discoverAgents,
-		extensionDir,
-	});
-	const executor = new CrewToolExecutor({ pi, notifyDiscoveryWarnings });
-	const deps = { pi, actions, executor };
-	registerCrewListTool(deps);
-	registerCrewSpawnTool(deps);
-	registerCrewAbortTool(deps);
-	registerCrewRespondTool(deps);
-	registerCrewDoneTool(deps);
-}

package/extension/integration/tool-presentation.ts

@@ -1,30 +0,0 @@
-import type { AgentToolResult } from "@earendil-works/pi-agent-core";
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import { Box, Text } from "@earendil-works/pi-tui";
-
-export type ToolTheme = Parameters<Exclude<Parameters<ExtensionAPI["registerTool"]>[0]["renderCall"], undefined>>[1];
-export type ToolResult = AgentToolResult<unknown>;
-
-export function renderCrewCall(
-	theme: ToolTheme,
-	name: string,
-	id: string,
-	preview?: string,
-): Box {
-	const box = new Box(1, 1);
-	box.addChild(new Text(theme.fg("toolTitle", theme.bold(`${name} `)) + theme.fg("accent", id), 0, 0));
-	if (preview) {
-		box.addChild(new Text(theme.fg("dim", preview), 0, 0));
-	}
-	return box;
-}
-
-export function renderCrewResult(
-	result: ToolResult,
-	theme: ToolTheme,
-): Text {
-	const text = result.content[0];
-	const details = result.details as { error?: boolean } | undefined;
-	const content = text?.type === "text" && text.text ? text.text : "(no output)";
-	return new Text(details?.error ? theme.fg("error", content) : theme.fg("success", content), 0, 0);
-}

package/extension/integration/tools/crew-abort.ts

@@ -1,56 +0,0 @@
-import { Type } from "typebox";
-import { renderCrewCall } from "../tool-presentation.js";
-import {
-	registerCrewActionTool,
-	type CrewToolDeps,
-} from "../crew-tool-executor.js";
-
-type CrewAbortParams = {
-	subagent_id?: string;
-	subagent_ids?: string[];
-	all?: boolean;
-};
-
-export function registerCrewAbortTool(deps: CrewToolDeps): void {
-	registerCrewActionTool<CrewAbortParams>(deps, {
-		name: "crew_abort",
-		label: "Abort Crew",
-		description:
-			"Abort one, many, or all active subagents owned by the current session.",
-		parameters: Type.Object({
-			subagent_id: Type.Optional(
-				Type.String({ description: "Single subagent ID to abort" }),
-			),
-			subagent_ids: Type.Optional(
-				Type.Array(Type.String(), {
-					minItems: 1,
-					description: "Multiple subagent IDs to abort",
-				}),
-			),
-			all: Type.Optional(
-				Type.Boolean({
-					description: "Abort all active subagents owned by the current session",
-				}),
-			),
-		}),
-		promptSnippet: "Abort one, many, or all active subagents from this session.",
-		promptGuidelines: [
-			"crew_abort: Abort one, many, or all active subagents owned by this session.",
-			"crew_abort: Provide exactly one mode: subagent_id, subagent_ids, or all=true.",
-			"crew_abort: Use only when delegated work is obsolete, wrong, or explicitly cancelled.",
-		],
-		action: (params, actionCtx) => deps.actions.abort(params, actionCtx),
-		renderCall(args, theme, _context) {
-			if (args.all) {
-				return renderCrewCall(theme, "crew_abort", "all");
-			}
-
-			if (args.subagent_id) {
-				return renderCrewCall(theme, "crew_abort", args.subagent_id);
-			}
-
-			const count = Array.isArray(args.subagent_ids) ? args.subagent_ids.length : 0;
-			return renderCrewCall(theme, "crew_abort", `${count} ids`);
-		},
-	});
-}

package/extension/integration/tools/crew-done.ts

@@ -1,27 +0,0 @@
-import { Type } from "typebox";
-import { renderCrewCall } from "../tool-presentation.js";
-import {
-	registerCrewActionTool,
-	type CrewToolDeps,
-} from "../crew-tool-executor.js";
-
-export function registerCrewDoneTool(deps: CrewToolDeps): void {
-	registerCrewActionTool<{ subagent_id: string }>(deps, {
-		name: "crew_done",
-		label: "Done with Crew",
-		description:
-			"Close an interactive subagent session. Use when you no longer need to interact with the subagent.",
-		parameters: Type.Object({
-			subagent_id: Type.String({ description: "ID of the subagent to close" }),
-		}),
-		promptSnippet: "Close an interactive subagent session when done.",
-		promptGuidelines: [
-			"crew_done: Close a waiting interactive subagent owned by this session.",
-			"crew_done: Use only when no further follow-up is needed; otherwise use crew_respond.",
-		],
-		action: (params, actionCtx) => deps.actions.done(params, actionCtx),
-		renderCall(args, theme, _context) {
-			return renderCrewCall(theme, "crew_done", args.subagent_id || "...");
-		},
-	});
-}

package/extension/integration/tools/crew-list.ts

@@ -1,36 +0,0 @@
-import { Text } from "@earendil-works/pi-tui";
-import { Type } from "typebox";
-import type { CrewToolDeps } from "../crew-tool-executor.js";
-
-export function registerCrewListTool({
-	pi,
-	actions,
-	executor,
-}: CrewToolDeps): void {
-	pi.registerTool({
-		name: "crew_list",
-		label: "List Crew",
-		description:
-			"List available subagent definitions and currently running subagents with their status. Use only to discover which subagents exist or to get a one-time status snapshot. Do NOT call this repeatedly to check if a subagent has finished — results are delivered automatically as steering messages.",
-		parameters: Type.Object({}),
-		promptSnippet: "List subagent definitions and active subagents",
-		promptGuidelines: [
-			"crew_list: List available subagents and active subagents owned by this session.",
-			"crew_list: Use before crew_spawn to discover names, descriptions, and interactive status.",
-			"crew_list: Use only for discovery or a requested status snapshot; do not poll for completion.",
-		],
-
-		async execute(_toolCallId, _params, _signal, _onUpdate, ctx) {
-			return executor.execute(ctx, (actionCtx) => actions.list(actionCtx));
-		},
-
-		renderCall(_args, theme, _context) {
-			return new Text(theme.fg("toolTitle", theme.bold("crew_list")), 0, 0);
-		},
-
-		renderResult(result, _options, _theme, _context) {
-			const text = result.content[0];
-			return new Text(text?.type === "text" ? text.text : "(no output)", 0, 0);
-		},
-	});
-}

package/extension/integration/tools/crew-respond.ts

@@ -1,38 +0,0 @@
-import { Type } from "typebox";
-import { renderCrewCall } from "../tool-presentation.js";
-import {
-	registerCrewActionTool,
-	type CrewToolDeps,
-} from "../crew-tool-executor.js";
-
-export function registerCrewRespondTool(deps: CrewToolDeps): void {
-	registerCrewActionTool<{ subagent_id: string; message: string }>(deps, {
-		name: "crew_respond",
-		label: "Respond to Crew",
-		description:
-			"Send a follow-up message to an interactive subagent that is waiting for a response.",
-		parameters: Type.Object({
-			subagent_id: Type.String({
-				description:
-					"ID of the waiting subagent (from crew_list or crew_spawn result)",
-			}),
-			message: Type.String({ description: "Message to send to the subagent" }),
-		}),
-		promptSnippet:
-			"Send a follow-up message to a waiting interactive subagent.",
-		promptGuidelines: [
-			"crew_respond: Send a complete follow-up message to a waiting interactive subagent.",
-			"crew_respond: Use the waiting subagent ID from crew_spawn results or crew_list.",
-			"crew_respond: The response arrives as a steering message; do not poll crew_list.",
-		],
-		action: (params, actionCtx) => deps.actions.respond(params, actionCtx),
-		renderCall(args, theme, _context) {
-			return renderCrewCall(
-				theme,
-				"crew_respond",
-				args.subagent_id || "...",
-				args.message,
-			);
-		},
-	});
-}

package/extension/integration/tools/crew-spawn.ts

@@ -1,46 +0,0 @@
-import { getAgentDir } from "@earendil-works/pi-coding-agent";
-import { Type } from "typebox";
-import { renderCrewCall } from "../tool-presentation.js";
-import {
-	registerCrewActionTool,
-	type CrewToolDeps,
-} from "../crew-tool-executor.js";
-
-export function registerCrewSpawnTool(deps: CrewToolDeps): void {
-	registerCrewActionTool<{ subagent: string; task: string }>(deps, {
-		name: "crew_spawn",
-		label: "Spawn Crew",
-		description:
-			"Spawn a non-blocking subagent that runs in an isolated session. The subagent works independently while your session stays interactive. Results are delivered back to your session as steering messages.",
-		parameters: Type.Object({
-			subagent: Type.String({ description: "Subagent name from crew_list" }),
-			task: Type.String({ description: "Task to delegate to the subagent" }),
-		}),
-		promptSnippet:
-			"Spawn a non-blocking subagent. Use crew_list first to see available subagents.",
-		promptGuidelines: [
-			"crew_spawn: Spawn a discovered subagent for one clearly delegated, self-contained task.",
-			"crew_spawn: Include only needed context: constraints, relevant files, acceptance criteria, and expected output.",
-			"crew_spawn: After spawning, ownership transfers to the subagent; do not work on that task yourself.",
-			"crew_spawn: Results arrive as steering messages; do not poll crew_list or fabricate results.",
-			"crew_spawn: Use the bundled pi-crew skill for detailed delegation patterns.",
-		],
-		action: (params, actionCtx, ctx) =>
-			deps.actions.spawn(params, {
-				...actionCtx,
-				model: ctx.model,
-				modelRegistry: ctx.modelRegistry,
-				agentDir: getAgentDir(),
-				parentSessionFile: ctx.sessionManager.getSessionFile(),
-				onWarning: (msg) => ctx.ui.notify(msg, "warning"),
-			}),
-		renderCall(args, theme, _context) {
-			return renderCrewCall(
-				theme,
-				"crew_spawn",
-				args.subagent || "...",
-				args.task,
-			);
-		},
-	});
-}

package/extension/message-delivery-policy.ts

@@ -1,22 +0,0 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-
-export type SendMessageFn = ExtensionAPI["sendMessage"];
-type Message = Parameters<SendMessageFn>[0];
-
-interface DeliveryOptions {
-	isIdle: boolean;
-	triggerTurn: boolean;
-}
-
-export function sendWithDeliveryPolicy(
-	message: Message,
-	sendMessage: SendMessageFn,
-	opts: DeliveryOptions,
-): void {
-	sendMessage(
-		message,
-		opts.isIdle
-			? { triggerTurn: opts.triggerTurn }
-			: { deliverAs: "steer", triggerTurn: opts.triggerTurn },
-	);
-}

package/extension/runtime/crew-runtime.ts

@@ -1,263 +0,0 @@
-import type { Api, Model } from "@earendil-works/pi-ai";
-import type { ModelRegistry } from "@earendil-works/pi-coding-agent";
-import type { AgentConfig } from "../agent-discovery.js";
-import type { BootstrapContext } from "../bootstrap-session.js";
-import { type ActiveRuntimeBinding, OwnerSessionCoordinator } from "./owner-session-coordinator.js";
-import {
-	type ActiveAgentSummary,
-	SubagentRegistry,
-	type SubagentState,
-} from "./subagent-registry.js";
-import { SubagentLifecycle } from "./subagent-lifecycle.js";
-import {
-	type SettledSubagentStatus,
-	canAbortSubagent,
-	settleSubagent,
-	startSubagentResponse,
-	validateSubagentDone,
-} from "./subagent-transitions.js";
-
-export type {
-	ActiveAgentSummary,
-} from "./subagent-registry.js";
-
-export interface AbortOwnedResult {
-	abortedIds: string[];
-	missingIds: string[];
-	foreignIds: string[];
-}
-
-interface AbortOptions {
-	reason: string;
-}
-
-export interface SpawnContext {
-	model: Model<Api> | undefined;
-	modelRegistry: ModelRegistry;
-	agentDir: string;
-	parentSessionFile?: string;
-	onWarning?: (message: string) => void;
-}
-
-function toBootstrapContext(ctx: SpawnContext): BootstrapContext {
-	return {
-		model: ctx.model,
-		modelRegistry: ctx.modelRegistry,
-		agentDir: ctx.agentDir,
-		parentSessionFile: ctx.parentSessionFile,
-	};
-}
-
-/**
- * Process-level singleton that owns all durable subagent state.
- *
- * This survives extension instance replacement caused by runtime
- * teardown/recreation on /resume, /new, /fork (pi 0.65.0+).
- * Each new extension instance rebinds delivery and widget hooks
- * via activateSession/deactivateSession.
- */
-class CrewRuntime {
-	private readonly registry = new SubagentRegistry();
-	private readonly ownerSessions: OwnerSessionCoordinator;
-	private readonly lifecycle: SubagentLifecycle;
-
-	// Per-session refresh callbacks, keyed by ownerSessionId
-	private readonly refreshCallbacks = new Map<string, () => void>();
-
-	constructor() {
-		this.ownerSessions = new OwnerSessionCoordinator({
-			countRunningForOwner: (ownerSessionId, excludeId) =>
-				this.registry.countRunningForOwner(ownerSessionId, excludeId),
-			onRefreshOwnerSession: (ownerSessionId) => this.refreshWidgetFor(ownerSessionId),
-		});
-		this.lifecycle = new SubagentLifecycle({
-			isCurrent: (state) => this.registry.hasState(state),
-			onProgress: (ownerSessionId) => this.ownerSessions.refresh(ownerSessionId),
-			onSettled: (state, status, outcome) =>
-				this.settleAgent(state, status, outcome),
-		});
-	}
-
-	private refreshWidgetFor(sessionId: string): void {
-		this.refreshCallbacks.get(sessionId)?.();
-	}
-
-	activateSession(
-		binding: ActiveRuntimeBinding,
-		refreshWidget?: () => void,
-	): void {
-		if (refreshWidget) {
-			this.refreshCallbacks.set(binding.sessionId, refreshWidget);
-		}
-		this.ownerSessions.activateSession(binding);
-		refreshWidget?.();
-	}
-
-	deactivateSession(sessionId: string): void {
-		this.ownerSessions.deactivateSession(sessionId);
-		this.refreshCallbacks.delete(sessionId);
-	}
-
-	spawn(
-		agentConfig: AgentConfig,
-		task: string,
-		cwd: string,
-		ownerSessionId: string,
-		ctx: SpawnContext,
-		extensionResolvedPath: string,
-	): string {
-		const state = this.registry.create(agentConfig, task, ownerSessionId);
-		this.ownerSessions.refresh(ownerSessionId);
-		this.lifecycle.start(state, {
-			cwd,
-			ctx: toBootstrapContext(ctx),
-			extensionResolvedPath,
-			onWarning: ctx.onWarning,
-		});
-		return state.id;
-	}
-
-	private settleAgent(
-		state: SubagentState,
-		nextStatus: SettledSubagentStatus,
-		opts: { result?: string; error?: string },
-	): void {
-		settleSubagent(state, nextStatus, opts);
-
-		this.ownerSessions.deliver(
-			state.ownerSessionId,
-			{
-				id: state.id,
-				agentName: state.agentConfig.name,
-				sessionFile: state.session?.sessionFile,
-				status: state.status,
-				result: state.result,
-				error: state.error,
-			},
-		);
-
-		if (state.status !== "waiting") {
-			this.disposeAgent(state);
-		} else {
-			this.ownerSessions.refresh(state.ownerSessionId);
-		}
-	}
-
-	private disposeAgent(state: SubagentState): void {
-		state.unsubscribe?.();
-		state.promptAbortController = undefined;
-		state.session?.dispose();
-		this.registry.delete(state.id);
-		this.ownerSessions.refresh(state.ownerSessionId);
-	}
-
-
-	respond(
-		id: string,
-		message: string,
-		callerSessionId: string,
-	): { error?: string } {
-		const transition = startSubagentResponse(
-			this.registry.get(id),
-			id,
-			callerSessionId,
-		);
-		if (!transition.ok) return { error: transition.error };
-
-		this.ownerSessions.refresh(transition.state.ownerSessionId);
-		this.lifecycle.respond(transition.state, message);
-		return {};
-	}
-
-	done(id: string, callerSessionId: string): { error?: string } {
-		const transition = validateSubagentDone(
-			this.registry.get(id),
-			id,
-			callerSessionId,
-		);
-		if (!transition.ok) return { error: transition.error };
-
-		this.disposeAgent(transition.state);
-		return {};
-	}
-
-	abort(id: string, opts: AbortOptions): boolean {
-		const state = this.registry.get(id);
-		if (!canAbortSubagent(state)) return false;
-
-		this.lifecycle.abortPrompt(state);
-		this.settleAgent(state, "aborted", { error: opts.reason });
-		return true;
-	}
-
-	abortOwned(
-		ids: string[],
-		callerSessionId: string,
-		opts: AbortOptions,
-	): AbortOwnedResult {
-		const uniqueIds = Array.from(
-			new Set(ids.map((id) => id.trim()).filter(Boolean)),
-		);
-		const result: AbortOwnedResult = {
-			abortedIds: [],
-			missingIds: [],
-			foreignIds: [],
-		};
-
-		for (const id of uniqueIds) {
-			const state = this.registry.get(id);
-			if (!canAbortSubagent(state)) {
-				result.missingIds.push(id);
-				continue;
-			}
-			if (state.ownerSessionId !== callerSessionId) {
-				result.foreignIds.push(id);
-				continue;
-			}
-			if (this.abort(id, opts)) {
-				result.abortedIds.push(id);
-			} else {
-				result.missingIds.push(id);
-			}
-		}
-
-		return result;
-	}
-
-	abortAllOwned(
-		callerSessionId: string,
-		opts: AbortOptions,
-	): string[] {
-		const ids = this.registry.getOwnedAbortableIds(callerSessionId);
-
-		for (const id of ids) {
-			this.abort(id, opts);
-		}
-
-		return ids;
-	}
-
-	/**
-	 * Abort all abortable subagents during shutdown cleanup.
-	 * Called from SIGINT, session_shutdown(reason="quit"), and beforeExit fallback paths.
-	 */
-	abortAll(): void {
-		const allAgents = this.registry.getAllAbortable();
-		for (const state of allAgents) {
-			this.abort(state.id, { reason: "Aborted during shutdown" });
-		}
-	}
-
-	getActiveSummariesForOwner(ownerSessionId: string): ActiveAgentSummary[] {
-		return this.registry.getActiveSummariesForOwner(ownerSessionId);
-	}
-}
-
-const crewRuntimeKey = Symbol.for("pi-crew.runtime");
-const globalWithCrewRuntime = globalThis as typeof globalThis & Record<
-	symbol,
-	CrewRuntime | undefined
->;
-
-export const crewRuntime = globalWithCrewRuntime[crewRuntimeKey] ??= new CrewRuntime();
-export type { CrewRuntime };