@dp-bohrium/widget-sdk 0.6.0 → 0.7.0

package/dist/protocol/index.d.ts

@@ -0,0 +1,43 @@
+/** Public Widget contract surface. Runtime host/client APIs are deferred. */
+import type { FallbackBinding, LoadableBinding } from "./generated-host-runtime-config.js";
+import type { BridgeEnvelopeBase, GrantedCapability, HostToWidgetMessage, RenderRequest, WidgetError, WidgetToHostMessage } from "./generated-runtime-contracts.js";
+/**
+ * Every type is re-exported from the module generated out of the schema that
+ * owns it. The Host Config module also contains inlined `$ref` copies of
+ * Manifest and Runtime definitions; re-exporting those copies would let the
+ * public surface drift from the canonical contract.
+ */
+export type { FallbackBinding, HostServiceAuthorization, HostServiceAuthorizationGranted, HostServiceAuthorizationRequired, LoadableBinding, NetworkAuthority, RuntimeAuthority, WidgetHostRuntimeConfig, WidgetServiceAccess, } from "./generated-host-runtime-config.js";
+export type { ActivationEvents, HostUserPermission, HostUserPermissions, RequestedPresentationCapability, RequestedRegionCapability, StateCapabilityRequest, TasksCapabilityRequest, WidgetContributionConfig, WidgetManifest, } from "./generated-manifest.js";
+export type { WidgetContribution, WidgetFilePreviewContribution, WidgetPanelContribution, WidgetPluginContributions, } from "./generated-plugin-manifest.js";
+export type { BridgeEnvelopeBase, CapabilityRequest, CapabilityRequestMessage, CapabilityResult, CapabilityResultMessage, ComputeReviewRequestedPublicWidgetEvent, ComputeReviewRequestedPublicWidgetEventPayload, DisposeMessage, EmptyPublicWidgetEventPayload, ErrorMessage, FileDownloadResult, FileMutationId, FilePreviewContent, FilePreviewRenderRequest, FileReadInput, FileReadResult, FileReference, FileRevision, FileWriteInput, FileWriteResult, FocusBoundaryPresentationCapabilityRequest, GrantedCapability, GrantedPresentationCapability, GrantedRegionCapability, HostToWidgetMessage, HostUserAction, HostUserEmailReadInput, HostUserEmailReadOutput, HostUserProfileReadInput, HostUserProfileReadOutput, HostUserService, HostUserServiceRequest, InitMessage, InitPayload, JsonValue, PanelContent, PanelRenderRequest, PresentationCapabilityOutput, PresentationCapabilityRequest, PresentationCapabilityResult, PublicWidgetEvent, PublicWidgetEventBase, PublicWidgetEventId, PublicWidgetEventOccurredAt, PublicWidgetEventTopic, PublicWidgetSessionId, PublicWidgetWorkflowId, ReadyMessage, RegionCapabilityRequest, RegionCapabilityResult, RenderMessage, RenderRequest, RenderRequestBase, RenderState, ResizeMessage, ResourceBudget, SandboxApprovalRequestedPublicWidgetEvent, SandboxApprovalRequestedPublicWidgetEventPayload, SandboxApprovedPublicWidgetEvent, SandboxApprovedPublicWidgetEventPayload, SandboxDeniedPublicWidgetEvent, TaskListField, TaskListItem, TaskListPage, TaskObservationBatch, TaskObservationEvent, TaskObservationSnapshot, TaskStatus, Theme, ThemeMode, ToolCallPublicWidgetEvent, ToolCallPublicWidgetEventPayload, ToolLifecycleEvent, ToolResultArtifact, ToolResultContent, ToolResultEnvelope, ToolResultMetric, ToolResultNotice, ToolResultProvenance, ToolResultPublicWidgetEvent, ToolResultPublicWidgetEventPayload, ToolResultRenderRequest, UiStateResult, UiStateWriteResult, UserInputRequestedPublicWidgetEvent, UserInputRequestedPublicWidgetEventPayload, WidgetContributionKind, WidgetError, WidgetEvent, WidgetEventBatch, WidgetEventMessage, WidgetLiveEvent, WidgetNetworkFetchInput, WidgetNetworkFetchOutput, WidgetNetworkLimits, WidgetRenderContext, WidgetServicePermission, WidgetServicePermissions, WidgetToHostMessage, WorkflowDonePublicWidgetEvent, WorkflowDonePublicWidgetEventPayload, WorkflowErrorPublicWidgetEvent, WorkflowErrorPublicWidgetEventPayload, WorkflowStartedPublicWidgetEvent, WorkflowStartedPublicWidgetEventPayload, } from "./generated-runtime-contracts.js";
+export type { WidgetActivationEvent, WidgetActivationEvents, WidgetPluginManifest, WidgetToolPhase, } from "./plugin-manifest.js";
+export { isWidgetActivationEvent, WIDGET_ACTIVATION_EVENTS, } from "./plugin-manifest.js";
+export type { WidgetEventName } from "./widget-events.js";
+export { isWidgetEventName, WIDGET_EVENT_NAMES } from "./widget-events.js";
+/**
+ * Host API 协议版本，当前固定为 `1`，由各 Schema 的 `hostApiVersion`（`const: 1`）
+ * 唯一决定。它与包 SemVer 正交，不要用 `2` 之类不存在的值。
+ */
+export type HostApiVersion = 1;
+/** `RenderRequest` 的等价别名；用 `request.contribution` 收窄后访问对应 `content`。 */
+export type WidgetRenderRequest = RenderRequest;
+/** Host → Widget 与 Widget → Host 双向 Bridge 消息的联合。 */
+export type WidgetProtocolMessage = HostToWidgetMessage | WidgetToHostMessage;
+/**
+ * `GrantedCapability` 中只读文件能力名的联合：
+ * `files.list` / `files.metadata` / `files.read` / `files.download`；不包含 `files.write`。
+ */
+export type ReadonlyFileCapability = Extract<GrantedCapability["name"], "files.list" | "files.metadata" | "files.read" | "files.download">;
+/** `WidgetError.code` 的字符串字面量联合。 */
+export type WidgetErrorCode = WidgetError["code"];
+/**
+ * 带泛型 `type` / `payload` 的 Bridge 信封；默认 `type` 为 string、`payload` 为
+ * unknown。具体消息建议直接用 `HostToWidgetMessage` / `WidgetToHostMessage` 的成员。
+ */
+export type BridgeEnvelope<TType extends string = string, TPayload = unknown> = BridgeEnvelopeBase & {
+    type: TType;
+    payload: TPayload;
+};
+/** 可加载绑定与降级绑定的联合，即 Host Runtime Config 中一条 binding 的两种结果。 */
+export type ResolvedWidgetBinding = LoadableBinding | FallbackBinding;

