@dp-bohrium/widget-sdk 0.5.0 → 0.6.0

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

@@ -0,0 +1,2870 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "widget-runtime-contracts.schema.json",
+  "description": "Runtime 契约的汇总根容器；仅用于代码生成与符合性校验，不直接对外签发。",
+  "title": "Widget Runtime Contracts",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "widgetContributionKind",
+    "renderRequest",
+    "hostToWidgetMessage",
+    "widgetToHostMessage",
+    "capabilityRequest",
+    "capabilityResult",
+    "widgetError",
+    "resourceBudget"
+  ],
+  "properties": {
+    "widgetContributionKind": {
+      "$ref": "#/$defs/WidgetContributionKind"
+    },
+    "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"
+    },
+    "publicWidgetEvent": {
+      "$ref": "#/$defs/PublicWidgetEvent"
+    },
+    "widgetLiveEvent": {
+      "$ref": "#/$defs/WidgetLiveEvent"
+    },
+    "publicWidgetEventTopic": {
+      "$ref": "#/$defs/PublicWidgetEventTopic"
+    },
+    "widgetNetworkFetchOutput": {
+      "$ref": "#/$defs/WidgetNetworkFetchOutput"
+    },
+    "presentationCapabilityOutput": {
+      "$ref": "#/$defs/PresentationCapabilityOutput"
+    },
+    "presentationCapabilityResult": {
+      "$ref": "#/$defs/PresentationCapabilityResult"
+    },
+    "regionCapabilityResult": {
+      "$ref": "#/$defs/RegionCapabilityResult"
+    },
+    "fileDownloadResult": {
+      "$ref": "#/$defs/FileDownloadResult"
+    },
+    "fileReadResult": { "$ref": "#/$defs/FileReadResult" },
+    "fileWriteResult": { "$ref": "#/$defs/FileWriteResult" },
+    "taskObservationSnapshot": {
+      "$ref": "#/$defs/TaskObservationSnapshot"
+    },
+    "taskObservationEvent": {
+      "$ref": "#/$defs/TaskObservationEvent"
+    },
+    "taskObservationBatch": {
+      "$ref": "#/$defs/TaskObservationBatch"
+    },
+    "taskListField": {
+      "$ref": "#/$defs/TaskListField"
+    },
+    "taskListItem": {
+      "$ref": "#/$defs/TaskListItem"
+    },
+    "taskListPage": {
+      "$ref": "#/$defs/TaskListPage"
+    },
+    "toolResultEnvelope": {
+      "$ref": "#/$defs/ToolResultEnvelope"
+    },
+    "uiStateResult": {
+      "$ref": "#/$defs/UiStateResult"
+    },
+    "uiStateWriteResult": {
+      "$ref": "#/$defs/UiStateWriteResult"
+    },
+    "hostUserService": {
+      "$ref": "#/$defs/HostUserService"
+    },
+    "hostUserAction": {
+      "$ref": "#/$defs/HostUserAction"
+    },
+    "hostUserProfileReadInput": {
+      "$ref": "#/$defs/HostUserProfileReadInput"
+    },
+    "hostUserProfileReadOutput": {
+      "$ref": "#/$defs/HostUserProfileReadOutput"
+    },
+    "hostUserEmailReadInput": {
+      "$ref": "#/$defs/HostUserEmailReadInput"
+    },
+    "hostUserEmailReadOutput": {
+      "$ref": "#/$defs/HostUserEmailReadOutput"
+    },
+    "hostUserServiceRequest": {
+      "$ref": "#/$defs/HostUserServiceRequest"
+    }
+  },
+  "$defs": {
+    "JsonValue": {
+      "description": "可序列化为 JSON 的任意值；null / boolean / number / string / 数组 / 对象的递归联合。",
+      "title": "JsonValue",
+      "oneOf": [
+        { "type": "null" },
+        { "type": "boolean" },
+        { "type": "number" },
+        { "type": "string" },
+        { "type": "array", "items": { "$ref": "#/$defs/JsonValue" } },
+        {
+          "type": "object",
+          "additionalProperties": { "$ref": "#/$defs/JsonValue" }
+        }
+      ]
+    },
+    "HostUserPermission": {
+      "description": "Host 用户数据权限名：个人资料或邮箱读取。",
+      "title": "HostUserPermission",
+      "enum": ["host.user.profile.read", "host.user.email.read"]
+    },
+    "HostUserService": {
+      "description": "Host 用户服务标识；固定为 host.user。",
+      "title": "HostUserService",
+      "const": "host.user"
+    },
+    "HostUserAction": {
+      "description": "Host 用户服务下的具体动作：个人资料或邮箱读取。",
+      "title": "HostUserAction",
+      "enum": ["profile.read", "email.read"]
+    },
+    "HostUserProfileReadInput": {
+      "description": "读取用户资料的请求输入；当前无需额外参数（null）。",
+      "title": "HostUserProfileReadInput",
+      "type": "null"
+    },
+    "HostUserProfileReadOutput": {
+      "description": "读取用户资料的结果；含稳定 userId 与展示名。",
+      "title": "HostUserProfileReadOutput",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["userId", "displayName"],
+      "properties": {
+        "userId": { "type": "string", "minLength": 1 },
+        "displayName": { "type": "string", "minLength": 1 }
+      }
+    },
+    "HostUserEmailReadInput": {
+      "description": "读取用户邮箱的请求输入；当前无需额外参数（null）。",
+      "title": "HostUserEmailReadInput",
+      "type": "null"
+    },
+    "HostUserEmailReadOutput": {
+      "description": "读取用户邮箱的结果；email 为地址或 null。",
+      "title": "HostUserEmailReadOutput",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["email"],
+      "properties": {
+        "email": {
+          "oneOf": [
+            { "type": "string", "minLength": 3, "maxLength": 320 },
+            { "type": "null" }
+          ]
+        }
+      }
+    },
+    "HostUserServiceRequest": {
+      "description": "Host 用户服务请求；以 action 判别资料或邮箱读取。",
+      "title": "HostUserServiceRequest",
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["service", "action", "payload"],
+          "properties": {
+            "service": { "$ref": "#/$defs/HostUserService" },
+            "action": { "const": "profile.read" },
+            "payload": { "$ref": "#/$defs/HostUserProfileReadInput" }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["service", "action", "payload"],
+          "properties": {
+            "service": { "$ref": "#/$defs/HostUserService" },
+            "action": { "const": "email.read" },
+            "payload": { "$ref": "#/$defs/HostUserEmailReadInput" }
+          }
+        }
+      ]
+    },
+    "WidgetServicePermission": {
+      "description": "单条服务权限：服务名 + 允许的动作列表。",
+      "title": "WidgetServicePermission",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["service", "actions"],
+      "properties": {
+        "service": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128,
+          "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$"
+        },
+        "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_.:-]*$"
+          }
+        }
+      }
+    },
+    "WidgetServicePermissions": {
+      "description": "服务权限列表。",
+      "title": "WidgetServicePermissions",
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 32,
+      "uniqueItems": true,
+      "items": { "$ref": "#/$defs/WidgetServicePermission" }
+    },
+    "WidgetContributionKind": {
+      "description": "Runtime 内部枚举；Forge 外部 Manifest 可声明的 Surface 仅为 file-preview 与 panel。tool-result 仅供受信任的内部 Host、Agent 事件与协议验证，不得作为外部作者 Contribution。",
+      "title": "WidgetContributionKind",
+      "enum": ["tool-result", "file-preview", "panel"]
+    },
+    "RenderState": {
+      "description": "渲染状态：loading / partial / complete / error。",
+      "title": "RenderState",
+      "enum": ["loading", "partial", "complete", "error"]
+    },
+    "ThemeMode": {
+      "description": "主题模式：light 或 dark。",
+      "title": "ThemeMode",
+      "enum": ["light", "dark"]
+    },
+    "Theme": {
+      "description": "渲染上下文中的主题：mode 与设计令牌表。",
+      "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": {
+      "description": "Host 签发的文件引用；仅含不透明 id、可选内容版本和展示元数据。引用本身不授予写权限，不含路径或 URL。",
+      "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 },
+        "revision": { "$ref": "#/$defs/FileRevision" }
+      }
+    },
+    "FileRevision": {
+      "description": "由存储执行端签发的文件内容版本，用于条件读取和保存；不是 RenderRequest.revision。",
+      "title": "FileRevision",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 256
+    },
+    "FileMutationId": {
+      "description": "一次逻辑保存的稳定标识；重试或确认结果时必须复用，相同标识不得提交不同内容。",
+      "title": "FileMutationId",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$"
+    },
+    "FileReadInput": {
+      "description": "分块读取已授权文件；后续分块应携带首块返回的 expectedRevision，防止拼接不同版本。",
+      "title": "FileReadInput",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["file", "offset", "length", "encoding"],
+      "properties": {
+        "file": { "$ref": "#/$defs/FileReference" },
+        "offset": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
+        "length": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 },
+        "encoding": { "enum": ["utf8", "base64"] },
+        "expectedRevision": { "$ref": "#/$defs/FileRevision" }
+      }
+    },
+    "FileReadResult": {
+      "description": "文件读取结果；普通读取只要求内容与编码，原有游标和截断信息按 Host 能力返回。revision 可选且必须与本次读取的内容属于同一快照；请求 expectedRevision 时必须返回匹配版本。缺少 revision 的结果仅用于只读展示，不能据此条件保存。提供字节游标时 nextOffset 等于请求 offset + bytesRead，不按字符串长度计数。",
+      "title": "FileReadResult",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["content", "encoding"],
+      "properties": {
+        "content": { "type": "string" },
+        "encoding": { "enum": ["utf8", "base64"] },
+        "offset": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
+        "bytesRead": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
+        "nextOffset": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
+        "eof": { "type": "boolean" },
+        "truncated": { "type": "boolean" },
+        "revision": { "$ref": "#/$defs/FileRevision" }
+      }
+    },
+    "FileWriteInput": {
+      "description": "按 Host 授权范围对已有文件作整文件条件替换；Host 校验引用、作用域、权限和实际字节预算。超时不表示未写入，使用同一 mutationId 核对结果。",
+      "title": "FileWriteInput",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["file", "content", "encoding", "expectedRevision", "mutationId"],
+      "properties": {
+        "file": { "$ref": "#/$defs/FileReference" },
+        "content": { "type": "string" },
+        "encoding": { "enum": ["utf8", "base64"] },
+        "expectedRevision": { "$ref": "#/$defs/FileRevision" },
+        "mutationId": { "$ref": "#/$defs/FileMutationId" }
+      }
+    },
+    "FileWriteResult": {
+      "description": "执行端已确认持久化的保存回执；file.id 保持原文件引用身份，revision 是新内容版本。",
+      "title": "FileWriteResult",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["file", "revision", "bytesWritten", "mutationId"],
+      "properties": {
+        "file": { "$ref": "#/$defs/FileReference" },
+        "revision": { "$ref": "#/$defs/FileRevision" },
+        "bytesWritten": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
+        "mutationId": { "$ref": "#/$defs/FileMutationId" }
+      }
+    },
+    "FileDownloadResult": {
+      "description": "文件下载保存意图的结果：saved / started / cancelled。",
+      "title": "FileDownloadResult",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status"],
+      "properties": {
+        "status": {
+          "enum": ["saved", "started", "cancelled"]
+        }
+      }
+    },
+    "TaskStatus": {
+      "description": "Host 投影给 Widget 的统一任务状态。",
+      "title": "TaskStatus",
+      "enum": ["queued", "running", "succeeded", "failed", "cancelled", "expired"]
+    },
+    "TaskObservationSnapshot": {
+      "description": "任务观察的当前快照：taskId、status 与 updatedAt；progress、message 可选。",
+      "title": "TaskObservationSnapshot",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["taskId", "status", "updatedAt"],
+      "properties": {
+        "taskId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "status": { "$ref": "#/$defs/TaskStatus" },
+        "progress": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        },
+        "message": {
+          "type": "string",
+          "maxLength": 1024
+        },
+        "updatedAt": {
+          "type": "string",
+          "pattern": "^\\d{4}-\\d{2}-\\d{2}T[^ ]+Z$"
+        }
+      }
+    },
+    "TaskObservationEvent": {
+      "description": "任务观察流中的单条事件；payload 由服务端裁剪。",
+      "title": "TaskObservationEvent",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "type", "occurredAt", "payload"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "type": {
+          "enum": ["started", "progress", "succeeded", "failed", "cancelled", "expired"]
+        },
+        "occurredAt": {
+          "type": "string",
+          "pattern": "^\\d{4}-\\d{2}-\\d{2}T[^ ]+Z$"
+        },
+        "payload": {
+          "$ref": "#/$defs/JsonValue"
+        }
+      }
+    },
+    "TaskObservationBatch": {
+      "description": "任务观察的一页结果：快照 + 有限事件页 + 游标。",
+      "title": "TaskObservationBatch",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schemaVersion", "taskId", "cursor", "reset", "hasMore", "snapshot", "events"],
+      "properties": {
+        "schemaVersion": { "const": 1 },
+        "taskId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "cursor": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "reset": { "type": "boolean" },
+        "hasMore": { "type": "boolean" },
+        "snapshot": { "$ref": "#/$defs/TaskObservationSnapshot" },
+        "events": {
+          "type": "array",
+          "maxItems": 100,
+          "items": { "$ref": "#/$defs/TaskObservationEvent" }
+        }
+      }
+    },
+    "TaskListField": {
+      "description": "任务列表中的受限展示字段；key 是稳定机器键，value 是 Host 裁剪后的展示文本。",
+      "title": "TaskListField",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["key", "value"],
+      "properties": {
+        "key": {
+          "description": "展示字段的稳定机器键，例如 machine 或 command。",
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 64,
+          "pattern": "^[A-Za-z][A-Za-z0-9_.:-]*$"
+        },
+        "value": {
+          "description": "Host 完成授权与裁剪后的展示文本。",
+          "type": "string",
+          "maxLength": 16384
+        }
+      }
+    },
+    "TaskListItem": {
+      "description": "Host 已授权发现的任务摘要；taskId 是可继续传给 tasks.watch 的不透明引用。",
+      "title": "TaskListItem",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["taskId", "kind", "name", "status", "updatedAt", "fields"],
+      "properties": {
+        "taskId": {
+          "description": "可继续传给 tasks.watch 的 Host 不透明任务引用。",
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "kind": {
+          "description": "任务来源类型的稳定机器键。",
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 64,
+          "pattern": "^[A-Za-z][A-Za-z0-9_.:-]*$"
+        },
+        "name": {
+          "description": "任务的安全展示名称。",
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "status": {
+          "$ref": "#/$defs/TaskStatus"
+        },
+        "progress": {
+          "description": "可选执行进度，取值范围为 0 到 1。",
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        },
+        "message": {
+          "description": "Host 裁剪后的可选状态说明。",
+          "type": "string",
+          "maxLength": 1024
+        },
+        "updatedAt": {
+          "description": "任务摘要最后更新时间，使用 UTC ISO 8601 字符串。",
+          "type": "string",
+          "pattern": "^\\d{4}-\\d{2}-\\d{2}T[^ ]+Z$"
+        },
+        "fields": {
+          "description": "任务面板可展示的受限附加字段。",
+          "type": "array",
+          "maxItems": 32,
+          "items": { "$ref": "#/$defs/TaskListField" }
+        }
+      }
+    },
+    "TaskListPage": {
+      "description": "Host 已授权任务摘要的一页结果；nextCursor 缺失表示当前页已到末尾。",
+      "title": "TaskListPage",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schemaVersion", "tasks"],
+      "properties": {
+        "schemaVersion": {
+          "description": "任务列表页结构版本，当前固定为 1。",
+          "const": 1
+        },
+        "tasks": {
+          "description": "当前页中 Host 已授权的任务摘要。",
+          "type": "array",
+          "maxItems": 100,
+          "items": { "$ref": "#/$defs/TaskListItem" }
+        },
+        "nextCursor": {
+          "description": "下一页的不透明游标；缺失表示当前列表已到末尾。",
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512
+        }
+      }
+    },
+    "ToolResultMetric": {
+      "description": "工具结果中的单个指标。",
+      "title": "ToolResultMetric",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "value"],
+      "properties": {
+        "name": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "value": { "type": "number" },
+        "unit": { "type": "string", "maxLength": 64 },
+        "label": { "type": "string", "maxLength": 128 }
+      }
+    },
+    "ToolResultArtifact": {
+      "description": "工具结果中的产物元数据，不含内容本身。",
+      "title": "ToolResultArtifact",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "name"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "name": { "type": "string", "minLength": 1, "maxLength": 255 },
+        "kind": { "enum": ["file", "directory"] },
+        "mimeType": { "type": "string", "minLength": 1, "maxLength": 255 },
+        "size": { "type": "integer", "minimum": 0 },
+        "downloadable": { "type": "boolean" }
+      }
+    },
+    "ToolResultProvenance": {
+      "description": "工具结果的来源信息。",
+      "title": "ToolResultProvenance",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["source"],
+      "properties": {
+        "source": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "kind": { "type": "string", "minLength": 1, "maxLength": 64 },
+        "label": { "type": "string", "maxLength": 256 }
+      }
+    },
+    "ToolResultNotice": {
+      "description": "工具结果中的提示或警告。",
+      "title": "ToolResultNotice",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code", "message"],
+      "properties": {
+        "code": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "message": { "type": "string", "minLength": 1, "maxLength": 1024 }
+      }
+    },
+    "ToolResultEnvelope": {
+      "description": "工具执行结果信封；仅供受信任的内部 Host 与 Agent 事件，不进入作者 Contribution。",
+      "title": "ToolResultEnvelope",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schemaVersion", "status"],
+      "properties": {
+        "schemaVersion": { "const": 1 },
+        "status": { "enum": ["running", "succeeded", "failed", "cancelled"] },
+        "summary": { "type": "string", "maxLength": 2048 },
+        "data": { "$ref": "#/$defs/JsonValue" },
+        "metrics": {
+          "type": "array",
+          "maxItems": 64,
+          "items": { "$ref": "#/$defs/ToolResultMetric" }
+        },
+        "artifacts": {
+          "type": "array",
+          "maxItems": 64,
+          "items": { "$ref": "#/$defs/ToolResultArtifact" }
+        },
+        "provenance": {
+          "type": "array",
+          "maxItems": 32,
+          "items": { "$ref": "#/$defs/ToolResultProvenance" }
+        },
+        "warnings": {
+          "type": "array",
+          "maxItems": 32,
+          "items": { "$ref": "#/$defs/ToolResultNotice" }
+        },
+        "missing": {
+          "type": "array",
+          "maxItems": 32,
+          "items": { "$ref": "#/$defs/ToolResultNotice" }
+        }
+      }
+    },
+    "UiStateResult": {
+      "description": "受限 UI 状态读取结果。",
+      "title": "UiStateResult",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["found"],
+      "properties": {
+        "found": { "type": "boolean" },
+        "value": { "$ref": "#/$defs/JsonValue" }
+      }
+    },
+    "UiStateWriteResult": {
+      "description": "受限 UI 状态写入结果。",
+      "title": "UiStateWriteResult",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status"],
+      "properties": { "status": { "const": "saved" } }
+    },
+    "GrantedCapability": {
+      "description": "Host 已授予的能力；多数分支附带调用与预算限制（ui.presentation / ui.region 除外）。",
+      "title": "GrantedCapability",
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["name", "services", "limits"],
+          "properties": {
+            "name": { "const": "service.invoke" },
+            "services": { "$ref": "#/$defs/WidgetServicePermissions" },
+            "limits": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["callsPerMinute", "requestBytes", "responseBytes"],
+              "properties": {
+                "callsPerMinute": { "type": "integer", "minimum": 1 },
+                "requestBytes": { "type": "integer", "minimum": 1 },
+                "responseBytes": { "type": "integer", "minimum": 1 }
+              }
+            }
+          }
+        },
+        {
+          "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.download"
+            },
+            "limits": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "bytesPerRun",
+                "callsPerMinute"
+              ],
+              "properties": {
+                "bytesPerRun": {
+                  "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", "limits"],
+          "properties": {
+            "name": { "const": "files.write" },
+            "limits": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["bytesPerRequest", "bytesPerRun", "callsPerMinute"],
+              "properties": {
+                "bytesPerRequest": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 },
+                "bytesPerRun": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 },
+                "callsPerMinute": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }
+              }
+            }
+          }
+        },
+        {
+          "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", "limits"],
+          "properties": {
+            "name": { "const": "tasks.list" },
+            "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", "limits"],
+          "properties": {
+            "name": { "const": "tasks.watch" },
+            "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", "limits"],
+          "properties": {
+            "name": { "const": "ui.state" },
+            "limits": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["callsPerMinute", "bytesPerRun", "maxValueBytes"],
+              "properties": {
+                "callsPerMinute": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 },
+                "bytesPerRun": { "type": "integer", "minimum": 1, "maximum": 1048576 },
+                "maxValueBytes": { "type": "integer", "minimum": 1, "maximum": 262144 }
+              }
+            }
+          }
+        },
+        {
+          "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" },
+        { "$ref": "#/$defs/GrantedRegionCapability" }
+      ]
+    },
+    "GrantedRegionCapability": {
+      "description": "已授予的会话右侧区域替换能力。",
+      "title": "GrantedRegionCapability",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "regions", "mode", "requiresHostConfirmation"],
+      "properties": {
+        "name": { "const": "ui.region" },
+        "regions": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 1,
+          "uniqueItems": true,
+          "items": { "const": "session.rightRail" }
+        },
+        "mode": { "const": "replace" },
+        "requiresHostConfirmation": { "const": true }
+      }
+    },
+    "GrantedPresentationCapability": {
+      "description": "已授予的呈现能力；含 surfaces，requiresHostConfirmation 恒为 true。",
+      "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": {
+      "description": "渲染上下文：locale、theme、viewport、能力与关联 id。",
+      "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": {
+      "description": "tool-result 渲染内容；仅内部通道使用，外部作者不挂载。",
+      "title": "ToolResultContent",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["contribution", "tool", "input"],
+      "properties": {
+        "contribution": { "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" },
+        "envelope": { "$ref": "#/$defs/ToolResultEnvelope" },
+        "error": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["code", "message"],
+          "properties": {
+            "code": { "type": "string", "minLength": 1 },
+            "message": { "type": "string", "minLength": 1 }
+          }
+        }
+      }
+    },
+    "FilePreviewContent": {
+      "description": "文件预览内容；contribution 必须为 file-preview。",
+      "title": "FilePreviewContent",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["contribution", "file"],
+      "properties": {
+        "contribution": { "const": "file-preview" },
+        "file": { "$ref": "#/$defs/FileReference" },
+        "preview": { "$ref": "#/$defs/JsonValue" }
+      }
+    },
+    "PanelContent": {
+      "description": "面板内容；contribution 必须为 panel。",
+      "title": "PanelContent",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["contribution", "id", "data"],
+      "properties": {
+        "contribution": { "const": "panel" },
+        "id": { "type": "string", "minLength": 1 },
+        "title": { "type": "string" },
+        "data": { "$ref": "#/$defs/JsonValue" }
+      }
+    },
+    "RenderRequestBase": {
+      "description": "渲染请求公共字段：schemaVersion、requestId、instanceId、revision、state、context。",
+      "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": {
+      "description": "历史 Host 投影类型；仅供受信任的内部 Host 与协议验证。Forge 新插件不得声明或挂载 tool-result，工具结果应由 Runtime 逻辑映射到自定义 Panel。",
+      "title": "ToolResultRenderRequest",
+      "type": "object",
+      "allOf": [
+        { "$ref": "#/$defs/RenderRequestBase" },
+        {
+          "type": "object",
+          "required": ["contribution", "content"],
+          "properties": {
+            "contribution": { "const": "tool-result" },
+            "content": { "$ref": "#/$defs/ToolResultContent" }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "FilePreviewRenderRequest": {
+      "description": "文件预览渲染请求：公共字段 + contribution=file-preview + content。",
+      "title": "FilePreviewRenderRequest",
+      "type": "object",
+      "allOf": [
+        { "$ref": "#/$defs/RenderRequestBase" },
+        {
+          "type": "object",
+          "required": ["contribution", "content"],
+          "properties": {
+            "contribution": { "const": "file-preview" },
+            "content": { "$ref": "#/$defs/FilePreviewContent" }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "PanelRenderRequest": {
+      "description": "面板渲染请求：公共字段 + contribution=panel + content。",
+      "title": "PanelRenderRequest",
+      "type": "object",
+      "allOf": [
+        { "$ref": "#/$defs/RenderRequestBase" },
+        {
+          "type": "object",
+          "required": ["contribution", "content"],
+          "properties": {
+            "contribution": { "const": "panel" },
+            "content": { "$ref": "#/$defs/PanelContent" }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "RenderRequest": {
+      "description": "完整渲染请求联合：tool-result（内部）/ file-preview / panel。",
+      "title": "RenderRequest",
+      "oneOf": [
+        { "$ref": "#/$defs/ToolResultRenderRequest" },
+        { "$ref": "#/$defs/FilePreviewRenderRequest" },
+        { "$ref": "#/$defs/PanelRenderRequest" }
+      ]
+    },
+    "CapabilityRequest": {
+      "description": "Widget 发起的能力请求；以 operation 判别语义与 input。",
+      "title": "CapabilityRequest",
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["operation", "input"],
+          "properties": {
+            "operation": { "const": "service.invoke" },
+            "input": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["service", "action", "payload"],
+              "properties": {
+                "service": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 128,
+                  "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$"
+                },
+                "action": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 128,
+                  "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$"
+                },
+                "payload": { "$ref": "#/$defs/JsonValue" }
+              }
+            }
+          }
+        },
+        {
+          "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": { "$ref": "#/$defs/FileReadInput" }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["operation", "input"],
+          "properties": {
+            "operation": { "const": "files.write" },
+            "input": { "$ref": "#/$defs/FileWriteInput" }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "operation",
+            "input"
+          ],
+          "properties": {
+            "operation": {
+              "const": "files.download"
+            },
+            "input": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["file", "suggestedName"],
+              "properties": {
+                "file": { "$ref": "#/$defs/FileReference" },
+                "suggestedName": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 255,
+                  "pattern": "^[^\\\\/\\u0000-\\u001f]+$"
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["operation", "input"],
+          "properties": {
+            "operation": { "const": "tasks.list" },
+            "input": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "cursor": { "type": "string", "minLength": 1, "maxLength": 512 },
+                "limit": { "type": "integer", "minimum": 1, "maximum": 100 }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["operation", "input"],
+          "properties": {
+            "operation": { "const": "tasks.watch" },
+            "input": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["taskId"],
+              "properties": {
+                "taskId": { "type": "string", "minLength": 1, "maxLength": 256 },
+                "cursor": { "type": "string", "minLength": 1, "maxLength": 256 },
+                "limit": { "type": "integer", "minimum": 1, "maximum": 100 }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["operation", "input"],
+          "properties": {
+            "operation": { "const": "ui.state" },
+            "input": {
+              "oneOf": [
+                {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": ["action", "key"],
+                  "properties": {
+                    "action": { "const": "read" },
+                    "key": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9_.:-]+$" }
+                  }
+                },
+                {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": ["action", "key", "value"],
+                  "properties": {
+                    "action": { "const": "write" },
+                    "key": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9_.:-]+$" },
+                    "value": { "$ref": "#/$defs/JsonValue" }
+                  }
+                }
+              ]
+            }
+          }
+        },
+        {
+          "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" },
+        { "$ref": "#/$defs/RegionCapabilityRequest" }
+      ]
+    },
+    "RegionCapabilityRequest": {
+      "description": "区域能力请求：acquire 或 release。",
+      "title": "RegionCapabilityRequest",
+      "type": "object",
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["operation", "input"],
+          "properties": {
+            "operation": { "const": "ui.region" },
+            "input": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["action", "region"],
+              "properties": {
+                "action": { "const": "acquire" },
+                "region": { "const": "session.rightRail" }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["operation", "input"],
+          "properties": {
+            "operation": { "const": "ui.region" },
+            "input": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["action"],
+              "properties": { "action": { "const": "release" } }
+            }
+          }
+        }
+      ]
+    },
+    "PresentationCapabilityRequest": {
+      "description": "呈现能力请求：present / change-surface、close，或 focus-boundary。",
+      "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": {
+      "description": "呈现焦点边界请求：forward 或 backward。",
+      "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": {
+      "description": "Host 托管网络的限制项：超时、并发、频率与字节数。",
+      "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": {
+      "description": "正整数。",
+      "title": "PositiveInteger",
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 9007199254740991
+    },
+    "NetworkHeaders": {
+      "description": "HTTP 响应头集合。",
+      "title": "NetworkHeaders",
+      "type": "object",
+      "maxProperties": 64,
+      "propertyNames": {
+        "pattern": "^[!#$%&'*+.^_`|~0-9A-Za-z-]+$"
+      },
+      "additionalProperties": {
+        "type": "string",
+        "maxLength": 16384
+      }
+    },
+    "WidgetNetworkRequestHeaders": {
+      "description": "Widget 发起网络请求时附加的请求头集合。",
+      "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": {
+      "description": "Host 托管网络请求输入；url 由 Host 校验，auth 声明凭据需求。",
+      "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": {
+      "description": "Host 托管网络请求结果；body 按 bodyEncoding 解释。",
+      "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": {
+      "description": "呈现能力输出：present / change-surface / focus-boundary / close。",
+      "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": {
+      "description": "呈现能力请求的结果。",
+      "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" }
+          }
+        }
+      ]
+    },
+    "RegionCapabilityResult": {
+      "description": "区域能力请求的结果；成功时含不透明 leaseId。",
+      "title": "RegionCapabilityResult",
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["ok", "data"],
+          "properties": {
+            "ok": { "const": true },
+            "data": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["action", "region", "mode"],
+              "properties": {
+                "action": { "enum": ["acquire", "release"] },
+                "region": { "const": "session.rightRail" },
+                "mode": { "const": "replace" },
+                "leaseId": { "type": "string", "minLength": 1, "maxLength": 256 }
+              }
+            }
+          }
+        },
+        {
+          "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"
+              ]
+            },
+            "message": { "type": "string", "minLength": 1 },
+            "retryable": { "type": "boolean" }
+          }
+        }
+      ]
+    },
+    "CapabilityResult": {
+      "description": "能力请求结果：成功时带 data，失败时带 reason / message / retryable。",
+      "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",
+                "revision-conflict",
+                "mutation-conflict",
+                "write-outcome-unknown"
+              ]
+            },
+            "message": { "type": "string", "minLength": 1 },
+            "retryable": { "type": "boolean" }
+          }
+        }
+      ]
+    },
+    "WidgetError": {
+      "description": "结构化稳定错误：code + phase + message + retryable + correlationId。",
+      "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": {
+      "description": "Host 为当前运行签发的资源预算：包、Bridge、文件、超时、并发、重试与失败。",
+      "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 },
+            "writeBytesPerRequest": {
+              "description": "写入单次原始字节上限；未签发时不得授权 files.write。",
+              "type": "integer", "minimum": 1, "maximum": 9007199254740991
+            },
+            "writeBytesPerRun": {
+              "description": "当前运行的累计写入原始字节上限；未签发时不得授权 files.write。",
+              "type": "integer", "minimum": 1, "maximum": 9007199254740991
+            }
+          }
+        },
+        "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": {
+      "description": "init 消息负载：实例、locale、theme、能力与资源预算。",
+      "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": {
+      "description": "Bridge 信封公共字段：protocolVersion、channelId、messageId、sequence。",
+      "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": {
+      "description": "Host 下发初始上下文的 Bridge 消息。",
+      "title": "InitMessage",
+      "type": "object",
+      "allOf": [
+        { "$ref": "#/$defs/BridgeEnvelopeBase" },
+        {
+          "type": "object",
+          "required": ["type", "payload"],
+          "properties": {
+            "type": { "const": "init" },
+            "payload": { "$ref": "#/$defs/InitPayload" }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "RenderMessage": {
+      "description": "Host 下发完整渲染快照的 Bridge 消息；type 为 render 或 update。",
+      "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": {
+      "description": "Host 返回能力请求结果的 Bridge 消息。",
+      "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": {
+      "description": "任一方向的结构化错误 Bridge 消息。",
+      "title": "ErrorMessage",
+      "type": "object",
+      "allOf": [
+        { "$ref": "#/$defs/BridgeEnvelopeBase" },
+        {
+          "type": "object",
+          "required": ["type", "payload"],
+          "properties": {
+            "type": { "const": "error" },
+            "payload": { "$ref": "#/$defs/WidgetError" }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "DisposeMessage": {
+      "description": "Host 通知销毁实例的终态 Bridge 消息。",
+      "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": {
+      "description": "Widget 向 Host 上报就绪的 Bridge 消息；含 SDK 与 Host API 版本。",
+      "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": {
+      "description": "Widget 请求调整视口尺寸的 Bridge 消息。",
+      "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": {
+      "description": "Widget 发起能力请求的 Bridge 消息。",
+      "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": {
+      "description": "Host → Widget 的 Bridge 消息联合。",
+      "title": "HostToWidgetMessage",
+      "oneOf": [
+        { "$ref": "#/$defs/InitMessage" },
+        { "$ref": "#/$defs/RenderMessage" },
+        { "$ref": "#/$defs/WidgetEventMessage" },
+        { "$ref": "#/$defs/CapabilityResultMessage" },
+        { "$ref": "#/$defs/ErrorMessage" },
+        { "$ref": "#/$defs/DisposeMessage" }
+      ]
+    },
+    "WidgetToHostMessage": {
+      "description": "Widget → Host 的 Bridge 消息联合。",
+      "title": "WidgetToHostMessage",
+      "oneOf": [
+        { "$ref": "#/$defs/ReadyMessage" },
+        { "$ref": "#/$defs/ResizeMessage" },
+        { "$ref": "#/$defs/CapabilityRequestMessage" },
+        { "$ref": "#/$defs/ErrorMessage" }
+      ]
+    },
+    "PublicWidgetEventTopic": {
+      "title": "PublicWidgetEventTopic",
+      "description": "Agent Widget 从当前 Workflow 流公开的事件主题。",
+      "enum": [
+        "workflow.lifecycle",
+        "tools.lifecycle",
+        "approval.lifecycle",
+        "interaction.lifecycle"
+      ]
+    },
+    "PublicWidgetEvent": {
+      "title": "PublicWidgetEvent",
+      "description": "Agent Widget 从已解析 Workflow 事件构造并向 Widget Runtime 推送的事件联合。",
+      "oneOf": [
+        { "$ref": "#/$defs/WorkflowStartedPublicWidgetEvent" },
+        { "$ref": "#/$defs/WorkflowDonePublicWidgetEvent" },
+        { "$ref": "#/$defs/WorkflowErrorPublicWidgetEvent" },
+        { "$ref": "#/$defs/ToolCallPublicWidgetEvent" },
+        { "$ref": "#/$defs/ToolResultPublicWidgetEvent" },
+        { "$ref": "#/$defs/SandboxApprovalRequestedPublicWidgetEvent" },
+        { "$ref": "#/$defs/SandboxApprovedPublicWidgetEvent" },
+        { "$ref": "#/$defs/SandboxDeniedPublicWidgetEvent" },
+        { "$ref": "#/$defs/UserInputRequestedPublicWidgetEvent" },
+        { "$ref": "#/$defs/ComputeReviewRequestedPublicWidgetEvent" }
+      ]
+    },
+    "WidgetLiveEvent": {
+      "title": "WidgetLiveEvent",
+      "description": "Host 从当前 Runtime 向 iframe 主动推送的聚合事件；事件由 type 唯一标识。",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type", "payload"],
+      "properties": {
+        "type": {
+          "$ref": "#/$defs/WidgetEventName"
+        },
+        "payload": {
+          "type": "object",
+          "additionalProperties": { "$ref": "#/$defs/JsonValue" }
+        }
+      }
+    },
+    "WidgetEventName": {
+      "title": "WidgetEventName",
+      "description": "已激活 Widget 可监听的实时事件；session.start 只用于激活，不在此列。",
+      "type": "string",
+      "enum": [
+        "turn-start",
+        "turn-end",
+        "step-start",
+        "step-end",
+        "tool-call-generating",
+        "tool-call-waiting",
+        "tool-call-running",
+        "tool-call-result",
+        "tool-call-error",
+        "workspace-file-changed",
+        "workspace-tree-refresh",
+        "workspace-file-opened",
+        "ui-tool-opened",
+        "ui-panel-focused",
+        "host-surface-changed"
+      ]
+    },
+    "PublicWidgetEventId": {
+      "title": "PublicWidgetEventId",
+      "description": "用于同一 Agent Widget Runtime 内去重的稳定事件标识。",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 256
+    },
+    "PublicWidgetSessionId": {
+      "title": "PublicWidgetSessionId",
+      "description": "事件所属的 Session 标识。",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 256
+    },
+    "PublicWidgetWorkflowId": {
+      "title": "PublicWidgetWorkflowId",
+      "description": "事件所属的 Workflow 标识。",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 256
+    },
+    "PublicWidgetEventOccurredAt": {
+      "title": "PublicWidgetEventOccurredAt",
+      "description": "事件产生时间：YYYY-MM-DD + T + 非空格字符，以 Z 结尾。",
+      "type": "string",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}T[^ ]+Z$"
+    },
+    "WorkflowStartedPublicWidgetEventPayload": {
+      "title": "WorkflowStartedPublicWidgetEventPayload",
+      "description": "Workflow 流已建立时公开的数据。",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["protocolVersion"],
+      "properties": {
+        "protocolVersion": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "EmptyPublicWidgetEventPayload": {
+      "title": "EmptyPublicWidgetEventPayload",
+      "description": "没有额外业务字段的事件负载。",
+      "type": "object",
+      "additionalProperties": false
+    },
+    "WorkflowDonePublicWidgetEventPayload": {
+      "title": "WorkflowDonePublicWidgetEventPayload",
+      "description": "Workflow 正常结束时公开的数据。",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status"],
+      "properties": {
+        "status": { "enum": ["completed", "failed", "cancelled", "expired"] },
+        "durationMs": { "type": "number", "minimum": 0 },
+        "error": { "type": "string" }
+      }
+    },
+    "WorkflowErrorPublicWidgetEventPayload": {
+      "title": "WorkflowErrorPublicWidgetEventPayload",
+      "description": "Workflow 错误事件公开的数据。",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["terminal"],
+      "properties": {
+        "terminal": { "type": "boolean" },
+        "error": { "type": "string" }
+      }
+    },
+    "ToolCallPublicWidgetEventPayload": {
+      "title": "ToolCallPublicWidgetEventPayload",
+      "description": "tool-call 原始语义对应的公开数据。",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["toolCallId", "toolName"],
+      "properties": {
+        "toolCallId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "toolName": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128,
+          "pattern": "^[A-Za-z0-9_.:-]+$"
+        },
+        "args": { "$ref": "#/$defs/JsonValue" },
+        "executionState": { "enum": ["waiting", "running"] }
+      }
+    },
+    "ToolResultPublicWidgetEventPayload": {
+      "title": "ToolResultPublicWidgetEventPayload",
+      "description": "tool-result 原始语义对应的公开数据。",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["toolCallId", "output"],
+      "properties": {
+        "toolCallId": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "toolName": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128,
+          "pattern": "^[A-Za-z0-9_.:-]+$"
+        },
+        "output": { "$ref": "#/$defs/JsonValue" },
+        "durationMs": { "type": "number", "minimum": 0 }
+      }
+    },
+    "SandboxApprovalRequestedPublicWidgetEventPayload": {
+      "title": "SandboxApprovalRequestedPublicWidgetEventPayload",
+      "description": "沙盒审批请求公开的数据。",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["approvalId", "mode"],
+      "properties": {
+        "approvalId": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "mode": { "enum": ["create", "reuse"] },
+        "sandboxName": { "type": "string" },
+        "resource": { "$ref": "#/$defs/JsonValue" },
+        "existingSandboxes": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["id", "name"],
+            "properties": {
+              "id": { "type": "string", "minLength": 1 },
+              "name": { "type": "string", "minLength": 1 }
+            }
+          }
+        },
+        "proxyAgentName": { "type": "string" }
+      }
+    },
+    "SandboxApprovedPublicWidgetEventPayload": {
+      "title": "SandboxApprovedPublicWidgetEventPayload",
+      "description": "沙盒审批通过时公开的数据。",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["sandboxId"],
+      "properties": {
+        "sandboxId": { "type": "string", "minLength": 1, "maxLength": 256 }
+      }
+    },
+    "UserInputRequestedPublicWidgetEventPayload": {
+      "title": "UserInputRequestedPublicWidgetEventPayload",
+      "description": "用户输入请求公开的数据。",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "toolCallId": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "requestId": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "request": { "$ref": "#/$defs/JsonValue" },
+        "schema": { "$ref": "#/$defs/JsonValue" },
+        "title": { "type": "string" },
+        "description": { "type": "string" },
+        "retryAttempt": { "type": "integer", "minimum": 0 },
+        "retryMessage": { "type": "string" },
+        "cancellable": { "type": "boolean" },
+        "timeoutSeconds": { "type": "number", "minimum": 0 },
+        "proxyWorkflowId": { "type": "string" },
+        "proxyAgentName": { "type": "string" }
+      }
+    },
+    "ComputeReviewRequestedPublicWidgetEventPayload": {
+      "title": "ComputeReviewRequestedPublicWidgetEventPayload",
+      "description": "计算任务审批请求公开的数据。",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["draftId", "toolCallId"],
+      "properties": {
+        "draftId": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "toolCallId": { "type": "string", "minLength": 1, "maxLength": 256 }
+      }
+    },
+    "PublicWidgetEventBase": {
+      "description": "公开事件公共字段：schemaVersion、id、occurredAt、sessionId、workflowId。",
+      "title": "PublicWidgetEventBase",
+      "type": "object",
+      "required": [
+        "schemaVersion",
+        "id",
+        "occurredAt",
+        "sessionId",
+        "workflowId"
+      ],
+      "properties": {
+        "schemaVersion": { "const": 1 },
+        "id": { "$ref": "#/$defs/PublicWidgetEventId" },
+        "occurredAt": { "$ref": "#/$defs/PublicWidgetEventOccurredAt" },
+        "sessionId": { "$ref": "#/$defs/PublicWidgetSessionId" },
+        "workflowId": { "$ref": "#/$defs/PublicWidgetWorkflowId" }
+      }
+    },
+    "WorkflowStartedPublicWidgetEvent": {
+      "title": "WorkflowStartedPublicWidgetEvent",
+      "description": "Workflow 流建立事件。",
+      "type": "object",
+      "allOf": [
+        { "$ref": "#/$defs/PublicWidgetEventBase" },
+        {
+          "type": "object",
+          "required": ["topic", "type", "payload"],
+          "properties": {
+            "topic": { "const": "workflow.lifecycle" },
+            "type": { "const": "connected" },
+            "payload": { "$ref": "#/$defs/WorkflowStartedPublicWidgetEventPayload" }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "WorkflowDonePublicWidgetEvent": {
+      "title": "WorkflowDonePublicWidgetEvent",
+      "description": "Workflow 正常终态事件。",
+      "type": "object",
+      "allOf": [
+        { "$ref": "#/$defs/PublicWidgetEventBase" },
+        {
+          "type": "object",
+          "required": ["topic", "type", "payload"],
+          "properties": {
+            "topic": { "const": "workflow.lifecycle" },
+            "type": { "const": "done" },
+            "payload": { "$ref": "#/$defs/WorkflowDonePublicWidgetEventPayload" }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "WorkflowErrorPublicWidgetEvent": {
+      "title": "WorkflowErrorPublicWidgetEvent",
+      "description": "Workflow 错误事件。",
+      "type": "object",
+      "allOf": [
+        { "$ref": "#/$defs/PublicWidgetEventBase" },
+        {
+          "type": "object",
+          "required": ["topic", "type", "payload"],
+          "properties": {
+            "topic": { "const": "workflow.lifecycle" },
+            "type": { "const": "error" },
+            "payload": { "$ref": "#/$defs/WorkflowErrorPublicWidgetEventPayload" }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "ToolCallPublicWidgetEvent": {
+      "title": "ToolCallPublicWidgetEvent",
+      "description": "tool-call 事件。",
+      "type": "object",
+      "allOf": [
+        { "$ref": "#/$defs/PublicWidgetEventBase" },
+        {
+          "type": "object",
+          "required": ["topic", "type", "payload"],
+          "properties": {
+            "topic": { "const": "tools.lifecycle" },
+            "type": { "const": "tool-call" },
+            "payload": { "$ref": "#/$defs/ToolCallPublicWidgetEventPayload" }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "ToolResultPublicWidgetEvent": {
+      "title": "ToolResultPublicWidgetEvent",
+      "description": "tool-result 事件。",
+      "type": "object",
+      "allOf": [
+        { "$ref": "#/$defs/PublicWidgetEventBase" },
+        {
+          "type": "object",
+          "required": ["topic", "type", "payload"],
+          "properties": {
+            "topic": { "const": "tools.lifecycle" },
+            "type": { "const": "tool-result" },
+            "payload": { "$ref": "#/$defs/ToolResultPublicWidgetEventPayload" }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "SandboxApprovalRequestedPublicWidgetEvent": {
+      "title": "SandboxApprovalRequestedPublicWidgetEvent",
+      "description": "sandbox-approval-requested 事件。",
+      "type": "object",
+      "allOf": [
+        { "$ref": "#/$defs/PublicWidgetEventBase" },
+        {
+          "type": "object",
+          "required": ["topic", "type", "payload"],
+          "properties": {
+            "topic": { "const": "approval.lifecycle" },
+            "type": { "const": "sandbox-approval-requested" },
+            "payload": { "$ref": "#/$defs/SandboxApprovalRequestedPublicWidgetEventPayload" }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "SandboxApprovedPublicWidgetEvent": {
+      "title": "SandboxApprovedPublicWidgetEvent",
+      "description": "sandbox-approved 事件。",
+      "type": "object",
+      "allOf": [
+        { "$ref": "#/$defs/PublicWidgetEventBase" },
+        {
+          "type": "object",
+          "required": ["topic", "type", "payload"],
+          "properties": {
+            "topic": { "const": "approval.lifecycle" },
+            "type": { "const": "sandbox-approved" },
+            "payload": { "$ref": "#/$defs/SandboxApprovedPublicWidgetEventPayload" }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "SandboxDeniedPublicWidgetEvent": {
+      "title": "SandboxDeniedPublicWidgetEvent",
+      "description": "sandbox-denied 事件。",
+      "type": "object",
+      "allOf": [
+        { "$ref": "#/$defs/PublicWidgetEventBase" },
+        {
+          "type": "object",
+          "required": ["topic", "type", "payload"],
+          "properties": {
+            "topic": { "const": "approval.lifecycle" },
+            "type": { "const": "sandbox-denied" },
+            "payload": { "$ref": "#/$defs/EmptyPublicWidgetEventPayload" }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "UserInputRequestedPublicWidgetEvent": {
+      "title": "UserInputRequestedPublicWidgetEvent",
+      "description": "user-input-requested 事件。",
+      "type": "object",
+      "allOf": [
+        { "$ref": "#/$defs/PublicWidgetEventBase" },
+        {
+          "type": "object",
+          "required": ["topic", "type", "payload"],
+          "properties": {
+            "topic": { "const": "interaction.lifecycle" },
+            "type": { "const": "user-input-requested" },
+            "payload": { "$ref": "#/$defs/UserInputRequestedPublicWidgetEventPayload" }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "ComputeReviewRequestedPublicWidgetEvent": {
+      "title": "ComputeReviewRequestedPublicWidgetEvent",
+      "description": "compute-review-requested 事件。",
+      "type": "object",
+      "allOf": [
+        { "$ref": "#/$defs/PublicWidgetEventBase" },
+        {
+          "type": "object",
+          "required": ["topic", "type", "payload"],
+          "properties": {
+            "topic": { "const": "interaction.lifecycle" },
+            "type": { "const": "compute-review-requested" },
+            "payload": { "$ref": "#/$defs/ComputeReviewRequestedPublicWidgetEventPayload" }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "WidgetEventMessage": {
+      "title": "WidgetEventMessage",
+      "description": "Host 通过当前 Widget MessageChannel 主动推送的 Workflow 事件。",
+      "type": "object",
+      "allOf": [
+        { "$ref": "#/$defs/BridgeEnvelopeBase" },
+        {
+          "type": "object",
+          "required": ["type", "payload"],
+          "properties": {
+            "type": { "const": "event" },
+            "payload": { "$ref": "#/$defs/WidgetLiveEvent" }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "WidgetEvent": {
+      "description": "低层 events.read 事件页中的单条原始事件；type 为受限标识、payload 为 JSON。",
+      "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": {
+      "description": "低层 events.read 的一页事件：topic、cursor、reset、hasMore 与事件列表。",
+      "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": {
+      "description": "工具生命周期事件：started / completed / failed / cancelled。",
+      "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"
+          ]
+        }
+      }
+    }
+  }
+}