@dp-bohrium/widget-contracts 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DP Technology
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,190 @@
+# @dp-bohrium/widget-contracts
+
+Bohrium Widget Platform 的跨仓共享 Contract 包。它是 Manifest、Host
+Runtime Config、Runtime Bridge 消息及其相关类型的唯一事实源，供 Shrimp、
+Host Runtime、SDK Runtime 和 Widget 工具链共同消费。
+
+本包只提供版本化 JSON Schema、由 Schema 生成的 TypeScript 类型和
+conformance fixtures，不提供生产 Runtime、AJV validator 或 Widget UI。
+
+## 安装
+
+当前版本从 Bohrium 内部 npm Registry 安装，并建议固定到明确版本：
+
+```bash
+pnpm add @dp-bohrium/widget-contracts@0.0.1 \
+  --registry=https://registry.npmjs.org
+```
+
+运行环境要求 Node.js 20 或更高版本。
+
+## TypeScript 类型
+
+包的根入口是纯类型入口，运行时不会导出值，因此需要使用 `import type`：
+
+```ts
+import type {
+  HostToWidgetMessage,
+  RenderRequest,
+  WidgetHostRuntimeConfig,
+  WidgetManifest,
+  WidgetToHostMessage,
+} from "@dp-bohrium/widget-contracts";
+
+function handleRender(request: RenderRequest) {
+  // request.slot 与 request.content.slot 保持类型级别的一致性。
+  return request.slot;
+}
+```
+
+主要导出包括：
+
+- `WidgetManifest`：Widget bundle 的 Manifest；
+- `WidgetHostRuntimeConfig`：Shrimp 为一次运行解析出的 Host Runtime Config；
+- `RenderRequest`：`tool-result`、`file-preview` 和 `panel` 三种 Slot 的渲染请求；
+- `HostToWidgetMessage` / `WidgetToHostMessage`：双向 Bridge 消息联合类型；
+- `CapabilityRequest` / `CapabilityResult`：能力请求与结果；
+- `WidgetError`、`ResourceBudget` 以及相关的主题、文件和渲染上下文类型。
+
+开发期只维护一套当前 Contract：`WidgetManifest` 与
+`WidgetHostRuntimeConfig` 均使用 `schemaVersion: 1` 和
+`hostApiVersion: 1`。未知版本必须拒绝；当前字段发生破坏性调整时，所有 prerelease
+消费者随同升级，不维护并行的旧版 reader。
+
+## Host 托管网络能力
+
+当前 Host API 提供 `network.fetch`。Widget 只通过 Bridge 发送结构化请求，实际
+网络访问、运行时授权弹窗、策略执行和凭据注入均由 Host 侧 provider 负责：
+
+- Manifest 使用 `requestedCapabilities.network.fetch: true` 声明需求；
+- Host Runtime Config 用 `network` 下发策略版本和预算，并在 binding 中授予
+  `network.fetch`；
+- Widget 只声明 `auth: none | optional | required`；凭据标识、凭据值、Authorization
+  header 和 Vault 内容均不得进入 iframe 或 Bridge；
+- Widget 请求头大小写不敏感地拒绝 `Authorization`、`Cookie`、
+  `Proxy-Authorization`、`X-Api-Key`，以及 `Api-Key`、`X-Auth-Token`、
+  `X-Access-Token`、`Credential-Binding-Id`、`X-Credential-Binding-Id` 等价名称；
+  请求头和响应头由不同 Schema authority 管理，响应头的结构合法不代表 Host 可以回传敏感信息；
+- 公网 HTTPS 可以使用契约支持的方法；公网 HTTP 仅允许无正文、无凭据的 GET/HEAD，
+  以兼容仍未提供 HTTPS 的学术站点；私网地址、跨 Origin 重定向和超限请求由
+  Host/Broker 拒绝；
+- `runtime.origin` 与 `catalogRevision` 由 Host Config 注入，消费者不得写死
+  当前 Runtime 域名。
+
+`network.fetch` 只定义 Widget/Host 间的结构化能力契约，不让 Widget Runtime 依赖
+Agent Widget。默认 provider、无头授权控制器和复用 Agent Widget primitives 的默认弹窗
+由 Host 组合；Host 也可以替换 presenter 或整个 provider，因此无需新增独立设计系统。
+
+## JSON Schema
+
+Schema 文件通过包的子路径导出，可交给 AJV 或其他 JSON Schema 2020-12
+实现校验：
+
+| 文件 | 责任 | 主要消费者 |
+| --- | --- | --- |
+| `schemas/widget-manifest.schema.json` | bundle 名称、入口、Slot、能力申请和样例 | 上传与管理侧 |
+| `schemas/host-runtime-config.schema.json` | Shrimp 为一次运行选择的版本、Digest、授权和资源配置 | Host Runtime |
+| `schemas/widget-runtime-contracts.schema.json` | iframe 启动后的 Bridge、Render、Capability、Error 和资源预算消息 | SDK Runtime / Host Runtime |
+
+例如，在支持 JSON module import 的 ESM 工程中：
+
+```ts
+import manifestSchema from
+  "@dp-bohrium/widget-contracts/schemas/widget-manifest.schema.json" with {
+    type: "json",
+  };
+```
+
+Schema 的 `$id` 使用包内相对标识（例如 `widget-manifest.schema.json`），**不是**可联网拉取的 URL。
+依赖方必须从已安装的 `@dp-bohrium/widget-contracts/schemas/*.json` 本地加载并按 `$id` 注册，再解析 `$ref`；不要假设校验器会访问网络。
+
+公开探测版从 `0.0.1` 起发布到 npmjs（`@dp-bohrium`）。历史内部 prerelease
+（`0.1.0-alpha.*`）曾去掉 schema 文件名的 `.v1` 后缀、增加 Host 托管网络与
+Panel 能力，并移除静态 `outboundOrigins`；那些变更已并入当前 Contract。
+
+`host-runtime-config.schema.json` 通过包内 `$id`/`$ref` 指向 Manifest 与 Runtime
+Schema。跨语言消费者必须先从已安装的 schema 文件注册这两个 `$id`，再编译
+Host Runtime Config；不能假设校验器会访问网络获取 `$ref`。
+
+## Conformance fixtures
+
+`conformance/` 与 Schema 一起发布，作为跨语言、跨仓实现的固定测试输入，
+不是另一套协议定义：
+
+```text
+conformance/
+├── manifests/                 # 合法 Manifest
+├── host-runtime-config/       # 合法/非法 Host Runtime Config
+├── render-inputs/             # 三种 Slot 的渲染请求及增量更新
+├── bridge/                    # Bridge 消息样例
+├── file-responses/            # 文件能力响应样例
+├── invalid-network-requests/  # 必须拒绝的 network.fetch 请求
+├── invalid-bridge-messages/   # 必须拒绝的完整 Bridge 消息
+├── invalid-presentation-grants/   # 必须拒绝的展示授权
+├── invalid-presentation-requests/ # 必须拒绝的展示请求
+└── invalid-*                  # 必须被拒绝的输入
+```
+
+展示能力的公开语料包含申请 `floating` 与 `overlay` 的
+`manifests/valid-presentation-panel.json`、带 `ui.presentation` grant 的 init
+消息、`present` / `change-surface` / `close` 请求、两个方向的
+`focus-boundary` 请求，以及降级成功、关闭成功、焦点边界成功、策略拒绝和用户拒绝结果。原有
+`manifests/valid-panel.json` 刻意不申请展示能力，用于证明历史 Panel Manifest 仍兼容。
+对应的 invalid fixtures 分别拒绝空、重复或未知 surface，错误的确认标记，缺失或多余
+surface，以及 Widget 提交的坐标、geometry、z-index 和运行/Widget 身份字段。
+`focus-boundary` 只携带 `forward | backward`，严格拒绝 surface、目标/选择器、
+身份、runtime generation、坐标、层级、时间戳、按键/修饰键和 `isTrusted` 等事件来源字段。
+它和 `close` 都只是当前 MessageChannel 上的 Widget UX 请求；MessageChannel 只能标识
+iframe 实例，不能证明物理按键或用户激活，最终授权与焦点目标始终由 Host 决定。
+
+需要读取 fixture 时可使用包导出的子路径，例如：
+
+```ts
+const fixture = await import(
+  "@dp-bohrium/widget-contracts/conformance/manifests/valid-panel.json",
+  { with: { type: "json" } },
+);
+```
+
+## 边界和版本约定
+
+- `host-runtime-config.schema.json` 是 Shrimp 与 Host Runtime 之间的配置
+  Contract，不是 Widget 收到的 Bridge 消息；Host Runtime 只将必要视图通过
+  `init` 消息传给 Widget。
+- 本包不实现 Runtime 行为，也不负责权限执行、iframe 隔离、CSP、资源治理
+  或 fallback/revoke。
+- Schema/validator 只负责结构和协议形状校验，不等于 Host Runtime 的安全策略
+  决策。Host 必须另外校验时间顺序、隔离域、凭据和 query、Origin 规范化、
+  Manifest/审核/运行授权交集，以及 DNS/SSRF 等运行时策略。
+- 凭据 binding 属于 Host provider 私有上下文；`credentialBindingId`、
+  `credentialValue` 和 Host 场景上下文都不是 Widget wire 字段。
+- Schema 的 `schemaVersion` 与 Bridge 的 `protocolVersion` 属于协议版本；
+  包版本使用 SemVer。新增兼容字段必须同时更新 Schema、生成类型、
+  fixtures 和 conformance 测试。
+- 协议版本只由载荷里的 `schemaVersion`、`hostApiVersion`、`protocolVersion` 和
+  `resourceBudget.version` 承载，不进 schema 文件名或 `$id`。在进入稳定发布前，
+  Contract 只有一套当前定义；如需破坏性调整，直接更新 prerelease 消费者，不创建
+  V1/V2 sibling 或 `<name>.v2.schema.json`。
+- 类型由仓库根目录的生成脚本维护，不应直接编辑 `src/generated-*.ts`。
+
+## 仓库开发
+
+在 `bohrium-widget-sdk` monorepo 中运行：
+
+```bash
+pnpm --filter @dp-bohrium/widget-contracts generate:types
+pnpm --filter @dp-bohrium/widget-contracts schema:check
+pnpm --filter @dp-bohrium/widget-contracts typecheck
+pnpm --filter @dp-bohrium/widget-contracts test
+pnpm --filter @dp-bohrium/widget-contracts build
+```
+
+详细的协议设计见
+[`docs/design/widget-contract-v1.md`](../../docs/design/widget-contract-v1.md)。
+
+## 发布状态
+
+当前 package metadata 配置为 Bohrium 内部受限 prerelease：Registry 为
+`https://registry.npmjs.org/`、访问级别为 `public`、许可证为 `MIT`。
+如果未来要发布到公开 npm Registry，必须先同步确认许可证、访问级别、
+Registry 和 CI 发布规则，再更新本 README 与 package metadata。

