@siact/sime-x-vue 0.0.9 → 0.0.11

package/types/composables/use-voice-recognition.d.ts

@@ -1,28 +1,28 @@
-import type { VoiceConfig } from '../types';
-export type VoiceStatus = 'standby' | 'listening';
-export interface UseVoiceRecognitionOptions {
-    modelPath?: string;
-    wakeWords?: string[];
-    getVoiceConfig: () => VoiceConfig | null;
-    /** 唤醒时回调 */
-    onWake?: () => void;
-    /** 转写完成（autoStop）时回调 */
-    onTranscriptionDone?: (text: string) => void;
-}
-/**
- * 语音识别 composable
- *
- * 管理唤醒词检测器 + 语音转写器的生命周期。
- */
-export declare function useVoiceRecognition(options: UseVoiceRecognitionOptions): {
-    voiceStatus: import("vue").Ref<VoiceStatus, VoiceStatus>;
-    isTranscribing: import("vue").Ref<boolean, boolean>;
-    isInitializing: import("vue").Ref<boolean, boolean>;
-    transcriptionText: import("vue").Ref<string, string>;
-    wakeAnimating: import("vue").Ref<boolean, boolean>;
-    startTranscribing: () => Promise<void>;
-    stopTranscribing: () => Promise<void>;
-    abortTranscription: () => Promise<void>;
-    toggleVoiceMode: (targetState?: boolean) => Promise<void>;
-    destroy: () => Promise<void>;
-};
+import type { VoiceConfig } from '../types';
+export type VoiceStatus = 'standby' | 'listening';
+export interface UseVoiceRecognitionOptions {
+    modelPath?: string;
+    wakeWords?: string[];
+    getVoiceConfig: () => VoiceConfig | null;
+    /** 唤醒时回调 */
+    onWake?: () => void;
+    /** 转写完成（autoStop）时回调 */
+    onTranscriptionDone?: (text: string) => void;
+}
+/**
+ * 语音识别 composable
+ *
+ * 管理唤醒词检测器 + 语音转写器的生命周期。
+ */
+export declare function useVoiceRecognition(options: UseVoiceRecognitionOptions): {
+    voiceStatus: import("vue").Ref<VoiceStatus, VoiceStatus>;
+    isTranscribing: import("vue").Ref<boolean, boolean>;
+    isInitializing: import("vue").Ref<boolean, boolean>;
+    transcriptionText: import("vue").Ref<string, string>;
+    wakeAnimating: import("vue").Ref<boolean, boolean>;
+    startTranscribing: () => Promise<void>;
+    stopTranscribing: () => Promise<void>;
+    abortTranscription: () => Promise<void>;
+    toggleVoiceMode: (targetState?: boolean) => Promise<void>;
+    destroy: () => Promise<void>;
+};

package/types/index.d.ts

@@ -1,5 +1,7 @@
-export { default as AiChatbotProvider } from './components/sime-provider.vue';
-export { default as AiChatbotX } from './components/sime-x.vue';
-export { default as AiChatbotVoiceAssistant } from './components/voice-assistant.vue';
-export * from './injection-key';
-export * from './types';
+export { default as AiChat } from './components/ai-chat.vue';
+export { default as AiChatbotProvider } from './components/sime-provider.vue';
+export { default as AiChatbotVoiceAssistant } from './components/voice-assistant.vue';
+export * from './injection-key';
+export { AgentChatTransport, createAgentChatTransport } from './lib/agent-chat-transport';
+export type { AgentChatTransportOptions } from './lib/agent-chat-transport';
+export * from './types';

package/types/injection-key.d.ts

