flare-chat-core 0.2.2 → 0.2.4

package/src/chat-core/orchestration/useBasicSendHandler.js

@@ -1,55 +0,0 @@
-import { useCallback } from 'react';
-
-/**
- * Compose a basic send handler from preflight/execution/recovery boundaries.
- *
- * @param {object} params - Hook params.
- * @param {Function} params.resolveSendPreflight - Preflight resolver.
- * @param {Function} params.executeSendRound - Round executor.
- * @param {Function} params.handleSendFailureRecovery - Failure recovery handler.
- * @param {Array<any>} params.emptyArray - Shared immutable empty array.
- * @returns {{handleSend: Function}}
- */
-export default function useBasicSendHandler({
-  resolveSendPreflight,
-  executeSendRound,
-  handleSendFailureRecovery,
-  emptyArray = [],
-}) {
-  const handleSend = useCallback(async (options = {}) => {
-    let isFirstDraftSend = false;
-    let preserveInputOnError = false;
-    let content = '';
-    let attachedSessionFilesSnapshot = emptyArray;
-
-    try {
-      const sendPreflight = await resolveSendPreflight?.(options);
-      if (!sendPreflight || sendPreflight.blocked) {
-        return;
-      }
-
-      attachedSessionFilesSnapshot = sendPreflight.attachedSessionFilesSnapshot || emptyArray;
-      isFirstDraftSend = sendPreflight.isFirstDraftSend === true;
-      preserveInputOnError = sendPreflight.preserveInputOnError === true;
-      content = sendPreflight.content || '';
-
-      await executeSendRound?.({
-        sendPreflight,
-        isFirstDraftSend,
-      });
-      return true;
-    } catch (error) {
-      handleSendFailureRecovery?.({
-        preserveInputOnError,
-        isFirstDraftSend,
-        content,
-        attachedSessionFilesSnapshot,
-      });
-      return error;
-    }
-  }, [emptyArray, executeSendRound, handleSendFailureRecovery, resolveSendPreflight]);
-
-  return { handleSend };
-}
-
-export { useBasicSendHandler };

package/src/chat-core/pipelines/build-action-request.js

@@ -1,46 +0,0 @@
-import { resolvePayloadExtra } from './build-stream-request.js';
-
-export function buildRealActionRequestBody({
-  action = {},
-  options = {},
-  scope = {},
-}) {
-  const normalizedAction = (
-    action
-    && typeof action === 'object'
-    && !Array.isArray(action)
-  ) ? action : {};
-  const payloadExtra = resolvePayloadExtra(options);
-  const actionPayload = (
-    normalizedAction.payload
-    && typeof normalizedAction.payload === 'object'
-    && !Array.isArray(normalizedAction.payload)
-  ) ? normalizedAction.payload : {};
-  const resolvedProjectId = String(scope?.projectId || '').trim();
-  const resolvedUserId = String(scope?.userId || '').trim();
-  const sessionId = String(options.sessionIdOverride || '').trim();
-
-  return {
-    tenant_id: 'default',
-    instance_id: 'default',
-    domain_pack_version: 'v1',
-    session_id: sessionId || null,
-    intent: 'default',
-    project_id: resolvedProjectId || null,
-    user_id: resolvedUserId || null,
-    action_key: String(normalizedAction.action_key || '').trim() || null,
-    target_mode: String(
-      normalizedAction.target_mode
-      || actionPayload.target_mode
-      || ''
-    ).trim() || null,
-    action_status: String(normalizedAction.status || '').trim() || null,
-    action_reason: String(normalizedAction.reason || '').trim() || null,
-    payload: {
-      ...actionPayload,
-      ...payloadExtra,
-      project_id: resolvedProjectId || null,
-      user_id: resolvedUserId || null,
-    },
-  };
-}

package/src/chat-core/pipelines/build-stream-request.js

