@ignex/nova 0.1.3 → 0.1.6

package/src/generated/ts/resumed.ts

@@ -0,0 +1,88 @@
+// automatically generated by the FlatBuffers compiler, do not modify
+
+/* eslint-disable @typescript-eslint/no-unused-vars, @typescript-eslint/no-explicit-any, @typescript-eslint/no-non-null-assertion */
+
+import * as flatbuffers from 'flatbuffers';
+
+
+
+export class Resumed implements flatbuffers.IUnpackableObject<ResumedT> {
+  bb: flatbuffers.ByteBuffer|null = null;
+  bb_pos = 0;
+  __init(i:number, bb:flatbuffers.ByteBuffer):Resumed {
+  this.bb_pos = i;
+  this.bb = bb;
+  return this;
+}
+
+static getRootAsResumed(bb:flatbuffers.ByteBuffer, obj?:Resumed):Resumed {
+  return (obj || new Resumed()).__init(bb.readInt32(bb.position()) + bb.position(), bb);
+}
+
+static getSizePrefixedRootAsResumed(bb:flatbuffers.ByteBuffer, obj?:Resumed):Resumed {
+  bb.setPosition(bb.position() + flatbuffers.SIZE_PREFIX_LENGTH);
+  return (obj || new Resumed()).__init(bb.readInt32(bb.position()) + bb.position(), bb);
+}
+
+ok():boolean {
+  const offset = this.bb!.__offset(this.bb_pos, 4);
+  return offset ? !!this.bb!.readInt8(this.bb_pos + offset) : false;
+}
+
+from():bigint {
+  const offset = this.bb!.__offset(this.bb_pos, 6);
+  return offset ? this.bb!.readInt64(this.bb_pos + offset) : BigInt('0');
+}
+
+static startResumed(builder:flatbuffers.Builder) {
+  builder.startObject(2);
+}
+
+static addOk(builder:flatbuffers.Builder, ok:boolean) {
+  builder.addFieldInt8(0, +ok, +false);
+}
+
+static addFrom(builder:flatbuffers.Builder, from:bigint) {
+  builder.addFieldInt64(1, from, BigInt('0'));
+}
+
+static endResumed(builder:flatbuffers.Builder):flatbuffers.Offset {
+  const offset = builder.endObject();
+  return offset;
+}
+
+static createResumed(builder:flatbuffers.Builder, ok:boolean, from:bigint):flatbuffers.Offset {
+  Resumed.startResumed(builder);
+  Resumed.addOk(builder, ok);
+  Resumed.addFrom(builder, from);
+  return Resumed.endResumed(builder);
+}
+
+unpack(): ResumedT {
+  return new ResumedT(
+    this.ok(),
+    this.from()
+  );
+}
+
+
+unpackTo(_o: ResumedT): void {
+  _o.ok = this.ok();
+  _o.from = this.from();
+}
+}
+
+export class ResumedT implements flatbuffers.IGeneratedObject {
+constructor(
+  public ok: boolean = false,
+  public from: bigint = BigInt('0')
+){}
+
+
+pack(builder:flatbuffers.Builder): flatbuffers.Offset {
+  return Resumed.createResumed(builder,
+    this.ok,
+    this.from
+  );
+}
+}

package/src/generated/ts/rpc-call.ts

