@dp-bohrium/widget-cli 0.4.0 → 0.5.1

package/dist/core.d.mts

@@ -0,0 +1,869 @@
+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. */
+/**
+ * 构建该 Widget 时使用的 SDK 精确 SemVer 版本，不接受范围。
+ */
+type WidgetSdkVersion = string;
+/**
+ * 包内 ESM 入口路径；仅允许包内相对 POSIX 路径。
+ */
+type EntryPath = string;
+/**
+ * 作者声明的扩展点配置：file-preview 声明扩展名集合，panel 绑定既有 Panel。
+ */
+type WidgetContributionConfig = ({
+  type: "file-preview";
+  /**
+   * @minItems 1
+   */
+  extensions: [string, ...(string)[]];
+} | PanelContributionConfig);
+/**
+ * 声明 Host 何时允许激活该 Widget；激活条件不授予事件读取能力。
+ *
+ * @minItems 1
+ * @maxItems 16
+ */
+type ActivationEvents$1 = [ActivationEvent] | [ActivationEvent, ActivationEvent] | [ActivationEvent, ActivationEvent, ActivationEvent] | [ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent] | [ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent] | [ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent] | [ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent] | [ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent] | [ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent] | [ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent] | [ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent] | [ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent] | [ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent] | [ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent] | [ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent] | [ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent, ActivationEvent];
+/**
+ * 公开 Widget 激活信号。高层 WidgetContext.events 使用事件 type；低层 events.read 的 topic 不填写在这里。
+ */
+type ActivationEvent = (("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") | string);
+/**
+ * Widget 申请的 Host 用户数据权限列表。
+ *
+ * @minItems 1
+ * @maxItems 2
+ */
+type HostUserPermissions = [HostUserPermission] | [HostUserPermission, HostUserPermission];
+/**
+ * Widget 可申请读取的 Host 用户数据权限名：个人资料或邮箱。
+ */
+type HostUserPermission = ("host.user.profile.read" | "host.user.email.read");
+/**
+ * 同版本 RenderRequest 测试样例；至少一个，request 为相对 .json 路径。
+ *
+ * @minItems 1
+ */
+type Samples$1 = [{
+  id: string;
+  title: string;
+  request: string;
+}, ...({
+  id: string;
+  title: string;
+  request: string;
+})[]];
+/**
+ * 打包阶段生成的宿主 Widget 清单；name / description 仅用于首次展示默认值，widgetConfig 为冻结运行配置。
+ */
+interface WidgetManifest {
+  name: string;
+  description?: string;
+  widgetConfig: WidgetConfig;
+}
+/**
+ * 打包阶段生成的冻结 Widget 运行配置；字段由 CLI 从作者清单写入，作者不得再直接覆盖。
+ */
+interface WidgetConfig {
+  schemaVersion: 1;
+  hostApiVersion: 1;
+  widgetSdkVersion: WidgetSdkVersion;
+  entry: EntryPath;
+  contribution: WidgetContributionConfig;
+  activationEvents?: ActivationEvents$1;
+  requestedCapabilities?: RequestedCapabilities$1;
+  requestedPermissions?: HostUserPermissions;
+  runtime?: RuntimeOptions$1;
+  samples: Samples$1;
+}
+/**
+ * 绑定 Agent Widget 既有 Panel 的配置。
+ */
+interface PanelContributionConfig {
+  /**
+   * Panel 贡献类型。
+   */
+  type: "panel";
+  /**
+   * Host 注册和查找 Panel 时使用的稳定类型标识。
+   */
+  id: string;
+  placement?: ({
+    kind: "panel";
+  } | {
+    kind: "region";
+    region: "session.rightRail";
+    mode: "replace";
+  });
+}
+/**
+ * Widget 申请的能力集合；声明仅表示申请，最终由 Host 按次授权。
+ */
+interface RequestedCapabilities$1 {
+  files?: FilesCapabilityRequest$1;
+  events?: EventsCapabilityRequest$1;
+  tasks?: TasksCapabilityRequest$1;
+  state?: StateCapabilityRequest$1;
+  actions?: ActionsCapabilityRequest$1;
+  network?: NetworkCapabilityRequest$1;
+  presentation?: RequestedPresentationCapability$1;
+  region?: RequestedRegionCapability$1;
+}
+/**
+ * 文件能力的独立申请开关；保存已有文件必须单独申请 files.write 并获得 Host 授权，可写范围由 Host grant 决定。
+ */
+interface FilesCapabilityRequest$1 {
+  list?: boolean;
+  metadata?: boolean;
+  read?: boolean;
+  download?: boolean;
+  write?: boolean;
+}
+/**
+ * 事件读取能力的申请；topics 声明要读取的事件主题。
+ */
+interface EventsCapabilityRequest$1 {
+  /**
+   * @minItems 1
+   * @maxItems 32
+   */
+  topics: [string, ...(string)[]];
+}
+/**
+ * 任务发现与观察能力的申请；list / watch 至少显式申请一项，已申请项固定为 true。
+ */
+interface TasksCapabilityRequest$1 {
+  list?: true;
+  watch?: true;
+}
+/**
+ * 受限 UI 状态读写能力的申请；read / write 分别声明。
+ */
+interface StateCapabilityRequest$1 {
+  read: boolean;
+  write: boolean;
+}
+/**
+ * Host 自定义动作调用能力的申请；names 声明可调用的动作名。
+ */
+interface ActionsCapabilityRequest$1 {
+  /**
+   * @minItems 1
+   * @maxItems 32
+   */
+  names: [string, ...(string)[]];
+}
+/**
+ * Host 托管网络能力的申请；fetch 固定为 true，目标域名由 Host 运行时按请求授权。
+ */
+interface NetworkCapabilityRequest$1 {
+  fetch: true;
+}
+/**
+ * 呈现能力的申请；surfaces 声明期望的呈现表面。
+ */
+interface RequestedPresentationCapability$1 {
+  /**
+   * @minItems 1
+   * @maxItems 2
+   */
+  surfaces: [("floating" | "overlay")] | [("floating" | "overlay"), ("floating" | "overlay")];
+}
+/**
+ * 会话右侧区域替换能力的申请；当前仅支持 session.rightRail + replace。
+ */
+interface RequestedRegionCapability$1 {
+  /**
+   * @minItems 1
+   * @maxItems 1
+   */
+  regions: ["session.rightRail"];
+  mode: "replace";
+}
+/**
+ * 运行时申请；worker 与 webAssembly 均为可选布尔开关。
+ */
+interface RuntimeOptions$1 {
+  worker?: boolean;
+  webAssembly?: boolean;
+}
+//#endregion
+//#region ../widget-sdk/src/protocol/generated-plugin-manifest.d.ts
+/** GENERATED FILE. Do not edit directly. */
+/**
+ * Host 可用于启动 Widget 的公开激活信号。多个值表示任一信号命中即可激活；它们不授予 events.read 权限。工具名形式为 tool-call-<阶段>:<工具名>。
+ *
+ * @minItems 1
+ * @maxItems 16
+ */
+type ActivationEvents = [(("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") | string)] | [(("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") | string), (("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") | string)] | [(("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") | string), (("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") | string), (("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") | string)] | [(("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") | string), (("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") | string), (("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") | string), (("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") | string)] | [(("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string)] | [(("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string)] | [(("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string)] | [(("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string)] | [(("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string)] | [(("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string)] | [(("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string)] | [(("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string)] | [(("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string)] | [(("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string)] | [(("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string)] | [(("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string), (("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") | string)];
+/**
+ * 作者贡献点联合：以 type 判别 Panel 或文件预览。
+ */
+type WidgetContribution = (WidgetPanelContribution | WidgetFilePreviewContribution);
+/**
+ * 同版本 RenderRequest 测试样例；至少一个，request 为相对 .json 路径。
+ *
+ * @minItems 1
+ */
+type Samples = [{
+  id: string;
+  title: string;
+  request: string;
+}, ...({
+  id: string;
+  title: string;
+  request: string;
+})[]];
+/**
+ * 插件作者维护的插件清单；打包阶段会生成宿主清单的运行时字段。
+ */
+interface WidgetPluginManifest$1 {
+  $schema?: string;
+  name: string;
+  version: string;
+  displayName?: string;
+  description?: string;
+  /**
+   * 插件源码入口；CLI 默认使用 src/widget.ts。
+   */
+  entry?: string;
+  activationEvents?: ActivationEvents;
+  contributes: WidgetPluginContributions;
+  capabilities?: RequestedCapabilities;
+  runtime?: RuntimeOptions;
+  samples?: Samples;
+}
+/**
+ * 插件声明的一组扩展点；当前仅支持 widget 贡献点。
+ */
+interface WidgetPluginContributions {
+  widget: WidgetContribution;
+}
+/**
+ * 面板贡献：声明 panel 类型与 id；surfaces、title、placement 可选。
+ */
+interface WidgetPanelContribution {
+  type: "panel";
+  id: string;
+  title?: string;
+  /**
+   * @minItems 1
+   * @maxItems 3
+   */
+  surfaces?: [("workspace" | "floating" | "overlay")] | [("workspace" | "floating" | "overlay"), ("workspace" | "floating" | "overlay")] | [("workspace" | "floating" | "overlay"), ("workspace" | "floating" | "overlay"), ("workspace" | "floating" | "overlay")];
+  placement?: ({
+    kind: "panel";
+  } | {
+    kind: "region";
+    region: "session.rightRail";
+    mode: "replace";
+  });
+}
+/**
+ * 文件预览贡献：声明一组小写且不含前导点的扩展名。
+ */
+interface WidgetFilePreviewContribution {
+  type: "file-preview";
+  /**
+   * @minItems 1
+   * @maxItems 32
+   */
+  extensions: [string, ...(string)[]];
+}
+/**
+ * Widget 申请的能力集合；声明仅表示申请，最终由 Host 按次授权。
+ */
+interface RequestedCapabilities {
+  files?: FilesCapabilityRequest;
+  events?: EventsCapabilityRequest;
+  tasks?: TasksCapabilityRequest;
+  state?: StateCapabilityRequest;
+  actions?: ActionsCapabilityRequest;
+  network?: NetworkCapabilityRequest;
+  presentation?: RequestedPresentationCapability;
+  region?: RequestedRegionCapability;
+}
+/**
+ * 文件能力的独立申请开关；保存已有文件必须单独申请 files.write 并获得 Host 授权，可写范围由 Host grant 决定。
+ */
+interface FilesCapabilityRequest {
+  list?: boolean;
+  metadata?: boolean;
+  read?: boolean;
+  download?: boolean;
+  write?: boolean;
+}
+/**
+ * 事件读取能力的申请；topics 声明要读取的事件主题。
+ */
+interface EventsCapabilityRequest {
+  /**
+   * @minItems 1
+   * @maxItems 32
+   */
+  topics: [string, ...(string)[]];
+}
+/**
+ * 任务发现与观察能力的申请；list / watch 至少显式申请一项，已申请项固定为 true。
+ */
+interface TasksCapabilityRequest {
+  list?: true;
+  watch?: true;
+}
+/**
+ * 受限 UI 状态读写能力的申请；read / write 分别声明。
+ */
+interface StateCapabilityRequest {
+  read: boolean;
+  write: boolean;
+}
+/**
+ * Host 自定义动作调用能力的申请；names 声明可调用的动作名。
+ */
+interface ActionsCapabilityRequest {
+  /**
+   * @minItems 1
+   * @maxItems 32
+   */
+  names: [string, ...(string)[]];
+}
+/**
+ * Host 托管网络能力的申请；fetch 固定为 true，目标域名由 Host 运行时按请求授权。
+ */
+interface NetworkCapabilityRequest {
+  fetch: true;
+}
+/**
+ * 呈现能力的申请；surfaces 声明期望的呈现表面。
+ */
+interface RequestedPresentationCapability {
+  /**
+   * @minItems 1
+   * @maxItems 2
+   */
+  surfaces: [("floating" | "overlay")] | [("floating" | "overlay"), ("floating" | "overlay")];
+}
+/**
+ * 会话右侧区域替换能力的申请；当前仅支持 session.rightRail + replace。
+ */
+interface RequestedRegionCapability {
+  /**
+   * @minItems 1
+   * @maxItems 1
+   */
+  regions: ["session.rightRail"];
+  mode: "replace";
+}
+/**
+ * 运行时申请；worker 与 webAssembly 均为可选布尔开关。
+ */
+interface RuntimeOptions {
+  worker?: boolean;
+  webAssembly?: boolean;
+}
+//#endregion
+//#region ../widget-sdk/src/protocol/plugin-manifest.d.ts
+/** 工具调用事件阶段；用于拼出 `tool-call-<phase>:<toolName>` 形式的激活事件。 */
+type WidgetToolPhase = "generating" | "waiting" | "running" | "result" | "error";
+/**
+ * Widget Host 公开的固定激活事件。数组同时作为清单编辑器文档和 Host
+ * 运行时校验的单一事实源；带工具名的事件使用下方的动态形式。
+ */
+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>` 动态形式。
+ */
+type WidgetActivationEvent = WidgetFixedActivationEvent | `tool-call-${WidgetToolPhase}:${string}`;
+/** 至少一个元素、按声明顺序的只读激活事件元组（作者侧清单使用）。 */
+type WidgetActivationEvents = readonly [WidgetActivationEvent, ...WidgetActivationEvent[]];
+/** 作者侧 Manifest 类型；激活事件类型与 JSON Schema 共用同一事实源。 */
+type WidgetPluginManifest = Omit<WidgetPluginManifest$1, "activationEvents"> & {
+  readonly activationEvents?: WidgetActivationEvents;
+};
+//#endregion
+//#region src/project/project.d.mts
+/** 工程检查摘要；Gallery 状态和终端输出只依赖这些字段。 */
+interface CheckResult {
+  ok: boolean;
+  label: string;
+  checks: Array<{
+    name: string;
+    ok: boolean;
+    detail?: string;
+  }>;
+  errors: string[];
+}
+type ContractValidationResult = {
+  ok: true;
+} | {
+  ok: false;
+  errors: Array<{
+    instancePath: string;
+    message?: string;
+    keyword: string;
+  }>;
+};
+interface WidgetContractValidators {
+  validateWidgetManifest(value: unknown): ContractValidationResult;
+  validateRenderRequest(value: unknown): ContractValidationResult;
+  validateCapabilityResult(value: unknown): ContractValidationResult;
+}
+interface ManifestCompilerOptions {
+  hostEntry?: string;
+  samples?: NonNullable<WidgetPluginManifest["samples"]>;
+}
+type WidgetManifestCompiler = (manifest: WidgetPluginManifest, options?: ManifestCompilerOptions) => WidgetManifest;
+interface WidgetProjectToolchain {
+  sdkVersion?: string;
+  compiler?: WidgetManifestCompiler;
+  validators?: WidgetContractValidators;
+}
+interface CheckWidgetProjectOptions extends ManifestCompilerOptions {
+  label?: string;
+  requireBuiltEntry?: boolean;
+  sdkVersion?: string;
+  compiler?: WidgetManifestCompiler;
+  validators?: WidgetContractValidators;
+  toolchain?: WidgetProjectToolchain;
+}
+interface CheckedWidgetSample {
+  sample: WidgetManifest["widgetConfig"]["samples"][number];
+  request: RenderRequest;
+}
+interface WidgetProjectCheckDetails extends CheckResult {
+  projectRoot: string;
+  sampleRequest: RenderRequest | null;
+  sampleRequests: CheckedWidgetSample[];
+  /** 夹具保留读取到的 JSON；失败结果中也可能存在未经验证的内容。 */
+  fixtures: unknown;
+  fixturesPath: string | null;
+  entryPath: string | null;
+}
+interface WidgetProjectCheckSuccess extends WidgetProjectCheckDetails {
+  ok: true;
+  manifest: WidgetManifest;
+  sourceManifest: unknown;
+  manifestKind: "author" | "host";
+  fixturesPath: string;
+  entryPath: string;
+}
+interface WidgetProjectCheckFailure extends WidgetProjectCheckDetails {
+  ok: false;
+  /** 清单缺失或 JSON 解析失败时为 null；校验失败时保留原始未知值。 */
+  manifest: unknown;
+  /** 尚未成功读取 JSON 的提前返回不包含这两个字段。 */
+  sourceManifest?: unknown;
+  manifestKind?: "author" | "host";
+}
+type WidgetProjectCheckResult = WidgetProjectCheckSuccess | WidgetProjectCheckFailure;
+//#endregion
+//#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;
+  manifest?: WidgetManifest;
+}
+interface WidgetPackageOptions {
+  includePreviewFixtures?: boolean;
+  /** 未提供已编译清单时，沿用作者清单编译器的入口选择。 */
+  hostEntry?: string;
+}
+/** 保留旧的同步 ZIP 返回值。 */
+declare function buildWidgetPackage(project: WidgetPackageInput, options?: WidgetPackageOptions): Buffer;
+//#endregion
+//#region src/core.d.mts
+interface WidgetTemplateContext {
+  readonly name: string;
+  readonly ui?: "vanilla" | "react" | string;
+}
+interface WidgetTemplate {
+  readonly id: string;
+  readonly description?: string;
+  manifest(context: WidgetTemplateContext): Record<string, unknown>;
+  sample(context: WidgetTemplateContext): Record<string, unknown>;
+  readonly source: string | ((context: WidgetTemplateContext) => string);
+}
+interface WidgetTemplateRegistry {
+  register(template: WidgetTemplate): WidgetTemplate;
+  get(id: string): WidgetTemplate | undefined;
+  list(): readonly WidgetTemplate[];
+}
+declare function defineWidgetTemplate(template: WidgetTemplate): WidgetTemplate;
+declare function createWidgetTemplateRegistry(initialTemplates?: readonly WidgetTemplate[]): WidgetTemplateRegistry;
+declare function auditDshPlugin(input: string): Promise<Record<string, unknown>>;
+declare function scaffoldDshWidget(input: string, output: string, options?: Record<string, unknown>): Promise<Record<string, unknown>>;
+declare const widgetCliCore: {
+  readonly buildWidgetPackage: typeof buildWidgetPackage;
+  readonly checkWidgetProject: typeof checkWidgetProject;
+  readonly compileAuthorManifest: typeof compileAuthorManifest;
+  readonly resolveWidgetProjects: typeof resolveWidgetProjects;
+  readonly createWidgetTemplateRegistry: typeof createWidgetTemplateRegistry;
+  readonly defineWidgetTemplate: typeof defineWidgetTemplate;
+  readonly auditDshPlugin: typeof auditDshPlugin;
+  readonly scaffoldDshWidget: typeof scaffoldDshWidget;
+};
+//#endregion
+export { WidgetTemplate, WidgetTemplateContext, WidgetTemplateRegistry, auditDshPlugin, buildWidgetPackage, checkWidgetProject, compileAuthorManifest, createWidgetTemplateRegistry, defineWidgetTemplate, resolveWidgetProjects, scaffoldDshWidget, widgetCliCore };