@ai-group/chat-sdk 3.6.11 → 3.7.0

package/dist/cjs/core/protocol/messages.js

@@ -0,0 +1,307 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/core/protocol/messages.ts
+var messages_exports = {};
+__export(messages_exports, {
+  buildAdkUserMessage: () => buildAdkUserMessage,
+  buildAdkUserParts: () => import_parts.buildAdkUserParts,
+  collectFunctionResponses: () => collectFunctionResponses,
+  createAdkMessage: () => createAdkMessage,
+  dedupeAdkMessages: () => dedupeAdkMessages,
+  getAdkEventMeta: () => getAdkEventMeta,
+  getAdkMessageEventId: () => getAdkMessageEventId,
+  getAdkMessageInvocationId: () => getAdkMessageInvocationId,
+  insertMissingAdkSessionEvents: () => insertMissingAdkSessionEvents,
+  isAdkAsyncTaskEvent: () => isAdkAsyncTaskEvent,
+  isUserFunctionResponseEvent: () => isUserFunctionResponseEvent,
+  mapAdkEventToMessages: () => mapAdkEventToMessages,
+  mapAdkSessionEventsToMessages: () => mapAdkSessionEventsToMessages,
+  pairFunctionResponses: () => pairFunctionResponses
+});
+module.exports = __toCommonJS(messages_exports);
+var import_uuid = require("uuid");
+var import_parts = require("./parts");
+var defaultProtocolOptions = {
+  hideAsyncTaskEvents: true,
+  pairFunctionResponses: true
+};
+var getAdkMessageEventId = (message) => {
+  var _a;
+  return message.eventId || ((_a = message.raw) == null ? void 0 : _a.id) || message.id;
+};
+var getAdkMessageInvocationId = (message) => {
+  var _a;
+  return message.invocationId || ((_a = message.raw) == null ? void 0 : _a.invocationId);
+};
+var isAdkAsyncTaskEvent = (event) => {
+  var _a, _b;
+  return event.author === "user" && ((_b = (_a = event.content) == null ? void 0 : _a.parts) == null ? void 0 : _b.some((part) => Boolean(part == null ? void 0 : part.task)));
+};
+var isUserFunctionResponseEvent = (event) => {
+  var _a;
+  return ((_a = event.content) == null ? void 0 : _a.role) === "user" && Array.isArray(event.content.parts) && event.content.parts.length > 0 && event.content.parts.every((part) => Boolean(part == null ? void 0 : part.functionResponse));
+};
+var getAdkEventMeta = (event) => ({
+  eventId: event.id,
+  invocationId: event.invocationId,
+  sessionId: event.sessionId,
+  timestamp: event.timestamp,
+  author: event.author,
+  modelCode: event.modelCode,
+  usageMetadata: event.usageMetadata,
+  finishReason: event.finishReason,
+  isLike: event.isLike
+});
+var createAdkMessage = (event, part, role = "bot") => {
+  var _a, _b;
+  return {
+    id: (0, import_uuid.v4)(),
+    role,
+    ...getAdkEventMeta(event),
+    thought: part.thought,
+    functionCall: part.functionCall,
+    functionResponse: part.functionResponse,
+    fileData: part.fileDataList || (part.fileData ? [part.fileData] : void 0),
+    inlineData: part.inlineData,
+    executableCode: part.executableCode,
+    codeExecutionResult: part.codeExecutionResult,
+    text: part.errorMessage || part.text,
+    renderedContent: (_b = (_a = event.groundingMetadata) == null ? void 0 : _a.searchEntryPoint) == null ? void 0 : _b.renderedContent,
+    raw: event
+  };
+};
+var mapAdkEventToMessages = (event, options) => {
+  var _a, _b, _c, _d;
+  const mergedOptions = { ...defaultProtocolOptions, ...options };
+  if (mergedOptions.hideAsyncTaskEvents && isAdkAsyncTaskEvent(event))
+    return [];
+  if (mergedOptions.pairFunctionResponses && isUserFunctionResponseEvent(event))
+    return [];
+  if (((_a = event.content) == null ? void 0 : _a.role) === "followup")
+    return [];
+  if ((_c = (_b = event.content) == null ? void 0 : _b.parts) == null ? void 0 : _c.length) {
+    const role = event.content.role === "user" ? "user" : "bot";
+    return (0, import_parts.normalizeAdkParts)(event.content.parts).map(
+      (part) => createAdkMessage(event, part, role)
+    );
+  }
+  if (event.errorMessage) {
+    return [
+      {
+        id: (0, import_uuid.v4)(),
+        role: "bot",
+        text: event.errorMessage,
+        ...getAdkEventMeta(event),
+        raw: event
+      }
+    ];
+  }
+  if ((_d = event.actions) == null ? void 0 : _d.artifactDelta) {
+    return [
+      {
+        id: (0, import_uuid.v4)(),
+        role: "bot",
+        ...getAdkEventMeta(event),
+        raw: event
+      }
+    ];
+  }
+  return [];
+};
+var mapAdkSessionEventsToMessages = (events = [], options) => pairFunctionResponses(events.flatMap(
+  (event) => mapAdkEventToMessages(event, options)
+));
+var dedupeAdkMessages = (messages) => {
+  const seenMessageIds = /* @__PURE__ */ new Set();
+  let hasDuplicate = false;
+  const uniqueIdMessages = messages.filter((message) => {
+    if (seenMessageIds.has(message.id)) {
+      hasDuplicate = true;
+      return false;
+    }
+    seenMessageIds.add(message.id);
+    return true;
+  });
+  const botTextGroups = /* @__PURE__ */ new Map();
+  uniqueIdMessages.forEach((message) => {
+    const invocationId = getAdkMessageInvocationId(message);
+    if (message.role !== "bot" || !invocationId || typeof message.text !== "string")
+      return;
+    const normalizedText = message.text.replace(/\s+/g, " ").trim();
+    if (!normalizedText)
+      return;
+    const fileKey = (message.fileData || []).map((file) => file.fileUri).join("|");
+    const groupKey = `${invocationId}\0${Boolean(
+      message.thought
+    )}\0${fileKey}`;
+    const group = botTextGroups.get(groupKey) || [];
+    group.push({ message, normalizedText });
+    botTextGroups.set(groupKey, group);
+  });
+  const redundantIds = /* @__PURE__ */ new Set();
+  botTextGroups.forEach((group) => {
+    const completeTexts = [];
+    [...group].sort((a, b) => b.normalizedText.length - a.normalizedText.length).forEach(({ message, normalizedText }) => {
+      if (completeTexts.some(
+        (completeText) => completeText.includes(normalizedText)
+      )) {
+        redundantIds.add(message.id);
+        hasDuplicate = true;
+        return;
+      }
+      completeTexts.push(normalizedText);
+    });
+  });
+  return hasDuplicate ? uniqueIdMessages.filter((message) => !redundantIds.has(message.id)) : messages;
+};
+var insertMissingAdkSessionEvents = (currentMessages, sessionEvents, options) => {
+  let nextMessages = pairFunctionResponses(currentMessages);
+  const functionResponses = collectFunctionResponses(sessionEvents);
+  if (functionResponses.size) {
+    nextMessages = pairFunctionResponses(nextMessages, functionResponses);
+  }
+  const renderedEventIds = new Set(
+    nextMessages.map(getAdkMessageEventId).filter(Boolean)
+  );
+  const missingMessages = sessionEvents.filter((event) => {
+    var _a, _b, _c;
+    if ((_a = options == null ? void 0 : options.removedInvocationIds) == null ? void 0 : _a.has(event.invocationId || ""))
+      return false;
+    const parts = (_b = event.content) == null ? void 0 : _b.parts;
+    return Boolean(event.id) && ((_c = event.content) == null ? void 0 : _c.role) === "model" && Array.isArray(parts) && parts.length > 0 && !renderedEventIds.has(event.id);
+  }).flatMap((event) => mapAdkEventToMessages(event, options));
+  if (!missingMessages.length)
+    return nextMessages;
+  const eventOrder = new Map(
+    sessionEvents.map((event, index) => [event.id, index])
+  );
+  const getMessageOrder = (message) => {
+    var _a;
+    const eventId = getAdkMessageEventId(message);
+    if (eventId && eventOrder.has(eventId))
+      return eventOrder.get(eventId);
+    const timestamp = message.timestamp ?? ((_a = message.raw) == null ? void 0 : _a.timestamp);
+    if (timestamp !== void 0) {
+      const nextEventIndex = sessionEvents.findIndex(
+        (event) => (event.timestamp || 0) > timestamp
+      );
+      return nextEventIndex < 0 ? sessionEvents.length + 0.5 : nextEventIndex - 0.5;
+    }
+    return Number.POSITIVE_INFINITY;
+  };
+  missingMessages.forEach((message) => {
+    const targetOrder = getMessageOrder(message);
+    let insertIndex = nextMessages.findIndex((current) => {
+      const currentOrder = getMessageOrder(current);
+      return Number.isFinite(currentOrder) && currentOrder > targetOrder;
+    });
+    if (insertIndex < 0)
+      insertIndex = nextMessages.length;
+    nextMessages.splice(insertIndex, 0, message);
+  });
+  return dedupeAdkMessages(pairFunctionResponses(nextMessages));
+};
+var collectFunctionResponses = (events) => {
+  const functionResponses = /* @__PURE__ */ new Map();
+  events.forEach((event) => {
+    var _a, _b;
+    (_b = (_a = event.content) == null ? void 0 : _a.parts) == null ? void 0 : _b.forEach((part) => {
+      var _a2;
+      if ((_a2 = part.functionResponse) == null ? void 0 : _a2.id) {
+        functionResponses.set(part.functionResponse.id, part.functionResponse);
+      }
+    });
+  });
+  return functionResponses;
+};
+var pairFunctionResponses = (messages, responses) => {
+  const responseMap = responses || new Map(
+    messages.filter((message) => {
+      var _a;
+      return (_a = message.functionResponse) == null ? void 0 : _a.id;
+    }).map((message) => [
+      message.functionResponse.id,
+      message.functionResponse
+    ])
+  );
+  if (!responseMap.size)
+    return messages;
+  return messages.map((message) => {
+    var _a;
+    const callId = (_a = message.functionCall) == null ? void 0 : _a.id;
+    if (!callId || message.functionResponse || !responseMap.has(callId)) {
+      return message;
+    }
+    return {
+      ...message,
+      functionResponse: responseMap.get(callId)
+    };
+  });
+};
+var buildAdkUserMessage = ({
+  text = "",
+  files = [],
+  functionResponse
+}) => {
+  const timestamp = Date.now();
+  const messages = [];
+  if (files.length) {
+    messages.push({
+      id: (0, import_uuid.v4)(),
+      role: "user",
+      timestamp,
+      fileData: files.map((file) => {
+        var _a, _b, _c, _d;
+        const fileUri = file.tempUrl || file.fileUrl || ((_a = file.response) == null ? void 0 : _a.fileUrl) || ((_b = file.response) == null ? void 0 : _b.tempUrl);
+        if (!fileUri)
+          return null;
+        return {
+          displayName: file.fileName || file.name || ((_c = file.response) == null ? void 0 : _c.fileName) || "",
+          mimeType: file.mimeType || ((_d = file.response) == null ? void 0 : _d.mimeType) || "",
+          fileUri
+        };
+      }).filter(Boolean)
+    });
+  }
+  if (text.trim()) {
+    messages.push({ id: (0, import_uuid.v4)(), role: "user", text, timestamp });
+  }
+  if (functionResponse) {
+    messages.push({ id: (0, import_uuid.v4)(), role: "user", functionResponse, timestamp });
+  }
+  return messages;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildAdkUserMessage,
+  buildAdkUserParts,
+  collectFunctionResponses,
+  createAdkMessage,
+  dedupeAdkMessages,
+  getAdkEventMeta,
+  getAdkMessageEventId,
+  getAdkMessageInvocationId,
+  insertMissingAdkSessionEvents,
+  isAdkAsyncTaskEvent,
+  isUserFunctionResponseEvent,
+  mapAdkEventToMessages,
+  mapAdkSessionEventsToMessages,
+  pairFunctionResponses
+});
+//# sourceMappingURL=messages.js.map

