statewire 0.8.1 → 0.9.0

package/dist/transports/fixtures.js

@@ -1,4 +1,4 @@
-import { useStatewireCommands, useStatewireEmit, useStatewireState } from "../host/host.js";
+import { useStatewireCommands, useStatewireState } from "../host/host.js";
 import "../host.js";
 import { tick } from "./testing.js";
 import { resource } from "@assistant-ui/tap";
@@ -10,21 +10,19 @@ const settle = async () => {
 /** A minimal statewire host element: `{ count }` state with an `increment` command. */
 const createCounterElement = () => resource(() => {
 	const [state] = useStatewireState(() => ({ count: 0 }));
-	const emit = useStatewireEmit();
 	return {
 		state,
 		commands: useStatewireCommands({ increment: () => {
 			state.count += 1;
-		} }),
-		emit
+		} })
 	};
 })();
-/** Serialize a command frame as a client would send it over a socket. */
-const commandFrame = (method, seq, params = []) => JSON.stringify({
+/** Serialize a one-statement cmd-lane frame as a client would send it. */
+const commandFrame = (method, seq, params = []) => JSON.stringify({ cmd: [{
 	method,
 	params,
 	seq
-});
+}] });
 /** Record sent frames and close calls; `last()` parses the latest frame. */
 const createSocketRecorder = () => {
 	const sent = [];

package/dist/transports/fixtures.js.map

@@ -1 +1 @@
-{"version":3,"file":"fixtures.js","names":["resource","useStatewireCommands","useStatewireEmit","useStatewireState","tick","settle","i","createCounterElement","state","count","emit","commands","increment","commandFrame","method","seq","params","JSON","stringify","SocketRecorder","sent","closes","code","reason","last","send","data","close","createSocketRecorder","parse","at","push","undefined"],"sources":["../../src/transports/fixtures.ts"],"sourcesContent":["import { resource } from \"@assistant-ui/tap\";\nimport {\n  useStatewireCommands,\n  useStatewireEmit,\n  useStatewireState,\n} from \"../host\";\nimport { tick } from \"./testing\";\n\n/** Let several rounds of queued microtasks and op batches drain. */\nexport const settle = async () => {\n  for (let i = 0; i < 3; i++) await tick();\n};\n\n/** A minimal statewire host element: `{ count }` state with an `increment` command. */\nexport const createCounterElement = () =>\n  resource(() => {\n    const [state] = useStatewireState(() => ({ count: 0 }));\n    const emit = useStatewireEmit();\n    const commands = useStatewireCommands({\n      increment: () => {\n        state.count += 1;\n      },\n    });\n    return { state, commands, emit };\n  })();\n\n/** Serialize a command frame as a client would send it over a socket. */\nexport const commandFrame = (\n  method: string,\n  seq: number,\n  params: unknown[] = [],\n) => JSON.stringify({ method, params, seq });\n\nexport type SocketRecorder = {\n  sent: string[];\n  closes: { code?: number; reason?: string }[];\n  last: () => any;\n  send: (data: string) => void;\n  close: (code?: number, reason?: string) => void;\n};\n\n/** Record sent frames and close calls; `last()` parses the latest frame. */\nexport const createSocketRecorder = (): SocketRecorder => {\n  const sent: string[] = [];\n  const closes: { code?: number; reason?: string }[] = [];\n  return {\n    sent,\n    closes,\n    last: () => JSON.parse(sent.at(-1)!),\n    send: (data) => {\n      sent.push(data);\n    },\n    close: (code, reason) => {\n      closes.push({\n        ...(code !== undefined && { code }),\n        ...(reason !== undefined && { reason }),\n      });\n    },\n  };\n};\n"],"mappings":";;;;;;AASA,MAAaK,SAAS,YAAY;CAChC,KAAK,IAAIC,IAAI,GAAGA,IAAI,GAAGA,KAAK,MAAMF,KAAK;AACzC;;AAGA,MAAaG,6BACXP,eAAe;CACb,MAAM,CAACQ,SAASL,yBAAyB,EAAEM,OAAO,EAAE,EAAE;CACtD,MAAMC,OAAOR,iBAAiB;CAM9B,OAAO;EAAEM;EAAOG,UALCV,qBAAqB,EACpCW,iBAAiB;GACfJ,MAAMC,SAAS;EACjB,EACF,CACgBE;EAAUD;CAAK;AACjC,CAAC,CAAC,CAAC;;AAGL,MAAaG,gBACXC,QACAC,KACAC,SAAoB,CAAA,MACjBC,KAAKC,UAAU;CAAEJ;CAAQE;CAAQD;AAAI,CAAC;;AAW3C,MAAaa,6BAA6C;CACxD,MAAMR,OAAiB,CAAA;CACvB,MAAMC,SAA+C,CAAA;CACrD,OAAO;EACLD;EACAC;EACAG,YAAYP,KAAKY,MAAMT,KAAKU,GAAG,EAAE,CAAE;EACnCL,OAAOC,SAAS;GACdN,KAAKW,KAAKL,IAAI;EAChB;EACAC,QAAQL,MAAMC,WAAW;GACvBF,OAAOU,KAAK;IACV,GAAIT,SAASU,KAAAA,KAAa,EAAEV,KAAK;IACjC,GAAIC,WAAWS,KAAAA,KAAa,EAAET,OAAO;GACvC,CAAC;EACH;CACF;AACF"}
+{"version":3,"file":"fixtures.js","names":["resource","useStatewireCommands","useStatewireState","tick","settle","i","createCounterElement","state","count","commands","increment","commandFrame","method","seq","params","JSON","stringify","cmd","SocketRecorder","sent","closes","code","reason","last","send","data","close","createSocketRecorder","parse","at","push","undefined"],"sources":["../../src/transports/fixtures.ts"],"sourcesContent":["import { resource } from \"@assistant-ui/tap\";\nimport { useStatewireCommands, useStatewireState } from \"../host\";\nimport { tick } from \"./testing\";\n\n/** Let several rounds of queued microtasks and op batches drain. */\nexport const settle = async () => {\n  for (let i = 0; i < 3; i++) await tick();\n};\n\n/** A minimal statewire host element: `{ count }` state with an `increment` command. */\nexport const createCounterElement = () =>\n  resource(() => {\n    const [state] = useStatewireState(() => ({ count: 0 }));\n    const commands = useStatewireCommands({\n      increment: () => {\n        state.count += 1;\n      },\n    });\n    return { state, commands };\n  })();\n\n/** Serialize a one-statement cmd-lane frame as a client would send it. */\nexport const commandFrame = (\n  method: string,\n  seq: number,\n  params: unknown[] = [],\n) => JSON.stringify({ cmd: [{ method, params, seq }] });\n\nexport type SocketRecorder = {\n  sent: string[];\n  closes: { code?: number; reason?: string }[];\n  last: () => any;\n  send: (data: string) => void;\n  close: (code?: number, reason?: string) => void;\n};\n\n/** Record sent frames and close calls; `last()` parses the latest frame. */\nexport const createSocketRecorder = (): SocketRecorder => {\n  const sent: string[] = [];\n  const closes: { code?: number; reason?: string }[] = [];\n  return {\n    sent,\n    closes,\n    last: () => JSON.parse(sent.at(-1)!),\n    send: (data) => {\n      sent.push(data);\n    },\n    close: (code, reason) => {\n      closes.push({\n        ...(code !== undefined && { code }),\n        ...(reason !== undefined && { reason }),\n      });\n    },\n  };\n};\n"],"mappings":";;;;;;AAKA,MAAaI,SAAS,YAAY;CAChC,KAAK,IAAIC,IAAI,GAAGA,IAAI,GAAGA,KAAK,MAAMF,KAAK;AACzC;;AAGA,MAAaG,6BACXN,eAAe;CACb,MAAM,CAACO,SAASL,yBAAyB,EAAEM,OAAO,EAAE,EAAE;CAMtD,OAAO;EAAED;EAAOE,UALCR,qBAAqB,EACpCS,iBAAiB;GACfH,MAAMC,SAAS;EACjB,EACF,CACgBC;CAAS;AAC3B,CAAC,CAAC,CAAC;;AAGL,MAAaE,gBACXC,QACAC,KACAC,SAAoB,CAAA,MACjBC,KAAKC,UAAU,EAAEC,KAAK,CAAC;CAAEL;CAAQE;CAAQD;AAAI,CAAC,EAAE,CAAC;;AAWtD,MAAac,6BAA6C;CACxD,MAAMR,OAAiB,CAAA;CACvB,MAAMC,SAA+C,CAAA;CACrD,OAAO;EACLD;EACAC;EACAG,YAAYR,KAAKa,MAAMT,KAAKU,GAAG,EAAE,CAAE;EACnCL,OAAOC,SAAS;GACdN,KAAKW,KAAKL,IAAI;EAChB;EACAC,QAAQL,MAAMC,WAAW;GACvBF,OAAOU,KAAK;IACV,GAAIT,SAASU,KAAAA,KAAa,EAAEV,KAAK;IACjC,GAAIC,WAAWS,KAAAA,KAAa,EAAET,OAAO;GACvC,CAAC;EACH;CACF;AACF"}

package/dist/transports/remote.d.ts

@@ -6,7 +6,8 @@ import { StatewireSessionOptions } from "../client/session.js";
 declare const useStatewireRemote: <TOptions extends {
   url: string;
   onChange?: (connection: StatewireClient.Connection) => void;
-} & StatewireSessionOptions>(options: TOptions, useLink: (options: TOptions, ctx: StatewireRemoteProps) => RemoteLink) => Statewire<any, any, any>;
+  onDone?: () => void;
+} & StatewireSessionOptions>(options: TOptions, useLink: (options: TOptions, ctx: StatewireRemoteProps) => RemoteLink) => Statewire<any, any>;
 //#endregion
 export { useStatewireRemote };
 //# sourceMappingURL=remote.d.ts.map

