statewire 0.18.1 → 0.19.0

package/dist/wire/limits.js

@@ -2,10 +2,10 @@
 const MAX_COMMANDS_PER_FRAME = 256;
 const MAX_INFLIGHT_COMMANDS_PER_CLIENT = 256;
 const MAX_FRAME_BODY_BYTES = 8388608;
-const MAX_CONTEXT_VALUE_BYTES = 65536;
+const MAX_EPHEMERAL_DOCUMENT_BYTES = 65536;
 const MAX_INFLIGHT_COMMANDS_PER_HOST = 1024;
 const COMMAND_CAPACITY_RETRY_MS = 1e3;
 //#endregion
-export { COMMAND_CAPACITY_RETRY_MS, MAX_COMMANDS_PER_FRAME, MAX_CONTEXT_VALUE_BYTES, MAX_FRAME_BODY_BYTES, MAX_INFLIGHT_COMMANDS_PER_CLIENT, MAX_INFLIGHT_COMMANDS_PER_HOST };
+export { COMMAND_CAPACITY_RETRY_MS, MAX_COMMANDS_PER_FRAME, MAX_EPHEMERAL_DOCUMENT_BYTES, MAX_FRAME_BODY_BYTES, MAX_INFLIGHT_COMMANDS_PER_CLIENT, MAX_INFLIGHT_COMMANDS_PER_HOST };
 
 //# sourceMappingURL=limits.js.map

package/dist/wire/limits.js.map

@@ -1 +1 @@
-{"version":3,"file":"limits.js","names":["MAX_COMMANDS_PER_FRAME","MAX_INFLIGHT_COMMANDS_PER_CLIENT","MAX_FRAME_BODY_BYTES","MAX_CONTEXT_VALUE_BYTES","MAX_INFLIGHT_COMMANDS_PER_HOST","COMMAND_CAPACITY_RETRY_MS"],"sources":["../../src/wire/limits.ts"],"sourcesContent":["export const MAX_COMMANDS_PER_FRAME = 256;\nexport const MAX_INFLIGHT_COMMANDS_PER_CLIENT = 256;\nexport const MAX_FRAME_BODY_BYTES = 8 * 1024 * 1024;\nexport const MAX_CONTEXT_VALUE_BYTES = 64 * 1024;\nexport const MAX_INFLIGHT_COMMANDS_PER_HOST = 1024;\nexport const COMMAND_CAPACITY_RETRY_MS = 1_000;\n"],"mappings":";AAAA,MAAaA,yBAAyB;AACtC,MAAaC,mCAAmC;AAChD,MAAaC,uBAAuB;AACpC,MAAaC,0BAA0B;AACvC,MAAaC,iCAAiC;AAC9C,MAAaC,4BAA4B"}
+{"version":3,"file":"limits.js","names":["MAX_COMMANDS_PER_FRAME","MAX_INFLIGHT_COMMANDS_PER_CLIENT","MAX_FRAME_BODY_BYTES","MAX_EPHEMERAL_DOCUMENT_BYTES","MAX_INFLIGHT_COMMANDS_PER_HOST","COMMAND_CAPACITY_RETRY_MS"],"sources":["../../src/wire/limits.ts"],"sourcesContent":["export const MAX_COMMANDS_PER_FRAME = 256;\nexport const MAX_INFLIGHT_COMMANDS_PER_CLIENT = 256;\nexport const MAX_FRAME_BODY_BYTES = 8 * 1024 * 1024;\nexport const MAX_EPHEMERAL_DOCUMENT_BYTES = 64 * 1024;\nexport const MAX_INFLIGHT_COMMANDS_PER_HOST = 1024;\nexport const COMMAND_CAPACITY_RETRY_MS = 1_000;\n"],"mappings":";AAAA,MAAaA,yBAAyB;AACtC,MAAaC,mCAAmC;AAChD,MAAaC,uBAAuB;AACpC,MAAaC,+BAA+B;AAC5C,MAAaC,iCAAiC;AAC9C,MAAaC,4BAA4B"}

package/dist/wire/protocol.d.ts

