@mulmobridge/protocol 0.1.0

package/dist/attachment.d.ts

@@ -0,0 +1,8 @@
+export interface Attachment {
+    /** IANA media type, e.g. "image/png". */
+    mimeType: string;
+    /** Raw base64-encoded payload (no `data:` prefix, no whitespace). */
+    data: string;
+    /** Optional original filename. Untrusted — sanitise before use on disk. */
+    filename?: string;
+}

package/dist/attachment.js

@@ -0,0 +1,2 @@
+// File attachment schema for chat messages (images, documents, etc.).
+export {};

package/dist/events.d.ts

@@ -0,0 +1,14 @@
+export declare const EVENT_TYPES: {
+    readonly status: "status";
+    readonly text: "text";
+    readonly toolCall: "tool_call";
+    readonly toolCallResult: "tool_call_result";
+    readonly toolResult: "tool_result";
+    readonly switchRole: "switch_role";
+    readonly error: "error";
+    readonly claudeSessionId: "claude_session_id";
+    readonly sessionFinished: "session_finished";
+    readonly sessionMeta: "session_meta";
+    readonly rolesUpdated: "roles_updated";
+};
+export type EventType = (typeof EVENT_TYPES)[keyof typeof EVENT_TYPES];

package/dist/events.js

@@ -0,0 +1,18 @@
+// Event type constants for the agent SSE / socket.io wire protocol.
+//
+// These are the string values that appear in `{ type: "..." }` on
+// every event flowing between the server and clients (both the Vue
+// frontend and external bridges).
+export const EVENT_TYPES = {
+    status: "status",
+    text: "text",
+    toolCall: "tool_call",
+    toolCallResult: "tool_call_result",
+    toolResult: "tool_result",
+    switchRole: "switch_role",
+    error: "error",
+    claudeSessionId: "claude_session_id",
+    sessionFinished: "session_finished",
+    sessionMeta: "session_meta",
+    rolesUpdated: "roles_updated",
+};

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { EVENT_TYPES, type EventType } from "./events.js";
+export { CHAT_SOCKET_PATH, CHAT_SOCKET_EVENTS, type ChatSocketEvent, } from "./socket.js";
+export { type Attachment } from "./attachment.js";
+export { CHAT_SERVICE_ROUTES } from "./routes.js";

package/dist/index.js

@@ -0,0 +1,11 @@
+// @mulmobridge/protocol — shared constants and interfaces for the
+// MulmoBridge chat protocol.
+//
+// This package defines the wire-level contract between:
+//   - The chat-service (server-side socket.io + REST)
+//   - External bridges (CLI, Telegram, future platforms)
+//
+// No runtime dependencies. Types + const-only.
+export { EVENT_TYPES } from "./events.js";
+export { CHAT_SOCKET_PATH, CHAT_SOCKET_EVENTS, } from "./socket.js";
+export { CHAT_SERVICE_ROUTES } from "./routes.js";

package/dist/routes.d.ts

@@ -0,0 +1,4 @@
+export declare const CHAT_SERVICE_ROUTES: {
+    readonly message: "/api/transports/:transportId/chats/:externalChatId";
+    readonly connect: "/api/transports/:transportId/chats/:externalChatId/connect";
+};

package/dist/routes.js

@@ -0,0 +1,6 @@
+// Chat-service route patterns. Only the subset needed by the
+// chat-service package — the full API_ROUTES lives in the root app.
+export const CHAT_SERVICE_ROUTES = {
+    message: "/api/transports/:transportId/chats/:externalChatId",
+    connect: "/api/transports/:transportId/chats/:externalChatId/connect",
+};

package/dist/socket.d.ts

@@ -0,0 +1,6 @@
+export declare const CHAT_SOCKET_PATH = "/ws/chat";
+export declare const CHAT_SOCKET_EVENTS: {
+    readonly message: "message";
+    readonly push: "push";
+};
+export type ChatSocketEvent = (typeof CHAT_SOCKET_EVENTS)[keyof typeof CHAT_SOCKET_EVENTS];

package/dist/socket.js

@@ -0,0 +1,6 @@
+// Socket.io event names and path for the chat bridge WebSocket.
+export const CHAT_SOCKET_PATH = "/ws/chat";
+export const CHAT_SOCKET_EVENTS = {
+    message: "message",
+    push: "push",
+};

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@mulmobridge/protocol",
+  "version": "0.1.0",
+  "description": "Shared types and constants for the MulmoBridge protocol",
+  "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": {
+      "import": "./src/index.ts",
+      "types": "./src/index.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepack": "yarn build",
+    "typecheck": "tsc --noEmit",
+    "test": "tsx --test test/test_*.ts"
+  },
+  "publishConfig": {
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "import": "./dist/index.js"
+      }
+    }
+  },
+  "license": "MIT",
+  "author": "Receptron Team",
+  "devDependencies": {
+    "typescript": "^5.8.0"
+  }
+}