package/conformance/bridge/capability-request.json

@@ -0,0 +1,23 @@
+{
+  "protocolVersion": 1,
+  "channelId": "0123456789abcdef0123456789abcdef",
+  "messageId": "widget-capability-1",
+  "sequence": 2,
+  "type": "capability-request",
+  "payload": {
+    "requestId": "capability-1",
+    "request": {
+      "operation": "files.read",
+      "input": {
+        "file": {
+          "id": "file-001",
+          "kind": "file",
+          "name": "result.txt"
+        },
+        "offset": 0,
+        "length": 1024,
+        "encoding": "utf8"
+      }
+    }
+  }
+}

package/conformance/bridge/network-fetch-denied.json

@@ -0,0 +1,16 @@
+{
+  "protocolVersion": 1,
+  "channelId": "0123456789abcdef0123456789abcdef",
+  "messageId": "host-network-denied-1",
+  "sequence": 4,
+  "type": "capability-result",
+  "payload": {
+    "requestId": "network-request-1",
+    "result": {
+      "ok": false,
+      "reason": "network-consent-denied",
+      "message": "Network access was not authorized",
+      "retryable": false
+    }
+  }
+}

package/conformance/bridge/network-fetch-request.json

@@ -0,0 +1,19 @@
+{
+  "protocolVersion": 1,
+  "channelId": "0123456789abcdef0123456789abcdef",
+  "messageId": "widget-network-request-1",
+  "sequence": 3,
+  "type": "capability-request",
+  "payload": {
+    "requestId": "network-request-1",
+    "request": {
+      "operation": "network.fetch",
+      "input": {
+        "url": "https://api.example.test/v1/items?query=water",
+        "auth": "required",
+        "method": "GET",
+        "redirect": "follow"
+      }
+    }
+  }
+}