@@ -0,0 +1,112 @@
+// automatically generated by the FlatBuffers compiler, do not modify
+
+/* eslint-disable @typescript-eslint/no-unused-vars, @typescript-eslint/no-explicit-any, @typescript-eslint/no-non-null-assertion */
+
+import * as flatbuffers from 'flatbuffers';
+
+
+
+export class RpcCall implements flatbuffers.IUnpackableObject<RpcCallT> {
+  bb: flatbuffers.ByteBuffer|null = null;
+  bb_pos = 0;
+  __init(i:number, bb:flatbuffers.ByteBuffer):RpcCall {
+  this.bb_pos = i;
+  this.bb = bb;
+  return this;
+}
+
+static getRootAsRpcCall(bb:flatbuffers.ByteBuffer, obj?:RpcCall):RpcCall {
+  return (obj || new RpcCall()).__init(bb.readInt32(bb.position()) + bb.position(), bb);
+}
+
+static getSizePrefixedRootAsRpcCall(bb:flatbuffers.ByteBuffer, obj?:RpcCall):RpcCall {
+  bb.setPosition(bb.position() + flatbuffers.SIZE_PREFIX_LENGTH);
+  return (obj || new RpcCall()).__init(bb.readInt32(bb.position()) + bb.position(), bb);
+}
+
+id():string|null
+id(optionalEncoding:flatbuffers.Encoding):string|Uint8Array|null
+id(optionalEncoding?:any):string|Uint8Array|null {
+  const offset = this.bb!.__offset(this.bb_pos, 4);
+  return offset ? this.bb!.__string(this.bb_pos + offset, optionalEncoding) : null;
+}
+
+name():string|null
+name(optionalEncoding:flatbuffers.Encoding):string|Uint8Array|null
+name(optionalEncoding?:any):string|Uint8Array|null {
+  const offset = this.bb!.__offset(this.bb_pos, 6);
+  return offset ? this.bb!.__string(this.bb_pos + offset, optionalEncoding) : null;
+}
+
+payloadB64():string|null
+payloadB64(optionalEncoding:flatbuffers.Encoding):string|Uint8Array|null
+payloadB64(optionalEncoding?:any):string|Uint8Array|null {
+  const offset = this.bb!.__offset(this.bb_pos, 8);
+  return offset ? this.bb!.__string(this.bb_pos + offset, optionalEncoding) : null;
+}
+
+static startRpcCall(builder:flatbuffers.Builder) {
+  builder.startObject(3);
+}
+
+static addId(builder:flatbuffers.Builder, idOffset:flatbuffers.Offset) {
+  builder.addFieldOffset(0, idOffset, 0);
+}
+
+static addName(builder:flatbuffers.Builder, nameOffset:flatbuffers.Offset) {
+  builder.addFieldOffset(1, nameOffset, 0);
+}
+
+static addPayloadB64(builder:flatbuffers.Builder, payloadB64Offset:flatbuffers.Offset) {
+  builder.addFieldOffset(2, payloadB64Offset, 0);
+}
+
+static endRpcCall(builder:flatbuffers.Builder):flatbuffers.Offset {
+  const offset = builder.endObject();
+  return offset;
+}
+
+static createRpcCall(builder:flatbuffers.Builder, idOffset:flatbuffers.Offset, nameOffset:flatbuffers.Offset, payloadB64Offset:flatbuffers.Offset):flatbuffers.Offset {
+  RpcCall.startRpcCall(builder);
+  RpcCall.addId(builder, idOffset);
+  RpcCall.addName(builder, nameOffset);
+  RpcCall.addPayloadB64(builder, payloadB64Offset);
+  return RpcCall.endRpcCall(builder);
+}
+
+unpack(): RpcCallT {
+  return new RpcCallT(
+    this.id(),
+    this.name(),
+    this.payloadB64()
+  );
+}
+
+
+unpackTo(_o: RpcCallT): void {
+  _o.id = this.id();
+  _o.name = this.name();
+  _o.payloadB64 = this.payloadB64();
+}
+}
+
+export class RpcCallT implements flatbuffers.IGeneratedObject {
+constructor(
+  public id: string|Uint8Array|null = null,
+  public name: string|Uint8Array|null = null,
+  public payloadB64: string|Uint8Array|null = null
+){}
+
+
+pack(builder:flatbuffers.Builder): flatbuffers.Offset {
+  const id = (this.id !== null ? builder.createString(this.id!) : 0);
+  const name = (this.name !== null ? builder.createString(this.name!) : 0);
+  const payloadB64 = (this.payloadB64 !== null ? builder.createString(this.payloadB64!) : 0);
+
+  return RpcCall.createRpcCall(builder,
+    id,
+    name,
+    payloadB64
+  );
+}
+}

