@dp-bohrium/widget-sdk 0.8.0 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (38) hide show
  1. package/AGENTS.md +1 -1
  2. package/CHANGELOG.md +25 -0
  3. package/README.md +0 -7
  4. package/assets/schemas/widget-manifest.schema.json +0 -12
  5. package/assets/schemas/widget-runtime-contracts.schema.json +906 -272
  6. package/assets/toolchain.json +8 -8
  7. package/conformance/development-diagnostics.json +128 -0
  8. package/dist/cli.mjs +184 -14
  9. package/dist/compatibility/testing.js +1 -1
  10. package/dist/contracts.js +3 -2
  11. package/dist/development-guards-COvBR0G1.js +136 -0
  12. package/dist/{dsh-BlpXm2Bv.mjs → dsh-BJWUB8Nq.mjs} +1308 -516
  13. package/dist/index.d.ts +2 -2
  14. package/dist/index.js +53 -17
  15. package/dist/protocol/development-guards.d.ts +9 -0
  16. package/dist/protocol/generated-development-policy.d.ts +22 -0
  17. package/dist/protocol/generated-host-runtime-config.d.ts +0 -22
  18. package/dist/protocol/generated-manifest.d.ts +0 -8
  19. package/dist/protocol/generated-plugin-manifest.d.ts +0 -8
  20. package/dist/protocol/generated-runtime-contracts.d.ts +230 -128
  21. package/dist/protocol/index.d.ts +7 -2
  22. package/dist/protocol/widget-recovery.d.ts +19 -0
  23. package/dist/{protocol-endpoint-CDz-YDGT.js → protocol-endpoint-DbT0OJNu.js} +5 -0
  24. package/dist/runtime/bootstrap.d.ts +3 -1
  25. package/dist/runtime/client.d.ts +5 -1
  26. package/dist/runtime/index.js +2 -2
  27. package/dist/runtime/protocol-endpoint.d.ts +5 -5
  28. package/dist/runtime/transport.d.ts +9 -9
  29. package/dist/{runtime-D2xmZVSb.js → runtime-Bn_ee8xy.js} +39 -5
  30. package/dist/widget-recovery-BF_sSUZX.js +472 -0
  31. package/dist/widget.d.ts +1 -41
  32. package/llms.txt +13 -1
  33. package/package.json +1 -1
  34. package/schemas/widget-manifest.schema.json +0 -12
  35. package/schemas/widget-runtime-contracts.schema.json +906 -272
  36. package/conformance/bridge/tasks-list-request.json +0 -17
  37. package/conformance/bridge/tasks-watch-request.json +0 -18
  38. package/dist/widget-events-gsKJbjqg.js +0 -65
package/AGENTS.md CHANGED
@@ -12,7 +12,7 @@ pnpm dlx @dp-bohrium/widget-sdk create my-widget --template panel
12
12
 
13
13
  1. 用 SDK 自带的 `bohr-widget` 创建工程,再用 `activate(context)` 实现 Widget;生成工程只直接依赖 SDK。
14
14
  2. 在 Manifest 中声明所需 capability,再使用 `context.capabilities`、`context.files`、
15
- `context.tasks`、`context.ui` 或 `context.network`。
15
+ `context.ui` 或 `context.network`。
16
16
  3. 在测试中使用 `@dp-bohrium/widget-sdk/testing` 的 `MockWidgetHost`;生产 Bundle 使用
17
17
  根入口,不把 testing 入口打进产物。
18
18
  4. 常用作者类型从根入口获取;完整协议用 `/contracts`,编辑器 Schema 用 `/schemas/*.json`。
package/CHANGELOG.md CHANGED
@@ -1,5 +1,30 @@
1
1
  # `@dp-bohrium/widget-sdk` 变更记录
2
2
 
3
+ ## 0.10.0
4
+
5
+ ### Minor Changes
6
+
7
+ - 75ef4f2: **破坏性变更**:移除 `tasks.list`、`tasks.watch` 及对应的 Manifest 申请、grant、协议类型、Schema、语料和 `context.tasks` 高层 API。依赖计算任务信息的 Widget 应改为消费 Host 主动下发的计算事件,并通过通用 `network.fetch` 查询目标平台。
8
+
9
+ ## 0.9.0
10
+
11
+ ### Minor Changes
12
+
13
+ - 2c4cac6: 新增标准开发诊断、类型化恢复规则目录与显式协商的开发扩展合同,复用现有错误和 Schema。
14
+ 恢复计划区分修复与原样重试,缺少证据或操作结果未知时先排查,并提供构建、刷新及场景复验步骤。
15
+ 旧握手和终态错误语义保持不变;仅在协商后发送标准诊断与渲染结果,开发 Host 提供受保护的诊断收集与已构建产物刷新,不自动执行作者脚本或修复。
16
+
17
+ ### Patch Changes
18
+
19
+ - 99fee61: 修复工作区声明构建被陈旧 SDK 分发文件干扰的问题,直接复用当前源码的协议类型,无需手动删除既有分发目录。
20
+
21
+ ## 0.8.1
22
+
23
+ ### Patch Changes
24
+
25
+ - de9e8a5: 在 Widget 工程和本地作者索引中提供尺寸指引。文件预览示例的内容区随宿主分配的 iframe 高度伸缩。
26
+ - 42fb8c1: `bohr-widget dev --no-build` 支持通过 `--listen-fd` 复用宿主已监听的 `127.0.0.1` TCP socket,避免预览服务另行绑定端口。
27
+
3
28
  ## 0.8.0
