pi-harness-runtime 1.1.375 → 1.1.377

package/packages/relay/src/types.ts

@@ -1,7 +1,13 @@
 /**
- * Relay Types
+ * Relay Types - Two-way Streaming Communication
  */
 
+import { randomUUID } from "node:crypto";
+
+// ============================================================================
+// Connection Types
+// ============================================================================
+
 export interface RelayConfig {
   /** Relay server URL */
   serverUrl: string;
@@ -30,6 +36,173 @@ export interface RelayTunnel {
   error?: string;
 }
 
+// ============================================================================
+// WebSocket Connection State Machine
+// ============================================================================
+
+export type ConnectionState =
+  | { state: 'disconnected' }
+  | { state: 'connecting' }
+  | { state: 'authenticating' }
+  | { state: 'connected'; sessionId: string }
+  | { state: 'reconnecting'; attempt: number }
+  | { state: 'error'; error: string };
+
+export interface ConnectionStateChange {
+  previous: ConnectionState;
+  current: ConnectionState;
+  timestamp: string;
+}
+
+// ============================================================================
+// Typed Streaming Protocol
+// ============================================================================
+
+/**
+ * Protocol version for typed streaming
+ */
+export const PROTOCOL_VERSION = 1;
+
+/**
+ * Generate a unique message ID
+ */
+export function generateMessageId(): string {
+  return randomUUID();
+}
+
+/**
+ * Create a timestamp
+ */
+export function createTimestamp(): string {
+  return new Date().toISOString();
+}
+
+/**
+ * Base message interface
+ */
+export interface BaseMessage<T extends string, P = unknown> {
+  version: typeof PROTOCOL_VERSION;
+  type: T;
+  payload: P;
+  timestamp: string;
+  messageId?: string;
+}
+
+/**
+ * Server -> Client: Initial state snapshot sent on connect
+ */
+export interface SnapshotMessage extends BaseMessage<'snapshot'> {
+  payload: {
+    sessionId: string;
+    serverVersion: string;
+    connectedClients: number;
+    recentCallbacks: CallbackPayload[];
+  };
+}
+
+/**
+ * Server -> Client: Synchronization marker (indicates all initial state sent)
+ */
+export interface SynchronizedMessage extends BaseMessage<'synchronized'> {}
+
+/**
+ * Callback types from Telegram/LINE
+ */
+export interface CallbackPayload {
+  id: string;
+  type: 'telegram_callback' | 'line_callback';
+  action: string;
+  targetId: string;
+  userId: number;
+  username?: string;
+  messageId?: number;
+  timestamp: string;
+}
+
+/**
+ * Server -> Client: Live callback event (after synchronized)
+ */
+export interface CallbackMessage extends BaseMessage<'callback'> {
+  payload: CallbackPayload;
+}
+
+/**
+ * Server -> Client: Status update
+ */
+export type StatusKind = 'info' | 'warning' | 'error';
+
+export interface StatusMessage extends BaseMessage<'status'> {
+  payload: {
+    kind: StatusKind;
+    code: string;
+    message: string;
+  };
+}
+
+/**
+ * Heartbeat messages
+ */
+export interface PingMessage extends BaseMessage<'ping'> {}
+
+export interface PongMessage extends BaseMessage<'pong'> {}
+
+/**
+ * Authentication messages
+ */
+export interface AuthRequestMessage extends BaseMessage<'auth'> {
+  payload: {
+    token: string;
+  };
+}
+
+export interface AuthResponseMessage extends BaseMessage<'auth'> {
+  payload: {
+    success: boolean;
+    sessionId?: string;
+    error?: string;
+  };
+}
+
+/**
+ * Client -> Server: Subscribe to specific event types
+ */
+export interface SubscribeMessage extends BaseMessage<'subscribe'> {
+  payload: {
+    events: ('callback' | 'status' | 'sync')[];
+  };
+}
+
+/**
+ * Connection acknowledged by server
+ */
+export interface ConnectedMessage extends BaseMessage<'connected'> {
+  payload: {
+    clientId: string;
+    serverTime: string;
+  };
+}
+
+/**
+ * Union type of all server -> client messages
+ */
+export type ServerMessage =
+  | SnapshotMessage
+  | SynchronizedMessage
+  | CallbackMessage
+  | StatusMessage
+  | PongMessage
+  | ConnectedMessage
+  | AuthResponseMessage;
+
+/**
+ * Union type of all client -> server messages
+ */
+export type ClientMessage =
+  | AuthRequestMessage
+  | PingMessage
+  | SubscribeMessage;
+
+// Legacy compatibility
 export interface RelayMessage {
   type: 'connect' | 'disconnect' | 'data' | 'ping' | 'pong' | 'error';
   tunnelId?: string;

package/packages/relay/src/ws-server.ts

@@ -0,0 +1,165 @@
+/**
+ * WebSocket Relay Server - Pushes callbacks to connected clients in real-time
+ * 
+ * Architecture:
+ *   Telegram/LINE → Webhook → This Server → WebSocket → Local Client
+ * 
+ * No file queue needed - real-time streaming!
+ */
+
+import { createServer, IncomingMessage, ServerResponse, Server } from "node:http";
+import { WebSocketServer, WebSocket } from "ws";
+import { randomUUID } from "node:crypto";
+
+export interface RelayMessage {
+  type: "callback" | "ping" | "pong" | "auth";
+  payload: unknown;
+}
+
+export interface CallbackPayload {
+  type: "telegram_callback" | "line_callback";
+  action: string;
+  targetId: string;
+  userId: number;
+  username?: string;
+  messageId?: number;
+  timestamp: string;
+}
+
+const AUTH_TOKEN = process.env.RELAY_AUTH_TOKEN || "change-me-in-production";
+
+/**
+ * WebSocket Relay Server
+ */
+export class WsRelayServer {
+  private server: Server | null = null;
+  private wss: WebSocketServer | null = null;
+  private clients = new Map<string, WebSocket>();
+  private port: number;
+  private running = false;
+
+  constructor(port = 8444) {
+    this.port = port;
+  }
+
+  /**
+   * Start the WebSocket server
+   */
+  async start(): Promise<void> {
+    if (this.running) return;
+
+    this.server = createServer();
+    this.wss = new WebSocketServer({ server: this.server });
+
+    this.wss.on("connection", (ws: WebSocket, req: IncomingMessage) => {
+      const clientId = randomUUID();
+      console.log(`[WsRelay] Client connected: ${clientId} from ${req.socket.remoteAddress}`);
+      
+      // Don't auth yet - just accept connection
+      // Client will send auth message
+      ws.on("message", (data: Buffer) => {
+        try {
+          const msg = JSON.parse(data.toString()) as RelayMessage;
+          this.handleMessage(ws, clientId, msg);
+        } catch (err) {
+          console.error("[WsRelay] Invalid message:", err);
+        }
+      });
+
+      ws.on("close", () => {
+        this.clients.delete(clientId);
+        console.log(`[WsRelay] Client disconnected: ${clientId}`);
+      });
+
+      ws.on("error", (err) => {
+        console.error(`[WsRelay] Client error: ${clientId}`, err);
+        this.clients.delete(clientId);
+      });
+
+      // Send welcome
+      ws.send(JSON.stringify({ type: "connected", payload: { clientId } }));
+    });
+
+    return new Promise((resolve) => {
+      this.server!.listen(this.port, () => {
+        this.running = true;
+        console.log(`[WsRelay] Server started on port ${this.port}`);
+        resolve();
+      });
+    });
+  }
+
+  private handleMessage(ws: WebSocket, clientId: string, msg: RelayMessage): void {
+    switch (msg.type) {
+      case "auth":
+        if (msg.payload === AUTH_TOKEN) {
+          this.clients.set(clientId, ws);
+          ws.send(JSON.stringify({ type: "auth", payload: { success: true } }));
+          console.log(`[WsRelay] Client authenticated: ${clientId}`);
+        } else {
+          ws.send(JSON.stringify({ type: "auth", payload: { success: false, error: "Invalid token" } }));
+          ws.close();
+        }
+        break;
+
+      case "ping":
+        ws.send(JSON.stringify({ type: "pong", payload: {} }));
+        break;
+    }
+  }
+
+  /**
+   * Broadcast callback to all connected clients
+   */
+  broadcastCallback(callback: CallbackPayload): void {
+    const msg = JSON.stringify({ type: "callback", payload: callback });
+    let count = 0;
+
+    for (const [clientId, ws] of this.clients) {
+      if (ws.readyState === WebSocket.OPEN) {
+        ws.send(msg);
+        count++;
+      }
+    }
+
+    console.log(`[WsRelay] Broadcast callback to ${count} client(s): ${callback.action} ${callback.targetId}`);
+  }
+
+  /**
+   * Stop the server
+   */
+  async stop(): Promise<void> {
+    if (!this.running) return;
+
+    for (const ws of this.clients.values()) {
+      ws.close();
+    }
+    this.clients.clear();
+
+    return new Promise((resolve) => {
+      this.server!.close(() => {
+        this.running = false;
+        console.log("[WsRelay] Server stopped");
+        resolve();
+      });
+    });
+  }
+
+  isRunning(): boolean {
+    return this.running;
+  }
+
+  getClientCount(): number {
+    return this.clients.size;
+  }
+}
+
+// Export singleton for use in unified webhook server
+let singleton: WsRelayServer | null = null;
+
+export function getRelayServer(): WsRelayServer {
+  if (!singleton) {
+    singleton = new WsRelayServer();
+  }
+  return singleton;
+}

package/packages/release-manager/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/release-manager",
-  "version": "1.1.375",
+  "version": "1.1.377",
   "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.375",
+  "version": "1.1.377",
   "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.375",
+  "version": "1.1.377",
   "description": "pi-harness-runtime — runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/scheduler/package.json

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

package/packages/scheduler-adapter/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/scheduler-adapter",
-  "version": "1.1.375",
+  "version": "1.1.377",
   "description": "Scheduler Adapter — cron, systemd, launchd, internal adapters for autonomous runtime (RFC-0101 §6)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/session/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/session",
-  "version": "1.1.375",
+  "version": "1.1.377",
   "description": "Session management system for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/session-api/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/session-api",
-  "version": "1.1.375",
+  "version": "1.1.377",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/session-export/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/session-export",
-  "version": "1.1.375",
+  "version": "1.1.377",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/shared-context/package.json

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

package/packages/skill-mcp-client/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/skill-mcp-client",
-  "version": "1.1.375",
+  "version": "1.1.377",
   "description": "MCP client for Skills SaaS backend",
   "type": "module",
   "main": "./dist/index.js",

package/packages/skill-registry/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/skill-registry",
-  "version": "1.1.375",
+  "version": "1.1.377",
   "description": "Skill Registry for pi-harness-runtime — dynamic skill discovery and invocation",
   "type": "module",
   "main": "./dist/index.js",

package/packages/skills/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/skills",
-  "version": "1.1.375",
+  "version": "1.1.377",
   "description": "File-based skill system with pi.dev compatibility and Hermes self-improvement",
   "type": "module",
   "main": "src/index.ts",

package/packages/sprint-planner/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/sprint-planner",
-  "version": "1.1.375",
+  "version": "1.1.377",
   "type": "module",
   "description": "Sprint planning engine for pi-harness",
   "main": "dist/index.js",

package/packages/subscription-engine/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/subscription-engine",
-  "version": "1.1.375",
+  "version": "1.1.377",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/task-compiler/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/task-compiler",
-  "version": "1.1.375",
+  "version": "1.1.377",
   "description": "Task Compiler for pi-harness-runtime — produces deterministic task DAG from CompiledRequirement",
   "type": "module",
   "main": "./dist/index.js",

package/packages/telegram/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/telegram",
-  "version": "1.1.375",
+  "version": "1.1.377",
   "description": "pi-harness-runtime — Telegram inbound/outbound",
   "type": "module",
   "main": "./src/index.js",

package/packages/tencentdb-memory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moocoding/tencentdb-memory",
-  "version": "1.1.375",
+  "version": "1.1.377",
   "description": "TencentDB Agent Memory client - sync skills to centralized knowledge base",
   "type": "module",
   "main": "src/index.ts",

package/packages/tencentdb-sync/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/tencentdb-sync",
-  "version": "1.1.375",
+  "version": "1.1.377",
   "description": "Sync SKILL.md skills to TencentDB-Agent-Memory server (RFC-0105/0106)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/test-data-generator/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/test-data-generator",
-  "version": "1.1.375",
+  "version": "1.1.377",
   "description": "Test data generation for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/test-generator/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/test-generator",
-  "version": "1.1.375",
+  "version": "1.1.377",
   "description": "Auto-Test Generator — generate unit and E2E tests from source code (RFC-0013)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/todo-bd-sync/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moocoding/todo-bd-sync",
-  "version": "1.1.375",
+  "version": "1.1.377",
   "description": "Two-way sync between rpiv-todo overlay and bd issue tracker",
   "type": "module",
   "main": "src/index.ts",

package/packages/token-estimation/package.json

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

package/packages/token-optimizer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/token-optimizer",
-  "version": "1.1.375",
+  "version": "1.1.377",
   "description": "Token Budget Optimizer — maximize prompt value within token limits (RFC-0011)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/trajectory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/trajectory",
-  "version": "1.1.375",
+  "version": "1.1.377",
   "description": "Trajectory capture for the write-review loop — persists cycle records for learning",
   "type": "module",
   "main": "./dist/src/index.js",

package/packages/tui/package.json

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

package/packages/types/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/types",
-  "version": "1.1.375",
+  "version": "1.1.377",
   "description": "Shared TypeScript types for pi-harness-runtime packages",
   "type": "module",
   "main": "./src/index.js",

package/packages/voice-api/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/voice-api",
-  "version": "1.1.375",
+  "version": "1.1.377",
   "type": "module",
   "description": "Voice-to-text API using Whisper for Telegram and LINE integration",
   "main": "./dist/index.js",

package/packages/webmcp-tester/package.json

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

package/packages/wiki/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/wiki",
-  "version": "1.1.375",
+  "version": "1.1.377",
   "description": "LLM Wiki integration for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/workflow-events/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/workflow-events",
-  "version": "1.1.375",
+  "version": "1.1.377",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/workspace-scanner/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/workspace-scanner",
-  "version": "1.1.375",
+  "version": "1.1.377",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

package/packages/worktree/package.json

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

package/packages/write-review/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moocoding/write-review",
-  "version": "1.1.375",
+  "version": "1.1.377",
   "description": "Two-agent write-review loop with blackboard coordination",
   "type": "module",
   "main": "src/index.ts",