@h-ai/ai 0.1.0-alpha9 → 1.0.0-beta.10

package/dist/client/index.d.ts

@@ -1,266 +1,98 @@
-import { ac as ChatCompletionRequest, ad as ChatCompletionResponse, aa as ChatCompletionChunk, aD as KnowledgeRetrieveResult, aq as KnowledgeAskResult, az as KnowledgeIngestResult, ar as KnowledgeDocumentInfo, aJ as MemoryEntry, be as StorePage, aK as MemoryEntryInput, aR as MemoryUpdateInput, bc as SessionInfo, ag as ChatRecord, aY as RagResult, b0 as ReasoningResult, O as A2AAgentCardConfig, _ as A2AMessageRecord, V as A2ACallResult } from '../ai-reasoning-types-CGUgkLF7.js';
-import { HaiResult } from '@h-ai/core';
-import '@a2a-js/sdk/server';
-import '@h-ai/datapipe';
-import 'zod';
-import 'openai';
+import { m as TranscriptionRequest, n as TranscriptionResult, p as TranscriptionStreamRequest, T as TranscriptionEvent, h as SynthesisRequest, i as SynthesisResult, j as SynthesisStreamRequest, S as SynthesisEvent } from '../ai-audio-types-4R5yUAVl.js';
+import '@h-ai/core';
 
 /**
- * @h-ai/ai — 前端 AI 客户端
+ * @h-ai/ai/client — 浏览器语音客户端
  *
- * 基于 @h-ai/api-client 的 AI 领域客户端。
- * 通过 `createAIClient()` 工厂函数创建，消除自建 HTTP 层，
- * 复用 api-client 提供的 Token 管理、超时、拦截器等基础能力。
- * @module ai-client
+ * 通过统一 WebSocket 连接 `@h-ai/serv` 的语音入口，向浏览器暴露与 Node 端一致的
+ * `ai.audio.*` 业务 API。WebSocket 建立、消息编解码等传输细节在此内部完成，
+ * 调用方不接触任何厂商原生事件。
+ * @module client/ai-audio-client
  */
 
 /**
- * AI 客户端所需的 API 调用能力
+ * getTicket 收到的当前 Audio 请求摘要
  *
- * 结构兼容 `@h-ai/api-client` 的 `api` 单例（鸭子类型）。
- * 传入 `api` 单例即可，无需额外适配。
- */
-interface AIApiAdapter {
-    /** POST 请求（返回 HaiResult） */
-    post: <T>(path: string, body?: unknown) => Promise<HaiResult<T>>;
-    /** 流式请求（返回 SSE data 行的 AsyncIterable） */
-    stream: (path: string, body?: unknown) => AsyncIterable<string>;
-}
-/**
- * AI 客户端配置
+ * 供应用签发与本次操作严格绑定的能力票据（如 `iam.ticket.issue({ grant })`），
+ * 使票据只能用于本次操作 / 模型 / 会话，降低票据被重放的风险。
  *
  * @example
  * ```ts
- * import { api } from '@h-ai/api-client'
- * import { createAIClient } from '@h-ai/ai/client'
- *
- * await api.init({ baseUrl: '/api', auth: { ... } })
- * const aiClient = createAIClient({ api })
+ * import type { AudioTicketRequest } from '@h-ai/ai/client'
+ * function grant(request: AudioTicketRequest) {
+ *   return { operation: request.operation, model: request.model } // 经已登录 HTTP 接口签发并在服务端原子消费。
+ * }
  * ```
  */