package/dist/cjs/core/protocol/messages.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/core/protocol/messages.ts"],
+  "sourcesContent": ["import { v4 } from \"uuid\";\nimport type { Event, IMessage } from \"@/types\";\nimport { buildAdkUserParts, normalizeAdkParts } from \"./parts\";\nimport type {\n  AdkProtocolOptions,\n  BuildAdkUserPartsInput,\n  MessageEventMeta,\n  NormalizedAdkPart,\n} from \"./types\";\n\nconst defaultProtocolOptions: Required<AdkProtocolOptions> = {\n  hideAsyncTaskEvents: true,\n  pairFunctionResponses: true,\n};\n\n/**\n * 获取消息对应的服务端 eventId。\n * session events 补偿和去重会优先用服务端 id，避免前端临时 id 导致重复插入。\n */\nexport const getAdkMessageEventId = (message: IMessage) =>\n  message.eventId || message.raw?.id || message.id;\n\n/**\n * 获取单次模型调用 id。流式分片与 sessionDetails 完整消息通常共享 invocationId，\n * 可用它判断哪些文本属于同一轮回复。\n */\nexport const getAdkMessageInvocationId = (message: IMessage) =>\n  message.invocationId || message.raw?.invocationId;\n\n/**\n * 后端为异步任务补链路时可能插入 user task 事件，这类事件用于关联任务，\n * 默认不作为用户可见消息展示。\n */\nexport const isAdkAsyncTaskEvent = (event: Event) =>\n  event.author === \"user\" &&\n  event.content?.parts?.some((part) => Boolean((part as any)?.task));\n\nexport const isUserFunctionResponseEvent = (event: Event) =>\n  event.content?.role === \"user\" &&\n  Array.isArray(event.content.parts) &&\n  event.content.parts.length > 0 &&\n  event.content.parts.every((part) => Boolean(part?.functionResponse));\n\n/**\n * 提取 event 级元信息，保证 stream 最后一条里的 modelCode / usageMetadata\n * 能透传到 IMessage，业务侧可据此展示 token 消耗等信息。\n */\nexport const getAdkEventMeta = (event: Event): MessageEventMeta => ({\n  eventId: event.id,\n  invocationId: event.invocationId,\n  sessionId: event.sessionId,\n  timestamp: event.timestamp,\n  author: event.author,\n  modelCode: event.modelCode,\n  usageMetadata: event.usageMetadata,\n  finishReason: event.finishReason,\n  isLike: event.isLike,\n});\n\nexport const createAdkMessage = (\n  event: Event,\n  part: NormalizedAdkPart,\n  role: IMessage[\"role\"] = \"bot\",\n): IMessage => ({\n  id: v4(),\n  role,\n  ...getAdkEventMeta(event),\n  thought: part.thought,\n  functionCall: part.functionCall,\n  functionResponse: part.functionResponse,\n  fileData: part.fileDataList || (part.fileData ? [part.fileData] : undefined),\n  inlineData: part.inlineData,\n  executableCode: part.executableCode,\n  codeExecutionResult: part.codeExecutionResult,\n  text: part.errorMessage || part.text,\n  renderedContent: event.groundingMetadata?.searchEntryPoint?.renderedContent,\n  raw: event,\n});\n\n/**\n * 将单个 ADK event 转换为 SDK 消息。\n *\n * followup 事件由上层作为 suggestedQuestions 处理；user functionResponse\n * 默认只用于回填对应 functionCall，不单独展示成一条用户消息。\n */\nexport const mapAdkEventToMessages = (\n  event: Event,\n  options?: AdkProtocolOptions,\n): IMessage[] => {\n  const mergedOptions = { ...defaultProtocolOptions, ...options };\n  if (mergedOptions.hideAsyncTaskEvents && isAdkAsyncTaskEvent(event)) return [];\n  if (mergedOptions.pairFunctionResponses && isUserFunctionResponseEvent(event))\n    return [];\n  if (event.content?.role === \"followup\") return [];\n\n  if (event.content?.parts?.length) {\n    const role = event.content.role === \"user\" ? \"user\" : \"bot\";\n    return normalizeAdkParts(event.content.parts).map((part) =>\n      createAdkMessage(event, part, role),\n    );\n  }\n\n  if (event.errorMessage) {\n    return [\n      {\n        id: v4(),\n        role: \"bot\",\n        text: event.errorMessage,\n        ...getAdkEventMeta(event),\n        raw: event,\n      },\n    ];\n  }\n\n  if (event.actions?.artifactDelta) {\n    return [\n      {\n        id: v4(),\n        role: \"bot\",\n        ...getAdkEventMeta(event),\n        raw: event,\n      },\n    ];\n  }\n\n  return [];\n};\n\nexport const mapAdkSessionEventsToMessages = (\n  events: Event[] = [],\n  options?: AdkProtocolOptions,\n): IMessage[] => pairFunctionResponses(events.flatMap((event) =>\n  mapAdkEventToMessages(event, options),\n));\n\n/**\n * 消息去重分两层：\n * - 先按前端 id 去重。\n * - 再按 invocationId + thought + fileUri 聚合同一轮 bot 文本，保留更完整的长文本。\n *\n * 第二层主要解决 SSE 增量文本和 sessionDetails 完整文本同时存在时重复展示的问题。\n */\nexport const dedupeAdkMessages = (messages: IMessage[]): IMessage[] => {\n  const seenMessageIds = new Set<string>();\n  let hasDuplicate = false;\n\n  const uniqueIdMessages = messages.filter((message) => {\n    if (seenMessageIds.has(message.id)) {\n      hasDuplicate = true;\n      return false;\n    }\n    seenMessageIds.add(message.id);\n    return true;\n  });\n\n  const botTextGroups = new Map<\n    string,\n    Array<{ message: IMessage; normalizedText: string }>\n  >();\n\n  uniqueIdMessages.forEach((message) => {\n    const invocationId = getAdkMessageInvocationId(message);\n    if (\n      message.role !== \"bot\" ||\n      !invocationId ||\n      typeof message.text !== \"string\"\n    )\n      return;\n\n    const normalizedText = message.text.replace(/\\s+/g, \" \").trim();\n    if (!normalizedText) return;\n\n    const fileKey = (message.fileData || [])\n      .map((file) => file.fileUri)\n      .join(\"|\");\n    const groupKey = `${invocationId}\\u0000${Boolean(\n      message.thought,\n    )}\\u0000${fileKey}`;\n    const group = botTextGroups.get(groupKey) || [];\n    group.push({ message, normalizedText });\n    botTextGroups.set(groupKey, group);\n  });\n\n  const redundantIds = new Set<string>();\n  botTextGroups.forEach((group) => {\n    const completeTexts: string[] = [];\n    [...group]\n      .sort((a, b) => b.normalizedText.length - a.normalizedText.length)\n      .forEach(({ message, normalizedText }) => {\n        if (\n          completeTexts.some((completeText) =>\n            completeText.includes(normalizedText),\n          )\n        ) {\n          redundantIds.add(message.id);\n          hasDuplicate = true;\n          return;\n        }\n        completeTexts.push(normalizedText);\n      });\n  });\n\n  return hasDuplicate\n    ? uniqueIdMessages.filter((message) => !redundantIds.has(message.id))\n    : messages;\n};\n\nexport const insertMissingAdkSessionEvents = (\n  currentMessages: IMessage[],\n  sessionEvents: Event[],\n  options?: AdkProtocolOptions & { removedInvocationIds?: Set<string> },\n): IMessage[] => {\n  // 先用 sessionEvents 里的 functionResponse 回填已有 functionCall，避免工具状态丢失。\n  let nextMessages = pairFunctionResponses(currentMessages);\n  const functionResponses = collectFunctionResponses(sessionEvents);\n  if (functionResponses.size) {\n    nextMessages = pairFunctionResponses(nextMessages, functionResponses);\n  }\n\n  const renderedEventIds = new Set(\n    nextMessages.map(getAdkMessageEventId).filter(Boolean),\n  );\n\n  const missingMessages = sessionEvents\n    .filter((event) => {\n      if (options?.removedInvocationIds?.has(event.invocationId || \"\"))\n        return false;\n      const parts = event.content?.parts;\n      return (\n        Boolean(event.id) &&\n        event.content?.role === \"model\" &&\n        Array.isArray(parts) &&\n        parts.length > 0 &&\n        !renderedEventIds.has(event.id)\n      );\n    })\n    .flatMap((event) => mapAdkEventToMessages(event, options));\n\n  if (!missingMessages.length) return nextMessages;\n\n  // 按服务端事件顺序插入缺失消息，尽量保持历史消息和流式消息的时间线一致。\n  const eventOrder = new Map(\n    sessionEvents.map((event, index) => [event.id, index]),\n  );\n  const getMessageOrder = (message: IMessage) => {\n    const eventId = getAdkMessageEventId(message);\n    if (eventId && eventOrder.has(eventId)) return eventOrder.get(eventId)!;\n\n    const timestamp = message.timestamp ?? message.raw?.timestamp;\n    if (timestamp !== undefined) {\n      const nextEventIndex = sessionEvents.findIndex(\n        (event) => (event.timestamp || 0) > timestamp,\n      );\n      return nextEventIndex < 0\n        ? sessionEvents.length + 0.5\n        : nextEventIndex - 0.5;\n    }\n    return Number.POSITIVE_INFINITY;\n  };\n\n  missingMessages.forEach((message) => {\n    const targetOrder = getMessageOrder(message);\n    let insertIndex = nextMessages.findIndex((current) => {\n      const currentOrder = getMessageOrder(current);\n      return Number.isFinite(currentOrder) && currentOrder > targetOrder;\n    });\n    if (insertIndex < 0) insertIndex = nextMessages.length;\n    nextMessages.splice(insertIndex, 0, message);\n  });\n\n  return dedupeAdkMessages(pairFunctionResponses(nextMessages));\n};\n\n/**\n * 从 session events 中收集工具响应，用于回填前面已经渲染出来的 functionCall。\n */\nexport const collectFunctionResponses = (events: Event[]) => {\n  const functionResponses = new Map<\n    string,\n    NonNullable<IMessage[\"functionResponse\"]>\n  >();\n  events.forEach((event) => {\n    event.content?.parts?.forEach((part) => {\n      if (part.functionResponse?.id) {\n        functionResponses.set(part.functionResponse.id, part.functionResponse);\n      }\n    });\n  });\n  return functionResponses;\n};\n\nexport const pairFunctionResponses = (\n  messages: IMessage[],\n  responses?: Map<string, NonNullable<IMessage[\"functionResponse\"]>>,\n): IMessage[] => {\n  const responseMap =\n    responses ||\n    new Map(\n      messages\n        .filter((message) => message.functionResponse?.id)\n        .map((message) => [\n          message.functionResponse!.id!,\n          message.functionResponse!,\n        ]),\n    );\n\n  if (!responseMap.size) return messages;\n\n  return messages.map((message) => {\n    const callId = message.functionCall?.id;\n    if (!callId || message.functionResponse || !responseMap.has(callId)) {\n      return message;\n    }\n    return {\n      ...message,\n      functionResponse: responseMap.get(callId),\n    };\n  });\n};\n\n/**\n * 构造本地乐观用户消息。\n * controller 在真正发请求前会先插入这些消息，让 UI 立即响应用户输入。\n */\nexport const buildAdkUserMessage = ({\n  text = \"\",\n  files = [],\n  functionResponse,\n}: BuildAdkUserPartsInput): IMessage[] => {\n  const timestamp = Date.now();\n  const messages: IMessage[] = [];\n\n  if (files.length) {\n    messages.push({\n      id: v4(),\n      role: \"user\",\n      timestamp,\n      fileData: files\n        .map((file) => {\n          const fileUri =\n            file.tempUrl ||\n            file.fileUrl ||\n            file.response?.fileUrl ||\n            file.response?.tempUrl;\n          if (!fileUri) return null;\n          return {\n            displayName:\n              file.fileName || file.name || file.response?.fileName || \"\",\n            mimeType: file.mimeType || file.response?.mimeType || \"\",\n            fileUri,\n          };\n        })\n        .filter(Boolean) as IMessage[\"fileData\"],\n    });\n  }\n\n  if (text.trim()) {\n    messages.push({ id: v4(), role: \"user\", text, timestamp });\n  }\n\n  if (functionResponse) {\n    messages.push({ id: v4(), role: \"user\", functionResponse, timestamp });\n  }\n\n  return messages;\n};\n\nexport { buildAdkUserParts };\n"],
+  "mappings": "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",
+  "names": ["_a"]
+}

