agent-chat-sdk-core 0.1.0

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EACL,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAE/F,YAAY,EACV,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,gBAAgB,EAChB,oBAAoB,EACpB,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,QAAQ,GACT,MAAM,YAAY,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,6 @@
+export { AgentChatClient } from './client.js';
+export { parseSSELine, readSSEStream, isStreamEndSignal } from './parser.js';
+export { normalizeRawChunk, createNormalizeContext, finalizeNormalizeContext, } from './normalizer.js';
+export { createSessionState, applyEventToSession } from './session.js';
+export { REACT_SSE_TYPE_MAP } from './react-flow.js';
+export { parseKnowledgeSupLabels, stripKnowledgeSupLabels, } from './knowledge-label.js';

package/dist/esm/knowledge-label.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 知识库引用标注（answer 正文中的 <sup> 标签）解析
+ *
+ * @example
+ * `<sup score="0.2" fileid="doc_001" filename="FAQ.txt" chunkid="4191..." dsid="docstore_xxx">2</sup>`
+ */
+/** 单条知识库引用标注 */
+export interface KnowledgeCitationLabel {
+    /** 原始 sup 标签全文 */
+    raw: string;
+    /** 标签内展示的引用序号（如 "2"） */
+    index: string;
+    /** 相关度分数 */
+    score?: string;
+    /** 文档 ID（fileid） */
+    fileId?: string;
+    /** 文档名称（filename） */
+    filename?: string;
+    /** 切片 ID（chunkid） */
+    chunkId?: string;
+    /** 知识库 / 数据集 ID（dsid） */
+    datasetId?: string;
+    /** 标签上其余属性（小写 key） */
+    attributes: Record<string, string>;
+}
+/** 解析结果 */
+export interface ParseKnowledgeLabelsResult {
+    /** 去掉 sup 标签后的正文 */
+    text: string;
+    /** 按出现顺序的引用标注 */
+    labels: KnowledgeCitationLabel[];
+}
+/**
+ * 解析正文中的知识库 <sup> 引用标签
+ *
+ * @param content - 含 sup 标签的回复正文
+ * @returns 剥离标签后的正文与标注列表
+ */
+export declare function parseKnowledgeSupLabels(content: string): ParseKnowledgeLabelsResult;
+/**
+ * 去掉正文中的知识库 sup 标签（便于暂不渲染引用角标）
+ *
+ * @param content - 原始正文
+ * @param options.stripIncomplete - 是否去掉末尾未闭合的 `<sup`（流式场景建议 true）
+ */
+export declare function stripKnowledgeSupLabels(content: string, options?: {
+    stripIncomplete?: boolean;
+}): string;
+//# sourceMappingURL=knowledge-label.d.ts.map

package/dist/esm/knowledge-label.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-label.d.ts","sourceRoot":"","sources":["../../src/knowledge-label.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,gBAAgB;AAChB,MAAM,WAAW,sBAAsB;IACrC,kBAAkB;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,WAAW;AACX,MAAM,WAAW,0BAA0B;IACzC,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB;IACjB,MAAM,EAAE,sBAAsB,EAAE,CAAC;CAClC;AA8BD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,0BAA0B,CAOnF;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE,GACtC,MAAM,CAIR"}

package/dist/esm/knowledge-label.js

