flare-chat-core 0.2.3 → 0.2.5

package/src/chat-core/session/sessionActionsStreaming.js

@@ -1,80 +0,0 @@
-import { useCallback } from 'react';
-import {
-  STREAMING_RESET,
-  STREAMING_CHUNK,
-  STREAMING_REPLACE,
-  AGENT_STATUS_SET,
-  THINKING_TRACE_SET,
-  EXECUTION_TRACE_SET,
-  STREAM_KNOWLEDGE_SEARCH_SET,
-  STREAM_SOURCING_CANDIDATES_SET,
-  STREAM_KNOWLEDGE_CITATION_SET,
-  EXECUTION_CARD_UPSERTED,
-  STREAMING_DONE,
-} from './chatSessionActionTypes.js';
-
-export function useStreamingActions({ dispatch }) {
-  const resetStreaming = useCallback(() => {
-    dispatch({ type: STREAMING_RESET });
-  }, [dispatch]);
-
-  const appendStreamChunk = useCallback((chunk) => {
-    dispatch({ type: STREAMING_CHUNK, payload: chunk });
-  }, [dispatch]);
-
-  const replaceStreamContent = useCallback((content) => {
-    dispatch({ type: STREAMING_REPLACE, payload: content });
-  }, [dispatch]);
-
-  const setAgentStatus = useCallback((agentStatus) => {
-    dispatch({ type: AGENT_STATUS_SET, payload: agentStatus });
-  }, [dispatch]);
-
-  const setThinkingTrace = useCallback((trace) => {
-    dispatch({ type: THINKING_TRACE_SET, payload: trace });
-  }, [dispatch]);
-
-  const setExecutionTrace = useCallback((executionTrace) => {
-    dispatch({ type: EXECUTION_TRACE_SET, payload: executionTrace });
-    dispatch({ type: EXECUTION_CARD_UPSERTED, payload: executionTrace });
-  }, [dispatch]);
-
-  const setKnowledgeSearch = useCallback((knowledgeSearch) => {
-    dispatch({ type: STREAM_KNOWLEDGE_SEARCH_SET, payload: knowledgeSearch });
-  }, [dispatch]);
-
-  const setSourcingCandidates = useCallback((sourcingCandidates) => {
-    dispatch({ type: STREAM_SOURCING_CANDIDATES_SET, payload: sourcingCandidates });
-  }, [dispatch]);
-
-  const setKnowledgeCitation = useCallback((knowledgeCitation) => {
-    dispatch({ type: STREAM_KNOWLEDGE_CITATION_SET, payload: knowledgeCitation });
-  }, [dispatch]);
-
-  const completeStreaming = useCallback((finalContent, finalMeta = null) => {
-    dispatch({
-      type: STREAMING_DONE,
-      payload: {
-        content: finalContent,
-        meta: (
-          finalMeta
-          && typeof finalMeta === 'object'
-          && !Array.isArray(finalMeta)
-        ) ? finalMeta : null,
-      },
-    });
-  }, [dispatch]);
-
-  return {
-    resetStreaming,
-    appendStreamChunk,
-    replaceStreamContent,
-    setAgentStatus,
-    setThinkingTrace,
-    setExecutionTrace,
-    setKnowledgeSearch,
-    setSourcingCandidates,
-    setKnowledgeCitation,
-    completeStreaming,
-  };
-}

package/src/chat-core/session/sessionActionsUiState.js