@@ -1,74 +0,0 @@
-import { resolveEntities } from './entity-extraction.js';
-
-function normalizeRefs(value) {
-  if (!Array.isArray(value)) {
-    return [];
-  }
-  return value.filter((item) => item !== undefined && item !== null);
-}
-
-export function resolvePayloadExtra(options = {}) {
-  return (
-    options?.payloadExtra
-    && typeof options.payloadExtra === 'object'
-    && !Array.isArray(options.payloadExtra)
-  ) ? options.payloadExtra : {};
-}
-
-export function resolveStreamRefs(options = {}) {
-  const payloadExtra = resolvePayloadExtra(options);
-
-  const contextRefs = Array.isArray(options?.context_refs)
-    ? normalizeRefs(options.context_refs)
-    : normalizeRefs(payloadExtra.context_refs);
-  const knowledgeRefs = Array.isArray(options?.knowledge_refs)
-    ? normalizeRefs(options.knowledge_refs)
-    : normalizeRefs(payloadExtra.knowledge_refs);
-
-  return {
-    context_refs: contextRefs,
-    knowledge_refs: knowledgeRefs,
-  };
-}
-
-export function buildRealStreamRequestBody({
-  content,
-  options = {},
-  scope = {},
-}) {
-  const resolvedProjectId = String(scope?.projectId || '').trim();
-  const resolvedUserId = String(scope?.userId || '').trim();
-  const sessionId = String(options.sessionIdOverride || '').trim();
-  const payloadExtra = resolvePayloadExtra(options);
-  const modeKey = String(options?.modeKey || payloadExtra.mode || '').trim();
-  const manualModeKey = String(options?.manualModeKey || payloadExtra.manual_mode || '').trim();
-  const command = String(options?.command || payloadExtra.command || 'send_message').trim() || 'send_message';
-  const refs = resolveStreamRefs(options);
-  const entities = resolveEntities({
-    text: content,
-    entities: Array.isArray(options?.entities) ? options.entities : payloadExtra.entities,
-  });
-  return {
-    tenant_id: 'default',
-    instance_id: 'default',
-    domain_pack_version: 'v1',
-    session_id: sessionId || null,
-    command,
-    intent: 'default',
-    ...(modeKey ? { mode: modeKey } : {}),
-    ...(manualModeKey ? { manual_mode: manualModeKey } : {}),
-    project_id: resolvedProjectId || null,
-    user_id: resolvedUserId || null,
-    payload: {
-      message: content,
-      ...(modeKey ? { mode: modeKey } : {}),
-      ...(manualModeKey ? { manual_mode: manualModeKey } : {}),
-      project_id: resolvedProjectId || null,
-      user_id: resolvedUserId || null,
-      ...payloadExtra,
-      entities,
-    },
-    context_refs: refs.context_refs,
-    knowledge_refs: refs.knowledge_refs,
-  };
-}

package/src/chat-core/pipelines/entity-extraction.js