package/dist/cjs/core/protocol/parts.d.ts

@@ -0,0 +1,24 @@
+import type { Part } from "../../types";
+import type { BuildAdkUserPartsInput } from "./types";
+import type { NormalizedAdkPart } from "./types";
+/**
+ * 将后端 ADK parts 归一化成更适合 UI 渲染的片段。
+ *
+ * 设计目标：
+ * - 连续 text 会被合并，减少流式分片直接渲染带来的碎片化。
+ * - fileData 会合并到 fileDataList，支持“文件 + 文本”作为一条消息展示。
+ * - functionCall、functionResponse、代码执行等特殊 part 保持独立，避免影响工具渲染。
+ * - thought 发生切换时会结算当前缓冲，保证思考内容和普通回答不误合并。
+ */
+export declare const normalizeAdkParts: (parts?: Part[]) => NormalizedAdkPart[];
+/**
+ * 兼容早期只关注文本合并的调用方，语义上等同于 normalizeAdkParts。
+ */
+export declare const combineAdkParts: (parts?: Part[]) => NormalizedAdkPart[];
+/**
+ * 将 SDK Sender 的输入内容转换为 ADK 请求体里的 user parts。
+ *
+ * 这里保持“附件 part 在前、文本 part 在后”的顺序，和业务项目 useDebug
+ * 当前对后端协议的使用方式一致；functionResponse 场景只提交工具响应。
+ */
+export declare const buildAdkUserParts: ({ text, files, functionResponse, }: BuildAdkUserPartsInput) => Part[];

