@mhome/app-facade-protocol 1.42.2 → 1.44.0

package/manifest/app-facade.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.app-facade.v1",
-  "contractVersion": "1.42.2",
+  "contractVersion": "1.44.0",
   "callSchema": "schema/facade-call.v1.schema.json",
   "routing": "manifest/routing.v1.json",
   "routingSchema": "schema/routing.v1.schema.json",
@@ -11,7 +11,10 @@
         "/app/artifact/resolve",
         "/app/artifact/put",
         "/app/artifact/import",
-        "/app/artifact/delete"
+        "/app/artifact/delete",
+        "/app/artifact/upload/start",
+        "/app/artifact/upload/complete",
+        "/app/artifact/upload/cancel"
       ]
     },
     "hub": {
@@ -33,7 +36,6 @@
     "plugin": {
       "extensionVersion": "v1",
       "targetPrefix": "/app/plugin",
-      "catalog": "manifest/plugin-catalog.v1.json",
       "catalogSchema": "schema/plugin-catalog.v1.schema.json",
       "exactRequestTargets": [
         "/app/plugin/catalog/list",
@@ -84,14 +86,11 @@
       "hostsSchema": "schema/system-hosts.v1.schema.json",
       "hostsRuntimeContract": "mhome.system.hosts.runtime.v1",
       "hostsRuntimeSchema": "schema/system-hosts-runtime.v1.schema.json",
-      "hostsClaimContract": "mhome.system.hosts.claim.v1",
-      "hostsClaimSchema": "schema/system-hosts-claim.v1.schema.json",
       "requestTargets": [
         "/app/system/instances/get",
         "/app/system/clients/get",
         "/app/system/hosts/get",
-        "/app/system/hosts/runtime",
-        "/app/system/hosts/claim"
+        "/app/system/hosts/runtime"
       ]
     },
     "integration": {
@@ -138,6 +137,17 @@
         "/app/user/profile/avatar/clear"
       ],
       "owner": "cloudAccount"
+    },
+    "hostManagement": {
+      "accessTarget": "/app/host/access/issue",
+      "accessSchema": "schema/host-access.v1.schema.json",
+      "principal": "user",
+      "issuer": "cloud",
+      "firstClaimTransport": "directLanOnly",
+      "authorizationTarget": "/app/host/authorization",
+      "authorizationSchema": "schema/host-authorization.v1.schema.json"
     }
-  }
+  },
+  "authorization": "manifest/authorization.v1.json",
+  "delegatedCallSchema": "schema/delegated-call.v1.schema.json"
 }

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

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.host-provision.targets.v1",
-  "contractVersion": "1.42.2",
+  "contractVersion": "1.44.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.42.2",
+  "contractVersion": "1.44.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.42.2",
+  "contractVersion": "1.44.0",
   "contract": "contract/pod-commissioning-v1.md",
   "localTargets": [
     "/local/pod/discovery/start",
@@ -61,13 +61,10 @@
   },
   "session": {
     "lifetimeMs": 600000,
-    "activationGraceMs": 30000,
-    "credentialStatusPollMs": 5000
+    "activationGraceMs": 30000
   },
   "cloud": {
-    "issue": "pod/credential/issue",
-    "status": "pod/credential/status",
-    "statusSchema": "schema/pod-credential-status.v1.schema.json",
+    "userLoginApprove": "pod/login/approve",
     "spaceIssue": "pod/space/credential/issue"
   },
   "activationErrorCodes": [

package/manifest/routing.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.app-facade.routing.v1",
-  "contractVersion": "1.42.2",
+  "contractVersion": "1.44.0",
   "targetPrefix": "/app/",
   "default": {
     "execution": "scopeMode",
@@ -21,14 +21,19 @@
       "/app/hub/remove",
       "/app/plugin/catalog/list",
       "/app/system/feedback/submit",
-      "/app/timeline/entity/latest/list"
+      "/app/timeline/entity/latest/list",
+      "/app/host/access/issue",
+      "/app/host/authorization"
     ],
     "scopeModeTargets": [
       "/app/artifact/resolve",
       "/app/scope/context/get",
       "/app/artifact/put",
       "/app/artifact/import",
-      "/app/artifact/delete"
+      "/app/artifact/delete",
+      "/app/artifact/upload/start",
+      "/app/artifact/upload/complete",
+      "/app/artifact/upload/cancel"
     ],
     "hubPrefixes": [
       "/app/plugin/",
@@ -57,7 +62,6 @@
       "/app/system/clients/get",
       "/app/system/hosts/get",
       "/app/system/hosts/runtime",
-      "/app/system/hosts/claim",
       "/app/person/summary-images/batch-get",
       "/app/person/status",
       "/app/person/list",

package/manifest/targets.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.messaging.targets.v1",
-  "contractVersion": "1.42.2",
+  "contractVersion": "1.44.0",
   "requestTargets": [
     "/app/messaging/provider/list",
     "/app/messaging/provider-account/list",
@@ -17,6 +17,8 @@
     "/app/messaging/setup/options",
     "/app/messaging/setup/start",
     "/app/messaging/setup/status",
+    "/app/messaging/setup/submit",
+    "/app/messaging/setup/cancel",
     "/app/messaging/surface/list",
     "/app/messaging/surface/dismiss",
     "/app/messaging/surface/bind-code/create",
@@ -41,6 +43,8 @@
     "/app/messaging/setup/options",
     "/app/messaging/setup/start",
     "/app/messaging/setup/status",
+    "/app/messaging/setup/submit",
+    "/app/messaging/setup/cancel",
     "/app/messaging/surface/list",
     "/app/messaging/surface/dismiss",
     "/app/messaging/surface/bind-code/create",

package/package.json

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

package/protocol.json

@@ -1,8 +1,10 @@
 {
   "protocol": "mhome.app-facade",
-  "contractVersion": "1.42.2",
+  "contractVersion": "1.44.0",
   "manifest": "manifest/app-facade.v1.json",
   "schemas": {
+    "hostAuthorization": "schema/host-authorization.v1.schema.json",
+    "hostAccess": "schema/host-access.v1.schema.json",
     "capabilityDescriptor": "schema/capability-descriptor.v1.schema.json",
     "call": "schema/facade-call.v1.schema.json",
     "frame": "schema/messaging-frame.v3.schema.json",
@@ -12,7 +14,6 @@
     "localHubState": "schema/local-hub-state.v1.schema.json",
     "podDiscovery": "schema/pod-discovery.v1.schema.json",
     "podCommission": "schema/pod-commission.v1.schema.json",
-    "podCredentialStatus": "schema/pod-credential-status.v1.schema.json",
     "hostProvision": "schema/host-provision.v1.schema.json",
     "systemClients": "schema/system-clients.v1.schema.json",
     "systemHosts": "schema/system-hosts.v1.schema.json",
@@ -24,6 +25,7 @@
   "fixtures": {
     "valid": "fixtures",
     "invalid": "fixtures/invalid",
+    "hostAccess": "schema/host-access.v1.schema.json",
     "capabilityDescriptor": "fixtures/capability-descriptor.conformance.json",
     "interactionFlow": "fixtures/interaction-flow.conformance.json"
   }

package/schema/host-access.v1.schema.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$defs": {
+    "request": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "challenge"
+      ],
+      "properties": {
+        "challenge": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 16384
+        }
+      }
+    },
+    "response": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "accessToken"
+      ],
+      "properties": {
+        "accessToken": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 16384
+        }
+      }
+    }
+  }
+}

