@farris/x-ui 0.0.6 → 0.0.8

package/bubble/src/bubble.component.d.ts

@@ -10,6 +10,8 @@ declare const _default: import('../../../vue').DefineComponent<{
     showAvatar: boolean;
     styles: Record<import('../../../..').AppearanceType, import('../../../vue').CSSProperties>;
     attachments: Attachment[];
+    attachmentRowClickOpensPreview: boolean;
+    attachmentShowDownload: boolean;
     content?: import('../../../..').BubbleContent | undefined;
     onPreview?: ((config: import('../../../../..').PreviewConfig) => void) | undefined;
     onUserAuthConfirm?: ((optionId: string, name: string, message?: string) => void) | undefined;
@@ -26,6 +28,8 @@ declare const _default: import('../../../vue').DefineComponent<{
     showAvatar: boolean;
     styles: Record<import('../../../..').AppearanceType, import('../../../vue').CSSProperties>;
     attachments: Attachment[];
+    attachmentRowClickOpensPreview: boolean;
+    attachmentShowDownload: boolean;
     content?: import('../../../..').BubbleContent | undefined;
     onPreview?: ((config: import('../../../../..').PreviewConfig) => void) | undefined;
     onUserAuthConfirm?: ((optionId: string, name: string, message?: string) => void) | undefined;
@@ -47,6 +51,8 @@ declare const _default: import('../../../vue').DefineComponent<{
     compositeTailRender: () => import('../../../vue').VNode | null | undefined;
     onDynamicComponentsDetected: (configs: import('../../../../..').DynamicComponentConfig[]) => void;
     onShowDynamicComponent: (config: import('../../../../..').DynamicComponentConfig) => void;
+    attachmentRowClickOpensPreview: boolean;
+    attachmentShowDownload: boolean;
 }, {}, {
     'fx-user-auth-inline': import('../../../vue').DefineComponent<import('../../../vue').ExtractPropTypes<{
         content: {

package/bubble/src/bubble.props.d.ts

@@ -80,5 +80,18 @@ export declare const bubbleProps: {
         type: PropType<(config: DynamicComponentConfig) => void>;
         default: undefined;
     };
+    /**
+     * 为 false 时附件主行点击不触发 `onPreview`（仍可用下载按钮下载）。
+     * 主会话助手带 `bubbleAttachments` 时宜为 false，避免与「仅下载」预期冲突。
+     */
+    attachmentRowClickOpensPreview: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 为 false 时隐藏附件下载按钮（如分栏镜像区仅保留预览）。 */
+    attachmentShowDownload: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
 };
 export type BubbleProps = ExtractPropTypes<typeof bubbleProps>;

package/bubble/src/components/attachment/bubble-attachment.component.d.ts

@@ -4,12 +4,14 @@ declare const _default: import('../../../../../vue').DefineComponent<{
     attachments: Attachment[];
     enableBatchPreview: boolean;
     enableFixedWidth: boolean;
+    showDownloadButton: boolean;
     onPreview?: ((attachment: Attachment) => void) | undefined;
     onBatchPreview?: ((attachments: Attachment[]) => void) | undefined;
 }, () => import("vue/jsx-runtime").JSX.Element | null, {}, {}, {}, import('../../../../../vue').ComponentOptionsMixin, import('../../../../../vue').ComponentOptionsMixin, {}, string, import('../../../../../vue').PublicProps, Readonly<{
     attachments: Attachment[];
     enableBatchPreview: boolean;
     enableFixedWidth: boolean;
+    showDownloadButton: boolean;
     onPreview?: ((attachment: Attachment) => void) | undefined;
     onBatchPreview?: ((attachments: Attachment[]) => void) | undefined;
 }> & Readonly<{}>, {
@@ -17,6 +19,7 @@ declare const _default: import('../../../../../vue').DefineComponent<{
     onPreview: (attachment: Attachment) => void;
     enableBatchPreview: boolean;
     enableFixedWidth: boolean;
+    showDownloadButton: boolean;
     onBatchPreview: (attachments: Attachment[]) => void;
 }, {}, {}, {}, string, import('../../../../../vue').ComponentProvideOptions, true, {}, any>;
 export default _default;

package/bubble/src/components/attachment/bubble-attachment.props.d.ts

@@ -14,6 +14,11 @@ export declare const bubbleAttachmentProps: {
         type: BooleanConstructor;
         default: boolean;
     };
+    /** 为 false 时不展示下载按钮（行点击预览仍由 onPreview 控制） */
+    showDownloadButton: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
     /** 预览附件时触发 */
     onPreview: {
         type: PropType<(attachment: Attachment) => void>;

package/bubble/src/components/bubble-think/bubble-think.props.d.ts

@@ -1,6 +1,6 @@
 import { ExtractPropTypes, PropType } from '../../../../../vue';
 import { ThinkContent } from '../../../../../../../composition/types';
-import { OutputMode } from '../../../../../../../..';
+import { OutputMode } from '../../../../../../../../../common';
 
 export declare const bubbleThinkProps: {
     /** 思考内容 */

package/bubble/src/components/text-content/composition/block-type.d.ts

@@ -2,7 +2,8 @@ import { DynamicComponentConfig } from '../../../../../../../../../../../dynamic
 
 export declare enum BlockType {
     Text = "text",
-    A2UIComplete = "a2ui-complete",
+    /** @deprecated FlowUI 渲染逻辑已迁移至 Venus/x-conversation 层，此类型不再使用 */
+    FlowUIComplete = "flowui-complete",
     AssistantWidgetComplete = "assistant-widget-complete",
     AssistantWidgetPending = "assistant-widget-pending",
     DynamicComponentComplete = "dynamic-component-complete",
@@ -12,10 +13,11 @@ export interface TextBlock {
     type: BlockType.Text;
     raw: string;
 }
-export interface A2UICompleteBlock {
-    type: BlockType.A2UIComplete;
+/** @deprecated FlowUI 渲染逻辑已迁移至 Venus/x-conversation 层，此类型不再使用 */
+export interface FlowUICompleteBlock {
+    type: BlockType.FlowUIComplete;
     raw: string;
-    a2uiData: Record<string, unknown>;
+    flowUiData: Record<string, unknown>;
 }
 export interface AssistantWidgetCompleteBlock {
     type: BlockType.AssistantWidgetComplete;
@@ -38,4 +40,4 @@ export interface DynamicComponentPendingBlock {
     raw: string;
     position: 'inline' | 'right' | null;
 }
-export type ParsedBlock = TextBlock | A2UICompleteBlock | AssistantWidgetCompleteBlock | AssistantWidgetPendingBlock | DynamicComponentCompleteBlock | DynamicComponentPendingBlock;
+export type ParsedBlock = TextBlock | FlowUICompleteBlock | AssistantWidgetCompleteBlock | AssistantWidgetPendingBlock | DynamicComponentCompleteBlock | DynamicComponentPendingBlock;

package/bubble/src/components/text-content/utils/block-renderer.d.ts

@@ -9,5 +9,5 @@ export interface RenderContext {
     renderFileEmbeddedContent: (content: EmbeddedContent, ctx: EmbeddedContentRenderContext) => VNode;
 }
 export type BlockRenderer = (block: ParsedBlock, index: number, ctx: RenderContext) => VNode | VNode[] | null;
-export type RendererRegistry = Record<BlockType, BlockRenderer>;
+export type RendererRegistry = Partial<Record<BlockType, BlockRenderer>>;
 export declare function createRendererRegistry(): RendererRegistry;

package/bubble/src/composition/types.d.ts

@@ -16,7 +16,8 @@ export type BubbleCompositeInlineBlock = {
 /** 文本类型消息内容 */
 export interface BubbleContent {
     type?: 'text';
-    text: string;
+    /** 正文文本，或者预渲染好的 VNode */
+    text: string | VNode;
     textFormat?: BubbleTextFormatType;
     /** 正文与 footer 之间按序渲染的网关块（如 request-run 按钮、app-preview） */
     compositeInlineBlocks?: BubbleCompositeInlineBlock[];

package/bubble/src/composition/use-widget-content.d.ts

@@ -38,11 +38,10 @@
  */
 export declare function isWidgetBlock(text: string): boolean;
 /**
- * 解析 displayText，将包含 assistant-widget 或 A2UI 代码块的内容分割成多个部分
+ * 解析 displayText，将包含 assistant-widget 代码块的内容分割成多个部分
  * 支持完整和不完整的 widget 结构
  * 支持 ``` 后紧跟换行符 + 空格 + widget类型 的格式
  */
 export declare function formatDisplayText(displayText: string): string[];
 export declare function parseAssistantWidget(input: string): any;
-export declare function parseA2UIWidget(input: string): any;
 export declare function getWidgetImplOptions(input: string): any;

package/chat-preview/index.d.ts

@@ -0,0 +1,17 @@
+import { Plugin } from '../../vue';
+import { default as FXChatPreview } from '../../src/chat-preview.component';
+
+export * from '../../src/chat-preview.props';
+export * from '../../src/preview-bridge-protocol';
+export { postAssistantToPreviewIframe, subscribeAssistantInPreviewIframe, type PreviewAssistantBridgeSubscribeOptions, } from '../../src/preview-bridge-host';
+/** 按方法名调用宿主 `window.AgentWorkbenchSDK`（由 `@farris/x-workbench` 注入） */
+export { invokeAgentWorkbenchSdkApi } from '../../src/invoke-agent-workbench-sdk';
+/** @deprecated 请使用 {@link subscribeAssistantInPreviewIframe}；宿主侧见 `@farris/x-workbench` */
+export { createPreviewIframeSdk } from '../../src/preview-iframe-sdk';
+/** @deprecated */
+export type { CreatePreviewIframeSdkOptions } from '../../src/preview-iframe-sdk';
+/** 会话分屏预览：由 FXConversation 注册，供 AgentWorkbenchSDK 等聚合调用 */
+export { registerPreviewChromeSdk, previewLayoutBridge, type PreviewChromeSdkHandlers, } from '../../src/preview-chrome-sdk';
+export { FXChatPreview };
+declare const _default: typeof FXChatPreview & Plugin;
+export default _default;

package/chat-preview/src/chat-preview.component.d.ts

@@ -0,0 +1,34 @@
+import { PreviewConfig } from '../../../../../app-preview';
+
+declare const _default: import('../../../vue').DefineComponent<import('../../../vue').ExtractPropTypes<{
+    previewConfig: {
+        type: import('../../../vue').PropType<PreviewConfig>;
+        default: () => {};
+    };
+    onClose: {
+        type: import('../../../vue').PropType<() => void>;
+        default: () => void;
+    };
+    onIframeLoad: {
+        type: import('../../../vue').PropType<() => void>;
+        default: () => void;
+    };
+}>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import('../../../vue').ComponentOptionsMixin, import('../../../vue').ComponentOptionsMixin, {}, string, import('../../../vue').PublicProps, Readonly<import('../../../vue').ExtractPropTypes<{
+    previewConfig: {
+        type: import('../../../vue').PropType<PreviewConfig>;
+        default: () => {};
+    };
+    onClose: {
+        type: import('../../../vue').PropType<() => void>;
+        default: () => void;
+    };
+    onIframeLoad: {
+        type: import('../../../vue').PropType<() => void>;
+        default: () => void;
+    };
+}>> & Readonly<{}>, {
+    previewConfig: PreviewConfig;
+    onClose: () => void;
+    onIframeLoad: () => void;
+}, {}, {}, {}, string, import('../../../vue').ComponentProvideOptions, true, {}, any>;
+export default _default;

package/chat-preview/src/chat-preview.props.d.ts

@@ -0,0 +1,19 @@
+import { ExtractPropTypes, PropType } from '../../../vue';
+import { PreviewConfig } from '../../../../../app-preview';
+
+export declare const chatPreviewProps: {
+    previewConfig: {
+        type: PropType<PreviewConfig>;
+        default: () => {};
+    };
+    onClose: {
+        type: PropType<() => void>;
+        default: () => void;
+    };
+    /** iframe 文档 load 后回调（用于父页在子页监听器就绪后再 postMessage） */
+    onIframeLoad: {
+        type: PropType<() => void>;
+        default: () => void;
+    };
+};
+export type ChatPreviewProps = ExtractPropTypes<typeof chatPreviewProps>;

package/chat-preview/src/invoke-agent-workbench-sdk.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 按方法名调用宿主挂载的 {@link AgentWorkbenchSDK}（由 `@farris/x-workbench` 在 `window.AgentWorkbenchSDK` 注入）。
+ * 供网关 `InputRecommend` 等配置 `api` + `params`；无宿主 SDK 时会告警并返回 `undefined`。
+ */
+export declare function invokeAgentWorkbenchSdkApi(api: string, params?: unknown[]): unknown;

package/chat-preview/src/preview-bridge-host.d.ts

@@ -0,0 +1,15 @@
+import { PreviewBridgeAssistantPayload } from '../../../preview-bridge-protocol';
+
+export interface PreviewAssistantBridgeSubscribeOptions {
+    /** 允许的父页面 origin；不传则只做结构校验，不校验 origin */
+    allowedParentOrigins?: string[];
+    /**
+     * 为 true（默认）时接受 `window.parent` 或 `window.top` 作为发送方。
+     */
+    allowTopAsSource?: boolean;
+    onAssistantMessage?: (payload: PreviewBridgeAssistantPayload) => void;
+}
+/** 向预览 iframe 的 `contentWindow` 投递助手消息（与 {@link subscribeAssistantInPreviewIframe} 协议一致） */
+export declare function postAssistantToPreviewIframe(targetWindow: Window, targetOrigin: string, payload: PreviewBridgeAssistantPayload): boolean;
+/** 预览页内：订阅父页 / top 推送的助手消息 */
+export declare function subscribeAssistantInPreviewIframe(options: PreviewAssistantBridgeSubscribeOptions): () => void;

package/chat-preview/src/preview-bridge-protocol.d.ts

@@ -0,0 +1,22 @@
+/** 父页 → iframe 的 postMessage 协议（与 iframe 侧 SDK 对齐） */
+export declare const PREVIEW_BRIDGE_SOURCE: "farris-x-preview-bridge";
+export declare const PREVIEW_BRIDGE_VERSION: 1;
+export declare const PREVIEW_BRIDGE_MESSAGE_TYPE_ASSISTANT: "assistant.message";
+export interface PreviewBridgeAssistantPayload {
+    messageId: string;
+    role: 'user' | 'assistant';
+    /** 助手消息的完整 content（与会话内结构一致，由 structured clone / 序列化承载） */
+    content: unknown;
+}
+export interface PreviewBridgeMessageEnvelope {
+    source: typeof PREVIEW_BRIDGE_SOURCE;
+    v: typeof PREVIEW_BRIDGE_VERSION;
+    type: typeof PREVIEW_BRIDGE_MESSAGE_TYPE_ASSISTANT;
+    payload: PreviewBridgeAssistantPayload;
+}
+/**
+ * postMessage 走 structured clone，Vue reactive/Proxy 可能无法克隆导致静默失败；
+ * 先 JSON 往返成纯对象再投递。
+ */
+export declare function clonePreviewPayloadForPostMessage(payload: PreviewBridgeAssistantPayload): PreviewBridgeAssistantPayload;
+export declare function isPreviewBridgeAssistantMessage(data: unknown): data is PreviewBridgeMessageEnvelope;

package/chat-preview/src/preview-chrome-sdk.d.ts

@@ -0,0 +1,28 @@
+import { PreviewConfig } from '../../../../../app-preview/src/types';
+
+/** 由 FXConversation 注入，供 window 侧 imperative 调用（分屏 / 双栏预览） */
+export interface PreviewChromeSdkHandlers {
+    showPreview?: (config: PreviewConfig) => void;
+    closePreviewPane?: () => void;
+    closeRightPreview?: () => void;
+    showFullScreenPreview?: (config: PreviewConfig) => void;
+    closeFullScreenPreview?: () => void;
+}
+/**
+ * 会话组件挂载时注册；卸载时执行返回函数。多实例时后进先出，避免前一个页面卸载清空后一个的句柄。
+ */
+export declare function registerPreviewChromeSdk(handlers: PreviewChromeSdkHandlers): () => void;
+/** 实现细节：对外由 `@farris/x-workbench` 的 `agent-workbench-sdk.ts` 聚合为 `window.AgentWorkbenchSDK`。 */
+export declare const previewLayoutBridge: {
+    /**
+     * 打开或更新预览：右侧空 → 单栏右侧；仅右侧已有 → 双栏（旧右→左，新→右）；**左右已有 → 只替换右侧 iframe**。
+     */
+    readonly showPreview: (config: PreviewConfig) => void;
+    /** 与 {@link previewLayoutBridge.showPreview} 相同，强调在双栏时只换右侧。 */
+    readonly replaceRightPreview: (config: PreviewConfig) => void;
+    readonly closePreviewPane: () => void;
+    readonly closeRightPreview: () => void;
+    readonly showFullScreenPreview: (config: PreviewConfig) => void;
+    readonly closeFullScreenPreview: () => void;
+    readonly isPreviewLayoutActive: () => boolean;
+};

package/chat-preview/src/preview-iframe-sdk.d.ts

@@ -0,0 +1,7 @@
+import { PreviewAssistantBridgeSubscribeOptions } from '../../../preview-bridge-host';
+
+export type CreatePreviewIframeSdkOptions = PreviewAssistantBridgeSubscribeOptions;
+/** @deprecated 请使用 {@link subscribeAssistantInPreviewIframe} */
+export declare function createPreviewIframeSdk(options: CreatePreviewIframeSdkOptions): () => void;
+/** @deprecated 请使用 {@link postAssistantToPreviewIframe} */
+export { postAssistantToPreviewIframe as postAssistantViaAgentWorkbenchSDK } from '../../../preview-bridge-host';

package/components.d.ts

@@ -4,6 +4,8 @@ export { default as FXBubble, FXBubbleAction } from '../bubble';
 export * from '../bubble';
 export { default as FXCarousel, FXCarouselItem } from '../carousel';
 export * from '../carousel';
+export { default as FXChatPreview } from '../chat-preview';
+export * from '../chat-preview';
 export { default as FXConfirmDialog } from '../confirm-dialog';
 export * from '../confirm-dialog';
 export { default as FXCoding } from '../coding';

package/dynamic-component/index.d.ts

@@ -2,6 +2,6 @@ import { Plugin } from '../../vue';
 import { default as FXDynamicComponent } from '../../src/dynamic-component.component';
 export { default as FXDynamicComponent } from '../../src/dynamic-component.component';
 export * from '../../src/composition/types';
-export { loadDynamicComponent, unloadDynamicComponent, postDynamicComponentAssistantMessage } from '../../src/composition/dynamic-component-registry';
+export { loadDynamicComponent, unloadDynamicComponent, postDynamicComponentAssistantMessage, peekDynamicComponentRegisterBootstrapId, normalizeDynamicComponentRegisterClaim, getDynamicComponentRegistryDebugSnapshot } from '../../src/composition/dynamic-component-registry';
 declare const _default: typeof FXDynamicComponent & Plugin;
 export default _default;

package/dynamic-component/src/composition/dynamic-component-registry.d.ts

@@ -1,10 +1,23 @@
 import { DynamicComponentConfig, DynamicComponentAPI, DynamicComponentAssistantMessagePayload } from '../../../../types';
 
+/** 与对话 mock 「口令规范化」同源：隐蔽字符会导致 pending key 肉眼一致却 get 失败 */
+export declare function normalizeDynamicComponentRegisterClaim(raw: unknown): string;
+/** 供调试：`import { peekDynamicComponentRegisterBootstrapId } from '@farris/x-ui'` */
+export declare function peekDynamicComponentRegisterBootstrapId(): string | undefined;
+/** 控制台联调快照 */
+export declare function getDynamicComponentRegistryDebugSnapshot(): {
+    pendingKeys: string[];
+    bootstrapQueue: string[];
+    activeKeys: string[];
+    windowBootstrapPeek?: string;
+};
 export declare function loadDynamicComponent(config: DynamicComponentConfig): Promise<DynamicComponentAPI>;
 export declare function unloadDynamicComponent(id: string): void;
 export declare function postDynamicComponentAssistantMessage(id: string, payload: DynamicComponentAssistantMessagePayload): boolean;
 declare global {
     interface Window {
         __fluens_dynamic_component_register: (id: string, api: DynamicComponentAPI) => void;
+        __fluens_dynamic_component_bootstrap_instance_id?: string;
+        __fluens_get_dynamic_component_registry_debug_snapshot?: typeof getDynamicComponentRegistryDebugSnapshot;
     }
 }

package/dynamic-component/src/composition/types.d.ts

@@ -12,18 +12,20 @@ export interface DynamicComponentConfig {
     isFullscreen?: boolean;
     autoOpen?: boolean;
     fileRe?: string;
+    /** 打开后落位目标面板，默认 'preview' */
+    target?: 'preview' | 'previewExtra';
 }
 export interface DynamicComponentAssistantMessagePayload {
     messageId: string;
-    role: 'assistant';
-    /** 会话内 assistant 消息的完整 content；包含 dynamic-component 围栏、markdown、复合块等结构。 */
+    role: 'user' | 'assistant';
+    /** 会话内消息的完整 content；含 dynamic-component 围栏、markdown、复合块等（与 UI 气泡一致）。 */
     content: unknown;
 }
 export interface DynamicComponentAPI {
     mount(container: HTMLElement, config: DynamicComponentConfig): void;
     unmount(): void;
     /**
-     * 可选：接收唤起当前 dynamic-component 的 assistant 消息，以及之后同会话继续产生的 assistant 消息。
+     * 可选：接收同会话内用户/助手消息（与右侧 iframe 预览桥一致），用于侧栏/预览区与流式同步。
      */
     onAssistantMessage?: (payload: DynamicComponentAssistantMessagePayload) => void;
 }

package/enterprise-cloud/src/types.d.ts

@@ -118,6 +118,10 @@ export interface MessageContentToolUse {
      * 仅以 `trim(result).length` 判断「完成」时，空 stdout 会一直显示「调用中」。
      */
     toolResultApplied?: boolean;
+    /** 工具调用整体是否成功；缺省/`true` 走原成功视觉，仅 `false` 走 `is-error` 视觉 */
+    success?: boolean;
+    /** 失败时的错误描述；优先级高于 result，仅在 `success === false` 时下发 */
+    errorMessage?: string;
     sessionId?: string;
 }
 /** HITL 单题：`agent/hitl-question.content.questions[]`（见《HITL 前端对接》） */
@@ -127,12 +131,23 @@ export interface HitlQuestionOption {
     description?: string;
     preview?: string;
 }
+export interface HitlQuestionField {
+    name: string;
+    label: string;
+    type?: 'text' | 'select' | 'number' | 'date';
+    required?: boolean;
+    options?: string[];
+    default_value?: string;
+    min?: number;
+    max?: number;
+}
 export interface HitlQuestionItem {
     id: string;
     question: string;
     header?: string;
     ui_type?: HitlUiType;
     options?: HitlQuestionOption[];
+    fields?: HitlQuestionField[];
     allow_other?: boolean;
     placeholder?: string;
     default_value?: string;