@@ -1,51 +0,0 @@
-import { useCallback } from 'react';
-import {
-  UI_CARDS_SET,
-  UI_CARD_UPDATED,
-  LAST_USER_MESSAGE_SET,
-  DOC_GENERATED,
-  LEGEND_HINT_SHOWN,
-  SESSION_ERROR,
-  INSTANCE_PROFILE_SET,
-} from './chatSessionActionTypes.js';
-
-export function useUiStateActions({ dispatch }) {
-  const setUICards = useCallback((cards) => {
-    dispatch({ type: UI_CARDS_SET, payload: Array.isArray(cards) ? cards : [] });
-  }, [dispatch]);
-
-  const updateUICard = useCallback((card) => {
-    dispatch({ type: UI_CARD_UPDATED, payload: card });
-  }, [dispatch]);
-
-  const setLastUserMessage = useCallback((content) => {
-    dispatch({ type: LAST_USER_MESSAGE_SET, payload: content || '' });
-  }, [dispatch]);
-
-  const setGeneratedDoc = useCallback((doc) => {
-    dispatch({ type: DOC_GENERATED, payload: doc });
-  }, [dispatch]);
-
-  const markLegendHintShown = useCallback((sourceType) => {
-    dispatch({ type: LEGEND_HINT_SHOWN, payload: sourceType });
-  }, [dispatch]);
-
-  const setSessionError = useCallback((error) => {
-    dispatch({ type: SESSION_ERROR, payload: error });
-  }, [dispatch]);
-
-  const setInstanceProfile = useCallback((profile) => {
-    dispatch({ type: INSTANCE_PROFILE_SET, payload: profile || null });
-  }, [dispatch]);
-
-  return {
-    setUICards,
-    updateUICard,
-    setLastUserMessage,
-    setGeneratedDoc,
-    markLegendHintShown,
-    setSessionError,
-    setInstanceProfile,
-  };
-}
-

package/src/chat-core/session/useChatSessionReducer.js

@@ -1,131 +0,0 @@
-import { useReducer, useMemo } from 'react';
-import {
-  initialState,
-  reducer,
-} from './chatSessionReducer.js';
-import { useSessionCrudActions } from './sessionActionsSessionCrud.js';
-import { useMessageActions } from './sessionActionsMessages.js';
-import { useStreamingActions } from './sessionActionsStreaming.js';
-import { useUiStateActions } from './sessionActionsUiState.js';
-
-export { initialState } from './chatSessionReducer.js';
-
-export default function useChatSessionReducer(deps = {}) {
-  const { sessionAPI, messageAPI } = deps;
-  const [state, dispatch] = useReducer(reducer, initialState);
-
-  const sessionCrudActions = useSessionCrudActions({
-    dispatch,
-    sessionAPI,
-    messageAPI,
-  });
-  const messageActions = useMessageActions({
-    dispatch,
-    messageAPI,
-  });
-  const streamingActions = useStreamingActions({ dispatch });
-  const uiStateActions = useUiStateActions({ dispatch });
-
-  const {
-    loadSession,
-    createSession,
-    createOrLoadSession,
-    resetSession,
-    updateTitle,
-    promoteSession,
-  } = sessionCrudActions;
-  const {
-    refreshMessages,
-    appendUserMessage,
-  } = messageActions;
-  const {
-    resetStreaming,
-    appendStreamChunk,
-    replaceStreamContent,
-    setAgentStatus,
-    setThinkingTrace,
-    setExecutionTrace,
-    setKnowledgeSearch,
-    setSourcingCandidates,
-    setKnowledgeCitation,
-    completeStreaming,
-  } = streamingActions;
-  const {
-    setUICards,
-    updateUICard,
-    setLastUserMessage,
-    setGeneratedDoc,
-    markLegendHintShown,
-    setSessionError,
-    setInstanceProfile,
-  } = uiStateActions;
-
-  return useMemo(() => ({
-    sessionId: state.sessionId,
-    sessionTitle: state.sessionTitle,
-    sessionDetail: state.sessionDetail,
-    instanceProfile: state.instanceProfile,
-    messages: state.messages,
-    executionCards: state.executionCards,
-    uiCards: state.uiCards,
-    lastUserMessage: state.lastUserMessage,
-    generatedDoc: state.generatedDoc,
-    streaming: state.streaming,
-    sessionError: state.sessionError,
-    legendHintsShown: state.legendHintsShown,
-    loadSession,
-    createSession,
-    createOrLoadSession,
-    resetSession,
-    updateTitle,
-    promoteSession,
-    refreshMessages,
-    setSessionError,
-    appendUserMessage,
-    setUICards,
-    updateUICard,
-    setLastUserMessage,
-    resetStreaming,
-    appendStreamChunk,
-    replaceStreamContent,
-    setAgentStatus,
-    setThinkingTrace,
-    setExecutionTrace,
-    setKnowledgeSearch,
-    setSourcingCandidates,
-    setKnowledgeCitation,
-    completeStreaming,
-    setGeneratedDoc,
-    setInstanceProfile,
-    markLegendHintShown,
-  }), [
-    state,
-    loadSession,
-    createSession,
-    createOrLoadSession,
-    resetSession,
-    updateTitle,
-    promoteSession,
-    refreshMessages,
-    setSessionError,
-    appendUserMessage,
-    setUICards,
-    updateUICard,
-    setLastUserMessage,
-    resetStreaming,
-    appendStreamChunk,
-    replaceStreamContent,
-    setAgentStatus,
-    setThinkingTrace,
-    setExecutionTrace,
-    setKnowledgeSearch,
-    setSourcingCandidates,
-    setKnowledgeCitation,
-    completeStreaming,
-    setGeneratedDoc,
-    setInstanceProfile,
-    markLegendHintShown,
-  ]);
-}
-
-export { useChatSessionReducer };

