flare-chat-core 0.2.2 → 0.2.4

package/src/chat-core/app/mockRuntime.js

@@ -1,291 +0,0 @@
-const MAX_PREVIEW_LENGTH = 80;
-const MAX_AUTO_TITLE_LENGTH = 24;
-const DEFAULT_TITLE_SOURCE = 'default';
-const AUTO_TITLE_SOURCE = 'auto';
-const MANUAL_TITLE_SOURCE = 'manual';
-
-function buildId(prefix) {
-  const randomPart = Math.random().toString(36).slice(2, 10);
-  return `${prefix}_${Date.now()}_${randomPart}`;
-}
-
-function nowISO() {
-  return new Date().toISOString();
-}
-
-function summarize(messages) {
-  if (!Array.isArray(messages) || messages.length === 0) {
-    return '';
-  }
-
-  const lastContent = messages[messages.length - 1]?.content || '';
-  if (lastContent.length <= MAX_PREVIEW_LENGTH) {
-    return lastContent;
-  }
-
-  return `${lastContent.slice(0, MAX_PREVIEW_LENGTH)}...`;
-}
-
-function extractSessionPreview({ userMessage = '', assistantMessage = '' } = {}) {
-  const normalizedUserMessage = String(userMessage || '').replace(/\s+/g, ' ').trim();
-  if (normalizedUserMessage) {
-    if (normalizedUserMessage.length <= MAX_PREVIEW_LENGTH) {
-      return normalizedUserMessage;
-    }
-    return `${normalizedUserMessage.slice(0, MAX_PREVIEW_LENGTH)}...`;
-  }
-  const normalizedAssistantMessage = String(assistantMessage || '').replace(/\s+/g, ' ').trim();
-  if (!normalizedAssistantMessage) {
-    return '';
-  }
-  if (normalizedAssistantMessage.length <= MAX_PREVIEW_LENGTH) {
-    return normalizedAssistantMessage;
-  }
-  return `${normalizedAssistantMessage.slice(0, MAX_PREVIEW_LENGTH)}...`;
-}
-
-function createMessage(role, content) {
-  return {
-    message_id: buildId(`msg_${role}`),
-    role,
-    content,
-    created_at: nowISO(),
-  };
-}
-
-function extractAutoSessionTitle(content) {
-  const normalized = String(content || '')
-    .replace(/\s+/g, ' ')
-    .trim();
-  if (!normalized) {
-    return '';
-  }
-  if (normalized.length <= MAX_AUTO_TITLE_LENGTH) {
-    return normalized;
-  }
-  return `${normalized.slice(0, MAX_AUTO_TITLE_LENGTH)}…`;
-}
-
-export function createMockRuntime({
-  defaultFunctionType = 'chat_component_debug',
-  defaultSessionTitle = '新会话',
-} = {}) {
-  const sessions = new Map();
-  const messagesBySession = new Map();
-
-  function getMessages(sessionId) {
-    return messagesBySession.get(sessionId) || [];
-  }
-
-  function upsertSession(sessionRecord) {
-    sessions.set(sessionRecord.sessionId, sessionRecord);
-  }
-
-  function getSessionOrThrow(sessionId) {
-    const session = sessions.get(sessionId);
-    if (!session) {
-      throw new Error(`Session not found: ${sessionId}`);
-    }
-
-    return session;
-  }
-
-  function touchSession(sessionId, options = {}) {
-    const session = getSessionOrThrow(sessionId);
-    const previewOverride = String(options?.preview || '').trim();
-    upsertSession({
-      ...session,
-      updatedAt: nowISO(),
-      preview: previewOverride || summarize(getMessages(sessionId)),
-    });
-  }
-
-  function createSessionRecord({ functionType, projectId = null, title, userId = null }) {
-    const sessionId = buildId('sess');
-    const now = nowISO();
-    const nextRecord = {
-      sessionId,
-      functionType: functionType || defaultFunctionType,
-      projectId: projectId || null,
-      title: title || defaultSessionTitle,
-      titleSource: DEFAULT_TITLE_SOURCE,
-      status: 'active',
-      userId: userId || null,
-      createdAt: now,
-      updatedAt: now,
-      preview: '',
-      workspaceState: null,
-    };
-
-    upsertSession(nextRecord);
-    messagesBySession.set(sessionId, []);
-    return nextRecord;
-  }
-
-  function ensureSessionRecord(sessionId, options = {}) {
-    const normalizedSessionId = String(sessionId || '').trim();
-    if (normalizedSessionId && sessions.has(normalizedSessionId)) {
-      return normalizedSessionId;
-    }
-    const created = createSessionRecord({
-      functionType: options.functionType,
-      projectId: options.projectId,
-      title: options.title,
-      userId: options.userId,
-    });
-    return created.sessionId;
-  }
-
-  const sessionAPI = {
-    async list(params = {}) {
-      const functionType = params.function_type;
-      const projectId = params.project_id ? String(params.project_id) : null;
-      const userId = params.user_id ? String(params.user_id) : null;
-      const filteredSessions = Array.from(sessions.values())
-        .filter((item) => !functionType || item.functionType === functionType)
-        .filter((item) => !projectId || item.projectId === projectId)
-        .filter((item) => !userId || item.userId === userId)
-        .sort((a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime())
-        .map((item) => ({
-          sessionId: item.sessionId,
-          project_id: item.projectId,
-          title: item.title,
-          preview: item.preview,
-          title_source: item.titleSource,
-          status: item.status,
-          updatedAt: item.updatedAt,
-          user_id: item.userId,
-        }));
-
-      return {
-        sessions: filteredSessions,
-      };
-    },
-
-    async get(sessionId) {
-      const session = getSessionOrThrow(sessionId);
-      return {
-        sessionId: session.sessionId,
-        project_id: session.projectId,
-        title: session.title,
-        preview: session.preview,
-        title_source: session.titleSource,
-        status: session.status,
-        user_id: session.userId,
-        function_type: session.functionType,
-        workspace_state: session.workspaceState,
-      };
-    },
-
-    async create(payload = {}) {
-      const session = createSessionRecord({
-        functionType: payload.function_type,
-        projectId: payload.project_id,
-        title: payload.title,
-        userId: payload.user_id,
-      });
-
-      return {
-        sessionId: session.sessionId,
-        project_id: session.projectId,
-        title: session.title,
-        preview: session.preview,
-        title_source: session.titleSource,
-        status: session.status,
-        user_id: session.userId,
-        workspace_state: session.workspaceState,
-      };
-    },
-
-    async update(sessionId, payload = {}) {
-      const session = getSessionOrThrow(sessionId);
-      const nextTitle = String(payload.title || '').trim();
-      const hasWorkspaceState = Object.prototype.hasOwnProperty.call(payload, 'workspace_state');
-
-      upsertSession({
-        ...session,
-        title: nextTitle || session.title,
-        titleSource: nextTitle ? MANUAL_TITLE_SOURCE : session.titleSource,
-        ...(hasWorkspaceState ? { workspaceState: payload.workspace_state || null } : {}),
-        updatedAt: nowISO(),
-      });
-
-      return {
-        sessionId,
-        title: nextTitle || session.title,
-        preview: session.preview,
-        title_source: nextTitle ? MANUAL_TITLE_SOURCE : session.titleSource,
-        workspace_state: hasWorkspaceState ? (payload.workspace_state || null) : session.workspaceState,
-      };
-    },
-  };
-
-  const messageAPI = {
-    async list(sessionId) {
-      const messages = getMessages(sessionId);
-      return {
-        messages: messages.map((item) => ({ ...item })),
-      };
-    },
-  };
-
-  function appendExchange(sessionId, userMessage, assistantMessage, options = {}) {
-    const resolvedSessionId = ensureSessionRecord(sessionId, options);
-    const messages = [...getMessages(resolvedSessionId)];
-    const session = getSessionOrThrow(resolvedSessionId);
-    const currentTitleSource = String(session?.titleSource || DEFAULT_TITLE_SOURCE).trim() || DEFAULT_TITLE_SOURCE;
-    const hasUserMessage = messages.some((item) => String(item?.role || '').trim() === 'user');
-    const nextAutoTitle = extractAutoSessionTitle(userMessage);
-    const shouldAutoTitle = (
-      !hasUserMessage
-      && nextAutoTitle
-      && currentTitleSource !== MANUAL_TITLE_SOURCE
-      && String(session?.title || '').trim() === String(defaultSessionTitle || '').trim()
-    );
-    const nextPreview = extractSessionPreview({ userMessage, assistantMessage });
-
-    messages.push(createMessage('user', userMessage));
-    messages.push(createMessage('assistant', assistantMessage));
-
-    messagesBySession.set(resolvedSessionId, messages);
-    upsertSession({
-      ...session,
-      title: shouldAutoTitle ? nextAutoTitle : session.title,
-      titleSource: shouldAutoTitle ? AUTO_TITLE_SOURCE : currentTitleSource,
-      preview: nextPreview || session.preview || '',
-      updatedAt: nowISO(),
-    });
-    touchSession(resolvedSessionId, { preview: nextPreview });
-    const latestSession = getSessionOrThrow(resolvedSessionId);
-    return {
-      sessionId: resolvedSessionId,
-      title: String(latestSession?.title || '').trim(),
-      preview: String(latestSession?.preview || '').trim(),
-      title_source: String(latestSession?.titleSource || '').trim(),
-    };
-  }
-
-  function buildAssistantReply(content, enabledCapabilities = []) {
-    const lines = [
-      '这是本地开发模式的模拟响应。',
-      '用于调试会话、流式渲染、模式切换与生成式界面插槽。',
-      '',
-      `你输入的是：${content}`,
-    ];
-
-    if (enabledCapabilities.length > 0) {
-      lines.push('', `当前启用能力：${enabledCapabilities.join('、')}`);
-    }
-
-    lines.push('', '下一步可以继续输入，观察多轮对话行为。');
-    return lines.join('\n');
-  }
-
-  return {
-    sessionAPI,
-    messageAPI,
-    appendExchange,
-    ensureSessionRecord,
-    buildAssistantReply,
-  };
-}

package/src/chat-core/app/useAppStream.js

@@ -1,187 +0,0 @@
-import { useCallback, useEffect, useRef, useState } from 'react';
-import { buildRealStreamRequestBody, resolveStreamRefs } from '../pipelines/build-stream-request.js';
-import { sendMockStreamMessage } from '../pipelines/transport/send-mock-stream.js';
-import { sendRealStreamAction, sendRealStreamMessage } from '../pipelines/transport/send-real-stream.js';
-
-function useMockStream(runtime, scope = {}, persistExchange) {
-  const [loading, setLoading] = useState(false);
-  const [error, setError] = useState(null);
-  const lastRequestRef = useRef(null);
-  const timersRef = useRef([]);
-
-  const clearTimers = useCallback(() => {
-    timersRef.current.forEach((timer) => clearTimeout(timer));
-    timersRef.current = [];
-  }, []);
-
-  useEffect(() => clearTimers, [clearTimers]);
-
-  const schedule = useCallback((delay, callback) => {
-    const timer = setTimeout(callback, delay);
-    timersRef.current.push(timer);
-  }, []);
-
-  const send = useCallback(async (content, handlers = {}, options = {}) => {
-    clearTimers();
-    setLoading(true);
-    setError(null);
-    lastRequestRef.current = { content, handlers, options };
-
-    try {
-      await sendMockStreamMessage({
-        runtime,
-        content,
-        handlers,
-        options,
-        scope,
-        persistExchange,
-        schedule,
-      });
-    } finally {
-      setLoading(false);
-    }
-  }, [clearTimers, persistExchange, runtime, schedule, scope]);
-
-  const retry = useCallback(async () => {
-    if (!lastRequestRef.current) {
-      return;
-    }
-
-    const { content, handlers, options } = lastRequestRef.current;
-    await send(content, handlers, options);
-  }, [send]);
-
-  const abort = useCallback(() => {
-    clearTimers();
-    setLoading(false);
-  }, [clearTimers]);
-
-  return {
-    send,
-    retry,
-    abort,
-    loading,
-    error,
-  };
-}
-
-function useRealStream(apiBaseUrl, scope = {}, persistExchange) {
-  const [loading, setLoading] = useState(false);
-  const [error, setError] = useState(null);
-  const lastRequestRef = useRef(null);
-  const abortControllerRef = useRef(null);
-  const resolvedProjectId = String(scope?.projectId || '').trim();
-  const resolvedUserId = String(scope?.userId || '').trim();
-
-  const abort = useCallback(() => {
-    if (abortControllerRef.current) {
-      abortControllerRef.current.abort();
-      abortControllerRef.current = null;
-    }
-    setLoading(false);
-  }, []);
-
-  const send = useCallback(async (content, handlers = {}, options = {}) => {
-    setError(null);
-    setLoading(true);
-    lastRequestRef.current = { content, handlers, options };
-    abortControllerRef.current = new AbortController();
-
-    try {
-      await sendRealStreamMessage({
-        apiBaseUrl,
-        content,
-        handlers,
-        options,
-        scope: {
-          projectId: resolvedProjectId,
-          userId: resolvedUserId,
-        },
-        persistExchange,
-        signal: abortControllerRef.current.signal,
-      });
-    } catch (streamError) {
-      if (streamError?.name !== 'AbortError') {
-        const nextError = {
-          message: streamError?.message || 'chat stream failed',
-          type: 'api',
-        };
-        setError(nextError);
-        handlers.onError?.(nextError);
-      }
-    } finally {
-      setLoading(false);
-      abortControllerRef.current = null;
-    }
-  }, [apiBaseUrl, persistExchange, resolvedProjectId, resolvedUserId]);
-
-  const sendAction = useCallback(async (action, handlers = {}, options = {}) => {
-    setError(null);
-    setLoading(true);
-    abortControllerRef.current = new AbortController();
-
-    try {
-      return await sendRealStreamAction({
-        apiBaseUrl,
-        action,
-        handlers,
-        options,
-        scope: {
-          projectId: resolvedProjectId,
-          userId: resolvedUserId,
-        },
-        signal: abortControllerRef.current.signal,
-      });
-    } catch (actionError) {
-      if (actionError?.name !== 'AbortError') {
-        const nextError = {
-          message: actionError?.message || 'chat action failed',
-          type: 'api',
-        };
-        setError(nextError);
-        handlers.onError?.(nextError);
-      }
-      return null;
-    } finally {
-      setLoading(false);
-      abortControllerRef.current = null;
-    }
-  }, [apiBaseUrl, resolvedProjectId, resolvedUserId]);
-
-  const retry = useCallback(async () => {
-    if (!lastRequestRef.current) {
-      return;
-    }
-    const { content, handlers, options } = lastRequestRef.current;
-    await send(content, handlers, options);
-  }, [send]);
-
-  return {
-    send,
-    sendAction,
-    retry,
-    abort,
-    loading,
-    error,
-  };
-}
-
-export function useAppStream({
-  runtime,
-  backendMode = 'real',
-  apiBaseUrl,
-  kernelBaseUrl,
-  scope,
-  persistExchange,
-}) {
-  const fallbackPersistExchange = (
-    typeof persistExchange === 'function'
-      ? persistExchange
-      : runtime?.appendExchange
-  );
-  const mockStream = useMockStream(runtime, scope, fallbackPersistExchange);
-  const realStream = useRealStream(apiBaseUrl, scope, fallbackPersistExchange);
-  return backendMode === 'real' ? realStream : mockStream;
-}
-
-export { resolveStreamRefs, buildRealStreamRequestBody };

package/src/chat-core/app/useAppStream.refs.test.mjs

@@ -1,44 +0,0 @@
-import test from 'node:test';
-import assert from 'node:assert/strict';
-import { resolveStreamRefs } from './useAppStream.js';
-
-test('resolveStreamRefs prefers top-level refs over payloadExtra refs', () => {
-  const refs = resolveStreamRefs({
-    context_refs: [{ source_id: 'ctx-top' }],
-    knowledge_refs: [{ source_id: 'kn-top' }],
-    payloadExtra: {
-      context_refs: [{ source_id: 'ctx-payload' }],
-      knowledge_refs: [{ source_id: 'kn-payload' }],
-    },
-  });
-
-  assert.deepEqual(refs.context_refs, [{ source_id: 'ctx-top' }]);
-  assert.deepEqual(refs.knowledge_refs, [{ source_id: 'kn-top' }]);
-});
-
-test('resolveStreamRefs falls back to payloadExtra refs when top-level refs are absent', () => {
-  const refs = resolveStreamRefs({
-    payloadExtra: {
-      context_refs: [{ source_id: 'ctx-payload' }],
-      knowledge_refs: [{ source_id: 'kn-payload' }],
-    },
-  });
-
-  assert.deepEqual(refs.context_refs, [{ source_id: 'ctx-payload' }]);
-  assert.deepEqual(refs.knowledge_refs, [{ source_id: 'kn-payload' }]);
-});
-
-test('resolveStreamRefs returns empty arrays for invalid refs input', () => {
-  const refs = resolveStreamRefs({
-    context_refs: 'invalid',
-    knowledge_refs: null,
-    payloadExtra: {
-      context_refs: 'invalid',
-      knowledge_refs: { source_id: 'bad' },
-    },
-  });
-
-  assert.deepEqual(refs.context_refs, []);
-  assert.deepEqual(refs.knowledge_refs, []);
-});
-

package/src/chat-core/app/useAppStream.request-body.test.mjs

@@ -1,116 +0,0 @@
-import test from 'node:test';
-import assert from 'node:assert/strict';
-import { buildRealStreamRequestBody } from './useAppStream.js';
-
-test('buildRealStreamRequestBody includes source refs in request body', () => {
-  const requestBody = buildRealStreamRequestBody({
-    content: 'hello',
-    scope: {
-      projectId: 'project-1',
-      userId: 'user-1',
-    },
-    options: {
-      sessionIdOverride: 'session-1',
-      knowledge_refs: ['src-1', 'src-2'],
-      context_refs: [{ source_id: 'src-1' }],
-    },
-  });
-
-  assert.deepEqual(requestBody.knowledge_refs, ['src-1', 'src-2']);
-  assert.deepEqual(requestBody.context_refs, [{ source_id: 'src-1' }]);
-  assert.equal(requestBody.session_id, 'session-1');
-  assert.equal(requestBody.project_id, 'project-1');
-  assert.equal(requestBody.user_id, 'user-1');
-});
-
-test('buildRealStreamRequestBody falls back refs from payloadExtra', () => {
-  const requestBody = buildRealStreamRequestBody({
-    content: 'hello',
-    options: {
-      payloadExtra: {
-        knowledge_refs: ['src-payload'],
-        context_refs: [{ source_id: 'ctx-payload' }],
-      },
-    },
-  });
-
-  assert.deepEqual(requestBody.knowledge_refs, ['src-payload']);
-  assert.deepEqual(requestBody.context_refs, [{ source_id: 'ctx-payload' }]);
-});
-
-test('buildRealStreamRequestBody keeps valid source refs stable with mixed invalid values', () => {
-  const requestBody = buildRealStreamRequestBody({
-    content: 'hello',
-    options: {
-      context_refs: [
-        { source_id: 'ctx-valid-1' },
-        null,
-        undefined,
-        { source_id: 'ctx-valid-2' },
-        '',
-        0,
-        {},
-      ],
-      knowledge_refs: [
-        'src-valid-1',
-        null,
-        undefined,
-        'src-valid-2',
-        '',
-        1,
-        { source_id: 'src-valid-3' },
-      ],
-    },
-  });
-
-  assert.deepEqual(requestBody.context_refs, [
-    { source_id: 'ctx-valid-1' },
-    { source_id: 'ctx-valid-2' },
-    '',
-    0,
-    {},
-  ]);
-  assert.deepEqual(requestBody.knowledge_refs, [
-    'src-valid-1',
-    'src-valid-2',
-    '',
-    1,
-    { source_id: 'src-valid-3' },
-  ]);
-
-  assert.ok(
-    requestBody.context_refs.some(
-      (item) => item && typeof item === 'object' && item.source_id === 'ctx-valid-1',
-    ),
-  );
-  assert.ok(
-    requestBody.knowledge_refs.includes('src-valid-1'),
-  );
-});
-
-test('buildRealStreamRequestBody includes extracted entities in payload', () => {
-  const requestBody = buildRealStreamRequestBody({
-    content: '请对比 SAP 和 Oracle 的 ERP 方案',
-    options: {},
-  });
-
-  assert.ok(Array.isArray(requestBody.payload.entities));
-  const normalized = requestBody.payload.entities.map((item) => String(item?.normalized || '').trim());
-  assert.ok(normalized.includes('sap'));
-  assert.ok(normalized.includes('oracle'));
-});
-
-test('buildRealStreamRequestBody merges provided entities with extracted entities', () => {
-  const requestBody = buildRealStreamRequestBody({
-    content: '请推荐金蝶 ERP 供应商',
-    options: {
-      payloadExtra: {
-        entities: [{ text: '用友', normalized: 'yonyou', type: 'vendor' }],
-      },
-    },
-  });
-
-  const normalized = requestBody.payload.entities.map((item) => String(item?.normalized || '').trim());
-  assert.ok(normalized.includes('yonyou'));
-  assert.ok(normalized.includes('金蝶'));
-});