@mhome/conversation-protocol 3.6.1 → 3.7.0

package/README.md

@@ -11,6 +11,16 @@ contains no Agent runtime, persistence, transport implementation, or messaging-p
 threads themselves. The Conversation implementation owns active-thread creation, idle rotation,
 pending-interaction policy, idempotency, and enqueueing for that operation.
 
+Each newly created `ThreadSummary` carries a durable `origin`: either
+`{ "type": "turn", "requestId": "…" }` for creation/idle rotation caused by
+`turn/submit`, or `{ "type": "operation", "operationId": "…" }` for an explicit
+thread/session operation. The owner assigns it when committing creation; callers
+cannot supply it as request metadata. It is immutable and appears in control,
+catalog and thread-load projections, including queries after reconnection.
+It identifies creation, not turn admission or execution. Origin can be absent
+for records written before tracking was introduced; clients must not infer a
+cause from operation-ID spelling, timing or the presence of an unbound send.
+
 The canonical `cs1` surface families are client personal (`cp`), client group (`cg`), messaging
 personal (`mp`), and messaging group (`mg`). Messaging surfaces include provider, provider account,
 external conversation, and an optional lane. A lane isolates a provider sub-conversation such as a

package/fixtures/control-get.response.json

@@ -11,7 +11,11 @@
       "createdAt": "2026-08-22T00:00:00Z",
       "updatedAt": "2026-08-22T00:00:00Z",
       "archivedAt": null,
-      "purgeAfter": null
+      "purgeAfter": null,
+      "origin": {
+        "type": "operation",
+        "operationId": "session-start-2"
+      }
     },
     "activeRun": null,
     "pendingInteraction": null,

package/fixtures/control.event.json

@@ -14,7 +14,11 @@
         "createdAt": "2026-08-22T00:00:00Z",
         "updatedAt": "2026-08-22T00:00:00Z",
         "archivedAt": null,
-        "purgeAfter": null
+        "purgeAfter": null,
+        "origin": {
+          "type": "turn",
+          "requestId": "turn-create-2"
+        }
       },
       "activeRun": null,
       "pendingInteraction": null,

package/manifest/targets.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.conversation.targets.v1",
-  "contractVersion": "3.6.1",
+  "contractVersion": "3.7.0",
   "requestTargets": [
     "/chat/control/get",
     "/chat/thread/list",

package/package.json

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

package/protocol.json

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

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

@@ -382,6 +382,9 @@
               "type": "null"
             }
           ]
+        },
+        "origin": {
+          "$ref": "#/$defs/threadOrigin"
         }
       }
     },
@@ -2817,6 +2820,42 @@
           }
         }
       }
+    },
+    "threadOrigin": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "type",
+            "requestId"
+          ],
+          "properties": {
+            "type": {
+              "const": "turn"
+            },
+            "requestId": {
+              "$ref": "#/$defs/id"
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "type",
+            "operationId"
+          ],
+          "properties": {
+            "type": {
+              "const": "operation"
+            },
+            "operationId": {
+              "$ref": "#/$defs/id"
+            }
+          }
+        }
+      ]
     }
   }
 }