package/src/chat-core/session/useSessionListController.js

@@ -1,67 +0,0 @@
-import { useCallback, useState } from 'react';
-
-/**
- * Session list lifecycle controller.
- *
- * @param {object} params - Hook params.
- * @param {object} params.sessionAPI - Session API provider.
- * @param {object} params.listParams - Session list query params.
- * @param {Function} params.onStarted - Optional started callback.
- * @param {Function} params.onSucceeded - Optional succeeded callback.
- * @param {Function} params.onFailed - Optional failed callback.
- * @returns {{sessions: Array<object>, loading: boolean, error: any, loadSessionList: Function}}
- */
-export default function useSessionListController({
-  sessionAPI,
-  listParams = {},
-  onStarted,
-  onSucceeded,
-  onFailed,
-} = {}) {
-  const [sessions, setSessions] = useState([]);
-  const [loading, setLoading] = useState(false);
-  const [error, setError] = useState(null);
-  const [hasLoaded, setHasLoaded] = useState(false);
-
-  const loadSessionList = useCallback(async (options = {}) => {
-    if (!sessionAPI?.list) {
-      return [];
-    }
-    const background = options?.background === true;
-    const shouldShowLoading = !background && !hasLoaded;
-
-    onStarted?.();
-    if (shouldShowLoading) {
-      setLoading(true);
-    }
-    if (!background) {
-      setError(null);
-    }
-
-    try {
-      const response = await sessionAPI.list(listParams);
-      const resolvedSessions = Array.isArray(response?.sessions) ? response.sessions : [];
-      setSessions(resolvedSessions);
-      setHasLoaded(true);
-      onSucceeded?.(resolvedSessions);
-      return resolvedSessions;
-    } catch (nextError) {
-      setError(nextError);
-      onFailed?.(nextError);
-      throw nextError;
-    } finally {
-      if (shouldShowLoading) {
-        setLoading(false);
-      }
-    }
-  }, [hasLoaded, listParams, onFailed, onStarted, onSucceeded, sessionAPI]);
-
-  return {
-    sessions,
-    loading,
-    error,
-    loadSessionList,
-  };
-}
-
-export { useSessionListController };

package/src/chat-core/stream/sse-client.js

@@ -1 +0,0 @@
-export { SSEClient } from '../../adapters/sse-client.js';

package/src/chat-core/stream/sse-event-dispatcher.js

@@ -1 +0,0 @@
-export * from '../../adapters/sse-event-dispatcher.js';

package/src/chat-core/stream/sse-events.js

@@ -1 +0,0 @@
-export * from '../../contracts/sse-events.js';

package/src/chat-core/stream/useSSEStream.js

@@ -1 +0,0 @@
-export { useSSEStream, default } from '../../orchestration/useSSEStream.js';

