@dp-bohrium/widget-cli 0.5.1 → 0.7.0

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

@@ -72,24 +72,6 @@
     },
     "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"
     },
@@ -119,6 +101,28 @@
     },
     "hostUserServiceRequest": {
       "$ref": "#/$defs/HostUserServiceRequest"
+    },
+    "widgetDevelopmentDiagnostic": {
+      "$ref": "#/$defs/WidgetDevelopmentDiagnostic"
+    },
+    "widgetRecoveryContext": { "$ref": "#/$defs/WidgetRecoveryContext" },
+    "widgetRecoveryPlan": {
+      "$ref": "#/$defs/WidgetRecoveryPlan"
+    },
+    "widgetRecoveryRule": {
+      "$ref": "#/$defs/WidgetRecoveryRule"
+    },
+    "widgetDevelopmentOffer": {
+      "$ref": "#/$defs/WidgetDevelopmentOffer"
+    },
+    "widgetDevelopmentConnect": {
+      "$ref": "#/$defs/WidgetDevelopmentConnect"
+    },
+    "widgetRenderResult": {
+      "$ref": "#/$defs/WidgetRenderResult"
+    },
+    "widgetDevelopmentMessage": {
+      "$ref": "#/$defs/WidgetDevelopmentMessage"
     }
   },
   "$defs": {
@@ -402,190 +406,6 @@
         }
       }
     },
-    "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",
@@ -908,42 +728,6 @@
             }
           }
         },
-        {
-          "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,
@@ -1362,40 +1146,6 @@
             }
           }
         },
-        {
-          "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,
@@ -2869,6 +2619,890 @@
           ]
         }
       }