@@ -1,6 +1,6 @@
-import type { InjectionKey } from 'vue';
-import type { AiChatbotXContext } from './types';
-export declare const AiChatbotXKey: InjectionKey<AiChatbotXContext>;
-export declare function injectStrict<T>(key: InjectionKey<T>): T;
-export declare function injectStrict<T>(key: InjectionKey<T>, defaultValue: T, treatDefaultAsFactory?: false): T;
-export declare function injectStrict<T>(key: InjectionKey<T>, defaultValue: T | (() => T), treatDefaultAsFactory: true): T;
+import type { InjectionKey } from 'vue';
+import type { AiChatbotXContext } from './types';
+export declare const AiChatbotXKey: InjectionKey<AiChatbotXContext>;
+export declare function injectStrict<T>(key: InjectionKey<T>): T;
+export declare function injectStrict<T>(key: InjectionKey<T>, defaultValue: T, treatDefaultAsFactory?: false): T;
+export declare function injectStrict<T>(key: InjectionKey<T>, defaultValue: T | (() => T), treatDefaultAsFactory: true): T;

package/types/lib/agent-chat-transport.d.ts

@@ -0,0 +1,35 @@
+import type { UIMessage } from 'ai';
+import { DefaultChatTransport } from 'ai';
+import type { DiscoveredCommand } from '../utils/command-types';
+export interface AgentChatTransportOptions {
+    /** streamInvoke endpoint URL, e.g. http://host/agent/{id}/stream-invoke */
+    api: string;
+    /** 项目 ID */
+    projectId?: string;
+    /** 动态获取宿主命令 */
+    getCommands?: () => Promise<DiscoveredCommand[]>;
+    /** 额外 headers */
+    headers?: Record<string, string> | (() => Record<string, string>);
+    /** 额外 body 字段 */
+    body?: Record<string, unknown> | (() => Record<string, unknown>);
+}
+/**
+ * 基于 DefaultChatTransport 的自定义 Transport，
+ * 通过 prepareSendMessagesRequest 将 AI SDK 标准 messages 转换为 streamInvoke 接口格式。
+ *
+ * streamInvoke 期望：{ input, projectId, commands, messages }
+ * - input: 最后一条 user 消息的文本
+ * - messages: 历史对话（不含最后一条 user 消息）
+ * - commands: 宿主命令列表
+ * - projectId: 项目 ID
+ */
+export declare function createAgentChatTransport(options: AgentChatTransportOptions): DefaultChatTransport<UIMessage<unknown, import("ai").UIDataTypes, import("ai").UITools>>;
+/**
+ * 带命令注入的 AgentChatTransport 工厂函数
+ * 在每次发送前异步获取宿主命令并注入 body
+ */
+export declare class AgentChatTransport extends DefaultChatTransport<UIMessage> {
+    private agentOptions;
+    constructor(options: AgentChatTransportOptions);
+    sendMessages(options: Parameters<DefaultChatTransport<UIMessage>['sendMessages']>[0]): Promise<ReadableStream<import("ai").UIMessageChunk<unknown, import("ai").UIDataTypes>>>;
+}

package/types/lib/data-stream-parser.d.ts