package/src/chat-core/stream/useStreamSendController.js

@@ -1,46 +0,0 @@
-import { useCallback } from 'react';
-
-/**
- * Stream send lifecycle controller.
- *
- * @param {object} params - Hook params.
- * @param {object} params.stream - Stream adapter with `send`.
- * @param {Function} params.onStarted - Optional started callback.
- * @param {Function} params.onChunk - Optional chunk callback.
- * @param {Function} params.onCompleted - Optional completed callback.
- * @param {Function} params.onFailed - Optional failed callback.
- * @returns {{executeStreamSend: Function}}
- */
-export default function useStreamSendController({
-  stream,
-  onStarted,
-  onChunk,
-  onCompleted,
-  onFailed,
-} = {}) {
-  const executeStreamSend = useCallback(async (content, handlers = {}, options = {}) => {
-    if (!stream?.send) {
-      throw new Error('stream.send is required');
-    }
-
-    onStarted?.();
-
-    try {
-      await stream.send(content, {
-        ...handlers,
-        onContent: (chunk, ...args) => {
-          onChunk?.(chunk, ...args);
-          handlers?.onContent?.(chunk, ...args);
-        },
-      }, options);
-      onCompleted?.();
-    } catch (error) {
-      onFailed?.(error);
-      throw error;
-    }
-  }, [onChunk, onCompleted, onFailed, onStarted, stream]);
-
-  return { executeStreamSend };
-}
-
-export { useStreamSendController };

package/src/contracts/context-ssot.js

@@ -1,47 +0,0 @@
-export function createEmptyContext() {
-  return {
-    confirmed_fields: {},
-    missing_fields: [],
-    notes: [],
-    evidence: [],
-    sourcing_results: [],
-    analysis_results: [],
-  };
-}
-
-function toArray(value) {
-  return Array.isArray(value) ? value : [];
-}
-
-export function normalizeContext(input = {}) {
-  const base = input && typeof input === 'object' ? input : {};
-  return {
-    confirmed_fields:
-      base.confirmed_fields && typeof base.confirmed_fields === 'object' && !Array.isArray(base.confirmed_fields)
-        ? { ...base.confirmed_fields }
-        : {},
-    missing_fields: toArray(base.missing_fields).map((item) => String(item || '').trim()).filter(Boolean),
-    notes: toArray(base.notes).map((item) => String(item || '')).filter(Boolean),
-    evidence: toArray(base.evidence),
-    sourcing_results: toArray(base.sourcing_results),
-    analysis_results: toArray(base.analysis_results),
-  };
-}
-
-export function mergeContextPatch(context = createEmptyContext(), patch = {}) {
-  const normalizedContext = normalizeContext(context);
-  const normalizedPatch = normalizeContext(patch);
-  return {
-    confirmed_fields: {
-      ...normalizedContext.confirmed_fields,
-      ...normalizedPatch.confirmed_fields,
-    },
-    missing_fields: normalizedPatch.missing_fields.length > 0
-      ? normalizedPatch.missing_fields
-      : normalizedContext.missing_fields,
-    notes: [...normalizedContext.notes, ...normalizedPatch.notes],
-    evidence: [...normalizedContext.evidence, ...normalizedPatch.evidence],
-    sourcing_results: [...normalizedContext.sourcing_results, ...normalizedPatch.sourcing_results],
-    analysis_results: [...normalizedContext.analysis_results, ...normalizedPatch.analysis_results],
-  };
-}

package/src/contracts/index.js

@@ -1 +0,0 @@
-export * from './sse-events.js';

package/src/contracts/sse-events/base-parsers.js

