pi-harness-runtime 1.1.190 → 1.1.192

package/packages/notification/src/adapters/telegram-adapter.ts

@@ -69,17 +69,28 @@ return this._botUsername;
 			const response = await fetch(
 				`https://api.telegram.org/bot${cfg.botToken}/getMe`,
 			);
-			if (!response.ok) return false;
+			if (!response.ok) {
+				console.warn(`[TelegramAdapter] getMe failed: HTTP ${response.status}`);
+				return false;
+			}
 			const data = (await response.json()) as { ok: boolean; result?: { username?: string } };
-			if (data.ok && data.result?.username) {
-				this._botUsername = data.result.username;
+			if (!data.ok || !data.result?.username) {
+				console.warn(`[TelegramAdapter] getMe returned ok=false`);
+				return false;
 			}
+
+			this._botUsername = data.result.username;
+			this.markHealthy(); // Mark as healthy after successful getMe
+			console.log(`[TelegramAdapter] Bot @${this._botUsername} verified successfully`);
+
 			// Start polling for callback queries if handler is registered
 			if (this._callbackHandler) {
 				this.startPolling();
 			}
-			return data.ok;
-		} catch {
+
+			return true;
+		} catch (err) {
+			console.error(`[TelegramAdapter] Initialize failed:`, err);
 			return false;
 		}
 	}

package/packages/notification/src/base-adapter.ts

@@ -28,9 +28,17 @@ export interface ChannelAdapter {
 	 * Check if the adapter is properly configured
 	 */
 	isConfigured(): boolean;
+
+	/**
+	 * Check if the adapter is healthy (initialized and working)
+	 * Returns true if initialized successfully, false otherwise
+	 */
+	isHealthy(): boolean;
 }
 
