@dp-bohrium/widget-cli 0.5.0 → 0.6.0

package/dist/generated-runtime-contracts-CbZY-iss.d.mts

@@ -0,0 +1,500 @@
+//#region ../widget-sdk/src/protocol/generated-runtime-contracts.d.ts
+/**
+ * 完整渲染请求联合：tool-result（内部）/ file-preview / panel。
+ */
+type RenderRequest = (ToolResultRenderRequest | FilePreviewRenderRequest | PanelRenderRequest);
+/**
+ * 历史 Host 投影类型；仅供受信任的内部 Host 与协议验证。Forge 新插件不得声明或挂载 tool-result，工具结果应由 Runtime 逻辑映射到自定义 Panel。
+ */
+type ToolResultRenderRequest = (RenderRequestBase & {
+  contribution: "tool-result";
+  content: ToolResultContent;
+});
+/**
+ * 渲染状态：loading / partial / complete / error。
+ */
+type RenderState = ("loading" | "partial" | "complete" | "error");
+/**
+ * 主题模式：light 或 dark。
+ */
+type ThemeMode = ("light" | "dark");
+/**
+ * Host 已授予的能力；多数分支附带调用与预算限制（ui.presentation / ui.region 除外）。
+ */
+type GrantedCapability = ({
+  name: "service.invoke";
+  services: WidgetServicePermissions;
+  limits: {
+    callsPerMinute: number;
+    requestBytes: number;
+    responseBytes: number;
+  };
+} | {
+  name: "files.list";
+  limits: {
+    pageSize: number;
+    callsPerMinute: number;
+  };
+} | {
+  name: "files.download";
+  limits: {
+    bytesPerRun: number;
+    callsPerMinute: number;
+  };
+} | {
+  name: "files.metadata";
+  limits: {
+    callsPerMinute: number;
+  };
+} | {
+  name: "files.read";
+  limits: {
+    bytesPerRequest: number;
+    /**
+     * @deprecated
+     * 历史读取累计额度字段，仅为兼容旧配置保留；当前 files.read 不累计或执行此额度，新宿主不再下发。
+     */
+    bytesPerRun?: number;
+    callsPerMinute: number;
+  };
+} | {
+  name: "files.write";
+  limits: {
+    bytesPerRequest: number;
+    bytesPerRun: number;
+    callsPerMinute: number;
+  };
+} | {
+  name: "events.read";
+  /**
+   * @minItems 1
+   * @maxItems 32
+   */
+  topics: [string, ...(string)[]];
+  limits: {
+    callsPerMinute: number;
+    pageSize: number;
+    minPollMs: number;
+  };
+} | {
+  name: "tasks.list";
+  limits: {
+    callsPerMinute: number;
+    pageSize: number;
+    minPollMs: number;
+  };
+} | {
+  name: "tasks.watch";
+  limits: {
+    callsPerMinute: number;
+    pageSize: number;
+    minPollMs: number;
+  };
+} | {
+  name: "ui.state";
+  limits: {
+    callsPerMinute: number;
+    bytesPerRun: number;
+    maxValueBytes: number;
+  };
+} | {
+  name: "actions.invoke";
+  /**
+   * @minItems 1
+   * @maxItems 32
+   */
+  actions: [string, ...(string)[]];
+  limits: {
+    callsPerMinute: number;
+  };
+} | {
+  name: "network.fetch";
+  limits: WidgetNetworkLimits;
+} | GrantedPresentationCapability | GrantedRegionCapability);
+/**
+ * 服务权限列表。
+ *
+ * @minItems 1
+ * @maxItems 32
+ */
+type WidgetServicePermissions = [WidgetServicePermission, ...(WidgetServicePermission)[]];
+/**
+ * 正整数。
+ */
+type PositiveInteger = number;
+/**
+ * 可序列化为 JSON 的任意值；null / boolean / number / string / 数组 / 对象的递归联合。
+ */
+type JsonValue = (null | boolean | number | string | JsonValue[] | {
+  [k: string]: JsonValue;
+});
+/**
+ * 文件预览渲染请求：公共字段 + contribution=file-preview + content。
+ */
+type FilePreviewRenderRequest = (RenderRequestBase & {
+  contribution: "file-preview";
+  content: FilePreviewContent;
+});
+/**
+ * 由存储执行端签发的文件内容版本，用于条件读取和保存；不是 RenderRequest.revision。
+ */
+type FileRevision = string;
+/**
+ * 面板渲染请求：公共字段 + contribution=panel + content。
+ */
+type PanelRenderRequest = (RenderRequestBase & {
+  contribution: "panel";
+  content: PanelContent;
+});
+/**
+ * 受控字段诊断或工程相对源码位置；不携带原始对象。
+ */
+type WidgetDiagnosticDetail = ({
+  field: string;
+  expected?: string;
+  observed?: string;
+} | {
+  file: string;
+  line: number;
+  column: number;
+  excerpt?: string;
+});
+/**
+ * 保留 transport、HTTP 与非法响应事实；不包含 URL 或原始响应。
+ */
+type WidgetDiagnosticIO = ({
+  kind: ("transport" | "invalid-response");
+  sourceCode?: string;
+} | {
+  kind: "http";
+  status: number;
+  sourceCode?: string;
+});
+/**
+ * 恢复动作的语义及类型化参数；可信宿主绑定已有工具，不包含任意命令。
+ */
+type WidgetRecoveryAction = ({
+  id: "inspect";
+  params: {
+    area: ("toolchain" | "host-bridge" | "configuration" | "bundle" | "handshake" | "render" | "capability" | "lease" | "operation-outcome" | "runtime");
+  };
+} | {
+  id: "wait";
+  params: {
+    milestone: ("budget-reset" | "connection-restored");
+    retryAfterMs?: number;
+  };
+} | {
+  id: "edit-project";
+  params: {
+    evidence: "diagnostics";
+  };
+} | {
+  id: "build-project";
+  params: {
+    target: "current-project";
+  };
+} | {
+  id: "refresh-preview";
+  params: {
+    target: "current-project";
+  };
+} | {
+  id: "verify-scenario";
+  params: {
+    target: ("current-attempt" | "next-built-generation");
+    scenarioId?: string;
+  };
+} | {
+  id: "request-external-action";
+  params: {
+    reason: ("authorization" | "host-support" | "host-start" | "credentials");
+  };
+} | {
+  id: "stop-preview";
+  params: {
+    target: "current-preview";
+  };
+});
+/**
+ * 仅表示受管渲染处理器的处理结果，不代表视觉或业务验收。
+ */
+type WidgetRenderResult = ({
+  requestId: string;
+  revision: number;
+  outcome: ("handled" | "superseded");
+} | {
+  requestId: string;
+  revision: number;
+  outcome: "failed";
+  diagnostic: WidgetRenderFailureDiagnostic;
+});
+/**
+ * 失败处理回执的 SDK 请求诊断；接收方还须匹配当前 requestId。
+ */
+type WidgetRenderFailureDiagnostic = (WidgetGuestDiagnostic & {
+  correlationId: string;
+  phase?: ("render" | "update");
+});
+/**
+ * Guest 仅声明 SDK 诊断事实，不得冒充 Host 或工具链。
+ */
+type WidgetGuestDiagnostic = (WidgetDevelopmentDiagnostic & {
+  source: "sdk";
+});
+/**
+ * 渲染请求公共字段：schemaVersion、requestId、instanceId、revision、state、context。
+ */
+interface RenderRequestBase {
+  schemaVersion: 1;
+  requestId: string;
+  instanceId: string;
+  revision: number;
+  state: RenderState;
+  context: WidgetRenderContext;
+}
+/**
+ * 渲染上下文：locale、theme、viewport、能力与关联 id。
+ */
+interface WidgetRenderContext {
+  locale: string;
+  theme: Theme;
+  viewport: {
+    width: number;
+    height: number;
+  };
+  capabilities: GrantedCapability[];
+  correlationId: string;
+}
+/**
+ * 渲染上下文中的主题：mode 与设计令牌表。
+ */
+interface Theme {
+  mode: ThemeMode;
+  tokens: {
+    background: string;
+    foreground: string;
+    muted: string;
+    mutedForeground: string;
+    border: string;
+    primary: string;
+    danger: string;
+  };
+}
+/**
+ * 单条服务权限：服务名 + 允许的动作列表。
+ */
+interface WidgetServicePermission {
+  service: string;
+  /**
+   * @minItems 1
+   * @maxItems 32
+   */
+  actions: [string, ...(string)[]];
+}
+/**
+ * Host 托管网络的限制项：超时、并发、频率与字节数。
+ */
+interface WidgetNetworkLimits {
+  timeoutMs: PositiveInteger;
+  maxRedirects: PositiveInteger;
+  maxConcurrentRequests: PositiveInteger;
+  callsPerMinute: PositiveInteger;
+  requestHeaderBytes: PositiveInteger;
+  responseHeaderBytes: PositiveInteger;
+  requestBodyBytes: PositiveInteger;
+  responseBodyBytes: PositiveInteger;
+}
+/**
+ * 已授予的呈现能力；含 surfaces，requiresHostConfirmation 恒为 true。
+ */
+interface GrantedPresentationCapability {
+  name: "ui.presentation";
+  /**
+   * @minItems 1
+   * @maxItems 2
+   */
+  surfaces: [("floating" | "overlay")] | [("floating" | "overlay"), ("floating" | "overlay")];
+  requiresHostConfirmation: true;
+}
+/**
+ * 已授予的会话右侧区域替换能力。
+ */
+interface GrantedRegionCapability {
+  name: "ui.region";
+  /**
+   * @minItems 1
+   * @maxItems 1
+   */
+  regions: ["session.rightRail"];
+  mode: "replace";
+  requiresHostConfirmation: true;
+}
+/**
+ * tool-result 渲染内容；仅内部通道使用，外部作者不挂载。
+ */
+interface ToolResultContent {
+  contribution: "tool-result";
+  tool: {
+    name: string;
+    callId: string;
+    status: ("running" | "succeeded" | "failed" | "cancelled");
+  };
+  input: JsonValue;
+  result?: JsonValue;
+  envelope?: ToolResultEnvelope;
+  error?: {
+    code: string;
+    message: string;
+  };
+}
+/**
+ * 工具执行结果信封；仅供受信任的内部 Host 与 Agent 事件，不进入作者 Contribution。
+ */
+interface ToolResultEnvelope {
+  schemaVersion: 1;
+  status: ("running" | "succeeded" | "failed" | "cancelled");
+  summary?: string;
+  data?: JsonValue;
+  /**
+   * @maxItems 64
+   */
+  metrics?: ToolResultMetric[];
+  /**
+   * @maxItems 64
+   */
+  artifacts?: ToolResultArtifact[];
+  /**
+   * @maxItems 32
+   */
+  provenance?: ToolResultProvenance[];
+  /**
+   * @maxItems 32
+   */
+  warnings?: ToolResultNotice[];
+  /**
+   * @maxItems 32
+   */
+  missing?: ToolResultNotice[];
+}
+/**
+ * 工具结果中的单个指标。
+ */
+interface ToolResultMetric {
+  name: string;
+  value: number;
+  unit?: string;
+  label?: string;
+}
+/**
+ * 工具结果中的产物元数据，不含内容本身。
+ */
+interface ToolResultArtifact {
+  id: string;
+  name: string;
+  kind?: ("file" | "directory");
+  mimeType?: string;
+  size?: number;
+  downloadable?: boolean;
+}
+/**
+ * 工具结果的来源信息。
+ */
+interface ToolResultProvenance {
+  source: string;
+  kind?: string;
+  label?: string;
+}
+/**
+ * 工具结果中的提示或警告。
+ */
+interface ToolResultNotice {
+  code: string;
+  message: string;
+}
+/**
+ * 文件预览内容；contribution 必须为 file-preview。
+ */
+interface FilePreviewContent {
+  contribution: "file-preview";
+  file: FileReference;
+  preview?: JsonValue;
+}
+/**
+ * Host 签发的文件引用；仅含不透明 id、可选内容版本和展示元数据。引用本身不授予写权限，不含路径或 URL。
+ */
+interface FileReference {
+  id: string;
+  kind: ("file" | "directory");
+  name: string;
+  extension?: string;
+  mimeType?: string;
+  size?: number;
+  revision?: FileRevision;
+}
+/**
+ * 面板内容；contribution 必须为 panel。
+ */
+interface PanelContent {
+  contribution: "panel";
+  id: string;
+  title?: string;
+  data: JsonValue;
+}
+/**
+ * 可信出口的标准诊断；恢复指令和 scope 由宿主另行生成。
+ */
+interface WidgetDevelopmentDiagnostic {
+  schemaVersion: 1;
+  source: ("sdk" | "host" | "toolchain");
+  code: string;
+  sourceCode?: string;
+  phase: ("discovery" | "build" | "config" | "load" | "handshake" | "render" | "update" | "capability" | "dispose");
+  sourcePhase?: string;
+  operation: string;
+  severity: ("warning" | "request-error" | "instance-failure");
+  message: string;
+  retryable?: boolean;
+  correlationId?: string;
+  /**
+   * @maxItems 8
+   */
+  diagnostics?: [] | [WidgetDiagnosticDetail] | [WidgetDiagnosticDetail, WidgetDiagnosticDetail] | [WidgetDiagnosticDetail, WidgetDiagnosticDetail, WidgetDiagnosticDetail] | [WidgetDiagnosticDetail, WidgetDiagnosticDetail, WidgetDiagnosticDetail, WidgetDiagnosticDetail] | [WidgetDiagnosticDetail, WidgetDiagnosticDetail, WidgetDiagnosticDetail, WidgetDiagnosticDetail, WidgetDiagnosticDetail] | [WidgetDiagnosticDetail, WidgetDiagnosticDetail, WidgetDiagnosticDetail, WidgetDiagnosticDetail, WidgetDiagnosticDetail, WidgetDiagnosticDetail] | [WidgetDiagnosticDetail, WidgetDiagnosticDetail, WidgetDiagnosticDetail, WidgetDiagnosticDetail, WidgetDiagnosticDetail, WidgetDiagnosticDetail, WidgetDiagnosticDetail] | [WidgetDiagnosticDetail, WidgetDiagnosticDetail, WidgetDiagnosticDetail, WidgetDiagnosticDetail, WidgetDiagnosticDetail, WidgetDiagnosticDetail, WidgetDiagnosticDetail, WidgetDiagnosticDetail];
+  io?: WidgetDiagnosticIO;
+}
+/**
+ * 可信宿主观察到的恢复进展；重复故障无新证据时不能重复同一修复。
+ */
+interface WidgetRecoveryProgress {
+  repeated: boolean;
+  hasNewEvidence: boolean;
+}
+/**
+ * 可信宿主选择的恢复计划；不能由 Guest 的诊断 payload 指定。
+ */
+interface WidgetRecoveryPlan {
+  progress?: WidgetRecoveryProgress;
+  schemaVersion: 1;
+  ruleId: string;
+  ruleVersion: number;
+  disposition: ("retry" | "repair" | "inspect" | "external-action" | "stop");
+  nextAction: WidgetRecoveryAction;
+  verification: WidgetRecoveryVerification;
+  guidance: string;
+  /**
+   * 首项动作完成后的有限恢复步骤；宿主逐步验证前置条件，不原样盲目重放。
+   *
+   * @maxItems 8
+   */
+  followUpActions: [] | [WidgetRecoveryAction] | [WidgetRecoveryAction, WidgetRecoveryAction] | [WidgetRecoveryAction, WidgetRecoveryAction, WidgetRecoveryAction] | [WidgetRecoveryAction, WidgetRecoveryAction, WidgetRecoveryAction, WidgetRecoveryAction] | [WidgetRecoveryAction, WidgetRecoveryAction, WidgetRecoveryAction, WidgetRecoveryAction, WidgetRecoveryAction] | [WidgetRecoveryAction, WidgetRecoveryAction, WidgetRecoveryAction, WidgetRecoveryAction, WidgetRecoveryAction, WidgetRecoveryAction] | [WidgetRecoveryAction, WidgetRecoveryAction, WidgetRecoveryAction, WidgetRecoveryAction, WidgetRecoveryAction, WidgetRecoveryAction, WidgetRecoveryAction] | [WidgetRecoveryAction, WidgetRecoveryAction, WidgetRecoveryAction, WidgetRecoveryAction, WidgetRecoveryAction, WidgetRecoveryAction, WidgetRecoveryAction, WidgetRecoveryAction];
+}
+/**
+ * 恢复复验目标；下一成功构建须在取得回执后绑定实际产物。
+ */
+interface WidgetRecoveryVerification {
+  target: ("current-attempt" | "next-built-generation" | "original-operation");
+  milestone: ("diagnostics-updated" | "render-handled" | "scenario-passed" | "operation-confirmed");
+  scenarioId?: string;
+}
+//#endregion
+export { WidgetRenderResult as i, WidgetDevelopmentDiagnostic as n, WidgetRecoveryPlan as r, RenderRequest as t };

