@webskill/sdk 0.3.0 → 0.4.0

package/dist/{index-wiV5X8Rz.d.ts → index-CHXxDccV.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 { F as JsonSchema, _ as RenderBlock, b as UiSpecActionCapability, o as InteractionRequest, pt as UiSpecNode, r as ChartSpec, s as InteractionResponse, v as RenderResultRequest, w as UiSpecSnapshot, y as UiBridge } from "./types-7Wcg--Vh-1YlQ4jF9.js";
+import { x as ExternalToolSource } from "./index-DLfR2Y6I.js";
 import { z } from "zod";
 import { ComponentType, ReactNode } from "react";
 //#region ../ui/dist/index.d.ts
@@ -65,6 +65,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
@@ -102,15 +120,6 @@ declare const WEBSKILL_STYLES_CSS = "\n.webskill-form { display: block; padding:
 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;
@@ -176,7 +185,7 @@ 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;
@@ -187,25 +196,6 @@ declare const UI_CATALOG_GROUPS: {
   readonly input: readonly ["Form", "Field", "Button"];
 };
 //#endregion
-//#region src/catalog/toSurface.d.ts
-/**
- * 保留的 custom 组件名：catalog 声明树整棵挂在这个 surface 上。
- * `UiSurface` 的六类联合表达不了通用节点树，改造它属破坏性变更（21 号文档 §7 已备案），
- * 因此本轮用一个保留 component 名承载，四档 registry 各自识别它。
- */
-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;
-//#endregion
 //#region src/catalog/toJsonRenderSpec.d.ts
 /** json-render 的扁平 spec：`elements` 以 key 索引，`children` 只存 key */
 interface JsonRenderSpec {
@@ -222,6 +212,24 @@ 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";
 interface UiCatalogToolSourceOptions {
@@ -230,36 +238,14 @@ interface UiCatalogToolSourceOptions {
   /** surface id 生成（默认时间戳 + 随机后缀） */
   newSurfaceId?: () => 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 +255,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 +273,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 +280,46 @@ 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;
+  value?: Record<string, unknown>;
+  cancelled?: boolean;
+}
+declare function toUiSurfaceActionDispatch(snapshot: UiSpecSnapshot, action: UiSpecActionCapability, 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/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>): {
   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 +416,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 +512,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 { fromA2uiSpecAction as $, UiCatalogToolSourceOptions as A, WEBSKILL_SURFACE_ACTION as B, OpenUiRuntime as C, UiCatalog as D, UiActionDef as E, VERCEL_INTERACTION_TOOL_NAME as F, buildA2uiCatalogDefinition as G, ZodRuntime as H, VercelToolInvocation as I, collectSpecActions as J, chartSpecFromProps as K, VercelUiBridge as L, UiSpecIssue as M, UiSpecValidation as N, UiCatalogInput as O, UiSurfaceActionDispatch as P, ensureStyles as Q, WEBSKILL_A2UI_CATALOG_ID as R, OpenUiRendererProps as S, UI_CATALOG_GROUPS as T, a2uiComponentSchema as U, WebFormBridge as V, a2uiComponentShapes as W, createUiCatalogToolSource as X, collectValues as Y, defineUiCatalog as Z, EchartHandle as _, toUiSurfaceActionDispatch as _t, A2UI_SURFACE_ACTION as a, loadOpenUiPeers as at, JsonRenderSpec as b, A2uiCatalogDefinition as c, renderBlocks as ct, A2uiMessage as d, renderRenderResult as dt, fromA2uiSurfaceAction as et, A2uiSpecActionEvent as f, shapeInteractionValue as ft, ControlModel as g, toOpenUiSpecLang as gt, CollectedValues as h, toJsonRenderSpec as ht, A2UI_SPEC_FORM_PATH as i, interactionToUiSpec as it, UiComponentDef as j, UiCatalogPromptOptions as k, A2uiCatalogHandle as l, renderMiniChart as lt, CHART_PALETTE as m, toA2uiSurfaceAction as mt, A2UI_COMMON_TYPES as n, fromVercelToolResult as nt, A2UI_VERSION as o, loadWebSkillLitCatalog as ot, A2uiSpecMessageOptions as p, toA2uiSpecMessages as pt, chartToTable as q, A2UI_SPEC_ACTION as r, interactionToFormModel as rt, A2uiCatalogComponent as s, mountEchart as st, A2UI_BASIC_CATALOG_ID as t, fromUiSurfaceActionDispatch as tt, A2uiComponentShape as u, renderMiniMarkdown as ut, FormModel as v, toVercelToolInvocation as vt, RENDER_UI_TOOL as w, LoadedOpenUiPeers as x, InteractionSpecLabels as y, uiCatalog as yt, WEBSKILL_STYLES_CSS as z };