@dp-bohrium/widget-cli 0.5.1 → 0.7.0

package/dist/core.d.mts

@@ -1,352 +1,5 @@
+import { t as RenderRequest } from "./generated-runtime-contracts-qdyub_ED.mjs";
 import { Buffer } from "node:buffer";
-//#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;
-});
-/**
- * 渲染请求公共字段：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;
-}
-//#endregion
 //#region ../widget-sdk/src/protocol/generated-manifest.d.ts
 /** GENERATED FILE. Do not edit directly. */
 /**
@@ -452,7 +105,6 @@ interface PanelContributionConfig {
 interface RequestedCapabilities$1 {
   files?: FilesCapabilityRequest$1;
   events?: EventsCapabilityRequest$1;
-  tasks?: TasksCapabilityRequest$1;
   state?: StateCapabilityRequest$1;
   actions?: ActionsCapabilityRequest$1;
   network?: NetworkCapabilityRequest$1;
@@ -479,13 +131,6 @@ interface EventsCapabilityRequest$1 {
    */
   topics: [string, ...(string)[]];
 }
-/**
- * 任务发现与观察能力的申请；list / watch 至少显式申请一项，已申请项固定为 true。
- */
-interface TasksCapabilityRequest$1 {
-  list?: true;
-  watch?: true;
-}
 /**
  * 受限 UI 状态读写能力的申请；read / write 分别声明。
  */