package/conformance/bridge/network-fetch-success.json

@@ -0,0 +1,22 @@
+{
+  "protocolVersion": 1,
+  "channelId": "0123456789abcdef0123456789abcdef",
+  "messageId": "host-network-success-1",
+  "sequence": 4,
+  "type": "capability-result",
+  "payload": {
+    "requestId": "network-request-1",
+    "result": {
+      "ok": true,
+      "data": {
+        "status": 200,
+        "statusText": "OK",
+        "headers": { "content-type": "application/json" },
+        "body": "{\"items\":[]}",
+        "bodyEncoding": "utf8",
+        "finalUrl": "https://api.example.test/v1/items?query=water",
+        "redirected": false
+      }
+    }
+  }
+}

package/conformance/bridge/presentation-change-surface-request.json

@@ -0,0 +1,14 @@
+{
+  "protocolVersion": 1,
+  "channelId": "0123456789abcdef0123456789abcdef",
+  "messageId": "widget-presentation-change-1",
+  "sequence": 3,
+  "type": "capability-request",
+  "payload": {
+    "requestId": "presentation-change-1",
+    "request": {
+      "operation": "ui.presentation",
+      "input": { "action": "change-surface", "surface": "floating" }
+    }
+  }
+}

package/conformance/bridge/presentation-close-request.json