package/src/generated/ts/rpc-result.ts

@@ -0,0 +1,126 @@
+// automatically generated by the FlatBuffers compiler, do not modify
+
+/* eslint-disable @typescript-eslint/no-unused-vars, @typescript-eslint/no-explicit-any, @typescript-eslint/no-non-null-assertion */
+
+import * as flatbuffers from 'flatbuffers';
+
+
+
+export class RpcResult implements flatbuffers.IUnpackableObject<RpcResultT> {
+  bb: flatbuffers.ByteBuffer|null = null;
+  bb_pos = 0;
+  __init(i:number, bb:flatbuffers.ByteBuffer):RpcResult {
+  this.bb_pos = i;
+  this.bb = bb;
+  return this;
+}
+
+static getRootAsRpcResult(bb:flatbuffers.ByteBuffer, obj?:RpcResult):RpcResult {
+  return (obj || new RpcResult()).__init(bb.readInt32(bb.position()) + bb.position(), bb);
+}
+
+static getSizePrefixedRootAsRpcResult(bb:flatbuffers.ByteBuffer, obj?:RpcResult):RpcResult {
+  bb.setPosition(bb.position() + flatbuffers.SIZE_PREFIX_LENGTH);
+  return (obj || new RpcResult()).__init(bb.readInt32(bb.position()) + bb.position(), bb);
+}
+
+id():string|null
+id(optionalEncoding:flatbuffers.Encoding):string|Uint8Array|null
+id(optionalEncoding?:any):string|Uint8Array|null {
+  const offset = this.bb!.__offset(this.bb_pos, 4);
+  return offset ? this.bb!.__string(this.bb_pos + offset, optionalEncoding) : null;
+}
+
+ok():boolean {
+  const offset = this.bb!.__offset(this.bb_pos, 6);
+  return offset ? !!this.bb!.readInt8(this.bb_pos + offset) : false;
+}
+
+err():string|null
+err(optionalEncoding:flatbuffers.Encoding):string|Uint8Array|null
+err(optionalEncoding?:any):string|Uint8Array|null {
+  const offset = this.bb!.__offset(this.bb_pos, 8);
+  return offset ? this.bb!.__string(this.bb_pos + offset, optionalEncoding) : null;
+}
+
+payloadB64():string|null
+payloadB64(optionalEncoding:flatbuffers.Encoding):string|Uint8Array|null
+payloadB64(optionalEncoding?:any):string|Uint8Array|null {
+  const offset = this.bb!.__offset(this.bb_pos, 10);
+  return offset ? this.bb!.__string(this.bb_pos + offset, optionalEncoding) : null;
+}
+
+static startRpcResult(builder:flatbuffers.Builder) {
+  builder.startObject(4);
+}
+
+static addId(builder:flatbuffers.Builder, idOffset:flatbuffers.Offset) {
+  builder.addFieldOffset(0, idOffset, 0);
+}
+
+static addOk(builder:flatbuffers.Builder, ok:boolean) {
+  builder.addFieldInt8(1, +ok, +false);
+}
+
+static addErr(builder:flatbuffers.Builder, errOffset:flatbuffers.Offset) {
+  builder.addFieldOffset(2, errOffset, 0);
+}
+
+static addPayloadB64(builder:flatbuffers.Builder, payloadB64Offset:flatbuffers.Offset) {
+  builder.addFieldOffset(3, payloadB64Offset, 0);
+}
+
+static endRpcResult(builder:flatbuffers.Builder):flatbuffers.Offset {
+  const offset = builder.endObject();
+  return offset;
+}
+
+static createRpcResult(builder:flatbuffers.Builder, idOffset:flatbuffers.Offset, ok:boolean, errOffset:flatbuffers.Offset, payloadB64Offset:flatbuffers.Offset):flatbuffers.Offset {
+  RpcResult.startRpcResult(builder);
+  RpcResult.addId(builder, idOffset);
+  RpcResult.addOk(builder, ok);
+  RpcResult.addErr(builder, errOffset);
+  RpcResult.addPayloadB64(builder, payloadB64Offset);
+  return RpcResult.endRpcResult(builder);
+}
+
+unpack(): RpcResultT {
+  return new RpcResultT(
+    this.id(),
+    this.ok(),
+    this.err(),
+    this.payloadB64()
+  );
+}
+
+
+unpackTo(_o: RpcResultT): void {
+  _o.id = this.id();
+  _o.ok = this.ok();
+  _o.err = this.err();
+  _o.payloadB64 = this.payloadB64();
+}
+}
+
+export class RpcResultT implements flatbuffers.IGeneratedObject {
+constructor(
+  public id: string|Uint8Array|null = null,
+  public ok: boolean = false,
+  public err: string|Uint8Array|null = null,
+  public payloadB64: string|Uint8Array|null = null
+){}
+
+
+pack(builder:flatbuffers.Builder): flatbuffers.Offset {
+  const id = (this.id !== null ? builder.createString(this.id!) : 0);
+  const err = (this.err !== null ? builder.createString(this.err!) : 0);
+  const payloadB64 = (this.payloadB64 !== null ? builder.createString(this.payloadB64!) : 0);
+
+  return RpcResult.createRpcResult(builder,
+    id,
+    this.ok,
+    err,
+    payloadB64
+  );
+}
+}

