pi-harness-runtime 1.1.342 → 1.1.343

package/README.md

@@ -25,6 +25,15 @@ Give the runtime a requirement. It keeps working, survives interruption, and ret
 pi install npm:pi-harness-runtime
 ```
 
+### Recommended Extensions
+
+This runtime works best with these extensions (auto-installed by pi-harness-runtime):
+
+```bash
+pi install npm:pi-mcp-adapter    # MCP protocol adapter for external tools
+pi install npm:@juicesharp/rpiv-todo  # Task tracking with bd sync
+```
+
 Requires Pi v0.37.3+.
 
 ### Headless Server Setup (herdr clipboard bridge)

package/harness/notification-center.ts

@@ -0,0 +1,363 @@
+/**
+ * Multi-Channel Notification Center
+ * 
+ * Unified notification system supporting Telegram and LINE.
+ * Users can configure which channels to use and toggle them via inline buttons.
+ */
+
+import * as https from "https";
+
+export interface NotificationConfig {
+  telegram?: {
+    botToken: string;
+    chatId: string;
+    enabled: boolean;
+  };
+  line?: {
+    channelAccessToken: string;
+    userId: string;
+    enabled: boolean;
+  };
+}
+
+export interface NotificationEvent {
+  type: string;
+  emoji: string;
+  title: string;
+  message: string;
+  metadata?: Record<string, unknown>;
+}
+
+export interface NotificationButtons {
+  label: string;
+  action: string;
+  style?: "primary" | "secondary" | "danger";
+}
+
+const DEFAULT_CONFIG_FILE = `${process.env.HOME || "/home/frappe"}/.pi-harness-runtime/notification-config.json`;
+
+/**
+ * Load notification configuration
+ */
+function loadConfig(): NotificationConfig {
+  try {
+    const { existsSync, readFileSync } = require("fs");
+    if (existsSync(DEFAULT_CONFIG_FILE)) {
+      return JSON.parse(readFileSync(DEFAULT_CONFIG_FILE, "utf-8"));
+    }
+    } catch (e) {
+      console.error("Failed to save notification config:", e);
+    }
+  return {};
+}
+
+/**
+ * Save notification configuration
+ */
+function saveConfig(config: NotificationConfig): void {
+  try {
+    const { writeFileSync, mkdirSync, existsSync } = require("fs");
+    const dir = DEFAULT_CONFIG_FILE.substring(0, DEFAULT_CONFIG_FILE.lastIndexOf("/"));
+    if (!existsSync(dir)) {
+      mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(DEFAULT_CONFIG_FILE, JSON.stringify(config, null, 2), "utf-8");
+  } catch (e) {
+    console.error("Failed to save notification config:", e);
+  }
+}
+
+/**
+ * Multi-Channel Notification Center
+ */
+export class NotificationCenter {
+  private config: NotificationConfig;
+  
+  constructor(config?: Partial<NotificationConfig>) {
+    this.config = loadConfig();
+    if (config?.telegram) {
+      this.config.telegram = { ...this.config.telegram, ...config.telegram };
+    }
+    if (config?.line) {
+      this.config.line = { ...this.config.line, ...config.line };
+    }
+  }
+
+  /**
+   * Update configuration
+   */
+  updateConfig(updates: Partial<NotificationConfig>): void {
+    this.config = { ...this.config, ...updates };
+    if (updates.telegram) {
+      this.config.telegram = { ...this.config.telegram!, ...updates.telegram };
+    }
+    if (updates.line) {
+      this.config.line = { ...this.config.line!, ...updates.line };
+    }
+    saveConfig(this.config);
+  }
+
+  /**
+   * Get current configuration
+   */
+  getConfig(): NotificationConfig {
+    return { ...this.config };
+  }
+
+  /**
+   * Send notification to all enabled channels
+   */
+  async notify(event: NotificationEvent): Promise<void> {
+    const { telegram, line } = this.config;
+    const promises: Promise<void>[] = [];
+
+    if (telegram?.enabled && telegram.botToken && telegram.chatId) {
+      promises.push(this.sendTelegram(event, telegram.botToken, telegram.chatId));
+    }
+
+    if (line?.enabled && line.channelAccessToken && line.userId) {
+      promises.push(this.sendLINE(event, line.channelAccessToken, line.userId));
+    }
+
+    await Promise.allSettled(promises);
+  }
+
+  /**
+   * Send notification with action buttons
+   */
+  async notifyWithButtons(
+    event: NotificationEvent,
+    buttons: NotificationButtons[]
+  ): Promise<void> {
+    const { telegram, line } = this.config;
+
+    if (telegram?.enabled && telegram.botToken && telegram.chatId) {
+      await this.sendTelegramWithButtons(event, buttons, telegram.botToken, telegram.chatId);
+    }
+
+    if (line?.enabled && line.channelAccessToken && line.userId) {
+      await this.sendLINEWithButtons(event, buttons, line.channelAccessToken, line.userId);
+    }
+  }
+
+  /**
+   * Send to Telegram
+   */
+  private async sendTelegram(
+    event: NotificationEvent,
+    botToken: string,
+    chatId: string
+  ): Promise<void> {
+    const text = `${event.emoji} ${event.title}\n\n${event.message}`;
+    
+    await this.telegramRequest(botToken, "sendMessage", {
+      chat_id: chatId,
+      text,
+      parse_mode: "Markdown",
+    });
+  }
+
+  /**
+   * Send to Telegram with inline buttons
+   */
+  private async sendTelegramWithButtons(
+    event: NotificationEvent,
+    buttons: NotificationButtons[],
+    botToken: string,
+    chatId: string
+  ): Promise<void> {
+    const text = `${event.emoji} ${event.title}\n\n${event.message}`;
+    const inlineButtons = buttons.map((btn) => ({
+      text: btn.label,
+      callback_data: btn.action,
+    }));
+
+    await this.telegramRequest(botToken, "sendMessage", {
+      chat_id: chatId,
+      text,
+      parse_mode: "Markdown",
+      reply_markup: {
+        inline_keyboard: [inlineButtons],
+      },
+    });
+  }
+
+  /**
+   * Telegram API request
+   */
+  private telegramRequest(botToken: string, method: string, body: Record<string, unknown>): Promise<void> {
+    return new Promise((resolve, _reject) => {
+      const data = JSON.stringify(body);
+      const options = {
+        hostname: "api.telegram.org",
+        path: `/bot${botToken}/${method}`,
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "Content-Length": Buffer.byteLength(data),
+        },
+      };
+
+      const req = https.request(options, (res) => {
+        let response = "";
+        res.on("data", (chunk) => (response += chunk));
+        res.on("end", () => {
+          try {
+            const parsed = JSON.parse(response);
+            if (!parsed.ok) {
+              console.error(`Telegram API error: ${parsed.description}`);
+            }
+          } catch (e) {
+            console.error(`JSON parse error: ${e}`);
+          }
+          resolve();
+        });
+      });
+
+      req.on("error", (err: Error) => {
+        console.error(`Telegram API request error: ${err.message}`);
+        resolve();
+      });
+      req.write(data);
+      req.end();
+    });
+  }
+
+  /**
+   * Send to LINE
+   */
+  private async sendLINE(
+    event: NotificationEvent,
+    accessToken: string,
+    userId: string
+  ): Promise<void> {
+    const text = `${event.emoji} ${event.title}\n\n${event.message}`;
+
+    await this.lineRequest(accessToken, "push", {
+      to: userId,
+      messages: [{ type: "text", text }],
+    });
+  }
+
+  /**
+   * Send to LINE with quick reply buttons
+   */
+  private async sendLINEWithButtons(
+    event: NotificationEvent,
+    buttons: NotificationButtons[],
+    accessToken: string,
+    userId: string
+  ): Promise<void> {
+    const text = `${event.emoji} ${event.title}\n\n${event.message}`;
+    
+    const actions = buttons.map((btn) => ({
+      type: "message" as const,
+      label: btn.label,
+      text: btn.action,
+    }));
+
+    await this.lineRequest(accessToken, "push", {
+      to: userId,
+      messages: [
+        { type: "text", text },
+        {
+          type: "text",
+          text: "Quick actions:",
+          quickReply: {
+            items: actions.map((action) => ({
+              type: "action",
+              action,
+            })),
+          },
+        },
+      ],
+    });
+  }
+
+  /**
+   * LINE API request
+   */
+  private lineRequest(accessToken: string, method: string, body: Record<string, unknown>): Promise<void> {
+    return new Promise((resolve, reject) => {
+      const data = JSON.stringify(body);
+      const options = {
+        hostname: "api.line.me",
+        path: `/v2/bot/message/${method}`,
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "Authorization": `Bearer ${accessToken}`,
+          "Content-Length": Buffer.byteLength(data),
+        },
+      };
+
+      const req = https.request(options, (res) => {
+        let response = "";
+        res.on("data", (chunk) => (response += chunk));
+        res.on("end", () => {
+          if (res.statusCode !== 200) {
+            console.error(`LINE API error: ${res.statusCode} ${response}`);
+          }
+          resolve();
+        });
+      });
+
+      req.on("error", reject);
+      req.write(data);
+      req.end();
+    });
+  }
+
+  /**
+   * Toggle Telegram notifications
+   */
+  toggleTelegram(enabled: boolean): void {
+    if (!this.config.telegram) {
+      this.config.telegram = { botToken: "", chatId: "", enabled };
+    } else {
+      this.config.telegram.enabled = enabled;
+    }
+    saveConfig(this.config);
+  }
+
+  /**
+   * Toggle LINE notifications
+   */
+  toggleLINE(enabled: boolean): void {
+    if (!this.config.line) {
+      this.config.line = { channelAccessToken: "", userId: "", enabled };
+    } else {
+      this.config.line.enabled = enabled;
+    }
+    saveConfig(this.config);
+  }
+
+  /**
+   * Check if Telegram is enabled
+   */
+  isTelegramEnabled(): boolean {
+    return this.config.telegram?.enabled ?? false;
+  }
+
+  /**
+   * Check if LINE is enabled
+   */
+  isLINEEnabled(): boolean {
+    return this.config.line?.enabled ?? false;
+  }
+}
+
+// Export singleton
+let center: NotificationCenter | null = null;
+
+export function getNotificationCenter(): NotificationCenter {
+  if (!center) {
+    center = new NotificationCenter();
+  }
+  return center;
+}
+
+export function initNotificationCenter(config?: Partial<NotificationConfig>): NotificationCenter {
+  center = new NotificationCenter(config);
+  return center;
+}

package/index.ts

@@ -1078,16 +1078,17 @@ async function advanceCodexTask(
 async function initTelegram(pi: ExtensionAPI): Promise<void> {
 	addHarnessMessage("Telegram", "initializing", "wait");
 	try {
-		const {
-			NotificationCenter,
-			createConversationBridge,
-		} = await import("./packages/notification/dist/index.js");
+		const notifModule = await import("./packages/notification/dist/index.js");
+		const NotificationCenter = notifModule.NotificationCenter;
+		const createConversationBridge = notifModule.createConversationBridge;
 		const { readFileSync, existsSync } = await import("node:fs");
 		const home = process.env.HOME || process.env.USERPROFILE || "/home/frappe";
 		const keysDir = `${home}/.pi-harness-runtime/keys`;
 
 		const botTokenPath = `${keysDir}/telegram-bot-token.txt`;
 		const chatIdPath = `${keysDir}/telegram-chat-id.txt`;
+		const lineTokenPath = `${keysDir}/line-access-token.txt`;
+		const lineUserIdPath = `${keysDir}/line-user-id.txt`;
 
 		if (!existsSync(botTokenPath) || !existsSync(chatIdPath)) {
 			logStartup("[pi-harness] Telegram (@PiHarnessRuntimeBot) not configured:");
@@ -1107,6 +1108,11 @@ async function initTelegram(pi: ExtensionAPI): Promise<void> {
 		const botToken = readFileSync(botTokenPath, "utf8").trim();
 		const chatId = readFileSync(chatIdPath, "utf8").trim();
 
+		// Load LINE credentials
+		const hasLineCredentials = existsSync(lineTokenPath) && existsSync(lineUserIdPath);
+		const lineAccessToken = hasLineCredentials ? readFileSync(lineTokenPath, "utf8").trim() : null;
+		const lineUserId = hasLineCredentials ? readFileSync(lineUserIdPath, "utf8").trim() : null;
+
 		if (!botToken || !chatId) {
 			logStartup("[pi-harness] Telegram: bot token or chat ID is empty — skipping");
 			addHarnessMessage("Telegram", "bot token or chat ID is empty; notifications unavailable", "warn", [
@@ -1115,16 +1121,35 @@ async function initTelegram(pi: ExtensionAPI): Promise<void> {
 			return;
 		}
 
+		const channels: Array<{
+			id: string;
+			type: string;
+			enabled: boolean;
+			config: Record<string, unknown>;
+		}> = [
+			{
+				id: "telegram",
+				type: "telegram",
+				enabled: true,
+				config: { botToken, chatId },
+			},
+		];
+
+		// Add LINE channel if credentials exist
+		if (hasLineCredentials && lineAccessToken && lineUserId) {
+			channels.push({
+				id: "line",
+				type: "line" as const,
+				enabled: true,
+				config: { channelAccessToken: lineAccessToken, userId: lineUserId },
+			});
+			addHarnessMessage("LINE", "configured and enabled", "ok");
+		}
+
+		// eslint-disable-next-line @typescript-eslint/no-explicit-any
 		const center = new NotificationCenter({
 			enabled: true,
-			channels: [
-				{
-					id: "telegram",
-					type: "telegram",
-					enabled: true,
-					config: { botToken, chatId },
-				},
-			],
+			channels: channels as any,
 		});
 
 		await center.initialize();
@@ -1187,9 +1212,22 @@ async function initTelegram(pi: ExtensionAPI): Promise<void> {
 					(sharedState.todoContinuationController as any)?.explicitPause?.();
 					break;
 				default:
-					logToFile("[TelegramCallback]", `Unknown action: ${parsed.action}`);
-			}
-		});
+					// Check for channel toggle actions
+					if (parsed.action === "toggle_telegram") {
+						const telegramEnabled = (center as any).isChannelEnabled?.("telegram") ?? true;
+						(center as any).setChannelEnabled?.("telegram", !telegramEnabled);
+						logToFile("[TelegramCallback]", `Telegram ${!telegramEnabled ? "enabled" : "disabled"}`);
+						await acknowledge(`Telegram notifications ${!telegramEnabled ? "enabled" : "disabled"}`);
+					} else if (parsed.action === "toggle_line") {
+						const lineEnabled = (center as any).isChannelEnabled?.("line") ?? true;
+						(center as any).setChannelEnabled?.("line", !lineEnabled);
+						logToFile("[TelegramCallback]", `LINE ${!lineEnabled ? "enabled" : "disabled"}`);
+						await acknowledge(`LINE notifications ${!lineEnabled ? "enabled" : "disabled"}`);
+					} else {
+						logToFile("[TelegramCallback]", `Unknown action: ${parsed.action}`);
+					}
+				}
+			});
 
 		// Register message handler to forward Telegram messages to Pi
 		center.setMessageHandler(async (text: string, _chatId: string) => {

package/package.json

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

package/packages/clipboard-plugin/package.json

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

package/packages/code-generation/package.json

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