package/dist/cjs/core/protocol/parts.js

@@ -0,0 +1,106 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/core/protocol/parts.ts
+var parts_exports = {};
+__export(parts_exports, {
+  buildAdkUserParts: () => buildAdkUserParts,
+  combineAdkParts: () => combineAdkParts,
+  normalizeAdkParts: () => normalizeAdkParts
+});
+module.exports = __toCommonJS(parts_exports);
+var hasContent = (text, files) => Boolean(text) || Boolean(files == null ? void 0 : files.length);
+var isSpecialPart = (part) => Boolean(
+  part.functionCall || part.functionResponse || part.executableCode || part.codeExecutionResult || part.actions
+);
+var normalizeAdkParts = (parts = []) => {
+  const normalized = [];
+  let currentFiles = [];
+  let currentText = "";
+  let currentThought;
+  parts.forEach((part) => {
+    const thoughtChanged = part.thought !== currentThought && hasContent(currentText, currentFiles);
+    if (isSpecialPart(part) || thoughtChanged) {
+      if (hasContent(currentText, currentFiles)) {
+        normalized.push({
+          text: currentText || void 0,
+          fileDataList: currentFiles.length ? currentFiles : void 0,
+          thought: currentThought
+        });
+        currentText = "";
+        currentFiles = [];
+      }
+      if (typeof part.thought !== "undefined") {
+        currentThought = part.thought;
+      }
+    }
+    if (isSpecialPart(part)) {
+      normalized.push({ ...part });
+      return;
+    }
+    if (part.fileData)
+      currentFiles.push(part.fileData);
+    if (part.text)
+      currentText += part.text;
+    if (typeof part.thought !== "undefined")
+      currentThought = part.thought;
+  });
+  if (hasContent(currentText, currentFiles)) {
+    normalized.push({
+      text: currentText || void 0,
+      fileDataList: currentFiles.length ? currentFiles : void 0,
+      thought: currentThought
+    });
+  } else if (!normalized.length && parts.length > 0) {
+    return parts.map((part) => ({ ...part }));
+  }
+  return normalized;
+};
+var combineAdkParts = normalizeAdkParts;
+var buildAdkUserParts = ({
+  text = "",
+  files = [],
+  functionResponse
+}) => {
+  if (functionResponse)
+    return [{ functionResponse }];
+  const parts = [];
+  files.forEach((file) => {
+    var _a, _b, _c, _d;
+    const fileUri = file.tempUrl || file.fileUrl || ((_a = file.response) == null ? void 0 : _a.fileUrl) || ((_b = file.response) == null ? void 0 : _b.tempUrl);
+    if (!fileUri)
+      return;
+    parts.push({
+      fileData: {
+        fileUri,
+        displayName: file.fileName || file.name || ((_c = file.response) == null ? void 0 : _c.fileName) || "",
+        mimeType: file.mimeType || ((_d = file.response) == null ? void 0 : _d.mimeType) || ""
+      }
+    });
+  });
+  if (text.trim())
+    parts.push({ text });
+  return parts;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildAdkUserParts,
+  combineAdkParts,
+  normalizeAdkParts
+});
+//# sourceMappingURL=parts.js.map

