Gateway: discriminated protocol schema + CLI updates

src/gateway/protocol/index.ts

@@ -1,46 +1,60 @@
 import AjvPkg, { type ErrorObject } from "ajv";
 import {
+  type AgentEvent,
   AgentEventSchema,
   AgentParamsSchema,
   ErrorCodes,
-  ErrorShapeSchema,
-  EventFrameSchema,
-  HelloErrorSchema,
-  HelloOkSchema,
-  HelloSchema,
-  PresenceEntrySchema,
-  ProtocolSchemas,
-  RequestFrameSchema,
-  ResponseFrameSchema,
-  SendParamsSchema,
-  SnapshotSchema,
-  StateVersionSchema,
-  errorShape,
-  type AgentEvent,
   type ErrorShape,
+  ErrorShapeSchema,
   type EventFrame,
+  EventFrameSchema,
+  errorShape,
   type Hello,
   type HelloError,
+  HelloErrorSchema,
   type HelloOk,
+  HelloOkSchema,
+  HelloSchema,
   type PresenceEntry,
+  PresenceEntrySchema,
+  ProtocolSchemas,
+  PROTOCOL_VERSION,
   type RequestFrame,
+  RequestFrameSchema,
   type ResponseFrame,
+  ResponseFrameSchema,
+  SendParamsSchema,
   type Snapshot,
+  SnapshotSchema,
   type StateVersion,
+  StateVersionSchema,
+  TickEventSchema,
+  type TickEvent,
+  GatewayFrameSchema,
+  type GatewayFrame,
+  type ShutdownEvent,
+  ShutdownEventSchema,
 } from "./schema.js";
 
-const ajv = new (AjvPkg as unknown as new (opts?: object) => import("ajv").default)({
+const ajv = new (
+  AjvPkg as unknown as new (
+    opts?: object,
+  ) => import("ajv").default
+)({
   allErrors: true,
   strict: false,
   removeAdditional: false,
 });
 
 export const validateHello = ajv.compile<Hello>(HelloSchema);
-export const validateRequestFrame = ajv.compile<RequestFrame>(RequestFrameSchema);
+export const validateRequestFrame =
+  ajv.compile<RequestFrame>(RequestFrameSchema);
 export const validateSendParams = ajv.compile(SendParamsSchema);
 export const validateAgentParams = ajv.compile(AgentParamsSchema);
 
-export function formatValidationErrors(errors: ErrorObject[] | null | undefined) {
+export function formatValidationErrors(
+  errors: ErrorObject[] | null | undefined,
+) {
   if (!errors) return "unknown validation error";
   return ajv.errorsText(errors, { separator: "; " });
 }
@@ -52,6 +66,7 @@ export {
   RequestFrameSchema,
   ResponseFrameSchema,
   EventFrameSchema,
+  GatewayFrameSchema,
   PresenceEntrySchema,
   SnapshotSchema,
   ErrorShapeSchema,
@@ -59,12 +74,16 @@ export {
   AgentEventSchema,
   SendParamsSchema,
   AgentParamsSchema,
+  TickEventSchema,
+  ShutdownEventSchema,
   ProtocolSchemas,
+  PROTOCOL_VERSION,
   ErrorCodes,
   errorShape,
 };
 
 export type {
+  GatewayFrame,
   Hello,
   HelloOk,
   HelloError,
@@ -76,4 +95,6 @@ export type {
   ErrorShape,
   StateVersion,
   AgentEvent,
+  TickEvent,
+  ShutdownEvent,
 };