@dp-bohrium/widget-cli 0.5.0 → 0.6.0

package/dist/core.d.mts

@@ -1,353 +1,6 @@
+import { t as RenderRequest } from "./generated-runtime-contracts-CbZY-iss.mjs";
 import { Buffer } from "node:buffer";
-//#region ../contracts/dist/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 ../contracts/dist/generated-manifest.d.ts
+//#region ../widget-sdk/src/protocol/generated-manifest.d.ts
 /** GENERATED FILE. Do not edit directly. */
 /**
  * 构建该 Widget 时使用的 SDK 精确 SemVer 版本，不接受范围。
@@ -538,7 +191,7 @@ interface RuntimeOptions$1 {
   webAssembly?: boolean;
 }
 //#endregion
-//#region ../contracts/dist/generated-plugin-manifest.d.ts
+//#region ../widget-sdk/src/protocol/generated-plugin-manifest.d.ts
 /** GENERATED FILE. Do not edit directly. */
 /**
  * Host 可用于启动 Widget 的公开激活信号。多个值表示任一信号命中即可激活；它们不授予 events.read 权限。工具名形式为 tool-call-<阶段>:<工具名>。
@@ -713,7 +366,7 @@ interface RuntimeOptions {
   webAssembly?: boolean;
 }
 //#endregion
-//#region ../contracts/dist/plugin-manifest.d.ts
+//#region ../widget-sdk/src/protocol/plugin-manifest.d.ts
 /** 工具调用事件阶段；用于拼出 `tool-call-<phase>:<toolName>` 形式的激活事件。 */
 type WidgetToolPhase = "generating" | "waiting" | "running" | "result" | "error";
 /**
@@ -734,7 +387,7 @@ type WidgetPluginManifest = Omit<WidgetPluginManifest$1, "activationEvents"> & {
   readonly activationEvents?: WidgetActivationEvents;
 };
 //#endregion
-//#region ../widget-project/src/project.d.mts
+//#region src/project/project.d.mts
 /** 工程检查摘要；Gallery 状态和终端输出只依赖这些字段。 */
 interface CheckResult {
   ok: boolean;
@@ -810,7 +463,17 @@ interface WidgetProjectCheckFailure extends WidgetProjectCheckDetails {
 }
 type WidgetProjectCheckResult = WidgetProjectCheckSuccess | WidgetProjectCheckFailure;
 //#endregion
-//#region ../widget-project/src/packaging.d.mts
+//#region src/project/check.d.mts
+declare function checkWidgetProject(projectRoot: string, options?: CheckWidgetProjectOptions): Promise<WidgetProjectCheckResult>;
+declare function resolveWidgetProjects(input: string, root?: string): string[];
+//#endregion
+//#region src/project/manifest.d.mts
+declare function compileAuthorManifest(manifest: unknown, options?: ManifestCompilerOptions & {
+  sdkVersion?: string;
+  compiler?: WidgetManifestCompiler;
+}): unknown;
+//#endregion
+//#region src/project/packaging.d.mts
 /** 打包只依赖工程位置与已编译清单，不依赖 Gallery 的路由或展示状态。 */
 interface WidgetPackageInput {
   projectRoot: string;
@@ -824,14 +487,6 @@ interface WidgetPackageOptions {
 /** 保留旧的同步 ZIP 返回值。 */
 declare function buildWidgetPackage(project: WidgetPackageInput, options?: WidgetPackageOptions): Buffer;
 //#endregion
-//#region ../widget-project/src/index.d.mts
-declare function compileAuthorManifest(manifest: unknown, options?: ManifestCompilerOptions & {
-  sdkVersion?: string;
-  compiler?: WidgetManifestCompiler;
-}): unknown;
-declare function checkWidgetProject(projectRoot: string, options?: CheckWidgetProjectOptions): Promise<WidgetProjectCheckResult>;
-declare function resolveWidgetProjects(input: string, root?: string): string[];
-//#endregion
 //#region src/core.d.mts
 interface WidgetTemplateContext {
   readonly name: string;

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-BkPMTfZ_.mjs";
+import { l as compileAuthorManifest, n as scaffoldDshWidget, o as checkWidgetProject, r as buildWidgetPackage, s as resolveWidgetProjects, t as auditDshPlugin } from "./dsh-BL6cMLrg.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-CbZY-iss.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 };