package/schema/host-authorization.v1.schema.json

@@ -0,0 +1,55 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$defs": {
+    "request": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "action",
+            "challenge",
+            "recoverIdentity"
+          ],
+          "properties": {
+            "action": {
+              "const": "prepare"
+            },
+            "challenge": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 16384
+            },
+            "recoverIdentity": {
+              "type": "boolean"
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "action",
+            "requestId",
+            "proof"
+          ],
+          "properties": {
+            "action": {
+              "const": "commit"
+            },
+            "requestId": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 256
+            },
+            "proof": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 16384
+            }
+          }
+        }
+      ]
+    }
+  }
+}

package/schema/messaging-frame.v3.schema.json

@@ -41,7 +41,8 @@
     "deliveryMode": {
       "enum": [
         "unrestricted",
-        "session_window"
+        "session_window",
+        "reply_context"
       ]
     },
     "projectionUnsupportedReason": {
@@ -197,7 +198,9 @@
         "actor.link_code.create",
         "identity_code.status",
         "actor.link.list",
-        "actor.link.delete"
+        "actor.link.delete",
+        "setup.submit",
+        "setup.cancel"
       ]
     },
     "frontendProvider": {
@@ -2186,6 +2189,12 @@
         },
         {
           "$ref": "#/$defs/actorLinkDeleteRequest"
+        },
+        {
+          "$ref": "#/$defs/setupSubmitRequest"
+        },
+        {
+          "$ref": "#/$defs/setupCancelRequest"
         }
       ]
     },
@@ -2259,6 +2268,12 @@
         },
         {
           "$ref": "#/$defs/actorLinkDeleteResponse"
+        },
+        {
+          "$ref": "#/$defs/setupSubmitResponse"
+        },
+        {
+          "$ref": "#/$defs/setupCancelResponse"
         }
       ]
     },
@@ -2588,6 +2603,128 @@
           }
         }
       ]
+    },
+    "setupSubmitBody": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "provider",
+        "placement",
+        "setupId",
+        "data"
+      ],
+      "properties": {
+        "provider": {
+          "$ref": "#/$defs/providerId"
+        },
+        "placement": {
+          "$ref": "#/$defs/placement"
+        },
+        "setupId": {
+          "$ref": "#/$defs/id"
+        },
+        "data": {
+          "$ref": "#/$defs/extension"
+        }
+      }
+    },
+    "setupSubmitRequest": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "target",
+        "direction",
+        "body"
+      ],
+      "properties": {
+        "target": {
+          "const": "/app/messaging/setup/submit"
+        },
+        "direction": {
+          "const": "request"
+        },
+        "body": {
+          "$ref": "#/$defs/setupSubmitBody"
+        }
+      }
+    },
+    "setupSubmitResponse": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "target",
+        "direction",
+        "body"
+      ],
+      "properties": {
+        "target": {
+          "const": "/app/messaging/setup/submit"
+        },
+        "direction": {
+          "const": "response"
+        },
+        "body": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "setup"
+          ],
+          "properties": {
+            "setup": {
+              "$ref": "#/$defs/setupState"
+            }
+          }
+        }
+      }
+    },
+    "setupCancelRequest": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "target",
+        "direction",
+        "body"
+      ],
+      "properties": {
+        "target": {
+          "const": "/app/messaging/setup/cancel"
+        },
+        "direction": {
+          "const": "request"
+        },
+        "body": {
+          "$ref": "#/$defs/setupStatusBody"
+        }
+      }
+    },
+    "setupCancelResponse": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "target",
+        "direction",
+        "body"
+      ],
+      "properties": {
+        "target": {
+          "const": "/app/messaging/setup/cancel"
+        },
+        "direction": {
+          "const": "response"
+        },
+        "body": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "setup"
+          ],
+          "properties": {
+            "setup": {
+              "$ref": "#/$defs/setupState"
+            }
+          }
+        }
+      }
     }
   }
 }