@mhome/app-facade-protocol 1.113.0 → 1.114.1

package/README.md

@@ -12,7 +12,10 @@ or forwarded by authenticated Cloud ingress. The separate Hub `/local/*`
 protocol carries domain input and never uses the public envelope.
 
 Every `/app/*` request uses the strict `FacadeCall` envelope. Invocation
-metadata lives in `control`; the domain request lives in `input`. The crate
+metadata lives in `control`; the domain request lives in `input`. Optional
+`source` hints identify the originating surface without selecting actor or authority.
+See [household behavior recording](contract/household-recording-v1.md) for the
+shared projection contract and runtime ownership. The crate
 owns public targets, request/response/event schemas, and stable operation
 identity. Core-to-Node routes and provider runtime models belong to
 `mhome-core-api` instead.

package/contract/household-recording-v1.md

@@ -0,0 +1,61 @@
+# Household behavior records
+
+This is input for background household learning, not an audit log. Plugin Facades,
+queries, UI layout, account settings, infrastructure and Agent memory updates skip.
+`manifest/recording.v1.json` owns the explicit Facade projections and canonical
+Device command allowlist (including declared provider overrides). Mixed-purpose
+hooks may return Skip. New Facades default to Skip until explicitly registered.
+Rust `recording::project` and Lion `BehaviorProjection` implement the same pure
+hooks and share `fixtures/recording.conformance.json`. The Lion runtime definition
+is a packaged mirror verified against this canonical manifest in joint-source tests.
+
+A call may carry optional `source: {kind, page?, cardId?}` beside `control` and
+`input`. Kinds are `ui`, `agent` (built-in Agent), `messaging`, `cli`, `skill`, `mcp`.
+Source hints never select authorization or actor. Trusted Agent/MCP ingress overrides
+hints; a canonical Messaging Agent surface keeps `messaging`, including through
+Cloud-to-Hub forwarding. CLI defaults to `cli`; external Skills explicitly pass
+`meow --source skill`. UI sets `ui`. `appClientId` comes only from the verified
+Client identity, not connection routing IDs or an input hint.
+
+The runtime derives actor from verified initiation: User -> `{kind: user,userId}`;
+shared Space -> `{kind: space}`. The record schema also reserves `{kind: agent}`
+for autonomous initiation. Current user-directed Agent operations retain their
+verified principal. Source `agent` never makes an operation autonomous. Wiring a
+future proactive scheduler requires trusted initiation metadata; an LLM cannot
+self-declare an actor in the Facade call.
+
+Only actual execution records. Prepare, reject, validation before execution and
+cached commit replay do not. Internal automation side effects are separate event
+sources, not additional manual behavior. The record uses one `id`: trusted delegated
+operation identity, prepared operation identity when applicable, or a generated UUID.
+It contains `occurredAtMs` (server UTC at execution dispatch), `finishedAtMs` (server
+UTC when that dispatch settles), actor, source and domain `data`. Status comes from
+the canonical Full outcome before Essential presentation. An accepted async run is
+not a claim that all its physical effects completed. Failures keep intent and error
+code, never raw exception messages, internal details, complete request/response or
+source scripts. Runtime completion/Twin observations belong to their own sources.
+
+Space mode determines the single storage owner: Local -> Hub SQLite, Cloud ->
+Lion's configured cloud store. Routing/forwarding creates no second record.
+The existing Space cleanup removes this partition. Hub queued deliveries retain
+the existing runtime fence so revoked/replaced generations cannot recreate records
+after cleanup; Cloud writes use the existing Space admission guard.
+The physical row has `pk`, `sk`, `schemaVersion=1`, `payloadYaml` only:
+
+- `pk = tenant|space`.
+- `sk = zero-padded 13-digit UTC milliseconds|id`.
+- Fixed string order supports `[start,end)` queries in one partition. Pagination
+  uses the last returned SK exclusively. No secondary index is required.
+- Inserts never replace an existing key. Retrying persistence reuses the same row.
+- YAML retains null, false, zero and typed values; no custom tags or raw JSON copy.
+
+Recording is best effort. Request code only captures immutable facts and offers
+work to a bounded queue (256). Projection, YAML and storage run in the background.
+Failures, overload and the 32 KiB projected-payload limit drop/count the record,
+without changing the business result or replaying the operation. No durable outbox,
+start-record requirement, recovery workflow, or logging warning in Facade responses.
+
+Core adds a table to its complete SQLite baseline. An existing incompatible Dev
+DB requires the explicit standard rebuild workflow; startup never rewrites migration
+checksums, deletes data or silently migrates the old baseline. Publishing Foundation
+and reconciling normal consumer protocol receipts remain release prerequisites.