@@ -0,0 +1,14 @@
+{
+  "protocolVersion": 1,
+  "channelId": "0123456789abcdef0123456789abcdef",
+  "messageId": "widget-presentation-close-1",
+  "sequence": 4,
+  "type": "capability-request",
+  "payload": {
+    "requestId": "presentation-close-1",
+    "request": {
+      "operation": "ui.presentation",
+      "input": { "action": "close" }
+    }
+  }
+}

package/conformance/bridge/presentation-close-success.json

@@ -0,0 +1,11 @@
+{
+  "protocolVersion": 1,
+  "channelId": "0123456789abcdef0123456789abcdef",
+  "messageId": "host-presentation-close-1",
+  "sequence": 6,
+  "type": "capability-result",
+  "payload": {
+    "requestId": "presentation-close-1",
+    "result": { "ok": true, "data": { "action": "close" } }
+  }
+}

package/conformance/bridge/presentation-downgrade-success.json

@@ -0,0 +1,14 @@
+{
+  "protocolVersion": 1,
+  "channelId": "0123456789abcdef0123456789abcdef",
+  "messageId": "host-presentation-downgrade-1",
+  "sequence": 5,
+  "type": "capability-result",
+  "payload": {
+    "requestId": "presentation-present-1",
+    "result": {
+      "ok": true,
+      "data": { "action": "present", "surface": "workspace" }
+    }
+  }
+}

package/conformance/bridge/presentation-focus-backward-request.json

@@ -0,0 +1,14 @@
+{
+  "protocolVersion": 1,
+  "channelId": "0123456789abcdef0123456789abcdef",
+  "messageId": "widget-presentation-focus-backward-1",
+  "sequence": 8,
+  "type": "capability-request",
+  "payload": {
+    "requestId": "presentation-focus-backward-1",
+    "request": {
+      "operation": "ui.presentation",
+      "input": { "action": "focus-boundary", "direction": "backward" }
+    }
+  }
+}

package/conformance/bridge/presentation-focus-boundary-success.json

@@ -0,0 +1,14 @@
+{
+  "protocolVersion": 1,
+  "channelId": "0123456789abcdef0123456789abcdef",
+  "messageId": "host-presentation-focus-boundary-1",
+  "sequence": 9,
+  "type": "capability-result",
+  "payload": {
+    "requestId": "presentation-focus-forward-1",
+    "result": {
+      "ok": true,
+      "data": { "action": "focus-boundary", "direction": "forward" }
+    }
+  }
+}

package/conformance/bridge/presentation-focus-forward-request.json

@@ -0,0 +1,14 @@
+{
+  "protocolVersion": 1,
+  "channelId": "0123456789abcdef0123456789abcdef",
+  "messageId": "widget-presentation-focus-forward-1",
+  "sequence": 7,
+  "type": "capability-request",
+  "payload": {
+    "requestId": "presentation-focus-forward-1",
+    "request": {
+      "operation": "ui.presentation",
+      "input": { "action": "focus-boundary", "direction": "forward" }
+    }
+  }
+}

package/conformance/bridge/presentation-init.json

