pi-harness-runtime 1.1.336 → 1.1.338

package/index.ts

@@ -2054,8 +2054,20 @@ let _nc: {
 		ctx: Record<string, unknown>,
 		options?: { approveLabel?: string; rejectLabel?: string },
 	) => Promise<unknown>;
+	notifyWithButtons?: (
+		event: string,
+		ctx: Record<string, unknown>,
+		buttons: Array<{ text: string; action: string; targetId: string; url?: string }>,
+	) => Promise<unknown>;
 } | null = null;
 
+// Type for _nc.center
+type NcCenter = {
+	notifyWithApproval: Function;
+	notify: Function;
+	notifyWithButtons?: Function;
+};
+
 /**
  * Fire a Telegram notification event. Logs delivery outcomes.
  * Silently skips if Telegram is not configured.
@@ -2063,12 +2075,7 @@ let _nc: {
 async function nc(event: string, ctx: Record<string, unknown>): Promise<void> {
 	if (!_nc) return;
 	try {
-		const nc = _nc as {
-			center: {
-				notifyWithApproval: Function;
-				notify: Function;
-			};
-		};
+		const center = _nc!.center as NcCenter;
 
 		// Import policy engine dynamically to check if approval buttons needed
 		// This is a simple sync check - can be replaced with Jev-powered evaluation
@@ -2077,9 +2084,9 @@ async function nc(event: string, ctx: Record<string, unknown>): Promise<void> {
 		// Capture results for logging
 		let results: unknown;
 		if (requiresApproval(event)) {
-			results = await nc.center.notifyWithApproval(event as never, ctx as never);
+			results = await center.notifyWithApproval(event as never, ctx as never);
 		} else {
-			results = await nc.center.notify(event as never, ctx as never);
+			results = await center.notify(event as never, ctx as never);
 		}
 
 		// Log delivery outcomes to file
@@ -2730,10 +2737,11 @@ export default async function (pi: ExtensionAPI) {
 				const doneToken = _createPendingAction(sessionId, "done", projectRoot, "plan");
 				
 				// Use event type based on stage
-				if (hasReviewMarker) {
+if (hasReviewMarker) {
 					// Review stage: buttons are Code again and Done
 					const codeAgainToken = _createPendingAction(sessionId, "code_again", projectRoot, "review");
-					void nc.center.notifyWithButtons("CodexReviewDetected", {
+					// SAFETY: _nc.center is always an object with notifyWithButtons in our usage
+				void (_nc as unknown as { center: { notifyWithButtons: Function } }).center.notifyWithButtons("CodexReviewDetected", {
 						requirement: msg.text,
 						taskTitle: sessionId,
 						details: {
@@ -2746,9 +2754,10 @@ export default async function (pi: ExtensionAPI) {
 						{ text: "Code again", action: PING_PONG_ACTIONS.CODE_AGAIN, targetId: codeAgainToken },
 						{ text: "Done", action: PING_PONG_ACTIONS.DONE, targetId: doneToken },
 					]);
-				} else {
+} else {
 					// Plan stage: buttons are Code and Done
-					void nc.center.notifyWithButtons("CodexPlanDetected", {
+					// SAFETY: _nc.center is always an object with notifyWithButtons in our usage
+				void (_nc as unknown as { center: { notifyWithButtons: Function } }).center.notifyWithButtons("CodexPlanDetected", {
 						requirement: msg.text, // Full text, no truncation
 						taskTitle: sessionId,
 						details: {

package/package.json

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

package/packages/clipboard-plugin/package.json

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

package/packages/code-generation/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/code-generation",
-  "version": "1.1.336",
+  "version": "1.1.338",
   "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.336",
+  "version": "1.1.338",
   "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.336",
+  "version": "1.1.338",
   "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.336",
+  "version": "1.1.338",
   "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.336",
+  "version": "1.1.338",
   "description": "Auto-capture API-fetched configuration values to AGENTS.md",
   "type": "module",
   "main": "src/index.ts",

package/packages/connection-runtime/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Connection Runtime for pi-harness
+ *
+ * Inspired by T3Code's client-runtime:
+ * - Jittered exponential backoff for reconnection
+ * - One transport retry owner per environment
+ * - Shared subscription logic across clients
+ */
+export * from './supervisor.js';
+export * from './registry.js';
+export * from './types.js';

package/packages/connection-runtime/dist/index.js

@@ -0,0 +1,11 @@
+/**
+ * Connection Runtime for pi-harness
+ *
+ * Inspired by T3Code's client-runtime:
+ * - Jittered exponential backoff for reconnection
+ * - One transport retry owner per environment
+ * - Shared subscription logic across clients
+ */
+export * from './supervisor.js';
+export * from './registry.js';
+export * from './types.js';

package/packages/connection-runtime/dist/registry.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Connection Registry
+ *
+ * Scopes connections by environment/context.
+ * Tracks active connections and their state.
+ */
+import { ConnectionSupervisor } from './supervisor.js';
+export interface RegistryEntry {
+    id: string;
+    supervisor: ConnectionSupervisor;
+    metadata?: Record<string, unknown>;
+    createdAt: Date;
+    lastConnectedAt?: Date;
+}
+/**
+ * Connection Registry
+ *
+ * Manages multiple connections by ID.
+ * Connections persist even after disconnect (for reconnection).
+ */
+export declare class ConnectionRegistry {
+    private connections;
+    private onChange?;
+    constructor(onChange?: (entries: RegistryEntry[]) => void);
+    /**
+     * Register a new connection
+     */
+    register(id: string, supervisor: ConnectionSupervisor, metadata?: Record<string, unknown>): RegistryEntry;
+    /**
+     * Unregister a connection
+     */
+    unregister(id: string): boolean;
+    /**
+     * Get a connection by ID
+     */
+    get(id: string): RegistryEntry | undefined;
+    /**
+     * Get all connections
+     */
+    list(): RegistryEntry[];
+    /**
+     * Get connections by state
+     */
+    listByState(state: string): RegistryEntry[];
+    /**
+     * Update connection metadata
+     */
+    updateMetadata(id: string, metadata: Record<string, unknown>): boolean;
+    /**
+     * Update last connected timestamp
+     */
+    touch(id: string): boolean;
+    /**
+     * Clear all connections
+     */
+    clear(): Promise<void>;
+    /**
+     * Get count of connections
+     */
+    size(): number;
+    /**
+     * Check if connection exists
+     */
+    has(id: string): boolean;
+    /**
+     * Notify change listeners
+     */
+    private notifyChange;
+}