@@ -1,84 +1,84 @@
-/**
- * AI SDK Stream Protocol Parser for Vue
- *
- * Handles THREE possible response formats from the agent/chat service:
- *
- * Format A – UI Message Stream Protocol (pipeUIMessageStreamToResponse) ★ PRIMARY
- *   SSE format with JSON objects containing a "type" field:
- *   data: {"type":"start","messageId":"..."}
- *   data: {"type":"text-delta","id":"...","delta":"Hello"}
- *   data: {"type":"tool-input-start","toolCallId":"...","toolName":"..."}
- *   data: {"type":"tool-input-delta","toolCallId":"...","inputTextDelta":"..."}
- *   data: {"type":"tool-input-available","toolCallId":"...","toolName":"...","input":{...}}
- *   data: {"type":"tool-output-available","toolCallId":"...","output":{...}}
- *   data: {"type":"finish-step"}
- *   data: {"type":"finish"}
- *   data: [DONE]
- *
- * Format B – Legacy Data Stream Protocol (pipeDataStreamToResponse)
- *   Each line: CODE:JSON_VALUE\n
- *   0:"text"  9:{toolCallId,toolName}  c:{toolCallId,toolName,args}  a:{toolCallId,result}
- *
- * Format C – Plain text stream (pipeTextStreamToResponse fallback)
- *   Raw UTF-8 text chunks with no protocol framing.
- *
- * The parser auto-detects the format from the first chunk.
- */
-export type ToolState = 'partial-call' | 'call' | 'result' | 'error';
-export interface TextPart {
-    type: 'text';
-    text: string;
-}
-export interface ToolCallPart {
-    type: 'tool-call';
-    toolCallId: string;
-    toolName: string;
-    args: any;
-    state: ToolState;
-}
-export interface ToolResultPart {
-    type: 'tool-result';
-    toolCallId: string;
-    toolName: string;
-    args: any;
-    result: any;
-    state: ToolState;
-}
-export type MessagePart = TextPart | ToolCallPart | ToolResultPart;
-export interface StreamMessage {
-    id: string;
-    role: 'user' | 'assistant';
-    parts: MessagePart[];
-    createdAt: number;
-}
-interface ToolCallTracker {
-    toolCallId: string;
-    toolName: string;
-    argsText: string;
-    args: any;
-    result?: any;
-    state: ToolState;
-}
-export type StreamEventType = 'text-delta' | 'tool-call-start' | 'tool-call-delta' | 'tool-call-complete' | 'tool-result' | 'step-finish' | 'finish' | 'error';
-export interface StreamEvent {
-    type: StreamEventType;
-    data: any;
-}
-export interface DataStreamCallbacks {
-    onTextDelta?: (text: string) => void;
-    onToolCallStart?: (toolCallId: string, toolName: string) => void;
-    onToolCallDelta?: (toolCallId: string, argsTextDelta: string) => void;
-    onToolCallComplete?: (toolCallId: string, toolName: string, args: any) => void;
-    onToolResult?: (toolCallId: string, result: any) => void;
-    onStepFinish?: (data: any) => void;
-    onFinish?: (data: any) => void;
-    onError?: (error: string) => void;
-}
-export declare function readDataStream(response: Response, callbacks: DataStreamCallbacks): Promise<void>;
-export interface StreamParseResult {
-    textContent: string;
-    parts: MessagePart[];
-    toolCalls: Map<string, ToolCallTracker>;
-}
-export declare function parseDataStreamToMessage(response: Response, onUpdate: (result: StreamParseResult) => void): Promise<StreamParseResult>;
-export {};
+/**
+ * AI SDK Stream Protocol Parser for Vue
+ *
+ * Handles THREE possible response formats from the agent/chat service:
+ *
+ * Format A – UI Message Stream Protocol (pipeUIMessageStreamToResponse) ★ PRIMARY
+ *   SSE format with JSON objects containing a "type" field:
+ *   data: {"type":"start","messageId":"..."}
+ *   data: {"type":"text-delta","id":"...","delta":"Hello"}
+ *   data: {"type":"tool-input-start","toolCallId":"...","toolName":"..."}
+ *   data: {"type":"tool-input-delta","toolCallId":"...","inputTextDelta":"..."}
+ *   data: {"type":"tool-input-available","toolCallId":"...","toolName":"...","input":{...}}
+ *   data: {"type":"tool-output-available","toolCallId":"...","output":{...}}
+ *   data: {"type":"finish-step"}
+ *   data: {"type":"finish"}
+ *   data: [DONE]
+ *
+ * Format B – Legacy Data Stream Protocol (pipeDataStreamToResponse)
+ *   Each line: CODE:JSON_VALUE\n
+ *   0:"text"  9:{toolCallId,toolName}  c:{toolCallId,toolName,args}  a:{toolCallId,result}
+ *
+ * Format C – Plain text stream (pipeTextStreamToResponse fallback)
+ *   Raw UTF-8 text chunks with no protocol framing.
+ *
+ * The parser auto-detects the format from the first chunk.
+ */
+export type ToolState = 'partial-call' | 'call' | 'result' | 'error';
+export interface TextPart {
+    type: 'text';
+    text: string;
+}
+export interface ToolCallPart {
+    type: 'tool-call';
+    toolCallId: string;
+    toolName: string;
+    args: any;
+    state: ToolState;
+}
+export interface ToolResultPart {
+    type: 'tool-result';
+    toolCallId: string;
+    toolName: string;
+    args: any;
+    result: any;
+    state: ToolState;
+}
+export type MessagePart = TextPart | ToolCallPart | ToolResultPart;
+export interface StreamMessage {
+    id: string;
+    role: 'user' | 'assistant';
+    parts: MessagePart[];
+    createdAt: number;
+}
+interface ToolCallTracker {
+    toolCallId: string;
+    toolName: string;
+    argsText: string;
+    args: any;
+    result?: any;
+    state: ToolState;
+}
+export type StreamEventType = 'text-delta' | 'tool-call-start' | 'tool-call-delta' | 'tool-call-complete' | 'tool-result' | 'step-finish' | 'finish' | 'error';
+export interface StreamEvent {
+    type: StreamEventType;
+    data: any;
+}
+export interface DataStreamCallbacks {
+    onTextDelta?: (text: string) => void;
+    onToolCallStart?: (toolCallId: string, toolName: string) => void;
+    onToolCallDelta?: (toolCallId: string, argsTextDelta: string) => void;
+    onToolCallComplete?: (toolCallId: string, toolName: string, args: any) => void;
+    onToolResult?: (toolCallId: string, result: any) => void;
+    onStepFinish?: (data: any) => void;
+    onFinish?: (data: any) => void;
+    onError?: (error: string, data?: any) => void;
+}
+export declare function readDataStream(response: Response, callbacks: DataStreamCallbacks): Promise<void>;
+export interface StreamParseResult {
+    textContent: string;
+    parts: MessagePart[];
+    toolCalls: Map<string, ToolCallTracker>;
+}
+export declare function parseDataStreamToMessage(response: Response, onUpdate: (result: StreamParseResult) => void): Promise<StreamParseResult>;
+export {};

