@clowder-ai/plugin-contract 0.1.0-beta.15 → 0.1.0-beta.17

package/src/schemas/manifest.schema.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://clowder-ai.dev/schemas/manifest/v0.1",
   "title": "Clowder AI Plugin Manifest (v0.1)",
-  "description": "Machine-readable truth source for the static plugin.yaml access protocol (§3.4/§3.5). beta.14 adds the Host-governed content-editor-provider contribution while Host grants and content ownership remain separate runtime authorities.",
+  "description": "Machine-readable truth source for the static plugin.yaml access protocol (§3.4/§3.5). beta.16 adds the Host-governed desktop-window contribution. Window, media and conversation authorities remain separate Host runtime decisions; the signed broker wire is unchanged.",
   "x-clowder-capability-layers": {
     "L0": ["plugin.config.read", "plugin.state.get", "plugin.state.set"],
     "L1": ["messaging.send", "schedule.register", "events.publish", "messaging.appendElements"],
@@ -105,7 +105,7 @@
       "properties": {
         "type": {
           "type": "string",
-          "enum": ["identity", "schedule", "tool", "mcp", "skill", "limb", "webhook", "message-subscription", "service", "connector", "ui", "content-editor-provider"]
+          "enum": ["identity", "schedule", "tool", "mcp", "skill", "limb", "webhook", "message-subscription", "service", "connector", "ui", "content-editor-provider", "desktop-window"]
         },
         "id": { "type": "string", "minLength": 1 }
       },
@@ -469,6 +469,41 @@
       "additionalProperties": false
     },
 
+    "DesktopWindowContribution": {
+      "type": "object",
+      "description": "Host-created desktop surface under its owning feature's windows.create grant. surface.integrity verifies only the entry HTML bytes. The Host must separately verify the complete installed package and serve a verified snapshot of all referenced assets. This declares no executable, Host origin, identity, or capture permission. The Host owns window execution, media/session admission and the isolated receive-only provider channel.",
+      "properties": {
+        "type": { "const": "desktop-window" },
+        "id": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "role": { "const": "companion" },
+        "surface": {
+          "type": "object",
+          "properties": {
+            "entrypoint": { "$ref": "#/$defs/PackageRelativePath", "pattern": "\\.html$" },
+            "integrity": { "type": "string", "pattern": "^sha256-[A-Za-z0-9+/]{43}=$" }
+          },
+          "required": ["entrypoint", "integrity"],
+          "additionalProperties": false
+        },
+        "bridgeVersion": { "enum": ["1.0.0", "1.1.0"] },
+        "presentation": {
+          "type": "object",
+          "properties": {
+            "width": { "type": "integer", "minimum": 160, "maximum": 600 },
+            "height": { "type": "integer", "minimum": 160, "maximum": 1000 },
+            "transparent": { "const": true },
+            "frame": { "const": false },
+            "alwaysOnTop": { "type": "boolean" },
+            "skipTaskbar": { "type": "boolean" }
+          },
+          "required": ["width", "height", "transparent", "frame", "alwaysOnTop", "skipTaskbar"],
+          "additionalProperties": false
+        }
+      },
+      "required": ["type", "id", "role", "surface", "bridgeVersion", "presentation"],
+      "additionalProperties": false
+    },
+
     "ContentEditorProviderContribution": {
       "type": "object",
       "properties": {
@@ -530,7 +565,8 @@
         { "$ref": "#/$defs/ServiceContribution" },
         { "$ref": "#/$defs/ConnectorContribution" },
         { "$ref": "#/$defs/UiContribution" },
-        { "$ref": "#/$defs/ContentEditorProviderContribution" }
+        { "$ref": "#/$defs/ContentEditorProviderContribution" },
+        { "$ref": "#/$defs/DesktopWindowContribution" }
       ]
     },