@mhome/conversation-protocol 0.11.1 → 1.2.0

package/fixtures/admission.event.json

@@ -0,0 +1,17 @@
+{
+  "target": "/chat/event",
+  "direction": "event",
+  "body": {
+    "type": "admission.changed",
+    "surfaceId": "cs1:cp:dXNlci0x",
+    "requestId": "request-3",
+    "admissionVersion": 8,
+    "occurredAt": "2026-08-22T03:00:00Z",
+    "data": {
+      "state": "bound",
+      "reason": "accepted",
+      "threadId": "thread-3",
+      "queueVersion": 1
+    }
+  }
+}

package/fixtures/request-cancel-waiting.request.json

@@ -0,0 +1,7 @@
+{
+  "target": "/chat/request/cancel",
+  "direction": "request",
+  "body": {
+    "requestId": "request-3"
+  }
+}

package/fixtures/request-cancel-waiting.response.json

@@ -0,0 +1,10 @@
+{
+  "target": "/chat/request/cancel",
+  "direction": "response",
+  "body": {
+    "requestId": "request-3",
+    "phase": "admission_waiting",
+    "outcome": "cancelled",
+    "admissionVersion": 8
+  }
+}

package/fixtures/turn-submit-waiting.response.json

@@ -0,0 +1,13 @@
+{
+  "target": "/chat/turn/submit",
+  "direction": "response",
+  "body": {
+    "requestId": "request-3",
+    "disposition": "queued",
+    "admission": {
+      "state": "waiting_handoff",
+      "admissionVersion": 7,
+      "reason": "mode_handoff"
+    }
+  }
+}

package/manifest/targets.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.conversation.targets.v1",
-  "contractVersion": "0.11.1",
+  "contractVersion": "1.2.0",
   "requestTargets": [
     "/chat/thread/list",
     "/chat/thread/create",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mhome/conversation-protocol",
-  "version": "0.11.1",
+  "version": "1.2.0",
   "description": "Build-time protocol artifacts for mhome.conversation",
   "license": "MIT",
   "repository": {

package/protocol.json

@@ -1,6 +1,6 @@
 {
   "protocol": "mhome.conversation",
-  "contractVersion": "0.11.1",
+  "contractVersion": "1.2.0",
   "manifest": "manifest/targets.v1.json",
   "schemas": {
     "frame": "schema/conversation-frame.v2.schema.json"

package/schema/conversation-frame.v2.schema.json

@@ -10,12 +10,83 @@
     },
     "surfaceId": {
       "type": "string",
-      "pattern": "^cs1:(?:(?:cp|cg):[A-Za-z0-9_-]+|(?:mp|mg):[a-z][a-z0-9_]*:[A-Za-z0-9_-]+:[A-Za-z0-9_-]+(?::[A-Za-z0-9_-]+)?)$"
+      "pattern": "^cs1:(?:(?:cp|cg):[A-Za-z0-9_-]+|n:[a-z][a-z0-9_]*:[A-Za-z0-9_-]+:[A-Za-z0-9_-]+:[A-Za-z0-9_-]+|(?:mp|mg):[a-z][a-z0-9_]*:[A-Za-z0-9_-]+:[A-Za-z0-9_-]+(?::[A-Za-z0-9_-]+)?)$"
     },
     "time": {
       "type": "string",
       "format": "date-time"
     },
+    "requestAdmission": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "state",
+        "admissionVersion"
+      ],
+      "properties": {
+        "state": {
+          "enum": [
+            "waiting_handoff",
+            "bound",
+            "cancelled",
+            "failed"
+          ]
+        },
+        "admissionVersion": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "reason": {
+          "enum": [
+            "mode_handoff",
+            "waiting_for_prior_turn",
+            "accepted",
+            "cancelled",
+            "handoff_failed"
+          ]
+        },
+        "threadId": {
+          "$ref": "#/$defs/id"
+        },
+        "queueVersion": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    },
+    "requestAdmissionData": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "state"
+      ],
+      "properties": {
+        "state": {
+          "enum": [
+            "waiting_handoff",
+            "bound",
+            "cancelled",
+            "failed"
+          ]
+        },
+        "reason": {
+          "enum": [
+            "mode_handoff",
+            "waiting_for_prior_turn",
+            "accepted",
+            "cancelled",
+            "handoff_failed"
+          ]
+        },
+        "threadId": {
+          "$ref": "#/$defs/id"
+        },
+        "queueVersion": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    },
     "previewValue": {
       "oneOf": [
         {
@@ -1331,6 +1402,39 @@
         }
       }
     },
+    "admissionEvent": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "type",
+        "surfaceId",
+        "requestId",
+        "admissionVersion",
+        "occurredAt",
+        "data"
+      ],
+      "properties": {
+        "type": {
+          "const": "admission.changed"
+        },
+        "surfaceId": {
+          "$ref": "#/$defs/surfaceId"
+        },
+        "requestId": {
+          "$ref": "#/$defs/id"
+        },
+        "admissionVersion": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "occurredAt": {
+          "$ref": "#/$defs/time"
+        },
+        "data": {
+          "$ref": "#/$defs/requestAdmissionData"
+        }
+      }
+    },
     "debugEvent": {
       "type": "object",
       "additionalProperties": false,
@@ -1669,7 +1773,8 @@
             "accessMode": {
               "enum": [
                 "interactive",
-                "full_access"
+                "full_access",
+                "no_access"
               ]
             },
             "agentModelMode": {
@@ -1734,7 +1839,8 @@
             "accessMode": {
               "enum": [
                 "interactive",
-                "full_access"
+                "full_access",
+                "no_access"
               ]
             },
             "agentModelMode": {
@@ -1825,7 +1931,6 @@
           "type": "object",
           "additionalProperties": false,
           "required": [
-            "threadId",
             "requestId"
           ],
           "properties": {
@@ -1961,8 +2066,7 @@
           "additionalProperties": false,
           "required": [
             "requestId",
-            "disposition",
-            "queueVersion"
+            "disposition"
           ],
           "properties": {
             "requestId": {
@@ -1977,6 +2081,9 @@
             "queueVersion": {
               "type": "integer",
               "minimum": 0
+            },
+            "admission": {
+              "$ref": "#/$defs/requestAdmission"
             }
           }
         }
@@ -2002,10 +2109,7 @@
           "additionalProperties": false,
           "required": [
             "requestId",
-            "threadId",
-            "disposition",
-            "sessionDisposition",
-            "queueVersion"
+            "disposition"
           ],
           "properties": {
             "requestId": {
@@ -2031,6 +2135,9 @@
             "queueVersion": {
               "type": "integer",
               "minimum": 0
+            },
+            "admission": {
+              "$ref": "#/$defs/requestAdmission"
             }
           }
         }
@@ -2077,8 +2184,7 @@
           "required": [
             "requestId",
             "phase",
-            "outcome",
-            "queueVersion"
+            "outcome"
           ],
           "properties": {
             "requestId": {
@@ -2086,6 +2192,7 @@
             },
             "phase": {
               "enum": [
+                "admission_waiting",
                 "waiting",
                 "running"
               ]
@@ -2099,6 +2206,10 @@
             "queueVersion": {
               "type": "integer",
               "minimum": 0
+            },
+            "admissionVersion": {
+              "type": "integer",
+              "minimum": 0
             }
           }
         }
@@ -2166,6 +2277,9 @@
             {
               "$ref": "#/$defs/sessionEvent"
             },
+            {
+              "$ref": "#/$defs/admissionEvent"
+            },
             {
               "$ref": "#/$defs/liveEvent"
             }