@@ -13,6 +13,7 @@ declare namespace StatewireProtocol {
     protocols: {
       name: string;
       version: string;
+      record?: "ephemeral";
     }[];
   };
   type Options = {
@@ -24,9 +25,13 @@ declare namespace StatewireProtocol {
   type Definition = Range & {
     name: string;
     requires?: Readonly<Record<string, Range>>;
+    subprotocols?: readonly {
+      name: string;
+      record?: "ephemeral";
+    }[];
   };
 }
-declare const WIRE_VERSION = "2026-09-07";
+declare const WIRE_VERSION = "2026-09-13";
 declare const DEFAULT_PROTOCOL = "default";
 declare const PROTOCOL_HEADER = "Statewire-Protocol";
 declare const VERSION_HEADER = "Statewire-Version";

package/dist/wire/protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.d.ts","names":[],"sources":["../../src/wire/protocol.ts"],"mappings":";kBAAiB;OACH;IAAU;IAAiB;;OAC3B,QAAQ;IAAU;IAAc;;OAChC;IACV;IACA;MAAa;MAAc;;;OAEjB;IACV,cAAc;IACd,gCAAgC;IAChC;IACA,cAAc,SAAS;;OAEb,aAAa;IACvB;IACA,WAAW,SAAS,eAAe;;;cAI1B;cACA;cACA;cACA;cACA,eAAa;cAMb,kBAAmB;cAanB,gBAAiB,OAAO,kBAAkB;;;;cAU1C,UAAW,eAAe,OAAO,kBAAkB;cAKnD,iBAAkB,SAAS,kBAAkB,qBAAO,kBAAA;cAKpD,qBACX,SAAS,kBAAkB,YAC1B;cA6DU,mBACX,SAAS,YACR,SACD,KAAK,kBAAkB;cA0DZ,oBACX,gBACA,SAAS,kBAAkB,YAC1B,kBAAkB;cAqCR,qBACX,SAAS,SACT,MAAM,kBAAkB,OACxB,sBAAsB,kBAAkB,iBAEtC,kBAAkB;EAEhB;IACE;IACA;IACA;IACA;IACA"}
+{"version":3,"file":"protocol.d.ts","names":[],"sources":["../../src/wire/protocol.ts"],"mappings":";kBAAiB;OACH;IAAU;IAAiB;;OAC3B,QAAQ;IAAU;IAAc;;OAChC;IACV;IACA;MAAa;MAAc;MAAiB;;;OAElC;IACV,cAAc;IACd,gCAAgC;IAChC;IACA,cAAc,SAAS;;OAEb,aAAa;IACvB;IACA,WAAW,SAAS,eAAe;IACnC;MAA0B;MAAc;;;;cAI/B;cACA;cACA;cACA;cACA,eAAa;cAMb,kBAAmB;cAanB,gBAAiB,OAAO,kBAAkB;;;;cAU1C,UAAW,eAAe,OAAO,kBAAkB;cAKnD,iBAAkB,SAAS,kBAAkB,qBAAO,kBAAA;cAKpD,qBACX,SAAS,kBAAkB,YAC1B;cA6DU,mBACX,SAAS,YACR,SACD,KAAK,kBAAkB;cA0DZ,oBACX,gBACA,SAAS,kBAAkB,YAC1B,kBAAkB;cA6CR,qBACX,SAAS,SACT,MAAM,kBAAkB,OACxB,sBAAsB,kBAAkB,iBAEtC,kBAAkB;EAEhB;IACE;IACA;IACA;IACA;IACA"}

package/dist/wire/protocol.js

@@ -1,5 +1,5 @@
 //#region src/wire/protocol.ts
-const WIRE_VERSION = "2026-09-07";
+const WIRE_VERSION = "2026-09-13";
 const DEFAULT_PROTOCOL = "default";
 const PROTOCOL_HEADER = "Statewire-Protocol";
 const VERSION_HEADER = "Statewire-Version";
@@ -28,7 +28,7 @@ const inRange = (value, range) => {
 };
 const protocolOffers = (options) => options.applicationProtocols ?? [{
 	name: options.protocol ?? "default",
-	version: "2026-09-07"
+	version: "2026-09-13"
 }];
 const negotiationHeaders = (options) => {
 	const suffix = (range) => {
@@ -39,7 +39,7 @@ const negotiationHeaders = (options) => {
 	const seen = /* @__PURE__ */ new Set();
 	if (offers !== "*" && !offers.length) invalid("protocol list must not be empty");
 	return {
-		[VERSION_HEADER]: suffix(options.wireVersion ?? { version: "2026-09-07" }),
+		[VERSION_HEADER]: suffix(options.wireVersion ?? { version: "2026-09-13" }),
 		[PROTOCOL_HEADER]: offers === "*" ? "*" : offers.map((offer) => {
 			if (!protocolToken.test(offer.name) || offer.name === "*" || seen.has(offer.name)) invalid("invalid or duplicate protocol name");
 			if (offer.optional !== void 0 && typeof offer.optional !== "boolean") invalid("optional must be boolean");
@@ -123,24 +123,30 @@ const validateSelection = (value, options) => {
 	if (typeof value !== "object" || value === null) return invalid("missing negotiation selection");
 	const syn = value;
 	const version = validateVersion(syn.version);
-	if (!inRange(version, options.wireVersion ?? { version: "2026-09-07" })) invalid("selected wire version is outside offer");
+	if (!inRange(version, options.wireVersion ?? { version: "2026-09-13" })) invalid("selected wire version is outside offer");
 	if (!Array.isArray(syn.protocols)) return invalid("syn.protocols must be an array");
 	const offers = protocolOffers(options);
-	const seen = /* @__PURE__ */ new Set();
+	const seen = /* @__PURE__ */ new Map();
 	const protocols = syn.protocols.map((entry) => {
 		if (typeof entry !== "object" || entry === null) return invalid("invalid selected protocol");
 		const item = entry;
 		const name = item.name;
 		if (typeof name !== "string" || !protocolToken.test(name) || name === "*" || seen.has(name)) return invalid("invalid selected protocol name");
 		const version = validateVersion(item.version);
-		seen.add(name);
-		if (offers !== "*") {
+		if (item.record !== void 0 && item.record !== "ephemeral") invalid("invalid selected protocol record");
+		const record = item.record;
+		const parent = name.slice(0, name.lastIndexOf("/"));
+		if (parent !== "" && seen.has(parent)) {
+			if (seen.get(parent) !== version) invalid("subprotocol version differs from its parent");
+		} else if (offers !== "*") {
 			const offer = offers.find((o) => o.name === name);
 			if (!offer || !inRange(version, offer)) invalid("selected protocol is outside offer");
 		}
+		seen.set(name, version);
 		return {
 			name,
-			version
+			version,
+			...record !== void 0 && { record }
 		};
 	});
 	if (offers !== "*" && offers.some((o) => !o.optional && !seen.has(o.name))) invalid("required protocol missing from selection");
@@ -179,6 +185,13 @@ const negotiateProtocols = (headers, wire, definitions) => {
 	})) : request.applicationProtocols;
 	const registry = new Map(definitions.map((d) => [d.name, d]));
 	if (registry.size !== definitions.length) throw new Error("statewire: duplicate registered protocol");
+	for (const definition of definitions) {
+		const children = /* @__PURE__ */ new Set();
+		for (const child of definition.subprotocols ?? []) {
+			if (!protocolToken.test(child.name) || child.name.includes("/") || children.has(child.name) || child.record !== void 0 && child.record !== "ephemeral") throw new Error("statewire: invalid subprotocol registration");
+			children.add(child.name);
+		}
+	}
 	const offered = new Map(offers.map((o) => [o.name, o]));
 	const solve = (names) => {
 		const active = new Set(names);
@@ -209,10 +222,18 @@ const negotiateProtocols = (headers, wire, definitions) => {
 	for (const offer of offers) if (offer.optional) selected = solve(/* @__PURE__ */ new Set([...selected.keys(), offer.name])) ?? selected;
 	return {
 		version,
-		protocols: offers.flatMap((o) => selected.has(o.name) ? [{
-			name: o.name,
-			version: selected.get(o.name)
-		}] : [])
+		protocols: offers.flatMap((o) => {
+			const version = selected.get(o.name);
+			if (version === void 0) return [];
+			return [{
+				name: o.name,
+				version
+			}, ...(registry.get(o.name).subprotocols ?? []).map((child) => ({
+				name: `${o.name}/${child.name}`,
+				version,
+				...child.record !== void 0 && { record: child.record }
+			}))];
+		})
 	};
 };
 //#endregion

package/dist/wire/protocol.js.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.js","names":["StatewireProtocol","Range","version","minVersion","Offer","name","optional","Selection","protocols","Options","wireVersion","applicationProtocols","protocol","keyPrefixes","Readonly","Record","Definition","requires","WIRE_VERSION","DEFAULT_PROTOCOL","PROTOCOL_HEADER","VERSION_HEADER","protocolToken","invalid","message","Error","validateVersion","value","test","parsed","Date","Number","isFinite","getTime","toISOString","slice","startsWith","validateRange","range","undefined","inRange","checked","protocolOffers","options","negotiationHeaders","suffix","offers","seen","Set","length","map","offer","has","add","join","parseItem","input","atom","String","raw","text","trim","match","RegExp","exec","quoted","decode","replace","params","Map","rest","parameter","key","set","parseNegotiation","headers","Headers","Required","Pick","wire","get","application","item","keys","some","k","names","split","includes","validateSelection","syn","Array","isArray","entry","find","o","negotiateProtocols","definitions","fin","reason","code","status","payload","supported","d","failure","const","request","ReturnType","error","sort","registry","size","offered","solve","active","definition","dependency","Object","result","ranges","flatMap","parent","lower","r","at","upper","selected","filter"],"sources":["../../src/wire/protocol.ts"],"sourcesContent":["export namespace StatewireProtocol {\n  export type Range = { version: string; minVersion?: string };\n  export type Offer = Range & { name: string; optional?: boolean };\n  export type Selection = {\n    version: string;\n    protocols: { name: string; version: string }[];\n  };\n  export type Options = {\n    wireVersion?: Range;\n    applicationProtocols?: readonly Offer[] | \"*\";\n    protocol?: string;\n    keyPrefixes?: Readonly<Record<string, readonly string[]>>;\n  };\n  export type Definition = Range & {\n    name: string;\n    requires?: Readonly<Record<string, Range>>;\n  };\n}\n\nexport const WIRE_VERSION = \"2026-09-07\";\nexport const DEFAULT_PROTOCOL = \"default\";\nexport const PROTOCOL_HEADER = \"Statewire-Protocol\";\nexport const VERSION_HEADER = \"Statewire-Version\";\nexport const protocolToken = /^[A-Za-z*][A-Za-z0-9!#$%&'*+.^_`|~:/-]*$/;\n\nconst invalid = (message: string): never => {\n  throw new Error(`statewire: protocol error: ${message}`);\n};\n\nexport const validateVersion = (value: unknown): string => {\n  if (typeof value !== \"string\" || !/^\\d{4}-\\d{2}-\\d{2}$/.test(value))\n    return invalid(\"version must be a YYYY-MM-DD date\");\n  const parsed = new Date(`${value}T00:00:00.000Z`);\n  if (\n    !Number.isFinite(parsed.getTime()) ||\n    parsed.toISOString().slice(0, 10) !== value ||\n    value.startsWith(\"0000\")\n  )\n    return invalid(\"invalid version date\");\n  return value;\n};\n\nexport const validateRange = (range: StatewireProtocol.Range) => {\n  const version = validateVersion(range.version);\n  const minVersion =\n    range.minVersion === undefined\n      ? version\n      : validateVersion(range.minVersion);\n  if (minVersion > version) invalid(\"min-version exceeds version\");\n  return { version, minVersion };\n};\n\nexport const inRange = (value: string, range: StatewireProtocol.Range) => {\n  const checked = validateRange(range);\n  return value >= checked.minVersion && value <= checked.version;\n};\n\nexport const protocolOffers = (options: StatewireProtocol.Options) =>\n  options.applicationProtocols ?? [\n    { name: options.protocol ?? DEFAULT_PROTOCOL, version: WIRE_VERSION },\n  ];\n\nexport const negotiationHeaders = (\n  options: StatewireProtocol.Options,\n): Record<string, string> => {\n  const suffix = (range: StatewireProtocol.Range) => {\n    const { version, minVersion } = validateRange(range);\n    return `\"${version}\"${minVersion === version ? \"\" : `; min-version=\"${minVersion}\"`}`;\n  };\n  const offers = protocolOffers(options);\n  const seen = new Set<string>();\n  if (offers !== \"*\" && !offers.length)\n    invalid(\"protocol list must not be empty\");\n  return {\n    [VERSION_HEADER]: suffix(options.wireVersion ?? { version: WIRE_VERSION }),\n    [PROTOCOL_HEADER]:\n      offers === \"*\"\n        ? \"*\"\n        : offers\n            .map((offer) => {\n              if (\n                !protocolToken.test(offer.name) ||\n                offer.name === \"*\" ||\n                seen.has(offer.name)\n              )\n                invalid(\"invalid or duplicate protocol name\");\n              if (\n                offer.optional !== undefined &&\n                typeof offer.optional !== \"boolean\"\n              )\n                invalid(\"optional must be boolean\");\n              seen.add(offer.name);\n              return `${offer.name}; version=${suffix(offer)}${offer.optional ? \"; optional\" : \"\"}`;\n            })\n            .join(\", \"),\n  };\n};\n\nconst parseItem = (input: string) => {\n  const atom = String.raw`\"(?:[\\x20-\\x21\\x23-\\x5b\\x5d-\\x7e]|\\\\[\"\\\\])*\"|[A-Za-z*][A-Za-z0-9!#$%&'*+.^_\\x60|~:/-]*|\\?[01]`;\n  const text = input.trim();\n  const match = new RegExp(`^(?:${atom})`).exec(text);\n  if (!match) return invalid(\"invalid structured item\");\n  const quoted = match[0].startsWith('\"');\n  const decode = (raw: string) => raw.slice(1, -1).replace(/\\\\([\"\\\\])/g, \"$1\");\n  const value = quoted ? decode(match[0]) : match[0];\n  const params = new Map<string, string | boolean>();\n  let rest = text.slice(match[0].length);\n  while (rest) {\n    const parameter = new RegExp(\n      `^; *([a-z*][a-z0-9_.*-]*)(?:=(${atom}))?`,\n    ).exec(rest);\n    if (!parameter) return invalid(\"invalid structured parameters\");\n    const key = parameter[1]!;\n    const raw = parameter[2];\n    if (params.has(key)) invalid(\"duplicate parameter\");\n    if (raw === undefined || raw === \"?1\") params.set(key, true);\n    else if (raw === \"?0\") params.set(key, false);\n    else if (raw.startsWith('\"')) params.set(key, decode(raw));\n    else invalid(\"parameter must be string or boolean\");\n    rest = rest.slice(parameter[0].length);\n  }\n  return { value, quoted, params };\n};\n\nexport const parseNegotiation = (\n  headers: Headers,\n): Required<\n  Pick<StatewireProtocol.Options, \"wireVersion\" | \"applicationProtocols\">\n> => {\n  const wire = headers.get(VERSION_HEADER);\n  const application = headers.get(PROTOCOL_HEADER);\n  if (wire === null || application === null)\n    return invalid(\"negotiation fields are required\");\n  const item = parseItem(wire);\n  if (!item.quoted || [...item.params.keys()].some((k) => k !== \"min-version\"))\n    invalid(\"invalid Statewire-Version\");\n  const minVersion = item.params.get(\"min-version\");\n  if (minVersion !== undefined && typeof minVersion !== \"string\")\n    return invalid(\"min-version must be a string\");\n  const wireVersion = validateRange({\n    version: item.value,\n    ...(minVersion === undefined ? {} : { minVersion }),\n  });\n  if (application.trim() === \"*\")\n    return { wireVersion, applicationProtocols: \"*\" };\n  const names = new Set<string>();\n  const applicationProtocols = application\n    .split(\",\")\n    .map((text): StatewireProtocol.Offer => {\n      const { value: name, quoted, params } = parseItem(text);\n      if (\n        quoted ||\n        !protocolToken.test(name) ||\n        name === \"*\" ||\n        names.has(name)\n      )\n        invalid(\"invalid or duplicate protocol name\");\n      names.add(name);\n      if (\n        [...params.keys()].some(\n          (k) => ![\"version\", \"min-version\", \"optional\"].includes(k),\n        )\n      )\n        invalid(\"unsupported parameter\");\n      const version = params.get(\"version\");\n      const minVersion = params.get(\"min-version\");\n      const optional = params.get(\"optional\") ?? false;\n      if (\n        typeof version !== \"string\" ||\n        (minVersion !== undefined && typeof minVersion !== \"string\") ||\n        typeof optional !== \"boolean\"\n      )\n        return invalid(\"invalid protocol parameters\");\n      return {\n        name,\n        ...validateRange({\n          version,\n          ...(minVersion === undefined ? {} : { minVersion }),\n        }),\n        optional,\n      };\n    });\n  return { wireVersion, applicationProtocols };\n};\n\nexport const validateSelection = (\n  value: unknown,\n  options: StatewireProtocol.Options,\n): StatewireProtocol.Selection => {\n  if (typeof value !== \"object\" || value === null)\n    return invalid(\"missing negotiation selection\");\n  const syn = value as Record<string, unknown>;\n  const version = validateVersion(syn.version);\n  if (!inRange(version, options.wireVersion ?? { version: WIRE_VERSION }))\n    invalid(\"selected wire version is outside offer\");\n  if (!Array.isArray(syn.protocols))\n    return invalid(\"syn.protocols must be an array\");\n  const offers = protocolOffers(options);\n  const seen = new Set<string>();\n  const protocols = syn.protocols.map((entry: unknown) => {\n    if (typeof entry !== \"object\" || entry === null)\n      return invalid(\"invalid selected protocol\");\n    const item = entry as Record<string, unknown>;\n    const name = item.name;\n    if (\n      typeof name !== \"string\" ||\n      !protocolToken.test(name) ||\n      name === \"*\" ||\n      seen.has(name)\n    )\n      return invalid(\"invalid selected protocol name\");\n    const version = validateVersion(item.version);\n    seen.add(name);\n    if (offers !== \"*\") {\n      const offer = offers.find((o) => o.name === name);\n      if (!offer || !inRange(version, offer))\n        invalid(\"selected protocol is outside offer\");\n    }\n    return { name, version };\n  });\n  if (offers !== \"*\" && offers.some((o) => !o.optional && !seen.has(o.name)))\n    invalid(\"required protocol missing from selection\");\n  return { version, protocols };\n};\n\nexport const negotiateProtocols = (\n  headers: Headers,\n  wire: StatewireProtocol.Range,\n  definitions: readonly StatewireProtocol.Definition[],\n):\n  | StatewireProtocol.Selection\n  | {\n      fin: {\n        reason: \"protocol-error\";\n        code: string;\n        status: number;\n        message: string;\n        payload?: unknown;\n      };\n    } => {\n  const supported = {\n    ...validateRange(wire),\n    protocols: definitions.map((d) => ({ name: d.name, ...validateRange(d) })),\n  };\n  const failure = (code: string, message: string) => ({\n    fin: {\n      reason: \"protocol-error\" as const,\n      code,\n      message,\n      status: code === \"invalid-negotiation\" ? 400 : 406,\n      ...(code === \"invalid-negotiation\" ? {} : { payload: supported }),\n    },\n  });\n  let request: ReturnType<typeof parseNegotiation>;\n  try {\n    request = parseNegotiation(headers);\n  } catch (error) {\n    return failure(\n      \"invalid-negotiation\",\n      error instanceof Error ? error.message : \"invalid negotiation\",\n    );\n  }\n  const version = [wire.version, request.wireVersion.version].sort()[0]!;\n  if (!inRange(version, wire) || !inRange(version, request.wireVersion))\n    return failure(\"unsupported-version\", \"Statewire versions do not overlap\");\n  const offers =\n    request.applicationProtocols === \"*\"\n      ? definitions.map((d) => ({\n          name: d.name,\n          version: d.version,\n          optional: false,\n        }))\n      : request.applicationProtocols;\n  const registry = new Map(definitions.map((d) => [d.name, d]));\n  if (registry.size !== definitions.length)\n    throw new Error(\"statewire: duplicate registered protocol\");\n  const offered = new Map(offers.map((o) => [o.name, o]));\n  const solve = (names: Set<string>) => {\n    const active = new Set(names);\n    for (const name of active) {\n      const definition = registry.get(name);\n      if (!definition || !offered.has(name)) return undefined;\n      for (const dependency of Object.keys(definition.requires ?? {}))\n        active.add(dependency);\n    }\n    const result = new Map<string, string>();\n    for (const name of active) {\n      const ranges = [\n        registry.get(name)!,\n        offered.get(name)!,\n        ...[...active].flatMap((parent) => {\n          const dependency = registry.get(parent)!.requires?.[name];\n          return dependency ? [dependency] : [];\n        }),\n      ].map(validateRange);\n      const lower = ranges\n        .map((r) => r.minVersion)\n        .sort()\n        .at(-1)!;\n      const upper = ranges.map((r) => r.version).sort()[0]!;\n      if (lower > upper) return undefined;\n      result.set(name, upper);\n    }\n    return result;\n  };\n  let selected = solve(\n    new Set(offers.filter((o) => !o.optional).map((o) => o.name)),\n  );\n  if (!selected)\n    return failure(\n      \"unsupported-protocol\",\n      \"required protocol combination is unsupported\",\n    );\n  for (const offer of offers) {\n    if (offer.optional)\n      selected = solve(new Set([...selected.keys(), offer.name])) ?? selected;\n  }\n  return {\n    version,\n    protocols: offers.flatMap((o) =>\n      selected!.has(o.name)\n        ? [{ name: o.name, version: selected!.get(o.name)! }]\n        : [],\n    ),\n  };\n};\n"],"mappings":"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"}
+{"version":3,"file":"protocol.js","names":["StatewireProtocol","Range","version","minVersion","Offer","name","optional","Selection","protocols","record","Options","wireVersion","applicationProtocols","protocol","keyPrefixes","Readonly","Record","Definition","requires","subprotocols","WIRE_VERSION","DEFAULT_PROTOCOL","PROTOCOL_HEADER","VERSION_HEADER","protocolToken","invalid","message","Error","validateVersion","value","test","parsed","Date","Number","isFinite","getTime","toISOString","slice","startsWith","validateRange","range","undefined","inRange","checked","protocolOffers","options","negotiationHeaders","suffix","offers","seen","Set","length","map","offer","has","add","join","parseItem","input","atom","String","raw","text","trim","match","RegExp","exec","quoted","decode","replace","params","Map","rest","parameter","key","set","parseNegotiation","headers","Headers","Required","Pick","wire","get","application","item","keys","some","k","names","split","includes","validateSelection","syn","Array","isArray","entry","parent","lastIndexOf","child","find","o","negotiateProtocols","definitions","fin","reason","code","status","payload","supported","d","failure","const","request","ReturnType","error","sort","registry","size","definition","children","offered","solve","active","dependency","Object","result","ranges","flatMap","lower","r","at","upper","selected","filter"],"sources":["../../src/wire/protocol.ts"],"sourcesContent":["export namespace StatewireProtocol {\n  export type Range = { version: string; minVersion?: string };\n  export type Offer = Range & { name: string; optional?: boolean };\n  export type Selection = {\n    version: string;\n    protocols: { name: string; version: string; record?: \"ephemeral\" }[];\n  };\n  export type Options = {\n    wireVersion?: Range;\n    applicationProtocols?: readonly Offer[] | \"*\";\n    protocol?: string;\n    keyPrefixes?: Readonly<Record<string, readonly string[]>>;\n  };\n  export type Definition = Range & {\n    name: string;\n    requires?: Readonly<Record<string, Range>>;\n    subprotocols?: readonly { name: string; record?: \"ephemeral\" }[];\n  };\n}\n\nexport const WIRE_VERSION = \"2026-09-13\";\nexport const DEFAULT_PROTOCOL = \"default\";\nexport const PROTOCOL_HEADER = \"Statewire-Protocol\";\nexport const VERSION_HEADER = \"Statewire-Version\";\nexport const protocolToken = /^[A-Za-z*][A-Za-z0-9!#$%&'*+.^_`|~:/-]*$/;\n\nconst invalid = (message: string): never => {\n  throw new Error(`statewire: protocol error: ${message}`);\n};\n\nexport const validateVersion = (value: unknown): string => {\n  if (typeof value !== \"string\" || !/^\\d{4}-\\d{2}-\\d{2}$/.test(value))\n    return invalid(\"version must be a YYYY-MM-DD date\");\n  const parsed = new Date(`${value}T00:00:00.000Z`);\n  if (\n    !Number.isFinite(parsed.getTime()) ||\n    parsed.toISOString().slice(0, 10) !== value ||\n    value.startsWith(\"0000\")\n  )\n    return invalid(\"invalid version date\");\n  return value;\n};\n\nexport const validateRange = (range: StatewireProtocol.Range) => {\n  const version = validateVersion(range.version);\n  const minVersion =\n    range.minVersion === undefined\n      ? version\n      : validateVersion(range.minVersion);\n  if (minVersion > version) invalid(\"min-version exceeds version\");\n  return { version, minVersion };\n};\n\nexport const inRange = (value: string, range: StatewireProtocol.Range) => {\n  const checked = validateRange(range);\n  return value >= checked.minVersion && value <= checked.version;\n};\n\nexport const protocolOffers = (options: StatewireProtocol.Options) =>\n  options.applicationProtocols ?? [\n    { name: options.protocol ?? DEFAULT_PROTOCOL, version: WIRE_VERSION },\n  ];\n\nexport const negotiationHeaders = (\n  options: StatewireProtocol.Options,\n): Record<string, string> => {\n  const suffix = (range: StatewireProtocol.Range) => {\n    const { version, minVersion } = validateRange(range);\n    return `\"${version}\"${minVersion === version ? \"\" : `; min-version=\"${minVersion}\"`}`;\n  };\n  const offers = protocolOffers(options);\n  const seen = new Set<string>();\n  if (offers !== \"*\" && !offers.length)\n    invalid(\"protocol list must not be empty\");\n  return {\n    [VERSION_HEADER]: suffix(options.wireVersion ?? { version: WIRE_VERSION }),\n    [PROTOCOL_HEADER]:\n      offers === \"*\"\n        ? \"*\"\n        : offers\n            .map((offer) => {\n              if (\n                !protocolToken.test(offer.name) ||\n                offer.name === \"*\" ||\n                seen.has(offer.name)\n              )\n                invalid(\"invalid or duplicate protocol name\");\n              if (\n                offer.optional !== undefined &&\n                typeof offer.optional !== \"boolean\"\n              )\n                invalid(\"optional must be boolean\");\n              seen.add(offer.name);\n              return `${offer.name}; version=${suffix(offer)}${offer.optional ? \"; optional\" : \"\"}`;\n            })\n            .join(\", \"),\n  };\n};\n\nconst parseItem = (input: string) => {\n  const atom = String.raw`\"(?:[\\x20-\\x21\\x23-\\x5b\\x5d-\\x7e]|\\\\[\"\\\\])*\"|[A-Za-z*][A-Za-z0-9!#$%&'*+.^_\\x60|~:/-]*|\\?[01]`;\n  const text = input.trim();\n  const match = new RegExp(`^(?:${atom})`).exec(text);\n  if (!match) return invalid(\"invalid structured item\");\n  const quoted = match[0].startsWith('\"');\n  const decode = (raw: string) => raw.slice(1, -1).replace(/\\\\([\"\\\\])/g, \"$1\");\n  const value = quoted ? decode(match[0]) : match[0];\n  const params = new Map<string, string | boolean>();\n  let rest = text.slice(match[0].length);\n  while (rest) {\n    const parameter = new RegExp(\n      `^; *([a-z*][a-z0-9_.*-]*)(?:=(${atom}))?`,\n    ).exec(rest);\n    if (!parameter) return invalid(\"invalid structured parameters\");\n    const key = parameter[1]!;\n    const raw = parameter[2];\n    if (params.has(key)) invalid(\"duplicate parameter\");\n    if (raw === undefined || raw === \"?1\") params.set(key, true);\n    else if (raw === \"?0\") params.set(key, false);\n    else if (raw.startsWith('\"')) params.set(key, decode(raw));\n    else invalid(\"parameter must be string or boolean\");\n    rest = rest.slice(parameter[0].length);\n  }\n  return { value, quoted, params };\n};\n\nexport const parseNegotiation = (\n  headers: Headers,\n): Required<\n  Pick<StatewireProtocol.Options, \"wireVersion\" | \"applicationProtocols\">\n> => {\n  const wire = headers.get(VERSION_HEADER);\n  const application = headers.get(PROTOCOL_HEADER);\n  if (wire === null || application === null)\n    return invalid(\"negotiation fields are required\");\n  const item = parseItem(wire);\n  if (!item.quoted || [...item.params.keys()].some((k) => k !== \"min-version\"))\n    invalid(\"invalid Statewire-Version\");\n  const minVersion = item.params.get(\"min-version\");\n  if (minVersion !== undefined && typeof minVersion !== \"string\")\n    return invalid(\"min-version must be a string\");\n  const wireVersion = validateRange({\n    version: item.value,\n    ...(minVersion === undefined ? {} : { minVersion }),\n  });\n  if (application.trim() === \"*\")\n    return { wireVersion, applicationProtocols: \"*\" };\n  const names = new Set<string>();\n  const applicationProtocols = application\n    .split(\",\")\n    .map((text): StatewireProtocol.Offer => {\n      const { value: name, quoted, params } = parseItem(text);\n      if (\n        quoted ||\n        !protocolToken.test(name) ||\n        name === \"*\" ||\n        names.has(name)\n      )\n        invalid(\"invalid or duplicate protocol name\");\n      names.add(name);\n      if (\n        [...params.keys()].some(\n          (k) => ![\"version\", \"min-version\", \"optional\"].includes(k),\n        )\n      )\n        invalid(\"unsupported parameter\");\n      const version = params.get(\"version\");\n      const minVersion = params.get(\"min-version\");\n      const optional = params.get(\"optional\") ?? false;\n      if (\n        typeof version !== \"string\" ||\n        (minVersion !== undefined && typeof minVersion !== \"string\") ||\n        typeof optional !== \"boolean\"\n      )\n        return invalid(\"invalid protocol parameters\");\n      return {\n        name,\n        ...validateRange({\n          version,\n          ...(minVersion === undefined ? {} : { minVersion }),\n        }),\n        optional,\n      };\n    });\n  return { wireVersion, applicationProtocols };\n};\n\nexport const validateSelection = (\n  value: unknown,\n  options: StatewireProtocol.Options,\n): StatewireProtocol.Selection => {\n  if (typeof value !== \"object\" || value === null)\n    return invalid(\"missing negotiation selection\");\n  const syn = value as Record<string, unknown>;\n  const version = validateVersion(syn.version);\n  if (!inRange(version, options.wireVersion ?? { version: WIRE_VERSION }))\n    invalid(\"selected wire version is outside offer\");\n  if (!Array.isArray(syn.protocols))\n    return invalid(\"syn.protocols must be an array\");\n  const offers = protocolOffers(options);\n  const seen = new Map<string, string>();\n  const protocols = syn.protocols.map((entry: unknown) => {\n    if (typeof entry !== \"object\" || entry === null)\n      return invalid(\"invalid selected protocol\");\n    const item = entry as Record<string, unknown>;\n    const name = item.name;\n    if (\n      typeof name !== \"string\" ||\n      !protocolToken.test(name) ||\n      name === \"*\" ||\n      seen.has(name)\n    )\n      return invalid(\"invalid selected protocol name\");\n    const version = validateVersion(item.version);\n    if (item.record !== undefined && item.record !== \"ephemeral\")\n      invalid(\"invalid selected protocol record\");\n    const record = item.record as \"ephemeral\" | undefined;\n    const parent = name.slice(0, name.lastIndexOf(\"/\"));\n    const child = parent !== \"\" && seen.has(parent);\n    if (child) {\n      if (seen.get(parent) !== version)\n        invalid(\"subprotocol version differs from its parent\");\n    } else if (offers !== \"*\") {\n      const offer = offers.find((o) => o.name === name);\n      if (!offer || !inRange(version, offer))\n        invalid(\"selected protocol is outside offer\");\n    }\n    seen.set(name, version);\n    return { name, version, ...(record !== undefined && { record }) };\n  });\n  if (offers !== \"*\" && offers.some((o) => !o.optional && !seen.has(o.name)))\n    invalid(\"required protocol missing from selection\");\n  return { version, protocols };\n};\n\nexport const negotiateProtocols = (\n  headers: Headers,\n  wire: StatewireProtocol.Range,\n  definitions: readonly StatewireProtocol.Definition[],\n):\n  | StatewireProtocol.Selection\n  | {\n      fin: {\n        reason: \"protocol-error\";\n        code: string;\n        status: number;\n        message: string;\n        payload?: unknown;\n      };\n    } => {\n  const supported = {\n    ...validateRange(wire),\n    protocols: definitions.map((d) => ({ name: d.name, ...validateRange(d) })),\n  };\n  const failure = (code: string, message: string) => ({\n    fin: {\n      reason: \"protocol-error\" as const,\n      code,\n      message,\n      status: code === \"invalid-negotiation\" ? 400 : 406,\n      ...(code === \"invalid-negotiation\" ? {} : { payload: supported }),\n    },\n  });\n  let request: ReturnType<typeof parseNegotiation>;\n  try {\n    request = parseNegotiation(headers);\n  } catch (error) {\n    return failure(\n      \"invalid-negotiation\",\n      error instanceof Error ? error.message : \"invalid negotiation\",\n    );\n  }\n  const version = [wire.version, request.wireVersion.version].sort()[0]!;\n  if (!inRange(version, wire) || !inRange(version, request.wireVersion))\n    return failure(\"unsupported-version\", \"Statewire versions do not overlap\");\n  const offers =\n    request.applicationProtocols === \"*\"\n      ? definitions.map((d) => ({\n          name: d.name,\n          version: d.version,\n          optional: false,\n        }))\n      : request.applicationProtocols;\n  const registry = new Map(definitions.map((d) => [d.name, d]));\n  if (registry.size !== definitions.length)\n    throw new Error(\"statewire: duplicate registered protocol\");\n  for (const definition of definitions) {\n    const children = new Set<string>();\n    for (const child of definition.subprotocols ?? []) {\n      if (\n        !protocolToken.test(child.name) ||\n        child.name.includes(\"/\") ||\n        children.has(child.name) ||\n        (child.record !== undefined && child.record !== \"ephemeral\")\n      )\n        throw new Error(\"statewire: invalid subprotocol registration\");\n      children.add(child.name);\n    }\n  }\n  const offered = new Map(offers.map((o) => [o.name, o]));\n  const solve = (names: Set<string>) => {\n    const active = new Set(names);\n    for (const name of active) {\n      const definition = registry.get(name);\n      if (!definition || !offered.has(name)) return undefined;\n      for (const dependency of Object.keys(definition.requires ?? {}))\n        active.add(dependency);\n    }\n    const result = new Map<string, string>();\n    for (const name of active) {\n      const ranges = [\n        registry.get(name)!,\n        offered.get(name)!,\n        ...[...active].flatMap((parent) => {\n          const dependency = registry.get(parent)!.requires?.[name];\n          return dependency ? [dependency] : [];\n        }),\n      ].map(validateRange);\n      const lower = ranges\n        .map((r) => r.minVersion)\n        .sort()\n        .at(-1)!;\n      const upper = ranges.map((r) => r.version).sort()[0]!;\n      if (lower > upper) return undefined;\n      result.set(name, upper);\n    }\n    return result;\n  };\n  let selected = solve(\n    new Set(offers.filter((o) => !o.optional).map((o) => o.name)),\n  );\n  if (!selected)\n    return failure(\n      \"unsupported-protocol\",\n      \"required protocol combination is unsupported\",\n    );\n  for (const offer of offers) {\n    if (offer.optional)\n      selected = solve(new Set([...selected.keys(), offer.name])) ?? selected;\n  }\n  return {\n    version,\n    protocols: offers.flatMap((o) => {\n      const version = selected!.get(o.name);\n      if (version === undefined) return [];\n      return [\n        { name: o.name, version },\n        ...(registry.get(o.name)!.subprotocols ?? []).map((child) => ({\n          name: `${o.name}/${child.name}`,\n          version,\n          ...(child.record !== undefined && { record: child.record }),\n        })),\n      ];\n    }),\n  };\n};\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "statewire",
-  "version": "0.18.1",
+  "version": "0.19.0",
   "description": "State over the wire: snapshot-first delta streaming and command submission for any state and any command",
   "license": "MIT",
   "repository": {

package/src/client/connection.ts

@@ -7,7 +7,7 @@ import type { StatewireProtocol } from "../wire/protocol";
 import { useEffect, useRef, useState } from "react";
 import { flushTapSync } from "@assistant-ui/tap";
 import { reviveOps, reviveValue } from "../wire/meta";
-import { backoff, timing } from "./timing";
+import { backoff, retryHint, timing } from "./timing";
 import { isStorageError } from "./storageError";
 import type {
   ConnectionState,
@@ -35,6 +35,7 @@ export const TERMINAL = [
 ] as const;
 
 export type StatewireCmd = {
+  protocol: string;
   seq: number;
   type?: "applied" | (typeof TERMINAL)[number];
   code?: string;
@@ -47,10 +48,12 @@ export type StatewireCmd = {
 
 export type StatewireSyn = {
   version?: string;
-  protocols?: StatewireProtocol.Selection["protocols"];
-  seq?: number;
-  ctxSeq?: number;
-  record?: "ephemeral";
+  protocols?: {
+    name: string;
+    version?: string;
+    record?: "ephemeral";
+    seq?: number;
+  }[];
   id?: string;
   idle?: boolean;
   retry?: number;
@@ -197,13 +200,33 @@ const validateOptionalString = (value: unknown, field: string): void => {
   }
 };
 
-const validateSynScalars = (syn: Record<string, unknown>) => {
-  if (syn["seq"] !== undefined && !isNonnegativeSafeInteger(syn["seq"])) {
-    protocolError("syn.seq must be a nonnegative safe integer");
-  }
-  if (syn["ctxSeq"] !== undefined && !isNonnegativeSafeInteger(syn["ctxSeq"])) {
-    protocolError("syn.ctxSeq must be a nonnegative safe integer");
+const validateSynProtocols = (value: unknown, hello: boolean): void => {
+  if (value === undefined) return;
+  if (!Array.isArray(value))
+    return protocolError("syn.protocols must be an array");
+  for (const entry of value) {
+    if (!isObject(entry))
+      return protocolError("syn.protocols entry must be an object");
+    if (typeof entry["name"] !== "string")
+      protocolError("syn.protocols[].name must be a string");
+    if (
+      !hello &&
+      (entry["version"] !== undefined || entry["record"] !== undefined)
+    )
+      protocolError("invalid mid-stream syn");
+    if (
+      hello
+        ? !isNonnegativeSafeInteger(entry["seq"])
+        : entry["seq"] !== undefined && !isNonnegativeSafeInteger(entry["seq"])
+    )
+      protocolError("syn.protocols[].seq must be a nonnegative safe integer");
+    if (hello && entry["record"] === "ephemeral" && entry["seq"] !== 0)
+      protocolError("ephemeral lane hello seq must be 0");
   }
+};
+
+const validateSynScalars = (syn: Record<string, unknown>, hello: boolean) => {
+  validateSynProtocols(syn["protocols"], hello);
   if (syn["retry"] !== undefined && !isNonnegativeSafeInteger(syn["retry"])) {
     protocolError("syn.retry must be a nonnegative safe integer");
   }
@@ -211,24 +234,19 @@ const validateSynScalars = (syn: Record<string, unknown>) => {
   if (syn["idle"] !== undefined && typeof syn["idle"] !== "boolean") {
     protocolError("syn.idle must be a boolean");
   }
-  validateOptionalString(syn["record"], "syn.record");
 };
 
 export const validateRefusalSyn = (value: unknown): StatewireSyn => {
   if (!isObject(value)) return protocolError("syn must be an object");
-  validateSynScalars(value);
+  validateSynScalars(value, false);
   if (
     value["id"] !== undefined ||
     value["idle"] !== undefined ||
-    value["record"] !== undefined
+    value["version"] !== undefined
   ) {
     protocolError("invalid refusal syn");
   }
-  if (
-    value["seq"] === undefined &&
-    value["ctxSeq"] === undefined &&
-    value["retry"] === undefined
-  ) {
+  if (value["protocols"] === undefined && value["retry"] === undefined) {
     protocolError("refusal syn has no watermarks or retry");
   }
   return value as StatewireSyn;
@@ -236,6 +254,9 @@ export const validateRefusalSyn = (value: unknown): StatewireSyn => {
 
 const validateCmd = (value: unknown): value is StatewireCmd => {
   if (!isObject(value)) return protocolError("cmd entry must be an object");
+  if (typeof value["protocol"] !== "string") {
+    protocolError("cmd.protocol must be a string");
+  }
   if (!isPositiveSafeInteger(value["seq"])) {
     protocolError("cmd.seq must be a positive safe integer");
   }
@@ -313,7 +334,7 @@ const snapshotOf = (env: StatewireEnvelope): unknown[] => {
 
 const helloSynOf = (env: StatewireEnvelope): StatewireSyn => {
   if (!isObject(env.syn)) return protocolError("expected hello");
-  validateSynScalars(env.syn);
+  validateSynScalars(env.syn, true);
   if (env.syn["retry"] !== undefined) {
     protocolError("hello syn cannot carry retry");
   }
@@ -328,6 +349,7 @@ const handleHello = (c: Conn, env: StatewireEnvelope) => {
     ops,
     syn,
   });
+  if (env.cmd !== undefined) c.ctx.onCmds(env.cmd);
   c.ctx.onIdle(syn.idle ?? false);
   c.awaitingHello = false;
   c.error = undefined;
@@ -347,20 +369,11 @@ const warnUnknownSynFact = () => {
 
 const deliverSyn = (c: Conn, value: unknown) => {
   if (!isObject(value)) return protocolError("syn must be an object");
-  validateSynScalars(value);
-  if (
-    value["version"] !== undefined ||
-    value["protocols"] !== undefined ||
-    value["record"] !== undefined ||
-    value["idle"] !== undefined
-  ) {
+  validateSynScalars(value, false);
+  if (value["version"] !== undefined || value["idle"] !== undefined) {
     protocolError("invalid mid-stream syn");
   }
-  if (
-    value["seq"] !== undefined ||
-    value["ctxSeq"] !== undefined ||
-    value["retry"] !== undefined
-  ) {
+  if (value["protocols"] !== undefined || value["retry"] !== undefined) {
     c.ctx.onRefusal(validateRefusalSyn(value));
     return;
   }
@@ -394,7 +407,7 @@ export const settleFin = (c: Conn, fin: StatewireHost.Fin): AttemptOutcome => {
       ? fin
       : { ...fin, payload: reviveValue(fin.payload, fin.meta) };
   releaseHeld(c);
-  c.retryAt = Date.now() + (finish.retry ?? 0);
+  c.retryAt = Date.now() + retryHint(finish.retry ?? 0);
   if (finish.reason === "idle") {
     c.ctx.onIdle(true);
     c.attempt = 0;