-interface AIClientConfig {
-    /**
-     * API 调用适配器
-     *
-     * 传入 `api` 单例（初始化后）。
-     * baseUrl、Token 管理、超时等通过 api-client 配置。
-     */
-    api: AIApiAdapter;
-}
-/** 流式响应进度（`onProgress` 回调参数） */
-interface StreamProgress {
-    /** 当前累积的文本内容 */
-    content: string;
-    /** 是否已完成 */
-    done: boolean;
-    /** 完成原因（仅 `done=true` 时有值，如 `'stop'`） */
-    finishReason?: string;
-}
-/** 流式响应选项 */
-interface StreamOptions {
-    /** 进度回调（每次收到 chunk 时触发） */
-    onProgress?: (progress: StreamProgress) => void;
+interface AudioTicketRequest {
+    /** 本次操作类型 */
+    operation: 'transcribe' | 'synthesize';
+    /** 本次使用的模型 ID（如有指定） */
+    model?: string;
 }
 /**
- * AI 客户端接口
- *
- * 提供浏览器端调用 AI API 的能力，HTTP 基础设施委托给 @h-ai/api-client。
- */
-interface AIClient {
-    /** 发送对话请求（非流式） */
-    chat: (request: ChatCompletionRequest) => Promise<ChatCompletionResponse>;
-    /** 发送流式对话请求，返回异步迭代器 */
-    chatStream: (request: ChatCompletionRequest, options?: StreamOptions) => AsyncIterable<ChatCompletionChunk>;
-    /** 便捷方法：发送纯文本消息并返回回复文本 */
-    sendMessage: (message: string, systemPrompt?: string) => Promise<string>;
-    /** 便捷方法：流式发送纯文本消息并返回完整回复 */
-    sendMessageStream: (message: string, options?: StreamOptions, systemPrompt?: string) => Promise<string>;
-    /** 简单问答（单轮，自动构造 messages） */
-    ask: (question: string, options?: {
-        systemPrompt?: string;
-        model?: string;
-    }) => Promise<string>;
-    /** 流式简单问答，返回异步文本流 */
-    askStream: (question: string, options?: {
-        systemPrompt?: string;
-        model?: string;
-    }) => AsyncIterable<string>;
-    /** 知识检索（向量 + 实体增强） */
-    knowledgeRetrieve: (query: string, options?: {
-        topK?: number;
-        collection?: string;
-    }) => Promise<KnowledgeRetrieveResult>;
-    /** 知识问答（RAG + 信源） */
-    knowledgeAsk: (query: string, options?: {
-        model?: string;
-        collection?: string;
-    }) => Promise<KnowledgeAskResult>;
-    /** 导入文档 */
-    knowledgeIngest: (input: {
-        documentId: string;
-        content: string;
-        title?: string;
-        collection?: string;
-        metadata?: Record<string, unknown>;
-    }) => Promise<KnowledgeIngestResult>;
-    /** 列出已导入文档 */
-    knowledgeListDocuments: (options?: {
-        collection?: string;
-        offset?: number;
-        limit?: number;
-    }) => Promise<KnowledgeDocumentInfo[]>;
-    /** 删除已导入文档 */
-    knowledgeRemoveDocument: (documentId: string, options?: {
-        collection?: string;
-    }) => Promise<void>;
-    /** 检索相关记忆 */
-    recallMemories: (query: string, options?: {
-        topK?: number;
-        types?: string[];
-        minImportance?: number;
-        objectId?: string;
-    }) => Promise<MemoryEntry[]>;
-    /** 列出记忆（分页） */
-    listMemories: (options?: {
-        types?: string[];
-        objectId?: string;
-        offset?: number;
-        limit?: number;
-    }) => Promise<StorePage<MemoryEntry>>;
-    /** 添加记忆 */
-    addMemory: (entry: MemoryEntryInput) => Promise<MemoryEntry>;
-    /** 更新记忆 */
-    updateMemory: (memoryId: string, updates: MemoryUpdateInput) => Promise<MemoryEntry>;
-    /** 删除记忆 */
-    removeMemory: (memoryId: string) => Promise<void>;
-    /** 列出会话 */
-    listSessions: (objectId: string) => Promise<SessionInfo[]>;
-    /** 重命名会话 */
-    renameSession: (sessionId: string, title: string) => Promise<void>;
-    /** 删除会话 */
-    removeSession: (sessionId: string) => Promise<void>;
-    /** 获取对话历史 */
-    chatHistory: (objectId: string, sessionId: string, options?: {
-        limit?: number;
-        order?: 'asc' | 'desc';
-    }) => Promise<ChatRecord[]>;
-    /** RAG 查询（检索 + 生成） */
-    ragQuery: (query: string, options?: {
-        collection?: string;
-        topK?: number;
-        model?: string;
-    }) => Promise<RagResult>;
-    /** RAG 流式查询，返回 SSE 数据行 */
-    ragQueryStream: (query: string, options?: {
-        collection?: string;
-        topK?: number;
-        model?: string;
-    }) => AsyncIterable<string>;
-    /** 推理（多步思考） */
-    reasoningRun: (query: string, options?: {
-        model?: string;
-        maxSteps?: number;
-    }) => Promise<ReasoningResult>;
-    /** 推理流式，返回 SSE 数据行 */
-    reasoningRunStream: (query: string, options?: {
-        model?: string;
-        maxSteps?: number;
-    }) => AsyncIterable<string>;
-    /** 估算文本的 Token 数 */
-    estimateTokens: (text: string) => Promise<{
-        tokens: number;
-    }>;
-}
-/**
- * 创建 AI 客户端
- *
- * 通过 @h-ai/api-client 的 ApiClient 实例调用后端 AI API。
- * HTTP 层（Token、超时、拦截器）全部复用 api-client，本模块仅负责：
- * - 非流式 / 流式 ChatCompletion 协议适配
- * - SSE 解析与 ChatCompletionChunk 类型化
- * - onProgress 进度回调
- *
- * @param config - 客户端配置
- * @returns AI 客户端实例
+ * 浏览器语音客户端配置
  *
  * @example
  * ```ts
- * import { api } from '@h-ai/api-client'
- * import { createAIClient } from '@h-ai/ai/client'
- *
- * await api.init({ baseUrl: '/api' })
- * const client = createAIClient({ api })
- * const reply = await client.sendMessage('你好')
+ * import { createAudioClient } from '@h-ai/ai/client'
+ * import type { AudioTicketRequest } from '@h-ai/ai/client'
+ * function connect(issueTicket: (request: AudioTicketRequest) => Promise<string>) {
+ *   return createAudioClient({ url: 'wss://example.com/api/v1/ai/audio', getTicket: issueTicket })
+ * }
  * ```
  */
-declare function createAIClient(config: AIClientConfig): AIClient;
+interface AudioClientConfig {
+    /** 语音 WebSocket 完整 URL（如 `wss://host/api/v1/ai/audio`） */
+    url: string;
+    /**
+     * 获取短期、一次性的 Audio WebSocket ticket
+     *
+     * ticket 应由已登录 HTTP 请求签发，并在服务端首次校验时原子消费。
+     * 收到当前请求摘要（operation / model），可签发与本次操作严格绑定的票据。
+     */
+    getTicket: (request: AudioTicketRequest) => string | Promise<string>;
+}
 /**
- * 从 fetch Response 中解析 SSE data 字段
+ * 浏览器语音操作接口
  *
- * 自动处理分片缓冲和 `[DONE]` 结束标记。
- *
- * @param response - fetch 响应对象
- * @yields SSE data 字符串（不含 `[DONE]`）
+ * 与 Node 端 `AudioOperations` 业务形态一致；出错时抛出异常（浏览器 Client 约定）。
  *
  * @example
  * ```ts
- * const resp = await fetch('/api/chat', { method: 'POST', body })
- * for await (const data of parseSSE(resp)) {
- *   const chunk = JSON.parse(data) // ChatCompletionChunk
+ * import type { AudioClientOperations } from '@h-ai/ai/client'
+ * async function speak(audio: AudioClientOperations) {
+ *   // 浏览器 AudioClient 普通方法也显式抛错，由应用交互边界处理。
+ *   const result = await audio.synthesize({ text: '你好', format: 'mp3' })
+ *   return result.data
  * }
  * ```
  */
-declare function parseSSE(response: Response): AsyncIterable<string>;
+interface AudioClientOperations {
+    /** 将完整音频识别为完整文本 */
+    transcribe: (request: TranscriptionRequest) => Promise<TranscriptionResult>;
+    /** 持续输入音频或增量返回识别文本（含语音起止事件） */
+    transcribeStream: (request: TranscriptionStreamRequest) => AsyncIterable<TranscriptionEvent>;
+    /** 将完整文本合成为完整音频 */
+    synthesize: (request: SynthesisRequest) => Promise<SynthesisResult>;
+    /** 持续输入文本段并按段输出结构化音频事件 */
+    synthesizeStream: (request: SynthesisStreamRequest) => AsyncIterable<SynthesisEvent>;
+}
 /**
- * 收集流式响应的完整文本内容
+ * 创建浏览器语音客户端
  *
- * 完整消费流并拼接所有 `delta.content` 片段。
- *
- * @param stream - 聊天响应块流
- * @returns 完整文本
+ * @param config - 语音客户端配置
+ * @returns 浏览器语音操作接口
  *
  * @example
  * ```ts
- * const client = createAIClient({ api })
- * const stream = client.chatStream({ messages })
- * const fullText = await collectStreamContent(stream)
+ * import { createAudioClient } from '@h-ai/ai/client'
+ * import type { AudioTicketRequest } from '@h-ai/ai/client'
+ * function connect(issueTicket: (request: AudioTicketRequest) => Promise<string>) {
+ *   return createAudioClient({ url: 'wss://example.com/api/v1/ai/audio', getTicket: issueTicket })
+ * }
  * ```
  */
-declare function collectStreamContent(stream: AsyncIterable<ChatCompletionChunk>): Promise<string>;
-
-/**
- * @h-ai/ai — 前端 A2A 客户端
- *
- * 浏览器端 A2A 操作客户端，通过 API 服务调用后端 A2A 能力。
- * @module ai-a2a-client
- */
-
-/**
- * A2A 客户端接口
- *
- * 提供浏览器端调用后端 A2A API 的能力。
- */
-interface A2AClientOperations {
-    /** 获取当前 Agent Card 配置 */
-    getAgentCard: () => Promise<A2AAgentCardConfig>;
-    /** 查询 A2A 消息记录 */
-    listMessages: (filter?: {
-        contextId?: string;
-        status?: string;
-        limit?: number;
-        offset?: number;
-    }) => Promise<StorePage<A2AMessageRecord>>;
-    /** 作为客户端调用远端 Agent */
-    callRemoteAgent: (remoteUrl: string, message: string, options?: {
-        timeout?: number;
-    }) => Promise<A2ACallResult>;
-}
-/**
- * 创建 A2A 客户端
- *
- * @param api - API 适配器（来自 @h-ai/api-client）
- * @returns A2A 客户端操作实例
- */
-declare function createA2AClient(api: AIApiAdapter): A2AClientOperations;
+declare function createAudioClient(config: AudioClientConfig): AudioClientOperations;
 
-export { type A2AClientOperations, type AIApiAdapter, type AIClient, type AIClientConfig, type StreamOptions, type StreamProgress, collectStreamContent, createA2AClient, createAIClient, parseSSE };
+export { type AudioClientConfig, type AudioClientOperations, type AudioTicketRequest, createAudioClient };

package/dist/client/index.js

@@ -1,3 +1,4 @@
-export { collectStreamContent, createA2AClient, createAIClient, parseSSE } from '../chunk-ABP7RKIP.js';
+export { createAudioClient } from '../chunk-O6P4P5PC.js';
+import '../chunk-M77C3VAP.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.d.ts

@@ -1,20 +1,21 @@
-export { O as A2AAgentCardConfig, P as A2AApiKeySecurity, Q as A2AAuthenticator, U as A2ACallOptions, V as A2ACallResult, W as A2ACallerIdentity, X as A2AClientCallRecord, A as A2AConfig, a as A2AConfigSchema, Y as A2AContextInfo, Z as A2AHandleResult, _ as A2AMessageRecord, $ as A2AOperations, a0 as A2ASecurityConfig, b as A2ASkillConfigSchema, a1 as A2ATaskFilter, c as AIConfig, d as AIConfigInput, e as AIConfigSchema, a2 as AILLMFunctionsDeps, a3 as AIRelStore, a4 as AIRelStoreOptions, a5 as AIStoreProvider, a6 as AIVectorStore, a7 as AskOptions, a8 as AssistantMessage, a9 as ChatCompletionChoice, aa as ChatCompletionChunk, ab as ChatCompletionDelta, ac as ChatCompletionRequest, ad as ChatCompletionResponse, ae as ChatHistoryOptions, af as ChatMessage, ag as ChatRecord, ah as Citation, C as CompressConfig, f as CompressConfigSchema, ai as DefineToolOptions, E as EmbeddingConfig, g as EmbeddingConfigSchema, aj as EntityDocumentRelation, ak as EntityDocumentResult, al as EntityListOptions, am as EntityQueryOptions, h as EntityType, i as EntityTypeSchema, F as FileConfig, j as FileConfigSchema, an as ImageContent, ao as InteractionScope, ap as KnowledgeAskOptions, aq as KnowledgeAskResult, K as KnowledgeConfig, k as KnowledgeConfigSchema, ar as KnowledgeDocumentInfo, as as KnowledgeDocumentListOptions, at as KnowledgeDocumentRemoveOptions, au as KnowledgeEntity, av as KnowledgeIngestBatchProgress, aw as KnowledgeIngestBatchResult, ax as KnowledgeIngestFileInput, ay as KnowledgeIngestInput, az as KnowledgeIngestResult, aA as KnowledgeOperations, aB as KnowledgeRetrieveItem, aC as KnowledgeRetrieveOptions, aD as KnowledgeRetrieveResult, aE as KnowledgeSetupOptions, aF as KnowledgeStore, L as LLMConfig, l as LLMConfigSchema, aG as LLMOperations, aH as LLMProvider, M as MCPConfig, m as MCPConfigSchema, n as MCPServerCapabilities, o as MCPServerCapabilitiesSchema, p as MCPServerConfig, q as MCPServerConfigSchema, aI as MemoryClearOptions, r as MemoryConfig, s as MemoryConfigSchema, aJ as MemoryEntry, aK as MemoryEntryInput, aL as MemoryExtractOptions, aM as MemoryInjectionOptions, aN as MemoryListOptions, aO as MemoryListPageOptions, aP as MemoryOperations, aQ as MemoryRecallOptions, t as MemoryType, u as MemoryTypeSchema, aR as MemoryUpdateInput, aS as MessageContent, aT as MessageRole, v as ModelEntry, w as ModelEntrySchema, x as ModelScenario, y as ModelScenarioSchema, aU as ObjectRef, aV as RagContextItem, aW as RagOperations, aX as RagOptions, aY as RagResult, aZ as RagStreamEvent, a_ as ReasoningOperations, a$ as ReasoningOptions, b0 as ReasoningResult, b1 as ReasoningStep, b2 as ReasoningStepType, b3 as ReasoningStrategy, b4 as ReasoningStreamEvent, R as ResolveRequiredModelEntryOptions, z as ResolvedModelConfig, B as RetrievalConfig, D as RetrievalConfigSchema, b5 as RetrievalOperations, b6 as RetrievalRequest, b7 as RetrievalResult, b8 as RetrievalResultItem, b9 as RetrievalSource, G as RetrievalSourceConfig, H as RetrievalSourceSchema, ba as SSEDecoder, bb as SSEEvent, bc as SessionInfo, bd as StoreFilter, be as StorePage, bf as StoreScope, bg as StreamOperations, bh as StreamProcessor, bi as StreamResult, S as SummaryConfig, I as SummaryConfigSchema, bj as SystemMessage, bk as TextContent, T as TokenConfig, J as TokenConfigSchema, bl as TokenUsage, bm as Tool, bn as ToolCall, bo as ToolDefinition, bp as ToolErrorType, bq as ToolMessage, br as ToolRegistryOperations, bs as ToolsOperations, bt as UserMessage, bu as WhereClause, bv as WhereOperator, bw as WhereValue, N as resolveModelEntry } from './ai-reasoning-types-CGUgkLF7.js';
-import { A as AIFunctions } from './ai-types-CRCjluXI.js';
-export { a as AIInitOptions, c as AIMCPFunctionsDeps, d as CompressOperations, e as CompressOptions, f as CompressResult, C as CompressionStrategy, b as CompressionStrategySchema, g as ContextChatOptions, h as ContextChatResult, i as ContextDeps, j as ContextManager, k as ContextManagerOptions, l as ContextOperations, m as ContextStreamEvent, E as EmbeddingItem, n as EmbeddingOperations, o as EmbeddingProvider, p as EmbeddingRequest, q as EmbeddingResponse, F as FileOperations, r as FileParseMethod, s as FileParseOptions, t as FileParseRequest, u as FileParseResult, H as HaiAIError, M as MCPContext, v as MCPOperations, w as MCPPrompt, x as MCPPromptArgument, y as MCPPromptContent, z as MCPPromptMessage, B as MCPProvider, D as MCPResource, G as MCPResourceContent, I as MCPToolDefinition, J as MCPToolHandler, K as McpServerOptions, O as OutputFormat, R as RerankDocument, L as RerankItem, N as RerankOperations, P as RerankRequest, Q as RerankResponse, S as SummaryOperations, T as SummaryOptions, U as SummaryResult, V as TokenOperations } from './ai-types-CRCjluXI.js';
-export { TaskStore as A2ATaskStore, AgentExecutor, ExecutionEventBus, RequestContext, ServerCallContext } from '@a2a-js/sdk/server';
+import { I as AIFunctions, c7 as McpServerOptions } from './ai-acp-types-DQ8jO9Ie.js';
+export { A as A2AAgentCardConfig, a as A2AApiKeySecurity, b as A2AAuthenticator, c as A2ACallOptions, d as A2ACallResult, e as A2ACallerIdentity, f as A2AConfig, g as A2AConfigSchema, h as A2AContextInfo, i as A2AHandleResult, j as A2AMessageRecord, k as A2AOperations, l as A2ASecurityConfig, m as A2ASkillConfigSchema, n as A2ATaskFilter, o as ACPAgentAdapter, p as ACPAgentAdapterInput, q as ACPAgentLaunch, r as ACPAgentSchema, s as ACPClientOptions, t as ACPConfig, u as ACPConfigInput, v as ACPConfigSchema, w as ACPCreateSessionOptions, x as ACPGitReport, y as ACPOperations, z as ACPPublishSchema, B as ACPRepositorySchema, C as ACPSessionInfo, D as ACPTransport, E as ACPWorkspaceSchema, F as AIConfig, G as AIConfigInput, H as AIConfigSchema, J as AIInitOptions, K as AIRelStore, L as AIRelStoreCompareAndSwap, M as AIRelStoreOptions, N as AIResourceEntry, O as AIResourceRegistry, P as AIStoreProvider, Q as AIVectorBackend, R as AIVectorStore, S as AIVersionedRecord, T as AUDIO_WS_PATH, U as ApiType, V as ApiTypeSchema, W as AskOptions, X as AssistantMessage, Y as AudioConfig, Z as AudioConfigSchema, _ as AudioFormatSchema, $ as AudioModelEntry, a0 as AudioModelEntrySchema, a1 as AudioOperation, a2 as AudioOperationSchema, a3 as AudioOperationsSchema, a4 as AudioProviderName, a5 as AudioProviderSchema, a6 as AudioWsClientMessage, a7 as AudioWsClientMessageSchema, a8 as AudioWsDoneMessage, a9 as AudioWsDoneMessageSchema, aa as AudioWsEndMessage, ab as AudioWsErrorMessage, ac as AudioWsSegmentDoneMessage, ad as AudioWsSegmentStartedMessage, ae as AudioWsServerMessage, af as AudioWsSpeechMessage, ag as AudioWsStartMessage, ah as AudioWsStartMessageSchema, ai as AudioWsTextMessage, aj as AudioWsTextMessageSchema, ak as AudioWsTranscriptMessage, al as ChatCompletionChoice, am as ChatCompletionChunk, an as ChatCompletionDelta, ao as ChatCompletionRequest, ap as ChatCompletionResponse, aq as ChatHistoryOptions, ar as ChatMessage, as as ChatRecord, at as Citation, au as CommitTurnInput, av as CompressConfig, aw as CompressConfigSchema, ax as CompressOperations, ay as CompressOptions, az as CompressResult, aA as CompressionStrategy, aB as CompressionStrategySchema, aC as ConsolidateOptions, aD as ConsolidateResult, aE as ContextChatOptions, aF as ContextChatResult, aG as ContextManager, aH as ContextManagerOptions, aI as ContextOperations, aJ as ContextResetOptions, aK as ContextStreamEvent, aL as ConversationTurn, aM as ConversationTurnStatus, aN as DefineToolOptions, aO as DeveloperMessage, aP as EmbeddingConfig, aQ as EmbeddingConfigSchema, aR as EmbeddingItem, aS as EmbeddingOperations, aT as EmbeddingRequest, aU as EmbeddingResponse, aV as EntityDocumentRelation, aW as EntityDocumentResult, aX as EntityListOptions, aY as EntityQueryOptions, aZ as EntityType, a_ as EntityTypeSchema, a$ as FileConfig, b0 as FileConfigSchema, b1 as FileOperations, b2 as FileParseMethod, b3 as FileParseOptions, b4 as FileParseRequest, b5 as FileParseResult, b6 as GenerateImageRequest, b7 as GenerateImageResult, b8 as GenerateObjectRequest, b9 as GeneratedImage, ba as HaiAIError, bb as ImageConfig, bc as ImageConfigSchema, bd as ImageContent, be as ImageModelEntry, bf as ImageModelEntrySchema, bg as ImageOperations, bh as ImageProviderName, bi as ImageProviderSchema, bj as ImageSize, bk as InteractionScope, bl as KnowledgeAskOptions, bm as KnowledgeAskResult, bn as KnowledgeConfig, bo as KnowledgeConfigSchema, bp as KnowledgeDocumentInfo, bq as KnowledgeDocumentListOptions, br as KnowledgeDocumentMetadata, bs as KnowledgeDocumentRemoveOptions, bt as KnowledgeDocumentRevision, bu as KnowledgeEntity, bv as KnowledgeIngestBatchProgress, bw as KnowledgeIngestBatchResult, bx as KnowledgeIngestFileInput, by as KnowledgeIngestInput, bz as KnowledgeIngestResult, bA as KnowledgeOperations, bB as KnowledgeRepairOptions, bC as KnowledgeRepairProgress, bD as KnowledgeRepairResult, bE as KnowledgeRetrieveItem, bF as KnowledgeRetrieveOptions, bG as KnowledgeRetrieveResult, bH as KnowledgeSetupOptions, bI as KnowledgeStore, bJ as LLMConfig, bK as LLMConfigSchema, bL as LLMOperations, bM as MCPConfig, bN as MCPConfigSchema, bO as MCPContext, bP as MCPExternalServer, bQ as MCPExternalServerSchema, bR as MCPOperations, bS as MCPPrompt, bT as MCPPromptArgument, bU as MCPPromptContent, bV as MCPPromptMessage, bW as MCPResource, bX as MCPResourceContent, bY as MCPServerCapabilities, bZ as MCPServerCapabilitiesSchema, b_ as MCPServerConfig, b$ as MCPServerConfigSchema, c0 as MCPToolDefinition, c1 as MCPToolHandler, c2 as ManagedAudioOperations, c3 as ManagedImageOperations, c4 as ManagedLLMOperations, c5 as ManagedMCPOperations, c6 as ManagedRetrievalOperations, c8 as MemoryAccessScope, c9 as MemoryAdminOperations, ca as MemoryClearAllOptions, cb as MemoryClearOptions, cc as MemoryConfig, cd as MemoryConfigSchema, ce as MemoryCoreOperations, cf as MemoryEntry, cg as MemoryEntryInput, ch as MemoryExtractOptions, ci as MemoryInjectionOptions, cj as MemoryListOptions, ck as MemoryListPageOptions, cl as MemoryOperations, cm as MemoryRecallOptions, cn as MemoryType, co as MemoryTypeSchema, cp as MemoryUpdateInput, cq as MessageContent, cr as MessageRole, cs as ModelCapabilitiesSchema, ct as ModelEntry, cu as ModelEntrySchema, cv as ModelScenario, cw as ModelScenarioSchema, cx as ObjectRef, cy as OptionalSecretSchema, cz as OutputFormat, cA as PersonaOperations, cB as PersonaProfile, cC as PersonaProfileInput, cD as PersonaProfileUpdate, cE as PersonaScopeOptions, cF as RagContextItem, cG as RagOperations, cH as RagOptions, cI as RagResult, cJ as RagStreamEvent, cK as ReasoningOperations, cL as ReasoningOptions, cM as ReasoningResult, cN as ReasoningStep, cO as ReasoningStepType, cP as ReasoningStrategy, cQ as ReasoningStreamEvent, cR as ReferenceImage, cS as RerankDocument, cT as RerankItem, cU as RerankOperations, cV as RerankRequest, cW as RerankResponse, cX as ResolveRequiredModelEntryOptions, cY as ResolvedAudioModel, cZ as ResolvedImageModel, c_ as ResolvedModelConfig, c$ as RetrievalConfig, d0 as RetrievalConfigSchema, d1 as RetrievalOperations, d2 as RetrievalRequest, d3 as RetrievalResult, d4 as RetrievalResultItem, d5 as RetrievalSource, d6 as RetrievalSourceConfig, d7 as RetrievalSourceSchema, d8 as SSEDecoder, d9 as SSEEvent, da as ScopedMemoryBinding, db as ScopedMemoryOperations, dc as SessionInfo, dd as StoreFilter, de as StorePage, df as StoreScope, dg as StreamOperations, dh as StreamProcessor, di as StreamResult, dj as SummaryConfig, dk as SummaryConfigSchema, dl as SummaryOperations, dm as SummaryOptions, dn as SummaryResult, dp as SystemMessage, dq as TempModelConfig, dr as TextContent, ds as TokenConfig, dt as TokenConfigSchema, du as TokenOperations, dv as TokenUsage, dw as Tool, dx as ToolAuthorizationRequest, dy as ToolAuthorizer, dz as ToolCall, dA as ToolDefinition, dB as ToolErrorType, dC as ToolExecutionContext, dD as ToolExecutionOptions, dE as ToolMessage, dF as ToolRegistryOperations, dG as ToolRegistryOptions, dH as ToolsOperations, dI as UserMessage, dJ as WhereClause, dK as WhereOperator, dL as WhereValue, dM as ensureAudioCredential, dN as resolveAudioModel, dO as resolveImageModel, dP as resolveModelApi, dQ as resolveModelEntry, dR as serializePlayableAudio } from './ai-acp-types-DQ8jO9Ie.js';
+export { A as AudioCapabilitiesRequest, a as AudioContent, b as AudioFormat, c as AudioInputStream, d as AudioModelCapabilities, e as AudioOperations, f as AudioReference, P as PlayableAudio, S as SynthesisEvent, g as SynthesisOptions, h as SynthesisRequest, i as SynthesisResult, j as SynthesisStreamRequest, k as SynthesisTextSegment, T as TranscriptionEvent, l as TranscriptionOptions, m as TranscriptionRequest, n as TranscriptionResult, o as TranscriptionSegment, p as TranscriptionStreamRequest, q as TranscriptionTimestampGranularity, r as TranscriptionWord } from './ai-audio-types-4R5yUAVl.js';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 export { AgentCapabilities, AgentCard, AgentProvider, AgentSkill, Artifact, DataPart, FilePart, FileWithBytes, FileWithUri, Message, MessageSendParams, Part, PushNotificationConfig, Task, TaskArtifactUpdateEvent, TaskIdParams, TaskQueryParams, TaskState, TaskStatus, TaskStatusUpdateEvent, TextPart } from '@a2a-js/sdk';
+export { AgentExecutor, ExecutionEventBus, RequestContext, ServerCallContext } from '@a2a-js/sdk/server';
+export { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
+export { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+export { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
 import '@h-ai/core';
-import '@h-ai/datapipe';
 import 'zod';
-import 'openai';
 import 'node:buffer';
-
-/**
- * @h-ai/ai — AI 服务主入口
- *
- * 提供统一的 `ai` 对象，聚合所有 AI 操作功能。
- * @module ai-main
- */
+import '@h-ai/datapipe';
+import 'zod/v4/core';
+import '@agentclientprotocol/sdk';
+import 'openai';
+import '@modelcontextprotocol/sdk/types.js';
 
 /**
  * AI 服务对象，统一的 AI 访问入口
@@ -22,19 +23,45 @@ import 'node:buffer';
  * @example
  * ```ts
  * import { ai } from '@h-ai/ai'
+ * import type { AIConfigInput, AIInitOptions } from '@h-ai/ai'
+ * async function run(config: AIConfigInput, options: AIInitOptions) {
+ *   // 默认 Store 所需 reldb/vecdb 已由应用初始化；显式测试 Store 通过 options 注入。
+ *   const initialized = await ai.init(config, options)
+ *   if (!initialized.success) return initialized
+ *   try {
+ *     const result = await ai.llm.chat({ messages: [{ role: 'user', content: '你好' }] })
+ *     if (!result.success) return result
+ *     return result.data.choices[0]?.message.content
+ *   }
+ *   finally { await ai.close() }
+ * }
+ * ```
+ */
+declare const ai: AIFunctions;
+
+/**
+ * @h-ai/ai — MCP Server 创建与传输层
+ *
+ * 基于 `@modelcontextprotocol/sdk` 封装，提供便捷的 MCP 服务器创建。
+ * @module ai-mcp-server
+ */
+
+/**
+ * 创建 MCP 服务器
  *
- * // 初始化
- * await ai.init({ llm: { model: 'gpt-4o-mini', apiKey: process.env.HAI_AI_LLM_API_KEY } })
+ * @param options - 服务器选项（名称、版本）
+ * @returns McpServer 实例
  *
- * // LLM 调用
- * const result = await ai.llm.chat({
- *   messages: [{ role: 'user', content: '你好' }],
- * })
+ * @example
+ * ```ts
+ * import { createMcpServer, StdioServerTransport } from '@h-ai/ai'
  *
- * // 关闭
- * ai.close()
+ * const server = createMcpServer({ name: 'my-server', version: '1.0.0' })
+ * // 注册工具 / 资源 ...
+ * const transport = new StdioServerTransport()
+ * await server.connect(transport)
  * ```
  */
-declare const ai: AIFunctions;
+declare function createMcpServer(options: McpServerOptions): McpServer;
 
-export { AIFunctions, ai };
+export { AIFunctions, McpServerOptions, ai, createMcpServer };