@@ -627,7 +272,6 @@ interface WidgetFilePreviewContribution {
 interface RequestedCapabilities {
   files?: FilesCapabilityRequest;
   events?: EventsCapabilityRequest;
-  tasks?: TasksCapabilityRequest;
   state?: StateCapabilityRequest;
   actions?: ActionsCapabilityRequest;
   network?: NetworkCapabilityRequest;
@@ -654,13 +298,6 @@ interface EventsCapabilityRequest {
    */
   topics: [string, ...(string)[]];
 }
-/**
- * 任务发现与观察能力的申请；list / watch 至少显式申请一项，已申请项固定为 true。
- */
-interface TasksCapabilityRequest {
-  list?: true;
-  watch?: true;
-}
 /**
  * 受限 UI 状态读写能力的申请；read / write 分别声明。
  */

package/dist/core.mjs

@@ -1,4 +1,4 @@
-import { c as compileAuthorManifest, n as scaffoldDshWidget, o as checkWidgetProject, r as buildWidgetPackage, s as resolveWidgetProjects, t as auditDshPlugin } from "./dsh-BlpXm2Bv.mjs";
+import { l as compileAuthorManifest, n as scaffoldDshWidget, o as checkWidgetProject, r as buildWidgetPackage, s as resolveWidgetProjects, t as auditDshPlugin } from "./dsh-BJWUB8Nq.mjs";
 //#region src/core.mjs
 /** Validate a community template before registering it in a custom CLI. */
 function defineWidgetTemplate(template) {

package/dist/development-host.d.mts

@@ -1,3 +1,4 @@
+import { i as WidgetRenderResult, n as WidgetDevelopmentDiagnostic, r as WidgetRecoveryPlan } from "./generated-runtime-contracts-qdyub_ED.mjs";
 //#region src/development-host.d.mts
 interface WidgetDevelopmentEndpointSetV1 {
   readonly claim: string;
@@ -54,6 +55,36 @@ interface WidgetDevelopmentRuntimeDescriptorV1 {
   readonly panel?: WidgetDevelopmentPanelProjectionV1;
   readonly presentationRequests?: readonly WidgetDevelopmentPresentationRequestV1[];
 }
+interface WidgetDevelopmentObservationV1 {
+  readonly generation: number;
+  readonly attemptId: string;
+  readonly instanceId: string;
+  readonly sequence: number;
+  readonly event: {
+    readonly type: "connected";
+    readonly supported: boolean;
+  } | {
+    readonly type: "diagnostic";
+    readonly diagnostic: WidgetDevelopmentDiagnostic;
+  } | {
+    readonly type: "render-result";
+    readonly result: WidgetRenderResult;
+  };
+}
+interface WidgetDevelopmentRuntimeStateV1 {
+  readonly state: "unknown" | "unsupported" | "connected" | "failed" | "handled";
+  readonly cursor: number;
+  readonly oldestCursor: number;
+  readonly generation: number;
+  readonly attemptId?: string;
+  readonly instanceId?: string;
+  readonly diagnostic?: WidgetDevelopmentDiagnostic;
+  readonly recovery?: WidgetRecoveryPlan;
+  readonly renderResult?: WidgetRenderResult;
+  readonly entries: readonly (WidgetDevelopmentObservationV1 & {
+    readonly cursor: number;
+  })[];
+}
 interface WidgetDevelopmentStatusV1 {
   readonly protocolVersion: 1;
   readonly state: "ready" | "stopping" | "build-failed";
@@ -67,6 +98,7 @@ interface WidgetDevelopmentStatusV1 {
   readonly assets: readonly WidgetDevelopmentAssetV1[];
   readonly watch: boolean;
   readonly lastBuild: Readonly<Record<string, unknown>>;
+  readonly runtime?: WidgetDevelopmentRuntimeStateV1;
   readonly lastBuildError: Readonly<Record<string, unknown>> | null;
 }
 type WidgetDevelopmentEventTypeV1 = "generation-ready" | "generation-failed" | "reload-requested" | "session-stopping" | "disconnected";
@@ -76,10 +108,14 @@ interface WidgetDevelopmentEventV1 {
   readonly type: WidgetDevelopmentEventTypeV1;
   readonly data: Readonly<Record<string, unknown>>;
 }
-interface WidgetDevelopmentControlRequestV1 {
+type WidgetDevelopmentControlRequestV1 = {
   readonly protocolVersion: 1;
-  readonly action: "reload" | "disconnect";
-}
+  readonly action: "reload" | "disconnect" | "refresh-built-output";
+} | {
+  readonly protocolVersion: 1;
+  readonly action: "report-runtime";
+  readonly observation: WidgetDevelopmentObservationV1;
+};
 interface WidgetDevelopmentBridgeRequestV1 {
   readonly protocol: "bohrium.widget-development-host";
   readonly protocolVersion: 1;
@@ -99,4 +135,4 @@ interface WidgetDevelopmentCliEnvelopeV1<T = Readonly<Record<string, unknown>>>
   readonly data: T;
 }
 //#endregion
-export { WidgetDevelopmentAssetV1, WidgetDevelopmentBridgeRequestV1, WidgetDevelopmentBridgeResponseV1, WidgetDevelopmentClaimV1, WidgetDevelopmentCliEnvelopeV1, WidgetDevelopmentControlRequestV1, WidgetDevelopmentDescriptorV1, WidgetDevelopmentEndpointSetV1, WidgetDevelopmentEventTypeV1, WidgetDevelopmentEventV1, WidgetDevelopmentPanelProjectionV1, WidgetDevelopmentPresentationRequestV1, WidgetDevelopmentRuntimeDescriptorV1, WidgetDevelopmentStatusV1 };
+export { WidgetDevelopmentAssetV1, WidgetDevelopmentBridgeRequestV1, WidgetDevelopmentBridgeResponseV1, WidgetDevelopmentClaimV1, WidgetDevelopmentCliEnvelopeV1, WidgetDevelopmentControlRequestV1, WidgetDevelopmentDescriptorV1, WidgetDevelopmentEndpointSetV1, WidgetDevelopmentEventTypeV1, WidgetDevelopmentEventV1, WidgetDevelopmentObservationV1, WidgetDevelopmentPanelProjectionV1, WidgetDevelopmentPresentationRequestV1, WidgetDevelopmentRuntimeDescriptorV1, WidgetDevelopmentRuntimeStateV1, WidgetDevelopmentStatusV1 };