@oh-my-pi/pi-wire 16.2.13 → 16.3.2

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 ## [Unreleased]
 
+## [16.3.0] - 2026-07-02
+
+### Breaking Changes
+
+- Upgraded the collaboration protocol to version 3. Guests using version 2 will now be rejected during the handshake with a protocol-mismatch error.
+
+### Added
+
+- Added support for interactive UI request and response frames, enabling browser guests to respond to prompts initiated by the host.
+
 ## [16.1.8] - 2026-06-20
 
 ### Breaking Changes

package/dist/types/index.d.ts

@@ -284,6 +284,28 @@ export interface SubagentLifecyclePayload {
     parentToolCallId?: string;
     index: number;
 }
+export type CollabUiSelectItem = string | {
+    label: string;
+    description?: string;
+};
+export type CollabUiResponseValue = string | undefined;
+export type CollabUiRequestDraft = {
+    kind: "select";
+    title: string;
+    options: CollabUiSelectItem[];
+    initialIndex?: number;
+    selectionMarker?: "radio" | "checkbox";
+    checkedIndices?: number[];
+    markableCount?: number;
+    helpText?: string;
+} | {
+    kind: "editor";
+    title: string;
+    prefill?: string;
+};
+export type CollabUiRequest = CollabUiRequestDraft & {
+    reqId: number;
+};
 export type GuestFrame = {
     t: "hello";
     proto: number;
@@ -298,6 +320,10 @@ export type GuestFrame = {
     t: "prompt";
     text: string;
     images?: ImageContent[];
+} | {
+    t: "ui-response";
+    reqId: number;
+    value?: CollabUiResponseValue;
 } | {
     t: "abort";
 } | {
@@ -357,6 +383,12 @@ export type HostFrame = {
 } | {
     t: "agents";
     agents: AgentSnapshot[];
+} | {
+    t: "ui-request";
+    request: CollabUiRequest;
+} | {
+    t: "ui-request-end";
+    reqId: number;
 }
 /** Targeted reply to fetch-transcript; `text` is decoded JSONL from `fromByte`, `newSize` the next offset base. */
  | {
@@ -381,8 +413,12 @@ export type WireFrame = GuestFrame | HostFrame;
  *   transcript entries follow in `snapshot-chunk` frames, so multi-MB
  *   sessions are not gated on a single welcome frame fitting under the
  *   guest's first-welcome timeout.
+ * - `3`: host asks guests through `ui-request`/`ui-request-end` host frames
+ *   answered by the `ui-response` guest frame. Guests that predate the
+ *   grammar would silently drop `ui-request` (asks hang forever on the
+ *   host), so they must be rejected at hello.
  */
-export declare const COLLAB_PROTO = 2;
+export declare const COLLAB_PROTO = 3;
 /** Parameter key used for intent tracing (e.g. prompt explanation/reasoning) */
 export declare const INTENT_FIELD = "i";
 /** Plaintext envelope prefix: `[4B uint32 BE peerId][sealed payload]`. */

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-wire",
-	"version": "16.2.13",
+	"version": "16.3.2",
 	"description": "Shared wire protocol types for Oh My Pi packages",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",

package/src/index.ts

@@ -298,6 +298,29 @@ export interface SubagentLifecyclePayload {
 // Frames (JSON inside the AES-GCM seal)
 // ═══════════════════════════════════════════════════════════════════════════
 
+export type CollabUiSelectItem = string | { label: string; description?: string };
+
+export type CollabUiResponseValue = string | undefined;
+
+export type CollabUiRequestDraft =
+	| {
+			kind: "select";
+			title: string;
+			options: CollabUiSelectItem[];
+			initialIndex?: number;
+			selectionMarker?: "radio" | "checkbox";
+			checkedIndices?: number[];
+			markableCount?: number;
+			helpText?: string;
+	  }
+	| {
+			kind: "editor";
+			title: string;
+			prefill?: string;
+	  };
+
+export type CollabUiRequest = CollabUiRequestDraft & { reqId: number };
+
 export type GuestFrame =
 	| {
 			t: "hello";
@@ -311,6 +334,7 @@ export type GuestFrame =
 			writeToken?: string;
 	  }
 	| { t: "prompt"; text: string; images?: ImageContent[] }
+	| { t: "ui-response"; reqId: number; value?: CollabUiResponseValue }
 	| { t: "abort" }
 	| { t: "agent-cmd"; cmd: "chat" | "kill" | "revive"; agentId: string; text?: string }
 	| { t: "fetch-transcript"; reqId: number; agentId: string; fromByte: number };
@@ -348,6 +372,8 @@ export type HostFrame =
 	/** Mirrored EventBus traffic (task subagent lifecycle/progress channels only). */
 	| { t: "bus"; channel: BusChannel; data: unknown }
 	| { t: "agents"; agents: AgentSnapshot[] }
+	| { t: "ui-request"; request: CollabUiRequest }
+	| { t: "ui-request-end"; reqId: number }
 	/** Targeted reply to fetch-transcript; `text` is decoded JSONL from `fromByte`, `newSize` the next offset base. */
 	| { t: "transcript"; reqId: number; text: string; newSize: number; error?: string }
 	| { t: "bye"; reason: string }
@@ -363,8 +389,12 @@ export type WireFrame = GuestFrame | HostFrame;
  *   transcript entries follow in `snapshot-chunk` frames, so multi-MB
  *   sessions are not gated on a single welcome frame fitting under the
  *   guest's first-welcome timeout.
+ * - `3`: host asks guests through `ui-request`/`ui-request-end` host frames
+ *   answered by the `ui-response` guest frame. Guests that predate the
+ *   grammar would silently drop `ui-request` (asks hang forever on the
+ *   host), so they must be rejected at hello.
  */
-export const COLLAB_PROTO = 2;
+export const COLLAB_PROTO = 3;
 
 /** Parameter key used for intent tracing (e.g. prompt explanation/reasoning) */
 export const INTENT_FIELD = "i";