pi-harness-runtime 0.9.25 → 1.1.0

package/harness/context-window-manager.ts

@@ -22,7 +22,7 @@ import {
 	roughMessagesTokens,
 } from "../packages/token-estimation/src/index.ts";
 
-// ─── Constants ────────────────────────────────────────────────────────────────
+// --- Constants ----------------------------------------------------------------
 
 /** Proactive compact triggers at this many tokens before limit */
 export const AUTOCOMPACT_BUFFER_TOKENS = 13_000;
@@ -36,7 +36,7 @@ export const BLOCKING_THRESHOLD_BUFFER_TOKENS = 20_000;
 /** Maximum consecutive compact failures before circuit breaker */
 export const MAX_CONSECUTIVE_COMPACT_FAILURES = 3;
 
-// ─── Types ──────────────────────────────────────────────────────────────────
+// --- Types ------------------------------------------------------------------
 
 export interface CompactThresholds {
 	/** Trigger proactive compact at this utilization (0.85) */
@@ -60,7 +60,7 @@ export interface TokenEstimate {
 	shouldBlock: boolean;
 }
 
-// ─── Context Window Manager ─────────────────────────────────────────────────
+// --- Context Window Manager -------------------------------------------------
 
 export class ContextWindowManager {
 	private stats: Map<string, ContextWindowStats> = new Map();
@@ -95,7 +95,7 @@ export class ContextWindowManager {
 		}
 	}
 
-	// ─── Public API ───────────────────────────────────────────────────────────
+	// --- Public API -----------------------------------------------------------
 
 	/**
 	 * Update context window stats after a request
@@ -399,7 +399,7 @@ export class ContextWindowManager {
 	}
 }
 
-// ─── Microcompact Helpers ───────────────────────────────────────────────────
+// --- Microcompact Helpers ---------------------------------------------------
 
 /**
  * Microcompact: prune old tool results based on time gap.

package/harness/continue-prompt.ts

@@ -7,7 +7,7 @@
 
 import type { CompactableMessage } from "../packages/types/src/runtime-types.js";
 
-// ─── Types ──────────────────────────────────────────────────────────────────
+// --- Types ------------------------------------------------------------------
 
 export interface ContinueContext {
 	/** Task identifier */
@@ -35,7 +35,7 @@ export interface MinimalContinueContext {
 	recentMessages: CompactableMessage[];
 }
 
-// ─── Continue Prompt Generator ───────────────────────────────────────────────
+// --- Continue Prompt Generator -----------------------------------------------
 
 export class ContinuePromptGenerator {
 	/**
@@ -237,6 +237,6 @@ export class ContinuePromptGenerator {
 	}
 }
 
-// ─── Singleton Instance ──────────────────────────────────────────────────────
+// --- Singleton Instance ------------------------------------------------------
 
 export const continuePromptGenerator = new ContinuePromptGenerator();

package/harness/e2e/minimax-quota-scraper.ts

@@ -387,7 +387,8 @@ export class MiniMaxQuotaScraper {
 		} catch {
 			const msg =
 				"Playwright not installed. Install with: bun add playwright\nThen install browsers: bunx playwright install chromium";
-			if (!this.config.quiet) console.error("[MiniMaxQuotaScraper] " + msg);
+			if (!this.config.quiet)
+				console.error("[DEBUG MiniMaxQuotaScraper] " + msg);
 			throw new Error(msg);
 		}
 
@@ -399,8 +400,7 @@ export class MiniMaxQuotaScraper {
 
 		if (cookies.length === 0) {
 			const dropHint = join(homedir(), ".pi-harness-runtime", "cookies");
-			const msg =
-				`No cookies found.
+			const msg = `No cookies found.
 Drop your platform.minimax.io cookies (Netscape or EditThisCookie JSON) into:
   ${dropHint}
 …or run: bun packages/auth/src/run-minimax-auth.ts auth`;
@@ -550,12 +550,12 @@ MiniMax Quota Scraper Setup Instructions
 3. Use the scraper:
    const scraper = new MiniMaxQuotaScraper();
    const quota = await scraper.scrape();
-   console.log("5h usage:", quota.h5UsedPct, "%");
+   console.log("[DEBUG MiniMaxQuotaScraper] 5h usage:", quota.h5UsedPct, "%");
 `;
 	}
 }
 
-// ─── Quota Manager Integration ───────────────────────────────────────────────
+// --- Quota Manager Integration -----------------------------------------------
 
 /**
  * Quota Manager that periodically fetches MiniMax quota data

package/harness/e2e/openai-quota-scraper.ts

@@ -205,13 +205,14 @@ export class OpenAIQuotaScraper {
 Drop your chatgpt.com cookies (Netscape or EditThisCookie JSON) into:
   ${dropHint}
 Then run: bun run packages/cookie-sanitizer/src/sync.ts`;
-			if (!this.config.quiet) console.error(`[OpenAIQuotaScraper] ${msg}`);
+			if (!this.config.quiet)
+				console.error(`[DEBUG OpenAIQuotaScraper] ${msg}`);
 			throw new Error(msg);
 		}
 
 		// Launch browser
 		if (!this.config.quiet) {
-			console.log("[OpenAIQuotaScraper] Launching browser...");
+			console.log("[DEBUG OpenAIQuotaScraper] Launching browser...");
 		}
 
 		const browser = await chromium.launch({
@@ -259,7 +260,9 @@ Then run: bun run packages/cookie-sanitizer/src/sync.ts`;
 		try {
 			// Navigate to analytics page
 			if (!this.config.quiet) {
-				console.log("[OpenAIQuotaScraper] Navigating to analytics page...");
+				console.log(
+					"[DEBUG OpenAIQuotaScraper] Navigating to analytics page...",
+				);
 			}
 
 			await page.goto(ANALYTICS_URL, {
@@ -282,14 +285,16 @@ Then run: bun run packages/cookie-sanitizer/src/sync.ts`;
 			if (currentUrl.includes("login") || currentUrl.includes("auth")) {
 				const msg =
 					"OpenAI cookies are expired or insufficient. Please re-export cookies from chatgpt.com.";
-				if (!this.config.quiet) console.error("[OpenAIQuotaScraper] " + msg);
+				if (!this.config.quiet)
+					console.error("[DEBUG OpenAIQuotaScraper] " + msg);
 				throw new Error(msg);
 			}
 
 			// Parse the usage data from the captured API response
 			if (!usageData) {
 				const msg = "Failed to capture usage data from API";
-				if (!this.config.quiet) console.error("[OpenAIQuotaScraper] " + msg);
+				if (!this.config.quiet)
+					console.error("[DEBUG OpenAIQuotaScraper] " + msg);
 				throw new Error(msg);
 			}
 
@@ -306,7 +311,7 @@ Then run: bun run packages/cookie-sanitizer/src/sync.ts`;
 
 			if (!this.config.quiet) {
 				console.log(
-					`[OpenAIQuotaScraper] Weekly usage: ${weeklyUsedPct}%, resets in ${weeklyResetsAt}`,
+					`[DEBUG OpenAIQuotaScraper] Weekly usage: ${weeklyUsedPct}%, resets in ${weeklyResetsAt}`,
 				);
 			}
 
@@ -349,7 +354,7 @@ Then run: bun run packages/cookie-sanitizer/src/sync.ts`;
 			if (!response.ok) {
 				if (!this.config.quiet) {
 					console.log(
-						`[OpenAIQuotaScraper] Direct API failed: ${response.status}`,
+						`[DEBUG OpenAIQuotaScraper] Direct API failed: ${response.status}`,
 					);
 				}
 				return null;
@@ -374,7 +379,7 @@ Then run: bun run packages/cookie-sanitizer/src/sync.ts`;
 		} catch (error) {
 			if (!this.config.quiet) {
 				console.warn(
-					"[OpenAIQuotaScraper] Direct API error:",
+					"[DEBUG OpenAIQuotaScraper] Direct API error:",
 					error instanceof Error ? error.message : String(error),
 				);
 			}

package/harness/forked-summarizer.ts

@@ -12,7 +12,7 @@ import type {
 	InvokeResult,
 } from "../packages/types/src/runtime-types.js";
 
-// ─── Types ──────────────────────────────────────────────────────────────────
+// --- Types ------------------------------------------------------------------
 
 export interface SummarizerConfig {
 	/** Model to use for summarization */
@@ -43,7 +43,7 @@ export interface InvokeOptions {
 	systemPrompt?: string;
 }
 
-// ─── Default System Prompt ───────────────────────────────────────────────────
+// --- Default System Prompt ---------------------------------------------------
 
 const DEFAULT_SUMMARY_SYSTEM = `You are a conversation summarizer. Your task is to create concise, accurate summaries that preserve essential context for continuing a conversation.
 
@@ -70,7 +70,7 @@ const DECISIONS_FOCUS = `Focus specifically on:
 4. What constraints or requirements influenced the decisions?
 5. Any lessons learned or trade-offs considered?`;
 
-// ─── Forked Summarizer ──────────────────────────────────────────────────────
+// --- Forked Summarizer ------------------------------------------------------
 
 export class ForkedSummarizer {
 	private readonly config: SummarizerConfig;
@@ -283,7 +283,7 @@ Do not include verbatim tool results — summarize their outcomes instead.`;
 	}
 }
 
