@oh-my-pi/pi-wire 16.1.6 → 16.1.8

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## [Unreleased]
 
+## [16.1.8] - 2026-06-20
+
+### Breaking Changes
+
+- Bumped `COLLAB_PROTO` to `2`. The `welcome` host frame now carries metadata only (`header`, `state`, `agents`, `entryCount`, optional `readOnly`) — the transcript moves to a new `snapshot-chunk` host frame (`{ entries: SessionEntry[]; final: boolean }`) sent immediately after the welcome. Hosts split large snapshots into multiple chunks; the last chunk carries `final: true`. Old guests speaking proto v1 are rejected with the existing protocol-mismatch error. ([#3144](https://github.com/can1357/oh-my-pi/issues/3144))
+
 ## [15.12.4] - 2026-06-13
 
 ### Changed

package/dist/types/index.d.ts

@@ -317,11 +317,28 @@ export type HostFrame = {
     t: "welcome";
     proto: number;
     header: SessionHeader;
-    entries: SessionEntry[];
     state: SessionState;
     agents: AgentSnapshot[];
+    /**
+     * Total number of `SessionEntry` items the host will deliver in the
+     * `snapshot-chunk` frames that follow. Guests stay in the loading
+     * phase until they have accumulated all of them (or a chunk arrives
+     * with `final: true`).
+     */
+    entryCount: number;
     /** True when this peer joined through a read-only (view) link. */
     readOnly?: boolean;
+}
+/**
+ * Targeted snapshot fragment delivered after `welcome`. Hosts split the
+ * transcript into chunks bounded by byte size so a multi-MB session is not
+ * forced through one giant frame the relay may stall on. The last chunk
+ * carries `final: true`; guests finalize the replica on that frame.
+ */
+ | {
+    t: "snapshot-chunk";
+    entries: SessionEntry[];
+    final: boolean;
 } | {
     t: "entry";
     entry: SessionEntry;
@@ -356,8 +373,16 @@ export type HostFrame = {
     message: string;
 };
 export type WireFrame = GuestFrame | HostFrame;
-/** Wire protocol version carried in `hello`; the host rejects mismatches. */
-export declare const COLLAB_PROTO = 1;
+/**
+ * Wire protocol version carried in `hello`; the host rejects mismatches.
+ *
+ * - `1` (legacy): `welcome` carried the full `entries` array inline.
+ * - `2`: `welcome` carries only metadata (header/state/agents/entryCount);
+ *   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.
+ */
+export declare const COLLAB_PROTO = 2;
 /** 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.1.6",
+	"version": "16.1.8",
 	"description": "Shared wire protocol types for Oh My Pi packages",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",

package/src/index.ts

@@ -323,12 +323,25 @@ export type HostFrame =
 			t: "welcome";
 			proto: number;
 			header: SessionHeader;
-			entries: SessionEntry[];
 			state: SessionState;
 			agents: AgentSnapshot[];
+			/**
+			 * Total number of `SessionEntry` items the host will deliver in the
+			 * `snapshot-chunk` frames that follow. Guests stay in the loading
+			 * phase until they have accumulated all of them (or a chunk arrives
+			 * with `final: true`).
+			 */
+			entryCount: number;
 			/** True when this peer joined through a read-only (view) link. */
 			readOnly?: boolean;
 	  }
+	/**
+	 * Targeted snapshot fragment delivered after `welcome`. Hosts split the
+	 * transcript into chunks bounded by byte size so a multi-MB session is not
+	 * forced through one giant frame the relay may stall on. The last chunk
+	 * carries `final: true`; guests finalize the replica on that frame.
+	 */
+	| { t: "snapshot-chunk"; entries: SessionEntry[]; final: boolean }
 	| { t: "entry"; entry: SessionEntry }
 	| { t: "event"; event: AgentEvent }
 	| { t: "state"; state: SessionState }
@@ -342,8 +355,16 @@ export type HostFrame =
 
 export type WireFrame = GuestFrame | HostFrame;
 
-/** Wire protocol version carried in `hello`; the host rejects mismatches. */
-export const COLLAB_PROTO = 1;
+/**
+ * Wire protocol version carried in `hello`; the host rejects mismatches.
+ *
+ * - `1` (legacy): `welcome` carried the full `entries` array inline.
+ * - `2`: `welcome` carries only metadata (header/state/agents/entryCount);
+ *   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.
+ */
+export const COLLAB_PROTO = 2;
 
 /** Parameter key used for intent tracing (e.g. prompt explanation/reasoning) */
 export const INTENT_FIELD = "i";