@dp-bohrium/widget-contracts 0.0.1

package/schemas/widget-runtime-contracts.schema.json

@@ -0,0 +1,1478 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "widget-runtime-contracts.schema.json",
+  "title": "Widget Runtime Contracts",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "widgetSlot",
+    "renderRequest",
+    "hostToWidgetMessage",
+    "widgetToHostMessage",
+    "capabilityRequest",
+    "capabilityResult",
+    "widgetError",
+    "resourceBudget"
+  ],
+  "properties": {
+    "widgetSlot": {
+      "$ref": "#/$defs/WidgetSlot"
+    },
+    "renderRequest": {
+      "$ref": "#/$defs/RenderRequest"
+    },
+    "hostToWidgetMessage": {
+      "$ref": "#/$defs/HostToWidgetMessage"
+    },
+    "widgetToHostMessage": {
+      "$ref": "#/$defs/WidgetToHostMessage"
+    },
+    "capabilityRequest": {
+      "$ref": "#/$defs/CapabilityRequest"
+    },
+    "capabilityResult": {
+      "$ref": "#/$defs/CapabilityResult"
+    },
+    "widgetError": {
+      "$ref": "#/$defs/WidgetError"
+    },
+    "resourceBudget": {
+      "$ref": "#/$defs/ResourceBudget"
+    },
+    "widgetEventBatch": {
+      "$ref": "#/$defs/WidgetEventBatch"
+    },
+    "toolLifecycleEvent": {
+      "$ref": "#/$defs/ToolLifecycleEvent"
+    },
+    "widgetNetworkFetchOutput": {
+      "$ref": "#/$defs/WidgetNetworkFetchOutput"
+    },
+    "presentationCapabilityOutput": {
+      "$ref": "#/$defs/PresentationCapabilityOutput"
+    },
+    "presentationCapabilityResult": {
+      "$ref": "#/$defs/PresentationCapabilityResult"
+    }
+  },
+  "$defs": {
+    "JsonValue": {
+      "title": "JsonValue",
+      "oneOf": [
+        { "type": "null" },
+        { "type": "boolean" },
+        { "type": "number" },
+        { "type": "string" },
+        { "type": "array", "items": { "$ref": "#/$defs/JsonValue" } },
+        {
+          "type": "object",
+          "additionalProperties": { "$ref": "#/$defs/JsonValue" }
+        }
+      ]
+    },
+    "WidgetSlot": {
+      "title": "WidgetSlot",
+      "enum": ["tool-result", "file-preview", "panel"]
+    },
+    "RenderState": {
+      "title": "RenderState",
+      "enum": ["loading", "partial", "complete", "error"]
+    },
+    "ThemeMode": {
+      "title": "ThemeMode",
+      "enum": ["light", "dark"]
+    },
+    "Theme": {
+      "title": "Theme",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["mode", "tokens"],
+      "properties": {
+        "mode": { "$ref": "#/$defs/ThemeMode" },
+        "tokens": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "background",
+            "foreground",
+            "muted",
+            "mutedForeground",
+            "border",
+            "primary",
+            "danger"
+          ],
+          "properties": {
+            "background": { "type": "string", "minLength": 1 },
+            "foreground": { "type": "string", "minLength": 1 },
+            "muted": { "type": "string", "minLength": 1 },
+            "mutedForeground": { "type": "string", "minLength": 1 },
+            "border": { "type": "string", "minLength": 1 },
+            "primary": { "type": "string", "minLength": 1 },
+            "danger": { "type": "string", "minLength": 1 }
+          }
+        }
+      }
+    },
+    "FileReference": {
+      "title": "FileReference",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "kind", "name"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "kind": { "enum": ["file", "directory"] },
+        "name": { "type": "string", "minLength": 1 },
+        "extension": {
+          "type": "string",
+          "pattern": "^[a-z0-9][a-z0-9.-]*$",
+          "maxLength": 32
+        },
+        "mimeType": { "type": "string", "minLength": 1, "maxLength": 255 },
+        "size": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "GrantedCapability": {
+      "title": "GrantedCapability",
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "name",
+            "limits"
+          ],
+          "properties": {
+            "name": {
+              "const": "files.list"
+            },
+            "limits": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "pageSize",
+                "callsPerMinute"
+              ],
+              "properties": {
+                "pageSize": {
+                  "type": "integer",
+                  "minimum": 1
+                },
+                "callsPerMinute": {
+                  "type": "integer",
+                  "minimum": 1
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "name",
+            "limits"
+          ],
+          "properties": {
+            "name": {
+              "const": "files.metadata"
+            },
+            "limits": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "callsPerMinute"
+              ],
+              "properties": {
+                "callsPerMinute": {
+                  "type": "integer",
+                  "minimum": 1
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "name",
+            "limits"
+          ],
+          "properties": {
+            "name": {
+              "const": "files.read"
+            },
+            "limits": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "bytesPerRequest",
+                "bytesPerRun",
+                "callsPerMinute"
+              ],
+              "properties": {
+                "bytesPerRequest": {
+                  "type": "integer",
+                  "minimum": 1
+                },
+                "bytesPerRun": {
+                  "type": "integer",
+                  "minimum": 1
+                },
+                "callsPerMinute": {
+                  "type": "integer",
+                  "minimum": 1
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "name",
+            "topics",
+            "limits"
+          ],
+          "properties": {
+            "name": {
+              "const": "events.read"
+            },
+            "topics": {
+              "type": "array",
+              "minItems": 1,
+              "maxItems": 32,
+              "uniqueItems": true,
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 128,
+                "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$"
+              }
+            },
+            "limits": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "callsPerMinute",
+                "pageSize",
+                "minPollMs"
+              ],
+              "properties": {
+                "callsPerMinute": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 9007199254740991
+                },
+                "pageSize": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 100
+                },
+                "minPollMs": {
+                  "type": "integer",
+                  "minimum": 1000,
+                  "maximum": 60000
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "name",
+            "actions",
+            "limits"
+          ],
+          "properties": {
+            "name": {
+              "const": "actions.invoke"
+            },
+            "actions": {
+              "type": "array",
+              "minItems": 1,
+              "maxItems": 32,
+              "uniqueItems": true,
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 128,
+                "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$"
+              }
+            },
+            "limits": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "callsPerMinute"
+              ],
+              "properties": {
+                "callsPerMinute": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 9007199254740991
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["name", "limits"],
+          "properties": {
+            "name": { "const": "network.fetch" },
+            "limits": { "$ref": "#/$defs/WidgetNetworkLimits" }
+          }
+        },
+        { "$ref": "#/$defs/GrantedPresentationCapability" }
+      ]
+    },
+    "GrantedPresentationCapability": {
+      "title": "GrantedPresentationCapability",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "surfaces", "requiresHostConfirmation"],
+      "properties": {
+        "name": { "const": "ui.presentation" },
+        "surfaces": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 2,
+          "uniqueItems": true,
+          "items": { "enum": ["floating", "overlay"] }
+        },
+        "requiresHostConfirmation": { "const": true }
+      }
+    },
+    "WidgetRenderContext": {
+      "title": "WidgetRenderContext",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "locale",
+        "theme",
+        "viewport",
+        "capabilities",
+        "correlationId"
+      ],
+      "properties": {
+        "locale": { "type": "string", "minLength": 1 },
+        "theme": { "$ref": "#/$defs/Theme" },
+        "viewport": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["width", "height"],
+          "properties": {
+            "width": { "type": "number", "minimum": 0 },
+            "height": { "type": "number", "minimum": 0 }
+          }
+        },
+        "capabilities": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/GrantedCapability" }
+        },
+        "correlationId": { "type": "string", "minLength": 1 }
+      }
+    },
+    "ToolResultContent": {
+      "title": "ToolResultContent",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["slot", "tool", "input"],
+      "properties": {
+        "slot": { "const": "tool-result" },
+        "tool": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["name", "callId", "status"],
+          "properties": {
+            "name": { "type": "string", "minLength": 1 },
+            "callId": { "type": "string", "minLength": 1 },
+            "status": {
+              "enum": ["running", "succeeded", "failed", "cancelled"]
+            }
+          }
+        },
+        "input": { "$ref": "#/$defs/JsonValue" },
+        "result": { "$ref": "#/$defs/JsonValue" },
+        "error": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["code", "message"],
+          "properties": {
+            "code": { "type": "string", "minLength": 1 },
+            "message": { "type": "string", "minLength": 1 }
+          }
+        }
+      }
+    },
+    "FilePreviewContent": {
+      "title": "FilePreviewContent",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["slot", "file"],
+      "properties": {
+        "slot": { "const": "file-preview" },
+        "file": { "$ref": "#/$defs/FileReference" },
+        "preview": { "$ref": "#/$defs/JsonValue" }
+      }
+    },
+    "PanelContent": {
+      "title": "PanelContent",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["slot", "panelType", "data"],
+      "properties": {
+        "slot": { "const": "panel" },
+        "panelType": { "type": "string", "minLength": 1 },
+        "title": { "type": "string" },
+        "data": { "$ref": "#/$defs/JsonValue" }
+      }
+    },
+    "RenderRequestBase": {
+      "title": "RenderRequestBase",
+      "type": "object",
+      "required": [
+        "schemaVersion",
+        "requestId",
+        "instanceId",
+        "revision",
+        "state",
+        "context"
+      ],
+      "properties": {
+        "schemaVersion": { "const": 1 },
+        "requestId": { "type": "string", "minLength": 1 },
+        "instanceId": { "type": "string", "minLength": 1 },
+        "revision": { "type": "integer", "minimum": 1 },
+        "state": { "$ref": "#/$defs/RenderState" },
+        "context": { "$ref": "#/$defs/WidgetRenderContext" }
+      }
+    },
+    "ToolResultRenderRequest": {
+      "title": "ToolResultRenderRequest",
+      "type": "object",
+      "allOf": [
+        { "$ref": "#/$defs/RenderRequestBase" },
+        {
+          "type": "object",
+          "required": ["slot", "content"],
+          "properties": {
+            "slot": { "const": "tool-result" },
+            "content": { "$ref": "#/$defs/ToolResultContent" }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "FilePreviewRenderRequest": {
+      "title": "FilePreviewRenderRequest",
+      "type": "object",
+      "allOf": [
+        { "$ref": "#/$defs/RenderRequestBase" },
+        {
+          "type": "object",
+          "required": ["slot", "content"],
+          "properties": {
+            "slot": { "const": "file-preview" },
+            "content": { "$ref": "#/$defs/FilePreviewContent" }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "PanelRenderRequest": {
+      "title": "PanelRenderRequest",
+      "type": "object",
+      "allOf": [
+        { "$ref": "#/$defs/RenderRequestBase" },
+        {
+          "type": "object",
+          "required": ["slot", "content"],
+          "properties": {
+            "slot": { "const": "panel" },
+            "content": { "$ref": "#/$defs/PanelContent" }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "RenderRequest": {
+      "title": "RenderRequest",
+      "oneOf": [
+        { "$ref": "#/$defs/ToolResultRenderRequest" },
+        { "$ref": "#/$defs/FilePreviewRenderRequest" },
+        { "$ref": "#/$defs/PanelRenderRequest" }
+      ]
+    },
+    "CapabilityRequest": {
+      "title": "CapabilityRequest",
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "operation",
+            "input"
+          ],
+          "properties": {
+            "operation": {
+              "const": "files.list"
+            },
+            "input": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "directory"
+              ],
+              "properties": {
+                "directory": {
+                  "$ref": "#/$defs/FileReference"
+                },
+                "cursor": {
+                  "type": "string"
+                },
+                "limit": {
+                  "type": "integer",
+                  "minimum": 1
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "operation",
+            "input"
+          ],
+          "properties": {
+            "operation": {
+              "const": "files.metadata"
+            },
+            "input": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "reference"
+              ],
+              "properties": {
+                "reference": {
+                  "$ref": "#/$defs/FileReference"
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "operation",
+            "input"
+          ],
+          "properties": {
+            "operation": {
+              "const": "files.read"
+            },
+            "input": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "file",
+                "offset",
+                "length",
+                "encoding"
+              ],
+              "properties": {
+                "file": {
+                  "$ref": "#/$defs/FileReference"
+                },
+                "offset": {
+                  "type": "integer",
+                  "minimum": 0
+                },
+                "length": {
+                  "type": "integer",
+                  "minimum": 1
+                },
+                "encoding": {
+                  "enum": [
+                    "utf8",
+                    "base64"
+                  ]
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "operation",
+            "input"
+          ],
+          "properties": {
+            "operation": {
+              "const": "events.read"
+            },
+            "input": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "topic",
+                "limit"
+              ],
+              "properties": {
+                "topic": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 128,
+                  "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$"
+                },
+                "cursor": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 256
+                },
+                "limit": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 100
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "operation",
+            "input"
+          ],
+          "properties": {
+            "operation": {
+              "const": "actions.invoke"
+            },
+            "input": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "action",
+                "idempotencyKey",
+                "arguments"
+              ],
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 128,
+                  "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$"
+                },
+                "idempotencyKey": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 256
+                },
+                "arguments": {
+                  "$ref": "#/$defs/JsonValue"
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["operation", "input"],
+          "properties": {
+            "operation": { "const": "network.fetch" },
+            "input": { "$ref": "#/$defs/WidgetNetworkFetchInput" }
+          }
+        },
+        { "$ref": "#/$defs/PresentationCapabilityRequest" }
+      ]
+    },
+    "PresentationCapabilityRequest": {
+      "title": "PresentationCapabilityRequest",
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["operation", "input"],
+          "properties": {
+            "operation": { "const": "ui.presentation" },
+            "input": {
+              "oneOf": [
+                {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": ["action", "surface"],
+                  "properties": {
+                    "action": { "enum": ["present", "change-surface"] },
+                    "surface": {
+                      "enum": ["workspace", "floating", "overlay"]
+                    }
+                  }
+                },
+                {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": ["action"],
+                  "properties": {
+                    "action": { "const": "close" }
+                  }
+                }
+              ]
+            }
+          }
+        },
+        { "$ref": "#/$defs/FocusBoundaryPresentationCapabilityRequest" }
+      ]
+    },
+    "FocusBoundaryPresentationCapabilityRequest": {
+      "title": "FocusBoundaryPresentationCapabilityRequest",
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["operation", "input"],
+          "properties": {
+            "operation": { "const": "ui.presentation" },
+            "input": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["action", "direction"],
+              "properties": {
+                "action": { "const": "focus-boundary" },
+                "direction": { "enum": ["forward", "backward"] }
+              }
+            }
+          }
+        }
+      ]
+    },
+    "WidgetNetworkLimits": {
+      "title": "WidgetNetworkLimits",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "timeoutMs",
+        "maxRedirects",
+        "maxConcurrentRequests",
+        "callsPerMinute",
+        "requestHeaderBytes",
+        "responseHeaderBytes",
+        "requestBodyBytes",
+        "responseBodyBytes"
+      ],
+      "properties": {
+        "timeoutMs": { "$ref": "#/$defs/PositiveInteger" },
+        "maxRedirects": { "$ref": "#/$defs/PositiveInteger" },
+        "maxConcurrentRequests": { "$ref": "#/$defs/PositiveInteger" },
+        "callsPerMinute": { "$ref": "#/$defs/PositiveInteger" },
+        "requestHeaderBytes": { "$ref": "#/$defs/PositiveInteger" },
+        "responseHeaderBytes": { "$ref": "#/$defs/PositiveInteger" },
+        "requestBodyBytes": { "$ref": "#/$defs/PositiveInteger" },
+        "responseBodyBytes": { "$ref": "#/$defs/PositiveInteger" }
+      }
+    },
+    "PositiveInteger": {
+      "title": "PositiveInteger",
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 9007199254740991
+    },
+    "NetworkHeaders": {
+      "title": "NetworkHeaders",
+      "type": "object",
+      "maxProperties": 64,
+      "propertyNames": {
+        "pattern": "^[!#$%&'*+.^_`|~0-9A-Za-z-]+$"
+      },
+      "additionalProperties": {
+        "type": "string",
+        "maxLength": 16384
+      }
+    },
+    "WidgetNetworkRequestHeaders": {
+      "title": "WidgetNetworkRequestHeaders",
+      "type": "object",
+      "maxProperties": 64,
+      "propertyNames": {
+        "allOf": [
+          { "pattern": "^[!#$%&'*+.^_`|~0-9A-Za-z-]+$" },
+          {
+            "not": {
+              "pattern": "^(?:[Aa][Uu][Tt][Hh][Oo][Rr][Ii][Zz][Aa][Tt][Ii][Oo][Nn]|[Cc][Oo][Oo][Kk][Ii][Ee]|[Pp][Rr][Oo][Xx][Yy]-[Aa][Uu][Tt][Hh][Oo][Rr][Ii][Zz][Aa][Tt][Ii][Oo][Nn]|[Xx]-[Aa][Pp][Ii]-[Kk][Ee][Yy]|[Aa][Pp][Ii]-[Kk][Ee][Yy]|[Xx]-[Aa][Uu][Tt][Hh]-[Tt][Oo][Kk][Ee][Nn]|[Xx]-[Aa][Cc][Cc][Ee][Ss][Ss]-[Tt][Oo][Kk][Ee][Nn]|[Cc][Rr][Ee][Dd][Ee][Nn][Tt][Ii][Aa][Ll]-[Bb][Ii][Nn][Dd][Ii][Nn][Gg]-[Ii][Dd]|[Xx]-[Cc][Rr][Ee][Dd][Ee][Nn][Tt][Ii][Aa][Ll]-[Bb][Ii][Nn][Dd][Ii][Nn][Gg]-[Ii][Dd])$"
+            }
+          }
+        ]
+      },
+      "additionalProperties": {
+        "type": "string",
+        "maxLength": 16384
+      }
+    },
+    "WidgetNetworkFetchInput": {
+      "title": "WidgetNetworkFetchInput",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["url", "auth"],
+      "properties": {
+        "url": { "type": "string", "minLength": 1, "maxLength": 8192 },
+        "auth": { "enum": ["none", "optional", "required"] },
+        "method": {
+          "enum": ["GET", "HEAD", "POST", "PUT", "PATCH", "DELETE"]
+        },
+        "headers": { "$ref": "#/$defs/WidgetNetworkRequestHeaders" },
+        "body": { "type": "string" },
+        "bodyEncoding": { "enum": ["utf8", "base64"] },
+        "redirect": { "enum": ["follow", "manual", "error"] }
+      },
+      "dependentRequired": {
+        "bodyEncoding": ["body"]
+      }
+    },
+    "WidgetNetworkFetchOutput": {
+      "title": "WidgetNetworkFetchOutput",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "status",
+        "statusText",
+        "headers",
+        "body",
+        "bodyEncoding",
+        "finalUrl",
+        "redirected"
+      ],
+      "properties": {
+        "status": { "type": "integer", "minimum": 100, "maximum": 599 },
+        "statusText": { "type": "string", "maxLength": 256 },
+        "headers": { "$ref": "#/$defs/NetworkHeaders" },
+        "body": { "type": "string" },
+        "bodyEncoding": { "enum": ["utf8", "base64"] },
+        "finalUrl": { "type": "string", "minLength": 1, "maxLength": 8192 },
+        "redirected": { "type": "boolean" }
+      }
+    },
+    "PresentationCapabilityOutput": {
+      "title": "PresentationCapabilityOutput",
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["action", "surface"],
+          "properties": {
+            "action": { "enum": ["present", "change-surface"] },
+            "surface": { "enum": ["workspace", "floating", "overlay"] }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["action"],
+          "properties": {
+            "action": { "const": "close" }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["action", "direction"],
+          "properties": {
+            "action": { "const": "focus-boundary" },
+            "direction": { "enum": ["forward", "backward"] }
+          }
+        }
+      ]
+    },
+    "PresentationCapabilityResult": {
+      "title": "PresentationCapabilityResult",
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["ok", "data"],
+          "properties": {
+            "ok": { "const": true },
+            "data": { "$ref": "#/$defs/PresentationCapabilityOutput" }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["ok", "reason", "message", "retryable"],
+          "properties": {
+            "ok": { "const": false },
+            "reason": {
+              "enum": [
+                "unsupported",
+                "permission-denied",
+                "resource-limit",
+                "invalid-reference",
+                "timeout",
+                "internal-error",
+                "network-consent-denied",
+                "network-policy-denied",
+                "network-transport-unavailable",
+                "network-request-too-large",
+                "network-response-too-large",
+                "network-rate-limited",
+                "network-redirect-denied",
+                "network-credential-unavailable",
+                "network-scope-invalid",
+                "network-dns-denied",
+                "network-error"
+              ]
+            },
+            "message": { "type": "string", "minLength": 1 },
+            "retryable": { "type": "boolean" }
+          }
+        }
+      ]
+    },
+    "CapabilityResult": {
+      "title": "CapabilityResult",
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["ok", "data"],
+          "properties": {
+            "ok": { "const": true },
+            "data": { "$ref": "#/$defs/JsonValue" }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["ok", "reason", "message", "retryable"],
+          "properties": {
+            "ok": { "const": false },
+            "reason": {
+              "enum": [
+                "unsupported",
+                "permission-denied",
+                "resource-limit",
+                "invalid-reference",
+                "timeout",
+                "internal-error",
+                "network-consent-denied",
+                "network-policy-denied",
+                "network-transport-unavailable",
+                "network-request-too-large",
+                "network-response-too-large",
+                "network-rate-limited",
+                "network-redirect-denied",
+                "network-credential-unavailable",
+                "network-scope-invalid",
+                "network-dns-denied",
+                "network-error"
+              ]
+            },
+            "message": { "type": "string", "minLength": 1 },
+            "retryable": { "type": "boolean" }
+          }
+        }
+      ]
+    },
+    "WidgetError": {
+      "title": "WidgetError",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code", "phase", "message", "retryable", "correlationId"],
+      "properties": {
+        "code": {
+          "enum": [
+            "BUNDLE_LOAD_FAILED",
+            "DIGEST_MISMATCH",
+            "RUNTIME_CONFIG_EXPIRED",
+            "WIDGET_VERSION_REVOKED",
+            "HOST_API_UNSUPPORTED",
+            "HANDSHAKE_TIMEOUT",
+            "MESSAGE_INVALID",
+            "CHANNEL_MISMATCH",
+            "MESSAGE_TOO_LARGE",
+            "MESSAGE_RATE_LIMITED",
+            "TOO_MANY_PENDING_REQUESTS",
+            "CAPABILITY_UNDECLARED",
+            "CAPABILITY_DENIED",
+            "CAPABILITY_UNSUPPORTED",
+            "CAPABILITY_TIMEOUT",
+            "FILE_REFERENCE_INVALID",
+            "FILE_PERMISSION_DENIED",
+            "RESOURCE_LIMIT",
+            "RENDER_FAILED",
+            "UPDATE_FAILED",
+            "WIDGET_CRASHED",
+            "INSTANCE_DISPOSED"
+          ]
+        },
+        "phase": {
+          "enum": [
+            "load",
+            "handshake",
+            "render",
+            "update",
+            "capability",
+            "dispose"
+          ]
+        },
+        "message": { "type": "string", "minLength": 1 },
+        "retryable": { "type": "boolean" },
+        "correlationId": { "type": "string", "minLength": 1 }
+      }
+    },
+    "ResourceBudget": {
+      "title": "ResourceBudget",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "version",
+        "bundle",
+        "bridge",
+        "files",
+        "timeouts",
+        "concurrency",
+        "retry",
+        "failure"
+      ],
+      "properties": {
+        "version": { "const": 1 },
+        "bundle": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "compressedBytes",
+            "expandedBytes",
+            "fileCount",
+            "singleFileBytes"
+          ],
+          "properties": {
+            "compressedBytes": { "type": "integer", "minimum": 1 },
+            "expandedBytes": { "type": "integer", "minimum": 1 },
+            "fileCount": { "type": "integer", "minimum": 1 },
+            "singleFileBytes": { "type": "integer", "minimum": 1 }
+          }
+        },
+        "bridge": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "messageBytes",
+            "messagesPerSecond",
+            "pendingRequests"
+          ],
+          "properties": {
+            "messageBytes": { "type": "integer", "minimum": 1 },
+            "messagesPerSecond": { "type": "integer", "minimum": 1 },
+            "pendingRequests": { "type": "integer", "minimum": 1 }
+          }
+        },
+        "files": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "readBytesPerRequest",
+            "readBytesPerRun",
+            "callsPerMinute",
+            "listPageSize"
+          ],
+          "properties": {
+            "readBytesPerRequest": { "type": "integer", "minimum": 1 },
+            "readBytesPerRun": { "type": "integer", "minimum": 1 },
+            "callsPerMinute": { "type": "integer", "minimum": 1 },
+            "listPageSize": { "type": "integer", "minimum": 1 }
+          }
+        },
+        "timeouts": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "bundleLoadMs",
+            "handshakeMs",
+            "firstRenderMs",
+            "updateMs",
+            "capabilityMs",
+            "disposeGraceMs"
+          ],
+          "properties": {
+            "bundleLoadMs": { "type": "integer", "minimum": 1 },
+            "handshakeMs": { "type": "integer", "minimum": 1 },
+            "firstRenderMs": { "type": "integer", "minimum": 1 },
+            "updateMs": { "type": "integer", "minimum": 1 },
+            "capabilityMs": { "type": "integer", "minimum": 1 },
+            "disposeGraceMs": { "type": "integer", "minimum": 1 }
+          }
+        },
+        "concurrency": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "activeIframesPerPage",
+            "activeIframesPerRun",
+            "hiddenRecycleMs"
+          ],
+          "properties": {
+            "activeIframesPerPage": { "type": "integer", "minimum": 1 },
+            "activeIframesPerRun": { "type": "integer", "minimum": 1 },
+            "hiddenRecycleMs": { "type": "integer", "minimum": 1 }
+          }
+        },
+        "retry": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "maxAttempts",
+            "initialDelayMs",
+            "maxDelayMs",
+            "totalMs"
+          ],
+          "properties": {
+            "maxAttempts": { "type": "integer", "minimum": 1 },
+            "initialDelayMs": { "type": "integer", "minimum": 1 },
+            "maxDelayMs": { "type": "integer", "minimum": 1 },
+            "totalMs": { "type": "integer", "minimum": 1 }
+          }
+        },
+        "failure": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["consecutiveFailures", "windowMs"],
+          "properties": {
+            "consecutiveFailures": { "type": "integer", "minimum": 1 },
+            "windowMs": { "type": "integer", "minimum": 1 }
+          }
+        }
+      }
+    },
+    "InitPayload": {
+      "title": "InitPayload",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "instanceId",
+        "locale",
+        "theme",
+        "capabilities",
+        "resourceBudget"
+      ],
+      "properties": {
+        "instanceId": { "type": "string", "minLength": 1 },
+        "locale": { "type": "string", "minLength": 1 },
+        "theme": { "$ref": "#/$defs/Theme" },
+        "capabilities": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/GrantedCapability" }
+        },
+        "resourceBudget": { "$ref": "#/$defs/ResourceBudget" }
+      }
+    },
+    "BridgeEnvelopeBase": {
+      "title": "BridgeEnvelopeBase",
+      "type": "object",
+      "required": ["protocolVersion", "channelId", "messageId", "sequence"],
+      "properties": {
+        "protocolVersion": { "const": 1 },
+        "channelId": { "type": "string", "minLength": 16 },
+        "messageId": { "type": "string", "minLength": 1 },
+        "sequence": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "InitMessage": {
+      "title": "InitMessage",
+      "type": "object",
+      "allOf": [
+        { "$ref": "#/$defs/BridgeEnvelopeBase" },
+        {
+          "type": "object",
+          "required": ["type", "payload"],
+          "properties": {
+            "type": { "const": "init" },
+            "payload": { "$ref": "#/$defs/InitPayload" }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "RenderMessage": {
+      "title": "RenderMessage",
+      "type": "object",
+      "allOf": [
+        { "$ref": "#/$defs/BridgeEnvelopeBase" },
+        {
+          "type": "object",
+          "required": ["type", "payload"],
+          "properties": {
+            "type": { "enum": ["render", "update"] },
+            "payload": { "$ref": "#/$defs/RenderRequest" }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "CapabilityResultMessage": {
+      "title": "CapabilityResultMessage",
+      "type": "object",
+      "allOf": [
+        { "$ref": "#/$defs/BridgeEnvelopeBase" },
+        {
+          "type": "object",
+          "required": ["type", "payload"],
+          "properties": {
+            "type": { "const": "capability-result" },
+            "payload": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["requestId", "result"],
+              "properties": {
+                "requestId": { "type": "string", "minLength": 1 },
+                "result": { "$ref": "#/$defs/CapabilityResult" }
+              }
+            }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "ErrorMessage": {
+      "title": "ErrorMessage",
+      "type": "object",
+      "allOf": [
+        { "$ref": "#/$defs/BridgeEnvelopeBase" },
+        {
+          "type": "object",
+          "required": ["type", "payload"],
+          "properties": {
+            "type": { "const": "error" },
+            "payload": { "$ref": "#/$defs/WidgetError" }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "DisposeMessage": {
+      "title": "DisposeMessage",
+      "type": "object",
+      "allOf": [
+        { "$ref": "#/$defs/BridgeEnvelopeBase" },
+        {
+          "type": "object",
+          "required": ["type", "payload"],
+          "properties": {
+            "type": { "const": "dispose" },
+            "payload": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["reason", "deadlineMs"],
+              "properties": {
+                "reason": { "type": "string", "minLength": 1 },
+                "deadlineMs": { "type": "integer", "minimum": 1 }
+              }
+            }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "ReadyMessage": {
+      "title": "ReadyMessage",
+      "type": "object",
+      "allOf": [
+        { "$ref": "#/$defs/BridgeEnvelopeBase" },
+        {
+          "type": "object",
+          "required": ["type", "payload"],
+          "properties": {
+            "type": { "const": "ready" },
+            "payload": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["widgetSdkVersion", "hostApiVersion"],
+              "properties": {
+                "widgetSdkVersion": { "type": "string", "minLength": 1 },
+                "hostApiVersion": { "const": 1 }
+              }
+            }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "ResizeMessage": {
+      "title": "ResizeMessage",
+      "type": "object",
+      "allOf": [
+        { "$ref": "#/$defs/BridgeEnvelopeBase" },
+        {
+          "type": "object",
+          "required": ["type", "payload"],
+          "properties": {
+            "type": { "const": "resize" },
+            "payload": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["width", "height"],
+              "properties": {
+                "width": { "type": "number", "minimum": 0 },
+                "height": { "type": "number", "minimum": 0 }
+              }
+            }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "CapabilityRequestMessage": {
+      "title": "CapabilityRequestMessage",
+      "type": "object",
+      "allOf": [
+        { "$ref": "#/$defs/BridgeEnvelopeBase" },
+        {
+          "type": "object",
+          "required": ["type", "payload"],
+          "properties": {
+            "type": { "const": "capability-request" },
+            "payload": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["requestId", "request"],
+              "properties": {
+                "requestId": { "type": "string", "minLength": 1 },
+                "request": { "$ref": "#/$defs/CapabilityRequest" }
+              }
+            }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "HostToWidgetMessage": {
+      "title": "HostToWidgetMessage",
+      "oneOf": [
+        { "$ref": "#/$defs/InitMessage" },
+        { "$ref": "#/$defs/RenderMessage" },
+        { "$ref": "#/$defs/CapabilityResultMessage" },
+        { "$ref": "#/$defs/ErrorMessage" },
+        { "$ref": "#/$defs/DisposeMessage" }
+      ]
+    },
+    "WidgetToHostMessage": {
+      "title": "WidgetToHostMessage",
+      "oneOf": [
+        { "$ref": "#/$defs/ReadyMessage" },
+        { "$ref": "#/$defs/ResizeMessage" },
+        { "$ref": "#/$defs/CapabilityRequestMessage" },
+        { "$ref": "#/$defs/ErrorMessage" }
+      ]
+    },
+    "WidgetEvent": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "type",
+        "payload"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "type": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128,
+          "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$"
+        },
+        "payload": {
+          "$ref": "#/$defs/JsonValue"
+        }
+      }
+    },
+    "WidgetEventBatch": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schemaVersion",
+        "topic",
+        "cursor",
+        "reset",
+        "hasMore",
+        "events"
+      ],
+      "properties": {
+        "schemaVersion": {
+          "const": 1
+        },
+        "topic": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128,
+          "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$"
+        },
+        "cursor": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "reset": {
+          "type": "boolean"
+        },
+        "hasMore": {
+          "type": "boolean"
+        },
+        "events": {
+          "type": "array",
+          "maxItems": 100,
+          "items": {
+            "$ref": "#/$defs/WidgetEvent"
+          }
+        },
+        "snapshot": {
+          "$ref": "#/$defs/JsonValue"
+        }
+      }
+    },
+    "ToolLifecycleEvent": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "toolCallId",
+        "toolName",
+        "phase"
+      ],
+      "properties": {
+        "toolCallId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "toolName": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128,
+          "pattern": "^[A-Za-z0-9_.:-]+$"
+        },
+        "phase": {
+          "enum": [
+            "started",
+            "completed",
+            "failed",
+            "cancelled"
+          ]
+        }
+      }
+    }
+  }
+}