package/fixtures/recording.conformance.json

@@ -0,0 +1,393 @@
+[
+  {
+    "target": "/app/widget/data/update",
+    "input": {
+      "widgetId": "lamp-d",
+      "typedValue": 0,
+      "internal": "secret"
+    },
+    "outcome": {
+      "status": "success"
+    },
+    "expected": {
+      "event": "widget.value.set",
+      "widgetId": "lamp-d",
+      "typedValue": 0,
+      "status": "success"
+    }
+  },
+  {
+    "target": "/app/widget/data/update",
+    "input": {
+      "widgetId": "lamp-d",
+      "typedValue": null
+    },
+    "outcome": {
+      "status": "error",
+      "error": {
+        "code": "UNREACHABLE",
+        "message": "private",
+        "details": {
+          "token": "secret"
+        }
+      }
+    },
+    "expected": {
+      "event": "widget.value.set",
+      "widgetId": "lamp-d",
+      "typedValue": null,
+      "status": "error",
+      "errorCode": "UNREACHABLE"
+    }
+  },
+  {
+    "target": "/app/widget/delete",
+    "input": {
+      "widgetIds": [
+        "x-d",
+        "wake-c"
+      ]
+    },
+    "outcome": {
+      "status": "success"
+    },
+    "expected": {
+      "event": "circadian.deleted",
+      "widgetIds": [
+        "wake-c"
+      ],
+      "status": "success"
+    }
+  },
+  {
+    "target": "/app/widget/delete",
+    "input": {
+      "widgetIds": [
+        "x-d"
+      ]
+    },
+    "outcome": {
+      "status": "success"
+    },
+    "expected": null
+  },
+  {
+    "target": "/app/widget/circadian/config/update",
+    "input": {
+      "widgetId": "wake-c",
+      "displayName": "Wake"
+    },
+    "outcome": {
+      "status": "success"
+    },
+    "expected": null
+  },
+  {
+    "target": "/app/widget/circadian/runtime/update",
+    "input": {
+      "widgetId": "wake-c",
+      "offset": 0,
+      "multiplier": 1
+    },
+    "outcome": {
+      "status": "success"
+    },
+    "expected": {
+      "event": "circadian.adjusted",
+      "widgetId": "wake-c",
+      "offset": 0,
+      "multiplier": 1,
+      "status": "success"
+    }
+  },
+  {
+    "target": "/app/automation/start",
+    "input": {
+      "automationId": "a",
+      "timezone": "Asia/Shanghai"
+    },
+    "outcome": {
+      "status": "success",
+      "data": {
+        "enabled": true,
+        "running": false
+      }
+    },
+    "expected": {
+      "event": "automation.start",
+      "automationId": "a",
+      "enabled": true,
+      "running": false,
+      "status": "success"
+    }
+  },
+  {
+    "target": "/app/dialog/reply",
+    "input": {
+      "dialogId": "d",
+      "value": {
+        "choice": false
+      }
+    },
+    "outcome": {
+      "status": "success",
+      "data": {
+        "accepted": true,
+        "dialog": {
+          "images": [
+            "private"
+          ]
+        }
+      }
+    },
+    "expected": {
+      "event": "dialog.answered",
+      "dialogId": "d",
+      "value": {
+        "choice": false
+      },
+      "accepted": true,
+      "status": "success"
+    }
+  },
+  {
+    "target": "/app/capability/invoke/json",
+    "input": {
+      "capabilityId": "mlinkHue.device.command.onOff",
+      "request": {
+        "device": "device1",
+        "command": "off",
+        "internal": "secret"
+      }
+    },
+    "outcome": {
+      "status": "partial",
+      "data": {}
+    },
+    "expected": {
+      "event": "device.command",
+      "capabilityId": "mlinkHue.device.command.onOff",
+      "parameters": {
+        "device": "device1",
+        "command": "off"
+      },
+      "status": "partial"
+    }
+  },
+  {
+    "target": "/app/capability/invoke",
+    "input": {
+      "capabilityId": "basic.device.command.onOff",
+      "request": "device: lamp\ncommand: 'off'"
+    },
+    "outcome": {
+      "status": "success"
+    },
+    "expected": {
+      "event": "device.command",
+      "capabilityId": "basic.device.command.onOff",
+      "parameters": {
+        "device": "lamp",
+        "command": "off"
+      },
+      "status": "success"
+    }
+  },
+  {
+    "target": "/app/device/disable",
+    "input": {},
+    "outcome": {
+      "status": "success"
+    },
+    "expected": null
+  },
+  {
+    "target": "/app/room/rename",
+    "input": {},
+    "outcome": {
+      "status": "success"
+    },
+    "expected": null
+  },
+  {
+    "target": "/app/plugin/camera/device/settings/update",
+    "input": {},
+    "outcome": {
+      "status": "success"
+    },
+    "expected": null
+  },
+  {
+    "target": "/app/agent/memory/save",
+    "input": {},
+    "outcome": {
+      "status": "success"
+    },
+    "expected": null
+  },
+  {
+    "target": "/app/automation/list",
+    "input": {},
+    "outcome": {
+      "status": "success"
+    },
+    "expected": null
+  },
+  {
+    "target": "/app/capability/invoke/json",
+    "input": {
+      "capabilityId": "basic.device.command.getImageSnapshot",
+      "request": {}
+    },
+    "outcome": {
+      "status": "success"
+    },
+    "expected": null
+  },
+  {
+    "target": "/app/capability/invoke/json",
+    "input": {
+      "capabilityId": "basic.device.command.prepareWebrtcSession",
+      "request": {}
+    },
+    "outcome": {
+      "status": "success"
+    },
+    "expected": null
+  },
+  {
+    "target": "/app/capability/invoke/json",
+    "input": {
+      "capabilityId": "basic.device.command.identify",
+      "request": {}
+    },
+    "outcome": {
+      "status": "success"
+    },
+    "expected": null
+  },
+  {
+    "target": "/app/capability/invoke/json",
+    "input": {
+      "capabilityId": "basic.device.command.onOff",
+      "request": {
+        "device": {
+          "uid": "lamp",
+          "name": "Desk lamp",
+          "attributes": {
+            "private": "hidden"
+          }
+        },
+        "command": "on"
+      }
+    },
+    "outcome": {
+      "status": "success"
+    },
+    "expected": {
+      "event": "device.command",
+      "capabilityId": "basic.device.command.onOff",
+      "parameters": {
+        "device": {
+          "uid": "lamp",
+          "name": "Desk lamp"
+        },
+        "command": "on"
+      },
+      "status": "success"
+    }
+  },
+  {
+    "target": "/app/presentation/automation/copy",
+    "input": {
+      "automationId": "old",
+      "name": "Bedtime"
+    },
+    "outcome": {
+      "status": "success",
+      "data": {
+        "automationId": "new"
+      }
+    },
+    "expected": {
+      "event": "automation.copy",
+      "fromAutomationId": "old",
+      "automationId": "new",
+      "name": "Bedtime",
+      "status": "success"
+    }
+  },
+  {
+    "target": "/app/capability/invoke",
+    "input": {
+      "capabilityId": "basic.device.command.onOff",
+      "request": "device: lamp\ncommand: on"
+    },
+    "outcome": {
+      "status": "success"
+    },
+    "expected": {
+      "event": "device.command",
+      "capabilityId": "basic.device.command.onOff",
+      "parameters": {
+        "device": "lamp",
+        "command": "on"
+      },
+      "status": "success"
+    }
+  },
+  {
+    "target": "/app/capability/invoke",
+    "input": {
+      "capabilityId": "basic.device.command.setBrightness",
+      "request": "device: lamp\nbrightness: 08"
+    },
+    "outcome": {
+      "status": "success"
+    },
+    "expected": {
+      "event": "device.command",
+      "capabilityId": "basic.device.command.setBrightness",
+      "parameters": {
+        "device": "lamp",
+        "brightness": "08"
+      },
+      "status": "success"
+    }
+  },
+  {
+    "target": "/app/capability/invoke",
+    "input": {
+      "capabilityId": "basic.device.command.setBrightness",
+      "request": "device: lamp\nbrightness: 010"
+    },
+    "outcome": {
+      "status": "success"
+    },
+    "expected": {
+      "event": "device.command",
+      "capabilityId": "basic.device.command.setBrightness",
+      "parameters": {
+        "device": "lamp",
+        "brightness": "010"
+      },
+      "status": "success"
+    }
+  },
+  {
+    "target": "/app/widget/circadian/config/update",
+    "input": {
+      "widget_id": "w-c",
+      "location_id": "home"
+    },
+    "outcome": {
+      "status": "success"
+    },
+    "expected": {
+      "event": "circadian.configured",
+      "widgetId": "w-c",
+      "locationId": "home",
+      "status": "success"
+    }
+  }
+]

