@mhome/app-facade-protocol 1.127.1 → 1.128.0

package/README.md

@@ -39,15 +39,18 @@ conversion belongs at the Facade implementation boundary.
 
 Agent Profile get/save use `content` for the complete document. LLM mode get/save
 use `llmMode`; summary and default-provider metadata use that same field.
-`control.mode` selects response detail. Each LLM use case has one current model. The existing
+`control.responseDetail` selects response detail. Each LLM use case has one current model. The existing
 `/app/agent/llm/summary` operation owns the combined LLM read used by UI and CLI.
 See the Agent cases in the shared [presentation fixtures](fixtures/presentation/cases.json).
 
-Client workflows may coordinate input, login, polling and local files. Native
-Profile updates may run model-based merging. These workflows own explicit final
-results and compose real Facade calls; they are not alternative DTOs for a single
-Facade operation. A UI view model may derive display state after the SDK boundary.
-Composition does not imply a distributed transaction or automatic rollback.
+Business aggregation, multi-write orchestration and overall outcome settlement belong
+behind a Facade. Clients may make independent reads needed by the caller and adapt
+arguments, local files and terminal/UI input. They may drive defined prepare/commit,
+interactive-session and asynchronous-operation protocols; the backend owns business
+steps, transitions and final DTOs. Do not implement product business composites or
+alternative DTOs in CLI, SDK or surface adapters. A UI view model may derive display
+state after the SDK boundary. Backend composition does not imply a distributed
+transaction or automatic rollback.
 
 ## Full values and Essential presentation
 

package/contract/space-presentation-v1.md

@@ -49,7 +49,42 @@ login and Hub authorization retain their independently owned wire DTOs.
 
 Legacy `/scope/list`, `/scope/get`, `/scope/preference/get`, `/scope/agent/get`,
 and `/scope/location/list` readers are retired, without fallback aliases. Native
-UI membership refresh uses `/app/presentation/space/list`; the CLI uses
-`/app/space/list` for identity-only listing and selection checks, and presentation
-listing for its full management view. Neither lightweight flow expands per-Space
-context. `/focus` remains connection control, not a business Facade.
+UI membership refresh uses `/app/presentation/space/list`. CLI `space list` forwards
+`/app/space/list` and its canonical `{spaces}` DTO with `spaceId`, `name`, `mode`,
+`llmMode` and `lifecycleState`. It never expands per-Space context or adds local
+active-Space state and Hub routes. Read selected details, members and preferences
+through their own Facades. CLI selection uses `/app/client/space/focus`; it returns
+`{focusedSpaceId}` and leaves membership validation/persistence to the receiving
+Client and authoritative executor. `/focus` has no compatibility alias.
+
+Space commands pass the caller's Full/Essential choice to the Facade. Prepare
+previews remain fixed control objects. Whole-Space deletion drives the existing
+asynchronous protocol using structured Full control reads, then returns the
+unchanged `/app/space/delete/status` DTO in the requested detail. It does not
+rewrite `action` or hide operation fields. A successful status read may describe
+`DELETE_FAILED`; waiting for that failed operation still exits unsuccessfully.
+
+## Space mutation outcomes
+
+The backend settles member invite/remove outcomes before presentation. A request
+with no failed items succeeds, including already-pending/already-member invitations
+and removal of absent memberships. Fulfilled and failed items together return
+`partial`; failure of every requested item returns `error` with the complete
+per-item result in diagnostics. Full and Essential retain the same outcome.
+Location writes with `NotCreated`, `NotUpdated` or `NotDeleted` return `error`,
+with the original write result in diagnostics. Prepared previews describe planned
+work and never prove effects. Reading a failed deletion operation remains a
+successful read; accepting deletion never means erasure has completed.
+
+`/app/space/member/update` accepts `{removeEmails?: string[], inviteEmails?: string[]}`
+with at least one requested change. UI member editing and the human-operated CLI
+share this business composite. The backend normalizes/resolves all inputs and
+rejects an OWNER removal before any write. It then removes memberships and sends
+invitations under one Space mutation lock; it does not promise rollback. The same
+email cannot be removed and invited together. Its complete result is
+`{action, spaceId, removal, invitation, problems}`; removal/invitation preserve
+those individual operations' DTOs. If invitation execution becomes unconfirmed,
+`invitation` is null and `problems` explains that membership must be inspected
+before retrying. The backend settles the overall outcome. It supports direct and
+prepared modes; previews perform no writes. This operation does not extend the
+native Agent, MCP or external Skill boundary for member removal.

