ultimate-pi 0.11.0 → 0.13.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,137 +0,0 @@
-/**
- * Registers ask_user in subagent sessions, delegating UI to the parent harness session.
- */
-
-import type {
-	ExtensionAPI,
-	ExtensionContext,
-} from "@earendil-works/pi-coding-agent";
-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";
-
-const HARNESS_UI_AGENT_TYPES = new Set([
-	"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;
-}
-
-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). Plan approval uses approve_plan on the parent orchestrator only.",
-			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);
-			},
-		});
-	};
-}
-
-/** @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,77 +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 { writePlanReviewMarkdown } from "../plan-approval/plan-review.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`;
-			const runCtx = getLatestRunContext(getParentEntries());
-			void writePlanReviewMarkdown(projectRoot, runCtx, draft.plan_packet, {
-				human_summary: draft.human_summary,
-				status: "draft",
-			}).then((reviewPath) => {
-				if (!reviewPath) return;
-				pi.sendMessage({
-					customType: "harness-plan-review-path",
-					content: `Editor review: ${reviewPath}`,
-					display: true,
-					details: {
-						schema_version: "1.0.0",
-						plan_review_path: reviewPath,
-						plan_id: planId,
-					},
-				});
-			});
-			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;
-}