package/dist/cjs/core/protocol/parts.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/core/protocol/parts.ts"],
+  "sourcesContent": ["import type { FileData, Part } from \"@/types\";\nimport type { BuildAdkUserPartsInput } from \"./types\";\nimport type { NormalizedAdkPart } from \"./types\";\n\nconst hasContent = (text?: string, files?: FileData[]) =>\n  Boolean(text) || Boolean(files?.length);\n\nconst isSpecialPart = (part: Part) =>\n  Boolean(\n    part.functionCall ||\n      part.functionResponse ||\n      part.executableCode ||\n      part.codeExecutionResult ||\n      (part as any).actions,\n  );\n\n/**\n * 将后端 ADK parts 归一化成更适合 UI 渲染的片段。\n *\n * 设计目标：\n * - 连续 text 会被合并，减少流式分片直接渲染带来的碎片化。\n * - fileData 会合并到 fileDataList，支持“文件 + 文本”作为一条消息展示。\n * - functionCall、functionResponse、代码执行等特殊 part 保持独立，避免影响工具渲染。\n * - thought 发生切换时会结算当前缓冲，保证思考内容和普通回答不误合并。\n */\nexport const normalizeAdkParts = (parts: Part[] = []): NormalizedAdkPart[] => {\n  const normalized: NormalizedAdkPart[] = [];\n  let currentFiles: FileData[] = [];\n  let currentText = \"\";\n  let currentThought: boolean | undefined;\n\n  parts.forEach((part) => {\n    const thoughtChanged =\n      part.thought !== currentThought && hasContent(currentText, currentFiles);\n\n    if (isSpecialPart(part) || thoughtChanged) {\n      if (hasContent(currentText, currentFiles)) {\n        normalized.push({\n          text: currentText || undefined,\n          fileDataList: currentFiles.length ? currentFiles : undefined,\n          thought: currentThought,\n        });\n        currentText = \"\";\n        currentFiles = [];\n      }\n      if (typeof part.thought !== \"undefined\") {\n        currentThought = part.thought;\n      }\n    }\n\n    if (isSpecialPart(part)) {\n      normalized.push({ ...part });\n      return;\n    }\n\n    if (part.fileData) currentFiles.push(part.fileData as FileData);\n    if (part.text) currentText += part.text;\n    if (typeof part.thought !== \"undefined\") currentThought = part.thought;\n  });\n\n  if (hasContent(currentText, currentFiles)) {\n    normalized.push({\n      text: currentText || undefined,\n      fileDataList: currentFiles.length ? currentFiles : undefined,\n      thought: currentThought,\n    });\n  } else if (!normalized.length && parts.length > 0) {\n    return parts.map((part) => ({ ...part }));\n  }\n\n  return normalized;\n};\n\n/**\n * 兼容早期只关注文本合并的调用方，语义上等同于 normalizeAdkParts。\n */\nexport const combineAdkParts = normalizeAdkParts;\n\n/**\n * 将 SDK Sender 的输入内容转换为 ADK 请求体里的 user parts。\n *\n * 这里保持“附件 part 在前、文本 part 在后”的顺序，和业务项目 useDebug\n * 当前对后端协议的使用方式一致；functionResponse 场景只提交工具响应。\n */\nexport const buildAdkUserParts = ({\n  text = \"\",\n  files = [],\n  functionResponse,\n}: BuildAdkUserPartsInput): Part[] => {\n  if (functionResponse) return [{ functionResponse }];\n\n  const parts: Part[] = [];\n  files.forEach((file) => {\n    const fileUri =\n      file.tempUrl ||\n      file.fileUrl ||\n      file.response?.fileUrl ||\n      file.response?.tempUrl;\n    if (!fileUri) return;\n\n    parts.push({\n      fileData: {\n        fileUri,\n        displayName:\n          file.fileName || file.name || file.response?.fileName || \"\",\n        mimeType: file.mimeType || file.response?.mimeType || \"\",\n      },\n    });\n  });\n\n  if (text.trim()) parts.push({ text });\n  return parts;\n};\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,IAAM,aAAa,CAAC,MAAe,UACjC,QAAQ,IAAI,KAAK,QAAQ,+BAAO,MAAM;AAExC,IAAM,gBAAgB,CAAC,SACrB;AAAA,EACE,KAAK,gBACH,KAAK,oBACL,KAAK,kBACL,KAAK,uBACJ,KAAa;AAClB;AAWK,IAAM,oBAAoB,CAAC,QAAgB,CAAC,MAA2B;AAC5E,QAAM,aAAkC,CAAC;AACzC,MAAI,eAA2B,CAAC;AAChC,MAAI,cAAc;AAClB,MAAI;AAEJ,QAAM,QAAQ,CAAC,SAAS;AACtB,UAAM,iBACJ,KAAK,YAAY,kBAAkB,WAAW,aAAa,YAAY;AAEzE,QAAI,cAAc,IAAI,KAAK,gBAAgB;AACzC,UAAI,WAAW,aAAa,YAAY,GAAG;AACzC,mBAAW,KAAK;AAAA,UACd,MAAM,eAAe;AAAA,UACrB,cAAc,aAAa,SAAS,eAAe;AAAA,UACnD,SAAS;AAAA,QACX,CAAC;AACD,sBAAc;AACd,uBAAe,CAAC;AAAA,MAClB;AACA,UAAI,OAAO,KAAK,YAAY,aAAa;AACvC,yBAAiB,KAAK;AAAA,MACxB;AAAA,IACF;AAEA,QAAI,cAAc,IAAI,GAAG;AACvB,iBAAW,KAAK,EAAE,GAAG,KAAK,CAAC;AAC3B;AAAA,IACF;AAEA,QAAI,KAAK;AAAU,mBAAa,KAAK,KAAK,QAAoB;AAC9D,QAAI,KAAK;AAAM,qBAAe,KAAK;AACnC,QAAI,OAAO,KAAK,YAAY;AAAa,uBAAiB,KAAK;AAAA,EACjE,CAAC;AAED,MAAI,WAAW,aAAa,YAAY,GAAG;AACzC,eAAW,KAAK;AAAA,MACd,MAAM,eAAe;AAAA,MACrB,cAAc,aAAa,SAAS,eAAe;AAAA,MACnD,SAAS;AAAA,IACX,CAAC;AAAA,EACH,WAAW,CAAC,WAAW,UAAU,MAAM,SAAS,GAAG;AACjD,WAAO,MAAM,IAAI,CAAC,UAAU,EAAE,GAAG,KAAK,EAAE;AAAA,EAC1C;AAEA,SAAO;AACT;AAKO,IAAM,kBAAkB;AAQxB,IAAM,oBAAoB,CAAC;AAAA,EAChC,OAAO;AAAA,EACP,QAAQ,CAAC;AAAA,EACT;AACF,MAAsC;AACpC,MAAI;AAAkB,WAAO,CAAC,EAAE,iBAAiB,CAAC;AAElD,QAAM,QAAgB,CAAC;AACvB,QAAM,QAAQ,CAAC,SAAS;AA5F1B;AA6FI,UAAM,UACJ,KAAK,WACL,KAAK,aACL,UAAK,aAAL,mBAAe,cACf,UAAK,aAAL,mBAAe;AACjB,QAAI,CAAC;AAAS;AAEd,UAAM,KAAK;AAAA,MACT,UAAU;AAAA,QACR;AAAA,QACA,aACE,KAAK,YAAY,KAAK,UAAQ,UAAK,aAAL,mBAAe,aAAY;AAAA,QAC3D,UAAU,KAAK,cAAY,UAAK,aAAL,mBAAe,aAAY;AAAA,MACxD;AAAA,IACF,CAAC;AAAA,EACH,CAAC;AAED,MAAI,KAAK,KAAK;AAAG,UAAM,KAAK,EAAE,KAAK,CAAC;AACpC,SAAO;AACT;",
+  "names": []
+}