package/dist/transports/remote.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remote.d.ts","names":[],"sources":["../../src/transports/remote.ts"],"mappings":";;;;;cAYa,qBACX;EACE;EACA,YAAY,YAAY,gBAAgB;IACtC,yBAEJ,SAAS,UACT,UAAU,SAAS,UAAU,KAAK,yBAAyB,eAC1D"}
+{"version":3,"file":"remote.d.ts","names":[],"sources":["../../src/transports/remote.ts"],"mappings":";;;;;cAWa,qBACX;EACE;EACA,YAAY,YAAY,gBAAgB;EACxC;IACE,yBAEJ,SAAS,UACT,UAAU,SAAS,UAAU,KAAK,yBAAyB,eAC1D"}

package/dist/transports/remote.js

@@ -1,18 +1,24 @@
-import { useStatewireEmit } from "../host/host.js";
 import { setContext, setTransport, useStatewireSession } from "../client/session.js";
 import { useEffect } from "@assistant-ui/tap/react-shim";
 //#region src/transports/remote.ts
 const useStatewireRemote = (options, useLink) => {
-	const emit = useStatewireEmit();
-	const s = useStatewireSession({ sessionStore: options.sessionStore }, emit);
+	const s = useStatewireSession({
+		sessionStore: options.sessionStore,
+		onDone: options.onDone
+	});
 	const conn = useLink(options, s.ctx);
 	useEffect(() => setTransport(s, conn), [s, conn]);
 	return {
 		state: s.canonical,
 		commands: s.commands,
-		emit,
 		connection: conn.connection,
 		source: s.source,
+		get durableSeq() {
+			return s.durableSeq;
+		},
+		get isBusy() {
+			return !s.idle;
+		},
 		setContext: (value) => setContext(s, value)
 	};
 };

package/dist/transports/remote.js.map

@@ -1 +1 @@
-{"version":3,"file":"remote.js","names":["useEffect","useStatewireEmit","Statewire","setContext","setTransport","useStatewireSession","StatewireSessionOptions","StatewireClient","RemoteLink","StatewireRemoteProps","useStatewireRemote","url","onChange","connection","Connection","options","TOptions","useLink","ctx","emit","s","sessionStore","conn","state","canonical","commands","source","value"],"sources":["../../src/transports/remote.ts"],"sourcesContent":["import { useEffect } from \"react\";\nimport { useStatewireEmit } from \"../host/host\";\nimport type { Statewire } from \"../types\";\nimport {\n  setContext,\n  setTransport,\n  useStatewireSession,\n} from \"../client/session\";\nimport type { StatewireSessionOptions } from \"../client/session\";\nimport type { StatewireClient } from \"../statewire\";\nimport type { RemoteLink, StatewireRemoteProps } from \"./sse\";\n\nexport const useStatewireRemote = <\n  TOptions extends {\n    url: string;\n    onChange?: (connection: StatewireClient.Connection) => void;\n  } & StatewireSessionOptions,\n>(\n  options: TOptions,\n  useLink: (options: TOptions, ctx: StatewireRemoteProps) => RemoteLink,\n): Statewire<any, any, any> => {\n  const emit = useStatewireEmit<any>();\n  const s = useStatewireSession({ sessionStore: options.sessionStore }, emit);\n  const conn = useLink(options, s.ctx);\n  useEffect(() => setTransport(s, conn), [s, conn]);\n\n  return {\n    state: s.canonical,\n    commands: s.commands,\n    emit,\n    connection: conn.connection,\n    source: s.source,\n    setContext: (value) => setContext(s, value),\n  };\n};\n"],"mappings":";;;;AAYA,MAAaU,sBAMXK,SACAE,YAC6B;CAC7B,MAAME,OAAOlB,iBAAsB;CACnC,MAAMmB,IAAIf,oBAAoB,EAAEgB,cAAcN,QAAQM,aAAa,GAAGF,IAAI;CAC1E,MAAMG,OAAOL,QAAQF,SAASK,EAAEF,GAAG;CACnClB,gBAAgBI,aAAagB,GAAGE,IAAI,GAAG,CAACF,GAAGE,IAAI,CAAC;CAEhD,OAAO;EACLC,OAAOH,EAAEI;EACTC,UAAUL,EAAEK;EACZN;EACAN,YAAYS,KAAKT;EACjBa,QAAQN,EAAEM;EACVvB,aAAawB,UAAUxB,WAAWiB,GAAGO,KAAK;CAC5C;AACF"}
+{"version":3,"file":"remote.js","names":["useEffect","Statewire","setContext","setTransport","useStatewireSession","StatewireSessionOptions","StatewireClient","RemoteLink","StatewireRemoteProps","useStatewireRemote","url","onChange","connection","Connection","onDone","options","TOptions","useLink","ctx","s","sessionStore","conn","state","canonical","commands","source","durableSeq","isBusy","idle","value"],"sources":["../../src/transports/remote.ts"],"sourcesContent":["import { useEffect } from \"react\";\nimport type { Statewire } from \"../types\";\nimport {\n  setContext,\n  setTransport,\n  useStatewireSession,\n} from \"../client/session\";\nimport type { StatewireSessionOptions } from \"../client/session\";\nimport type { StatewireClient } from \"../statewire\";\nimport type { RemoteLink, StatewireRemoteProps } from \"./sse\";\n\nexport const useStatewireRemote = <\n  TOptions extends {\n    url: string;\n    onChange?: (connection: StatewireClient.Connection) => void;\n    onDone?: () => void;\n  } & StatewireSessionOptions,\n>(\n  options: TOptions,\n  useLink: (options: TOptions, ctx: StatewireRemoteProps) => RemoteLink,\n): Statewire<any, any> => {\n  const s = useStatewireSession({\n    sessionStore: options.sessionStore,\n    onDone: options.onDone,\n  });\n  const conn = useLink(options, s.ctx);\n  useEffect(() => setTransport(s, conn), [s, conn]);\n\n  return {\n    state: s.canonical,\n    commands: s.commands,\n    connection: conn.connection,\n    source: s.source,\n    get durableSeq() {\n      return s.durableSeq;\n    },\n    get isBusy() {\n      return !s.idle;\n    },\n    setContext: (value) => setContext(s, value),\n  };\n};\n"],"mappings":";;;AAWA,MAAaS,sBAOXM,SACAE,YACwB;CACxB,MAAME,IAAIf,oBAAoB;EAC5BgB,cAAcL,QAAQK;EACtBN,QAAQC,QAAQD;CAClB,CAAC;CACD,MAAMO,OAAOJ,QAAQF,SAASI,EAAED,GAAG;CACnClB,gBAAgBG,aAAagB,GAAGE,IAAI,GAAG,CAACF,GAAGE,IAAI,CAAC;CAEhD,OAAO;EACLC,OAAOH,EAAEI;EACTC,UAAUL,EAAEK;EACZZ,YAAYS,KAAKT;EACjBa,QAAQN,EAAEM;EACV,IAAIC,aAAa;GACf,OAAOP,EAAEO;EACX;EACA,IAAIC,SAAS;GACX,OAAO,CAACR,EAAES;EACZ;EACA1B,aAAa2B,UAAU3B,WAAWiB,GAAGU,KAAK;CAC5C;AACF"}

