@pellux/goodvibes-contracts 1.14.0 → 1.15.0

package/artifacts/operator-contract.json

@@ -3,7 +3,7 @@
   "product": {
     "id": "goodvibes",
     "surface": "operator",
-    "version": "1.14.0"
+    "version": "1.15.0"
   },
   "auth": {
     "modes": [
@@ -26207,6 +26207,15 @@
                   "items": {}
                 }
               ]
+            },
+            "persistedTo": {
+              "type": "string"
+            },
+            "tier": {
+              "type": "string"
+            },
+            "daemonOwned": {
+              "type": "boolean"
             }
           },
           "required": [
@@ -69747,7 +69756,8 @@
                       "status.request",
                       "location.request",
                       "session.message",
-                      "automation.run"
+                      "automation.run",
+                      "device.capability"
                     ]
                   }
                 },
@@ -71024,7 +71034,8 @@
                     "status.request",
                     "location.request",
                     "session.message",
-                    "automation.run"
+                    "automation.run",
+                    "device.capability"
                   ]
                 },
                 "command": {
@@ -72554,7 +72565,8 @@
                           "status.request",
                           "location.request",
                           "session.message",
-                          "automation.run"
+                          "automation.run",
+                          "device.capability"
                         ]
                       },
                       "command": {
@@ -72940,7 +72952,8 @@
                     "status.request",
                     "location.request",
                     "session.message",
-                    "automation.run"
+                    "automation.run",
+                    "device.capability"
                   ]
                 },
                 "command": {
@@ -73220,7 +73233,8 @@
                       "status.request",
                       "location.request",
                       "session.message",
-                      "automation.run"
+                      "automation.run",
+                      "device.capability"
                     ]
                   },
                   "command": {
@@ -75067,6 +75081,529 @@
         },
         "invokable": true
       },
