pi-harness-runtime 1.1.381 → 1.1.383

package/index.ts

@@ -660,6 +660,9 @@ async function initAutoContinue(pi: ExtensionAPI): Promise<void> {
 
 		// Clean up controller on session shutdown
 		pi.on("session_shutdown", () => {
+			// Release the guard timer and the queue: a stopped session must not
+			// keep a timer alive nor block a later continuation.
+			todoContinuationController?.dispose?.();
 			todoContinuationController = null;
 		});
 
@@ -830,6 +833,12 @@ async function initAutoContinue(pi: ExtensionAPI): Promise<void> {
 
 		// --- agent_settled: Check todos and continue work ---------------
 		pi.on("agent_settled", async (_event, ctx) => {
+			// The turn that a previous continuation triggered has now settled:
+			// release the dispatch guard so the next decision can dispatch again.
+			// Keeping it set would block every later dispatch while still
+			// consuming the retry budget.
+			todoContinuationController?.releaseContinuationGuard?.("agent_settled");
+
 			// Don't continue if user is waiting for response
 			if (waitingForUserSince) {
 				todoContinuationController?.clearQueue();
@@ -857,8 +866,19 @@ async function initAutoContinue(pi: ExtensionAPI): Promise<void> {
 
 				if (result.action === "continue" && result.nextItemId) {
 					updateAutoContinueStatus("CONTINUING");
-					await todoContinuationController.steerToContinue(result.nextItemId);
-					// Queue remains set while agent processes, cleared on agent_end
+					const steer = await todoContinuationController.steerToContinue(result.nextItemId);
+					if (!steer?.dispatched) {
+						// Surface an explicit stall reason instead of silently doing nothing
+						logToFile(
+							"[auto-continue]",
+							"Continuation not dispatched:",
+							steer?.reason ?? "unknown reason",
+							`(attempts=${steer?.attempts ?? 0}, blocked=${steer?.blockedDispatches ?? 0})`,
+						);
+						updateAutoContinueStatus("IDLE");
+					}
+					// Guard stays set while the agent processes the continuation and is
+					// released by releaseContinuationGuard() on the next agent_settled.
 				} else {
 					// Not continuing - clear queue to allow future decisions
 					todoContinuationController.clearQueue();
@@ -1242,7 +1262,11 @@ async function initTelegram(pi: ExtensionAPI): Promise<void> {
 				enabled: true,
 				config: { channelAccessToken: lineAccessToken, userId: lineUserId },
 			});
-			addHarnessMessage("LINE", "configured and enabled", "ok");
+			addHarnessMessage("LINE", "configured and enabled (tap Toggle LINE to disable)", "ok");
+		} else {
+			addHarnessMessage("LINE", "not configured", "warn", [
+				"Configure LINE in ~/.pi-harness-runtime/keys/",
+			]);
 		}
 
 		// eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -1451,7 +1475,7 @@ async function initTelegram(pi: ExtensionAPI): Promise<void> {
 		const botUsername = center.getTelegramBotUsername();
 		const telegram = center.getTelegramAdapter();
 		telegram?.setGreetingVerifiedHandler(() => {
-			addHarnessMessage("Telegram", "ready (Hi reply received; two-way verified)", "ok");
+			addHarnessMessage("Telegram", "ready (tap Toggle Telegram to disable)", "ok");
 		});
 
 		// Set adapter for relay streaming (receives callbacks via WebSocket)
@@ -1462,18 +1486,14 @@ async function initTelegram(pi: ExtensionAPI): Promise<void> {
 			_relayClient?.disconnect();
 		});
 
-		// Check if webhook mode is configured
-		const homedir2 = process.env.HOME || process.env.USERPROFILE || "/home/frappe";
-		const webhookUrlPath = join(homedir2, ".pi-harness-runtime", "keys", "telegram-webhook-url.txt");
-		const _hasWebhook = existsSync(webhookUrlPath);
-
 		// Initialize relay streaming (receives callbacks via WebSocket)
 		// In webhook mode, streaming delivers callbacks in real-time
 		await initRelayStream();
 
 		const greeting = await telegram?.sendStartupGreeting();
+		logStartup(`[pi-harness] Telegram greeting result: ${JSON.stringify(greeting)}`);
 		if (!greeting?.success) {
-			logStartup("[pi-harness] Telegram: startup greeting delivery failed");
+			logStartup("[pi-harness] Telegram: startup greeting delivery failed - see logs");
 			addHarnessMessage("Telegram", "bot verified; Hi delivery failed", "err", [
 				"Open your bot in Telegram and press Start; unblock it if necessary.",
 				"Verify telegram-chat-id.txt in ~/.pi-harness-runtime/keys/ and network access, then reload Pi.",
@@ -1482,7 +1502,7 @@ async function initTelegram(pi: ExtensionAPI): Promise<void> {
 		}
 		telegram?.startPolling();
 		if (!telegram?.isGreetingVerified()) {
-			addHarnessMessage("Telegram", "Hi sent; tap Say Hi back to verify inbound", "wait");
+			addHarnessMessage("Telegram", "Hi sent; tap Say Hi to verify inbound (tap Toggle Telegram to disable)", "wait");
 		}
 		if (botUsername) {
 			logStartup(`[pi-harness] Telegram (@${botUsername}) ready — DM the bot to receive alerts`);
@@ -1547,6 +1567,9 @@ async function initRelayStream(): Promise<void> {
 		{
 			serverUrl: relayWsUrl,
 			token: relayToken,
+			// Keep retrying in the background: the relay server may not be up
+			// yet when the harness starts.
+			retryOnConnectFailure: true,
 		},
 		{
 			onConnected: (sessionId) => {
@@ -3664,6 +3687,49 @@ Run \`bd ready\` to see current bd issues.
 	// Store only the setStatus function, NOT the ctx itself.
 	// Storing ctx causes stale-context errors after pi reload/restart.
 	let footerSetStatus: ((key: string, value: string) => void) | null = null;
+	// The custom footer needs live session data (cwd, model, usage, context).
+	// The ctx is stored here as well, but the footer guards every access and
+	// keeps the last known values when the ctx has gone stale, so a replaced
+	// session can never break the rendering.
+	let latestFooterCtx: ExtensionContext | null = null;
+	let harnessFooterEnabled = true;
+
+	/**
+	 * Install the harness footer.
+	 *
+	 * Pi's built-in footer renders ALL `setStatus()` values on ONE shared line,
+	 * so the quota and the workspace environment summary used to be appended to
+	 * each other (and the workspace summary was truncated away on narrow
+	 * terminals). The harness footer gives the workspace summary its own row
+	 * while keeping Pi's footer information (cwd/branch, token stats, cost,
+	 * context usage, model/thinking state, other extensions' statuses).
+	 *
+	 * This function never rejects: every access to the (possibly stale) ctx is
+	 * guarded and failures are logged.
+	 */
+	async function installHarnessFooter(ctx: ExtensionContext): Promise<void> {
+		try {
+			if (!harnessFooterEnabled) return;
+			// A stale ctx throws on property access - read it defensively.
+			let mode: string | undefined;
+			try {
+				mode = ctx.mode;
+			} catch {
+				mode = undefined;
+			}
+			if (mode !== "tui") return;
+			const { createHarnessFooter } = await import(
+				"./packages/tui/src/harness-footer.js"
+			);
+			ctx.ui.setFooter((tui, theme, footerData) =>
+				createHarnessFooter(tui, theme, footerData, {
+					getContext: () => latestFooterCtx,
+				}),
+			);
+		} catch (e) {
+			logToFile("[pi-harness] harness footer install failed:", String(e));
+		}
+	}
 	let quotaAutoFetchInFlight = false;
 	let proactiveCompactInFlight = false;
 	let lastProactiveCompactAt = 0;
@@ -4577,6 +4643,49 @@ Run \`bd ready\` to see current bd issues.
 		},
 	});
 
+	// --- /harness-footer — Toggle harness custom footer vs built-in Pi footer ----
+	pi.registerCommand("harness-footer", {
+		description: "Toggle or restore footer: /harness-footer [harness|builtin]",
+		handler: async (args: string, ctx: ExtensionCommandContext) => {
+			// A stale ctx throws on property access - read it defensively.
+			let ctxMode: string | undefined;
+			try {
+				ctxMode = ctx.mode;
+			} catch {
+				ctxMode = undefined;
+			}
+			if (ctxMode !== "tui") {
+				ctx.ui.notify("Footer control is only available in TUI mode.", "info");
+				return;
+			}
+
+			const mode = args.trim().toLowerCase();
+			if (mode === "builtin" || mode === "pi") {
+				harnessFooterEnabled = false;
+				ctx.ui.setFooter(undefined);
+				ctx.ui.notify(
+					"Built-in Pi footer restored. The workspace summary shares the status line again.",
+					"info",
+				);
+			} else if (mode === "harness" || mode === "") {
+				harnessFooterEnabled = true;
+				latestFooterCtx = ctx;
+				await installHarnessFooter(ctx);
+				ctx.ui.notify(
+					"Harness custom footer installed. The workspace summary has its own row.",
+					"info",
+				);
+			} else {
+				ctx.ui.notify(
+					"Usage: /harness-footer [harness|builtin]\n" +
+					"  harness  — install the Harness footer (workspace summary on its own row)\n" +
+					"  builtin  — restore Pi's built-in footer",
+					"info",
+				);
+			}
+		},
+	});
+
 	// --- Harness widget state (like Todos extension) -----------------------
 	// Learn from Todos extension:
 	// - setWidget with placement: "aboveEditor" (fixed above input)
@@ -4652,6 +4761,7 @@ Run \`bd ready\` to see current bd issues.
 
 		// Capture only the setStatus function, not the ctx
 		footerSetStatus = ctx.ui.setStatus.bind(ctx.ui);
+		latestFooterCtx = ctx;
 		refreshFooterStatus(
 			footerSetStatus,
 			tracker,
@@ -4660,6 +4770,9 @@ Run \`bd ready\` to see current bd issues.
 			() => lastActiveProvider,
 		);
 
+		// Give the workspace environment summary its own footer row
+		void installHarnessFooter(ctx);
+
 		// Increment session generation to fence late callbacks
 		sessionGeneration++;
 		const mySession = sessionGeneration;
@@ -4722,6 +4835,7 @@ Run \`bd ready\` to see current bd issues.
 		noteActiveProvider(ctx.model?.id ?? null);
 		// Capture only the setStatus function, not the ctx
 		footerSetStatus = ctx.ui.setStatus.bind(ctx.ui);
+		latestFooterCtx = ctx;
 		refreshFooterStatus(
 			footerSetStatus,
 			tracker,
@@ -4751,6 +4865,7 @@ Run \`bd ready\` to see current bd issues.
 	pi.on("session_compact", async (event, ctx) => {
 		// Capture only the setStatus function, not the ctx
 		footerSetStatus = ctx.ui.setStatus.bind(ctx.ui);
+		latestFooterCtx = ctx;
 		proactiveCompactInFlight = false;
 		lastProactiveCompactAt = Date.now();
 		consecutiveCompactFailures = 0;
@@ -4931,13 +5046,18 @@ function refreshFooterStatus(
 		statusValue,
 	);
 
-	// Set workspace environment on separate row below quota
+	// The workspace environment summary is published under its own status key.
+	// Pi renders every status value on ONE shared line, so the harness footer
+	// (see installHarnessFooter) renders it on a dedicated row instead.
 	setWorkspaceEnvStatus(setStatus);
 }
 
 /**
  * Set workspace environment status line
- * This appears on a NEW LINE below the quota line
+ *
+ * Published under the `harness-workspace` status key. The harness footer
+ * renders it on its own row (Pi's built-in footer joins all status values
+ * into a single line).
  */
 async function setWorkspaceEnvStatus(setStatus: (key: string, value: string) => void) {
 	try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-harness-runtime",
-  "version": "1.1.381",
+  "version": "1.1.383",
   "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.381",
+  "version": "1.1.383",
   "type": "module",
   "description": "Google Agent-to-Agent (A2A) protocol adapter for pi-harness",
   "main": "dist/index.js",

package/packages/agent-policy/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/agent-policy",
-  "version": "1.1.381",
+  "version": "1.1.383",
   "description": "Agent policy runtime for pi-harness - enforces mandatory rule delivery and mutation gating",
   "type": "module",
   "main": "./dist/index.js",

package/packages/architecture-generator/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/architecture-generator",
-  "version": "1.1.381",
+  "version": "1.1.383",
   "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.381",
+  "version": "1.1.383",
   "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.381",
+  "version": "1.1.383",
   "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.381",
+  "version": "1.1.383",
   "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.381",
+  "version": "1.1.383",
   "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.381",
+  "version": "1.1.383",
   "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.381",
+  "version": "1.1.383",
   "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.381",
+  "version": "1.1.383",
   "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.381",
+  "version": "1.1.383",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/clipboard-plugin/package.json

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

package/packages/code-generation/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/code-generation",
-  "version": "1.1.381",
+  "version": "1.1.383",
   "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.381",
+  "version": "1.1.383",
   "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.381",
+  "version": "1.1.383",
   "type": "module",
   "description": "OpenAI Codex provider adapter for pi-harness",
   "main": "dist/index.js",

package/packages/codex-watcher/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/codex-watcher",
-  "version": "1.1.381",
+  "version": "1.1.383",
   "description": "Watches Codex CLI sessions and emits visible messages for PING-PONG monitoring",
   "type": "module",
   "main": "./dist/src/index.js",

package/packages/config-capture/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moocoding/config-capture",
-  "version": "1.1.381",
+  "version": "1.1.383",
   "description": "Auto-capture API-fetched configuration values to AGENTS.md",
   "type": "module",
   "main": "src/index.ts",

package/packages/connection-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/connection-runtime",
-  "version": "1.1.381",
+  "version": "1.1.383",
   "type": "module",
   "description": "Connection management with jittered exponential backoff for pi-harness",
   "main": "./dist/index.js",

package/packages/context-compiler/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/context-compiler",
-  "version": "1.1.381",
+  "version": "1.1.383",
   "description": "Bounded context selection engine for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/context-discovery/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/context-discovery",
-  "version": "1.1.381",
+  "version": "1.1.383",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/context-manager/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/context-manager",
-  "version": "1.1.381",
+  "version": "1.1.383",
   "description": "Context Window Manager — prevents model context overflow via compaction and resume prompts (RFC-0010)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/contracts/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/contracts",
-  "version": "1.1.381",
+  "version": "1.1.383",
   "type": "module",
   "description": "RPC schema definitions for pi-harness runtime",
   "main": "./dist/index.js",

package/packages/cookie-sanitizer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/cookie-sanitizer",
-  "version": "1.1.381",
+  "version": "1.1.383",
   "description": "pi-harness-runtime — cookie sanitizer (provider-quota cookie file normaliser)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/cost-optimizer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/cost-optimizer",
-  "version": "1.1.381",
+  "version": "1.1.383",
   "description": "Cost Optimizer for pi-harness-runtime — budget tracking, forecasting, and model selection optimization",
   "type": "module",
   "main": "./dist/index.js",

package/packages/dependency-analyzer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/dependency-analyzer",
-  "version": "1.1.381",
+  "version": "1.1.383",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/django-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/django-plugin",
-  "version": "1.1.381",
+  "version": "1.1.383",
   "description": "Django framework analysis — models, management commands, settings",
   "type": "module",
   "main": "./dist/index.js",

package/packages/doc-generator/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/doc-generator",
-  "version": "1.1.381",
+  "version": "1.1.383",
   "description": "Auto-Doc Generator — generate documentation from source code (RFC-0014)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/durable-review/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moocoding/durable-review",
-  "version": "1.1.381",
+  "version": "1.1.383",
   "description": "SQLite-backed durable reviewer using @earendil-works/pi-durable",
   "type": "module",
   "main": "src/index.ts",

package/packages/e2e-tester/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/e2e-tester",
-  "version": "1.1.381",
+  "version": "1.1.383",
   "description": "WebMCP-powered E2E testing for pi-harness - natural language test scenarios",
   "type": "module",
   "main": "./dist/index.js",

package/packages/evaluation-engine/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/evaluation-engine",
-  "version": "1.1.381",
+  "version": "1.1.383",
   "description": "Evaluation engine for pi-harness runtime (RFC-0057)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/evaluation-runner/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/evaluation-runner",
-  "version": "1.1.381",
+  "version": "1.1.383",
   "type": "module",
   "description": "Framework-agnostic evaluation framework for AI outputs (RFC-0020)",
   "main": "dist/index.js",

package/packages/event-bus/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/event-bus",
-  "version": "1.1.381",
+  "version": "1.1.383",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/event-sink/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/event-sink",
-  "version": "1.1.381",
+  "version": "1.1.383",
   "type": "module",
   "description": "Atomic event sourcing with SQLite transactions for pi-harness",
   "main": "./dist/index.js",

package/packages/event-store/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/event-store",
-  "version": "1.1.381",
+  "version": "1.1.383",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/experience-replay/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/experience-replay",
-  "version": "1.1.381",
+  "version": "1.1.383",
   "description": "Experience replay for debugging and reproducibility (RFC-0059)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/feedback-collector/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/feedback-collector",
-  "version": "1.1.381",
+  "version": "1.1.383",
   "type": "module",
   "description": "Collect and aggregate human/automated feedback (RFC-0021)",
   "main": "dist/index.js",

package/packages/file-copy-helper/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moocoding/file-copy-helper",
-  "version": "1.1.381",
+  "version": "1.1.383",
   "description": "Injects cp/sudo cp rule when user asks to mimic/copy files",
   "type": "module",
   "main": "dist/index.js",

package/packages/framework-detector/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/framework-detector",
-  "version": "1.1.381",
+  "version": "1.1.383",
   "description": "Framework detection system for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

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

@@ -1,6 +1,6 @@
 {
   "name": "@pi/framework-plugin-sdk",
-  "version": "1.1.381",
+  "version": "1.1.383",
   "description": "Framework plugin SDK for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/frappe-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/frappe-plugin",
-  "version": "1.1.381",
+  "version": "1.1.383",
   "description": "Frappe/ERPNext framework analysis — DocTypes, hooks, bench sites, site config",
   "type": "module",
   "main": "./dist/index.js",

package/packages/generic-web-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/generic-web-plugin",
-  "version": "1.1.381",
+  "version": "1.1.383",
   "description": "Generic web framework analysis — REST/GraphQL endpoints, OpenAPI, auth",
   "type": "module",
   "main": "./dist/index.js",