@kangentic/protocol 0.2.0 → 0.3.0

package/dist/version.d.ts

@@ -8,5 +8,5 @@
  * differing prologue produces a differing transcript hash `h` from the
  * first MixHash call, which cascades into every derived key.
  */
-export declare const PROTOCOL_VERSION = "1";
+export declare const PROTOCOL_VERSION = "2";
 export declare function encodeProtocolVersion(version?: string): Uint8Array;

package/dist/wire/framing.d.ts

@@ -1,4 +1,8 @@
 import type { BridgeMessage } from './messages';
 export declare const MAX_FRAME_LENGTH: number;
+/** Upper bound on the JSON a compressed frame may declare/inflate to. */
+export declare const MAX_DECODED_LENGTH: number;
+/** JSON below this size ships raw - deflate overhead is not worth it. */
+export declare const COMPRESSION_THRESHOLD: number;
 export declare function encodeMessage(message: BridgeMessage): Uint8Array;
 export declare function decodeMessage(bytes: Uint8Array): BridgeMessage;

package/dist/wire/payloads.d.ts

@@ -15,10 +15,22 @@
  */
 import type { CapabilityVerb } from '../capabilities/verbs';
 import type { JsonValue } from './messages';
-import { type ActivityReasonWire, type ActivityStateWire, type BacklogItemWire, type BoardColumnWire, type BoardTaskWire, type DiffFileContentWire, type DiffFileListWire, type SessionUsageWire } from '../events/payloads';
+import { type ActivityReasonWire, type ActivityStateWire, type BacklogItemWire, type BoardColumnWire, type BoardTaskWire, type DiffFileContentWire, type DiffFileListWire, type SessionUsageWire, type TranscriptEntryWire } from '../events/payloads';
 export interface ReadStreamRequestPayload {
     sessionId: string;
-    action: 'subscribe' | 'unsubscribe';
+    /**
+     * 'transcript-window' is a one-shot windowed-history read: the newest
+     * `limit` transcript entries strictly before `beforeIndex` (or the tail
+     * when `beforeIndex` is omitted). The desktop may return fewer entries
+     * than `limit` to keep the response frame small - page again from the
+     * returned `startIndex`. Live updates after 'subscribe' arrive as
+     * incremental TranscriptEvent deltas, never full transcripts.
+     */
+    action: 'subscribe' | 'unsubscribe' | 'transcript-window';
+    /** transcript-window only: fetch entries strictly before this absolute index. Omit for the newest window. */
+    beforeIndex?: number;
+    /** transcript-window only: maximum entries wanted (the desktop may cap this and may return fewer). */
+    limit?: number;
 }
 /** Initial snapshot returned on subscribe; live updates arrive as TerminalEvent/ActivityEvent/TranscriptEvent. */
 export interface ReadStreamResponsePayload {
@@ -33,6 +45,19 @@ export interface ReadStreamResponsePayload {
 }
 /** Phone-side narrowing of a read-stream subscribe response. Throws on a malformed required field. */
 export declare function parseReadStreamResponsePayload(payload: JsonValue): ReadStreamResponsePayload;
+/**
+ * A contiguous slice of the transcript, returned by the read-stream
+ * 'transcript-window' action. `startIndex` is the absolute index of
+ * `entries[0]`; `startIndex > 0` means more history exists above.
+ */
+export interface TranscriptWindowResponsePayload {
+    revision: number;
+    totalEntries: number;
+    startIndex: number;
+    entries: TranscriptEntryWire[];
+}
+/** Phone-side narrowing of a transcript-window response. Throws on a malformed required field. */
+export declare function parseTranscriptWindowResponsePayload(payload: JsonValue): TranscriptWindowResponsePayload;
 export interface ReadBoardRequestPayload {
     projectId?: string;
     /** Defaults to 'subscribe' when omitted. 'unsubscribe' only has an effect when projectId is set - the no-projectId project list is a one-shot read with no live feed to tear down. */
@@ -121,7 +146,7 @@ export interface CapabilityRequestPayloadMap {
     'board-tool-write': BoardToolRequestPayload;
 }
 export interface CapabilityResponsePayloadMap {
-    'read-stream': ReadStreamResponsePayload;
+    'read-stream': ReadStreamResponsePayload | TranscriptWindowResponsePayload;
     'read-board': ReadBoardResponsePayload;
     'read-diff': ReadDiffResponsePayload;
     'send-user-message': SendUserMessageResponsePayload;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kangentic/protocol",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Kangentic mobile bridge wire protocol: framing, Noise-based pairing and session handshakes, signed device roster, and capability verbs shared between desktop and mobile.",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",
@@ -42,7 +42,8 @@
   "dependencies": {
     "@noble/ciphers": "^2.2.0",
     "@noble/curves": "^2.2.0",
-    "@noble/hashes": "^2.2.0"
+    "@noble/hashes": "^2.2.0",
+    "fflate": "^0.8.3"
   },
   "devDependencies": {
     "esbuild": "^0.28.0",