@mhome/conversation-protocol 3.0.4 → 3.1.1

package/README.md

@@ -30,6 +30,11 @@ Model data is re-exported from `llm-api`; there is one model-message representat
 messages intentionally use separate content types and never contain private model continuation.
 Runtime state machines, checkpoint formats, prompts and recovery policy remain in Agent Runtime.
 
+`RunErrorCode` is the closed catalog for `runOutcome.errorCode` and Agent `Failed.code`. Host
+terminalize and Agent failures emit the same strings. `status` and `failure.source` are properties
+of the code; `failure.code` equals `errorCode`. User-visible copy stays in `runOutcome.message`,
+not in this crate. Command `/chat/*` errors and adapter `ExternalErrorKind` are separate layers.
+
 ## Cloud admission model snapshot
 
 Every cloud `LlmRoute` carries a required `model_snapshot` containing confirmed capabilities
@@ -41,3 +46,7 @@ snapshot. Version 3 stores `capabilities.input` as `image|video|audio|file` inst
 `vision: bool`. An old plan without the snapshot, or with `vision`, fails decoding instead
 of silently changing behavior. This development contract change must be published and
 adopted by Lion and Cloud together before deployment.
+
+### Strict execution envelope decoding
+
+Execution commands, events, facade responses and their typed nested objects reject undeclared fields, including null-valued unknown fields. Opaque JSON inputs/results and model continuation payloads remain extensible; known optional null fields remain accepted. Enforcement lives on the typed DTOs as well as the wire entry point because Serde's internally tagged enum buffering bypasses an outer `serde_ignored` observer. Tagged unit variants explicitly require an empty remaining map. This restores the existing wire-v1 contract without changing its message shape or major version.

package/manifest/targets.v1.json

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

package/package.json

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

package/protocol.json

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

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

@@ -8,6 +8,43 @@
       "type": "string",
       "minLength": 1
     },
+    "runErrorCode": {
+      "type": "string",
+      "enum": [
+        "CANCELLED",
+        "RUN_INTERRUPTED",
+        "EXECUTOR_TERMINATED",
+        "THREAD_EXPIRED",
+        "THREAD_ARCHIVED",
+        "AGENT_ADMISSION_TIMEOUT",
+        "AGENT_DEADLINE_EXCEEDED",
+        "AGENT_CONNECTION_LOST",
+        "AGENT_UNAVAILABLE",
+        "PROCESS_INTERRUPTED",
+        "PROTOCOL",
+        "INVALID_ENVELOPE",
+        "INVALID_FRAME",
+        "INVALID_JSON",
+        "STALE_DISPATCH",
+        "STALE_SESSION",
+        "UNSUPPORTED_VERSION",
+        "INVALID_FAMILY",
+        "INVALID_REQUEST",
+        "UNAUTHORIZED",
+        "UNAVAILABLE",
+        "RATE_LIMITED",
+        "CONTEXT_LIMIT",
+        "TIMEOUT",
+        "INTERNAL",
+        "OUTPUT_TRUNCATED",
+        "CREDIT_BUDGET_EXCEEDED",
+        "THREAD_BUSY",
+        "ADMISSION_REJECTED",
+        "AGENT_EXECUTION_FAILED",
+        "INVALID_MODEL_FINISH",
+        "INVALID_MODEL_TOOL_CALLS"
+      ]
+    },
     "surfaceId": {
       "type": "string",
       "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_-]+)?)$"
@@ -641,7 +678,7 @@
           ]
         },
         "code": {
-          "$ref": "#/$defs/id"
+          "$ref": "#/$defs/runErrorCode"
         },
         "message": {
           "type": "string"
@@ -671,7 +708,7 @@
         "errorCode": {
           "oneOf": [
             {
-              "type": "string"
+              "$ref": "#/$defs/runErrorCode"
             },
             {
               "type": "null"

package/schema/execution/envelope.v1.schema.json

@@ -8,6 +8,43 @@
       "type": "string",
       "minLength": 1
     },
+    "run_error_code": {
+      "type": "string",
+      "enum": [
+        "CANCELLED",
+        "RUN_INTERRUPTED",
+        "EXECUTOR_TERMINATED",
+        "THREAD_EXPIRED",
+        "THREAD_ARCHIVED",
+        "AGENT_ADMISSION_TIMEOUT",
+        "AGENT_DEADLINE_EXCEEDED",
+        "AGENT_CONNECTION_LOST",
+        "AGENT_UNAVAILABLE",
+        "PROCESS_INTERRUPTED",
+        "PROTOCOL",
+        "INVALID_ENVELOPE",
+        "INVALID_FRAME",
+        "INVALID_JSON",
+        "STALE_DISPATCH",
+        "STALE_SESSION",
+        "UNSUPPORTED_VERSION",
+        "INVALID_FAMILY",
+        "INVALID_REQUEST",
+        "UNAUTHORIZED",
+        "UNAVAILABLE",
+        "RATE_LIMITED",
+        "CONTEXT_LIMIT",
+        "TIMEOUT",
+        "INTERNAL",
+        "OUTPUT_TRUNCATED",
+        "CREDIT_BUDGET_EXCEEDED",
+        "THREAD_BUSY",
+        "ADMISSION_REJECTED",
+        "AGENT_EXECUTION_FAILED",
+        "INVALID_MODEL_FINISH",
+        "INVALID_MODEL_TOOL_CALLS"
+      ]
+    },
     "conversation_surface": {
       "type": "string",
       "pattern": "^cs1:(?:(?:cp|cg):[A-Za-z0-9_-]+|(?:mp|mg):[a-z0-9_]+:[A-Za-z0-9_-]+:[A-Za-z0-9_-]+(?::[A-Za-z0-9_-]+)?)$"
@@ -1043,7 +1080,7 @@
               "const": "failed"
             },
             "code": {
-              "$ref": "#/$defs/identifier"
+              "$ref": "#/$defs/run_error_code"
             },
             "message": {
               "type": "string"