@mhome/app-facade-protocol 1.69.0 → 1.72.0

package/README.md

@@ -144,6 +144,15 @@ its complete referenced value is available and which visible inputs can make
 it stale, so clients can resolve it reactively without learning handlers or
 the hidden graph.
 
+Final completion can return `completed: false` with `submission.status: accepted`:
+the business owner has saved the input but installation has not finished. Clients
+retain the completion command ID and may query `/app/interaction-flow/submission/status`
+or explicitly call `/app/interaction-flow/submission/retry` with the original source
+and that ID. Neither call requires a live interactive session. Responses distinguish
+`notFound`, `accepted`, and `completed` with the original result. Clients cannot
+supply an owner or handler; current Node binding and Space access are checked again.
+Retry is explicit, and closing the interaction does not cancel accepted business data.
+
 `topology` exposes the Hub-owned Space network projection. Stable Host, Hub,
 Node, AppClient, and Cloud identities are separate from current transport
 sessions. Durable relations remain present while disconnected and carry an

package/fixtures/group.conformance.json

@@ -14,19 +14,13 @@
         ]
       }
     },
-    {
-      "definition": "GroupPresentationInput",
-      "value": {
-        "groupId": "g:1"
-      }
-    },
     {
       "definition": "CreateGroupInput",
       "value": {
         "creationId": "11111111-1111-4111-8111-111111111111",
         "name": "Lights",
-        "memberType": "basic.device.Device",
-        "memberIds": [
+        "entityType": "basic.device.Device",
+        "entityIds": [
           "lamp-a",
           "lamp-b",
           "lamp-a"
@@ -45,7 +39,7 @@
       "definition": "UpdateGroupMembersInput",
       "value": {
         "groupId": "g:1",
-        "memberIds": [
+        "entityIds": [
           "lamp-b"
         ],
         "expectedRevision": 3
@@ -63,7 +57,7 @@
       "value": {
         "groupId": "g:11111111-1111-4111-8111-111111111111",
         "name": "Lights",
-        "memberType": "basic.device.Device",
+        "entityType": "basic.device.Device",
         "memberCount": 2,
         "revision": 3,
         "applyState": "ready",
@@ -76,13 +70,13 @@
       "value": {
         "groupId": "g:11111111-1111-4111-8111-111111111111",
         "name": "Lights",
-        "memberType": "basic.device.Device",
+        "entityType": "basic.device.Device",
         "memberCount": 2,
         "revision": 3,
         "applyState": "ready",
         "createdAt": 1900000000000,
         "updatedAt": 1900000001000,
-        "memberIds": [
+        "entityIds": [
           "lamp-a",
           "lamp-b"
         ],
@@ -94,7 +88,7 @@
         ],
         "memberProblems": [
           {
-            "memberId": "lamp-b",
+            "entityId": "lamp-b",
             "code": "MEMBER_UNAVAILABLE",
             "message": "Member is unavailable"
           }
@@ -128,7 +122,7 @@
           {
             "groupId": "g:11111111-1111-4111-8111-111111111111",
             "name": "Lights",
-            "memberType": "basic.device.Device",
+            "entityType": "basic.device.Device",
             "memberCount": 2,
             "revision": 3,
             "applyState": "ready",
@@ -149,13 +143,13 @@
             "group": {
               "groupId": "g:11111111-1111-4111-8111-111111111111",
               "name": "Lights",
-              "memberType": "basic.device.Device",
+              "entityType": "basic.device.Device",
               "memberCount": 2,
               "revision": 3,
               "applyState": "ready",
               "createdAt": 1900000000000,
               "updatedAt": 1900000001000,
-              "memberIds": [
+              "entityIds": [
                 "lamp-a",
                 "lamp-b"
               ],
@@ -167,7 +161,7 @@
               ],
               "memberProblems": [
                 {
-                  "memberId": "lamp-b",
+                  "entityId": "lamp-b",
                   "code": "MEMBER_UNAVAILABLE",
                   "message": "Member is unavailable"
                 }
@@ -181,6 +175,23 @@
           }
         ]
       }
+    },
+    {
+      "definition": "GroupDetail",
+      "value": {
+        "groupId": "g:11111111-1111-4111-8111-111111111111",
+        "name": "Lights",
+        "entityType": "basic.device.Device",
+        "memberCount": 2,
+        "revision": 3,
+        "applyState": "ready",
+        "createdAt": 1900000000000,
+        "updatedAt": 1900000001000,
+        "entityIds": [
+          "lamp-a",
+          "lamp-b"
+        ]
+      }
     }
   ],
   "invalid": [
@@ -195,7 +206,7 @@
       "definition": "UpdateGroupMembersInput",
       "value": {
         "groupId": "g:1",
-        "memberIds": [
+        "entityIds": [
           "lamp-b"
         ],
         "expectedRevision": 3,
@@ -214,8 +225,8 @@
       "value": {
         "creationId": "11111111-1111-4111-8111-111111111111",
         "name": "Lights",
-        "memberType": "basic.device.Device",
-        "memberIds": [
+        "entityType": "basic.device.Device",
+        "entityIds": [
           "lamp-a",
           "lamp-b",
           "lamp-a"
@@ -232,13 +243,13 @@
       "value": {
         "groupId": "g:11111111-1111-4111-8111-111111111111",
         "name": "Lights",
-        "memberType": "basic.device.Device",
+        "entityType": "basic.device.Device",
         "memberCount": 2,
         "revision": 3,
         "applyState": "ready",
         "createdAt": 1900000000000,
         "updatedAt": 1900000001000,
-        "memberIds": [
+        "entityIds": [
           "lamp-a",
           "lamp-b"
         ],
@@ -250,7 +261,7 @@
         ],
         "memberProblems": [
           {
-            "memberId": "lamp-b",
+            "entityId": "lamp-b",
             "code": "MEMBER_UNAVAILABLE",
             "message": "Member is unavailable"
           }
@@ -371,13 +382,29 @@
       "value": {
         "groupId": "g:11111111-1111-4111-8111-111111111111",
         "name": "Lights",
-        "memberType": "basic.device.Device",
+        "entityType": "basic.device.Device",
         "memberCount": 2,
         "revision": 3,
         "applyState": "unknown",
         "createdAt": 1900000000000,
         "updatedAt": 1900000001000
       }
+    },
+    {
+      "definition": "ListGroupsInput",
+      "value": {
+        "memberType": "basic.device.Device"
+      }
+    },
+    {
+      "definition": "UpdateGroupMembersInput",
+      "value": {
+        "groupId": "g:1",
+        "memberIds": [
+          "one"
+        ],
+        "expectedRevision": 1
+      }
     }
   ]
 }

package/fixtures/interaction-flow.conformance.json

@@ -70,9 +70,28 @@
     "completed": true,
     "result": {
       "providerConnectionId": "provider-1"
+    },
+    "submission": {
+      "status": "completed",
+      "result": {
+        "providerConnectionId": "provider-1"
+      }
     }
   },
   "cancelResponse": {
     "cancelled": true
+  },
+  "submissionRequest": {
+    "source": {
+      "kind": "plugin",
+      "nodeType": "camera",
+      "nodeId": "camera-1",
+      "flowId": "provider.connect",
+      "subjectId": "onvif"
+    },
+    "submissionId": "command-3"
+  },
+  "submissionResponse": {
+    "status": "accepted"
   }
 }

package/fixtures/presentation/cases.json

@@ -561,7 +561,7 @@
             "twinTags": [
               "light"
             ],
-            "memberIds": []
+            "entityIds": []
           }
         },
         {
@@ -578,7 +578,7 @@
             ],
             "group": true,
             "integration": "demo.device",
-            "memberIds": [
+            "entityIds": [
               "d1"
             ]
           }
@@ -615,7 +615,7 @@
             "twinTags": [
               "light"
             ],
-            "memberIds": []
+            "entityIds": []
           }
         },
         {
@@ -632,7 +632,7 @@
             ],
             "group": true,
             "integration": "demo.device",
-            "memberIds": [
+            "entityIds": [
               "d1"
             ]
           }
@@ -3692,7 +3692,7 @@
         {
           "groupId": "g:11111111-1111-4111-8111-111111111111",
           "name": "Lights",
-          "memberType": "basic.device.Device",
+          "entityType": "basic.device.Device",
           "memberCount": 2,
           "revision": 3,
           "applyState": "ready",
@@ -3708,7 +3708,7 @@
         {
           "groupId": "g:11111111-1111-4111-8111-111111111111",
           "name": "Lights",
-          "memberType": "basic.device.Device",
+          "entityType": "basic.device.Device",
           "memberCount": 2,
           "revision": 3,
           "applyState": "ready",
@@ -3730,13 +3730,13 @@
           "group": {
             "groupId": "g:11111111-1111-4111-8111-111111111111",
             "name": "Lights",
-            "memberType": "basic.device.Device",
+            "entityType": "basic.device.Device",
             "memberCount": 2,
             "revision": 3,
             "applyState": "ready",
             "createdAt": 1900000000000,
             "updatedAt": 1900000001000,
-            "memberIds": [
+            "entityIds": [
               "lamp-a",
               "lamp-b"
             ],
@@ -3772,13 +3772,13 @@
           "group": {
             "groupId": "g:11111111-1111-4111-8111-111111111111",
             "name": "Lights",
-            "memberType": "basic.device.Device",
+            "entityType": "basic.device.Device",
             "memberCount": 2,
             "revision": 3,
             "applyState": "ready",
             "createdAt": "2030-03-17 17:46:40 +00:00 (UTC)",
             "updatedAt": "2030-03-17 17:46:41 +00:00 (UTC)",
-            "memberIds": [
+            "entityIds": [
               "lamp-a",
               "lamp-b"
             ],
@@ -3962,5 +3962,95 @@
         }
       ]
     }
+  },
+  {
+    "name": "agent-provider-auth-start",
+    "target": "/app/agent/llm/provider/auth/start",
+    "data": {
+      "success": true,
+      "sessionId": "auth-example",
+      "status": "pending"
+    },
+    "status": "success",
+    "full": {
+      "sessionId": "auth-example",
+      "status": "pending"
+    },
+    "essential": {
+      "sessionId": "auth-example",
+      "status": "pending"
+    }
+  },
+  {
+    "name": "agent-provider-auth-complete",
+    "target": "/app/agent/llm/provider/auth/complete",
+    "data": {
+      "success": true,
+      "sessionId": "auth-example",
+      "status": "persisted"
+    },
+    "status": "success",
+    "full": {
+      "sessionId": "auth-example",
+      "status": "persisted"
+    },
+    "essential": {
+      "sessionId": "auth-example",
+      "status": "persisted"
+    }
+  },
+  {
+    "name": "agent-provider-auth-status",
+    "target": "/app/agent/llm/provider/auth/status",
+    "data": {
+      "success": true,
+      "sessionId": "auth-example",
+      "status": "failed"
+    },
+    "status": "success",
+    "full": {
+      "sessionId": "auth-example",
+      "status": "failed"
+    },
+    "essential": {
+      "sessionId": "auth-example",
+      "status": "failed"
+    }
+  },
+  {
+    "name": "agent-provider-auth-cancel",
+    "target": "/app/agent/llm/provider/auth/cancel",
+    "data": {
+      "success": true
+    },
+    "status": "success",
+    "acknowledgement": true
+  },
+  {
+    "name": "agent-provider-auth-cancel-failed",
+    "target": "/app/agent/llm/provider/auth/cancel",
+    "data": {
+      "success": false
+    },
+    "status": "error",
+    "code": "OPERATION_FAILED"
+  },
+  {
+    "name": "agent-provider-auth-request-failed",
+    "target": "/app/agent/llm/provider/auth/complete",
+    "data": {
+      "success": false
+    },
+    "status": "error",
+    "code": "OPERATION_FAILED"
+  },
+  {
+    "name": "agent-provider-auth-request-malformed",
+    "target": "/app/agent/llm/provider/auth/status",
+    "data": {
+      "status": "persisted"
+    },
+    "status": "error",
+    "code": "INVALID_RESPONSE"
   }
 ]

package/manifest/app-facade.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.app-facade.v1",
-  "contractVersion": "1.69.0",
+  "contractVersion": "1.72.0",
   "callSchema": "schema/facade-call.v1.schema.json",
   "routing": "manifest/routing.v1.json",
   "routingSchema": "schema/routing.v1.schema.json",
@@ -83,7 +83,9 @@
         "/app/interaction-flow/next",
         "/app/interaction-flow/back",
         "/app/interaction-flow/complete",
-        "/app/interaction-flow/cancel"
+        "/app/interaction-flow/cancel",
+        "/app/interaction-flow/submission/status",
+        "/app/interaction-flow/submission/retry"
       ],
       "sessionPersistence": "memory"
     },
@@ -254,8 +256,7 @@
         "/app/group/create",
         "/app/group/rename",
         "/app/group/members/update",
-        "/app/group/delete",
-        "/app/group/presentation/get"
+        "/app/group/delete"
       ]
     },
     "resourceRead": {

package/manifest/authorization.v1.json

@@ -1,5 +1,5 @@
 {
-  "contractVersion": "1.69.0",
+  "contractVersion": "1.72.0",
   "operations": {
     "/app/agent/context/get": "spaceRead",
     "/app/agent/credit/usage": "spaceRead",
@@ -137,6 +137,8 @@
     "/app/interaction-flow/back": "spaceWrite",
     "/app/interaction-flow/cancel": "spaceWrite",
     "/app/interaction-flow/complete": "spaceWrite",
+    "/app/interaction-flow/submission/status": "spaceRead",
+    "/app/interaction-flow/submission/retry": "spaceWrite",
     "/app/interaction-flow/next": "spaceWrite",
     "/app/interaction-flow/resolve": "spaceRead",
     "/app/interaction-flow/start": "spaceWrite",
@@ -400,7 +402,6 @@
     "/app/group/create": "spaceWrite",
     "/app/group/rename": "spaceWrite",
     "/app/group/members/update": "spaceWrite",
-    "/app/group/presentation/get": "spaceRead",
     "/app/device/state/get": "spaceRead",
     "/app/device/history/series/get": "spaceRead",
     "/app/widget/value/get": "spaceRead",

package/manifest/host-provision-targets.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.host-provision.targets.v1",
-  "contractVersion": "1.69.0",
+  "contractVersion": "1.72.0",
   "contract": "contract/host-provisioning-v1.md",
   "localTargets": [
     "/local/host/provision/start",

package/manifest/hub-targets.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.hub.targets.v1",
-  "contractVersion": "1.69.0",
+  "contractVersion": "1.72.0",
   "appTargets": [
     "/app/hub/get",
     "/app/hub/remove",

package/manifest/pod-targets.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.pod.targets.v1",
-  "contractVersion": "1.69.0",
+  "contractVersion": "1.72.0",
   "contract": "contract/pod-commissioning-v1.md",
   "localTargets": [
     "/local/pod/discovery/start",

package/manifest/routing.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.app-facade.routing.v1",
-  "contractVersion": "1.69.0",
+  "contractVersion": "1.72.0",
   "targetPrefix": "/app/",
   "default": {
     "execution": "scopeMode"

package/manifest/targets.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.messaging.targets.v1",
-  "contractVersion": "1.69.0",
+  "contractVersion": "1.72.0",
   "requestTargets": [
     "/app/messaging/provider/list",
     "/app/messaging/provider-account/list",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mhome/app-facade-protocol",
-  "version": "1.69.0",
+  "version": "1.72.0",
   "description": "Build-time protocol artifacts for mhome.app-facade",
   "license": "MIT",
   "repository": {

package/protocol.json

@@ -1,6 +1,6 @@
 {
   "protocol": "mhome.app-facade",
-  "contractVersion": "1.69.0",
+  "contractVersion": "1.72.0",
   "manifest": "manifest/app-facade.v1.json",
   "schemas": {
     "hostAuthorization": "schema/host-authorization.v1.schema.json",

package/schema/group.v1.schema.json

@@ -6,7 +6,7 @@
       "type": "object",
       "additionalProperties": false,
       "properties": {
-        "memberType": {
+        "entityType": {
           "type": "string",
           "minLength": 1
         }
@@ -31,19 +31,6 @@
         "ids"
       ]
     },
-    "GroupPresentationInput": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "groupId": {
-          "type": "string",
-          "minLength": 1
-        }
-      },
-      "required": [
-        "groupId"
-      ]
-    },
     "CreateGroupInput": {
       "type": "object",
       "additionalProperties": false,
@@ -57,11 +44,11 @@
           "type": "string",
           "minLength": 1
         },
-        "memberType": {
+        "entityType": {
           "type": "string",
           "minLength": 1
         },
-        "memberIds": {
+        "entityIds": {
           "type": "array",
           "minItems": 1,
           "items": {
@@ -73,8 +60,8 @@
       "required": [
         "creationId",
         "name",
-        "memberType",
-        "memberIds"
+        "entityType",
+        "entityIds"
       ]
     },
     "RenameGroupInput": {
@@ -108,7 +95,7 @@
           "type": "string",
           "minLength": 1
         },
-        "memberIds": {
+        "entityIds": {
           "type": "array",
           "minItems": 1,
           "items": {
@@ -123,7 +110,7 @@
       },
       "required": [
         "groupId",
-        "memberIds",
+        "entityIds",
         "expectedRevision"
       ]
     },
@@ -157,7 +144,7 @@
           "type": "string",
           "minLength": 1
         },
-        "memberType": {
+        "entityType": {
           "type": "string",
           "minLength": 1
         },
@@ -189,7 +176,7 @@
       "required": [
         "groupId",
         "name",
-        "memberType",
+        "entityType",
         "memberCount",
         "revision",
         "applyState",
@@ -209,7 +196,7 @@
           "type": "string",
           "minLength": 1
         },
-        "memberType": {
+        "entityType": {
           "type": "string",
           "minLength": 1
         },
@@ -237,7 +224,7 @@
           "type": "integer",
           "minimum": 1
         },
-        "memberIds": {
+        "entityIds": {
           "type": "array",
           "minItems": 1,
           "items": {
@@ -273,7 +260,7 @@
             "type": "object",
             "additionalProperties": false,
             "properties": {
-              "memberId": {
+              "entityId": {
                 "type": "string",
                 "minLength": 1
               },
@@ -287,7 +274,7 @@
               }
             },
             "required": [
-              "memberId",
+              "entityId",
               "code",
               "message"
             ]
@@ -316,15 +303,13 @@
       "required": [
         "groupId",
         "name",
-        "memberType",
+        "entityType",
         "memberCount",
         "revision",
         "applyState",
         "createdAt",
         "updatedAt",
-        "memberIds",
-        "capabilities",
-        "memberProblems"
+        "entityIds"
       ]
     },
     "GroupMutationOutput": {

package/schema/interaction-flow-app.v1.schema.json

@@ -13,7 +13,9 @@
     "cancelRequest": { "$ref": "#/$defs/cancelRequest" },
     "view": { "$ref": "#/$defs/view" },
     "completeResponse": { "$ref": "#/$defs/completeResponse" },
-    "cancelResponse": { "$ref": "#/$defs/cancelResponse" }
+    "cancelResponse": { "$ref": "#/$defs/cancelResponse" },
+    "submissionRequest": { "$ref": "#/$defs/submissionRequest" },
+    "submissionResponse": { "$ref": "#/$defs/submissionResponse" }
   },
   "$defs": {
     "nonEmpty": { "type": "string", "minLength": 1, "maxLength": 256 },
@@ -171,13 +173,15 @@
       "type": "object",
       "additionalProperties": false,
       "required": ["completed"],
-      "properties": { "completed": { "type": "boolean" }, "result": true }
+      "properties": { "completed": { "type": "boolean" }, "result": true, "submission": { "$ref": "#/$defs/submissionResponse" } }
     },
     "cancelResponse": {
       "type": "object",
       "additionalProperties": false,
       "required": ["cancelled"],
       "properties": { "cancelled": { "type": "boolean" } }
-    }
+    },
+    "submissionRequest": {"type": "object", "additionalProperties": false, "required": ["source", "submissionId"], "properties": {"source": {"$ref": "#/$defs/source"}, "submissionId": {"type": "string", "minLength": 1, "maxLength": 256}}},
+    "submissionResponse": {"oneOf": [{"type": "object", "additionalProperties": false, "required": ["status"], "properties": {"status": {"const": "notFound"}}}, {"type": "object", "additionalProperties": false, "required": ["status"], "properties": {"status": {"const": "accepted"}}}, {"type": "object", "additionalProperties": false, "required": ["status", "result"], "properties": {"status": {"const": "completed"}, "result": true}}]}
   }
 }