+      {
+        "id": "devices.grants.list",
+        "title": "List Device Capability Grants",
+        "description": "The durable \"always allow\" grants a person gave, per capability and per device, with when each was granted, when it expires, and how often it has been used — plus the recent ledger of grants given, used, revoked, and expired.",
+        "category": "runtime",
+        "source": "builtin",
+        "access": "authenticated",
+        "transport": [
+          "http",
+          "ws"
+        ],
+        "scopes": [
+          "read:remote"
+        ],
+        "http": {
+          "method": "GET",
+          "path": "/api/devices/grants"
+        },
+        "inputSchema": {
+          "type": "object",
+          "properties": {
+            "nodeId": {
+              "type": "string"
+            },
+            "limit": {
+              "type": "number"
+            }
+          },
+          "additionalProperties": false
+        },
+        "outputSchema": {
+          "type": "object",
+          "properties": {
+            "grants": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "grantId": {
+                    "type": "string"
+                  },
+                  "nodeId": {
+                    "type": "string"
+                  },
+                  "nodeKind": {
+                    "type": "string"
+                  },
+                  "capabilityId": {
+                    "type": "string"
+                  },
+                  "capabilityTitle": {
+                    "type": "string"
+                  },
+                  "scope": {
+                    "type": "string"
+                  },
+                  "grantedAt": {
+                    "type": "number"
+                  },
+                  "expiresAt": {
+                    "type": "number"
+                  },
+                  "lastUsedAt": {
+                    "anyOf": [
+                      {
+                        "type": "number"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "useCount": {
+                    "type": "number"
+                  },
+                  "grantedBy": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "grantId",
+                  "nodeId",
+                  "nodeKind",
+                  "capabilityId",
+                  "capabilityTitle",
+                  "scope",
+                  "grantedAt",
+                  "expiresAt",
+                  "lastUsedAt",
+                  "useCount",
+                  "grantedBy"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "audit": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string"
+                  },
+                  "action": {
+                    "type": "string"
+                  },
+                  "grantId": {
+                    "type": "string"
+                  },
+                  "nodeId": {
+                    "type": "string"
+                  },
+                  "capabilityId": {
+                    "type": "string"
+                  },
+                  "at": {
+                    "type": "number"
+                  },
+                  "actor": {
+                    "type": "string"
+                  },
+                  "reason": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "id",
+                  "action",
+                  "grantId",
+                  "nodeId",
+                  "capabilityId",
+                  "at",
+                  "actor",
+                  "reason"
+                ],
+                "additionalProperties": false
+              }
+            }
+          },
+          "required": [
+            "grants",
+            "audit"
+          ],
+          "additionalProperties": false
+        },
+        "invokable": true
+      },
+      {
+        "id": "devices.grants.revoke",
+        "title": "Revoke a Device Capability Grant",
+        "description": "Delete durable grants by grant id, by device, by capability, or any combination. Revoked grants are removed rather than flagged, so the next request for that capability asks the person again. Returns exactly what was removed.",
+        "category": "runtime",
+        "source": "builtin",
+        "access": "authenticated",
+        "transport": [
+          "http",
+          "ws"
+        ],
+        "scopes": [
+          "write:config"
+        ],
+        "http": {
+          "method": "POST",
+          "path": "/api/devices/grants/revoke"
+        },
+        "inputSchema": {
+          "type": "object",
+          "properties": {
+            "grantId": {
+              "type": "string"
+            },
+            "nodeId": {
+              "type": "string"
+            },
+            "capabilityId": {
+              "type": "string"
+            },
+            "note": {
+              "type": "string"
+            }
+          },
+          "additionalProperties": false
+        },
+        "outputSchema": {
+          "type": "object",
+          "properties": {
+            "revoked": {
+              "type": "number"
+            },
+            "removals": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "grantId": {
+                    "type": "string"
+                  },
+                  "nodeId": {
+                    "type": "string"
+                  },
+                  "capabilityId": {
+                    "type": "string"
+                  },
+                  "scope": {
+                    "type": "string"
+                  },
+                  "reason": {
+                    "type": "string"
+                  },
+                  "removedAt": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "grantId",
+                  "nodeId",
+                  "capabilityId",
+                  "scope",
+                  "reason",
+                  "removedAt"
+                ],
+                "additionalProperties": false
+              }
+            }
+          },
+          "required": [
+            "revoked",
+            "removals"
+          ],
+          "additionalProperties": false
+        },
+        "invokable": true
+      },
+      {
+        "id": "devices.housekeeping.run",
+        "title": "Run Device Housekeeping",
+        "description": "Sweep the device grants ledger and the retained captures now: expired and orphaned grants removed, captures past their retention window deleted, torn or missing capture files reaped. Returns the itemised disclosure of everything removed and why.",
+        "category": "runtime",
+        "source": "builtin",
+        "access": "authenticated",
+        "transport": [
+          "http",
+          "ws"
+        ],
+        "scopes": [
+          "write:config"
+        ],
+        "http": {
+          "method": "POST",
+          "path": "/api/devices/housekeeping"
+        },
+        "inputSchema": {
+          "type": "object",
+          "properties": {},
+          "additionalProperties": false
+        },
+        "outputSchema": {
+          "type": "object",
+          "properties": {
+            "summary": {
+              "type": "string"
+            },
+            "sweptAt": {
+              "type": "number"
+            },
+            "grantsRemoved": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "grantId": {
+                    "type": "string"
+                  },
+                  "nodeId": {
+                    "type": "string"
+                  },
+                  "capabilityId": {
+                    "type": "string"
+                  },
+                  "scope": {
+                    "type": "string"
+                  },
+                  "reason": {
+                    "type": "string"
+                  },
+                  "removedAt": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "grantId",
+                  "nodeId",
+                  "capabilityId",
+                  "scope",
+                  "reason",
+                  "removedAt"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "grantsRetained": {
+              "type": "number"
+            },
+            "capturesRemoved": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "artifactId": {
+                    "type": "string"
+                  },
+                  "nodeId": {
+                    "type": "string"
+                  },
+                  "capabilityId": {
+                    "type": "string"
+                  },
+                  "fileName": {
+                    "type": "string"
+                  },
+                  "reason": {
+                    "type": "string"
+                  },
+                  "removedAt": {
+                    "type": "number"
+                  },
+                  "byteLength": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "artifactId",
+                  "nodeId",
+                  "capabilityId",
+                  "fileName",
+                  "reason",
+                  "removedAt",
+                  "byteLength"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "capturesRetained": {
+              "type": "number"
+            },
+            "bytesReclaimed": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "summary",
+            "sweptAt",
+            "grantsRemoved",
+            "grantsRetained",
+            "capturesRemoved",
+            "capturesRetained",
+            "bytesReclaimed"
+          ],
+          "additionalProperties": false
+        },
+        "invokable": true
+      },
+      {
+        "id": "devices.nodes.list",
+        "title": "List Paired Device Nodes",
+        "description": "Every phone paired as a device node, with the capabilities it announced, the ones it did not offer, and the ones it announced but cannot currently serve because its connection is not a secure context. Node-kind neutral: a web app node and a native app node are described identically.",
+        "category": "runtime",
+        "source": "builtin",
+        "access": "authenticated",
+        "transport": [
+          "http",
+          "ws"
+        ],
+        "scopes": [
+          "read:remote"
+        ],
+        "http": {
+          "method": "GET",
+          "path": "/api/devices/nodes"
+        },
+        "inputSchema": {
+          "type": "object",
+          "properties": {},
+          "additionalProperties": false
+        },
+        "outputSchema": {
+          "type": "object",
+          "properties": {
+            "nodes": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "nodeId": {
+                    "type": "string"
+                  },
+                  "nodeKind": {
+                    "type": "string"
+                  },
+                  "nodeKindLabel": {
+                    "type": "string"
+                  },
+                  "label": {
+                    "type": "string"
+                  },
+                  "platform": {
+                    "type": "string"
+                  },
+                  "appVersion": {
+                    "type": "string"
+                  },
+                  "contractVersion": {
+                    "type": "number"
+                  },
+                  "contractCompatible": {
+                    "type": "boolean"
+                  },
+                  "supported": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "undeclared": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "gatedBySecureContext": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "unknownDeclared": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  }
+                },
+                "required": [
+                  "nodeId",
+                  "nodeKind",
+                  "nodeKindLabel",
+                  "label",
+                  "platform",
+                  "appVersion",
+                  "contractVersion",
+                  "contractCompatible",
+                  "supported",
+                  "undeclared",
+                  "gatedBySecureContext",
+                  "unknownDeclared"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "capabilities": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string"
+                  },
+                  "family": {
+                    "type": "string"
+                  },
+                  "title": {
+                    "type": "string"
+                  },
+                  "purpose": {
+                    "type": "string"
+                  },
+                  "effect": {
+                    "type": "string"
+                  },
+                  "sensitivity": {
+                    "type": "string"
+                  },
+                  "producesArtifact": {
+                    "type": "boolean"
+                  },
+                  "allowAlwaysOffered": {
+                    "type": "boolean"
+                  }
+                },
+                "required": [
+                  "id",
+                  "family",
+                  "title",
+                  "purpose",
+                  "effect",
+                  "sensitivity",
+                  "producesArtifact",
+                  "allowAlwaysOffered"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "mode": {
+              "type": "string"
+            },
+            "allowAlwaysOffer": {
+              "type": "string"
+            },
+            "captureRetentionHours": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "nodes",
+            "capabilities",
+            "mode",
+            "allowAlwaysOffer",
+            "captureRetentionHours"
+          ],
+          "additionalProperties": false
+        },
+        "invokable": true
+      },
       {
         "id": "runtime.metrics.get",
         "title": "Runtime Metrics",
@@ -92153,10 +92690,10 @@
       }
     ],
     "schemaCoverage": {
-      "methods": 415,
-      "typedInputs": 415,
+      "methods": 419,
+      "typedInputs": 419,
       "genericInputs": 0,
-      "typedOutputs": 415,
+      "typedOutputs": 419,
       "genericOutputs": 0
     },
     "eventCoverage": {
@@ -92165,8 +92702,8 @@
       "withWireEvents": 32
     },
     "validationCoverage": {
-      "methods": 415,
-      "validated": 408,
+      "methods": 419,
+      "validated": 412,
       "skippedGeneric": 0,
       "skippedUntyped": 7
     }