@graphorin/protocol 0.6.0 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @graphorin/protocol
 
+## 0.7.0
+
+### Minor Changes
+
+- [#154](https://github.com/o-stepper/graphorin/pull/154) [`fe98522`](https://github.com/o-stepper/graphorin/commit/fe98522ce2477c9a7dc09029f9dcfdb1f7c9aa04) Thanks [@o-stepper](https://github.com/o-stepper)! - W-072: every export map's `import` condition becomes `default`, and the Node floor rises to `>=22.12.0`.
+
+  CJS consumers previously hit a bewildering `ERR_PACKAGE_PATH_NOT_EXPORTED` instead of a clear ESM-only signal. With the `default` condition, plain `require('@graphorin/core')` works via Node's stable `require(esm)` - which shipped in 22.12, hence the engines bump across every workspace manifest (packages, examples, benchmarks, docs; enforced by the widened mvp-readiness sweep). No dual-instance hazard: there is no CJS build, `require()` returns the same ESM module instance. ESM consumers are unaffected (`default` serves both paths; `types` stays first). The pack gate now runs attw under the full `node16` profile (was `esm-only`) and adds a runtime `require(esm)` smoke against the packed tarballs. Installs on Node 22.0-22.11 with `engine-strict` will refuse - upgrade Node (see the migration guide).
+
+### Patch Changes
+
+- [#160](https://github.com/o-stepper/graphorin/pull/160) [`4ee256e`](https://github.com/o-stepper/graphorin/commit/4ee256e30fe9190cef6c48dc6785464757707156) Thanks [@o-stepper](https://github.com/o-stepper)! - W-109: the package doc no longer promises forward-compatible negotiation that does not exist. It now states the actual contract: the frame ENVELOPE (kind set, control-frame fields, the `v: '1'` literal) is validated strictly on both sides and evolves only lockstep (the 0.x deployment model; `v: '2'` frames are rejected), while the deliberate additive extension points live inside the envelope (event `type` + `payload: z.unknown()`, RPC `result: z.unknown()`, the `initialize` capabilities record - which the shipped client currently does not consume). New contract tests pin both classes of behaviour: unknown event types and arbitrary payload/result values pass; extra envelope fields, unknown kinds and `v: '2'` fail. No schema or wire behaviour changed.
+
+- [#164](https://github.com/o-stepper/graphorin/pull/164) [`764239b`](https://github.com/o-stepper/graphorin/commit/764239b97e0e0202442e91272583f13adeb12d00) Thanks [@o-stepper](https://github.com/o-stepper)! - Tarballs now ship `src/` so the published `dist/**/*.d.ts.map` files actually work (W-136): the maps referenced `../src/*.ts` that the `files` whitelist excluded, so go-to-definition fell back into `.d.ts` and the shipped maps were dead weight. The pack gate gains a `map-integrity` leg: every source referenced by a shipped map must resolve inside the tarball (or be embedded via `sourcesContent`), with an anti-vacuous guard - a package whose tsdown config emits declaration maps must contain a non-zero number of `.d.ts.map` files, so a cache-restored dist that silently dropped maps fails the gate instead of passing vacuously. `mvp-readiness` now requires `src` in every publishable `files` array.
+
+- [#154](https://github.com/o-stepper/graphorin/pull/154) [`fe98522`](https://github.com/o-stepper/graphorin/commit/fe98522ce2477c9a7dc09029f9dcfdb1f7c9aa04) Thanks [@o-stepper](https://github.com/o-stepper)! - W-046: JSON-safe `WireAgentEvent` projection for all binary-bearing event variants, applied on the server WS path.
+
+  `@graphorin/core` gains `WireFileGeneratedEvent`, `WireToolExecutePartialEvent`, `WireAgentEndEvent` (whose `result.state` is the `WireRunState` projection) plus the `WireAgentEvent` union and pure `toWireAgentEvent`/`fromWireAgentEvent` codecs. The `AgentEvent` TSDoc now documents the real two-layer wire contract (envelope `{eventId, subject, type, payload}` with `payload = WireAgentEvent`) instead of the false claim that `@graphorin/protocol` re-exports the union; protocol stays zod-only with a doc pointer. The server's `backgroundStreamAgent` projects every streamed event before emitting, so `file.generated`, binary `tool.execute.partial` chunks and a multimodal `agent.end` state arrive at WS clients decodable instead of as numeric-key mush. An exhaustive `Record<AgentEvent['type'], ...>` fixture gate in core forces a wire decision for every future event variant.
+
+## 0.6.1
+
+### Patch Changes
+
+- [#142](https://github.com/o-stepper/graphorin/pull/142) [`436d6ca`](https://github.com/o-stepper/graphorin/commit/436d6ca5ebbd16df094e915682d3915c279a8430) Thanks [@o-stepper](https://github.com/o-stepper)! - Version constants and version-bearing strings now derive from each package's manifest at build time (`VERSION = pkg.version`; writer ids, client/server info, OTLP framework attributes, build-info metrics interpolate it). No behavioral change at the current version: the rendered strings are byte-identical. A release bump no longer edits source; the new `check-version-consistency` gate fails any reintroduced hardcoded framework version.
+
 ## 0.6.0
 
 ## 0.5.0

package/README.md

@@ -5,7 +5,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
 [![Node.js: 22+](https://img.shields.io/badge/Node.js-22%2B-43853d.svg)](https://nodejs.org)
 
-- **Version:** v0.6.0
+- **Version:** v0.7.0
 - **License:** [MIT](./LICENSE) (© 2026 Oleksiy Stepurenko)
 - **Repository:** <https://github.com/o-stepper/graphorin/tree/main/packages/protocol>
 - **Issues:** <https://github.com/o-stepper/graphorin/issues>
@@ -68,4 +68,4 @@ MIT © 2026 Oleksiy Stepurenko. See [`LICENSE`](./LICENSE).
 
 ---
 
-**Project Graphorin** · v0.6.0 · MIT License · © 2026 Oleksiy Stepurenko · <https://github.com/o-stepper/graphorin>
+**Project Graphorin** · v0.7.0 · MIT License · © 2026 Oleksiy Stepurenko · <https://github.com/o-stepper/graphorin>

package/dist/client-message.d.ts

@@ -34,7 +34,6 @@ declare const InitializeRequest: z.ZodObject<{
     capabilities?: Record<string, unknown> | undefined;
   }>;
 }, "strict", z.ZodTypeAny, {
-  method: "initialize";
   v: "1";
   params: {
     clientInfo: {
@@ -45,8 +44,8 @@ declare const InitializeRequest: z.ZodObject<{
   };
   jsonrpc: "2.0";
   id: string | number;
-}, {
   method: "initialize";
+}, {
   v: "1";
   params: {
     clientInfo: {
@@ -57,6 +56,7 @@ declare const InitializeRequest: z.ZodObject<{
   };
   jsonrpc: "2.0";
   id: string | number;
+  method: "initialize";
 }>;
 declare const SubscribeRequest: z.ZodObject<{
   v: z.ZodLiteral<"1">;
@@ -74,7 +74,6 @@ declare const SubscribeRequest: z.ZodObject<{
     sinceEventId?: string | undefined;
   }>;
 }, "strict", z.ZodTypeAny, {
-  method: "subscription.subscribe";
   v: "1";
   params: {
     subject: string;
@@ -82,8 +81,8 @@ declare const SubscribeRequest: z.ZodObject<{
   };
   jsonrpc: "2.0";
   id: string | number;
-}, {
   method: "subscription.subscribe";
+}, {
   v: "1";
   params: {
     subject: string;
@@ -91,6 +90,7 @@ declare const SubscribeRequest: z.ZodObject<{
   };
   jsonrpc: "2.0";
   id: string | number;
+  method: "subscription.subscribe";
 }>;
 declare const UnsubscribeRequest: z.ZodObject<{
   v: z.ZodLiteral<"1">;
@@ -105,21 +105,21 @@ declare const UnsubscribeRequest: z.ZodObject<{
     subscriptionId: string;
   }>;
 }, "strict", z.ZodTypeAny, {
-  method: "subscription.unsubscribe";
   v: "1";
   params: {
     subscriptionId: string;
   };
   jsonrpc: "2.0";
   id: string | number;
-}, {
   method: "subscription.unsubscribe";
+}, {
   v: "1";
   params: {
     subscriptionId: string;
   };
   jsonrpc: "2.0";
   id: string | number;
+  method: "subscription.unsubscribe";
 }>;
 declare const RunCancelRequest: z.ZodObject<{
   v: z.ZodLiteral<"1">;
@@ -143,7 +143,6 @@ declare const RunCancelRequest: z.ZodObject<{
     onPendingApprovals?: "deny" | "preserve" | undefined;
   }>;
 }, "strict", z.ZodTypeAny, {
-  method: "run.cancel";
   v: "1";
   params: {
     runId: string;
@@ -153,8 +152,8 @@ declare const RunCancelRequest: z.ZodObject<{
   };
   jsonrpc: "2.0";
   id: string | number;
-}, {
   method: "run.cancel";
+}, {
   v: "1";
   params: {
     runId: string;
@@ -164,6 +163,7 @@ declare const RunCancelRequest: z.ZodObject<{
   };
   jsonrpc: "2.0";
   id: string | number;
+  method: "run.cancel";
 }>;
 declare const PingRequest: z.ZodObject<{
   v: z.ZodLiteral<"1">;
@@ -178,18 +178,18 @@ declare const PingRequest: z.ZodObject<{
     nonce?: string | undefined;
   }>>;
 }, "strict", z.ZodTypeAny, {
-  method: "ping";
   v: "1";
   jsonrpc: "2.0";
   id: string | number;
+  method: "ping";
   params?: {
     nonce?: string | undefined;
   } | undefined;
 }, {
-  method: "ping";
   v: "1";
   jsonrpc: "2.0";
   id: string | number;
+  method: "ping";
   params?: {
     nonce?: string | undefined;
   } | undefined;
@@ -206,19 +206,19 @@ declare const CancelledNotification: z.ZodObject<{
     requestId: string;
   }>;
 }, "strict", z.ZodTypeAny, {
-  method: "notifications/cancelled";
   v: "1";
   params: {
     requestId: string;
   };
   jsonrpc: "2.0";
-}, {
   method: "notifications/cancelled";
+}, {
   v: "1";
   params: {
     requestId: string;
   };
   jsonrpc: "2.0";
+  method: "notifications/cancelled";
 }>;
 /**
  * Zod schema for every legal client → server frame. Use
@@ -259,7 +259,6 @@ declare const ClientMessageSchema: z.ZodDiscriminatedUnion<"method", [z.ZodObjec
     capabilities?: Record<string, unknown> | undefined;
   }>;
 }, "strict", z.ZodTypeAny, {
-  method: "initialize";
   v: "1";
   params: {
     clientInfo: {
@@ -270,8 +269,8 @@ declare const ClientMessageSchema: z.ZodDiscriminatedUnion<"method", [z.ZodObjec
   };
   jsonrpc: "2.0";
   id: string | number;
-}, {
   method: "initialize";
+}, {
   v: "1";
   params: {
     clientInfo: {
@@ -282,6 +281,7 @@ declare const ClientMessageSchema: z.ZodDiscriminatedUnion<"method", [z.ZodObjec
   };
   jsonrpc: "2.0";
   id: string | number;
+  method: "initialize";
 }>, z.ZodObject<{
   v: z.ZodLiteral<"1">;
   jsonrpc: z.ZodLiteral<"2.0">;
@@ -298,7 +298,6 @@ declare const ClientMessageSchema: z.ZodDiscriminatedUnion<"method", [z.ZodObjec
     sinceEventId?: string | undefined;
   }>;
 }, "strict", z.ZodTypeAny, {
-  method: "subscription.subscribe";
   v: "1";
   params: {
     subject: string;
@@ -306,8 +305,8 @@ declare const ClientMessageSchema: z.ZodDiscriminatedUnion<"method", [z.ZodObjec
   };
   jsonrpc: "2.0";
   id: string | number;
-}, {
   method: "subscription.subscribe";
+}, {
   v: "1";
   params: {
     subject: string;
@@ -315,6 +314,7 @@ declare const ClientMessageSchema: z.ZodDiscriminatedUnion<"method", [z.ZodObjec
   };
   jsonrpc: "2.0";
   id: string | number;
+  method: "subscription.subscribe";
 }>, z.ZodObject<{
   v: z.ZodLiteral<"1">;
   jsonrpc: z.ZodLiteral<"2.0">;
@@ -328,21 +328,21 @@ declare const ClientMessageSchema: z.ZodDiscriminatedUnion<"method", [z.ZodObjec
     subscriptionId: string;
   }>;
 }, "strict", z.ZodTypeAny, {
-  method: "subscription.unsubscribe";
   v: "1";
   params: {
     subscriptionId: string;
   };
   jsonrpc: "2.0";
   id: string | number;
-}, {
   method: "subscription.unsubscribe";
+}, {
   v: "1";
   params: {
     subscriptionId: string;
   };
   jsonrpc: "2.0";
   id: string | number;
+  method: "subscription.unsubscribe";
 }>, z.ZodObject<{
   v: z.ZodLiteral<"1">;
   jsonrpc: z.ZodLiteral<"2.0">;
@@ -365,7 +365,6 @@ declare const ClientMessageSchema: z.ZodDiscriminatedUnion<"method", [z.ZodObjec
     onPendingApprovals?: "deny" | "preserve" | undefined;
   }>;
 }, "strict", z.ZodTypeAny, {
-  method: "run.cancel";
   v: "1";
   params: {
     runId: string;
@@ -375,8 +374,8 @@ declare const ClientMessageSchema: z.ZodDiscriminatedUnion<"method", [z.ZodObjec
   };
   jsonrpc: "2.0";
   id: string | number;
-}, {
   method: "run.cancel";
+}, {
   v: "1";
   params: {
     runId: string;
@@ -386,6 +385,7 @@ declare const ClientMessageSchema: z.ZodDiscriminatedUnion<"method", [z.ZodObjec
   };
   jsonrpc: "2.0";
   id: string | number;
+  method: "run.cancel";
 }>, z.ZodObject<{
   v: z.ZodLiteral<"1">;
   jsonrpc: z.ZodLiteral<"2.0">;
@@ -399,18 +399,18 @@ declare const ClientMessageSchema: z.ZodDiscriminatedUnion<"method", [z.ZodObjec
     nonce?: string | undefined;
   }>>;
 }, "strict", z.ZodTypeAny, {
-  method: "ping";
   v: "1";
   jsonrpc: "2.0";
   id: string | number;
+  method: "ping";
   params?: {
     nonce?: string | undefined;
   } | undefined;
 }, {
-  method: "ping";
   v: "1";
   jsonrpc: "2.0";
   id: string | number;
+  method: "ping";
   params?: {
     nonce?: string | undefined;
   } | undefined;
@@ -426,19 +426,19 @@ declare const ClientMessageSchema: z.ZodDiscriminatedUnion<"method", [z.ZodObjec
     requestId: string;
   }>;
 }, "strict", z.ZodTypeAny, {
-  method: "notifications/cancelled";
   v: "1";
   params: {
     requestId: string;
   };
   jsonrpc: "2.0";
-}, {
   method: "notifications/cancelled";
+}, {
   v: "1";
   params: {
     requestId: string;
   };
   jsonrpc: "2.0";
+  method: "notifications/cancelled";
 }>]>;
 /**
  * Inferred TypeScript union for the `ClientMessage` discriminator. A

package/dist/client-message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client-message.d.ts","names":[],"sources":["../src/client-message.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"client-message.d.ts","names":[],"sources":["../src/client-message.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index.d.ts

@@ -20,8 +20,7 @@ import { PROTOCOL_VERSION, SUBPROTOCOL_NAME, TICKET_SUBPROTOCOL_PREFIX, formatTi
  *
  * @packageDocumentation
  */
-/** Canonical version constant. Mirrors the `package.json` version. */
-declare const VERSION = "0.6.0";
+declare const VERSION: string;
 //#endregion
 export { CLOSE_CODE_VALUES, ClientMessage, ClientMessageId, ClientMessageSchema, GraphorinCloseReason, PROTOCOL_VERSION, RPC_ERROR_CODES, SUBPROTOCOL_NAME, ServerErrorFrame, ServerEventFrame, ServerLifecycleFrame, ServerMessage, ServerMessageSchema, ServerPongFrame, ServerReplayMarkerFrame, ServerRpcFailure, ServerRpcSuccess, ServerSubscribedFrame, ServerUnsubscribedFrame, TICKET_SUBPROTOCOL_PREFIX, VERSION, closeCodeFor, closeCodeReason, formatTicketSubprotocol, isCancelledNotification, isErrorFrame, isEventFrame, isInitializeRequest, isLifecycleFrame, isPingRequest, isPongFrame, isReplayMarkerFrame, isRpcFailure, isRpcSuccess, isRunCancelRequest, isSubscribeRequest, isSubscribedFrame, isUnsubscribeRequest, isUnsubscribedFrame, negotiateSubprotocol, parseTicketSubprotocol };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;AAiBA;;;;;;;;;;cAAa,OAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;AAmBA;;;;;;;;;cAAa"}

package/dist/index.js

@@ -1,3 +1,4 @@
+import { version } from "./package.js";
 import { ClientMessageSchema, isCancelledNotification, isInitializeRequest, isPingRequest, isRunCancelRequest, isSubscribeRequest, isUnsubscribeRequest } from "./client-message.js";
 import { CLOSE_CODE_VALUES, closeCodeFor, closeCodeReason } from "./close-codes.js";
 import { RPC_ERROR_CODES, ServerMessageSchema, isErrorFrame, isEventFrame, isLifecycleFrame, isPongFrame, isReplayMarkerFrame, isRpcFailure, isRpcSuccess, isSubscribedFrame, isUnsubscribedFrame } from "./server-message.js";
@@ -19,8 +20,8 @@ import { PROTOCOL_VERSION, SUBPROTOCOL_NAME, TICKET_SUBPROTOCOL_PREFIX, formatTi
 *
 * @packageDocumentation
 */
-/** Canonical version constant. Mirrors the `package.json` version. */
-const VERSION = "0.6.0";
+/** Canonical version constant, derived from `package.json` at build time. */
+const VERSION = version;
 
 //#endregion
 export { CLOSE_CODE_VALUES, ClientMessageSchema, PROTOCOL_VERSION, RPC_ERROR_CODES, SUBPROTOCOL_NAME, ServerMessageSchema, TICKET_SUBPROTOCOL_PREFIX, VERSION, closeCodeFor, closeCodeReason, formatTicketSubprotocol, isCancelledNotification, isErrorFrame, isEventFrame, isInitializeRequest, isLifecycleFrame, isPingRequest, isPongFrame, isReplayMarkerFrame, isRpcFailure, isRpcSuccess, isRunCancelRequest, isSubscribeRequest, isSubscribedFrame, isUnsubscribeRequest, isUnsubscribedFrame, negotiateSubprotocol, parseTicketSubprotocol };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * `@graphorin/protocol` - wire-format contract for the Graphorin\n * WebSocket subprotocol.\n *\n * The package is the **single source of truth** for the shape of\n * every frame exchanged over `wss://.../v1/ws`. Both\n * `@graphorin/server` and `@graphorin/client` import their schemas\n * from here so the two implementations cannot drift.\n *\n * Browser-friendly: the only runtime dependency is\n * [`zod`](https://zod.dev). No Node-only imports, no DOM-only\n * imports.\n *\n * @packageDocumentation\n */\n\n/** Canonical version constant. Mirrors the `package.json` version. */\nexport const VERSION = '0.6.0';\n\nexport * from './client-message.js';\nexport * from './close-codes.js';\nexport * from './server-message.js';\nexport * from './subprotocol.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAiBA,MAAa,UAAU"}
+{"version":3,"file":"index.js","names":["VERSION: string","pkg.version"],"sources":["../src/index.ts"],"sourcesContent":["/**\n * `@graphorin/protocol` - wire-format contract for the Graphorin\n * WebSocket subprotocol.\n *\n * The package is the **single source of truth** for the shape of\n * every frame exchanged over `wss://.../v1/ws`. Both\n * `@graphorin/server` and `@graphorin/client` import their schemas\n * from here so the two implementations cannot drift.\n *\n * Browser-friendly: the only runtime dependency is\n * [`zod`](https://zod.dev). No Node-only imports, no DOM-only\n * imports.\n *\n * @packageDocumentation\n */\n\n/** Canonical version constant, derived from `package.json` at build time. */\nimport pkg from '../package.json' with { type: 'json' };\n\nexport const VERSION: string = pkg.version;\n\nexport * from './client-message.js';\nexport * from './close-codes.js';\nexport * from './server-message.js';\nexport * from './subprotocol.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAmBA,MAAaA,UAAkBC"}

package/dist/package.js

@@ -0,0 +1,6 @@
+//#region package.json
+var version = "0.7.0";
+
+//#endregion
+export { version };
+//# sourceMappingURL=package.js.map

package/dist/package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.js","names":[],"sources":["../package.json"],"sourcesContent":["{\n  \"name\": \"@graphorin/protocol\",\n  \"version\": \"0.7.0\",\n  \"description\": \"Wire protocol contract for the Graphorin framework: Zod schemas + TypeScript types for the WebSocket subprotocol `graphorin.protocol.v1`. Defines the `ClientMessage` and `ServerMessage` discriminated unions, the JSON-RPC-shaped control channel (`initialize` / `subscription.subscribe` / `subscription.unsubscribe` / `run.cancel` / `ping`), the typed event push frames (`{ kind: 'event', subject, type, payload, eventId }`), the asynchronous server-initiated error frames (`{ kind: 'error', code, message }`), the subprotocol negotiation helpers, and the close-code taxonomy (4001 auth.required, 4002 auth.invalid, 4003 auth.revoked, 4004 auth.scope_denied, 4005 rate.limited, 4006 flow.throttled, 4007 server.shutdown, 4008 protocol.violation). Browser-friendly: zero Node-only dependencies; the only runtime dependency is `zod`. Created and maintained by Oleksiy Stepurenko.\",\n  \"license\": \"MIT\",\n  \"author\": \"Oleksiy Stepurenko\",\n  \"homepage\": \"https://github.com/o-stepper/graphorin/tree/main/packages/protocol\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://github.com/o-stepper/graphorin.git\",\n    \"directory\": \"packages/protocol\"\n  },\n  \"bugs\": {\n    \"url\": \"https://github.com/o-stepper/graphorin/issues\"\n  },\n  \"keywords\": [\n    \"graphorin\",\n    \"ai\",\n    \"agents\",\n    \"framework\",\n    \"protocol\",\n    \"websocket\",\n    \"subprotocol\",\n    \"zod\",\n    \"wire-format\",\n    \"browser-friendly\"\n  ],\n  \"type\": \"module\",\n  \"engines\": {\n    \"node\": \">=22.12.0\"\n  },\n  \"main\": \"./dist/index.js\",\n  \"module\": \"./dist/index.js\",\n  \"types\": \"./dist/index.d.ts\",\n  \"sideEffects\": false,\n  \"exports\": {\n    \".\": {\n      \"types\": \"./dist/index.d.ts\",\n      \"default\": \"./dist/index.js\"\n    },\n    \"./client-message\": {\n      \"types\": \"./dist/client-message.d.ts\",\n      \"default\": \"./dist/client-message.js\"\n    },\n    \"./server-message\": {\n      \"types\": \"./dist/server-message.d.ts\",\n      \"default\": \"./dist/server-message.js\"\n    },\n    \"./subprotocol\": {\n      \"types\": \"./dist/subprotocol.d.ts\",\n      \"default\": \"./dist/subprotocol.js\"\n    },\n    \"./close-codes\": {\n      \"types\": \"./dist/close-codes.d.ts\",\n      \"default\": \"./dist/close-codes.js\"\n    },\n    \"./package.json\": \"./package.json\"\n  },\n  \"files\": [\n    \"dist\",\n    \"src\",\n    \"README.md\",\n    \"CHANGELOG.md\",\n    \"LICENSE\"\n  ],\n  \"scripts\": {\n    \"build\": \"tsdown\",\n    \"typecheck\": \"tsc --noEmit && tsc -p tsconfig.tests.json\",\n    \"test\": \"vitest run\",\n    \"lint\": \"biome check .\",\n    \"clean\": \"rimraf dist .turbo *.tsbuildinfo\"\n  },\n  \"dependencies\": {\n    \"zod\": \"^3.25.0\"\n  },\n  \"publishConfig\": {\n    \"access\": \"public\",\n    \"provenance\": true\n  }\n}\n"],"mappings":";cAEa"}

package/dist/server-message.d.ts

@@ -62,15 +62,15 @@ declare const SubscribedFrame: z.ZodObject<{
   snapshotEventId: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
   v: "1";
-  subject: string;
-  subscriptionId: string;
   kind: "subscribed";
+  subscriptionId: string;
+  subject: string;
   snapshotEventId?: string | undefined;
 }, {
   v: "1";
-  subject: string;
-  subscriptionId: string;
   kind: "subscribed";
+  subscriptionId: string;
+  subject: string;
   snapshotEventId?: string | undefined;
 }>;
 declare const UnsubscribedFrame: z.ZodObject<{
@@ -79,12 +79,12 @@ declare const UnsubscribedFrame: z.ZodObject<{
   subscriptionId: z.ZodString;
 }, "strict", z.ZodTypeAny, {
   v: "1";
-  subscriptionId: string;
   kind: "unsubscribed";
+  subscriptionId: string;
 }, {
   v: "1";
-  subscriptionId: string;
   kind: "unsubscribed";
+  subscriptionId: string;
 }>;
 declare const EventFrame: z.ZodObject<{
   v: z.ZodLiteral<"1">;
@@ -97,17 +97,17 @@ declare const EventFrame: z.ZodObject<{
 }, "strict", z.ZodTypeAny, {
   v: "1";
   type: string;
-  subject: string;
-  subscriptionId: string;
   kind: "event";
+  subscriptionId: string;
+  subject: string;
   eventId: string;
   payload?: unknown;
 }, {
   v: "1";
   type: string;
-  subject: string;
-  subscriptionId: string;
   kind: "event";
+  subscriptionId: string;
+  subject: string;
   eventId: string;
   payload?: unknown;
 }>;
@@ -120,14 +120,14 @@ declare const LifecycleFrame: z.ZodObject<{
 }, "strict", z.ZodTypeAny, {
   v: "1";
   status: "aborted" | "running" | "paused" | "completed" | "failed";
-  subscriptionId: string;
   kind: "lifecycle";
+  subscriptionId: string;
   reason?: string | undefined;
 }, {
   v: "1";
   status: "aborted" | "running" | "paused" | "completed" | "failed";
-  subscriptionId: string;
   kind: "lifecycle";
+  subscriptionId: string;
   reason?: string | undefined;
 }>;
 declare const ErrorFrame: z.ZodObject<{
@@ -143,16 +143,16 @@ declare const ErrorFrame: z.ZodObject<{
   code: string;
   message: string;
   kind: "error";
-  subscriptionId?: string | undefined;
   data?: unknown;
+  subscriptionId?: string | undefined;
   fatal?: boolean | undefined;
 }, {
   v: "1";
   code: string;
   message: string;
   kind: "error";
-  subscriptionId?: string | undefined;
   data?: unknown;
+  subscriptionId?: string | undefined;
   fatal?: boolean | undefined;
 }>;
 declare const PongFrame: z.ZodObject<{
@@ -177,15 +177,15 @@ declare const ReplayMarkerFrame: z.ZodObject<{
   note: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
   v: "1";
-  subscriptionId: string;
   kind: "replay-marker";
+  subscriptionId: string;
   eventId: string;
   droppedCount?: number | undefined;
   note?: string | undefined;
 }, {
   v: "1";
-  subscriptionId: string;
   kind: "replay-marker";
+  subscriptionId: string;
   eventId: string;
   droppedCount?: number | undefined;
   note?: string | undefined;
@@ -257,15 +257,15 @@ declare const ServerMessageSchema: z.ZodUnion<[z.ZodUnion<[z.ZodObject<{
   snapshotEventId: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
   v: "1";
-  subject: string;
-  subscriptionId: string;
   kind: "subscribed";
+  subscriptionId: string;
+  subject: string;
   snapshotEventId?: string | undefined;
 }, {
   v: "1";
-  subject: string;
-  subscriptionId: string;
   kind: "subscribed";
+  subscriptionId: string;
+  subject: string;
   snapshotEventId?: string | undefined;
 }>, z.ZodObject<{
   v: z.ZodLiteral<"1">;
@@ -273,12 +273,12 @@ declare const ServerMessageSchema: z.ZodUnion<[z.ZodUnion<[z.ZodObject<{
   subscriptionId: z.ZodString;
 }, "strict", z.ZodTypeAny, {
   v: "1";
-  subscriptionId: string;
   kind: "unsubscribed";
+  subscriptionId: string;
 }, {
   v: "1";
-  subscriptionId: string;
   kind: "unsubscribed";
+  subscriptionId: string;
 }>, z.ZodObject<{
   v: z.ZodLiteral<"1">;
   kind: z.ZodLiteral<"event">;
@@ -290,17 +290,17 @@ declare const ServerMessageSchema: z.ZodUnion<[z.ZodUnion<[z.ZodObject<{
 }, "strict", z.ZodTypeAny, {
   v: "1";
   type: string;
-  subject: string;
-  subscriptionId: string;
   kind: "event";
+  subscriptionId: string;
+  subject: string;
   eventId: string;
   payload?: unknown;
 }, {
   v: "1";
   type: string;
-  subject: string;
-  subscriptionId: string;
   kind: "event";
+  subscriptionId: string;
+  subject: string;
   eventId: string;
   payload?: unknown;
 }>, z.ZodObject<{
@@ -312,14 +312,14 @@ declare const ServerMessageSchema: z.ZodUnion<[z.ZodUnion<[z.ZodObject<{
 }, "strict", z.ZodTypeAny, {
   v: "1";
   status: "aborted" | "running" | "paused" | "completed" | "failed";
-  subscriptionId: string;
   kind: "lifecycle";
+  subscriptionId: string;
   reason?: string | undefined;
 }, {
   v: "1";
   status: "aborted" | "running" | "paused" | "completed" | "failed";
-  subscriptionId: string;
   kind: "lifecycle";
+  subscriptionId: string;
   reason?: string | undefined;
 }>, z.ZodObject<{
   v: z.ZodLiteral<"1">;
@@ -334,16 +334,16 @@ declare const ServerMessageSchema: z.ZodUnion<[z.ZodUnion<[z.ZodObject<{
   code: string;
   message: string;
   kind: "error";
-  subscriptionId?: string | undefined;
   data?: unknown;
+  subscriptionId?: string | undefined;
   fatal?: boolean | undefined;
 }, {
   v: "1";
   code: string;
   message: string;
   kind: "error";
-  subscriptionId?: string | undefined;
   data?: unknown;
+  subscriptionId?: string | undefined;
   fatal?: boolean | undefined;
 }>, z.ZodObject<{
   v: z.ZodLiteral<"1">;
@@ -366,15 +366,15 @@ declare const ServerMessageSchema: z.ZodUnion<[z.ZodUnion<[z.ZodObject<{
   note: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
   v: "1";
-  subscriptionId: string;
   kind: "replay-marker";
+  subscriptionId: string;
   eventId: string;
   droppedCount?: number | undefined;
   note?: string | undefined;
 }, {
   v: "1";
-  subscriptionId: string;
   kind: "replay-marker";
+  subscriptionId: string;
   eventId: string;
   droppedCount?: number | undefined;
   note?: string | undefined;

package/dist/server-message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server-message.d.ts","names":[],"sources":["../src/server-message.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"server-message.d.ts","names":[],"sources":["../src/server-message.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/server-message.js

@@ -16,8 +16,20 @@ import { z } from "zod";
 *      - server-initiated messages that do not correlate with a
 *      single client RPC id.
 *
-* Every frame carries the `v: '1'` literal so future revisions can
-* negotiate forward-compatible additions without a subprotocol bump.
+* Versioning contract (W-109, honest edition): the frame ENVELOPE -
+* the set of `kind`s, the fields of the control frames, and the
+* `v: '1'` literal - is validated strictly (`.strict()`, literal `v`)
+* on BOTH server and client, and evolves only in lockstep with both
+* sides shipping together: there is NO negotiation, and a frame with
+* `v: '2'` is rejected outright. That is the deployment model of the
+* 0.x line. The additive extension points are deliberate and inside
+* the envelope: the `type` string + `payload: z.unknown()` of event
+* frames (consumers ignore unknown `type`s per the agent-event
+* convention), `result: z.unknown()` of RPC responses, and the
+* `capabilities` record of the `initialize` result (which today the
+* shipped client does not consume). If additive envelope evolution is
+* ever promised publicly, that is a separate negotiation feature -
+* do not loosen `.strict()` for it piecemeal.
 *
 * @packageDocumentation
 */