@@ -0,0 +1,70 @@
+{
+  "protocolVersion": 1,
+  "channelId": "0123456789abcdef0123456789abcdef",
+  "messageId": "host-presentation-init-1",
+  "sequence": 1,
+  "type": "init",
+  "payload": {
+    "instanceId": "presentation-instance-1",
+    "locale": "en-US",
+    "theme": {
+      "mode": "light",
+      "tokens": {
+        "background": "#ffffff",
+        "foreground": "#111111",
+        "muted": "#eeeeee",
+        "mutedForeground": "#666666",
+        "border": "#dddddd",
+        "primary": "#0066cc",
+        "danger": "#cc0000"
+      }
+    },
+    "capabilities": [
+      {
+        "name": "ui.presentation",
+        "surfaces": ["floating", "overlay"],
+        "requiresHostConfirmation": true
+      }
+    ],
+    "resourceBudget": {
+      "version": 1,
+      "bundle": {
+        "compressedBytes": 1,
+        "expandedBytes": 1,
+        "fileCount": 1,
+        "singleFileBytes": 1
+      },
+      "bridge": {
+        "messageBytes": 1,
+        "messagesPerSecond": 1,
+        "pendingRequests": 1
+      },
+      "files": {
+        "readBytesPerRequest": 1,
+        "readBytesPerRun": 1,
+        "callsPerMinute": 1,
+        "listPageSize": 1
+      },
+      "timeouts": {
+        "bundleLoadMs": 1,
+        "handshakeMs": 1,
+        "firstRenderMs": 1,
+        "updateMs": 1,
+        "capabilityMs": 1,
+        "disposeGraceMs": 1
+      },
+      "concurrency": {
+        "activeIframesPerPage": 1,
+        "activeIframesPerRun": 1,
+        "hiddenRecycleMs": 1
+      },
+      "retry": {
+        "maxAttempts": 1,
+        "initialDelayMs": 1,
+        "maxDelayMs": 1,
+        "totalMs": 1
+      },
+      "failure": { "consecutiveFailures": 1, "windowMs": 1 }
+    }
+  }
+}

package/conformance/bridge/presentation-policy-denied.json

@@ -0,0 +1,16 @@
+{
+  "protocolVersion": 1,
+  "channelId": "0123456789abcdef0123456789abcdef",
+  "messageId": "host-presentation-policy-denied-1",
+  "sequence": 7,
+  "type": "capability-result",
+  "payload": {
+    "requestId": "presentation-change-1",
+    "result": {
+      "ok": false,
+      "reason": "permission-denied",
+      "message": "Host presentation policy denied the requested surface",
+      "retryable": false
+    }
+  }
+}

package/conformance/bridge/presentation-present-request.json

@@ -0,0 +1,14 @@
+{
+  "protocolVersion": 1,
+  "channelId": "0123456789abcdef0123456789abcdef",
+  "messageId": "widget-presentation-present-1",
+  "sequence": 2,
+  "type": "capability-request",
+  "payload": {
+    "requestId": "presentation-present-1",
+    "request": {
+      "operation": "ui.presentation",
+      "input": { "action": "present", "surface": "overlay" }
+    }
+  }
+}

package/conformance/bridge/presentation-user-denied.json

@@ -0,0 +1,16 @@
+{
+  "protocolVersion": 1,
+  "channelId": "0123456789abcdef0123456789abcdef",
+  "messageId": "host-presentation-user-denied-1",
+  "sequence": 8,
+  "type": "capability-result",
+  "payload": {
+    "requestId": "presentation-present-1",
+    "result": {
+      "ok": false,
+      "reason": "permission-denied",
+      "message": "User declined the presentation request",
+      "retryable": false
+    }
+  }
+}

package/conformance/bridge/ready.json

@@ -0,0 +1,11 @@
+{
+  "protocolVersion": 1,
+  "channelId": "0123456789abcdef0123456789abcdef",
+  "messageId": "widget-ready-1",
+  "sequence": 1,
+  "type": "ready",
+  "payload": {
+    "widgetSdkVersion": "0.0.1",
+    "hostApiVersion": 1
+  }
+}

package/conformance/bundles/minimal-file-preview/entry.js

@@ -0,0 +1 @@
+export const Widget = { render() {} };

package/conformance/bundles/minimal-file-preview/manifest.json

@@ -0,0 +1,12 @@
+{
+  "name": "Minimal Structure Preview",
+  "widgetConfig": {
+    "schemaVersion": 1,
+    "hostApiVersion": 1,
+    "widgetSdkVersion": "0.0.1",
+    "entry": "entry.js",
+    "slot": { "type": "file-preview", "extensions": ["cif"] },
+    "requestedCapabilities": { "files": { "metadata": true, "read": true } },
+    "samples": [{ "id": "normal", "title": "Normal", "request": "samples/file-preview.json" }]
+  }
+}

package/conformance/bundles/minimal-file-preview/samples/file-preview.json

