@mhome/app-facade-protocol 1.69.0 → 1.71.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/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

@@ -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.71.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"
     },

package/manifest/authorization.v1.json

@@ -1,5 +1,5 @@
 {
-  "contractVersion": "1.69.0",
+  "contractVersion": "1.71.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",

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

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.host-provision.targets.v1",
-  "contractVersion": "1.69.0",
+  "contractVersion": "1.71.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.71.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.71.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.71.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.71.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.71.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.71.0",
   "manifest": "manifest/app-facade.v1.json",
   "schemas": {
     "hostAuthorization": "schema/host-authorization.v1.schema.json",

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}}]}
   }
 }