@h-ai/ai 0.1.0-alpha.10

package/dist/api/index.js

@@ -0,0 +1,243 @@
+import { z } from 'zod';
+
+// src/api/ai-api-contract.ts
+var MessageRoleSchema = z.enum(["system", "user", "assistant", "tool"]);
+var TextContentSchema = z.object({
+  type: z.literal("text"),
+  text: z.string()
+});
+var ImageContentSchema = z.object({
+  type: z.literal("image_url"),
+  image_url: z.object({
+    url: z.string(),
+    detail: z.enum(["auto", "low", "high"]).optional()
+  })
+});
+var MessageContentSchema = z.union([
+  z.string(),
+  z.array(z.union([TextContentSchema, ImageContentSchema]))
+]);
+var ToolCallSchema = z.object({
+  id: z.string(),
+  type: z.literal("function"),
+  function: z.object({
+    name: z.string(),
+    arguments: z.string()
+  })
+});
+var ChatMessageSchema = z.object({
+  role: MessageRoleSchema,
+  content: MessageContentSchema.optional(),
+  name: z.string().optional(),
+  tool_calls: z.array(ToolCallSchema).optional(),
+  tool_call_id: z.string().optional()
+});
+var ToolParameterSchema = z.object({
+  type: z.string(),
+  description: z.string().optional(),
+  enum: z.array(z.string()).optional()
+});
+var ToolDefinitionSchema = z.object({
+  type: z.literal("function"),
+  function: z.object({
+    name: z.string(),
+    description: z.string().optional(),
+    parameters: z.object({
+      type: z.literal("object"),
+      properties: z.record(z.string(), ToolParameterSchema).optional(),
+      required: z.array(z.string()).optional()
+    }).optional()
+  })
+});
+var ChatCompletionInputSchema = z.object({
+  model: z.string().optional(),
+  messages: z.array(ChatMessageSchema).min(1),
+  temperature: z.number().min(0).max(2).optional(),
+  top_p: z.number().min(0).max(1).optional(),
+  max_tokens: z.number().int().min(1).optional(),
+  stream: z.boolean().optional(),
+  tools: z.array(ToolDefinitionSchema).optional(),
+  tool_choice: z.union([
+    z.literal("auto"),
+    z.literal("none"),
+    z.object({ type: z.literal("function"), function: z.object({ name: z.string() }) })
+  ]).optional()
+});
+var TokenUsageSchema = z.object({
+  prompt_tokens: z.number(),
+  completion_tokens: z.number(),
+  total_tokens: z.number()
+});
+var AssistantMessageSchema = z.object({
+  role: z.literal("assistant"),
+  content: z.string().nullable().optional(),
+  tool_calls: z.array(ToolCallSchema).optional()
+});
+var ChatCompletionChoiceSchema = z.object({
+  index: z.number(),
+  message: AssistantMessageSchema,
+  finish_reason: z.enum(["stop", "length", "tool_calls", "content_filter"])
+});
+var ChatCompletionOutputSchema = z.object({
+  id: z.string(),
+  object: z.literal("chat.completion"),
+  created: z.number(),
+  model: z.string(),
+  choices: z.array(ChatCompletionChoiceSchema),
+  usage: TokenUsageSchema
+});
+var SendMessageInputSchema = z.object({
+  message: z.string().min(1),
+  systemPrompt: z.string().optional(),
+  model: z.string().optional(),
+  temperature: z.number().min(0).max(2).optional()
+});
+var SendMessageOutputSchema = z.object({
+  content: z.string(),
+  model: z.string(),
+  usage: TokenUsageSchema.optional()
+});
+var MemoryEntrySchema = z.object({
+  id: z.string(),
+  content: z.string(),
+  type: z.enum(["fact", "preference", "event", "summary", "custom"]),
+  importance: z.number(),
+  objectId: z.string().optional(),
+  metadata: z.record(z.string(), z.unknown()).optional(),
+  createdAt: z.number(),
+  lastAccessedAt: z.number(),
+  accessCount: z.number()
+});
+var MemoryRecallInputSchema = z.object({
+  query: z.string().min(1),
+  topK: z.number().int().min(1).optional(),
+  types: z.array(z.enum(["fact", "preference", "event", "summary", "custom"])).optional(),
+  minImportance: z.number().min(0).max(1).optional(),
+  objectId: z.string().optional()
+});
+var MemoryRecallOutputSchema = z.object({
+  items: z.array(MemoryEntrySchema)
+});
+var MemoryListInputSchema = z.object({
+  types: z.array(z.enum(["fact", "preference", "event", "summary", "custom"])).optional(),
+  objectId: z.string().optional(),
+  offset: z.number().int().min(0).optional(),
+  limit: z.number().int().min(1).max(100).optional()
+});
+var MemoryListOutputSchema = z.object({
+  items: z.array(MemoryEntrySchema),
+  total: z.number()
+});
+var SessionInfoSchema = z.object({
+  objectId: z.string(),
+  sessionId: z.string(),
+  createdAt: z.number(),
+  updatedAt: z.number(),
+  metadata: z.record(z.string(), z.unknown()).optional()
+});
+var SessionListInputSchema = z.object({
+  objectId: z.string().min(1)
+});
+var SessionListOutputSchema = z.object({
+  items: z.array(SessionInfoSchema)
+});
+var ChatRecordSchema = z.object({
+  id: z.string(),
+  objectId: z.string(),
+  sessionId: z.string(),
+  request: z.object({
+    model: z.string(),
+    messages: z.array(ChatMessageSchema)
+  }),
+  response: z.object({
+    content: z.string(),
+    toolCalls: z.array(ToolCallSchema).optional(),
+    finishReason: z.string(),
+    usage: TokenUsageSchema
+  }),
+  createdAt: z.number(),
+  duration: z.number()
+});
+var ChatHistoryInputSchema = z.object({
+  objectId: z.string().min(1),
+  sessionId: z.string().min(1),
+  limit: z.number().int().min(1).max(200).optional(),
+  order: z.enum(["asc", "desc"]).optional()
+});
+var ChatHistoryOutputSchema = z.object({
+  items: z.array(ChatRecordSchema)
+});
+
+// src/api/ai-api-contract.ts
+function defineEndpoint(def) {
+  return def;
+}
+var aiEndpoints = {
+  /** 聊天完成（非流式） */
+  chat: defineEndpoint({
+    method: "POST",
+    path: "/ai/chat",
+    input: ChatCompletionInputSchema,
+    output: ChatCompletionOutputSchema,
+    meta: { summary: "Chat completion (non-streaming)", tags: ["ai"] }
+  }),
+  /**
+   * 聊天完成（流式 SSE）
+   *
+   * 此端点使用 Server-Sent Events 协议返回流式 chunk。
+   * 客户端应使用 `createAIClient().chatStream()` 而非 `api.call()`。
+   * 定义此契约用于服务端路由注册和 API 文档。
+   */
+  chatStream: defineEndpoint({
+    method: "POST",
+    path: "/ai/chat/stream",
+    input: ChatCompletionInputSchema,
+    output: z.unknown(),
+    requireAuth: true,
+    meta: { summary: "Chat completion (SSE streaming)", tags: ["ai"], streaming: true }
+  }),
+  /** 简单消息（便捷接口，封装单轮对话） */
+  sendMessage: defineEndpoint({
+    method: "POST",
+    path: "/ai/message",
+    input: SendMessageInputSchema,
+    output: SendMessageOutputSchema,
+    meta: { summary: "Send a single message (convenience)", tags: ["ai"] }
+  }),
+  /** 记忆检索 */
+  memoryRecall: defineEndpoint({
+    method: "POST",
+    path: "/ai/memory/recall",
+    input: MemoryRecallInputSchema,
+    output: MemoryRecallOutputSchema,
+    meta: { summary: "Recall relevant memories", tags: ["ai", "memory"] }
+  }),
+  /** 记忆列表（分页） */
+  memoryList: defineEndpoint({
+    method: "POST",
+    path: "/ai/memory/list",
+    input: MemoryListInputSchema,
+    output: MemoryListOutputSchema,
+    meta: { summary: "List memories (paginated)", tags: ["ai", "memory"] }
+  }),
+  /** 会话列表 */
+  sessionList: defineEndpoint({
+    method: "POST",
+    path: "/ai/sessions",
+    input: SessionListInputSchema,
+    output: SessionListOutputSchema,
+    meta: { summary: "List sessions for an object", tags: ["ai", "session"] }
+  }),
+  /** 对话历史 */
+  chatHistory: defineEndpoint({
+    method: "POST",
+    path: "/ai/chat/history",
+    input: ChatHistoryInputSchema,
+    output: ChatHistoryOutputSchema,
+    meta: { summary: "Get chat history for a session", tags: ["ai", "llm"] }
+  })
+};
+
+export { ChatCompletionInputSchema, ChatCompletionOutputSchema, ChatHistoryInputSchema, ChatHistoryOutputSchema, ChatMessageSchema, MemoryListInputSchema, MemoryListOutputSchema, MemoryRecallInputSchema, MemoryRecallOutputSchema, SendMessageInputSchema, SendMessageOutputSchema, SessionListInputSchema, SessionListOutputSchema, aiEndpoints };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/api/ai-api-schemas.ts","../../src/api/ai-api-contract.ts"],"names":["z"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * @h-ai/ai/api — AI API 契约 Schema\n *\n * 入参/出参 Schema，客户端和服务端共享的唯一真相源。\n * @module ai-api-schemas\n */\n\nimport { z } from 'zod'\n\n// ─── 消息 Schema ───\n\n/** 消息角色 */\nconst MessageRoleSchema = z.enum(['system', 'user', 'assistant', 'tool'])\n\n/** 文本消息内容 */\nconst TextContentSchema = z.object({\n  type: z.literal('text'),\n  text: z.string(),\n})\n\n/** 图片消息内容 */\nconst ImageContentSchema = z.object({\n  type: z.literal('image_url'),\n  image_url: z.object({\n    url: z.string(),\n    detail: z.enum(['auto', 'low', 'high']).optional(),\n  }),\n})\n\n/** 消息内容（字符串或结构化数组） */\nconst MessageContentSchema = z.union([\n  z.string(),\n  z.array(z.union([TextContentSchema, ImageContentSchema])),\n])\n\n/** 工具调用 */\nconst ToolCallSchema = z.object({\n  id: z.string(),\n  type: z.literal('function'),\n  function: z.object({\n    name: z.string(),\n    arguments: z.string(),\n  }),\n})\n\n/** 聊天消息 */\nexport const ChatMessageSchema = z.object({\n  role: MessageRoleSchema,\n  content: MessageContentSchema.optional(),\n  name: z.string().optional(),\n  tool_calls: z.array(ToolCallSchema).optional(),\n  tool_call_id: z.string().optional(),\n})\n\n// ─── 工具定义 ───\n\n/** 工具参数 Schema */\nconst ToolParameterSchema = z.object({\n  type: z.string(),\n  description: z.string().optional(),\n  enum: z.array(z.string()).optional(),\n})\n\n/** 工具定义 */\nconst ToolDefinitionSchema = z.object({\n  type: z.literal('function'),\n  function: z.object({\n    name: z.string(),\n    description: z.string().optional(),\n    parameters: z.object({\n      type: z.literal('object'),\n      properties: z.record(z.string(), ToolParameterSchema).optional(),\n      required: z.array(z.string()).optional(),\n    }).optional(),\n  }),\n})\n\n// ─── 请求/响应 Schema ───\n\n/** 聊天完成请求入参 */\nexport const ChatCompletionInputSchema = z.object({\n  model: z.string().optional(),\n  messages: z.array(ChatMessageSchema).min(1),\n  temperature: z.number().min(0).max(2).optional(),\n  top_p: z.number().min(0).max(1).optional(),\n  max_tokens: z.number().int().min(1).optional(),\n  stream: z.boolean().optional(),\n  tools: z.array(ToolDefinitionSchema).optional(),\n  tool_choice: z.union([\n    z.literal('auto'),\n    z.literal('none'),\n    z.object({ type: z.literal('function'), function: z.object({ name: z.string() }) }),\n  ]).optional(),\n})\n\n/** Token 使用统计 */\nconst TokenUsageSchema = z.object({\n  prompt_tokens: z.number(),\n  completion_tokens: z.number(),\n  total_tokens: z.number(),\n})\n\n/** 助手消息 */\nconst AssistantMessageSchema = z.object({\n  role: z.literal('assistant'),\n  content: z.string().nullable().optional(),\n  tool_calls: z.array(ToolCallSchema).optional(),\n})\n\n/** 聊天完成选择 */\nconst ChatCompletionChoiceSchema = z.object({\n  index: z.number(),\n  message: AssistantMessageSchema,\n  finish_reason: z.enum(['stop', 'length', 'tool_calls', 'content_filter']),\n})\n\n/** 聊天完成响应出参 */\nexport const ChatCompletionOutputSchema = z.object({\n  id: z.string(),\n  object: z.literal('chat.completion'),\n  created: z.number(),\n  model: z.string(),\n  choices: z.array(ChatCompletionChoiceSchema),\n  usage: TokenUsageSchema,\n})\n\n/** 简单消息请求入参（便捷接口） */\nexport const SendMessageInputSchema = z.object({\n  message: z.string().min(1),\n  systemPrompt: z.string().optional(),\n  model: z.string().optional(),\n  temperature: z.number().min(0).max(2).optional(),\n})\n\n/** 简单消息响应出参 */\nexport const SendMessageOutputSchema = z.object({\n  content: z.string(),\n  model: z.string(),\n  usage: TokenUsageSchema.optional(),\n})\n\n// ─── Memory Schema ───\n\n/** 记忆条目 Schema */\nconst MemoryEntrySchema = z.object({\n  id: z.string(),\n  content: z.string(),\n  type: z.enum(['fact', 'preference', 'event', 'summary', 'custom']),\n  importance: z.number(),\n  objectId: z.string().optional(),\n  metadata: z.record(z.string(), z.unknown()).optional(),\n  createdAt: z.number(),\n  lastAccessedAt: z.number(),\n  accessCount: z.number(),\n})\n\n/** 记忆检索请求入参 */\nexport const MemoryRecallInputSchema = z.object({\n  query: z.string().min(1),\n  topK: z.number().int().min(1).optional(),\n  types: z.array(z.enum(['fact', 'preference', 'event', 'summary', 'custom'])).optional(),\n  minImportance: z.number().min(0).max(1).optional(),\n  objectId: z.string().optional(),\n})\n\n/** 记忆检索响应出参 */\nexport const MemoryRecallOutputSchema = z.object({\n  items: z.array(MemoryEntrySchema),\n})\n\n/** 记忆列表请求入参 */\nexport const MemoryListInputSchema = z.object({\n  types: z.array(z.enum(['fact', 'preference', 'event', 'summary', 'custom'])).optional(),\n  objectId: z.string().optional(),\n  offset: z.number().int().min(0).optional(),\n  limit: z.number().int().min(1).max(100).optional(),\n})\n\n/** 记忆列表响应出参 */\nexport const MemoryListOutputSchema = z.object({\n  items: z.array(MemoryEntrySchema),\n  total: z.number(),\n})\n\n// ─── Session Schema ───\n\n/** 会话信息 Schema */\nconst SessionInfoSchema = z.object({\n  objectId: z.string(),\n  sessionId: z.string(),\n  createdAt: z.number(),\n  updatedAt: z.number(),\n  metadata: z.record(z.string(), z.unknown()).optional(),\n})\n\n/** 会话列表请求入参 */\nexport const SessionListInputSchema = z.object({\n  objectId: z.string().min(1),\n})\n\n/** 会话列表响应出参 */\nexport const SessionListOutputSchema = z.object({\n  items: z.array(SessionInfoSchema),\n})\n\n// ─── ChatHistory Schema ───\n\n/** 对话记录响应条目 */\nconst ChatRecordSchema = z.object({\n  id: z.string(),\n  objectId: z.string(),\n  sessionId: z.string(),\n  request: z.object({\n    model: z.string(),\n    messages: z.array(ChatMessageSchema),\n  }),\n  response: z.object({\n    content: z.string(),\n    toolCalls: z.array(ToolCallSchema).optional(),\n    finishReason: z.string(),\n    usage: TokenUsageSchema,\n  }),\n  createdAt: z.number(),\n  duration: z.number(),\n})\n\n/** 对话历史请求入参 */\nexport const ChatHistoryInputSchema = z.object({\n  objectId: z.string().min(1),\n  sessionId: z.string().min(1),\n  limit: z.number().int().min(1).max(200).optional(),\n  order: z.enum(['asc', 'desc']).optional(),\n})\n\n/** 对话历史响应出参 */\nexport const ChatHistoryOutputSchema = z.object({\n  items: z.array(ChatRecordSchema),\n})\n\n// ─── 推导类型 ───\n\nexport type ChatCompletionInput = z.infer<typeof ChatCompletionInputSchema>\nexport type ChatCompletionOutput = z.infer<typeof ChatCompletionOutputSchema>\nexport type SendMessageInput = z.infer<typeof SendMessageInputSchema>\nexport type SendMessageOutput = z.infer<typeof SendMessageOutputSchema>\n","/**\n * @h-ai/ai/api — AI API 端点契约定义\n *\n * 所有 ai 模块的 API 端点（path + method + schema），\n * 客户端和服务端都从此处引用，编译时保证一致性。\n *\n * 注意：`chatStream` 使用 SSE 流式协议，客户端应使用\n * `createAIClient().chatStream()` 而非 `api.call()`。\n * 此处定义仅用于服务端路由注册和文档生成。\n *\n * @module ai-api-contract\n */\n\nimport { z } from 'zod'\nimport {\n  ChatCompletionInputSchema,\n  ChatCompletionOutputSchema,\n  ChatHistoryInputSchema,\n  ChatHistoryOutputSchema,\n  MemoryListInputSchema,\n  MemoryListOutputSchema,\n  MemoryRecallInputSchema,\n  MemoryRecallOutputSchema,\n  SendMessageInputSchema,\n  SendMessageOutputSchema,\n  SessionListInputSchema,\n  SessionListOutputSchema,\n} from './ai-api-schemas.js'\n\n// ─── 端点定义辅助（内联，避免对 @h-ai/api-client 的循环依赖） ───\n\ninterface EndpointDef<TInput = unknown, TOutput = unknown> {\n  method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH'\n  path: string\n  input: z.ZodType<TInput>\n  output: z.ZodType<TOutput>\n  requireAuth?: boolean\n  meta?: { summary?: string, tags?: string[], streaming?: boolean }\n}\n\nfunction defineEndpoint<TInput, TOutput>(def: EndpointDef<TInput, TOutput>): EndpointDef<TInput, TOutput> {\n  return def\n}\n\n// ─── ai API 端点 ───\n\n/**\n * ai 所有 API 端点\n *\n * @example\n * ```ts\n * // 客户端（非流式）\n * import { aiEndpoints } from '@h-ai/ai/api'\n * const result = await api.call(aiEndpoints.chat, { messages: [...] })\n *\n * // 客户端（流式）— 使用专用 AIClient\n * import { api } from '@h-ai/api-client'\n * import { createAIClient } from '@h-ai/ai/client'\n * await api.init({ baseUrl: '/api' })\n * const client = createAIClient({ api })\n * for await (const chunk of client.chatStream({ messages })) { ... }\n *\n * // 服务端\n * export const POST = kit.fromContract(aiEndpoints.chat, async (input) => {\n *   const result = await ai.llm.chat(input)\n *   return result.success ? result.data : kit.response.internalError(result.error.message)\n * })\n * ```\n */\nexport const aiEndpoints = {\n  /** 聊天完成（非流式） */\n  chat: defineEndpoint({\n    method: 'POST',\n    path: '/ai/chat',\n    input: ChatCompletionInputSchema,\n    output: ChatCompletionOutputSchema,\n    meta: { summary: 'Chat completion (non-streaming)', tags: ['ai'] },\n  }),\n\n  /**\n   * 聊天完成（流式 SSE）\n   *\n   * 此端点使用 Server-Sent Events 协议返回流式 chunk。\n   * 客户端应使用 `createAIClient().chatStream()` 而非 `api.call()`。\n   * 定义此契约用于服务端路由注册和 API 文档。\n   */\n  chatStream: defineEndpoint({\n    method: 'POST',\n    path: '/ai/chat/stream',\n    input: ChatCompletionInputSchema,\n    output: z.unknown(),\n    requireAuth: true,\n    meta: { summary: 'Chat completion (SSE streaming)', tags: ['ai'], streaming: true },\n  }),\n\n  /** 简单消息（便捷接口，封装单轮对话） */\n  sendMessage: defineEndpoint({\n    method: 'POST',\n    path: '/ai/message',\n    input: SendMessageInputSchema,\n    output: SendMessageOutputSchema,\n    meta: { summary: 'Send a single message (convenience)', tags: ['ai'] },\n  }),\n\n  /** 记忆检索 */\n  memoryRecall: defineEndpoint({\n    method: 'POST',\n    path: '/ai/memory/recall',\n    input: MemoryRecallInputSchema,\n    output: MemoryRecallOutputSchema,\n    meta: { summary: 'Recall relevant memories', tags: ['ai', 'memory'] },\n  }),\n\n  /** 记忆列表（分页） */\n  memoryList: defineEndpoint({\n    method: 'POST',\n    path: '/ai/memory/list',\n    input: MemoryListInputSchema,\n    output: MemoryListOutputSchema,\n    meta: { summary: 'List memories (paginated)', tags: ['ai', 'memory'] },\n  }),\n\n  /** 会话列表 */\n  sessionList: defineEndpoint({\n    method: 'POST',\n    path: '/ai/sessions',\n    input: SessionListInputSchema,\n    output: SessionListOutputSchema,\n    meta: { summary: 'List sessions for an object', tags: ['ai', 'session'] },\n  }),\n\n  /** 对话历史 */\n  chatHistory: defineEndpoint({\n    method: 'POST',\n    path: '/ai/chat/history',\n    input: ChatHistoryInputSchema,\n    output: ChatHistoryOutputSchema,\n    meta: { summary: 'Get chat history for a session', tags: ['ai', 'llm'] },\n  }),\n} as const\n"]}