-// ─── Convenience Factory ────────────────────────────────────────────────────
+// --- Convenience Factory ----------------------------------------------------
 
 /**
  * Create a ForkedSummarizer with default config

package/harness/herdr-agents.ts

@@ -0,0 +1,91 @@
+/**
+ * Herdr Agent Commands
+ */
+import { existsSync, readdirSync, readFileSync } from "fs";
+import { join } from "path";
+import {
+	createHerdrBus,
+	getHerdrWorkspacePaths,
+	ensureHerdrWorkspace,
+} from "../packages/event-bus/src/herdr-bus.js";
+
+async function startReviewAgent(): Promise<void> {
+	console.log("[herdr:review] Starting review agent...");
+	const bus = createHerdrBus("review-agent");
+	ensureHerdrWorkspace();
+	bus.subscribe("code.written");
+	bus.startPolling(async (payload) => {
+		if (payload.topic === "code.written") {
+			const data = payload.data as { taskId: string; files: string[] };
+			console.log(
+				`[herdr:review] code.written: task=${data.taskId} files=${data.files.length}`,
+			);
+			for (const file of data.files ?? []) {
+				console.log(`[herdr:review] Reviewing: ${file}`);
+			}
+		}
+	});
+	console.log(`[herdr:review] Workspace: ${bus.getWorkspace()}`);
+	await new Promise(() => {});
+}
+
+async function startCodeAgent(): Promise<void> {
+	console.log("[herdr:code] Starting code agent...");
+	const bus = createHerdrBus("code-agent");
+	ensureHerdrWorkspace();
+	bus.subscribe("review.completed");
+	bus.startPolling(async (payload) => {
+		if (payload.topic === "review.completed") {
+			const data = payload.data as {
+				taskId: string;
+				reportFile: string;
+				status: string;
+			};
+			console.log(
+				`[herdr:code] Review done: task=${data.taskId} status=${data.status} report=${data.reportFile}`,
+			);
+		}
+	});
+	console.log(`[herdr:code] Workspace: ${bus.getWorkspace()}`);
+	await new Promise(() => {});
+}
+
+function showStatus(): void {
+	const paths = getHerdrWorkspacePaths();
+	console.log(`Workspace: ${paths.root}`);
+	const evPath = join(paths.root, "events.jsonl");
+	if (existsSync(evPath)) {
+		const lines = readFileSync(evPath, "utf-8")
+			.split("\n")
+			.filter(Boolean)
+			.slice(-10);
+		console.log("Recent events:");
+		for (const line of lines) {
+			try {
+				const { topic, ts } = JSON.parse(line);
+				console.log(`  ${ts} ${topic}`);
+			} catch {
+				/* skip */
+			}
+		}
+	}
+	if (existsSync(paths.subscriptions)) {
+		const agents = readdirSync(paths.subscriptions);
+		console.log(`Active agents: ${agents.join(", ") || "none"}`);
+	}
+}
+
+const [command] = process.argv.slice(2);
+switch (command) {
+	case "review":
+		startReviewAgent().catch(console.error);
+		break;
+	case "code":
+		startCodeAgent().catch(console.error);
+		break;
+	case "status":
+		showStatus();
+		break;
+	default:
+		console.log("Usage: bun harness/herdr-agents.ts <review|code|status>");
+}