package/fixtures/presentation/cases.json

@@ -1147,8 +1147,8 @@
           "spaceId": "space-demo",
           "name": "Home",
           "mode": "local",
-          "agentMode": "cloud",
-          "lifecycleState": "ACTIVE"
+          "lifecycleState": "ACTIVE",
+          "llmMode": "cloud"
         }
       ]
     },
@@ -1159,8 +1159,8 @@
           "spaceId": "space-demo",
           "name": "Home",
           "mode": "local",
-          "agentMode": "cloud",
-          "lifecycleState": "ACTIVE"
+          "lifecycleState": "ACTIVE",
+          "llmMode": "cloud"
         }
       ]
     }
@@ -1173,8 +1173,8 @@
         "spaceId": "space-demo",
         "name": "Home",
         "mode": "local",
-        "agentMode": "cloud",
-        "lifecycleState": "ACTIVE"
+        "lifecycleState": "ACTIVE",
+        "llmMode": "cloud"
       },
       "locations": [
         {
@@ -1196,8 +1196,8 @@
         "spaceId": "space-demo",
         "name": "Home",
         "mode": "local",
-        "agentMode": "cloud",
-        "lifecycleState": "ACTIVE"
+        "lifecycleState": "ACTIVE",
+        "llmMode": "cloud"
       },
       "locations": [
         {
@@ -1239,7 +1239,7 @@
         "invalid@example.com"
       ]
     },
-    "status": "success",
+    "status": "partial",
     "essential": {
       "action": "Invited",
       "spaceId": "space-demo",
@@ -2171,7 +2171,7 @@
       "llmUseCases": [
         {
           "useCase": "chat",
-          "displayName": "\u5bf9\u8bdd",
+          "displayName": "对话",
           "description": null,
           "ownerType": "system",
           "ownerId": "agent",
@@ -2199,7 +2199,7 @@
           "models": [
             {
               "id": "demo-chat",
-              "displayName": "\u793a\u4f8b\u5bf9\u8bdd\u6a21\u578b",
+              "displayName": "示例对话模型",
               "modelType": "chat",
               "available": true,
               "deprecated": false,
@@ -2235,7 +2235,7 @@
       "providers": [
         {
           "provider": "local_example",
-          "displayName": "\u793a\u4f8b Provider",
+          "displayName": "示例 Provider",
           "runtime": "local",
           "modelSource": "catalog",
           "catalogProvider": "example",
@@ -2306,7 +2306,7 @@
       "llmUseCases": [
         {
           "useCase": "chat",
-          "displayName": "\u5bf9\u8bdd",
+          "displayName": "对话",
           "configurable": true,
           "active": true,
           "requirements": {
@@ -2328,7 +2328,7 @@
           "models": [
             {
               "id": "demo-chat",
-              "displayName": "\u793a\u4f8b\u5bf9\u8bdd\u6a21\u578b",
+              "displayName": "示例对话模型",
               "modelType": "chat",
               "available": true,
               "deprecated": false,
@@ -2359,7 +2359,7 @@
       "providers": [
         {
           "provider": "local_example",
-          "displayName": "\u793a\u4f8b Provider",
+          "displayName": "示例 Provider",
           "runtime": "local",
           "useCases": [
             "chat"
@@ -2400,7 +2400,7 @@
           "models": [
             {
               "id": "demo-chat",
-              "displayName": "\u793a\u4f8b\u5bf9\u8bdd\u6a21\u578b",
+              "displayName": "示例对话模型",
               "modelType": "chat",
               "available": true,
               "deprecated": false,
@@ -2428,7 +2428,7 @@
       "providers": [
         {
           "provider": "local_example",
-          "displayName": "\u793a\u4f8b Provider",
+          "displayName": "示例 Provider",
           "runtime": "local",
           "modelSource": "catalog",
           "catalogProvider": "example",
@@ -2461,7 +2461,7 @@
           "models": [
             {
               "id": "demo-chat",
-              "displayName": "\u793a\u4f8b\u5bf9\u8bdd\u6a21\u578b",
+              "displayName": "示例对话模型",
               "modelType": "chat",
               "available": true,
               "deprecated": false,
@@ -2486,7 +2486,7 @@
       "providers": [
         {
           "provider": "local_example",
-          "displayName": "\u793a\u4f8b Provider",
+          "displayName": "示例 Provider",
           "runtime": "local",
           "useCases": [
             "chat"
@@ -2531,7 +2531,7 @@
           "models": [
             {
               "id": "demo-chat",
-              "displayName": "\u793a\u4f8b\u5bf9\u8bdd\u6a21\u578b",
+              "displayName": "示例对话模型",
               "modelType": "chat",
               "available": true,
               "deprecated": false,
@@ -2589,7 +2589,7 @@
           "models": [
             {
               "id": "demo-chat",
-              "displayName": "\u793a\u4f8b\u5bf9\u8bdd\u6a21\u578b",
+              "displayName": "示例对话模型",
               "modelType": "chat",
               "available": true,
               "deprecated": false,
@@ -2640,7 +2640,7 @@
       "llmUseCases": [
         {
           "useCase": "chat",
-          "displayName": "\u5bf9\u8bdd",
+          "displayName": "对话",
           "description": null,
           "ownerType": "system",
           "ownerId": "agent",
@@ -2682,7 +2682,7 @@
       "llmUseCases": [
         {
           "useCase": "chat",
-          "displayName": "\u5bf9\u8bdd",
+          "displayName": "对话",
           "configurable": true,
           "active": true,
           "requirements": {
@@ -2738,22 +2738,22 @@
     "name": "agent-memory-text",
     "target": "/app/agent/memory/get",
     "data": {
-      "content": "\u5ba2\u5385\u7a7a\u8c03\u8bbe\u5b9a\u4e3a 26\u00b0C \u524d\u5148\u5f81\u6c42\u7528\u6237\u540c\u610f\u3002"
+      "content": "客厅空调设定为 26°C 前先征求用户同意。"
     },
     "status": "success",
     "essential": {
-      "content": "\u5ba2\u5385\u7a7a\u8c03\u8bbe\u5b9a\u4e3a 26\u00b0C \u524d\u5148\u5f81\u6c42\u7528\u6237\u540c\u610f\u3002"
+      "content": "客厅空调设定为 26°C 前先征求用户同意。"
     }
   },
   {
     "name": "agent-identity-text",
     "target": "/app/agent/identity/get",
     "data": {
-      "content": "\u4f7f\u7528\u4e2d\u6587\uff0c\u56de\u7b54\u7b80\u6d01\u3002"
+      "content": "使用中文，回答简洁。"
     },
     "status": "success",
     "essential": {
-      "content": "\u4f7f\u7528\u4e2d\u6587\uff0c\u56de\u7b54\u7b80\u6d01\u3002"
+      "content": "使用中文，回答简洁。"
     }
   },
   {
@@ -4537,5 +4537,508 @@
         "createdAt": "2024-11-03 14:30:00.123 +08:00 (Asia/Shanghai)"
       }
     }
+  },
+  {
+    "name": "space-invite-all-failed",
+    "target": "/app/space/member/invite",
+    "data": {
+      "action": "Unchanged",
+      "spaceId": "space-demo",
+      "requested": [
+        "a@example.com"
+      ],
+      "invited": [],
+      "alreadyPending": [],
+      "alreadyMembers": [],
+      "failed": [
+        "a@example.com"
+      ]
+    },
+    "status": "error",
+    "code": "OPERATION_FAILED",
+    "essential": {
+      "status": "error",
+      "error": {
+        "code": "OPERATION_FAILED",
+        "message": "No requested Space member operation succeeded",
+        "details": {
+          "action": "Unchanged",
+          "spaceId": "space-demo",
+          "requested": [
+            "a@example.com"
+          ],
+          "invited": [],
+          "alreadyPending": [],
+          "alreadyMembers": [],
+          "failed": [
+            "a@example.com"
+          ]
+        }
+      }
+    }
+  },
+  {
+    "name": "space-invite-alreadyPending",
+    "target": "/app/space/member/invite",
+    "data": {
+      "action": "Unchanged",
+      "spaceId": "space-demo",
+      "requested": [
+        "a@example.com"
+      ],
+      "invited": [],
+      "alreadyPending": [
+        "a@example.com"
+      ],
+      "alreadyMembers": [],
+      "failed": []
+    },
+    "status": "success",
+    "essential": {
+      "action": "Unchanged",
+      "spaceId": "space-demo",
+      "requested": [
+        "a@example.com"
+      ],
+      "invited": [],
+      "alreadyPending": [
+        "a@example.com"
+      ],
+      "alreadyMembers": [],
+      "failed": []
+    }
+  },
+  {
+    "name": "space-invite-alreadyMembers",
+    "target": "/app/space/member/invite",
+    "data": {
+      "action": "Unchanged",
+      "spaceId": "space-demo",
+      "requested": [
+        "a@example.com"
+      ],
+      "invited": [],
+      "alreadyPending": [],
+      "alreadyMembers": [
+        "a@example.com"
+      ],
+      "failed": []
+    },
+    "status": "success",
+    "essential": {
+      "action": "Unchanged",
+      "spaceId": "space-demo",
+      "requested": [
+        "a@example.com"
+      ],
+      "invited": [],
+      "alreadyPending": [],
+      "alreadyMembers": [
+        "a@example.com"
+      ],
+      "failed": []
+    }
+  },
+  {
+    "name": "space-remove-success",
+    "target": "/app/space/member/remove",
+    "data": {
+      "action": "Removed",
+      "spaceId": "space-demo",
+      "requested": [
+        "a@example.com"
+      ],
+      "removed": [],
+      "notMembership": [
+        "a@example.com"
+      ],
+      "failed": []
+    },
+    "status": "success",
+    "essential": {
+      "action": "Removed",
+      "spaceId": "space-demo",
+      "requested": [
+        "a@example.com"
+      ],
+      "removed": [],
+      "notMembership": [
+        "a@example.com"
+      ],
+      "failed": []
+    }
+  },
+  {
+    "name": "space-remove-partial",
+    "target": "/app/space/member/remove",
+    "data": {
+      "action": "Removed",
+      "spaceId": "space-demo",
+      "requested": [
+        "a@example.com",
+        "b@example.com"
+      ],
+      "removed": [
+        "a@example.com"
+      ],
+      "notMembership": [],
+      "failed": [
+        "b@example.com"
+      ]
+    },
+    "status": "partial",
+    "essential": {
+      "action": "Removed",
+      "spaceId": "space-demo",
+      "requested": [
+        "a@example.com",
+        "b@example.com"
+      ],
+      "removed": [
+        "a@example.com"
+      ],
+      "notMembership": [],
+      "failed": [
+        "b@example.com"
+      ]
+    }
+  },
+  {
+    "name": "space-remove-error",
+    "target": "/app/space/member/remove",
+    "data": {
+      "action": "Removed",
+      "spaceId": "space-demo",
+      "requested": [
+        "a@example.com"
+      ],
+      "removed": [],
+      "notMembership": [],
+      "failed": [
+        "a@example.com"
+      ]
+    },
+    "status": "error",
+    "code": "OPERATION_FAILED",
+    "essential": {
+      "status": "error",
+      "error": {
+        "code": "OPERATION_FAILED",
+        "message": "No requested Space member operation succeeded",
+        "details": {
+          "action": "Removed",
+          "spaceId": "space-demo",
+          "requested": [
+            "a@example.com"
+          ],
+          "removed": [],
+          "notMembership": [],
+          "failed": [
+            "a@example.com"
+          ]
+        }
+      }
+    }
+  },
+  {
+    "name": "space-location-create-failed",
+    "target": "/app/space/location/create",
+    "data": {
+      "action": "NotCreated",
+      "spaceId": "space-demo",
+      "locationId": "office",
+      "name": "Office"
+    },
+    "status": "error",
+    "code": "OPERATION_FAILED",
+    "essential": {
+      "status": "error",
+      "error": {
+        "code": "OPERATION_FAILED",
+        "message": "The Space Location write did not succeed",
+        "details": {
+          "action": "NotCreated",
+          "spaceId": "space-demo",
+          "locationId": "office",
+          "name": "Office"
+        }
+      }
+    }
+  },
+  {
+    "name": "space-location-update-failed",
+    "target": "/app/space/location/update",
+    "data": {
+      "action": "NotUpdated",
+      "spaceId": "space-demo",
+      "locationId": "office",
+      "name": "Office"
+    },
+    "status": "error",
+    "code": "OPERATION_FAILED",
+    "essential": {
+      "status": "error",
+      "error": {
+        "code": "OPERATION_FAILED",
+        "message": "The Space Location write did not succeed",
+        "details": {
+          "action": "NotUpdated",
+          "spaceId": "space-demo",
+          "locationId": "office",
+          "name": "Office"
+        }
+      }
+    }
+  },
+  {
+    "name": "space-location-delete-failed",
+    "target": "/app/space/location/delete",
+    "data": {
+      "action": "NotDeleted",
+      "spaceId": "space-demo",
+      "locationId": "office",
+      "name": "Office",
+      "deleted": false
+    },
+    "status": "error",
+    "code": "OPERATION_FAILED",
+    "essential": {
+      "status": "error",
+      "error": {
+        "code": "OPERATION_FAILED",
+        "message": "The Space Location write did not succeed",
+        "details": {
+          "action": "NotDeleted",
+          "spaceId": "space-demo",
+          "locationId": "office",
+          "name": "Office",
+          "deleted": false
+        }
+      }
+    }
+  },
+  {
+    "name": "space-delete-failed-operation-read",
+    "target": "/app/space/delete/status",
+    "data": {
+      "accepted": true,
+      "operationId": "operation-demo",
+      "spaceId": "space-demo",
+      "state": "DELETE_FAILED",
+      "message": "Hub did not confirm erasure",
+      "deleted": false
+    },
+    "status": "success",
+    "essential": {
+      "accepted": true,
+      "operationId": "operation-demo",
+      "spaceId": "space-demo",
+      "state": "DELETE_FAILED",
+      "message": "Hub did not confirm erasure",
+      "deleted": false
+    }
+  },
+  {
+    "name": "space-member-changes-success",
+    "target": "/app/space/member/update",
+    "data": {
+      "action": "Updated",
+      "spaceId": "space-demo",
+      "removal": {
+        "action": "Removed",
+        "spaceId": "space-demo",
+        "requested": [
+          "old@example.com"
+        ],
+        "removed": [
+          "old@example.com"
+        ],
+        "notMembership": [],
+        "failed": []
+      },
+      "invitation": {
+        "action": "Invited",
+        "spaceId": "space-demo",
+        "requested": [
+          "new@example.com"
+        ],
+        "invited": [
+          "new@example.com"
+        ],
+        "alreadyPending": [],
+        "alreadyMembers": [],
+        "failed": []
+      },
+      "problems": []
+    },
+    "status": "success",
+    "essential": {
+      "action": "Updated",
+      "spaceId": "space-demo",
+      "removal": {
+        "action": "Removed",
+        "spaceId": "space-demo",
+        "requested": [
+          "old@example.com"
+        ],
+        "removed": [
+          "old@example.com"
+        ],
+        "notMembership": [],
+        "failed": []
+      },
+      "invitation": {
+        "action": "Invited",
+        "spaceId": "space-demo",
+        "requested": [
+          "new@example.com"
+        ],
+        "invited": [
+          "new@example.com"
+        ],
+        "alreadyPending": [],
+        "alreadyMembers": [],
+        "failed": []
+      },
+      "problems": []
+    }
+  },
+  {
+    "name": "space-member-changes-partial",
+    "target": "/app/space/member/update",
+    "data": {
+      "action": "Updated",
+      "spaceId": "space-demo",
+      "removal": {
+        "action": "Removed",
+        "spaceId": "space-demo",
+        "requested": [
+          "old@example.com"
+        ],
+        "removed": [
+          "old@example.com"
+        ],
+        "notMembership": [],
+        "failed": []
+      },
+      "invitation": {
+        "action": "Invited",
+        "spaceId": "space-demo",
+        "requested": [
+          "new@example.com"
+        ],
+        "invited": [],
+        "alreadyPending": [],
+        "alreadyMembers": [],
+        "failed": [
+          "new@example.com"
+        ]
+      },
+      "problems": []
+    },
+    "status": "partial",
+    "essential": {
+      "action": "Updated",
+      "spaceId": "space-demo",
+      "removal": {
+        "action": "Removed",
+        "spaceId": "space-demo",
+        "requested": [
+          "old@example.com"
+        ],
+        "removed": [
+          "old@example.com"
+        ],
+        "notMembership": [],
+        "failed": []
+      },
+      "invitation": {
+        "action": "Invited",
+        "spaceId": "space-demo",
+        "requested": [
+          "new@example.com"
+        ],
+        "invited": [],
+        "alreadyPending": [],
+        "alreadyMembers": [],
+        "failed": [
+          "new@example.com"
+        ]
+      },
+      "problems": []
+    }
+  },
+  {
+    "name": "space-member-changes-error",
+    "target": "/app/space/member/update",
+    "data": {
+      "action": "Updated",
+      "spaceId": "space-demo",
+      "removal": {
+        "action": "Removed",
+        "spaceId": "space-demo",
+        "requested": [
+          "old@example.com"
+        ],
+        "removed": [],
+        "notMembership": [],
+        "failed": [
+          "old@example.com"
+        ]
+      },
+      "invitation": {
+        "action": "Invited",
+        "spaceId": "space-demo",
+        "requested": [
+          "new@example.com"
+        ],
+        "invited": [],
+        "alreadyPending": [],
+        "alreadyMembers": [],
+        "failed": [
+          "new@example.com"
+        ]
+      },
+      "problems": []
+    },
+    "status": "error",
+    "essential": {
+      "status": "error",
+      "error": {
+        "code": "OPERATION_FAILED",
+        "message": "Space member changes did not complete",
+        "details": {
+          "action": "Updated",
+          "spaceId": "space-demo",
+          "removal": {
+            "action": "Removed",
+            "spaceId": "space-demo",
+            "requested": [
+              "old@example.com"
+            ],
+            "removed": [],
+            "notMembership": [],
+            "failed": [
+              "old@example.com"
+            ]
+          },
+          "invitation": {
+            "action": "Invited",
+            "spaceId": "space-demo",
+            "requested": [
+              "new@example.com"
+            ],
+            "invited": [],
+            "alreadyPending": [],
+            "alreadyMembers": [],
+            "failed": [
+              "new@example.com"
+            ]
+          },
+          "problems": []
+        }
+      }
+    },
+    "code": "OPERATION_FAILED"
   }
 ]

package/manifest/app-facade.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.app-facade.v1",
-  "contractVersion": "1.127.1",
+  "contractVersion": "1.128.0",
   "callSchema": "schema/facade-call.v1.schema.json",
   "routing": "manifest/routing.v1.json",
   "routingSchema": "schema/routing.v1.schema.json",
@@ -334,6 +334,13 @@
         "/app/presentation/space/location/list"
       ]
     },
+    "spaceMemberChanges": {
+      "contract": "contract/space-presentation-v1.md",
+      "schema": "schema/space-member-changes.v1.schema.json",
+      "requestTargets": [
+        "/app/space/member/update"
+      ]
+    },
     "spaceManagement": {
       "contract": "contract/space-presentation-v1.md",
       "requestTargets": [

package/manifest/authorization.v1.json

@@ -1,5 +1,5 @@
 {
-  "contractVersion": "1.127.1",
+  "contractVersion": "1.128.0",
   "operations": {
     "/app/agent/context/get": "spaceRead",
     "/app/agent/credit/usage": "spaceRead",
@@ -118,7 +118,6 @@
     "/app/host/permissions/get": "userRead",
     "/app/host/service/install": "userWrite",
     "/app/host/service/restart": "userWrite",
-    "/app/hub/cache/clear": "spaceManage",
     "/app/hub/get": "spaceRead",
     "/app/hub/remove": "spaceManage",
     "/app/hub/restart": "spaceManage",
@@ -280,6 +279,7 @@
     "/app/space/member/invite": "spaceManage",
     "/app/space/member/list": "spaceManage",
     "/app/space/member/remove": "spaceManage",
+    "/app/space/member/update": "spaceManage",
     "/app/space/preference/get": "spaceRead",
     "/app/space/preference/update": "userWrite",
     "/app/space/rename": "spaceManage",

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

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

package/manifest/hub-targets.v1.json

@@ -1,10 +1,9 @@
 {
   "manifest": "mhome.hub.targets.v1",
-  "contractVersion": "1.127.1",
+  "contractVersion": "1.128.0",
   "appTargets": [
     "/app/hub/get",
-    "/app/hub/remove",
-    "/app/hub/cache/clear"
+    "/app/hub/remove"
   ],
   "localTargets": [
     "/local/hub/get",

package/manifest/pod-targets.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.pod.targets.v1",
-  "contractVersion": "1.127.1",
+  "contractVersion": "1.128.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.127.1",
+  "contractVersion": "1.128.0",
   "targetPrefix": "/app/",
   "default": {
     "execution": "spaceMode"
@@ -16,7 +16,6 @@
     "cloudTargets": [
       "/app/agent/context/get",
       "/app/agent/credit/usage",
-      "/app/hub/cache/clear",
       "/app/hub/get",
       "/app/hub/remove",
       "/app/plugin/catalog/list",

package/manifest/targets.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.messaging.targets.v1",
-  "contractVersion": "1.127.1",
+  "contractVersion": "1.128.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.127.1",
+  "version": "1.128.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.127.1",
+  "contractVersion": "1.128.0",
   "manifest": "manifest/app-facade.v1.json",
   "schemas": {
     "storage": "schema/storage.v1.schema.json",
@@ -12,6 +12,7 @@
     "hostAuthorization": "schema/host-authorization.v1.schema.json",
     "hostAccess": "schema/host-access.v1.schema.json",
     "agentLlm": "schema/agent-llm.v1.schema.json",
+    "spaceMemberChanges": "schema/space-member-changes.v1.schema.json",
     "entityPresentation": "schema/entity-presentation.v1.schema.json",
     "integrationPresentation": "schema/integration-presentation.v1.schema.json",
     "capabilityDescriptor": "schema/capability-descriptor.v1.schema.json",

package/schema/space-member-changes.v1.schema.json

@@ -0,0 +1,190 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://schemas.meowlink.app/space-member-changes.v1.json",
+  "title": "Space member changes",
+  "definitions": {
+    "input": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "removeEmails": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "inviteEmails": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "anyOf": [
+        {
+          "required": [
+            "removeEmails"
+          ],
+          "properties": {
+            "removeEmails": {
+              "minItems": 1
+            }
+          }
+        },
+        {
+          "required": [
+            "inviteEmails"
+          ],
+          "properties": {
+            "inviteEmails": {
+              "minItems": 1
+            }
+          }
+        }
+      ]
+    },
+    "output": {
+      "type": "object",
+      "required": [
+        "action",
+        "spaceId",
+        "removal",
+        "invitation",
+        "problems"
+      ],
+      "properties": {
+        "action": {
+          "enum": [
+            "Updated",
+            "DryRun"
+          ]
+        },
+        "spaceId": {
+          "type": "string"
+        },
+        "removal": {
+          "type": "object",
+          "required": [
+            "action",
+            "spaceId",
+            "requested",
+            "removed",
+            "notMembership",
+            "failed"
+          ],
+          "properties": {
+            "action": {
+              "type": "string"
+            },
+            "spaceId": {
+              "type": "string"
+            },
+            "requested": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "removed": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "notMembership": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "failed": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "invitation": {
+          "anyOf": [
+            {
+              "type": "object",
+              "required": [
+                "action",
+                "spaceId",
+                "requested",
+                "invited",
+                "alreadyPending",
+                "alreadyMembers",
+                "failed"
+              ],
+              "properties": {
+                "action": {
+                  "type": "string"
+                },
+                "spaceId": {
+                  "type": "string"
+                },
+                "requested": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "invited": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "alreadyPending": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "alreadyMembers": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "failed": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              }
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "problems": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "step",
+              "code",
+              "message"
+            ],
+            "properties": {
+              "step": {
+                "type": "string"
+              },
+              "code": {
+                "type": "string"
+              },
+              "message": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}