package/dist/browser.d.ts

@@ -0,0 +1,9 @@
+export { A as A2AConfig, a as A2AConfigSchema, b as A2ASkillConfigSchema, c as AIConfig, d as AIConfigInput, e as AIConfigSchema, C as CompressConfig, f as CompressConfigSchema, E as EmbeddingConfig, g as EmbeddingConfigSchema, h as EntityType, i as EntityTypeSchema, F as FileConfig, j as FileConfigSchema, K as KnowledgeConfig, k as KnowledgeConfigSchema, L as LLMConfig, l as LLMConfigSchema, M as MCPConfig, m as MCPConfigSchema, n as MCPServerCapabilities, o as MCPServerCapabilitiesSchema, p as MCPServerConfig, q as MCPServerConfigSchema, r as MemoryConfig, s as MemoryConfigSchema, t as MemoryType, u as MemoryTypeSchema, v as ModelEntry, w as ModelEntrySchema, x as ModelScenario, y as ModelScenarioSchema, R as ResolveRequiredModelEntryOptions, z as ResolvedModelConfig, B as RetrievalConfig, D as RetrievalConfigSchema, G as RetrievalSourceConfig, H as RetrievalSourceSchema, S as SummaryConfig, I as SummaryConfigSchema, T as TokenConfig, J as TokenConfigSchema, N as resolveModelEntry } from './ai-reasoning-types-CGUgkLF7.js';
+export { A as AIFunctions, a as AIInitOptions, C as CompressionStrategy, b as CompressionStrategySchema, H as HaiAIError } from './ai-types-CRCjluXI.js';
+export { A2AClientOperations, AIApiAdapter, AIClient, AIClientConfig, StreamOptions, StreamProgress, collectStreamContent, createA2AClient, createAIClient, parseSSE } from './client/index.js';
+import '@a2a-js/sdk/server';
+import '@h-ai/core';
+import '@h-ai/datapipe';
+import 'zod';
+import 'openai';
+import 'node:buffer';

package/dist/browser.js

@@ -0,0 +1,4 @@
+export { A2AConfigSchema, A2ASkillConfigSchema, AIConfigSchema, CompressConfigSchema, CompressionStrategySchema, EmbeddingConfigSchema, EntityTypeSchema, FileConfigSchema, HaiAIError, KnowledgeConfigSchema, LLMConfigSchema, MCPConfigSchema, MCPServerCapabilitiesSchema, MCPServerConfigSchema, MemoryConfigSchema, MemoryTypeSchema, ModelEntrySchema, ModelScenarioSchema, RetrievalConfigSchema, RetrievalSourceSchema, SummaryConfigSchema, TokenConfigSchema, resolveModelEntry } from './chunk-6PPXWQ7I.js';
+export { collectStreamContent, createA2AClient, createAIClient, parseSSE } from './chunk-ABP7RKIP.js';
+//# sourceMappingURL=browser.js.map
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"browser.js"}