package/manifest/app-facade.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.app-facade.v1",
-  "contractVersion": "1.113.0",
+  "contractVersion": "1.114.1",
   "callSchema": "schema/facade-call.v1.schema.json",
   "routing": "manifest/routing.v1.json",
   "routingSchema": "schema/routing.v1.schema.json",

package/manifest/authorization.v1.json

@@ -1,5 +1,5 @@
 {
-  "contractVersion": "1.113.0",
+  "contractVersion": "1.114.1",
   "operations": {
     "/app/agent/context/get": "spaceRead",
     "/app/agent/credit/usage": "spaceRead",

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

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

package/manifest/recording.v1.json

@@ -0,0 +1,465 @@
+{
+  "schemaVersion": 1,
+  "operations": [
+    {
+      "target": "/app/capability/invoke",
+      "event": "device.command",
+      "input": [],
+      "output": [],
+      "hook": "capability"
+    },
+    {
+      "target": "/app/capability/invoke/json",
+      "event": "device.command",
+      "input": [],
+      "output": [],
+      "hook": "capability"
+    },
+    {
+      "target": "/app/widget/data/update",
+      "event": "widget.value.set",
+      "input": [
+        "widgetId",
+        "typedValue",
+        "value",
+        "values"
+      ],
+      "output": []
+    },
+    {
+      "target": "/app/widget/button/trigger",
+      "event": "widget.button.pressed",
+      "input": [
+        "widgetId",
+        "clickType"
+      ],
+      "output": []
+    },
+    {
+      "target": "/app/widget/circadian/runtime/update",
+      "event": "circadian.adjusted",
+      "input": [
+        "widgetId",
+        "curve",
+        "offset",
+        "multiplier"
+      ],
+      "output": []
+    },
+    {
+      "target": "/app/automation/start",
+      "event": "automation.start",
+      "input": [
+        "automationId"
+      ],
+      "output": [
+        "enabled",
+        "running"
+      ]
+    },
+    {
+      "target": "/app/automation/stop",
+      "event": "automation.stop",
+      "input": [
+        "automationId"
+      ],
+      "output": [
+        "enabled",
+        "running"
+      ]
+    },
+    {
+      "target": "/app/presentation/automation/generated/enable",
+      "event": "automation.enable",
+      "input": [
+        "automationId"
+      ],
+      "output": [
+        "automationId",
+        "enabled",
+        "running"
+      ]
+    },
+    {
+      "target": "/app/presentation/automation/generated/disable",
+      "event": "automation.disable",
+      "input": [
+        "automationId"
+      ],
+      "output": [
+        "automationId",
+        "enabled",
+        "running"
+      ]
+    },
+    {
+      "target": "/app/presentation/automation/generated/run",
+      "event": "automation.run",
+      "input": [
+        "automationId"
+      ],
+      "output": [
+        "automationId",
+        "enabled",
+        "running"
+      ]
+    },
+    {
+      "target": "/app/quickword/run",
+      "event": "quickword.invoked",
+      "input": [
+        "quickWord",
+        "values"
+      ],
+      "output": [
+        "dispatched"
+      ]
+    },
+    {
+      "target": "/app/dialog/reply",
+      "event": "dialog.answered",
+      "input": [
+        "dialogId",
+        "value"
+      ],
+      "output": [
+        "accepted"
+      ]
+    },
+    {
+      "target": "/app/automation/save",
+      "event": "automation.saved",
+      "input": [
+        "automationId",
+        "singleUse",
+        "restoreEnabled"
+      ],
+      "output": [
+        "automationId"
+      ],
+      "hook": "automationSource"
+    },
+    {
+      "target": "/app/presentation/automation/overview/save",
+      "event": "automation.saved",
+      "input": [
+        "automationId"
+      ],
+      "output": [
+        "automationId",
+        "enabled"
+      ]
+    },
+    {
+      "target": "/app/presentation/automation/copy",
+      "event": "automation.copy",
+      "input": [
+        "name"
+      ],
+      "output": [
+        "automationId"
+      ],
+      "hook": "automationCopy"
+    },
+    {
+      "target": "/app/presentation/automation/enroll",
+      "event": "automation.enroll",
+      "input": [
+        "name"
+      ],
+      "output": [
+        "automationId"
+      ],
+      "hook": "automationCopy"
+    },
+    {
+      "target": "/app/automation/delete",
+      "event": "automation.deleted",
+      "input": [
+        "automationId",
+        "automationIds"
+      ],
+      "output": []
+    },
+    {
+      "target": "/app/automation/snapshot/rollback",
+      "event": "automation.restored",
+      "input": [
+        "automationId",
+        "snapshotId"
+      ],
+      "output": [
+        "automationId"
+      ]
+    },
+    {
+      "target": "/app/widget/circadian/create",
+      "event": "circadian.configured",
+      "input": [
+        "widgetId",
+        "locationId",
+        "schedules",
+        "curve",
+        "offset",
+        "multiplier"
+      ],
+      "output": [
+        "widgetId"
+      ],
+      "hook": "circadian"
+    },
+    {
+      "target": "/app/widget/circadian/config/update",
+      "event": "circadian.configured",
+      "input": [
+        "widgetId",
+        "locationId",
+        "schedules",
+        "curve",
+        "offset",
+        "multiplier"
+      ],
+      "output": [
+        "widgetId"
+      ],
+      "hook": "circadian"
+    },
+    {
+      "target": "/app/widget/delete",
+      "event": "circadian.deleted",
+      "input": [
+        "widgetIds"
+      ],
+      "output": [],
+      "hook": "circadianDelete"
+    }
+  ],
+  "deviceCommands": {
+    "onOff": [
+      "device",
+      "command"
+    ],
+    "setBrightness": [
+      "device",
+      "brightness",
+      "transitionDuration"
+    ],
+    "setColorTemperature": [
+      "device",
+      "colorTemperature",
+      "transitionDuration"
+    ],
+    "setColorRGB": [
+      "device",
+      "hue",
+      "saturation",
+      "transitionDuration"
+    ],
+    "setThermostatTemperature": [
+      "device",
+      "coolingSetpoint",
+      "heatingSetpoint"
+    ],
+    "setThermostatMode": [
+      "device",
+      "hvacMode",
+      "presetMode"
+    ],
+    "setFan": [
+      "device",
+      "mode",
+      "speed"
+    ],
+    "coverOpenClose": [
+      "device",
+      "command",
+      "position",
+      "transitionDuration"
+    ],
+    "lockUnlock": [
+      "device",
+      "command"
+    ],
+    "playMedia": [
+      "device",
+      "providerMediaContentId",
+      "mediaContent"
+    ],
+    "controlMediaPlayback": [
+      "device",
+      "command"
+    ],
+    "seekMediaPlayback": [
+      "device",
+      "position"
+    ],
+    "setAudioVolume": [
+      "device",
+      "volume"
+    ],
+    "setAudioMute": [
+      "device",
+      "command"
+    ],
+    "broadcastAudio": [
+      "device",
+      "audio",
+      "volume",
+      "priority"
+    ],
+    "chime": [
+      "device",
+      "command"
+    ],
+    "dispensePetFood": [
+      "device",
+      "portions",
+      "weight"
+    ],
+    "cameraPtz": [
+      "device",
+      "command",
+      "preset",
+      "speed",
+      "duration"
+    ],
+    "setCameraRecording": [
+      "device",
+      "mode"
+    ],
+    "setCameraSetting": [
+      "device",
+      "monitoringMode",
+      "personRecognitionMode"
+    ],
+    "startAudioRecording": [
+      "device"
+    ],
+    "stopAudioRecording": [
+      "device"
+    ]
+  },
+  "deviceCapabilities": {
+    "audioBridge.device.command.broadcastAudio": "broadcastAudio",
+    "audioBridge.device.command.controlMediaPlayback": "controlMediaPlayback",
+    "audioBridge.device.command.playMedia": "playMedia",
+    "audioBridge.device.command.seekMediaPlayback": "seekMediaPlayback",
+    "audioBridge.device.command.setAudioMute": "setAudioMute",
+    "audioBridge.device.command.setAudioVolume": "setAudioVolume",
+    "audioBridge.device.command.startAudioRecording": "startAudioRecording",
+    "audioBridge.device.command.stopAudioRecording": "stopAudioRecording",
+    "basic.device.command.broadcastAudio": "broadcastAudio",
+    "basic.device.command.cameraPtz": "cameraPtz",
+    "basic.device.command.chime": "chime",
+    "basic.device.command.controlMediaPlayback": "controlMediaPlayback",
+    "basic.device.command.coverOpenClose": "coverOpenClose",
+    "basic.device.command.dispensePetFood": "dispensePetFood",
+    "basic.device.command.lockUnlock": "lockUnlock",
+    "basic.device.command.onOff": "onOff",
+    "basic.device.command.playMedia": "playMedia",
+    "basic.device.command.seekMediaPlayback": "seekMediaPlayback",
+    "basic.device.command.setAudioMute": "setAudioMute",
+    "basic.device.command.setAudioVolume": "setAudioVolume",
+    "basic.device.command.setBrightness": "setBrightness",
+    "basic.device.command.setCameraRecording": "setCameraRecording",
+    "basic.device.command.setCameraSetting": "setCameraSetting",
+    "basic.device.command.setColorRGB": "setColorRGB",
+    "basic.device.command.setColorTemperature": "setColorTemperature",
+    "basic.device.command.setFan": "setFan",
+    "basic.device.command.setThermostatMode": "setThermostatMode",
+    "basic.device.command.setThermostatTemperature": "setThermostatTemperature",
+    "basic.device.command.startAudioRecording": "startAudioRecording",
+    "basic.device.command.stopAudioRecording": "stopAudioRecording",
+    "camera.device.command.cameraPtz": "cameraPtz",
+    "camera.device.command.onOff": "onOff",
+    "camera.device.command.setCameraSetting": "setCameraSetting",
+    "mlinkGoogleCast.device.command.broadcastAudio": "broadcastAudio",
+    "mlinkGoogleCast.device.command.controlMediaPlayback": "controlMediaPlayback",
+    "mlinkGoogleCast.device.command.playMedia": "playMedia",
+    "mlinkGoogleCast.device.command.setAudioMute": "setAudioMute",
+    "mlinkGoogleCast.device.command.setAudioVolume": "setAudioVolume",
+    "mlinkHomeAssistant.device.command.broadcastAudio": "broadcastAudio",
+    "mlinkHomeAssistant.device.command.chime": "chime",
+    "mlinkHomeAssistant.device.command.controlMediaPlayback": "controlMediaPlayback",
+    "mlinkHomeAssistant.device.command.coverOpenClose": "coverOpenClose",
+    "mlinkHomeAssistant.device.command.lockUnlock": "lockUnlock",
+    "mlinkHomeAssistant.device.command.onOff": "onOff",
+    "mlinkHomeAssistant.device.command.playMedia": "playMedia",
+    "mlinkHomeAssistant.device.command.setAudioMute": "setAudioMute",
+    "mlinkHomeAssistant.device.command.setAudioVolume": "setAudioVolume",
+    "mlinkHomeAssistant.device.command.setBrightness": "setBrightness",
+    "mlinkHomeAssistant.device.command.setColorRGB": "setColorRGB",
+    "mlinkHomeAssistant.device.command.setColorTemperature": "setColorTemperature",
+    "mlinkHomeAssistant.device.command.setFan": "setFan",
+    "mlinkHomeAssistant.device.command.setThermostatMode": "setThermostatMode",
+    "mlinkHomeAssistant.device.command.setThermostatTemperature": "setThermostatTemperature",
+    "mlinkHue.device.command.onOff": "onOff",
+    "mlinkHue.device.command.setBrightness": "setBrightness",
+    "mlinkHue.device.command.setColorRGB": "setColorRGB",
+    "mlinkHue.device.command.setColorTemperature": "setColorTemperature",
+    "mlinkLutron.device.command.coverOpenClose": "coverOpenClose",
+    "mlinkLutron.device.command.onOff": "onOff",
+    "mlinkLutron.device.command.setBrightness": "setBrightness",
+    "mlinkLutron.device.command.setFan": "setFan",
+    "mlinkMatter.device.command.coverOpenClose": "coverOpenClose",
+    "mlinkMatter.device.command.lockUnlock": "lockUnlock",
+    "mlinkMatter.device.command.onOff": "onOff",
+    "mlinkMatter.device.command.setAudioMute": "setAudioMute",
+    "mlinkMatter.device.command.setAudioVolume": "setAudioVolume",
+    "mlinkMatter.device.command.setBrightness": "setBrightness",
+    "mlinkMatter.device.command.setColorRGB": "setColorRGB",
+    "mlinkMatter.device.command.setColorTemperature": "setColorTemperature",
+    "mlinkMatter.device.command.setFan": "setFan",
+    "mlinkMatter.device.command.setThermostatMode": "setThermostatMode",
+    "mlinkMatter.device.command.setThermostatTemperature": "setThermostatTemperature",
+    "mlinkShelly.device.command.coverOpenClose": "coverOpenClose",
+    "mlinkShelly.device.command.onOff": "onOff",
+    "mlinkShelly.device.command.setBrightness": "setBrightness",
+    "mlinkShelly.device.command.setColorRGB": "setColorRGB",
+    "mlinkShelly.device.command.setColorTemperature": "setColorTemperature",
+    "mlinkSmartThings.device.command.broadcastAudio": "broadcastAudio",
+    "mlinkSmartThings.device.command.chime": "chime",
+    "mlinkSmartThings.device.command.controlMediaPlayback": "controlMediaPlayback",
+    "mlinkSmartThings.device.command.coverOpenClose": "coverOpenClose",
+    "mlinkSmartThings.device.command.lockUnlock": "lockUnlock",
+    "mlinkSmartThings.device.command.onOff": "onOff",
+    "mlinkSmartThings.device.command.setAudioMute": "setAudioMute",
+    "mlinkSmartThings.device.command.setAudioVolume": "setAudioVolume",
+    "mlinkSmartThings.device.command.setBrightness": "setBrightness",
+    "mlinkSmartThings.device.command.setColorRGB": "setColorRGB",
+    "mlinkSmartThings.device.command.setColorTemperature": "setColorTemperature",
+    "mlinkSmartThings.device.command.setFan": "setFan",
+    "mlinkSmartThings.device.command.setThermostatMode": "setThermostatMode",
+    "mlinkSmartThings.device.command.setThermostatTemperature": "setThermostatTemperature",
+    "mlinkSonos.device.command.broadcastAudio": "broadcastAudio",
+    "mlinkSonos.device.command.controlMediaPlayback": "controlMediaPlayback",
+    "mlinkSonos.device.command.playMedia": "playMedia",
+    "mlinkSonos.device.command.setAudioMute": "setAudioMute",
+    "mlinkSonos.device.command.setAudioVolume": "setAudioVolume",
+    "playground.device.command.broadcastAudio": "broadcastAudio",
+    "playground.device.command.chime": "chime",
+    "playground.device.command.controlMediaPlayback": "controlMediaPlayback",
+    "playground.device.command.coverOpenClose": "coverOpenClose",
+    "playground.device.command.lockUnlock": "lockUnlock",
+    "playground.device.command.onOff": "onOff",
+    "playground.device.command.playMedia": "playMedia",
+    "playground.device.command.setAudioMute": "setAudioMute",
+    "playground.device.command.setAudioVolume": "setAudioVolume",
+    "playground.device.command.setBrightness": "setBrightness",
+    "playground.device.command.setColorRGB": "setColorRGB",
+    "playground.device.command.setColorTemperature": "setColorTemperature",
+    "playground.device.command.setFan": "setFan",
+    "playground.device.command.setThermostatMode": "setThermostatMode",
+    "playground.device.command.setThermostatTemperature": "setThermostatTemperature",
+    "smartLife.device.command.onOff": "onOff",
+    "smartLife.device.command.setBrightness": "setBrightness",
+    "smartLife.device.command.setColorRGB": "setColorRGB",
+    "smartLife.device.command.setColorTemperature": "setColorTemperature",
+    "smartLife.device.command.setFan": "setFan",
+    "xiaomi.device.command.onOff": "onOff",
+    "xiaomi.device.command.setBrightness": "setBrightness",
+    "xiaomi.device.command.setColorRGB": "setColorRGB",
+    "xiaomi.device.command.setColorTemperature": "setColorTemperature",
+    "xiaomi.device.command.setFan": "setFan"
+  }
+}

package/manifest/routing.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.app-facade.routing.v1",
-  "contractVersion": "1.113.0",
+  "contractVersion": "1.114.1",
   "targetPrefix": "/app/",
   "default": {
     "execution": "scopeMode"

package/manifest/targets.v1.json

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

package/protocol.json

@@ -1,9 +1,10 @@
 {
   "protocol": "mhome.app-facade",
-  "contractVersion": "1.113.0",
+  "contractVersion": "1.114.1",
   "manifest": "manifest/app-facade.v1.json",
   "schemas": {
     "storage": "schema/storage.v1.schema.json",
+    "householdRecording": "schema/household-recording.v1.schema.json",
     "nowAttention": "schema/now-attention.v1.schema.json",
     "billing": "schema/billing.v1.schema.json",
     "pluginInstall": "schema/plugin-install.v1.schema.json",

package/schema/facade-call.v1.schema.json

@@ -4,44 +4,158 @@
   "title": "App Facade call",
   "type": "object",
   "additionalProperties": false,
-  "required": ["control", "input"],
+  "required": [
+    "control",
+    "input"
+  ],
   "properties": {
     "control": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["mode"],
+      "required": [
+        "mode"
+      ],
       "properties": {
-        "mode": { "enum": ["direct", "prepare", "commit", "reject"] },
-        "preparedActionId": { "type": "string", "minLength": 1, "pattern": ".*\\S.*" },
-        "approvalToken": { "type": "string", "minLength": 1, "pattern": ".*\\S.*" },
-        "responseDetail": { "enum": ["full", "essential"] }
+        "mode": {
+          "enum": [
+            "direct",
+            "prepare",
+            "commit",
+            "reject"
+          ]
+        },
+        "preparedActionId": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": ".*\\S.*"
+        },
+        "approvalToken": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": ".*\\S.*"
+        },
+        "responseDetail": {
+          "enum": [
+            "full",
+            "essential"
+          ]
+        }
       },
       "allOf": [
         {
-          "if": { "properties": { "mode": { "enum": ["direct", "prepare"] } } },
+          "if": {
+            "properties": {
+              "mode": {
+                "enum": [
+                  "direct",
+                  "prepare"
+                ]
+              }
+            }
+          },
           "then": {
             "not": {
               "anyOf": [
-                { "properties": { "preparedActionId": {} }, "required": ["preparedActionId"] },
-                { "properties": { "approvalToken": {} }, "required": ["approvalToken"] }
+                {
+                  "properties": {
+                    "preparedActionId": {}
+                  },
+                  "required": [
+                    "preparedActionId"
+                  ]
+                },
+                {
+                  "properties": {
+                    "approvalToken": {}
+                  },
+                  "required": [
+                    "approvalToken"
+                  ]
+                }
               ]
             }
           }
         },
         {
-          "if": { "properties": { "mode": { "const": "commit" } } },
-          "then": { "properties": { "preparedActionId": {}, "approvalToken": {} }, "required": ["preparedActionId", "approvalToken"] }
+          "if": {
+            "properties": {
+              "mode": {
+                "const": "commit"
+              }
+            }
+          },
+          "then": {
+            "properties": {
+              "preparedActionId": {},
+              "approvalToken": {}
+            },
+            "required": [
+              "preparedActionId",
+              "approvalToken"
+            ]
+          }
         },
         {
-          "if": { "properties": { "mode": { "const": "reject" } } },
+          "if": {
+            "properties": {
+              "mode": {
+                "const": "reject"
+              }
+            }
+          },
           "then": {
-            "properties": { "preparedActionId": {} },
-            "required": ["preparedActionId"],
-            "not": { "properties": { "approvalToken": {} }, "required": ["approvalToken"] }
+            "properties": {
+              "preparedActionId": {}
+            },
+            "required": [
+              "preparedActionId"
+            ],
+            "not": {
+              "properties": {
+                "approvalToken": {}
+              },
+              "required": [
+                "approvalToken"
+              ]
+            }
           }
         }
       ]
     },
-    "input": true
+    "input": true,
+    "source": {
+      "type": [
+        "object",
+        "null"
+      ],
+      "additionalProperties": false,
+      "required": [
+        "kind"
+      ],
+      "properties": {
+        "kind": {
+          "enum": [
+            "ui",
+            "agent",
+            "messaging",
+            "cli",
+            "skill",
+            "mcp"
+          ]
+        },
+        "page": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "cardId": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      }
+    }
   }
 }

package/schema/household-recording.v1.schema.json

@@ -0,0 +1,129 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Household behavior record",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "id",
+    "occurredAtMs",
+    "finishedAtMs",
+    "actor",
+    "source",
+    "data"
+  ],
+  "properties": {
+    "id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "occurredAtMs": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "finishedAtMs": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "actor": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "kind",
+            "userId"
+          ],
+          "properties": {
+            "kind": {
+              "const": "user"
+            },
+            "userId": {
+              "type": "string",
+              "minLength": 1
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "kind"
+          ],
+          "properties": {
+            "kind": {
+              "const": "space"
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "kind"
+          ],
+          "properties": {
+            "kind": {
+              "const": "agent"
+            },
+            "agentId": {
+              "type": "string"
+            }
+          }
+        }
+      ]
+    },
+    "source": {
+      "type": "object",
+      "required": [
+        "kind"
+      ],
+      "properties": {
+        "kind": {
+          "enum": [
+            "ui",
+            "agent",
+            "messaging",
+            "cli",
+            "skill",
+            "mcp"
+          ]
+        },
+        "appClientId": {
+          "type": "string"
+        },
+        "page": {
+          "type": "string"
+        },
+        "cardId": {
+          "type": "string"
+        },
+        "surfaceId": {
+          "type": "string"
+        },
+        "provider": {
+          "type": "string"
+        }
+      }
+    },
+    "data": {
+      "type": "object",
+      "required": [
+        "event",
+        "status"
+      ],
+      "properties": {
+        "event": {
+          "type": "string"
+        },
+        "status": {
+          "enum": [
+            "success",
+            "partial",
+            "error",
+            "cancelled"
+          ]
+        }
+      }
+    }
+  }
+}