package/packages/connection-runtime/dist/registry.js

@@ -0,0 +1,117 @@
+/**
+ * Connection Registry
+ *
+ * Scopes connections by environment/context.
+ * Tracks active connections and their state.
+ */
+/**
+ * Connection Registry
+ *
+ * Manages multiple connections by ID.
+ * Connections persist even after disconnect (for reconnection).
+ */
+export class ConnectionRegistry {
+    connections = new Map();
+    onChange;
+    constructor(onChange) {
+        this.onChange = onChange;
+    }
+    /**
+     * Register a new connection
+     */
+    register(id, supervisor, metadata) {
+        const entry = {
+            id,
+            supervisor,
+            metadata,
+            createdAt: new Date(),
+        };
+        this.connections.set(id, entry);
+        this.notifyChange();
+        return entry;
+    }
+    /**
+     * Unregister a connection
+     */
+    unregister(id) {
+        const entry = this.connections.get(id);
+        if (entry) {
+            entry.supervisor.disconnect().catch(() => { });
+            this.connections.delete(id);
+            this.notifyChange();
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Get a connection by ID
+     */
+    get(id) {
+        return this.connections.get(id);
+    }
+    /**
+     * Get all connections
+     */
+    list() {
+        return Array.from(this.connections.values());
+    }
+    /**
+     * Get connections by state
+     */
+    listByState(state) {
+        return this.list().filter(e => e.supervisor.getState() === state);
+    }
+    /**
+     * Update connection metadata
+     */
+    updateMetadata(id, metadata) {
+        const entry = this.connections.get(id);
+        if (entry) {
+            entry.metadata = { ...entry.metadata, ...metadata };
+            this.notifyChange();
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Update last connected timestamp
+     */
+    touch(id) {
+        const entry = this.connections.get(id);
+        if (entry) {
+            entry.lastConnectedAt = new Date();
+            this.notifyChange();
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Clear all connections
+     */
+    async clear() {
+        const promises = this.list().map(e => e.supervisor.disconnect());
+        await Promise.allSettled(promises);
+        this.connections.clear();
+        this.notifyChange();
+    }
+    /**
+     * Get count of connections
+     */
+    size() {
+        return this.connections.size;
+    }
+    /**
+     * Check if connection exists
+     */
+    has(id) {
+        return this.connections.has(id);
+    }
+    /**
+     * Notify change listeners
+     */
+    notifyChange() {
+        if (this.onChange) {
+            this.onChange(this.list());
+        }
+    }
+}

package/packages/connection-runtime/dist/supervisor.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Connection Supervisor
+ *
+ * Inspired by T3Code's connection supervisor:
+ * - Jittered exponential backoff for reconnection
+ * - Resets delay after successful connection
+ * - Cap at maxDelay to prevent thundering herd
+ */
+import type { EventEmitter } from './types.js';
+/**
+ * Connection Supervisor options
+ */
+export interface SupervisorOptions {
+    /** Transport to manage */
+    transport: EventEmitter & {
+        open(): Promise<void>;
+        close(): Promise<void>;
+        isConnected(): boolean;
+    };
+    /** Initial retry delay in ms */
+    initialDelay?: number;
+    /** Maximum retry delay in ms */
+    maxDelay?: number;
+    /** Maximum retries (0 = infinite) */
+    maxRetries?: number;
+    /** Enable jitter */
+    jitter?: boolean;
+    /** Callback when connected */
+    onConnected?: () => void;
+    /** Callback when disconnected */
+    onDisconnected?: () => void;
+    /** Callback on error */
+    onError?: (error: Error) => void;
+    /** Callback on retry attempt */
+    onRetry?: (attempt: number, delay: number) => void;
+}
+/**
+ * Connection Supervisor
+ *
+ * Manages transport connection with automatic reconnection using
+ * jittered exponential backoff.
+ */
+export declare class ConnectionSupervisor {
+    private transport;
+    private delay;
+    private maxDelay;
+    private maxRetries;
+    private jitter;
+    private retries;
+    private state;
+    private stopping;
+    private onConnected?;
+    private onDisconnected?;
+    private onError?;
+    private onRetry?;
+    constructor(options: SupervisorOptions);
+    /**
+     * Current connection state
+     */
+    getState(): "connected" | "connecting" | "error" | "idle" | "reconnecting" | "stopped";
+    /**
+     * Number of retries attempted
+     */
+    getRetries(): number;
+    /**
+     * Start the connection
+     */
+    connect(): Promise<void>;
+    /**
+     * Stop the connection
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Force reconnection
+     */
+    reconnect(): Promise<void>;
+    /**
+     * Handle connection error with backoff
+     */
+    private handleConnectionError;
+    /**
+     * Attempt connection with backoff
+     */
+    private attemptConnection;
+    /**
+     * Get initial delay (allows override)
+     */
+    protected getInitialDelay(): number;
+}