@webskill/sdk 0.3.0 → 0.5.0

package/dist/{index-wiV5X8Rz.d.ts → index-Bsqg4ftU.d.ts}

@@ -1,5 +1,5 @@
-import { D as UiSurfaceSnapshot, I as JsonSchema, _ as RenderResultRequest, b as UiSurfaceAction, g as RenderBlock, o as InteractionRequest, r as ChartSpec, s as InteractionResponse, v as UiBridge, y as UiSurface } from "./types-AmKCKJn_-VGabeXK4.js";
-import { y as ExternalToolSource } from "./index-8d-oEDww.js";
+import { I as JsonSchema, T as UiSpecSnapshot, b as UiBridge, c as InteractionResponse, mt as UiSpecNode, r as ChartSpec, s as InteractionRequest, v as RenderBlock, x as UiSpecActionCapability, y as RenderResultRequest } from "./types-D_hoCri8-BnNPiZCi.js";
+import { x as ExternalToolSource } from "./index-vBz_FC9w.js";
 import { z } from "zod";
 import { ComponentType, ReactNode } from "react";
 //#region ../ui/dist/index.d.ts
@@ -23,6 +23,15 @@ interface ControlModel {
     label: string;
     value: unknown;
   }>;
+  /**
+   * 上次填写值（FR-5.9）。与 `defaultValue` 严格分开：渲染器只能把它展示为建议，
+   * 用户主动采纳后才能进控件。
+   * @experimental
+   */
+  suggestion?: {
+    value: unknown;
+    ts: number;
+  };
 }
 /** 提交值按请求类型归形（WebFormBridge 与框架组件库共享单一来源） */
 declare function shapeInteractionValue(model: FormModel, values: Record<string, unknown>): unknown;
