pi-harness-runtime 1.1.376 → 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/release-manager/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/release-manager",
-  "version": "1.1.376",
+  "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.376",
+  "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.376",
+  "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.376",
+  "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.376",
+  "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.376",
+  "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.376",
+  "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.376",
+  "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.376",
+  "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.376",
+  "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.376",
+  "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.376",
+  "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.376",
+  "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.376",
+  "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.376",
+  "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.376",
+  "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.376",
+  "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.376",
+  "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.376",
+  "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.376",
+  "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.376",
+  "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.376",
+  "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.376",
+  "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.376",
+  "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.376",
+  "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.376",
+  "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.376",
+  "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.376",
+  "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.376",
+  "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.376",
+  "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.376",
+  "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.376",
+  "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.376",
+  "version": "1.1.377",
   "description": "Two-agent write-review loop with blackboard coordination",
   "type": "module",
   "main": "src/index.ts",