ultimate-pi 0.10.1 → 0.12.0

package/.pi/extensions/lib/harness-subagents/blackboard.ts

@@ -1,175 +0,0 @@
-/**
- * Shared blackboard for orchestrator ↔ subagent handoffs (~8k injection cap).
- */
-
-import type {
-	BlackboardEntry,
-	BlackboardQuery,
-	PostMetadata,
-} from "./types-blackboard.js";
-
-const MAX_VALUE_DISPLAY_CHARS = 500;
-export const MAX_SERIALIZE_TOTAL_CHARS = 8_000;
-
-function truncateForDisplay(value: unknown): string {
-	const str =
-		typeof value === "string" ? value : JSON.stringify(value, null, 2);
-	if (str.length <= MAX_VALUE_DISPLAY_CHARS) return str;
-	return `${str.slice(0, MAX_VALUE_DISPLAY_CHARS)}...(truncated)`;
-}
-
-type PostHandler = (key: string, entry: BlackboardEntry) => void;
-
-export class Blackboard {
-	private entries = new Map<string, BlackboardEntry>();
-	private postHandlers: PostHandler[] = [];
-
-	post(
-		namespacedKey: string,
-		value: unknown,
-		agentId: string,
-		agentName: string,
-		metadata?: PostMetadata,
-	): void {
-		if (metadata?.supersedes) {
-			this.entries.delete(metadata.supersedes);
-		}
-
-		const entry: BlackboardEntry = {
-			key: namespacedKey,
-			value,
-			agentId,
-			agentName,
-			timestamp: Date.now(),
-			metadata,
-		};
-
-		this.entries.set(namespacedKey, entry);
-
-		for (const handler of this.postHandlers) {
-			try {
-				handler(namespacedKey, entry);
-			} catch {
-				/* ignore */
-			}
-		}
-	}
-
-	get(key: string): BlackboardEntry | undefined {
-		return this.entries.get(key);
-	}
-
-	getAll(): Map<string, BlackboardEntry> {
-		return new Map(this.entries);
-	}
-
-	query(query: BlackboardQuery): BlackboardEntry[] {
-		let results = [...this.entries.values()];
-
-		if (query.keys?.length) {
-			results = results.filter((e) => query.keys?.includes(e.key));
-		}
-
-		if (query.pattern) {
-			const pat = query.pattern;
-			if (pat instanceof RegExp) {
-				results = results.filter((e) => pat.test(e.key));
-			} else {
-				const escaped = pat.replace(/[.+?^${}()|[\]\\]/g, "\\$&");
-				const re = new RegExp(`^${escaped.replace(/\*/g, ".*")}$`);
-				results = results.filter((e) => re.test(e.key) || e.key.includes(pat));
-			}
-		}
-
-		if (query.agentId) {
-			results = results.filter((e) => e.agentId === query.agentId);
-		}
-		if (query.agentName) {
-			results = results.filter((e) => e.agentName === query.agentName);
-		}
-		if (query.category) {
-			results = results.filter((e) => e.metadata?.category === query.category);
-		}
-		if (query.after !== undefined) {
-			results = results.filter((e) => e.timestamp > query.after!);
-		}
-
-		return results;
-	}
-
-	serialize(query?: BlackboardQuery): string {
-		const entries = query ? this.query(query) : [...this.entries.values()];
-
-		if (entries.length === 0) return "(blackboard is empty)";
-
-		const lines: string[] = [`Blackboard (${entries.length} entries):`];
-		let totalChars = lines[0].length;
-
-		for (const entry of entries) {
-			const summary = entry.metadata?.summary
-				? entry.metadata.summary
-				: truncateForDisplay(entry.value);
-			const category = entry.metadata?.category
-				? ` [${entry.metadata.category}]`
-				: "";
-			const ts = new Date(entry.timestamp).toISOString().slice(11, 19);
-			const keyLine = `  ${entry.key}${category} (${entry.agentName} @ ${ts})`;
-			const valLine = `    ${summary}`;
-			const entryChars = keyLine.length + valLine.length + 2;
-
-			if (totalChars + entryChars > MAX_SERIALIZE_TOTAL_CHARS) {
-				lines.push(
-					"  ... (more entries truncated — use blackboard query with specific keys)",
-				);
-				break;
-			}
-			lines.push(keyLine, valLine);
-			totalChars += entryChars;
-		}
-
-		return lines.join("\n");
-	}
-
-	toJSON(query?: BlackboardQuery): object {
-		const entries = query ? this.query(query) : [...this.entries.values()];
-		return {
-			count: entries.length,
-			entries: entries.map((e) => ({
-				key: e.key,
-				agentId: e.agentId,
-				agentName: e.agentName,
-				timestamp: e.timestamp,
-				summary: e.metadata?.summary ?? null,
-				category: e.metadata?.category ?? null,
-				value: e.value,
-			})),
-		};
-	}
-
-	clear(): void {
-		this.entries.clear();
-	}
-
-	restore(data: {
-		key: string;
-		value: unknown;
-		agentId: string;
-		agentName: string;
-		timestamp: number;
-		metadata?: PostMetadata;
-	}): void {
-		this.entries.set(data.key, { ...data });
-	}
-
-	delete(key: string): boolean {
-		return this.entries.delete(key);
-	}
-
-	get size(): number {
-		return this.entries.size;
-	}
-
-	on(event: "post", handler: PostHandler): void {
-		if (event === "post") this.postHandlers.push(handler);
-	}
-}