package/types/lib/utils.d.ts

@@ -1,14 +1,14 @@
-import { DiscoveredCommand } from '@siact/sime-bridge';
-export declare const ensureMicrophonePermission: () => Promise<boolean>;
-/**
- * 语音命令匹配函数
- * @param {string} userInput - 用户输入的原始语音文本
- * @param {Array} commandList - 命令列表对象数组
- * @param {number} threshold - 相似度阈值 (0-1)，默认 0.5
- */
-export declare function matchVoiceCommand(userInput: string, commandList: DiscoveredCommand[], threshold?: number): {
-    confidence: number;
-    name: string;
-    description: string;
-    parameters?: import("@siact/sime-bridge").CommandParameter[] | undefined;
-} | null;
+import { DiscoveredCommand } from '../utils/command-types';
+export declare const ensureMicrophonePermission: () => Promise<boolean>;
+/**
+ * 语音命令匹配函数
+ * @param {string} userInput - 用户输入的原始语音文本
+ * @param {Array} commandList - 命令列表对象数组
+ * @param {number} threshold - 相似度阈值 (0-1)，默认 0.5
+ */
+export declare function matchVoiceCommand(userInput: string, commandList: DiscoveredCommand[], threshold?: number): {
+    confidence: number;
+    name: string;
+    description: string;
+    parameters?: import("../utils/command-types").CommandParameter[];
+} | null;

package/types/main.d.ts

@@ -1 +1 @@
-export {};
+export {};

package/types/types.d.ts

