@mhome/conversation-protocol 3.3.0 → 3.6.0

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

@@ -842,7 +842,7 @@
         "threadId",
         "requestId",
         "baseSnapshotVersion",
-        "offset",
+        "sequence",
         "occurredAt",
         "data"
       ],
@@ -863,10 +863,6 @@
           "type": "integer",
           "minimum": 0
         },
-        "offset": {
-          "type": "integer",
-          "minimum": 1
-        },
         "occurredAt": {
           "$ref": "#/$defs/time"
         },
@@ -874,17 +870,18 @@
           "type": "object",
           "additionalProperties": false,
           "required": [
-            "text",
-            "append"
+            "text"
           ],
           "properties": {
             "text": {
-              "type": "string"
-            },
-            "append": {
-              "type": "boolean"
+              "type": "string",
+              "maxLength": 8192
             }
           }
+        },
+        "sequence": {
+          "type": "integer",
+          "minimum": 1
         }
       }
     },
@@ -973,7 +970,7 @@
         "threadId",
         "requestId",
         "baseSnapshotVersion",
-        "offset",
+        "sequence",
         "occurredAt",
         "data"
       ],
@@ -994,15 +991,15 @@
           "type": "integer",
           "minimum": 0
         },
-        "offset": {
-          "type": "integer",
-          "minimum": 1
-        },
         "occurredAt": {
           "$ref": "#/$defs/time"
         },
         "data": {
           "$ref": "#/$defs/runProgressData"
+        },
+        "sequence": {
+          "type": "integer",
+          "minimum": 1
         }
       }
     },
@@ -1015,7 +1012,7 @@
         "threadId",
         "requestId",
         "baseSnapshotVersion",
-        "offset",
+        "sequence",
         "occurredAt",
         "data"
       ],
@@ -1036,10 +1033,6 @@
           "type": "integer",
           "minimum": 0
         },
-        "offset": {
-          "type": "integer",
-          "minimum": 1
-        },
         "occurredAt": {
           "$ref": "#/$defs/time"
         },
@@ -1058,6 +1051,10 @@
               "type": "string"
             }
           }
+        },
+        "sequence": {
+          "type": "integer",
+          "minimum": 1
         }
       }
     },
@@ -1074,31 +1071,6 @@
         }
       ]
     },
-    "live": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": [
-        "baseSnapshotVersion",
-        "lastOffset",
-        "events"
-      ],
-      "properties": {
-        "baseSnapshotVersion": {
-          "type": "integer",
-          "minimum": 0
-        },
-        "lastOffset": {
-          "type": "integer",
-          "minimum": 0
-        },
-        "events": {
-          "type": "array",
-          "items": {
-            "$ref": "#/$defs/liveEvent"
-          }
-        }
-      }
-    },
     "threadSession": {
       "type": "object",
       "additionalProperties": false,
@@ -1184,7 +1156,6 @@
         "thread",
         "session",
         "sync",
-        "live",
         "queue"
       ],
       "properties": {
@@ -1197,9 +1168,6 @@
         "sync": {
           "$ref": "#/$defs/threadSync"
         },
-        "live": {
-          "$ref": "#/$defs/live"
-        },
         "queue": {
           "$ref": "#/$defs/queue"
         }
@@ -1595,6 +1563,15 @@
         },
         {
           "$ref": "#/$defs/debugEventFrame"
+        },
+        {
+          "$ref": "#/$defs/controlRequest"
+        },
+        {
+          "$ref": "#/$defs/controlResponse"
+        },
+        {
+          "$ref": "#/$defs/catalogCommandResponse"
         }
       ]
     },