@@ -42,6 +51,13 @@ interface CollectedValues {
  * - required 空值列入 missingRequired（由调用方阻止提交并标记）
  */
 declare function collectValues(controls: ControlModel[], container: ParentNode): CollectedValues;
+/**
+ * 采纳建议值（FR-5.9）：把 `control.suggestion` 写进已渲染的控件。
+ * 与 `collectValues` 共用同一套选择器与编码约定——两边分开实现的话，
+ * select 的 JSON 编码值迟早会对不上。
+ * @experimental
+ */
+declare function applySuggestion(control: ControlModel, container: ParentNode): void;
 //#endregion
 //#region src/markdown/miniMarkdown.d.ts
 /**
@@ -65,6 +81,24 @@ declare function chartToTable(chart: ChartSpec): {
   rows: unknown[][];
 };
 //#endregion
+//#region src/chart/echart.d.ts
+/**
+ * catalog `Chart` 节点 props → `ChartSpec`。四档共用这一份转换：
+ * 此前 native / OpenUI / json-render / A2UI 各抄了一遍，改一处就会漂移。
+ * catalog 的 `area` 在 `ChartSpec` 里没有对应枚举，按折线渲染——
+ * 原先的裸 cast 会把非法枚举一路带进渲染器，画出空图。
+ */
+declare function chartSpecFromProps(props: Record<string, unknown>): ChartSpec;
+interface EchartHandle {
+  setChart(chart: ChartSpec): void;
+  dispose(): void;
+}
+/**
+ * 框架无关的 echarts 挂载点：三档的 React 组件与 A2UI 档的 Lit 元素共用同一实现，
+ * 图表不再因档位而异。echarts 走动态 import，不打进首屏。
+ */
+declare function mountEchart(container: HTMLElement): EchartHandle;
+//#endregion
 //#region src/web/webFormBridge.d.ts
 /**
  * 框架无关原生 DOM 的 UiBridge：request 渲染表单并返回 Promise
@@ -97,20 +131,11 @@ declare function renderRenderResult(request: RenderResultRequest, doc: Document)
 //#endregion
 //#region src/web/styles.d.ts
 /** 最小样式（BEM class，应用可整体覆写） */
-declare const WEBSKILL_STYLES_CSS = "\n.webskill-form { display: block; padding: 12px; border: 1px solid #d0d0d0; border-radius: 8px; font-family: system-ui, sans-serif; max-width: 420px; }\n.webskill-form__title { margin: 0 0 8px; font-size: 15px; font-weight: 600; }\n.webskill-form__message { margin: 0 0 10px; font-size: 14px; }\n.webskill-form__control { margin-bottom: 10px; display: flex; flex-direction: column; gap: 4px; }\n.webskill-form__control--invalid .webskill-form__input { border-color: #d33; }\n.webskill-form__label { font-size: 13px; font-weight: 500; }\n.webskill-form__label-required::after { content: ' *'; color: #d33; }\n.webskill-form__description { font-size: 12px; color: #666; }\n.webskill-form__error { font-size: 12px; color: #d33; display: none; }\n.webskill-form__control--invalid .webskill-form__error { display: block; }\n.webskill-form__input { padding: 6px 8px; border: 1px solid #bbb; border-radius: 4px; font-size: 14px; font-family: inherit; }\n.webskill-form__actions { display: flex; gap: 8px; margin-top: 12px; }\n.webskill-form__button { padding: 6px 14px; border-radius: 4px; border: 1px solid #bbb; background: #fff; cursor: pointer; font-size: 14px; }\n.webskill-form__button--primary { background: #2563eb; border-color: #2563eb; color: #fff; }\n.webskill-form__button--ghost { background: transparent; }\n.webskill-result { font-family: system-ui, sans-serif; font-size: 14px; }\n.webskill-result__summary { font-size: 12px; color: #666; margin-bottom: 6px; }\n.webskill-result__json { background: #f5f5f5; padding: 8px; border-radius: 4px; overflow-x: auto; }\n.webskill-result__file { padding: 4px 0; font-size: 13px; }\n.webskill-md pre { background: #f5f5f5; padding: 8px; border-radius: 4px; overflow-x: auto; }\n.webskill-md h1, .webskill-md h2, .webskill-md h3 { margin: 8px 0 4px; }\n.webskill-md p { margin: 4px 0; }\n.webskill-md ul { margin: 4px 0; padding-left: 20px; }\n";
+declare const WEBSKILL_STYLES_CSS = "\n.webskill-form { display: block; padding: 12px; border: 1px solid #d0d0d0; border-radius: 8px; font-family: system-ui, sans-serif; max-width: 420px; }\n.webskill-form__title { margin: 0 0 8px; font-size: 15px; font-weight: 600; }\n.webskill-form__message { margin: 0 0 10px; font-size: 14px; }\n.webskill-form__control { margin-bottom: 10px; display: flex; flex-direction: column; gap: 4px; }\n.webskill-form__control--invalid .webskill-form__input { border-color: #d33; }\n.webskill-form__label { font-size: 13px; font-weight: 500; }\n.webskill-form__label-required::after { content: ' *'; color: #d33; }\n.webskill-form__description { font-size: 12px; color: #666; }\n.webskill-form__error { font-size: 12px; color: #d33; display: none; }\n.webskill-form__control--invalid .webskill-form__error { display: block; }\n.webskill-form__input { padding: 6px 8px; border: 1px solid #bbb; border-radius: 4px; font-size: 14px; font-family: inherit; }\n.webskill-form__suggestion { display: flex; align-items: center; gap: 6px; font-size: 12px; color: #666; }\n.webskill-form__suggestion-use { padding: 1px 8px; border-radius: 4px; border: 1px solid #bbb; background: #fff; cursor: pointer; font-size: 12px; }\n.webskill-form__actions { display: flex; gap: 8px; margin-top: 12px; }\n.webskill-form__button { padding: 6px 14px; border-radius: 4px; border: 1px solid #bbb; background: #fff; cursor: pointer; font-size: 14px; }\n.webskill-form__button--primary { background: #2563eb; border-color: #2563eb; color: #fff; }\n.webskill-form__button--ghost { background: transparent; }\n.webskill-result { font-family: system-ui, sans-serif; font-size: 14px; }\n.webskill-result__summary { font-size: 12px; color: #666; margin-bottom: 6px; }\n.webskill-result__json { background: #f5f5f5; padding: 8px; border-radius: 4px; overflow-x: auto; }\n.webskill-result__file { padding: 4px 0; font-size: 13px; }\n.webskill-md pre { background: #f5f5f5; padding: 8px; border-radius: 4px; overflow-x: auto; }\n.webskill-md h1, .webskill-md h2, .webskill-md h3 { margin: 8px 0 4px; }\n.webskill-md p { margin: 4px 0; }\n.webskill-md ul { margin: 4px 0; padding-left: 20px; }\n";
 /** 每个 document 只注入一次 */
 declare function ensureStyles(doc: Document): void;
 //#endregion
 //#region src/catalog/types.d.ts
-/** 声明式 UI 的节点：框架无关，技能脚本与 LLM 产出同一形状 */
-interface UiSpecNode {
-  /** catalog 中声明过的组件名 */
-  component: string;
-  props?: Record<string, unknown>;
-  children?: UiSpecNode[];
-  /** 稳定 id（回放与 action 关联用） */
-  id?: string;
-}
 interface UiComponentDef {
   /** 声明里使用的组件名（PascalCase，全局唯一） */
   name: string;
@@ -121,6 +146,8 @@ interface UiComponentDef {
   /** 允许的子节点组件名；省略表示叶子节点 */
   children?: readonly string[] | 'any';
   group: 'layout' | 'content' | 'data' | 'input' | 'feedback';
+  /** 同一容器（声明了 children 的父节点）下至多出现一个；超出时校验不通过 */
+  singletonPerContainer?: boolean;
   /** 给模型的额外约束 */
   constraints?: readonly string[];
   /** 最小示例（进 prompt，显著提升生成质量） */
@@ -176,35 +203,83 @@ declare function defineUiCatalog(input: UiCatalogInput): UiCatalog;
 //#endregion
 //#region src/catalog/uiCatalog.d.ts
 /**
- * v3 首发 catalog：覆盖既有 `UiSurface` 六类的全部表达力，先窄后宽。
+ * v3 首发 catalog：覆盖旧六类 surface（metric / chart / table / form / file / custom）的全部表达力，先窄后宽。
  * 只依赖 zod —— 不 import 任何 UI framework（21 号文档 §5.1）。
  */
 declare const uiCatalog: UiCatalog;
 /** prompt / 文档里引用的分组顺序（Console 展示同序） */
 declare const UI_CATALOG_GROUPS: {
   readonly content: readonly ["Stack", "Card", "Separator", "Heading", "Text", "Markdown", "Badge"];
-  readonly data: readonly ["Metric", "Table", "Chart", "FileLink"];
+  readonly data: readonly ["Metric", "Table", "Chart", "Timeline", "FileLink"];
   readonly input: readonly ["Form", "Field", "Button"];
 };
+/**
+ * catalog 系统提示的体积上限（UTF-8 字节，FR-6.6）。
+ * 描述每次请求都要重发，所以上限必须是可判定的数字而不是「尽量精简」。
+ * 要改这个数字，先想清楚是否值得让每次请求都多付这些 token。
+ */
+declare const UI_CATALOG_PROMPT_BUDGET_BYTES = 20480;
 //#endregion
-//#region src/catalog/toSurface.d.ts
+//#region src/catalog/formScopes.d.ts
+/** 声明树里一个 `Form` 的提交作用域。@experimental */
+interface UiFormScope {
+  /** 提交动作所属的表单容器：节点 id 优先，否则按出现序生成 */
+  scopeId: string;
+  /** 该表单的提交 action id */
+  submitActionId: string;
+  /** 该表单的取消 action id（仅在声明了 cancelLabel 时会进能力表） */
+  cancelActionId: string;
+  /** 该表单子树内的字段名，按声明序 */
+  fieldNames: readonly string[];
+  form: UiSpecNode;
+}
 /**
- * 保留的 custom 组件名：catalog 声明树整棵挂在这个 surface 上。
- * `UiSurface` 的六类联合表达不了通用节点树，改造它属破坏性变更（21 号文档 §7 已备案），
- * 因此本轮用一个保留 component 名承载，四档 registry 各自识别它。
+ * 按出现序列出声明树里的每个 `Form`。
+ *
+ * 单表单时 action id 保持 `submit` / `cancel`，回传形状与容器级放宽前逐字节一致——
+ * 向后兼容是 FR-6.3 的硬约束，不能让既有单表单卡片跟着改。
+ * 多表单时每个表单拿到独立的 action id 与 `scopeId`，渲染层据此只收集本表单子树内的字段。
  */
-declare const UI_SPEC_COMPONENT = "webskill.ui-spec";
-interface UiSpecSurfaceProps {
-  catalogId: string;
-  catalogVersion: string;
-  spec: UiSpecNode;
-  /** 声明树里出现过的 action 名（renderer 据此生成按钮能力） */
-  actions: string[];
-}
-/** 声明树 → `UiSurface`。id 缺省时由调用方给（工具源用 runtime 生成的 id）。 */
-declare function toSurface(catalog: UiCatalog, spec: UiSpecNode, id: string): UiSurface;
-/** surface 是否承载 catalog 声明树（四档 renderer 的分派入口） */
-declare function isUiSpecSurface(surface: UiSurface): boolean;
+declare function collectFormScopes(spec: UiSpecNode): UiFormScope[];
+/**
+ * 多表单时字段值在渲染层的存储键。
+ *
+ * 跨表单重名过去不可能发生，容器级放宽后它变成合法输入：两个表单各有一个 `email`，
+ * 共用一张扁平表就是后写的覆盖先写的，用户在 A 里输入会串到 B。
+ * 因此多表单时按作用域限定键；单表单不加前缀，存储与草稿形状保持不变。
+ */
+declare function qualifyFieldName(name: string, scopeId?: string): string;
+/**
+ * 提交时回传的字段值。
+ *
+ * 不给 `scope` → 整张 surface 的扁平值，与容器级放宽前完全一致（FR-6.3 第 3 条）。
+ * 给了 `scope` → 只取该表单子树内的字段，键回落成裸字段名，
+ * 因此接收端看到的载荷形状与单表单时相同。
+ */
+declare function collectScopedValues(values: Readonly<Record<string, unknown>>, scope?: Pick<UiFormScope, 'scopeId' | 'fieldNames'>): Record<string, unknown>;
+//#endregion
+//#region src/catalog/presets.d.ts
+/** 场景预设名（FR-6.4） */
+type UiPresetName = 'charts' | 'cards' | 'dashboards' | 'slides' | 'reports';
+/**
+ * 一类场景的排版模板。产出的是 catalog 节点树，不是标记语言——
+ * 技能可以引用预设，但不能自带 HTML（需求 8 的方案 A）。
+ * @experimental
+ */
+interface UiPreset {
+  name: UiPresetName;
+  /** 一行说明，进工具入参枚举；这行是唯一无条件计入请求上下文的部分 */
+  summary: string;
+  /** 详细排版指引，只在模型显式索取该预设时才下发（FR-6.5） */
+  guidance: string;
+  /** 可运行示例：必须通过 `uiCatalog.validate`（AC-6.6） */
+  example: UiSpecNode;
+}
+/** 五类场景预设（FR-6.4）。@experimental */
+declare const UI_PRESETS: readonly UiPreset[];
+declare const UI_PRESET_NAMES: readonly UiPresetName[];
+/** Returns undefined for names outside the catalog presets. @experimental */
+declare function uiPreset(name: string): UiPreset | undefined;
 //#endregion
 //#region src/catalog/toJsonRenderSpec.d.ts
 /** json-render 的扁平 spec：`elements` 以 key 索引，`children` 只存 key */
@@ -222,44 +297,43 @@ interface JsonRenderSpec {
  */
 declare function toJsonRenderSpec(spec: UiSpecNode): JsonRenderSpec;
 //#endregion
+//#region src/catalog/interactionToUiSpec.d.ts
+/**
+ * 宿主注入的界面文案（缺省用 `FormModel` 的英文默认值）。
+ * 生成器本身与语言无关，本地化由持有字典的宿主提供。
+ */
+interface InteractionSpecLabels {
+  title?: string;
+  submitLabel?: string;
+  cancelLabel?: string;
+}
+/**
+ * 五类 `InteractionRequest` → catalog 声明树。
+ *
+ * 路径 A（runtime 发起的交互请求）与路径 B（模型产出的 surface）的差别只在「谁产出这棵树」；
+ * 产出之后四档走的是同一条 spec 渲染路径，因此这份生成器全仓只写一份。
+ */
+declare function interactionToUiSpec(request: InteractionRequest, labels?: InteractionSpecLabels): UiSpecNode;
+//#endregion
 //#region src/catalog/uiCatalogToolSource.d.ts
 declare const RENDER_UI_TOOL = "render_ui";
+declare const DESCRIBE_UI_PRESET_TOOL = "describe_ui_preset";
 interface UiCatalogToolSourceOptions {
   /** 默认使用 v1 catalog */
   catalog?: UiCatalog;
   /** surface id 生成（默认时间戳 + 随机后缀） */
   newSurfaceId?: () => string;
+  /** 向模型开放的场景预设；缺省全部开放，空数组等于关闭预设。不认识的名字直接忽略 */
+  presets?: readonly string[];
 }
+/** 节点树声明的 action 能力表（renderer 据此生成按钮，runtime 据此签发 nonce）。@experimental */
+declare function collectSpecActions(spec: UiSpecNode): UiSpecActionCapability[];
 /**
  * 把 catalog 变成一个工具的入参 Schema，让模型直接生成声明式 UI（21 号文档 §3）：
- * agentLoop / UiBridge / extractUiSurfaceEvents 全部零改动，装配处只多一个 externalTools 条目。
+ * agentLoop / UiBridge / extractUiSpecEvents 全部零改动，装配处只多一个 externalTools 条目。
  */
 declare function createUiCatalogToolSource(options?: UiCatalogToolSourceOptions): ExternalToolSource;
 //#endregion
-//#region src/adapters/surface/surfaceDescriptor.d.ts
-declare const WEBSKILL_SURFACE_ACTION = "webskill:surface-action";
-type SurfaceRendererProvenance = 'a2ui-standard' | 'a2ui-extension' | 'openui-library' | 'openui-extension' | 'vercel-surface-host';
-/** Serializable surface state consumed by a renderer-specific host. @experimental */
-interface UiSurfaceDescriptor {
-  type: 'webskill-surface';
-  snapshot: UiSurfaceSnapshot;
-  provenance: SurfaceRendererProvenance;
-}
-/** Serializable renderer action. The Runtime validates nonce capability before resuming a run. @experimental */
-interface UiSurfaceActionDispatch {
-  runId?: string;
-  surfaceId: string;
-  actionId: string;
-  intent: UiSurfaceAction['intent'];
-  nonce?: string;
-  value?: Record<string, unknown>;
-  cancelled?: boolean;
-}
-declare function toUiSurfaceDescriptor(snapshot: UiSurfaceSnapshot, provenance: SurfaceRendererProvenance): UiSurfaceDescriptor;
-declare function toUiSurfaceActionDispatch(snapshot: UiSurfaceSnapshot, action: UiSurfaceAction, value?: Record<string, unknown>): UiSurfaceActionDispatch;
-/** Returns undefined for malformed or non-WebSkill renderer events. @experimental */
-declare function fromUiSurfaceActionDispatch(value: unknown): UiSurfaceActionDispatch | undefined;
-//#endregion
 //#region src/adapters/vercel/vercelPayload.d.ts
 /** Vercel AI SDK v7 ToolCallPart 兼容结构 */
 interface VercelToolInvocation {
@@ -269,22 +343,10 @@ interface VercelToolInvocation {
   input: unknown;
 }
 declare const VERCEL_INTERACTION_TOOL_NAME = "webskill_interaction";
-declare const VERCEL_SURFACE_DATA_PART_TYPE = "data-webskill-surface";
-declare const VERCEL_SURFACE_ACTION_DATA_PART_TYPE = "webskill:surface-action";
-/** Vercel AI SDK-compatible data part consumed by a WebSkill SurfaceHost. @experimental */
-interface VercelSurfaceDataPart {
-  type: typeof VERCEL_SURFACE_DATA_PART_TYPE;
-  id: string;
-  data: ReturnType<typeof toUiSurfaceDescriptor>;
-}
 /** InteractionRequest → SDK tool UI 结构（应用聊天 UI 直接消费） */
 declare function toVercelToolInvocation(request: InteractionRequest): VercelToolInvocation;
 /** SDK 回传（tool result / output）→ InteractionResponse */
 declare function fromVercelToolResult(part: unknown): InteractionResponse;
-/** UiSurfaceSnapshot → AI SDK data part; the SurfaceHost owns renderer selection. @experimental */
-declare function toVercelSurfaceDataPart(snapshot: UiSurfaceSnapshot): VercelSurfaceDataPart;
-/** Decodes a nonce-bound action data part emitted by a Vercel SurfaceHost. @experimental */
-declare function fromVercelSurfaceAction(part: unknown): UiSurfaceActionDispatch | undefined;
 //#endregion
 //#region src/adapters/vercel/vercelUiBridge.d.ts
 /**
@@ -299,39 +361,6 @@ declare class VercelUiBridge implements UiBridge {
   request(input: InteractionRequest): Promise<InteractionResponse>;
 }
 //#endregion
-//#region src/adapters/openui/openuiLang.d.ts
-/**
- * InteractionRequest ↔ openui-lang 双向转换。
- * openui-lang 语法（@openuidev/react-lang 实测）：
- * - 每行一条语句 `identifier = Expression`，`root = Component(...)` 为入口
- * - 组件调用参数为位置参数；字符串双引号反斜杠转义
- * - 组件词汇（与应用 Library 约定）：Form(title, children)、
- *   Text(content)（纯展示文本，authorize 的能力描述用）、
- *   TextField(name, label, required?, defaultValue?)、NumberField、BooleanField(name, label, default?)、
- *   SelectField(name, label, options)、SubmitButton(label, actionType, requestId)、
- *   CancelButton(label, actionType, requestId)
- */
-declare const OPENUI_SUBMIT_ACTION = "webskill:submit";
-declare const OPENUI_CANCEL_ACTION = "webskill:cancel";
-/** authorize 的 Allow 专用动作（提交即批准 → value:true；Deny 走 cancel → cancelled:true） */
-declare const OPENUI_AUTHORIZE_ACTION = "webskill:authorize";
-declare const OPENUI_SURFACE_ACTION = "webskill:surface-action";
-/** @experimental */
-declare function toOpenUiLang(request: InteractionRequest): string;
-/**
- * UiSurfaceSnapshot → OpenUI library program. OpenUI applications provide WebSkillSurfaceHost;
- * its descriptor tells the host whether it is a native extension rather than an OpenUI-native component.
- * @experimental
- */
-declare function toOpenUiSurfaceLang(snapshot: UiSurfaceSnapshot): string;
-/** Decodes a nonce-bound action emitted by an OpenUI WebSkillSurfaceHost. @experimental */
-declare function fromOpenUiSurfaceAction(action: unknown): UiSurfaceActionDispatch | undefined;
-/**
- * OpenUI ActionEvent → InteractionResponse（formState 优先，取消单独分支）
- * @experimental
- */
-declare function fromOpenUiAction(action: unknown): InteractionResponse;
-//#endregion
 //#region src/adapters/openui/openUiSpecLang.d.ts
 /**
  * catalog 声明树 → openui-lang 文本。语法为每行一条 `id = Component(位置参数…)`，
@@ -339,56 +368,48 @@ declare function fromOpenUiAction(action: unknown): InteractionResponse;
  */
 declare function toOpenUiSpecLang(spec: UiSpecNode, catalog?: UiCatalog): string;
 //#endregion
+//#region src/adapters/surface/surfaceDescriptor.d.ts
+declare const WEBSKILL_SURFACE_ACTION = "webskill:surface-action";
+/** Serializable renderer action. The Runtime validates nonce capability before resuming a run. @experimental */
+interface UiSurfaceActionDispatch {
+  runId?: string;
+  surfaceId: string;
+  actionId: string;
+  intent: UiSpecActionCapability['intent'];
+  nonce?: string;
+  /** 提交动作所属的表单容器；单表单场景可省略 */
+  scopeId?: string;
+  value?: Record<string, unknown>;
+  cancelled?: boolean;
+}
+declare function toUiSurfaceActionDispatch(snapshot: UiSpecSnapshot, action: UiSpecActionCapability, value?: Record<string, unknown>, scopeId?: string): UiSurfaceActionDispatch;
+/** Returns undefined for malformed or non-WebSkill renderer events. @experimental */
+declare function fromUiSurfaceActionDispatch(value: unknown): UiSurfaceActionDispatch | undefined;
+//#endregion
 //#region src/adapters/a2ui/a2uiMessages.d.ts
 /**
- * InteractionRequest → A2UI 协议消息（v0.9.1，Basic Catalog）。
+ * A2UI 协议常量与 surface 动作编解码（v0.9.1）。
  * 依据 https://a2ui.org/specification/v0.9-a2ui/：
  * - 信封 {version, createSurface|updateComponents|updateDataModel|deleteSurface}
  * - 组件为扁平邻接表（id 引用），root 必需
  * - 输入组件与数据模型经 JSON Pointer 双向绑定；action.context 回传
- * - createSurface.sendDataModel: true → 客户端动作时携带完整数据模型
  *
- * action 约定：submit → {name: 'webskill:submit', context: {requestId}}；
- * cancel → {name: 'webskill:cancel', context: {requestId}}。
+ * 声明树 → A2UI 消息的转换在 `specToA2ui.ts`（四档共用的单一渲染路径）。
  */
 declare const A2UI_VERSION = "v0.9.1";
 declare const A2UI_BASIC_CATALOG_ID = "https://a2ui.org/specification/v0_9/catalogs/basic/catalog.json";
-declare const A2UI_SUBMIT_ACTION = "webskill:submit";
-declare const A2UI_CANCEL_ACTION = "webskill:cancel";
 declare const A2UI_SURFACE_ACTION = "webskill:surface-action";
 interface A2uiMessage {
   version: string;
   [key: string]: unknown;
 }
-/** @experimental */
-declare function toA2uiMessages(request: InteractionRequest): A2uiMessage[];
-/**
- * UiSurfaceSnapshot → A2UI extension-host messages.
- * Basic Catalog has no chart/table vocabulary, so a labelled WebSkill host owns these controlled renderers.
- * @experimental
- */
-declare function toA2uiSurfaceMessages(snapshot: UiSurfaceSnapshot): A2uiMessage[];
 /** Decodes a nonce-bound action emitted by a WebSkill A2UI extension host. @experimental */
 declare function fromA2uiSurfaceAction(event: unknown): UiSurfaceActionDispatch | undefined;
 /** Builds the A2UI event payload an extension host sends after a user action. @experimental */
-declare function toA2uiSurfaceAction(snapshot: UiSurfaceSnapshot, action: UiSurfaceAction, value?: Record<string, unknown>): {
+declare function toA2uiSurfaceAction(snapshot: UiSpecSnapshot, action: UiSpecActionCapability, value?: Record<string, unknown>, scopeId?: string): {
   name: string;
   context: UiSurfaceActionDispatch;
 };
-/**
- * 按 InteractionRequest.type 解码提交值（绑定模型原样回传的是表单对象）：
- * confirm 仅 confirmed===true 批准；select 还原原始 option 值（非字符串值经 JSON 编码比对）；
- * form 的 number 字段转 number（NaN 保留原值）；ask 取 answer；authorize 提交即批准。
- * 纯转换器：任何直接使用 fromA2uiAction 的消费者都应经此拿到正确类型。
- * @experimental
- */
-declare function decodeInteractionResponse(request: InteractionRequest, response: InteractionResponse): InteractionResponse;
-/**
- * A2UI client→server action 事件 → InteractionResponse。
- * 传入 request 时按类型解码提交值（见 decodeInteractionResponse）。
- * @experimental
- */
-declare function fromA2uiAction(event: unknown, request?: InteractionRequest): InteractionResponse;
 //#endregion
 //#region src/adapters/a2ui/webskillCatalog.d.ts
 /** 自定义 catalog 的协议 id（对齐 https://a2ui.org/specification/v1_0/catalog_definition.json） */
@@ -485,19 +506,6 @@ interface A2uiSpecActionEvent {
 /** A2UI action 事件 → 声明树 action（非本 catalog 的事件返回 undefined） */
 declare function fromA2uiSpecAction(event: unknown): A2uiSpecActionEvent | undefined;
 //#endregion
-//#region src/a2uiRuntime/litRendererBridge.d.ts
-/** @experimental */
-declare class LitRendererBridge implements UiBridge {
-  #private;
-  constructor(deps: {
-    mount: HTMLElement;
-    document?: Document;
-  });
-  request(input: InteractionRequest): Promise<InteractionResponse>;
-  /** runtime 交互超时/取消：移除 surface 并以 cancelled resolve pending Promise（防悬挂 + DOM 残留） */
-  cancel(id: string): void;
-}
-//#endregion
 //#region src/a2uiRuntime/loadLitCatalog.d.ts
 /** catalog 里单个组件的最小可见面（A2UI `LitComponentApi` 的结构子集） */
 interface A2uiCatalogComponent {
@@ -594,4 +602,4 @@ interface LoadedOpenUiPeers {
  */
 declare function loadOpenUiPeers(): Promise<LoadedOpenUiPeers>;
 //#endregion
-export { WEBSKILL_SURFACE_ACTION as $, SurfaceRendererProvenance as A, toA2uiSurfaceAction as At, UiSpecNode as B, toVercelToolInvocation as Bt, OPENUI_AUTHORIZE_ACTION as C, renderBlocks as Ct, OpenUiRendererProps as D, shapeInteractionValue as Dt, OPENUI_SURFACE_ACTION as E, renderRenderResult as Et, UiCatalogInput as F, toOpenUiSurfaceLang as Ft, VERCEL_INTERACTION_TOOL_NAME as G, UiSpecValidation as H, UiCatalogPromptOptions as I, toSurface as It, VercelSurfaceDataPart as J, VERCEL_SURFACE_ACTION_DATA_PART_TYPE as K, UiCatalogToolSourceOptions as L, toUiSurfaceActionDispatch as Lt, UI_SPEC_COMPONENT as M, toJsonRenderSpec as Mt, UiActionDef as N, toOpenUiLang as Nt, OpenUiRuntime as O, toA2uiMessages as Ot, UiCatalog as P, toOpenUiSpecLang as Pt, WEBSKILL_STYLES_CSS as Q, UiComponentDef as R, toUiSurfaceDescriptor as Rt, LoadedOpenUiPeers as S, loadWebSkillLitCatalog as St, OPENUI_SUBMIT_ACTION as T, renderMiniMarkdown as Tt, UiSurfaceActionDispatch as U, UiSpecSurfaceProps as V, uiCatalog as Vt, UiSurfaceDescriptor as W, VercelUiBridge as X, VercelToolInvocation as Y, WEBSKILL_A2UI_CATALOG_ID as Z, CollectedValues as _, fromVercelSurfaceAction as _t, A2UI_SPEC_FORM_PATH as a, chartToTable as at, JsonRenderSpec as b, isUiSpecSurface as bt, A2UI_VERSION as c, decodeInteractionResponse as ct, A2uiCatalogHandle as d, fromA2uiAction as dt, WebFormBridge as et, A2uiComponentShape as f, fromA2uiSpecAction as ft, CHART_PALETTE as g, fromUiSurfaceActionDispatch as gt, A2uiSpecMessageOptions as h, fromOpenUiSurfaceAction as ht, A2UI_SPEC_ACTION as i, buildA2uiCatalogDefinition as it, UI_CATALOG_GROUPS as j, toA2uiSurfaceMessages as jt, RENDER_UI_TOOL as k, toA2uiSpecMessages as kt, A2uiCatalogComponent as l, defineUiCatalog as lt, A2uiSpecActionEvent as m, fromOpenUiAction as mt, A2UI_CANCEL_ACTION as n, a2uiComponentSchema as nt, A2UI_SUBMIT_ACTION as o, collectValues as ot, A2uiMessage as p, fromA2uiSurfaceAction as pt, VERCEL_SURFACE_DATA_PART_TYPE as q, A2UI_COMMON_TYPES as r, a2uiComponentShapes as rt, A2UI_SURFACE_ACTION as s, createUiCatalogToolSource as st, A2UI_BASIC_CATALOG_ID as t, ZodRuntime as tt, A2uiCatalogDefinition as u, ensureStyles as ut, ControlModel as v, fromVercelToolResult as vt, OPENUI_CANCEL_ACTION as w, renderMiniChart as wt, LitRendererBridge as x, loadOpenUiPeers as xt, FormModel as y, interactionToFormModel as yt, UiSpecIssue as z, toVercelSurfaceDataPart as zt };
+export { buildA2uiCatalogDefinition as $, UiActionDef as A, uiCatalog as At, UiSpecValidation as B, OpenUiRendererProps as C, shapeInteractionValue as Ct, UI_CATALOG_PROMPT_BUDGET_BYTES as D, toOpenUiSpecLang as Dt, UI_CATALOG_GROUPS as E, toJsonRenderSpec as Et, UiComponentDef as F, WEBSKILL_A2UI_CATALOG_ID as G, VERCEL_INTERACTION_TOOL_NAME as H, UiFormScope as I, WebFormBridge as J, WEBSKILL_STYLES_CSS as K, UiPreset as L, UiCatalogInput as M, UiCatalogPromptOptions as N, UI_PRESETS as O, toUiSurfaceActionDispatch as Ot, UiCatalogToolSourceOptions as P, applySuggestion as Q, UiPresetName as R, LoadedOpenUiPeers as S, renderRenderResult as St, RENDER_UI_TOOL as T, toA2uiSurfaceAction as Tt, VercelToolInvocation as U, UiSurfaceActionDispatch as V, VercelUiBridge as W, a2uiComponentSchema as X, ZodRuntime as Y, a2uiComponentShapes as Z, DESCRIBE_UI_PRESET_TOOL as _, mountEchart as _t, A2UI_SURFACE_ACTION as a, collectValues as at, InteractionSpecLabels as b, renderMiniChart as bt, A2uiCatalogDefinition as c, ensureStyles as ct, A2uiMessage as d, fromUiSurfaceActionDispatch as dt, chartSpecFromProps as et, A2uiSpecActionEvent as f, fromVercelToolResult as ft, ControlModel as g, loadWebSkillLitCatalog as gt, CollectedValues as h, loadOpenUiPeers as ht, A2UI_SPEC_FORM_PATH as i, collectSpecActions as it, UiCatalog as j, uiPreset as jt, UI_PRESET_NAMES as k, toVercelToolInvocation as kt, A2uiCatalogHandle as l, fromA2uiSpecAction as lt, CHART_PALETTE as m, interactionToUiSpec as mt, A2UI_COMMON_TYPES as n, collectFormScopes as nt, A2UI_VERSION as o, createUiCatalogToolSource as ot, A2uiSpecMessageOptions as p, interactionToFormModel as pt, WEBSKILL_SURFACE_ACTION as q, A2UI_SPEC_ACTION as r, collectScopedValues as rt, A2uiCatalogComponent as s, defineUiCatalog as st, A2UI_BASIC_CATALOG_ID as t, chartToTable as tt, A2uiComponentShape as u, fromA2uiSurfaceAction as ut, EchartHandle as v, qualifyFieldName as vt, OpenUiRuntime as w, toA2uiSpecMessages as wt, JsonRenderSpec as x, renderMiniMarkdown as xt, FormModel as y, renderBlocks as yt, UiSpecIssue as z };