pi-harness-runtime 1.1.379 → 1.1.381

package/index.ts

@@ -54,6 +54,10 @@ import {
 	shouldTriggerProactiveCompact,
 } from "./proactive-compact.ts";
 import { aggregateWindows } from "./windows.ts";
+
+// Relay client for streaming callbacks (t3code-style two-way communication)
+import { RelayClient } from "./packages/relay/src/client.js";
+import type { CallbackPayload } from "./packages/relay/src/types.js";
 import { renderStatus } from "./renderer.ts";
 import {
 	JobStateMachine,
@@ -1449,7 +1453,24 @@ async function initTelegram(pi: ExtensionAPI): Promise<void> {
 		telegram?.setGreetingVerifiedHandler(() => {
 			addHarnessMessage("Telegram", "ready (Hi reply received; two-way verified)", "ok");
 		});
-		pi.on("session_shutdown", () => telegram?.stopPolling());
+
+		// Set adapter for relay streaming (receives callbacks via WebSocket)
+		setRelayTelegramAdapter(telegram);
+
+		pi.on("session_shutdown", () => {
+			telegram?.stopPolling();
+			_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();
 		if (!greeting?.success) {
 			logStartup("[pi-harness] Telegram: startup greeting delivery failed");
@@ -1477,6 +1498,114 @@ async function initTelegram(pi: ExtensionAPI): Promise<void> {
 	}
 }
 
+// ============================================================================
+// --- relay-stream: WebSocket streaming for real-time Telegram callbacks -------
+// ============================================================================
+// Wires RelayClient to the Telegram adapter for two-way streaming communication.
+// When callbacks arrive via WebSocket, they are forwarded to the adapter's
+// handleWebhookUpdate() for proper greeting verification and callback handling.
+
+let _relayTelegramAdapter: any = null;
+let _relayClient: RelayClient | null = null;
+
+/**
+ * Set the Telegram adapter for relay streaming (called from initTelegram)
+ */
+function setRelayTelegramAdapter(adapter: any) {
+	_relayTelegramAdapter = adapter;
+}
+
+/**
+ * Initialize relay streaming for real-time callback delivery.
+ * Connects to the relay WebSocket server and forwards Telegram callbacks
+ * to the adapter for proper greeting verification and handling.
+ */
+async function initRelayStream(): Promise<void> {
+	const homedir = process.env.HOME || process.env.USERPROFILE || "/home/frappe";
+	const keysDir = join(homedir, ".pi-harness-runtime", "keys");
+
+	// Check for relay WebSocket URL
+	const relayWsUrlPath = join(keysDir, "relay-ws-url.txt");
+	const relayTokenPath = join(keysDir, "relay-auth-token.txt");
+
+	if (!existsSync(relayWsUrlPath) || !existsSync(relayTokenPath)) {
+		logToFile("[RelayStream]", "Relay WebSocket URL or token not configured - skipping streaming");
+		return;
+	}
+
+	const relayWsUrl = readFileSync(relayWsUrlPath, "utf-8").trim();
+	const relayToken = readFileSync(relayTokenPath, "utf-8").trim();
+
+	if (!relayWsUrl || !relayToken) {
+		logToFile("[RelayStream]", "Relay URL or token is empty - skipping streaming");
+		return;
+	}
+
+	logToFile("[RelayStream]", `Connecting to relay at ${relayWsUrl}`);
+
+	_relayClient = new RelayClient(
+		{
+			serverUrl: relayWsUrl,
+			token: relayToken,
+		},
+		{
+			onConnected: (sessionId) => {
+				logToFile("[RelayStream]", `Connected to relay, session: ${sessionId}`);
+			},
+			onDisconnected: () => {
+				logToFile("[RelayStream]", "Disconnected from relay");
+			},
+			onSnapshot: (snapshot) => {
+				logToFile("[RelayStream]", `Snapshot: ${snapshot.recentCallbacks.length} recent callbacks`);
+			},
+			onSynchronized: () => {
+				logToFile("[RelayStream]", "Synchronized - receiving live events");
+			},
+			onCallback: async (callback: CallbackPayload) => {
+				logToFile("[RelayStream]", `Callback: ${callback.action} ${callback.targetId}`);
+
+				// Forward Telegram callbacks to the adapter
+				if (callback.type === "telegram_callback" && _relayTelegramAdapter) {
+					// Convert relay callback to Telegram update format
+					const update = {
+						callback_query: {
+							id: callback.callbackQueryId || String(callback.id),
+							from: {
+								id: callback.userId,
+								is_bot: false,
+								first_name: callback.username || "User",
+								username: callback.username,
+							},
+							data: `${callback.action}:${callback.targetId}`,
+							message: {
+								chat: { id: callback.chatId || callback.userId },
+								message_id: callback.messageId || 0,
+							},
+						},
+					};
+
+					try {
+						await _relayTelegramAdapter.handleWebhookUpdate(update);
+						logToFile("[RelayStream]", "Callback processed by Telegram adapter");
+					} catch (err) {
+						logToFile("[RelayStream]", `Adapter error: ${err}`);
+					}
+				}
+			},
+			onError: (error) => {
+				logToFile("[RelayStream]", `Error: ${error.message}`);
+			},
+		}
+	);
+
+	try {
+		await _relayClient.connect();
+		logToFile("[RelayStream]", "Relay stream initialized successfully");
+	} catch (err) {
+		logToFile("[RelayStream]", `Failed to connect: ${err}`);
+	}
+}
+
 // --- honcho-memory: Honcho MCP for peer/user memory via https://mcp.honcho.dev ------
 // Registers Honcho MCP server and implements automatic memory lifecycle:
 // - Ingest sanitized messages on completed turns
@@ -2483,6 +2612,7 @@ function initJobPipeWatcher(pi: ExtensionAPI): void {
 	// Get webhook server URL and API key from config
 	const getWebhookConfig = () => {
 		const webhookUrlPath = join(keysDir, "telegram-webhook-url.txt");
+		const apiUrlPath = join(keysDir, "relay-api-url.txt"); // Separate API base URL
 		const secretPath = join(keysDir, "telegram-webhook-secret.txt");
 
 		if (!existsSync(webhookUrlPath) || !existsSync(secretPath)) {
@@ -2492,11 +2622,25 @@ function initJobPipeWatcher(pi: ExtensionAPI): void {
 		const webhookUrl = readFileSync(webhookUrlPath, "utf-8").trim();
 		const secret = readFileSync(secretPath, "utf-8").trim();
 
+		// Use separate API URL if configured, otherwise extract origin from webhook URL
+		let apiBaseUrl: string;
+		if (existsSync(apiUrlPath)) {
+			apiBaseUrl = readFileSync(apiUrlPath, "utf-8").trim().replace(/\/$/, "");
+		} else {
+			// Extract origin from webhook URL (e.g., https://example.com from https://example.com/telegram)
+			try {
+				const url = new URL(webhookUrl);
+				apiBaseUrl = `${url.protocol}//${url.host}`;
+			} catch {
+				apiBaseUrl = webhookUrl;
+			}
+		}
+
 		if (!webhookUrl || !secret) {
 			return null;
 		}
 
-		return { webhookUrl: webhookUrl.replace(/\/$/, ""), secret };
+		return { webhookUrl: webhookUrl.replace(/\/$/, ""), apiBaseUrl, secret };
 	};
 
 	const processCommand = (cmd: { command: string; jobId: string; userId: number }) => {
@@ -2521,9 +2665,9 @@ function initJobPipeWatcher(pi: ExtensionAPI): void {
 	};
 
 	// Acknowledge processed commands
-	const acknowledgeCommands = async (jobIds: string[], config: { webhookUrl: string; secret: string }) => {
+	const acknowledgeCommands = async (jobIds: string[], config: { webhookUrl: string; apiBaseUrl: string; secret: string }) => {
 		try {
-			await fetch(`${config.webhookUrl}/api/acknowledge-commands`, {
+			await fetch(`${config.apiBaseUrl}/api/acknowledge-commands`, {
 				method: "POST",
 				headers: {
 					"Content-Type": "application/json",
@@ -2543,7 +2687,7 @@ function initJobPipeWatcher(pi: ExtensionAPI): void {
 		}
 
 		try {
-			const response = await fetch(`${config.webhookUrl}/api/pending-commands`, {
+			const response = await fetch(`${config.apiBaseUrl}/api/pending-commands`, {
 				headers: {
 					"Authorization": `Bearer ${config.secret}`,
 				},

package/package.json

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

package/packages/clipboard-plugin/package.json

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

package/packages/code-generation/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/code-generation",
-  "version": "1.1.379",
+  "version": "1.1.381",
   "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.379",
+  "version": "1.1.381",
   "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.379",
+  "version": "1.1.381",
   "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.379",
+  "version": "1.1.381",
   "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.379",
+  "version": "1.1.381",
   "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.379",
+  "version": "1.1.381",
   "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.379",
+  "version": "1.1.381",
   "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.379",
+  "version": "1.1.381",
   "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.379",
+  "version": "1.1.381",
   "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.379",
+  "version": "1.1.381",
   "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.379",
+  "version": "1.1.381",
   "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.379",
+  "version": "1.1.381",
   "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.379",
+  "version": "1.1.381",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/django-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/django-plugin",
-  "version": "1.1.379",
+  "version": "1.1.381",
   "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.379",
+  "version": "1.1.381",
   "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.379",
+  "version": "1.1.381",
   "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.379",
+  "version": "1.1.381",
   "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.379",
+  "version": "1.1.381",
   "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.379",
+  "version": "1.1.381",
   "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.379",
+  "version": "1.1.381",
   "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.379",
+  "version": "1.1.381",
   "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.379",
+  "version": "1.1.381",
   "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.379",
+  "version": "1.1.381",
   "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.379",
+  "version": "1.1.381",
   "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.379",
+  "version": "1.1.381",
   "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.379",
+  "version": "1.1.381",
   "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.379",
+  "version": "1.1.381",
   "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.379",
+  "version": "1.1.381",
   "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.379",
+  "version": "1.1.381",
   "description": "Generic web framework analysis — REST/GraphQL endpoints, OpenAPI, auth",
   "type": "module",
   "main": "./dist/index.js",

package/packages/health-monitor/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/health-monitor",
-  "version": "1.1.379",
+  "version": "1.1.381",
   "type": "module",
   "description": "Health monitoring and auto-healing",
   "main": "dist/index.js",

package/packages/intent-analyzer/package.json

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

package/packages/jev-judge/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/jev-judge",
-  "version": "1.1.379",
+  "version": "1.1.381",
   "description": "Jev Judge - Structured decision model for agent routing, E2E testing, and automated decisions",
   "type": "module",
   "main": "./dist/index.js",

package/packages/knowledge-graph/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/knowledge-graph",
-  "version": "1.1.379",
+  "version": "1.1.381",
   "description": "Knowledge Graph extraction and provenance linking for SKILL.md files",
   "type": "module",
   "main": "./dist/index.js",

package/packages/knowledge-retrieval/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/knowledge-retrieval",
-  "version": "1.1.379",
+  "version": "1.1.381",
   "description": "Knowledge retrieval via TencentDB-Agent-Memory MCP (RFC-0105)",
   "type": "module",
   "main": "./dist/index.js",