package/dist/protocol/plugin-manifest.d.ts

@@ -0,0 +1,30 @@
+import type { WidgetPluginManifest as GeneratedWidgetPluginManifest } from "./generated-plugin-manifest.js";
+/** 工具调用事件阶段；用于拼出 `tool-call-<phase>:<toolName>` 形式的激活事件。 */
+export type WidgetToolPhase = "generating" | "waiting" | "running" | "result" | "error";
+/**
+ * Widget Host 公开的固定激活事件。数组同时作为清单编辑器文档和 Host
+ * 运行时校验的单一事实源；带工具名的事件使用下方的动态形式。
+ */
+export declare const WIDGET_ACTIVATION_EVENTS: readonly ["session.start", "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"];
+type WidgetFixedActivationEvent = (typeof WIDGET_ACTIVATION_EVENTS)[number];
+/**
+ * `activationEvents` 可声明的值：固定事件，或按工具名筛选的
+ * `tool-call-<phase>:<toolName>` 动态形式。
+ */
+export type WidgetActivationEvent = WidgetFixedActivationEvent | `tool-call-${WidgetToolPhase}:${string}`;
+/** 至少一个元素、按声明顺序的只读激活事件元组（作者侧清单使用）。 */
+export type WidgetActivationEvents = readonly [
+    WidgetActivationEvent,
+    ...WidgetActivationEvent[]
+];
+/**
+ * 判断一个字符串是否为合法激活事件（固定事件或带工具名的动态形式）。
+ * @param value 待检查的字符串。
+ * @returns 若命中固定目录或工具事件模式则收窄为 `WidgetActivationEvent`。
+ */
+export declare function isWidgetActivationEvent(value: unknown): value is WidgetActivationEvent;
+/** 作者侧 Manifest 类型；激活事件类型与 JSON Schema 共用同一事实源。 */
+export type WidgetPluginManifest = Omit<GeneratedWidgetPluginManifest, "activationEvents"> & {
+    readonly activationEvents?: WidgetActivationEvents;
+};
+export {};