@@ -1,54 +1,45 @@
-import type { CommandDefinition, DiscoveredCommand } from '@siact/sime-bridge';
-export declare enum clientCommandKey {
-    SET_THEME = "SiMeAgent_setTheme",
-    APPEND_MESSAGE = "SiMeAgent_appendMessage",
-    WAKE = "SiMeAgent_wake",
-    TRANSITION = "SiMeAgent_transition",
-    TRANSITION_END = "SiMeAgent_transition_end",
-    START_NEW_CONVERSATION = "SiMeAgent_startNewConversation",
-    RECOGNITION = "SiMeAgent_recognition"
-}
-export interface VoiceConfig {
-    appId: string;
-    /** STT（语音转写）apiKey */
-    apiKey: string;
-    /** apiSecret，TTS 鉴权必需 */
-    apiSecret?: string;
-    /** STT（语音转写）WebSocket 地址 */
-    websocketUrl: string;
-    /** TTS apiKey（可选，不填则复用 apiKey） */
-    ttsApiKey?: string;
-    /** TTS（语音合成）WebSocket 地址 */
-    ttsWebsocketUrl?: string;
-    /** TTS 发音人，默认 xiaoyan */
-    ttsVcn?: string;
-}
-export interface AiChatbotXContext {
-    chatbotUrl: () => string;
-    appId: () => string;
-    appToken: () => string;
-    voiceConfig: () => VoiceConfig;
-    registerCommand: (cmd: CommandDefinition) => void;
-    unregisterCommand: (name: string) => void;
-    clientCommand: () => Promise<DiscoveredCommand[]>;
-    hostCommads: () => Promise<DiscoveredCommand[]>;
-    appendMessage: (message: string) => Promise<void>;
-    setTheme: (theme: string) => Promise<void>;
-    weak: () => Promise<void>;
-    startListening: () => Promise<void>;
-    stopListening: () => Promise<void>;
-    toggleCollapse: () => Promise<void>;
-    openDialog: () => Promise<void>;
-    closeDialog: () => Promise<void>;
-    registerVoiceMethods: (methods: {
-        start: () => Promise<void>;
-        stop: () => Promise<void>;
-        toggleCollapse: () => Promise<void>;
-        openDialog: () => Promise<void>;
-        closeDialog: () => Promise<void>;
-    }) => void;
-    startNewConversation: () => Promise<void>;
-    setIframeElement: (iframe: HTMLIFrameElement) => void;
-    recognition: (message: string, commands: DiscoveredCommand[]) => Promise<any>;
-    executeCommand: (commandName: string, args?: any[]) => Promise<any>;
-}
+import type { CommandDefinition, DiscoveredCommand } from './utils/command-types';
+export declare enum clientCommandKey {
+    SET_THEME = "SiMeAgent_setTheme",
+    APPEND_MESSAGE = "SiMeAgent_appendMessage",
+    WAKE = "SiMeAgent_wake",
+    TRANSITION = "SiMeAgent_transition",
+    TRANSITION_END = "SiMeAgent_transition_end",
+    START_NEW_CONVERSATION = "SiMeAgent_startNewConversation",
+    RECOGNITION = "SiMeAgent_recognition"
+}
+export interface VoiceConfig {
+    appId: string;
+    /** STT（语音转写）apiKey */
+    apiKey: string;
+    /** apiSecret，TTS 鉴权必需 */
+    apiSecret?: string;
+    /** STT（语音转写）WebSocket 地址 */
+    websocketUrl: string;
+    /** TTS apiKey（可选，不填则复用 apiKey） */
+    ttsApiKey?: string;
+    /** TTS（语音合成）WebSocket 地址 */
+    ttsWebsocketUrl?: string;
+    /** TTS 发音人，默认 xiaoyan */
+    ttsVcn?: string;
+    /** TTS 发音速度 */
+    speed?: number;
+    /** TTS 发音音量 */
+    volume?: number;
+    /** TTS 发音音调 */
+    pitch?: number;
+}
+export interface AiChatbotXContext {
+    chatbotUrl: () => string;
+    appId: () => string;
+    appToken: () => string;
+    registerCommand: (cmd: CommandDefinition) => void;
+    unregisterCommand: (name: string) => void;
+    getCommads: () => Promise<DiscoveredCommand[]>;
+    /** 中止当前语音播报并关闭气泡 */
+    stopBroadcast: () => Promise<void>;
+    registerVoiceMethods: (methods: {
+        stopBroadcast?: () => Promise<void>;
+    }) => void;
+    executeCommand: (commandName: string, args?: any[]) => Promise<any>;
+}