package/src/generated/ts/snapshot-request.ts

@@ -31,40 +31,53 @@ topic(optionalEncoding?:any):string|Uint8Array|null {
   return offset ? this.bb!.__string(this.bb_pos + offset, optionalEncoding) : null;
 }
 
+fromSeq():bigint {
+  const offset = this.bb!.__offset(this.bb_pos, 6);
+  return offset ? this.bb!.readInt64(this.bb_pos + offset) : BigInt('0');
+}
+
 static startSnapshotRequest(builder:flatbuffers.Builder) {
-  builder.startObject(1);
+  builder.startObject(2);
 }
 
 static addTopic(builder:flatbuffers.Builder, topicOffset:flatbuffers.Offset) {
   builder.addFieldOffset(0, topicOffset, 0);
 }
 
+static addFromSeq(builder:flatbuffers.Builder, fromSeq:bigint) {
+  builder.addFieldInt64(1, fromSeq, BigInt('0'));
+}
+
 static endSnapshotRequest(builder:flatbuffers.Builder):flatbuffers.Offset {
   const offset = builder.endObject();
   return offset;
 }
 
-static createSnapshotRequest(builder:flatbuffers.Builder, topicOffset:flatbuffers.Offset):flatbuffers.Offset {
+static createSnapshotRequest(builder:flatbuffers.Builder, topicOffset:flatbuffers.Offset, fromSeq:bigint):flatbuffers.Offset {
   SnapshotRequest.startSnapshotRequest(builder);
   SnapshotRequest.addTopic(builder, topicOffset);
+  SnapshotRequest.addFromSeq(builder, fromSeq);
   return SnapshotRequest.endSnapshotRequest(builder);
 }
 
 unpack(): SnapshotRequestT {
   return new SnapshotRequestT(
-    this.topic()
+    this.topic(),
+    this.fromSeq()
   );
 }
 
 
 unpackTo(_o: SnapshotRequestT): void {
   _o.topic = this.topic();
+  _o.fromSeq = this.fromSeq();
 }
 }
 
 export class SnapshotRequestT implements flatbuffers.IGeneratedObject {
 constructor(
-  public topic: string|Uint8Array|null = null
+  public topic: string|Uint8Array|null = null,
+  public fromSeq: bigint = BigInt('0')
 ){}
 
 
@@ -72,7 +85,8 @@ pack(builder:flatbuffers.Builder): flatbuffers.Offset {
   const topic = (this.topic !== null ? builder.createString(this.topic!) : 0);
 
   return SnapshotRequest.createSnapshotRequest(builder,
-    topic
+    topic,
+    this.fromSeq
   );
 }
 }