package/dist/protocol/widget-events.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Host 主动推送给已激活 Widget 的实时事件。`session.start` 只用于激活索引，
+ * 不属于这组运行期事件；激活后首个可用快照通过 `context.render` 交付。
+ */
+export declare const WIDGET_EVENT_NAMES: readonly ["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"];
+/** `context.events.on` 可监听的实时事件名；不含仅用于激活的 `session.start`。 */
+export type WidgetEventName = (typeof WIDGET_EVENT_NAMES)[number];
+/**
+ * 判断一个字符串是否为合法的实时事件名。
+ * @param value 待检查的字符串。
+ * @returns 若 `value` 命中 `WIDGET_EVENT_NAMES` 则收窄为 `WidgetEventName`。
+ */
+export declare function isWidgetEventName(value: unknown): value is WidgetEventName;

package/dist/runtime/bootstrap.d.ts

@@ -1,4 +1,4 @@
-import type { CapabilityRequest, CapabilityResult, InitPayload, PresentationCapabilityResult, RegionCapabilityResult, RenderRequest, WidgetError, WidgetLiveEvent } from "@dp-bohrium/widget-contracts";
+import type { CapabilityRequest, CapabilityResult, InitPayload, PresentationCapabilityResult, RegionCapabilityResult, RenderRequest, WidgetError, WidgetLiveEvent } from "../protocol/index.js";
 import { type PresentationFocusDirection, type PresentationSurface, type RegionName, type WidgetCapabilityRequestOptions, type WidgetClientEvents, type WidgetClientState } from "./client.js";
 import { type SubscribeWidgetEventsOptions, type WidgetEventSubscription, type WidgetToolHooks } from "./events.js";
 import type { WidgetNetworkClient } from "./network.js";

package/dist/runtime/client.d.ts

@@ -1,4 +1,4 @@
-import type { CapabilityRequest, CapabilityResult, GrantedCapability, InitPayload, PresentationCapabilityRequest, PresentationCapabilityResult, RegionCapabilityRequest, RegionCapabilityResult, RenderRequest, WidgetError, WidgetLiveEvent } from "@dp-bohrium/widget-contracts";
+import type { CapabilityRequest, CapabilityResult, GrantedCapability, InitPayload, PresentationCapabilityRequest, PresentationCapabilityResult, RegionCapabilityRequest, RegionCapabilityResult, RenderRequest, WidgetError, WidgetLiveEvent } from "../protocol/index.js";
 import { type WidgetNetworkClient } from "./network.js";
 import type { WidgetTransport } from "./transport.js";
 export type WidgetClientState = "created" | "waiting-ready" | "ready" | "disposed";

package/dist/runtime/event-validation.d.ts

@@ -1,3 +1,3 @@
-import type { ToolLifecycleEvent, WidgetEventBatch } from "@dp-bohrium/widget-contracts";
+import type { ToolLifecycleEvent, WidgetEventBatch } from "../protocol/index.js";
 export declare function parseWidgetEventBatch(value: unknown): WidgetEventBatch;
 export declare function parseToolLifecycleEvent(value: unknown): ToolLifecycleEvent;

package/dist/runtime/events.d.ts