package/harness/index.ts

@@ -178,7 +178,7 @@ export type { QuotaStatus, QuotaDisplayConfig } from "./e2e/quota-status.js";
 // Project Detector
 export { ProjectDetector } from "./project-detector/detector.js";
 
-// ─── RFC-0056: Performance Optimizer ────────────────────────────────────────
+// --- RFC-0056: Performance Optimizer ----------------------------------------
 export {
 	PerformanceOptimizer,
 	createPerformanceOptimizer,
@@ -189,7 +189,7 @@ export type {
 	PerformanceRecommendation,
 } from "../packages/performance-optimizer/src/types.js";
 
-// ─── RFC-0057: Evaluation Engine ───────────────────────────────────────────
+// --- RFC-0057: Evaluation Engine -------------------------------------------
 export {
 	EvaluationEngine,
 	createEvaluationEngine,
@@ -200,7 +200,7 @@ export type {
 	EvaluationFinding,
 } from "../packages/evaluation-engine/src/types.js";
 
-// ─── RFC-0058: Learning Engine ─────────────────────────────────────────────
+// --- RFC-0058: Learning Engine ---------------------------------------------
 export {
 	LearningEngine,
 	createLearningEngine,
@@ -210,7 +210,7 @@ export type {
 	LearnedExperience,
 } from "../packages/learning-engine/src/types.js";
 
-// ─── RFC-0059: Experience Replay ──────────────────────────────────────────
+// --- RFC-0059: Experience Replay ------------------------------------------
 export {
 	ExperienceReplay,
 	createExperienceReplay,
@@ -220,7 +220,7 @@ export type {
 	ReplayResult,
 } from "../packages/experience-replay/src/types.js";
 
-// ─── RFC-0060: Memory Engine ───────────────────────────────────────────────
+// --- RFC-0060: Memory Engine -----------------------------------------------
 export {
 	MemoryEngine,
 	createMemoryEngine,

package/harness/loop-code-agent.ts

@@ -0,0 +1,284 @@
+/**
+ * Loop Code Agent (Minimax) — coordinates via blackboard.
+ *
+ * Polls blackboard for nextAction where agentType="code".
+ * Writes code, updates node status, sets nextAction for review-agent.
+ *
+ * Usage:  bun harness/loop-code-agent.ts
+ */
+
+import { readFileSync, writeFileSync, mkdirSync } from "fs";
+import { join } from "path";
+import {
+	createHerdrBus,
+	ensureHerdrWorkspace,
+} from "../packages/event-bus/src/herdr-bus.js";
+import { SharedBlackboard } from "./blackboard.js";
+import type { LoopNextAction, LoopAgentReport } from "./loop-types.js";
+import type { BlackboardRecord } from "../packages/types/src/runtime-types.js";
+
+const AGENT_ID = "code-agent";
+const AGENT_TYPE = "code";
+const POLL_MS = 1000;
+
+async function main(): Promise<void> {
+	console.log(`[${AGENT_ID}] Starting...`);
+	const paths = ensureHerdrWorkspace();
+
+	// Find active loop config
+	const loopId = await findActiveLoop(paths.root);
+	if (!loopId) {
+		console.log(`[${AGENT_ID}] No active loop found. Waiting...`);
+	}
+
+	const rootDir = paths.root;
+	const blackboard = new SharedBlackboard(loopId ?? "no-loop", rootDir);
+	blackboard.load();
+	blackboard.registerAgent(AGENT_ID, "Code Agent", "minimax", "minimax");
+	blackboard.updateAgentStatus(AGENT_ID, "idle");
+	console.log(`[${AGENT_ID}] Registered. Blackboard: ${blackboard.getPath()}`);
+
+	while (true) {
+		await sleep(POLL_MS);
+
+		blackboard.load();
+		const record = blackboard.getRecord();
+		if (!record) continue;
+
+		// Check for early exit
+		const earlyExit = checkEarlyExit(record);
+		if (earlyExit) {
+			console.log(`[${AGENT_ID}] Early exit: ${earlyExit}`);
+			blackboard.updateAgentStatus(AGENT_ID, "idle");
+			break;
+		}
+
+		// Check if this loop is ours (loopId matches)
+		if (record.jobId !== loopId) continue;
+
+		// Check nextAction for code agent
+		const action = parseNextAction(record.nextAction);
+		if (!action || action.agentType !== AGENT_TYPE) continue;
+
+		// Claim the task
+		const locked = blackboard.acquireLock(action.taskId, AGENT_ID);
+		if (!locked) continue;
+
+		blackboard.updateAgentStatus(AGENT_ID, "working", action.taskId);
+		console.log(`[${AGENT_ID}] Claimed: ${action.taskId}`);
+
+		// Do the work
+		const result = await writeCode(action, paths, record.jobId);
+
+		// Update task status
+		updateTaskStatus(blackboard, record, action.taskId, "done", result.files);
+
+		// Set nextAction for review agent
+		const nextTaskId = getNextReviewTask(record, action.iteration);
+		if (nextTaskId) {
+			blackboard.setNextAction(
+				encodeNextAction({
+					taskId: nextTaskId,
+					agentType: "review",
+					iteration: getReviewIteration(nextTaskId),
+					prompt: action.prompt,
+					codeFiles: result.files,
+				}),
+			);
+			console.log(`[${AGENT_ID}] -> nextAction: review ${nextTaskId}`);
+		} else {
+			// No review needed — go to report
+			const writeDone = getNextWriteTask(record, action.iteration);
+			if (writeDone) {
+				blackboard.setNextAction(
+					encodeNextAction({
+						taskId: writeDone,
+						agentType: "code",
+						iteration: getWriteIteration(writeDone),
+						prompt: action.prompt,
+					}),
+				);
+				console.log(`[${AGENT_ID}] -> nextAction: code ${writeDone}`);
+			} else {
+				// All done — go to report
+				blackboard.setNextAction(
+					encodeNextAction({
+						taskId: "report",
+						agentType: "review",
+						iteration: 0,
+					}),
+				);
+				console.log(`[${AGENT_ID}] -> nextAction: report`);
+			}
+		}
+
+		// Release lock and report
+		blackboard.releaseLock(action.taskId, AGENT_ID);
+		blackboard.writeReport({
+			agentId: AGENT_ID,
+			taskId: action.taskId,
+			status: "success",
+			files: result.files,
+		} satisfies LoopAgentReport);
+		blackboard.updateAgentStatus(AGENT_ID, "idle");
+	}
+}
+
+async function writeCode(
+	action: LoopNextAction,
+	paths: { code: string },
+	loopId: string,
+): Promise<{ files: string[] }> {
+	const iteration = action.iteration;
+	const outputDir = join(paths.code, loopId, `iteration-${iteration}`);
+	mkdirSync(outputDir, { recursive: true });
+
+	const codeFile = join(outputDir, `index.ts`);
+	// TODO: Replace with actual Minimax call
+	const code = `// Iteration ${iteration} — ${action.prompt}
+// TODO: Replace with actual Minimax code generation
+export const iteration = ${iteration};
+export const prompt = ${JSON.stringify(action.prompt)};
+`;
+	writeFileSync(codeFile, code);
+	console.log(`[${AGENT_ID}] Wrote: ${codeFile}`);
+	return { files: [codeFile] };
+}
+
+// ─── Helpers ────────────────────────────────────────────────────────────────
+
+async function findActiveLoop(rootDir: string): Promise<string | null> {
+	const { readdirSync, existsSync } = await import("fs");
+	try {
+		const files = readdirSync(rootDir).filter(
+			(f) => f.startsWith("loop-") && f.endsWith(".config.json"),
+		);
+		// Find most recent config that has an active blackboard
+		for (const configFile of files.slice(-1)) {
+			const config = JSON.parse(
+				readFileSync(join(rootDir, configFile), "utf-8"),
+			);
+			const bbPath = join(rootDir, "jobs", config.loopId, "blackboard");
+			if (existsSync(bbPath)) return config.loopId;
+		}
+	} catch {
+		// no loop yet
+	}
+	return null;
+}
+
+function encodeNextAction(action: Partial<LoopNextAction>) {
+	return {
+		taskId: action.taskId,
+		instruction: "LOOP:" + JSON.stringify(action),
+		priority: "high" as const,
+		createdAt: new Date().toISOString(),
+	};
+}
+
+function parseNextAction(nextAction: unknown): LoopNextAction | null {
+	if (!nextAction) return null;
+	const a = nextAction as Record<string, unknown>;
+	if (!a.taskId) return null;
+	if (typeof a.instruction === "string" && a.instruction.startsWith("LOOP:")) {
+		try {
+			return JSON.parse(a.instruction.slice(5)) as LoopNextAction;
+		} catch {
+			return null;
+		}
+	}
+	return null;
+}
+
+function checkEarlyExit(record: BlackboardRecord): string | null {
+	const blocked = Object.values(record.tasks.nodes).find(
+		(n) => n.status === "blocked",
+	);
+	if (blocked) return `blocked at ${blocked.id}`;
+	const approved = Object.values(record.tasks.nodes).find(
+		(n) =>
+			n.status === "done" && (n as { result?: string }).result === "approved",
+	);
+	if (approved) return "approved";
+	return null;
+}
+
+function updateTaskStatus(
+	blackboard: SharedBlackboard,
+	record: BlackboardRecord,
+	taskId: string,
+	status: "done" | "running" | "blocked",
+	files?: string[],
+): void {
+	if (record.tasks.nodes[taskId]) {
+		(
+			record.tasks.nodes[taskId] as unknown as {
+				status: string;
+				result?: string;
+			}
+		).status = status;
+		if (files)
+			(record.tasks.nodes[taskId] as unknown as { result?: string }).result =
+				files.join(", ");
+		(
+			record.tasks.nodes[taskId] as unknown as { updatedAt?: string }
+		).updatedAt = new Date().toISOString();
+		blackboard.save();
+	}
+}
+
+function getNextReviewTask(
+	record: BlackboardRecord,
+	writeIteration: number,
+): string | null {
+	const reviewCount = Object.keys(record.tasks.nodes).filter((id) =>
+		id.startsWith("review-"),
+	).length;
+	const step = Math.max(
+		1,
+		Math.floor(
+			Object.keys(record.tasks.nodes).filter((id) => id.startsWith("write-"))
+				.length / (reviewCount || 1),
+		),
+	);
+	const targetReview = Math.ceil(writeIteration / step);
+	const taskId = `review-${targetReview}`;
+	if (
+		record.tasks.nodes[taskId] &&
+		record.tasks.nodes[taskId].status === "pending"
+	) {
+		return taskId;
+	}
+	return null;
+}
+
+function getNextWriteTask(
+	record: BlackboardRecord,
+	currentIteration: number,
+): string | null {
+	const nextWrite = currentIteration + 1;
+	const taskId = `write-${nextWrite}`;
+	if (
+		record.tasks.nodes[taskId] &&
+		record.tasks.nodes[taskId].status === "pending"
+	) {
+		return taskId;
+	}
+	return null;
+}
+
+function getReviewIteration(taskId: string): number {
+	const m = taskId.match(/^review-(\d+)$/);
+	return m ? parseInt(m[1], 10) : 0;
+}
+
+function getWriteIteration(taskId: string): number {
+	const m = taskId.match(/^write-(\d+)$/);
+	return m ? parseInt(m[1], 10) : 0;
+}
+
+function sleep(ms: number): Promise<void> {
+	return new Promise((r) => setTimeout(r, ms));
+}
+
+main().catch(console.error);