@mhome/app-facade-protocol 1.117.0 → 1.118.1

package/contract/developer-contracts-v1.md

@@ -0,0 +1,40 @@
+# Published standard capability contracts
+
+`/app/developer/contracts/list` and `/app/developer/contracts/export` are read-only
+Hub operations. The authenticated caller needs Space read access to reach its
+online Hub. The Hub requests the matching `/bridge/schema/contracts/*` operation
+from Lion using its existing authenticated connection. Space identity authorizes
+and routes the request; it never chooses contract content. There is no direct
+Client-to-cloud implementation of these operations.
+
+Lion selects the latest complete, unarchived official production packages and
+their necessary dependencies, including `base`. Space Beta settings, installed
+versions, personal staging and local Preview do not participate. A missing or
+invalid requested dependency fails the operation. Unrelated catalog packages are
+not loaded. Sources are checked again before returning a result; a publication
+change causes a bounded retry, then an explicit temporary-unavailable error.
+
+List input is exactly `{ "integrationId": "basic.device" }`. The result contains
+`integrationId`, `sourceSnapshot` and `capabilities`, with each capability's `id`,
+`method`, `abstract` flag and `description` from the resolved compiler graph.
+
+Export input contains `selected` (1..64 unique fully-qualified command/state/event/
+data IDs) and optional lowercase SHA-256 `ifNoneMatch`. Unknown fields are rejected.
+The result is either `{ "kind": "ready", "document": <export> }` or
+`{ "kind": "unchanged", "sha256": <digest> }`. These are business results inside
+the ordinary Facade response. The compiler-owned document keeps the
+`meow-capability-contracts` version 1 format: compiler identity, exact source
+inventory/digests, input snapshot, explicit selections, resolved contracts and
+referenced types, plus its canonical result digest. It preserves inheritance,
+main entity routing fields, request/result semantics, constraints and data
+discovery dependencies. It executes no provider code or live business queries.
+
+`ifNoneMatch` is only a transfer optimization: Lion first checks current official
+sources, and may reuse immutable content and compiled/exported results. Cached
+data is never a freshness fallback when the cloud cannot be reached. A digest is
+a content identity, not a publication signature or operation grant.
+
+Each business result is limited to 512 KiB so the ordinary envelopes remain below
+the Client's 2 MiB WebSocket message budget. Over-limit queries fail explicitly;
+request fewer capabilities. Export does not install a package, activate a source,
+change provider configuration, or return runtime credentials/household data.

package/manifest/app-facade.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.app-facade.v1",
-  "contractVersion": "1.117.0",
+  "contractVersion": "1.118.1",
   "callSchema": "schema/facade-call.v1.schema.json",
   "routing": "manifest/routing.v1.json",
   "routingSchema": "schema/routing.v1.schema.json",
@@ -412,6 +412,19 @@
         "/app/billing/subscription/resume",
         "/app/billing/subscription/change"
       ]
+    },
+    "developerContracts": {
+      "contract": "contract/developer-contracts-v1.md",
+      "requestTargets": [
+        "/app/developer/contracts/list",
+        "/app/developer/contracts/export"
+      ],
+      "bridgeTargets": [
+        "/bridge/schema/contracts/list",
+        "/bridge/schema/contracts/export"
+      ],
+      "owner": "cloudStandardCatalog",
+      "transport": "authorizedHub"
     }
   },
   "authorization": "manifest/authorization.v1.json",

package/manifest/authorization.v1.json

@@ -1,5 +1,5 @@
 {
-  "contractVersion": "1.117.0",
+  "contractVersion": "1.118.1",
   "operations": {
     "/app/agent/context/get": "spaceRead",
     "/app/agent/credit/usage": "spaceRead",
@@ -48,6 +48,10 @@
     "/app/automation/verify": "spaceWrite",
     "/app/billing/credit/usage": "userRead",
     "/app/billing/payment/list": "userRead",
+    "/app/billing/subscription/cancel": "userWrite",
+    "/app/billing/subscription/change": "userWrite",
+    "/app/billing/subscription/checkout/create": "userWrite",
+    "/app/billing/subscription/resume": "userWrite",
     "/app/billing/summary/get": "userRead",
     "/app/capability/invoke": "spaceWrite",
     "/app/capability/invoke/json": "spaceWrite",
@@ -73,6 +77,8 @@
     "/app/dashboard/card/list": "spaceRead",
     "/app/dashboard/card/main-view/update": "spaceWrite",
     "/app/dashboard/card/move": "spaceWrite",
+    "/app/developer/contracts/export": "spaceRead",
+    "/app/developer/contracts/list": "spaceRead",
     "/app/device/activity/recent/list": "spaceRead",
     "/app/device/detail/get": "spaceRead",
     "/app/device/disable": "spaceWrite",
@@ -353,11 +359,7 @@
     "/pod/talk/request/get": "spaceRead",
     "/pod/talk/speech/prepare": "spaceWrite",
     "/pod/talk/turn/submit": "spaceWrite",
-    "/pod/talk/view/get": "spaceRead",
-    "/app/billing/subscription/checkout/create": "userWrite",
-    "/app/billing/subscription/cancel": "userWrite",
-    "/app/billing/subscription/resume": "userWrite",
-    "/app/billing/subscription/change": "userWrite"
+    "/pod/talk/view/get": "spaceRead"
   },
   "nodePrefix": "/app/plugin/",
   "serviceOperations": [

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

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.host-provision.targets.v1",
-  "contractVersion": "1.117.0",
+  "contractVersion": "1.118.1",
   "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.117.0",
+  "contractVersion": "1.118.1",
   "appTargets": [
     "/app/hub/get",
     "/app/hub/remove",

package/manifest/pod-targets.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.pod.targets.v1",
-  "contractVersion": "1.117.0",
+  "contractVersion": "1.118.1",
   "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.117.0",
+  "contractVersion": "1.118.1",
   "targetPrefix": "/app/",
   "default": {
     "execution": "scopeMode"
@@ -90,7 +90,9 @@
       "/app/hub/restart",
       "/app/hub/status",
       "/app/integration/preview/apply",
-      "/app/integration/preview/status"
+      "/app/integration/preview/status",
+      "/app/developer/contracts/list",
+      "/app/developer/contracts/export"
     ],
     "connectionTargets": [
       "/app/client/space/focus"

package/manifest/targets.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.messaging.targets.v1",
-  "contractVersion": "1.117.0",
+  "contractVersion": "1.118.1",
   "requestTargets": [
     "/app/messaging/provider/list",
     "/app/messaging/provider-account/list",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mhome/app-facade-protocol",
-  "version": "1.117.0",
+  "version": "1.118.1",
   "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.117.0",
+  "contractVersion": "1.118.1",
   "manifest": "manifest/app-facade.v1.json",
   "schemas": {
     "storage": "schema/storage.v1.schema.json",