@@ -1,4 +1,4 @@
-import type { CapabilityRequest, GrantedCapability, ToolLifecycleEvent, WidgetEventBatch } from "@dp-bohrium/widget-contracts";
+import type { CapabilityRequest, GrantedCapability, ToolLifecycleEvent, WidgetEventBatch } from "../protocol/index.js";
 export interface WidgetEventSubscription {
     readonly cursor: string | undefined;
     readonly closed: Promise<void>;

package/dist/runtime/files.d.ts

@@ -1,4 +1,4 @@
-import type { CapabilityRequest, CapabilityResult, FileReadInput, FileReadResult, FileWriteInput, FileWriteResult } from "@dp-bohrium/widget-contracts";
+import type { CapabilityRequest, CapabilityResult, FileReadInput, FileReadResult, FileWriteInput, FileWriteResult } from "../protocol/index.js";
 import type { WidgetCapabilityRequestOptions, WidgetClientState } from "./client.js";
 type Failure = Extract<CapabilityResult, {
     ok: false;

package/dist/runtime/index.d.ts

@@ -1,4 +1,4 @@
-export type { RegionCapabilityResult } from "@dp-bohrium/widget-contracts";
+export type { RegionCapabilityResult } from "../protocol/index.js";
 export type { CreateWidgetClientOptions, WidgetClientFactoryOptions, WidgetDisposeEvent, WidgetHostConnectMessage, WidgetLiveEventContext, WidgetLiveEventHandler, WidgetLiveEventName, WidgetRuntimeWindow, WidgetSize, } from "./bootstrap.js";
 export { createWidgetClient, isWidgetHostConnectMessage, WIDGET_BOOTSTRAP_READY, WIDGET_HOST_CONNECT, WIDGET_SDK_VERSION, WidgetRuntimeClient, } from "./bootstrap.js";
 export type { PresentationFocusDirection, PresentationSurface, RegionName, WidgetCapabilityRequestOptions, WidgetClientEvents, WidgetClientOptions, WidgetClientState, } from "./client.js";

package/dist/runtime/index.js

@@ -1,3 +1,3 @@
-import { a as isWidgetHostConnectMessage, c as WidgetClient, i as createWidgetClient, l as WIDGET_SDK_VERSION, n as WIDGET_HOST_CONNECT, o as PRESENTATION_CONFIRMATION_TIMEOUT_MS, r as WidgetRuntimeClient, s as REGION_CONFIRMATION_TIMEOUT_MS, t as WIDGET_BOOTSTRAP_READY } from "../runtime-D7KxTtdu.js";
+import { a as isWidgetHostConnectMessage, c as WidgetClient, i as createWidgetClient, l as WIDGET_SDK_VERSION, n as WIDGET_HOST_CONNECT, o as PRESENTATION_CONFIRMATION_TIMEOUT_MS, r as WidgetRuntimeClient, s as REGION_CONFIRMATION_TIMEOUT_MS, t as WIDGET_BOOTSTRAP_READY } from "../runtime-DZA7Gqzl.js";
 import { i as isWidgetProtocolMessage, r as MessagePortTransport } from "../protocol-endpoint-CDz-YDGT.js";
 export { MessagePortTransport, PRESENTATION_CONFIRMATION_TIMEOUT_MS, REGION_CONFIRMATION_TIMEOUT_MS, WIDGET_BOOTSTRAP_READY, WIDGET_HOST_CONNECT, WIDGET_SDK_VERSION, WidgetClient, WidgetRuntimeClient, createWidgetClient, isWidgetHostConnectMessage, isWidgetProtocolMessage };

package/dist/runtime/mock-host.d.ts

@@ -1,4 +1,4 @@
-import type { CapabilityRequest, CapabilityResult, InitPayload, RenderRequest, WidgetError } from "@dp-bohrium/widget-contracts";
+import type { CapabilityRequest, CapabilityResult, InitPayload, RenderRequest, WidgetError } from "../protocol/index.js";
 import type { WidgetTransport } from "./transport.js";
 export type MockWidgetHostState = "created" | "waiting-ready" | "ready" | "disposed";
 export interface MockWidgetHostOptions {

package/dist/runtime/network.d.ts

@@ -1,4 +1,4 @@
-import type { CapabilityRequest, CapabilityResult, WidgetNetworkFetchInput, WidgetNetworkFetchOutput } from "@dp-bohrium/widget-contracts";
+import type { CapabilityRequest, CapabilityResult, WidgetNetworkFetchInput, WidgetNetworkFetchOutput } from "../protocol/index.js";
 import type { WidgetCapabilityRequestOptions, WidgetClientState } from "./client.js";
 export type WidgetNetworkFetchResult = Readonly<{
     ok: true;

package/dist/runtime/protocol-endpoint.d.ts

@@ -1,4 +1,4 @@
-import type { WidgetProtocolMessage } from "@dp-bohrium/widget-contracts";
+import type { WidgetProtocolMessage } from "../protocol/index.js";
 import { type WidgetTransport } from "./transport.js";
 declare const envelopeFields: readonly ["protocolVersion", "channelId", "messageId", "sequence"];
 type EnvelopeField = (typeof envelopeFields)[number];

package/dist/runtime/service.d.ts

@@ -1,4 +1,4 @@
-import type { CapabilityRequest, CapabilityResult, JsonValue } from "@dp-bohrium/widget-contracts";
+import type { CapabilityRequest, CapabilityResult, JsonValue } from "../protocol/index.js";
 import type { WidgetCapabilityRequestOptions, WidgetClientState } from "./client.js";
 export type WidgetServiceInvokeInput = Extract<CapabilityRequest, {
     operation: "service.invoke";
@@ -37,7 +37,7 @@ export interface WidgetHostUserClient {
 }
 interface Dependencies {
     readonly state: () => WidgetClientState;
-    readonly grant: () => Extract<import("@dp-bohrium/widget-contracts").GrantedCapability, {
+    readonly grant: () => Extract<import("../protocol/index.js").GrantedCapability, {
         name: "service.invoke";
     }> | undefined;
     readonly request: (request: CapabilityRequest, options?: WidgetCapabilityRequestOptions) => Promise<CapabilityResult>;

package/dist/runtime/transport.d.ts

@@ -1,4 +1,4 @@
-import type { WidgetProtocolMessage } from "@dp-bohrium/widget-contracts";
+import type { WidgetProtocolMessage } from "../protocol/index.js";
 export interface WidgetTransport {
     send(message: WidgetProtocolMessage): void;
     onMessage(listener: (message: WidgetProtocolMessage) => void): () => void;

package/dist/{runtime-D7KxTtdu.js → runtime-DZA7Gqzl.js}

@@ -2,7 +2,7 @@ import { r as MessagePortTransport, t as ProtocolEndpoint } from "./protocol-end
 //#endregion
 //#region src/runtime/version.ts
 /** 从当前安装的 SDK package.json 读取版本，插件作者不需要重复填写。 */
-const WIDGET_SDK_VERSION = "0.6.0";
+const WIDGET_SDK_VERSION = "0.7.0";
 //#endregion
 //#region src/runtime/network.ts
 const failureReasons = /* @__PURE__ */ new Set([

package/dist/widget-events-BT0QxR-H.js

@@ -0,0 +1,65 @@
+//#region ../contracts/src/plugin-manifest.ts
+/**
+* Widget Host 公开的固定激活事件。数组同时作为清单编辑器文档和 Host
+* 运行时校验的单一事实源；带工具名的事件使用下方的动态形式。
+*/
+const WIDGET_ACTIVATION_EVENTS = [
+	"session.start",
+	"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"
+];
+const TOOL_EVENT_PATTERN = /^(?:tool-call-(?:generating|waiting|running|result|error)):[A-Za-z0-9_.:-]+$/u;
+/**
+* 判断一个字符串是否为合法激活事件（固定事件或带工具名的动态形式）。
+* @param value 待检查的字符串。
+* @returns 若命中固定目录或工具事件模式则收窄为 `WidgetActivationEvent`。
+*/
+function isWidgetActivationEvent(value) {
+	return typeof value === "string" && (WIDGET_ACTIVATION_EVENTS.includes(value) || TOOL_EVENT_PATTERN.test(value));
+}
+//#endregion
+//#region ../contracts/src/widget-events.ts
+/**
+* Host 主动推送给已激活 Widget 的实时事件。`session.start` 只用于激活索引，
+* 不属于这组运行期事件；激活后首个可用快照通过 `context.render` 交付。
+*/
+const WIDGET_EVENT_NAMES = [
+	"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"
+];
+/**
+* 判断一个字符串是否为合法的实时事件名。
+* @param value 待检查的字符串。
+* @returns 若 `value` 命中 `WIDGET_EVENT_NAMES` 则收窄为 `WidgetEventName`。
+*/
+function isWidgetEventName(value) {
+	return typeof value === "string" && WIDGET_EVENT_NAMES.includes(value);
+}
+//#endregion
+export { isWidgetActivationEvent as i, isWidgetEventName as n, WIDGET_ACTIVATION_EVENTS as r, WIDGET_EVENT_NAMES as t };

package/dist/widget.d.ts

@@ -1,4 +1,4 @@
-import type { CapabilityRequest, CapabilityResult, FileDownloadResult, FileReadInput, FileReference, FileWriteInput, GrantedCapability, RegionCapabilityResult, RenderRequest, TaskListPage, TaskObservationBatch, Theme, UiStateResult, UiStateWriteResult, WidgetEventName, WidgetLiveEvent } from "@dp-bohrium/widget-contracts";
+import type { CapabilityRequest, CapabilityResult, FileDownloadResult, FileReadInput, FileReference, FileWriteInput, GrantedCapability, RegionCapabilityResult, RenderRequest, TaskListPage, TaskObservationBatch, Theme, UiStateResult, UiStateWriteResult, WidgetEventName, WidgetLiveEvent } from "./protocol/index.js";
 import { type FileReadCapabilityResult, type FileWriteCapabilityResult } from "./runtime/files.js";
 import { type CreateWidgetClientOptions, type RegionName, type WidgetClientFactoryOptions, type WidgetClientState, type WidgetLiveEventContext, type WidgetLiveEventHandler } from "./runtime/index.js";
 import type { WidgetNetworkClient } from "./runtime/network.js";
@@ -96,7 +96,7 @@ export interface WidgetUiStateApi {
         readonly timeoutMs?: number;
         readonly signal?: AbortSignal;
     }): Promise<UiStateReadCapabilityResult>;
-    write(key: string, value: import("@dp-bohrium/widget-contracts").JsonValue, options?: {
+    write(key: string, value: import("./protocol/index.js").JsonValue, options?: {
         readonly timeoutMs?: number;
         readonly signal?: AbortSignal;
     }): Promise<UiStateWriteCapabilityResult>;

package/llms.txt

@@ -20,9 +20,8 @@
 - Host 协议校验语料：`@dp-bohrium/widget-sdk/conformance/*`
 - 工程命令：SDK 包内 `bohr-widget`（首次创建可用 `pnpm dlx @dp-bohrium/widget-sdk create ...`）
 
-消费方直接声明或导入 contracts 的旧用法已废弃；统一入口切换发布 R1 前迁到 SDK 子入口。
-contracts 仍维护内部唯一源，不恢复旧作者执行器来支持历史工程。
-新工程只直接声明精确 SDK 版本；`@dp-bohrium/widget-cli` 只按现行发布治理保留过渡分发、历史审计和废弃诊断，不由 SDK 回选。
+作者工程使用精确 SDK 版本，通过上述入口获取运行时、协议、测试工具与工程命令。
+升级旧工程时，按迁移指南准备候选并重新构建，不复用不匹配的执行器或旧 receipt。
 
 ## 使用原则
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dp-bohrium/widget-sdk",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Bohrium Widget 开发者 SDK：在 Widget Bundle 内与 Host 建立 Bridge，并暴露生命周期与能力协议。",
   "license": "MIT",
   "type": "module",
@@ -59,9 +59,6 @@
   "publishConfig": {
     "access": "public"
   },
-  "dependencies": {
-    "@dp-bohrium/widget-contracts": "0.6.0"
-  },
   "devDependencies": {
     "@biomejs/biome": "^2.2.0",
     "@vitest/coverage-v8": "^3.2.4",
@@ -69,10 +66,11 @@
     "tsdown": "0.22.14",
     "typescript": "^5.8.3",
     "vitest": "^3.2.4",
+    "@dp-bohrium/widget-contracts": "0.7.0",
     "@dp-bohrium/widget-contract-testing": "0.1.0-alpha.0"
   },
   "scripts": {
-    "build:runtime": "tsdown && tsc -b tsconfig.build.json --force --pretty false && node ../../scripts/schema/build-sdk-assets.mjs",
+    "build:runtime": "pnpm --filter @dp-bohrium/widget-contracts run build && tsdown && tsc -b tsconfig.build.json --force --pretty false && node ../../scripts/schema/build-sdk-assets.mjs",
     "build:cli": "node ../../scripts/schema/build-sdk-cli-assets.mjs && tsdown --config widget-cli.tsdown.config.ts && node --check dist/cli.mjs",
     "build": "pnpm build:runtime && pnpm --filter @dp-bohrium/widget-contract-testing build && pnpm build:cli",
     "typecheck": "tsc --noEmit",
@@ -86,7 +84,7 @@
     "lint": "biome check src test",
     "format:check": "biome check --linter-enabled=false src test",
     "package:contents": "node ../../scripts/quality/check-sdk-package-contents.mjs ../../.artifacts/dp-bohrium-widget-sdk-*.tgz",
-    "consumer:canary": "CONSUMER_PACKAGE_NAME=@dp-bohrium/widget-sdk node ../../scripts/consumer/consumer-install.mjs ../../.artifacts/dp-bohrium-widget-sdk-*.tgz ../../.artifacts/dp-bohrium-widget-contracts-*.tgz",
+    "consumer:canary": "node ../../scripts/consumer/consumer-sdk-install.mjs ../../.artifacts/dp-bohrium-widget-sdk-*.tgz",
     "release:check-version": "WIDGET_PACKAGE_NAME=@dp-bohrium/widget-sdk node ../../scripts/release/check-registry-version.mjs",
     "check": "pnpm typecheck && pnpm test && pnpm fixture:build && pnpm fixture:pack:test && pnpm lint && pnpm format:check && pnpm --filter @dp-bohrium/widget-contract-testing build && pnpm build && pnpm fixture:pack && pnpm fixture:check"
   }

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

@@ -821,7 +821,6 @@
               "additionalProperties": false,
               "required": [
                 "bytesPerRequest",
-                "bytesPerRun",
                 "callsPerMinute"
               ],
               "properties": {
@@ -830,6 +829,8 @@
                   "minimum": 1
                 },
                 "bytesPerRun": {
+                  "description": "历史读取累计额度字段，仅为兼容旧配置保留；当前 files.read 不累计或执行此额度，新宿主不再下发。",
+                  "deprecated": true,
                   "type": "integer",
                   "minimum": 1
                 },
@@ -1998,13 +1999,16 @@
           "additionalProperties": false,
           "required": [
             "readBytesPerRequest",
-            "readBytesPerRun",
             "callsPerMinute",
             "listPageSize"
           ],
           "properties": {
             "readBytesPerRequest": { "type": "integer", "minimum": 1 },
-            "readBytesPerRun": { "type": "integer", "minimum": 1 },
+            "readBytesPerRun": {
+              "description": "历史读取累计额度字段，仅为兼容旧配置保留；当前 files.read 不累计或执行此额度，新宿主不再下发。",
+              "deprecated": true,
+              "type": "integer", "minimum": 1
+            },
             "callsPerMinute": { "type": "integer", "minimum": 1 },
             "listPageSize": { "type": "integer", "minimum": 1 },
             "writeBytesPerRequest": {