@mhome/app-facade-protocol 1.1.2 → 1.3.0

package/README.md

@@ -20,3 +20,18 @@ recovering the secret. Each current-step resolver projection reports whether
 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.
+
+## Routing contract
+
+`manifest/routing.v1.json` is the canonical client-side routing policy for the
+new `/app/*` facade. Ordinary operations follow the active Space mode. Only
+exceptional domains declare a fixed Cloud, Hub, or request-placement executor.
+Relay permission is separate from execution authority so a client
+cannot silently turn every Hub request into a cloud-proxied request.
+
+The checked-in Rust table is generated from that manifest, and non-Rust clients
+consume the same manifest from the npm protocol package. A native Host may
+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.

package/manifest/app-facade.v1.json

@@ -1,7 +1,9 @@
 {
   "manifest": "mhome.app-facade.v1",
-  "contractVersion": "1.1.2",
+  "contractVersion": "1.3.0",
   "callSchema": "schema/facade-call.v1.schema.json",
+  "routing": "manifest/routing.v1.json",
+  "routingSchema": "schema/routing.v1.schema.json",
   "domains": {
     "messaging": {
       "targets": "manifest/targets.v1.json"
@@ -24,9 +26,10 @@
       "extensionPriority": "after_exact"
     },
     "runtime": {
+      "contract": "mhome.runtime.status.v1",
+      "resourceTypes": ["nodeInstance", "nodeRuntime"],
       "requestTargets": ["/app/runtime/status/list"],
-      "eventTargets": ["/app/runtime/status/changed"],
-      "authority": "host"
+      "eventTargets": ["/app/runtime/status/changed"]
     },
     "interactionFlow": {
       "schema": "schema/interaction-flow-app.v1.schema.json",

package/manifest/routing.v1.json

@@ -0,0 +1,46 @@
+{
+  "manifest": "mhome.app-facade.routing.v1",
+  "contractVersion": "1.3.0",
+  "targetPrefix": "/app/",
+  "default": {
+    "execution": "scopeMode",
+    "relay": "directOnly"
+  },
+  "matching": "exactBeforePrefix",
+  "placementJsonPointer": "/input/placement",
+  "rules": {
+    "cloudPrefixes": [
+      "/app/scope/",
+      "/app/inspire/"
+    ],
+    "cloudTargets": [
+      "/app/agent/context/get",
+      "/app/credit/record",
+      "/app/system/feedback/submit",
+      "/app/timeline/entity/latest/list"
+    ],
+    "scopeModeTargets": [
+      "/app/scope/context/get"
+    ],
+    "hubPrefixes": [
+      "/app/plugin/",
+      "/app/interaction-flow/",
+      "/app/object-storage/",
+      "/app/runtime/"
+    ],
+    "requestPlacementPrefixes": [
+      "/app/messaging/"
+    ],
+    "cloudRelayTargets": [
+      "/app/plugin/candidate/list",
+      "/app/plugin/detail/get",
+      "/app/plugin/installed/list",
+      "/app/object-storage/overview",
+      "/app/object-storage/folders/create",
+      "/app/object-storage/folders/get",
+      "/app/object-storage/folders/update",
+      "/app/object-storage/folders/list",
+      "/app/object-storage/settings/update"
+    ]
+  }
+}

package/manifest/targets.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.messaging.targets.v1",
-  "contractVersion": "1.1.2",
+  "contractVersion": "1.3.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.1.2",
+  "version": "1.3.0",
   "description": "Build-time protocol artifacts for mhome.app-facade",
   "license": "MIT",
   "repository": {

package/protocol.json

@@ -1,11 +1,12 @@
 {
   "protocol": "mhome.app-facade",
-  "contractVersion": "1.1.2",
+  "contractVersion": "1.3.0",
   "manifest": "manifest/app-facade.v1.json",
   "schemas": {
     "call": "schema/facade-call.v1.schema.json",
     "frame": "schema/messaging-frame.v3.schema.json",
-    "interactionFlow": "schema/interaction-flow-app.v1.schema.json"
+    "interactionFlow": "schema/interaction-flow-app.v1.schema.json",
+    "routing": "schema/routing.v1.schema.json"
   },
   "fixtures": {
     "valid": "fixtures",

package/schema/routing.v1.schema.json

@@ -0,0 +1,65 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mhome.ai/schema/app-facade-routing.v1.schema.json",
+  "title": "MeowLink App Facade routing contract",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "manifest",
+    "contractVersion",
+    "targetPrefix",
+    "default",
+    "matching",
+    "placementJsonPointer",
+    "rules"
+  ],
+  "properties": {
+    "manifest": { "const": "mhome.app-facade.routing.v1" },
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$"
+    },
+    "targetPrefix": { "const": "/app/" },
+    "default": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["execution", "relay"],
+      "properties": {
+        "execution": { "const": "scopeMode" },
+        "relay": { "const": "directOnly" }
+      }
+    },
+    "matching": { "const": "exactBeforePrefix" },
+    "placementJsonPointer": { "const": "/input/placement" },
+    "rules": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "cloudPrefixes",
+        "cloudTargets",
+        "scopeModeTargets",
+        "hubPrefixes",
+        "requestPlacementPrefixes",
+        "cloudRelayTargets"
+      ],
+      "properties": {
+        "cloudPrefixes": { "$ref": "#/$defs/targetList" },
+        "cloudTargets": { "$ref": "#/$defs/targetList" },
+        "scopeModeTargets": { "$ref": "#/$defs/targetList" },
+        "hubPrefixes": { "$ref": "#/$defs/targetList" },
+        "requestPlacementPrefixes": { "$ref": "#/$defs/targetList" },
+        "cloudRelayTargets": { "$ref": "#/$defs/targetList" }
+      }
+    }
+  },
+  "$defs": {
+    "targetList": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "pattern": "^/app/"
+      }
+    }
+  }
+}