@@ -1,79 +0,0 @@
-export const parseAgentStatus = (raw) => ({
-  agent: raw?.agent ?? '',
-  status: raw?.status ?? '',
-  timestamp: raw?.timestamp ?? null,
-});
-
-export const parseThinkingTrace = (raw) => ({
-  trace: raw?.trace ?? '',
-});
-
-export const parseExecutionTrace = (raw) => ({
-  session_id: raw?.session_id ?? '',
-  step_id: raw?.step_id ?? '',
-  agent: raw?.agent ?? '',
-  stage: raw?.stage ?? '',
-  label: raw?.label ?? '',
-  detail: raw?.detail ?? raw?.trace ?? '',
-  reason: raw?.reason ?? '',
-  status: raw?.status ?? raw?.step_status ?? '',
-  sources: Array.isArray(raw?.sources) ? raw.sources : [],
-  timestamp: raw?.timestamp ?? null,
-});
-
-export const parseContent = (raw) => ({
-  chunk: raw?.content ?? '',
-});
-
-export const parseAck = (raw) => ({
-  trace_id: String(raw?.trace_id || '').trim(),
-  session_id: String(raw?.session_id || '').trim(),
-  request_id: String(raw?.request_id || '').trim(),
-  mode: String(raw?.mode || '').trim(),
-  ts: Number.isFinite(Number(raw?.ts)) ? Number(raw.ts) : null,
-});
-
-export const parsePhaseEvent = (raw) => ({
-  phase: String(raw?.phase || '').trim(),
-  label: String(raw?.label || '').trim(),
-  status: String(raw?.status || '').trim(),
-  progress: Number.isFinite(Number(raw?.progress)) ? Number(raw.progress) : null,
-  meta: raw?.meta && typeof raw.meta === 'object' && !Array.isArray(raw.meta) ? raw.meta : {},
-  ts: Number.isFinite(Number(raw?.ts)) ? Number(raw.ts) : null,
-});
-
-export const parsePatch = (raw) => ({
-  scope: String(raw?.scope || '').trim(),
-  payload: raw?.payload && typeof raw.payload === 'object' && !Array.isArray(raw.payload) ? raw.payload : {},
-  ts: Number.isFinite(Number(raw?.ts)) ? Number(raw.ts) : null,
-});
-
-export const parseTextDelta = (raw) => ({
-  channel: String(raw?.channel || 'assistant').trim() || 'assistant',
-  delta: String(raw?.delta || ''),
-  ts: Number.isFinite(Number(raw?.ts)) ? Number(raw.ts) : null,
-});
-
-export const parseTextReplace = (raw) => ({
-  channel: String(raw?.channel || 'assistant').trim() || 'assistant',
-  content: String(raw?.content || ''),
-  ts: Number.isFinite(Number(raw?.ts)) ? Number(raw.ts) : null,
-});
-
-export const parseDone = (raw) => ({
-  trace_id: String(raw?.trace_id || '').trim(),
-  session_id: String(raw?.session_id || '').trim(),
-  request_id: String(raw?.request_id || '').trim(),
-  status: String(raw?.status || 'done').trim() || 'done',
-  ts: Number.isFinite(Number(raw?.ts)) ? Number(raw.ts) : null,
-});
-
-export const parseTrace = (raw) => ({
-  trace: raw?.trace ?? raw?.detail ?? '',
-  summary: raw?.summary ?? raw?.label ?? '',
-  agent: raw?.agent ?? '',
-});
-
-export const parseSSEError = (raw) => ({
-  message: raw?.message ?? '发生错误',
-});

package/src/contracts/sse-events/domain-parsers.js

@@ -1,3 +0,0 @@
-export * from './parsers-intake.js';
-export * from './parsers-sourcing.js';
-export * from './parsers-runtime.js';

package/src/contracts/sse-events/internal-normalizers.js

