@mulmobridge/protocol 0.1.3 → 0.1.4

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export { EVENT_TYPES, type EventType, GENERATION_KINDS, type GenerationKind, type GenerationEvent, type PendingGeneration, generationKey } from "./events.js";
-export { CHAT_SOCKET_PATH, CHAT_SOCKET_EVENTS, type ChatSocketEvent } from "./socket.js";
+export { CHAT_SOCKET_PATH, CHAT_SOCKET_EVENTS, type ChatSocketEvent, type BridgeHandshakeAuth, type BridgeOptions } from "./socket.js";
 export { type Attachment } from "./attachment.js";
 export { CHAT_SERVICE_ROUTES } from "./routes.js";

package/dist/socket.d.ts

@@ -9,3 +9,30 @@ export declare const CHAT_SOCKET_EVENTS: {
     readonly textChunk: "textChunk";
 };
 export type ChatSocketEvent = (typeof CHAT_SOCKET_EVENTS)[keyof typeof CHAT_SOCKET_EVENTS];
+/**
+ * Bridge → host-app option bag carried on the handshake.
+ *
+ * Values are restricted to flat primitives (string / number /
+ * boolean). The restriction serves two purposes:
+ *
+ *   1. The wire contract is explicit — no surprise nested objects
+ *      slip through to the host app's callback where a downstream
+ *      merge might reintroduce prototype-pollution risk.
+ *   2. The scrape-from-env path produces strings anyway, so the
+ *      ceiling is already flat primitives in practice.
+ *
+ * Protocol does not interpret any keys — bridges and host apps agree
+ * on names (`defaultRole`, …) out of band.
+ */
+export type BridgeOptions = Readonly<Record<string, string | number | boolean>>;
+/**
+ * Shape of `socket.handshake.auth` on the bridge chat socket. The
+ * server validates `transportId` + `token`; `options` is the opaque-
+ * but-primitive bag forwarded to the host application's startChat
+ * callback. See `plans/feat-bridge-options-passthrough.md`.
+ */
+export interface BridgeHandshakeAuth {
+    transportId: string;
+    token?: string;
+    options?: BridgeOptions;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mulmobridge/protocol",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Shared types and constants for the MulmoBridge protocol",
   "type": "module",
   "main": "./dist/index.js",