package/llms.txt

@@ -41,8 +41,8 @@ pnpm exec bohr-widget --version --json
 - `integration --json`: `interfaceVersion=3`，返回固定 profile、执行器位置、
   `toolchain.formatVersion=3` 和 `documentation { url, quickStart, cli, llms, llmsFull }`，
   不返回 `skills`。已有工程加 `--project <目录>` 核对锁定，再读取对应参考。
-- `create`: 创建 vanilla 或 React 工程并写 `widget-toolchain.json`；工作区文件面板使用
-  `--panel-id workspace-files`。
+- `create`: 创建 vanilla 或 React 工程并写 `widget-toolchain.json`；Panel ID 可自定义，
+  `--panel-id workspace-files` 是可选的文件浏览面板预设。
 - `adopt`: 为旧工程显式写入工具链锁，先核对精确依赖、实际 SDK 与内置协议摘要、Manifest 和 samples。
 - SDK 0.5.0 的任务 Panel 在 Manifest 声明 `capabilities.tasks.list`；需要观察单个任务时再声明
   `tasks.watch`。列表刷新遵守 grant 的 `minPollMs`，面板不可见后停止轮询；CLI 校验通过不代表

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dp-bohrium/widget-cli",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Bohrium Widget 插件工程的创建、校验、开发和打包工具。",
   "license": "MIT",
   "type": "module",