@@ -2058,12 +2035,7 @@
       ],
       "properties": {
         "target": {
-          "enum": [
-            "/chat/thread/list",
-            "/chat/thread/create",
-            "/chat/thread/archive",
-            "/chat/thread/rotate"
-          ]
+          "const": "/chat/thread/list"
         },
         "direction": {
           "const": "response"
@@ -2112,25 +2084,46 @@
           "type": "object",
           "additionalProperties": false,
           "required": [
-            "requestId",
-            "disposition"
+            "receipt",
+            "control"
           ],
           "properties": {
-            "requestId": {
-              "$ref": "#/$defs/id"
+            "receipt": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "requestId",
+                "disposition"
+              ],
+              "properties": {
+                "requestId": {
+                  "$ref": "#/$defs/id"
+                },
+                "disposition": {
+                  "enum": [
+                    "scheduled",
+                    "queued",
+                    "duplicate"
+                  ]
+                },
+                "queueVersion": {
+                  "type": "integer",
+                  "minimum": 0
+                },
+                "admission": {
+                  "$ref": "#/$defs/requestAdmission"
+                }
+              }
             },
-            "disposition": {
-              "enum": [
-                "queued",
-                "duplicate"
+            "control": {
+              "oneOf": [
+                {
+                  "$ref": "#/$defs/control"
+                },
+                {
+                  "type": "null"
+                }
               ]
-            },
-            "queueVersion": {
-              "type": "integer",
-              "minimum": 0
-            },
-            "admission": {
-              "$ref": "#/$defs/requestAdmission"
             }
           }
         }
@@ -2155,36 +2148,57 @@
           "type": "object",
           "additionalProperties": false,
           "required": [
-            "requestId",
-            "disposition"
+            "receipt",
+            "control"
           ],
           "properties": {
-            "requestId": {
-              "$ref": "#/$defs/id"
-            },
-            "threadId": {
-              "$ref": "#/$defs/id"
-            },
-            "disposition": {
-              "enum": [
-                "queued",
-                "duplicate",
-                "blocked_pending_interaction"
-              ]
+            "receipt": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "requestId",
+                "disposition"
+              ],
+              "properties": {
+                "requestId": {
+                  "$ref": "#/$defs/id"
+                },
+                "threadId": {
+                  "$ref": "#/$defs/id"
+                },
+                "disposition": {
+                  "enum": [
+                    "scheduled",
+                    "queued",
+                    "duplicate",
+                    "blocked_pending_interaction"
+                  ]
+                },
+                "sessionDisposition": {
+                  "enum": [
+                    "existing",
+                    "created",
+                    "rotated_idle_timeout"
+                  ]
+                },
+                "queueVersion": {
+                  "type": "integer",
+                  "minimum": 0
+                },
+                "admission": {
+                  "$ref": "#/$defs/requestAdmission"
+                }
+              }
             },
-            "sessionDisposition": {
-              "enum": [
-                "existing",
-                "created",
-                "rotated_idle_timeout"
+            "control": {
+              "oneOf": [
+                {
+                  "$ref": "#/$defs/control"
+                },
+                {
+                  "type": "null"
+                }
               ]
-            },
-            "queueVersion": {
-              "type": "integer",
-              "minimum": 0
-            },
-            "admission": {
-              "$ref": "#/$defs/requestAdmission"
             }
           }
         }
@@ -2206,7 +2220,27 @@
           "const": "response"
         },
         "body": {
-          "$ref": "#/$defs/queue"
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "receipt",
+            "control"
+          ],
+          "properties": {
+            "receipt": {
+              "$ref": "#/$defs/queue"
+            },
+            "control": {
+              "oneOf": [
+                {
+                  "$ref": "#/$defs/control"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          }
         }
       }
     },
@@ -2229,34 +2263,54 @@
           "type": "object",
           "additionalProperties": false,
           "required": [
-            "requestId",
-            "phase",
-            "outcome"
+            "receipt",
+            "control"
           ],
           "properties": {
-            "requestId": {
-              "$ref": "#/$defs/id"
-            },
-            "phase": {
-              "enum": [
-                "admission_waiting",
-                "waiting",
-                "running"
-              ]
+            "receipt": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "requestId",
+                "phase",
+                "outcome"
+              ],
+              "properties": {
+                "requestId": {
+                  "$ref": "#/$defs/id"
+                },
+                "phase": {
+                  "enum": [
+                    "admission_waiting",
+                    "waiting",
+                    "running"
+                  ]
+                },
+                "outcome": {
+                  "enum": [
+                    "cancelled",
+                    "cancelling"
+                  ]
+                },
+                "queueVersion": {
+                  "type": "integer",
+                  "minimum": 0
+                },
+                "admissionVersion": {
+                  "type": "integer",
+                  "minimum": 0
+                }
+              }
             },
-            "outcome": {
-              "enum": [
-                "cancelled",
-                "cancelling"
+            "control": {
+              "oneOf": [
+                {
+                  "$ref": "#/$defs/control"
+                },
+                {
+                  "type": "null"
+                }
               ]
-            },
-            "queueVersion": {
-              "type": "integer",
-              "minimum": 0
-            },
-            "admissionVersion": {
-              "type": "integer",
-              "minimum": 0
             }
           }
         }
@@ -2281,15 +2335,35 @@
           "type": "object",
           "additionalProperties": false,
           "required": [
-            "requestId",
-            "disposition"
+            "receipt",
+            "control"
           ],
           "properties": {
-            "requestId": {
-              "$ref": "#/$defs/id"
+            "receipt": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "requestId",
+                "disposition"
+              ],
+              "properties": {
+                "requestId": {
+                  "$ref": "#/$defs/id"
+                },
+                "disposition": {
+                  "const": "accepted"
+                }
+              }
             },
-            "disposition": {
-              "const": "accepted"
+            "control": {
+              "oneOf": [
+                {
+                  "$ref": "#/$defs/control"
+                },
+                {
+                  "type": "null"
+                }
+              ]
             }
           }
         }
@@ -2329,6 +2403,9 @@
             },
             {
               "$ref": "#/$defs/liveEvent"
+            },
+            {
+              "$ref": "#/$defs/controlEvent"
             }
           ]
         }