4
29
 
5
30
  ### Minor Changes
package/README.md CHANGED
@@ -224,8 +224,6 @@ SDK 发布包会生成 `dist/index.d.ts` 与各子入口声明,并通过 `pack
224
224
  | `files.write` | `files.write` | `context.files.write({ file, content, encoding, expectedRevision, mutationId })` |
225
225
  | `files.download` | `files.download` | `context.files.download({ file, suggestedName })` |
226
226
  | `events.read` | `events`(需列出 `topics`) | 低层分页订阅;`context.events.on(…)` 是 Host 主动推送,不需要该 grant |
227
- | `tasks.list` | `tasks.list` | `context.tasks.list({ cursor, limit })` |
228
- | `tasks.watch` | `tasks.watch` | `context.tasks.watch({ taskId, cursor, limit })` |
229
227
  | `ui.state` | `state`(`read` / `write`) | `context.ui.state.read(key)` / `write(key, value)` |
230
228
  | `actions.invoke` | `actions` | `context.capabilities.request({ operation: "actions.invoke", input })` |
231
229
  | `network.fetch` | `network` | `context.network.fetch(…)` |
@@ -263,10 +261,6 @@ if (result.ok) {
263
261
  业务 payload,不会把 Cookie、Bearer Token 或其他凭据放入 iframe。
264
262
  - `context.files.download` 只提交文件引用和建议文件名;Host 在用户确认后经宿主
265
263
  Download Adapter 惰性打开内容源。Widget 不会收到源 URL、保存路径或凭据。
266
- - `context.tasks.list` 只读取一次受限任务摘要页;返回的 `taskId` 是可继续传给
267
- `context.tasks.watch` 的不透明引用。SDK 不会自行轮询,调用方应遵守 grant 的 `minPollMs`。
268
- - `context.tasks.watch` 只读取一次受限任务快照和事件页;调用方用返回的 cursor 继续轮询。
269
- 两个任务 API 都不创建、调度或取消任务,服务端负责任务授权、脱敏和终态保留。
270
264
  - `context.ui.state` 只保存按 Widget + Session 隔离的 JSON UI 状态;Host 按 key、单值大小、总字节数和调用
271
265
  频率限流。它不能保存任务执行、凭据、文件内容或 Workspace 权限状态。
272
266
  - 外部插件的工具结果场景通过 `tool-call-result` 事件作为可选运行时信号;内部 Host/协议测试仍可使用低层 Tool Result RenderRequest
@@ -360,7 +354,6 @@ import { MockWidgetHost } from "@dp-bohrium/widget-sdk/testing";
360
354
  ## 限制
361
355
 
362
356
  - SDK 不做授权决策,能力是否可用最终由 Host 判定。
363
- - `tasks.list` / `tasks.watch` 是有界发现与观察协议,不是调度器、执行器或取消 API;任务摘要、状态和事件由服务端投影。
364
357
  - `invokeAction` 不自动重试,回调完成也不代表工具执行完成。
365
358
  - `subscribeEvents` 的 `events.read` 是有界分页读取,不是 websocket;实时推送走
366
359
  `onEvent`。当前版本没有单请求取消的独立协议消息:`unsubscribe` 会停止后续轮询并取消
@@ -65,7 +65,6 @@
65
65
  "properties": {
66
66
  "files": { "$ref": "#/$defs/FilesCapabilityRequest" },
67
67
  "events": { "$ref": "#/$defs/EventsCapabilityRequest" },
68
- "tasks": { "$ref": "#/$defs/TasksCapabilityRequest" },
69
68
  "state": { "$ref": "#/$defs/StateCapabilityRequest" },
70
69
  "actions": { "$ref": "#/$defs/ActionsCapabilityRequest" },
71
70
  "network": { "$ref": "#/$defs/NetworkCapabilityRequest" },
@@ -111,17 +110,6 @@
111
110
  }
112
111
  }
113
112
  },
114
- "TasksCapabilityRequest": {
115
- "description": "任务发现与观察能力的申请;list / watch 至少显式申请一项,已申请项固定为 true。",
116
- "title": "TasksCapabilityRequest",
117
- "type": "object",
118
- "additionalProperties": false,
119
- "minProperties": 1,
120
- "properties": {
121
- "list": { "const": true },
122
- "watch": { "const": true }
123
- }
124
- },
125
113
  "StateCapabilityRequest": {
126
114
  "description": "受限 UI 状态读写能力的申请;read / write 分别声明。",
127
115
  "title": "StateCapabilityRequest",