@mhome/app-facade-protocol 1.8.0 → 1.9.0

package/README.md

@@ -65,3 +65,22 @@ supervise Hub and Node processes, but it is not a public App Facade executor;
 Host process management remains an implementation detail behind the selected
 Hub. Lion's legacy controller annotations and non-`/app/*` protocols are
 outside this contract.
+
+### System plugin catalog
+
+`/app/plugin/catalog/list` returns `manifest/plugin-catalog.v1.json` from Cloud,
+without requiring a local Space or connected Hub. Authentication and Space
+membership still apply. Core also serves this catalog for clients with an older
+routing manifest. The response schema is `schema/plugin-catalog.v1.schema.json`.
+
+The catalog describes supported types, not installed software or bindings.
+`componentId` joins to Host runtime inspection; `nodeType` joins to existing
+Plugin candidate and installed/binding queries. Platform installability and
+versions come from the Host release catalog, not this directory. Host inventory
+is a native management API, not a portable App Facade executor.
+
+Core and Cloud embed generated copies. After editing the catalog, run
+`node scripts/sync-plugin-catalog.mjs --write <core-resource> <cloud-resource>`
+from the Foundation root; omit `--write` to check conformance. Resource paths are
+`src/application/plugin-catalog.v1.json` (Core) and
+`src/main/resources/app/plugin-catalog.v1.json` (Cloud module-service).

package/manifest/app-facade.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.app-facade.v1",
-  "contractVersion": "1.8.0",
+  "contractVersion": "1.9.0",
   "callSchema": "schema/facade-call.v1.schema.json",
   "routing": "manifest/routing.v1.json",
   "routingSchema": "schema/routing.v1.schema.json",
@@ -20,7 +20,10 @@
     "plugin": {
       "extensionVersion": "v1",
       "targetPrefix": "/app/plugin",
+      "catalog": "manifest/plugin-catalog.v1.json",
+      "catalogSchema": "schema/plugin-catalog.v1.schema.json",
       "exactRequestTargets": [
+        "/app/plugin/catalog/list",
         "/app/plugin/installed/list",
         "/app/plugin/detail/get",
         "/app/plugin/candidate/list",

package/manifest/routing.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.app-facade.routing.v1",
-  "contractVersion": "1.8.0",
+  "contractVersion": "1.9.0",
   "targetPrefix": "/app/",
   "default": {
     "execution": "scopeMode",
@@ -19,6 +19,7 @@
       "/app/hub/cache/clear",
       "/app/hub/get",
       "/app/hub/remove",
+      "/app/plugin/catalog/list",
       "/app/system/feedback/submit",
       "/app/timeline/entity/latest/list"
     ],

package/manifest/targets.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.messaging.targets.v1",
-  "contractVersion": "1.8.0",
+  "contractVersion": "1.9.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.8.0",
+  "version": "1.9.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.8.0",
+  "contractVersion": "1.9.0",
   "manifest": "manifest/app-facade.v1.json",
   "schemas": {
     "call": "schema/facade-call.v1.schema.json",