+    },
+    "WidgetDiagnosticDetail": {
+      "title": "WidgetDiagnosticDetail",
+      "description": "受控字段诊断或工程相对源码位置；不携带原始对象。",
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "field"
+          ],
+          "properties": {
+            "field": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 128
+            },
+            "expected": {
+              "type": "string",
+              "maxLength": 256
+            },
+            "observed": {
+              "type": "string",
+              "maxLength": 256
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "file",
+            "line",
+            "column"
+          ],
+          "properties": {
+            "file": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 256,
+              "pattern": "^(?!/)(?!.*\\\\)(?!.*:)(?!.*(?:^|/)\\.{1,2}(?:/|$))[^\\u0000-\\u001f]+$"
+            },
+            "line": {
+              "type": "integer",
+              "minimum": 1
+            },
+            "column": {
+              "type": "integer",
+              "minimum": 1
+            },
+            "excerpt": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 1024
+            }
+          }
+        }
+      ]
+    },
+    "WidgetDiagnosticIO": {
+      "title": "WidgetDiagnosticIO",
+      "description": "保留 transport、HTTP 与非法响应事实；不包含 URL 或原始响应。",
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "kind"
+          ],
+          "properties": {
+            "kind": {
+              "enum": [
+                "transport",
+                "invalid-response"
+              ]
+            },
+            "sourceCode": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 96,
+              "pattern": "^[A-Za-z][A-Za-z0-9_.-]*$"
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "kind",
+            "status"
+          ],
+          "properties": {
+            "kind": {
+              "enum": [
+                "http"
+              ]
+            },
+            "status": {
+              "type": "integer",
+              "minimum": 100,
+              "maximum": 599,
+              "not": { "minimum": 200, "maximum": 299 }
+            },
+            "sourceCode": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 96,
+              "pattern": "^[A-Za-z][A-Za-z0-9_.-]*$"
+            }
+          }
+        }
+      ]
+    },
+    "WidgetDevelopmentDiagnostic": {
+      "title": "WidgetDevelopmentDiagnostic",
+      "description": "可信出口的标准诊断；恢复指令和 scope 由宿主另行生成。",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schemaVersion",
+        "source",
+        "code",
+        "phase",
+        "operation",
+        "severity",
+        "message"
+      ],
+      "properties": {
+        "schemaVersion": {
+          "const": 1
+        },
+        "source": {
+          "enum": [
+            "sdk",
+            "host",
+            "toolchain"
+          ]
+        },
+        "code": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 96,
+          "pattern": "^[A-Za-z][A-Za-z0-9_.-]*$"
+        },
+        "sourceCode": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 96,
+          "pattern": "^[A-Za-z][A-Za-z0-9_.-]*$"
+        },
+        "phase": {
+          "enum": [
+            "discovery",
+            "build",
+            "config",
+            "load",
+            "handshake",
+            "render",
+            "update",
+            "capability",
+            "dispose"
+          ]
+        },
+        "sourcePhase": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 96,
+          "pattern": "^[A-Za-z][A-Za-z0-9_.-]*$"
+        },
+        "operation": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 96,
+          "pattern": "^[A-Za-z][A-Za-z0-9_.-]*$"
+        },
+        "severity": {
+          "enum": [
+            "warning",
+            "request-error",
+            "instance-failure"
+          ]
+        },
+        "message": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 1024
+        },
+        "retryable": {
+          "type": "boolean"
+        },
+        "correlationId": { "$ref": "#/$defs/WidgetError/properties/correlationId" },
+        "diagnostics": {
+          "type": "array",
+          "maxItems": 8,
+          "items": {
+            "$ref": "#/$defs/WidgetDiagnosticDetail"
+          }
+        },
+        "io": {
+          "$ref": "#/$defs/WidgetDiagnosticIO"
+        }
+      }
+    },
+    "WidgetRecoveryAction": {
+      "title": "WidgetRecoveryAction",
+      "description": "恢复动作的语义及类型化参数；可信宿主绑定已有工具，不包含任意命令。",
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "id",
+            "params"
+          ],
+          "properties": {
+            "id": {
+              "const": "inspect"
+            },
+            "params": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "area"
+              ],
+              "properties": {
+                "area": {
+                  "enum": [
+                    "toolchain",
+                    "host-bridge",
+                    "configuration",
+                    "bundle",
+                    "handshake",
+                    "render",
+                    "capability",
+                    "lease",
+                    "operation-outcome",
+                    "runtime"
+                  ]
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "id",
+            "params"
+          ],
+          "properties": {
+            "id": {
+              "const": "wait"
+            },
+            "params": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "milestone"
+              ],
+              "properties": {
+                "milestone": {
+                  "enum": [
+                    "budget-reset",
+                    "connection-restored"
+                  ]
+                },
+                "retryAfterMs": {
+                  "type": "integer",
+                  "minimum": 1
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "id",
+            "params"
+          ],
+          "properties": {
+            "id": {
+              "const": "edit-project"
+            },
+            "params": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "evidence"
+              ],
+              "properties": {
+                "evidence": {
+                  "const": "diagnostics"
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "id",
+            "params"
+          ],
+          "properties": {
+            "id": {
+              "const": "build-project"
+            },
+            "params": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "target"
+              ],
+              "properties": {
+                "target": {
+                  "const": "current-project"
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "id",
+            "params"
+          ],
+          "properties": {
+            "id": {
+              "const": "refresh-preview"
+            },
+            "params": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "target"
+              ],
+              "properties": {
+                "target": {
+                  "const": "current-project"
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "id",
+            "params"
+          ],
+          "properties": {
+            "id": {
+              "const": "verify-scenario"
+            },
+            "params": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "target"
+              ],
+              "properties": {
+                "target": {
+                  "enum": [
+                    "current-attempt",
+                    "next-built-generation"
+                  ]
+                },
+                "scenarioId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 96,
+                  "pattern": "^[A-Za-z][A-Za-z0-9_.-]*$"
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "id",
+            "params"
+          ],
+          "properties": {
+            "id": {
+              "const": "request-external-action"
+            },
+            "params": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "reason"
+              ],
+              "properties": {
+                "reason": {
+                  "enum": [
+                    "authorization",
+                    "host-support",
+                    "host-start",
+                    "credentials"
+                  ]
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "id",
+            "params"
+          ],
+          "properties": {
+            "id": {
+              "const": "stop-preview"
+            },
+            "params": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "target"
+              ],
+              "properties": {
+                "target": {
+                  "const": "current-preview"
+                }
+              }
+            }
+          }
+        }
+      ]
+    },
+    "WidgetRecoveryVerification": {
+      "title": "WidgetRecoveryVerification",
+      "description": "恢复复验目标；下一成功构建须在取得回执后绑定实际产物。",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "target",
+        "milestone"
+      ],
+      "properties": {
+        "target": {
+          "enum": [
+            "current-attempt",
+            "next-built-generation",
+            "original-operation"
+          ]
+        },
+        "milestone": {
+          "enum": [
+            "diagnostics-updated",
+            "render-handled",
+            "scenario-passed",
+            "operation-confirmed"
+          ]
+        },
+        "scenarioId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 96,
+          "pattern": "^[A-Za-z][A-Za-z0-9_.-]*$"
+        }
+      }
+    },
+    "WidgetRecoveryPlan": {
+      "title": "WidgetRecoveryPlan",
+      "description": "可信宿主选择的恢复计划；不能由 Guest 的诊断 payload 指定。",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schemaVersion",
+        "ruleId",
+        "ruleVersion",
+        "disposition",
+        "nextAction",
+        "verification",
+        "guidance",
+        "followUpActions"
+      ],
+      "properties": {
+        "progress": { "$ref": "#/$defs/WidgetRecoveryProgress" },
+        "schemaVersion": {
+          "const": 1
+        },
+        "ruleId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 96,
+          "pattern": "^[A-Za-z][A-Za-z0-9_.-]*$"
+        },
+        "ruleVersion": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "disposition": {
+          "enum": [
+            "retry",
+            "repair",
+            "inspect",
+            "external-action",
+            "stop"
+          ]
+        },
+        "nextAction": {
+          "$ref": "#/$defs/WidgetRecoveryAction"
+        },
+        "verification": {
+          "$ref": "#/$defs/WidgetRecoveryVerification"
+        },
+        "guidance": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 4096
+        },
+        "followUpActions": {
+          "description": "首项动作完成后的有限恢复步骤；宿主逐步验证前置条件，不原样盲目重放。",
+          "type": "array",
+          "maxItems": 8,
+          "items": {
+            "$ref": "#/$defs/WidgetRecoveryAction"
+          }
+        }
+      }
+    },
+    "WidgetRecoveryRule": {
+      "title": "WidgetRecoveryRule",
+      "description": "公共恢复规则目录条目；空 codes 仅用于显式 unknown 回退。",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "version",
+        "sources",
+        "codes",
+        "disposition",
+        "nextAction",
+        "verification",
+        "guidance",
+        "followUpActions"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 96,
+          "pattern": "^[A-Za-z][A-Za-z0-9_.-]*$"
+        },
+        "version": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "sources": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 3,
+          "uniqueItems": true,
+          "items": {
+            "enum": [
+              "sdk",
+              "host",
+              "toolchain"
+            ]
+          }
+        },
+        "codes": {
+          "type": "array",
+          "maxItems": 64,
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 96,
+            "pattern": "^[A-Za-z][A-Za-z0-9_.-]*$"
+          }
+        },
+        "disposition": {
+          "enum": [
+            "retry",
+            "repair",
+            "inspect",
+            "external-action",
+            "stop"
+          ]
+        },
+        "nextAction": {
+          "$ref": "#/$defs/WidgetRecoveryAction"
+        },
+        "verification": {
+          "$ref": "#/$defs/WidgetRecoveryVerification"
+        },
+        "guidance": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 4096
+        },
+        "followUpActions": {
+          "description": "首项动作完成后的有限恢复步骤；宿主逐步验证前置条件，不原样盲目重放。",
+          "type": "array",
+          "maxItems": 8,
+          "items": {
+            "$ref": "#/$defs/WidgetRecoveryAction"
+          }
+        }
+      }
+    },
+    "WidgetDevelopmentExtension": {
+      "title": "WidgetDevelopmentExtension",
+      "description": "经 offer/connect 显式选择的开发扩展；不授予 capability。",
+      "const": "development-diagnostics-v1"
+    },
+    "WidgetDevelopmentOffer": {
+      "title": "WidgetDevelopmentOffer",
+      "description": "独立于旧 bootstrap-ready 的支持声明，接收方仍须校验 frame 来源和挂载尝试。",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "type",
+        "protocolVersion",
+        "extensions"
+      ],
+      "properties": {
+        "type": {
+          "const": "widget-bootstrap-offer"
+        },
+        "protocolVersion": {
+          "const": 1
+        },
+        "extensions": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/$defs/WidgetDevelopmentExtension"
+          }
+        }
+      }
+    },
+    "WidgetDevelopmentConnect": {
+      "title": "WidgetDevelopmentConnect",
+      "description": "仅在收到当前 iframe 合法 offer 后使用的扩展 connect；旧形状保持不变。",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "type",
+        "protocolVersion",
+        "channelId",
+        "initPayload",
+        "extensions"
+      ],
+      "properties": {
+        "type": {
+          "const": "widget-host-connect"
+        },
+        "protocolVersion": {
+          "const": 1
+        },
+        "channelId": {
+          "type": "string",
+          "minLength": 16
+        },
+        "initPayload": {
+          "$ref": "#/$defs/InitPayload"
+        },
+        "extensions": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/$defs/WidgetDevelopmentExtension"
+          }
+        }
+      }
+    },
+    "WidgetRenderResult": {
+      "title": "WidgetRenderResult",
+      "description": "仅表示受管渲染处理器的处理结果，不代表视觉或业务验收。",
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "requestId",
+            "revision",
+            "outcome"
+          ],
+          "properties": {
+            "requestId": { "$ref": "#/$defs/RenderRequestBase/properties/requestId" },
+            "revision": {
+              "type": "integer",
+              "minimum": 1
+            },
+            "outcome": {
+              "enum": [
+                "handled",
+                "superseded"
+              ]
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "requestId",
+            "revision",
+            "outcome",
+            "diagnostic"
+          ],
+          "properties": {
+            "requestId": { "$ref": "#/$defs/RenderRequestBase/properties/requestId" },
+            "revision": {
+              "type": "integer",
+              "minimum": 1
+            },
+            "outcome": {
+              "const": "failed"
+            },
+            "diagnostic": {
+              "$ref": "#/$defs/WidgetRenderFailureDiagnostic"
+            }
+          }
+        }
+      ]
+    },
+    "WidgetDiagnosticMessage": {
+      "title": "WidgetDiagnosticMessage",
+      "description": "经协商的开发扩展 Bridge 消息；仍受现有通道与消息预算约束。",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/BridgeEnvelopeBase"
+        },
+        {
+          "type": "object",
+          "required": [
+            "type",
+            "payload"
+          ],
+          "properties": {
+            "type": {
+              "const": "diagnostic"
+            },
+            "payload": {
+              "$ref": "#/$defs/WidgetGuestDiagnostic"
+            }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "WidgetRenderResultMessage": {
+      "title": "WidgetRenderResultMessage",
+      "description": "经协商的开发扩展 Bridge 消息；仍受现有通道与消息预算约束。",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/BridgeEnvelopeBase"
+        },
+        {
+          "type": "object",
+          "required": [
+            "type",
+            "payload"
+          ],
+          "properties": {
+            "type": {
+              "const": "render-result"
+            },
+            "payload": {
+              "$ref": "#/$defs/WidgetRenderResult"
+            }
+          }
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "WidgetDevelopmentMessage": {
+      "title": "WidgetDevelopmentMessage",
+      "description": "扩展 profile 下的 Widget → Host 消息；原 WidgetToHostMessage 不扩展。",
+      "oneOf": [
+        {
+          "$ref": "#/$defs/WidgetToHostMessage"
+        },
+        {
+          "$ref": "#/$defs/WidgetDiagnosticMessage"
+        },
+        {
+          "$ref": "#/$defs/WidgetRenderResultMessage"
+        }
+      ]
+    },
+    "WidgetRecoveryContext": {
+      "title": "WidgetRecoveryContext",
+      "description": "复用工具执行结果语义的可信恢复上下文；缺失字段表示未知，不能授权重放。",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "progress": { "$ref": "#/$defs/WidgetRecoveryProgress" },
+        "executionState": {
+          "enum": [
+            "not_started",
+            "finished",
+            "partial",
+            "unknown"
+          ]
+        },
+        "mayHaveExecuted": {
+          "type": "boolean"
+        }
+      }
+    },
+    "WidgetGuestDiagnostic": {
+      "title": "WidgetGuestDiagnostic",
+      "description": "Guest 仅声明 SDK 诊断事实，不得冒充 Host 或工具链。",
+      "allOf": [
+        {
+          "$ref": "#/$defs/WidgetDevelopmentDiagnostic"
+        },
+        {
+          "type": "object",
+          "required": [
+            "source"
+          ],
+          "properties": {
+            "source": {
+              "const": "sdk"
+            }
+          }
+        }
+      ]
+    },
+    "WidgetRenderFailureDiagnostic": {
+      "title": "WidgetRenderFailureDiagnostic",
+      "description": "失败处理回执的 SDK 请求诊断；接收方还须匹配当前 requestId。",
+      "allOf": [
+        {
+          "$ref": "#/$defs/WidgetGuestDiagnostic"
+        },
+        {
+          "type": "object",
+          "required": [
+            "correlationId"
+          ],
+          "properties": {
+            "correlationId": { "$ref": "#/$defs/WidgetDevelopmentDiagnostic/properties/correlationId" },
+            "phase": {
+              "enum": [
+                "render",
+                "update"
+              ]
+            }
+          }
+        }
+      ]
+    },
+    "WidgetRecoveryProgress": {
+      "title": "WidgetRecoveryProgress",
+      "description": "可信宿主观察到的恢复进展；重复故障无新证据时不能重复同一修复。",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "repeated",
+        "hasNewEvidence"
+      ],
+      "properties": {
+        "repeated": {
+          "type": "boolean"
+        },
+        "hasNewEvidence": {
+          "type": "boolean"
+        }
+      }
     }
   }
 }