@@ -46,24 +46,21 @@
     "@types/node": "^22.15.0",
     "tsdown": "0.22.14",
     "typescript": "5.9.3",
-    "@dp-bohrium/widget-contracts": "0.7.0",
-    "@dp-bohrium/widget-contract-testing": "0.1.0-alpha.0",
-    "@dp-bohrium/widget-sdk": "0.7.0"
+    "@dp-bohrium/widget-sdk": "0.9.0"
   },
   "sideEffects": false,
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
-    "build:assets": "node scripts/build-assets.mjs",
-    "build:types": "tsdown --config types.tsdown.config.ts",
     "package:contents": "node ../../scripts/quality/check-widget-cli-package-contents.mjs ../../.artifacts/dp-bohrium-widget-cli-*.tgz",
-    "build:inputs": "pnpm --filter @dp-bohrium/widget-sdk... run build && pnpm --filter @dp-bohrium/widget-contract-testing run build",
-    "build": "pnpm build:inputs && pnpm build:assets && tsdown && pnpm build:types && node --check dist/cli.mjs",
-    "typecheck": "node --check src/cli.mjs && node --check src/help.mjs && node --check src/core.mjs && node --check src/templates.mjs && node --check src/toolchain.mjs && node --check src/project-executor.mjs && node --check scripts/build-assets.mjs",
-    "test": "pnpm build:inputs && pnpm build:assets && pnpm build:types && node --test test/*.test.mjs",
+    "build": "node ../../scripts/build/widget-build.mjs cli",
+    "typecheck": "node --check src/cli.mjs && node --check src/help.mjs && node --check src/core.mjs && node --check src/templates.mjs && node --check src/toolchain.mjs && node --check src/project-executor.mjs && node --check scripts/build-assets.mjs && tsc --project tsconfig.project.json",
+    "test": "node ../../scripts/build/with-build.mjs all -- node --test test/*.test.mjs test/project/*.test.mjs",
     "lint": "biome check src test scripts",
     "format:check": "biome check --linter-enabled=false src test scripts",
-    "check": "pnpm --filter @dp-bohrium/widget-contracts build && pnpm --filter @dp-bohrium/widget-contract-testing build && pnpm --filter widget-project build && pnpm typecheck && pnpm test && pnpm lint && pnpm format:check && pnpm build"
+    "check": "pnpm typecheck && pnpm test && pnpm lint && pnpm format:check && pnpm build",
+    "test:coverage": "node ../../scripts/build/with-build.mjs all -- node --experimental-test-coverage --test-coverage-include=src/project/*.mjs --test-coverage-lines=80 --test-coverage-functions=80 --test-coverage-branches=70 --test test/project/*.test.mjs",
+    "build:tools": "node ../../scripts/build/widget-build.mjs tools"
   }
 }

package/assets/licenses/widget-contracts.LICENSE

@@ -1,21 +0,0 @@
-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.