@mhome/app-facade-protocol 1.125.0 → 1.126.0

package/contract/space-presentation-v1.md

@@ -1,7 +1,8 @@
 # Space presentation and focused business readers
 
 All calls use the standard App Facade envelope. These presentation targets are
-UI reads, not Agent tools. They execute in the cloud and require user identity.
+UI reads, not Agent tools. List/get execute in the cloud and require user identity;
+the Location reader follows Space mode.
 
 - `/app/presentation/space/list` accepts `{}` and returns `{spaces}`. Each item
   has `spaceId`, `name`, `mode`, `llmMode`, `betaMode`, `defaultActive`,
@@ -13,11 +14,14 @@ UI reads, not Agent tools. They execute in the cloud and require user identity.
   Only `includeMembers:true` reads the Space membership list and member profiles.
   Each member has `userId`, `email`, `name`, `pending` and `role`. Active members
   may read this presentation; management mutations still require their own grants.
-- `/app/space/location/list` accepts `{}` and returns `{locations}`. Each Location
+- `/app/presentation/space/location/list` accepts `{}` and returns `{locations}`. Each Location
   has `spaceId`, `locationId`, `name`, `address`, `timezone`, `countryCode`,
   `latitude`, `longitude`, and `altitude`. It executes according to Space mode,
   reading only the authoritative backend's Locations; it does not read Space
   details, members or preferences and has no cloud fallback in local mode.
+
+## Shared Space management
+
 - `/app/space/delete/status` accepts `{operationId}` and returns `accepted`,
   `operationId`, `spaceId`, `state`, `message`, and `deleted`. It queries the
   existing durable operation and never starts or restarts deletion. Authorization
@@ -25,13 +29,19 @@ UI reads, not Agent tools. They execute in the cloud and require user identity.
   of membership and Space data. The request retains the operation's Space ID.
 - `/app/space/beta/update` accepts `{betaMode: boolean}` and returns
   `{betaMode, poll}`. It saves through the existing Space Beta service. A true
-  `poll` means the Client must wait for the Hub to apply the selected mode.
+  `poll` means the Hub has not yet been verified to apply the selected mode.
+  This owner-only business mutation is shared by UI, native Agent/Skill, MCP
+  and CLI. A local Space may restart and interrupt running operations. The
+  receipt confirms the saved selection; it never proves Hub restart completion.
 
 Invitation accept/reject remain membership operations and never select a Client's
 Space. The UI explicitly uses the connection focus protocol after joining when
 its flow intends to enter the joined Space. Current-Space switches must not be
 discarded by the previous Space's request guard.
 
+The retired `/app/space/location/list` has no compatibility alias. The UI uses
+`/app/presentation/space/location/list`; no independent Agent/MCP/CLI reader is exposed.
+
 Client handling of presentation replies unwraps successful Full Facade responses
 before updating cloud-authoritative membership/connection caches. Presentation
 wire DTOs (`spaceId`, `llmMode`) are explicitly projected into native state;

package/fixtures/authorization/decisions.json

