pi-harness-runtime 1.1.136 → 1.1.139

package/harness/langchain/daemon.ts

@@ -26,6 +26,7 @@
  * Wiki: wiki/auto-trigger-multi-agent.md
  */
 
+import { execSync } from "node:child_process";
 import { randomUUID } from "node:crypto";
 import {
 	existsSync,
@@ -34,42 +35,34 @@ import {
 	readFileSync,
 	writeFileSync,
 } from "node:fs";
-import { execSync } from "node:child_process";
-import { join } from "node:path";
 import { homedir } from "node:os";
+import { join } from "node:path";
 
 import { LeaseManager } from "../../packages/autonomous-runtime/src/lease.js";
 import type { ApprovalClass } from "../../packages/autonomous-runtime/src/types.js";
 import {
+	type CodexSession,
+	startWatcher,
+	type WatcherHandle,
+} from "../../packages/codex-watcher/dist/src/index.js";
+import { classifyMessage } from "../../packages/codex-watcher/dist/src/parser.js";
+import {
+	createHerdrBus,
 	ensureHerdrWorkspace,
 	getHerdrWorkspace,
 	type HerdrEventBus,
 	type LoopVerdict,
-} from "../../packages/event-bus/src/herdr-bus.js";
-import {
-	createHerdrBus,
 	publishCodeWritten,
 	publishLoopFinished,
 	publishLoopStarted,
 	publishReviewCompleted,
 } from "../../packages/event-bus/src/herdr-bus.js";
 import { NotificationCenter } from "../../packages/notification/dist/notification-center.js";
-
-import {
-	invokeWithSurgeRetry,
-	invokeWithGLMRetry,
-	SurgeScheduler,
-	type SurgePolicy,
-} from "./surge.js";
-import type { LoopWidget } from "./widget.js";
-import { StatusLineManager, isPiLensAvailable } from "./status-line.js";
-import { createLoopCheckpointer } from "./checkpointer.js";
-
 import {
-	getTrajectoryStore,
 	getApprovedPatternStore,
+	getTrajectoryStore,
 } from "../../packages/trajectory/src/index.js";
-
+import { createLoopCheckpointer } from "./checkpointer.js";
 import {
 	buildDryRunDeps,
 	buildRealLoopDeps,
@@ -78,10 +71,19 @@ import {
 	type LoopState,
 	type WriteReviewLoop,
 } from "./graph.js";
+import { submitPingPongIntent } from "./ping-pong-middleware.js";
+import { isPiLensAvailable, StatusLineManager } from "./status-line.js";
+import {
+	invokeWithGLMRetry,
+	invokeWithSurgeRetry,
+	type SurgePolicy,
+	SurgeScheduler,
+} from "./surge.js";
+import type { LoopWidget } from "./widget.js";
 
 // ─── Config ─────────────────────────────────────────────────────────────────
 
-export type TriggerSource = "bd-tasks" | "inbox" | "bus" | "cron";
+export type TriggerSource = "bd-tasks" | "inbox" | "bus" | "cron" | "codex";
 
 export type ApprovalPolicy =
 	| "never" // fully autonomous; notify only on finish/blocked (default)
@@ -556,6 +558,73 @@ class BdTasksWatcher {
  * Drop a JSON file into the right bucket to schedule a task.
  * Set "enabled": false to pause without deleting.
  */
+
+// ─── Codex watcher ──────────────────────────────────────────────────────────
+
+/** Polls ~/.codex/sessions/ for active Codex CLI sessions.
+ *  When Codex emits a plan-type message, emits a TriggeredTask so the daemon
+ *  can qualify it via submitPingPongIntent and run the ping-pong loop.
+ */
+class CodexWatcher {
+	private readonly pollMs: number;
+	private handle: WatcherHandle | null = null;
+	private running = false;
+	private seenMsgs = new Set<string>();
+	private seenSessions = new Set<string>();
+
+	constructor(pollMs: number) {
+		this.pollMs = pollMs;
+	}
+
+	start(onTask: (task: TriggeredTask) => void): void {
+		if (this.running) return;
+		this.running = true;
+
+		this.handle = startWatcher({
+			pollIntervalMs: this.pollMs,
+			onMessages: (msgs) => {
+				// Get current session from handle for deduplication key
+				const session = this.handle?.latestSession();
+				const sessionId = session?.id ?? "unknown";
+
+				for (const msg of msgs) {
+					// Deduplicate by ordinal — Codex rewrites the last line on each turn
+					const msgKey = `${sessionId}:${msg.ordinal}`;
+					if (this.seenMsgs.has(msgKey)) continue;
+					this.seenMsgs.add(msgKey);
+
+					// Only emit plan-type messages
+					const classification = classifyMessage(msg.text);
+					if (classification !== "plan") continue;
+					if (!msg.text.trim()) continue;
+
+					const taskId = `codex-${sessionId}-${msg.ordinal}`;
+					onTask({
+						taskId,
+						request: msg.text.trim(),
+						source: "codex",
+						triggeredAt: msg.timestamp,
+					});
+				}
+			},
+			onSessionChange: (session: CodexSession | null) => {
+				if (!session) return;
+				if (this.seenSessions.has(session.id)) return;
+				this.seenSessions.add(session.id);
+				console.log(
+					`[codex-watcher] Session started: ${session.id} — "${session.threadName}"`,
+				);
+			},
+		});
+	}
+
+	stop(): void {
+		this.running = false;
+		this.handle?.stop();
+		this.handle = null;
+	}
+}
+
 class CronWatcher {
 	private readonly workspace: string;
 	private readonly scheduleMs: Record<string, number>;
@@ -814,6 +883,7 @@ export class LoopDaemon {
 	private readonly inboxWatcher: InboxWatcher;
 	private readonly busWatcher: BusWatcher;
 	private readonly bdWatcher: BdTasksWatcher;
+	private readonly codexWatcher: CodexWatcher | null;
 	private readonly cronWatcher: CronWatcher | null;
 	private readonly tunnelMonitor: TunnelMonitor | null;
 	private readonly statusLine: StatusLineManager | null;
@@ -858,9 +928,11 @@ export class LoopDaemon {
 
 		if (this.config.notificationConfig) {
 			this.notificationCenter = new NotificationCenter({
-				channels: this._buildChannels(this.config.notificationConfig) as Parameters<
-					typeof NotificationCenter.prototype.notify
-				>[0] extends { channels: infer C }
+				channels: this._buildChannels(
+					this.config.notificationConfig,
+				) as Parameters<typeof NotificationCenter.prototype.notify>[0] extends {
+					channels: infer C;
+				}
 					? C
 					: never,
 				enabled: true,
@@ -873,6 +945,9 @@ export class LoopDaemon {
 		this.widget = this.config.widget ?? null;
 		this.busWatcher = new BusWatcher(this.bus, this.config.pollMs);
 		this.bdWatcher = new BdTasksWatcher(this.config.pollMs);
+		this.codexWatcher = this.config.sources.includes("codex")
+			? new CodexWatcher(this.config.pollMs)
+			: null;
 		this.cronWatcher = this.config.sources.includes("cron")
 			? new CronWatcher(this.bus.getWorkspace())
 			: null;
@@ -920,6 +995,11 @@ export class LoopDaemon {
 			this.bdWatcher.start((t) => this._onTriggered(t));
 		}
 
+		if (this.config.sources.includes("codex")) {
+			console.log(`[daemon] Starting Codex CLI session watcher`);
+			this.codexWatcher?.start((t) => this._onTriggered(t));
+		}
+
 		this.tunnelMonitor?.start();
 		this.statusLine?.start();
 
@@ -934,6 +1014,7 @@ export class LoopDaemon {
 		this.inboxWatcher.stop();
 		this.busWatcher.stop();
 		this.bdWatcher.stop();
+		this.codexWatcher?.stop();
 		this.cronWatcher?.stop();
 		this.statusLine?.stop();
 		this.tunnelMonitor?.stop();
@@ -961,6 +1042,23 @@ export class LoopDaemon {
 	private _onTriggered(task: TriggeredTask): void {
 		if (this.stopped) return;
 
+		// ── Codex source: qualify via ping-pong middleware ──────────────────
+		if (task.source === "codex") {
+			const result = submitPingPongIntent(task.request, {
+				actorId: this.agentId,
+			});
+			console.log(
+				`[daemon] Ping-pong decision for [codex] ${task.taskId}: ${result.decision.decision} ` +
+					`(score=${result.decision.score.toFixed(1)}, ` +
+					`reasons=${result.decision.reasons.slice(0, 2).join("; ")}...)`,
+			);
+			console.log(`[daemon]   blackboard: ${result.blackboardFile}`);
+			console.log(`[daemon]   audit:      ${result.auditFile}`);
+			if (result.enqueued) {
+				console.log(`[daemon]   enqueued:   ${result.taskFile}`);
+			}
+		}
+
 		// Skip if already running this task
 		if (this.running.has(task.taskId)) {
 			console.log(
@@ -1014,7 +1112,9 @@ export class LoopDaemon {
 			// ── Gate check (I7) ──────────────────────────────────────────────
 			const policy = effectivePolicy(task, this.config);
 			if (policy === "always" || policy === "on_blocked") {
-				log(`Gate policy=${policy} — waiting for human approval before starting`);
+				log(
+					`Gate policy=${policy} — waiting for human approval before starting`,
+				);
 				const approved = await waitForAck(
 					task,
 					this.config,
@@ -1079,7 +1179,9 @@ export class LoopDaemon {
 				}
 				return undefined; // default MemorySaver
 			})();
-			const loop: WriteReviewLoop = buildWriteReviewLoop(deps, { checkpointer });
+			const loop: WriteReviewLoop = buildWriteReviewLoop(deps, {
+				checkpointer,
+			});
 
 			// Persistent scheduler: attempt counter survives across multiple loop.invoke()
 			// calls within the same task. This enables true exponential escalation
@@ -1211,7 +1313,8 @@ export class LoopDaemon {
 						? "reviewer blocked the task"
 						: iterations >= this.config.maxIterations
 							? `max iterations (${iterations}) reached with changes still requested`
-							: comments.length > 0 && comments.every((c) => c.severity === "minor")
+							: comments.length > 0 &&
+									comments.every((c) => c.severity === "minor")
 								? `converged: only minor comments (${comments.length})`
 								: `stuck: changes still requested after ${iterations} iteration(s)`;
 

package/harness/langchain/run.ts

@@ -180,7 +180,7 @@ async function runDaemon(args: CliArgs): Promise<void> {
 	const daemon = new LoopDaemon({
 		maxIterations: args.maxIterations,
 		dryRun: args.dryRun,
-		sources: ["inbox", "bus"],
+		sources: ["inbox", "bus", "codex"],
 	});
 
 	// Graceful shutdown on SIGTERM / SIGINT

package/index.ts

@@ -244,7 +244,6 @@ async function initQdrant(): Promise<void> {
 
 // --- telegram-notifications: Telegram bot for harness event notifications ------------
 // Sends Telegram messages when jobs complete, tasks finish, or human input is needed.
-let _notificationCenter: unknown = null;
 async function initTelegram(): Promise<void> {
 	try {
 		const { NotificationCenter } = await import("./packages/notification/dist/index.js");
@@ -290,7 +289,7 @@ async function initTelegram(): Promise<void> {
 			return;
 		}
 
-		_notificationCenter = center;
+		// NotificationCenter ready
 		logStartup(`[pi-harness] Telegram notifications ready`);
 	} catch (err) {
 		logStartup("[pi-harness] Telegram: init failed:", err instanceof Error ? err.message : String(err));
@@ -2354,6 +2353,59 @@ Run \`bd ready\` to see current bd issues.
 
 	// --- Footer status (persistent badge) --------------------------------
 	pi.on("session_start", async (_event, ctx) => {
+		// ── Auto-start LangChain loop daemon ───────────────────────────────────
+		// Spawns `bun harness/langchain/run.ts --daemon` as a detached background
+		// process if no daemon is currently running.  The daemon watches:
+		//   inbox/   → manual task files dropped by the user
+		//   bus/     → task.proposed events (herdr event bus)
+		//   codex/   → Codex CLI session plans (PING-PONG Planner)
+		// Detached pattern: spawn with detached:true + stdio:ignore + unref() so
+		// the extension process can exit without killing the daemon.
+		// PID file at ~/.pi-harness-runtime/daemon.pid prevents double-start.
+		//
+		// SAFETY: fire-and-forget IIFE with try/catch.  Throwing from this handler
+		// crashes pi.dev and kicks the user out. NEVER let exceptions escape.
+		void (async () => {
+			try {
+				const { readFileSync: dfs, writeFileSync: wfs, unlinkSync: ufs } = await import("node:fs");
+				const { spawn: spwn } = await import("node:child_process");
+				const { dirname } = await import("node:path");
+				const { fileURLToPath } = await import("node:url");
+				const { freemem } = await import("node:os");
+				const runtimeRoot = dirname(fileURLToPath(import.meta.url));
+				const DAEMON_PID_FILE = `${process.env.HOME}/.pi-harness-runtime/daemon.pid`;
+				const DAEMON_SCRIPT = `${runtimeRoot}/harness/langchain/run.ts`;
+
+				// Memory guard: skip if system has < 1 GB free (daemon can spike to 500 MB+)
+				const FREE_RAM_MB = freemem() / (1024 * 1024);
+				const MIN_FREE_MB = 1024;
+				if (FREE_RAM_MB < MIN_FREE_MB) {
+					console.error(`[pi-harness] Daemon skipped: only ${FREE_RAM_MB.toFixed(0)} MB RAM free (need ${MIN_FREE_MB} MB). Run /langchain manually.`);
+					return;
+				}
+
+				let daemonPid = 0;
+				try { daemonPid = parseInt(dfs(DAEMON_PID_FILE, "utf8").trim(), 10); } catch { /* no PID file */ }
+				if (daemonPid > 0) {
+					try { process.kill(daemonPid, 0); /* alive? */ } catch {
+						try { ufs(DAEMON_PID_FILE); } catch { /* ignore */ }
+						daemonPid = 0;
+					}
+				}
+				if (daemonPid > 0) {
+					console.error(`[pi-harness] LangChain daemon already running (pid=${daemonPid})`);
+					return;
+				}
+				const daemonProc = spwn("bun", ["run", DAEMON_SCRIPT, "--daemon"], { detached: true, stdio: "ignore" });
+				daemonProc.unref();
+				try { wfs(DAEMON_PID_FILE, String(daemonProc.pid), "utf8"); } catch { /* ignore */ }
+				console.error(`[pi-harness] LangChain daemon started (pid=${daemonProc.pid})`);
+			} catch (err) {
+				// MUST NOT throw — throwing here crashes pi.dev and kicks the user out
+				console.error("[pi-harness] Daemon spawn failed (non-fatal):", err instanceof Error ? err.message : String(err));
+			}
+		})();
+
 		// Capture only the setStatus function, not the ctx
 		footerSetStatus = ctx.ui.setStatus.bind(ctx.ui);
 		refreshFooterStatus(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-harness-runtime",
-  "version": "1.1.136",
+  "version": "1.1.139",
   "description": "[BETA] Codex-style /usage status + autonomous coding harness for pi. Not production ready — expect breaking changes.",
   "type": "module",
   "scripts": {

package/packages/a2a-adapter/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/a2a-adapter",
-  "version": "1.1.136",
+  "version": "1.1.139",
   "type": "module",
   "description": "Google Agent-to-Agent (A2A) protocol adapter for pi-harness",
   "main": "dist/index.js",

package/packages/architecture-generator/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/architecture-generator",
-  "version": "1.1.136",
+  "version": "1.1.139",
   "description": "Generate ADR and Mermaid diagrams from project analysis",
   "type": "module",
   "main": "./dist/index.js",

package/packages/auth/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/auth",
-  "version": "1.1.136",
+  "version": "1.1.139",
   "description": "pi-harness-runtime — auth",
   "type": "module",
   "main": "./dist/index.js",

package/packages/autonomous-refactor/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/autonomous-refactor",
-  "version": "1.1.136",
+  "version": "1.1.139",
   "type": "module",
   "description": "Autonomous refactoring engine",
   "main": "dist/index.js",

package/packages/autonomous-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/autonomous-runtime",
-  "version": "1.1.136",
+  "version": "1.1.139",
   "description": "Autonomous Operations Runtime — task inbox, lease management, and worker lifecycle (RFC-0101)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/cache-strategy/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/cache-strategy",
-  "version": "1.1.136",
+  "version": "1.1.139",
   "type": "module",
   "description": "Smart caching with TTL and invalidation strategies (RFC-0022)",
   "main": "dist/index.js",

package/packages/capability-registry/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/capability-registry",
-  "version": "1.1.136",
+  "version": "1.1.139",
   "description": "Capability Registry for pi-harness-runtime — tracks model capabilities and enables capability-based routing",
   "type": "module",
   "main": "./dist/index.js",

package/packages/checkpoint/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/checkpoint",
-  "version": "1.1.136",
+  "version": "1.1.139",
   "description": "Enhanced checkpoint system with incremental snapshots, diff-based storage, and recovery strategies",
   "type": "module",
   "main": "./dist/index.js",

package/packages/cli-plugin-sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/cli-plugin-sdk",
-  "version": "1.1.136",
+  "version": "1.1.139",
   "type": "module",
   "description": "CLI Plugin SDK for pi-harness — install, list, remove, update, invoke plugins",
   "main": "dist/index.js",

package/packages/clipboard/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/clipboard",
-  "version": "1.1.136",
+  "version": "1.1.139",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/clipboard-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/clipboard-plugin",
-  "version": "1.1.136",
+  "version": "1.1.139",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/code-generation/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/code-generation",
-  "version": "1.1.136",
+  "version": "1.1.139",
   "description": "Code generation pipeline for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/code-review/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/code-review",
-  "version": "1.1.136",
+  "version": "1.1.139",
   "description": "Automated code review engine for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/codex-adapter/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/codex-adapter",
-  "version": "1.1.136",
+  "version": "1.1.139",
   "type": "module",
   "description": "OpenAI Codex provider adapter for pi-harness",
   "main": "dist/index.js",

package/packages/codex-watcher/dist/src/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Codex Session Watcher — Main API
+ *
+ * Watches the active Codex CLI session and emits visible messages (user + assistant)
+ * so the harness PING-PONG middleware can feed them to pi.dev.
+ *
+ * Usage:
+ *   import { startWatcher, getLatestSession, getVisibleMessages } from "@pi-harness/codex-watcher";
+ *
+ *   // One-shot: get latest messages from the current session
+ *   const session = getLatestSession();
+ *   const messages = await getVisibleMessages(session.rolloutPath, { fromOrdinal: 0 });
+ *
+ *   // Continuous: poll the active session and emit messages
+ *   const handle = startWatcher({
+ *     onMessages: (msgs) => console.log(msgs),
+ *   });
+ *   // later: handle.stop();
+ */
+import { classifyMessage } from "./parser.js";
+import { getAllSessions, getLatestSession } from "./session.js";
+import type { CodexMessage, CodexSession, WatcherHandle, WatcherOptions } from "./types.js";
+export type { CodexMessage, CodexSession, WatcherHandle, WatcherOptions };
+export { classifyMessage, getAllSessions, getLatestSession };
+/** Read all visible messages from a rollout file, starting from a given ordinal. */
+export declare function getVisibleMessages(rolloutPath: string, options?: {
+    fromOrdinal?: number;
+    limit?: number;
+}): Promise<CodexMessage[]>;
+/**
+ * Start watching the active Codex session and call `onMessages` whenever
+ * new visible messages appear in the rollout file.
+ *
+ * @returns WatcherHandle — call handle.stop() to stop watching
+ *
+ * The watcher:
+ * 1. Polls session_index.jsonl to detect active session changes
+ * 2. Tracks file position so it only reads new lines (no re-read of full file)
+ * 3. Calls onMessages with incremental messages each poll cycle
+ */
+export declare function startWatcher(options?: WatcherOptions): WatcherHandle;
+//# sourceMappingURL=index.d.ts.map

package/packages/codex-watcher/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,OAAO,EAAE,eAAe,EAAoB,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,KAAK,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,cAAc,EACd,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAC;AAM7D,oFAAoF;AACpF,wBAAsB,kBAAkB,CACvC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GACpD,OAAO,CAAC,YAAY,EAAE,CAAC,CAkBzB;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,cAAmB,GAAG,aAAa,CA6JxE"}