@mhome/app-facade-protocol 1.44.0 → 1.46.1

package/manifest/app-facade.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.app-facade.v1",
-  "contractVersion": "1.44.0",
+  "contractVersion": "1.46.1",
   "callSchema": "schema/facade-call.v1.schema.json",
   "routing": "manifest/routing.v1.json",
   "routingSchema": "schema/routing.v1.schema.json",
@@ -44,7 +44,6 @@
         "/app/plugin/candidate/list",
         "/app/plugin/enable/start",
         "/app/plugin/enable/status",
-        "/app/plugin/enable/cancel",
         "/app/plugin/disable",
         "/app/plugin/profile/update"
       ],
@@ -96,7 +95,13 @@
     "integration": {
       "capabilitySchema": "schema/capability-descriptor.v1.schema.json",
       "requestTargets": [
+        "/app/integration/list",
         "/app/integration/detail/get",
+        "/app/integration/detail/batch",
+        "/app/integration/install",
+        "/app/integration/uninstall",
+        "/app/integration/connect",
+        "/app/integration/disconnect",
         "/app/integration/installed/list",
         "/app/integration/capability/detail/get"
       ],
@@ -146,6 +151,57 @@
       "firstClaimTransport": "directLanOnly",
       "authorizationTarget": "/app/host/authorization",
       "authorizationSchema": "schema/host-authorization.v1.schema.json"
+    },
+    "clientAppearance": {
+      "schema": "schema/client-appearance.v1.schema.json",
+      "requestTargets": [
+        "/app/client/appearance/report"
+      ],
+      "owner": "authenticatedClient",
+      "persistence": "none"
+    },
+    "clientPage": {
+      "schema": "schema/client-page.v1.schema.json",
+      "requestTargets": [
+        "/app/client/page/report"
+      ],
+      "owner": "authenticatedClient",
+      "persistence": "none"
+    },
+    "cardSkins": {
+      "contract": "contract/card-skins-v1.md",
+      "packageSchema": "schema/card-skin-package.v1.schema.json",
+      "requestSchema": "schema/card-skins.v1.schema.json",
+      "requests": {
+        "/app/card-skins/catalog/package/get": "#/definitions/packageGet",
+        "/app/card-skins/catalog/package/create": "#/definitions/packageCreate",
+        "/app/card-skins/catalog/package/update": "#/definitions/packageUpdate",
+        "/app/card-skins/catalog/release/list": "#/definitions/packageGet",
+        "/app/card-skins/catalog/release/get": "#/definitions/releaseGet",
+        "/app/card-skins/catalog/publish/prepare": "#/definitions/publishPrepare",
+        "/app/card-skins/catalog/publish/complete": "#/definitions/publishComplete",
+        "/app/card-skins/selection/get": "#/definitions/empty",
+        "/app/card-skins/install": "#/definitions/install",
+        "/app/card-skins/uninstall": "#/definitions/uninstall",
+        "/app/card-skins/upgrade": "#/definitions/upgrade",
+        "/app/card-skins/override/set": "#/definitions/overrideSet",
+        "/app/card-skins/override/reset": "#/definitions/overrideReset"
+      },
+      "responses": {
+        "/app/card-skins/catalog/package/get": "#/definitions/packageSnapshot",
+        "/app/card-skins/catalog/package/create": "#/definitions/empty",
+        "/app/card-skins/catalog/package/update": "#/definitions/empty",
+        "/app/card-skins/catalog/release/list": "#/definitions/releaseList",
+        "/app/card-skins/catalog/release/get": "#/definitions/release",
+        "/app/card-skins/catalog/publish/prepare": "#/definitions/prepared",
+        "/app/card-skins/catalog/publish/complete": "#/definitions/release",
+        "/app/card-skins/selection/get": "#/definitions/selectionView",
+        "/app/card-skins/install": "#/definitions/empty",
+        "/app/card-skins/uninstall": "#/definitions/empty",
+        "/app/card-skins/upgrade": "#/definitions/empty",
+        "/app/card-skins/override/set": "#/definitions/empty",
+        "/app/card-skins/override/reset": "#/definitions/empty"
+      }
     }
   },
   "authorization": "manifest/authorization.v1.json",

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

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.host-provision.targets.v1",
-  "contractVersion": "1.44.0",
+  "contractVersion": "1.46.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.44.0",
+  "contractVersion": "1.46.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.44.0",
+  "contractVersion": "1.46.1",
   "contract": "contract/pod-commissioning-v1.md",
   "localTargets": [
     "/local/pod/discovery/start",

package/manifest/routing.v1.json

@@ -1,10 +1,9 @@
 {
   "manifest": "mhome.app-facade.routing.v1",
-  "contractVersion": "1.44.0",
+  "contractVersion": "1.46.1",
   "targetPrefix": "/app/",
   "default": {
-    "execution": "scopeMode",
-    "relay": "directOnly"
+    "execution": "scopeMode"
   },
   "matching": "exactBeforePrefix",
   "placementJsonPointer": "/input/placement",
@@ -12,10 +11,12 @@
     "cloudPrefixes": [
       "/app/scope/",
       "/app/inspire/",
-      "/app/user/"
+      "/app/user/",
+      "/app/card-skins/catalog/"
     ],
     "cloudTargets": [
       "/app/agent/context/get",
+      "/app/agent/credit/usage",
       "/app/hub/cache/clear",
       "/app/hub/get",
       "/app/hub/remove",
@@ -23,7 +24,14 @@
       "/app/system/feedback/submit",
       "/app/timeline/entity/latest/list",
       "/app/host/access/issue",
-      "/app/host/authorization"
+      "/app/host/authorization",
+      "/app/messaging/link/code/create",
+      "/app/messaging/link/list",
+      "/app/messaging/unlink",
+      "/app/messaging/code/status",
+      "/app/messaging/binding/list",
+      "/app/messaging/bind/code/create",
+      "/app/messaging/unbind"
     ],
     "scopeModeTargets": [
       "/app/artifact/resolve",
@@ -33,50 +41,24 @@
       "/app/artifact/delete",
       "/app/artifact/upload/start",
       "/app/artifact/upload/complete",
-      "/app/artifact/upload/cancel"
+      "/app/artifact/upload/cancel",
+      "/app/system/instances/get",
+      "/app/system/clients/get"
     ],
     "hubPrefixes": [
       "/app/plugin/",
       "/app/interaction-flow/",
       "/app/object-storage/",
       "/app/runtime/",
-      "/app/system/instances/",
-      "/app/system/clients/",
       "/app/system/hosts/",
       "/app/person/"
     ],
     "requestPlacementPrefixes": [
       "/app/messaging/"
     ],
-    "cloudRelayTargets": [
-      "/app/plugin/candidate/list",
-      "/app/plugin/detail/get",
-      "/app/plugin/enabled/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",
-      "/app/system/instances/get",
-      "/app/system/clients/get",
-      "/app/system/hosts/get",
-      "/app/system/hosts/runtime",
-      "/app/person/summary-images/batch-get",
-      "/app/person/status",
-      "/app/person/list",
-      "/app/person/get",
-      "/app/person/reset",
-      "/app/person/clusters/list",
-      "/app/person/clusters/image",
-      "/app/person/backup/export",
-      "/app/person/backup/read",
-      "/app/person/backup/close",
-      "/app/person/backup/import/start",
-      "/app/person/backup/import/write",
-      "/app/person/backup/import/commit",
-      "/app/person/clusters/name",
-      "/app/person/clusters/delete"
+    "hubTargets": [
+      "/app/hub/restart",
+      "/app/hub/status"
     ]
   }
 }

package/manifest/targets.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.messaging.targets.v1",
-  "contractVersion": "1.44.0",
+  "contractVersion": "1.46.1",
   "requestTargets": [
     "/app/messaging/provider/list",
     "/app/messaging/provider-account/list",
@@ -19,13 +19,13 @@
     "/app/messaging/setup/status",
     "/app/messaging/setup/submit",
     "/app/messaging/setup/cancel",
-    "/app/messaging/surface/list",
-    "/app/messaging/surface/dismiss",
-    "/app/messaging/surface/bind-code/create",
-    "/app/messaging/actor/link-code/create",
-    "/app/messaging/identity-code/status",
-    "/app/messaging/actor/link/list",
-    "/app/messaging/actor/link/delete"
+    "/app/messaging/unbind",
+    "/app/messaging/binding/list",
+    "/app/messaging/bind/code/create",
+    "/app/messaging/link/code/create",
+    "/app/messaging/code/status",
+    "/app/messaging/link/list",
+    "/app/messaging/unlink"
   ],
   "responseTargets": [
     "/app/messaging/provider/list",
@@ -45,15 +45,13 @@
     "/app/messaging/setup/status",
     "/app/messaging/setup/submit",
     "/app/messaging/setup/cancel",
-    "/app/messaging/surface/list",
-    "/app/messaging/surface/dismiss",
-    "/app/messaging/surface/bind-code/create",
-    "/app/messaging/actor/link-code/create",
-    "/app/messaging/identity-code/status",
-    "/app/messaging/actor/link/list",
-    "/app/messaging/actor/link/delete"
+    "/app/messaging/unbind",
+    "/app/messaging/binding/list",
+    "/app/messaging/bind/code/create",
+    "/app/messaging/link/code/create",
+    "/app/messaging/code/status",
+    "/app/messaging/link/list",
+    "/app/messaging/unlink"
   ],
-  "eventTargets": [
-    "/app/messaging/identity-code/changed"
-  ]
+  "eventTargets": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mhome/app-facade-protocol",
-  "version": "1.44.0",
+  "version": "1.46.1",
   "description": "Build-time protocol artifacts for mhome.app-facade",
   "license": "MIT",
   "repository": {

package/protocol.json

@@ -1,11 +1,13 @@
 {
   "protocol": "mhome.app-facade",
-  "contractVersion": "1.44.0",
+  "contractVersion": "1.46.1",
   "manifest": "manifest/app-facade.v1.json",
   "schemas": {
     "hostAuthorization": "schema/host-authorization.v1.schema.json",
     "hostAccess": "schema/host-access.v1.schema.json",
     "capabilityDescriptor": "schema/capability-descriptor.v1.schema.json",
+    "cardSkinPackage": "schema/card-skin-package.v1.schema.json",
+    "cardSkins": "schema/card-skins.v1.schema.json",
     "call": "schema/facade-call.v1.schema.json",
     "frame": "schema/messaging-frame.v3.schema.json",
     "interactionFlow": "schema/interaction-flow-app.v1.schema.json",

package/schema/card-skin-package.v1.schema.json

@@ -0,0 +1,238 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://schemas.meowlink.app/card-skin-package.v1.json",
+  "title": "MeowLink Card skin package v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "packageId",
+    "version",
+    "name",
+    "description",
+    "apiVersion",
+    "renderers",
+    "entry",
+    "files"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": 1
+    },
+    "packageId": {
+      "type": "string",
+      "pattern": "^[a-z0-9]+(?:[.-][a-z0-9]+)*$",
+      "maxLength": 128
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)(-((0|[1-9][0-9]*|[0-9]*[A-Za-z-][0-9A-Za-z-]*)(\\.(0|[1-9][0-9]*|[0-9]*[A-Za-z-][0-9A-Za-z-]*))*))?(\\+[0-9A-Za-z-]+(\\.[0-9A-Za-z-]+)*)?$",
+      "maxLength": 128
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 120
+    },
+    "description": {
+      "type": "string",
+      "maxLength": 2000
+    },
+    "apiVersion": {
+      "const": 1
+    },
+    "renderers": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "$ref": "#/definitions/renderer"
+      },
+      "maxItems": 128
+    },
+    "entry": {
+      "type": "string",
+      "pattern": "^[a-zA-Z0-9._-]+\\.mjs$"
+    },
+    "files": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "$ref": "#/definitions/file"
+      },
+      "maxItems": 128
+    }
+  },
+  "definitions": {
+    "pattern": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "patternId",
+        "contractId",
+        "contractVersion"
+      ],
+      "properties": {
+        "patternId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512
+        },
+        "contractId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512
+        },
+        "contractVersion": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 2147483647
+        }
+      }
+    },
+    "renderer": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "name",
+        "description",
+        "supportedPatterns",
+        "detail",
+        "configSchema"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z0-9]+(?:[.-][a-z0-9]+)*$",
+          "maxLength": 128
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 120
+        },
+        "description": {
+          "type": "string",
+          "maxLength": 2000
+        },
+        "supportedPatterns": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "$ref": "#/definitions/pattern"
+          }
+        },
+        "detail": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "mode"
+          ],
+          "properties": {
+            "mode": {
+              "enum": [
+                "custom",
+                "builtin",
+                "none"
+              ]
+            }
+          }
+        },
+        "configSchema": {
+          "type": "object",
+          "required": [
+            "type"
+          ],
+          "properties": {
+            "type": {
+              "const": "object"
+            }
+          }
+        }
+      }
+    },
+    "file": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "path",
+        "mediaType",
+        "sizeBytes",
+        "sha256"
+      ],
+      "properties": {
+        "path": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512
+        },
+        "mediaType": {
+          "type": "string",
+          "minLength": 1
+        },
+        "sizeBytes": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 8388608
+        },
+        "sha256": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$"
+        }
+      }
+    },
+    "project": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schemaVersion",
+        "packageId",
+        "version",
+        "name",
+        "description",
+        "apiVersion",
+        "renderers",
+        "entry"
+      ],
+      "properties": {
+        "schemaVersion": {
+          "const": 1
+        },
+        "packageId": {
+          "type": "string",
+          "pattern": "^[a-z0-9]+(?:[.-][a-z0-9]+)*$",
+          "maxLength": 128
+        },
+        "version": {
+          "type": "string",
+          "pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)(-((0|[1-9][0-9]*|[0-9]*[A-Za-z-][0-9A-Za-z-]*)(\\.(0|[1-9][0-9]*|[0-9]*[A-Za-z-][0-9A-Za-z-]*))*))?(\\+[0-9A-Za-z-]+(\\.[0-9A-Za-z-]+)*)?$",
+          "maxLength": 128
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 120
+        },
+        "description": {
+          "type": "string",
+          "maxLength": 2000
+        },
+        "apiVersion": {
+          "const": 1
+        },
+        "renderers": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "$ref": "#/definitions/renderer"
+          },
+          "maxItems": 128
+        },
+        "entry": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    }
+  }
+}