@@ -864,7 +864,7 @@
     "allowed": false
   },
   {
-    "name": "space-ui:MEMBER:/app/space/location/list",
+    "name": "space-ui:MEMBER:/app/presentation/space/location/list",
     "principal": {
       "kind": "user",
       "userId": "user"
@@ -872,11 +872,11 @@
     "memberRole": "MEMBER",
     "tenantId": "tenant",
     "spaceId": "space",
-    "target": "/app/space/location/list",
+    "target": "/app/presentation/space/location/list",
     "allowed": true
   },
   {
-    "name": "space-ui:unscoped:/app/space/location/list",
+    "name": "space-ui:unscoped:/app/presentation/space/location/list",
     "principal": {
       "kind": "user",
       "userId": "user"
@@ -884,7 +884,7 @@
     "memberRole": null,
     "tenantId": "tenant",
     "spaceId": "space",
-    "target": "/app/space/location/list",
+    "target": "/app/presentation/space/location/list",
     "allowed": false
   },
   {

package/fixtures/routing/cases.json

@@ -768,7 +768,7 @@
     "entry": "unavailable"
   },
   {
-    "target": "/app/space/location/list",
+    "target": "/app/presentation/space/location/list",
     "execution": "spaceMode",
     "placement": null,
     "hubReady": true,
@@ -776,7 +776,7 @@
     "entry": "hub"
   },
   {
-    "target": "/app/space/location/list",
+    "target": "/app/presentation/space/location/list",
     "execution": "spaceMode",
     "placement": null,
     "hubReady": true,
@@ -784,7 +784,7 @@
     "entry": "hub"
   },
   {
-    "target": "/app/space/location/list",
+    "target": "/app/presentation/space/location/list",
     "execution": "spaceMode",
     "placement": null,
     "hubReady": false,
@@ -792,7 +792,7 @@
     "entry": "cloud"
   },
   {
-    "target": "/app/space/location/list",
+    "target": "/app/presentation/space/location/list",
     "execution": "spaceMode",
     "placement": null,
     "hubReady": false,

package/manifest/app-facade.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.app-facade.v1",
-  "contractVersion": "1.125.0",
+  "contractVersion": "1.126.0",
   "callSchema": "schema/facade-call.v1.schema.json",
   "routing": "manifest/routing.v1.json",
   "routingSchema": "schema/routing.v1.schema.json",
@@ -331,9 +331,14 @@
       "requestTargets": [
         "/app/presentation/space/list",
         "/app/presentation/space/get",
+        "/app/presentation/space/location/list"
+      ]
+    },
+    "spaceManagement": {
+      "contract": "contract/space-presentation-v1.md",
+      "requestTargets": [
         "/app/space/delete/status",
-        "/app/space/beta/update",
-        "/app/space/location/list"
+        "/app/space/beta/update"
       ]
     },
     "automationPresentation": {

package/manifest/authorization.v1.json

@@ -1,5 +1,5 @@
 {
-  "contractVersion": "1.125.0",
+  "contractVersion": "1.126.0",
   "operations": {
     "/app/agent/context/get": "spaceRead",
     "/app/agent/credit/usage": "spaceRead",
@@ -274,7 +274,7 @@
     "/app/space/list": "userRead",
     "/app/space/location/create": "spaceManage",
     "/app/space/location/delete": "spaceManage",
-    "/app/space/location/list": "spaceRead",
+    "/app/presentation/space/location/list": "spaceRead",
     "/app/space/location/search": "userRead",
     "/app/space/location/update": "spaceManage",
     "/app/space/member/invite": "spaceManage",

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

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.host-provision.targets.v1",
-  "contractVersion": "1.125.0",
+  "contractVersion": "1.126.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.125.0",
+  "contractVersion": "1.126.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.125.0",
+  "contractVersion": "1.126.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.125.0",
+  "contractVersion": "1.126.0",
   "targetPrefix": "/app/",
   "default": {
     "execution": "spaceMode"
@@ -73,7 +73,7 @@
       "/app/host/service/restart",
       "/app/pod/list",
       "/app/now/attention/list",
-      "/app/space/location/list",
+      "/app/presentation/space/location/list",
       "/app/trace/get"
     ],
     "hubPrefixes": [

package/manifest/targets.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.messaging.targets.v1",
-  "contractVersion": "1.125.0",
+  "contractVersion": "1.126.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.125.0",
+  "version": "1.126.0",
   "description": "Build-time protocol artifacts for mhome.app-facade",
   "license": "Apache-2.0",
   "repository": {

package/protocol.json

@@ -1,6 +1,6 @@
 {
   "protocol": "mhome.app-facade",
-  "contractVersion": "1.125.0",
+  "contractVersion": "1.126.0",
   "manifest": "manifest/app-facade.v1.json",
   "schemas": {
     "storage": "schema/storage.v1.schema.json",