@h-ai/ai 0.1.0-alpha.67 → 0.1.0-alpha.69

package/dist/client/index.d.ts

@@ -1,10 +1,5 @@
-import { ao as TranscriptionRequest, ap as TranscriptionResult, ar as TranscriptionStreamRequest, am as TranscriptionEvent, ag as SynthesisRequest, ah as SynthesisResult, ai as SynthesisStreamRequest, ae as SynthesisEvent, aX as ChatCompletionRequest, aY as ChatCompletionResponse, aV as ChatCompletionChunk, bn as KnowledgeRetrieveResult, ba as KnowledgeAskResult, bj as KnowledgeIngestResult, bb as KnowledgeDocumentInfo, bx as MemoryEntry, c4 as StorePage, by as MemoryEntryInput, bF as MemoryUpdateInput, c2 as SessionInfo, a$ as ChatRecord, bM as RagResult, bQ as ReasoningResult, aI as A2AMessageRecord, aE as A2ACallResult } from '../ai-reasoning-types-DZd_6Umd.js';
-import { HaiResult } from '@h-ai/core';
-import { AgentCard } from '@a2a-js/sdk';
-import '@h-ai/datapipe';
-import 'zod';
-import '@a2a-js/sdk/server';
-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/client — 浏览器语音客户端
@@ -20,6 +15,14 @@ import 'openai';
  *
  * 供应用签发与本次操作严格绑定的能力票据（如 `iam.ticket.issue({ grant })`），
  * 使票据只能用于本次操作 / 模型 / 会话，降低票据被重放的风险。