@@ -0,0 +1,67 @@
+/**
+ * 知识库引用标注（answer 正文中的 <sup> 标签）解析
+ *
+ * @example
+ * `<sup score="0.2" fileid="doc_001" filename="FAQ.txt" chunkid="4191..." dsid="docstore_xxx">2</sup>`
+ */
+// \s* 兼容无属性写法 <sup>1</sup>
+const SUP_TAG_REGEX = /<sup\s*([^>]*)>([\s\S]*?)<\/sup>/gi;
+const ATTR_REGEX = /([\w-]+)\s*=\s*"([^"]*)"/g;
+function parseSupAttributes(attrString) {
+    const attributes = {};
+    let match;
+    ATTR_REGEX.lastIndex = 0;
+    while ((match = ATTR_REGEX.exec(attrString)) !== null) {
+        attributes[match[1].toLowerCase()] = match[2];
+    }
+    return attributes;
+}
+function toCitationLabel(raw, attrString, inner) {
+    const attributes = parseSupAttributes(attrString);
+    return {
+        raw,
+        index: inner.trim(),
+        score: attributes.score,
+        fileId: attributes.fileid,
+        filename: attributes.filename,
+        chunkId: attributes.chunkid,
+        datasetId: attributes.dsid,
+        attributes,
+    };
+}
+/**
+ * 解析正文中的知识库 <sup> 引用标签
+ *
+ * @param content - 含 sup 标签的回复正文
+ * @returns 剥离标签后的正文与标注列表
+ */
+export function parseKnowledgeSupLabels(content) {
+    const labels = [];
+    const text = content.replace(SUP_TAG_REGEX, (match, attrPart, inner) => {
+        labels.push(toCitationLabel(match, attrPart, inner));
+        return '';
+    });
+    return { text, labels };
+}
+/**
+ * 去掉正文中的知识库 sup 标签（便于暂不渲染引用角标）
+ *
+ * @param content - 原始正文
+ * @param options.stripIncomplete - 是否去掉末尾未闭合的 `<sup`（流式场景建议 true）
+ */
+export function stripKnowledgeSupLabels(content, options) {
+    const { text } = parseKnowledgeSupLabels(content);
+    if (options?.stripIncomplete === false)
+        return text;
+    return stripIncompleteSupTail(text);
+}
+/** 去掉末尾未闭合的 sup 片段，避免流式过程中露出半截标签 */
+function stripIncompleteSupTail(text) {
+    const openIdx = text.lastIndexOf('<sup');
+    if (openIdx === -1)
+        return text;
+    const tail = text.slice(openIdx);
+    if (/<\/sup>/i.test(tail))
+        return text;
+    return text.slice(0, openIdx);
+}

package/dist/esm/normalizer.d.ts

@@ -0,0 +1,22 @@
+import { AgentStreamEvent, RawSSEChunk } from './types.js';
+export interface NormalizeContext {
+    thinkingContent: string;
+    answerContent: string;
+    isThinking: boolean;
+    thinkingRound: number;
+    thinkingRunningTime?: string;
+    activeToolId?: string;
+}
+export declare function createNormalizeContext(): NormalizeContext;
+/**
+ * ReAct 流式事件归一化
+ *
+ * 交互时序：
+ * 1. thinking_start → thinking_delta* → thinking_end（进入工具/MCP/工作流，或开始输出 answer 时收尾）
+ * 2. tool_call_start → tool_call_end（工具调用中 → 完成）
+ * 3. 可重复 1-2 多轮
+ * 4. answer_delta* 流式输出最终结果（不触发 thinking_end，避免 answer-toolsnode 空包多计一轮）
+ */
+export declare function normalizeRawChunk(chunk: RawSSEChunk, ctx: NormalizeContext): AgentStreamEvent[];
+export declare function finalizeNormalizeContext(ctx: NormalizeContext): AgentStreamEvent[];
+//# sourceMappingURL=normalizer.d.ts.map

package/dist/esm/normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizer.d.ts","sourceRoot":"","sources":["../../src/normalizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAmB,WAAW,EAAE,MAAM,YAAY,CAAC;AAa5E,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,sBAAsB,IAAI,gBAAgB,CAOzD;AAoJD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,WAAW,EAClB,GAAG,EAAE,gBAAgB,GACpB,gBAAgB,EAAE,CAoGpB;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,gBAAgB,GAAG,gBAAgB,EAAE,CAIlF"}

package/dist/esm/normalizer.js