@@ -0,0 +1 @@
+{"schemaVersion":1,"requestId":"bundle-file","instanceId":"bundle-file","revision":1,"slot":"file-preview","state":"complete","content":{"slot":"file-preview","file":{"id":"file","kind":"file","name":"x.cif","extension":"cif"}},"context":{"locale":"en-US","theme":{"mode":"light","tokens":{"background":"#fff","foreground":"#111","muted":"#eee","mutedForeground":"#666","border":"#ddd","primary":"#06c","danger":"#c00"}},"viewport":{"width":1,"height":1},"capabilities":[],"correlationId":"bundle-file"}}

package/conformance/bundles/minimal-panel/entry.js

@@ -0,0 +1 @@
+export const Widget = { render() {} };

package/conformance/bundles/minimal-panel/manifest.json

@@ -0,0 +1,11 @@
+{
+  "name": "Minimal Analysis Summary",
+  "widgetConfig": {
+    "schemaVersion": 1,
+    "hostApiVersion": 1,
+    "widgetSdkVersion": "0.0.1",
+    "entry": "entry.js",
+    "slot": { "type": "panel", "panelType": "analysis-summary" },
+    "samples": [{ "id": "normal", "title": "Normal", "request": "samples/panel.json" }]
+  }
+}

package/conformance/bundles/minimal-panel/samples/panel.json

@@ -0,0 +1 @@
+{"schemaVersion":1,"requestId":"bundle-panel","instanceId":"bundle-panel","revision":1,"slot":"panel","state":"complete","content":{"slot":"panel","panelType":"analysis-summary","data":{}},"context":{"locale":"en-US","theme":{"mode":"light","tokens":{"background":"#fff","foreground":"#111","muted":"#eee","mutedForeground":"#666","border":"#ddd","primary":"#06c","danger":"#c00"}},"viewport":{"width":1,"height":1},"capabilities":[],"correlationId":"bundle-panel"}}

package/conformance/bundles/minimal-tool-result/entry.js

@@ -0,0 +1 @@
+export const Widget = { render() {} };

package/conformance/bundles/minimal-tool-result/manifest.json

@@ -0,0 +1,11 @@
+{
+  "name": "Minimal Simulation Result",
+  "widgetConfig": {
+    "schemaVersion": 1,
+    "hostApiVersion": 1,
+    "widgetSdkVersion": "0.0.1",
+    "entry": "entry.js",
+    "slot": { "type": "tool-result", "toolName": "simulation.run" },
+    "samples": [{ "id": "normal", "title": "Normal", "request": "samples/tool-result.json" }]
+  }
+}

package/conformance/bundles/minimal-tool-result/samples/tool-result.json

@@ -0,0 +1 @@
+{"schemaVersion":1,"requestId":"bundle-tool","instanceId":"bundle-tool","revision":1,"slot":"tool-result","state":"complete","content":{"slot":"tool-result","tool":{"name":"simulation.run","callId":"call","status":"succeeded"},"input":{},"result":{}},"context":{"locale":"en-US","theme":{"mode":"light","tokens":{"background":"#fff","foreground":"#111","muted":"#eee","mutedForeground":"#666","border":"#ddd","primary":"#06c","danger":"#c00"}},"viewport":{"width":1,"height":1},"capabilities":[],"correlationId":"bundle-tool"}}

package/conformance/file-responses/list.json

@@ -0,0 +1 @@
+{"ok":true,"data":{"items":[{"id":"file-001","kind":"file","name":"result.txt"}],"nextCursor":null}}

package/conformance/file-responses/metadata.json

@@ -0,0 +1,11 @@
+{
+  "ok": true,
+  "data": {
+    "id": "file-001",
+    "kind": "file",
+    "name": "structure.cif",
+    "extension": "cif",
+    "mimeType": "chemical/x-cif",
+    "size": 128
+  }
+}

package/conformance/file-responses/permission-denied.json

@@ -0,0 +1,6 @@
+{
+  "ok": false,
+  "reason": "permission-denied",
+  "message": "Host denied this file operation",
+  "retryable": false
+}

package/conformance/file-responses/resource-limit.json

@@ -0,0 +1 @@
+{"ok":false,"reason":"resource-limit","message":"request exceeds the file read budget","retryable":false}

package/conformance/file-responses/text-content.json

@@ -0,0 +1 @@
+{"ok":true,"data":{"encoding":"utf8","content":"simulation complete"}}