@mhome/app-facade-protocol 1.129.1 → 1.131.0

package/contract/automation-presentation-v1.md

@@ -9,7 +9,7 @@ Full and Essential use the same business read scope; UI requests Full.
 | `/app/presentation/automation/names/get` | `{ids}`: 1–100 selected, trimmed/deduplicated IDs | `{automations: {id: label}}`. Missing IDs omitted. Selected definition metadata only; no source downloads, parsing, state, history or graph reads. |
 | `/app/presentation/automation/list` | `{type: "RECURRING" \| "TASK_FLOW"}` | `{automations}`: current-type regular user programs, with labels, runnable/health/expiry metadata, enabled/running/blocked, last-run `timestamp`, status timestamps and tags. No temporary-program, Group, Widget, snapshot, graph or authored-source expansion. |
 | `/app/presentation/automation/overview/get` | `{automationId}`: nonblank, trimmed | `{id,name,type,enabled,runnable,corrupted,blocked,widgets}`. Selected metadata, status, cloud quota display state and owned Widget configuration/current values. No source, graph traversal, running history or snapshots. Missing definition is not-found. |
-| `/app/presentation/automation/placements/get` | `{automationId}`: nonblank, trimmed | `{canvases:[{id,name,containsAutomation}]}`. Reads owned Widgets, Widget-to-Card relations and canvas metadata/card IDs; never loads Card bodies. Retains existing default-canvas initialization when the Space has none. |
+| `/app/presentation/automation/placements/get` | `{automationId}`: nonblank, trimmed | `{canvases:[{id,name,containsAutomation}]}`. Matches both owned Widget-to-Card relations and dedicated Automation Cards by `meta.automationId`, against Canvas leaf IDs including composition members. Backends read current-Space Card records to resolve these business references; responses contain only Canvas labels and membership flags. Retains existing default-canvas initialization when the Space has none. |
 
 Labels use saved preferredName, then the script-derived saved name, then the
 existing unknown-label fallback. Metadata reads never require source storage to

package/contract/dashboard-composition-v1.md

@@ -50,6 +50,18 @@ source and target Canvas documents together. Delete and resource cleanup prune
 leaf references: one surviving member becomes an independent Card at its current
 absolute position; zero members removes the container.
 
+`/app/dashboard/canvas/list` and `/app/dashboard/canvas/content/get` include
+`pendingDeletion: {canvas, itemIds}` when a Canvas has a staged deletion.
+`canvas: true` identifies a staged whole-Canvas deletion. For card deletions,
+`itemIds` contains the root or member IDs that were selected for deletion.
+The read field is omitted after cleanup finishes.
+
+Users can explicitly finish a staged deletion with `retryPending: true` on
+`/app/dashboard/canvas/delete` for that `canvasId`, or on
+`/app/dashboard/card/delete` with the selected pending `itemIds` as
+`cardIds`. The backend processes the requested pending targets. An already
+completed retry returns success with zero deletions.
+
 Existing data is converted explicitly with old writers stopped, a verified
 backup and conflict checks. Runtime startup never converts legacy placement or
 silently deletes a database. Cloud Canvas records stay in the existing `canvas`

package/manifest/app-facade.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.app-facade.v1",
-  "contractVersion": "1.129.1",
+  "contractVersion": "1.131.0",
   "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.129.1",
+  "contractVersion": "1.131.0",
   "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.129.1",
+  "contractVersion": "1.131.0",
   "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.129.1",
+  "contractVersion": "1.131.0",
   "appTargets": [
     "/app/hub/get",
     "/app/hub/remove"

package/manifest/pod-targets.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.pod.targets.v1",
-  "contractVersion": "1.129.1",
+  "contractVersion": "1.131.0",
   "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.129.1",
+  "contractVersion": "1.131.0",
   "targetPrefix": "/app/",
   "default": {
     "execution": "spaceMode"

package/manifest/targets.v1.json

@@ -1,6 +1,6 @@
 {
   "manifest": "mhome.messaging.targets.v1",
-  "contractVersion": "1.129.1",
+  "contractVersion": "1.131.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.129.1",
+  "version": "1.131.0",
   "description": "Build-time protocol artifacts for mhome.app-facade",
   "license": "Apache-2.0",
   "repository": {

package/protocol.json

@@ -1,6 +1,6 @@
 {
   "protocol": "mhome.app-facade",
-  "contractVersion": "1.129.1",
+  "contractVersion": "1.131.0",
   "manifest": "manifest/app-facade.v1.json",
   "schemas": {
     "storage": "schema/storage.v1.schema.json",