@@ -0,0 +1,252 @@
+const ANSWER_TYPES = new Set(['answer', 'text', 'message']);
+const STREAM_END_TYPES = new Set(['done', 'end', 'finish', 'completed', 'stop']);
+const TOOL_TYPES = new Set(['tool', 'knowledge', 'plugin', 'mcp', 'memory_var_update', 'workflow']);
+let toolIdSeq = 0;
+function nextToolId() {
+    toolIdSeq += 1;
+    return `tool_${toolIdSeq}_${Date.now()}`;
+}
+export function createNormalizeContext() {
+    return {
+        thinkingContent: '',
+        answerContent: '',
+        isThinking: false,
+        thinkingRound: 0,
+    };
+}
+function isToolType(type) {
+    return TOOL_TYPES.has(type);
+}
+function resolveCallKind(type) {
+    if (type === 'knowledge')
+        return 'knowledge';
+    if (type === 'plugin')
+        return 'plugin';
+    if (type === 'mcp')
+        return 'mcp';
+    if (type === 'memory_var_update')
+        return 'memory';
+    if (type === 'workflow')
+        return 'workflow';
+    return 'tool';
+}
+/** 规范化耗时（去掉末尾 s） */
+function normalizeRunningTime(value) {
+    if (!value)
+        return undefined;
+    return String(value).replace(/s$/i, '').trim();
+}
+/**
+ * 拼接回答正文：兼容增量 delta 与服务端推送的累积全文
+ */
+function appendAnswerContent(ctx, incoming) {
+    if (!incoming)
+        return;
+    if (!ctx.answerContent) {
+        ctx.answerContent = incoming;
+        return;
+    }
+    if (incoming.startsWith(ctx.answerContent)) {
+        ctx.answerContent = incoming;
+        return;
+    }
+    if (ctx.answerContent.endsWith(incoming))
+        return;
+    ctx.answerContent += incoming;
+}
+function resolveCallTitle(kind, raw) {
+    if (kind === 'knowledge')
+        return '知识库调用';
+    if (kind === 'plugin')
+        return '插件调用';
+    if (kind === 'mcp')
+        return 'MCP调用';
+    if (kind === 'memory') {
+        const name = raw?.name;
+        if (typeof name === 'string' && name)
+            return `记忆变量 ${name}`;
+        return '记忆变量更新';
+    }
+    if (kind === 'workflow') {
+        if (typeof raw?.tool_name === 'string' && raw.tool_name)
+            return String(raw.tool_name);
+        return '工作流调用';
+    }
+    if (typeof raw?.tool_name === 'string' && raw.tool_name)
+        return String(raw.tool_name);
+    return '工具调用';
+}
+function resolveToolId(chunk) {
+    if (chunk.type === 'workflow' && chunk.raw) {
+        if (typeof chunk.raw.tool_call_id === 'string')
+            return chunk.raw.tool_call_id;
+        if (typeof chunk.raw.workflow_id === 'string')
+            return chunk.raw.workflow_id;
+        if (typeof chunk.raw.tool_id === 'string')
+            return chunk.raw.tool_id;
+    }
+    if (chunk.type === 'memory_var_update' && chunk.raw) {
+        const name = typeof chunk.raw.name === 'string' ? chunk.raw.name : 'var';
+        const conv = typeof chunk.raw.conversation_id === 'string' ? chunk.raw.conversation_id : '';
+        return `memory_${name}_${conv}`.slice(0, 120);
+    }
+    if (typeof chunk.raw?.tool_call_id === 'string')
+        return chunk.raw.tool_call_id;
+    if (typeof chunk.raw?.chunk_id === 'string')
+        return chunk.raw.chunk_id;
+    return undefined;
+}
+/** 结束当前思考阶段，进入 ReAct 下一步（工具调用或回答） */
+function endThinkingPhase(ctx, events, timestamp) {
+    if (!ctx.isThinking)
+        return;
+    const content = ctx.thinkingContent.trim();
+    ctx.isThinking = false;
+    if (content) {
+        events.push({
+            type: 'thinking_end',
+            timestamp,
+            content,
+            runningTime: normalizeRunningTime(ctx.thinkingRunningTime),
+            round: ctx.thinkingRound,
+        });
+    }
+    ctx.thinkingContent = '';
+    ctx.thinkingRunningTime = undefined;
+}
+/** 开始新一轮思考（支持 ReAct 多轮：思考 → 工具 → 再思考） */
+function startThinkingPhase(ctx, events, timestamp) {
+    if (ctx.isThinking)
+        return;
+    ctx.thinkingRound += 1;
+    ctx.isThinking = true;
+    ctx.thinkingContent = '';
+    ctx.thinkingRunningTime = undefined;
+    events.push({
+        type: 'thinking_start',
+        timestamp,
+        round: ctx.thinkingRound,
+    });
+}
+function emitToolStart(ctx, events, timestamp, callKind, title, toolId) {
+    const id = toolId ?? nextToolId();
+    ctx.activeToolId = id;
+    events.push({
+        type: callKind === 'knowledge' ? 'knowledge_call_start' : 'tool_call_start',
+        timestamp,
+        toolId: id,
+        title,
+        callKind,
+    });
+}
+function emitToolEnd(ctx, events, timestamp, callKind, title, content, runningTime, toolId) {
+    const id = toolId ?? ctx.activeToolId ?? nextToolId();
+    events.push({
+        type: callKind === 'knowledge' ? 'knowledge_call_end' : 'tool_call_end',
+        timestamp,
+        toolId: id,
+        title,
+        content,
+        runningTime: normalizeRunningTime(runningTime),
+        callKind,
+    });
+    if (ctx.activeToolId === id)
+        ctx.activeToolId = undefined;
+}
+/**
+ * ReAct 流式事件归一化
+ *
+ * 交互时序：
+ * 1. thinking_start → thinking_delta* → thinking_end（进入工具/MCP/工作流，或开始输出 answer 时收尾）
+ * 2. tool_call_start → tool_call_end（工具调用中 → 完成）
+ * 3. 可重复 1-2 多轮
+ * 4. answer_delta* 流式输出最终结果（不触发 thinking_end，避免 answer-toolsnode 空包多计一轮）
+ */
+export function normalizeRawChunk(chunk, ctx) {
+    const timestamp = Date.now();
+    const events = [];
+    if (chunk.type === 'error') {
+        endThinkingPhase(ctx, events, timestamp);
+        events.push({
+            type: 'error',
+            timestamp,
+            message: chunk.error || chunk.content || '执行出错，请稍后重试',
+            detail: chunk.error_detail,
+        });
+        return events;
+    }
+    if (chunk.type === 'thinking') {
+        if (chunk.running_time) {
+            ctx.thinkingRunningTime = normalizeRunningTime(chunk.running_time);
+        }
+        startThinkingPhase(ctx, events, timestamp);
+        ctx.thinkingContent += chunk.content;
+        events.push({
+            type: 'thinking_delta',
+            timestamp,
+            delta: chunk.content,
+            content: ctx.thinkingContent,
+            round: ctx.thinkingRound,
+        });
+        return events;
+    }
+    if (isToolType(chunk.type)) {
+        endThinkingPhase(ctx, events, timestamp);
+        const callKind = resolveCallKind(chunk.type);
+        const title = resolveCallTitle(callKind, chunk.raw);
+        const rawId = resolveToolId(chunk);
+        if (chunk.running_time) {
+            if (!ctx.activeToolId) {
+                emitToolStart(ctx, events, timestamp, callKind, title, rawId);
+            }
+            emitToolEnd(ctx, events, timestamp, callKind, title, chunk.content, chunk.running_time, rawId);
+        }
+        else if (chunk.content) {
+            emitToolEnd(ctx, events, timestamp, callKind, title, chunk.content, undefined, rawId);
+        }
+        else {
+            emitToolStart(ctx, events, timestamp, callKind, title, rawId);
+        }
+        return events;
+    }
+    if (ANSWER_TYPES.has(chunk.type)) {
+        // 思考阶段结束、开始输出最终回答时立即 thinking_end，避免 loading 持续到流结束
+        endThinkingPhase(ctx, events, timestamp);
+        const delta = chunk.content;
+        appendAnswerContent(ctx, delta);
+        events.push({
+            type: 'answer_delta',
+            timestamp,
+            delta,
+            content: ctx.answerContent,
+        });
+        return events;
+    }
+    if (STREAM_END_TYPES.has(chunk.type)) {
+        endThinkingPhase(ctx, events, timestamp);
+        events.push({ type: 'stream_end', timestamp });
+        return events;
+    }
+    if (chunk.content &&
+        chunk.type !== 'thinking' &&
+        !isToolType(chunk.type) &&
+        chunk.type !== 'error') {
+        endThinkingPhase(ctx, events, timestamp);
+        const delta = chunk.content;
+        appendAnswerContent(ctx, delta);
+        events.push({
+            type: 'answer_delta',
+            timestamp,
+            delta,
+            content: ctx.answerContent,
+        });
+        return events;
+    }
+    events.push({ type: 'raw', timestamp, chunk });
+    return events;
+}
+export function finalizeNormalizeContext(ctx) {
+    const events = [];
+    endThinkingPhase(ctx, events, Date.now());
+    return events;
+}

package/dist/esm/parser.d.ts

@@ -0,0 +1,12 @@
+import { RawSSEChunk } from './types.js';
+export declare function isStreamEndSignal(type: string, dataStr: string): boolean;
+/**
+ * 解析单行 SSE 文本
+ * @returns 原始分片 | 'end' 流结束 | null 跳过
+ */
+export declare function parseSSELine(line: string): RawSSEChunk | 'end' | null;
+/**
+ * 从 ReadableStream 读取并解析 SSE，逐条回调
+ */
+export declare function readSSEStream(body: ReadableStream<Uint8Array>, onChunk: (chunk: RawSSEChunk) => void, signal?: AbortSignal): Promise<void>;
+//# sourceMappingURL=parser.d.ts.map

package/dist/esm/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAsKzC,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAExE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,KAAK,GAAG,IAAI,CAkFrE;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,EAChC,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,EACrC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAwCf"}