@@ -2406,26 +2483,46 @@
           "type": "object",
           "additionalProperties": false,
           "required": [
-            "operationId",
-            "threadId",
-            "disposition",
-            "catalog"
+            "receipt",
+            "control"
           ],
           "properties": {
-            "operationId": {
-              "$ref": "#/$defs/id"
-            },
-            "threadId": {
-              "$ref": "#/$defs/id"
+            "receipt": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "operationId",
+                "threadId",
+                "disposition",
+                "catalog"
+              ],
+              "properties": {
+                "operationId": {
+                  "$ref": "#/$defs/id"
+                },
+                "threadId": {
+                  "$ref": "#/$defs/id"
+                },
+                "disposition": {
+                  "enum": [
+                    "rotated",
+                    "already_applied"
+                  ]
+                },
+                "catalog": {
+                  "$ref": "#/$defs/catalog"
+                }
+              }
             },
-            "disposition": {
-              "enum": [
-                "rotated",
-                "already_applied"
+            "control": {
+              "oneOf": [
+                {
+                  "$ref": "#/$defs/control"
+                },
+                {
+                  "type": "null"
+                }
               ]
-            },
-            "catalog": {
-              "$ref": "#/$defs/catalog"
             }
           }
         }
@@ -2512,23 +2609,209 @@
           "type": "object",
           "additionalProperties": false,
           "required": [
-            "requestId",
-            "threadId",
-            "disposition"
+            "receipt",
+            "control"
           ],
           "properties": {
-            "requestId": {
-              "$ref": "#/$defs/id"
+            "receipt": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "requestId",
+                "threadId",
+                "disposition"
+              ],
+              "properties": {
+                "requestId": {
+                  "$ref": "#/$defs/id"
+                },
+                "threadId": {
+                  "$ref": "#/$defs/id"
+                },
+                "disposition": {
+                  "enum": [
+                    "accepted",
+                    "duplicate",
+                    "unavailable",
+                    "expired_session"
+                  ]
+                }
+              }
             },
-            "threadId": {
-              "$ref": "#/$defs/id"
+            "control": {
+              "oneOf": [
+                {
+                  "$ref": "#/$defs/control"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          }
+        }
+      }
+    },
+    "control": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "surfaceId",
+        "version",
+        "activeThread",
+        "activeRun",
+        "pendingInteraction",
+        "queue",
+        "historyVersion"
+      ],
+      "properties": {
+        "surfaceId": {
+          "$ref": "#/$defs/surfaceId"
+        },
+        "version": {
+          "type": "string",
+          "pattern": "^[0-9]{20}:[0-9]{20}$"
+        },
+        "activeThread": {
+          "oneOf": [
+            {
+              "$ref": "#/$defs/threadSummary"
             },
-            "disposition": {
-              "enum": [
-                "accepted",
-                "duplicate",
-                "unavailable",
-                "expired_session"
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "activeRun": {
+          "oneOf": [
+            {
+              "$ref": "#/$defs/activeRun"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "pendingInteraction": {
+          "oneOf": [
+            {
+              "$ref": "#/$defs/pendingInteraction"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "queue": {
+          "$ref": "#/$defs/queue"
+        },
+        "historyVersion": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    },
+    "controlEvent": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "type",
+        "surfaceId",
+        "data"
+      ],
+      "properties": {
+        "type": {
+          "const": "control.updated"
+        },
+        "surfaceId": {
+          "$ref": "#/$defs/surfaceId"
+        },
+        "data": {
+          "$ref": "#/$defs/control"
+        }
+      }
+    },
+    "controlRequest": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "target",
+        "direction",
+        "body"
+      ],
+      "properties": {
+        "target": {
+          "const": "/chat/control/get"
+        },
+        "direction": {
+          "const": "request"
+        },
+        "body": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [],
+          "properties": {}
+        }
+      }
+    },
+    "controlResponse": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "target",
+        "direction",
+        "body"
+      ],
+      "properties": {
+        "target": {
+          "const": "/chat/control/get"
+        },
+        "direction": {
+          "const": "response"
+        },
+        "body": {
+          "$ref": "#/$defs/control"
+        }
+      }
+    },
+    "catalogCommandResponse": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "target",
+        "direction",
+        "body"
+      ],
+      "properties": {
+        "target": {
+          "enum": [
+            "/chat/thread/create",
+            "/chat/thread/archive",
+            "/chat/thread/rotate"
+          ]
+        },
+        "direction": {
+          "const": "response"
+        },
+        "body": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "receipt",
+            "control"
+          ],
+          "properties": {
+            "receipt": {
+              "$ref": "#/$defs/catalog"
+            },
+            "control": {
+              "oneOf": [
+                {
+                  "$ref": "#/$defs/control"
+                },
+                {
+                  "type": "null"
+                }
               ]
             }
           }