package/dist/transports/sse.d.ts

@@ -1,74 +1,60 @@
 import { StatewireClient } from "../statewire.js";
 import { Statewire } from "../types.js";
-import { StatewireMetaEntry } from "../wire/meta.js";
 import { StatewireHost } from "../host.js";
-import { StatewireResponse } from "../client/connection.js";
+import { StatewireCmd, StatewireSyn } from "../client/connection.js";
 import { ResourceElement } from "@assistant-ui/tap";
 //#region src/transports/sse.d.ts
+/** A client frame's lanes: stamped statements, strictly consecutive per lane. */
+type StatewireFrame = {
+  ctx?: {
+    ops: unknown[];
+    seq: number;
+  }[];
+  cmd?: {
+    method: string;
+    params: unknown[];
+    meta?: unknown;
+    seq: number;
+  }[];
+};
 type StatewireRemoteProps = {
   clientId: string;
-  onSnapshot: (args: {
+  /** Lanes to ride the attach frame (no-lease supersession only); records the included seqs. */
+  takeAttachLanes: () => StatewireFrame | null;
+  onHello: (args: {
     ops: unknown[];
-    lastSeq: number;
+    syn: StatewireSyn;
   }) => void;
   onOps: (args: {
     ops: unknown[];
-    res?: StatewireResponse[];
-    ack?: number;
+    cmds: StatewireCmd[];
   }) => void;
+  onCmds: (cmds: StatewireCmd[]) => void;
+  onRefusal: (syn: StatewireSyn) => void;
+  onIdle: (level: boolean) => void;
+  onDetach: () => void;
   onFinish: (args: StatewireHost.Fin) => void;
 };
-type StatewireWireCommand = {
-  method: string;
-  params: readonly unknown[];
-  context?: never;
-} | {
-  method?: never;
-  params?: never;
-  context: Record<string, unknown>;
-};
-/** The wire shape of a client context submission: one root replace op. */
-declare const contextOps: (value: Record<string, unknown>) => {
-  op: string;
-  path: never[];
-  value: Record<string, unknown>;
-}[];
-declare const encodeWireCommand: (command: StatewireWireCommand) => {
-  context?: {
-    op: string;
-    path: never[];
-    value: Record<string, unknown>;
-  }[];
-  params?: unknown[];
-  meta?: StatewireMetaEntry[];
-  method?: string;
-};
 type StatewireSubmitResult = {
-  type: "receipt";
-  response?: StatewireResponse;
-} | {
-  type: "rejected";
-  message: string;
+  type: "ok";
 } | {
-  type: "seq-gap";
-} | {
-  type: "unknown-client";
+  type: "refusal";
+  syn: StatewireSyn;
 } | {
   type: "stale-lease";
+} | {
+  type: "no-lease";
 };
 type ConnectionState = StatewireClient.ConnectionState;
-/** The live wire a remote session drives: connection status plus command POST. */
+/** The live wire a remote session drives: connection status plus frame submission. */
 type RemoteLink = {
   connection: StatewireClient.Connection;
-  send: (args: {
-    seq: number;
-    command: StatewireWireCommand;
-  }) => Promise<StatewireSubmitResult>;
+  send: (frame: StatewireFrame) => Promise<StatewireSubmitResult>;
 };
 type AuthState = {
   stale: boolean;
 };
-declare const StatewireSSE: <TState = any, TCommands extends Statewire.Commands = Statewire.Commands, TEvent = any>(options: StatewireClient.SSEOptions) => ResourceElement<Statewire<TState | undefined, TCommands, TEvent>>;
+declare const StatewireSSE: <TState = any, TCommands extends Statewire.Commands = Statewire.Commands>(options: StatewireClient.SSEOptions) => ResourceElement<Statewire<TState | undefined, TCommands>>;
 //#endregion
-export { AuthState, ConnectionState, RemoteLink, StatewireRemoteProps, StatewireSSE, StatewireSubmitResult, StatewireWireCommand, contextOps, encodeWireCommand };
+export { AuthState, ConnectionState, RemoteLink, StatewireFrame, StatewireRemoteProps, StatewireSSE, StatewireSubmitResult };
 //# sourceMappingURL=sse.d.ts.map

package/dist/transports/sse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sse.d.ts","names":[],"sources":["../../src/transports/sse.ts"],"mappings":";;;;;;;KAuBY;EACV;EACA,aAAa;IAAQ;IAAgB;;EACrC,QAAQ;IACN;IACA,MAAM;IACN;;EAEF,WAAW,MAAM,cAAc;;KAGrB;EACN;EAAgB;EAA4B;;EAC5C;EAAgB;EAAgB,SAAS;;;cAGlC,aAAc,OAAO;;;SAAA;;cAIrB,oBAAqB,SAAS;;;;;;;;;;KAU/B;EACN;EAAiB,WAAW;;EAC5B;EAAkB;;EAClB;;EACA;;EACA;;KAEM,kBAAkB,gBAAgB;;KAGlC;EACV,YAAY,gBAAgB;EAC5B,OAAO;IACL;IACA,SAAS;QACL,QAAQ;;KAMJ;EAAc;;cAsOb,eACX,cACA,kBAAkB,UAAU,WAAW,UAAU,UACjD,cAEA,SAAS,gBAAgB,eACtB,gBAAgB,UAAU,oBAAoB,WAAW"}
+{"version":3,"file":"sse.d.ts","names":[],"sources":["../../src/transports/sse.ts"],"mappings":";;;;;;;KAuBY;EACV;IAAQ;IAAgB;;EACxB;IAAQ;IAAgB;IAAmB;IAAgB;;;KAGjD;EACV;;EAEA,uBAAuB;EACvB,UAAU;IAAQ;IAAgB,KAAK;;EACvC,QAAQ;IAAQ;IAAgB,MAAM;;EACtC,SAAS,MAAM;EACf,YAAY,KAAK;EACjB,SAAS;EACT;EACA,WAAW,MAAM,cAAc;;KAGrB;EACN;;EACA;EAAiB,KAAK;;EACtB;;EACA;;KAEM,kBAAkB,gBAAgB;;KAGlC;EACV,YAAY,gBAAgB;EAC5B,OAAO,OAAO,mBAAmB,QAAQ;;KAQ/B;EAAc;;cAqOb,eACX,cACA,kBAAkB,UAAU,WAAW,UAAU,UAEjD,SAAS,gBAAgB,eACtB,gBAAgB,UAAU,oBAAoB"}

package/dist/transports/sse.js

@@ -1,28 +1,18 @@
-import { encodeParams, reviveResponse } from "../wire/meta.js";
 import { createSseParser } from "./sse-parser.js";
 import { timing } from "../client/timing.js";
-import { classify, handleEnvelope, overloadedError, parseRetryAfter, useStatewireConn } from "../client/connection.js";
+import { classify, handleEnvelope, useStatewireConn } from "../client/connection.js";
 import { useStatewireRemote } from "./remote.js";
 import { useRef, useState } from "@assistant-ui/tap/react-shim";
 import { flushTapSync, resource } from "@assistant-ui/tap";
 //#region src/transports/sse.ts
-/** The wire shape of a client context submission: one root replace op. */
-const contextOps = (value) => [{
-	op: "replace",
-	path: [],
-	value
-}];
-const encodeWireCommand = (command) => ({
-	...command.method !== void 0 && {
-		method: command.method,
-		...encodeParams(command.params)
-	},
-	...command.context !== void 0 && { context: contextOps(command.context) }
-});
+const LEASE_HEADER = "Statewire-Lease";
 const baseUrl = (options) => options.url.replace(/\/$/, "");
-const requestHeaders = async (options, extra, ctx) => {
+const resolveHeaders = async (options, ctx) => {
 	const { headers } = options;
-	const merged = new Headers(typeof headers === "function" ? await headers(ctx) : headers);
+	return new Headers(typeof headers === "function" ? await headers(ctx) : headers);
+};
+const withExtra = (headers, extra) => {
+	const merged = new Headers(headers);
 	for (const [name, value] of Object.entries(extra)) merged.set(name, value);
 	return merged;
 };
@@ -58,29 +48,38 @@ const consume = async (c, reader, heartbeat, dead) => {
 const attemptStream = async (c, options, auth, abort) => {
 	const stale = auth.stale;
 	auth.stale = false;
-	const headers = await requestHeaders(options, {
-		"Statewire-Client-Id": c.ctx.clientId,
-		accept: "text/event-stream"
-	}, { staleAuth: stale });
+	c.lease = null;
+	const userHeaders = await resolveHeaders(options, { staleAuth: stale });
+	const lanes = flushTapSync(() => c.ctx.takeAttachLanes());
+	const frame = {
+		headers: Object.fromEntries(userHeaders),
+		...lanes ?? {}
+	};
 	const heartbeat = new AbortController();
 	const headerTimer = setTimeout(() => heartbeat.abort(), timing.heartbeatTimeoutMs);
 	let res;
 	try {
 		res = await timedFetch(options, `${baseUrl(options)}/stream`, {
-			headers,
+			method: "POST",
+			headers: withExtra(userHeaders, {
+				"content-type": "application/json",
+				"Statewire-Client-Id": c.ctx.clientId,
+				accept: "text/event-stream"
+			}),
+			body: JSON.stringify(frame),
 			cache: "no-store",
 			signal: AbortSignal.any([abort.signal, heartbeat.signal])
 		}, heartbeat.signal);
 	} finally {
 		clearTimeout(headerTimer);
 	}
-	if (res.status === 429 || res.status === 503) throw overloaded(res);
 	if (res.status === 401) {
 		if (stale) c.episode = { cause: "unauthorized" };
 		auth.stale = true;
 		throw new Error("unauthorized");
 	}
 	if (!res.ok || !res.body) throw new Error(`HTTP ${res.status}`);
+	c.lease = res.headers.get(LEASE_HEADER);
 	const reader = res.body.getReader();
 	try {
 		return await consume(c, reader, heartbeat, () => abort.signal.aborted);
@@ -88,53 +87,51 @@ const attemptStream = async (c, options, auth, abort) => {
 		reader.cancel().catch(() => {});
 	}
 };
-const overloaded = (res) => overloadedError(parseRetryAfter(res.headers.get("Retry-After")));
-const postCommand = async (c, options, { seq, command }, timeout, stale) => timedFetch(options, `${baseUrl(options)}/commands`, {
+const postFrame = async (c, options, lease, frame, timeout, stale) => timedFetch(options, `${baseUrl(options)}/frames`, {
 	method: "POST",
-	headers: await requestHeaders(options, {
+	headers: withExtra(await resolveHeaders(options, { staleAuth: stale }), {
 		"content-type": "application/json",
 		"Statewire-Client-Id": c.ctx.clientId,
-		"Statewire-Command-Seq": String(seq),
-		...c.lease !== null && { "Statewire-Lease": c.lease }
-	}, { staleAuth: stale }),
-	body: JSON.stringify(encodeWireCommand(command)),
+		[LEASE_HEADER]: lease
+	}),
+	body: JSON.stringify(frame),
 	signal: AbortSignal.any([c.lifetime?.signal ?? AbortSignal.abort(), timeout])
 }, timeout);
-const sendCommand = async (c, options, auth, args) => {
+const retryAfterMs = (res) => {
+	const header = res.headers.get("retry-after")?.trim();
+	return header !== void 0 && /^\d+$/.test(header) ? Number(header) * 1e3 : null;
+};
+const refusalSyn = async (res) => {
+	const syn = (await res.json().catch(() => null))?.syn;
+	if (typeof syn !== "object" || syn === null) throw new Error(`HTTP ${res.status}`);
+	return syn;
+};
+const sendFrame = async (c, options, auth, frame) => {
+	const lease = c.lease;
+	if (lease === null) return { type: "no-lease" };
 	const timeout = AbortSignal.timeout(timing.heartbeatTimeoutMs);
-	let res = await postCommand(c, options, args, timeout, false);
-	if (res.status === 401 && typeof options.headers === "function") res = await postCommand(c, options, args, timeout, true);
-	if (res.ok) {
-		let body;
-		try {
-			body = await res.json();
-		} catch {
-			return {
-				type: "rejected",
-				message: "statewire: protocol error: malformed /commands receipt body"
-			};
-		}
-		return body?.res !== void 0 ? {
-			type: "receipt",
-			response: reviveResponse(body.res)
-		} : { type: "receipt" };
+	let res = await postFrame(c, options, lease, frame, timeout, false);
+	if (res.status === 401 && typeof options.headers === "function") res = await postFrame(c, options, lease, frame, timeout, true);
+	if (res.ok) return { type: "ok" };
+	if (res.status === 429 || res.status === 409) {
+		const headerRetry = res.status === 429 ? retryAfterMs(res) : null;
+		const syn = await refusalSyn(res).catch((error) => {
+			if (headerRetry === null) throw error;
+			return { retry: headerRetry };
+		});
+		if (syn.retry === void 0 && headerRetry !== null) syn.retry = headerRetry;
+		return {
+			type: "refusal",
+			syn
+		};
 	}
-	if (res.status === 429 || res.status === 503) throw overloaded(res);
+	if (res.status === 423) return { type: "stale-lease" };
 	if (res.status === 401) {
 		auth.stale = true;
 		c.episode = { cause: "unauthorized" };
 		c.connection.reconnect();
 		throw new Error("unauthorized");
 	}
-	const body = await res.json().catch(() => null);
-	if (body?.error === "rejected") return {
-		type: "rejected",
-		message: body.rejections?.[0]?.message ?? `HTTP ${res.status}`
-	};
-	if (res.status === 409 || res.status === 412 || res.status === 423) {
-		const verdict = res.status === 409 ? "seq-gap" : res.status === 412 ? "unknown-client" : "stale-lease";
-		if (body?.error === verdict) return { type: verdict };
-	}
 	throw new Error(`HTTP ${res.status}`);
 };
 const useSseLink = (options, ctx) => {
@@ -151,13 +148,13 @@ const useSseLink = (options, ctx) => {
 		get connection() {
 			return c_0.connection;
 		},
-		send: (args) => sendCommand(c_0, latest.current, auth, args)
+		send: (frame) => sendFrame(c_0, latest.current, auth, frame)
 	}));
 	return link;
 };
 const useStatewireSSE = (options) => useStatewireRemote(options, useSseLink);
 const StatewireSSE = resource(useStatewireSSE);
 //#endregion
-export { StatewireSSE, contextOps, encodeWireCommand };
+export { StatewireSSE };
 
 //# sourceMappingURL=sse.js.map

package/dist/transports/sse.js.map

@@ -1 +1 @@
-{"version":3,"file":"sse.js","names":["useRef","useState","flushTapSync","resource","ResourceElement","encodeParams","reviveResponse","createSseParser","timing","classify","handleEnvelope","overloadedError","parseRetryAfter","useStatewireConn","Conn","StatewireEnvelope","StatewireResponse","Statewire","StatewireClient","StatewireHost","useStatewireRemote","StatewireRemoteProps","clientId","onSnapshot","args","ops","lastSeq","onOps","res","ack","onFinish","Fin","StatewireWireCommand","method","params","context","Record","contextOps","value","op","path","encodeWireCommand","command","undefined","StatewireSubmitResult","type","response","message","ConnectionState","RemoteLink","connection","Connection","send","seq","Promise","baseUrl","options","SSEOptions","url","replace","AuthState","stale","requestHeaders","extra","ctx","staleAuth","headers","merged","Headers","name","Object","entries","set","timedFetch","input","init","RequestInit","signal","AbortSignal","timeout","Response","fetch","globalThis","consume","c","reader","ReadableStreamDefaultReader","Uint8Array","heartbeat","AbortController","dead","decoder","TextDecoder","parse","timer","setTimeout","abort","heartbeatTimeoutMs","result","ReadableStreamReadResult","read","clearTimeout","done","data","decode","stream","env","JSON","attemptStream","auth","accept","headerTimer","cache","any","status","overloaded","episode","cause","Error","ok","body","getReader","aborted","cancel","catch","get","postCommand","String","lease","stringify","lifetime","sendCommand","json","reconnect","error","rejections","verdict","const","useSseLink","latest","current","onChange","attemptOnce","link","useStatewireSSE","StatewireSSE","Commands","TState","TCommands","TEvent"],"sources":["../../src/transports/sse.ts"],"sourcesContent":["import { useRef, useState } from \"react\";\nimport { flushTapSync, resource } from \"@assistant-ui/tap\";\nimport type { ResourceElement } from \"@assistant-ui/tap\";\nimport { encodeParams, reviveResponse } from \"../wire/meta\";\nimport { createSseParser } from \"./sse-parser\";\nimport { timing } from \"../client/timing\";\nimport {\n  classify,\n  handleEnvelope,\n  overloadedError,\n  parseRetryAfter,\n  useStatewireConn,\n} from \"../client/connection\";\nimport type {\n  Conn,\n  StatewireEnvelope,\n  StatewireResponse,\n} from \"../client/connection\";\nimport type { Statewire } from \"../types\";\nimport type { StatewireClient } from \"../statewire\";\nimport type { StatewireHost } from \"../host\";\nimport { useStatewireRemote } from \"./remote\";\n\nexport type StatewireRemoteProps = {\n  clientId: string;\n  onSnapshot: (args: { ops: unknown[]; lastSeq: number }) => void;\n  onOps: (args: {\n    ops: unknown[];\n    res?: StatewireResponse[];\n    ack?: number;\n  }) => void;\n  onFinish: (args: StatewireHost.Fin) => void;\n};\n\nexport type StatewireWireCommand =\n  | { method: string; params: readonly unknown[]; context?: never }\n  | { method?: never; params?: never; context: Record<string, unknown> };\n\n/** The wire shape of a client context submission: one root replace op. */\nexport const contextOps = (value: Record<string, unknown>) => [\n  { op: \"replace\", path: [], value },\n];\n\nexport const encodeWireCommand = (command: StatewireWireCommand) => ({\n  ...(command.method !== undefined && {\n    method: command.method,\n    ...encodeParams(command.params),\n  }),\n  ...(command.context !== undefined && {\n    context: contextOps(command.context),\n  }),\n});\n\nexport type StatewireSubmitResult =\n  | { type: \"receipt\"; response?: StatewireResponse }\n  | { type: \"rejected\"; message: string }\n  | { type: \"seq-gap\" }\n  | { type: \"unknown-client\" }\n  | { type: \"stale-lease\" };\n\nexport type ConnectionState = StatewireClient.ConnectionState;\n\n/** The live wire a remote session drives: connection status plus command POST. */\nexport type RemoteLink = {\n  connection: StatewireClient.Connection;\n  send: (args: {\n    seq: number;\n    command: StatewireWireCommand;\n  }) => Promise<StatewireSubmitResult>;\n};\n\nconst baseUrl = (options: StatewireClient.SSEOptions) =>\n  options.url.replace(/\\/$/, \"\");\n\nexport type AuthState = { stale: boolean };\n\nconst requestHeaders = async (\n  options: StatewireClient.SSEOptions,\n  extra: Record<string, string>,\n  ctx: { staleAuth: boolean },\n) => {\n  const { headers } = options;\n  const merged = new Headers(\n    typeof headers === \"function\" ? await headers(ctx) : headers,\n  );\n  for (const [name, value] of Object.entries(extra)) merged.set(name, value);\n  return merged;\n};\n\nconst timedFetch = async (\n  options: StatewireClient.SSEOptions,\n  input: string,\n  init: RequestInit & { signal: AbortSignal },\n  timeout: AbortSignal,\n): Promise<Response> => {\n  try {\n    return await (options.fetch ?? globalThis.fetch)(input, init);\n  } catch {\n    throw classify(timeout);\n  }\n};\n\nconst consume = async (\n  c: Conn,\n  reader: ReadableStreamDefaultReader<Uint8Array>,\n  heartbeat: AbortController,\n  dead: () => boolean,\n): Promise<\"stop\" | \"reattach\" | \"ended\"> => {\n  const decoder = new TextDecoder();\n  const parse = createSseParser();\n  for (;;) {\n    const timer = setTimeout(\n      () => heartbeat.abort(),\n      timing.heartbeatTimeoutMs,\n    );\n    let result: ReadableStreamReadResult<Uint8Array>;\n    try {\n      result = await reader.read();\n    } catch {\n      throw classify(heartbeat.signal);\n    } finally {\n      clearTimeout(timer);\n    }\n    if (result.done) return \"ended\";\n    for (const data of parse(decoder.decode(result.value, { stream: true }))) {\n      if (dead()) return \"ended\";\n      const env = JSON.parse(data) as StatewireEnvelope;\n      const done = flushTapSync(() => handleEnvelope(c, env));\n      if (done) return done;\n    }\n  }\n};\n\nconst attemptStream = async (\n  c: Conn,\n  options: StatewireClient.SSEOptions,\n  auth: AuthState,\n  abort: AbortController,\n): Promise<\"stop\" | \"reattach\" | \"ended\"> => {\n  const stale = auth.stale;\n  auth.stale = false;\n  const headers = await requestHeaders(\n    options,\n    {\n      \"Statewire-Client-Id\": c.ctx.clientId,\n      accept: \"text/event-stream\",\n    },\n    { staleAuth: stale },\n  );\n  const heartbeat = new AbortController();\n  const headerTimer = setTimeout(\n    () => heartbeat.abort(),\n    timing.heartbeatTimeoutMs,\n  );\n  let res: Response;\n  try {\n    res = await timedFetch(\n      options,\n      `${baseUrl(options)}/stream`,\n      {\n        headers,\n        cache: \"no-store\",\n        signal: AbortSignal.any([abort.signal, heartbeat.signal]),\n      },\n      heartbeat.signal,\n    );\n  } finally {\n    clearTimeout(headerTimer);\n  }\n  if (res.status === 429 || res.status === 503) throw overloaded(res);\n  if (res.status === 401) {\n    if (stale) c.episode = { cause: \"unauthorized\" };\n    auth.stale = true;\n    throw new Error(\"unauthorized\");\n  }\n  if (!res.ok || !res.body) throw new Error(`HTTP ${res.status}`);\n  const reader = res.body.getReader();\n  try {\n    return await consume(c, reader, heartbeat, () => abort.signal.aborted);\n  } finally {\n    reader.cancel().catch(() => {});\n  }\n};\n\nconst overloaded = (res: Response) =>\n  overloadedError(parseRetryAfter(res.headers.get(\"Retry-After\")));\n\nconst postCommand = async (\n  c: Conn,\n  options: StatewireClient.SSEOptions,\n  { seq, command }: { seq: number; command: StatewireWireCommand },\n  timeout: AbortSignal,\n  stale: boolean,\n): Promise<Response> =>\n  timedFetch(\n    options,\n    `${baseUrl(options)}/commands`,\n    {\n      method: \"POST\",\n      headers: await requestHeaders(\n        options,\n        {\n          \"content-type\": \"application/json\",\n          \"Statewire-Client-Id\": c.ctx.clientId,\n          \"Statewire-Command-Seq\": String(seq),\n          ...(c.lease !== null && { \"Statewire-Lease\": c.lease }),\n        },\n        { staleAuth: stale },\n      ),\n      body: JSON.stringify(encodeWireCommand(command)),\n      signal: AbortSignal.any([\n        c.lifetime?.signal ?? AbortSignal.abort(),\n        timeout,\n      ]),\n    },\n    timeout,\n  );\n\nconst sendCommand = async (\n  c: Conn,\n  options: StatewireClient.SSEOptions,\n  auth: AuthState,\n  args: { seq: number; command: StatewireWireCommand },\n): Promise<StatewireSubmitResult> => {\n  const timeout = AbortSignal.timeout(timing.heartbeatTimeoutMs);\n  let res = await postCommand(c, options, args, timeout, false);\n  if (res.status === 401 && typeof options.headers === \"function\") {\n    res = await postCommand(c, options, args, timeout, true);\n  }\n  if (res.ok) {\n    let body: { res?: StatewireResponse } | null;\n    try {\n      body = (await res.json()) as { res?: StatewireResponse } | null;\n    } catch {\n      return {\n        type: \"rejected\",\n        message: \"statewire: protocol error: malformed /commands receipt body\",\n      };\n    }\n    return body?.res !== undefined\n      ? { type: \"receipt\", response: reviveResponse(body.res) }\n      : { type: \"receipt\" };\n  }\n  if (res.status === 429 || res.status === 503) throw overloaded(res);\n  if (res.status === 401) {\n    // Fresh credentials did not clear the 401: signal auth-failed on the\n    // connection and let the send retry as a transport fault.\n    auth.stale = true;\n    c.episode = { cause: \"unauthorized\" };\n    c.connection.reconnect();\n    throw new Error(\"unauthorized\");\n  }\n  // Bodies settle, statuses pace: only a statewire-shaped body carries a\n  // verdict; any bare status is middleware noise — a transport fault, retried.\n  const body = (await res.json().catch(() => null)) as {\n    error?: string;\n    rejections?: { message?: string }[];\n  } | null;\n  if (body?.error === \"rejected\") {\n    return {\n      type: \"rejected\",\n      message: body.rejections?.[0]?.message ?? `HTTP ${res.status}`,\n    };\n  }\n  if (res.status === 409 || res.status === 412 || res.status === 423) {\n    const verdict =\n      res.status === 409\n        ? (\"seq-gap\" as const)\n        : res.status === 412\n          ? (\"unknown-client\" as const)\n          : (\"stale-lease\" as const);\n    if (body?.error === verdict) return { type: verdict };\n  }\n  throw new Error(`HTTP ${res.status}`);\n};\n\nconst useSseLink = (\n  options: StatewireClient.SSEOptions,\n  ctx: StatewireRemoteProps,\n): RemoteLink => {\n  const latest = useRef(options);\n  latest.current = options;\n  const [auth] = useState((): AuthState => ({ stale: false }));\n  const c = useStatewireConn({\n    url: options.url,\n    onChange: options.onChange,\n    ctx,\n    attemptOnce: (c, abort) => attemptStream(c, options, auth, abort),\n  });\n  const [link] = useState(\n    (): RemoteLink => ({\n      get connection() {\n        return c.connection;\n      },\n      send: (args) => sendCommand(c, latest.current, auth, args),\n    }),\n  );\n  return link;\n};\n\nconst useStatewireSSE = (\n  options: StatewireClient.SSEOptions,\n): Statewire<any, any, any> => useStatewireRemote(options, useSseLink);\n\nexport const StatewireSSE = resource(useStatewireSSE) as <\n  TState = any,\n  TCommands extends Statewire.Commands = Statewire.Commands,\n  TEvent = any,\n>(\n  options: StatewireClient.SSEOptions,\n) => ResourceElement<Statewire<TState | undefined, TCommands, TEvent>>;\n"],"mappings":"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"}
+{"version":3,"file":"sse.js","names":["useRef","useState","flushTapSync","resource","ResourceElement","createSseParser","timing","classify","handleEnvelope","useStatewireConn","AttemptOutcome","Conn","StatewireCmd","StatewireEnvelope","StatewireSyn","Statewire","StatewireClient","StatewireHost","useStatewireRemote","StatewireFrame","ctx","ops","seq","cmd","method","params","meta","StatewireRemoteProps","clientId","takeAttachLanes","onHello","args","syn","onOps","cmds","onCmds","onRefusal","onIdle","level","onDetach","onFinish","Fin","StatewireSubmitResult","type","ConnectionState","RemoteLink","connection","Connection","send","frame","Promise","LEASE_HEADER","baseUrl","options","SSEOptions","url","replace","AuthState","stale","resolveHeaders","staleAuth","Headers","headers","withExtra","extra","Record","merged","name","value","Object","entries","set","timedFetch","input","init","RequestInit","signal","AbortSignal","timeout","Response","fetch","globalThis","consume","c","reader","ReadableStreamDefaultReader","Uint8Array","heartbeat","AbortController","dead","decoder","TextDecoder","parse","timer","setTimeout","abort","heartbeatTimeoutMs","result","ReadableStreamReadResult","read","clearTimeout","done","data","decode","stream","env","JSON","attemptStream","auth","lease","userHeaders","lanes","fromEntries","headerTimer","res","accept","body","stringify","cache","any","status","episode","cause","Error","ok","get","getReader","aborted","cancel","catch","postFrame","lifetime","retryAfterMs","header","trim","undefined","test","Number","refusalSyn","json","sendFrame","headerRetry","error","retry","reconnect","useSseLink","latest","current","onChange","attemptOnce","link","useStatewireSSE","StatewireSSE","Commands","TState","TCommands"],"sources":["../../src/transports/sse.ts"],"sourcesContent":["import { useRef, useState } from \"react\";\nimport { flushTapSync, resource } from \"@assistant-ui/tap\";\nimport type { ResourceElement } from \"@assistant-ui/tap\";\nimport { createSseParser } from \"./sse-parser\";\nimport { timing } from \"../client/timing\";\nimport {\n  classify,\n  handleEnvelope,\n  useStatewireConn,\n} from \"../client/connection\";\nimport type {\n  AttemptOutcome,\n  Conn,\n  StatewireCmd,\n  StatewireEnvelope,\n  StatewireSyn,\n} from \"../client/connection\";\nimport type { Statewire } from \"../types\";\nimport type { StatewireClient } from \"../statewire\";\nimport type { StatewireHost } from \"../host\";\nimport { useStatewireRemote } from \"./remote\";\n\n/** A client frame's lanes: stamped statements, strictly consecutive per lane. */\nexport type StatewireFrame = {\n  ctx?: { ops: unknown[]; seq: number }[];\n  cmd?: { method: string; params: unknown[]; meta?: unknown; seq: number }[];\n};\n\nexport type StatewireRemoteProps = {\n  clientId: string;\n  /** Lanes to ride the attach frame (no-lease supersession only); records the included seqs. */\n  takeAttachLanes: () => StatewireFrame | null;\n  onHello: (args: { ops: unknown[]; syn: StatewireSyn }) => void;\n  onOps: (args: { ops: unknown[]; cmds: StatewireCmd[] }) => void;\n  onCmds: (cmds: StatewireCmd[]) => void;\n  onRefusal: (syn: StatewireSyn) => void;\n  onIdle: (level: boolean) => void;\n  onDetach: () => void;\n  onFinish: (args: StatewireHost.Fin) => void;\n};\n\nexport type StatewireSubmitResult =\n  | { type: \"ok\" }\n  | { type: \"refusal\"; syn: StatewireSyn }\n  | { type: \"stale-lease\" }\n  | { type: \"no-lease\" };\n\nexport type ConnectionState = StatewireClient.ConnectionState;\n\n/** The live wire a remote session drives: connection status plus frame submission. */\nexport type RemoteLink = {\n  connection: StatewireClient.Connection;\n  send: (frame: StatewireFrame) => Promise<StatewireSubmitResult>;\n};\n\nconst LEASE_HEADER = \"Statewire-Lease\";\n\nconst baseUrl = (options: StatewireClient.SSEOptions) =>\n  options.url.replace(/\\/$/, \"\");\n\nexport type AuthState = { stale: boolean };\n\nconst resolveHeaders = async (\n  options: StatewireClient.SSEOptions,\n  ctx: { staleAuth: boolean },\n): Promise<Headers> => {\n  const { headers } = options;\n  return new Headers(\n    typeof headers === \"function\" ? await headers(ctx) : headers,\n  );\n};\n\nconst withExtra = (headers: Headers, extra: Record<string, string>) => {\n  const merged = new Headers(headers);\n  for (const [name, value] of Object.entries(extra)) merged.set(name, value);\n  return merged;\n};\n\nconst timedFetch = async (\n  options: StatewireClient.SSEOptions,\n  input: string,\n  init: RequestInit & { signal: AbortSignal },\n  timeout: AbortSignal,\n): Promise<Response> => {\n  try {\n    return await (options.fetch ?? globalThis.fetch)(input, init);\n  } catch {\n    throw classify(timeout);\n  }\n};\n\nconst consume = async (\n  c: Conn,\n  reader: ReadableStreamDefaultReader<Uint8Array>,\n  heartbeat: AbortController,\n  dead: () => boolean,\n): Promise<AttemptOutcome> => {\n  const decoder = new TextDecoder();\n  const parse = createSseParser();\n  for (;;) {\n    const timer = setTimeout(\n      () => heartbeat.abort(),\n      timing.heartbeatTimeoutMs,\n    );\n    let result: ReadableStreamReadResult<Uint8Array>;\n    try {\n      result = await reader.read();\n    } catch {\n      throw classify(heartbeat.signal);\n    } finally {\n      clearTimeout(timer);\n    }\n    if (result.done) return \"ended\";\n    for (const data of parse(decoder.decode(result.value, { stream: true }))) {\n      if (dead()) return \"ended\";\n      const env = JSON.parse(data) as StatewireEnvelope;\n      const done = flushTapSync(() => handleEnvelope(c, env));\n      if (done) return done;\n    }\n  }\n};\n\nconst attemptStream = async (\n  c: Conn,\n  options: StatewireClient.SSEOptions,\n  auth: AuthState,\n  abort: AbortController,\n): Promise<AttemptOutcome> => {\n  const stale = auth.stale;\n  auth.stale = false;\n  c.lease = null;\n  const userHeaders = await resolveHeaders(options, { staleAuth: stale });\n  const lanes = flushTapSync(() => c.ctx.takeAttachLanes());\n  const frame = {\n    headers: Object.fromEntries(userHeaders),\n    ...(lanes ?? {}),\n  };\n  const heartbeat = new AbortController();\n  const headerTimer = setTimeout(\n    () => heartbeat.abort(),\n    timing.heartbeatTimeoutMs,\n  );\n  let res: Response;\n  try {\n    res = await timedFetch(\n      options,\n      `${baseUrl(options)}/stream`,\n      {\n        method: \"POST\",\n        headers: withExtra(userHeaders, {\n          \"content-type\": \"application/json\",\n          \"Statewire-Client-Id\": c.ctx.clientId,\n          accept: \"text/event-stream\",\n        }),\n        body: JSON.stringify(frame),\n        cache: \"no-store\",\n        signal: AbortSignal.any([abort.signal, heartbeat.signal]),\n      },\n      heartbeat.signal,\n    );\n  } finally {\n    clearTimeout(headerTimer);\n  }\n  if (res.status === 401) {\n    if (stale) c.episode = { cause: \"unauthorized\" };\n    auth.stale = true;\n    throw new Error(\"unauthorized\");\n  }\n  if (!res.ok || !res.body) throw new Error(`HTTP ${res.status}`);\n  c.lease = res.headers.get(LEASE_HEADER);\n  const reader = res.body.getReader();\n  try {\n    return await consume(c, reader, heartbeat, () => abort.signal.aborted);\n  } finally {\n    reader.cancel().catch(() => {});\n  }\n};\n\nconst postFrame = async (\n  c: Conn,\n  options: StatewireClient.SSEOptions,\n  lease: string,\n  frame: StatewireFrame,\n  timeout: AbortSignal,\n  stale: boolean,\n): Promise<Response> =>\n  timedFetch(\n    options,\n    `${baseUrl(options)}/frames`,\n    {\n      method: \"POST\",\n      headers: withExtra(await resolveHeaders(options, { staleAuth: stale }), {\n        \"content-type\": \"application/json\",\n        \"Statewire-Client-Id\": c.ctx.clientId,\n        [LEASE_HEADER]: lease,\n      }),\n      body: JSON.stringify(frame),\n      signal: AbortSignal.any([\n        c.lifetime?.signal ?? AbortSignal.abort(),\n        timeout,\n      ]),\n    },\n    timeout,\n  );\n\n// Delta-seconds only; anything else reads as absent.\nconst retryAfterMs = (res: Response): number | null => {\n  const header = res.headers.get(\"retry-after\")?.trim();\n  return header !== undefined && /^\\d+$/.test(header)\n    ? Number(header) * 1000\n    : null;\n};\n\nconst refusalSyn = async (res: Response): Promise<StatewireSyn> => {\n  const body = (await res.json().catch(() => null)) as {\n    syn?: StatewireSyn;\n  } | null;\n  const syn = body?.syn;\n  if (typeof syn !== \"object\" || syn === null) {\n    throw new Error(`HTTP ${res.status}`);\n  }\n  return syn;\n};\n\nconst sendFrame = async (\n  c: Conn,\n  options: StatewireClient.SSEOptions,\n  auth: AuthState,\n  frame: StatewireFrame,\n): Promise<StatewireSubmitResult> => {\n  const lease = c.lease;\n  if (lease === null) return { type: \"no-lease\" };\n  const timeout = AbortSignal.timeout(timing.heartbeatTimeoutMs);\n  let res = await postFrame(c, options, lease, frame, timeout, false);\n  if (res.status === 401 && typeof options.headers === \"function\") {\n    res = await postFrame(c, options, lease, frame, timeout, true);\n  }\n  if (res.ok) return { type: \"ok\" };\n  if (res.status === 429 || res.status === 409) {\n    // The syn body retry wins; Retry-After covers 429s minted below the host.\n    const headerRetry = res.status === 429 ? retryAfterMs(res) : null;\n    const syn: StatewireSyn = await refusalSyn(res).catch((error: unknown) => {\n      if (headerRetry === null) throw error;\n      return { retry: headerRetry };\n    });\n    if (syn.retry === undefined && headerRetry !== null)\n      syn.retry = headerRetry;\n    return { type: \"refusal\", syn };\n  }\n  if (res.status === 423) return { type: \"stale-lease\" };\n  if (res.status === 401) {\n    // Fresh credentials did not clear the 401: signal auth-failed on the\n    // connection and let the send retry as a transport fault.\n    auth.stale = true;\n    c.episode = { cause: \"unauthorized\" };\n    c.connection.reconnect();\n    throw new Error(\"unauthorized\");\n  }\n  throw new Error(`HTTP ${res.status}`);\n};\n\nconst useSseLink = (\n  options: StatewireClient.SSEOptions,\n  ctx: StatewireRemoteProps,\n): RemoteLink => {\n  const latest = useRef(options);\n  latest.current = options;\n  const [auth] = useState((): AuthState => ({ stale: false }));\n  const c = useStatewireConn({\n    url: options.url,\n    onChange: options.onChange,\n    ctx,\n    attemptOnce: (c, abort) => attemptStream(c, options, auth, abort),\n  });\n  const [link] = useState(\n    (): RemoteLink => ({\n      get connection() {\n        return c.connection;\n      },\n      send: (frame) => sendFrame(c, latest.current, auth, frame),\n    }),\n  );\n  return link;\n};\n\nconst useStatewireSSE = (\n  options: StatewireClient.SSEOptions,\n): Statewire<any, any> => useStatewireRemote(options, useSseLink);\n\nexport const StatewireSSE = resource(useStatewireSSE) as <\n  TState = any,\n  TCommands extends Statewire.Commands = Statewire.Commands,\n>(\n  options: StatewireClient.SSEOptions,\n) => ResourceElement<Statewire<TState | undefined, TCommands>>;\n"],"mappings":"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"}

package/dist/transports/testing.d.ts

@@ -1,15 +1,15 @@
 import { Statewire } from "../types.js";
 import { StatewireEnvelope } from "../client/connection.js";
-import { applyOptimistic } from "../util/recordMutations.js";
 import { SocketRecorder, commandFrame, createCounterElement, createSocketRecorder, settle } from "./fixtures.js";
+import { applyOptimistic } from "../util/recordMutations.js";
 import { ResourceElement } from "@assistant-ui/tap";
 //#region src/transports/testing.d.ts
 /** Let queued microtasks and op batches drain through the statewire client. */
 declare const tick: () => Promise<void>;
 type MockTransport<TState> = {
   /** Pass as the `transport:` option of useStatewire / Harness. */
-  transport: ResourceElement<Statewire<TState | undefined, any, any>>;
-  /** Captured `/commands` POST bodies, in POST order. */
+  transport: ResourceElement<Statewire<TState | undefined, any>>;
+  /** Captured statements in arrival order: cmd as `{method, params}`, ctx as `{context}`. */
   commands: {
     method?: string;
     params?: unknown[];
@@ -17,8 +17,10 @@ type MockTransport<TState> = {
   }[];
   /** Replace the replicated state and broadcast it as a root snapshot op. */
   setState: (state: TState) => Promise<void>;
-  /** Deliver an ack watermark on the stream. */
-  ack: (seq: number) => Promise<void>;
+  /** Deliver a bare ack cmd packet on the stream. */
+  applied: (seq: number) => Promise<void>;
+  /** Deliver a terminal result cmd packet on the stream. */
+  settle: (seq: number, payload?: unknown) => Promise<void>;
   /** Deliver an arbitrary envelope on the stream. */
   sendEnvelope: (envelope: StatewireEnvelope) => Promise<void>;
   /** End the stream with a fin; further attaches fail like a dead server. */

package/dist/transports/testing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"testing.d.ts","names":[],"sources":["../../src/transports/testing.ts"],"mappings":";;;;;;;cAUa,YAAI;KAIL,cAAc;;EAExB,WAAW,gBAAgB,UAAU;;EAErC;IAAY;IAAiB;IAAoB;;;EAEjD,WAAW,OAAO,WAAW;;EAE7B,MAAM,gBAAgB;;EAEtB,eAAe,UAAU,sBAAsB;;EAE/C,SAAS,gBAAgB,qBAAqB;WACrC;WACA;;cAUE,sBAAuB,QAClC,cAAc,WACb,cAAc"}
+{"version":3,"file":"testing.d.ts","names":[],"sources":["../../src/transports/testing.ts"],"mappings":";;;;;;;cAWa,YAAI;KAIL,cAAc;;EAExB,WAAW,gBAAgB,UAAU;;EAErC;IAAY;IAAiB;IAAoB;;;EAEjD,WAAW,OAAO,WAAW;;EAE7B,UAAU,gBAAgB;;EAE1B,SAAS,aAAa,sBAAsB;;EAE5C,eAAe,UAAU,sBAAsB;;EAE/C,SAAS,gBAAgB,qBAAqB;WACrC;WACA;;cAUE,sBAAuB,QAClC,cAAc,WACb,cAAc"}

package/dist/transports/testing.js

@@ -7,8 +7,8 @@ import { commandFrame, createCounterElement, createSocketRecorder, settle } from
 const tick = () => new Promise((r) => setTimeout(r, 0));
 /**
 * A mock statewire backend: serves `initialState` as the attach snapshot,
-* records command POSTs (receipt only — acks and results are delivered from
-* test code), and exposes the wire as a transport ResourceElement.
+* records submitted frames (receipt only — acks and results are delivered
+* from test code), and exposes the wire as a transport ResourceElement.
 */
 let mockCount = 0;
 const createMockTransport = (initialState) => {
@@ -22,15 +22,35 @@ const createMockTransport = (initialState) => {
 		for (const stream of streams) stream.send(sseFrame(envelope));
 		return tick();
 	};
+	const admit = (id, frame) => {
+		const rec = clients.get(id);
+		for (const statement of frame.ctx ?? []) {
+			rec.ctxSeq = Math.max(rec.ctxSeq, statement.seq);
+			const root = statement.ops[0];
+			commands.push({ context: root?.value });
+		}
+		for (const statement of frame.cmd ?? []) {
+			rec.seq = Math.max(rec.seq, statement.seq);
+			commands.push({
+				method: statement.method,
+				params: statement.params
+			});
+		}
+	};
 	const fakeFetch = (async (input, init) => {
 		if (finished) throw new TypeError("fetch failed (finished)");
 		const url = String(input);
-		const headers = new Headers(init?.headers);
-		const id = headers.get("Statewire-Client-Id") ?? "";
+		const id = new Headers(init?.headers).get("Statewire-Client-Id") ?? "";
 		if (url.endsWith("/stream")) {
 			clientId = id;
-			const lastSeq = clients.get(id) ?? 0;
-			clients.set(id, lastSeq);
+			const known = clients.has(id);
+			if (!known) clients.set(id, {
+				seq: 0,
+				ctxSeq: 0
+			});
+			const rec = clients.get(id);
+			const frame = JSON.parse(String(init?.body));
+			admit(id, frame);
 			return openSSEStream(streams, id, (handle) => {
 				handle.send(sseFrame({
 					ops: [{
@@ -39,16 +59,15 @@ const createMockTransport = (initialState) => {
 						value: state
 					}],
 					syn: {
-						lastSeq,
-						lease: "mock-lease"
+						seq: rec.seq,
+						ctxSeq: rec.ctxSeq,
+						record: known ? "resumed" : "fresh"
 					}
 				}));
-			}, init?.signal ?? void 0);
+			}, init?.signal ?? void 0, { "Statewire-Lease": "mock-lease" });
 		}
-		if (url.endsWith("/commands")) {
-			const seq = Number(headers.get("Statewire-Command-Seq"));
-			clients.set(id, Math.max(clients.get(id) ?? 0, seq));
-			commands.push(JSON.parse(String(init?.body)));
+		if (url.endsWith("/frames")) {
+			admit(id, JSON.parse(String(init?.body)));
 			return Response.json({});
 		}
 		return new Response(null, { status: 404 });
@@ -67,7 +86,15 @@ const createMockTransport = (initialState) => {
 				value: next
 			}] });
 		},
-		ack: (seq) => sendEnvelope({ ack: seq }),
+		applied: (seq) => sendEnvelope({ cmd: [{
+			seq,
+			type: "applied"
+		}] }),
+		settle: (seq, payload) => sendEnvelope({ cmd: [{
+			seq,
+			type: "result",
+			...payload !== void 0 && { payload }
+		}] }),
 		sendEnvelope,
 		finish: async (reason, message) => {
 			await sendEnvelope({ fin: {