@@ -1,143 +0,0 @@
-export function resolveModeEventPayload(raw) {
-  if (raw?.payload && typeof raw.payload === 'object' && !Array.isArray(raw.payload)) {
-    return raw.payload;
-  }
-
-  return raw && typeof raw === 'object' ? raw : {};
-}
-
-export function pickFirstArray(payload, keys) {
-  for (const key of keys) {
-    const value = payload?.[key];
-    if (Array.isArray(value)) {
-      return value;
-    }
-  }
-  return [];
-}
-
-export function isPlainObject(value) {
-  return Boolean(value && typeof value === 'object' && !Array.isArray(value));
-}
-
-export function ensureActionObject(value) {
-  return isPlainObject(value) ? value : {};
-}
-
-export function pickFirstString(candidates = []) {
-  for (const candidate of candidates) {
-    const text = String(candidate ?? '').trim();
-    if (text) {
-      return text;
-    }
-  }
-  return '';
-}
-
-export function normalizeActionPayload(rawPayload) {
-  if (isPlainObject(rawPayload)) {
-    return rawPayload;
-  }
-  return {};
-}
-
-export function normalizeAction(rawAction, index = 0) {
-  const action = ensureActionObject(rawAction);
-  const actionKey = pickFirstString([
-    action?.action_key,
-    action?.actionKey,
-    action?.key,
-    action?.id,
-  ]);
-  const label = pickFirstString([
-    action?.label,
-    action?.title,
-    action?.name,
-    actionKey,
-    'action',
-  ]);
-  const reason = pickFirstString([
-    action?.reason,
-    action?.description,
-  ]);
-  const ownerModule = pickFirstString([
-    action?.owner_module,
-    action?.ownerModule,
-  ]);
-  const policyId = pickFirstString([
-    action?.policy_id,
-    action?.policyId,
-  ]);
-  const payload = normalizeActionPayload(action?.payload);
-
-  return {
-    ...action,
-    action_key: actionKey,
-    label,
-    reason,
-    payload,
-    owner_module: ownerModule,
-    policy_id: policyId,
-    action_index: Number.isFinite(Number(action?.action_index))
-      ? Number(action.action_index)
-      : index,
-  };
-}
-
-export function normalizeActionList(rawActions) {
-  if (!Array.isArray(rawActions)) {
-    return [];
-  }
-  const normalized = [];
-  const seenActionKeys = new Set();
-
-  rawActions.forEach((rawAction, index) => {
-    const action = normalizeAction(rawAction, index);
-    const actionKey = String(action?.action_key || '').trim();
-    if (actionKey) {
-      if (seenActionKeys.has(actionKey)) {
-        return;
-      }
-      seenActionKeys.add(actionKey);
-    }
-    normalized.push(action);
-  });
-
-  return normalized;
-}
-
-export function parseGuidedSession(rawGuidedSession) {
-  const payload = (rawGuidedSession && typeof rawGuidedSession === 'object' && !Array.isArray(rawGuidedSession))
-    ? rawGuidedSession
-    : {};
-  const questionQueue = (payload.question_queue && typeof payload.question_queue === 'object' && !Array.isArray(payload.question_queue))
-    ? payload.question_queue
-    : {};
-  const summary = (payload.summary && typeof payload.summary === 'object' && !Array.isArray(payload.summary))
-    ? payload.summary
-    : {};
-  const decisionPoint = (payload.decision_point && typeof payload.decision_point === 'object' && !Array.isArray(payload.decision_point))
-    ? payload.decision_point
-    : {};
-  return {
-    state: payload?.state ?? '',
-    active: payload?.active === true,
-    current_question: payload?.current_question && typeof payload.current_question === 'object' && !Array.isArray(payload.current_question)
-      ? payload.current_question
-      : null,
-    question_queue: {
-      total: Number.isFinite(Number(questionQueue?.total)) ? Number(questionQueue.total) : 0,
-      answered: Number.isFinite(Number(questionQueue?.answered)) ? Number(questionQueue.answered) : 0,
-      remaining: Number.isFinite(Number(questionQueue?.remaining)) ? Number(questionQueue.remaining) : 0,
-      pending_fields: Array.isArray(questionQueue?.pending_fields) ? questionQueue.pending_fields : [],
-    },
-    summary: {
-      text: summary?.text ?? '',
-      ready: summary?.ready === true,
-    },
-    decision_point: {
-      active: decisionPoint?.active === true,
-      actions: Array.isArray(decisionPoint?.actions) ? decisionPoint.actions : [],
-    },
-  };
-}