package/src/generated/ts-ser.ts

@@ -20,6 +20,10 @@ import {
   SnapshotRequestT,
   PingT,
   PongT,
+  ResumeT,
+  ResumedT,
+  RpcCallT,
+  RpcResultT,
 } from "./ts/backend";
 import { anyEventNameToId, WIRE_HEADER_LEN, WIRE_VERSION } from "./registry";
 import type { AnyEventName, ControlEvents, Events } from "../schema";
@@ -149,6 +153,7 @@ type LeaveGroupPlain = {
 
 type SnapshotRequestPlain = {
   topic: string;
+  fromSeq: number;
 };
 
 type PingPlain = {
@@ -159,6 +164,28 @@ type PongPlain = {
   ts: number;
 };
 
+type ResumePlain = {
+  lastSeq: number;
+};
+
+type ResumedPlain = {
+  ok: boolean;
+  from: number;
+};
+
+type RpcCallPlain = {
+  id: string;
+  name: string;
+  payloadB64: string;
+};
+
+type RpcResultPlain = {
+  id: string;
+  ok: boolean;
+  err: string;
+  payloadB64: string;
+};
+
 function buildQuoteT(o: QuotePlain): QuoteT {
   return new QuoteT(
     o.symbol,
@@ -306,6 +333,7 @@ function buildLeaveGroupT(o: LeaveGroupPlain): LeaveGroupT {
 function buildSnapshotRequestT(o: SnapshotRequestPlain): SnapshotRequestT {
   return new SnapshotRequestT(
     o.topic,
+    o.fromSeq === undefined ? 0n : BigInt(o.fromSeq),
   );
 }
 
@@ -321,6 +349,36 @@ function buildPongT(o: PongPlain): PongT {
   );
 }
 
+function buildResumeT(o: ResumePlain): ResumeT {
+  return new ResumeT(
+    o.lastSeq === undefined ? 0n : BigInt(o.lastSeq),
+  );
+}
+
+function buildResumedT(o: ResumedPlain): ResumedT {
+  return new ResumedT(
+    o.ok,
+    o.from === undefined ? 0n : BigInt(o.from),
+  );
+}
+
+function buildRpcCallT(o: RpcCallPlain): RpcCallT {
+  return new RpcCallT(
+    o.id,
+    o.name,
+    o.payloadB64,
+  );
+}
+
+function buildRpcResultT(o: RpcResultPlain): RpcResultT {
+  return new RpcResultT(
+    o.id,
+    o.ok,
+    o.err,
+    o.payloadB64,
+  );
+}
+
 /** payload encoder: plain object → size-prefixed FlatBuffer. */
 export function encodeQuotePayload(o: Events["quote"], b: flatbuffers.Builder = getBuilder()): Uint8Array {
   b.clear();
@@ -426,24 +484,56 @@ export function encodePongPayload(o: ControlEvents["pong"], b: flatbuffers.Build
   return b.asUint8Array();
 }
 
+/** control payload encoder: plain object → size-prefixed FlatBuffer. */
+export function encodeResumePayload(o: ControlEvents["resume"], b: flatbuffers.Builder = getBuilder()): Uint8Array {
+  b.clear();
+  b.finishSizePrefixed(buildResumeT(o).pack(b));
+  return b.asUint8Array();
+}
+
+/** control payload encoder: plain object → size-prefixed FlatBuffer. */
+export function encodeResumedPayload(o: ControlEvents["resumed"], b: flatbuffers.Builder = getBuilder()): Uint8Array {
+  b.clear();
+  b.finishSizePrefixed(buildResumedT(o).pack(b));
+  return b.asUint8Array();
+}
+
+/** control payload encoder: plain object → size-prefixed FlatBuffer. */
+export function encodeRpcCallPayload(o: ControlEvents["rpcCall"], b: flatbuffers.Builder = getBuilder()): Uint8Array {
+  b.clear();
+  b.finishSizePrefixed(buildRpcCallT(o).pack(b));
+  return b.asUint8Array();
+}
+
+/** control payload encoder: plain object → size-prefixed FlatBuffer. */
+export function encodeRpcResultPayload(o: ControlEvents["rpcResult"], b: flatbuffers.Builder = getBuilder()): Uint8Array {
+  b.clear();
+  b.finishSizePrefixed(buildRpcResultT(o).pack(b));
+  return b.asUint8Array();
+}
+
 export type JsEncoder = (o: unknown, b?: flatbuffers.Builder) => Uint8Array;
 
 export const jsEncoders: Record<string, JsEncoder> = {
-  quote: encodeQuotePayload as JsEncoder,
-  trade: encodeTradePayload as JsEncoder,
-  portfolio: encodePortfolioPayload as JsEncoder,
-  complex: encodeComplexPayload as JsEncoder,
-  order: encodeOrderPayload as JsEncoder,
-  bigVal: encodeBigValPayload as JsEncoder,
-  hello: encodeHelloPayload as JsEncoder,
-  welcome: encodeWelcomePayload as JsEncoder,
-  subscribe: encodeSubscribePayload as JsEncoder,
-  unsubscribe: encodeUnsubscribePayload as JsEncoder,
-  joinGroup: encodeJoinGroupPayload as JsEncoder,
-  leaveGroup: encodeLeaveGroupPayload as JsEncoder,
-  snapshotRequest: encodeSnapshotRequestPayload as JsEncoder,
-  ping: encodePingPayload as JsEncoder,
-  pong: encodePongPayload as JsEncoder,
+  "quote": encodeQuotePayload as JsEncoder,
+  "trade": encodeTradePayload as JsEncoder,
+  "portfolio": encodePortfolioPayload as JsEncoder,
+  "complex": encodeComplexPayload as JsEncoder,
+  "order": encodeOrderPayload as JsEncoder,
+  "bigVal": encodeBigValPayload as JsEncoder,
+  "hello": encodeHelloPayload as JsEncoder,
+  "welcome": encodeWelcomePayload as JsEncoder,
+  "subscribe": encodeSubscribePayload as JsEncoder,
+  "unsubscribe": encodeUnsubscribePayload as JsEncoder,
+  "joinGroup": encodeJoinGroupPayload as JsEncoder,
+  "leaveGroup": encodeLeaveGroupPayload as JsEncoder,
+  "snapshotRequest": encodeSnapshotRequestPayload as JsEncoder,
+  "ping": encodePingPayload as JsEncoder,
+  "pong": encodePongPayload as JsEncoder,
+  "resume": encodeResumePayload as JsEncoder,
+  "resumed": encodeResumedPayload as JsEncoder,
+  "rpcCall": encodeRpcCallPayload as JsEncoder,
+  "rpcResult": encodeRpcResultPayload as JsEncoder,
 };
 
 /** Encode a payload (app or control event) → size-prefixed FlatBuffer. */
@@ -453,13 +543,16 @@ export function encodeJsPayload(name: AnyEventName, o: unknown, b?: flatbuffers.
   return enc(o, b);
 }
 
-/** Encode a payload into a full wire frame `[version][event_id:u32][size-prefixed FB]`. */
+/** Encode a payload into a full wire frame `[version][event_id:u32][flags:1][seq:u64 LE][size-prefixed FB]`. */
 export function encodeEventFrame(name: AnyEventName, o: unknown, b?: flatbuffers.Builder): Uint8Array {
   const payload = encodeJsPayload(name, o, b);
   const id = anyEventNameToId[name]!;
   const frame = new Uint8Array(WIRE_HEADER_LEN + payload.byteLength);
   frame[0] = WIRE_VERSION;
   new DataView(frame.buffer).setUint32(1, id, true);
+  // pristine delivery header (flags=0, seq=0) — client-sent frames are not stamped
+  frame[WIRE_HEADER_LEN - 9] = 0;
+  new DataView(frame.buffer).setBigUint64(WIRE_HEADER_LEN - 8, 0n, true);
   frame.set(payload, WIRE_HEADER_LEN);
   return frame;
 }

package/src/generated/wire-registry.json

@@ -1,6 +1,6 @@
 {
-  "version": 1,
-  "fingerprint": 1656642724,
+  "version": 2,
+  "fingerprint": 3647747841,
   "events": {
     "quote": 2995289047,
     "trade": 1362521689,
@@ -16,6 +16,10 @@
     "leaveGroup": 3755061443,
     "snapshotRequest": 1249175018,
     "ping": 375255177,
-    "pong": 2061178551
+    "pong": 2061178551,
+    "resume": 4281967466,
+    "resumed": 3585847050,
+    "rpcCall": 986404564,
+    "rpcResult": 648609069
   }
 }

package/src/schema/index.ts

@@ -183,7 +183,14 @@ export const JoinGroup = Type.Object({ group: Type.String() }, { additionalPrope
 export const LeaveGroup = Type.Object({ group: Type.String() }, { additionalProperties: false });
 
 export const SnapshotRequest = Type.Object(
-  { topic: Type.String() },
+  {
+    topic: Type.String(),
+    /**
+     * Resume point: serve recorded history STRICTLY AFTER this topic seq
+     * (0 = from the beginning of retained history — the v1 behavior).
+     */
+    fromSeq: Type.Integer(),
+  },
   { additionalProperties: false },
 );
 
@@ -191,6 +198,39 @@ export const Ping = Type.Object({ ts: Type.Integer() }, { additionalProperties:
 
 export const Pong = Type.Object({ ts: Type.Integer() }, { additionalProperties: false });
 
+/**
+ * Client → server: resume missed delivery-seq frames after a gap or
+ * reconnect. The server replays everything it still holds strictly after
+ * `lastSeq` from the per-connection history ring, prefixed by a `resumed`
+ * control frame (`ok:false` when the hole is older than the ring).
+ */
+export const Resume = Type.Object(
+  { lastSeq: Type.Integer() }, // last CONTIGUOUS delivery seq the client has
+  { additionalProperties: false },
+);
+
+/** Server → client: ack before replayed frames (`ok:false` → resubscribe topics). */
+export const Resumed = Type.Object(
+  { ok: Type.Boolean(), from: Type.Integer() }, // first seq being replayed
+  { additionalProperties: false },
+);
+
+/**
+ * Request/response over the event wire (correlation id + timeout live on the
+ * caller side). `name` is the app-event name being requested; `payload` is the
+ * base64 of a full wire frame encoded with that same event's schema — the
+ * response reuses the SAME event schema both directions.
+ */
+export const RpcCall = Type.Object(
+  { id: Type.String(), name: Type.String(), payloadB64: Type.String() },
+  { additionalProperties: false },
+);
+
+export const RpcResult = Type.Object(
+  { id: Type.String(), ok: Type.Boolean(), err: Type.String(), payloadB64: Type.String() },
+  { additionalProperties: false },
+);
+
 /** Server→client identity assignment (sent right after `hello` on open). */
 export const Welcome = Type.Object(
   {
@@ -211,6 +251,10 @@ export const controlEvents = {
   snapshotRequest: SnapshotRequest,
   ping: Ping,
   pong: Pong,
+  resume: Resume,
+  resumed: Resumed,
+  rpcCall: RpcCall,
+  rpcResult: RpcResult,
 } as const;
 
 export type EventName = keyof typeof events;