package/types/utils/command-manager.d.ts

@@ -0,0 +1,16 @@
+import type { CommandDefinition, DiscoveredCommand } from './command-types';
+export interface CommandManagerOptions {
+    debug?: boolean;
+}
+export declare class CommandManager {
+    private commands;
+    private debug;
+    constructor(options?: CommandManagerOptions);
+    registerCommand(command: CommandDefinition): void;
+    unregisterCommand(name: string): void;
+    executeCommand(command: string, args?: any[]): Promise<any>;
+    getCommands(): DiscoveredCommand[];
+    hasCommand(name: string): boolean;
+    clear(): void;
+    private log;
+}

package/types/utils/command-types.d.ts

@@ -0,0 +1,20 @@
+export interface CommandHandler {
+    (...args: any[]): any | Promise<any>;
+}
+export interface CommandParameter {
+    name: string;
+    description?: string;
+    type: 'string' | 'number' | 'boolean' | 'object' | 'array';
+    required: boolean;
+}
+export interface CommandDefinition {
+    name: string;
+    description: string;
+    handler: CommandHandler;
+    parameters?: CommandParameter[];
+}
+export interface DiscoveredCommand {
+    name: string;
+    description: string;
+    parameters?: CommandParameter[];
+}

package/types/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from './command-types';
+export * from './command-manager';

package/types/components/execution-status.vue.d.ts

@@ -1,17 +0,0 @@
-declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
-    visible: boolean;
-    text?: string | undefined;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
-    visible: boolean;
-    text?: string | undefined;
-}>>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-export default _default;
-type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
-type __VLS_TypePropsToRuntimeProps<T> = {
-    [K in keyof T]-?: {} extends Pick<T, K> ? {
-        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
-    } : {
-        type: import('vue').PropType<T[K]>;
-        required: true;
-    };
-};

package/types/components/sime-x.vue.d.ts

@@ -1,43 +0,0 @@
-interface XSize {
-    width: number;
-    height: number;
-}
-interface xDialogSize {
-    width: number;
-    height: number;
-}
-declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
-    xLogo?: string | undefined;
-    xSize?: XSize | undefined;
-    xTitle?: string | undefined;
-    xTheme?: "light" | "dark" | "system" | undefined;
-    xDialogSize?: xDialogSize | undefined;
-    wakeWords?: string[] | undefined;
-    modelPath?: string | undefined;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    "start-transcribing": () => void;
-    "stop-transcribing": () => void;
-    wakeUp: (isWake: boolean) => void;
-}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
-    xLogo?: string | undefined;
-    xSize?: XSize | undefined;
-    xTitle?: string | undefined;
-    xTheme?: "light" | "dark" | "system" | undefined;
-    xDialogSize?: xDialogSize | undefined;
-    wakeWords?: string[] | undefined;
-    modelPath?: string | undefined;
-}>>> & Readonly<{
-    "onStart-transcribing"?: (() => any) | undefined;
-    "onStop-transcribing"?: (() => any) | undefined;
-    onWakeUp?: ((isWake: boolean) => any) | undefined;
-}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-export default _default;
-type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
-type __VLS_TypePropsToRuntimeProps<T> = {
-    [K in keyof T]-?: {} extends Pick<T, K> ? {
-        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
-    } : {
-        type: import('vue').PropType<T[K]>;
-        required: true;
-    };
-};

package/types/debug-page.vue.d.ts

@@ -1,2 +0,0 @@
-declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-export default _default;