-export abstract class BaseChannelAdapter implements ChannelAdapter {
+	export abstract class BaseChannelAdapter implements ChannelAdapter {
+	protected _healthy = false;
+
 	abstract readonly id: string;
 	abstract readonly type: string;
 
@@ -43,6 +51,20 @@ export abstract class BaseChannelAdapter implements ChannelAdapter {
 		return this.config.enabled;
 	}
 
+	/**
+	 * Default health check - subclasses should override for actual health verification
+	 */
+	isHealthy(): boolean {
+		return this._healthy;
+	}
+
+	/**
+	 * Mark adapter as healthy (called after successful initialize)
+	 */
+	protected markHealthy(): void {
+		this._healthy = true;
+	}
+
 	/**
 	 * Redact sensitive data from payload before sending
 	 */

package/packages/notification/src/conversation-bridge.ts

@@ -0,0 +1,385 @@
+/**
+ * Telegram Conversation Bridge
+ *
+ * Sends assistant responses and tool activity to Telegram.
+ * Hooks into Pi lifecycle events to capture:
+ * - message_end: Final assistant responses
+ * - agent_end: When agent finishes a turn
+ * - agent_settled: When agent fully settles
+ *
+ * Features:
+ * - Deduplication across events
+ * - Safe formatting
+ * - Delivery status tracking
+ */
+
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import type { NotificationCenter } from "./notification-center.js";
+import type { NotificationPayload } from "./types.js";
+
+/**
+ * Configuration for the conversation bridge
+ */
+export interface ConversationBridgeConfig {
+	/** Whether to send assistant final responses */
+	sendAssistantResponses: boolean;
+	/** Whether to send tool summaries */
+	sendToolSummaries: boolean;
+	/** Max message length before chunking */
+	maxMessageLength: number;
+	/** Minimum confidence to send a message */
+	minConfidence: number;
+}
+
+/**
+ * Pending message to prevent duplicate sends
+ */
+interface PendingMessage {
+	messageId: string;
+	content: string;
+	timestamp: number;
+	events: Set<string>; // Events that triggered this message
+}
+
+/**
+ * Conversation Bridge
+ *
+ * Bridges Pi conversation events to Telegram notifications.
+ */
+export class ConversationBridge {
+	private pi: ExtensionAPI;
+	private center: NotificationCenter;
+	private config: ConversationBridgeConfig;
+	private pendingMessages: Map<string, PendingMessage> = new Map();
+	private deliveredMessageIds: Set<string> = new Set();
+	private sessionStartTime: number = Date.now();
+	private lastMessageId: string | null = null;
+
+	constructor(
+		pi: ExtensionAPI,
+		center: NotificationCenter,
+		config: Partial<ConversationBridgeConfig> = {},
+	) {
+		this.pi = pi;
+		this.center = center;
+		this.config = {
+			sendAssistantResponses: true,
+			sendToolSummaries: true,
+			maxMessageLength: 4000,
+			minConfidence: 0.5,
+			...config,
+		};
+	}
+
+	/**
+	 * Register all lifecycle hooks
+	 */
+	register(): void {
+		console.log("[ConversationBridge] Registering lifecycle hooks...");
+
+		// Session start - reset state
+		this.pi.on("session_start", () => {
+			this.reset();
+			console.log("[ConversationBridge] Session started");
+		});
+
+		// Session compact - flush pending messages
+		this.pi.on("session_compact", (event) => {
+			console.log(
+				`[ConversationBridge] Compaction: ${event.reason} (willRetry=${event.willRetry})`,
+			);
+			this.flushPendingMessages();
+		});
+
+		// Session shutdown - cleanup
+		this.pi.on("session_shutdown", () => {
+			console.log("[ConversationBridge] Session shutting down");
+			this.flushPendingMessages();
+			this.stop();
+		});
+
+		// Message start - track new message
+		this.pi.on("message_start", (event) => {
+			const msg = event.message as { id?: string; role?: string };
+			if (msg?.role === "assistant" && msg?.id) {
+				this.lastMessageId = msg.id;
+			}
+		});
+
+		// Message end - capture final assistant response
+		this.pi.on("message_end", (event) => {
+			const msg = event.message as { id?: string; role?: string; content?: unknown };
+			if (msg?.role !== "assistant") return;
+
+			const content = this.extractMessageContent(msg);
+			if (!content || content.length < 10) return; // Skip empty/too short
+
+			const messageId = msg.id ?? `msg-${Date.now()}`;
+
+			// Deduplicate
+			if (this.deliveredMessageIds.has(messageId)) {
+				console.log(`[ConversationBridge] Skipping duplicate: ${messageId}`);
+				return;
+			}
+
+			// Check if already pending
+			let pending = this.pendingMessages.get(messageId);
+			if (!pending) {
+				pending = {
+					messageId,
+					content,
+					timestamp: Date.now(),
+					events: new Set(),
+				};
+				this.pendingMessages.set(messageId, pending);
+			}
+			pending.events.add("message_end");
+
+			console.log(
+				`[ConversationBridge] Assistant message captured: ${messageId.substring(0, 20)}...`,
+			);
+		});
+
+		// Tool execution end - capture tool summaries
+		if (this.config.sendToolSummaries) {
+			this.pi.on("tool_execution_end", (event) => {
+				const summary = this.formatToolSummary(event);
+				if (summary) {
+					this.sendToolSummary(summary);
+				}
+			});
+		}
+
+		// Agent settled - finalize and send pending messages
+		this.pi.on("agent_settled", () => {
+			console.log("[ConversationBridge] Agent settled, finalizing messages...");
+			this.finalizePendingMessages();
+		});
+
+		console.log("[ConversationBridge] Lifecycle hooks registered");
+	}
+
+	/**
+	 * Extract text content from a message
+	 */
+	private extractMessageContent(
+		msg: { content?: unknown },
+	): string | null {
+		if (!msg.content) return null;
+
+		// Array of content parts
+		if (Array.isArray(msg.content)) {
+			const texts: string[] = [];
+			for (const part of msg.content) {
+				if (
+					part &&
+					typeof part === "object" &&
+					"type" in part &&
+					part.type === "text" &&
+					"text" in part
+				) {
+					texts.push(String(part.text));
+				}
+			}
+			return texts.join("\n\n");
+		}
+
+		// Simple string
+		if (typeof msg.content === "string") {
+			return msg.content;
+		}
+
+		return null;
+	}
+
+	/**
+	 * Format a tool execution summary
+	 */
+	private formatToolSummary(event: {
+		toolName: string;
+		result?: unknown;
+		isError: boolean;
+	}): string {
+		const status = event.isError ? "FAILED" : "DONE";
+		const resultPreview = this.truncate(
+			JSON.stringify(event.result ?? ""),
+			100,
+		);
+		return `[Tool] ${event.toolName}: ${status}${resultPreview ? ` - ${resultPreview}` : ""}`;
+	}
+
+	/**
+	 * Send a tool summary to Telegram
+	 */
+	private async sendToolSummary(summary: string): Promise<void> {
+		if (!this.center.hasHealthyChannels()) return;
+
+		const payload: NotificationPayload = {
+			event: "CodexSessionStarted", // Reusing existing event
+			jobId: `tool-${Date.now()}`,
+			timestamp: new Date().toISOString(),
+			title: "Tool Executed",
+			message: summary,
+		};
+
+		try {
+			const results = await this.center.notify("CodexSessionStarted", {
+				jobId: payload.jobId,
+				requirement: payload.message,
+			});
+
+			for (const result of results) {
+				if (result.success) {
+					console.log(`[ConversationBridge] Tool summary sent`);
+				} else {
+					console.warn(`[ConversationBridge] Tool summary failed: ${result.error}`);
+				}
+			}
+		} catch (err) {
+			console.error("[ConversationBridge] Failed to send tool summary:", err);
+		}
+	}
+
+	/**
+	 * Finalize and send pending messages (called on agent_settled)
+	 */
+	private async finalizePendingMessages(): Promise<void> {
+		for (const [messageId, pending] of this.pendingMessages) {
+			if (this.deliveredMessageIds.has(messageId)) continue;
+
+			// Send the message
+			await this.sendAssistantResponse(pending.content, messageId);
+			this.deliveredMessageIds.add(messageId);
+			this.pendingMessages.delete(messageId);
+		}
+	}
+
+	/**
+	 * Flush pending messages without sending (on compaction)
+	 */
+	private flushPendingMessages(): void {
+		console.log(
+			`[ConversationBridge] Flushing ${this.pendingMessages.size} pending messages`,
+		);
+		this.pendingMessages.clear();
+	}
+
+	/**
+	 * Send an assistant response to Telegram
+	 */
+	private async sendAssistantResponse(
+		content: string,
+		messageId: string,
+	): Promise<void> {
+		if (!this.center.hasHealthyChannels()) {
+			console.log("[ConversationBridge] No healthy channels, skipping");
+			return;
+		}
+
+		// Chunk if too long
+		const chunks = this.chunkMessage(content);
+
+		for (let i = 0; i < chunks.length; i++) {
+			const chunk = chunks[i];
+			const chunkSuffix = chunks.length > 1 ? ` [${i + 1}/${chunks.length}]` : "";
+
+			const payload: NotificationPayload = {
+				event: "CodexSessionStarted", // Reusing event type
+				jobId: `msg-${messageId}`,
+				timestamp: new Date().toISOString(),
+				title: "Assistant Response",
+				message: chunk + chunkSuffix,
+			};
+
+			try {
+				const results = await this.center.notify("CodexSessionStarted", {
+					jobId: payload.jobId,
+					requirement: payload.message,
+				});
+
+				for (const result of results) {
+					if (result.success) {
+						console.log(
+							`[ConversationBridge] Response chunk ${i + 1}/${chunks.length} sent`,
+						);
+					} else {
+						console.warn(
+							`[ConversationBridge] Response chunk failed: ${result.error}`,
+						);
+					}
+				}
+			} catch (err) {
+				console.error("[ConversationBridge] Failed to send response:", err);
+			}
+		}
+	}
+
+	/**
+	 * Chunk a message into smaller parts
+	 */
+	private chunkMessage(message: string): string[] {
+		if (message.length <= this.config.maxMessageLength) {
+			return [message];
+		}
+
+		const chunks: string[] = [];
+		const sentences = message.match(/[^.!?]+[.!?]+/g) || [message];
+		let currentChunk = "";
+
+		for (const sentence of sentences) {
+			if ((currentChunk + sentence).length > this.config.maxMessageLength) {
+				if (currentChunk) {
+					chunks.push(currentChunk.trim());
+				}
+				currentChunk = sentence;
+			} else {
+				currentChunk += sentence;
+			}
+		}
+
+		if (currentChunk) {
+			chunks.push(currentChunk.trim());
+		}
+
+		return chunks;
+	}
+
+	/**
+	 * Truncate a string
+	 */
+	private truncate(str: string, maxLen: number): string {
+		if (str.length <= maxLen) return str;
+		return str.substring(0, maxLen - 3) + "...";
+	}
+
+	/**
+	 * Reset state for new session
+	 */
+	private reset(): void {
+		this.pendingMessages.clear();
+		this.deliveredMessageIds.clear();
+		this.lastMessageId = null;
+		this.sessionStartTime = Date.now();
+	}
+
+	/**
+	 * Stop the bridge (cleanup)
+	 */
+	stop(): void {
+		console.log("[ConversationBridge] Stopped");
+		// Cleanup will happen on shutdown
+	}
+}
+
+/**
+ * Create and register a conversation bridge
+ */
+export function createConversationBridge(
+	pi: ExtensionAPI,
+	center: NotificationCenter,
+	config?: Partial<ConversationBridgeConfig>,
+): ConversationBridge {
+	const bridge = new ConversationBridge(pi, center, config);
+	bridge.register();
+	return bridge;
+}

package/packages/notification/src/index.ts

@@ -22,3 +22,7 @@ export {
 	filterTelegramContent,
 	getSafeNotificationLog,
 } from "./telegram-content-filter.js";
+export {
+	ConversationBridge,
+	createConversationBridge,
+} from "./conversation-bridge.js";

package/packages/notification/src/notification-center.ts

@@ -235,6 +235,19 @@ export class NotificationCenter {
 		return this.adapters.size > 0;
 	}
 
+	/**
+	 * Check if any adapter is healthy (initialized and working)
+	 * Unlike hasChannels(), this verifies actual health, not just config
+	 */
+	hasHealthyChannels(): boolean {
+		for (const [, adapter] of this.adapters) {
+			if (adapter.isHealthy()) {
+				return true;
+			}
+		}
+		return false;
+	}
+
 	/**
 	 * List all configured channels
 	 */

package/packages/observability/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/observability",
-  "version": "1.1.190",
+  "version": "1.1.192",
   "description": "Comprehensive observability system with structured logging, tracing, metrics, and alerting",
   "type": "module",
   "main": "./dist/index.js",

package/packages/okf-indexer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/okf-indexer",
-  "version": "1.1.190",
+  "version": "1.1.192",
   "description": "OKF document indexer for SKILL.md files (RFC-0106)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/paperclip-integration/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/paperclip-integration",
-  "version": "1.1.190",
+  "version": "1.1.192",
   "description": "Paperclip API integration: poll agent inbox, route tasks to pi.dev, Telegram alerts",
   "type": "module",
   "main": "./dist/index.js",

package/packages/performance-optimizer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/performance-optimizer",
-  "version": "1.1.190",
+  "version": "1.1.192",
   "description": "Performance optimization analyzer for pi-harness runtime (RFC-0056)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/privilege-broker/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/privilege-broker",
-  "version": "1.1.190",
+  "version": "1.1.192",
   "description": "Privilege Broker — capability registry and command executor for autonomous runtime (RFC-0101 §7)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/project-analyzer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/project-analyzer",
-  "version": "1.1.190",
+  "version": "1.1.192",
   "description": "Project analysis system for pi-harness-runtime - detects frameworks, rules, and project structure",
   "type": "module",
   "main": "./dist/index.js",

package/packages/project-bootstrap/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/project-bootstrap",
-  "version": "1.1.190",
+  "version": "1.1.192",
   "description": "Project scaffolding from typed ProjectSpec",
   "type": "module",
   "main": "./dist/index.js",

package/packages/projection-engine/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/projection-engine",
-  "version": "1.1.190",
+  "version": "1.1.192",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/prompt-compiler/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/prompt-compiler",
-  "version": "1.1.190",
+  "version": "1.1.192",
   "description": "Deterministic prompt compiler for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/prompt-versioning/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/prompt-versioning",
-  "version": "1.1.190",
+  "version": "1.1.192",
   "type": "module",
   "description": "Version control for prompts with rollback support (RFC-0019)",
   "main": "dist/index.js",

package/packages/provider-adapter-sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/provider-adapter-sdk",
-  "version": "1.1.190",
+  "version": "1.1.192",
   "description": "SDK for building, testing, and registering AI provider adapters",
   "type": "module",
   "main": "./dist/index.js",

package/packages/provider-router/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/provider-router",
-  "version": "1.1.190",
+  "version": "1.1.192",
   "description": "Enhanced Provider Router for pi-harness-runtime — intelligent routing with capabilities, costs, and quotas",
   "type": "module",
   "main": "./dist/provider-router.js",

package/packages/provider-selector/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/provider-selector",
-  "version": "1.1.190",
+  "version": "1.1.192",
   "description": "Multi-Provider Selector — route requests by cost, quality, and latency (RFC-0012)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/providers/package.json

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

package/packages/qdrant-skills/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/qdrant-skills",
-  "version": "1.1.190",
+  "version": "1.1.192",
   "description": "Qdrant vector search integration for Hermes-style skill system",
   "type": "module",
   "main": "./dist/index.js",

package/packages/quota-manager/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/quota-manager",
-  "version": "1.1.190",
+  "version": "1.1.192",
   "description": "pi-harness-runtime — quota-manager",
   "type": "module",
   "main": "./dist/index.js",

package/packages/rate-limiter/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/rate-limiter",
-  "version": "1.1.190",
+  "version": "1.1.192",
   "type": "module",
   "description": "Rate limiting with token bucket algorithm (RFC-0023)",
   "main": "dist/index.js",

package/packages/react-vite-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/react-vite-plugin",
-  "version": "1.1.190",
+  "version": "1.1.192",
   "description": "React/Vite framework analysis — components, config, TypeScript setup",
   "type": "module",
   "main": "./dist/index.js",

package/packages/release-manager/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/release-manager",
-  "version": "1.1.190",
+  "version": "1.1.192",
   "type": "module",
   "description": "Release management for pi-harness",
   "main": "dist/index.js",

package/packages/requirement-compiler/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/requirement-compiler",
-  "version": "1.1.190",
+  "version": "1.1.192",
   "description": "Compiles raw requirements into validated CompiledRequirement with ambiguity detection and risk tagging",
   "type": "module",
   "main": "./dist/index.js",

package/packages/runtime/package.json

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