package/.pi/extensions/lib/harness-subagents/parent-ask-user-bridge.ts

@@ -1,10 +0,0 @@
-/**
- * @deprecated Import from parent-harness-ui-bridge.js — kept for stable import paths.
- */
-export {
-	agentTypeAllowsParentAskUser,
-	agentTypeAllowsParentHarnessUi,
-	createParentAskUserBridgeFactory,
-	createParentHarnessUiBridgeFactory,
-	type ParentHarnessUiHooks,
-} from "./parent-harness-ui-bridge.js";

package/.pi/extensions/lib/harness-subagents/parent-harness-ui-bridge.ts

@@ -1,310 +0,0 @@
-/**
- * Registers ask_user and approve_plan in subagent sessions, delegating UI to the parent harness session.
- */
-
-import type {
-	ExtensionAPI,
-	ExtensionContext,
-} from "@earendil-works/pi-coding-agent";
-import { Text } from "@earendil-works/pi-tui";
-import { Type } from "@sinclair/typebox";
-import type {
-	PlanPacketLike,
-	PlanUserApproval,
-} from "../../../lib/harness-run-context.js";
-import { parsePlanApprovalFromMessage } from "../../../lib/harness-run-context.js";
-import { runAskDialog } from "../ask-user/dialog.js";
-import { runAskFallback } from "../ask-user/fallback.js";
-import { renderAskCall, renderAskResult } from "../ask-user/render.js";
-import {
-	PROMPT_GUIDELINES as ASK_PROMPT_GUIDELINES,
-	PROMPT_SNIPPET as ASK_PROMPT_SNIPPET,
-	AskUserParamsSchema,
-} from "../ask-user/schema.js";
-import type { AskUserParams, DialogResult } from "../ask-user/types.js";
-import {
-	formatResultText,
-	toToolDetails,
-	validateAskParams,
-} from "../ask-user/validate.js";
-import {
-	CREATE_PLAN_GUIDELINES,
-	CREATE_PLAN_SNIPPET,
-	executeCreatePlan,
-	formatCreatePlanResultText,
-} from "../plan-approval/create-plan.js";
-import { runPlanApprovalDialog } from "../plan-approval/dialog.js";
-import { runPlanApprovalFallback } from "../plan-approval/fallback.js";
-import {
-	renderApprovePlanCall,
-	renderApprovePlanResult,
-} from "../plan-approval/render.js";
-import {
-	ApprovePlanParamsSchema,
-	PROMPT_GUIDELINES as PLAN_PROMPT_GUIDELINES,
-	PROMPT_SNIPPET as PLAN_PROMPT_SNIPPET,
-} from "../plan-approval/schema.js";
-import type { ApprovePlanParams } from "../plan-approval/types.js";
-import {
-	formatApprovePlanResultText,
-	toApprovePlanToolDetails,
-	validateApprovePlanParams,
-} from "../plan-approval/validate.js";
-
-const HARNESS_UI_AGENT_TYPES = new Set([
-	"harness/planner",
-	"harness/evaluator",
-	"harness/adversary",
-	"harness/tie-breaker",
-]);
-
-export interface ParentHarnessUiHooks {
-	projectRoot?: string;
-	getParentEntries?: () => unknown[];
-	getParentRunContext?: () =>
-		| import("../../../lib/harness-run-context.js").HarnessRunContext
-		| null;
-	onPlanApproval?: (approval: PlanUserApproval) => void;
-	appendPlanDraft?: (draft: {
-		plan_packet: PlanPacketLike;
-		human_summary?: string;
-	}) => void;
-	onPlanCommitted?: (
-		runCtx: import("../../../lib/harness-run-context.js").HarnessRunContext,
-		packet: PlanPacketLike,
-		planPath: string,
-	) => void;
-}
-
-const CreatePlanParamsSchema = Type.Object({
-	plan_packet: Type.Object(
-		{},
-		{
-			description:
-				"Approved PlanPacket to persist (same object as approve_plan).",
-		},
-	),
-});
-
-const PLANNER_ONLY_AGENT = "harness/planner";
-
-export function agentTypeAllowsParentHarnessUi(agentType: string): boolean {
-	return HARNESS_UI_AGENT_TYPES.has(agentType);
-}
-
-/** @deprecated Use agentTypeAllowsParentHarnessUi */
-export function agentTypeAllowsParentAskUser(agentType: string): boolean {
-	return agentTypeAllowsParentHarnessUi(agentType);
-}
-
-function notifyPlanApproval(
-	hooks: ParentHarnessUiHooks | undefined,
-	details: unknown,
-	toolName: "ask_user" | "approve_plan",
-): void {
-	if (!hooks?.onPlanApproval) return;
-	const approval = parsePlanApprovalFromMessage({ toolName, details });
-	if (approval) hooks.onPlanApproval(approval);
-}
-
-export function createParentHarnessUiBridgeFactory(
-	parentCtx: ExtensionContext,
-	agentType: string,
-	hooks?: ParentHarnessUiHooks,
-): ((pi: ExtensionAPI) => void) | null {
-	if (!agentTypeAllowsParentHarnessUi(agentType)) {
-		return null;
-	}
-	return (pi: ExtensionAPI) => {
-		pi.registerTool({
-			name: "ask_user",
-			label: "Ask User",
-			description:
-				"Ask the user a structured question (parent session UI). Use for clarification — not final plan approval (use approve_plan).",
-			promptSnippet: ASK_PROMPT_SNIPPET,
-			promptGuidelines: ASK_PROMPT_GUIDELINES,
-			parameters: AskUserParamsSchema,
-			async execute(_toolCallId, params, _signal, _onUpdate) {
-				const validated = validateAskParams(params as AskUserParams);
-				if (typeof validated === "string") {
-					return {
-						content: [{ type: "text", text: validated }],
-						details: {
-							question: params.question ?? "",
-							options: [],
-							response: null,
-							cancelled: true,
-						},
-					};
-				}
-				let outcome: DialogResult;
-				if (parentCtx.hasUI) {
-					outcome = await runAskDialog(parentCtx.ui, validated);
-				} else {
-					outcome = await runAskFallback(parentCtx.ui, validated);
-				}
-				const details = toToolDetails(
-					validated,
-					outcome.response,
-					outcome.cancelled,
-				);
-				notifyPlanApproval(hooks, details, "ask_user");
-				const text = formatResultText(outcome.response, outcome.cancelled);
-				return {
-					content: [{ type: "text", text }],
-					details,
-				};
-			},
-			renderCall(args, theme) {
-				return renderAskCall(args, theme);
-			},
-			renderResult(result, options, theme) {
-				return renderAskResult(result, options, theme);
-			},
-		});
-
-		if (agentType !== PLANNER_ONLY_AGENT) {
-			return;
-		}
-
-		pi.registerTool({
-			name: "approve_plan",
-			label: "Approve Plan",
-			description:
-				"Present the full PlanPacket for user approval in the parent TUI (scrollable overlay).",
-			promptSnippet: PLAN_PROMPT_SNIPPET,
-			promptGuidelines: PLAN_PROMPT_GUIDELINES,
-			parameters: ApprovePlanParamsSchema,
-			async execute(_toolCallId, params, _signal, _onUpdate) {
-				const validated = validateApprovePlanParams(
-					params as ApprovePlanParams,
-				);
-				if (typeof validated === "string") {
-					return {
-						content: [{ type: "text", text: validated }],
-						details: {
-							plan_packet: (params as ApprovePlanParams).plan_packet ?? {},
-							options: [],
-							response: null,
-							cancelled: true,
-						},
-					};
-				}
-
-				hooks?.appendPlanDraft?.({
-					plan_packet: validated.plan_packet,
-					human_summary: validated.human_summary,
-				});
-
-				let outcome: DialogResult;
-				if (parentCtx.hasUI) {
-					outcome = await runPlanApprovalDialog(parentCtx.ui, validated, {
-						onMounted: () => {
-							pi.events.emit("plan-approval:mounted", {});
-						},
-					});
-				} else {
-					outcome = await runPlanApprovalFallback(parentCtx.ui, validated);
-				}
-				const details = toApprovePlanToolDetails(
-					validated,
-					outcome.response,
-					outcome.cancelled,
-				);
-				notifyPlanApproval(hooks, details, "approve_plan");
-				const text = formatApprovePlanResultText(
-					outcome.response,
-					outcome.cancelled,
-				);
-				return {
-					content: [{ type: "text", text }],
-					details,
-				};
-			},
-			renderCall(args, theme) {
-				return renderApprovePlanCall(args, theme);
-			},
-			renderResult(result, options, theme) {
-				return renderApprovePlanResult(result, options, theme);
-			},
-		});
-
-		pi.registerTool({
-			name: "create_plan",
-			label: "Create Plan",
-			description:
-				"Write the approved PlanPacket to the canonical plan-packet.json for this harness run. Requires approve_plan Approve first. Do not use write/edit.",
-			promptSnippet: CREATE_PLAN_SNIPPET,
-			promptGuidelines: CREATE_PLAN_GUIDELINES,
-			parameters: CreatePlanParamsSchema,
-			async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
-				const validated = validateApprovePlanParams(
-					params as ApprovePlanParams,
-				);
-				if (typeof validated === "string") {
-					return {
-						content: [{ type: "text", text: validated }],
-						details: { error: validated },
-					};
-				}
-				const projectRoot = hooks?.projectRoot ?? parentCtx.cwd;
-				const parentEntries = hooks?.getParentEntries?.() ?? [];
-				const subEntries = ctx.sessionManager.getEntries();
-				const result = await executeCreatePlan(validated.plan_packet, {
-					projectRoot,
-					getParentEntries: () => parentEntries,
-					getSubagentEntries: () => subEntries,
-					getParentRunContext: () => hooks?.getParentRunContext?.() ?? null,
-					onCommitted: (runCtx, packet, planPath) => {
-						hooks?.onPlanCommitted?.(runCtx, packet, planPath);
-					},
-				});
-				const text = formatCreatePlanResultText(result);
-				return {
-					content: [{ type: "text", text }],
-					details: result.ok
-						? {
-								plan_path: result.planPath,
-								plan_id: result.planId,
-							}
-						: { error: result.error },
-					isError: !result.ok,
-				};
-			},
-			renderCall(args, theme) {
-				const packet = (args as { plan_packet?: PlanPacketLike }).plan_packet;
-				const id = packet?.plan_id ?? "?";
-				return new Text(theme.fg("accent", `create_plan: ${id}`), 0, 0);
-			},
-			renderResult(result, _options, theme) {
-				const details = result.details as
-					| { plan_path?: string; error?: string }
-					| undefined;
-				if (details?.error) {
-					return new Text(
-						theme.fg("error", details.error ?? "create_plan failed"),
-						0,
-						0,
-					);
-				}
-				return new Text(
-					theme.fg(
-						"success",
-						`Wrote ${details?.plan_path ?? "plan-packet.json"}`,
-					),
-					0,
-					0,
-				);
-			},
-		});
-	};
-}
-
-/** @deprecated Use createParentHarnessUiBridgeFactory */
-export function createParentAskUserBridgeFactory(
-	parentCtx: ExtensionContext,
-	agentType: string,
-	hooks?: ParentHarnessUiHooks,
-): ((pi: ExtensionAPI) => void) | null {
-	return createParentHarnessUiBridgeFactory(parentCtx, agentType, hooks);
-}