package/dist/cjs/core/protocol/types.d.ts

@@ -0,0 +1,57 @@
+import type { AgentRunRequest, Event, FileData, FunctionCall, FunctionResponse, IMessage, Part, SendContent } from "../../types";
+export type AdkEvent = Event;
+export type AdkPart = Part;
+export type AdkFileData = FileData;
+export type AdkFunctionCall = FunctionCall;
+export type AdkFunctionResponse = FunctionResponse;
+export type AdkMessage = IMessage;
+export type AdkSendContent = SendContent;
+export type AdkRunRequest = AgentRunRequest;
+export interface NormalizedAdkPart extends Partial<Part> {
+    text?: string;
+    fileDataList?: FileData[];
+    thought?: boolean;
+}
+export interface MessageEventMeta {
+    eventId?: string;
+    invocationId?: string;
+    sessionId?: string;
+    timestamp?: number;
+    author?: string;
+    modelCode?: string;
+    usageMetadata?: AdkEvent["usageMetadata"];
+    finishReason?: string;
+    isLike?: number;
+}
+export interface AdkProtocolOptions {
+    /**
+     * Hide user events inserted by backend async tasks.
+     * @default true
+     */
+    hideAsyncTaskEvents?: boolean;
+    /**
+     * Treat user-only functionResponse events as tool-call status updates instead
+     * of standalone messages.
+     * @default true
+     */
+    pairFunctionResponses?: boolean;
+}
+export interface BuildAdkUserPartsInput {
+    text?: string;
+    files?: Array<{
+        fileName?: string;
+        name?: string;
+        tempUrl?: string;
+        fileUrl?: string;
+        mimeType?: string;
+        type?: string;
+        response?: {
+            fileName?: string;
+            fileUrl?: string;
+            tempUrl?: string;
+            mimeType?: string;
+            fileType?: string;
+        };
+    }>;
+    functionResponse?: FunctionResponse | null;
+}

