@krishanjinbo/vue-markdown-stream 1.0.0 → 2.0.0

package/README.md

@@ -1,20 +1,22 @@
 # vue-markdown-stream
 
-> 流式 Markdown 渲染 + Vue 3 组件块，基于 `markdown-it-container`
+> Agent UI Protocol — LLM 可控的流式 Markdown 渲染 + Vue 交互组件协议
 
 [![npm](https://img.shields.io/npm/v/@krishanjinbo/vue-markdown-stream)](https://www.npmjs.com/package/@krishanjinbo/vue-markdown-stream)
 [![license](https://img.shields.io/badge/license-MIT-blue)](./LICENSE)
 
-在 AI 流式输出场景中，将 `:::alert`、`:::card` 等 Markdown 容器块实时渲染为真实 Vue 3 组件，支持响应式 props 和 slot 内容。
+在 AI Agent 场景中，将 `:::confirm`、`:::select`、`:::form` 等 Markdown 容器块实时渲染为 Vue 3 交互组件，用户操作通过事件总线回传给宿主应用。
 
-**📖 [完整文档](https://hanlang123.github.io/vue-markdown-stream/) · [在线演示](https://hanlang123.github.io/vue-markdown-stream/demo)**
+**[完整文档](https://hanlang123.github.io/vue-markdown-stream/) · [在线演示](https://hanlang123.github.io/vue-markdown-stream/demo)**
 
 ## 特性
 
-- ⚡ **流式打字机渲染** — 逐字追加，自动补全未闭合 `:::` 块
-- 🧩 **Vue 组件块** — `:::alert` / `:::card` 渲染为真实 Vue 组件（响应式 props + slot）
-- 🔌 **完全可扩展** — 5 行代码注册任意自定义块组件
-- 🪶 **轻量** — 基于 `DOMParser` + `h()` VNode 树，无运行时编译，bundle 增量约 40KB
+- **流式打字机渲染** — 逐字追加，自动补全未闭合 `:::` 块
+- **8 种内置组件块** — alert / card / confirm / select / form / progress / datatable / actions
+- **事件回传** — AgentEventBus 将用户交互回传给宿主应用，闭环 Agent 流程
+- **Props 安全校验** — 白名单 + 黑名单 + 类型转换，防止 LLM 注入
+- **完全可扩展** — 通过 props 传入自定义 componentMap 和 propsSchemas
+- **轻量** — 基于 `DOMParser` + `h()` VNode，无运行时编译
 
 ## 安装
 
@@ -40,6 +42,25 @@ const display = computed(() => isStreaming.value ? text.value + '▍' : text.val
 </template>
 ```
 
+## Agent 交互用法
+
+```vue
+<script setup lang="ts">
+import { MarkdownRenderer, useAgentEvents } from '@krishanjinbo/vue-markdown-stream'
+
+const { createHandler, serializeToMessage } = useAgentEvents()
+
+const handleAction = createHandler(async (payload) => {
+  const message = serializeToMessage(payload)
+  // 发送给 Agent API...
+})
+</script>
+
+<template>
+  <MarkdownRenderer :content="text" @agent:action="handleAction" />
+</template>
+```
+
 ## Markdown 语法
 
 ```markdown
@@ -47,14 +68,18 @@ const display = computed(() => isStreaming.value ? text.value + '▍' : text.val
 **提示**：这是一个 Info 告警块。
 :::
 
-::: alert warning
-注意：`未闭合的块`在流式中间态会被自动补全。
+::: confirm action="delete" level=danger
+确认删除？此操作不可撤销。
+:::
+
+::: progress value=73 max=100 status=active
+正在处理... 73/100
 :::
 
-::: card 数据卡片标题
-| 列A | 列B |
-|-----|-----|
-| 值1 | 值2 |
+::: actions
+- 查看进度
+- 生成报告
+- 导出数据
 :::
 ```
 
@@ -65,7 +90,9 @@ const display = computed(() => isStreaming.value ? text.value + '▍' : text.val
   → autoCloseContainers()       补全未闭合 ::: 块
   → markdown-it + container     输出含 <vue-block> 的 HTML
   → DOMParser                   HTML → DOM 树
-  → h() VNode 构建              <vue-block> → Vue 组件 VNode
+  → PropValidator               Props 白名单校验 + 清洗
+  → h() VNode 构建              <vue-block> → Vue 组件 VNode + 事件绑定
+  → AgentEventBus               组件事件 → 宿主应用回调
   → MarkdownRenderer            渲染输出
 ```
 

package/dist/components/MarkdownRenderer.d.ts

@@ -1,17 +1,77 @@
 import { PropType, VNode } from 'vue';
+import { AgentActionPayload } from '../core/eventBus';
+import { ComponentPropsSchema } from '../core/propValidator';
+import { ComponentMap } from '../types';
+export declare const AGENT_EVENT_BUS_KEY: unique symbol;
 declare const _default: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    /** Markdown 内容（支持流式追加） */
     content: {
-        type: PropType<string>;
-        default: string;
+        type: StringConstructor;
+        required: true;
+    };
+    /**
+     * 自定义组件注册表（与内置组件合并，用户组件优先）
+     */
+    components: {
+        type: PropType<ComponentMap>;
+        default: () => {};
+    };
+    /**
+     * [v2 新增] 自定义 Props Schema（与默认 Schema 合并）
+     */
+    propsSchemas: {
+        type: PropType<Record<string, ComponentPropsSchema>>;
+        default: () => {};
+    };
+    /**
+     * [v2 新增] 是否启用 Props 安全校验（默认启用）
+     */
+    enableValidation: {
+        type: BooleanConstructor;
+        default: boolean;
     };
 }>, () => VNode<import('vue').RendererNode, import('vue').RendererElement, {
     [key: string]: any;
-}>, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+}>, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    /**
+     * [v2 新增] Agent 操作事件
+     *
+     * 当任何内置或自定义块组件触发用户交互时，
+     * 通过此事件通知宿主应用，宿主应用负责将其转发给 Agent
+     */
+    'agent:action': (_payload: AgentActionPayload) => true;
+}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    /** Markdown 内容（支持流式追加） */
     content: {
-        type: PropType<string>;
-        default: string;
+        type: StringConstructor;
+        required: true;
+    };
+    /**
+     * 自定义组件注册表（与内置组件合并，用户组件优先）
+     */
+    components: {
+        type: PropType<ComponentMap>;
+        default: () => {};
+    };
+    /**
+     * [v2 新增] 自定义 Props Schema（与默认 Schema 合并）
+     */
+    propsSchemas: {
+        type: PropType<Record<string, ComponentPropsSchema>>;
+        default: () => {};
+    };
+    /**
+     * [v2 新增] 是否启用 Props 安全校验（默认启用）
+     */
+    enableValidation: {
+        type: BooleanConstructor;
+        default: boolean;
     };
-}>> & Readonly<{}>, {
-    content: string;
+}>> & Readonly<{
+    "onAgent:action"?: ((_payload: AgentActionPayload) => any) | undefined;
+}>, {
+    components: ComponentMap;
+    propsSchemas: Record<string, ComponentPropsSchema>;
+    enableValidation: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 export default _default;

package/dist/components/blocks/ActionPills.vue.d.ts

@@ -0,0 +1,33 @@
+import { AgentEventBus } from '../../core/eventBus';
+type __VLS_Props = {
+    layout?: 'inline' | 'wrap';
+    blockId?: string;
+    eventBus?: AgentEventBus;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        default?(_: {}): any;
+    };
+    refs: {
+        slotContainer: HTMLDivElement;
+    };
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "agent-action": (event: string, data: Record<string, unknown>) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onAgent-action"?: ((event: string, data: Record<string, unknown>) => any) | undefined;
+}>, {
+    layout: "inline" | "wrap";
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    slotContainer: HTMLDivElement;
+}, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/blocks/ConfirmBlock.vue.d.ts

@@ -0,0 +1,35 @@
+import { AgentEventBus } from '../../core/eventBus';
+type __VLS_Props = {
+    action?: string;
+    level?: 'info' | 'warning' | 'danger';
+    confirmText?: string;
+    cancelText?: string;
+    blockId?: string;
+    eventBus?: AgentEventBus;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        default?(_: {}): any;
+    };
+    refs: {};
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "agent-action": (event: string, data: Record<string, unknown>) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onAgent-action"?: ((event: string, data: Record<string, unknown>) => any) | undefined;
+}>, {
+    action: string;
+    level: "info" | "warning" | "danger";
+    confirmText: string;
+    cancelText: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/blocks/DataTableBlock.vue.d.ts

@@ -0,0 +1,33 @@
+import { AgentEventBus } from '../../core/eventBus';
+type __VLS_Props = {
+    sortable?: boolean;
+    filterable?: boolean;
+    pageSize?: number;
+    blockId?: string;
+    eventBus?: AgentEventBus;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        default?(_: {}): any;
+    };
+    refs: {
+        slotContainer: HTMLDivElement;
+    };
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    sortable: boolean;
+    filterable: boolean;
+    pageSize: number;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    slotContainer: HTMLDivElement;
+}, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/blocks/FormBlock.vue.d.ts

@@ -0,0 +1,37 @@
+import { AgentEventBus } from '../../core/eventBus';
+type __VLS_Props = {
+    id?: string;
+    submitText?: string;
+    layout?: 'vertical' | 'horizontal';
+    blockId?: string;
+    eventBus?: AgentEventBus;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        default?(_: {}): any;
+    };
+    refs: {
+        slotContainer: HTMLDivElement;
+    };
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "agent-action": (event: string, data: Record<string, unknown>) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onAgent-action"?: ((event: string, data: Record<string, unknown>) => any) | undefined;
+}>, {
+    id: string;
+    submitText: string;
+    layout: "vertical" | "horizontal";
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    slotContainer: HTMLDivElement;
+}, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/blocks/ProgressBlock.vue.d.ts

@@ -0,0 +1,30 @@
+import { AgentEventBus } from '../../core/eventBus';
+type __VLS_Props = {
+    value?: number;
+    max?: number;
+    label?: string;
+    status?: 'active' | 'success' | 'error';
+    blockId?: string;
+    eventBus?: AgentEventBus;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        default?(_: {}): any;
+    };
+    refs: {};
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    value: number;
+    max: number;
+    status: "active" | "success" | "error";
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/blocks/SelectBlock.vue.d.ts

@@ -0,0 +1,37 @@
+import { AgentEventBus } from '../../core/eventBus';
+type __VLS_Props = {
+    mode?: 'single' | 'multiple';
+    columns?: number;
+    maxSelect?: number;
+    blockId?: string;
+    eventBus?: AgentEventBus;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        default?(_: {}): any;
+    };
+    refs: {
+        slotContainer: HTMLDivElement;
+    };
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "agent-action": (event: string, data: Record<string, unknown>) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onAgent-action"?: ((event: string, data: Record<string, unknown>) => any) | undefined;
+}>, {
+    mode: "single" | "multiple";
+    columns: number;
+    maxSelect: number;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    slotContainer: HTMLDivElement;
+}, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/blocks/index.d.ts

@@ -0,0 +1,13 @@
+import { ComponentMap } from '../../types';
+export { default as AlertBlock } from './AlertBlock.vue';
+export { default as DataCard } from './DataCard.vue';
+export { default as ConfirmBlock } from './ConfirmBlock.vue';
+export { default as SelectBlock } from './SelectBlock.vue';
+export { default as FormBlock } from './FormBlock.vue';
+export { default as ProgressBlock } from './ProgressBlock.vue';
+export { default as DataTableBlock } from './DataTableBlock.vue';
+export { default as ActionPills } from './ActionPills.vue';
+/**
+ * 默认的内置组件注册表
+ */
+export declare const builtinComponentMap: ComponentMap;

package/dist/composables/useAgentEvents.d.ts

@@ -0,0 +1,27 @@
+import { Ref } from 'vue';
+import { AgentActionPayload } from '../core/eventBus';
+/**
+ * 便捷的 Agent 事件管理 Composable
+ *
+ * 使用方式:
+ * ```vue
+ * <script setup>
+ * const { createHandler, serializeToMessage } = useAgentEvents()
+ *
+ * const handleAction = createHandler(async (payload) => {
+ *   await sendToAgent(payload)
+ * })
+ * </script>
+ *
+ * <template>
+ *   <MarkdownRenderer :content="text" @agent:action="handleAction" />
+ * </template>
+ * ```
+ */
+export declare function useAgentEvents(): {
+    lastAction: Ref<AgentActionPayload | null, AgentActionPayload | null>;
+    actionHistory: Ref<AgentActionPayload[], AgentActionPayload[]>;
+    isProcessing: Ref<boolean, boolean>;
+    createHandler: (handler: (payload: AgentActionPayload) => void | Promise<void>) => (payload: AgentActionPayload) => Promise<void>;
+    serializeToMessage: (payload: AgentActionPayload) => string;
+};

package/dist/composables/useMarkdownParser.d.ts

@@ -1,5 +1,9 @@
+import { default as MarkdownIt } from 'markdown-it';
 /**
- * 将 markdown 字符串渲染为 HTML
- * 流式场景下会自动补全未闭合的容器块
+ * 创建 Markdown 解析器（增强版）
  */
+export declare function useMarkdownParser(): {
+    parse: (content: string) => string;
+    md: MarkdownIt;
+};
 export declare function renderMarkdown(raw: string): string;

package/dist/core/autoCloseContainers.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 自动补全未闭合的 ::: 容器块
+ *
+ * 增强点（v2）:
+ * - 支持嵌套容器块的正确补全
+ * - 支持 ::: 后带属性参数的容器
+ */
+export declare function autoCloseContainers(content: string): string;

package/dist/core/eventBus.d.ts

@@ -0,0 +1,73 @@
+import { Ref } from 'vue';
+/**
+ * Agent 事件载荷
+ */
+export interface AgentActionPayload {
+    /** 触发事件的组件块 ID（自动生成或 data-id 指定） */
+    blockId: string;
+    /** 事件类型：confirm / cancel / submit / select / click 等 */
+    event: string;
+    /** 组件类型：ConfirmBlock / SelectBlock / FormBlock 等 */
+    componentType: string;
+    /** 事件携带的数据 */
+    data: Record<string, unknown>;
+    /** 事件时间戳 */
+    timestamp: number;
+}
+/**
+ * Agent 事件历史记录
+ */
+export interface AgentEventRecord extends AgentActionPayload {
+    /** 是否已被宿主应用消费 */
+    consumed: boolean;
+}
+export type AgentActionHandler = (payload: AgentActionPayload) => void | Promise<void>;
+/**
+ * 创建 Agent 事件总线实例
+ *
+ * 设计为工厂函数而非单例，支持多个 MarkdownRenderer 实例
+ * 各自拥有独立的事件空间
+ */
+export declare function createAgentEventBus(): {
+    emit: (payload: Omit<AgentActionPayload, "timestamp">) => void;
+    on: (handler: AgentActionHandler) => () => boolean;
+    clearHistory: () => void;
+    destroy: () => void;
+    history: Readonly<Ref<readonly {
+        readonly consumed: boolean;
+        readonly blockId: string;
+        readonly event: string;
+        readonly componentType: string;
+        readonly data: {
+            readonly [x: string]: Readonly<unknown>;
+        };
+        readonly timestamp: number;
+    }[], readonly {
+        readonly consumed: boolean;
+        readonly blockId: string;
+        readonly event: string;
+        readonly componentType: string;
+        readonly data: {
+            readonly [x: string]: Readonly<unknown>;
+        };
+        readonly timestamp: number;
+    }[]>>;
+    lastEvent: Readonly<Ref<{
+        readonly blockId: string;
+        readonly event: string;
+        readonly componentType: string;
+        readonly data: {
+            readonly [x: string]: Readonly<unknown>;
+        };
+        readonly timestamp: number;
+    } | null, {
+        readonly blockId: string;
+        readonly event: string;
+        readonly componentType: string;
+        readonly data: {
+            readonly [x: string]: Readonly<unknown>;
+        };
+        readonly timestamp: number;
+    } | null>>;
+};
+export type AgentEventBus = ReturnType<typeof createAgentEventBus>;

package/dist/core/propValidator.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 单个 prop 的校验规则
+ */
+export interface PropRule {
+    type: 'string' | 'number' | 'boolean' | 'enum';
+    required?: boolean;
+    default?: unknown;
+    enum?: string[];
+    maxLength?: number;
+    min?: number;
+    max?: number;
+}
+/**
+ * 组件的 Props Schema 定义
+ */
+export interface ComponentPropsSchema {
+    /** 允许的 props 白名单 */
+    allowed: Record<string, PropRule>;
+    /** 全局黑名单（会覆盖 allowed 中同名属性） */
+    blocked?: string[];
+}
+/**
+ * 默认的内置组件 Schema 注册表
+ */
+export declare const defaultSchemas: Record<string, ComponentPropsSchema>;
+/**
+ * 校验并清洗从 data-* 属性提取的 props
+ *
+ * @param componentName - 组件名称
+ * @param rawProps - 从 data-* 提取的原始 props（全部为 string 类型）
+ * @param schemas - Schema 注册表（可自定义扩展）
+ * @returns 校验通过的 props 对象
+ */
+export declare function validateProps(componentName: string, rawProps: Record<string, string>, schemas?: Record<string, ComponentPropsSchema>): Record<string, unknown>;
+/**
+ * 清洗事件 payload —— 防止原型链污染和函数注入
+ */
+export declare function sanitizePayload(payload: unknown): Record<string, unknown>;

package/dist/index.d.ts

@@ -1,8 +1,19 @@
 export { default as MarkdownRenderer } from './components/MarkdownRenderer';
 export { default as AlertBlock } from './components/blocks/AlertBlock.vue';
 export { default as DataCard } from './components/blocks/DataCard.vue';
-export { renderMarkdown } from './composables/useMarkdownParser';
+export { default as ConfirmBlock } from './components/blocks/ConfirmBlock.vue';
+export { default as SelectBlock } from './components/blocks/SelectBlock.vue';
+export { default as FormBlock } from './components/blocks/FormBlock.vue';
+export { default as ProgressBlock } from './components/blocks/ProgressBlock.vue';
+export { default as DataTableBlock } from './components/blocks/DataTableBlock.vue';
+export { default as ActionPills } from './components/blocks/ActionPills.vue';
 export { useStreamingText } from './composables/useStreamingText';
-export { autoCloseContainers } from './utils/autoClose';
-export { htmlToVnodes } from './utils/htmlToVnodes';
-export type { ComponentMap } from './utils/htmlToVnodes';
+export { useMarkdownParser, renderMarkdown } from './composables/useMarkdownParser';
+export { useAgentEvents } from './composables/useAgentEvents';
+export { createAgentEventBus } from './core/eventBus';
+export { validateProps, sanitizePayload, defaultSchemas } from './core/propValidator';
+export { autoCloseContainers } from './core/autoCloseContainers';
+export type { AgentActionPayload, AgentEventBus, AgentActionHandler } from './core/eventBus';
+export type { ComponentPropsSchema, PropRule } from './core/propValidator';
+export type { ComponentMap, BlockBaseProps } from './types';
+export { PROTOCOL_VERSION, SUPPORTED_BLOCKS } from './types/protocol';

package/dist/types/index.d.ts

@@ -0,0 +1,16 @@
+import { Component } from 'vue';
+import { AgentEventBus } from '../core/eventBus';
+/**
+ * 组件注册表类型
+ */
+export type ComponentMap = Record<string, Component>;
+/**
+ * 块组件 Props 基础接口
+ * 所有内置块组件都继承此接口
+ */
+export interface BlockBaseProps {
+    /** 块实例唯一 ID（自动生成或 data-id 指定） */
+    blockId?: string;
+    /** 事件总线引用（由 MarkdownRenderer 注入） */
+    eventBus?: AgentEventBus;
+}

package/dist/types/protocol.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Agent UI Protocol 版本
+ */
+export declare const PROTOCOL_VERSION = "2.0.0";
+/**
+ * 支持的容器块类型
+ */
+export declare const SUPPORTED_BLOCKS: readonly ["alert", "card", "confirm", "select", "form", "progress", "datatable", "actions"];
+export type SupportedBlock = typeof SUPPORTED_BLOCKS[number];