+ *
+ * @example
+ * ```ts
+ * import type { AudioTicketRequest } from '@h-ai/ai/client'
+ * function grant(request: AudioTicketRequest) {
+ *   return { operation: request.operation, model: request.model } // 经已登录 HTTP 接口签发并在服务端原子消费。
+ * }
+ * ```
  */
 interface AudioTicketRequest {
     /** 本次操作类型 */
@@ -27,7 +30,18 @@ interface AudioTicketRequest {
     /** 本次使用的模型 ID（如有指定） */
     model?: string;
 }
-/** 浏览器语音客户端配置 */
+/**
+ * 浏览器语音客户端配置
+ *
+ * @example
+ * ```ts
+ * 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 })
+ * }
+ * ```
+ */
 interface AudioClientConfig {
     /** 语音 WebSocket 完整 URL（如 `wss://host/api/v1/ai/audio`） */
     url: string;
@@ -43,6 +57,16 @@ interface AudioClientConfig {
  * 浏览器语音操作接口
  *
  * 与 Node 端 `AudioOperations` 业务形态一致；出错时抛出异常（浏览器 Client 约定）。
+ *
+ * @example
+ * ```ts
+ * 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
+ * }
+ * ```
  */
 interface AudioClientOperations {
     /** 将完整音频识别为完整文本 */
@@ -59,276 +83,16 @@ interface AudioClientOperations {
  *
  * @param config - 语音客户端配置
  * @returns 浏览器语音操作接口
- */
-declare function createAudioClient(config: AudioClientConfig): AudioClientOperations;
-/** 未配置语音入口时的占位实现（调用即抛出，提示需配置 audio） */
-declare function createUnconfiguredAudioClient(): AudioClientOperations;
-
-/**
- * @h-ai/ai — 前端 AI 客户端
- *
- * 基于 @h-ai/api-client 的 AI 领域客户端。
- * 通过 `createAIClient()` 工厂函数创建，消除自建 HTTP 层，
- * 复用 api-client 提供的 Token 管理、超时、拦截器等基础能力。
- * @module ai-client
- */
-
-/**
- * AI 客户端所需的 API 调用能力
- *
- * 结构兼容 `@h-ai/api-client` 的 `apiClient` 默认单例（鸭子类型）。
- * 传入 `apiClient` 默认单例即可，无需额外适配。
- */
-interface AIApiAdapter {
-    /** POST 请求（返回 HaiResult） */
-    post: <T>(path: string, body?: unknown) => Promise<HaiResult<T>>;
-    /** 流式请求（返回 SSE data 行的 AsyncIterable） */
-    stream: (path: string, body?: unknown) => AsyncIterable<string>;
-}
-/**
- * AI 客户端配置
  *
  * @example
  * ```ts
- * import { apiClient } from '@h-ai/api-client'
- * import { createAIClient } from '@h-ai/ai/client'
- *
- * await apiClient.init({ baseUrl: '/api', auth: { ... } })
- * const aiClient = createAIClient({ api: apiClient })
- * ```
- */
-interface AIClientConfig {
-    /**
-     * API 调用适配器
-     *
-     * 传入 `apiClient` 默认单例（初始化后）。
-     * baseUrl、Token 管理、超时等通过 api-client 配置。
-     */
-    api: AIApiAdapter;
-    /**
-     * 语音 WebSocket 配置（可选）
-     *
-     * 提供后 `client.audio.*` 通过统一 WebSocket 连接 `@h-ai/serv` 语音入口；
-     * 未提供时调用 `client.audio.*` 抛出「未配置」错误。
-     */
-    audio?: AudioClientConfig;
-}
-/** 流式响应进度（`onProgress` 回调参数） */
-interface StreamProgress {
-    /** 当前累积的文本内容 */
-    content: string;
-    /** 是否已完成 */
-    done: boolean;
-    /** 完成原因（仅 `done=true` 时有值，如 `'stop'`） */
-    finishReason?: string;
-}
-/** 流式响应选项 */
-interface StreamOptions {
-    /** 进度回调（每次收到 chunk 时触发） */
-    onProgress?: (progress: StreamProgress) => void;
-}
-/**
- * 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;
-    }>;
-    /** 语音操作（识别 / 合成），需在 createAIClient 配置 `audio` */
-    audio: AudioClientOperations;
-}
-/**
- * 创建 AI 客户端
- *
- * 通过 @h-ai/api-client 的 ApiClient 实例调用后端 AI API。
- * HTTP 层（Token、超时、拦截器）全部复用 api-client，本模块仅负责：
- * - 非流式 / 流式 ChatCompletion 协议适配
- * - SSE 解析与 ChatCompletionChunk 类型化
- * - onProgress 进度回调
- *
- * @param config - 客户端配置
- * @returns AI 客户端实例
- *
- * @example
- * ```ts
- * import { apiClient } from '@h-ai/api-client'
- * import { createAIClient } from '@h-ai/ai/client'
- *
- * await apiClient.init({ baseUrl: '/api' })
- * const client = createAIClient({ api: apiClient })
- * const reply = await client.sendMessage('你好')
- * ```
- */
-declare function createAIClient(config: AIClientConfig): AIClient;
-/**
- * 从 fetch Response 中解析 SSE data 字段
- *
- * 自动处理分片缓冲和 `[DONE]` 结束标记。
- *
- * @param response - fetch 响应对象
- * @yields SSE data 字符串（不含 `[DONE]`）
- *
- * @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 { 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 parseSSE(response: Response): AsyncIterable<string>;
-/**
- * 收集流式响应的完整文本内容
- *
- * 完整消费流并拼接所有 `delta.content` 片段。
- *
- * @param stream - 聊天响应块流
- * @returns 完整文本
- *
- * @example
- * ```ts
- * const client = createAIClient({ api })
- * const stream = client.chatStream({ messages })
- * const fullText = await collectStreamContent(stream)
- * ```
- */
-declare function collectStreamContent(stream: AsyncIterable<ChatCompletionChunk>): Promise<string>;
-
-/**
- * @h-ai/ai — 前端 A2A 客户端
- *
- * 浏览器端 A2A 操作客户端，通过 API 服务调用后端 A2A 能力。
- * @module ai-a2a-client
- */
-
-/**
- * A2A 客户端接口
- *
- * 提供浏览器端调用后端 A2A API 的能力。
- */
-interface A2AClientOperations {
-    /** 获取完整 A2A Agent Card；传输失败时抛出异常 */
-    getAgentCard: () => Promise<AgentCard>;
-    /** 查询 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 AudioClientConfig, type AudioClientOperations, type AudioTicketRequest, type StreamOptions, type StreamProgress, collectStreamContent, createA2AClient, createAIClient, createAudioClient, createUnconfiguredAudioClient, parseSSE };
+export { type AudioClientConfig, type AudioClientOperations, type AudioTicketRequest, createAudioClient };

package/dist/client/index.js

@@ -1,4 +1,4 @@
-export { collectStreamContent, createA2AClient, createAIClient, createAudioClient, createUnconfiguredAudioClient, parseSSE } from '../chunk-7SMQSE4S.js';
-import '../chunk-JC7QBT3C.js';
+export { createAudioClient } from '../chunk-GMQFIWND.js';
+import '../chunk-HYMP57AC.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.d.ts

@@ -1,19 +1,18 @@
-import { az as InteractionScope } from './ai-reasoning-types-DZd_6Umd.js';
-export { aA as A2AAgentCardConfig, aB as A2AApiKeySecurity, aC as A2AAuthenticator, aD as A2ACallOptions, aE as A2ACallResult, aF as A2ACallerIdentity, A as A2AConfig, a as A2AConfigSchema, aG as A2AContextInfo, aH as A2AHandleResult, aI as A2AMessageRecord, aJ as A2AOperations, aK as A2ASecurityConfig, b as A2ASkillConfigSchema, aL as A2ATaskFilter, c as AIConfig, d as AIConfigInput, e as AIConfigSchema, aM as AILLMFunctionsDeps, aN as AIRelStore, aO as AIRelStoreOptions, aP as AIStoreProvider, aQ as AIVectorBackend, aR as AIVectorStore, f as ApiType, g as ApiTypeSchema, aS as AskOptions, aT as AssistantMessage, h as AudioCapabilitiesRequest, i as AudioConfig, j as AudioConfigSchema, k as AudioContent, l as AudioFormat, m as AudioInputStream, n as AudioModelCapabilities, o as AudioModelEntry, p as AudioModelEntrySchema, q as AudioOperation, r as AudioOperationSchema, s as AudioOperations, t as AudioOperationsSchema, u as AudioProviderName, v as AudioProviderSchema, w as AudioReference, aU as ChatCompletionChoice, aV as ChatCompletionChunk, aW as ChatCompletionDelta, aX as ChatCompletionRequest, aY as ChatCompletionResponse, aZ as ChatHistoryOptions, a_ as ChatMessage, a$ as ChatRecord, b0 as Citation, C as CompressConfig, x as CompressConfigSchema, b1 as DefineToolOptions, b2 as DeveloperMessage, E as EmbeddingConfig, y as EmbeddingConfigSchema, b3 as EntityDocumentRelation, b4 as EntityDocumentResult, b5 as EntityListOptions, b6 as EntityQueryOptions, z as EntityType, B as EntityTypeSchema, F as FileConfig, D as FileConfigSchema, b7 as GenerateObjectRequest, I as ImageConfig, G as ImageConfigSchema, b8 as ImageContent, H as ImageModelEntry, J as ImageModelEntrySchema, K as ImageProviderName, L as ImageProviderSchema, b9 as KnowledgeAskOptions, ba as KnowledgeAskResult, M as KnowledgeConfig, N as KnowledgeConfigSchema, bb as KnowledgeDocumentInfo, bc as KnowledgeDocumentListOptions, bd as KnowledgeDocumentRemoveOptions, be as KnowledgeEntity, bf as KnowledgeIngestBatchProgress, bg as KnowledgeIngestBatchResult, bh as KnowledgeIngestFileInput, bi as KnowledgeIngestInput, bj as KnowledgeIngestResult, bk as KnowledgeOperations, bl as KnowledgeRetrieveItem, bm as KnowledgeRetrieveOptions, bn as KnowledgeRetrieveResult, bo as KnowledgeSetupOptions, bp as KnowledgeStore, O as LLMConfig, P as LLMConfigSchema, bq as LLMOperations, br as LLMProvider, Q as MCPConfig, R as MCPConfigSchema, S as MCPServerCapabilities, T as MCPServerCapabilitiesSchema, U as MCPServerConfig, V as MCPServerConfigSchema, bs as MemoryAccessScope, bt as MemoryAdminOperations, bu as MemoryClearAllOptions, bv as MemoryClearOptions, W as MemoryConfig, X as MemoryConfigSchema, bw as MemoryCoreOperations, bx as MemoryEntry, by as MemoryEntryInput, bz as MemoryExtractOptions, bA as MemoryInjectionOptions, bB as MemoryListOptions, bC as MemoryListPageOptions, bD as MemoryOperations, bE as MemoryRecallOptions, Y as MemoryType, Z as MemoryTypeSchema, bF as MemoryUpdateInput, bG as MessageContent, bH as MessageRole, _ as ModelEntry, $ as ModelEntrySchema, a0 as ModelScenario, a1 as ModelScenarioSchema, bI as ObjectRef, a2 as OptionalSecretSchema, a3 as PlayableAudio, bJ as RagContextItem, bK as RagOperations, bL as RagOptions, bM as RagResult, bN as RagStreamEvent, bO as ReasoningOperations, bP as ReasoningOptions, bQ as ReasoningResult, bR as ReasoningStep, bS as ReasoningStepType, bT as ReasoningStrategy, bU as ReasoningStreamEvent, a4 as ResolveRequiredModelEntryOptions, a5 as ResolvedAudioModel, a6 as ResolvedImageModel, a7 as ResolvedModelConfig, a8 as RetrievalConfig, a9 as RetrievalConfigSchema, bV as RetrievalOperations, bW as RetrievalRequest, bX as RetrievalResult, bY as RetrievalResultItem, bZ as RetrievalSource, aa as RetrievalSourceConfig, ab as RetrievalSourceSchema, b_ as SSEDecoder, b$ as SSEEvent, c0 as ScopedMemoryBinding, c1 as ScopedMemoryOperations, c2 as SessionInfo, c3 as StoreFilter, c4 as StorePage, c5 as StoreScope, c6 as StreamOperations, c7 as StreamProcessor, c8 as StreamResult, ac as SummaryConfig, ad as SummaryConfigSchema, ae as SynthesisEvent, af as SynthesisOptions, ag as SynthesisRequest, ah as SynthesisResult, ai as SynthesisStreamRequest, aj as SynthesisTextSegment, c9 as SystemMessage, ca as TempModelConfig, cb as TextContent, ak as TokenConfig, al as TokenConfigSchema, cc as TokenUsage, cd as Tool, ce as ToolAuthorizationRequest, cf as ToolAuthorizer, cg as ToolCall, ch as ToolDefinition, ci as ToolErrorType, cj as ToolExecutionContext, ck as ToolExecutionOptions, cl as ToolMessage, cm as ToolRegistryOperations, cn as ToolRegistryOptions, co as ToolsOperations, am as TranscriptionEvent, an as TranscriptionOptions, ao as TranscriptionRequest, ap as TranscriptionResult, aq as TranscriptionSegment, ar as TranscriptionStreamRequest, as as TranscriptionTimestampGranularity, at as TranscriptionWord, cp as UserMessage, cq as WhereClause, cr as WhereOperator, cs as WhereValue, au as ensureAudioCredential, av as resolveAudioModel, aw as resolveImageModel, ax as resolveModelApi, ay as resolveModelEntry } from './ai-reasoning-types-DZd_6Umd.js';
-import { A as AIFunctions, M as McpServerOptions } from './ai-audio-ws-protocol-S4N8-LBa.js';
-export { a as AIInitOptions, b as AUDIO_WS_PATH, c as AudioFormatSchema, d as AudioWsClientMessage, e as AudioWsClientMessageSchema, f as AudioWsDoneMessage, g as AudioWsDoneMessageSchema, h as AudioWsEndMessage, i as AudioWsErrorMessage, j as AudioWsSegmentDoneMessage, k as AudioWsSegmentStartedMessage, l as AudioWsServerMessage, m as AudioWsSpeechMessage, n as AudioWsStartMessage, o as AudioWsStartMessageSchema, p as AudioWsTextMessage, q as AudioWsTextMessageSchema, r as AudioWsTranscriptMessage, x as CommitTurnInput, y as CompressOperations, z as CompressOptions, B as CompressResult, C as CompressionStrategy, s as CompressionStrategySchema, D as ConsolidateOptions, E as ConsolidateResult, F as ContextChatOptions, J as ContextChatResult, K as ContextDeps, L as ContextManager, N as ContextManagerOptions, O as ContextOperations, P as ContextResetOptions, Q as ContextStreamEvent, S as ConversationTurn, T as ConversationTurnStatus, U as EmbeddingItem, V as EmbeddingOperations, W as EmbeddingProvider, X as EmbeddingRequest, Y as EmbeddingResponse, Z as FileOperations, _ as FileParseMethod, $ as FileParseOptions, a0 as FileParseRequest, a1 as FileParseResult, G as GenerateImageRequest, t as GenerateImageResult, u as GeneratedImage, H as HaiAIError, I as ImageOperations, v as ImageSize, a2 as MCPContext, a3 as MCPOperations, a4 as MCPPrompt, a5 as MCPPromptArgument, a6 as MCPPromptContent, a7 as MCPPromptMessage, a8 as MCPResource, a9 as MCPResourceContent, aa as MCPToolDefinition, ab as MCPToolHandler, ac as OutputFormat, ad as PersonaOperations, ae as PersonaProfile, af as PersonaProfileInput, ag as PersonaProfileUpdate, ah as PersonaScopeOptions, R as ReferenceImage, ai as RerankDocument, aj as RerankItem, ak as RerankOperations, al as RerankRequest, am as RerankResponse, an as SummaryOperations, ao as SummaryOptions, ap as SummaryResult, aq as TokenOperations, w as serializePlayableAudio } from './ai-audio-ws-protocol-S4N8-LBa.js';
+import { r as AIFunctions, bK as McpServerOptions } from './ai-audio-ws-protocol-nfhO0tOo.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 AIConfig, p as AIConfigInput, q as AIConfigSchema, s as AIInitOptions, t as AIRelStore, u as AIRelStoreCompareAndSwap, v as AIRelStoreOptions, w as AIStoreProvider, x as AIVectorBackend, y as AIVectorStore, z as AIVersionedRecord, B as AUDIO_WS_PATH, C as ApiType, D as ApiTypeSchema, E as AskOptions, F as AssistantMessage, G as AudioConfig, H as AudioConfigSchema, I as AudioFormatSchema, J as AudioModelEntry, K as AudioModelEntrySchema, L as AudioOperation, M as AudioOperationSchema, N as AudioOperationsSchema, O as AudioProviderName, P as AudioProviderSchema, Q as AudioWsClientMessage, R as AudioWsClientMessageSchema, S as AudioWsDoneMessage, T as AudioWsDoneMessageSchema, U as AudioWsEndMessage, V as AudioWsErrorMessage, W as AudioWsSegmentDoneMessage, X as AudioWsSegmentStartedMessage, Y as AudioWsServerMessage, Z as AudioWsSpeechMessage, _ as AudioWsStartMessage, $ as AudioWsStartMessageSchema, a0 as AudioWsTextMessage, a1 as AudioWsTextMessageSchema, a2 as AudioWsTranscriptMessage, a3 as ChatCompletionChoice, a4 as ChatCompletionChunk, a5 as ChatCompletionDelta, a6 as ChatCompletionRequest, a7 as ChatCompletionResponse, a8 as ChatHistoryOptions, a9 as ChatMessage, aa as ChatRecord, ab as Citation, ac as CommitTurnInput, ad as CompressConfig, ae as CompressConfigSchema, af as CompressOperations, ag as CompressOptions, ah as CompressResult, ai as CompressionStrategy, aj as CompressionStrategySchema, ak as ConsolidateOptions, al as ConsolidateResult, am as ContextChatOptions, an as ContextChatResult, ao as ContextManager, ap as ContextManagerOptions, aq as ContextOperations, ar as ContextResetOptions, as as ContextStreamEvent, at as ConversationTurn, au as ConversationTurnStatus, av as DefineToolOptions, aw as DeveloperMessage, ax as EmbeddingConfig, ay as EmbeddingConfigSchema, az as EmbeddingItem, aA as EmbeddingOperations, aB as EmbeddingRequest, aC as EmbeddingResponse, aD as EntityDocumentRelation, aE as EntityDocumentResult, aF as EntityListOptions, aG as EntityQueryOptions, aH as EntityType, aI as EntityTypeSchema, aJ as FileConfig, aK as FileConfigSchema, aL as FileOperations, aM as FileParseMethod, aN as FileParseOptions, aO as FileParseRequest, aP as FileParseResult, aQ as GenerateImageRequest, aR as GenerateImageResult, aS as GenerateObjectRequest, aT as GeneratedImage, aU as HaiAIError, aV as ImageConfig, aW as ImageConfigSchema, aX as ImageContent, aY as ImageModelEntry, aZ as ImageModelEntrySchema, a_ as ImageOperations, a$ as ImageProviderName, b0 as ImageProviderSchema, b1 as ImageSize, b2 as InteractionScope, b3 as KnowledgeAskOptions, b4 as KnowledgeAskResult, b5 as KnowledgeConfig, b6 as KnowledgeConfigSchema, b7 as KnowledgeDocumentInfo, b8 as KnowledgeDocumentListOptions, b9 as KnowledgeDocumentMetadata, ba as KnowledgeDocumentRemoveOptions, bb as KnowledgeDocumentRevision, bc as KnowledgeEntity, bd as KnowledgeIngestBatchProgress, be as KnowledgeIngestBatchResult, bf as KnowledgeIngestFileInput, bg as KnowledgeIngestInput, bh as KnowledgeIngestResult, bi as KnowledgeOperations, bj as KnowledgeRepairOptions, bk as KnowledgeRepairProgress, bl as KnowledgeRepairResult, bm as KnowledgeRetrieveItem, bn as KnowledgeRetrieveOptions, bo as KnowledgeRetrieveResult, bp as KnowledgeSetupOptions, bq as KnowledgeStore, br as LLMConfig, bs as LLMConfigSchema, bt as LLMOperations, bu as MCPConfig, bv as MCPConfigSchema, bw as MCPContext, bx as MCPOperations, by as MCPPrompt, bz as MCPPromptArgument, bA as MCPPromptContent, bB as MCPPromptMessage, bC as MCPResource, bD as MCPResourceContent, bE as MCPServerCapabilities, bF as MCPServerCapabilitiesSchema, bG as MCPServerConfig, bH as MCPServerConfigSchema, bI as MCPToolDefinition, bJ as MCPToolHandler, bL as MemoryAccessScope, bM as MemoryAdminOperations, bN as MemoryClearAllOptions, bO as MemoryClearOptions, bP as MemoryConfig, bQ as MemoryConfigSchema, bR as MemoryCoreOperations, bS as MemoryEntry, bT as MemoryEntryInput, bU as MemoryExtractOptions, bV as MemoryInjectionOptions, bW as MemoryListOptions, bX as MemoryListPageOptions, bY as MemoryOperations, bZ as MemoryRecallOptions, b_ as MemoryType, b$ as MemoryTypeSchema, c0 as MemoryUpdateInput, c1 as MessageContent, c2 as MessageRole, c3 as ModelEntry, c4 as ModelEntrySchema, c5 as ModelScenario, c6 as ModelScenarioSchema, c7 as ObjectRef, c8 as OptionalSecretSchema, c9 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, cA as ResolvedModelConfig, cB as RetrievalConfig, cC as RetrievalConfigSchema, cD as RetrievalOperations, cE as RetrievalRequest, cF as RetrievalResult, cG as RetrievalResultItem, cH as RetrievalSource, cI as RetrievalSourceConfig, cJ as RetrievalSourceSchema, cK as SSEDecoder, cL as SSEEvent, cM as ScopedMemoryBinding, cN as ScopedMemoryOperations, cO as SessionInfo, cP as StoreFilter, cQ as StorePage, cR as StoreScope, cS as StreamOperations, cT as StreamProcessor, cU as StreamResult, cV as SummaryConfig, cW as SummaryConfigSchema, cX as SummaryOperations, cY as SummaryOptions, cZ as SummaryResult, c_ as SystemMessage, c$ as TempModelConfig, d0 as TextContent, d1 as TokenConfig, d2 as TokenConfigSchema, d3 as TokenOperations, d4 as TokenUsage, d5 as Tool, d6 as ToolAuthorizationRequest, d7 as ToolAuthorizer, d8 as ToolCall, d9 as ToolDefinition, da as ToolErrorType, db as ToolExecutionContext, dc as ToolExecutionOptions, dd as ToolMessage, de as ToolRegistryOperations, df as ToolRegistryOptions, dg as ToolsOperations, dh as UserMessage, di as WhereClause, dj as WhereOperator, dk as WhereValue, dl as ensureAudioCredential, dm as resolveAudioModel, dn as resolveImageModel, dp as resolveModelApi, dq as resolveModelEntry, dr as serializePlayableAudio } from './ai-audio-ws-protocol-nfhO0tOo.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 { TaskStore as A2ATaskStore, AgentExecutor, ExecutionEventBus, RequestContext, ServerCallContext } from '@a2a-js/sdk/server';
 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';
+import '@h-ai/datapipe';
 import '@modelcontextprotocol/sdk/types.js';
 import 'zod/v4/core';
 
@@ -30,17 +29,18 @@ import 'zod/v4/core';
  * @example
  * ```ts
  * import { ai } from '@h-ai/ai'
- *
- * // 初始化
- * await ai.init({ llm: { model: 'gpt-4o-mini', apiKey: process.env.HAI_AI_LLM_APIKEY } })
- *
- * // LLM 调用
- * const result = await ai.llm.chat({
- *   messages: [{ role: 'user', content: '你好' }],
- * })
- *
- * // 关闭
- * await ai.close()
+ * 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;
@@ -70,26 +70,4 @@ declare const ai: AIFunctions;
  */
 declare function createMcpServer(options: McpServerOptions): McpServer;
 
-/**
- * @h-ai/ai — 会话存储键
- *
- * 提供 LLM / Context / SessionStore 共用的复合存储键构造，确保不同交互主体
- * 使用相同 sessionId 时不会在会话目录（SessionInfo）与上下文正文上互相覆盖。
- * @module store/ai-store-key
- */
-
-/**
- * 构造会话存储的复合主键
- *
- * 用 JSON 数组序列化 `[objectId, sessionId]`，避免朴素拼接 `${objectId}:${sessionId}`
- * 在 id 本身含分隔符时产生碰撞（如 `a` + `b:c` 与 `a:b` + `c` 得到同一键），
- * 也避免不同主体相同 sessionId 因裸 sessionId 作主键而互相覆盖。
- *
- * LLM、Context 与 SessionStore 必须共用此实现。
- *
- * @param scope - 交互作用域（主体 ID + 会话 ID）
- * @returns 复合存储键
- */
-declare function sessionStoreKey(scope: InteractionScope): string;
-
-export { AIFunctions, InteractionScope, McpServerOptions, ai, createMcpServer, sessionStoreKey };
+export { AIFunctions, McpServerOptions, ai, createMcpServer };