package/.pi/extensions/lib/harness-subagents/parent-harness-ui-hooks.ts

@@ -1,59 +0,0 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import {
-	appendPlanApprovalIfNew,
-	getLatestRunContext,
-	type HarnessRunContext,
-	nowIso,
-	type PlanUserApproval,
-	planPacketSummary,
-} from "../../../lib/harness-run-context.js";
-import type { ParentHarnessUiHooks } from "./parent-harness-ui-bridge.js";
-
-function persistRunContext(pi: ExtensionAPI, runCtx: HarnessRunContext): void {
-	pi.appendEntry("harness-run-context", runCtx);
-}
-
-export function createParentHarnessUiHooks(
-	pi: ExtensionAPI,
-	getParentEntries: () => unknown[],
-	projectRoot: string,
-): ParentHarnessUiHooks {
-	return {
-		projectRoot,
-		getParentEntries,
-		getParentRunContext: () => getLatestRunContext(getParentEntries()),
-		appendPlanDraft: (draft) => {
-			const planId = String(draft.plan_packet.plan_id ?? "plan");
-			const summary =
-				draft.human_summary?.trim() || `Plan ${planId} — pending your approval`;
-			pi.sendMessage({
-				customType: "harness-plan-draft",
-				content: summary,
-				display: true,
-				details: {
-					schema_version: "1.0.0",
-					plan_packet: draft.plan_packet,
-					human_summary: draft.human_summary ?? null,
-					shown_at: nowIso(),
-				},
-			});
-		},
-		onPlanApproval: (approval: PlanUserApproval) => {
-			const entries = getParentEntries();
-			const runCtx = getLatestRunContext(entries);
-			appendPlanApprovalIfNew(
-				(type, data) => pi.appendEntry(type, data),
-				entries,
-				approval,
-				runCtx,
-			);
-		},
-		onPlanCommitted: (runCtx, packet, planPath) => {
-			persistRunContext(pi, runCtx);
-			pi.appendEntry(
-				"harness-plan-packet",
-				planPacketSummary(packet, planPath, "ready"),
-			);
-		},
-	};
-}

package/.pi/extensions/lib/harness-subagents/types-blackboard.ts

@@ -1,27 +0,0 @@
-/**
- * Blackboard types (ported from subagent-v2 reference; MIT design reference).
- */
-
-export interface PostMetadata {
-	summary?: string;
-	category?: string;
-	supersedes?: string;
-}
-
-export interface BlackboardEntry {
-	key: string;
-	value: unknown;
-	agentId: string;
-	agentName: string;
-	timestamp: number;
-	metadata?: PostMetadata;
-}
-
-export interface BlackboardQuery {
-	keys?: string[];
-	pattern?: string | RegExp;
-	agentId?: string;
-	agentName?: string;
-	category?: string;
-	after?: number;
-}