package/dist/cjs/core/protocol/types.js

@@ -0,0 +1,18 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/core/protocol/types.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);
+//# sourceMappingURL=types.js.map

package/dist/cjs/core/protocol/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/core/protocol/types.ts"],
+  "sourcesContent": ["import type {\n  AgentRunRequest,\n  Event,\n  FileData,\n  FunctionCall,\n  FunctionResponse,\n  IMessage,\n  Part,\n  SendContent,\n} from \"@/types\";\n\nexport type AdkEvent = Event;\nexport type AdkPart = Part;\nexport type AdkFileData = FileData;\nexport type AdkFunctionCall = FunctionCall;\nexport type AdkFunctionResponse = FunctionResponse;\nexport type AdkMessage = IMessage;\nexport type AdkSendContent = SendContent;\nexport type AdkRunRequest = AgentRunRequest;\n\nexport interface NormalizedAdkPart extends Partial<Part> {\n  text?: string;\n  fileDataList?: FileData[];\n  thought?: boolean;\n}\n\nexport interface MessageEventMeta {\n  eventId?: string;\n  invocationId?: string;\n  sessionId?: string;\n  timestamp?: number;\n  author?: string;\n  modelCode?: string;\n  usageMetadata?: AdkEvent[\"usageMetadata\"];\n  finishReason?: string;\n  isLike?: number;\n}\n\nexport interface AdkProtocolOptions {\n  /**\n   * Hide user events inserted by backend async tasks.\n   * @default true\n   */\n  hideAsyncTaskEvents?: boolean;\n  /**\n   * Treat user-only functionResponse events as tool-call status updates instead\n   * of standalone messages.\n   * @default true\n   */\n  pairFunctionResponses?: boolean;\n}\n\nexport interface BuildAdkUserPartsInput {\n  text?: string;\n  files?: Array<{\n    fileName?: string;\n    name?: string;\n    tempUrl?: string;\n    fileUrl?: string;\n    mimeType?: string;\n    type?: string;\n    response?: {\n      fileName?: string;\n      fileUrl?: string;\n      tempUrl?: string;\n      mimeType?: string;\n      fileType?: string;\n    };\n  }>;\n  functionResponse?: FunctionResponse | null;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;",
+  "names": []
+}

package/dist/cjs/core/runtime/createAdkConversationController.d.ts

@@ -0,0 +1,8 @@
+import type { AdkConversationController, AdkConversationOptions } from "./types";
+/**
+ * 创建无 React 依赖的 ADK 对话数据流控制器。
+ *
+ * controller 只管理状态和数据流编排；所有请求细节都交给 transport，
+ * 所有 UI 提示都通过 callbacks 抛给调用方。
+ */
+export declare const createAdkConversationController: (options: AdkConversationOptions) => AdkConversationController;