@@ -1,159 +0,0 @@
-const ENTITY_TYPES = {
-  VENDOR: 'vendor',
-  PRODUCT: 'product',
-  ORG: 'org',
-};
-
-const PRODUCT_TOKENS = [
-  'ERP',
-  'CRM',
-  'SCM',
-  'MES',
-  'PLM',
-  'SRM',
-  'WMS',
-  'HRM',
-];
-
-const KNOWN_ENTITY_DEFS = [
-  { type: ENTITY_TYPES.VENDOR, text: '用友', aliases: ['用友', '用友网络', 'yonyou'] },
-  { type: ENTITY_TYPES.VENDOR, text: '金蝶', aliases: ['金蝶', 'kingdee'] },
-  { type: ENTITY_TYPES.VENDOR, text: 'SAP', aliases: ['sap', 'sap erp', '思爱普'] },
-  { type: ENTITY_TYPES.VENDOR, text: 'Oracle', aliases: ['oracle', 'oracle erp', '甲骨文'] },
-  { type: ENTITY_TYPES.VENDOR, text: '鼎捷', aliases: ['鼎捷', 'digiwin'] },
-  { type: ENTITY_TYPES.VENDOR, text: 'Microsoft Dynamics', aliases: ['microsoft dynamics', 'dynamics 365'] },
-  { type: ENTITY_TYPES.VENDOR, text: 'Infor', aliases: ['infor'] },
-  { type: ENTITY_TYPES.VENDOR, text: 'Workday', aliases: ['workday'] },
-  { type: ENTITY_TYPES.VENDOR, text: 'Sage', aliases: ['sage'] },
-  { type: ENTITY_TYPES.VENDOR, text: 'Odoo', aliases: ['odoo'] },
-  { type: ENTITY_TYPES.VENDOR, text: 'Epicor', aliases: ['epicor'] },
-  { type: ENTITY_TYPES.VENDOR, text: 'IFS', aliases: ['ifs'] },
-  ...PRODUCT_TOKENS.map((token) => ({ type: ENTITY_TYPES.PRODUCT, text: token, aliases: [token] })),
-];
-
-function normalizeEntityKey(value) {
-  return String(value || '')
-    .trim()
-    .toLowerCase()
-    .replace(/[\u3000\s]+/g, ' ')
-    .replace(/^[,.;:!?()[\]{}"'`~]+|[,.;:!?()[\]{}"'`~]+$/g, '');
-}
-
-function escapeRegExp(value) {
-  return String(value || '').replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
-
-function hasCjk(value) {
-  return /[\u3400-\u9fff]/.test(String(value || ''));
-}
-
-function includesAlias(text, alias) {
-  const sourceText = String(text || '');
-  const sourceAlias = String(alias || '').trim();
-  if (!sourceText || !sourceAlias) {
-    return false;
-  }
-  if (hasCjk(sourceAlias)) {
-    return sourceText.includes(sourceAlias);
-  }
-  const pattern = new RegExp(`\\b${escapeRegExp(sourceAlias)}\\b`, 'i');
-  return pattern.test(sourceText);
-}
-
-function inferEntityType(text, fallbackType = ENTITY_TYPES.ORG) {
-  const normalized = normalizeEntityKey(text);
-  if (PRODUCT_TOKENS.some((token) => normalizeEntityKey(token) === normalized)) {
-    return ENTITY_TYPES.PRODUCT;
-  }
-  return fallbackType;
-}
-
-function normalizeEntityItem(item) {
-  if (typeof item === 'string') {
-    const normalized = normalizeEntityKey(item);
-    if (!normalized) return null;
-    return {
-      text: String(item).trim(),
-      normalized,
-      type: inferEntityType(item),
-    };
-  }
-  if (!item || typeof item !== 'object' || Array.isArray(item)) {
-    return null;
-  }
-  const text = String(item.text || item.name || item.value || '').trim();
-  const normalized = normalizeEntityKey(item.normalized || text);
-  if (!text && !normalized) {
-    return null;
-  }
-  return {
-    text: text || normalized,
-    normalized,
-    type: String(item.type || inferEntityType(text || normalized)).trim().toLowerCase() || ENTITY_TYPES.ORG,
-  };
-}
-
-function dedupeEntities(list = []) {
-  const seen = new Set();
-  const normalized = [];
-  list.forEach((item) => {
-    const normalizedItem = normalizeEntityItem(item);
-    if (!normalizedItem || !normalizedItem.normalized) {
-      return;
-    }
-    const key = `${normalizedItem.type}:${normalizedItem.normalized}`;
-    if (seen.has(key)) {
-      return;
-    }
-    seen.add(key);
-    normalized.push(normalizedItem);
-  });
-  return normalized;
-}
-
-function extractKnownEntities(text = '') {
-  const sourceText = String(text || '');
-  if (!sourceText.trim()) {
-    return [];
-  }
-  return KNOWN_ENTITY_DEFS
-    .filter((entity) => entity.aliases.some((alias) => includesAlias(sourceText, alias)))
-    .map((entity) => ({
-      text: entity.text,
-      normalized: normalizeEntityKey(entity.text),
-      type: entity.type,
-    }));
-}
-
-function extractOrgLikeEntities(text = '') {
-  const sourceText = String(text || '');
-  if (!sourceText.trim()) {
-    return [];
-  }
-  const matches = [];
-  const cnPattern = /([\u4e00-\u9fa5]{2,24}(?:公司|集团|科技|信息|股份|研究院))/g;
-  const enPattern = /\b([A-Z][A-Za-z0-9&.-]{1,}(?:\s+[A-Z][A-Za-z0-9&.-]{1,}){0,3}\s+(?:Inc|Corp|Corporation|Ltd|LLC|Group|Systems|Technologies|Technology))\b/g;
-  for (const match of sourceText.matchAll(cnPattern)) {
-    matches.push({ text: match[1], type: ENTITY_TYPES.ORG });
-  }
-  for (const match of sourceText.matchAll(enPattern)) {
-    matches.push({ text: match[1], type: ENTITY_TYPES.ORG });
-  }
-  return matches;
-}
-
-export function extractEntitiesFromText(text = '') {
-  return dedupeEntities([
-    ...extractKnownEntities(text),
-    ...extractOrgLikeEntities(text),
-  ]);
-}
-
-export function resolveEntities({ text = '', entities = [] } = {}) {
-  return dedupeEntities([
-    ...(Array.isArray(entities) ? entities : []),
-    ...extractEntitiesFromText(text),
-  ]);
-}
-
-export { ENTITY_TYPES };

package/src/chat-core/pipelines/preprocess-message.js

@@ -1,16 +0,0 @@
-import { extractEntitiesFromText } from './entity-extraction.js';
-
-export function normalizeIntentText(value) {
-  return String(value || '').trim().toLowerCase();
-}
-
-export function detectSourcingIntent(text) {
-  const normalized = normalizeIntentText(text);
-  if (!normalized) return false;
-  const signals = ['寻源', '供应商', '比价', '采购', '招标', 'source', 'vendor', 'supplier', 'sourcing'];
-  return signals.some((token) => normalized.includes(token));
-}
-
-export function extractMessageEntities(text) {
-  return extractEntitiesFromText(text);
-}

package/src/chat-core/pipelines/stream-persist-utils.js

@@ -1,32 +0,0 @@
-export function resolvePersistExchangeResult(result, fallbackSessionId = '') {
-  const fallback = String(fallbackSessionId || '').trim();
-  if (result && typeof result === 'object' && !Array.isArray(result)) {
-    return {
-      sessionId: String(result.sessionId || result.session_id || fallback).trim(),
-      title: String(result.title || '').trim(),
-    };
-  }
-  return {
-    sessionId: String(result || fallback).trim(),
-    title: '',
-  };
-}
-
-export function collectSourceIdsFromRefs(refs = []) {
-  if (!Array.isArray(refs)) {
-    return [];
-  }
-  const ids = [];
-  const seen = new Set();
-  refs.forEach((item) => {
-    const sourceId = typeof item === 'string'
-      ? String(item).trim()
-      : String(item?.source_id || item?.id || '').trim();
-    if (!sourceId || seen.has(sourceId)) {
-      return;
-    }
-    seen.add(sourceId);
-    ids.push(sourceId);
-  });
-  return ids;
-}

package/src/chat-core/pipelines/transport/send-mock-stream.js

@@ -1,86 +0,0 @@
-import { resolvePersistExchangeResult } from '../stream-persist-utils.js';
-
-function chunkText(content, chunkSize = 16) {
-  if (!content) {
-    return [];
-  }
-
-  const result = [];
-  for (let index = 0; index < content.length; index += chunkSize) {
-    result.push(content.slice(index, index + chunkSize));
-  }
-
-  return result;
-}
-
-export async function sendMockStreamMessage({
-  runtime,
-  content,
-  handlers = {},
-  options = {},
-  scope = {},
-  persistExchange,
-  schedule,
-}) {
-  const sessionId = String(options.sessionIdOverride || '').trim();
-  const enabledCapabilities = Array.isArray(options.enabledCapabilities)
-    ? options.enabledCapabilities
-    : [];
-  const finalReply = runtime.buildAssistantReply(content, enabledCapabilities);
-  const chunks = chunkText(finalReply);
-  const resolvedProjectId = String(scope?.projectId || '').trim();
-  const resolvedUserId = String(scope?.userId || '').trim();
-
-  await new Promise((resolve) => {
-    let delay = 120;
-    chunks.forEach((chunk) => {
-      schedule(delay, () => {
-        handlers.onContent?.(chunk);
-      });
-      delay += 70;
-    });
-
-    schedule(delay + 40, () => {
-      const persistedResult = (typeof persistExchange === 'function'
-        ? persistExchange(sessionId, content, finalReply, {
-          functionType: options.modeKey || 'chat_component_debug',
-          projectId: resolvedProjectId || null,
-          userId: resolvedUserId || null,
-        })
-        : String(sessionId || '').trim()
-      );
-      const persistedSession = resolvePersistExchangeResult(persistedResult, sessionId);
-      const resolvedSessionId = persistedSession.sessionId;
-      handlers.onPatchEvent?.({
-        session: {
-          session_id: resolvedSessionId,
-          turn_id: '',
-        },
-        payload: persistedSession.title
-          ? {
-              session: {
-                title: persistedSession.title,
-              },
-            }
-          : {},
-        patch_scope: ['session'],
-        event_type: 'ack',
-        final: false,
-        invalid: false,
-      });
-      handlers.onComplete?.(finalReply, {
-        sessionId: resolvedSessionId,
-        ...(persistedSession.title
-          ? {
-              payload: {
-                session: {
-                  title: persistedSession.title,
-                },
-              },
-            }
-          : {}),
-      });
-      resolve();
-    });
-  });
-}